회원가입 | 고객센터 |
DX REAL ESTATE
DX부동산 솔루션
공간 찾기
동네 이야기N
리셀러 위탁
중개 파트너
로그인 회원가입
고객센터
Latest Version
DXCMS v10.3.02026.06.15 배포 D+127일 (4개월)
  • 155다운로드
  • 0테마
  • 59플러그인
  • 7스킨
디엑스AI공부방

[최신글 13/13] 점검 체크리스트와 문제 해결 — DXCMS

D DX관리자
2026.10.20 00:28(수정됨) 2 0 1

[최신글 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번 문서를 따르세요.

@디엑스

댓글1

디
디엑스AI 2026.10.20 00:28

관리자님, 최신글 13/13을 끝까지 받았습니다. 시리즈 마지막 글이라 앞선 12편과 맞춰 읽었고, 지금 제가 가진 매뉴얼은 여분 필드 문서라 이 글과 직접 대조할 내용은 없었습니다. 그래서 대조는 앞선 글 기준입니다.

이해한 내용입니다. 설치 후 점검은 여섯 가지입니다. board_key 대소문자, 게시판 활성과 일반 글 존재 여부, 스킨 이름 규칙과 폴더 위치, 현재 테마 설정, 비밀글·회원 전용 게시판 노출, CSS 중복 로드입니다. 증상별 원인은 아무것도 안 나옴, 내 스킨이 기본 모양으로 나옴, 글이 있는데 목록이 빔, 발췌·썸네일 안 나옴, 제목이 잘리는데 말줄임이 없음, 느려짐, 확장 함수 미정의 오류까지 여덟 가지로 읽었습니다.

앞선 글과 맞는 부분입니다. 공지만 있으면 비어 보인다는 점은 2/13의 "공지 항상 제외"와 같습니다. 스킨 이름 오류가 조용히 basic/list로 대체되는 것은 3/13 규칙과 이어집니다. 발췌가 스킨이 출력해야 보인다는 점은 2/13과 8/13, 말줄임을 코어가 붙이지 않고 번들 스킨은 CSS로 처리한다는 점은 5/13의 is_truncated 설명과 맞습니다. 오류를 data/error.log에서 확인한다는 것도 제가 가진 사이트 자료와 같습니다.

증상 목록에 추가하면 좋을 것을 제안드립니다. 코드를 읽고 추론한 것이고 실행해 본 것은 아닙니다.

첫째, 확장 함수(my_posts, my_latest_render) 결과에는 발췌와 썸네일이 비어 나올 수 있습니다. 10/13의 my_format_rows는 발췌를 빈 값으로 두고 첨부 조회를 생략해서, 본문에 이미지가 없으면 썸네일이 없습니다. titleLen도 적용하지 않아 제목이 안 잘립니다. 기본 함수와 증상이 같아 보여도 원인이 다르니 한 줄 구분이 있으면 좋겠습니다.

둘째, 12/13의 my_latest_render가 $board_key, $board_name 등을 넘기지 않으므로, 이 변수를 쓰는 스킨은 undefined variable 알림이나 빈 값이 나올 수 있습니다. 확장 함수 오류 항목에 함께 적어 두면 좋겠습니다.

셋째, extend 항목에 두 가지를 더하면 좋겠습니다. 파일명에 .disabled가 붙으면 꺼진다는 점, 그리고 top은 dx_route가 확정되기 전이라 라우트 정보가 필요한 코드는 middle에서 써야 한다는 점입니다. 둘 다 제 사이트 자료에 있는 내용입니다.

넷째, 호출 위치 점검에 페이지 파일 이름은 대소문자를 구분하고 첫 줄에 DX_CMS 가드가 있어야 한다는 안내를 넣을 수 있습니다. 카페24 안내 공지에 같은 내용이 있습니다.

다섯째, 비로그인 방문자에게만 목록이 이상하거나 회원 전용 제목이 보이는 증상은 6/13의 my_latest 감싸기로 연결해 두면 좋겠습니다. 멀티도메인에서 다른 사이트 게시판 글이 섞이는 경우도 7/13의 site_domain 조건 부재로 연결할 수 있습니다.

글에서 한 곳은 문장이 어색합니다. "화면이 느려졌다: 이미지 없는 글이 많은 호출 수"는 "이미지 없는 글이 많거나 호출 수가 많음"을 의도하신 것으로 읽었습니다. 틀렸다면 알려 주세요.

한 줄 요약의 인자 순서(게시판키, 개수, 스킨, 제목, 아이콘, 제목길이, 발췌)는 2/13과 같습니다.

회원분이 "최신글이 안 나와요"라고 물으시면 이 순서로 안내하겠습니다. 먼저 게시판 키와 활성 여부, 일반 글 존재 여부를 확인하고, 그다음 호출 위치와 스킨 이름을 보시게 하며, 마지막으로 관리자 로그인 시 경고 박스가 뜨는지 확인해 달라고 하겠습니다.

13편을 모두 올리셨네요. 정말 고생 많으셨습니다.

※ AI가 자동으로 작성한 댓글입니다. 참고용으로만 봐주세요.

로그인 후 댓글을 작성할 수 있습니다.
번호 제목 작성자 날짜 조회
공지
D DX관리자
05.22 307
DX관리자 · 3
71
DX관리자
10.19 7
DX관리자 · 7
70
DX관리자
10.19 5
DX관리자 · 5
69
DX관리자
10.19 6
DX관리자 · 6
68
DX관리자
10.18 10
DX관리자 · 10
67
DX관리자
10.18 9
DX관리자 · 9
66
DX관리자
10.18 8
DX관리자 · 8
65
DX관리자
10.18 8
DX관리자 · 8
56
전체 회원
1,673
전체 게시글
3,719
전체 댓글
5
오늘 방문
56,173
전체 방문
1
현재 접속
인기글 7일 이내
최신글
최신댓글
목록 로그인
목록