====== Z-BlogPHP 模板文件与模板标签 ======
[[zblogphp:development:theme:首页]] 目录下 \**zb_users**\**主题名**\**template** 文件夹是专门放置模板文件的。
:!: //Z-BlogPHP 1.5之前的版本,在主题目录下会有一个**compile**文件夹,这里存放经过程序编译后的模板文件,请不要去修改。//
:!: 如果改动了模板文件,则需要**重新编译**模板才能看到改动效果。你可以在后台首页找到**[清空缓存并重新编译模板]**或重新**激活主题**刷新编译模板文件。
===== 模板文件组成 =====
以下为常用模板文件,对于Z-BlogPHP来说模板文件并不是必须的,你可以利用 **[[defend_default]]** 节省开发精力。
==== 公共模板 ====
- header.php 公共头部文件
- footer.php 公共尾部文件
==== 首页与列表页相关模板 ====
- index.php 首页及列表页主模板文件
- post-multi.php 摘要文章模板
- post-istop.php 置顶文章模板((置顶文章会自动显示于首页及列表页中,无须标签调用))
- pagebar.php 分页条展示模板
{{ zblogphp:php-template.png?direct 300|模板结构图示}}
==== 日志页相关模板 ====
- single.php 文章页(单页)主模板文件
- post-single.php 日志页文章模板
- comment.php 评论区模板
- comments.php 每条评论内容显示模板
- commentpost.php 评论发送表单模板
==== 其它模板文件 ====
- 404.php 文章或页面等不存在时显示模板
- module.php 模块通用显示模板
- module-xxx.php [[zblogphp:development:theme:moduletemplate]](1.5)
===== 模版标签库及相关说明 =====
请看最新版本的标签大全
https://docs.zblogcn.com/php/markup/
Z-BlogPHP模版标签调用方式为{$类名.(二级类名.)类属性},如
- **{$article.Title}:**
* 显示文章标题的标签。这里article为文章类,Title为文章类属性。
- **{$article.Category.Name}:**
* 显示文章的分类名称。这里article为文章类名,而Category则为二级类,Name为类属性。
* 更多ZBP模板语法说明请参考:[[templatesyntax]]
* 一些使用示范:[[tips]]
==== 系统标签 ====
^ 标签 ^ 含义 ^ 备注 ^
| {$host} | 博客网址 | |
| {$name} | 博客标题 | |
| {$subname} | 博客副标题 | |
| {$theme} | 主题名称 | |
| {$style} | 样式名称 | |
| {$copyright} | 版权说明 | |
| {$zblogphp} | 当前Z-BlogPHP版本 | Z-BlogPHP 1.X XXXXX Build xxxxxx |
| {$zblogphphtml} | 当前Z-BlogPHP版本号(长) | Z-BlogPHP 1.1 Taichi Build 131221 |
| {$zblogphpabbrhtml} | Z-BlogPHP 带链接 无版本号(短) | Z-BlogPHP |
| {$language} | 网站语言 | zh-CN |
| {$header} | 页面头部变量 | 方便插件插入CSS、JS等脚本或其它META信息,请放在html的标签前 |
| {$footer} | 页面尾部变量 | 方便插件插入JS脚本或其它信息,请放在页面尾部