Valine Admin 是 Valine 评论系统的扩展和增强,主要实现评论邮件通知、评论管理、垃圾评论过滤等功能。支持完全自定义的邮件通知模板,基于Akismet API实现准确的垃圾评论过滤。
开发者@Deserts
云引擎"一键"部署
1. 填写代码库
在Leancloud云引擎设置界面,填写代码库并保存:https://github.com/DesertsP/Valine-Admin.git
2.在设置页面,设置环境变量以及 Web 二级域名。
具体格式如下:
变量 | 示例 | 说明 |
---|---|---|
SITE_NAME | 平凡的你我 | [必填]博客名称 |
SITE_URL | https://reinness.com | [必填]首页地址 |
SMTP_SERVICE | "163" | [新版支持]邮件服务提供商,支持 QQ、163、126、Gmail 以及 更多 |
SMTP_USER | [email protected] | [必填]SMTP登录用户 |
SMTP_PASS | XXXXXXXX | [必填]SMTP登录密码(QQ邮箱需要获取独立密码) |
SENDER_NAME | caleb | [必填]发件人 |
SENDER_EMAIL | [email protected] | [必填]发件邮箱 |
BLOGGER_EMAIL | [email protected] | [可选]如果自己在回复,设置这个可以不向自己的邮箱发送邮件 |
ADMIN_URL | https://xxx.leanapp.cn/ | [建议]Web主机二级域名,用于自动唤醒 |
BLOGGER_EMAIL | [email protected] | [可选]博主通知收件地址,默认使用SENDER_EMAIL |
AKISMET_KEY | xxxxxxxxxxxx | [可选]Akismet Key 用于垃圾评论检测,设为MANUAL_REVIEW开启人工审核,留空不使用反垃圾 |
以上必填参数请务必正确设置。
3.切换到部署标签页,分支使用master,点击部署即可
第一次部署可能会需要些时间。
4.评论管理
访问设置的二级域名https://二级域名.leanapp.cn/sign-up
,注册管理员登录信息,如:https://nk6vtvs0tdwc.leanapp.cn/sign-up
注:使用原版Valine如果遇到注册页面不显示直接跳转至登录页的情况,请手动删除_User表中的全部数据。
此后,可以通过https://二级域名.leanapp.cn/
管理评论。
5.定时任务设置
目前实现了两种云函数定时任务:
(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.自定义模板
邮件通知包含两种,分别是 被@通知 和 博主通知,这两种模板都可以完全自定义。默认使用经典的蓝色风格模板。
@通知模板中的可用变量如下(注,这是邮件模板变量,是指嵌入到HTML邮件模板中的变量,请勿与云引擎环境变量混淆)
模板变量 | 说明 |
---|---|
SITE_NAME | 博客名称 |
SITE_URL | 博客首页地址 |
POST_URL | 文章地址(完整路径) |
PARENT_NICK | 收件人昵称(被@者,父级评论人) |
PARENT_COMMENT | 父级评论内容 |
NICK | 新评论者昵称 |
COMMENT | 新评论内容 |
(1)默认被@通知邮件内容模板如下:
您在 ${SITE_NAME}上的评论有了新的回复
${PARENT_NICK} 同学,您曾发表评论:
效果如图:
(2)彩虹风格的@通知邮件模板代码:
您在 ${SITE_NAME}上的评论有了新的回复
${PARENT_NICK} 同学,您曾发表评论:
效果如图:
博主通知邮件模板中的可用变量与@通知中的基本一致,PARENT_NICK 和 PARENT_COMMENT 变量不再可用。
(3)默认博主通知邮件内容模板如下: