1. 정적 페이지 관리 개요

DXCMS의 [정적 페이지 관리] 메뉴는 회사소개, 이용약관, 개인정보처리방침, 서비스 안내 등 고정된 내용의 독립 페이지를 생성•편집•관리하는 도구입니다. 일반 게시판과 달리 게시글 목록이 없는 단일 콘텐츠 페이지를 제작할 때 사용합니다.

📌  접근 경로: 관리자 대시보드 → 정적 페이지 관리 (또는 URL: /admin/pages)

1.1 정적 페이지 vs 게시판 차이

구분	정적 페이지	게시판
콘텐츠 형태	단일 페이지 (1개 파일)	게시글 목록 + 상세 페이지
저장 방식	PHP 파일로 직접 저장	데이터베이스(DB) 저장
URL 구조	/슬러그 (예: /about)	/게시판키/list, /게시판키/view/123
주요 용도	회사소개, 약관, 정책, 랜딩페이지	공지사항, 자유게시판, FAQ 등
에디터 지원	지원 (에디터 직접 입력 방식)	지원

1.2 화면 구성

정적 페이지 관리 화면은 상단의 사이트 탭 필터, 새 페이지 추가 버튼, 그리고 페이지 목록 테이블로 구성됩니다. 새 페이지 추가 또는 수정 시 폼 화면이 목록 위에 표시됩니다.
 

영역	설명
사이트 탭 필터	전체 / 글로벌 / 도메인별 탭으로 페이지를 필터링. 멀티사이트 환경에서 사이트별 관리 가능.
새 페이지 추가 버튼	우측 상단의 [+ 새 페이지 추가] 버튼. 클릭 시 1단계(도메인 선택) 화면으로 이동.
페이지 목록 테이블	등록된 모든 정적 페이지를 표로 나열. 제목, 슬러그, 파일 경로, 방식, 위치, 상태, 관리 버튼 표시.
페이지네이션	페이지당 50개씩 표시. 페이지 수 초과 시 하단에 페이지 이동 버튼 자동 표시.

2. 페이지 목록 테이블

등록된 정적 페이지들이 테이블 형태로 표시됩니다. 각 컬럼의 의미와 관리 버튼 기능을 아래에서 상세히 설명합니다.

2.1 목록 컬럼 설명

컬럼	설명
페이지 제목 / 슬러그	굵은 글씨로 페이지 제목 표시. 아래 줄에 /슬러그 형태의 URL 코드. HOME 배지: 홈페이지로 지정된 페이지. 독립 배지: 독립형 단독 실행 모드 설정 페이지.
경로	실제 파일이 저장된 서버 경로. 글로벌 위치는 pages/슬러그.php 형태, 테마 위치는 themes/테마명/page/파일명.php 형태로 표시.
방식 (Editor/File)	Editor(파란색 배지): 에디터로 직접 작성된 페이지. File(보라색 배지): PHP 파일 경로를 직접 지정한 페이지.
위치 (Global/Theme)	Global(초록색 배지): pages/ 공용 폴더에 저장. Theme(노란색 배지): 테마 전용 폴더에 저장.
상태 (Live/Off)	Live(초록색): 공개 중인 활성 페이지. Off(회색): 비공개 처리된 페이지. 비공개 상태에서도 직접 URL 접근 시 권한 설정에 따라 동작.
관리 버튼	수정(연필 아이콘), 복사(복사 아이콘), 삭제(쓰레기통 아이콘) 3개 버튼 제공.

2.2 목록 관리 버튼

아이콘	기능	상세 설명
✏️	수정	해당 페이지의 설정 및 내용을 편집하는 폼으로 이동합니다. 편집 완료 후 저장하면 즉시 반영됩니다.
📋	복사	현재 페이지 설정과 내용을 복제합니다. 새 슬러그는 원본슬러그-copy로 자동 생성. 복사본은 비공개(Off) 상태로 생성되며 제목에 "(복사본)"이 추가됩니다.
🗑	삭제	페이지를 DB에서 삭제하고, Editor 방식의 글로벌 페이지인 경우 pages/ 폴더의 실제 PHP 파일도 함께 삭제합니다. 삭제 전 확인 창이 표시됩니다.

⚠️  삭제는 복구가 불가능합니다. Editor 방식 글로벌 페이지의 경우 PHP 파일도 서버에서 함께 삭제됩니다. 중요한 페이지는 삭제 전 복사 기능을 활용해 백업하세요.

2.3 사이트 탭 필터

목록 상단의 탭을 클릭하여 원하는 사이트(도메인)의 페이지만 필터링할 수 있습니다.
 

탭	표시 범위
전체	도메인 구분 없이 시스템에 등록된 모든 정적 페이지를 표시합니다. 전체 페이지 수를 괄호로 표시.
글로벌	site_domain이 비어있는(공통) 페이지만 표시합니다. 모든 사이트에서 공용으로 접근 가능한 페이지입니다.
도메인 탭	해당 도메인에 귀속된 페이지만 표시합니다. 멀티사이트 환경에서 각 도메인별 페이지를 분리 관리할 때 사용합니다.

3. 새 페이지 생성

상단의 [+ 새 페이지 추가] 버튼을 클릭하면 2단계 프로세스로 새 페이지를 생성합니다. 1단계에서 도메인(사이트)을 선택하고, 2단계에서 상세 설정을 입력합니다.

3.1 1단계 — Domain 노출 범위 선택

새 페이지를 생성하기 전, 이 페이지를 어느 도메인(사이트)에 귀속시킬지 먼저 결정합니다. 화면에 카드 형태로 선택지가 표시됩니다.
 

카드	귀속 범위	특징
🌐 글로벌 (공통)	모든 사이트 공통 페이지	site_domain이 빈 값으로 저장. 어느 도메인에서도 슬러그로 접근 가능. 멀티사이트 공유 페이지(약관, 개인정보처리방침 등)에 적합.
도메인 카드 (특정 사이트)	해당 도메인 전용 페이지	해당 도메인의 테마와 메뉴 그룹 정보가 자동 연동. 선택한 도메인에서만 접근되는 전용 페이지 제작에 사용. 현재 접속 도메인은 "현재" 배지로 표시.

💡  도메인 카드에는 연결된 테마명과 메뉴 그룹 정보가 표시됩니다. 페이지 파일 저장 경로(Storage Path)가 선택한 테마에 따라 결정되므로 신중하게 선택하세요.

3.2 2단계 — 페이지 설정 폼

도메인 선택 후 표시되는 상세 설정 폼입니다. 폼 상단의 파란색 배너에 선택된 도메인, 테마, 메뉴 그룹 정보가 표시됩니다. [변경] 링크를 클릭하면 1단계로 돌아가 도메인을 다시 선택할 수 있습니다.

3.3 콘텐츠 방식 선택 (Contents Selection)

페이지 콘텐츠를 어떤 방식으로 관리할지 결정합니다. 두 가지 방식 중 하나를 선택합니다.
 

방식	저장 위치	사용 시기 및 특징
에디터 직접 입력 (Editor)	pages/슬러그.php 자동 생성	비개발자도 쉽게 사용. 브라우저에서 WYSIWYG 에디터(CKEditor 등)로 내용 작성. 저장 시 PHP 파일 자동 생성. 가장 일반적인 방식.
PHP 파일 직접 지정 (File)	수동 지정한 PHP 파일 경로	개발자가 직접 제작한 복잡한 PHP 파일 연결. 에디터 없이 파일명만 입력. 동적 로직이 포함된 랜딩페이지, 이벤트 페이지 등에 적합.

⚠️  테마 전용(theme) 위치를 선택하면 에디터 직접 입력 방식은 사용할 수 없습니다. 테마 경로에는 반드시 PHP 파일 직접 지정(File) 방식만 사용 가능합니다.

3.4 저장 경로 위치 선택 (Storage Path)

생성하는 페이지 파일을 어느 경로에 저장할지 결정합니다.
 

위치	실제 저장 경로	설명
글로벌 공통 (Global)	pages/슬러그.php	모든 사이트에서 공용으로 사용하는 기본 경로. 에디터 방식 선택 시 슬러그명으로 파일이 자동 생성됩니다.
테마 전용 (Theme)	themes/테마명/page/파일명.php	선택된 사이트의 테마 폴더 내부에 저장. 반드시 File 방식과 함께 사용. 테마에 종속된 페이지를 제작할 때 활용.

💡  폼 중앙에 위치한 [경로 안내 배너]는 현재 선택된 방식+위치 조합에 따라 실제 파일 경로를 실시간으로 미리 보여줍니다. 저장 전에 반드시 경로를 확인하세요.

3.5 기본 정보 입력

페이지 명칭 *	관리자 목록 및 사이트 탭 타이틀에 표시되는 페이지 이름. 한글 포함 자유롭게 입력 가능. 예: 회사 소개, 이용약관, 개인정보처리방침.
URL 접근 슬러그 *	실제 사이트에서 이 페이지에 접근하는 URL 경로. 예: about → 접근 URL: /about. 영문 소문자·숫자·하이픈·언더바만 허용. 페이지 명칭 입력 시 자동 생성(수정 가능). 슬러그 중복 불가.

⚠️  슬러그는 URL 경로이자 파일명으로 사용됩니다. 한번 생성 후 변경하면 기존 URL로의 접근이 불가능해지므로, 초기에 신중하게 결정하세요. 기존 URL을 사용해야 한다면 메뉴에서 리다이렉트를 설정하세요.

3.6 물리 파일명 입력 (File 방식 전용)

콘텐츠 방식으로 [PHP 파일 직접 지정]을 선택하면 아래 입력란이 표시됩니다. 연결할 PHP 파일명을 직접 입력합니다.
 

글로벌(Global) 위치일 때	pages/ 폴더 기준 파일명 입력. 예: intro.php, docs/manual.php. 경로 탐색 공격 방지를 위해 ../ 입력은 차단됩니다.
테마(Theme) 위치일 때	themes/테마명/page/ 폴더 기준 파일명 입력. 예: welcome.php, landing/event.php. 파일은 사전에 서버에 업로드되어 있어야 합니다.

💡  파일 지정 방식은 개발자가 직접 PHP 파일을 서버에 업로드한 후 파일명만 등록하는 방식입니다. 에디터 입력란은 표시되지 않으며, 페이지 내용은 해당 PHP 파일이 전담합니다.

3.7 본문 콘텐츠 에디터 (Editor 방식 전용)

콘텐츠 방식으로 [에디터 직접 입력]을 선택하면 에디터 영역이 표시됩니다. 시스템에 설정된 에디터(CKEditor, Jodit, TinyMCE 등)가 자동으로 로드됩니다.
 

에디터 자동 로드	설정된 전역 에디터가 자동 활성화됩니다. CKEditor, Jodit, TinyMCE 등 플러그인으로 등록된 에디터를 사용합니다.
파일 방식 전환 시	에디터 방식에서 파일 방식으로 전환 시 에디터(CKEditor, TinyMCE 등)가 자동으로 destroy되어 충돌을 방지합니다.
저장 시 파일 처리	저장 시 입력한 HTML 콘텐츠가 pages/슬러그.php 파일에 자동으로 기록됩니다. 파일 상단에는 직접 접근 차단 PHP 코드가 자동 추가됩니다.
기존 PHP 파일 자동 감지	수정 모드에서 기존 파일 내용이 PHP 코드로 시작되면, 자동으로 "파일 방식"으로 전환되어 DB도 업데이트됩니다.

4. 페이지 옵션 설정

폼 하단의 옵션 영역에서 공개 상태, 접근 권한, 정렬 순서, 홈페이지 지정, 독립형 모드, SEO 설정을 구성합니다.

4.1 기본 옵션 3종

옵션	설명
현재 노출 상태	ACTIVE(공개중): 사이트 방문자가 슬러그 URL로 접근 가능. HIDDEN(비공개): 관리자 외 접근 차단. 작성 중인 페이지를 임시 저장할 때 활용.
열람 접근 권한	모든 방문자 허용(레벨 0): 비회원 포함 모두 접근 가능. 로그인 회원만(레벨 1): 로그인한 회원만 열람 가능. 관리자 권한 필요(레벨 9): 관리자 계정만 접근 가능.
목록 정렬 순서	관리자 목록에서 이 페이지의 표시 순서. 숫자가 작을수록 앞에 표시. 같은 숫자면 최신 등록순(ID 내림차순) 정렬.

4.2 홈페이지 지정 (is_home)

체크 시 이 페이지가 해당 사이트(도메인)의 메인 홈페이지로 설정됩니다. 사이트 접속 시 이 페이지가 첫 화면으로 표시됩니다.
 

항목	상세 설명
홈 지정 범위	같은 site_domain(도메인) 내에서 하나의 페이지만 홈으로 설정됩니다. 새 페이지를 홈으로 지정하면 같은 도메인의 기존 홈 설정이 자동으로 해제됩니다.
목록 HOME 배지	홈으로 지정된 페이지는 목록에서 제목 옆에 노란색 HOME 배지가 표시됩니다.
주의사항	홈 페이지는 반드시 공개(ACTIVE) 상태여야 정상적으로 동작합니다. 비공개 상태의 페이지를 홈으로 지정하면 사이트 접속 시 오류가 발생할 수 있습니다.

⚠️  현재 사이트의 홈 페이지를 변경할 경우, 검색엔진 색인에 영향을 줄 수 있습니다. 변경 전 SEO 리다이렉트 처리를 고려하세요.

4.3 독립형 단독 실행 모드 (is_standalone)

체크 시 이 페이지가 테마 레이아웃(헤더, 푸터, 사이드바 등) 없이 본문 콘텐츠만 단독으로 렌더링됩니다.
 

항목	상세 설명
일반 모드 (기본)	테마의 헤더, 푸터, 내비게이션, 사이드바 등 전체 레이아웃이 적용됩니다.
독립형 모드 (체크)	테마 레이아웃 없이 페이지 본문만 출력. 팝업 페이지, 인쇄용 페이지, 외부 삽입용 페이지, 랜딩 페이지 등 레이아웃 간섭 없이 완전한 제어가 필요한 경우에 사용.
목록 독립 배지	독립형 모드 페이지는 목록에서 제목 옆에 초록색 독립 배지가 표시됩니다.

💡  독립형 모드는 iframe으로 삽입되는 콘텐츠, 별도 디자인이 적용되는 이벤트 랜딩페이지, 팝업 전용 약관 페이지 등에 활용하면 효과적입니다.

5. SEO 설정

폼 하단의 SEO 설정 영역에서 검색 엔진 최적화를 위한 메타 정보를 입력합니다. 이 정보는 HTML <head> 태그 내의 메타 태그로 삽입됩니다.
 

필드	HTML 적용 위치	설명 및 작성 팁
메타 제목 (meta_title)	<title> 및 <meta property="og:title">	브라우저 탭과 검색 결과에 표시되는 제목. 비워두면 페이지 명칭(title)이 자동 사용. 권장 길이: 50~60자 이내.
메타 설명 (meta_desc)	<meta name="description"> 및 og:description	검색 결과 미리보기에 표시되는 요약 설명. 클릭률(CTR)에 직접 영향. 권장 길이: 120~160자 이내. 페이지의 핵심 내용을 자연스럽게 서술.

💡  SEO 메타 정보는 입력하지 않아도 페이지 동작에는 영향이 없습니다. 단, 검색 노출과 SNS 공유 시 미리보기 품질에 영향을 주므로 중요 페이지는 반드시 입력하세요.

6. 페이지 저장 및 반영

모든 설정 입력 완료 후 폼 하단의 [페이지 설정 저장 및 반영] 버튼을 클릭합니다.

6.1 저장 처리 흐름

저장 버튼 클릭 시 다음 순서로 처리됩니다.

1. 입력값 유효성 검증: 제목•슬러그 필수 입력 확인, 슬러그 중복 여부 확인
2. 에디터 방식(editor): 입력된 HTML 콘텐츠를 pages/슬러그.php 파일로 저장 (자동 생성/덮어쓰기)
3. 파일 방식(file): 입력된 파일명 유효성 검증 후 DB에 경로만 등록
4. 홈 지정 체크 시: 같은 도메인의 기존 is_home=1 페이지를 is_home=0으로 자동 해제
5. DB에 페이지 정보 저장 (신규 등록 또는 업데이트)
6. 저장 성공 메시지와 함께 목록 페이지로 자동 이동 (PRG 패턴 적용)

6.2 저장 오류 및 대처

오류 메시지	원인 및 해결 방법
페이지 제목을 입력하세요.	페이지 명칭 필드가 비어있습니다. 제목을 입력한 후 다시 저장하세요.
슬러그를 입력하세요.	URL 슬러그 필드가 비어있습니다. 영문·숫자·하이픈으로 슬러그를 입력하세요.
이미 사용 중인 슬러그입니다.	동일한 슬러그가 이미 등록되어 있습니다. 다른 슬러그를 사용하거나 기존 페이지를 삭제 후 재등록하세요.
pages/ 폴더에 파일을 쓸 수 없습니다.	서버의 pages/ 폴더 쓰기 권한이 없습니다. 서버에서 chmod 755 또는 777로 권한을 부여하세요. 호스팅 환경에서는 관리자에게 문의하세요.
파일명을 입력하세요.	파일 방식 선택 시 물리 파일명 입력란이 비어있습니다. 연결할 PHP 파일명을 입력하세요.

7. 페이지 수정

목록에서 [✏️ 수정] 버튼을 클릭하면 해당 페이지의 설정 폼으로 이동합니다. 신규 생성 폼과 동일한 구조이나 몇 가지 차이점이 있습니다.

7.1 수정 모드의 특이사항

항목	수정 모드에서의 동작
도메인 선택 (1단계 없음)	수정 시 도메인 선택 1단계가 없습니다. 기존 페이지의 site_domain 값으로 컨텍스트가 자동 설정됩니다.
슬러그 변경 가능	수정 시에도 슬러그 변경이 가능합니다. 단, 슬러그 변경 시 기존 URL로의 접근이 불가능해지니 주의하세요.
에디터 내용 자동 로드	에디터 방식 글로벌 페이지의 경우, pages/슬러그.php 파일에서 내용을 읽어 에디터에 자동으로 표시합니다.
PHP 코드 자동 감지	파일 내용이 PHP 코드(<?php로 시작)로 확인되면 자동으로 "파일 방식"으로 전환하고 DB도 업데이트합니다.
취소 버튼	폼 하단의 [리스트로 돌아가기] 링크를 클릭하면 변경사항 저장 없이 목록으로 돌아갑니다.

8. 페이지 복사

목록의 [📋 복사] 버튼 클릭 시 즉시 복사 처리됩니다. 별도의 확인 창 없이 바로 실행됩니다.

8.1 복사 동작 규칙

새 슬러그 자동 생성	원본 슬러그 뒤에 -copy를 붙여 생성. 이미 사용 중이면 -copy2, -copy3 순으로 자동 증가.
제목 변경	원본 제목 + " (복사본)" 텍스트가 추가됩니다. 수정 후 원하는 제목으로 변경하세요.
파일 복사 (Editor+Global)	Editor 방식 + Global 위치 조합의 경우, pages/ 폴더의 원본 PHP 파일을 새 슬러그명으로 복사합니다.
파일 복사 제외 (기타 조합)	File 방식 또는 Theme 위치 조합은 파일을 복사하지 않고 DB 레코드만 복사합니다. 파일 경로는 원본과 동일하게 유지됩니다.
홈 지정 해제	복사본의 is_home은 항상 0(해제) 상태로 생성됩니다.
공개 상태 비공개	복사본의 status는 항상 0(비공개)으로 생성됩니다. 내용 확인 후 직접 공개로 전환하세요.
탭 유지	복사 완료 후 현재 선택된 도메인 탭으로 자동 이동하여 목록을 표시합니다.

9. 페이지 삭제

목록의 [🗑 삭제] 버튼 클릭 시 "삭제하시겠습니까?" 확인 창이 표시됩니다. 확인 클릭 시 즉시 삭제됩니다.

🚨  삭제는 즉시 실행되며 복구가 불가능합니다. Editor 방식 + Global 위치 페이지는 서버의 PHP 파일까지 함께 삭제됩니다. 중요한 페이지는 삭제 전 반드시 [복사] 기능으로 백업하세요.

9.1 삭제 처리 상세

DB 레코드 삭제	pages 테이블에서 해당 페이지 레코드를 완전히 삭제합니다.
PHP 파일 삭제 조건	page_type=editor 인 경우에만 pages/ 폴더의 실제 .php 파일을 삭제합니다. (보안상 DX_PAGES 경로 외 파일은 삭제하지 않음)
File 방식 파일 보존	page_type=file 로 등록된 경우 지정된 PHP 파일은 삭제하지 않습니다. DB 레코드만 삭제되고 실제 파일은 서버에 유지됩니다.
삭제 후 이동	삭제 완료 후 현재 활성화된 도메인 탭의 목록 페이지로 자동 이동합니다.

10. 멀티사이트 환경에서의 페이지 관리

여러 도메인을 운영하는 멀티사이트 환경에서 정적 페이지 관리 화면에 도메인별 탭이 표시됩니다. 각 도메인의 페이지를 독립적으로 관리할 수 있습니다.

10.1 도메인 탭 구성

전체 탭	모든 도메인의 페이지를 하나의 목록에서 확인. 전체 관리 현황 파악 용도.
글로벌 탭	site_domain이 비어있는 공용 페이지만 표시. 약관, 개인정보처리방침 등 공통 페이지 관리.
도메인별 탭	해당 도메인에 귀속된 페이지만 표시. 각 사이트의 홈페이지, 소개 페이지 등을 분리 관리.
현재 도메인	현재 관리자가 접속한 도메인은 항상 탭 목록에 포함. sites 테이블에 미등록된 경우에도 자동 추가됨.

10.2 도메인별 페이지 시나리오 예시

아래 예시는 2개 도메인을 운영하는 멀티사이트 환경의 페이지 구성 예입니다.
 

페이지 용도	슬러그	domain 귀속	접근 방법
이용약관	/terms	글로벌 (공통)	모든 도메인에서 /terms
개인정보처리방침	/privacy	글로벌 (공통)	모든 도메인에서 /privacy
A사이트 홈	/home	asite.com	asite.com/home
B사이트 회사소개	/about	bsite.com	bsite.com/about

💡  글로벌(공통) 페이지는 어느 도메인에서도 같은 슬러그로 접근 가능합니다. 도메인 전속 페이지와 공통 페이지를 혼합하여 효율적으로 운영할 수 있습니다.

11. 실전 활용 예시

자주 사용되는 정적 페이지 유형별 권장 설정을 안내합니다.

예시 1: 이용약관 페이지

설정 항목	권장 값
페이지 명칭	이용약관
슬러그	terms
도메인 귀속	글로벌 (공통) — 모든 사이트에서 공유
콘텐츠 방식	에디터 직접 입력
저장 경로	글로벌 (pages/terms.php 자동 생성)
노출 상태	ACTIVE (공개)
접근 권한	모든 방문자 허용 (비회원 포함)
메타 제목	서비스 이용약관 | 사이트명

예시 2: 사이트 홈페이지 랜딩

설정 항목	권장 값
페이지 명칭	메인 홈
슬러그	home
도메인 귀속	특정 도메인 선택 (해당 사이트 전용)
콘텐츠 방식	PHP 파일 직접 지정 (복잡한 레이아웃 구현)
파일명	home.php (서버에 미리 업로드)
홈페이지 지정	체크 (is_home = 1)
독립형 모드	선택 사항 (풀페이지 랜딩이면 체크 권장)

예시 2: 사이트 홈페이지 랜딩

설정 항목	권장 값
페이지 명칭	메인 홈
슬러그	home
도메인 귀속	특정 도메인 선택 (해당 사이트 전용)
콘텐츠 방식	PHP 파일 직접 지정 (복잡한 레이아웃 구현)
파일명	home.php (서버에 미리 업로드)
홈페이지 지정	체크 (is_home = 1)
독립형 모드	선택 사항 (풀페이지 랜딩이면 체크 권장)

예시 3: 로그인 회원 전용 안내 페이지

설정 항목	권장 값
페이지 명칭	회원 전용 서비스 안내
슬러그	members-guide
노출 상태	ACTIVE (공개)
접근 권한	로그인 회원만 (레벨 1)
홈페이지 지정	미체크
독립형 모드	미체크 (테마 레이아웃 포함)

예시 4: 팝업 전용 이벤트 페이지

설정 항목	권장 값
페이지 명칭	봄맞이 이벤트 안내
슬러그	event-spring
콘텐츠 방식	에디터 직접 입력 (배너 이미지 + 텍스트)
독립형 모드	체크 (is_standalone = 1) — 팝업 전용, 헤더/푸터 없음
접근 권한	모든 방문자 허용
노출 상태	이벤트 기간 중 ACTIVE, 종료 후 HIDDEN으로 전환

12. 자주 묻는 질문 (FAQ)

Q1. 에디터 방식과 파일 방식, 어떤 것을 선택해야 하나요?

A. 비개발자가 내용을 직접 작성•수정하는 일반 텍스트/이미지 콘텐츠 페이지(회사소개, 약관 등)는 에디터 방식을 선택하세요. 개발자가 PHP로 직접 제작한 복잡한 레이아웃이나 동적 기능이 포함된 페이지(이벤트 랜딩, 회원 대시보드 등)는 파일 방식을 사용하세요.

Q2. 슬러그를 잘못 입력했습니다. 변경해도 되나요?

A. 수정 폼에서 슬러그를 변경할 수 있습니다. 단, 슬러그 변경 시 기존 URL(/이전슬러그)로의 접근이 불가능해집니다. 이미 검색 엔진에 색인된 URL이거나 외부에서 링크된 URL이라면, 메뉴 관리에서 리다이렉트를 설정하거나 웹 서버 수준(.htaccess)에서 리다이렉트를 처리하세요.

Q3. 홈페이지로 설정했는데 사이트 접속 시 홈이 표시되지 않습니다.

A. 다음을 확인하세요: ① 해당 페이지가 ACTIVE(공개) 상태인지 확인. ② 해당 도메인의 페이지로 올바르게 귀속되었는지 확인. ③ 독립형 모드(is_standalone)가 의도치 않게 체크되지 않았는지 확인. ④ 캐시가 있다면 캐시를 초기화하세요.

Q4. 에디터로 작성한 내용이 사라졌습니다.

A. 에디터 방식의 경우 내용이 pages/슬러그.php 파일에 저장됩니다. 서버에서 이 파일을 직접 수정하거나 삭제한 경우 내용이 사라질 수 있습니다. 파일의 쓰기 권한(chmod)을 확인하고, 정기적으로 파일을 백업하는 습관을 들이세요.

Q5. 삭제한 페이지를 복구할 수 있나요?

A. DB에서 삭제 후 복구는 불가능합니다. 단, 이미 서버에서 pages/ 폴더의 .php 파일이 삭제된 경우에도 서버 백업이 있다면 파일만 복원한 후 새 페이지로 등록하면 됩니다. 중요한 페이지는 반드시 삭제 전 [복사] 버튼으로 백업하세요.

Q6. 테마 전용(Theme) 위치를 사용하려면 어떻게 하나요?

A. ① 파일 방식(File)을 선택하고 ② Theme 위치를 선택합니다. ③ themes/테마명/page/ 폴더에 미리 PHP 파일을 업로드한 후 ④ 파일명 입력란에 파일명(예: about.php)을 입력하고 저장합니다.

Q7. 페이지 접근 권한(access_level)을 설정했는데 비회원이 접근됩니다.

A. 접근 권한은 CMS 레벨에서 처리되므로, 테마와 라우터가 올바르게 구성되어 있어야 합니다. access_level 설정 후 테마의 라우터 코드가 해당 값을 읽어 처리하도록 구현되어 있는지 개발자에게 확인하세요.

Q8. 독립형(is_standalone) 모드에서 특정 JS/CSS를 사용하려면?

A. 독립형 모드에서는 테마 레이아웃이 없으므로 기본 스타일시트나 스크립트가 로드되지 않습니다. 에디터 방식이라면 본문 내에 직접 <link>나 <script> 태그를 삽입하거나, 파일 방식으로 PHP 파일을 제작하여 필요한 리소스를 직접 로드하세요.

13. 용어 정리

용어	설명
slug	URL 경로에 사용되는 고유 식별자. 영문·숫자·하이픈·언더바 가능. 예: about, terms, privacy-policy.
page_type: editor	브라우저 에디터로 내용을 직접 작성하는 방식. 저장 시 pages/ 폴더에 PHP 파일 자동 생성.
page_type: file	서버에 미리 업로드된 PHP 파일 경로를 직접 지정하는 방식. 에디터 없이 파일명만 등록.
page_location: global	파일이 pages/ 공용 폴더에 저장. 모든 사이트에서 공용 사용 가능.
page_location: theme	파일이 themes/테마명/page/ 폴더에 위치. 해당 테마에서만 작동.
site_domain	페이지가 귀속된 도메인. 비어있으면 글로벌(공통), 값이 있으면 해당 도메인 전용.
is_home	해당 페이지를 사이트의 메인 홈페이지로 지정. 같은 도메인 내 1개만 활성화 가능.
is_standalone	테마 레이아웃 없이 본문만 단독 렌더링하는 독립형 모드. 팝업·랜딩페이지에 활용.
access_level	페이지 접근 가능 최소 권한 레벨. 0: 전체, 1: 회원, 9: 관리자.
status	페이지 공개 상태. 1: 공개(ACTIVE), 0: 비공개(HIDDEN).
sort_order	관리자 목록에서 페이지 표시 순서. 숫자가 작을수록 앞에 위치.
meta_title	HTML <title> 및 og:title에 사용될 SEO 제목.
meta_desc	HTML <meta name="description">에 사용될 SEO 설명.
DX_PAGES	DXCMS 글로벌 페이지 파일 저장 디렉토리. 서버 절대 경로 상수.
CSRF 토큰	폼 위조 공격 방지 보안 토큰. 모든 POST 저장·삭제 요청에 자동 포함.
PRG 패턴	Post-Redirect-Get. 저장 후 자동 리다이렉트하여 새로고침 시 중복 저장 방지.