[최신글 13/13] 점검 체크리스트와 문제 해결 — DXCMS
키워드: 문제 해결, 안 보임, 체크리스트, 오류, 점검, 스킨 적용 안 됨 표기: (소스)=코드 확인·실행 검증, (README)=README 기재, (일반)=일반 지식
설치 후 점검
- board_key 가 관리자 게시판 관리의 키와 정확히 같은가 (대소문자 포함)
- 게시판이 활성(status=1)이고 일반 글이 1개 이상 있는가 (공지만 있으면 비어 보임)
- 스킨 이름이 소문자 규칙을 지키는가, 파일이 올바른 폴더에 있는가
- 현재 테마 설정이 내 테마를 가리키는가
- 비밀글·회원 전용 게시판이 노출되지 않는가 (7/13)
- 같은 페이지에 여러 번 호출해도 CSS 가 한 번만 로드되는가
증상별 원인
- 아무것도 안 나온다: 게시판 키 오타, 게시판 비활성, 호출 위치가 PHP 블록 밖, 페이지 파일이 PHP 로 실행되지 않는 곳. 관리자로 로그인하면 키 오류일 때 노란 경고 박스가 나옵니다. (소스)
- 내 스킨이 적용되지 않고 기본 모양이다: 스킨 이름에 대문자·공백이 있거나, 파일 경로 오류, 테마 설정이 default 로 되어 있음. 이 경우 오류 없이 basic/list 로 대체됩니다. (3/13)
- 글이 있는데 목록이 비어 있다: 글이 공지(is_notice=1)뿐이거나 status 가 1 이 아님, 다른 게시판 키
- 발췌가 안 나온다: 7번째 인자 $showExcerpt 를 true 로 주지 않았거나, 스킨이 $show_excerpt 를 쓰지 않음
- 썸네일이 안 나온다: 썸네일 컬럼·본문 이미지·첨부 이미지가 모두 없음. 외부 이미지 주소가 막힌 경우도 있음 (갤러리 스킨은 오류 시 플레이스홀더 표시)
- 제목이 잘리는데 … 이 없다: 코어가 말줄임을 붙이지 않음. 번들 스킨은 is_truncated 를 쓰지 않고 CSS(text-overflow)로 처리하므로, 직접 만든 스킨에서는 is_truncated 로 … 을 붙이거나 CSS 를 사용
- 화면이 느려졌다: 이미지 없는 글이 많은 호출 수, 캐시 없음 (7/13, 6/13)
- 확장 함수가 '정의되지 않음' 오류: extend/top 파일의 정의 순서, 파일 첫 줄 가드, PHP 문법 오류. data/error.log 에서 확인 (소스: 운영 시 오류는 파일에 기록)
한 줄 요약
dx_board_latest('게시판키', 개수, '스킨', '제목', '아이콘', 제목길이, 발췌) 한 줄을 출력할 자리에 넣고, 권한·비밀글·성능은 6·7번 문서를 따르세요.
@디엑스