💬 ThinkPlugsWechat

ThinkPlugsWechat 是 ThinkAdmin 的微信基础管理插件，提供公众号配置、粉丝、图文、菜单、回复、微信支付与退款管理，并封装 WeChatDeveloper 公众号、小程序和支付接口调用能力。该插件基于 MIT 协议开源，免费可商用。

当前 composer.json 要求 PHP >7.1，依赖 ext-json、ext-openssl、ext-mbstring、zoujingli/qrcode、think-install、think-library 和 zoujingli/wechat-developer。插件安装时会把 src 复制到 app/wechat，并把迁移脚本复制到 database/migrations。

🚀 主要功能

后台管理

接口配置: 公众号、第三方授权模式和小程序绑定参数配置
微信支付配置: 微信商户支付参数、证书和支付测试
粉丝管理: 关注用户信息同步和管理
图文管理: 图文素材管理和接口预览
菜单配置: 自定义菜单创建、保存和发布
回复管理: 关键词回复和关注自动回复
支付与退款: 微信支付行为记录、未支付清理和退款记录管理

接口封装

公众号接口: 封装 WeChat 公众号常用接口
小程序接口: 封装 WeMini 小程序接口调用，后台不提供小程序代码发布管理菜单
支付接口: 封装 WePay / WePayV3 支付、通知和退款处理

⚠️ 重要提示

目录替换警告: 安装此插件将会占用并替换 app/wechat 目录（采用先删除再写入的方式）。如果您之前对 app/wechat 目录有过自定义修改，请先备份，否则这些修改可能会丢失。

卸载注意: 使用 Composer 卸载此插件时，请务必记得手动删除 app/wechat 目录及相关的数据表，因为这些内容不会被自动清理。

🛡️ 保护自定义修改

如果您不希望 app/wechat 目录被插件更新替换，可以使用以下方法：

方法一：忽略更新机制 在 app/wechat 目录下创建一个名为 ignore 的文件：

touch app/wechat/ignore

方法二：插件本地化 使用插件本地化实现 ThinkPlugsWechat 定制开发。

加入我们

我们的代码仓库已移至 Github，而 Gitee 则仅作为国内镜像仓库，方便广大开发者获取和使用。若想提交 PR 或 ISSUE 请在 ThinkAdminDeveloper 仓库进行操作，如果在其他仓库操作或提交问题将无法处理！。

标准安装

**安装前建议尝试更新所有组件**
composer update --optimize-autoloader

composer require zoujingli/think-plugs-wechat

定制安装

如果不希望 app/wechat 目录被插件更新替换，有两个方法可以避免这一情况。

使用插件更新忽略替换机制，在 app/wechat 目录下创建一个名为 ignore 的文件 ( 例如 app/wechat/ignore ) 。这样即使执行了插件的安装或更新操作，该目录也将被忽略，不会被替换更新。
使用插件本地化实现 ThinkPlugsWechat 定制开发。当前插件 composer.json 已配置 app\\wechat\\ 到 src 的 PSR-4 加载规则，定制时应保留该规则，并按需追加 version 配置。

插件本地化 ( 插件模式 )

复制插件 ThinkPlugsWechat 所有源代码到 plugin/think-plugs-wechat 目录。
修改插件 composer.json 文件追加 version 配置项，并保留 autoload 与安装器复制规则，插件 ThinkPlugsWechat 的完整配置如下：

{
  "type": "think-admin-plugin",
  "name": "zoujingli/think-plugs-wechat",
  "version": "1.0.0",
  "license": "MIT",
  "homepage": "https://thinkadmin.top",
  "description": "WeChat official account, menu, reply, payment and refund module for ThinkAdmin",
  "authors": [
    {
      "name": "Anyon",
      "email": "zoujingli@qq.com"
    }
  ],
  "require": {
    "php": ">7.1",
    "ext-json": "*",
    "ext-openssl": "*",
    "ext-mbstring": "*",
    "zoujingli/qrcode": "^1.0|@dev",
    "zoujingli/think-install": "^1.0|@dev",
    "zoujingli/think-library": "^6.1|@dev",
    "zoujingli/wechat-developer": "^1.2|@dev"
  },
  "autoload": {
    "psr-4": {
      "app\\wechat\\": "src"
    }
  },
  "extra": {
    "config": {
      "type": "module",
      "name": "微信平台管理",
      "document": "https://thinkadmin.top/plugin/think-plugs-wechat.html",
      "description": "微信基础管理模块，提供公众号配置、粉丝、素材、菜单、回复、支付和退款管理。"
    },
    "plugin": {
      "copy": {
        "src": "!app/wechat",
        "stc/database": "database/migrations"
      },
      "clear": true
    },
    "think": {
      "services": [
        "app\\wechat\\Service"
      ]
    }
  }
}

修改项目根 composer.json 配置，增加 ThinkPlugsWechat 插件本地化路径配置，完整配置如下：

{
  "type": "project",
  "name": "zoujingli/thinkadmin",
  "license": "MIT",
  "homepage": "https://thinkadmin.top",
  "description": "ThinkAdmin plugin aggregation and distribution project",
  "keywords": [
    "ThinkAdmin",
    "ThinkLibrary",
    "WeChatDeveloper"
  ],
  "authors": [
    {
      "name": "Anyon",
      "email": "zoujingli@qq.com"
    }
  ],
  "require": {
    "php": ">7.1",
    "ext-gd": "*",
    "ext-json": "*",
    "ext-openssl": "*",
    "zoujingli/think-plugs-admin": "^1.0",
    "zoujingli/think-plugs-wechat": "^1.0"
  },
  "repositories": [
    {
      "type": "path",
      "url": "plugin/think-plugs-wechat"
    }
  ],
  "config": {
    "sort-packages": true,
    "allow-plugins": {
      "zoujingli/think-install": true
    }
  }
}

手动删除 app/wechat 目录 ( 如果存在 )，然后在项目根目录终端执行 composer update 完成安装。

后台演示

操作演示案例

卸载插件

**插件卸载不会删除数据表和 app/wechat 的代码**
**卸载后通过 composer update 时不会再更新，其他依赖除外**
composer remove zoujingli/think-plugs-wechat

功能节点

可根据下面的功能节点配置菜单和访问权限，按钮操作级别的节点未展示！

微信接口配置：wechat/config/options
微信支付配置：wechat/config/payment
微信粉丝管理：wechat/fans/index
微信图文管理：wechat/news/index
微信菜单配置：wechat/menu/index
回复规则管理：wechat/keys/index
关注自动回复：wechat/auto/index
微信支付行为：wechat/payment.record/index
微信退款管理：wechat/payment.refund/index

服务注册

服务类：app\wechat\Service
注册命令：xadmin:fansall、xadmin:fansmsg [openid] [autocode]、xadmin:fanspay
事件监听：WechatFansSubscribe，触发关注自动回复注册
通知路由：/plugin-wxpay-notify/:vars

插件数据

本插件涉及数据表有：

微信-回复：wechat_auto
微信-粉丝：wechat_fans
微信-标签：wechat_fans_tags
微信-规则：wechat_keys
微信-素材：wechat_media
微信-图文：wechat_news
微信-文章：wechat_news_article
微信-支付：wechat_payment_record
微信-退款：wechat_payment_refund

版权说明

ThinkPlugsWechat 遵循 MIT 开源协议发布，并免费提供使用。

本项目包含的第三方源码和二进制文件的版权信息将另行标注，请在对应文件查看。