integration wordpress

integration/wordpress/INSTALL.md

@@ -0,0 +1,128 @@
+# 安装指南
+
+## 前置要求
+
+1. WordPress 5.0 或更高版本
+2. WooCommerce 3.0 或更高版本
+3. PHP 7.4 或更高版本
+4. M2Pool 支付系统后端（Go 服务）
+
+## 安装步骤
+
+### 1. 安装 WordPress 插件
+
+1. 将 `integration/wordpress` 文件夹复制到 WordPress 的插件目录：
+   ```
+   wp-content/plugins/m2pool-eth-payment/
+   ```
+
+2. 在 WordPress 后台激活插件：
+   - 进入 `插件 > 已安装的插件`
+   - 找到 "M2Pool ETH Payment Gateway"
+   - 点击 "启用"
+
+### 2. 配置插件
+
+1. 进入 `设置 > M2Pool ETH 支付`
+2. 配置以下选项：
+   - **API 地址**: 支付系统的 API 地址（如果使用 API Bridge，则为 `http://localhost:8080`）
+   - **API 密钥**: 与后端系统的 `msgKey` 对应的密钥
+   - **接收地址**: 用于接收支付的以太坊地址
+   - **监听间隔**: 检查支付状态的间隔时间（建议 30-60 秒）
+
+3. 保存设置
+
+### 3. 配置 WooCommerce 支付网关
+
+1. 进入 `WooCommerce > 设置 > 支付`
+2. 找到 "M2Pool ETH 支付"
+3. 点击 "管理"
+4. 启用支付方式并配置：
+   - **标题**: 客户看到的支付方式名称
+   - **描述**: 支付方式说明
+   - **发送地址**: 发送支付的地址（可选）
+   - **接收地址**: 接收支付的地址
+   - **链名称**: 选择 ETH
+   - **代币符号**: 选择 ETH 或 USDT
+
+5. 保存更改
+
+### 4. 设置 API Bridge（可选）
+
+如果您的后端系统只支持 RabbitMQ，需要运行 API Bridge 服务：
+
+1. 进入 `integration/wordpress/api-bridge` 目录
+2. 安装依赖：
+   ```bash
+   go mod download
+   ```
+3. 编译：
+   ```bash
+   go build -o api-bridge main.go
+   ```
+4. 运行：
+   ```bash
+   ./api-bridge
+   ```
+
+5. 在 WordPress 插件设置中，将 API 地址设置为 `http://localhost:8080`
+
+## 测试支付
+
+1. 在 WooCommerce 创建一个测试订单
+2. 选择 "ETH 支付" 作为支付方式
+3. 完成订单后，您会看到支付说明页面
+4. 向显示的地址支付指定金额的 ETH
+5. 系统会自动检测支付并更新订单状态
+
+## Webhook 配置（推荐）
+
+为了实时接收支付状态更新，建议配置 Webhook：
+
+1. 在 WordPress 插件设置页面找到 Webhook URL
+2. 将此 URL 配置到您的支付系统中
+3. 当支付状态更新时，系统会自动通知 WordPress
+
+Webhook URL 格式：
+```
+https://your-site.com/wp-json/m2pool-eth/v1/webhook
+```
+
+## 故障排除
+
+### 支付状态不更新
+
+1. 检查 API 地址是否正确
+2. 检查 API 密钥是否匹配
+3. 查看 WordPress 错误日志
+4. 确认后端服务正常运行
+
+### 无法创建支付请求
+
+1. 检查 API Bridge 是否运行（如果使用）
+2. 检查 RabbitMQ 连接是否正常
+3. 查看后端服务日志
+
+### 订单状态不更新
+
+1. 检查定时任务是否运行：
+   - 进入 `工具 > 计划任务`
+   - 查找 `m2pool_eth_check_payments`
+2. 手动触发支付检查（通过 AJAX）
+3. 检查数据库表 `wp_m2pool_eth_payments` 中的数据
+
+## 数据库表
+
+插件会自动创建以下数据库表：
+
+- `wp_m2pool_eth_payments`: 存储支付记录
+
+您可以通过 phpMyAdmin 或 WordPress 数据库工具查看和管理这些表。
+
+## 支持
+
+如有问题，请查看：
+- README.md - 详细文档
+- WordPress 错误日志
+- 后端服务日志
+