DX 게시판 인기글 카드 사용 설명서 (v1.0.7)
게시판 목록 맨 위, 게시판 본문 칸 바로 위(오른쪽 사이드 메뉴 옆)에 본문과 구분된 별도 카드로 그 게시판의 인기글 순위를 작은 카드로 보여 주는 플러그인입니다. 순위는 게시판마다 따로 계산하고, 결과는 일정 시간 저장해 두었다가 보여 주기 때문에 사이트가 느려지지 않습니다. 멀티사이트는 도메인별로 보이게/안 보이게 고를 수 있습니다.
1. 설치 (5분)
- 받은
dx-board-rank_v1.0.7.zip압축을 풉니다. 안에plugins폴더가 있습니다. - FTP 프로그램(파일질라 등)으로 내 사이트에 접속합니다.
- 압축을 푼
plugins/dx-board-rank폴더를 사이트의plugins/안에 올립니다. (최종 위치:사이트/plugins/dx-board-rank/) - 관리자 → 플러그인 에서 DX 게시판 인기글 카드 를 찾아 활성화 합니다.
- 왼쪽 관리자 메뉴에 게시판 인기글 카드 가 생깁니다. 눌러서 설정을 확인하고 저장 합니다.
- 사이트 게시판 목록을 열어 확인합니다. (캐시가 있으면 한 번 비워 주세요.)
2. 사용법
관리자 → 게시판 인기글 카드 에서 아래를 정합니다.
| 항목 | 설명 |
|---|---|
| 카드를 보여줄 사이트 | 모든 사이트 / 체크한 사이트에만. 멀티사이트에서 도메인별로 켜고 끕니다. |
| 카드를 보여줄 게시판 | 모든 게시판 / 체크한 게시판에만. |
| 보여줄 글 수 | 3~10개 (처음 값 5개) |
| 집계 기간 | 최근 며칠 글만 순위에 넣을지 (처음 값 30일, 0이면 전체 기간) |
| 캐시 시간 | 순위를 몇 분마다 새로 계산할지 (처음 값 10분) |
| 썸네일 이미지 표시 | 켜면 순위 칸마다 작은 이미지가 붙습니다. 끄면 숫자와 제목만 보입니다. (처음 값: 켬) |
| 글 보기 화면에도 표시 | 기본은 목록 화면만. 켜면 글 보기 화면에도 나옵니다. |
- 캐시 지금 비우기 를 누르면 다음 방문 때 순위를 바로 새로 계산합니다. 저장할 때도 자동으로 비워집니다.
- 카드를 누르면(글 제목) 해당 글로 이동합니다.
3. 알아 두세요
- 썸네일 이미지는 글의 대표 이미지(갤러리형 게시판은 올릴 때 만들어진 썸네일, 유튜브 글은 유튜브 대표 화면)를 쓰고, 없으면 본문의 첫 이미지를 씁니다. 이미지가 하나도 없는 글은 이미지 자리에 본문 글 요약(앞부분 3줄)이 테두리 칸 안에 나옵니다. 이미지 칸은 모두 얇은 테두리로 둘러싸여 있어 카드 배경색과 같아도 모양이 또렷합니다. 이미지는 화면에 보일 때 불러와서 사이트가 느려지지 않습니다.
- 순위는 게시판의 인기순 과 같은 점수(조회수, 좋아요, 댓글수를 합산하고 오래된 글은 점수가 줄어듭니다)로 정합니다. 그래서 목록의 "인기순"과 결과가 비슷합니다.
- 설정한 캐시 시간 동안은 조회가 늘어도 순위가 바로 바뀌지 않습니다. 급하게 바꾸고 싶으면 캐시 지금 비우기 를 누르세요.
- 공지글, 비밀글, 점수가 0인 글은 넣지 않습니다. 집계 기간 안에 넣을 글이 하나도 없으면 전체 기간에서 뽑아 보여 주고(카드에 「전체 기간」 표시), 전체에도 없을 때만 카드가 나오지 않습니다. 집계 기간 안에 글이 1~2개라도 있으면 그 글만 보여 줍니다.
- 인기 점수는 글을 조회하거나 좋아요를 누르거나 댓글이 달릴 때 올라갑니다. 옮겨 온 글이나 아무도 열어 보지 않은 글은 0이라 넣지 않습니다.
- 글쓰기·수정·답글·삭제 화면에는 나오지 않습니다.
- 카드는 본문 칸 바깥 위에 따로 놓입니다. 오른쪽에 사이드 메뉴가 있으면 카드 옆에서 사이드 메뉴가 시작되고, 본문(흰 칸)은 카드 아래로 내려갑니다. 사이드 메뉴가 없는 화면은 본문 위에 가로 폭 그대로 나옵니다. 다운로드 통계 카드(LATEST 줄)가 켜져 있으면 그 아래에 있습니다.
- 카드 위쪽에 굵은 선, 라임색 HOT 표시, 1위는 라임 칸으로 눈에 띄게 했고, 제목에 마우스를 올리면 라임색 형광펜 표시가 나옵니다. 조회수·댓글수는 아이콘(Font Awesome)으로 보여 주며, 아이콘이 안 불러와져도 숫자는 그대로 보입니다.
- 밝은/어두운 모드와 모바일을 지원합니다. 카드 폭이 좁아지면 가로 5칸 → 2칸 → 세로 한 줄 목록으로 바뀝니다. 그림자·둥근 모서리·이모지는 쓰지 않았습니다.
- 확인하지 못한 것: 서버 PHP 5.6 직접 실행(문법은 5.6 규칙을 점검했습니다). 제작 환경에서는 new-basic 테마로 확인했습니다. 사이드 메뉴가 있는 화면의 실제 모습은 직접 확인하지 못했습니다.
4. 라이선스 (DesignOneX License 1.0)
- 재배포 절대 금지: 무료·유료 모두 다른 사람/사이트에 다시 배포·공유·판매할 수 없습니다. 단독 상품 판매나 유료 상품·유료 회원제에 포함하는 것도 금지입니다.
- 허용: 사용료 없이 쓸 수 있고, 기업 사이트·고객사 프로젝트 등 상업적 이용이 가능하며, 고쳐서 본인의 사이트·프로젝트에 쓸 수 있습니다. 고객 서버에 설치해 주는 것은 재배포가 아닙니다. (플러그인 파일을 고객에게 판매·양도하는 것은 금지)
- 변형한 것을 재배포하고 싶다면 디자인원엑스 사이트(designonex.com)에 올려야 합니다.
- 공식 전문: https://designonex.com/notice/view/1787577858493247
- 라이선스 요지는 플러그인 폴더 안
LICENSE.md에 들어 있습니다. 지우지 마세요.
5. 문제가 생기면
- 카드가 안 나와요: ① 플러그인이 활성화되어 있는지, ② 설정에서 이 도메인과 이 게시판이 체크되어 있는지, ③ 이 게시판에 조회·댓글·좋아요가 한 번이라도 있었던 글이 있는지 확인하세요. 그런 글이 하나도 없으면 카드가 나오지 않습니다.
- 순위가 안 바뀌어요: 캐시 시간 동안 저장된 결과입니다. 캐시 지금 비우기 를 눌러 보세요.
- 카드가 다른 위치에 나와요: 카드는 게시판 스킨 바로 위에 끼워 넣습니다. 스킨의 첫 요소 모양이 특이하면 위치가 다를 수 있으니 알려 주세요.
- 멀티사이트에서 한 사이트에만 나와요: 설정의 「선택한 사이트에만 표시」에서 원하는 도메인을 모두 체크했는지 확인하세요.
