Z-blog模版制作标签
发布在:网站学习 评论: 2 条评论

Z-blog模版制作标签

发表于:2019-03-29 10:52:49      发布在:网站学习      评论:2 条评论

主题 目录下 template 文件夹是专门放置模板文件的。

模板文件组成

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

公共模板

  1. header.php 公共头部文件

  2. footer.php 公共尾部文件

首页与列表页相关模板

  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. Z-BlogPHP模版标签调用方式为{$类名.(二级类名.)类属性}


系统标签:

标签含义备注
{$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}网站目录物理路径注意:该路径应仅用于文件读取操作,不应直接输出造成安全隐患

分类标签

含义备注
{$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序列化字符串)更多请参考扩展标签

分页标签

标签含义备注
{$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为普通页面。其它类型还在设计中。

评论标签

文章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.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: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}标签链接
{$tag.Count}标签下文章数

时间标签

标签示例备注
{$article.Time('Y年m月d日')}2014年01月01日
{$article.Time('Y年m月d日 H:i:s')}2014年01月01日 01:02:03有前导零


文章目录:

评论
你好,访客
好东西 感谢分享
评论时间:2019-05-27 14:12:47 回复
哈哈哈,教程很详细。thanks
评论时间:2019-04-17 11:43:37 回复