letou

Z-BlogPHP 模板文件與模板標簽

大寶 1479 0

主題 目錄下 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 置頂文章模板1)
  4. pagebar.php 分頁條展示模板

Z-BlogPHP 模板文件與模板標簽-第1張圖片-萊蕪網站制作中心

日志頁相關模板

  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)

模版標簽庫及相關說明



Z-BlogPHP模版標簽調用方式為{$類名.(二級類名.)類屬性},如


  1. {$article.Title}:
    • 顯示文章標題的標簽。這里article為文章類,Title為文章類屬性。
  2. {$article.Category.Name}:
    • 顯示文章的分類名稱。這里article為文章類名,而Category則為二級類,Name為類屬性。




系統標簽

標簽含義備注
{$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-BlogPHP1.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為普通頁面。其它類型還在設計中。

Z-BlogPHP 模板文件與模板標簽-第2張圖片-萊蕪網站制作中心 文章Tag獲取方法

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


具體{$tag.XXX}內容參考Tag標簽Z-BlogPHP 模板文件與模板標簽-第2張圖片-萊蕪網站制作中心注意,獨立頁面沒有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就是模塊的文件名


從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日')}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) 
置頂文章會自動顯示于首頁及列表頁中,無須標簽調用


標簽: z-blog 非原創

抱歉,評論功能暫時關閉!

黑彩时时彩