Z-BlogPHP 模板文件与模板标签

主题 目录下 template 文件夹是专门放置模板文件的。

Z-BlogPHP 1.5之前的版本，在主题目录下会有一个compile文件夹，这里存放经过程序编译后的模板文件，请不要去修改。

如果改动了模板文件，则需要重新编译模板才能看到改动效果。你可以在后台首页找到[清空缓存并重新编译模板]或重新激活主题刷新编译模板文件。

以下为常用模板文件，对于Z-BlogPHP来说模板文件并不是必须的，你可以利用 Z-BlogPHP 保留模板 节省开发精力。

1. header.php 公共头部文件
2. footer.php 公共尾部文件

1. index.php 首页及列表页主模板文件
2. post-multi.php 摘要文章模板
3. post-istop.php 置顶文章模板¹⁾
4. pagebar.php 分页条展示模板

1. single.php 文章页(单页)主模板文件
2. post-single.php 日志页文章模板
3. comment.php 评论区模板
4. comments.php 每条评论内容显示模板
5. commentpost.php 评论发送表单模板

1. 404.php 文章或页面等不存在时显示模板
2. module.php 模块通用显示模板
3. module-xxx.php 侧栏及模块模板标签(1.5)

在摘要或文章等子模板页面中调用需在标签前加“article.”,如分类ID为:{$article.Category.ID}

单独获取分类的信息，例如某分类ID的姓名：{$categorys[分类ID].Name}（缺点：当分类id不存在时，会导致网站页面错误，在使用前需进行判断。）

文章列表相关页面中可用分页标签，如首页等。

 文章Tag获取方法

{foreach $article.Tags as $tag}<a href="{$tag.Url}">{$tag.Name}</a>{/foreach}

具体{$tag.XXX}内容参考Tag标签。注意，独立页面没有tag元素！

在文章页面中显示评论需先格式化评论数据：

{foreach $comments as $key => $comment}{$comment.XXX}{/foreach}

具体内容参照下表：

可以通过以下来循环调用该评论的子评论：

{foreach $comment.Comments as $key => $comment} {template:comment} {/foreach}

• 当前登录用户信息使用$user，如{$user.Name}，当前登录者的名称
• 当前页面作者信息使用$author，$author涉及的标签只可在用户专属页面调用。如：{$author.Name}，显示作者的名称
• 指定用户信息{$zbp.members[1].xxx}，如{$zbp.members[1].Name}，显示ID为1的用户名称。

一般情况下主题应尽可能使用系统内部的模块管理功能来调用侧栏模块，系统内部内置5个侧栏，分别可以使用{template:sidebar}、{template:sidebar2}、{template:sidebar3}、{template:sidebar4}、{template:sidebar5}来直接调用。

如果需要单独调用某一模块内容，请使用以下代码调用：

{module:moduleName}

系统内置模块调用如下：

如果需要控制每个模块的具体输出内容或者单独调用某模块属性，调用标签如下：

moduleFileName就是模块的文件名

{$tag}

在模板中获取时间如{$article.Time(XXX)}、{$comment.Time(XXX)}等处XXX代表从时间戳标准格式符，使用效果等同于PHP原生函数

date ( $format )

常见时间格式代码如下：

详细格式符用法请查看PHP手册中Date章节

Z-BlogPHP是支持多语言的，系统语言包文件位于/zb_users/language，从1.4版本开始支持应用也拥有自己的语言，具体请参考LoadLanguage 语言包载入。语言包内容以数组格式存储，根据系统配置或指定加载相应语言包内容。

{$lang[msg][name]}

{$lang[APPID][name]}

Z-blogPHP几乎所有数据表都拥有扩展元数据，即Z-BlogPHP的自定义域机制Meta。Meta中数据以PHP序列化格式数据存储，其调用标签如

{$article.Metas.abc}