基础配置
1.准备:注册,获取APP ID和APP KEY
请先 登录或注册LeanCloud
, 进入控制台后点击左下角创建应用:
应用创建好以后,进入刚刚创建的应用,选择左下角的设置
>应用Key
,然后就能看到你的APP ID
和APP Key
了:
2.复制HTML 片段到需要的地方
修改初始化对象中的appId
和appKey
的值为上面刚刚获取到的值即可(其他可以默认)。
<head>
..
<script src='//unpkg.com/valine/dist/Valine.min.js'></script>
...
</head>
<body>
...
<div id="vcomments"></div>
<script>
new Valine({
el: '#vcomments',
appId: 'Your appId',
appKey: 'Your appKey'
})
</script>
</body>
3.评论数据管理
由于Valine 是无后端评论系统,所以也就没有开发评论数据管理功能。请自行登录Leancloud应用
管理。
具体步骤:登录
>选择你创建的应用
>存储
>选择Class Comment
,然后就可以尽情的发挥你的权利啦(~ ̄▽ ̄)~
4. 安全域名
为了你的数据安全,请设置自己的安全域名
:
5.头像配置
Valine 目前使用的是Gravatar作为评论列表头像。
请自行登录或注册Gravatar,然后修改自己的头像。
评论的时候,留下在Gravatar注册时所使用的邮箱即可。
扩展功能
1.QQ头像
🔗 enableQQ
- 类型:
Boolean
- 默认值:
false
- 必要性:
false
是否启用昵称框
自动获取QQ昵称
和QQ头像
, 默认关闭,需博/网站主
主动启用
v1.4.6+
成功显示
2.设置昵称或邮箱必填
🔗 requiredFields
- 类型:
Array
- 默认值:
[]
- 必要性:
false
设置必填项
,默认匿名
,可选值:
['nick']
['nick','mail']
v1.4.6+
需要注意,设置nick后昵称需三个字节以上
3.修改评论输入框提示
通过查看网页元素,可以发现三个样式分别为vnick vinput
、vmail vinput
、vlink vinput
的Input框和一个veditor vinput
的textarea框,且均无id。
于是我们便可以通过class名称来定位到这些内容,然后修改其中的内容。
//修改comment的昵称说明
function update_nick() {
var inputs = document.getElementsByClassName("vnick vinput");//通常获取的是表单标签name
document.getElementsByClassName("vnick vinput")[0].setAttribute('placeholder', '昵称/QQ(qq可以自动获取昵称头像!!!)');
document.getElementsByClassName("vmail vinput")[0].setAttribute('placeholder', '邮箱(可不填)');
document.getElementsByClassName("vlink vinput")[0].setAttribute('placeholder', '个人主页(可不填)');
document.getElementsByClassName("veditor vinput")[0].setAttribute('placeholder', '来都来了,给我留个言吧[○・`Д´・ ○]');
//console.log(inputs);
}
setInterval(update_nick, 1000);
这就是修改前后的样式了:
Valine评论Plus
直接将原生的 Valine 替换为以下的 Valine.min.js
文件。
https://cdn.jsdelivr.net/gh/HCLonely/Valine@latest/dist/Valine.min.js
与原生的相比,多了以下功能:
- 添加博主,小伙伴,访客标签,请使用 MD5加密邮箱。
- 添加浏览器和操作系统图标,需引入
fontawesome v5.0+
的 CSS 样式- 邮箱检测更严格
- 增加 QQ 邮箱识别(原版只能通过昵称栏输入 QQ 号识别)
- meta placeholder 可自定义
使用方法与原生的类似,不同的是可以多设置几个参数:
参数 | 类型 | 说明 | 默认 | 示例 |
---|---|---|---|---|
tagMeta | Array | 标签要显示的文字 | [“博主”,“小伙伴”,“访客”] | [“博主”,”小伙伴”,”访客”] |
master | Array/String | md5 加密后的博主邮箱 | [] | [“fe01ce2a7fbac8fafaed7c982a04e229”] |
friends | Array | md5 加密后的小伙伴邮箱 | [] | [“fe01ce2a7fbac8fafaed7c982a04e229”] |
metaPlaceholder | Object | meta placeholder 内容 | {} | {“nick”:“昵称 / QQ 号”,“mail”:“邮箱 (必填)”} |
verify | Boolean | 评论时是否需要验证,需 jQuery 支持 | false | true |
参考资料: