標簽 | 含義 | 備注 |
---|---|---|
{$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} | 社會化評論區(qū) | 如多說評論等,可用于文章頁面等 |
{$cookiespath} | cookie的路徑 | 如將Z-BlogPHP安裝在子目錄,該路徑則為/子目錄名 |
{$path} | 網站目錄物理路徑 | 注意:該路徑應僅用于文件讀取操作,不應直接輸出造成安全隱患 |
分類標簽
在摘要或文章等子模板頁面中調用需在標簽前加“article.”,如分類ID為:{$article.Category.ID}
標簽 | 含義 | 備注 |
---|---|---|
{$category.ID} | 分類ID | |
{$category.Name} | 分類名稱 | |
{$category.Alias} | 分類別名 | |
{$category.Url} | 分類鏈接 | |
{$category.Count} | 分類文章數(shù)量 | |
{$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} | 子分類實例數(shù)組 | 注意:如無子分類則為空,在使用前需進行判斷。 |
{$category.Template} | 分類所用模板 | 默認為index |
{$category.LogTemplate} | 分類下文章所用模板 | 默認為single |
{$category.Meta} | 分類擴展數(shù)據(jù)(php序列化字符串) | 更多請參考擴展標簽 |
單獨獲取分類的信息,例如某分類ID的姓名:{$categorys[分類ID].Name}
(缺點:當分類id不存在時,會導致網站頁面錯誤,在使用前需進行判斷。)
分頁標簽
文章列表相關頁面中可用分頁標簽,如首頁等。
標簽 | 含義 | 備注 |
---|---|---|
{$pagebar.PageBarCount} | 分頁長度 | |
{$pagebar.PageCount} | 每頁顯示文章數(shù)量 | |
{$pagebar.Name} | 分頁名稱 | |
{$pagebar.PageAll} | 總頁碼數(shù) | |
{$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} | 頁碼關聯(lián)數(shù)組 | 鍵名為頁碼,鍵值為頁碼對應的鏈接。 其中有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} | 文章狀態(tài) | |
{$article.IsLock} | 是否禁止評論 | |
{$article.CommNums} | 文章評論數(shù) | |
{$article.ViewNums} | 文章瀏覽數(shù) | |
{$article.Time(XXX)} | 文章發(fā)布時間 | XXX具體內容參考時間標簽 |
{$article.Category.XXX} | 文章分類數(shù)據(jù) | XXX具體內容參考分類標簽 |
{$article.Author.XXX} | 文章作者數(shù)據(jù) | XXX具體內容參考用戶標簽 |
{$article.Tags.XXX} | 文章標簽數(shù)組 | XXX具體內容參考Tag標簽,注意$article.Tags是個Tag類實例數(shù)組 |
{$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元素!
評論標簽
在文章頁面中顯示評論需先格式化評論數(shù)據(jù):
{foreach $comments as $key => $comment}{$comment.XXX}{/foreach}
具體內容參照下表:
標簽 | 含義 | 備注 |
---|---|---|
{$comment.ID} | 評論ID | |
{$comment.FloorID} | 評論樓號 | 子評論不加入樓號計數(shù),默認為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)} | 評論發(fā)布時間 | 具體時間參考時間標簽 |
可以通過以下來循環(huán)調用該評論的子評論:
{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} | 用戶靜態(tài)名 | 存在別名時調用別名,不存在則調用用戶名 |
{$author.Level} | 用戶級別 | 數(shù)值 |
{$author.LevelName} | 用戶級別名 | |
{$author.Email} | 用戶郵箱 | |
{$author.HomePage} | 用戶主頁 | |
{$author.Intro} | 用戶摘要 | |
{$author.Avatar} | 用戶頭像 | |
{$author.Articles} | 用戶發(fā)表文章數(shù) | |
{$author.Pages} | 用戶創(chuàng)建頁面數(shù) | |
{$author.Comments} | 用戶發(fā)表評論數(shù) | |
{$author.Uploads} | 用戶上傳文件數(shù) |
模塊標簽
一般情況下主題應盡可能使用系統(tǒng)內部的模塊管理功能來調用側欄模塊,系統(tǒng)內部內置5個側欄,分別可以使用{template:sidebar}
、{template:sidebar2}
、{template:sidebar3}
、{template:sidebar4}
、{template:sidebar5}
來直接調用。
如果需要單獨調用某一模塊內容,請使用以下代碼調用:
{module:moduleName}
系統(tǒng)內置模塊調用如下:
標簽 | 含義 | 備注 |
---|---|---|
{module:navbar} | 導航欄 | |
{module:calendar} | 日歷 | 系統(tǒng)自動更新 |
{module:controlpanel} | 控制面板 | |
{module:catalog} | 網站分類 | 系統(tǒng)自動更新 |
{module:searchpanel} | 搜索 | |
{module:comments} | 最新留言 | 系統(tǒng)自動更新 |
{module:archives} | 文章歸檔 | 系統(tǒng)自動更新 |
{module:statistics} | 站點信息 | 系統(tǒng)自動更新 |
{module:favorite} | 網站收藏 | |
{module:link} | 友情鏈接 | |
{module:misc} | 圖標匯集 | |
{module:authors} | 作者列表 | 系統(tǒng)自動更新 |
{module:previous} | 最近發(fā)表 | 系統(tǒng)自動更新 |
{module:tags} | Tags列表 | 系統(tǒng)自動更新 |
如果需要控制每個模塊的具體輸出內容或者單獨調用某模塊屬性,調用標簽如下:
標簽 | 含義 | 備注 |
---|---|---|
{$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類型模塊顯示的最大列數(shù) | 默認為10。該數(shù)值不會影響存儲,只會限制前端顯示條數(shù) |
{$modules['moduleFileName'].Source} | 模塊屬性 | system=系統(tǒng)模塊,theme=主題模塊,plugin=插件模塊 |
{$modules['moduleFileName'].IsHideTitle} | 是否隱藏標題 | 1表示隱藏,0表示不隱藏,默認不隱藏 |
moduleFileName
就是模塊的文件名
Tag標簽
{$tag}
標簽 | 含義 | 備注 |
---|---|---|
{$tag.Name} | 標簽名 | |
{$tag.Url} | 標簽鏈接 | |
{$tag.Count} | 標簽下文章數(shù) |
時間標簽
在模板中獲取時間如{$article.Time(XXX)}
、{$comment.Time(XXX)}
等處XXX代表從時間戳標準格式符,使用效果等同于PHP原生函數(shù)
date ( $format )
格式符支持PHP原生函數(shù)中所有格式符。
常見時間格式代碼如下:
標簽 | 示例 | 備注 |
---|---|---|
{$article.Time('Y年m月d日')} | 2014年01月01日 | |
{$article.Time('Y年m月d日 H:i:s')} | 2014年01月01日 01:02:03 | 有前導零 |
語言標簽
Z-BlogPHP是支持多語言的,系統(tǒng)語言包文件位于/zb_users/language,從1.4版本開始支持應用也擁有自己的語言,具體請參考LoadLanguage 語言包載入。語言包內容以數(shù)組格式存儲,根據(jù)系統(tǒng)配置或指定加載相應語言包內容。
引用系統(tǒng)語言包標簽
{$lang[msg][name]}
引用應用語言包標簽(1.4以上版本適用)
{$lang[APPID][name]}
所有可用的語言標簽請打開相應的語言包文件進行查看。
擴展標簽
Z-blogPHP幾乎所有數(shù)據(jù)表都擁有擴展元數(shù)據(jù),即Z-BlogPHP的自定義域機制Meta。Meta中數(shù)據(jù)以PHP序列化格式數(shù)據(jù)存儲,其調用標簽如
{$article.Metas.abc}
若要添加或設置meta數(shù)據(jù)請參考使用擴展元數(shù)據(jù)機制,或使用相關插件如 自定義字段插件。
以上是Z-Blog博客系統(tǒng)的官方標簽,大家在使用過程中可參考使用。