1. 게시판 관리 개요

DXCMS 관리자 패널의 [게시판 관리] 메뉴는 사이트에서 사용되는 모든 게시판을 생성•수정•삭제하고, 세부 옵션(권한•기능•디자인)을 제어하는 핵심 관리 도구입니다. 본 가이드는 각 항목의 의미와 올바른 설정 방법을 상세히 안내합니다.

📌  접근 경로: 관리자 대시보드 상단 메뉴 → 게시판 관리 (또는 URL: /admin/boards)

1.1 화면 구성

게시판 관리 페이지는 좌측 2/3 영역의 게시판 목록 패널과 우측 1/3 영역의 생성•수정 사이드바로 구성됩니다.
 

영역	설명
게시판 목록 (좌측)	그룹별로 분류된 전체 게시판 목록 표시. 각 게시판의 상태·타입·권한 정보를 한눈에 확인.
생성·수정 사이드바 (우측)	새 게시판 생성 또는 기존 게시판 설정 수정 폼. 저장 버튼 클릭 시 즉시 반영.
사이트 필터 탭	멀티사이트 환경에서 도메인별로 게시판을 필터링하여 표시.
상단 바로가기 버튼	[카테고리 관리] 및 [그룹 관리] 페이지로 바로 이동할 수 있는 링크 버튼.

2. 게시판 목록 패널

좌측 목록 패널에는 모든 게시판이 그룹 단위로 묶여 카드 형태로 표시됩니다. 각 항목에서 게시판의 상태를 즉시 파악하고 빠른 동작을 수행할 수 있습니다.

2.1 게시판 행 정보

표시 요소	설명
상태 인디케이터 (점)	초록색 점(깜빡임) = 활성, 빨간색 점 = 비활성. 비활성 게시판은 전체 행이 흐릿하게 표시됩니다.
게시판 이름	굵은 글씨로 표시. 클릭 또는 수정(✏️) 버튼으로 설정 편집 가능.
게시판 키 (코드)	/board_key 형태의 회색 코드 배지. URL 경로에 직접 사용되는 고유 식별자.
게시판 타입 배지	일반(파랑), 갤러리(보라), Q&A(노랑), FAQ(초록), 뉴스(빨강)로 색상 구분.
스킨 배지	기본(default)이 아닌 스킨 사용 시 파란색 배지로 스킨명 표시.
도메인 배지	특정 도메인에 귀속된 게시판은 초록색 도메인 배지, 공통 게시판은 회색 "전체 공통" 배지.
권한·기능 요약	읽기 레벨, 쓰기 레벨, 목록 출력수, 댓글·파일 사용 여부를 작은 텍스트로 표시.

2.2 각 게시판 액션 버튼

각 게시판 행의 오른쪽에는 아이콘 버튼 7개가 위치합니다.
 

아이콘	기능	설명
🔗	게시판 보기	해당 게시판 목록 페이지를 새 탭에서 바로 미리볼 수 있습니다.
🏷	카테고리 관리	해당 게시판의 카테고리 관리 페이지로 이동합니다. 카테고리 사용 설정 시에만 표시됩니다.
✏️	설정 수정	우측 사이드바에 해당 게시판 설정을 불러와 편집 모드로 전환합니다.
📋	게시판 복사	현재 게시판의 설정 전체를 복사하여 새 게시판 키로 복제합니다. 게시글은 복사되지 않습니다.
📂	그룹 이동	게시판을 다른 그룹으로 이동합니다. 모달 창에서 대상 그룹을 선택합니다.
🔒	비활성화	게시판을 일시적으로 비활성화합니다. 데이터는 보존되며 status=0으로 변경됩니다.
🗑	완전 삭제	게시판과 모든 하위 데이터(게시글·댓글·파일·카테고리·메뉴)를 영구 삭제합니다. 복구 불가.

3. 새 게시판 생성

우측 사이드바 폼을 사용하여 새 게시판을 생성합니다. 각 필드의 의미와 유의사항을 아래에서 자세히 설명합니다.

3.1 Domain 노출 범위 (멀티사이트)

사이드바 상단의 어두운 배경 영역에서 이 게시판을 어느 도메인에 귀속시킬지 선택합니다. 멀티사이트 환경에서 각 도메인별로 별도 게시판을 운영할 때 사용합니다.
 

선택 값	동작
── 모든 사이트 공통 ──	도메인에 관계없이 모든 사이트에서 접근 가능한 공통 게시판으로 생성됩니다.
특정 도메인 선택	해당 도메인에서만 표시·접근되는 게시판으로 생성됩니다. 다른 도메인에서는 노출되지 않습니다.

3.2 기본 정보

게시판 키 *	영문 소문자·숫자·하이픈·언더바만 허용. URL 경로로 직접 사용됩니다. 예: notice, free_board, gallery-2026. 생성 후 변경 불가.
게시판 이름 *	관리자 및 사용자에게 표시되는 게시판 명칭. 예: 공지사항, 자유게시판, 포토갤러리. 언제든지 수정 가능.
간략 설명	게시판의 목적이나 작성 안내 등 부가 설명을 입력합니다. 일부 스킨에서 게시판 상단에 표시될 수 있습니다.

게시판 키는 한 번 생성하면 변경할 수 없습니다. 서버의 업로드 폴더 경로(data/uploads/게시판키/)와 연동되어 있기 때문입니다. 신중하게 결정하세요.

3.3 그룹 및 에디터 설정

소속 그룹	게시판을 특정 그룹에 배치합니다. 그룹은 [그룹 관리] 메뉴에서 미리 생성해야 합니다. 그룹 없음(최상위)을 선택하면 독립 표시됩니다.
에디터 설정	"전역 설정 사용": 시스템 전체 에디터 설정 적용. "에디터 없음": 텍스트만 입력 가능한 기본 텍스트박스. 또는 활성화된 플러그인 에디터(예: CKEditor) 선택 가능.

3.4 게시판 타입

게시판의 용도에 맞는 레이아웃과 기능 세트를 결정합니다. 타입 변경은 기존 데이터에 영향을 주지 않으나, 스킨도 함께 변경하는 것을 권장합니다.
 

타입	적합한 용도	특징
일반 (normal)	공지사항, 자유게시판, Q&A 기반 게시판	기본 테이블 목록형. 제목·글쓴이·날짜·조회수 표시. 대부분의 용도에 적합.
갤러리 (gallery)	사진첩, 포트폴리오, 미디어 갤러리	썸네일 이미지 카드 그리드 형식. 이미지 중심의 시각적 게시판.
Q&A (qa)	고객센터, 문의게시판, 기술 지원	질문·답변 구조. 답변 여부 상태 표시. 1:1 소통 형태에 최적화.
FAQ (faq)	자주 묻는 질문, 도움말	아코디언(펼침) 방식. 질문을 클릭하면 답변이 펼쳐지는 구조.
뉴스 (news)	뉴스레터, 블로그, 매거진	대표 이미지·요약 중심의 카드 레이아웃. 콘텐츠 중심 디자인.

3.5 갤러리 썸네일 설정 (갤러리 타입 전용)

게시판 타입을 [갤러리]로 설정하면 썸네일 설정 영역이 자동으로 표시됩니다.
 

설정 항목	설명 및 옵션
유형 (thumb_type)	자르기(Crop): 지정 크기로 정확히 잘라냄. 비율 유지(Fit): 이미지 비율 유지하며 지정 영역 내 배치. 가로 고정(width): 가로만 고정, 세로는 자동. 세로 고정(height): 세로만 고정, 가로는 자동.
크롭 기준 (thumb_crop)	자르기(Crop) 유형 선택 시 기준점 지정. 가운데(center): 이미지 중앙을 기준으로 자름. 상단(top): 이미지 윗부분 기준. 좌측(left): 이미지 왼쪽 기준.
가로/세로 (px)	썸네일 가로·세로 픽셀 크기 지정. 범위: 50~1,200px. 권장값: 가로 600px, 세로 400px. 갤러리 레이아웃에 따라 조정하세요.
썸네일 캐시 정리	서버에 저장된 미사용 썸네일 파일을 일괄 삭제합니다. 게시글이 삭제된 후 남은 고아 파일을 제거합니다.
썸네일 전체 재생성	현재 설정 크기로 모든 게시글 썸네일을 다시 생성합니다. 크기 변경 후 기존 썸네일에 반영할 때 사용. 게시글 수에 따라 시간이 소요됩니다.

💡  썸네일 크기를 변경하고 저장하면, 기존 썸네일이 자동으로 초기화되어 다음 게시글 접근 시 새 크기로 재생성됩니다. 즉시 전체 반영이 필요하면 [썸네일 전체 재생성] 버튼을 사용하세요.

3.6 디자인 스킨

게시판의 프론트엔드 레이아웃•디자인을 결정합니다. 스킨은 /skins/board/ 경로에 설치된 것들이 자동으로 목록에 표시됩니다.

💡  게시판 타입을 [갤러리]로 변경하면 스킨도 자동으로 gallery로, [일반형]으로 변경하면 default로 자동 설정됩니다. 필요에 따라 수동으로 다시 선택할 수 있습니다.

4. 권한 설정 및 페이징

4.1 권한 레벨 체계

DXCMS는 0•1•9의 3단계 권한 레벨로 읽기•쓰기•댓글 쓰기 권한을 제어합니다.
 

레벨	대상	설명
0	전체 (비회원 포함)	로그인하지 않은 방문자도 접근 가능. 공개 게시판에 적합.
1	회원 (로그인 필요)	로그인한 일반 회원만 접근 가능. 가장 일반적인 설정.
9	관리자 전용	관리자 권한을 가진 계정만 접근 가능. 내부 공지·비밀 게시판에 활용.

4.2 권한 항목별 설명

읽기 권한 (read_level)	게시판 목록 및 게시글 내용을 볼 수 있는 최소 레벨. 레벨 미달 시 로그인 페이지로 이동하거나 접근 거부 메시지가 표시됩니다.
쓰기 권한 (write_level)	새 글을 작성할 수 있는 최소 레벨. 읽기 권한보다 높게 설정하는 것이 일반적입니다.
댓글 권한 (comment_level)	댓글을 작성할 수 있는 최소 레벨. 댓글 사용 기능이 활성화된 경우에만 적용됩니다.

4.3 페이징 설정

목록 출력수 (per_page)	한 페이지에 표시할 게시글 수. 기본값: 20. 갤러리형은 12~16, 일반형은 20~30이 권장됩니다.
정렬 순서 (sort_order)	게시판 목록에서의 표시 순서. 숫자가 작을수록 앞에 표시됩니다. 같은 그룹 내 게시판의 노출 순서를 조정합니다.

5. 상세 기능 설정

사이드바 하단의 체크박스 영역에서 각 게시판에서 활성화할 추가 기능을 선택합니다. 각 기능은 독립적으로 켜고 끌 수 있습니다.
 

기능명	내부 필드명	상세 설명
💬 댓글 사용	use_comment	게시글 하단에 댓글 입력 영역을 표시합니다. 댓글 작성 권한은 "댓글 권한(comment_level)" 설정에 따릅니다. 대댓글(답글) 기능도 함께 활성화됩니다.
📎 파일 첨부	use_file	게시글 작성 시 파일 업로드 기능을 활성화합니다. 최대 첨부 파일 수는 "파일 개수(file_count)" 필드로 제어합니다. 업로드된 파일은 data/uploads/게시판키/ 경로에 저장됩니다.
📌 공지 기능	use_notice	게시글을 공지글로 고정 표시하는 기능을 활성화합니다. 공지글은 목록 상단에 항상 표시되며, 관리자 또는 쓰기 권한자가 설정할 수 있습니다.
🏷 분류(카테고리) 사용	use_category	게시글을 카테고리로 분류하는 기능을 활성화합니다. 활성화 후 [카테고리 관리] 메뉴에서 해당 게시판의 카테고리를 추가·편집해야 합니다.
🔖 태그 사용	use_tag	게시글에 태그를 입력하고 태그별 검색·필터링을 가능하게 합니다. 스킨에서 태그 표시 영역이 지원되어야 화면에 나타납니다.
🕵 익명 쓰기	use_anonymous	로그인 없이(또는 로그인 후에도) 익명으로 게시글을 작성할 수 있게 합니다. 작성자명이 "익명" 등으로 표시됩니다.
📋 뷰에서 목록 표시	show_list_in_view	게시글 상세 보기 페이지에서 다른 게시글 목록을 함께 표시합니다. 사용자가 게시글 하단에서 바로 다른 글로 이동 가능.
🗺 경로(브레드크럼) 표시	use_breadcrumb	게시판 및 게시글 페이지 상단에 현재 위치 경로(홈 > 게시판명 > 게시글명)를 표시합니다. 기본값: 활성화(체크됨).
📊 설문 사용	use_survey	게시글에 투표/설문 첨부 기능을 활성화합니다. 설문 기능 플러그인이 활성화된 경우에만 정상 동작합니다.

6. 게시판 복사 • 그룹 이동 • 삭제

6.1 게시판 복사

동일한 설정의 게시판을 빠르게 생성할 때 활용합니다. 목록에서 [📋 복사] 버튼 클릭 시 모달이 열립니다.

📝  복사 절차: ① 복사할 게시판의 [📋] 버튼 클릭 → ② 모달 창에서 새 게시판 키 입력 → ③ [복사하기] 클릭.

주의사항:

• 게시글•댓글•파일 등 실제 데이터는 복사되지 않습니다. 설정(권한, 기능, 스킨 등)만 복사됩니다.
• 새 게시판 키는 영문•숫자•하이픈•언더바만 허용되며, 이미 사용 중인 키는 사용할 수 없습니다.
• 복사 후 게시판 이름 뒤에 " (복사)"가 자동으로 추가됩니다. 이름은 이후 수정 가능합니다.

6.2 그룹 이동

게시판을 다른 그룹으로 재배치합니다. 목록에서 [📂 그룹 이동] 버튼 클릭 시 그룹 선택 모달이 열립니다.

📝  이동 절차: ① [📂] 버튼 클릭 → ② 모달에서 이동할 그룹 선택 → ③ [그룹 이동] 클릭.

그룹 없음(최상위)으로 이동하면 어느 그룹에도 속하지 않은 독립 게시판이 됩니다. 그룹은 [그룹 관리] 메뉴에서 미리 생성해야 선택 가능합니다.

6.3 게시판 비활성화 (일시 중단)

게시판을 일시적으로 사용 불가 상태로 전환합니다. 데이터는 보존되며 언제든지 다시 활성화할 수 있습니다.

📝  비활성화 절차: ① [🔒 비활성화] 버튼 클릭 → ② "비활성화하시겠습니까?" 확인 창 → ③ 확인 클릭.

비활성화된 게시판은 목록에서 흐릿하게 표시(opacity 60%)되며 빨간 점으로 상태가 표시됩니다. 프론트엔드에서 해당 게시판 URL 접근 시 게시판이 표시되지 않습니다.

6.4 게시판 완전 삭제 (영구 삭제)

게시판과 하위 데이터를 모두 영구 삭제합니다. 이 작업은 되돌릴 수 없습니다.

🚨  완전 삭제는 복구가 불가능합니다. 반드시 중요한 게시글을 백업한 후 진행하세요.

삭제 절차:

1. 목록에서 [🗑 완전 삭제] 버튼 클릭
2. 삭제 모달이 열리며 게시판명, 게시판 키, 삭제 항목 체크리스트 표시
3. 게시글이 있는 경우: "게시글이 있습니다" 경고와 함께 게시판 키 직접 입력 필드 표시 → 게시판 키 정확히 입력
4. [완전 삭제] 버튼이 활성화되면 클릭하여 삭제 실행

삭제되는 항목:

• 모든 게시글 (status=1인 게시글 전체)
• 댓글 및 대댓글
• 첨부파일 (서버 파일 포함, data/uploads/게시판키/ 폴더 전체 삭제)
• 업로드 이미지
• 게시판 카테고리
• 이 게시판 URL을 포함한 메뉴 항목
• 좋아요•스크랩 데이터
• 설문•투표 데이터

7. 멀티사이트 도메인 필터

2개 이상의 도메인을 운영하는 멀티사이트 환경에서 게시판 목록 상단에 도메인 탭이 표시됩니다.
 

전체 탭	도메인 구분 없이 모든 게시판을 표시합니다. 기본 선택 상태입니다.
도메인별 탭	해당 도메인에 귀속된 게시판만 필터링하여 표시합니다. (현재) 표시가 있는 탭이 현재 접속 도메인입니다.
새 게시판 생성 시 연동	특정 도메인 탭이 선택된 상태에서 게시판 생성 시, 사이드바 도메인 선택이 해당 도메인으로 자동 설정됩니다.

💡  사이트 관리 메뉴에서 도메인을 등록해야 탭이 표시됩니다. 단일 사이트 환경에서는 이 탭이 표시되지 않습니다.

8. 자주 사용하는 게시판 설정 예시

아래 예시를 참고하여 용도에 맞는 게시판을 빠르게 설정하세요.

예시 1: 공지사항 게시판

설정 항목	권장 값
게시판 키	notice
게시판 타입	일반 (normal)
읽기 권한	0 (전체 공개)
쓰기 권한	9 (관리자 전용)
공지 기능	활성화
댓글	비활성화 또는 필요 시 활성화
목록 출력수	20

예시 2: 자유게시판

설정 항목	권장 값
게시판 키	free
게시판 타입	일반 (normal)
읽기 권한	1 (회원)
쓰기 권한	1 (회원)
댓글	활성화 (댓글 권한: 1)
파일 첨부	활성화 (필요 시)
카테고리	필요 시 활성화 후 카테고리 추가
태그	활성화 권장

예시 3: 포토갤러리

설정 항목	권장 값
게시판 키	gallery
게시판 타입	갤러리 (gallery)
디자인 스킨	gallery (자동 선택됨)
썸네일 유형	자르기 (Crop), 크롭 기준: 가운데
썸네일 크기	가로 600px, 세로 400px (권장)
파일 첨부	활성화 필수 (이미지 업로드)
목록 출력수	12 또는 16 (그리드 배치 고려)

예시 4: 고객센터 Q&A

설정 항목	권장 값
게시판 키	qna
게시판 타입	Q&A (qa)
읽기 권한	1 (작성자 본인 및 관리자만)
쓰기 권한	1 (회원)
파일 첨부	활성화 (증빙 자료 첨부용)
카테고리	활성화 후 문의 유형 카테고리 추가

9. 자주 묻는 질문 (FAQ)

Q1. 게시판 키를 잘못 입력했습니다. 변경할 수 있나요?

A. 게시판 키는 생성 후 변경이 불가능합니다. 새 키로 게시판을 [복사]한 후 원본을 [완전 삭제]하는 방법을 사용하세요. 단, 첨부파일 경로가 변경되므로 파일 데이터는 별도로 이전해야 합니다.

Q2. 갤러리 썸네일이 표시되지 않습니다.

A. 파일 첨부 기능이 활성화되어 있는지 확인하세요. 또한 data/uploads/ 폴더에 쓰기 권한(chmod 755 또는 777)이 있는지 서버에서 확인하세요. 이미지 업로드 후에도 표시 안 되면 [썸네일 전체 재생성] 버튼을 클릭하세요.

Q3. 같은 게시판이 여러 도메인에서 보이게 하려면?

A. 게시판 생성 시 도메인을 "── 모든 사이트 공통 ──"으로 선택하세요. 특정 도메인을 선택하면 해당 도메인에서만 접근됩니다.

Q4. 카테고리 관리는 어디서 하나요?

A. 상단의 [카테고리 관리] 버튼 또는 각 게시판 행의 [🏷] 아이콘을 클릭하면 카테고리 관리 페이지로 이동합니다. 먼저 게시판의 [분류 사용] 옵션을 활성화해야 합니다.

Q5. 게시판 그룹 기능이 보이지 않습니다.

A. 마이그레이션(migrate_v1.4.0.php 실행)이 필요합니다. 페이지 상단의 노란색 경고 배너의 링크를 클릭하여 마이그레이션을 실행하세요.

Q6. 비활성화된 게시판을 다시 활성화하려면?

A. 목록에서 비활성화된 게시판의 [✏️ 수정] 버튼을 클릭하면 사이드바에 설정이 로드됩니다. [설정 수정] 버튼을 클릭하면 상태가 활성(status=1)으로 복원됩니다.

Q7. 에디터를 게시판마다 다르게 설정하려면?

A. 각 게시판 수정 화면의 "에디터 설정"에서 해당 게시판에 적용할 에디터를 선택하세요. "전역 설정 사용"은 시스템 기본 에디터를 따릅니다. 플러그인 메뉴에서 에디터 플러그인을 먼저 활성화해야 목록에 표시됩니다.

11. 용어 정리

용어	설명
board_key	게시판을 고유하게 식별하는 영문 코드. URL 경로 및 파일 저장 경로에 사용됨. 생성 후 변경 불가.
board_type	게시판 레이아웃 유형 (normal/gallery/qa/faq/news). 프론트엔드 표시 방식을 결정.
skin	게시판의 디자인 템플릿. /skins/board/ 경로에 설치. board_type 변경 시 자동 연동 가능.
group_id	게시판이 속한 그룹 ID. migrate_v1.4.0.php 실행 후 활성화되는 기능.
read_level / write_level	게시판 접근·작성 최소 권한 레벨 (0: 전체, 1: 회원, 9: 관리자).
per_page	게시판 목록 한 페이지당 표시할 게시글 수.
sort_order	같은 그룹 내 게시판 표시 순서. 숫자가 작을수록 앞에 위치.
use_comment	댓글 기능 사용 여부 (0: 비활성, 1: 활성).
use_file	파일 첨부 기능 사용 여부 (0: 비활성, 1: 활성).
use_notice	공지글 설정 기능 사용 여부.
use_category	카테고리 분류 기능 사용 여부.
use_tag	태그 기능 사용 여부.
use_anonymous	익명 작성 기능 사용 여부.
show_list_in_view	게시글 상세 보기 페이지에 목록 표시 여부.
use_breadcrumb	경로(브레드크럼) 표시 여부.
use_survey	설문/투표 기능 사용 여부.
thumb_type	갤러리 썸네일 생성 방식 (crop/fit/width/height).
thumb_w / thumb_h	갤러리 썸네일 가로/세로 크기 (픽셀).
thumb_crop	썸네일 자르기(Crop) 기준점 (center/top/left).
site_domain	멀티사이트 환경에서 게시판이 귀속될 도메인. 빈 값이면 모든 사이트 공통.
status	게시판 활성화 상태 (1: 활성, 0: 비활성).
DxThumb	썸네일 자동 생성을 담당하는 DXCMS 내부 클래스.
CSRF 토큰	폼 위조 방지를 위한 보안 토큰. 모든 POST 요청에 자동 포함됨.