1. 카테고리(분류) 관리 개요

DXCMS의 [카테고리 관리] 메뉴는 게시판의 게시글을 주제별로 분류하는 카테고리(분류) 항목을 생성•편집•삭제•관리하는 도구입니다. 카테고리를 사용하면 방문자가 원하는 주제의 게시글만 빠르게 필터링할 수 있으며, 게시판의 정보 구조를 체계적으로 구성할 수 있습니다.

📌  접근 경로: 관리자 대시보드 → 카테고리 관리 (또는 URL: /admin/categories) 게시판 관리 → 카테고리 사용 체크된 게시판의 [🏷 카테고리 관리] 버튼으로도 접근 가능.

1.1 카테고리 주요 특징

특징	설명
무제한 계층 구조	최상위 분류 아래 하위 분류를 무제한으로 중첩 생성할 수 있습니다. parent_id 기반 트리 구조로 계층이 관리됩니다.
게시판별 독립 관리	각 게시판마다 독립적인 카테고리 체계를 구성합니다. A 게시판의 카테고리는 B 게시판과 완전히 분리됩니다.
슬러그 자동 생성	분류명에서 영문을 추출해 URL 슬러그를 자동으로 생성합니다. 수동 입력 불필요.
노출 위치 이중 제어	목록탭(게시판 상단 탭) 표시 여부와 뷰배지(게시글 제목 옆 배지) 표시 여부를 각각 독립적으로 설정 가능.
색상 개별 지정	카테고리마다 6가지 색상(파랑/초록/빨강/주황/보라/회색) 중 하나를 선택해 시각적으로 구분.
탭 디자인 스킨	게시판별로 카테고리 탭 영역의 디자인 스킨을 선택할 수 있습니다.
활성/비활성 토글	카테고리를 삭제하지 않고 일시적으로 비활성화하여 숨길 수 있습니다.

1.2 화면 레이아웃 구조

카테고리 관리 화면은 좌측의 게시판 선택 사이드바와 우측의 메인 영역(분류 설정 + 추가/수정 폼 + 분류 트리 목록)으로 구성됩니다.
 

영역	설명
게시판 선택 사이드바 (좌측)	활성(status=1) 게시판 전체 목록. 사이트 필터 드롭다운·키워드 검색·ON/OFF 상태 배지 표시. 게시판 클릭 시 우측에 해당 게시판 카테고리 관리 화면이 표시됩니다.
분류 기능 설정 바 (우측 상단)	선택된 게시판의 카테고리 사용 여부와 탭 디자인 스킨을 설정하는 영역.
추가/수정 폼 (우측 중간)	새 카테고리 추가 또는 기존 카테고리 수정 폼. 분류명·색상·순서·목록탭·뷰배지·상태 입력.
분류 트리 리스트 (우측 하단)	등록된 카테고리를 계층 트리 구조로 시각화. 각 항목마다 하위 추가·수정·활성토글·삭제 버튼 제공.
가이드 배너 (최하단)	사용법 요약 가이드가 항상 고정 표시됩니다.

2. 게시판 선택 사이드바

카테고리 관리의 첫 단계는 왼쪽 사이드바에서 카테고리를 관리할 게시판을 선택하는 것입니다. 사이드바는 화면을 스크롤해도 상단에 고정(sticky)됩니다.

2.1 사이트 필터 드롭다운

멀티사이트 환경에서 여러 도메인의 게시판이 뒤섞이지 않도록 사이트별로 필터링합니다.
 

필터 옵션	표시 범위
🌐 전체 사이트	모든 도메인의 게시판을 함께 표시합니다. 기본 선택값.
🌍 글로벌 (공통)	site_domain이 비어있는 모든 사이트 공통 게시판만 표시합니다.
특정 도메인 선택	선택한 도메인에 귀속된 게시판만 표시합니다. 도메인명과 사이트명이 함께 표시됩니다.

💡  드롭다운에서 사이트를 선택하면 폼이 자동으로 제출되어 즉시 필터링 결과가 표시됩니다.

2.2 게시판 키워드 검색

게시판이 많을 때 게시판명 또는 게시판 키(URL 경로)로 빠르게 검색할 수 있습니다. 검색어를 입력하고 🔍 버튼을 클릭하거나 Enter 키를 눌러 검색합니다. [X] 버튼으로 검색 필터를 초기화합니다.

2.3 게시판 목록 ON/OFF 배지

각 게시판 행 왼쪽에 카테고리 기능 활성화 상태가 배지로 표시됩니다.
 

배지	의미
ON	해당 게시판에서 카테고리(분류) 기능이 활성화된 상태입니다. 방문자가 이 게시판의 카테고리 탭을 볼 수 있습니다.
OFF	해당 게시판에서 카테고리 기능이 비활성화된 상태입니다. 카테고리를 미리 만들어두고 기능을 켜고 끌 때 사용합니다.

2.4 게시판 선택 방법

목록에서 관리할 게시판을 클릭하면 해당 게시판이 선택되어 우측 메인 영역에 카테고리 관리 화면이 표시됩니다. 선택된 게시판은 왼쪽 파란색 세로선과 하늘색 배경으로 강조됩니다. 게시판명 아래에 /게시판키 경로와 귀속 도메인이 함께 표시됩니다.

💡  게시판을 선택하지 않으면 우측 메인 영역에 "왼쪽 목록에서 분류를 관리할 게시판을 선택해 주세요." 안내가 표시됩니다.

3. 분류 기능 설정 바

게시판을 선택하면 우측 상단에 "[게시판명] 분류 기능 설정" 바가 표시됩니다. 카테고리 기능 사용 여부와 탭 디자인 스킨을 이곳에서 설정하고 [설정 저장] 버튼으로 저장합니다.

3.1 이 게시판에서 분류 기능 사용함 (use_category)

체크박스로 해당 게시판에서 카테고리 기능을 켜거나 끕니다.
 

상태	동작
체크 (ON)	프론트엔드 게시판 목록 상단에 카테고리 탭 영역이 표시됩니다. 게시글 작성 시 카테고리 선택 드롭다운이 활성화됩니다. 좌측 사이드바에서 해당 게시판의 배지가 빨간색 ON으로 표시됩니다.
미체크 (OFF)	카테고리 탭 영역이 숨겨집니다. 카테고리를 미리 만들어두고 기능만 끄는 방식으로 임시 비활성화할 수 있습니다. 좌측 배지는 회색 OFF로 표시됩니다.

카테고리 기능 사용 설정과 게시판 관리에서의 use_category 설정은 동일한 필드를 수정합니다. 게시판 관리 → 상세 기능 설정의 [분류 사용] 체크박스와 연동됩니다

3.2 탭 디자인 스킨 (cat_skin)

게시판 목록 상단에 표시되는 카테고리 탭 영역의 디자인 스킨을 선택합니다. DxCategory::getAvailableSkins()가 반환하는 스킨 목록에서 선택합니다.
 

default (기본)	기본 스킨. 일반적인 탭 형태의 카테고리 필터 UI.
추가 스킨	/skins/category/ 경로에 설치된 사용자 정의 스킨이 있으면 목록에 추가로 표시됩니다.

💡  스킨 설정은 게시판 관리의 cat_skin 필드와 동일합니다. 어느 화면에서 저장해도 같은 값이 반영됩니다.

4. 카테고리 추가 및 수정 폼

분류 기능 설정 바 아래에 카테고리를 추가하거나 수정하는 폼이 표시됩니다. 상황에 따라 3가지 모드로 동작합니다.

4.1 폼 모드 3가지

모드	진입 방법	특징
✨ 최상위 분류 추가	게시판 선택 직후 기본 상태	parent_id=0으로 최상위 카테고리를 생성합니다. 폼 헤더에 "최상위 분류 추가"로 표시됩니다.
➕ 하위 분류 추가	트리 목록에서 [＋ 하위] 버튼 클릭	클릭한 카테고리의 하위로 카테고리를 추가합니다. URL에 parent_id=N이 포함됩니다. 폼 헤더에 "하위 분류 추가" 및 상위 분류명이 표시됩니다.
✏️ 분류 수정	트리 목록에서 [✏️ 수정] 버튼 클릭	기존 카테고리 정보가 폼에 자동으로 채워집니다. 폼 헤더에 "분류 수정하기"와 해당 카테고리명이 표시됩니다. 상태(status) 드롭다운이 추가로 표시됩니다.

4.2 분류명 (name) — 필수

게시판 탭과 게시글 배지에 표시되는 카테고리 이름입니다.
 

필수 항목	비워두면 "분류 이름을 입력하세요." 오류가 발생합니다.
슬러그 자동 생성	이름에서 영문만 추출해 소문자로 변환하고 공백을 하이픈(-)으로 치환하여 slug를 자동 생성합니다. 영문이 2자 미만이면 cat-[랜덤8자리] 형식의 슬러그가 생성됩니다. 수동 입력 불필요.
한글 가능	한글, 영문, 숫자 모두 분류명으로 사용 가능합니다.
자동 포커스	페이지 로드 시 분류명 입력 필드에 자동으로 커서가 위치합니다(autofocus).

4.3 색상 (color)

카테고리를 시각적으로 구분하는 색상입니다. 선택한 색상은 분류 트리 목록의 컬러 점과 게시판 탭•배지에 적용됩니다.
 

색상명	HEX 코드	권장 용도
● 파랑 (blue)	#3b82f6	일반·기본·공지 카테고리. 가장 많이 사용되는 중립 색상.
● 초록 (green)	#22c55e	완료·성공·정보 카테고리. 긍정적인 내용.
● 빨강 (red)	#ef4444	긴급·경고·오류 카테고리. 주의 요망 내용.
● 주황 (orange)	#f97316	이벤트·프로모션·주목 카테고리. 이벤트성 분류.
● 보라 (purple)	#a855f7	프리미엄·특별·VIP 카테고리. 특수 분류.
● 회색 (slate)	#64748b	기타·일반·미분류 카테고리. 중립적인 분류.

4.4 순서 (sort_order)

같은 계층(같은 parent_id)의 카테고리끼리 표시 순서를 결정합니다. 숫자가 작을수록 앞에 표시됩니다. 기본값은 0이며, 같은 순서 값이면 ID 오름차순으로 정렬됩니다.

💡  최상위 카테고리끼리의 순서와 하위 카테고리끼리의 순서는 각각 독립적으로 관리됩니다. 카테고리 추가 시 0, 1, 2 또는 0, 10, 20 등으로 설정하세요.

4.5 목록탭 / 뷰배지 표시 설정

카테고리의 두 가지 노출 위치를 각각 독립적으로 제어합니다. 두 항목 모두 기본값이 체크(표시)입니다.
 

옵션	내부 필드	표시 위치 및 설명
목록탭 (show_in_list)	show_in_list	게시판 목록 페이지 상단의 카테고리 필터 탭 영역에 이 카테고리가 탭으로 표시됩니다. 체크 해제 시 목록 탭에서 숨겨지지만 카테고리 자체는 유지됩니다.
뷰배지 (show_in_view)	show_in_view	게시글 상세 보기 페이지에서 제목 옆에 카테고리 배지가 표시됩니다. 체크 해제 시 상세 보기에서 배지가 숨겨집니다.

💡  숨김 목적으로 카테고리를 비활성화하기 전에, 목록탭과 뷰배지만 개별적으로 끄는 방법도 고려하세요. 예를 들어 "기타" 카테고리는 목록탭에는 표시하지 않고(필터 탭 숨김), 뷰배지는 표시(게시글에 배지는 보임)하도록 설정할 수 있습니다.

4.6 상태 (수정 모드 전용)

카테고리 수정 모드에서만 표시되는 드롭다운입니다. 카테고리를 삭제하지 않고 일시적으로 비활성화할 때 사용합니다.
 

상태값	동작
활성 (status=1)	카테고리가 정상적으로 사용됩니다. 목록탭·뷰배지 설정에 따라 프론트엔드에 표시됩니다.
비활성 (status=0)	카테고리가 숨겨집니다. 분류 트리 목록에서는 반투명(opacity 60%)으로 표시되며 "(비활성)" 배지가 함께 표시됩니다. 프론트엔드에서는 표시되지 않습니다.

5. 분류 트리 목록

추가/수정 폼 아래에 등록된 모든 카테고리가 계층 트리 구조로 시각화됩니다. 최상위 카테고리는 들여쓰기 없이, 하위 카테고리는 ├─ / └─ 기호로 계층을 표현합니다.

5.1 트리 행 구성 요소

구성 요소	설명
계층 들여쓰기 기호	├─ : 같은 계층에 다음 형제 카테고리가 있는 경우. └─ : 같은 계층의 마지막 카테고리. 깊이(depth)마다 들여쓰기 선이 추가됩니다.
컬러 점	카테고리에 설정된 색상의 작은 원형 점. 마우스 호버 시 확대됩니다. 색상 발광(glow) 효과가 적용됩니다.
카테고리명	최상위 분류는 굵은 다크 텍스트, 하위 분류는 중간 굵기 그레이 텍스트. 마우스 호버 시 하늘색으로 변경됩니다.
(비활성) 배지	status=0인 카테고리에 빨간색 (비활성) 배지가 표시됩니다. 행 전체가 반투명(opacity 60%)으로 표시됩니다.
N Subs 배지	하위 카테고리가 있는 경우 직계 하위 수를 회색 배지로 표시합니다. 예: "3 Subs"는 직접 하위 3개.
목록/뷰 옵션 배지	show_in_list와 show_in_view 설정 상태를 배지로 표시. 활성 시 파랑/초록 강조, 비활성 시 회색으로 표시됩니다.

5.2 트리 행 관리 버튼

버튼	기능	상세 설명
＋ 하위	하위 분류 추가	클릭하면 URL에 parent_id=[현재ID]가 추가되어 하위 카테고리 추가 폼으로 전환됩니다. 폼 헤더에 "상위: [현재 카테고리명]"이 표시됩니다.
✏️ 수정	카테고리 수정	/admin/categories/{id}?board_id=N 으로 이동하여 해당 카테고리의 폼이 수정 모드로 전환됩니다.
활성/비활성	상태 토글	클릭 즉시 status를 0↔1로 전환합니다. 활성 상태에서는 "비활성" 버튼(노란색), 비활성 상태에서는 "활성" 버튼(초록색)이 표시됩니다.
🗑 삭제	영구 삭제	확인 창 후 해당 카테고리와 모든 하위 카테고리를 함께 삭제합니다. 하위가 있으면 확인 창에 "하위 분류(N개)도 함께 삭제됩니다." 경고가 포함됩니다.

5.3 분류 트리 정렬 방식

카테고리 트리는 _build_tree() 함수가 parent_id 기반으로 계층을 구성하며, 같은 계층 내에서 sort_order 오름차순으로 정렬됩니다. DB 조회 시 sort_order ASC, id ASC 순으로 정렬된 후 트리로 재구성됩니다.

6. 저장 및 삭제 처리 상세

6.1 카테고리 추가(add) 처리

1. CSRF 토큰 검증
2. 분류명(name) 필수 검증 — 빈 값이면 오류
3. 게시판 선택(board_id) 검증 — 0이면 "게시판을 선택하세요." 오류
4. depth•path 계산 — parent_id=0이면 depth=0, path="0". parent_id>0이면 부모 카테고리 조회 후 depth=부모depth+1, path=부모path/부모ID
5. 슬러그 자동 생성 — _cat_slug(name) 함수로 영문 추출 및 변환
6. categories 테이블 INSERT — board_id, parent_id, name, slug, sort_order, depth, path, status=1, show_in_list, show_in_view, color, badge_color, created_at 저장
7. 카테고리 캐시 초기화 — DxCache::deletePrefix("cat_board_")
8. "[이름] 분류가 추가되었습니다." 성공 메시지 표시

6.2 카테고리 수정(edit) 처리

1. CSRF 토큰 검증
2. id와 name 검증 — 둘 중 하나라도 없으면 처리 안 함
3. categories 테이블 UPDATE — name, sort_order, show_in_list, show_in_view, color, badge_color, status 업데이트
4. 카테고리 캐시 초기화
5. "분류가 수정되었습니다." 성공 메시지 표시

💡  수정 시 slug는 변경되지 않습니다. 이름이 바뀌어도 기존 URL 슬러그가 유지되어 SEO에 영향이 없습니다.

6.3 카테고리 삭제(delete) 처리

1. 삭제는 해당 카테고리와 모든 하위 카테고리를 함께 삭제합니다. path 컬럼 기반으로 하위를 찾습니다.
2. 삭제 대상 카테고리 ID 확인
3. path LIKE '%/{ID}/%' 또는 '%/{ID}' 조건으로 하위 카테고리 전체 삭제
4. id={ID}로 자신도 삭제 (위에서 누락된 경우 대비)
5. 카테고리 캐시 초기화
6. "분류와 하위 분류가 삭제되었습니다." 성공 메시지 표시

🚨  삭제된 카테고리는 복구할 수 없습니다. 하위 카테고리가 있는 카테고리를 삭제하면 모든 하위도 함께 삭제됩니다. 임시로 숨기려면 삭제 대신 [비활성] 버튼을 사용하거나 show_in_list/show_in_view를 해제하세요.

6.4 상태 토글(toggle) 처리

1. 트리 목록의 [비활성]/[활성] 버튼 클릭 시 즉시 status가 반전됩니다.
2. id와 새로운 status 값(0 또는 1) 수신
3. categories 테이블 UPDATE — status 컬럼만 변경
4. 카테고리 캐시 초기화
5. "상태가 변경되었습니다." 메시지 표시

💡  상태 토글은 해당 카테고리 단독으로만 변경됩니다. 상위 카테고리를 비활성화해도 하위 카테고리의 status는 변경되지 않습니다. 하위 카테고리까지 모두 숨기려면 각각 따로 비활성화하거나 상위 카테고리를 삭제해야 합니다.

6.5 오류 메시지 및 대처

오류 메시지	원인 및 해결
분류 이름을 입력하세요.	분류명 필드가 비어있습니다. 카테고리 이름을 입력하고 다시 저장하세요.
게시판을 선택하세요.	board_id가 0입니다. 왼쪽 게시판 목록에서 게시판을 먼저 선택 후 다시 시도하세요.

7. 카테고리 계층 구조 상세

DXCMS 카테고리는 parent_id, depth, path 세 가지 컬럼으로 무제한 계층을 관리합니다.

7.1 계층 관련 DB 컬럼

컬럼	데이터 형식	설명
parent_id	INT	부모 카테고리 ID. 최상위 카테고리는 0. 하위 카테고리는 부모의 id값.
depth	INT	계층 깊이. 최상위=0, 1단 하위=1, 2단 하위=2... 자동 계산됩니다.
path	VARCHAR	조상 ID 경로. 최상위="0", 하위="0/1", 그 하위="0/1/5"... 삭제 시 하위 탐색에 사용됩니다.

7.2 계층 구조 예시

다음은 3단계 계층 카테고리 구조의 예시입니다.
 

ID	카테고리명	depth	path 값
1	자유게시판	0	0
3	└─ 유머	1	0/1
7	└─ 짤방	2	0/1/3
2	정보공유	0	0
5	├─ IT/기술	1	0/2
6	└─ 생활정보	1	0/2

💡  ID 7(짤방)을 삭제하면 path LIKE '%/7/%' 또는 '%/7' 조건으로 하위를 찾아 모두 삭제합니다. 이 예시에서는 짤방(ID 7)만 삭제됩니다. ID 3(유머)을 삭제하면 유머(3)와 짤방(7, path="0/1/3")이 함께 삭제됩니다.

8. 전체 사용 절차

8.1 게시판에 카테고리 처음 설정하는 절차

1. 관리자 → [카테고리 관리] 메뉴 이동
2. 왼쪽 사이드바에서 카테고리를 추가할 게시판 클릭
3. 우측 상단 "분류 기능 설정" 바에서 [이 게시판에서 분류 기능 사용함] 체크
4. 원하는 탭 디자인 스킨 선택 (없으면 default 유지)
5. [설정 저장] 버튼 클릭하여 카테고리 기능 활성화
6. 추가/수정 폼에서 분류명 입력, 색상•순서•목록탭•뷰배지 설정
7. [신규 추가] 버튼 클릭 → 트리 목록에 최상위 카테고리 추가됨 확인
8. 하위 카테고리가 필요하면 해당 항목의 [＋ 하위] 버튼 클릭 후 동일 절차 반복
9. 모든 카테고리 추가 완료 후 사이트에서 해당 게시판 목록을 확인하여 탭 정상 표시 확인

8.2 기존 카테고리 수정 절차

1. 왼쪽 사이드바에서 해당 게시판 클릭
2. 분류 트리 목록에서 수정할 카테고리의 [✏️] 버튼 클릭
3. 폼에 기존 정보가 자동으로 채워짐 확인
4. 분류명, 색상, 순서, 목록탭, 뷰배지, 상태 중 변경할 항목 수정
5. [저장하기] 버튼 클릭 → "분류가 수정되었습니다." 메시지 확인
6. 취소 시 [X 취소] 링크 클릭하여 추가 모드로 복귀

9. 실전 활용 예시

게시판 유형별 카테고리 구성 예시를 안내합니다.

예시 1: 자유게시판 (2단계 계층)

Depth	분류명	색상	순서	목록탭	뷰배지	비고
0	유머	주황	0	ON	ON
1	└─ 짤방	주황	0	ON	ON
0	정보공유	파랑	1	ON	ON
0	기타	회색	99	OFF	ON	탭은 숨김

예시 2: 고객센터 FAQ (단일 계층)

Depth	분류명	색상	순서	목록탭	뷰배지	비고
0	회원/계정	파랑	0	ON	ON
0	결제/환불	초록	1	ON	ON
0	배송/수령	주황	2	ON	ON
0	서비스 이용	보라	3	ON	ON
0	기타 문의	회색	99	ON	ON

예시 3: 공지사항 게시판 (카테고리로 중요도 구분)

Depth	분류명	색상	순서	목록탭	뷰배지	비고
0	🚨 긴급공지	빨강	0	ON	ON	강조 색상
0	서비스 공지	파랑	1	ON	ON
0	이벤트	주황	2	ON	ON
0	업데이트	초록	3	ON	ON

10. 자주 묻는 질문 (FAQ)

Q1. 카테고리를 추가했는데 게시판 목록에 탭이 표시되지 않습니다.

A. 다음을 순서대로 확인하세요. ① 분류 기능 설정 바에서 [이 게시판에서 분류 기능 사용함]이 체크되어 있고 [설정 저장]을 클릭했는지 확인. ② 카테고리의 status가 1(활성)인지 확인. ③ show_in_list(목록탭)가 체크되어 있는지 확인. ④ 테마가 카테고리 탭 영역을 지원하는지 확인(dx-category-tab 클래스 영역이 템플릿에 포함되어야 합니다).

Q2. 카테고리 탭은 표시되는데 게시글 상세에서 배지가 안 보입니다.

A. 해당 카테고리의 show_in_view(뷰배지) 항목이 체크되어 있는지 확인하세요. 체크 해제 시 상세 보기에서 배지가 숨겨집니다. 또한 테마의 게시글 뷰 템플릿에 카테고리 배지 출력 코드가 있는지 개발자에게 확인하세요.

Q3. 하위 카테고리를 추가하려면 어떻게 하나요?

A. 트리 목록에서 상위 카테고리 행의 [＋ 하위] 버튼을 클릭하면 폼이 하위 분류 추가 모드로 전환됩니다. 폼 헤더에 "상위: [부모 카테고리명]"이 표시됩니다. 이 상태에서 분류명을 입력하고 [신규 추가]를 클릭하면 해당 카테고리의 하위로 추가됩니다.

Q4. 카테고리의 상위/하위 계층을 변경(이동)할 수 있나요?

A. 현재 버전에서 카테고리의 계층 이동(parent_id 변경)은 지원되지 않습니다. 계층을 변경하려면 기존 카테고리를 삭제하고 원하는 위치에 새로 추가해야 합니다. 이때 해당 카테고리를 선택한 기존 게시글의 카테고리 연결도 수동으로 수정해야 합니다.

Q5. 카테고리를 비활성화하면 해당 카테고리로 분류된 기존 게시글은 어떻게 되나요?

A. 기존 게시글의 카테고리 연결 데이터(post_category_id)는 그대로 유지됩니다. 카테고리가 비활성화되면 프론트엔드에서 해당 카테고리 탭과 배지가 숨겨지지만, 게시글 자체는 삭제되지 않습니다. 카테고리를 다시 활성화하면 연결 관계가 그대로 복원됩니다.

Q6. 같은 이름의 카테고리를 다른 게시판에 만들 수 있나요?

A. 네, 가능합니다. 카테고리는 게시판별로 독립 관리됩니다. A 게시판의 "공지" 카테고리와 B 게시판의 "공지" 카테고리는 서로 다른 레코드로 분리되어 있습니다.

Q7. 카테고리 슬러그를 수동으로 설정하거나 수정할 수 있나요?

A. 현재 관리자 UI에서는 슬러그를 직접 수정하는 기능을 제공하지 않습니다. 분류명에서 자동 생성된 슬러그가 사용됩니다. DB를 직접 수정하면 변경 가능하지만 권장하지 않습니다.

Q8. 카테고리 순서를 드래그 앤 드롭으로 변경할 수 있나요?

A. 현재 버전에서는 드래그 앤 드롭 정렬을 지원하지 않습니다. 각 카테고리의 [✏️ 수정] 버튼으로 sort_order 값을 수동으로 변경하여 순서를 조정하세요.

11. 용어 정리

용어	설명
categories	카테고리 데이터를 저장하는 DB 테이블. id, board_id, parent_id, name, slug, depth, path, sort_order, status, show_in_list, show_in_view, color, badge_color, created_at 컬럼.
board_id	이 카테고리가 속한 게시판 ID. 카테고리는 게시판별로 독립 관리됩니다.
parent_id	부모 카테고리 ID. 0이면 최상위. 하위 카테고리는 부모의 id 값.
depth	계층 깊이. 최상위=0, 1단 하위=1, 2단 하위=2. 자동 계산됩니다.
path	조상 ID 경로 문자열. 최상위="0", 1단 하위="0/{부모ID}". 하위 카테고리 일괄 삭제에 활용.
slug	카테고리 URL 식별자. 분류명에서 영문 추출해 자동 생성. 수동 입력 불가.
sort_order	같은 계층(같은 parent_id)의 카테고리 표시 순서. 낮을수록 앞에 표시.
status	카테고리 활성 여부. 1: 활성, 0: 비활성. 비활성 시 프론트에 미표시.
show_in_list	게시판 목록 상단 카테고리 필터 탭에 이 카테고리를 표시할지 여부.
show_in_view	게시글 상세 보기에서 제목 옆 카테고리 배지를 표시할지 여부.
color / badge_color	카테고리 색상. blue/green/red/orange/purple/slate 중 하나. 두 컬럼은 동일 값으로 저장됩니다.
use_category	boards 테이블의 컬럼. 해당 게시판에서 카테고리 기능 사용 여부.
cat_skin	boards 테이블의 컬럼. 게시판 카테고리 탭 영역 디자인 스킨.
_build_tree()	플랫 배열(DB 조회 결과)을 parent_id 기반 트리 구조로 변환하는 PHP 함수. 같은 계층에서 sort_order 오름차순 정렬.
_cat_slug()	분류명에서 영문을 추출해 소문자 하이픈 슬러그로 변환하는 PHP 함수.
DxCache::deletePrefix("cat_board_")	카테고리 변경 시 호출되어 카테고리 관련 캐시를 일괄 초기화하는 메서드.
DxCategory::getAvailableSkins()	설치된 카테고리 탭 스킨 목록을 반환하는 메서드. 스킨 선택 드롭다운에 사용.
목록탭	게시판 목록 페이지 상단에 표시되는 카테고리 필터 탭 영역.
뷰배지	게시글 상세 보기 페이지에서 제목 옆에 표시되는 카테고리 라벨 배지.
CSRF 토큰	폼 위조 공격 방지 토큰. 추가/수정/삭제/토글 모든 POST 요청에 자동 포함.