---

Simple Form Mail Project

• Introduction (소개)
• Key Notes (특징)
• Preview
• Installation (설치)
• Download
• History
• Contact

1. Introduction (소개)

(1) qMailer는 C/C++ CGI 라이브러리 qDecoder로 개발된 폼메일 입니다.

SMTP서버와 직접 소켓(Socket)으로 통신하며 메일을 발송하므로 투명하고 신뢰성이 있는 메일발송이 가능하며 프로그램 수정없이 다양한 폼메일 스킨을 손쉽게 제작/적용할 수 있습니다.

(2) qMailer는 왜 만들게 되었나?

첫번째 이유는 웹상에서 E-mail을 보내거나 다량의 메일링리스트을 처리하는데 있어서 어떠한 요구(예를들면, 다량의 메일발송시 SMTP서버로 메일을 제대로 발송하였는지 확인이 필요한 경우등)에 따라 세밀한 제어를 해야할 경우 root권한이 없으므로 해서 운용서버의 설정을 조절할 수 없거나 sendmail을 이용하더라도 sendmail의 설정에 따라 영향을 받는등의 이유로 고민하다 C/C++을 이용해서 외적요인에 의한 불확실성을 최소화 하면서 직접 SMTP서버와 통신하면서 메일발송을 처리하는 투명하고 신뢰성 있는 CGI 루틴이 필요함을 느꼈습니다.

두번째 이유는 폼을 변경해야 할 경우 소스를 직접 수정해야 함에 따라 실수로 인한 오류의 위험성을 방지하고 소스를 수정할 수 없는 사용자의 경우 자신이 원하는 폼메일 스킨을 만들기 어렵다는 생각에 소스의 수정없이 폼메일 스킨을 만들 수 있는 기능이 필요함을 느끼던중 qDecoder의 qSedFile 기능을 발견하고 만들게 되었습니다.

(3) qMailer는 왜 필요한가?

두가지 측면에서 바라볼 수 있겠습니다.

첫번째는 SMTP서버와의 직접 통신의 필요성에 대한 부분 입니다.

이것은 메일링리스트와 같은 다량의 메일을 발송하는데 있어서 투명하고 신뢰성 있는 결과를 보장하기 위한 것이라고 할 수 있습니다.

만약 다량의 메일을 발송한다고 했을때 어떤 이유로 인하여 발송이 된곳과 안된곳이 있을때 그것을 확인할 방법이 없다면 다량의 메일발송에 대한 어떠한 정책도 세울 수 없을 것입니다.

이런경우 왜 이런문제가 발생했는지, 모두 다시 발송해야할지 아니면 아예 발송하지 말아야 할지에 대한 결정조차 하기 어려울 것입니다.

그렇지만 다량의 메일을 발송하더라도 SMTP서버와 직접 통신을 통하여 발송에 대한 응답을 검증함으로서 미발송 원인과 대책을 결정할 수 있으며 발송된 리스트와 미발송 리스트를 확인할 수 있습니다.

따라서 문제가 발생하더라도 해결가능한 다양한 메일발송 정책을 수립할 수 있어 투명하고 신뢰할 수 있는 다량의 메일발송이 가능한 것입니다.

두번째는 Skin기능의 필요성이라고 볼 수 있습니다.

이것은 기존의 폼메일에 멋내기적인 요소를 덧붙인 것이라고 볼 수도 있겠습니다.

즉, 폼메일을 자신의 취향이나 고객의 요구에 맞게 꾸미는데 편의성을 제공하는 측면입니다.

qDecoder의 qSedFile은 외부 템플릿과 폼 데이터를 결합하여 웹브라우저로 전송해주는 것을 가능하게 함으로 동일한 폼데이타에 대해서 다양한 템플릿을 적용할 수 있습니다.

이러한 다양한 템플릿을 qMailer에서는 skin이라 부르며 skin은 qMailer와 독립적으로 제작이 가능하므로 소스수정에 따른 오류의 위험성이 없습니다.

qMailer에서는 간단한 HTML작업과 몇가지 단순한 설정으로 자신이 원하는 분위기의 폼메일 스킨을 쉽게 제작할 수 있습니다.

기업이 이미지에 어울리는 feedback용 폼메일을 원하거나 개인의 취향에 따라 자신만의 독특한 분위기의 폼메일을 꾸미기를 원하시는 분들이 qMailer를 활용하신다면 좋을 것입니다.

2. Key Notes (특징)

(1) SMTP 포트와 직접 통신하며 메일을 발송 합니다.

(2) qDecoder의 qSedFile함수를 사용하므로 프로그램 수정없이 자신이 원하는 폼메일 스킨을 손쉽게 제작/적용할 수 있습니다.

(3) qMailer관련 옵션은 qMailer.conf에, skin관련 설정은 해당 skin conf파일에 설정하므로 다양한 skin의 적용이 가능 합니다.

3. Preview

(1) simple skin (qMailer skin 학습용) : qMailer 스킨이 어떻게 구성되는지 이해할 수 있는 간단한 스킨 입니다.

preview Simple for GNU/Linux

(2) default skin (qMailer skin 참조용) : qMailer 스킨의 참조용으로 자신의 스킨 제작시 참조할 수 있도록 제작된 스킨 입니다.

preview Default for GNU/Linux

(3) letter skin (qMailer skin 활용예:편지지 skin)

preview Letter for GNU/Linux

(4) postcard skin (qMailer skin 활용예:엽서 skin)

preview Letter for GNU/Linux

(5) pcs skin (qMailer skin 활용예:PCS skin)

preview PCS for GNU/Linux

4. Installation (설치)

(1) 압축해제

qMailer-VERSION.tar.Z는 GNU/Linux 상에서 다음과 같이 압축을 해제 합니다.

$ gunzip < qMailer-VERSION.tar.Z | tar xvf -

qMailer-VERSION 에 해당하는 디렉토리가 생성되며 다음과 유사한 형태로 패키지가 풀려 집니다.

$ cd qMailer-VERSION<br> $ ls -asCF<br> 1 ./ 18 COPYING 1 message/ 2 qMailer.h 2 qSendmail.h<br> 1 ../ 2 Makefile 25 qMailer.c 23 qMailer.o 11 qSendmail.o<br> 1 AUTHORS 13 README 2 qMailer.conf 13 qSendmail.c 1 skin/<br>

Makefile : qMailer.cgi를 만들기 위한 Makefile message/ : mailheader/mailfooter 디렉토리 skin/ : skin 디렉토리(default, simple, letter, postcard, pcs 스킨이 기본으로 들어 있습니다.) qMailer.cgi : qMailer 미리 작성된 CGI qMailer.conf : qMailer 설정파일 qSendmail.c : SMTP Socket통신 소스파일 qSendmail.h : SMTP Socket통신 헤더파일 qmailer.c : qMailer 소스파일 qmailer.h : qMailer 헤더파일

(2) 컴파일

아래와 같이 qMailer.cgi를 만들기 위한 Makefile이 있는 디렉토리로 이동후 make를 실행 합니다.

$ cd qMailer-VERSION $ make gcc -Wall -I. -I../qDecoder-6.0.5/src/ -c -o qMailer.o qMailer.c gcc -Wall -I. -I../qDecoder-6.0.5/src/ -c -o qSendmail.o qSendmail.c gcc -Wall -I. -I../qDecoder-6.0.5/src/ -o qMailer.cgi qMailer.o qSendmail.o ../qDecoder-6.0.5/src/libqDecoder.a $

성공적으로 된경우 qMailer.cgi가 생성 됩니다.

(3) conf파일 설정

qMailer.conf파일과 skin conf파일을 반드시 자신의 시스템에 맞게 설정해 주셔야 됩니다.

• qMailer.conf 설정
  ProgramName = qMailer.cgi : 프로그램 이름 입니다. 수정할 필요 없습니다. ProgramVersion = qMailer-VERSION : 프로그램이름과 버전 입니다. 수정할 필요 없습니다. QMailerURL = qMailer가 설치된 http경로를 설정 합니다.(예:http://yourdomain.com/qMailer/) Server = SMTP 서버 도메인명 또는 IP주소를 설정 합니다.(예:yourdomain.com) Port = SMTP 서버 포트를 설정 합니다. 보통은 25 Domain = SMTP 시작을 위한 도메인 주소를 설정 합니다.(예:yourdomain.com) SkinDirectory = skin 디렉토리를 설정 합니다.(예:skin) DefaultSkin = 디폴트로 사용할 skin명을 설정 합니다.(예:default) MailHeader = message/mailheader.txt : 메일 앞부분에 포함시킬 파일 입니다. 수정할 필요 없습니다. MailFooter = message/mailfooter.txt : 메일 뒷부분에 포함시킬 파일 입니다. 수정할 필요 없습니다.

• skin conf파일 설정

  default skin은 qMailer skin에 대한 참조용 이므로 skin에 대한 의문점은 default skin을 참조하시면 됩니다.
  skin/default/default.conf 파일을 통해 skin conf파일 설정을 알아 보겠습니다.

  BodyToHTML = true #BodyToHTML = false * BodyToHTML은 폼에서 name='qBody'의 내용을 HTML로 변환할것인지 아닌지를 설정 합니다. MailHeaderOption = true #MailHeaderOption = false MailFooterOption = true #MailFooterOption = false * 메일 앞부분과 뒷부분을 포함할것인지 아닌지를 설정 합니다. #SubjectPrefix = true SubjectPrefix = false Subject = qMailer와 함께 있을때, 우린 두려울게 없었뜸미다. * 제목을 미리 고정할 것인지 아닌지를 설정하고 미리 고정할 제목을 설정합니다. TO_NAME_MODE = text #TO_NAME_MODE = hidden FROM_NAME_MODE = text #FROM_NAME_MODE = hidden CC_MODE = text #CC_MODE = hidden BCC_MODE = text #BCC_MODE = hidden HTML_FILE_MODE = file #HTML_FILE_MODE = hidden ATTACH_FILE_MODE = file #ATTACH_FILE_MODE = hidden SUBMIT_MODE = image #SUBMIT_MODE = submit * 폼 요소들을 사용할 것인지 아닌지를 설정 합니다. 각 요소별로 설정이 가능하며 대부분은 사용할 경우 text로 사용 안할 경우 hidden으로 하며 HTML_FILE_MODE와 ATTACH_FILE_MODE는 사용할 경우 file로 사용 안할 경우 hidden으로 SUBMIT_MDOE는 일반 button type일때 submit으로 image type일때 image로 설정합니다. SUBMIT_SKIN_IMAGE = images/submit_skin.gif * 위에서 SUBMIT_MDOE를 이미지로 했을때 해당 이미지파일의 위치를 설정합니다.

(4) skin 제작 및 사용

• skin 파일명
  skin 디렉토리명 : skin명과 같아야 합니다.(예:skin명이 default이면 디렉토리명도 default이어야 합니다.) head 파일 : skin명_head.chtml (필수) form 파일 : skin명_form.chtml (필수 : 폼입력 스킨) send 파일 : skin명_send.chtml (선택 : 받는이에게 폼 데이타와 함께전송할 스킨) post 파일 : skin명_post.chtml (필수 : 메일발송후 보여줄 스킨) tail 파일 : skin명_tail.chtml (필수) * send 파일이 없으면 일반 메일발송과 같이 됩니다.
• skin 제작

  기본적으로 일반 HTML작성과 동일합니다.
  qMailer skin에 사용되는 예약된 폼이름과 SED인자에 대하여 설명 드리겠습니다.

  폼이름 - 각 폼이름은 qMailer에 다음의 내용을 전달 합니다.

  skin : skin명 qTo : 받는사람 E-mail 주소 qToName : 받는사람 이름 qFrom : 보내는 사람 E-mail 주소 qFromName : 보내는 사람 이름 qCC : 참조할 사람 E-mail 주소들 qBCC : 숨은참조할 사람 E-mail 주소들 qSubject : 제목 qBody : 본문 내용 qHTMLFile : 발송할 HTML파일 qAttachFile : 발송할 첨부파일

  SED인자 - 각 SED인자는 qMailer로 부터 다음의 내용을 전달 받습니다.

  ${QMAILER_URL} : qMailer.conf에 설정된 QMailerURL값(send 파일에 필요 합니다.) ${SMTP_ERROR} : SMTP에서 보내온 Error 값 ${SMTP_SEND} : SMTP로 발송된 메일 ${MAIL_HEADER} : MailHeaderOption이 true이면 mailheader.txt의 내용 아니면 "" ${MAIL_FOOTER} : MailFooterOption이 true이면 mailfooter.txt의 내용 아니면 "" ${CGI} : qMailer CGI명 ${CGI_MODE} : mode명 ${SKIN} : skin명 ${TO} : 받는사람 E-mail 주소 ${TO_NAME_OPEN} : TO_NAME 사용여부에 따라 "<!--" 또는 "" ${TO_NAME_MODE} : TO_NAME 사용여부에 따라 "hidden" 또는 "text" ${TO_NAME} : 받는사람 이름 ${TO_NAME_CLOSE} : TO_NAME 사용여부에 따라 "-->" 또는 "" ${FROM} : 보내는 사람 E-mail 주소 ${FROM_NAME_OPEN} : FROM_NAME 사용여부에 따라 "<!--" 또는 "" ${FROM_NAME_MODE} : FROM_NAME 사용여부에 따라 "hidden" 또는 "text" ${FROM_NAME} : 보내는 사람 이름 ${FROM_NAME_CLOSE} : FROM_NAME 사용여부에 따라 "-->" 또는 "" ${CC_OPEN} : CC 사용여부에 따라 "<!--" 또는 "" ${CC_MODE} : CC 사용여부에 따라 "hidden" 또는 "text" ${CC} : 참조할 사람 E-mail 주소들 ${CC_CLOSE} : CC 사용여부에 따라 "-->" 또는 "" ${BCC_OPEN} : BCC 사용여부에 따라 "<!--" 또는 "" ${BCC_MODE} : BCC 사용여부에 따라 "hidden" 또는 "text" ${BCC} : 숨은참조할 사람 E-mail 주소들 ${BCC_CLOSE} : BCC 사용여부에 따라 "-->" 또는 "" ${SUBJECT_PREFIX} : SUBJECT_PREFIX 사용여부에 따라 "value='미리 고정한 제목 값' readonly" 또는 "" ${SUBJECT} : 제목 ${BODY} : 본문 내용 ${MESSAGE} : 본문 내용 + HTML_FILE ${HTML_FILE_OPEN} : HTML_FILE 사용여부에 따라 "<!--" 또는 "" ${HTML_FILE_MODE} : HTML_FILE 사용여부에 따라 "hidden" 또는 "file" ${HTML_FILE_NAME} : HTML 파일명 ${HTML_FILE_SIZE} : HTML 파일크기(KBytes단위) ${HTML_FILE_CLOSE} : HTML_FILE 사용여부에 따라 "-->" 또는 "" ${ATTACH_FILE_OPEN} : ATTACH_FILE 사용여부에 따라 "<!--" 또는 "" ${ATTACH_FILE_MODE} : ATTACH_FILE 사용여부에 따라 "hidden" 또는 "file" ${ATTACH_FILE_NAME} : 첨부 파일명 ${ATTACH_FILE_SIZE} : 첨부 파일크기(KBytes단위) ${ATTACH_FILE_CLOSE} : ATTACH_FILE 사용여부에 따라 "-->" 또는 "" ${SUBMIT_MODE} : submit 유형에 따라 "submit" 또는 "image" ${SUBMIT} : submit 유형에 따라 "value=' 보 내 기 '" 또는 "src='SUBMIT_SKIN_IMAGE 위치값'" 주의 : skin파일에서 폼이름(예:name='qTo')과 SED인자(예:${TO})들은 변경할 수 없습니다.
• skin 사용

  qMailer.cgi?skin=skin명 으로 사용합니다.(예:qMailer.cgi?skin=letter)
  만약 skin명 없이 qMailer.cgi라고 호출하면 qMailer.conf에 설정된 DefaultSkin으로 설정됩니다.

  예제 skin은 다음과 같은 용도와 기능을 하도록 제작되었습니다.

  simple skin은 send 파일 없이 사용한 예 입니다. default skin은 send 파일이 있고 mailheader/mailfooter를 사용하고 HTML_MODE를 사용하지 않고 post 파일에서 ${MESSAGE} 대신 ${BODY}만 출력한 예 입니다. letter skin은 send 파일이 있고 CC_MODE, BCC_MODE, HTML_FILE, ATTACH_FILE을 사용하지 않은 예 입니다. postcard skin은 send 파일이 있고 BodyToHTML을 사용하지 않고 CC_MODE, BCC_MODE, HTML_FILE, ATTACH_FILE을 사용하지 않은 예 입니다. pcs skin은 send 파일이 있고 BodyToHTML을 사용하지 않고 SUBJECT_PREFIX를 사용하고 TO_NAME, FROM_NAME, CC_MODE, BCC_MODE, HTML_FILE, ATTACH_FILE을 사용하지 않은 예 입니다.

5. Download

• qMailer-2.0.tar.Z (2001.09.17)
• qMailer-1.0.2.tar.Z (2001.06.14)
• qMailer-1.0.1.tar.Z (Server 1) or qMailer-1.0.1.tar.Z (Server 2) (2001.05.01)
• qMailer-1.0.tar.Z (2001.04.25)

6. Histoty

• 2001/09/17 qMailer-2.0 Release
  변경 내용 1) qDecoder-7.0.1 Liberary 대응
• 2001/06/14 qMailer-1.0.2 Release
  변경 내용 1) Dan Bernstein의 qMail(Ver1.03)에서 DATA끝에 Bare LF 사용을 금지하는 규정을 지원하도록 sendmail()에서 qMailize 했습니다. (Dan Bernstein의 설명에 의하면 Bare LF 사용을 금지하는 822bis section 2.3 규정을 위반하지 말것을 주장합니다.) (Dan Bernstein의 설명에 의하면 Bare LF란 CR없이 LF만 사용하는 것을 의미합니다.) 2) postmail() 에서 SED 인자 ${SMTP_ERROR} 와 ${SMTP_SEND} 추가 3) Netscape에서 skin 깨지는 부분 수정
• 2001/05/01 qMailer-1.0.1 Release
  변경 내용 1) sendmail(), postmail() 에서 SED 인자 ${MAIL_HEADER}, ${MAIL_FOOTER} 추가 2) sendmail(), postmail() 에서 SED 인자 ${MESSAGE}에 넘기는 내용중 mailheader와 mailfooter 삭제(본문내용과 HTML 파일만 넘어감) 3) default skin에서 send 파일 추가 4) makefile 수정전 $(QLIB): (cd ${QLIBPATH}; make distclean; ./configure; make all) 수정후 $(QLIB): (cd ${QLIBPATH}; ./configure; make all)
• 2001/04/25 qMailer-1.0 Release

7. Contact

문의/개선사항, 버그 리포트등은 아래의 E-mail 주소로 연락주시면 고맙겠습니다.

Dae-heung Park <qmailer@qdecoder.org>

bulletin board