一般情况下主题应尽可能使用系统内部的模块管理功能来调用侧栏模块,系统内部内置5个侧栏,分别可以使用{template:sidebar}、{template:sidebar2}、{template:sidebar3}、{template:sidebar4}、{template:sidebar5}来直接调用。
如果需要单独调用某一模块内容,请使用以下代码调用:
系统内置模块调用如下:
标签
含义
备注
{module:navbar}
导航栏
{module:calendar}
日历
系统自动更新
{module:controlpanel}
控制面板
{module:catalog}
网站分类
系统自动更新
{module:searchpanel}
搜索
{module:comments}
最新留言
系统自动更新
{module:archives}
文章归档
系统自动更新
{module:statistics}
站点信息
系统自动更新
{module:favorite}
网站收藏
{module:link}
友情链接
{module:misc}
图标汇集
{module:authors}
作者列表
系统自动更新
{module:previous}
最近发表
系统自动更新
{module:tags}
Tags列表
系统自动更新
如果需要控制每个模块的具体输出内容或者单独调用某模块属性,调用标签如下:
标签
含义
备注
{$modules[‘moduleFileName’].ID}
内部ID
{$modules[‘moduleFileName’].Name}
模块名称
{$modules[‘moduleFileName’].FileName}
文件名
文件名应是唯一的,如为主题添加模块请以theme_主题ID_filename命名,同理,如为插件添加模块请以theme_插件ID_filename命名
{$modules[‘moduleFileName’].Content}
模块内容
{$modules[‘moduleFileName’].HtmlID}
htmlID
{$modules[‘moduleFileName’].Type}
模块类型
ul表示列表型,div表示混杂型
{$modules[‘moduleFileName’].MaxLi}
ul类型模块显示的最大列数
默认为10。该数值不会影响存储,只会限制前端显示条数
{$modules[‘moduleFileName’].Source}
模块属性
system=系统模块,theme=主题模块,plugin=插件模块
{$modules[‘moduleFileName’].IsHideTitle}
是否隐藏标题
1表示隐藏,0表示不隐藏,默认不隐藏
moduleFileName就是模块的文件名
从1.5模板开始,支持系统模块模板化,请参考侧栏模块相关模板 及 侧栏及模块模板标签。
Tag标签
{$tag}
标签
含义
备注
{$tag.Name}
标签名
{$tag.Url}
标签链接
{$tag.Count}
标签下文章数
时间标签
在模板中获取时间如{$article.Time(XXX)}、{$comment.Time(XXX)}等处XXX代表从时间戳标准格式符,使用效果等同于PHP原生函数
date($format)
格式符支持PHP原生函数中所有格式符。
常见时间格式代码如下:
标签
示例
备注
{$article.Time(‘Y年m月d日’)}
01月01日
{$article.Time(‘Y年m月d日 H:i:s’)}
01月01日 01:02:03
有前导零
详细格式符用法请查看PHP手册中Date章节
语言标签
Z-BlogPHP是支持多语言的,系统语言包文件位于/zb_users/language,从1.4版本开始支持应用也拥有自己的语言,具体请参考LoadLanguage 语言包载入。语言包内容以数组格式存储,根据系统配置或指定加载相应语言包内容。
引用系统语言包标签
{$lang[msg][name]}
引用应用语言包标签(1.4以上版本适用)
{$lang[APPID][name]}
所有可用的语言标签请打开相应的语言包文件进行查看。
扩展标签
Z-blogPHP几乎所有数据表都拥有扩展元数据,即Z-BlogPHP的自定义域机制Meta。Meta中数据以PHP序列化格式数据存储,其调用标签如
{$article.Metas.abc}
若要添加或设置meta数据请参考使用扩展元数据机制,或使用相关插件如自定义字段插件。