主題?目錄下?template?文件夾是專門放置模板文件的。
Z-BlogPHP 1.5之前的版本,在主題目錄下會有一個compile文件夾,這里存放經過程序編譯后的模板文件,請不要去修改。
如果改動了模板文件,則需要重新編譯模板才能看到改動效果。你可以在后臺首頁找到[清空緩存并重新編譯模板]或重新激活主題刷新編譯模板文件。
以下為常用模板文件,對于Z-BlogPHP來說模板文件并不是必須的,你可以利用?Z-BlogPHP 保留模板?節省開發精力。
Z-BlogPHP模版標簽調用方式為{$類名.(二級類名.)類屬性},如
標簽 | 含義 | 備注 |
---|---|---|
{$host} | 博客網址 | |
{$name} | 博客標題 | |
{$subname} | 博客副標題 | |
{$theme} | 主題名稱 | |
{$style} | 樣式名稱 | |
{$copyright} | 版權說明 | |
{$zblogphp} | 當前Z-BlogPHP版本 | Z-BlogPHP 1.X XXXXX Build xxxxxx |
{$zblogphphtml} | 當前Z-BlogPHP版本號(長) | <a RainbowSoft Z-BlogPHP"?target="_blank">Z-BlogPHP1.1?Taichi Build?131221</a> |
{$zblogphpabbrhtml} | Z-BlogPHP 帶鏈接 無版本號(短) | <a 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}">{$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表示列表型,p表示混雜型 |
{$modules['moduleFileName'].MaxLi} | ul類型模塊顯示的最大列數 | 默認為10。該數值不會影響存儲,只會限制前端顯示條數 |
{$modules['moduleFileName'].Source} | 模塊屬性 | system=系統模塊,theme=主題模塊,plugin=插件模塊 |
{$modules['moduleFileName'].IsHideTitle} | 是否隱藏標題 | 1表示隱藏,0表示不隱藏,默認不隱藏 |
moduleFileName
就是模塊的文件名
從1.5模板開始,支持系統模塊模板化,請參考側欄模塊相關模板?及?側欄及模塊模板標簽。
{$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 | 有前導零 |
詳細格式符用法請查看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數據請參考使用擴展元數據機制,或使用相關插件如?自定義字段插件。
置頂文章會自動顯示于首頁及列表頁中,無須標簽調用。
本文由 貴州做網站公司 整理發布,部分圖文來源于互聯網,如有侵權,請聯系我們刪除,謝謝!
網絡推廣與網站優化公司(網絡優化與推廣專家)作為數字營銷領域的核心服務提供方,其價值在于通過技術手段與策略規劃幫助企業提升線上曝光度、用戶轉化率及品牌影響力。這...
在當今數字化時代,公司網站已成為企業展示形象、傳遞信息和開展業務的重要平臺。然而,對于許多公司來說,網站建設的價格是一個關鍵考量因素。本文將圍繞“公司網站建設價...
在當今的數字化時代,企業網站已成為企業展示形象、吸引客戶和開展業務的重要平臺。然而,對于許多中小企業來說,高昂的網站建設費用可能會成為其發展的瓶頸。幸運的是,隨...
手機按鈕失靈了什么原因?1.手機因后臺程序太多而卡死。大家都知道Android后臺進程太多,占用內存很大。這時候手機會卡死,導致按鍵不靈敏。很多人以為是按鈕壞了,其實是系統卡住了。解決方法:清空手機中APP的緩存,關閉不必要的程序,釋放更多存儲空間。2.灰塵進入電源鍵和音量鍵之間的縫隙?;覊m經常進入手機的USB接口。雖然電源鍵和音量鍵的縫隙很小,但是久而久之也會進入很多灰塵。而且從表面看不出灰塵會...
152是哪里的號碼 152號碼在哪里?152開頭是移動還是聯通? 152是江西省九江市彭澤縣的號碼彭澤縣,新建商品房近1000套釣魚臺社區和淵明湖社區,成為縣城兩個模式住宅區;風景宜人的淵明湖公園和街道花園成為縣城兩大休閑亮點;朝陽公寓、新區農貿市場、河邊廣場的建成,形成了集工、貿、居、娛為一體的格局。 152號在哪里? 樂山銀行號。樂山市商業銀行是在原樂山市城市信用社的基礎上成立并逐步發...
怎么制作橙光徽章?如果沒有你會PS,是可以自己可以制作。如果不是你不會,也可以找美工幫你。做了后,再在后臺作品那里上傳就可以。ps制作徽章教程?1、先打開PS,按CTRLN創建一個新的文件,中,選擇“橢圓形工具”(U),畫一個圓形。將圓形填充上隨便什么顏色,后面將被圖層樣式覆蓋;這種徽章的磨砂底效果在CDR里面怎么做出來?這種磨砂是金屬本身的質感,如果在cdr里面做沒有辦法色塊制做,可以不通過底紋...