테마 검색¶
1. 메뉴 개요¶
특정 키워드 그룹을 검색했을 때, 사전 정의된 HTML 템플릿을 검색 결과 상단에 노출하는 기능입니다. 캠페인 페이지, 안내 배너, 시즌 특집 등을 검색 결과에 자연스럽게 띄우는 용도로 사용합니다.
2. 메뉴 위치¶
[좌측 메뉴바] > [UI 설정] > [부가기능 관리] > [테마 검색]
URL: /ui/addon/theme
3. 화면 구성¶

| 번호 | 영역 | 설명 |
|---|---|---|
| ① | 페이지 헤더 | 페이지 제목, 우측에 서비스 활성/비활성 토글 |
| ② | 툴바 | [추가] 버튼, 검색어 입력, 서비스 필터, 페이지당 항목 수 |
| ③ | 목록 테이블 | 대표키워드, 키워드, 서비스(Y/N), 템플릿 보유 여부, 조회수, 행별 [저장]·[템플릿 편집]·[삭제] 버튼 |
| ④ | 페이지네이션 | 하단 페이지 이동 |
4. 주요 작업 방법¶
4.1 신규 테마 등록¶
- ② [추가] 버튼을 클릭합니다.
- 모달에서 다음을 입력합니다:
- 대표키워드 (필수)
- 키워드 (필수, 콤마로 여러 개)
- 템플릿 HTML (선택) — 검색 결과 상단에 표시될 HTML
- 서비스 설정 — 예/아니오
- [등록]을 클릭합니다.

4.2 템플릿 편집¶
- ③ 행의
템플릿 편집(</>아이콘) 버튼을 클릭합니다. - 모달이 수정 모드로 열리고 기존 템플릿 HTML이 표시됩니다.
- HTML을 수정한 뒤 [수정 저장]을 클릭합니다.
4.3 인라인 수정 / 삭제¶
- 대표키워드·키워드·서비스 Y/N은 ③ 셀에서 직접 편집 후 행의 [저장] 아이콘 클릭.
- 삭제는 행의 [삭제] 아이콘 클릭 → 확인 창에서 승인.
4.4 서비스 활성/비활성¶
기능 자체를 끄거나 켜려면 ① 헤더의 토글을 사용합니다.
5. 🚨 주의사항¶
HTML 템플릿은 그대로 렌더링됩니다
템플릿에 입력한 HTML이 검색 결과 페이지에 그대로 삽입됩니다. 외부 출처의 스크립트(<script>)나 신뢰할 수 없는 코드는 절대 붙여 넣지 마세요. 검색 페이지 전체가 영향을 받을 수 있습니다.
- 템플릿이 비어 있어도 키워드 매칭은 동작하지만, 사용자에게 노출할 콘텐츠가 없으면 의미가 없습니다.
- 캠페인 종료 시에는 행의 서비스 Y/N을 N으로 바꿔 비노출 처리하거나 삭제합니다.