有关Bo-blog模板制作(二)
第五部分 elements.php文件
下面解释elements.php文件的作用和内容。
这个文件里定义了各个部分的html表现代码。之所以设立这样一个文件,是为了满足在仅仅修改css无法达到布局更改时的需求。
这个文件的内容就是一些赋值语句。形式为 $elements[ElementName]=ElementHtmlCode; 。
Element的名称和含意对照如下:
$elements[\'header\'] 文件开始
$elements[\'displayheader\'] 顶部
$elements[\'mainpage\'] 日志页面
$elements[\'otherpage\'] 其它页面
$elements[\'displayside\'] 侧边栏
$elements[\'displayfooter\'] 底部
$elements[\'footer\'] 文件结束
$elements[\'msgbox\'] 出错/成功信息提示框
$elements[\'sideblock\'] 侧栏项目
$elements[\'excerpt\'] 摘要
$elements[\'excerptontop\'] 置顶的摘要
$elements[\'viewentry\'] 查看日志
$elements[\'listbody\'] 日志列表
$elements[\'list\'] 日志列表单行
$elements[\'comment\'] 评论
$elements[\'trackback\'] 引用
$elements[\'form_reply\'] 评论发表框
$elements[\'endviewentry\'] 查看日志的补充
$elements[\'entryadditional\'] “查看更多”区域
$elements[\'login\'] 登入表单
$elements[\'contentpage\'] 内容页
$elements[\'taglist\'] tags
$elements[\'register\'] 注册表单
$elements[\'normaltable\'] 一般表格
$elements[\'normaltablewithtitle\'] 一般表格(带有表格标题)
$elements[\'form_eachline\'] 表格一行
$elements[\'eachlink\'] 链接页(单项)
$elements[\'linkdiv\'] 链接页(组)
$elements[\'tips\'] 提示信息的页面
1. 被替换标签以 {开头,以}结束,在模板解析时会被替换为实际的内容。例如,星标的标签为
由于这里的标签很多,时间有限暂不一一讲解,大部分标签都是可以顾名思义的,在制作模板时可以边测试边修改。
2. 不同侧边栏项目的区块可以分别定义。
例如,$elements[\'sideblock_categories\'] 可定义名为 categories 的项目(即分类项目)的html。
形式为 sideblock_itemname 。当一个item显示时,如果有 $elements[\'sideblock_item\'] ,则优先使用此处的定义,否则使用默认($elements[\'sideblock\'])。
第六部分 标签
用{}包含起来的是“标签”,标签可以被解释成具体的html内容。其意义如下:
注1: 标有*号的是2.0.3起新增的标签。
注2: 各个标签在其规定的区域内可直接使用,例如在 $elements[\'header\'] 区域中,{blogkeywords}可直接输出blog关键词。但这些标签不是全局性的,当在 $elements[\'displayheader\'] 中引用时,不会被解释。在Bo-blog 2.0.3以前的版本中,您无法跨区域使用标签,但 2.0.3 版本起,程序提供了一个跨区域引用标签的方法。要使用非本区域中定义的标签,请使用 。例如,在本例中,书写 即可输出blog关键词。
1. $elements[\'header\'] 文件开始
*language – 网页使用的语言代码,如zh-cn(简体中文)、en(英语)
blogdesc – blog描述语
blogkeywords – blog关键词
baseurl – 设置
blogname – blog名
csslocation – CSS载入代码
pagetitle – 当前页面标题,如“留言本”
ajax_js – 载入Ajax所需js代码
extraheader – 载入header区域额外代码
2. $elements[\'displayheader\'] 顶部
blogname – blog名
blogdesc – blog描述语
section_head_components – 顶部导航内容(如首页、链接、Tags等),生成的是一组列表(
)
3. $elements[\'mainpage\'] 日志页面
ifannouncement – 顶部公告显隐状态(block/none)
topannounce – 顶部公告内容
iftoppage – 顶部分页条显隐状态(block/none)
ifbottompage – 底部分页条显隐状态(block/none)
mainpart – 页面整体内容,由具体的分页面生成
pagebar – 分页条完整内容 (包含当前页面指示、分页选择、上下页选择)
*currentpage – 当前处于第几页
*previouspageurl – 上一页的链接地址
*nextpageurl – 下一页的链接地址
*turningpages – 翻页部分
*totalpages – 总共有几页
4. $elements[\'otherpage\'] 其它页面
mainpart – 页面整体内容,由具体的分页面生成
5. $elements[\'displayside\'] 侧边栏
section_side_components – 侧边栏总内容
*siderbarcounter – 总共显示了几个侧边栏项目
6. $elements[\'displayfooter\'] 底部
mainpart – 底部内容,由程序根据底部模块配置生成
7. $elements[\'footer\'] 文件结束
此部分无任何标签
8. $elements[\'msgbox\'] 出错/成功信息提示框 (废弃)
message – 提示框内显示的信息
9. $elements[\'sideblock\'] 单一侧栏项目
id – 该侧边栏项目的识别名
title – 侧边栏项目的标题
ifextend – 是否展开(block/none)
content – 侧边栏内容
10. $elements[\'excerpt\'] 普通的摘要
entrystar – 星标
entrytitle – 带链接的日志标题
*baseurl – 不带链接的日志标题
*entryrelurl – 日志链接URL(相对链接)
*entryabsurl – 日志链接URL(绝对链接)
entryicon – 天气
entrydate – 完整的日志发布日期 (年/月/日)
*entrydatey – 日志发布日期之‘年’
*entrydatem – 日志发布日期之‘月’
*entrydated – 日志发布日期之‘日’
entrytime – 日志发布时刻
entryauthor – 日志发布者
entrycontent – 日志内容
iftags – 有无设置tags(block/none)
tags – “Tags”
alltags – 本文的tags
entrycateicon – 所属分类的分类图标
entrycate – 分类名
entrycomment – “评论”(评论数)
*entrycommentnum – 单纯的评论数
entrytb – “引用”(引用数)
*entrytbnum – 单纯的引用数
entryviews – “阅读”(阅读次数)
*entryviewsnum – 单纯的阅读次数
ifadmin – 管理的链接
tbbar – 引用传输的地址显示区域(带地址)
*entrytburl – 引用传输的URL
adminbar – 管理栏
topid – 置顶日志的唯一id
previous – 上一篇日志的链接和标题
next – 下一篇日志的链接和标题
ifedited – 本文最后编辑时间和编辑者(仅打开相关选项时有效)
11. $elements[\'excerptontop\'] 置顶的摘要
此部分支持标签与 $elements[\'excerpt\'] 完全一致
12. $elements[\'viewentry\'] 查看日志
此部分支持标签与 $elements[\'excerpt\'] 完全一致
13. $elements[\'list\'] 日志列表单行
此部分支持标签与 $elements[\'excerpt\'] 完全一致
14. $elements[\'listbody\'] 日志列表
listbody – 列表具体内容
15. $elements[\'comment\'] 评论
replier – 评论人
replieremail – 评论者的email
replierhomepage – 评论者的主页地址
replierip – 评论者的ip
replytime – 评论时间
addadminreply – 添加、修改管理员回复的链接
deladminreply – 移除管理员回复的链接
delreply – 移除此评论的链接
replycontent – 评论内容
ifadminreplied – 管理员是否回复过(block/none)
commentid – 管理员回复id
adminrepliershow – 管理员回复的回复者名字、时间
adminreplycontent – 管理员回复的内容
commentid – 此评论的唯一id
adminreplybody – 管理员评论输入框
16. $elements[\'trackback\'] 引用
tbtitle – 引用的标题
tbtime – 引用传送时间
delreply – 删除此引用
tburl – 引用来源URL
tbblogname – 引用来源日志名
tbcontent – 引用内容
17. $elements[\'form_reply\'] 评论发表框
jobnow – 当前表单动作
formtitle – 表单标题
emots – 表情框
disable_html – html可用状态
disable_ubb – ubb可用状态
disable_emot – 表情可用状态
if_neednopsw_begin – 是否显示密码输入框()
additional – 额外js
ubbcode – UBB工具条
if_securitycode_begin – 是否显示验证码()
hidden_areas – 表单隐藏数据
18. $elements[\'endviewentry\'] 查看日志的补充
innerpages – 该日志的内部分页
form_reply – 该日志的评论区域
19. $elements[\'entryadditional\'] “查看更多”区域
readmore – “查看更多”
20. $elements[\'login\'] 登入表单 (2.0.3废弃)
lvstart – 是否显示验证码()
rand – 随机数,只起到强制浏览器更新验证码的作用,非验证码本身
21. $elements[\'contentpage\'] 内容页
title – 该页标题
contentbody – 该页内容
22. $elements[\'taglist\'] tags
tagcategory – tag页的标题
tagcontent – tag页的内容
tagextra – tag页的额外说明
23. $elements[\'register\'] 注册表单 (2.0.3的登入表单合并入此)
job – 当前表单动作
title – 当前表单标题
registerbody – 表单整体内容
24. $elements[\'normaltable\'] 一般表格
tablebody – 表格内容
25. $elements[\'normaltablewithtitle\'] 带有标题的一般表格
title – 标题
tablebody – 表格内容
26. $elements[\'form_eachline\'] 表格一行
text – 副标题列
formelement – 内容列
27. $elements[\'eachlink\'] 链接页(单项)
logo – 链接logo
title – 链接网站名
desc – 链接描述
28. $elements[\'linkdiv\'] 链接页(组)
title – 链接组名
tablebody – 链接组内容
29. $elements[\'tips\'] 提示信息的页面
*language – 网页使用的语言代码,如zh-cn(简体中文)、en(英语)
blogdesc – blog描述语
blogname – blog名
csslocation – CSS载入代码
title – 信息框标题
tips – 信息主体内容
admin_plus – 管理员特有的链接
(END)