引言 {#引言}

为Valine评论系统增加邮件和微信提醒需要使用到Valine-Admin。

Valine Admin 是 Valine 评论系统的扩展和增强，主要实现评论邮件通知、评论管理、垃圾评论过滤等功能。支持完全自定义的邮件通知模板，基于Akismet API实现准确的垃圾评论过滤。

实现方法 {#实现方法}

云引擎一键部署 {#1-云引擎一键部署}

在Leancloud 云引擎-->部署界面，填写部署代码库地址并保存：https://github.com/ComicAuthor/Valine-Admin.git

在设置页面，设置环境变量 {#2-在设置页面，设置环境变量}

环境变量的具体格式如下：常规版本只需要配置下表所列变量即可

| 变量 | 示例 | 说明 | |---------------|-----------------------------------------------|----------------------------------------------------------------| | SITE_NAME | 平凡的你我 | [必填]博客名称 | | SITE_URL | https://reinness.com | [必填]首页地址 | | SMTP_SERVICE | "163" | [新版支持]邮件服务提供商，支持 QQ、163、126、Gmail 以及更多 | | SMTP_USER | xxxxx@163.com | [必填]SMTP登录用户 | | SMTP_PASS | XXXXXXXX | [必填]SMTP登录密码(QQ邮箱需要获取独立密码) | | SENDER_NAME | caleb | [必填]发件人 | | SENDER_EMAIL | xxxxx@163.com | [必填]发件邮箱 | | BLOGGER_EMAIL | xxxxx@163.com | [可选]如果自己在回复，设置这个可以不向自己的邮箱发送邮件 && 博主通知收件地址，默认使用SENDER_EMAIL | | ADMIN_URL | https://xxx.leanapp.cn/ | [建议]Web主机二级域名，用于自动唤醒 | | AKISMET_KEY | xxxxxxxxxxxx | [可选]Akismet Key 用于垃圾评论检测，设为MANUAL_REVIEW开启人工审核，留空不使用反垃圾 |

QQ和微信推送提醒则需要设置下面的变量

| 变量 | 示例 | 说明 | |------------------|----------------|------------------------| | QMSG_KEY | Qmsg酱官网申请教程 | [必填]QQ消息提示的APPKey | | QMSG_TEMPLATE | [查看教程] | [选填]发送QQ消息模板 | | QQ_SHAKE | true / false | [选填]是否使用QQ戳一戳 | | SC_KEY | Server酱官网申请教程 | [必填]微信消息提示的SCKEY | | SC_TEXT_TEMPLATE | [查看教程] | [选填]Server酱发送消息的标题模板 | | SC_DESP_TEMPLATE | [查看教程] | [选填]Server酱发送消息的内容模板 |

以上必填参数请务必正确设置。

切换到部署标签页，分支使用master，点击部署即可 {#3-切换到部署标签页，分支使用master，点击部署即可}

第一次部署可能会需要些时间。

4.定时任务设置 {#4-定时任务设置}

目前实现了两种云函数定时任务:

(1)自动唤醒，定时访问Web APP二级域名防止云引擎休眠；
(2)每天定时检查24小时内漏发的邮件通知。

进入云引擎-定时任务中，创建定时器，创建两个定时任务。
(1)选择self-wake云函数，Cron表达式为0 0/30 7-23 * * ?，表示每天早6点到晚23点每隔30分钟访问云引擎，ADMIN_URL环境变量务必设置正确：

(2)选择resend-mails云函数，Cron表达式为0 0 8 * * ?，表示每天早8点检查过去24小时内漏发的通知邮件并补发：

添加定时器后记得点击启动方可生效。

至此，Valine Admin 已经可以正常工作。

邮件通知模板 {#邮件通知模板}

环境变量设定 {#1-环境变量设定}

邮件通知模板在云引擎环境变量中设定，可自定义通知邮件标题及内容模板。

| 环境变量 | 示例 | 说明 | |---------------------|----------------------------------------|---------------------| | MAIL_SUBJECT | ${PARENT_NICK}，您在${SITE_NAME}上的评论收到了回复 | [可选]@通知邮件主题(标题)模板 | | MAIL_TEMPLATE | 见下文 | [可选]@通知邮件内容模板 | | MAIL_SUBJECT_ADMIN | ${SITE_NAME}上有新评论了 | [可选]博主邮件通知主题模板 | | MAIL_TEMPLATE_ADMIN | 见下文 | [可选]博主邮件通知内容模板 |

2.自定义模板 {#2-自定义模板}

邮件通知包含两种，分别是 被@通知 和 博主通知，这两种模板都可以完全自定义。默认使用经典的蓝色风格模板。

@通知模板中的可用变量如下(注，这是邮件模板变量，是指嵌入到HTML邮件模板中的变量，请勿与云引擎环境变量混淆)

| 模板变量 | 说明 | |----------------|------------------| | SITE_NAME | 博客名称 | | SITE_URL | 博客首页地址 | | POST_URL | 文章地址(完整路径) | | PARENT_NICK | 收件人昵称(被@者，父级评论人) | | PARENT_COMMENT | 父级评论内容 | | NICK | 新评论者昵称 | | COMMENT | 新评论内容 |

(1) 默认被@通知邮件内容模板如下：

效果如图：

(2) 彩虹风格的@通知邮件模板代码：

效果如图：

博主通知邮件模板中的可用变量与@通知中的基本一致，PARENT_NICK 和 PARENT_COMMENT 变量不再可用。

(3) 默认博主通知邮件内容模板如下：

因为没使用过这个，所以就没挂图~~~

(4) 彩虹风格的博主通知邮件内容模板如下：

|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 | <div style="border-radius: 10px 10px 10px 10px;font-size:13px; color: #555555;width: 666px;font-family:'Century Gothic','Trebuchet MS','Hiragino Sans GB',微软雅黑,'Microsoft Yahei',Tahoma,Helvetica,Arial,'SimSun',sans-serif;margin:50px auto;border:1px solid #eee;max-width:100%;background: #ffffff repeating-linear-gradient(-45deg,#fff,#fff 1.125rem,transparent 1.125rem,transparent 2.25rem);box-shadow: 0 1px 5px rgba(0, 0, 0, 0.15);"><div style="width:100%;background:#49BDAD;color:#ffffff;border-radius: 10px 10px 0 0;background-image: -moz-linear-gradient(0deg, rgb(67, 198, 184), rgb(255, 209, 244));background-image: -webkit-linear-gradient(0deg, rgb(67, 198, 184), rgb(255, 209, 244));height: 66px;"><p style="font-size:15px;word-break:break-all;padding: 23px 32px;margin:0;background-color: hsla(0,0%,100%,.4);border-radius: 10px 10px 0 0;">您在<a style="text-decoration:none;color: #ffffff;"href="${SITE_URL}">${SITE_NAME}</a>上有新评论啦！</p></div><div style="margin:40px auto;width:90%"><p>${NICK}给您的回复如下：</p><div style="background: #fafafa repeating-linear-gradient(-45deg,#fff,#fff 1.125rem,transparent 1.125rem,transparent 2.25rem);box-shadow: 0 2px 5px rgba(0, 0, 0, 0.15);margin:20px 0px;padding:15px;border-radius:5px;font-size:14px;color:#555555;">${COMMENT}</div><p>您可以点击<a style="text-decoration:none; color:#12addb"href="${POST_URL}#comments">查看回复的完整內容</a>，欢迎再次光临<a style="text-decoration:none; color:#12addb"href="${SITE_URL}">${SITE_NAME}</a>。</p><style type="text/css">a:link{text-decoration:none}a:visited{text-decoration:none}a:hover{text-decoration:none}a:active{text-decoration:none}</style></div></div> |

效果如图：

以上所有内容仅供大家参考，如有问题请及时指正，如有侵权，请及时联系删除

参考链接：https://blog.csdn.net/AC916305619/article/details/110379680