first commit 2

theme/rd.dnssash/js/universal-mailer.js

@@ -0,0 +1,90 @@
+/**
+ * 파일명: universal-mailer.js
+ * 설명: 사이트 전체에서 사용할 수 있는 범용 메일 발송 클라이언트
+ */
+(function(window) {
+    'use strict';
+
+    function UniversalMailer() {}
+
+    /**
+     * AJAX를 통해 지정된 템플릿으로 이메일을 발송합니다.
+     * @param {object} options - 메일 발송 옵션 객체
+     * @param {string} options.template_code - 사용할 메일 템플릿의 고유 코드
+     * @param {object} options.variables - 템플릿에 치환될 변수 객체 (예: {name: "홍길동"})
+     * @param {string|string[]} [options.to_email] - 수신자 이메일. (문자열 또는 배열)
+     * @param {string|string[]} [options.cc_email] - 참조 이메일. (문자열 또는 배열)
+     * @param {string|string[]} [options.bcc_email] - 숨은 참조 이메일. (문자열 또는 배열)
+     * @param {function} [options.onSuccess] - 발송 성공 시 실행될 콜백 함수
+     * @param {function} [options.onError] - 발송 실패 시 실행될 콜백 함수
+     * @param {function} [options.onComplete] - 성공/실패와 관계없이 마지막에 실행될 콜백 함수
+     */
+    UniversalMailer.prototype.send = function(options) {
+        const formData = new FormData();
+        formData.append('template_code', options.template_code);
+
+        // 수신자 처리 (배열 또는 문자열)
+        if (options.to_email) {
+            if (Array.isArray(options.to_email)) {
+                options.to_email.forEach(email => formData.append('to_email[]', email));
+            } else {
+                formData.append('to_email', options.to_email);
+            }
+        }
+
+        // 참조자 처리 (배열 또는 문자열)
+        if (options.cc_email) {
+            if (Array.isArray(options.cc_email)) {
+                options.cc_email.forEach(email => formData.append('cc_email[]', email));
+            } else {
+                formData.append('cc_email', options.cc_email);
+            }
+        }
+
+        // 숨은 참조자 처리 (배열 또는 문자열)
+        if (options.bcc_email) {
+            if (Array.isArray(options.bcc_email)) {
+                options.bcc_email.forEach(email => formData.append('bcc_email[]', email));
+            } else {
+                formData.append('bcc_email', options.bcc_email);
+            }
+        }
+
+        if (options.variables) {
+            for (const key in options.variables) {
+                formData.append(`variables[${key}]`, options.variables[key]);
+            }
+        }
+
+        // GnuBoard의 g5_url 변수를 사용하여 AJAX 요청 URL을 생성합니다.
+        const ajax_url = (typeof g5_url !== 'undefined' ? g5_url : '') + '/adm/mail_manage/ajax_universal_send.php';
+
+        fetch(ajax_url, {
+            method: 'POST',
+            body: formData
+        })
+        .then(response => {
+            if (!response.ok) throw new Error('서버와의 통신에 실패했습니다.');
+            return response.json();
+        })
+        .then(data => {
+            if (data.success) {
+                if (typeof options.onSuccess === 'function') options.onSuccess(data);
+            } else {
+                throw new Error(data.message || '알 수 없는 오류가 발생했습니다.');
+            }
+        })
+        .catch(error => {
+            if (typeof options.onError === 'function') options.onError(error.message);
+        })
+        .finally(() => {
+            if (typeof options.onComplete === 'function') options.onComplete();
+        });
+
+
+    };
+
+    // mailer 객체를 window 전역 객체에 등록하여 어디서든 접근 가능하게 합니다.
+    window.universalMailer = new UniversalMailer();
+
+})(window);