目录
以下标题点击可直接跳转:
如有其他疑问,或者还需要添加的教程,请在评论区留言。
评论区直达Hexo设置Valine评论系统
申请LeanCloud账号
1.官网地址:https://leancloud.cn/ (国内版) https://leancloud.app/ (国际版)
2.注册后登陆,创建一个应用,名称随意填写,开发版即可。
3.进入刚才创建的应用→点击设置→应用Keys→记录AppID、AppKey
Volantis主题开启valine评论
以下适合3.0版本,4.0建议看官网文档
任何主题都是一样,建议多看看官方文档。看官方文档是配置主题各项功能的第一步。
1.打开主题配置文件,开启Valine评论
2.开启文章阅读数量统计
要在主题配置文件以下地方加上counter
和valinecount
,才能开启
3.配置好了之后记得要设置安全域名:传送门
Valine增强版配置:博主标签、评论后台、微信qq提醒、垃圾评论过滤
博主、小伙伴、访客标签
效果如图所示:
博主
小伙伴
访客
下面以Volantis设置为例:
- 添加js链接、并在配置文件增加参数
使用的是懒人大佬修改的js:
1 | https://cdn.jsdelivr.net/gh/HCLonely/Valine@latest/dist/Valine.min.js |
与原生的相比,多了以下功能:
添加博主,小伙伴,访客标签
添加浏览器和操作系统图标,需
fontawesomeV5
支持邮箱检测更严格
增加 QQ 邮箱识别(原版只能通过昵称栏输入 QQ 号识别)
meta placeholder 可自定义
使用方法与原生的类似,不同的是可以多设置几个参数:
参数 | 类型 | 说明 | 默认 | 示例 |
---|---|---|---|---|
tagMeta | Array | 标签要显示的文字 | [“博主”,“小伙伴”,“访客”] | [“博主”,“小伙伴”,“访客”] |
master | Array/String | md5 加密后的博主邮箱 | [] | [“fc2c9b067f65c9e2d7057ba797f7cfca”] |
friends | Array | md5 加密后的小伙伴邮箱 | [] | [“4a713ec085a4431f15a8da0942656713”] |
metaPlaceholder | Object | meta placeholder 内容 | {} | {“nick”:“昵称 / QQ 号”,“mail”:“邮箱 (必填)”} |
verify | Boolean | 评论时是否需要验证,需 jQuery 支持 | false | true |
- volantis在主题配置文件中可直接更换,如图:
MD5加密网站:https://md5jiami.51240.com/
修改主题文件
找到主题文件
volantis\layout\_third-party\comments\valine\script.ejs
,按图添加增加的配置
代码:
1 | master: '[<%= theme.comments.valine.master %>]', |
至此,就可以在主题配置文件中,直接填写master和friends参数,通过MD5加密的邮箱地址判断博主和小伙伴了。其他参数、其他主题原理相同:
原理
在配置文件增加参数。
主题模板里增加参数调用。
部署Valine-Admin评论后台
创建应用
进入leancloud,登陆之前创建的Valine应用
进行部署
安利下我用的自己valine-admin-server (基于小康大佬),去掉了一些二次元的东西(本博主年龄偏大,对此不感冒😂)。
地址如下:
1 | https://github.com/heson525/Valine-Admin-Server |
绑定评论后台域名
添加参数
变量名 | 说明 | 示例 |
---|---|---|
SITE_NAME | [必填] 网站名称 | 黑石博客 |
SITE_URL | [必填] 网站地址,最后不要加 / | https://www.heson10.com |
SMTP_USER | [必填] SMTP 服务用户名,一般为邮箱地址。 | mail@heson10.com |
SMTP_PASS | [必填] SMTP 密码,一般为授权码,而不是邮箱的登陆密码,请自行查询对应邮件服务商的获取方式 | XXXXXXXXXX |
SMTP_SERVICE | [新版支持] 邮件服务提供商,内置支持 | 163 |
SENDER_NAME | [必填] 寄件人名称。 | 黑石博客 |
TO_EMAIL | [可选] 博主通知收件地址,默认使用 SMTP_USER | mail@heson10.com |
BLOGGER_EMAIL | [可选] 如果设置则作为后台管理员邮箱(/sign-up 页面设置),不设置则默认以 SMTP_USER | mail@heson10.com |
TEMPLATE_NAME | [必填] 设置提醒邮件的主题 | custom2 |
AKISMET_KEY | [可选] Akismet Key 用于垃圾评论检测,设为 MANUAL_REVIEW 开启人工审核,留空不使用反垃圾 | xxxx |
ADMIN_URL | [可选] 后台管理地址 (非博客地址) | https://xxxx.leanapp.cn/ |
COMMENT | [可选] 评论 div 的 ID 名 | #comments |
SCKEY | [可选] server 酱的 SCKEY | xxx |
AKISMET_KEY | [可选] Akismet Key 用于垃圾评论检测 | xxxxxxxxxxxx |
QMSG_KEY | [可选] Qmsg 酱的密钥 | xxxxx |
[可选] Qmsg 酱发送的 qq,不填为全部。支持多个,用英文逗号分隔即可 | 535668586 | |
DISABLE_EMAIL | [可选],填写则代表停止发送邮件 | TRUE |
QQ_SHAKE | [可选],填写代表发送 QQ 戳一戳 | TRUE |
ICP | [可选] 备案信息,直接填写即可。 | 赣ICP备20008960号 |
INFO | [可选] 自定义信息输出,支持 HTML 代码 | test |
favicon | [可选] 网页 favicon 图标 | https://cdn.jsdelivr.net/gh/heson525/pic@master/pic/favicon.ico |
SPAM_WORDS | [可选] 需要对屏蔽的关键词,关键词用半角逗号分隔 | 单号,物流 |
MAIN_COLOR | [可选] 仅针对 custom2 模板主题的主要颜色 | #ff9191 |
MAIN_IMG | [可选] 仅针对 custom2 模板主题的头图 | https://bing.rthe.net/wallpaper |
当使用自定义邮件服务器时(需将 SMTP_SERVICE
变量删掉哦!)
变量名 | 说明 | 示例 |
---|---|---|
SMTP_HOST | 邮件服务提供商 SMTP 地址,此项需要自行查询或询问其服务商。 | smtp.ym.163.com |
SMTP_PORT | 邮件服务提供商 SMTP 端口,此项需要自行查询或询问其服务商。 | 994 |
SMTP_SECURE | 是否启用加密,默认为 true ,一般不需要设置,如有特殊请自行配置。 此项需要自行查询或询问其服务商。 |
true |
此项目的主题字段
模板名称 | 说明 |
---|---|
default | 默认主题 |
rainbow | 原版的 rainbow |
custom1 | 基于🎉梨花町の肾兄さん🎉的模板 |
custom2 | 对 custom1 的改进版 |
设置位置:
后台管理员注册
打开绑定的域名 +/sign-up
,例如我的域名为 https://leancloud.heson10.com/
,那么我访问的地址就是 https://leancloud.heson10.com/sign-up
。接下来设置你的登录信息。
后台评论管理
登录地址:https://leancloud.heson10.com
至此,Valine-admin已设置完毕。
微信、QQ提醒
微信Server酱 SCKEY 获取
官网注册:http://sc.ftqq.com/3.version
- 用github账户登录
- 获取SCKEY并填入变量
- 在Server酱上绑定微信即可
QQmsg 密钥获取
最近貌似官网要停业了,已经不开放注册了
建议设置微信提醒。
又被续命了!
垃圾评论过滤
只需在AKISMET_KEY
变量上填入Akismet Key
申请地址:https://akismet.com/development/
解决LeanCloud流控问题
之前几天后台不能发送邮件通知,查看日志显示”因流控原因,通过定时任务唤醒体验版实例失败,建议升级至标准版云引擎实例避免休眠”,相信大家会碰到这样的问题。
因为好多都是同一时间用定时任务触发容器运行,leancloud服务器不堪重负。
多得理论性知识可直接查看小康大佬的这篇帖子。下面只讲方法:
解决方法之GitHub+Actions大法
新建一个Token
方法之前教程有写很详细,点这里。不过这里用到的权限很少。勾上:
- repo
- admin:repo_hook
- worflow
Fork项目地址
地址: https://github.com/blogimg/WakeLeanCloud
进入后点击右上角的 fork,这样会fork到自己的账户下。
配置唤醒项目
在自己fork的仓库下,进入Secrets ,设置SITE变量
填评论后台的地址,这个leancloud国内版本是自己域名绑定的后台地址。我的是https://leancloud.heson10.com
启动
接下来对自己的项目点个 star 就能启动了,启动后请切换到 actions,看看是否运行成功。
在actions选项,可以看是否唤醒成功。
如果你的 GitHub 从来没有用过 actions,那么需要先 “了解”。方法很简单,点击绿色的按钮即可。
然后再取消star,再点击一次就可以看到了。
参考文档
1.Valine官方文档:https://valine.js.org/