WordPress微信/QQ分享插件 – 让你的网站在微信和QQ中完美展示

https://blog.ccswust.org/21669.html

在移动互联网时代，微信和QQ已经成为最重要的社交分享渠道。当用户在微信或QQ中分享你的WordPress网站链接时，你是否遇到过以下问题：

• 分享后只显示链接，没有标题和描述？
• 分享图片显示错误或模糊不清？
• 分享内容与页面实际内容不符？

这些问题不仅影响用户体验，还会降低网站的传播效果。为了解决这些问题，我开发了这款WordPress微信/QQ分享插件，让你的网站在微信和QQ中分享时能够完美展示自定义的标题、描述和图标。我也是前几天给理想画室做落地页的时候，客户说分享是一个链接乱码，然后就研究了好久，终于弄好了，现在就集成到wordpress里面来了。

图片[1]-WordPress微信/QQ分享插件 – 让你的网站在微信和QQ中完美展示-西城知道

图片[2]-WordPress微信/QQ分享插件 – 让你的网站在微信和QQ中完美展示-西城知道

插件介绍

WordPress微信/QQ分享插件是一款基于微信JSSDK 1.6.0最新版本开发的WordPress插件，支持微信公众号和微信开放平台两种配置方式，能够让你的网站在微信和QQ中分享时显示自定义的标题、描述和图标。

图片[3]-WordPress微信/QQ分享插件 – 让你的网站在微信和QQ中完美展示-西城知道

图片[4]-WordPress微信/QQ分享插件 – 让你的网站在微信和QQ中完美展示-西城知道

图片[5]-WordPress微信/QQ分享插件 – 让你的网站在微信和QQ中完美展示-西城知道

主要特性

• 支持多种分享场景：微信朋友、朋友圈、QQ好友、QQ空间
• 双平台支持：微信公众号（服务号）和微信开放平台
• 页面级别自定义：可以为不同页面设置不同的分享内容
• 智能回退机制：自动获取文章特色图片、网站图标作为分享图标
• 配置测试功能：内置配置测试工具，快速验证配置是否正确
• 调试模式：开启调试模式可查看详细日志，方便问题排查
• 性能优化：完善的缓存机制，避免服务器宕机
• 最新API：基于微信JSSDK 1.6.0，使用最新推荐接口

安装方法

方法一：WordPress后台安装（推荐）

1. 下载插件ZIP文件：wp-wechat-share-plugin.zip
2. 登录WordPress后台
3. 进入“插件”→“安装插件”→“上传插件”
4. 选择下载的ZIP文件，点击“现在安装”
5. 安装完成后，点击“启用插件”

方法二：FTP上传安装

1. 下载插件ZIP文件并解压
2. 将解压后的wp-wechat-share-plugin文件夹上传到wp-content/plugins/目录
3. 登录WordPress后台，进入“插件”页面
4. 找到“微信/QQ分享”插件，点击“启用”

配置步骤

第一步：获取微信凭证

根据你的需求选择配置方式：

方式一：微信公众号（服务号）

1. 登录微信公众平台 (https://mp.weixin.qq.com/)
2. 进入“开发”→“基本配置”
3. 获取AppID和AppSecret
4. 确保你的公众号已认证（个人订阅号不支持JSSDK）

方式二：微信开放平台

1. 登录微信开放平台 (https://open.weixin.qq.com/)
2. 进入“管理中心”→“网站应用”
3. 获取AppID和AppSecret
4. 确保你的网站应用已通过审核

第二步：配置JS接口安全域名

微信公众号配置

1. 登录微信公众平台
2. 进入“设置与开发”→“公众号设置”→“功能设置”
3. 找到“JS接口安全域名”
4. 填写你的网站域名（如：blog.ccswust.org）
   • 注意：不要带http://或https://协议头
   • 不要带端口号
   • 必须与实际访问域名完全一致（包括子域名）
5. 下载微信提供的验证文件（如：MP_verify_xxxx.txt）
6. 将验证文件上传到网站根目录
7. 在浏览器中访问 http://你的域名/MP_verify_xxxx.txt 确认可以访问
8. 点击“确定”保存配置

微信开放平台配置

1. 登录微信开放平台
2. 进入“管理中心”→“网站应用”→选择你的应用
3. 找到“开发信息”→“JS接口安全域名”
4. 填写你的网站域名（格式同上）
5. 下载验证文件并上传到网站根目录
6. 确认验证文件可以访问
7. 保存配置

重要提示：域名配置后可能需要等待几分钟到几小时才能生效，请耐心等待。

第三步：填写插件配置

1. 登录WordPress后台
2. 进入“设置”→“微信/QQ分享”
3. 在“基本配置”选项卡中填写以下信息：
   • 启用插件：勾选以启用分享功能
   • 配置类型：选择“微信公众号”或“微信开放平台”
   • AppID：填写从微信平台获取的AppID
   • AppSecret：填写从微信平台获取的AppSecret
   • 默认标题：设置默认分享标题（支持使用{title}变量）
   • 默认描述：设置默认分享描述（支持使用{excerpt}变量）
   • 默认图标：设置默认分享图标URL（必须是HTTPS协议）
   • 调试模式：勾选以开启调试模式（仅用于问题排查）
4. 点击“保存设置”

第四步：测试配置

1. 在“配置测试”选项卡中
2. 点击“测试配置”按钮
3. 查看测试结果：
   • AppID验证：检查AppID和AppSecret是否正确
   • Access Token：检查是否成功获取access_token
   • JSAPI Ticket：检查是否成功获取jsapi_ticket
   • 签名生成：检查签名是否正确生成

如果所有测试都通过，说明配置成功！

使用方法

默认分享行为

插件启用后，会自动为所有页面添加微信/QQ分享功能：

• 文章页面：使用文章标题、摘要和特色图片
• 页面页面：使用页面标题、摘要和特色图片
• 首页：使用网站名称、描述和网站图标
• 其他页面：使用默认配置的标题、描述和图标

页面级别自定义

如果你想让某个页面使用特定的分享内容，可以在页面编辑器中添加隐藏的input字段：

注意：

• 自定义图片必须是HTTPS协议
• 建议图片尺寸：300×300像素
• 建议图片大小：不超过50KB

在主题中集成

如果你想在主题模板中添加自定义分享内容，可以在相关模板文件中添加：

常见问题

1. 分享图片显示不对

原因：

• 图片URL不是HTTPS协议
• 图片尺寸过大或过小
• 图片格式不支持（建议使用PNG或JPG）

解决方法：

• 确保图片URL使用HTTPS协议
• 调整图片尺寸为300×300像素
• 压缩图片大小至50KB以内
• 使用微信分享调试工具检查图片URL

1. 分享功能不生效

原因：

• 插件未启用
• AppID或AppSecret配置错误
• JS接口安全域名未配置或配置错误
• 微信验证文件未上传或无法访问

解决方法：

1. 检查插件是否已启用
2. 使用“配置测试”功能验证AppID和AppSecret
3. 确认JS接口安全域名配置正确
4. 确认微信验证文件已上传到网站根目录且可以访问
5. 等待域名配置生效（可能需要几小时）
6. 提示”config:fail,invalid urldomain”错误

原因：JS接口安全域名配置错误

解决方法：

1. 确认在微信公众平台或开放平台配置了正确的JS接口安全域名
2. 域名格式必须正确（不带协议头和端口号）
3. 确保微信验证文件已上传到网站根目录
4. 在浏览器中访问验证文件URL，确认可以访问
5. 等待配置生效（几分钟到几小时）
6. 提示”updateTimelineShareData:fail, the permission value is offline verifying”

说明：这是微信开发者工具的正常提示，表示权限正在离线验证。在真实微信环境中不会有这个错误，不影响实际使用。

1. 如何测试分享功能

方法一：使用微信开发者工具

1. 下载并安装微信开发者工具 (https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_web_developer_tools.html)
2. 创建一个公众号网页调试项目
3. 输入你的网站URL
4. 查看控制台输出，检查是否有错误

方法二：使用真实微信测试

1. 在手机微信中打开你的网站链接
2. 点击右上角“…”菜单
3. 选择“分享给朋友”或“分享到朋友圈”
4. 查看分享效果
5. 标题或描述显示乱码

原因：字符编码问题

解决方法：

1. 确保WordPress数据库和页面使用UTF-8编码
2. 检查主题的header.php是否包含正确的meta标签：
3. 避免在标题或描述中使用特殊字符
4. 微信公众号和微信开放平台的区别

微信公众号（服务号）：

• 适用于已认证的微信服务号
• 主要用于在微信公众号内分享网页
• 需要在微信公众平台配置JS接口安全域名

微信开放平台：

• 适用于已认证的微信开放平台账号
• 主要用于在微信App内分享网页（不限于公众号）
• 需要在微信开放平台配置JS接口安全域名

选择建议：

• 如果你的网站主要通过微信公众号传播，选择“微信公众号”
• 如果你的网站需要在微信App中广泛传播，选择“微信开放平台”

1. 服务器死机或卡顿

原因：频繁请求微信API导致服务器负载过高

解决方法： 本插件已内置性能优化措施：

• 请求频率限制（最小间隔1秒）
• 缓存机制（access_token和jsapi_ticket缓存7000秒）
• 超时控制（API请求超时10秒）
• 完善的错误处理

如果仍然出现问题：

1. 检查服务器配置是否满足要求
2. 开启调试模式查看详细日志
3. 联系服务器管理员优化服务器配置
4. 如何查看调试日志
5. 在插件设置中开启“调试模式”
6. 在浏览器中打开你的网站
7. 按F12打开开发者工具
8. 切换到“Console”标签
9. 查看输出的调试信息
10. 支持哪些分享接口

本插件基于微信JSSDK 1.6.0，支持以下分享接口：

微信分享：

• updateAppMessageShareData：分享给朋友（最新推荐）
• updateTimelineShareData：分享到朋友圈（最新推荐）

QQ分享：

• onMenuShareQQ：分享给QQ好友
• onMenuShareQZone：分享到QQ空间

注意：旧版接口（onMenuShareAppMessage、onMenuShareTimeline）即将废弃，本插件已不再使用。

技术支持

如果在使用过程中遇到问题，可以通过以下方式获取帮助：

1. 查看常见问题：在插件后台的“常见问题”选项卡中查看详细解答
2. 使用配置测试：在“配置测试”选项卡中测试配置是否正确
3. 开启调试模式：开启调试模式查看详细日志
4. 访问作者博客：https://blog.ccswust.org/
5. 提交问题反馈：在作者博客留言或通过联系方式反馈

更新日志

v1.2.0 (2026-02-28)

• 基于微信JSSDK 1.6.0最新版本开发
• 移除即将废弃的旧版接口
• 使用最新推荐接口：updateAppMessageShareData、updateTimelineShareData
• 优化后台设置页面排版，采用选项卡布局
• 添加调试模式开关
• 添加分享回调事件处理
• 完善常见问题文档（10个问题）
• 修复代码显示问题
• 使用阿里巴巴矢量图标库

v1.1.0 (2026-02-27)

• 支持微信公众号和微信开放平台两种配置方式
• 添加配置验证功能
• 优化性能，防止服务器宕机
• 修复代码显示问题

下载

最新版本：v1.2.0 下载地址：wp-wechat-share-plugin.zip WordPress要求：WordPress 5.0+ PHP要求：PHP 7.0+

结语

这款WordPress微信/QQ分享插件是我基于实际需求开发的，希望能够帮助更多的WordPress用户解决微信和QQ分享的问题。如果你在使用过程中有任何问题或建议，欢迎在博客留言反馈。

插件信息：

• 作者：夏末浅笑
• 作者博客：https://blog.ccswust.org/
• 版本：1.2.0
• 基于微信JSSDK 1.6.0

感谢你的使用！

相关链接：

• 微信JSSDK官方文档：https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html
• 微信开放平台文档：https://developers.weixin.qq.com/doc/oplatform/Website_App/WeChat_PC_APIs/share.html
• 微信公众平台：https://mp.weixin.qq.com/
• 微信开放平台：https://open.weixin.qq.com/

图片[6]-WordPress微信/QQ分享插件 – 让你的网站在微信和QQ中完美展示-西城知道