页面组件 DIY按需加载
ID layout_diy版本 2.3.3插件制作者 cxk123售价 30 积分6018 行 / 376.6 KBHook / 路由 / 后台页
2.3.0:**运行期结构自愈**(把新版文件覆盖进插件目录、没跑 install 时,老库缺表缺列不再让核心把整个插件自动停用 —— 组件目录页与后台 tab 先走「零查询内存快路径 → settings → 才 DDL」三道门,落后时按安装同一份定义幂等补齐 3 张表 / 4 枚索引 / 9 个增量列)。把站内已有的区块变成可以拖拽摆放的「页面组件」:五个槽位(首页顶 / 首页中 / 首页底 / 全站侧栏 / 页脚),三类组件来源(内置组件 / 别的插件通过私有 Hook diy_layout.components 自愿注册 / 把其它插件既有 entries 的 feature_links、profile_card、top_actions 自动包装成链接类组件),后台原生拖拽排序(不依赖任何前端框架),桌面端与移动端各存一套布局,支持多套布局与一键恢复默认。1.2.0 新增:帖子列表类组件六种样式(列表 / 两列紧凑 / 卡片封面 / 图文横排 / 杂志错落 / 信息流,颜色圆角字号跟随主题 CSS 变量)、封面来源三选一(主题首图零额外查询 / 附件图走 attachment.topic_images 契约整页一次批查 / 自定义链接)与比例圆角可配、没有封面的行自动回退成无图版式、四套一键套用的布局预设、版块列表组件(列表 / 卡片 + 描述与主题数回复数开关)、只对管理团队开放且默认关闭的自定义 HTML 组件(入库白名单过滤,脚本事件属性外链一律清掉)。三条硬约束:①查询预算 —— 每块声明 cost,保存时逐块累计、超上限拒绝保存并点名是哪一块贵,渲染时逐块实测查询数、超支的块降级为占位而不是拖垮整页;②失败隔离 —— 单块异常或空输出只留占位,输出缓冲 + try/catch 保证块内直接 echo 也破坏不了页面结构;③权限与隐私 fail-closed —— 块级可见范围(游客 / 登录 / 管理 / 版块)全部在服务端判定,未知值一律不渲染,组件能力与块范围取交集,管理向组件对游客永不渲染,匿名与屏蔽内容走既有遮蔽契约(anon_board.mask_rows)。1.3.0 新增:**组件自定义参数**(组件声明自己的参数白名单 —— 条数 3-20 / 显示哪些字段 / 开关等,后台逐块可视化编辑,未知键与越界值一律拒绝保存,参数带来的成本计入「有效声明成本」并与渲染期核对共用同一个函数;参数只改 SQL 的绑定值,不改查询条数)、**组件级缓存**(同一组件在同一请求内只渲染一次;跨请求可选短 TTL 缓存,缓存键含访客档与设备档,默认关闭时前台零额外查询,后台一键清空)、以及四处真缺陷修复(删除布局漏清快照 / 封面契约异常不再把整页变成错误页 / 站内链接白名单的反斜杠绕过 / 渲染账目跨钩子不同源)。2.0.0 新增:**全站任意页的槽位**(槽位从「首页三槽 + 全站侧栏 + 页脚」扩到五类页面 —— 首页 / 版块页 ?a=forum / 主题页 ?a=topic / 用户主页 ?a=user / 插件路由页(白名单挂载,默认空),每类页面**独立的开关与独立的预算**,预算 = 该类页面的槽位 + 全站槽位摊销,保存期按类校验、超了拒绝保存并点名是哪一块、哪一类页面;未知页面与未知槽位一律不注入、不报错、字节不变)、**组件级缓存的页面档**(缓存键增加页面档维度;后台按页面档看行数与命中、可按页面档清空;后台页面只读不写,清空后刷新后台不会又把页脚/侧栏的块写回来)、**渲染期参数白名单真正生效**(交给第三方渲染回调的块配置在渲染前统一过白名单:未知键丢掉、非法值退回默认、没提交过的键不凭空补),以及两处真缺陷修复(**站点标记自愈** —— 库里有启用中的布局而 `live` 标记为 0 时,前台按 `live` + `live_rows` 两个纯内存标记比对后就地重算,不再「库里有数据却永远显示空」;后台另给一个「按真实数据重算站点标记」的按钮)。2.2.0 新增:**块级条件显示**(每个块可带用户组 / 积分区间 / 注册天数 / 只给楼主 / 时段 / 星期,全部在服务端用请求级内存判定 —— 不发查询、不摊成本;未知键与非法值一律 fail-closed 不渲染,保存期与渲染期共用同一套归一化)、**布局 A/B 分桶**(同一套槽位挂 A/B 两份块清单,按登录用户 id / 游客浏览器 cookie 稳定哈希分桶,比例 0-100 可配、非法值按 0 = 关闭处理;分桶是纯内存判定,前台查询数不变;桶**不进缓存键** —— 缓存签名按块算,两桶天然分开,两桶里相同的块继续共用同一行缓存;B 桶某槽位为空时回落 A 桶;后台 A/B 面板可切桶编辑、一键把 A 桶复制到 B 桶,概览里点名「配了比例但 B 桶是空的」这种半开启状态)、**组件级缓存的定向失效**(缓存行带 component_id / slot,按「组件 / 槽位 / 页面档」任意组合定向删,空条件拒绝执行,不再「改一个组件的参数就把整站缓存全清」)、**保存前差异预览**(把编辑器里的块清单与当前已保存的那一份逐槽位比对,列出新增 / 删除 / 移动 / 参数变化 / 成本变化,纯服务端渲染,无 JS 路径照旧)。快照同时留档 A/B 两桶(回滚是完整回滚)。不启用任何布局时对前台零影响:不注入、不发查询、页面字节不变。
收费插件安装说明购买后点击“授权码”获取一次性授权码;在后台 > 插件广场点击在线安装或更新,并填写该授权码。已购买用户更新免费:每次在线安装或更新前,重新点击“授权码”获取新的一次性授权码即可,无需再次购买;也可直接下载新版后用后台“插件上传”更新。尊重并感谢他人劳动,请勿传播代码。
app/plugins/layout_diy/plugin.php
开发日志最新 10 条

此项目接受所有登录用户协助维护和提交更新。

  • bbs1
    bbs1
    版本 2.3.3 cdcdc1271210 更新:更新支持新内核的按需加载模式release
  • cxk123
    cxk123
    版本 2.3.1 3818c12d0f0e 更新:**2.3.1 · 卸载卫生:不再把两个历史记号"建"回数据库** - **修复(卸载残留)**:卸载逻辑里原本用一次「把记号清零」的写入来收拾现场,而那次写入走的是**upsert**(有则改、无则**新建**)—— 其中 `plugin_layout_diy_check` / `plugin_layout_diy_cache_hit` 这两个名字是**历史遗留**:现在的代码里既没有人写、也没
  • cxk123
    cxk123
    版本 2.3.0 69b70f911d5f 更新:**2.3.0 · 覆盖文件升级自愈** - **修复(升级路径)**:布局/组件/缓存三张表的列在 1.1.0 与 1.3.0 两代各有新增,而补列只在 `install` 内执行 ⇒ 覆盖文件升级后后台保存布局会直接抛 SQL 错并被**自动停用**(结构标记此前只写不读,等于没有护栏)。现在运行期入口按**三道门**(内存副本 → 设置标记 → 才 DDL)幂等补齐,结构标记改为一读一写。
  • cxk123
    cxk123
    版本 2.2.0 fa7811d1926f 更新:【2.2.0】把布局变成可运营的实验台:块级条件显示 · 布局 A/B 分桶 · 缓存定向失效 · 保存前差异预览 - **块级条件显示**:每个块可带「用户组 / 积分区间 / 注册天数 / 只给楼主 / 时段(支持跨零点)/ 星期」。 全部**在服务端用请求级内存判定**(核心已取回的当前用户 + 当前时间)→ **一条查询都不发**; 条件不满足时这一块**直接不渲染**(连块内那一条查询都
  • cxk123
    cxk123
    版本 2.1.0 45271107f5f2 更新:【2.1.0】组件生态续篇:私有 Hook `diy_layout.components` 与三款插件的原生组件 - 新增私有 Hook `diy_layout.components`:已上架的三款插件**原生实现**自己的组件,宿主只做登记与渲染, 插件停用即整块跳过(不报错、零查询、页面照常): · `rate_pick:picks`「高分 / 精选」——高分主题带评分人数,精选条带推荐理由;
  • cxk123
    cxk123
    版本 2.0.1 b4231eb3a797 更新:【2.0.1】站点标记收口(本轮「边界项收口」) - 渲染自愈补第四条**免费判据**:标记说「没有启用中的布局」、但 app_settings 里还留着一份能用的已发布载荷 (只可能来自带外改动:从旧备份恢复设置 / 先写载荷后写标记)→ 判为不同源,就地重算并照常渲染。 - **关键写点收口**:10 个会改布局表的后台动作(保存 / 加块 / 启用 / 停用 / 删除 / 复制 / 恢复默认
  • cxk123
    cxk123
    版本 2.0.0 e57188f8dc19 更新:## 2.0.0:全站任意页 —— 槽位从「五个」扩到「五类页面」 这一版把「只能改首页」这件事做完了:**版块页、主题页、用户主页、以及白名单里的插件路由页**都能摆组件, 每类页面有**自己的开关与自己的预算**;同时补上缓存的页面档、把渲染期参数白名单真正落地,并修掉两处真缺陷。 ### 全站任意页的槽位 - 槽位:首页三槽(首页顶 / 首页中 / 首页底)+ **版块页两槽 / 主题页两槽
  • cxk123
    cxk123
    版本 1.3.0 93f85b58f44f 更新:## 1.3.0:把 DIY 从摆设变成平台 **先修四处真缺陷(都先复现、再修、各留回归断言)** - 删除布局时**从属快照一条不剩**(以前只删布局行,快照留成孤儿;安装/升级补扫一次历史残留); - 第三方封面契约抛异常时**页面不再变成「操作失败」错误面板**(封面批查跑在核心最后一个页面钩子上,块级 try/catch 覆盖不到;现在拿不到封面就按无图版式渲染); - 站内链接白名单*
  • cxk123
    cxk123
    版本 1.2.0 cc7e3348faab 更新:## 页面组件 DIY 1.2.0 **大版本:组件样式(skin)+ 布局预设 + 版块列表组件 + 自定义 HTML;顺带修掉两处真缺陷。** ### 一、帖子列表类组件的六种样式(按组件可选,后台可配) - **列表**(默认,最省空间,与 1.1.x 完全一致)· **两列紧凑** · **卡片封面** · **图文横排** · **杂志错落**(每组 1 大 + 2 小)· **信息流*
  • cxk123
    cxk123
    版本 1.1.1 73ac5257826f 更新:**1.1.1 修复:后台「开始体检」「运行预算与隔离自检」在真实浏览器里点不动** * **现象**:后台点「开始体检」只弹一个「操作失败」,体检面板永远不出现;「运行预算与隔离自检」同样。curl 直接 POST 完全正常 —— 所以带 SQL_COUNT 断言的 300 项套件全绿也测不到。 * **根因**:①核心 `app/assets/index.js` 的全局 submit 监听器对
主楼