Z-BlogPHP模板文件及缺省机制

摘要

Z-BlogPHP博客系统采用模板文件及缺省机制，当主题未提供特定模板文件时，系统会从默认目录`zb_system/defend/default`中读取并使用。文章详细列举了页面公共模板（如header.php, footer.php）、首页与列表页相关模板（如index.php, post-multi.php）、日志/独立页相关模板（如single.php, post-single.php）以及侧栏模块相关模板（如sidebar.php, module.php及各类模块内容细节模板）的结构与功能说明。

核心要点

• 模板缺省机制：未提供的模板文件会从系统默认目录`zb_system/defend/default`读取。
• 模板文件分类：分为页面公共模板、首页/列表页模板、日志/独立页模板及侧栏模块模板四大类。
• 侧栏模块灵活性：侧栏模板（sidebar.php）支持自定义多个（如sidebar2-9.php），模块内容细节模板（如module-comments.php）决定了各类模块的最终显示格式。
• 1.5版本新增：评论验证码模板（commentpost-verify.php）及对模块内容细节模板的明确列表行数限制（如评论模块默认10条）。

关键实体

- Z-BlogPHP (product) ⚠️建议建页

• 模板文件 (concept)
• 缺省机制 (concept)

相关内容

• [[开发规范备忘docx处理与argparse安全访问.md]]
• [[技术选型]]

建议新建页面

• [[Z-BlogPHP主题开发规范]] — Z-BlogPHP作为特定产品，其模板机制和主题开发流程是核心知识，值得建立独立页面进行系统说明。

---

> 编译时间: 2026-06-02 04:35 | 来源: `zblog-docs/app-10-theme/theme-templates.md`