付费阅读内容

一、插件简介

发帖拓展插件：作者在发帖时可开启付费阅读并设置价格（积分或金币），读者支付后解锁全文，收益发放给作者。可配置允许发布付费帖的用户组。业务数据（帖子 is_paid、price、pay_currency 字段及解锁记录）由社区插件维护。

二、核心能力

三、依赖与安装

1. 将插件置于 plugins/paidread/。
2. 在应用中心安装「付费阅读」（也可由系统自动 ensureInstalled）。
3. 本插件不创建独立数据表；帖子付费字段与解锁记录由 community 维护。
4. 依赖：community（发帖、支付解锁、Coin 服务）。
5. 可选：vip（跳过付费）、payment（若涉及现金链路）。

首次安装会尝试从社区旧配置 enable_pay、pay_publish_level_ids 迁移开关与用户组。

四、应用中心基础配置

五、后台重点配置

付费阅读无独立后台菜单。管理员在后台编辑帖子时，若用户组有权限，可在帖子表单中看到付费阅读拓展（通过社区 admin_topic_form 插槽，本插件当前仅注册 compose_extra）。

主要运营配置在应用中心完成；价格与币种在发帖/编辑时按帖设置。

六、前台用户流程

作者发帖

1. 进入发帖页，在拓展区找到「付费阅读」区块（需用户组有发布权限）。
2. 开启付费开关，设置价格与币种（积分/金币）。
3. 发布帖子；正文对未付费读者显示预览/遮罩。

读者解锁

1. 打开付费帖子，看到付费提示与价格。
2. 点击支付解锁 → 扣减积分/金币 → 展示全文。
3. VIP 用户在配额与范围内可自动跳过扣费。

七、后台审核与运维

本插件无审核流程。运营关注：

• 应用中心开关与用户组配置
• 社区后台帖子管理中查看/编辑付费帖
• 通过社区流水查看作者收益

八、特殊说明

• 无 routes.php：前台解锁走社区帖子支付接口，非本插件独立路由。
• 插槽：compose_extra（发帖拓展，hookPriority 返回 10 靠前展示）。
• 数据：社区 topic 表字段 is_paid、price、pay_currency；解锁记录在社区相关表。
• 自动安装：ensureInstalled() 在首次使用时尝试自动安装插件。
• 回退逻辑：插件未安装时 enabled() 回退读取社区旧键 enable_pay。

九、推荐上线清单

• 确认社区插件已安装且发帖功能正常
• 在应用中心启用付费阅读并配置可发布用户组
• 测试发帖设置付费、读者解锁、作者到账
• 若使用 VIP，测试权益跳过逻辑
• 确认付费帖在列表/详情页展示正确

十、常见问题

Q：发帖页看不到付费阅读选项？ 检查插件是否启用；当前用户组是否在「可发布用户组」中（不勾选=不限制；管理员始终可用）。

Q：解锁后仍看不到全文？ 刷新页面；检查社区解锁记录是否写入；确认帖子 is_paid 状态正确。

Q：收益没有到作者账户？ 解锁逻辑由社区 Coin 服务处理，检查社区积分/金币流水。

Q：与 VIP 如何配合？ VIP 套餐配置付费阅读跳过次数；在生效范围内自动跳过，不重复扣费。

Q：卸载插件会删数据吗？ 不会；uninstall() 保留帖子付费字段与解锁记录。