7.1 KiB
在配置前,请升级NexT至v6.0.6以上。
在配置过程中请注意博客配置文件和主题配置文件的区别。
注册Leancloud并创建应用
-
首先,前往Leancloud官网leancloud.cn进行注册,并登陆。
-
然后点击图示
1
处,进入控制台: -
接着,点击图示
1
处,创建应用: -
在弹出窗口
1
处输入应用名称(可随意输入,可更改,为演示方便取名为test),并选择2
处“开发版”,然后点击3
处创建:
到这里应用创建完成。
建立Counter类并在NexT中启用插件
-
点击
1
处应用名称进入应用管理界面: -
如图,点击侧边栏
1
处创建Class: -
在弹出窗口
1
处填入Counter
,勾选2
处无限制,并点击3
处创建Class: -
此时类已创建完成。接下来点击图示
1
处进入设置,然后点击2
处进入应用Key: -
粘贴
App ID
和App Key
到NexT主题配置文件_config.yml
对应位置。此时配置文件应如下:
leancloud_visitors:
enable: true
security: true
app_id: <<your app id>>
app_key: <<your app key>>
- 设置Web安全域名确保域名调用安全。点击
1
处进入安全中心,然后在2
处填写自己博客对应的域名(注意协议、域名和端口号需严格一致):
到这里内容均与Doublemine的为NexT主题添加文章阅读量统计功能这篇文章相同,只不过截图为新版的Leancloud的界面。
部署云引擎以保证访客数量不被随意篡改
-
点击左侧
1
处云引擎,然后点击2
处部署,再点击3
处在线编辑: -
点击
1
处创建函数: -
在弹出窗口选择
1
处Hook
类型,然后2
处选择beforeUpdate
,3
处选择刚才建立的Counter
类。在4
中粘贴下方代码后,点5
处保存。var query = new AV.Query("Counter"); if (request.object.updatedKeys.indexOf('time') !== -1) { return query.get(request.object.id).then(function (obj) { if (obj.get("time") > request.object.get("time")) { throw new AV.Cloud.Error('Invalid update!'); } return request.object.save(); }); }
如图所示:
-
点击保存后应出现类似红框处函数。此时点击
1
处部署: -
在弹出窗口点击
1
处部署: -
等待出现红框处的成功部署信息后,点击
1
处关闭:
至此云引擎已成功部署,任何非法的访客数量更改请求都将失败。
进一步设置权限
-
打开NexT主题配置文件
_config.yml
,将leancloud_visitors下的security设置为true(如没有则新增):leancloud_visitors: enable: true app_id: <<your app id>> app_key: <<your app key>> # Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security security: true betterPerformance: false
对
betterPerformance
选项的说明: 由于Leancloud免费版的云引擎存在请求线程数和运行时间限制以及休眠机制,很多时候访客数量加载会很慢。如果设置betterPerformance
为true
,则网页则会在提交请求之前直接显示访客人数为查询到的人数+1,以增加用户体验。 -
打开cmd并切换至博客根目录,键入以下命令以安装
hexo-leancloud-counter-security
插件:npm install hexo-leancloud-counter-security --save
-
打开博客配置文件
_config.yml
,新增以下配置:leancloud_counter_security: enable_sync: true app_id: <<your app id>> app_key: <<your app key> username: password:
-
在相同目录键入以下命令:
hexo lc-counter register <<username>> <<password>>
或
hexo lc-counter r <<username>> <<password>>
将
<<username>>
和<<password>>
替换为你自己的用户名和密码(不必与leancloud的账号相同)。此用户名和密码将在hexo部署时使用。- 打开博客配置文件
_config.yml
,将<<username>>
和<<password>>
替换为你刚刚设置的用户名和密码:
leancloud_counter_security: enable_sync: true app_id: <<your app id>> app_key: <<your app key> username: <<your username>> #如留空则将在部署时询问 password: <<your password>> #建议留空以保证安全性,如留空则将在部署时询问
- 打开博客配置文件
-
在博客配置文件
_config.yml
的deploy
下添加项:deploy: # other deployer - type: leancloud_counter_security_sync
-
返回Leancloud控制台的应用内。依次点击
1
2
,检查_User表中是否出现一条记录(图示以用户名为admin为例): -
点击
1
处进入Counter表,依次点击2
3
,打开权限设置: -
点击此处应与下条create设置相同(选择你所创建的用户):1
add_fields后选择2
指定用户, 并将下两栏留空: -
点击
1
create后选择2
指定用户, 在3
处键入用户名,点击4
处后点击5
处添加:完成此步操作后,界面应与图示类似:
-
点击
1
delete后选择2
指定用户, 并将下两栏留空:
至此权限已设置完成,数据库记录只能在本地增删。
每次运行hexo d
部署的时候,插件都会扫描本地source/_posts
下的文章并与数据库对比,然后在数据库创建没有录入数据库的文章记录。
如果在博客配置文件中留空username或password,则在部署过程中程序会要求输入。