弹窗通知消息通知

一、插件简介

独立弹窗公告：后台维护多条公告，前台按优先级依次弹出。支持有效时间、三种样式、主按钮跳转，以及关闭后在限制周期内不再弹出。全局开关与每次访问条数在应用中心配置，单条文案与样式在「弹窗公告」中编辑。

二、核心能力

三、依赖与安装

1. 将插件目录置于 plugins/popup/。
2. 在应用中心安装「弹窗通知」。
3. 安装时创建 popup_item 表，注册后台「弹窗公告」菜单。
4. 硬依赖：社区前台布局（注入弹窗 DOM 与脚本）。后台内容编辑依赖站点编辑器钩子。
5. 无支付、积分依赖。关闭记录存在用户浏览器，不写会员账户。

四、应用中心基础配置

在应用中心 → 弹窗通知 → 配置，字段来自 configSchema：

公告标题、正文、按钮、链接、优先级、有效期均在后台「弹窗公告」中配置，不在应用中心弹窗。

五、后台重点配置

菜单「弹窗公告」/admin/popup：列表增删改、启用/停用。

• 标题、内容：内容支持富文本，前台按 HTML 展示
• 主按钮 / 关闭按钮：自定义文案
• 跳转链接：点击主按钮跳转；留空则只关闭
• 样式：现代轻奢 / 底部抽屉 / 右下浮窗
• 优先级：数值越大越先弹出
• 有效时间：开始、结束可留空
• 状态：启用后才进入前台队列

六、前台用户流程

1. 打开社区前台页面，脚本请求当前有效公告列表。
2. 过滤已在限制周期内关闭过的条目，再按优先级取出不超过「弹出上限」的条数。
3. 依次展示：可点遮罩/关闭按钮关闭，或点主按钮（有链接则跳转）。
4. 关闭后写入浏览器本地记录；周期内刷新通常不再弹出同一条。

七、后台审核与运维

前台路由

八、特殊说明

• 关闭记忆：键名为 popup_dismiss_{id}，存在浏览器 localStorage，换设备、清站点数据或隐私模式会重新弹出。
• 样式：luxury 现代轻奢、drawer 底部抽屉、float 右下浮窗。单条样式非法时回退到应用中心默认样式。
• 静态资源：/static/popup/popup.css、/static/popup/popup.js，由插件注入社区布局。
• 菜单名与插件名：应用中心标题为「弹窗通知」，后台菜单为「弹窗公告」，指同一插件。
• 不按版块、用户组定向；全站前台统一队列。

九、推荐上线清单

• 开启「启用弹窗公告」
• 确认弹出上限（日常建议 1）与限制周期（日常建议 86400）
• 至少一条启用中的公告：标题、正文、样式、优先级、有效期
• 需要活动落地时填写主按钮文案与跳转链接，并在前台点一次验证
• 抽检三种样式与深色模式观感
• 用无痕窗口验证「首次弹出 → 关闭 → 刷新不再弹出 → 周期后或清存储再弹」

十、常见问题

Q：前台完全不弹？ 检查应用中心总开关、公告是否启用、是否在有效期内，以及社区前台是否加载了弹窗脚本。

Q：关过一次就再也看不到？ 限制周期未到。可把周期改为 0 做测试，或换无痕窗口 / 清站点本地存储。

Q：为什么一次只弹一条？ 默认「弹出上限」为 1。要连弹多条请调大上限（0 为不限制条数）。

Q：多条时哪条先出？ 优先级数值越大越靠前，相同则较新的 id 优先。

Q：主按钮没有跳转？ 跳转链接为空时主按钮只关闭弹窗。

Q：换账号还是不弹？ 关闭记录跟浏览器不跟会员。同一浏览器内各账号共用这条本地记录。

Q：关掉总开关后列表还在吗？ 在。仅前台不请求展示，后台仍可编辑。