| 標簽 | 含義 | 備注 |
|---|---|---|
| {$host} | 博客網址 | |
| {$name} | 博客標題 | |
| {$subname} | 博客副標題 | |
| {$theme} | 主題名稱 | |
| {$style} | 樣式名稱 | |
| {$copyright} | 版權說明 | |
| {$zblogphp} | 當前Z-BlogPHP版本 | Z-BlogPHP 1.X XXXXX Build xxxxxx |
| {$zblogphphtml} | 當前Z-BlogPHP版本號(長) | <a href="http://www.rainbowsoft.org/" title="RainbowSoft Z-BlogPHP" target="_blank">Z-BlogPHP 1.1 Taichi Build 131221</a> |
| {$zblogphpabbrhtml} | Z-BlogPHP 帶鏈接 無版本號(短) | <a href="http://www.zblogcn.com/" title="RainbowSoft Z-BlogPHP" target="_blank">Z-BlogPHP</a> |
| {$language} | 網站語言 | zh-CN |
| {$header} | 頁面頭部變量 | 方便插件插入CSS、JS等腳本或其它META信息，請放在html的</head>標簽前 |
| {$footer} | 頁面尾部變量 | 方便插件插入JS腳本或其它信息，請放在頁面尾部</body>標簽前 |
| {$type} | 頁面類型 | 頁面分為index、category、article、page、author、date、tag。請參考頁面判斷 |
| {$page} | 當前頁面頁碼 | 適用列表頁。文章頁等默認為1 |
| {$user} | 當前登錄用戶 | 請參考用戶標簽 |
| {$socialcomment} | 社會化評論區 | 如多說評論等，可用于文章頁面等 |
| {$cookiespath} | cookie的路徑 | 如將Z-BlogPHP安裝在子目錄，該路徑則為/子目錄名 |
| {$path} | 網站目錄物理路徑 | 注意：該路徑應僅用于文件讀取操作，不應直接輸出造成安全隱患 |
分類標簽
在摘要或文章等子模板頁面中調用需在標簽前加“article.”,如分類ID為:{$article.Category.ID}
| 標簽 | 含義 | 備注 |
|---|---|---|
| {$category.ID} | 分類ID | |
| {$category.Name} | 分類名稱 | |
| {$category.Alias} | 分類別名 | |
| {$category.Url} | 分類鏈接 | |
| {$category.Count} | 分類文章數量 | |
| {$category.Intro} | 分類摘要 | |
| {$category.Order} | 分類序號 | |
| {$category.Level} | 分類層級 | 目前支持4層級，0表示頂級，1表示2級，2表示3級，3表示4級 |
| {$category.RootID} | 分類的頂級ID | 頂級ID為0時表示該分類即為一級分類 |
| {$category.ParentID} | 分類的上一級ID | 同上 |
| {$category.Parent} | 分類的上一級類實例 | 注意：如為頂級分類則其上級類為NULL，在使用前需進行判斷。如： {if $article.Category.Parent}{$article.Category.Parent.Name}{/if} |
| {$category.SubCategorys} | 子分類實例數組 | 注意：如無子分類則為空，在使用前需進行判斷。 |
| {$category.Template} | 分類所用模板 | 默認為index |
| {$category.LogTemplate} | 分類下文章所用模板 | 默認為single |
| {$category.Meta} | 分類擴展數據(php序列化字符串) | 更多請參考擴展標簽 |
單獨獲取分類的信息，例如某分類ID的姓名：{$categorys[分類ID].Name}（缺點：當分類id不存在時，會導致網站頁面錯誤，在使用前需進行判斷。）
分頁標簽
文章列表相關頁面中可用分頁標簽，如首頁等。
| 標簽 | 含義 | 備注 |
|---|---|---|
| {$pagebar.PageBarCount} | 分頁長度 | |
| {$pagebar.PageCount} | 每頁顯示文章數量 | |
| {$pagebar.Name} | 分頁名稱 | |
| {$pagebar.PageAll} | 總頁碼數 | |
| {$pagebar.PageNow} | 當前頁碼 | |
| {$pagebar.PageFirst} | 起始頁碼 | |
| {$pagebar.PageLast} | 尾頁頁碼 | |
| {$pagebar.PagePrevious} | 上一頁ID | |
| {$pagebar.PageNext} | 下一頁ID | |
| {$pagebar.prevbutton} | 上一頁Url | <a href=“{$pagebar.prevbutton}”>« 更早的文章</a> |
| {$pagebar.nextbutton} | 下一頁Url | <a href=“{$pagebar.nextbutton}”>之后的文章 »</a> |
| {$pagebar.buttons} | 頁碼關聯數組 | 鍵名為頁碼，鍵值為頁碼對應的鏈接。 其中有4個特殊鍵名 ‹‹ 、‹、›、››分別代表第一頁、上一頁、下一頁、最后頁。 如 {$pagebar.buttons[3]}為第3頁鏈接，{$pagebar.buttons['››']}為最后一頁鏈接。 注意： ‹、›只有當上下頁存在時不為空，使用時應注意判別。 |
文章標簽（含獨立頁面）
| 標簽 | 含義 | 備注 |
|---|---|---|
| {$article.ID} | 文章ID | |
| {$article.Title} | 文章標題 | |
| {$article.Alias} | 文章標題別名 | 未設置則等同于Title |
| {$article.IsTop} | 文章是否置頂 | |
| {$article.Intro} | 文章摘要 | |
| {$article.Content} | 文章正文 | |
| {$article.Url} | 文章鏈接 | |
| {$article.Status} | 文章狀態 | |
| {$article.IsLock} | 是否禁止評論 | |
| {$article.CommNums} | 文章評論數 | |
| {$article.ViewNums} | 文章瀏覽數 | |
| {$article.Time(XXX)} | 文章發布時間 | XXX具體內容參考時間標簽 |
| {$article.Category.XXX} | 文章分類數據 | XXX具體內容參考分類標簽 |
| {$article.Author.XXX} | 文章作者數據 | XXX具體內容參考用戶標簽 |
| {$article.Tags.XXX} | 文章標簽數組 | XXX具體內容參考Tag標簽，注意$article.Tags是個Tag類實例數組 |
| {$article.Prev.Url} | 上一篇URL | |
| {$article.Next.Url} | 下一篇URL | |
| {$article.Prev.Title} | 上一篇標題 | |
| {$article.Next.Title} | 下一篇標題 | |
| {$article.Type} | 文章類型 | 0為普通文章，1為普通頁面。其它類型還在設計中。 |
文章Tag獲取方法
{foreach $article.Tags as $tag}<a href="{$tag.Url}" rel="external nofollow" >{$tag.Name}</a>{/foreach}
具體{$tag.XXX}內容參考Tag標簽。:!:注意，獨立頁面沒有tag元素！
評論標簽
在文章頁面中顯示評論需先格式化評論數據：
{foreach $comments as $key => $comment}{$comment.XXX}{/foreach}
具體內容參照下表：
| 標簽 | 含義 | 備注 |
|---|---|---|
| {$comment.ID} | 評論ID | |
| {$comment.FloorID} | 評論樓號 | 子評論不加入樓號計數，默認為0 |
| {$comment.Level} | 評論層級 | 0表示頂層，1表示2層，2表示3層，3表示4層，大于4層的返回4 |
| {$comment.ParentID} | 評論父ID | 上一層評論ID，自身為頂層則為0 |
| {$comment.RootID} | 評論根ID | 最頂層評論ID，自身為頂層則為0 |
| {$comment.LogID} | 評論所屬文章/頁面ID | |
| {$comment.Author.Name} | 評論作者 | 本表僅列出常用的作者相關標簽，更多可用標簽請參考 用戶標簽 |
| {$comment.Author.HomePage} | 評論網址 | |
| {$comment.Author.Email} | 評論郵箱 | |
| {$comment.Author.Avatar} | 評論頭像地址 | |
| {$comment.Post.Url} | 評論所屬文章的鏈接 | |
| {$comment.Post.Title} | 評論所屬文章的標題 | |
| {$comment.Content} | 評論正文 | |
| {$comment.IP} | 評論者IP | |
| {$comment.Agent} | 評論者客戶端信息 | |
| {$comment.Time(XXX)} | 評論發布時間 | 具體時間參考時間標簽 |
可以通過以下來循環調用該評論的子評論：
{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的用戶名稱。
| 標簽 | 含義 | 備注 |
|---|---|---|
| {$author.Url} | 用戶頁面鏈接 | |
| {$author.Name} | 用戶名 | |
| {$author.Alias} | 用戶別名 | |
| {$author.StaticName} | 用戶靜態名 | 存在別名時調用別名，不存在則調用用戶名 |
| {$author.Level} | 用戶級別 | 數值 |
| {$author.LevelName} | 用戶級別名 | |
| {$author.Email} | 用戶郵箱 | |
| {$author.HomePage} | 用戶主頁 | |
| {$author.Intro} | 用戶摘要 | |
| {$author.Avatar} | 用戶頭像 | |
| {$author.Articles} | 用戶發表文章數 | |
| {$author.Pages} | 用戶創建頁面數 | |
| {$author.Comments} | 用戶發表評論數 | |
| {$author.Uploads} | 用戶上傳文件數 |
模塊標簽
一般情況下主題應盡可能使用系統內部的模塊管理功能來調用側欄模塊，系統內部內置5個側欄，分別可以使用{template:sidebar}、{template:sidebar2}、{template:sidebar3}、{template:sidebar4}、{template:sidebar5}來直接調用。
如果需要單獨調用某一模塊內容，請使用以下代碼調用：
{module:moduleName}
系統內置模塊調用如下：
| 標簽 | 含義 | 備注 |
|---|---|---|
| {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就是模塊的文件名
Tag標簽
{$tag}
| 標簽 | 含義 | 備注 |
|---|---|---|
| {$tag.Name} | 標簽名 | |
| {$tag.Url} | 標簽鏈接 | |
| {$tag.Count} | 標簽下文章數 |
時間標簽
在模板中獲取時間如{$article.Time(XXX)}、{$comment.Time(XXX)}等處XXX代表從時間戳標準格式符，使用效果等同于PHP原生函數
date ( $format )
格式符支持PHP原生函數中所有格式符。
常見時間格式代碼如下：
| 標簽 | 示例 | 備注 |
|---|---|---|
| {$article.Time('Y年m月d日')} | 2014年01月01日 | |
| {$article.Time('Y年m月d日 H:i:s')} | 2014年01月01日 01:02:03 | 有前導零 |
語言標簽
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數據請參考使用擴展元數據機制，或使用相關插件如 自定義字段插件。
以上是Z-Blog博客系統的官方標簽，大家在使用過程中可參考使用。
