PageNest Companion
Companion plugin for PageNest, providing comment notifications, Markdown editor compatibility, math rendering, and legacy site integration.
Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/wzf2000/pagenest-compatibility/archive/refs/heads/main.zip
为 WordPress 长文增加段落互动、章节导航与可选站点功能。
Reading interactions, content guides and media presentation for WordPress.
开始使用 · 实际效果 · 文档 · 安装指南 · 更新记录
本文档对应 1.9.0。安装包与发行状态以仓库 Releases 为准，请使用对应版本附带的文档。
系列目录可在阅读设置中明确关联，章节返回、主题侧栏与 SEO 共用公开目录路径。旧文档可由服务器显式绑定系列，保留原内容与章节顺序。配置细节见 扩展接口。
让阅读之外的操作有处可去
读者可以围绕具体段落交流，沿章节顺序继续阅读，为文章点赞。站长可以按需开启搜索、分享信息、媒体展示和社交登录，而不用把这些功能写进主题。
Companion 与 PageNest 配合提供完整的阅读入口；其他主题也能使用独立评论抽屉。内容仍由 WordPress 管理，可选模块需要明确配置，不会自动批量迁移文章。
实际效果
下图来自 1.6.0 发布前的合成 WordPress／PageNest 截图，画廊使用合成图片；不是当前候选新增界面的验收截图。更多阅读、编辑与管理效果。
你能用它做什么
| 目标 | 提供的功能 | 使用入口 |
|---|---|---|
| 围绕正文交流 | 逐篇启用段落评论、本人编辑与冲突保护、文章点赞、普通评论邮件通知 | 阅读与互动 |
| 连续阅读一个系列 | 同名系列与章节顺序、按阅读权限展示上下篇 | 阅读设置 |
| 帮助内容被找到与分享 | 可选搜索建议、分类／系列筛选、SEO 与单篇分享预览 | 搜索与分享 |
| 展示图片与文件 | 可选画廊、键盘灯箱、PDF 查看器与媒体文件夹 | 媒体展示 |
| 接入站点账号与通知 | 可选社交登录、Brevo 邮件与 Turnstile 原生表单验证 | 账号与服务 |
| 扩展站点能力 | 可选内容模块、通用工具宿主与管理员页面测速 | 扩展文档 |
1.6.0 已提供： 需读者同意的本机 “我的阅读”、本人的评论与私人笔记入口、独立内容导览编辑、原生画廊／PDF 创作与只读模块诊断。详见使用指南。本机阅读记录不保存到账户、不跨设备同步；私人记录继续在服务端校验本人权限。
开始使用
需要 WordPress 6.0+、PHP 8.0+；安装目录保持 pagenest-compatibility。
- 从 仓库页面的 Releases 下载插件安装 ZIP，在后台 插件 → 安装插件 → 上传插件 安装并启用。
- 打开 设置 → PageNest Companion，选择所需的段落评论、章节导航和点赞功能。
- 编辑一篇文章，在 “PageNest 阅读功能” 中明确启用段落评论，填写系列名称及章节顺序，然后保存。
- 使用不同账号检查互动，再退出登录确认访客只能阅读公开内容。
关闭功能会保留既有记录；新文章默认不启用段落评论。已有相同功能的插件或桥接代码应先核对职责，升级与旧存储接入见使用指南。
两个组件，各自维护清楚的职责
PageNest 负责首页、目录、视觉和布局；Companion 负责互动、功能配置与服务端权限。经验奖励政策、浏览器工具、游戏与私人服务由独立可选实现提供，不随本插件安装包分发。
可选服务由管理员逐项启用，旧负责人仍运行时不自动接管。社交账号按应用身份关联，不按邮箱合并；配置和真实供应商验证见手册。MathJax 2.7.7 按主题特性从 cdnjs 加载，会产生第三方请求，库文件不随包发行。
文档与参与
文档导航按日常使用、站点配置和开发扩展组织说明：
- 使用指南：安装、阅读互动、权限、媒体、搜索、账号与升级。
- 实际效果：真实合成站的阅读、编辑与管理截图。
- 扩展接口：显式服务器配置、内容模块及兼容契约。
- 工具宿主与页面测速：独立可选模块的配置、实现边界与验收要求。
- 贡献指南与发行指南：本地检查、真实 WordPress 测试和安装包。
采用 GPL-2.0-or-later，版权归 PageNest Contributors（2026）所有。外部插件与远端加载库保留各自许可证。