ZS主题助手（template）

zsadmin 主题开发辅助插件：通过可视化配置界面，无需编写代码即可快速定制主题各项功能。

安装

后台 → 应用中心 → 找到「ZS主题助手」→ 安装并启用。安装后左侧菜单出现「插件 → 主题助手」（/admin/template）。

功能总览

网站基础配置

SEO 优化

• 全站 SEO（标题/关键词/描述），同步写入社区插件配置，前台服务端渲染输出
• 分类 / 文章 / 标签 / 作者页面独立 SEO 规则（类型 + 对象 + 标题/关键词/描述）
• 自定义 SEO 分隔符：中横杠 -、下划线 _、竖线 |
• 分类 SEO 直接写入 communitycategory 表 seotitle/seokeywords/seodescription 列（列缺失时自动补齐），随页面服务端输出
• 文章/标签/作者独立 SEO 在前台页面即时应用（document.title 与 meta 标签）
• RSS 订阅发现链接（<link rel="alternate">，指向 /rss.xml）

内容管理

• 首页轮播图：可视化管理，支持上传、排序、启用开关，自动轮播（4 秒）、箭头/圆点切换、悬停暂停
• 首页模块：按分类配置文章模块（模块标题、数量 1-20、展示模板：文字流/图文行/杂志卡片/缩略图网格）
• 首页关于：选择指定页面作为「关于我」模块，自动提取纯文本摘要，右侧栏顶部展示
• 文字摘要格式化：列表摘要纯文本化、压缩空白、按长度截断补省略号
• 文章缩略图：发帖页显示缩略图上传字段，保存后存入 templatetopicthumb 表

分类管理

• 每个分类独立设置列表页每页文章数量（主题通过 TemplatePlugin::categoryPageSize($cid) 读取）
• 每个分类独立 SEO（见上）

备案与统计

• 网站备案号（ICP）与公安备案号：同步写入社区插件 footericp/footerpolice 系列配置，页脚原生输出
• 工商执照：文字 + 链接，自动追加到页脚版权行
• 统计代码：第三方统计服务代码，原样输出到页面尾部

用户体验

• 面包屑导航：分类/文章/标签/作者页自动生成「首页 / … / 当前页」层级路径
• 导航高亮：自动为当前页面对应的导航链接追加 on/active 类
• 灯箱效果：文章内容图片点击放大预览（遮罩层，点击关闭）

性能优化

• 图片懒加载：自动为内容图片补 HTML5 原生 loading="lazy" 属性（含动态新增内容）
• PJAX 局部刷新：拦截站内链接实现无刷新切换（实验性，默认关闭；如遇页面脚本异常请关闭）
• 响应式优化：轮播与首页模块在移动端自适应布局

主题开发接口

主题模板中可直接调用：

// 文章缩略图：自定义缩略图 → 文章默认图 → 空串
\plugins\template\TemplatePlugin::topicThumb($topicId);

// 分类列表页每页文章数量
\plugins\template\TemplatePlugin::categoryPageSize($categoryId, 20);

// 文字摘要格式化（去标签/压缩空白/截断）
\plugins\template\TemplatePlugin::formatExcerpt($html, 120);

前台生效方式

注意事项

• LOGO / 全站 SEO / ICP / 公安备案为「非空才同步」：在本插件填入后才会覆盖社区插件对应配置，清空本插件配置不会清除社区已保存值
• PJAX 为实验性功能，与强依赖页面内初始化脚本的页面可能存在兼容问题
• 轮播图与首页模块依赖社区前台插槽，第三方主题若移除对应插槽则不显示