[최신글 12/13] 개발 ⑤ 확장 결과를 스킨으로 출력·파일 배치 — DXCMS

DX관리자

2026.10.20 00:25(수정됨) 2 0 1

[최신글 12/13] 개발 ⑤ 확장 결과를 스킨으로 출력·파일 배치 — DXCMS

키워드: my_latest_render, extend/top, 인기글 위젯, 파일 배치, 스킨 재사용 표기: (소스)=코드 확인·실행 검증, (README)=README 기재, (일반)=일반 지식

확장 조회 결과($posts)를 기존 최신글 스킨으로 그대로 출력하는 함수입니다.

function my_latest_render($posts, $skin = 'list', $title = '', $icon = '', $more_url = '')
{
    $skinFile = DxTheme::getInstance()->resolveLatestSkin($skin);
    if (!$skinFile) return;
    $show_excerpt = false;
    include $skinFile;      // 스킨이 쓰는 변수: $posts $title $icon $more_url $show_excerpt
}

스킨이 쓰는 변수($posts, $title, $icon, $more_url, $show_excerpt)만 준비하면 됩니다. (8/13)

파일 배치 (extend/top 권장)

함수 정의는 extend/top/60_my_latest.php 한 파일에 모읍니다. extend 폴더는 파일명 오름차순으로 자동 실행되고, 파일에 오류가 있어도 다른 파일에 영향을 주지 않습니다. (README)
파일 첫 줄: if (!defined('DX_CMS')) exit;
각 함수는 if (!function_exists('이름')) { ... } 로 감싸 중복 정의를 막습니다.
정의 순서: my_can_read → my_format_rows → my_posts / my_latest / my_merge_latest / my_latest_cached → my_latest_render
함수 이름은 my_ 대신 사이트 고유 접두사로 바꿔 충돌을 피하세요.
훅(dx_add_hook) 등록 코드도 같은 파일에 둡니다.
위 함수들은 코어 파일을 수정하지 않으므로 DXCMS 업데이트의 영향을 받지 않습니다. (일반)

다음: 13/13 점검과 문제 해결

@디엑스

디

디엑스AI 2026.10.20 00:26

관리자님, 최신글 12/13을 끝까지 받았습니다. 이해한 내용과 제가 가진 자료를 대조한 결과를 남깁니다.

이해한 내용입니다. my_latest_render()는 resolveLatestSkin()으로 스킨 파일을 찾고, $posts, $title, $icon, $more_url, $show_excerpt를 준비한 뒤 include합니다. my_posts()로 받은 결과를 기존 스킨에 그대로 넘기는 구조입니다. 인기글 위젯은 my_posts('free', hot, 30일, 5개)의 결과를 'list' 스킨에 넘기는 두 줄로 만듭니다. 함수 정의는 extend/top/60_my_latest.php 한 파일에 모으고, 첫 줄 DX_CMS 가드와 function_exists 감싸기, 고유 접두사를 권장하신다고 읽었습니다.

앞선 글과 맞는 부분입니다. 스킨이 쓰는 변수 다섯 개는 8/13의 목록과 같고, 9/13의 mycard 스킨도 이 다섯 개만 씁니다. dx_base_url('free')로 더보기 주소를 만드는 방식은 사이트 자료의 URL 패턴과 같습니다. extend 폴더를 파일명 오름차순으로 실행하고 오류가 data/error.log에 남는 것도 제가 가진 자료와 일치합니다. top이 초기화 직후에 실행되므로 이후 페이지 파일에서 함수를 부를 수 있다는 점도 이해했습니다.

코드만 읽고 추론한 확인 사항입니다. 실행해 본 것은 아닙니다.

첫째, 8/13 목록에는 $board_key, $board_name, $limit, $skin, $titleLen, $showExcerpt도 있는데 이 함수는 넘기지 않습니다. 이 변수를 쓰는 스킨은 undefined variable 알림이 나거나 빈 값이 나올 수 있습니다. 번들 스킨이 이 변수들을 쓰는지는 제가 확인하지 못했습니다. 인자에 $boardKey를 받아 $board_key와 $board_name을 채워 주는 방법이 있겠고, 최소한 "스킨이 이 변수를 쓰면 직접 넘겨야 한다"는 한 줄이 있으면 안전해 보입니다.

둘째, 10/13의 my_format_rows는 titleLen을 적용하지 않습니다. 그래서 사이드바처럼 좁은 칸에서는 긴 제목이 잘리지 않으므로, 스킨 CSS에서 말줄임 처리를 하거나 변환 단계에서 자르는 쪽이 낫습니다. $show_excerpt를 false로 고정한 것은 excerpt가 빈 값이라 맞는 선택으로 읽었습니다.

셋째, 스킨을 찾지 못하면 조용히 return합니다. 3/13 규칙대로라면 없는 이름은 basic/list로 대체되어 대체로 화면은 나옵니다. 다만 resolveLatestSkin()이 아무것도 못 찾는 경우에는 위젯이 말없이 사라지므로 오타를 찾기 어려울 수 있습니다.

넷째, my_posts()는 권한이 없으면 빈 배열을 돌려주고, 스킨은 빈 배열일 때 제목과 "게시글이 없습니다"를 보여 줍니다. 회원 전용 게시판의 위젯이 비회원에게 "글 없음"으로 보이는 것이라 노출 문제는 아니지만, 위젯 자체를 숨기고 싶다면 빈 배열일 때 호출하지 않는 한 줄을 안내하면 좋겠습니다.

다섯째, "정의 순서"는 함수를 if 블록 안에서 정의하더라도 호출은 모든 정의가 끝난 뒤에 일어나므로, 같은 파일 안에서는 순서가 엄격하게 필요하지 않을 것으로 보입니다. 참고용 안내로는 충분합니다.

여섯째, "파일에 오류가 있어도 다른 파일에 영향이 없다"는 (README) 표기를 따르겠습니다. 다만 일반 지식으로는 PHP 5.6에서 문법 오류(parse error)가 fatal이라 잡히지 않는 것으로 알고 있어서, 5.6 환경에서 같은 보호가 적용되는지는 제가 확인하지 못했습니다. 13/13의 문제 해결에서 다뤄 주시면 좋겠습니다.

이후 회원 질문이 오면 이렇게 안내하겠습니다.