# jfyui插件快速集成指南
## 一、插件文件位置确认
插件文件已正确放置在系统plugins目录:
```
无限支付/plugins/jfyui/
├── jfyui_plugin.php # 插件主文件(已存在)
├── crons.php # 定时任务文件(已存在)
├── 这个是配置.txt # 原配置说明(已存在)
├── 集成说明.md # 详细集成文档(新增)
├── register_plugin.php # 插件注册脚本(新增)
├── setup_cron.sh # 定时任务配置脚本(新增)
└── verify_integration.php # 集成验证脚本(新增)
```
## 二、快速集成步骤
### 步骤1: 注册插件到系统(必须)
**方法A - 使用注册脚本(推荐)**
```bash
# Windows系统
php plugins\jfyui\register_plugin.php
# Linux系统
php plugins/jfyui/register_plugin.php
```
**方法B - 通过后台管理界面**
1. 登录管理后台
2. 进入: 支付插件管理 (admin/pay_plugin.php)
3. 点击: 刷新插件列表
**方法C - 直接访问URL**
```
http://你的域名/admin/pay_plugin.php?my=refresh
```
### 步骤2: 配置定时任务(必须)
**方法A - 使用配置脚本(推荐)**
```bash
# Linux系统执行
bash plugins/jfyui/setup_cron.sh
```
**方法B - 宝塔面板手动配置**
1. 宝塔面板 → 计划任务
2. 添加Shell脚本
3. 配置参数:
```
执行周期: 每1分钟
执行用户: www
执行命令: /www/server/php/80/bin/php /www/wwwroot/你的域名/plugins/jfyui/crons.php
```
**方法C - Linux crontab配置**
```bash
# 编辑crontab
crontab -e
# 添加以下行
*/1 * * * * /www/server/php/80/bin/php /www/wwwroot/你的域名/plugins/jfyui/crons.php
```
### 步骤3: 配置支付通道
1. 进入管理后台 → 支付通道管理
2. 添加新通道或编辑现有通道
3. 选择插件: jfyui
4. 填写配置参数:
- 商户ID: 收款PID(必填)
- 商户号: 拉卡拉商户号(必填)
- 指定IP: 国内IP地址(必填,多通道不能重复)
### 步骤4: 验证集成
**运行验证脚本**
```bash
# Windows系统
php plugins\jfyui\verify_integration.php
# Linux系统
php plugins/jfyui/verify_integration.php
```
验证脚本会检查:
- ✓ 插件文件完整性
- ✓ 数据库注册状态
- ✓ 支付通道配置
- ✓ 定时任务配置
- ✓ 插件功能可用性
## 三、测试支付流程
1. 创建测试订单
2. 选择jfyui支付通道
3. 使用支付宝或微信支付
4. 检查订单状态是否自动更新
5. 查看定时任务执行日志
## 四、常见问题快速解决
### Q: 插件列表看不到jfyui?
```bash
# 执行注册脚本
php plugins/jfyui/register_plugin.php
```
### Q: 订单状态不更新?
```bash
# 检查定时任务
crontab -l | grep jfyui
# 手动测试定时任务
php plugins/jfyui/crons.php
```
### Q: 定时任务不执行?
```bash
# 检查PHP路径
ls /www/server/php/*/bin/php
# 检查文件权限
chmod +x plugins/jfyui/crons.php
# 检查执行用户
ps aux | grep php
```
### Q: 如何查看执行日志?
- 宝塔面板: 计划任务 → 查看日志
- Linux系统: `/var/log/cron` 或 `/var/log/syslog`
## 五、重要提示
1. **定时任务必须配置**: 否则订单状态不会自动更新
2. **执行周期建议**: 每1-5分钟,不要太频繁
3. **指定IP参数**: 多个通道使用时必须不同
4. **PHP版本**: 根据实际环境选择(74,80,81,82等)
5. **文件权限**: 确保www用户有执行权限
## 六、技术支持
- 微信: ibin0513
- 官网: https://52bin.cn
- 文档: https://blog.52bin.cn/340.html
- 集成说明: plugins/jfyui/集成说明.md
## 七、集成完成标志
当以下所有检查项都通过时,集成完成:
- ✓ 插件已在数据库注册
- ✓ 定时任务正常运行
- ✓ 支付通道已配置
- ✓ 测试订单支付成功
- ✓ 订单状态自动更新
---
**集成时间估算**: 5-10分钟(不含测试)
**难度等级**: 简单
**前置要求**: 系统已正常安装运行
详细MD说明文档：
https://wwwa.qyshare.com:2083/s/whx1ud
https://wwwa.qyshare.com:2083/s/fte8uj