{{ tags.important.name }}MaPay微信小程序-wordpress

很多 WordPress 站点已经有稳定的内容、分类和读者，但到了微信里，仍然缺少一个顺手的入口。做一个独立 App 成本太高，直接套模板又容易出现内容不同步、缩略图缺失、主题不兼容的问题。

MaPay 就是在这个背景下做出来的：不替换 WordPress，不和子比主题绑定，把现有的文章、分类、页面和互动数据，整理成一套可以在微信小程序里阅读的界面。

为什么做 MaPay

WordPress 负责内容，微信负责触达，这两件事本来可以很好地配合。实际落地时，常见的麻烦有三个：

1. 内容重复维护。文章在网站发一次，小程序里还要再发一次，时间一长就没人愿意更新。
2. 图片不统一。网站有特色图，小程序却没有合适的缩略图；有些老文章甚至完全没有图。
3. 主题依赖。换主题、关插件，小程序接口就跟着失效。

MaPay 的做法是：网站仍然是唯一的内容源，插件只负责把 WordPress 的数据整理成小程序需要的格式，并补上图片和小程序码这些“展示层”的事情。小程序不保存文章，也不复制一套后台。

一套插件，一个小程序

MaPay 由两部分组成：

• WordPress 插件：提供小程序接口、后台设置、固定缩略图、分享海报小程序码。
• 微信小程序：负责首页、排行、关于、文章详情和分享互动。

插件当前版本是 2.5.21，小程序当前版本是 2.7.24。

插件做了什么

1. 小程序接口

插件通过 WordPress REST API 提供小程序所需的数据：

• 站点配置、首页分类、轮播文章
• 文章列表与文章详情
• 浏览统计
• 点赞
• 文章分享海报的小程序码

小程序只读取已发布的内容，不需要额外的 CMS，也不需要在小程序里再建一套文章表。

2. 固定缩略图

这是 MaPay 最实用的一块。

WordPress 站点里总有一些文章没有特色图，小程序列表就会出现空白卡片。MaPay 内置了 42 张压缩后的固定缩略图，只处理没有图片的文章：

• 有特色图、首图、分类封面的文章不写入
• 无图文章自动补一张固定外链图
• 网站和小程序显示同一张图
• 关闭开关后，清理插件写入的图片

插件同时兼容子比主题的 zib_other_data 存储方式，不会出现“后台设置了但主题读不到”的情况。

3. 分享海报小程序码

文章详情页可以生成分享海报，海报里的小程序码由插件生成并缓存。

小程序码文件默认保存在：

wp-content/plugins/mapay/qrcode/

每篇文章一张，文件名为文章 ID，例如 123.png。插件目录不可写时，会自动回退到上传目录，后台使用说明里会显示实际生效的路径。

4. 后台设置

后台把常用配置集中在一个页面：

• 小程序 AppID / AppSecret
• 首页显示分类
• 首页轮播文章
• 无图文章固定缩略图开关
• 小程序版权名称
• 关于页入口和小程序码目录说明

AppID、AppSecret 只保存在 WordPress 数据库，不会下发到小程序端。后台菜单固定在仪表盘之后，进入站点后台就能看到。

5. 主题兼容

MaPay 不依赖子比主题：

• 启用子比主题时，兼容它的点赞、阅读量、分类封面和格式化函数
• 使用 WordPress 默认主题时，插件内置的格式化逻辑也能正常工作
• 开启 Redis 对象缓存时，缩略图和配置读取不会重复打数据库

网站前台除了固定缩略图，不改动主题的文章页、分类页和首页结构。小程序是独立入口。

小程序体验

首页

首页把“找文章”放在第一位：

• 顶部分类标签，支持横向滚动
• 搜索框，支持标题搜索和防抖
• 文章轮播，显示标题、精选标记和页码
• 最新文章列表，卡片式布局，缩略图、分类、时间、浏览和点赞一眼可见

列表使用骨架屏和图片懒加载，首屏不会白屏，也不会一次加载全部图片。

排行

排行页提供两个维度：

• 热门：按浏览量
• 热赞：按点赞量

前三名有单独的视觉标记，方便读者快速找到站点里最受欢迎的内容。

关于

“我们”页展示：

• 文章数
• 点赞量
• 阅读量
• 站点介绍正文

介绍正文读取 WordPress 中别名为 about 的页面。只要在后台“页面 → 所有页面”里编辑这个页面并发布，小程序就会自动同步。插件后台也放了快捷编辑入口。

文章详情

文章详情页包含：

• 标题、分类、时间、阅读时长
• 正文排版
• 点赞
• 分享给好友
• 生成海报
• 相关文章

正文使用 mp-html 渲染，标题、段落、图片、引用、表格、代码块的样式和关于页保持一致。相关文章和首页文章列表使用同一套卡片样式，不会出现“首页一套、详情页另一套”的割裂感。

版权与导航

小程序后台可以设置版权名称，显示在：

• 首页、排行、关于的顶部导航
• 文章详情顶部
• 所有页面底部版权

版权名由首页加载后缓存，其他页面直接复用，切换页面时不会先闪一下默认名称。

独立登录页

小程序里的登录页保持独立加载：

• 使用原生导航
• 不加载主小程序的版权、导航和自定义样式
• 不请求首页配置接口
• 不参与主页面样式体系

这样登录页不会被主小程序的视觉和逻辑影响，头像、昵称和登录流程保持原样。

几个实现细节

缩略图不覆盖已有图片

固定缩略图只处理“没有图”的文章，不会覆盖编辑已经选好的特色图，也不会改文章首图。关闭开关时，只清理插件自己写入的图片，不动人工设置的图片。

小程序码有缓存

同一篇文章的小程序码生成一次后会复用文件，不会每次打开海报都请求微信接口。接口层也有频率限制，避免被频繁调用。

内容不复制

小程序不保存文章正文，只通过 REST API 读取 WordPress 的已发布内容。网站在哪里更新，小程序就在哪里更新。

样式按页面加载

小程序的主页面样式拆成了基础、导航、文章列表、正文、分享、浮动按钮几个模块，每个页面只引入自己用到的部分。登录页不引入任何主小程序样式，背景、字号和卡片样式都不会互相影响。

安装与配置

1. 安装插件

上传 mapay-2.5.21.zip，在 WordPress 后台启用。

2. 填写小程序信息

进入 MaPay 设置页：

• 填写小程序 AppID
• 填写小程序 AppSecret
• 选择首页分类
• 选择首页轮播文章
• 设置版权名称
• 按需开启固定缩略图

3. 准备关于页

新建或编辑一个页面，别名设置为 about，发布。

4. 检查小程序码目录

确保 wp-content/plugins/mapay/qrcode/ 可写。后台使用说明会显示实际目录；如果插件目录不可写，会自动回退到上传目录。

5. 配置并上传小程序

在小程序源码里填写站点域名，使用微信开发者工具导入、编译、真机预览，然后上传代码并提交审核。

适合谁

MaPay 适合：

• 已经用 WordPress 持续更新内容的站点
• 使用子比主题，或者准备使用默认主题的站点
• 想要一个轻量阅读型小程序，而不是完整电商或复杂会员系统
• 希望网站和小程序共用同一套文章、分类和图片的站点

它不适合：

• 需要在小程序里完成复杂交易、订单和会员体系的场景
• 完全不想维护 WordPress 内容源的场景

最后

MaPay 想解决的不是“再做一个内容后台”，而是让 WordPress 已经写好的文章，在微信里有一个干净、稳定、维护成本低的入口。

网站继续负责内容，小程序负责阅读和分享。缩略图、小程序码、版权名、关于页这些琐碎但影响体验的细节，交给插件处理。

当前版本：

• 插件：MaPay 2.5.21
• 小程序：2.7.24

如果你也在用 WordPress 和子比主题，这套方案可以直接作为一个小程序内容的起点，再按自己的站点风格继续调整。