# 前言

shoka 主题采用的文章评论功能是 MiniValine 魔改版，该项目魔改自原 MiniValine 项目。评论通知与管理工具建议使用这个 Valine-Admin。需要注册 Leancloud，推荐注册华北区，国际区需要翻墙才能评论，评论管理工具也是同理，但是步骤都一样，放心食用，也可以使用其它自己喜欢的评论插件。

食用前请先阅读：🚀 Hexo 博客基础搭建、🌈 Hexo 博客主题更换

这部分参考文献：Valine 文档、MiniValine 魔改版、Valine-Admin 工具

📝 主题前言

🚀 基础搭建

🌐 域名绑定

🌈 主题更换

💬 评论功能 👈 当前位置 📌

🔎 搜索功能

🎨 图床搭建

# 文章评论功能

魔改版 MiniValine 项目主要用在 Hexo Theme Shoka >= 0.2 中，是该主题暂时、唯一支持的评论功能。如果想用在其他地方，需要自行修改，比如加上 css 等。本文档仅提供基本的配置参数说明。

# 获取 `APP ID` 和 `APP Key`

获取 APP ID 和 APP Key 前往注册：https://console.leancloud.app ，注册登陆后 👉 创建应用 👉 填写应用名称 👉 选择开发版 👉 创建应用

设置 👉 应用凭证，在这里就能看到你的 APP ID 和 APP Key

# valine 配置

在 <root>/_config.shoka.yml 里配置 valine ，把 appID 和 appKey 改成你应用的 AppID 和 AppKey ，其他配置看需求配置即可

	valine:
	appId: #Your_appId
	appKey: #Your_appkey
	placeholder: ヽ(○´∀`)ﾉ♪ # Comment box placeholder
	avatar: mp # Gravatar style : mp, identicon, monsterid, wavatar, robohash, retro
	pageSize: 10 # Pagination size
	lang: zh-CN
	visitor: true # 文章访问量统计
	NoRecordIP: false # 不记录 IP
	serverURLs: # When the custom domain name is enabled, fill it in here (it will be detected automatically by default, no need to fill in)
	powerMode: true # 默认打开评论框输入特效
	tagMeta:
	visitor: 新朋友
	master: 主人
	friend: 小伙伴
	investor: 金主粑粑
	tagColor:
	master: "var(--color-orange)"
	friend: "var(--color-aqua)"
	investor: "var(--color-pink)"
	tagMember:
	master:
	# - hash of master@email.com #需要把邮箱转成 MD5 加密格式才有效
	# - hash of master2@email.com
	friend:
	# - hash of friend@email.com
	# - hash of friend2@email.com
	investor:
	# - hash of investor1@email.com

记得引入 js

	vendors:
	js:
	valine: gh/amehime/MiniValine@4.2.2-beta10/dist/MiniValine.min.js

现在可以评论了

在文章 Front Matter 中也可以配置上述参数，访问该文章页面时，将覆盖全局配置。
尤其可以用来配置一个特殊的 placeholder。

valine:

  placeholder: "1. 提问前请先仔细阅读本文档⚡\n2. 页面显示问题💥，请提供控制台截图📸或者您的测试网址\n3. 其他任何报错💣，请提供详细描述和截图📸，祝食用愉快💪"

---

如果某一篇文章需要关闭评论功能，则在文章 Front Matter 中配置：

	---
	title: 关闭评论
	comment: false
	---

# 评论通知与管理工具

评论通知与管理工具建议使用这个 Valine-Admin。（由于我的域名没有备案，我这里使用国际版演示）

我这里只做一个最简单的配置演示，如果有其他需求可以看看 Valine-Admin 的文档进行配置

# 基本配置

设置 👉 安全中心 👉 设置 Web 安全域名：设置你博客的 Web 安全域名

云引擎 👉 WEB 👉 设置 👉 设置访问域名 👉 到你的域名代理商域名服务里配置主机值

# 自定义环境变量

进入评论系统数据库所在的 LeanCloud 应用。进入「云引擎 - 设置」，设置环境变量以及云引擎域名。以下参数需要正确设置。云引擎域名（ADMIN_URL 参数）用于评论后台管理，如。

变量	示例	说明
SITE_NAME	小森の blog	[必填] 博客名称
SITE_URL	https://chinoaider.com/	[必填] 首页地址
SMTP_SERVICE	QQ	[新版支持] 邮件服务提供商，支持 QQ、163、126、Gmail 以及更多
SMTP_USER	xxxxxx@qq.com	[必填] SMTP 登录用户
SMTP_PASS	ccxxxxxxxxch	[必填] SMTP 登录密码（QQ 邮箱需要获取独立密码）
SENDER_NAME	小森の blog	[必填] 发件人
SENDER_EMAIL	xxxxxx@qq.com	[必填] 发件邮箱
ADMIN_URL	https://xxx.leanapp.cn/	[建议] Web 主机二级域名（云引擎域名），用于自动唤醒
BLOGGER_EMAIL	xxxxx@gmail.com	[可选] 博主通知收件地址，默认使用 SENDER_EMAIL
AKISMET_KEY	xxxxxxxx	[可选] Akismet Key 用于垃圾评论检测，设为 MANUAL_REVIEW 开启人工审核，留空不使用反垃圾