공식자료

컨택트 모듈

컨택트는 문의 폼을 원하는 대로 구성해 Contact Us 페이지를 만들고, 접수된 내용을 관리 화면에서 처리하는 모듈입니다. 문의가 들어오면 관리자에게 알림 메일이 가고, 접수자에게는 자동응답이 나갑니다. 답변도 관리 화면에서 써서 메일로 보냅니다.

컨택트는 베타 버전입니다. 기능과 데이터 구조가 바뀔 수 있으니 실제 서비스보다는 테스트 환경에서 먼저 확인해 보시기 바랍니다.

설치

스토어에서 컨택트 모듈을 설치합니다.
관리자 > 컨택트로 들어가면 접수 목록 · 페이지 관리 · 폼 관리 · 권한 · 설정 다섯 개 탭이 있습니다.
페이지 관리에서 문의 페이지를 하나 만들고, 폼 관리에서 그 페이지에 쓸 폼을 구성합니다.

페이지 만들기

한 페이지가 하나의 접수 창구입니다. 부서별로 창구를 나누고 싶으면 페이지를 여러 개 만들면 됩니다.

관리자 > 컨택트 > 페이지 관리 > 페이지 만들기에서 다음을 정합니다.

항목	설명
주소(URL)	사이트 주소에 붙는 값. 영문으로 시작하고 영문 · 숫자 · 밑줄만 씁니다
브라우저 제목	브라우저 탭과 검색 결과에 뜨는 제목
접수자 본인 조회	켜면 접수 시 조회용 비밀번호를 받고 접수자가 처리 상태를 볼 수 있습니다. 끄면 일방향 Contact Us 로 동작합니다
파일 첨부 사용	폼에 파일 항목을 넣을 수 있게 합니다
목록 개수	접수자 본인 조회 화면의 한 페이지 목록 수
레이아웃 · 스킨	PC · 모바일 각각 지정. 기본값을 쓰면 사이트 설정을 따릅니다

목록에서는 페이지마다 폼 개수와 접수 건수(신규 건수 포함)를 함께 보여 줍니다. 복사는 설정과 폼 구성만 새 페이지로 옮기고 접수된 내용은 가져오지 않습니다. 삭제하면 그 페이지의 폼 · 접수 내용 · 첨부가 모두 지워집니다.

폼과 항목 구성

폼 관리 > 폼 추가에서 폼을 만들고 그 안에 항목을 채웁니다. 한 페이지에 폼을 여러 개 두면 문의 페이지 위쪽에 폼 선택 탭이 생깁니다. 폼을 지정하지 않고 페이지에 들어오면 "기본 폼으로 사용"에 체크한 폼이 열립니다.

항목은 카드 하나가 입력칸 하나입니다. 채워야 하는 것은 화면에 보일 이름과 입력 방식 둘뿐이고 나머지는 비워도 됩니다.

칸	뜻
화면에 보일 이름	방문자가 보는 항목 이름 (예: 휴대폰 번호)
입력 방식	아래 11종 중 하나
접수자 정보로 저장	이 값을 접수자 정보(이름 · 이메일 · 연락처 · 제목)로도 저장합니다
반드시 채워야 함	비어 있으면 제출이 막힙니다
선택지	선택 목록 · 단일 선택 · 복수 선택일 때 나타납니다. 한 줄에 하나씩
내부 이름	비우면 자동 생성. CSV 내려받기의 열 이름이 됩니다
칸 안 예시 글	입력칸에 흐리게 보이는 안내 문구
칸 아래 설명	입력칸 밑에 붙는 작은 설명

내부 이름 · 예시 글 · 설명은 "상세 설정"으로 접혀 있습니다.

입력 방식 11종

한 줄 텍스트, 여러 줄 텍스트, 이메일, 전화번호, 숫자, 날짜, 선택 목록, 단일 선택, 복수 선택, 파일 첨부, 동의 항목.

동의 항목은 "선택지" 칸이 "약관 본문"으로 바뀝니다. 여기에 적은 글이 스크롤 상자로 표시되고 그 아래 동의 체크박스가 붙습니다. 반드시 채워야 함을 켜면 동의해야만 제출됩니다.

접수자 정보로 저장

접수 목록의 이름 · 이메일 · 연락처 열과 메일 발송에 쓰이는 값입니다. 이메일 역할을 지정한 항목이 하나는 있어야 자동응답과 답변 메일이 나갑니다. 회원이 접수하면 비어 있는 이름 · 이메일은 회원 정보로 채워집니다.

제목 역할을 지정하지 않으면 첫 텍스트 항목의 앞부분을 잘라 목록 제목으로 씁니다.

메일 알림

폼마다 세 가지를 켜고 끕니다. 발송은 엔진의 메일 기능을 그대로 씁니다. 메일 발송이 실패해도 접수 자체는 정상 처리됩니다.

알림	받는 사람	언제
접수 알림	관리자 (수신 주소 여러 개 가능)	문의가 들어온 즉시
자동응답	접수자	문의가 들어온 즉시
답변 메일	접수자	관리자가 답변을 써서 보낼 때

수신 주소를 비우면 관리자 > 컨택트 > 설정의 기본 수신 주소로 갑니다. 자동응답 · 답변 메일 제목과 본문에는 자리표시자를 쓸 수 있습니다.

자리표시자	값
`{name}`	접수자 이름
`{email}`	접수자 이메일
`{title}`	문의 제목
`{form}`	폼 이름
`{date}`	접수 일시
`{site}`	사이트 이름

접수 관리

접수 목록에서 상태 · 폼으로 걸러 보고 이름 · 이메일 · 연락처 · 내용으로 검색합니다. CSV 내려받기는 실제로 등장한 항목을 열로 만들어 주므로, 폼을 고친 뒤에도 예전 접수건이 함께 나옵니다.

상세 화면에서 할 수 있는 일은 셋입니다.

상태 바꾸기 — 신규 · 처리중 · 완료 · 보류
답변 메일 보내기 — 제목과 본문을 쓰면 접수자에게 메일이 갑니다. 발송에 실패해도 이력에는 남습니다
메모 남기기 — 메일로 나가지 않는 내부 기록

답변은 홈페이지에 노출되지 않고 메일로만 나갑니다. 답변을 처음 보내면 상태가 자동으로 처리중이 됩니다(완료 · 보류로 정해 둔 건은 그대로 둡니다).

접수자 본인 조회

페이지 설정에서 켜면 동작합니다.

회원은 자기 접수 내역이 자동으로 보입니다.
비회원은 접수할 때 조회용 비밀번호를 받고, 나중에 이메일 + 비밀번호로 본인 확인을 거쳐 봅니다.

이 화면에서는 접수 내용과 처리 상태만 보입니다. 답변 내용은 메일로만 전달됩니다. 공용 PC를 고려해 "확인 해제" 버튼으로 본인 확인 상태를 지울 수 있습니다.

끄면 문의 페이지와 완료 화면만 남아 일방향 Contact Us 가 됩니다.

권한

권한 탭에서 페이지마다 지정합니다. 사이트맵의 권한 설정과 같은 값을 다룹니다.

권한	막히면
문의 페이지 보기	페이지에 들어가는 순간 차단됩니다
문의 보내기	폼은 보이지만 제출이 거부됩니다
내 문의 내역 확인	본인 조회 화면이 열리지 않습니다

누구나 · 회원 · 비회원 · 관리자 · 지정한 그룹 중에서 고릅니다. 회원 전용 문의 창구로 쓰려면 앞의 두 권한을 회원으로 두세요.

첨부와 스팸 방지

첨부는 엔진 파일 모듈에 저장되며, 관리자 > 컨택트 > 설정에서 파일 1개당 최대 크기 · 접수당 개수 · 허용 확장자를 정합니다.

스팸 방지는 폼 단위로 켭니다. 비회원 접수에 한해 사람 눈에 보이지 않는 입력칸과 폼을 연 뒤 지난 시간을 확인해 자동 제출을 걸러냅니다. 외부 서비스에 가입하거나 키를 발급받을 필요는 없습니다.

설정 탭 전체 항목

항목	설명
발신 이메일 · 발신자 이름	비우면 사이트 기본 발신 주소를 씁니다
기본 수신 주소	폼에 수신 주소를 지정하지 않았을 때 쓰는 주소 (쉼표로 구분)
알림 메일 말머리	관리자 알림 메일 제목 앞에 붙는 문구
답변 메일에 접수 내용 함께 보내기	답변 아래에 원래 문의 내용을 붙입니다
첨부 1개당 최대 크기 (MB)
접수당 첨부 개수
허용 확장자	쉼표로 구분

스킨

기본 스킨 하나가 함께 설치되며 반응형입니다. 헤리티지 테마를 쓰면 테마에 들어 있는 컨택트 스킨이 자동으로 적용되어 테마와 같은 색 · 모서리로 보입니다.

스킨 파일은 modules/contact/skins/default/ 에 있고 화면은 넷입니다.

파일	화면
`form.html`	문의 폼
`complete.html`	접수 완료
`my_list.html`	내 문의 내역 (본인 확인 포함)
`my_view.html`	접수 상세

자주 겪는 일

자동응답이 안 갑니다 — 폼에 이메일 역할을 지정한 항목이 있는지, 자동응답이 켜져 있는지 확인하세요. 접수자 이메일을 모르면 보낼 곳이 없습니다.

관리자 알림이 안 옵니다 — 폼의 수신 주소나 설정의 기본 수신 주소가 비어 있는지 보세요. 둘 다 비면 발송하지 않습니다.

사이트맵에서 컨택트가 안 보입니다 — 설치 직후 한 번은 관리자 > 모듈에서 컨택트 업데이트를 실행해야 사이트맵 목록에 등록됩니다. 페이지 관리 탭에서 만들면 이 과정 없이도 만들 수 있습니다.

폼을 고쳤더니 예전 접수건의 항목 이름이 그대로입니다 — 접수 당시의 항목 이름을 함께 저장하기 때문입니다. 지난 문의는 그때 보였던 이름 그대로 남습니다.