南通SEO,南通网络营销顾问任伟SEO博客

首页> 网站建设> Z-blog > Z-BlogPHP 模板文件与模板标签
1485Views

Z-BlogPHP 模板文件与模板标签

作者: 发布于 0 条评论 字体大小[]

Z-blogPHP 主题 目录下 template 文件夹是专门放置模板文件的。compile文件夹是存放经过程序编译的模板文件,请尽量不要去修改。

如果改动了模板文件,则需要重新编译模板才能看到改动效果。你可以在后台首页找到[清空缓存并重新编译模板]或重新激活主题刷新编译模板文件。

模板文件组成

以下为常用模板文件,对于Z-BlogPHP来说模板文件并不是必须的,你可以利用 保留模板 节省开发精力。

首页与列表页相关模板

  1. index.php 首页及列表页主模板文件
  2. post-multi.php 摘要文章模板
  3. post-istop.php 置顶文章模板
  4. pagebar.php 分页条展示模板

模板结构图示

日志页相关模板

  1. single.php 文章页(单页)主模板文件
  2. post-single.php 日志页文章模板
  3. comment.php 评论区模板
  4. comments.php 每条评论内容显示模板
  5. commentpost.php 评论发送表单模板

其它模板文件

  1. header.php 公共头部文件
  2. footer.php 公共页面尾部文件
  3. module.php 模块显示模板
  4. 404.php 文章或页面等不存在时显示模板

模版标签库及相关说明

 

 

Z-BlogPHP模版标签调用方式为{$类名.(二级类名.)类属性},如

 

  1. {$article.Title}:
    • 显示文章标题的标签。这里article为文章类,Title为文章类属性。
  2. {$article.Category.Name}:
    • 显示文章的分类名称。这里article为文章类名,而Category则为二级类,Name为类属性。

 

 

 

系统标签

标签含义备注
{$host}博客网址
{$name}博客标题
{$subname}博客副标题
{$theme}主题名称
{$style}样式名称
{$copyright}版权说明
{$zblogphphtml}当前Z-BlogPHP版本号(长)<a href=“http://www.rainbowsoft.org/” title=“RainbowSoft Z-BlogPHP” target=“_blank”>Z-BlogPHP 1.1 Taichi Build 131221</a>
{$zblogphpabbrhtml}Z-BlogPHP 带链接 无版本号(短)<a href=“http://www.zblogcn.com/” title=“RainbowSoft Z-BlogPHP” target=“_blank”>Z-BlogPHP</a>
{$zblogphp}当前Z-BlogPHP版本Z-BlogPHP 1.X XXXXX Build xxxxxx
{$language}网站语言zh-CN
{$header}页面头部变量方便插件插入CSS、JS等脚本或其它META信息,请放在html的</head>标签前
{$footer}页面尾部变量方便插件插入JS脚本或其它信息,请放在页面尾部</body>标签前
{$type}页面类型页面分为index、category、article、page、author、date、tag。请参考页面判断
{$page}当前页面页码适用列表页。文章页等默认为1

分类标签

在摘要或文章等子模板页面中调用需在标签前加“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.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.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.Name}用户名
{$author.Alias}用户别名
{$author.StaticName}用户静态名存在别名时调用别名,不存在则调用用户名
{$author.Level}用户级别
{$author.Email}用户邮箱
{$author.HomePage}用户主页
{$author.Intro}用户摘要
{$author.Avatar}用户头像
{$author.Articles}用户发帖文章数
{$author.Url}用户页面链接

模块标签

一般情况下主题应尽可能使用系统内部的模块管理功能来调用侧栏模块,系统内部内置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就是模块的文件名

Tag标签

{$tag}

标签含义备注
{$tag.Name}标签名
{$tag.Url}标签链接

时间标签

在模板中获取时间如{$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,以数组格式存储。默认有简体中文与繁体中文两种,在后台网站设置中可更改。在模板中引用语言标签格式如下

{$lang[msg][name]}

所有可用的语言标签请打开相应的语言包文件进行查看。

扩展标签

Z-blogPHP几乎所有数据表都拥有扩展元数据,即Z-BlogPHP的自定义域机制Meta。Meta中数据以PHP序列化格式数据存储,其调用标签如

{$article.Metas.abc}

若要添加或设置meta数据请参考使用扩展元数据机制,或使用相关插件如 自定义字段插件

1) 置顶文章会自动显示于首页及列表页中,无须标签调用

 

分享来源: 任伟SEO博客 转载请注明出处!(QQ交流:547701130/微信:renweiseo/微信公众号:renwei_seo)
原文地址:http://www.renweiseo.com/z-blog/view/1153.html
发布于 2016-05-23 14:45:44 已有0人评论 任伟 作者保留权利

发表评论

必填

选填

选填

必填

已有0人参与,欢迎参与讨论,请在这里发表您的看法、交流您的观点。

亲!看完有什么想法呢?
  • 流泪

    0

  • 打酱油

    0

  • 开心

    1

  • 鼓掌

    0

  • 恐怖

    0

作者介绍

  • 任伟
  • • 主页:
    • 文章:
    • 邮箱:

    命是弱者的借口,运是强者的谦辞。

    控制面板

    您好,欢迎到访网站!
      查看权限
    «   2018年11月   »
    1234
    567891011
    12131415161718
    19202122232425
    2627282930

    猜你喜欢

    最近发表