简介
这是一个基于 Halo 2.0 开发的微信公众号同步插件,支持在发布文章时同步到微信公众号。
意义和用途
Halo 有部分用户有自己运营的微信公众号,但是在 Halo 创作的文章,再手动复制一遍到微信公众号上是一件比较繁琐的工作。故使用该插件能够帮助用户,一键同步文章到微信公众号的草稿箱中,然后可以在公众号端预览并选择发布。
如何安装和配置插件
在 Halo 的「应用市场」中,可以看到付费插件,找到微信公众号发布插件并购买插件。付费插件涉及到许可证激活,购买之后可在 Halo 官网登录个人账号查看「我的许可证」,然后在 Halo 的插件页面选择对应插件的许可证管理,激活方式选择账户激活,选择对应的在线许可证并激活使用插件即可。当然也可以选择使用下载 jar 包并本地上传安装的方式安装插件。安装成功后,可以在插件列表看到微信公众号发布插件。
准备工作
1、需要有微信公众号(订阅号或服务号均可),并且在公众号后台的「设置与开发」「基本配置」IP 白名单中添加 Halo 所在服务器 IP 地址,作为调用微信公众号 API 的条件。
2、微信公众平台中检查「接口权限」中「永久素材管理接口」的权限接口状态是否是已获得。需要是已获得状态才能同步时正常上传图片素材。
3、检查 Halo 平台中「概览」「外部访问地址」是否已设置(非 localhost),如果没有设置,需要根据不同的部署方式重新设置 external url 参数,如 http://服务器IP:8090, 也可域名的形式,且需保证该 URL 需要能从浏览器直接访问。
4、安装插件后,需要在插件配置处配置好 appId, appSecret。然后在「预校验」中点击按钮测试是否通过。
操作步骤
1、安装并且配置好插件后,编辑文章,在文章设置中需要设置封面图。
2、在元数据处,「是否发布文章时推送到微信公众号」选择是,然后点击保存。
3、可以在文章列表右边操作处选择「预览公众号效果」,点击之后会弹出一个新页面显示公众号展示的样式效果(注:只作为参考,公众号端可能存在部分样式过滤和转换,效果可能不完全一致)。
4、可以在文章列表右边操作处选择「同步到微信公众号」,选择确认,即可将文章同步到微信公众号。稍等片刻即可查看同步的状态以及可能的错误提示。
5、推送之后可以登录到公众号平台,查看草稿箱,可选择将草稿箱的文章群发或者是普通发布。
注意事项
1、如果需要编辑草稿,需要在文章编辑保存,再将文章「发布」之后,选择「同步到微信公众号」,才会同步更新改动之后的内容到微信公众号。
2、如果需要删除草稿,在文章点击删除之后,会将微信公众号草稿箱中的对应文章的草稿删除。
3、目前 Halo 端可预览同步到微信公众号之后的 html 效果,但是因为在同步过程中,页面的部分标签或者样式可能经过微信端 转换/过滤/特殊处理,导致最终在公众号呈现的页面效果跟 Halo 端可能不完全一致。这种情况可能需要用户在公众号端稍做调整样式。