懂懂

# IP_Pro - 评论区IP显示

一个轻量级WordPress评论区IP地址显示插件，用于评论区显示评论者的IP地理位置. 支持自定义显示位置、图标和颜色样式。

## 功能

- 展示评论者地理位置。国内精确到市级，国外精确到国家
- 使用ipip.net官方SDK Reader类解析IP地址
- 支持IPv4和IPv6地址解析（需相应数据库支持）
- 自定义显示格式、位置级别和样式
- 支持评论下方或评论时间后显示位置信息
- 支持自定义图标和颜色
- 自动适配大部分WordPress主题，无需修改主题文件

## 安装

1. 下载插件并解压
2. 将插件文件夹上传到 `/wp-content/plugins/` 目录
3. 在 WordPress 管理后台激活插件
4. 插件内置IP数据库，无需额外下载
5. 在设置页面自定义显示方式

## 使用方法

插件激活后会自动在评论下方显示评论者的IP地址所在地理位置。

### 自定义设置

通过 WordPress 管理后台的 "设置 > IP Pro" 页面可以进行以下设置：
- **显示级别**：选择显示位置的精确度
- 国家级（如：中国）
- 省级（如：广东省）
- 市级（如：广州市）
- **显示位置**：选择IP位置信息的显示位置
- 评论内容下方
- 评论时间后
- **位置前缀**：自定义显示在位置信息前的文本，例如"IP属地："
- **文本颜色**：设置位置信息的文本颜色
- **启用图标**：选择是否在位置信息前显示图标
- **图标类型**：选择使用默认图标或自定义图标
- **图标颜色**：设置图标的颜色
- **自定义图标**：如选择自定义图标，可在此处输入SVG图标代码

## 主题兼容性

插件采用多种技术确保与绝大多数WordPress主题兼容：
1. **自动检测**：通过钩入WordPress评论系统的多个钩子点，自动识别并适配不同主题
2. **缓冲处理**：使用输出缓冲技术处理评论输出，确保位置信息正确显示
3. **特定主题适配**：针对常见主题框架添加特定支持

如果您的主题未能自动显示位置信息，可尝试以下方法：

### 手动添加位置显示代码

在您的主题评论模板中找到显示评论时间的位置（通常包含`<time>`标签），在其后添加：

<!--?php if (function_exists('ip_pro_show_location')) { ip_pro_show_location(); } ?-->

或者使用短代码：

<!--?php echo do_shortcode('[ip_pro_location]'); ?-->

## 自定义数据库

如需更新IP数据库，只需替换插件目录下 `data/ipipfree.ipdb` 文件即可。
可从ipip.net官网下载最新的免费版数据库：https://www.ipip.net/product/ip.html（需注册）

## 版本历史

###1.0.6

- 增加自定义图标支持（默认/自定义SVG）
- 增加文本和图标颜色选项
- 添加多种主题兼容方式
- 优化位置信息显示效果
- 添加响应式样式支持

###1.0.5

- 优化IP位置自定义显示多样化（国家级/省级/市级）
- 移除IP样式信息自定义，优化IP显示自定义文本
- 增加后台切换显示位置（评论区下方/评论时间后）

### 1.0.0

- 初始版本发布
- 使用ipip.net官方SDK解析IP地址
- 支持显示评论者地理位置

## 常见问题

### 为什么有些 IP 显示的位置不准确？

IP 地址的地理位置数据主要依赖于 ipip.net 的免费数据库，其准确性有一定限制。对于国内 IP 地址，通常能精确到市级；国外 IP 地址则通常只能精确到国家。

### 插件是否会影响网站性能？

本插件设计轻量，仅在显示评论时进行 IP 解析，使用本地数据库而非在线 API，对网站性能影响极小。

### 如果位置信息未在评论时间后正确显示怎么办？

某些主题使用非标准的评论结构，可能导致自动适配失效。您可以：
1. 尝试切换到"评论内容下方"显示模式
2. 按照"主题兼容性"部分的说明手动添加显示代码
3. 联系插件作者提供主题结构信息，以便添加专门支持

## 技术说明

此插件使用ipip.net官方提供的Reader类解析IP地址数据库，支持最新格式的.ipdb文件，提供较好的兼容性和准确性。插件采用多种钩子和JavaScript方法实现主题兼容。

## 许可证

本插件遵循 GPL v2 或更高版本许可证。

## 作者

插件作者：Chenming

联系方式：[QQ 2545399540]