WordPress微信自动回复插件（Composer原生版）使用说明

发布时间：2026/04/15阅读：15点赞：0评论：0
wordpress公众号，插件

微信自动回复插件（Composer原生版）使用说明

本文档用于指导用户安装、配置及使用「微信自动回复（Composer原生版）」插件，该插件基于WordPress开发，采用Composer自动加载规范（无第三方微信SDK，所有功能原生PHP实现），支持微信公众号文本消息关键词自动回复，包含后台配置、关键词管理等核心功能，操作简单、安全无残留。

一、插件简介

「微信自动回复（Composer原生版）」是一款专为WordPress设计的轻量微信公众号辅助插件，核心特点如下：

  • Composer规范：采用PSR-4自动加载，代码结构清晰，可扩展、可维护，相当于自建轻量开发框架。
  • 原生无依赖：不引用任何第三方微信SDK，所有微信相关功能（签名验证、消息加解密、自动回复）均由原生PHP实现，避免冗余依赖。
  • 核心功能：微信公众号基础配置、关键词回复管理（增删改查）、微信消息接收与自动回复，支持明文/兼容/安全三种消息模式。
  • 安全无残留：卸载插件时自动清理数据表及配置项，不占用服务器冗余空间。
  • 直观界面：WordPress后台新增「微信」菜单，含基础配置、关键词回复两个子页面，操作便捷。

二、前置准备

使用插件前，请确保满足以下条件，避免配置失败：

  1. 环境要求：WordPress 5.0及以上版本，PHP 7.2及以上版本，服务器支持Composer（用于自动加载）。
  2. 微信公众号：拥有一个微信公众号（服务号/订阅号均可），获取公众号的「AppID」「Token」「EncodingAESKey」（用于对接插件）。
  3. 服务器权限：拥有服务器文件上传权限、数据库操作权限（插件激活时需创建数据表）。

补充：微信公众号相关信息获取路径：登录微信公众平台 → 开发 → 基本配置 → 找到AppID、Token、EncodingAESKey（若未设置，需先设置Token和EncodingAESKey）。

三、插件安装

关注公众号【码进制的世界】，回复 "公众号插件" 即可获得下载链接。下载后即可安装。
图片

插件安装分为「手动安装」（推荐，适配Composer自动加载）和「常规安装」两种方式，任选一种即可。

3.1 手动安装（推荐）

  1. 下载插件包：将插件所有文件（wechat-auto-reply.php、composer.json、src文件夹）压缩为ZIP包，或直接上传文件夹至服务器。
  2. 上传插件：登录WordPress后台 → 插件 → 安装插件 → 上传插件 → 选择插件ZIP包，点击「现在安装」；或通过FTP工具，将插件文件夹（wechat-auto-reply）上传至WordPress的 wp-content/plugins/ 目录下。
  3. 安装Composer依赖：通过服务器终端，进入插件根目录（wp-content/plugins/wechat-auto-reply/），执行命令 composer install，等待依赖安装完成（仅生成vendor自动加载目录，无其他第三方依赖）。
  4. 启用插件：安装完成后，在WordPress后台「插件」列表中，找到「微信自动回复（Composer原生版）」，点击「启用」，插件自动激活并创建关键词数据表。

3.2 常规安装（无终端权限）

若服务器无终端权限，可提前在本地安装Composer依赖，再上传至服务器：

  1. 本地解压插件包，进入插件根目录，执行 composer install，生成vendor目录。
  2. 将插件所有文件（含vendor目录）压缩为ZIP包，上传至WordPress后台安装，或通过FTP上传至 wp-content/plugins/ 目录。
  3. 在WordPress后台启用插件即可。

安装验证

插件启用后，若WordPress后台左侧出现「微信」菜单（带绿色微信图标），且无报错提示，说明安装成功。

四、核心配置（必做）

插件启用后，需先完成微信基础配置，才能实现与微信公众号的对接，步骤如下：

4.1 插件后台配置

  1. 登录WordPress后台，点击左侧「微信」菜单，默认进入「基础配置」页面。
  2. 填写微信公众号相关信息（均从微信公众平台获取）：
    1. Token：与微信公众平台「基本配置」中设置的Token一致（自定义字符串，用于签名验证）。
    2. AppID：微信公众号的唯一标识，从公众平台「基本配置」中复制。
    3. EncodingAESKey：用于消息加解密，从公众平台「基本配置」中复制（若未设置，可跳过不填，默认使用明文模式）。
  3. 填写完成后，点击页面底部「保存更改」，配置立即生效。

4.2 微信公众号接口配置

插件配置完成后，需在微信公众平台配置接口，实现微信消息与插件的对接：

  1. 登录微信公众平台 → 开发 → 基本配置。
  2. 找到「接口配置信息」，点击「修改配置」，填写以下内容：
    1. URL：复制插件「基础配置」页面中提示的URL（格式：https://你的域名/?wechat_callback=1），确保该URL可正常访问（无防盗链、无拦截）。
    2. Token：与插件「基础配置」中填写的Token完全一致。
    3. 消息加解密方式：根据是否填写EncodingAESKey选择：
      • 未填写EncodingAESKey：选择「明文模式」。
      • 填写EncodingAESKey：选择「兼容模式」或「安全模式」（推荐兼容模式，兼容性更强）。
  3. 点击「提交」，微信公众平台会自动验证URL和Token，验证通过后，接口配置生效；若验证失败，请检查URL是否可访问、Token是否一致。

五、关键词回复管理

接口配置生效后，可在插件后台添加、编辑、删除关键词，实现用户发送关键词时自动回复指定内容。

5.1 添加关键词

  1. 登录WordPress后台 → 微信 → 关键词回复，进入关键词管理页面。
  2. 在「添加/编辑」区域，填写以下内容：
    1. 关键词：用户需要发送的触发词（如「你好」「帮助」），支持纯文本，不支持特殊符号。
    2. 回复内容：用户发送对应关键词后，微信公众号自动回复的内容（纯文本，可换行）。
  3. 填写完成后，点击「保存」，关键词立即生效。

5.2 编辑关键词

  1. 在关键词列表中，找到需要编辑的关键词，点击「编辑」按钮。
  2. 编辑区域会自动填充该关键词的现有内容，修改后点击「保存」，修改立即生效。

5.3 删除关键词

  1. 在关键词列表中，找到需要删除的关键词，点击「删除」按钮。
  2. 弹出确认提示框，点击「确定」，关键词立即删除（删除后不可恢复，请谨慎操作）。

注意事项

  • 关键词支持「精确匹配」：只有用户发送的内容与关键词完全一致时，才会触发自动回复。
  • 若多个关键词重复，仅触发第一个匹配的关键词回复。
  • 未匹配到任何关键词时，会自动回复默认内容：「你好！请输入关键词获取回复」。

六、功能测试

配置完成后，建议进行功能测试，确保自动回复正常工作：

  1. 关注你的微信公众号。
  2. 向公众号发送已添加的关键词（如「你好」），查看是否收到对应回复。
  3. 发送未添加的关键词，查看是否收到默认回复。
  4. 若未收到回复，请检查：接口配置是否正确、关键词是否启用、URL是否可访问、服务器是否正常运行。

七、插件卸载

若无需使用插件，可通过以下步骤卸载，确保无数据残留：

  1. 登录WordPress后台 → 插件 → 已安装插件，找到「微信自动回复（Composer原生版）」。
  2. 点击「停用」，先停用插件（停用后插件功能失效，但数据保留）。
  3. 停用后，点击「删除」，弹出确认提示框，点击「确定」，插件会自动卸载。

卸载说明：插件卸载时，会自动删除关键词数据表（wp_wechat_keywords）和所有配置项（Token、AppID、EncodingAESKey），无需手动清理，彻底无残留。

八、常见问题排查

Q1：微信菜单图标不显示？

A：插件已内置自定义绿色微信图标，若未显示，可检查：

  • 插件是否正常启用，若未启用，启用后刷新页面。
  • 浏览器缓存问题，清除浏览器缓存后重新登录WordPress后台。

Q2：微信公众平台接口配置验证失败？

A：常见原因及解决方法：

  • URL不可访问：检查域名是否解析正常、服务器是否开启80/443端口、URL是否被防火墙拦截。
  • Token不一致：确保插件「基础配置」中的Token与微信公众平台的Token完全一致（区分大小写）。
  • EncodingAESKey错误：若填写了EncodingAESKey，确保与微信公众平台的一致，或暂时不填，选择明文模式测试。

Q3：用户发送关键词，无自动回复？

A：排查步骤：

  1. 检查接口配置是否生效（微信公众平台「基本配置」中接口配置状态为「已启用」）。
  2. 检查关键词是否添加正确，且状态为启用（默认启用）。
  3. 检查服务器是否正常运行，可访问插件URL（https://你的域名/?wechat_callback=1），若显示空白则正常，若报错需修复服务器环境。

Q4：Composer安装依赖失败？

A：确保服务器已安装Composer，若未安装，可参考Composer官方文档安装；若安装后仍失败，可检查PHP版本是否满足要求（7.2及以上），或手动上传本地安装好的vendor目录。

九、注意事项

  • 插件仅支持微信公众号文本消息的自动回复，暂不支持图片、图文、语音等消息类型。
  • 请妥善保管微信公众号的AppID、AppSecret、EncodingAESKey，避免泄露，防止安全风险。
  • 若WordPress版本升级或服务器环境变更，建议重新检查插件配置，确保功能正常。
  • 插件仅在删除时清理数据，停用插件不会删除任何数据，重新启用后可继续使用。

十、扩展说明

该插件采用Composer自动加载规范，代码结构清晰，可根据需求扩展以下功能（需具备基础PHP开发能力）：

  • 添加模糊匹配关键词功能，支持关键词包含匹配。
  • 扩展图片、图文、语音等消息类型的自动回复。
  • 添加关注自动回复功能，用户关注公众号时自动发送指定内容。
  • 添加关键词回复日志，记录用户发送的消息及回复内容。
后端开发

评论 (0)

暂无评论

推荐阅读