Hexo-NexT配置Valine

我之前用的是Disqus这个评论服务,但是它需要科学上网才能使用,不利于交流,所以我准备换用Valine这个评论服务。

LeanCloud注册

Valine用LeanCloud作为数据库,所以我们需要注册一个LeanCloud账号

  1. 注册完以后需要创建一个应用,然后 进入应用->设置->应用key,得到appid、appkey。
  2. LeanCloud -> 存储 -> 创建Class -> 无限制的Class,class名称为:Comment,这是用来存放评论信息的。
  3. LeanCloud-设置,把除数据存储外其他选项都关闭。

注意:我们需要在Leancloud -> 设置 -> 安全中心 -> Web 安全域名把你的域名加进去。

NexT配置

由于NexT 7.1.2已经内置了Valine,所以我们只需要进行简单的配置即可。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# Valine
# You can get your appid and appkey from https://leancloud.cn
# More info available at https://valine.js.org
valine:
enable: true # When enable is set to be true, leancloud_visitors is recommended to be closed for the re-initialization problem within different leancloud adk version.
appid: # your leancloud application appid
appkey: # your leancloud application appkey
notify: false # mail notifier, See: https://github.com/xCss/Valine/wiki
verify: false # Verification code
placeholder: 'ヾノ≧∀≦)o来啊,快活啊!' # comment box placeholder
avatar: mm # gravatar style
guest_info: nick,mail,link # custom comment header
pageSize: 10 # pagination size
language: zh-cn # language, available values: en, zh-cn
visitor: true # leancloud-counter-security is not supported for now. When visitor is set to be true, appid and appkey are recommended to be the same as leancloud_visitors' for counter compatibility. Article reading statistic https://valine.js.org/visitor.html
comment_count: true # if false, comment count will only be displayed in post page, not in home page

主要就是填入前一步得到的appid、appkey。然后由于我后面要用更完善的第三方邮件提醒Valine-Admin,所以这里我关闭了自带的邮件提醒notify

由于自带的CDN加载很慢,所以这里我们在NexT配置文件_config.yml中改成第三方CDN:

1
2
3
4
5
6
7
vendors:
# valine
# See: https://github.com/xCss/Valine
# Example:
# valine: //cdn.jsdelivr.net/npm/valine@1/dist/Valine.min.js
# valine: //cdnjs.cloudflare.com/ajax/libs/valine/1.3.4/Valine.min.js
valine: //cdn.jsdelivr.net/npm/valine@1/dist/Valine.min.js

到目前为止,我们就可以正常使用Valine了。

下面是一些可选的高级配置,比如我想要评论后得到邮件通知、垃圾邮件过滤,那就需要配置Valine Admin。

Valine Admin 配置

Valine Admin 是 Valine 评论系统的扩展和增强,主要实现评论邮件通知、评论管理、垃圾评论过滤等功能。支持完全自定义的邮件通知模板。基于Akismet API实现准确的垃圾评论过滤。此外,使用云函数等技术解决了免费版云引擎休眠问题,支持云引擎自动唤醒,漏发邮件自动补发。兼容云淡风轻及Deserts维护的多版本Valine。

云引擎”一键”部署

  1. 在Leancloud云引擎设置界面,填写代码库并保存:https://github.com/DesertsP/Valine-Admin.git

  2. 在设置页面,设置环境变量以及 Web 二级域名:

环境变量:

变量示例说明
SITE_NAME小丁的个人博客[必填]博客名称
SITE_URLhttps://tding.top/[必填]首页地址
SMTP_SERVICEQQ[新版支持]邮件服务提供商,支持 QQ、163、126、Gmail 以及 更多
SMTP_USERxxxxxx@qq.com[必填]SMTP登录用户
SMTP_PASSccxxxxxxxxch[必填]SMTP登录密码(QQ邮箱需要获取独立密码)
SENDER_NAMEtding[必填]发件人
SENDER_EMAILxxxxxx@qq.com[必填]发件邮箱
ADMIN_URLhttps://tding.avosapps.us/[建议]Web主机二级域名,用于自动唤醒
BLOGGER_EMAILxxxxx@gmail.com[可选]博主通知收件地址,默认使用SENDER_EMAIL
AKISMET_KEYxxxxxxxxxxxx[可选]Akismet Key 用于垃圾评论检测,设为MANUAL_REVIEW开启人工审核,留空不使用反垃圾

二级域名用于评论后台管理:例如https://tding.avosapps.us/

  1. 切换到部署标签页,分支使用master,点击部署即可,第一次部署需要花点时间。

  2. 评论管理。访问设置的二级域名https://二级域名.avosapps.us/sign-up,注册管理员登录信息,如:https://tding.avosapps.us/sign-up。此后,可以通过https://tding.avosapps.us/管理评论。

  1. 定时任务设置

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

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

进入云引擎-定时任务中,创建定时器,创建两个定时任务。

  • 选择self-wake云函数,Cron表达式为0 0/30 7-23 * * ?,表示每天早6点到晚23点每隔30分钟访问云引擎,ADMIN_URL环境变量务必设置正确
  • 选择resend-mails云函数,Cron表达式为0 0 8 * * ?,表示每天早8点检查过去24小时内漏发的通知邮件并补发

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

至此,Valine Admin 已经可以正常工作,更多以下是可选的进阶配置。

邮件通知模板

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

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

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

默认被@通知邮件内容模板如下:

1
<div style="border-top:2px solid #12ADDB;box-shadow:0 1px 3px #AAAAAA;line-height:180%;padding:0 15px 12px;margin:50px auto;font-size:12px;"><h2 style="border-bottom:1px solid #DDD;font-size:14px;font-weight:normal;padding:13px 0 10px 8px;">您在<a style="text-decoration:none;color: #12ADDB;" href="${SITE_URL}" target="_blank">            ${SITE_NAME}</a>上的评论有了新的回复</h2> ${PARENT_NICK} 同学,您曾发表评论:<div style="padding:0 12px 0 12px;margin-top:18px"><div style="background-color: #f5f5f5;padding: 10px 15px;margin:18px 0;word-wrap:break-word;">            ${PARENT_COMMENT}</div><p><strong>${NICK}</strong>回复说:</p><div style="background-color: #f5f5f5;padding: 10px 15px;margin:18px 0;word-wrap:break-word;"> ${COMMENT}</div><p>您可以点击<a style="text-decoration:none; color:#12addb" href="${POST_URL}" target="_blank">查看回复的完整內容</a>,欢迎再次光临<a style="text-decoration:none; color:#12addb" href="${SITE_URL}" target="_blank">${SITE_NAME}</a>。<br></p></div></div>

默认博主通知邮件内容模板如下:

1
<div style="border-top:2px solid #12ADDB;box-shadow:0 1px 3px #AAAAAA;line-height:180%;padding:0 15px 12px;margin:50px auto;font-size:12px;"><h2 style="border-bottom:1px solid #DDD;font-size:14px;font-weight:normal;padding:13px 0 10px 8px;">您在<a style="text-decoration:none;color: #12ADDB;" href="${SITE_URL}" target="_blank">${SITE_NAME}</a>上的文章有了新的评论</h2><p><strong>${NICK}</strong>回复说:</p><div style="background-color: #f5f5f5;padding: 10px 15px;margin:18px 0;word-wrap:break-word;"> ${COMMENT}</div><p>您可以点击<a style="text-decoration:none; color:#12addb" href="${POST_URL}" target="_blank">查看回复的完整內容</a><br></p></div></div>

这里还提供一个彩虹风格的@通知邮件模板代码:

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>${PARENT_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;">${PARENT_COMMENT}</div><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>

我的环境变量配置

Valine和“热榜”冲突问题

这里Valine和热榜存在一定的冲突,导致了热榜中的文章无法正常显示。

我们可以不在 热榜 页面加载 Valine 的代码,反正 热榜 页面也没开启评论。

修改文件~/blog/themes/next/layout/_third-party/comments/valine.swig

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
+ {% if theme.valine.enable and theme.valine.appid and theme.valine.appkey and page.title !=== '热榜' %}


{% set leancloud_uri = '//cdn1.lncld.net/static/js/3.11.1/av-min.js' %}
{% if theme.vendors.leancloud %}
{% set leancloud_uri = theme.vendors.leancloud %}
{% endif %}
<script src="{{ leancloud_uri }}"></script>

{% set valine_uri = '//unpkg.com/valine/dist/Valine.min.js' %}
{% if theme.vendors.valine %}
{% set valine_uri = theme.vendors.valine %}
{% endif %}
<script src="{{ valine_uri }}"></script>

<script>
var GUEST = ['nick', 'mail', 'link'];
var guest = '{{ theme.valine.guest_info }}';
guest = guest.split(',').filter(function(item) {
return GUEST.indexOf(item) > -1;
});
new Valine({
el: '#comments',
verify: {{ theme.valine.verify }},
notify: {{ theme.valine.notify }},
appId: '{{ theme.valine.appid }}',
appKey: '{{ theme.valine.appkey }}',
placeholder: '{{ theme.valine.placeholder }}',
avatar: '{{ theme.valine.avatar }}',
meta: guest,
pageSize: '{{ theme.valine.pageSize }}' || 10,
visitor: {{ theme.valine.visitor }},
lang: '{{ theme.valine.language }}' || 'zh-cn'
});
</script>

+ {% endif %}

上面的热榜要修改成你自己的标题名字。

参考

赞赏一杯咖啡
0%