VENOX CMS의 위젯은 페이지 본문에 [widget:위젯키] 한 줄을 넣어 쓰는 기능 블록입니다. 이 글은 자주 쓰는 위젯 8종의 동작, 넣는 코드, 바꿀 수 있는 값을 한곳에 모았습니다. 화면은 venox.kr에서 실제로 위젯을 띄워 캡처했습니다.
| 위젯 | 숏코드 | 주로 쓰는 곳 |
|---|---|---|
| 통합검색 | search_widget_v1 | 검색 페이지 |
| 문의하기 폼 | contact_form_v1 | 문의·견적·제휴 접수 |
| 캘린더 | calendar_v1 | 행사·교육 일정 |
| AI 챗봇 | ai_chatbot_v1 | 안내·상담 |
| 동의 관리 | consent_v1 | 약관·개인정보 동의 |
| 메인 비주얼 | main_visual_v1 | 첫 화면 슬라이드 |
| 위치 지도 | location_map_v1 | 오시는 길 |
| 정책뉴스 | policy_news_v1 | 협회·기관 소식 |
넣는 방법
관리자 화면 페이지 관리에서 위젯을 넣을 페이지를 엽니다.
원하는 위치에 숏코드를 붙여 넣고 저장합니다.
값이 필요한 위젯은
[widget:위젯키 이름="값"]처럼 씁니다. 따옴표는 곧은 따옴표(")여야 합니다. 문서 프로그램에서 복사하다 둥근 따옴표(“ ”)로 바뀌면 값이 적용되지 않습니다.
위젯마다 CSS 파일이 따로 있고 클래스 이름 앞에 위젯 고유의 접두어(통합검색 .sw-, 문의 폼 .cf-, 캘린더 .cw- 등)가 붙습니다. 위젯 모양을 고쳐도 다른 화면에 영향을 주지 않는 이유입니다. 기본 디자인은 관리자 화면 CSS 관리에서 고치고, 사이트별로 다르게 하려면 사이트용 덮어쓰기 파일을 추가합니다.
통합검색
게시물과 페이지를 한 번에 찾습니다. 공지와 자료가 많은 기관 홈페이지에서 방문자가 메뉴를 뒤지지 않고 원하는 글로 바로 가게 하는 용도입니다.
입력을 0.3초 멈추면 일치하는 게시물 제목을 최대 12개까지 추천
결과를 전체·게시판·페이지 탭으로 나누고 탭마다 건수 표시
제목과 본문 요약(검색어 앞뒤 80자)에서 검색어 강조
시작일·종료일로 게시물 결과 좁히기
최근 검색어 최대 10개는 방문자 브라우저에만 저장
삭제된 글과 비밀글은 결과에서 제외
[widget:search_widget_v1]
[widget:popular_keyword_v1 maxCount="10" showRank="true"]인기 검색어는 집계가 아니라 운영자가 고르는 방식입니다. 관리자 화면의 인기 검색어 메뉴에서 알리고 싶은 키워드를 순서대로 등록합니다.
문의하기 폼
어느 페이지에나 넣을 수 있는 접수 폼입니다. 접수된 문의는 관리자 화면에 쌓이고, 받는 주소를 지정하면 담당자에게 HTML 메일로도 보냅니다.
항목 선택: 이름, 이메일, 연락처, 제목, 문의 유형, 내용
문의 유형을 쉼표로 나열하면 선택 목록이 생김
스팸 차단: 사람에게 보이지 않는 입력란, 같은 IP에서 1분에 5건 넘는 접수 제한
메일 서버는 관리자 화면에서 설정하고 테스트 메일로 확인
[widget:contact_form_v1 form_name="제휴 문의" fields="name,email,phone,category,message"
categories="견적,제휴,기술지원" to="담당자@도메인"]| 값 | 설명 | 기본값 |
|---|---|---|
| fields | 보여 줄 항목 (name, email, phone, subject, category, message) | name,email,phone,message |
| categories | 문의 유형 목록, 쉼표로 구분 | 없음 (선택 목록 숨김) |
| to | 알림을 받을 이메일 | 없음 (메일 안 보냄) |
| form_name / form_desc | 폼 제목 / 설명 | 문의하기 / 없음 |
| success_msg / submit_label | 접수 완료 문구 / 버튼 문구 | 기본 문구 |
캘린더
월 단위 달력에 일정을 보여 줍니다. 일정에는 제목, 시작일, 종료일, 색상, 내용을 넣습니다. 일정을 누르면 상세 내용과 함께 Google 캘린더에 추가 버튼이 나와, 방문자가 자기 캘린더로 바로 옮겨 갈 수 있습니다.
방문자가 등록한 일정은 등록한 브라우저에서만 고치거나 지울 수 있고, 관리자는 모든 일정을 관리합니다. 사이트가 여러 개라면 site_seq 값으로 어느 사이트의 일정을 보여 줄지 정합니다.
[widget:calendar_v1 site_seq="3"]AI 챗봇
홈페이지 오른쪽 아래에 대화창을 띄웁니다. 단순히 AI에 질문을 넘기는 방식이 아니라, 관리자가 등록한 문서에서 관련 내용을 찾아 함께 보내는 RAG 방식을 쓸 수 있습니다.
| 구분 | 동작 |
|---|---|
| AI 서비스 | OpenAI, Anthropic, Google Gemini 중 선택, 모델 이름 지정 |
| 문서 처리 | 관리자가 문서를 등록하면 500자 단위로 나누고(앞뒤 100자 겹침) 임베딩을 만들어 저장 |
| 답변 근거 | 질문과 가장 가까운 문서 조각 3개를 코사인 유사도로 찾아 지시문에 붙임 |
| 임베딩 모델 | 기본 text-embedding-3-small, 관리자 화면에서 변경 |
| 응답 설정 | 시스템 지시문, 환영 메시지, 창 제목, temperature(기본 0.7), 최대 토큰(기본 1,000), 문서 기반 답변 켜기·끄기 |
| 대화 맥락 | 같은 대화의 이전 메시지를 함께 보내 이어지는 질문에 답함 |
| 기록 | 관리자 화면에서 대화 세션별 기록 조회 |
API 키는 서버에만 저장되고, 방문자 브라우저가 받는 위젯 설정에는 들어가지 않습니다. 같은 AI 설정은 관리자 화면의 AI 메뉴 추천 기능도 함께 씁니다.
[widget:ai_chatbot_v1 title="VENOX 안내" welcome="무엇을 도와드릴까요?"]기관 자료만 근거로 답하고, 출처 표시나 답변 거절 기준까지 엄격하게 관리해야 한다면 설치형 챗봇인 Nexis Chat이 더 맞습니다.
동의 관리
개인정보 수집·이용, 이용약관, 마케팅 수신 같은 동의를 받고 기록합니다. 동의 항목과 안내 문구는 관리자 화면에서 등록합니다.
팝업 방식과 페이지 안 방식(inline) 중 선택
전체 동의 한 번으로 모든 항목 체크
항목마다 필수·선택 표시, 필수에 모두 동의해야 진행
안내 문구는 펼쳐서 전문 확인
항목별 동의 여부·일시·세션·접속 IP 기록
이미 동의한 브라우저에는 팝업을 다시 띄우지 않음
[widget:consent_v1 mode="popup" button_label="동의하고 계속하기" redirect="/"]| 값 | 설명 | 기본값 |
|---|---|---|
| mode | popup 또는 inline | popup |
| button_label | 동의 버튼 문구 | 동의하고 계속하기 |
| redirect | 동의 후 이동할 주소 | 없음 |
| success_msg | 동의 완료 문구 | 기본 문구 |
메인 비주얼
첫 화면의 대형 슬라이드입니다. 슬라이드마다 이미지나 동영상을 고르고, 모바일에서 보여 줄 파일을 따로 지정할 수 있습니다. 동영상은 소리 없이 반복 재생됩니다.
5초마다 넘어가고, 마우스를 올리면 잠시 멈춤
제목·부제는 어두운 막 위에 표시되어 배경과 상관없이 읽힘
링크를 걸고 현재 창·새 창 중 선택
PC에서는 재생·일시정지 버튼 제공, 화면낭독기용 설명 포함
관리자 화면 메인비주얼 관리에서 끌어서 순서 변경, 사용 여부로 잠시 숨기기
[widget:main_visual_v1]위치 지도
카카오맵으로 위치를 보여 주는 '오시는 길' 위젯입니다. 위도·경도와 확대 수준, 말풍선 문구만 정하면 됩니다. 지도 프로그램은 이 위젯이 들어간 페이지에서만 불러오므로 다른 페이지 속도에는 영향이 없습니다. 지도를 불러오지 못하면 안내 문구를 보여 줍니다.
[widget:location_map_v1 lat="37.5665" lng="126.9780" level="3" title="본사"]| 값 | 설명 | 기본값 |
|---|---|---|
| lat / lng | 위도 / 경도 | 37.483333 / 126.987778 |
| level | 확대 수준, 숫자가 작을수록 가깝게 | 3 |
| title | 말풍선 문구 | 오시는 길 |
정책뉴스
수집 프로그램이 대한민국 정책브리핑(korea.kr)에서 지정한 부처의 뉴스를 매일 모으고, 위젯은 그 가운데 승인된 기사를 보여 줍니다. 모은 기사는 바로 공개되지 않고 '대기' 상태로 저장되며, 관리자가 승인한 기사만 홈페이지에 나옵니다. 목록에는 부처 표시, 새 글 표시, 요약, 썸네일과 함께 출처가 표기됩니다.
[widget:policy_news_v1 limit="10"]위젯으로 안 되는 일
위젯은 이미 만들어진 기능을 배치하는 도구입니다. 기관 회원 DB와 연동한 마이페이지, 기존 업무 시스템의 데이터를 보여 주는 화면처럼 기관마다 다른 기능은 새 위젯이나 연동 개발이 필요합니다. 이런 작업은 시스템 연동 개발에서 다룹니다.
관련 글: VENOX CMS 구조 해설 · VENOX CMS 솔루션 · 도입 문의