Chatbot MCP Wordpress Plugin

===超级帽子=== 贡献者：supachat 标签：聊天机器人，人工智能，客户支持，自动化，聊天 至少需要：5.6 测试高达：6.8 需要PHP:7.4 稳定标签：1.0.0 许可证：GPLv2或更高版本 许可证URI:https://www.gnu.org/licenses/gpl-2.0.html

自动将您的网站与SupaChat AI聊天机器人集成，以增强客户支持。

==描述==

一个自动将您的网站与SupaChat AI聊天机器人集成的插件。此插件提供无缝集成，以增强客户支持和自动化协助。

==功能==

• 🔐 API自动化集成：自动生成并管理具有适当权限的API连接
• 🤖 SupaChat集成：无缝登录并与您的SupaChat帐户集成
• 🔧 MCP服务器管理：在聊天机器人服务中自动创建和管理MCP服务器
• 📊 实时状态监控：监控集成和服务的运行状况
• 🛡️ 安全第一：API密钥的安全存储和正确的身份验证处理
• 📱 响应式管理界面：现代、用户友好的管理界面，适用于所有设备
• 📝 综合录井：故障排除和监控的详细日志

==要求==

• WordPress 6.8或更高版本
• PHP 7.4或更高版本
• SupaChat帐户
• 访问SupaChat用户和聊天机器人服务

==安装==

1. 下载插件

   cd /path/to/wordpress/wp-content/plugins/
   git clone  supa-chat-woocommerce

1. 激活插件

- 转到WordPress管理员→ 插件 - 查找“SupaChat” - 点击“激活”

1. 配置服务 （如果需要）

- 该插件使用默认服务URL进行开发 - 对于生产，更新插件设置中的服务URL

==用法==

初始设置

1. 访问插件

- 转到WordPress管理员→ SupaChat - 您将看到SupaChat仪表板

1. 登录SupaChat

- 输入您的SupaChat帐户凭据 - 该插件将验证与SupaChat服务的连接 - 成功登录后，您将被重定向到仪表板

1. 创建集成

- 点击“新建集成”按钮 - 选择要与您的商店集成的聊天机器人 - 为集成提供描述性名称 - 点击“创建集成”

自动发生的事情

当您创建集成时，插件会自动：

1. 生成WooCommerce API密钥

- 创建新的REST API密钥对（使用者密钥/机密） - 为产品访问设置适当的读取权限 - 安全地存放钥匙

1. 创建MCP服务器

- 调用您的聊天机器人服务API - 创建新的WordPress MCP服务器条目 - 使用商店的URL和API凭据对其进行配置 - 验证连接和可用工具

1. 存储集成数据

- 保存集成元数据以供将来管理 - 链接聊天机器人、API密钥和MCP服务器

管理集成

• 查看集成：在仪表板上查看您所有的活动集成
• 测试集成：验证MCP服务器是否正常工作
• 刷新集成：重新验证和更新MCP服务器配置
• 删除集成：删除集成（清除API密钥和MCP服务器）

管理界面

仪表板选项卡

1. 集成选项卡

- 查看和管理所有聊天机器人集成 - 创建新的集成 - 监控集成状态和运行状况

1. 设置标签

- 配置服务URL - 设置自动清理首选项 - 访问危险操作（重置、清理）

1. 日志选项卡

- 查看集成日志 - 按日志级别和日期筛选 - 需要时清除日志

状态监测

该插件为以下内容提供实时状态监控：

• 服务连接：用户服务和聊天机器人服务可用性
• WooCommerce状态：插件激活和API启用
• 环境卫生：SSL状态、WordPress版本等。
• 集成状态：个体整合健康和验证

配置

服务URL

默认情况下，插件使用以下服务URL：

• 用户服务: http://localhost:9091/api/v1
• 聊天机器人服务: http://localhost:9092/api/v1

对于生产环境，请在“设置”选项卡中更新这些设置，或在您的 wp-config.php:

define('SCWC_USER_SERVICE_URL', 'https://your-user-service.com/api/v1');
define('SCWC_CHATBOT_SERVICE_URL', 'https://your-chatbot-service.com/api/v1');

自动清理

该插件包括一个自动清理功能，该功能：

• 删除集成时删除API键
• 删除集成时清理MCP服务器
• 可以在“设置”选项卡中禁用

API终点

该插件与这些SupaChat服务端点集成：

用户服务(/api/v1)

• POST /login -对用户进行身份验证
• GET /users/{id} -获取用户详细信息
• GET /status -服务健康检查

聊天机器人服务(/api/v1)

• GET /chatbots -列出用户的聊天机器人
• POST /chatbots/{id}/wordpress-mcp-servers -创建WordPress MCP服务器
• DELETE /mcp-servers/{id} -删除MCP服务器
• POST /mcp-servers/{id}/refresh -刷新MCP服务器
• GET /status -服务健康检查

安全

数据保护

• API密钥安全存储在WordPress选项中
• 用户令牌按照WordPress最佳实践进行处理
• 所有AJAX请求都包含随机数验证
• 检查所有管理员操作的用户能力

访问控制

• 仅限具有以下条件的用户 manage_options 功能可以访问插件
• API通信使用正确的身份验证头
• 敏感数据从未被记录或公开

最佳实践

• 在生产环境中使用HTTPS
• 如果需要，定期旋转API键
• 监控集成日志中的异常活动
• 保持插件更新

故障排除

常见问题

1. 服务连接错误

- 检查SupaChat服务是否正在运行且可访问 - 验证设置中的服务URL - 检查防火墙和网络连接

1. WooCommerce API问题

- 确保WooCommerce已安装并激活 - 验证WooCommerce REST API是否已启用 - 检查WordPress永久链接是否已配置

1. 身份验证失败

- 验证SupaChat帐户凭据 - 检查用户服务连接 - 清除浏览器缓存，然后重试

1. 集成创建失败

- 检查聊天机器人服务连接 - 验证您的SupaChat帐户中是否有聊天机器人 - 查看集成日志中的特定错误

调试模式

启用WordPress调试模式以查看详细的错误信息：

// In wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

查看WordPress调试日志 /wp-content/debug.log 对于插件特定的错误。

日志文件

该插件记录重要事件和错误。通过以下方式访问日志：

• WordPress管理员→ SupaChat→ 日志选项卡
• WordPress调试日志（如果启用了WP_debug）
• 服务器错误日志

发展

文件结构

supa-chat-woocommerce/
├── supa-chat-woocommerce.php    # Main plugin file
├── includes/                     # PHP classes
│   ├── class-admin.php          # Admin interface
│   ├── class-api-manager.php    # API communication
│   ├── class-mcp-manager.php    # MCP server management
│   └── class-woocommerce-api.php # WooCommerce API handling
├── assets/                      # Frontend assets
│   ├── css/
│   │   └── admin.css           # Admin styles
│   └── js/
│       └── admin.js            # Admin JavaScript
└── README.md                   # This file

扩展插件

该插件的设计考虑了可扩展性：

1. 挂钩和过滤器：标准WordPress挂钩可用
2. 阶级结构：面向对象设计，易于扩展
3. API摘要：服务通信被抽象化，便于修改

贡献

1. 复刻仓库
2. 创建要素分支
3. 进行更改
4. 彻底测试
5. 提交拉取请求

支持

有关支持和问题：

1. 检查上面的故障排除部分
2. 查看集成日志
3. 联系SupaChat支持人员，提供日志详细信息
4. 在项目存储库中创建问题

许可证

此插件根据GPL v2或更高版本获得许可。

更新日志

版本1.0.0

• 初始版本
• 自动生成WooCommerce API密钥
• SupaChat服务集成
• WordPress MCP服务器管理
• 响应式管理界面
• 全面的日志记录和监控

______________________________________________________________________

由...制作❤️ 为SupaChat社区