浏览量统计
Artalk 内置页面浏览量统计和评论数统计功能,你可以在页面中显示页面的浏览量和评论数。
浏览量:<span class="artalk-pv-count"></span>
评论数:<span class="artalk-comment-count"></span>加载占位符
Artalk 加载需要时间,你可以在展示统计数的元素中加入占位符:
<span class="artalk-pv-count">加载中...</span>同时加载多个页面的统计数
例如在文章列表页,你可以显示每篇文章的浏览量和评论数。
当处于文章列表页时,仅需调用 Artalk.loadCountWidget 函数,而无需 Artalk.init (加载评论列表会使页面浏览量 PV 数 +1)。
Artalk.loadCountWidget({
server: '服务器地址',
site: '站点名',
pvEl: '.artalk-pv-count',
countEl: '.artalk-comment-count',
statPageKeyAttr: 'data-page-key',
})然后放置多个 class 为 artalk-pv-count 的元素,通过属性 data-page-key 来指定需要查询的页面:
<span class="artalk-pv-count" data-page-key="/test/1.html"></span>
<span class="artalk-pv-count" data-page-key="/test/2.html"></span>
<span class="artalk-pv-count" data-page-key="/test/3.html"></span>评论数查询同理:
<span class="artalk-comment-count" data-page-key="/test/1.html"></span>
<span class="artalk-comment-count" data-page-key="/test/2.html"></span>
<span class="artalk-comment-count" data-page-key="/test/3.html"></span>自定义元素选择器
可通过配置项 pvEl 和 countEl 来指定元素选择器,以展示页面浏览量和评论数:
Artalk.init({
pvEl: '.your_pv_count_element', // 页面浏览量元素选择器
countEl: '.your_comment_count_element', // 评论数元素选择器
})自定义 data-page-key 属性名
配置项 statPageKeyAttr 的默认值为 data-page-key,Artalk 会通过该属性名来查询指定页面。为了方便博客主题的适配,可通过它自定义属性名,例如将其替换为 data-path:
Artalk.loadCountWidget({
statPageKeyAttr: 'data-path',
})此时,对应的 HTML 代码应如下所示:
<span class="artalk-pv-count" data-path="/test/1.html"></span>这样,data-path 属性值将被用于查询指定的页面。
自动登记页面与防滥用
页面首次访问时仍会自动登记并累计 PV,无需预先创建页面。为限制通过随机页面地址批量写入数据,每个服务进程在一分钟窗口内最多允许每个 IP 通过 PV 请求创建 60 个页面,总计 600 个页面;不同站点共用此额度。额度独立于验证码设置。
达到额度后,仅跳过该次新页面登记,返回 PV 为 0,不弹出验证码。窗口重置后的访问可以重新尝试;跳过的访问不会事后补计。已有页面继续正常累计 PV,评论提交仍按原有验证流程处理。使用反向代理时,请正确配置可信代理,以便服务器识别访问者 IP。
控制中心的页面列表只显示有评论的页面(包括只有待审核评论的页面)。过滤不会删除记录或改变 PV、投票等统计。页面列表 API 的 has_comments 是可选参数;省略时仍返回全部页面,兼容已有客户端。
qwqcode
Mr.Hope
pluveto