这是一个为 Typecho 博客系统开发的访客统计插件,基于原版的VistorLogger修改版本。该插件提供了详细的访问统计功能,包括访问国家/地区统计、IP分布等信息,并进行了隐私保护处理。
| 项目 | 要求 |
|---|---|
| Typecho | 1.2.x ~ 1.3.0(已适配 1.3.0 最新版命名空间与后台布局) |
| PHP | 7.4+(推荐 8.0+,已在 8.3 验证) |
| 数据库 | MySQL 5.5+ / 8.0+(自动检测并回退 SQL) |
| 主题 | Handsome 主题可使用前台访客统计页(需拷贝模板文件) |
- 三种统计模式:
- 前端埋点(推荐):对照 Umami 开源实现——浏览器只上报页面元数据,服务端按 IP+UA+月盐识别访客、按 30 分钟 visit 识别访问;不使用追踪 Cookie
- 混合模式:服务端直接按同一套 Umami 算法写 visitor_id / session_id
- 仅服务端:旧版简易 IP+UA 口径(兼容历史行为)
- 四项核心指标:PV(页面浏览量)、独立IP数、独立访客数(UV)、访问次数(会话数)
- Umami 访客口径:
visitor_id= UmamisessionId(IP + UA + 月盐,按月轮换) - Umami 访问口径:
session_id= UmamivisitId(30 分钟无活动超时);旧数据自动回退 IP 间隔算法 - 访问国家/地区统计(Top 30)
- IP分布统计(已匿名化处理)
- 省份访问统计图表
- 路由访问统计分析(页面访问量统计)
- 访问时间统计(按日期分布)
- 管理员访问自动排除
- 可配置爬虫 UA 过滤(默认名单已扩充)
- 日期范围选择器
- 快捷时间选择(今天、昨日、最近7天、本周、上周、本月、上月、最近30天、全部)
- 按钮选中状态高亮显示
- 默认只加载近7天数据,优化首次加载速度
- 四条曲线同时展示:支持PV、独立IP、独立访客(UV)、访问次数四项指标同屏对比
- 趋势分析页面:全新的访客趋势分析功能,支持多维度数据分析
- 动态时间轴:选择单日时自动切换为小时段显示(0:00-23:00)
- 智能图例设计:优化颜色方案和图例布局,提升可读性
- ECharts环形图表展示方式
- 列表视图支持(详细数据展示)
- 图表悬停效果(显示详细信息)
- 自适应图表区域
- 删除特定IP记录功能(支持模糊匹配)
- 数据库自动优化
- 时区自动转换功能,确保访客时间记录准确
- 禁用时删除数据表开关:插件设置中可配置禁用插件时是否删除
visitor_log,默认关闭(保留数据)
- 异步API数据加载(getVisitStatistic.php和getTrendData.php)
- 解决大数据量加载问题,提高页面响应速度(从10s优化到2s)
- 数据库索引自动补齐:为
time/country/ip等字段建立索引,90万+ 日志量级下显著加速统计查询 - 统计查询减负:合并多余 COUNT、避免
DATE(time)破坏索引、趋势会话数改为一次分组计算 - 后台面板:国家/路由统计改为 SQL 聚合,不再把全表拉进 PHP
- 智能资源加载机制:ECharts和Flatpickr的CDN优先加载,失败时自动回退到本地文件
- 智能SQL回退机制:兼容MySQL 5.5+到8.0+所有版本,自动检测数据库版本
- 使用CDN加载ECharts图表库,减少插件体积
- 优化移动端显示
- IP地址匿名化处理(只显示前两段)
- 明确的隐私声明
- 符合相关法律法规要求
- 数据安全存储
- 统计摘要卡片:新增四项核心指标的数值展示区域
- 指标说明区域:详细说明PV、独立IP数、独立访客数(UV)、访问次数的概念和统计方法
- 响应式设计:指标说明区域支持桌面端4列网格和移动端单列布局
- Typecho 1.3 后台布局适配:修复宽屏/高缩放下区块宽度不一致问题
- 饼图尺寸优化:适当放大饼图显示区域,提升数据可视性和视觉效果
- 渐变视觉效果:为柱状图添加蓝色渐变背景和红色悬停效果
- 移动端自适应布局
- 美观的图表展示
- 增高环形图展示区域,改善视觉效果
- 列表/图表切换视图
- 优雅的加载动画
- 下载插件文件
- 在本地解压后把目录名改为
VisitorLoggerPro(目录名大小写需一致) - 将改后的文件上传到
/usr/plugins目录下 - 插件名为
VisitorLoggerPro - 在 Typecho 后台启用插件
- 要把该文件
visitor-stats.php移动到handsome主题根目录(handsome主题适用)
Typecho 1.3.0 的自动加载对目录名大小写更严格,请确保插件目录名为
VisitorLoggerPro。
- 在 Typecho 后台创建新页面
- 在页面模板中选择"访客统计"
- 发布页面即可看到统计效果
- 创建新页面,选择"访客统计"模板
在 控制台 → 插件 → VisitorLoggerPro → 设置 中可配置:
| 选项 | 说明 | 默认 |
|---|---|---|
| 统计模式 | 前端埋点 / 混合 / 仅服务端。推荐「前端埋点」对齐 Umami 开源口径 |
表单默认前端埋点;未保存过配置的旧站运行时仍按仅服务端 |
| 蜘蛛过滤设置 | 按格式配置爬虫 UA 关键字,命中则不记入 | 内置常见搜索引擎与爬虫 |
| 忽略的IP地址 | 不记录的 IP(支持精确 / 通配符 / CIDR) | 空 |
| IPV4数据库选项 | 纯真 或 ip2region |
纯真 |
| 启用访客统计 | 是否启用统计功能 | 启用 |
| 禁用时删除数据表 | 开关:开启后禁用插件会删除 visitor_log 表及全部记录 |
关闭(保留数据) |
升级提示(2.4.x):在设置中选择「前端埋点」并保存即可。脚本会由插件自动注入(搜索
tracker.js),无需手动改主题。身份标识改为服务端按 Umami 算法计算,不再依赖_vlp_uid/_vlp_sidCookie。若源码中完全没有脚本,请确认主题输出了$this->header()。
启用后,管理员菜单会出现:
- 访客日志:访问明细、IP 查询/删除、地区与路由图表
- 趋势分析:PV / 独立 IP / UV / 会话 四项指标趋势
插件启用失败解决办法: 有一部分小伙伴之前使用过VisitorLogger插件,然后如果直接启用VisitorLoggerPro的话会报错
- 1.只需要把VisitorLogger相关文件全部删除即可,也就是两者不能共存。
- 2.数据库表不需要修改,但也可以把bot_list表删掉因为用不到。
Typecho 1.3.0 后台布局不协调:
- 请升级到本插件 v2.2.10+。该版本已适配 1.3 后台
flex布局,并修复访客日志 / 趋势分析页宽度不一致问题。
本插件已实现以下隐私保护措施:
- IP地址匿名化处理(只显示前两段)
- 明确的隐私声明
- 符合相关法律法规要求
- 前端:ECharts 图表库;埋点脚本对照 Umami tracker(只上报元数据 + cache token)
- 后端:PHP + MySQL;身份算法对照 Umami
/api/send(UmamiIdentity.php) - 数据存储:Typecho 数据库;
visitor_id/session_id对应 UmamisessionId/visitId - 数据处理:通过API异步加载,支持PV、UV、IP、会话四项指标
- 访客算法:IP + User-Agent + 月盐(按月轮换,与 Umami 默认一致)
- 访问算法:30 分钟无活动超时(
iat > 1800) - 兼容性:自动检测MySQL版本,智能回退到简化算法
- Typecho 适配:
adapter.php兼容 1.2 旧类名与 1.3 命名空间(PluginInterface/ActionInterface/Utils\Helper等)
- 博客:https://blog.ybyq.wang/
- GitHub:https://github.com/BXCQ
- 原版插件地址:https://github.com/PengMai1998/VisitorLogger
MIT License
统计口径(对照 umami-software/umami)
- 取消 Cookie 访客/会话标识:不再使用
_vlp_uid/_vlp_sid(此前误称为 Umami 口径) - 访客(UV):服务端
visitor_id = hash(站点, IP, UA, 月盐),对应 UmamisessionId/visitors - 访问(会话):
session_id为 30 分钟超时的 visit,对应 UmamivisitId/visits;前端用X-VLP-Cache维持 visit(对齐x-umami-cache) - 前端埋点:只上报 url/referrer/title 等元数据,身份全部服务端计算
- 混合模式:服务端直接套用同一算法,前端不再 beacon
- 消除
adapter.php重复声明告警:Typecho 1.2+/1.3 自动加载命名空间类时会顺带创建旧式别名;适配器在class_exists后再class_alias会导致Cannot declare class ... already in use。现于自动加载后再次检测目标符号,避免重复别名。
- 后台布局适配:覆盖 1.3
grid.css中.container { display:flex }导致的区块宽度不一致问题 - 钩子参数修复:修正
handle钩子(type, archive, select)参数解析,避免模板页异常 - Action / 权限:使用
Widget\User::alloc()等方式兼容 1.3 用户权限校验 - 适配器增强:完善
PluginInterface、ActionInterface、Utils\Helper等别名映射 - API 初始化:统计接口优先走
Widget\Init,兼容 1.2 / 1.3 启动流程
- 禁用时删除数据表开关:设置页新增关闭/开启开关,默认关闭(保留数据);开启后禁用插件会删除
visitor_log - 宽屏布局优化:访客日志 / 趋势分析页主要区块统一全宽,并放宽网格最小列宽,改善高缩放下观感
- 自动补齐数据库索引:
idx_time、idx_time_country、idx_ip、idx_time_ip,已有站点打开统计页即可自动创建(无需重装) - 统计 API 减负:去掉多余全表 COUNT;路由聚合避免
SUBSTRING_INDEX破坏索引利用 - 趋势 API 加速:用时间范围条件替代
DATE(time)=;会话数按天/小时一次分组计算,避免 N 次窗口查询 - 后台面板:国家/路由统计改为 SQL
GROUP BY,不再把全部日志载入 PHP - 缓存策略:查询跨度超过 30 天时缓存延长至 15 分钟
- 访客日志 AJAX 翻页:翻页只刷新左侧日志表,右侧三个图表不再跟着整页重载
- 线条宽度优化:将所有趋势线条宽度从4px减小到2px,符号大小从8px减小到6px
- 左轴刻度智能优化:重构Y轴刻度算法,左轴最大值设为刚好比数据最大值大的整数+1,消除过多空白区域
- 动态间隔计算:根据数据范围智能计算Y轴间隔(1、5、10、20、50、100),提升图表可读性
- 线条区分度提升:优化后的图表能更清晰地区分IP数、访客数(UV)、访问数(SV)三条线的变化趋势
- 视觉平衡改进:图表整体更加精致,避免了线条过粗带来的视觉负担
- 刻度算法重构:从复杂的分段判断简化为基于数据驱动的动态计算
- 显示精度提升:确保每条线的微小变化都能在图表上清晰体现
- 用户体验优化:解决了数据值较小时线条重合难以区分的问题
- 趋势分析页面说明:在趋势图表下方新增四项核心指标详细说明区域
- 指标概念解释:详细说明PV、独立IP数、独立访客数(UV)、访问次数的概念和统计方法
- 技术实现展示:展示各指标的SQL查询语句和数据获取方式,提升专业性
- 响应式设计:指标说明区域支持桌面端4列网格和移动端单列布局
- 界面美化优化:使用彩色图标和现代化卡片设计,增强视觉效果
- 精简文件结构:移除冗余的header.php、footer.php、menu.php文件
- 代码内嵌优化:将HTML头部和尾部代码直接集成到主要文件中
- 减少依赖关系:简化文件引用结构,提升代码可维护性
- 饼图显示优化:去除冗余标题,仅保留"路由访问统计"标题,界面更简洁
- 饼图尺寸优化:适当放大饼图显示区域(半径增加约25%),提升数据可视性和视觉效果
- 路由统计增强:路由显示数量从10个扩展到20个,提供更全面的访问分析
- 柱状图完整显示:解决路由访问统计图加载不完整问题,增加底部空间并优化标签显示
- 渐变视觉效果:为柱状图添加蓝色渐变背景和红色悬停效果,提升交互体验
- 标签显示优化:调整饼图标签显示逻辑,适应放大后的图表尺寸
- 图例布局调整:优化图例位置和间距,适配更大的饼图显示
- 移动端适配:改进小屏设备上的图表布局和显示效果
- 智能SQL回退机制:实现SQL窗口函数的智能回退,兼容MySQL 5.5+到8.0+所有版本
- 数据库自动升级:自动检测并添加user_agent字段,无需手动操作数据库
- 错误处理优化:完善API响应错误信息,便于问题排查和调试
- 查询性能提升:优化单日和多日数据查询算法,支持按小时和按天双维度统计
- 内存使用优化:重构数据库查询逻辑,减少内存占用
- 加载速度提升:改进前端默认加载逻辑,提升用户体验
- 四条曲线同时展示:支持PV、独立IP、独立访客(UV)、访问次数四项指标同屏对比
- 智能图例设计:优化颜色方案和图例布局,提升可读性
- 交互体验优化:改进悬停提示和图表动画效果
- 移动端适配:优化小屏设备上的图表显示和统计摘要布局
- 统计摘要卡片:新增四项核心指标的数值展示区域
- 响应式布局:完善移动端统计项目的排列和显示
- 配色方案优化:采用专业的数据可视化配色,提升视觉效果
- 多指标数据计算:重构getTrendData.php,支持四项指标的并行计算
- 智能会话算法:实现基于IP和时间间隔(30分钟)的会话识别算法
- 数据聚合优化:优化大数据量场景下的查询性能和响应速度
- 错误容错机制:增强API稳定性,提供详细的错误信息反馈
- UV计算逻辑:基于IP+User-Agent组合的独立访客识别算法
- 会话识别机制:30分钟超时的智能会话计算,支持跨日统计
- 时间维度处理:单日按小时统计,多日按天统计的自适应算法
- 新增user_agent字段:扩展visitor_log表结构,支持更精准的访客识别
- 自动结构升级:插件启用时自动检测并升级数据库表结构
- 数据完整性保障:确保现有数据完整性,新字段向后兼容
- 四项核心指标:全新引入PV(页面浏览量)、独立访客数(UV)、访问次数(会话数)
- 精准统计算法:结合IP地址和User-Agent的独立访客识别机制
- 数据记录增强:开始记录User-Agent信息,提升统计准确性
- 趋势分析页面:全新的访客趋势分析功能,支持PV、独立IP、独立访客(UV)、访问次数四项指标的多曲线图表
- 智能时间范围:新增昨日、本周、上周、本月、上月快捷选择
- 动态时间轴:选择单日时自动切换为小时段显示(0:00-23:00)
- 数据统计显示:在图表中显示选定时间范围内的PV、独立IP数、独立访客数(UV)、访问次数四项核心指标
- 自适应全部时间:全部时间范围自动从第一条访客记录开始计算
- 优化API数据获取逻辑,提升趋势分析页面加载速度
- 改进图表交互体验,支持悬停显示详细数据
- 完善错误处理机制,提供更好的用户反馈
- 智能资源加载机制:实现ECharts和Flatpickr的CDN优先加载,失败时自动回退到本地文件
- 提升加载稳定性:解决网络环境不稳定时图表库加载失败的问题
- 优化用户体验:无需手动选择加载方式,系统自动选择最佳加载策略
- 增强容错能力:多重加载保障,确保图表功能正常运行
- 重构资源加载逻辑,采用Promise-based异步加载
- 添加详细的加载状态日志,便于问题排查
- 优化错误处理机制,提供友好的用户提示
- 移除本地chart.js文件(约200KB),减少插件体积
- 全部使用CDN加载ECharts图表库
- 删除panel.php中对本地chart.js的引用
- 新增API端点(getVisitStatistic.php)处理数据聚合
- 解决大数据量加载问题,提高页面响应速度(从10s优化到2s)
- 添加日期范围选择器和快捷按钮(今天、最近7天、最近30天、全部)
- 实现按钮选中状态高亮显示
- 优化首次加载速度,默认加载今天数据
- 增高环形图展示区域,改善视觉效果
- 修复图表悬停效果
- 添加删除特定IP记录功能(支持模糊匹配)
- 重构图表加载逻辑,使用异步API获取数据
- 添加省份访问统计图表
- 优化后台路由统计,解决X轴信息重叠问题
- 优化日期选择功能
- 修复内容解码错误(ERR_CONTENT_DECODING_FAILED)
- 修复SQL错误(Unknown column 'province')
- 新增后台忽略IP名单功能,支持批量添加和删除
- 前台删除管理员(自己)访问记录功能,保持统计数据纯净
- 优化CDN环境下IP识别机制,解决IP不准确问题
- 添加IP地址过滤器,支持自定义过滤规则
- 修复PHP 8.0环境下的弃用函数警告
- 修复在某些主题下的样式冲突问题
- 修复日期选择器在移动端的显示问题
- 优化数据库查询,减少资源占用
- 修复时区问题:将数据库time字段从TIMESTAMP改为DATETIME类型
- 添加服务器时区自动转换功能,确保访客时间记录准确
- 优化数据迁移处理,自动转换已有记录的时区
- 添加适配器(adapter.php),实现原版插件与当前插件的无缝衔接
- 初始版本发布
- 实现基本访客统计功能
- 国家/地区访问统计
- IP分布统计(已匿名化处理)
- ECharts环形图表展示方式
- 列表视图支持
- 移动端适配
- IP地址匿名化处理(只显示前两段)
- 明确的隐私声明
- 符合相关法律法规要求
- 优化移动端显示
- 管理员访问自动排除
