插件特色
- 实现榜单查询功能
- 支持浏览量统计与显示
- 支持点赞量统计与显示
- 支持文章列表自定义排序
- 支持浏览量、点赞量异步接口调用
- 实现浏览量、点赞量当天不重复计算
- 支持点赞在当天取消
- 实现防抖策略，避免多次重复提交
功能介绍
1. 浏览量统计与显示
插件启用之后，代码无需任何改动，也不需要配置，默认就可以实现对文章浏览量的统计，然后你就可以在你的页面中，通过如下代码显示统计结果了。
<?php $this->viewsNum(); ?>
2. 点赞量统计与显示
点赞量统计与浏览量统计类似，只是没有默认统计一说，而是必须手动点击触发。因此，你必须在被点击的元素上，加上set-likes类和data-cid属性，示例代码如下：
<i class="set-likes iconfont icon-zan" data-cid="<?php $this->cid(); ?>"></i>然后，通过如下代码显示点赞量：
<?php $this->viewsNum(); ?>当然，如果你点错了或者后悔了，再次点击，就会取消点赞，即点赞数减一。
你也可以在自己的css文件中加入如下样式，以实现鼠标悬停的效果（因为每个人想要的效果可能不一样，所以该样式没有内置到插件中）。
.set-likes:hover {
cursor: pointer;
color: #dc3545;
}如果你希望点赞完成后，点赞量在当前页面无刷新的更新，则需要在显示点赞量的标签上加上get-likes类和data-cid属性，示例代码如下：
<span class="get-likes" data-cid="<?php $this->cid(); ?>"><?php $this->likesNum(); ?></span>3. 自定义排序
文章列表默认按照创建时间降序排序，但你可以通过修改插件的设置，实现按创建时间、浏览量、点赞量、权重(点赞量 * 100 + 浏览量)等更多形式的排序。例如，本文中提到的 导航网站 就是按照权重排序的。
4. 榜单查询
你也可以手动根据创建时间、浏览量、点赞量、权重排序，查询前N条数据，主要用于侧边栏的最新文章、热门文章等功能，调用示例如下：
<?php $rank = \TypechoPlugin\LZStat\Plugin::getRank(); ?>
<h3><?= $rank["title"]; ?></h3>
<?php if (empty($rank["posts"])) : ?>
<div>暂无数据</div>
<?php else : ?>
<div>
<?php $posts = $rank["posts"];
while ($posts->next()) : ?>
<a href="<?php $posts->permalink() ?>"><?php $posts->title() ?></a>
<?php endwhile; ?>
</div>
<?php endif; ?>排序方式(created，viewsNum，likesNum，weight)可以通过插件设置，也可以通过参数传递，查询条数通过博客控制台的 设置->阅读->文章列表数目 指定。考虑到每个人想要的显示效果不同，该功能只提供了数据查询接口，界面渲染需要自己写代码实现。
统计接口
如果上述方式都不能满足你的需求，你也可以直接通过调用下面的接口实现统计功能，然后自行实现界面渲染。
| 接口名称 | 请求类型 | 接口地址 | 返回值示例 |
|---|---|---|---|
| 浏览量统计 | GET | /action/stat?do=views&cid=${cid} | {"total":0} |
| 点赞量统计 | GET | /action/stat?do=likes&cid=${cid} | {"total":0} |
适配主题
你可以转到主题源码，查看具体用法，后续还会尝试让其适配更多类型的主题，以实现更通用、易用的目的！
不足之处
由于本插件是基于Cookie实现的，因此，如果用户在浏览器中禁用了Cookie，则无法实现浏览量、点赞量不重复计算，取消点赞等功能；另外，更换浏览器或者手动删除Cookie，也都会导致数据统计不准确。
插件的复杂性和数据准确性，鱼和熊掌二者不可兼得，权衡利弊之后，我认为浏览量和点赞量的准确性相对而言不那么重要，因而依然选择了基于Cookie的实现方式，因此，在你使用本插件之前，也必须认可这一点才行。
总结
浏览量和点赞量统计几乎是所有类型的网站都需要的功能，网上也有很多的版本，但始终没有合我心意的。因此，我自己实现了这个插件，希望在满足自己需求的基础上，通过后续适配更多不同类型的主题，也能满足更多人的需求！
本站所有文章，如无特殊说明或标注，均为本站原创发布；任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台；如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。
如果下载链接失效的话，请劳烦您在评论区反馈，以便我们及时处理。
