zblog各个文件以及文件夹详细说明+zblog安装教程

安装：

安装文件包安装

在线安装程序

安装

我们一般提供以下两种安装方式：

使用安装文件包，将安装包上传FTP空间安装，缺点上传文件较多可能较为耗时。

在线安装，可以上传在线安装程序远程下载数据包进行安装，优点是速度较快，不过某些服务器可能无法支持。

注意，安装前应确保文件目录为777权限（可在安装后再修改具体目录权限）！

安装文件包安装

上传Z-BlogPHP程序到网站目录

打开你的网站（如：http://xxx/），进入安装界面

建立数据库

若选择MySQL数据库，请输入空间商为您提供的MySQL帐号密码等信息

若选择SQLite，请确保服务器支持SQLite，安装程序将在点击下一步后自动创建SQLite数据库文件

填写你为站点设置的管理员账号密码，务必使用强口令账号

点击下一步，安装成功，进入网站

在线安装程序

上传在线安装程序install.php到你的空间。

在浏览器里打开你的网站/install.php。

点击“安装”按钮后，程序会自动从远程服务器里下载安装包并解压到空间里。

接下去的安装过程与安装包安装相同，不再说明。

注意：空间的权限必须设置符合程序要求，可以让install.php有权限创建目录和文件，不然将无法远程安

查看更新记录

系统要求和安装

系统要求

Web Server: IIS / Apache / nginx / Lighttpd / Kangle / Tengine / Caddy and so on…

PHP Version: 5.2 ~ 7.x / HHVM 3

DB: MariaDB(MySQL) / SQLite / PostgreSQL

文件结构

zb_install 安装文件夹

zb_system 系统文件夹

admin 管理

css 后台CSS

defend 系统保留文档

function 系统核心

image 系统图片

script 系统脚本

xml-rpc xml-rpc组件

zb_users 用户文件夹

avatar 头像缓存

cache 缓存

data 数据库

emotion 表情图片

include 引用文件

language 语言

plugin 插件

theme 主题

upload 上传

index.php 主页

search.php 搜索面

feed.php rss页

模板文件组成

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

公共模板

header.php 公共头部文件

footer.php 公共尾部文件

首页与列表页相关模板

index.php 首页及列表页主模板文件

post-multi.php 摘要文章模板

post-istop.php 置顶文章模板1)

pagebar.php 分页条展示模板

模板结构图示

日志页相关模板

single.php 文章页(单页)主模板文件

post-single.php 日志页文章模板

comment.php 评论区模板

comments.php 每条评论内容显示模板

commentpost.php 评论发送表单模板

其它模板文件

404.php 文章或页面等不存在时显示模板

module.php 模块通用显示模板

module-xxx.php 侧栏及模块模板标签(1.5)

系统标签

标签含义备注

{$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-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>

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

分类标签

在摘要或文章等子模板页面中调用需在标签前加“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序列化字符串)更多请参考扩展标签

分页标签

文章列表相关页面中可用分页标签，如首页等。

标签含义备注

{$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.FirstImg}文章第一张图片该图为文章中的第一张图片

{$article.Thumb}文章第一张图片的缩略图该图为文章中第一张图片的缩略图，生成的缩略图尺寸请到后台【网站设置】【全局设置】中配置

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

评论标签

在文章页面中显示评论需先格式化评论数据：

{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)}评论发布时间

用户标签

当前登录用户信息使用$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: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}标签链接

{$tag.Count}标签下文章数

时间标签

在模板中获取时间如{$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，从1.4版本开始支持应用也拥有自己的语言，具体请参考LoadLanguage 语言包载入。语言包内容以数组格式存储，根据系统配置或指定加载相应语言包内容。

引用系统语言包标签

{$lang[msg][name]}

引用应用语言包标签（1.4以上版本适用）

{$lang[APPID][name]}

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

扩展标签

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

{$article.Metas.abc}

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

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

Z-BlogPHP 保留模板

保留模板机制是Z-Blog ASP就有的一个主题模板特性，它允许主题的模板目录只放置少量的个性化模板文件，甚至完全放空专注于样式实现都可以。

运行机制

调用时逐一判断某一模板文件是否存在于主题中，如存在，则调用主题自定义模板文件，否则调用保留模板。

:!:注意：请不要删除保留模板文件，也不推荐对保留模板进行修改！

文件位置

默认的保留模板文件位于：zb_system\DEFEND\default。

页面公共模板文件

模板文件说明

header.php公共头部文件

footer.php公共尾部文件

首页与列表页相关模板

模板文件说明

index.php首页及列表页主模板文件

post-multi.php摘要文章模板

post-istop.php置顶文章模板

pagebar.php页码模板

日志/独立页相关模板

模板文件说明

single.php文章页(单页)主模板文件

post-single.php日志页文章模板

post-page.php独立页面模板

comment.php评论区模板

comments.php每条评论内容显示模板

commentpost.php评论发送表单模板

commentpost-verify.php评论验证码模板（1.5新增）

侧栏模块相关模板

1、模块展现外框架模板

模板文件说明

sidebar.php默认侧栏模板，可自定义 sidebar2.php~sidebar5.php 等为第2至第5侧栏模板

module.php模块显示模板，可定义模块标题等格式，模块具体内容格式由下列细节模板决定

2、模块内容细节模板（1.5版本及以上）

模板文件说明备注（默认列表行数）

module-archives.php文章归档模块没有限制

module-authors.php作者列表模块没有限制

module-calendar.php日历模块没有限制

module-catalog.php分类列表模块没有限制

module-navbar.php导航条模块没有限制

module-statistics.php站点信息模块没有限制

module-comments.php最近评论列表模块10条

module-previous.php最近文章列表模块10条

module-tags.php标签列表模块25条

本文主要详细说下zblog的各个文件夹的作用，方便大家有自定义修改需求的时候可以快速找到对应的文件。

zblog程序安装完成后就只有三个文件夹，名称和作用分别为：

zb_system：zblog核心文件夹，里面放的是zblog核心程序代码和zblog后台文件，如果没有特殊需求请切记不要改动这个文件夹和文件夹里面的文件。

zb_users：这个文件夹里面的东西很多，主题、插件、图片、缓存什么的都是放在这个文件夹里面的，下面会详细说明。

zb_install：这个文件夹是放zblog安装文件的，程序安装完成后切记删除这个文件夹，不然无聊的人可以把你的程序重新安装一遍然后搞得你怀疑人生。

接下来要详细介绍下“zb_users”，我们在使用zblog的过程中一般都是跟这个文件夹打交道。“zb_users”里面的文件夹名称和作用分别如下：

avatar：放默认头像的，如果你和你网站的评论者没有绑定“Gravata”头像，那么就会调用这个文件夹里面的默认头像；

cache：放缓存文件的，主题编译后的文件就放在这个文件夹里面，所以这个文件夹里面的东西没有修改的必要。

data：放数据库的，如果你的数据库选择的是-SQLite，那么数据库文件就会存放在这个文件夹里面，如果你的数据库是mysql，那么这个文件夹就不用管了；

emotion：放表情包图片的，真是个中二的文件夹...

language：放语言包的，zblog现在支持英文、中文简体和中文繁体三种语言；

logs：放日志文件的；

plugin：zblog插件安装目录，你安装的插件都会在这个文件夹里面。（补充说明：有的时候插件冲突造成的后台打不开，那么就可以ftp连接打开这个文件夹找到对应的插件文件夹删除即可）

theme：zblog主题安装目录，你安装的zblog主题都会在这个文件夹里面，也是我们需要修改最多的文件夹了；

upload：放附件的，你上传的图片和其他一些文件都在这个文件夹里面，按照上传日期分类管理的，还是很方便查找的。

以上就是zblog各个文件的作用说明，当然仅供参考，如有错漏欢迎指出。