VOID 插件

配合 VOID 主题 使用

使用方法：下载本插件后，部署到 Typecho 插件目录时请将文件夹名称改为 VOID，然后在后台启用。

功能概览

• 文章点赞、评论赞踩，以及后台互动记录查看
• 文章浏览量统计，可供主题前台直接读取显示
• 文章与页面字数统计，并支持在前台模板中调用
• 后台评论列表显示评论 IP 与归属地
• 图片尺寸解析与历史 #vwid / #vhei 标记兼容
• 插件设置中可调整“单次图片处理数量上限”
• 1.4 新增：后台编辑器实时统计面板，可在写文章或页面时实时显示字数、图片数、标签数
• 1.4 升级：评论 IP 定位已切换为 ip2region xdb，支持 IPv4 与 IPv6
• 1.4 升级：UA 识别范围更完整，后台互动页可更准确显示访客浏览器与系统信息

关于 IP 数据库的更新

VOID 当前已换用 ip2region 提供的 .xdb 数据库文件，插件不内置数据库检查或一键更新能力。若本插件不再更新，后续数据库维护需手动。

当前仓库内置数据库对应 ip2region v3.14.0，数据库文件可从 ip2region 官方仓库的 Release 页面，或仓库 data/ 目录中获取

更新步骤：

1. 下载最新的 ip2region_v4.xdb 与 ip2region_v6.xdb
2. 分别替换插件目录中的 libs/data/ip2region/data/ip2region_v4.xdb 与 libs/data/ip2region/data/ip2region_v6.xdb
3. 保持文件名不变，并确保 IPv4 与 IPv6 文件成对更新
4. 替换完成后，建议在后台停用并重新启用插件一次，以触发启用阶段的数据库校验

注意事项：

• 若数据库文件缺失、损坏，或 IPv4 / IPv6 文件类型不匹配，插件会在启用时给出明确错误
• 如果插件被重新安装，或被新版插件包直接覆盖，上述内置数据库文件也可能被一并覆盖，需要重新手动替换

关于图片尺寸解析

• 插件会在内容发布后尝试为文章中的图片补充尺寸信息，以便主题前端更稳定地预留图片占位
• 历史文章中已经写入的 #vwid / #vhei 标记会继续保留并生效
• 插件设置中的“单次图片处理数量上限”用于控制单次处理的图片数量，默认值为 10
• 不建议将该值设置得过大，因为图片尺寸获取仍受外部图床响应速度影响，数值过高可能导致请求超时

兼容性说明

• 当前源码同时保留了对 Typecho 1.2 与 1.3 的兼容处理
• 插件目前仅支持 MySQL 数据库
• 运行插件前，请确保 PHP 已启用 OpenSSL 与 DOM 扩展