为博客文章添加阅读量统计功能

博客更换主题之后,查阅NexT 主题使用文档时,发现博客有文章阅读量统计功能,就想着也加上去。文档上虽然有相关介绍,但是发现新的主题已经集成了部分功能,内容有些出入。所以有了这边文章。

修改_config.yml文件

打开NexT主题的根目录下的_config.yml文件,找到以下内容:

1
2
3
4
leancloud_visitors:
enable: false
app_id: #<AppID>
app_key: #<AppKEY>

enable:false改为enable:true

注册LeanCloud

NexT的修改工作就完成之后,需要注册一个LeanCloud帐号才能继续使用这个功能。因为这个功能依赖于LeanCloud提供后端数据存取。点我快速注册

配置LeanCloud

注册完成LeanCloud帐号并验证邮箱之后,登录LeanCloud帐号。进行一番配置之后拿到AppID以及AppKey这两个参数,然后就可以正常使用文章阅读量统计的功能了。

创建应用

点击创建应用
创建应用
输入应用名,可以随意输入(之后可以更改),然后点击创建即可。
输入应用名

数据管理

应用创建成功之后进入数据管理
进入数据管理
在应用的数据配置界面,左侧下划线开头的都是系统预定义好的表,为了便于区分我们新建一张表来保存我们的数据。点击左侧右上角的齿轮图标,新建Class
新建Class
点击创建Class之后,为了保证我们前面对NexT主题的兼容,此处的新建Class名字必须为Counter
命名Class为Counter
创建完成之后,左侧数据栏应该会多出一栏名为Counter的栏目,这个时候我们点击顶部的设置,切换到应用的操作界面
打开应用设置

获取AppID、AppKey

在弹出的界面中,选择左侧的应用Key选项,即可发现我们创建应用的AppID以及AppKey
获取AppID、AppKey
复制AppID以及AppKey并在NexT主题的_config.yml文件中我们相应的位置填入即可,正确配置之后文件内容像这个样子:

1
2
3
4
leancloud_visitors:
enable: true
app_id: 你的AppID
app_key: 你的AppKey

重新部署Hexo博客

配置完成之后,重新生成部署Hexo博客,就可以正常使用文章阅读量统计的功能了。
需要特别说明的是:
记录文章访问量的唯一标识符是文章的发布日期以及文章的标题,因此请确保这两个数值组合的唯一性,如果你更改了这两个数值,会造成文章阅读数值的清零重计。

后台管理

现在查看博客,会发现文章的统计量显示为0,而且这个时候我们LeanCloud对应的应用的Counter表中并没有相应的记录。当博客文章在配置好阅读量统计服务之后第一次打开时,便会自动向服务器发送数据来创建一条数据,该数据会被记录在对应的应用的Counter表中。
后台数据管理
我们可以修改其中的time字段的数值来达到修改某一篇文章的访问量的目的。双击具体的数值,修改之后回车即可保存。
注:

  • url字段被当作唯一ID来使用,因此如果你不知道带来的后果的话请不要修改。
  • title字段显示的是博客文章的标题,用于后台管理的时候区分文章之用,没有什么实际作用。
  • 其他字段皆为自动生成,具体作用请查阅LeanCloud官方文档,如果你不知道有什么作用请不要随意修改。

至此,为博客文章添加阅读量统计功能就已经实现了。希望从此写博客能更有动力!

参考资料:
为NexT主题添加文章阅读量统计功能