Skip to content

feat(simple): add site traffic stats to header and footer - #4469

Merged
tangly1024 merged 2 commits into
notionnext-org:mainfrom
ZZHow1024:fix/simple-busuanzi-stats
Aug 29, 2026
Merged

feat(simple): add site traffic stats to header and footer#4469
tangly1024 merged 2 commits into
notionnext-org:mainfrom
ZZHow1024:fix/simple-busuanzi-stats

Conversation

@ZZHow1024

Copy link
Copy Markdown
Contributor

Resolves #2958

已知问题

  1. Simple 主题目前缺少站点访问统计展示

    • 开启 ANALYTICS_BUSUANZI_ENABLE 后,Simple 主题 Header 和 Footer 未展示站点访问量、访客数
    • 其他部分主题已经提供类似的站点统计信息,Simple 主题在这方面表现不一致

解决方案

  1. 在 Simple 主题 Header 中增加站点访问统计

    • 复用现有 ANALYTICS_BUSUANZI_ENABLE 配置控制是否展示
    • 使用 Busuanzi 的 site_pvsite_uv 数据
    • 采用文字形式展示:访问量 xxx · 访客数 xxx
  2. 在 Simple 主题 Footer 中增加站点访问统计

    • 复用现有公共组件 AnalyticsBusuanzi
    • 复用 ANALYTICS_BUSUANZI_ENABLE 配置控制是否展示
    • 保持公共组件现有的图标展示形式
  3. 保持改动范围最小

    • 不修改 components/AnalyticsBusuanzi.js
    • 不新增主题配置项
    • 不修改 Busuanzi 的加载和统计逻辑
    • 不影响其他主题

改动收益

  1. 完善 Simple 主题的站点统计展示

    • Header 可直接查看站点访问量和访客数
    • Footer 与其他使用 AnalyticsBusuanzi 的位置保持一致
  2. 复用现有配置和组件

    • 无需新增环境变量或主题配置
    • 用户仍然只需要通过 ANALYTICS_BUSUANZI_ENABLE 控制 Busuanzi 的启用状态
  3. 保持统计口径一致

    • Header 和 Footer 均使用站点级别的 site_pv / site_uv
    • 避免将单页面 page_pv 与站点总访问量混用

具体改动

  1. themes/simple/components/Header.js

    • 读取现有 ANALYTICS_BUSUANZI_ENABLE 配置
    • 开启 Busuanzi 时展示站点访问量和访客数
    • 使用 busuanzi_value_site_pvbusuanzi_value_site_uv
    • 展示形式为:访问量 xxx · 访客数 xxx
  2. themes/simple/components/Footer.js

    • 引入现有 AnalyticsBusuanzi 公共组件
    • 读取现有 ANALYTICS_BUSUANZI_ENABLE 配置
    • 开启 Busuanzi 时展示现有图标形式的站点访问量和访客数
  3. docs/user-guide/themes/simple.md

    • 补充 Simple 主题不蒜子访问统计说明
    • 说明 Header 和 Footer 在开启 ANALYTICS_BUSUANZI_ENABLE 后的展示效果
    • 明确 Header 和 Footer 均使用站点级 site_pvsite_uv 数据

效果截图

ANALYTICS_BUSUANZI_ENABLE = true

Header

开启 Busuanzi 后的 Simple Header

Footer

开启 Busuanzi 后的 Simple Footer

ANALYTICS_BUSUANZI_ENABLE = false

Header

关闭 Busuanzi 后的 Simple Header

Footer

关闭 Busuanzi 后的 Simple Footer

测试确认

  • 本地开发环境测试通过
  • 生产环境构建测试通过
  • ANALYTICS_BUSUANZI_ENABLE = true 时 Header 正常显示访问量和访客数
  • ANALYTICS_BUSUANZI_ENABLE = true 时 Footer 正常显示访问量和访客数
  • ANALYTICS_BUSUANZI_ENABLE = false 时 Header 不显示访问统计
  • ANALYTICS_BUSUANZI_ENABLE = false 时 Footer 不显示访问统计
  • Header 与 Footer 的 site_pv / site_uv 数据保持一致
  • 未影响 Simple 主题其他 Header / Footer 内容及布局
  • 未影响其他主题

用户文档(docs/user-guide/ / docs/developer/

如果本 PR 新增或修改了站长会使用的功能、主题配置、环境变量、Notion Config 键、插件开关、部署步骤、默认行为或可见 UI 交互,请同步更新 docs/user-guide/docs/developer/ 中对应说明,并在下方勾选已完成项。

只有纯内部重构、测试、CI、依赖维护、拼写修正等不改变站长使用方式的改动,才可以勾选「不适用」。

  • 不适用(无文档改动)
  • 已按 维护工作流 自检
  • 路径符合 docs/user-guide/ 目录约定
  • 已更新 user-guide/README.md(新增/移动文章时)
  • 已更新 ARTICLE_INDEX.md(新 slug 或路径变更时)
  • 环境变量名与 conf/*.config.js 一致(若文档涉及配置)
  • 示例中无真实 Token、.env、私有 ID
  • 保留或更新了「原文链接」(若源自 docs.tangly1024.com)

文档说明(可选):本次改动复用已有 ANALYTICS_BUSUANZI_ENABLE 配置,不新增环境变量、主题配置或 Notion Config 键。

@vercel

vercel Bot commented Aug 27, 2026

Copy link
Copy Markdown

@ZZHow1024 is attempting to deploy a commit to the tangly1024's projects Team on Vercel.

A member of the Team first needs to authorize it.

@netlify

netlify Bot commented Aug 27, 2026

Copy link
Copy Markdown

Deploy Preview for notionnext-netlify ready!

Name Link
🔨 Latest commit f8a8b2c
🔍 Latest deploy log https://app.netlify.com/projects/notionnext-netlify/deploys/6a900f3c25e48400071db4ce
😎 Deploy Preview https://deploy-preview-4469--notionnext-netlify.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@tangly1024 tangly1024 added enhancement New feature or request theme labels Aug 29, 2026
@tangly1024
tangly1024 merged commit 183cac5 into notionnext-org:main Aug 29, 2026
11 of 13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request theme

Projects

None yet

Development

Successfully merging this pull request may close these issues.

【站点统计】希望大佬能为 Simple 主题添加站点的统计功能

2 participants