====== 侧栏及模块模板标签 ====== zbp的侧栏模板结构分成了三层: * sidebar 规定了侧栏的最外框架 * module 规定了每个模块的外框架 * module-xxx 规定了每个模块内容的细节展示 ===== 侧栏模板 ===== 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} |模块内容 | [[.:moduletemplate#模块内容细节模板]] | |{$module.HtmlID} |htmlID | | |{$module.Type} |模块类型 | ul表示列表型,div表示混杂型 | |{$module.MaxLi} |ul类型模块显示的最大列数 | 默认为10。该数值不会影响存储,只会限制前端显示条数 | |{$module.Source} |模块属性 | system=系统模块,theme=主题模块,plugin=插件模块 | |{$module.IsHideTitle} |是否隐藏标题 | 1表示隐藏,0表示不隐藏,默认为0 | ===== 模块内容细节模板 ===== 系统模块内容展示自1.5版本开始部分支持模板化,通过这个功能可以细化模块内容如网站统计信息要显示具体哪一条等。你可以在 **[[zblogphp:development:theme:defend_default|保留模板]]** 中查看默认模板代码作为参考。 各模板文件名及可用标签数据如下: ==== 导航栏 ==== 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 | 指定日期对象 | [[http://cn2.php.net/manual/zh/function.date.php|PHP手册中Date章节]] | 指日期归档页面的归档月份 | |$arraydate | 当月中含有文章的日期数组列表 |Url | 文章链接 | | ::: | :::|Date | 日期 | | ::: | :::|Count | 文章数量 | ==== 网站分类 ==== module-catalog.php ^ 可用数据 ^ 数据类型 ^ 可用参数 ^ 含义 ^ |$maxLi | 数值 | |最大行数 | |$style | 数值 | |0表示普通列表,1表示树型,2表示UL嵌套型 | |$catalogs | 分类对象列表 | [[zblogphp:development:theme:template#分类标签]]| | ==== 最新留言 ==== module-comments.php ^ 可用数据 ^ 数据类型 ^ 可用参数 ^ 含义 ^ |$comments | 最近评论对象列表 |[[zblogphp:development:theme:template#评论标签]]| | ==== 作者列表 ==== module-authors.php ^ 可用数据 ^ 数据类型 ^ 可用参数 ^ 含义 ^ |$authors | 用户对象列表 | [[zblogphp:development:theme:template#用户标签]] | | ==== 最近发表 ==== module-previous.php ^ 可用数据 ^ 数据类型 ^ 可用参数 ^ 含义 ^ |$articles | 最近发表文章对象列表 |[[zblogphp:development:theme:template#文章标签_含独立页面]] | | ==== 标签列表 ==== module-tags.php ^ 可用数据 ^ 数据类型 ^ 可用参数 ^ 含义 ^ |$tags | tag标签对象列表 | [[zblogphp:development:theme:template#tag标签]] | |