弹窗公告通知广告

一款适用于 XIUNOX（Xiuno BBS X）1.1 系列的响应式弹窗插件，可用于发布网站公告、重要通知、活动推广及广告内容。

插件信息

插件简介

弹窗公告通知广告插件可以在论坛前台展示统一的公告、通知或推广弹窗。管理员可以在后台配置弹窗内容、展示范围、目标用户、终端类型、出现频率和视觉样式。

插件同时适配电脑端与手机端。手机端可选择居中弹窗或底部抽屉形式，并针对动态视口、安全区域和内容滚动进行了优化。

主要功能

1. 全局启用与停用

• 可在后台一键启用或停用前台弹窗。

• 停用后保留全部设置。

• 停用状态下不加载前台弹窗 CSS 和 JavaScript 资源。

2. 精准控制展示对象

支持以下展示对象：

• 全部访客

• 仅游客

• 仅登录会员

• 指定用户组

选择“指定用户组”后，可直接勾选允许展示弹窗的用户组。

3. 控制展示页面

支持以下页面范围：

• 全站页面

• 仅论坛首页

• 仅版块页与帖子详情页

4. 电脑端与手机端适配

支持按终端控制弹窗：

• 电脑端和手机端同时显示

• 仅电脑端显示

• 仅手机端显示

手机端支持两种布局：

• 底部抽屉

• 居中弹窗

5. 多种信息类型

可根据使用场景选择：

• 公告通知

• 重要提醒

• 活动推广

不同类型会使用对应的语义图标和展示文案。

6. 自定义弹窗内容

后台可配置：

• 弹窗标题

• 纯文本正文

• 配图地址

• 点击跳转地址

• 主按钮文字

• 次按钮文字

• 是否在新窗口打开链接

正文以纯文本方式保存与输出，支持换行，不执行管理员输入的 HTML 或脚本。

7. 八种预设皮肤

插件内置以下弹窗风格：

1. 经典 Discourse

2. 现代柔光

3. 像素街机

4. 玻璃拟态

5. 英伦暗金

6. 赛博霓虹

7. 荒野生存

8. 暗黑熔岩

管理员还可以继续调整：

• 强调色

• 主按钮渐变起点

• 主按钮渐变终点

• 主按钮文字颜色

• 次按钮文字颜色

• 电脑端弹窗宽度

8. 灵活的显示频率

支持四种频率策略：

• 每次打开页面：刷新或进入其他页面后仍会显示。

• 当前会话一次：当前浏览器会话中只显示一次。

• 间隔若干天：在设定的天数后再次显示。

• 当前内容永久一次：同一内容签名只显示一次。

当管理员修改标题、正文、配图、链接、按钮或样式等核心内容后，插件会生成新的内容签名，已经阅读过旧内容的访客也能看到新版公告。

9. 显示行为控制

可配置：

• 延迟弹出的秒数

• 自动关闭的秒数

• 是否显示右上角关闭按钮

• 是否允许点击遮罩关闭

• 是否允许按 ESC 键关闭

自动关闭时间设置为 0 时，弹窗不会自动关闭。

后台设置页

版本 1.1.1 的后台设置页按照统一插件规范重新设计，包含：

• 插件 Hero 信息区

• 运行状态与版本徽章

• 环境信息卡

• Pills 胶囊 Tab 分组

• 左侧说明、右侧开关的设置行

• 胶囊输入框与单位输入组

• 实时内容预览

• 粘性保存栏

• 异步保存与 Toast 提示

• 居中渐变版权栏

设置保存采用原生 Fetch 异步提交，不会整页刷新；提交过程中会禁用按钮并显示加载状态，防止重复保存。

安装方法

1. 下载 jxy_popup_notice_v1.1.1.zip。

2. 进入 XIUNOX 后台插件管理页面。

3. 上传并安装 ZIP 文件。

4. 启用“弹窗公告通知广告”插件。

5. 打开插件设置页面，填写公告内容并配置展示规则。

6. 保存设置后访问论坛前台进行检查。

ZIP 文件的内部目录结构如下：

jxy_popup_notice_v1.1.1.zip
└── jxy_popup_notice/
    ├── conf.json
    ├── icon.png
    ├── logo.png
    ├── install.php
    ├── uninstall.php
    ├── upgrade.php
    ├── setting.php
    ├── hook/
    ├── model/
    ├── static/
    └── view/

使用建议

普通公告

• 信息类型：公告通知

• 展示对象：全部访客

• 页面范围：全站页面

• 显示频率：间隔若干天

• 建议开启：关闭按钮、ESC 关闭

重要维护提醒

• 信息类型：重要提醒

• 展示对象：全部访客

• 页面范围：全站页面

• 显示频率：每次打开页面或当前会话一次

• 建议关闭：点击遮罩关闭

活动推广

• 信息类型：活动推广

• 展示对象：登录会员或指定用户组

• 页面范围：首页或全站

• 可配置：活动配图、跳转地址和新窗口打开

安全设计

• 设置页仅允许管理员和后台管理组访问。

• 所有 POST 保存请求均执行 XIUNOX CSRF 校验。

• 标题、正文和按钮文字会移除 HTML 标签。

• 前台输出使用 esc_html() 和 esc_attr() 转义。

• 图片及跳转链接只允许：

  • http://

  • https://

  • 以单个 / 开头的站内绝对路径

• 不依赖 jQuery 或 Alpine.js。

• 后台交互使用原生 JavaScript、Fetch 和 Bootstrap 5.3。

常见问题

保存设置后前台没有变化

请检查：

1. 插件是否已经启用。

2. “启用前台弹窗”开关是否开启。

3. 当前用户、终端和页面是否符合展示范围。

4. 当前浏览器是否已经按照频率策略记录为已读。

5. 是否需要清理 XIUNOX 模板缓存并强制刷新浏览器。

修改公告后，已经看过的用户能否再次看到？

可以。修改标题、正文、图片、链接、按钮或主要样式后，会生成新的内容签名。

是否会创建数据库表？

不会。插件设置保存在 XIUNOX 的 Setting KV 中。

是否支持在公告正文中执行 HTML？

不支持。正文按纯文本保存和输出，以降低脚本注入及错误标签破坏页面的风险。

版本记录

v1.1.1

• 按统一规范重构后台设置页面。

• 新增 Hero、环境卡、Pills Tab、规范开关行和粘性保存栏。

• 后台保存改为原生 Fetch 异步提交。

• 增加表单校验、加载状态、Toast 提示和 Tab 记忆。

• 更新统一插件图标和 Hero Logo。

• 完善移动端后台设置页适配。

v1.1.0

• 新增八种弹窗预设皮肤。

• 新增样式选择和实时预览。

• 样式变化加入内容修订签名。

v1.0.0

• 首次发布。

• 支持公告内容、展示范围、终端、人群和显示频率配置。

版权信息

Copyright 2026 金小颖论坛 版权所有。

弹窗公告通知广告 wajxy_popup_notice_v1.1.2

付费资源

已售 0

弹窗公告通知广告

文件大小54.1 KB

提取码***暂无权限查看***

解压密码***暂无权限查看***

下载次数0 次

金币10

检测链接立即购买

为 XIUNOX 提供电脑端与手机端自适应的公告、通知和广告弹窗。