페이지 내 위젯을 통해 특정 게시물 노출하기

사이트 내 특정 페이지에서 새로 등록된 게시글, 좋아요 수가 많은 게시글 등 특정 조건에 맞는 게시물을 노출하려면, 관리 콘솔에서 해당 조건에 맞는 위젯(Widget)을 생성한 뒤 원하는 페이지에 적용할 수 있습니다.

콘솔에서 위젯 생성하기

다음 절차에 따라 위젯을 생성할 수 있습니다:

1. H:Dev+에 로그인한 후 콘솔로 이동합니다.
2. 콘솔 화면의 왼쪽 메뉴에서 Widget > Widget Management로 이동합니다.
3. 위젯 목록 상단의 Add 버튼을 클릭하여 새 위젯의 정보를 입력합니다.
4. 위젯 정보를 입력한 뒤 Save 버튼을 클릭하면 위젯이 생성됩니다.

위젯 입력 정보

1. 위젯 이름

위젯 목록에서 쉽게 구분할 수 있는 이름을 입력합니다.

2. 위젯 코드

프론트엔드에서 위젯 호출 시 사용할 고유 코드입니다.

• 숫자, 알파벳, 언더바(_)로 구성
• 최대 20자 이하로 설정 가능

3. 위젯 설명

해당 위젯의 특징이나 사용 목적을 간략히 적습니다.

4. 위젯 구분

노출할 게시물 유형을 지정합니다:

• 사용자 지정 게시물: 특정 게시물을 수동으로 지정
• 등록 일자 순 게시물: 최신 순으로 게시물 노출
• 일간 조회 비율 순: 조회수/등록일 기준으로 일간 조회 수가 높은 게시물 순서로 노출
• 좋아요 순 게시물: 좋아요 수가 많은 게시물 순으로 노출

5. 위젯 아이템 수

노출할 게시물(아이템)의 수를 지정합니다.

6. 게시판

특정 게시판의 게시물만 노출하고 싶다면 해당 게시판을 지정합니다. 지정하지 않을 경우, 모든 게시판의 게시물이 대상이 됩니다.

7. 위젯 아이템 정렬

노출될 게시물의 정렬 기준을 설정합니다.

프론트엔드에서 위젯 사용하기

페이지에 위젯을 노출하려면 프론트엔드에서 해당 페이지의 DataID에 위젯 항목을 추가해야 합니다.

예를 들어, most_view_post와 new_post 두 개의 위젯을 노출하려면 아래와 같이 정의합니다:

{
  "dataID": "GET_POST",
  "widget": ["most_view_post", "new_post"]
}

dataID는 노출하려는 페이지에 따라 변경할 수 있습니다. 위와 같이 Request Data를 지정하면, 프론트엔드에서 해당 위젯들이 정상적으로 노출됩니다.

추가 참고 자료

위젯 관련 Request/Response 정보 및 상세 설정 방법은 공식 문서 에서 확인하실 수 있습니다.