zbp的側欄模板結構分成了三層:
- sidebar 規定了側欄的最外框架
- module-xxx 規定了每個模塊內容的細節展示
- module 規定了每個模塊的外框架
側欄模板
sidebar.php 默認側欄模板,可自定義 sidebar2.php~sidebar5.php 等為第2至第5側欄模板,在這個模板文件里可定義側欄內的模塊外框架應如何顯示。
模塊模板
module.php 模塊顯示模板,可定義模塊標題等格式,模塊具體內容格式其下細節模板決定。模塊可用標簽如下:
標簽 | 含義 | 備注 |
---|---|---|
{$module.ID} | 內部ID | |
{$module.Name} | 模塊名稱 | |
{$module.FileName} | 文件名 | 文件名應是唯一的,如為主題添加模塊請以theme_主題ID_filename 命名,同理,如為插件添加模塊請以theme_插件ID_filename 命名 |
{$module.Content} | 模塊內容 | 模塊內容細節模板 |
{$module.HtmlID} | htmlID | |
{$module.Type} | 模塊類型 | ul表示列表型,div表示混雜型 |
{$module.MaxLi} | ul類型模塊顯示的最大列數 | 默認為10。該數值不會影響存儲,只會限制前端顯示條數 |
{$module.Source} | 模塊屬性 | system=系統模塊,theme=主題模塊,plugin=插件模塊 |
{$module.IsHideTitle} | 是否隱藏標題 | 1表示隱藏,0表示不隱藏,默認為0 |
模塊內容細節模板
系統模塊內容展示自1.5版本開始部分支持模板化,通過這個功能可以細化模塊內容如網站統計信息要顯示具體哪一條等。你可以在 保留模板 中查看默認模板代碼作為參考。
各模板文件名及可用標簽數據如下:
導航欄
module-navbar.php
標簽 | 含義 |
---|---|
{$content} | 導航數據未改動,直接返回導航模塊內容 |
站點信息
module-statistics.php
可用數據 | 數據類型 | 可用參數 | 含義 |
---|---|---|---|
$allinfo | 網站統計信息二維數組 | all_artiles | 文章總數 |
all_pages | 頁面總數 | ||
all_categorys | 分類總數 | ||
all_tags | 標簽總數 | ||
all_comments | 評論總數 | ||
all_views | 瀏覽總數 |
文章歸檔
module-archives.php
可用數據 | 數據類型 | 可用參數 | 含義 |
---|---|---|---|
$urls | url對象數組 | Url | 鏈接 |
Name | 歸檔名份名 | ||
Count | 文章數量 |
日歷
module-calendar.php
標簽 | 含義 | 備注 |
---|---|---|
{$prevMonthUrl} | 上個月鏈接 | |
{$nowMonthUrl} | 當前月鏈接 | |
{$nextMonthUrl} | 下個月鏈接 | |
{$nowYear} | 當前年份 | |
{$nowMonth} | 當前月份 |
可用數據 | 數據類型 | 可用參數 | 含義 |
---|---|---|---|
$date | 指定日期對象 | PHP手冊中Date章節 | 指日期歸檔頁面的歸檔月份 |
$arraydate | 當月中含有文章的日期數組列表 | Url | 文章鏈接 |
Date | 日期 | ||
Count | 文章數量 |
網站分類
module-catalog.php
可用數據 | 數據類型 | 可用參數 | 含義 |
---|---|---|---|
$maxLi | 數值 | 最大行數 | |
$style | 數值 | 0表示普通列表,1表示樹型,2表示UL嵌套型 | |
$catalogs | 分類對象列表 | 分類標簽 |
最新留言
module-comments.php
可用數據 | 數據類型 | 可用參數 | 含義 |
---|---|---|---|
$comments | 最近評論對象列表 | 評論標簽 |
作者列表
module-authors.php
可用數據 | 數據類型 | 可用參數 | 含義 |
---|---|---|---|
$authors | 用戶對象列表 | 用戶標簽 |
最近發表
module-previous.php
可用數據 | 數據類型 | 可用參數 | 含義 |
---|---|---|---|
$articles | 最近發表文章對象列表 | 文章標簽_含獨立頁面 |
標簽列表
module-tags.php
可用數據 | 數據類型 | 可用參數 | 含義 |
---|---|---|---|
$tags | tag標簽對象列表 | tag標簽 |