弹窗通知通知
独立弹窗公告插件:后台配置展示规则,按优先级依次弹出公告,支持关闭周期与跳转链接。
免费
详情介绍
一、插件简介
弹窗通知插件为站点提供全站弹窗公告能力:后台新增多条公告,前台按规则自动弹出。支持三种展示样式(现代轻奢 / 底部抽屉 / 右下浮窗),按优先级依次展示,用户关闭后在设定周期内不再重复弹出。
| 入口 | 路径 |
|---|---|
| 前台弹窗 | 全站自动注入(无独立页面) |
| 有效公告 API | GET /popup/active |
| 后台管理 | /admin/popup |
| 应用中心配置 | 应用中心 → 弹窗通知 → 配置 |
URL 后缀说明:API 路径受社区 url_suffix 影响,例如 /popup/active.html;以实际配置为准。
二、核心能力
| 能力 | 说明 |
|---|---|
| 全站弹窗 | 通过 renderAssets() 注入,社区 layout 的 {:plugin_assets()} 自动加载 |
| 三种样式 | 现代轻奢(居中)、底部抽屉(居中卡片 + iOS 胶囊条)、右下浮窗 |
| 优先级队列 | 数值越大越优先;同次访问按顺序依次弹出 |
| 弹出上限 | 每次访问最多展示 N 条,0 表示不限制 |
| 关闭周期 | 用户关闭后,同一条公告在周期内不再弹出;0 表示每次访问都弹出 |
| 有效时间 | 单条公告可设开始/结束时间,过期自动不展示 |
| 跳转链接 | 主按钮可配置跳转;有链接时显示主题色胶囊按钮 |
| 富文本内容 | 后台公告内容使用编辑器(compose_body 钩子,软依赖 editor) |
| 主题色联动 | 按钮、图标、渐变背景跟随站点 --accent 主题变量 |
三、依赖与安装
建议安装 community(BBS社区)——社区 layout 含 {:plugin_assets()},弹窗才能在前台自动输出。软依赖 editor——后台公告内容区使用 compose_body / compose_assets 富文本编辑器;未安装时回退为普通文本框。install.sql,创建 popup_item 表。/static/popup/。无需修改核心代码——路由、菜单、前台资源均通过插件机制自动注册。
四、应用中心基础配置
字段来自 PopupPlugin::configSchema():
| 配置项 | 类型 | 说明 |
|---|---|---|
启用弹窗公告 enabled | 开关 | 关闭后前台不再弹出任何公告 |
弹出上限 max_per_visit | 数字 | 每次访问最多展示几条;按优先级从高到低;0 = 不限制 |
限制周期(秒) dismiss_period | 数字 | 用户关闭后同一条在该周期内不再弹出;0 = 每次访问都弹出。86400=1天,3600=1小时 |
弹窗样式 default_style | 下拉 | 新建公告时的默认样式;单条可单独覆盖 |
更新记录 (1)
-
v1.0.1
2026-08-24
首次发布