# 安装指南

## 前置要求

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 错误日志
- 后端服务日志