Discuz!后台管理中心首页微件（Widget）机制介绍

湖中沉

Discuz!后台管理中心首页微件（Widget）机制是从X3.5开始支持的一项机制，支持拖曳组合自定义显示顺序，从X5.0.1开始支持左右栏全域拖曳，让站长可以通过拖曳实现完全自由的后台首页数据看板，通过支持插件接入机制，拓展无限自由的数据看板形式。

每日签到的数据趋势？积分发放与消耗的走势与统计？会员增长数趋势？全站数据概览与趋势图？站点状态检测图表化？待办事宜快速分组显示并提供快捷入口？插件更新提示数据？ 内容审核效率监控？ 安全告警数据快速掌握？全部不是问题，通过系统内置和插件提供扩展组合，千万种可能都可满足，从简单的文字信息，变成一个数据看板中心，Discuz!正在

基于此功能开发的第一个插件已经上线： Discuz! 积分统计微件 (widget_showcredit) https://addon.dismall.com/plugins/widget_showcredit.html

一、整体架构概述

后台管理中心首页采用模块化 Widget 架构，将首页内容划分为多个独立的功能微件（Widget）。每个 Widget 负责展示特定维度的数据，管理员可以根据需求自由拖拽排序、显示/隐藏，实现高度个性化的工作台。

二、布局结构

首页采用双栏响应式布局：

左侧栏（#show_widgets_left，占 2/3 宽度）：展示数据量大、内容丰富的 Widget

右侧栏（#show_widgets_right，占 1/3 宽度）：展示精简概览类 Widget

Widget 会根据所在容器自动适配样式，左侧采用宽屏布局，右侧采用紧凑布局。

三、插件扩展机制

第三方插件可通过以下方式注入 Widget：

创建 admin\admin_widget 类

定义 widget_xxx() 方法（默认注入右侧）或 widget_xxx_left() 方法（注入左侧）

插件启用后，系统自动发现并加载

四、权限控制

站点状态 Widget 仅限创始人（isfounder()）可见

布局编辑权限 仅限最高层级管理员（adminid == 1）

插件 Widget 自动检测插件是否启用，禁用插件的 Widget 不显示

五、性能优化

数据缓存：部分 Widget（如积分排行）可使用文件缓存，N 小时内重复访问直接读取缓存

懒加载策略：数据库大小、附件大小等耗时操作采用点击触发

按需渲染：隐藏状态的 Widget 输出空占位模板，不执行数据查询

总结

该 Widget 机制实现了"高内聚、低耦合"的模块化设计，既保证了系统核心功能的完整性，又提供了灵活的扩展能力。管理员可以通过简单的拖拽和点击，打造符合自身工作习惯的管理首页，大幅提升日常运维效率。

云诺

支持👍