GNUCMS / MANUAL

프론트 파일과 테마 개발

PHP 화면·조각·레이아웃·자산과 사용자 테마 호환 방법을 설명합니다.

개발자

프론트 소스 위치

화면기본 파일
전체 사이트 레이아웃templates/default/layout.php
관리자 메뉴·레이아웃templates/default/admin/layout.php · admin/_sidebar.php
알림·발송 설정templates/default/admin/messaging.php
알림별 발송 규칙templates/default/admin/notify_settings.php
발송 이력·직접 발송templates/default/admin/message/ 아래
주문서templates/default/shop/checkout.php
쇼핑몰 관리templates/default/shop/admin/ 아래
CSS·JavaScriptwww/themes/default/ 아래

현재 선택한 테마가 기본 파일을 재정의하면 templates/테마명 안의 같은 경로를 사용합니다. GNUCMS.com의 현재 테마는 templates/modern과 www/themes/modern입니다. gnucmscom은 이전 테마로 남아 있습니다.

새 테마

개발 셸
cp -r templates/default templates/mytheme
cp -r www/themes/default www/themes/mytheme

기본 upstream은 일반 테마 간 템플릿 fallback을 제공하지 않으므로 default를 통째로 복사해 시작합니다. 정적 자산은 선택 테마에 없으면 default를 사용합니다. theme.php label과 사이트의 theme 설정을 맞춥니다.

공식 사이트 저장소는 modern을 포함한 선택 테마에 화면이 없으면 default를 찾는 별도 fallback 보완을 사용합니다. 이 공식 사이트 구현을 모든 사용자 테마의 계약으로 가정하지 않습니다. 업그레이드마다 코어에서 바뀐 화면·partial·전역 변수를 비교해야 합니다.

렌더링과 블록

PHP
<?php $this->layout('layout') ?>
<?php $this->start('title') ?><?= $this->e($title) ?><?php $this->stop() ?>
<?php $this->start('body') ?>
<h1><?= $this->e($title) ?></h1>
<?php $this->insert('posts/_meta', ['post' => $post]) ?>
<?php $this->stop() ?>

컨트롤러는 확장자 없는 논리 이름을 render에 전달합니다. layout, start/stop, insert를 사용하고 반복문 안의 조각 데이터는 명시적으로 넘깁니다. 관리 화면은 admin/layout과 admin_section을 사용합니다.

출력·URL·자산

  • 일반 출력은 $this->e(), 사용자 HTML은 $this->html()로 정화합니다.
  • 코어 라우트 주소는 $this->url(), 정적 파일은 $this->asset()으로 생성합니다.
  • asset은 내용 해시를 붙여 변경 시 브라우저 캐시를 갱신합니다.
  • 날짜 화면은 $this->date($value)와 공통 DateTimeDisplay를 사용해 y-m-d H:i:s로 표시합니다.
  • 모든 POST 폼에 csrf_token을 넣고 로그인 복귀 url은 검증된 return_url을 보존합니다.
  • 공개·관리자·모바일·다크 모드와 사용자 테마의 같은 partial 영향을 함께 확인합니다.
개발자 참고 소스

문서 파일 갱신 26-10-21 16:27:42