弹窗通知

弹窗通知通知

版本 v1.0.1· 张先生 · 23 次获取 · 通知
独立弹窗公告插件:后台配置展示规则,按优先级依次弹出公告,支持关闭周期与跳转链接。
免费

详情介绍

一、插件简介

弹窗通知插件为站点提供全站弹窗公告能力:后台新增多条公告,前台按规则自动弹出。支持三种展示样式(现代轻奢 / 底部抽屉 / 右下浮窗),按优先级依次展示,用户关闭后在设定周期内不再重复弹出。

入口路径
前台弹窗全站自动注入(无独立页面)
有效公告 APIGET /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
      首次发布
    微信客服 微信客服