使用教程

插件配置教程

前置准备

在使用数据统计插件的访问统计功能之前，您需要先部署 Umami 统计服务。

插件设置

在 Halo 后台进入「插件」→「数据统计插件」→「设置」，配置以下参数：

• 站点地址：填写您的 Umami 站点地址，例如：https://umami.example.com
• 用户名：填写您的 Umami 登录用户名，例如：admin
• 密码：填写您的 Umami 登录密码
• 网站 ID：填写您要统计的网站在 Umami 中的 ID

获取网站 ID

1. 打开您已经部署好的 Umami 管理后台
2. 在网站列表中找到您需要统计的网站
3. 点击网站名称进入详情页面，在 URL 或页面信息中可以找到网站 ID

4. 将获取到的网站 ID 填入插件设置中
5. 点击「保存」按钮完成配置

在编辑器中使用

使用 Halo 默认编辑器

在 Halo 的文章编辑器中，您可以通过以下方式插入统计组件：

1. 在编辑器中点击 + 按钮
2. 在插入菜单中找到以下选项：
   • 插入网站数据统计 - 插入网站内部数据图表
   • Umami 插入统计 - 插入 Umami 流量统计
3. 点击对应的选项即可插入

配置数据图表

插入「网站数据统计」组件后，您可以选择需要显示的图表模块：

• 可以选择特定的图表模块，也可以全选所有模块
• 可以在同一篇文章中插入多个数据统计组件
• 每个组件可以配置不同的图表类型组合

在模板中使用

如果您需要在网站的任意位置（如主题模板、自定义页面等）插入统计组件，可以使用以下 HTML 代码。

Umami 统计组件

流量统计

在页面中插入以下 HTML 代码，即可显示 Umami 流量统计：

<div class="xhhaocom-dataStatistics-v2-traffic"></div>

实时活动

在页面中插入以下 HTML 代码，即可显示 Umami 实时活动：

<div class="xhhaocom-dataStatistics-v2-activity"></div>

网站统计图表组件

显示所有图表

在页面中插入以下 HTML 代码，将显示所有可用的统计图表：

<div class="xhhaocom-chartboard"></div>

选择特定图表类型

通过 data-types 属性选择要显示的图表类型，多个类型用逗号分隔。

可用的图表类型：

• tags - 标签统计
• categories - 分类统计
• articles - 文章发布趋势
• comments - 评论活跃用户 Top10
• topArticles - 热门文章 Top10

使用示例：

<!-- 只显示标签和分类 -->
<div class="xhhaocom-chartboard" data-types="tags,categories"></div>

<!-- 只显示文章趋势 -->
<div class="xhhaocom-chartboard" data-types="articles"></div>

<!-- 显示评论排行和热门文章 -->
<div class="xhhaocom-chartboard" data-types="comments,topArticles"></div>

Uptime Kuma 配置教程

前置准备

Uptime Kuma 是一个开源的监控工具，用于监控网站和服务的可用性。在使用数据统计插件的 Uptime Kuma 功能之前，您需要先部署 Uptime Kuma 服务。

插件设置

在 Halo 后台进入「插件」→「设置」，找到 Uptime Kuma 配置部分，配置以下参数：

• 站点地址：填写您的 Uptime Kuma 状态页地址，例如：https://status.twouu.com/status/handsome

如何使用

方法一：在模板中使用 HTML 代码

如果您熟悉 HTML，可以在需要显示监控状态的位置插入以下代码：

<div class="xhhaocom-dataStatistics-v2-uptime-kuma"></div>

方法二：通过 Halo 设置页面注入代码

如果您不熟悉 HTML，可以通过 Halo 的设置页面来注入代码：

1. 在 Halo 后台进入「设置」页面

2. 找到「代码注入」选项并点击进入

3. 在「页脚」输入框中粘贴以下代码：

<div class="xhhaocom-dataStatistics-v2-uptime-kuma"></div>

4. 点击「保存」按钮完成配置