1. 개요
DX Popular Filter는 홈 화면의 "인기글" 위젯에 어떤 게시판의 글만 표시할지 관리자가 직접 선택할 수 있게 해주는 DXCMS 플러그인입니다.기본 상태(아무 설정도 하지 않았을 때)에서는 전체 게시판을 대상으로 인기글이 계산되는 DXCMS 원래 동작 그대로입니다. 특정 게시판만 인기글에 반영하고 싶을 때만 이 플러그인에서 선택해주면 됩니다.
2. 설치
- 전달받은 dx-popular-filter 폴더(zip 압축 파일)를 DXCMS 설치 경로의 /plugins/ 폴더 아래에 그대로 업로드합니다.
- 최종 경로가 /plugins/dx-popular-filter/ 형태가 되어야 합니다.
- 관리자로 로그인한 뒤, 플러그인 관리 화면으로 이동합니다.
- 플러그인 목록에서 "DX Popular Filter"를 찾아 활성화 스위치를 켭니다.
💡 DXCMS는 새로 설치된 플러그인을 기본적으로 "비활성화" 상태로 등록합니다. 반드시 플러그인 관리 화면에서 활성화를 켜야 동작합니다.
3. 사용 방법
플러그인을 활성화하면 관리자 좌측 사이드바에 "인기글 필터" 메뉴가 자동으로 나타납니다.- 사이드바의 "인기글 필터" 메뉴를 클릭합니다.
- "전체 게시판(기본값)" 또는 "선택한 게시판만" 중 하나를 선택합니다.
- "선택한 게시판만"을 선택한 경우, 아래 목록에서 인기글에 반영할 게시판을 체크합니다.
- "저장" 버튼을 클릭합니다.
4. 동작 원리
이 플러그인은 DXCMS의 코어 파일이나 테마 파일을 전혀 수정하지 않습니다. 대신 다음과 같은 방식으로 동작합니다.- "전체 게시판" 상태에서는 아무 것도 가로채지 않습니다 — DXCMS가 원래 그리는 인기글 위젯이 그대로 보입니다.
- 특정 게시판을 선택하면, 홈 화면이 다 로드된 뒤 자동으로 실행되는 스크립트가 이 플러그인이 제공하는 API를 호출해 "선택한 게시판만 기준으로 새로 계산한 인기글 TOP 9"를 가져옵니다.
- 가져온 결과로 인기글 위젯의 내용을 통째로 교체합니다.
💡 이미 화면에 그려진 9개 중 일부만 걸러내는 방식이 아니라, 선택한 게시판 안에서 다시 TOP 9를 계산하기 때문에 선택한 게시판의 글이 적더라도 화면에 개수가 정확하게 채워집니다.
5. 주의사항
⚠ 읽기 권한(read_level)이 9 이상으로 설정된 비공개/관리자 전용 게시판은 선택 여부와 관계없이 항상 결과에서 제외됩니다.
- 게시판을 새로 추가하거나 삭제한 뒤에는 필터 설정 화면에서 선택 목록을 다시 확인하는 것을 권장합니다.
- 이 플러그인은 홈 화면의 "인기글" 위젯에만 적용됩니다. "최신글", "최신댓글" 위젯은 영향을 받지 않습니다.
6. 제거
plugins/dx-popular-filter 폴더를 지우면 됩니다. 코어 파일을 전혀 수정하지 않으므로 그 외 별도 정리는 필요 없습니다. 플러그인을 지우기 전 플러그인 관리 화면에서 비활성화만 해도 즉시 원래(전체 게시판) 동작으로 돌아갑니다.7. 문제 해결
게시판을 선택했는데 홈 화면이 안 바뀌어요
- 브라우저 캐시 문제일 수 있습니다. Ctrl+F5로 강력 새로고침해보세요.
- 플러그인 관리 화면에서 "DX Popular Filter"가 활성화되어 있는지 확인하세요.
- 선택한 게시판에 최근 7일 이내 작성된 글이 있는지 확인하세요 — 인기글은 7일 이내 글만 대상으로 합니다(DXCMS 기본 정책).
"게시글이 없습니다"라고만 나와요
- 선택한 게시판들에 최근 7일 이내 작성된 공개 글이 없는 경우입니다. 게시판을 더 추가하거나 "전체"로 되돌려보세요.
