项目简介
本项目是对Valine评论系统的扩展与增强,依托LeanCloud云引擎构建。能够实现评论邮件通知、评论管理以及垃圾评论过滤等功能。支持自定义邮件通知模板,借助Akismet API精准过滤垃圾评论。利用云函数解决免费版云引擎休眠问题,实现云引擎自动唤醒和漏发邮件自动补发,并且兼容云淡风轻及Deserts维护的多版本Valine。
项目的主要特性和功能
- 邮件通知:具备被@通知和博主通知功能,可完全自定义邮件通知模板。
- 垃圾评论过滤:采用Akismet API自动过滤垃圾评论,采集评论者IP、浏览器信息等辅助精准识别,保障隐私安全。
- 评论管理:提供评论管理页面,便于管理评论,被标为垃圾的评论可在管理页面取消标注。
- 云函数定时任务:包含自动唤醒云引擎和每天定时检查并补发漏发邮件通知的功能。
安装使用步骤
前提条件
用户已下载本项目的源码文件,且确保已注册并登录LeanCloud账号,创建了相应的应用。
具体步骤
- 配置环境变量:以下参数需要正确设置:
SITE_NAME
:博客名称,必填。SITE_URL
:首页地址,必填。SMTP_SERVICE
:新版支持的邮件服务提供商,支持QQ、163、126、Gmail等,必填。SMTP_USER
:SMTP登录用户,必填。SMTP_PASS
:SMTP登录密码(QQ邮箱需要获取独立密码),必填。SENDER_NAME
:发件人,必填。SENDER_EMAIL
:发件邮箱,必填。ADMIN_URL
:Web主机二级域名(云引擎域名),用于自动唤醒,建议填写。BLOGGER_EMAIL
:博主通知收件地址,可选,默认使用SENDER_EMAIL
。AKISMET_KEY
:Akismet Key用于垃圾评论检测,设为MANUAL_REVIEW
开启人工审核,留空不使用反垃圾,可选。
- 设置管理员信息:访问管理员注册页面
https://云引擎域名/sign-up
,注册管理员登录信息。若使用原版Valine遇到注册页面不显示直接跳转至登录页的情况,请手动删除_User
表中的全部数据。 - 定时任务设置:进入「云引擎 - 定时任务」,创建两个定时任务:
- 选择
self-wake
云函数,Cron表达式为0 */30 0 - 16 * * ?
,每天早0点到晚16点每隔30分钟访问云引擎。 - 选择
resend-mails
云函数,Cron表达式为0 0 0 * * ?
,每天0点检查过去24小时内漏发的通知邮件并补发。注意国际版使用UTC - 0时间,需与国内时间对应。
- 选择
- 可选配置
- 邮件通知模板:可在云引擎环境变量中设定邮件通知模板,自定义被@通知和博主通知的邮件标题及内容模板。
- 手动配置邮件服务器:若需自定义邮件服务器地址和端口信息,删除
SMTP_SERVICE
环境变量,新增SMTP_HOST
、SMTP_PORT
、SMTP_SECURE
变量。 - 垃圾评论检测:若需要使用垃圾评论检测功能,可去 AKISMET FOR DEVELOPERS 免费申请Akismet Key并填入环境变量。
注意事项
- 确保环境变量配置正确,特别是邮件服务器相关配置。
- 博主通知模板中不要出现
PARENT*
相关参数,请勿混用模板。 - 若要实现点击邮件中的链接跳转至相应评论,需在Web前端添加以下代码: ```javascript
```
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】