ArtalkJS 评论系统总评论数统计功能实现指南

2025-07-07 19:50:05作者：温艾琴Wonderful

ArtalkJS 作为一款现代化的自托管评论系统，提供了丰富的 API 接口供开发者调用。其中，获取站点总评论数是一个常见需求，本文将详细介绍如何实现这一功能。

核心API接口

ArtalkJS 提供了专门的统计接口来获取站点总评论数。通过向服务器发送 GET 请求，可以获取指定站点的评论总数。请求格式如下：

GET /api/v2/stats/site_comment?site_name=站点名

服务器会返回 JSON 格式的响应，其中 data 字段即为总评论数：

{
  "data": 957
}

前端实现方案

在前端页面中，我们可以使用 JavaScript 的 fetch API 来获取并显示总评论数。以下是完整的实现代码示例：

// 定义站点名称
const siteName = '你的站点名称';
// 构建请求URL
const url = `https://你的artalk域名/api/v2/stats/site_comment?site_name=${encodeURIComponent(siteName)}`;

// 发起请求获取数据
fetch(url)
  .then(response => {
    if (!response.ok) {
      throw new Error('网络请求失败');
    }
    return response.json();
  })
  .then(({ data }) => {
    // 将数据显示在页面上
    const counterElement = document.getElementById('comment-counter');
    if (counterElement) {
      counterElement.textContent = data;
    }
  })
  .catch(error => {
    console.error('获取评论数时出错:', error);
  });

HTML 集成示例

在 HTML 页面中，你可以这样使用上述 JavaScript 代码：

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>我的网站</title>
</head>
<body>
  <header>
    <h1>欢迎来到我的网站</h1>
    <p>总评论数: <span id="comment-counter">加载中...</span></p>
  </header>

  <script>
    // 这里放置上面的JavaScript代码
  </script>
</body>
</html>