这是一个为 Typecho 博客系统开发的访客统计插件,基于VistorLoggerPro进行修改增强。 除了原有功能外,额外增加了插件个性化功能,满足我自己的使用需求。
新增功能有:
- 添加插件界面背景图,并可自定义 默认图片来源是我的猫娘乐园图片API,可以自行更换
- 数据面板透明化,可以自己调节颜色 默认是白色半透明卡片,可以根据需要调节颜色
修复的问题有:
- 修复了原版插件静态文件缺失和相对路径错误的问题,补充了对应的本地静态文件。
- 修复了当cdn分发JS等待时间过长却不切换本地文件的问题。设置了等待cdn分发静态文件超时时间为2秒,超时后自动获取本地文件。
当前版本已完成数据库、统计接口与 Typecho 1.3 后台兼容性重构,支持 MySQL 和 SQLite。
插件目录必须保持为 VisitorLoggerPro。
- 将“国家=中国、省份=中国”的不完整定位视为省份缺失,不再把“中国”计入国内省份统计
- 数据库构建、访问记录规范化和省份查询均排除这一无效组合
- 新增精简 IP 信息数据库,只保留国家、省份、城市、运营商四项
- 纯真数据库已转换为预先结构化的只读库,不再在访问请求中猜拆地址或强制添加“省”后缀
- IPv4 数据库可选择 ip2region、精简 IP 信息库或整理后的纯真库
- 访客日志新增
isp字段,地点统一按“国家 省份 城市 运营商”显示,空值自动省略
- 兼容 Typecho 1.2.1 与 1.3.0 的后台布局和数据库查询构造器
- 访客日志与趋势分析合并为一个控制台菜单入口
- 支持 SQLite,并修复国家、省份、城市统计查询
- 可配置 ECharts 使用公共 CDN(失败回落本地)或直接使用本地资源
- 支持按保留天数自动清理历史访问数据,默认 90 天且可关闭
- 支持 SQLite 部署,并保留 MySQL 兼容性
- 国家、省份、城市独立存储,自动迁移旧格式地点数据
- 统计接口改为 Typecho Action,修复越权、SQL 注入、XSS 与 CSRF 风险
- 新增查询索引、定位缓存和单查询会话计算
- 自动清理超过指定天数的数据,默认保留 90 天,也可关闭
- 修复 Typecho 1.3 后台菜单、资源路径和移动端布局
以下为原版VistorLoggerPro的README:
该插件提供了详细的访问统计功能,包括访问国家/地区统计、IP分布等信息,并进行了隐私保护处理。
- 四项核心指标:PV(页面浏览量)、独立IP数、独立访客数(UV)、访问次数(会话数)
- 智能会话识别:基于IP和时间间隔的会话计算(30分钟超时)
- 精准访客统计:结合IP和User-Agent的独立访客识别
- 访问国家/地区统计(Top 30)
- IP分布统计(已匿名化处理)
- 省份访问统计图表
- 路由访问统计分析(页面访问量统计)
- 访问时间统计(按日期分布)
- 管理员访问自动排除
- 日期范围选择器
- 快捷时间选择(今天、昨日、最近7天、本周、上周、本月、上月、最近30天、全部)
- 按钮选中状态高亮显示
- 默认只加载近7天数据,优化首次加载速度
- 四条曲线同时展示:支持PV、独立IP、独立访客(UV)、访问次数四项指标同屏对比
- 趋势分析页面:全新的访客趋势分析功能,支持多维度数据分析
- 动态时间轴:选择单日时自动切换为小时段显示(0:00-23:00)
- 智能图例设计:优化颜色方案和图例布局,提升可读性
- ECharts环形图表展示方式
- 列表视图支持(详细数据展示)
- 图表悬停效果(显示详细信息)
- 自适应图表区域
- 删除特定IP记录功能(支持模糊匹配)
- 数据库自动优化
- 时区自动转换功能,确保访客时间记录准确
- 历史数据自动清理(默认保留90天,可关闭)
- 异步API数据加载(getVisitStatistic.php和getTrendData.php)
- 解决大数据量加载问题,提高页面响应速度(从10s优化到2s)
- 智能资源加载机制:ECharts可选择CDN优先并回退本地,或直接加载本地文件;Flatpickr在CDN失败时回退本地
- 智能SQL回退机制:兼容MySQL 5.5+到8.0+所有版本,自动检测数据库版本
- 可按部署环境选择公共CDN或插件内置的ECharts图表库
- 优化移动端显示
- IP地址匿名化处理(只显示前两段)
- 明确的隐私声明
- 符合相关法律法规要求
- 数据安全存储
- 统计摘要卡片:新增四项核心指标的数值展示区域
- 指标说明区域:详细说明PV、独立IP数、独立访客数(UV)、访问次数的概念和统计方法
- 响应式设计:指标说明区域支持桌面端4列网格和移动端单列布局
- 饼图尺寸优化:适当放大饼图显示区域,提升数据可视性和视觉效果
- 渐变视觉效果:为柱状图添加蓝色渐变背景和红色悬停效果
- 移动端自适应布局
- 美观的图表展示
- 增高环形图展示区域,改善视觉效果
- 列表/图表切换视图
- 优雅的加载动画
- 下载插件文件
- 在本地解压后把目录名改为VisitorLoggerPro
- 将改后的文件上传到/usr/plugins目录下
- 插件名为VisitorLoggerPro
- 在 Typecho 后台启用插件
- 如需使用主题前台统计模板,可按主题说明集成
visitor-stats.php
- 在 Typecho 后台创建新页面
- 在页面模板中选择"访客统计"
- 发布页面即可看到统计效果
- 创建新页面,选择"访客统计"模板
插件启用失败解决办法: 有一部分小伙伴之前使用过VisitorLogger插件,然后如果直接启用VisitorLoggerPro的话会报错
- 1.只需要把VisitorLogger相关文件全部删除即可,也就是两者不能共存。
- 2.数据库表不需要修改,但也可以把bot_list表删掉因为用不到。
本插件已实现以下隐私保护措施:
- IP地址匿名化处理(只显示前两段)
- 明确的隐私声明
- 符合相关法律法规要求
- 前端:ECharts 图表库,支持四条曲线同时展示
- 后端:PHP + Typecho 数据库抽象层,支持 MySQL 与 SQLite
- 数据存储:Typecho 数据库,扩展user_agent字段
- 数据处理:通过API异步加载,支持PV、UV、IP、会话四项指标
- 会话算法:基于时间间隔的智能会话识别(30分钟超时)
- 兼容性:支持 Typecho 1.2 与 1.3 的新旧类名和后台资源路径
- 作者:BXCQ
- 博客:https://blog.ybyq.wang/
- GitHub:https://github.com/BXCQ
MIT License
- 线条宽度优化:将所有趋势线条宽度从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地址匿名化处理(只显示前两段)
- 明确的隐私声明
- 符合相关法律法规要求
- 优化移动端显示
- 管理员访问自动排除


