子比主题百度统计数据展示插件

如果你用百度统计做站点分析，大概都有同样的体验：想看数据得单独打开 tongji.baidu.com，登录、选站点、切日期，来回折腾。对于每天都要瞄一眼流量的站长来说，这个过程实在不够顺手。

这篇文章介绍一款我自己在用的 WordPress 插件——百度统计数据（baidu-tongji）。它通过百度统计 OpenAPI 把数据搬进 WordPress：后台有完整看板，前台可以用小工具或独立页面展示数据，样式与 Zibll 主题保持一致。

一、插件能做什么

• 后台数据看板：概况指标卡、流量趋势、来源分布、搜索引擎、搜索词、受访页面、入口页面、地域分布、实时访客，共 9 个模块，支持站点与日期切换。
• 10 个前端小工具：数字统计卡、趋势图表、热门页面、入口页面、来源分布、搜索引擎、搜索词、地域分布、实时访客，以及一个可自由组合的「可视化看板」。
• 前台独立数据页：新建页面时选择「百度统计页面」模板，即可得到一个完整的公开数据页，模块顺序与宽度可在后台可视化拖拽配置。
• 前台切换日期：小工具和独立页面都支持在「今日 / 昨日 / 近7天 / 近30天」之间切换，AJAX 局部刷新，不跳转页面。
• 权限控制：每个小工具可单独设置「所有人 / 仅登录用户 / 仅管理员」可见。
• 逐模块条数：排行榜类模块可以单独设置显示 3～50 条，不用改代码。
• 样式跟随主题：引用 Zibll 的 CSS 变量，自动适配主题色与暗色模式。

二、安装前的准备

开始之前，需要确认三件事：

1. 有一个百度统计账号，并且已经给站点安装了统计代码、能正常看到数据。
2. 在百度统计后台「管理 → 数据导出服务」中开通服务，拿到 API Key 与 Secret Key。这一步是免费的，但需要手动申请开通。
3. WordPress 6.0 以上、PHP 7.4 以上。插件按 Zibll 主题设计，其他主题也能运行，只是外观可能需要微调。

三、安装与授权

把插件目录上传到 /wp-content/plugins/，在后台启用后，进入「百度统计 → 设置」，按向导完成三步：

1. 填写凭据：粘贴 API Key 与 Secret Key，保存后会生成一个百度授权链接。
2. 获取授权码：打开授权链接登录百度账号，页面会直接显示一串 CODE，复制回来提交即可完成授权。
3. 选择站点：读取账号下的站点列表，选择要展示的默认站点并保存。

授权完成后不需要再管 Token。插件会在访问令牌过期前自动刷新，刷新失败时会在设置页提示重新授权，整个过程不需要手动维护。

四、后台数据看板

启用插件后，后台左侧会出现「百度统计」菜单。看板包含 9 个模块，每个模块独立异步加载，互不阻塞；顶部可以切换站点和日期范围（今日、昨日、近7天、近30天，也支持自定义日期）。

数据会缓存在本地，接口临时不可用时自动降级展示最近一次成功的数据，并标注「数据更新于缓存」，不会出现整页报错。想强制拉取最新数据，可以在设置页点「清除缓存」。

五、前台独立数据页

如果想把数据公开给访客看，独立页面是最省事的方式。新建一个页面，在「页面属性 → 模板」里选择「百度统计页面」，发布即可。

模块的显示与排列完全可视化：在设置页「前台独立页面」一栏，把左侧未启用的模块拖进画布，拖动排序，点击宽度徽标在「整行 / 半行 / ⅓行」之间切换。排行榜类模块还能单独设置显示条数。页面标题、查看权限、默认日期范围也都在这里配置。

六、前端小工具

在「外观 → 小工具」里可以添加 10 种统计小工具。它们与独立页面共用同一套渲染器，外观完全一致：居中的标题、跟随主题色的数字卡与图表、暗色模式下自动换色。

其中「可视化看板」小工具相当于一个迷你版独立页面：一个小工具里可以组合多个模块，后台同样用拖拽画布配置顺序和宽度，适合放在首页顶部或侧栏。

每个小工具都支持：