array(
'name' => __('评论通知', 'argon'),
'description' => __('当博客收到新评论时发送给管理员', 'argon'),
'default_subject' => '[{{blog_name}}] 文章收到新评论',
'default_content' => '
文章收到新评论
{{commenter_name}} 在文章《{{post_title}}》中发表了评论:
{{#ai_spam_check}}
🤖 AI 内容审核
识别结果:{{#ai_is_spam}}疑似垃圾评论{{/ai_is_spam}}{{^ai_is_spam}}正常评论{{/ai_is_spam}}
{{#ai_spam_reason}}
识别理由:{{ai_spam_reason}}
{{/ai_spam_reason}}
{{#ai_detection_code}}
识别码:{{ai_detection_code}}
{{/ai_detection_code}}
{{/ai_spam_check}}
查看评论
',
'placeholders' => array(
'blog_name' => __('博客名称', 'argon'),
'post_title' => __('文章标题', 'argon'),
'post_url' => __('文章链接', 'argon'),
'commenter_name' => __('评论者名称', 'argon'),
'commenter_email' => __('评论者邮箱', 'argon'),
'comment_content' => __('评论内容', 'argon'),
'comment_url' => __('评论链接', 'argon'),
'comment_date' => __('评论时间', 'argon'),
'ai_spam_check' => __('是否进行了 AI 审核', 'argon'),
'ai_is_spam' => __('AI 判断是否为垃圾评论', 'argon'),
'ai_spam_reason' => __('AI 识别理由', 'argon'),
'ai_detection_code' => __('AI 识别码', 'argon'),
'theme_color' => __('主题色', 'argon'),
),
),
'reply_notify' => array(
'name' => __('回复通知', 'argon'),
'description' => __('当评论收到回复时发送给原评论者', 'argon'),
'default_subject' => '[{{blog_name}}] 您的评论收到了回复',
'default_content' => '您的评论收到了回复
您在文章《{{post_title}}》中的评论:
{{replier_name}} 回复了您:
查看回复
',
'placeholders' => array(
'blog_name' => __('博客名称', 'argon'),
'post_title' => __('文章标题', 'argon'),
'post_url' => __('文章链接', 'argon'),
'original_comment' => __('原评论内容', 'argon'),
'replier_name' => __('回复者名称', 'argon'),
'replier_email' => __('回复者邮箱', 'argon'),
'reply_content' => __('回复内容', 'argon'),
'comment_url' => __('评论链接', 'argon'),
'reply_date' => __('回复时间', 'argon'),
'theme_color' => __('主题色', 'argon'),
),
),
'user_register' => array(
'name' => __('用户注册', 'argon'),
'description' => __('新用户注册成功后发送的欢迎邮件', 'argon'),
'default_subject' => '[{{blog_name}}] 注册成功',
'default_content' => '欢迎加入 {{blog_name}}
{{user_name}},您好:
您的账户已创建成功,现在可以登录使用了。
立即登录
',
'placeholders' => array(
'blog_name' => __('博客名称', 'argon'),
'user_name' => __('用户名', 'argon'),
'user_email' => __('用户邮箱', 'argon'),
'login_url' => __('登录链接', 'argon'),
'register_date' => __('注册时间', 'argon'),
'theme_color' => __('主题色', 'argon'),
),
),
'password_reset' => array(
'name' => __('密码重置', 'argon'),
'description' => __('用户请求重置密码时发送的邮件', 'argon'),
'default_subject' => '[{{blog_name}}] 密码重置请求',
'default_content' => '密码重置请求
{{user_name}},您好:
我们收到了您的密码重置请求,请点击下方按钮重置密码。如果这不是您本人的操作,请忽略此邮件。
重置密码
此链接将在 24 小时后失效。
',
'placeholders' => array(
'blog_name' => __('博客名称', 'argon'),
'user_name' => __('用户名', 'argon'),
'user_email' => __('用户邮箱', 'argon'),
'reset_url' => __('重置链接', 'argon'),
'theme_color' => __('主题色', 'argon'),
),
),
'todo_urge' => array(
'name' => __('TODO 提醒', 'argon'),
'description' => __('访客催促作者完成 TODO 时发送的邮件', 'argon'),
'default_subject' => '[{{blog_name}}] 有访客催促您完成 TODO',
'default_content' => '有访客催促您完成 TODO
以下任务被访客催促完成:
前往博客
',
'placeholders' => array(
'blog_name' => __('博客名称', 'argon'),
'blog_url' => __('博客链接', 'argon'),
'todo_content' => __('TODO 内容', 'argon'),
'todo_id' => __('TODO ID', 'argon'),
'urge_time' => __('提醒时间', 'argon'),
'theme_color' => __('主题色', 'argon'),
),
),
'general' => array(
'name' => __('通用邮件', 'argon'),
'description' => __('其他类型的通用邮件模板', 'argon'),
'default_subject' => '[{{blog_name}}] {{subject}}',
'default_content' => '{{title}}
{{content}}
',
'placeholders' => array(
'blog_name' => __('博客名称', 'argon'),
'subject' => __('邮件主题', 'argon'),
'title' => __('内容标题', 'argon'),
'content' => __('邮件内容', 'argon'),
'theme_color' => __('主题色', 'argon'),
),
),
);
// 允许通过 filter 扩展邮件类型
return apply_filters('argon_email_types', $types);
}
/**
* 获取邮件模板设置
*/
function argon_get_email_settings() {
$theme_color = get_option('argon_email_theme_color', '#5e72e4');
$logo_url = get_option('argon_email_logo_url', '');
$blog_name = get_option('argon_email_blog_name', '');
$footer_text = get_option('argon_email_footer_text', '');
$social_links = get_option('argon_email_social_links', array());
if (empty($blog_name)) {
$blog_name = get_bloginfo('name');
}
if (empty($footer_text)) {
$footer_text = '© ' . date('Y') . ' ' . $blog_name . '. All rights reserved.';
}
return array(
'theme_color' => $theme_color,
'logo_url' => $logo_url,
'blog_name' => $blog_name,
'footer_text' => $footer_text,
'social_links' => $social_links
);
}
/**
* 获取指定邮件类型的模板配置
*/
function argon_get_email_template_config($type) {
$types = argon_get_email_types();
$settings = argon_get_email_settings();
if (!isset($types[$type])) {
$type = 'general';
}
$default = $types[$type];
// 获取自定义模板,如果没有则使用默认
$subject = get_option('argon_email_template_' . $type . '_subject', '');
$content = get_option('argon_email_template_' . $type . '_content', '');
$enabled = get_option('argon_email_template_' . $type . '_enabled', 'true');
return array(
'type' => $type,
'name' => $default['name'],
'description' => $default['description'],
'subject' => !empty($subject) ? $subject : $default['default_subject'],
'content' => !empty($content) ? $content : $default['default_content'],
'default_subject' => $default['default_subject'],
'default_content' => $default['default_content'],
'placeholders' => $default['placeholders'],
'enabled' => $enabled === 'true',
);
}
/**
* 获取邮件基础模板 HTML
*/
function argon_get_email_base_template() {
$settings = argon_get_email_settings();
// 页眉部分
$header_html = '';
if (!empty($settings['logo_url'])) {
$header_html = '
';
} else {
$header_html = '' . esc_html($settings['blog_name']) . '
';
}
// 社交链接部分
$social_html = '';
if (!empty($settings['social_links']) && is_array($settings['social_links'])) {
$social_items = array();
$social_names = array(
'twitter' => 'Twitter',
'github' => 'GitHub',
'weibo' => '微博',
'facebook' => 'Facebook',
'instagram' => 'Instagram'
);
foreach ($settings['social_links'] as $key => $url) {
if (!empty($url)) {
$name = isset($social_names[$key]) ? $social_names[$key] : ucfirst($key);
$social_items[] = '' . esc_html($name) . '';
}
}
if (!empty($social_items)) {
$social_html = '' . implode('', $social_items) . '
';
}
}
$template = '
{{email_subject}}
|
' . $header_html . '
|
|
|
|
' . $social_html . '
' . esc_html($settings['footer_text']) . '
|
|
';
return $template;
}
/**
* 替换模板中的占位符
*
* @param string $template 模板字符串
* @param array $vars 变量数组
* @param bool $escape 是否转义 HTML
* @return string 替换后的字符串
*/
function argon_replace_placeholders($template, $vars, $escape = false) {
$settings = argon_get_email_settings();
// 添加全局变量
$global_vars = array(
'blog_name' => $settings['blog_name'],
'blog_url' => home_url(),
'theme_color' => $settings['theme_color'],
'current_year' => date('Y'),
'current_date' => date_i18n(get_option('date_format')),
'current_time' => date_i18n(get_option('time_format')),
);
$vars = array_merge($global_vars, $vars);
// 处理 Mustache 风格的条件语句 {{#variable}}...{{/variable}}
$template = preg_replace_callback('/\{\{#(\w+)\}\}(.*?)\{\{\/\1\}\}/s', function($matches) use ($vars) {
$var_name = $matches[1];
$content = $matches[2];
// 如果变量存在且为真值,返回内容
if (isset($vars[$var_name]) && $vars[$var_name]) {
return $content;
}
return '';
}, $template);
// 处理 Mustache 风格的反向条件语句 {{^variable}}...{{/variable}}
$template = preg_replace_callback('/\{\{\^(\w+)\}\}(.*?)\{\{\/\1\}\}/s', function($matches) use ($vars) {
$var_name = $matches[1];
$content = $matches[2];
// 如果变量不存在或为假值,返回内容
if (!isset($vars[$var_name]) || !$vars[$var_name]) {
return $content;
}
return '';
}, $template);
// 处理旧版条件语句 {{#if variable}}...{{/if}}(向后兼容)
$template = preg_replace_callback('/\{\{#if\s+(\w+)\}\}(.*?)\{\{\/if\}\}/s', function($matches) use ($vars) {
$var_name = $matches[1];
$content = $matches[2];
// 如果变量存在且不为空,返回内容,否则返回空字符串
if (isset($vars[$var_name]) && !empty($vars[$var_name])) {
return $content;
}
return '';
}, $template);
// 替换普通占位符
foreach ($vars as $key => $value) {
if ($escape && !in_array($key, array('theme_color', 'blog_url', 'post_url', 'comment_url', 'reset_url', 'login_url', 'feedback_manage_url', 'feedback_view_url'))) {
$value = esc_html($value);
}
$template = str_replace('{{' . $key . '}}', $value, $template);
}
return $template;
}
/**
* 渲染完整邮件
*
* @param string $type 邮件类型
* @param array $vars 模板变量
* @return array 包含 subject 和 html 的数组
*/
function argon_render_email_template($type, $vars = array()) {
$config = argon_get_email_template_config($type);
// 替换主题中的占位符
$subject = argon_replace_placeholders($config['subject'], $vars, true);
// 替换内容中的占位符(内容中的 URL 不转义)
$content = argon_replace_placeholders($config['content'], $vars, false);
// 获取基础模板并替换
$base_template = argon_get_email_base_template();
$html = str_replace('{{email_subject}}', esc_html($subject), $base_template);
$html = str_replace('{{email_content}}', $content, $html);
// 替换剩余的全局变量
$html = argon_replace_placeholders($html, $vars, false);
return array(
'subject' => $subject,
'html' => $html,
'enabled' => $config['enabled'],
);
}
/**
* 发送邮件
*
* @param string $to 收件人邮箱
* @param string $type 邮件类型
* @param array $vars 模板变量
* @return bool 发送是否成功
*/
function argon_send_email($to, $type, $vars = array()) {
$rendered = argon_render_email_template($type, $vars);
// 检查该类型邮件是否启用
if (!$rendered['enabled']) {
return false;
}
$settings = argon_get_email_settings();
// 设置邮件头
$headers = array(
'Content-Type: text/html; charset=UTF-8',
'From: ' . $settings['blog_name'] . ' <' . get_option('admin_email') . '>'
);
// 发送邮件
$result = wp_mail($to, $rendered['subject'], $rendered['html'], $headers);
if (!$result) {
error_log('Argon Email: Failed to send ' . $type . ' email to ' . $to);
}
return $result;
}
/**
* 兼容旧版 API - 渲染邮件(已废弃,保留向后兼容)
*/
function argon_render_email($content, $vars = array()) {
$base_template = argon_get_email_base_template();
$html = str_replace('{{email_content}}', $content, $base_template);
$html = str_replace('{{email_subject}}', isset($vars['subject']) ? esc_html($vars['subject']) : '', $html);
$html = argon_replace_placeholders($html, $vars, false);
return $html;
}
/**
* AJAX 邮件预览接口
*/
add_action('wp_ajax_argon_preview_email', 'argon_preview_email_handler');
function argon_preview_email_handler() {
if (!isset($_POST['nonce']) || !wp_verify_nonce($_POST['nonce'], 'argon_preview_email')) {
wp_die('Invalid nonce');
}
if (!current_user_can('manage_options')) {
wp_die('Permission denied');
}
$type = isset($_POST['type']) ? sanitize_text_field($_POST['type']) : 'comment_notify';
// 生成示例数据
$sample_vars = argon_get_sample_email_vars($type);
$rendered = argon_render_email_template($type, $sample_vars);
echo $rendered['html'];
wp_die();
}
/**
* 获取示例邮件变量
*/
function argon_get_sample_email_vars($type) {
$settings = argon_get_email_settings();
$common = array(
'blog_name' => $settings['blog_name'],
'theme_color' => $settings['theme_color'],
);
switch ($type) {
case 'comment_notify':
return array_merge($common, array(
'post_title' => '示例文章标题',
'post_url' => home_url('/sample-post/'),
'commenter_name' => '评论者',
'commenter_email' => 'commenter@example.com',
'comment_content' => '这是评论内容的示例文本,展示了邮件模板中评论通知的样式效果。非常感谢您的精彩文章!',
'comment_url' => home_url('/sample-post/#comment-1'),
'comment_date' => date_i18n(get_option('date_format') . ' ' . get_option('time_format')),
));
case 'reply_notify':
return array_merge($common, array(
'post_title' => '示例文章标题',
'post_url' => home_url('/sample-post/'),
'original_comment' => '这是原始评论的内容,用于展示邮件模板效果。',
'replier_name' => '回复者',
'replier_email' => 'replier@example.com',
'reply_content' => '这是回复内容的示例文本,展示了邮件模板中回复通知的样式效果。感谢您的评论!',
'comment_url' => home_url('/sample-post/#comment-2'),
'reply_date' => date_i18n(get_option('date_format') . ' ' . get_option('time_format')),
));
case 'user_register':
return array_merge($common, array(
'user_name' => '新用户',
'user_email' => 'newuser@example.com',
'login_url' => wp_login_url(),
'register_date' => date_i18n(get_option('date_format') . ' ' . get_option('time_format')),
));
case 'password_reset':
return array_merge($common, array(
'user_name' => '用户名',
'user_email' => 'user@example.com',
'reset_url' => home_url('/wp-login.php?action=rp&key=sample_key'),
));
case 'todo_urge':
return array_merge($common, array(
'todo_content' => '这是一个示例 TODO 任务内容',
'todo_id' => 'sample_todo_id',
'urge_time' => date_i18n(get_option('date_format') . ' ' . get_option('time_format')),
));
case 'general':
default:
return array_merge($common, array(
'subject' => '示例邮件主题',
'title' => '示例标题',
'content' => '这是通用邮件模板的示例内容。您可以在这里放置任何 HTML 内容。
',
));
}
}
/**
* 兼容旧版 API - 生成评论通知邮件内容(已废弃)
*/
function argon_get_comment_notify_content($vars) {
$config = argon_get_email_template_config('comment_notify');
return argon_replace_placeholders($config['content'], $vars, false);
}
/**
* 兼容旧版 API - 生成回复通知邮件内容(已废弃)
*/
function argon_get_reply_notify_content($vars) {
$config = argon_get_email_template_config('reply_notify');
return argon_replace_placeholders($config['content'], $vars, false);
}