基础配置

1.准备:注册,获取APP ID和APP KEY

请先 登录注册LeanCloud, 进入控制台后点击左下角创建应用

image.png

应用创建好以后,进入刚刚创建的应用,选择左下角的设置>应用Key,然后就能看到你的APP IDAPP Key了:

img

2.复制HTML 片段到需要的地方

修改初始化对象中的appIdappKey的值为上面刚刚获取到的值即可(其他可以默认)。

<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 vinputvmail vinputvlink 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

与原生的相比,多了以下功能:

  1. 添加博主,小伙伴,访客标签,请使用 MD5加密邮箱。
  2. 添加浏览器和操作系统图标,需引入 fontawesome v5.0+的 CSS 样式
  3. 邮箱检测更严格
  4. 增加 QQ 邮箱识别(原版只能通过昵称栏输入 QQ 号识别)
  5. 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





参考资料:

1.Jekyll博客添加Valine评论

2.Valine官网文档

3.Valine评论系统详解

4.博客Valine评论样式美化