七夏（牛马）

应用数
51
安装量
334

应用圈

最后在线：: 2026-10-01
客服时间：: 工作日 9时~20时

其他应用

热门应用

牛马侧栏开关福利版

收藏分享投诉

¥9.90

统　　计:共 6 次下载
更新日期:2026-06-20
适配编码:UTF8SC
兼容版本:X3.5 X5.0 X5.1
PHP版本:7.0 ~ 7.4 8.0 ~ 8.2
标签分类:小工具
移动属性:该版本未适配手机版（触屏版）
开发方式:作者申明该应用少量使用 AI 辅助开发

购买应用 免责声明

# 右侧栏开关 - Discuz! 侧栏控制插件

## 插件简介

右侧栏开关是一款专为 Discuz! 论坛设计的侧栏控制插件，在页面右侧栏边缘提供一个轻量切换按钮，让用户一键收起或展开侧栏。关闭侧栏后，主内容区自动扩展至全宽，为阅读和浏览提供更大的可视空间。

插件采用服务端 + 客户端双层架构，关闭侧栏时服务端直接注入内联样式隐藏侧栏区域，从首次加载就避免侧栏闪烁问题，而非等 JavaScript 执行后再隐藏。这是本插件与纯前端方案的核心差异。

体验地址：https://www.niumabbs.com/

***

## 模板适配说明

本插件基于 Discuz 默认模板的 DOM 结构开发，核心依赖以下页面结构：

```
#ct (内容容器，需包含 ct2 / ct3 / ct2_a / ct3_a 中的任一 class)
  ├── .mn (主内容区)
  └── .sd (侧栏区域)
```

**适配的模板类型：**

- Discuz 默认模板
- 基于默认模板修改的模板（保留 #ct / .mn / .sd 结构及 ct2/ct3 布局 class）
- 大部分 克米 系列模板（插件 CSS 使用了 comiis 主题变量作为配色参考）

**不适配的模板类型：**

- 完全自定义 DOM 结构的模板（不存在 #ct、.mn、.sd 元素）
- 使用 flex / grid 等现代布局且未保留 ct2/ct3 class 体系的模板
- 侧栏使用非 .sd 选择器的模板

**自行检测方法：**

在浏览器中打开论坛页面，按 F12 打开开发者工具，在 Elements 面板中检查：

1. 是否存在 `id=ct` 的元素
2. 该元素是否包含 `ct2`、`ct3`、`ct2_a`、`ct3_a` 中的任一 class
3. 该元素下是否存在 class 为 `mn` 的子元素
4. 该元素下是否存在 class 为 `sd` 的子元素

以上四项全部满足即可正常使用。任一项不满足则插件按钮不会显示（不会报错，但功能无法生效）。

### **如自己无法确定，请务必联系客服协助查看！！！**

### **因模板不适配导致插件无法正常使用的，不退不换。购买前请务必按上述方法确认模板兼容性。**

***

## 功能特性

### 六大页面类型独立控制

插件覆盖论坛所有含侧栏的页面类型，每种页面可单独启用或关闭功能，互不影响：

- 论坛首页
- 版块列表页
- 帖子内容页
- 门户页面
- 群组页面
- 导读页面

每种页面类型均提供独立的启用开关和默认状态设置。例如，你可以只在帖子页和列表页启用切换按钮，首页保持侧栏常驻；或者让帖子页默认关闭侧栏以突出阅读体验，其他页面默认开启。

### 每种页面独立默认状态

六种页面类型各有独立的默认状态配置。管理员可以将特定页面（如帖子页）的侧栏默认设为关闭，用户首次访问该页面时侧栏即为收起状态，主内容区直接全宽展示。用户手动切换后，个人偏好会被记住，覆盖默认设置。

### 用户偏好持久化

用户切换侧栏状态后，插件同时写入 localStorage 和 Cookie 双重存储：

- localStorage 作为客户端主存储，支持精确的状态记录和过期判断
- Cookie 作为服务端读取通道，使服务端在页面输出时就能判断侧栏状态，提前注入隐藏样式

两种存储机制协同工作，确保用户偏好在不同浏览器标签、不同访问时段之间一致生效。

### 缓存有效期机制

管理员可设置侧栏关闭状态的缓存有效期（单位：小时）。过期后侧栏自动恢复显示，用户需重新操作。设为 0 表示长期有效，用户关闭后除非主动开启，否则一直保持关闭。

这个机制适用于运营场景：例如设置 168 小时（7天）有效期，定期让侧栏重新曝光，避免侧栏内容长期被用户屏蔽。

### 过渡动画

关闭和开启侧栏时支持平滑过渡动画，动画采用 cubic-bezier 缓动曲线，视觉上自然流畅。管理员可控制：

- 是否启用动画（可关闭以获得即时切换效果）
- 动画时长（100-800 毫秒可调，默认 300 毫秒）

### 用户组权限控制

支持按用户组限制功能使用。管理员在后台选择允许使用的用户组后，只有属于指定用户组的成员才能看到切换按钮并使用功能。未选择任何用户组时，所有用户（含游客）均可使用。

权限判断同时检查用户的主用户组和扩展用户组，覆盖 Discuz 的完整用户组体系。

### 按钮位置微调

提供按钮顶部偏移量配置（单位：像素），管理员可根据模板的导航栏高度调整按钮的垂直位置，避免与导航元素重叠。默认值为 3 像素。

### 服务端防闪烁

这是本插件的关键技术特性。当用户此前已关闭侧栏时，再次访问页面会出现侧栏先显示后隐藏的闪烁问题。本插件通过 Cookie 在服务端读取用户状态，在 HTML 输出阶段直接注入内联 `style` 标签隐藏侧栏，从页面渲染的苐一帧起侧栏就是隐藏状态，彻底消除闪烁。

同时，当管理员将某页面默认状态设为关闭时，首次访问的用户同样享受防闪烁处理，不会出现侧栏一闪而过的问题。

### 资源加载优化

CSS 文件采用 preload 异步加载策略，不阻塞页面渲染。JavaScript 文件使用 defer 属性延迟执行，不影响页面首屏加载速度。仅在功能启用的页面才输出相关资源，未启用的页面零额外开销。

***

## 技术细节

- 兼容 Discuz! X3.5 / X5.0 / X5.1
- 纯前端 + Hook 方式实现，不修改任何系统文件，不写入数据库
- CSS 使用 CSS 自定义属性（CSS Variables）适配模板配色，未定义时回退到默认值
- JavaScript 严格模式运行，IIFE 封装，不污染全局作用域
- Cookie 设置 SameSite=Lax 属性，符合现代浏览器安全策略
- JSON 输出使用 JSON\_HEX\_TAG 转义，防止 XSS 注入
- 反序列化使用 Discuz 官方 dunserialize 函数，不调用原生 unserialize

***

## 注意事项

1. 插件通过 Hook 机制注入页面，不修改系统文件，卸载后无残留
2. 全局开关关闭后，前台不输出任何 CSS/JS 资源，对性能零影响
3. 用户切换状态存储在浏览器本地，清除浏览器数据后状态会重置为默认
4. 缓存有效期设为 0 表示长期有效，侧栏关闭后除非用户主动开启或清除浏览器数据，否则一直保持关闭
5. 按钮定位采用 fixed 定位，跟随页面滚动实时调整位置，滚动使用 requestAnimationFrame 节流
6. 插件不会删除或隐藏侧栏的 HTML 内容，仅通过 CSS 控制显示与隐藏，搜索引擎抓取不受影响