pbootcms模板标签

公共标签：

1、模板文件嵌套引用

{include file=***.html}

使用说明：

可以嵌套使用，如：index.html 嵌套一个head.html，同时head.html中嵌套comm.html

支持使用子目录，如：{include file=comm/***.html}

2、时间格式化标签

style=*

如:内容列表时间格式化[list:date style=Y-m-d]、内容详情页时间格式化{content:date style=Y-m-d}

 

使用说明：

时间格式化标签和PHP时间格式化语法一致，分别用不同字母代替，中间可以穿插任意字符，如：Y-m-d、Y/m/d、Y年m月d日等等

注意：Y代表完整年份，y代表简化年份，m代表月份，d代表日，H代表小时，i代表分，s代表秒，如完整时间：style='Y-m-d H:i:s'，更多请参考PHP时间格式化语法 ，参考链接 ：http://php.net/manual/zh/function.date.php

 

3、HTML去除标签

drophtml=1

如:内容列表内容[list:content drophtml=1]、内容详情页内容{content:content drophtml=1}

 

使用说明：

一般在首页等特殊位置需要调取正文一段纯文本时使用，这时一般会配合下面的内容截取标签一起使用

 

4、内容截取标签

长度截取使用len=* 或 lencn=* ，使用第二个将避免中英文长度不统一问题，一个英文字符算半个字

(V1.3.5+)内容截取时可使用more='*'设置省略号内容，设置more=''则不显示省略号

如:内容列表标题截取[list:title len=10]

substr=x,y 截取一段

substr截取字符串长度,传递两个数字，第一个为起始位置，第二个为截取长度，如只有一个数字则截取此数字起后面全部

 

使用说明：

使用内容截取时要注意如果是html内容需要先去除html再截取，否则可能导致html错位，如：[list:content drophtml=1 len=50]

 

5、其它格式化标签

dropblank=1 ，去除空白字符，如换行符、制表符等

decode=1 解码数据html字符，如果等于0.则不解码（包括源码已经解码的）,此标签一般不使用

decimal=* 小数点位数

unit=* 容量单位，可以是kb,mb,gb,tb,pb,eb

operate=** （V2.0.4新增）数字运算（支持+-*/%），如访问量加1000[list:visits operate=+1000] 、序号求余[list:i operate=%2]

lfield="a,b" （V2.0.5新增）限制列表数据查询字段，提高大数据性能，如lfield="title,content"

mark=1 （V2.0.5新增）对搜索结果关键字进行标红，如：[search:title mark=1]；

6、自定义标签

{label:***}

 

使用说明：

在后台”全局配置>定制标签“中定义，前台使用对应名字进行调用即可

 

7、面包屑标签

{pboot:position}

 

参数说明：

separator=* 分隔符,非必填，默认为>>

separatoricon=* 分割图标,非必填，如使用图标字体：separatoricon='fa fa-angle-double-right'

indextext=* 首页文本,非必填，默认为"首页"

indexicon=* 首页图标,非必填，如使用图标字体：indexicon='fa fa-home'

 

8、当前网址

{pboot:httpurl}

 

使用说明：

自适应获取当前访问网址，主要用于需要使用网站路径前缀的情况，如输出：https://www.pbootcms.com

 

9、当前页面

{pboot:pageurl}

 

使用说明：

自适应获取当前访问页面完整地址

 

10、二维码生成标签

{pboot:qrcode string=***}

 

使用说明：

用于生成对应文本的二维码图片，可用于产品列表页或详情页为每个产品生成二维码 ：{pboot:qrcode string={pboot:httpurl}{content:link}}或{pboot:qrcode string={pboot:pageurl}

 

11、程序运行时间

{pboot:runtime@} 使用时@去掉

 

使用说明：

用于输出页面运行时间/缓存时间，使用时请将反斜杠去掉。

 

12、留言验证码开关状态

{pboot:checkcodestatus}

 

使用说明：

用于判断留言验证码是否开启状态，方便页面控制验证码图标的显示。

 

13、站点地图

http://www.xxx.com/sitemap

http://www.xxx.com/sitemap.xml

http://www.xxx.com/sitemap.txt

 

使用说明：

系统使用动态站点地图，不需要生成，访问地址即为实时地图，输出格式为xml 或 txt，当然你也可以打开后另存为一个地图文件。

使用以上地址需要已经开启伪静态，否则域名后带问号才可以访问。

 

14、图片缩放及裁剪（v1.3.5+）

图片缩放及裁剪总共四个参数：

参数：width=* height=* maxwidth=*  maxheight=*

使用方式，如：[list:ico width=100]

 

使用说明：

四个参数可以组合使用，此处会生成改变了图片大小的缓存图片，缓存图片是裁切过后的图片，但原上传的图片不变。

如果不想改变大小及裁切图片，只是想缩放显示，那么请使用CSS进行控制即可。

站点地图：

访问路径如下：

http://www.xxx.com/sitemap

http://www.xxx.com/sitemap.xml

http://www.xxx.com/sitemap.txt

 

使用说明：

系统使用动态站点地图，不需要手动生成，访问地址即为实时地图，输出格式为xml 或 txt，当然你也可以打开后另存为一个地图文件。

使用以上地址需要已经开启伪静态，否则域名后带问号才可以访问。

公司信息：

适用范围：全站任意地方均可使用

标签作用：用于调取网站与公司相关的信息，对应后台的“基础内容>公司信息”

{pboot:companyname}	公司名称
{pboot:companyaddress}	公司地址
{pboot:companypostcode}	邮政编码
{pboot:companycontact}	联系人
{pboot:companymobile}	联系手机
{pboot:companyphone}	联系电话
{pboot:companyfax}	传真号码
{pboot:companyemail}	联系邮箱
{pboot:companyqq}	QQ号码
{pboot:companyweixin}	微信图标
{pboot:companyblicense}	营业执照号
{pboot:companyother}	其它信息

 站点信息：

适用范围：全站任意地方均可使用

标签作用：用于调取网站的基本配置信息，对应后台的“基础内容>站点信息”

                           

{pboot:siteindex}	站点入口地址，一般用于站内链接跳转设置地址前置，实现自适应URL模式
{pboot:sitepath}	站点路径,根目录时值为空，为适应部署到二级目录时建议链接前面带上
{pboot:sitelanguage}	站点语言
{pboot:sitetitle}	站点标题
{pboot:sitesubtitle}	站点副标题
{pboot:sitedomain}	站点域名
{pboot:sitelogo}	站点logo
{pboot:sitekeywords}	站点关键字
{pboot:sitedescription}	站点描述
{pboot:siteicp}	站点备案信息
{pboot:sitetplpath}	站点模板路径
{pboot:sitestatistical}	站点统计
{pboot:sitecopyright}	站点版权

               

V1.1.6+新增如下标签，推荐使用

{pboot:pagetitle}  根据不同页面自动显示标题

{pboot:pagekeywords} 根据不同页面自动显示关键字

{pboot:pagedescription}  根据不同页面自动显示描述

导航菜单列表：

适用范围：全站任意地方均可使用

标签作用：用于调导航菜单栏目列表，对应后台的“基础内容>内容栏目”

1、导航菜单列表

{pboot:nav}

<a href="[nav:link]">[nav:name]</a>

{/pboot:nav}

控制参数：

num=* 数量，非必填，用于控制输出的数量

parent=* 父菜单编码，用于输出子栏目，默认从一级菜单开始输出，（V3.1.2+）支持传递多个编码

parent={sort:pcode} 可用于输出当前栏目的同级菜单

parent={sort:scode} 可用于输出当前栏目的子菜单

parent={sort:tcode} 可用于输出当前栏目顶级菜单的子菜单

scode=1,2,3  用于控制输出栏目范围（V3.1.2+）

要注意parent和scode的区别，一个是输出子栏目，一个控制范围

2、可使用的列表标签

[nav:n]	序号，从0开始
[nav:i]	序号，从1开始
[nav:pcode]	父栏目编码
[nav:scode]	当前栏目编码
[nav:name]	栏目名称
[nav:subname]	栏目副名称
[nav:link]	栏目链接
[nav:type]	栏目类型，1单页、2列表
[nav:outlink]	后台设置的跳转链接
[nav:listtpl]	列表页模板
[nav:contenttpl]	详情页模板
[nav:ico]	栏目缩略图
[nav:pic]	栏目大图
[nav:keywords]	栏目关键字
[nav:description]	栏目描述
[nav:soncount]	当前栏目子栏目的数量，无子栏目时为0
[nav:rows]	输出栏目下内容数量（V1.3+）
[nav:def1]	栏目描述1（V3.0.6+）
[nav:def2]	栏目描述2（V3.0.6+）
[nav:def3]	栏目描述3（V3.0.6+）

3、常见使用示例

高亮菜单

使用判断语句：{pboot:if('[nav:scode]'=='{sort:tcode}')}class="active"{/pboot:if}

首页特殊用法：{pboot:if(0=='{sort:scode}')}class="active"{/pboot:if}

               

菜单嵌套

二级嵌套

{pboot:nav}                   

  <a href= "[nav:link]">[nav:name]</a>

  {pboot:2nav parent=[nav:scode]}

    <a href= "[2nav:link]">[2nav:name]</a>

  {/pboot:2nav}

{/pboot:nav}

三级嵌套

{pboot:nav}                   

  <a href= "[nav:link]">[nav:name]</a>

  {pboot:2nav parent=[nav:scode]}

    <a href= "[2nav:link]">[2nav:name]</a>

    {pboot:3nav parent=[2nav:scode]}

      <a href= "[3nav:link]">[3nav:name]</a>

    {/pboot:3nav}

  {/pboot:2nav}

{/pboot:nav}

如果有更多级别，以此类推，使用数字依层级套用，理论上不限级调用

当前栏目：

适用范围：在列表页或详情页使用

标签作用：用于输出当前栏目的相关信息

{sort:tcode}	当前栏目的顶级栏目编码
{sort:topname}	当前栏目的顶级栏目名称
{sort:toplink}	当前栏目的顶级栏目链接
{sort:pcode}	当前栏目的父栏目编码
{sort:parentname}	当前栏目的父栏目名称
{sort:parentlink}	当前栏目的父栏目链接
{sort:scode}	当前栏目编码
{sort:name}	栏目名称
{sort:subname}	栏目副名称
{sort:link}	栏目链接
{sort:type}	栏目类型，1单页、2列表
{sort:outlink}	后台设置的跳转链接
{sort:listtpl}	列表页模板
{sort:contenttpl}	详情页模板
{sort:ico}	栏目缩略图
{sort:pic}	栏目大图
{sort:title}	栏目标题(V1.3+)
{sort:keywords}	栏目关键字
{sort:description}	栏目描述
{sort:def1}	栏目描述1（V3.0.6+）
{sort:def2}	栏目描述2（V3.0.6+）
{sort:def3}	栏目描述3（V3.0.6+）

 

指定栏目：

适用范围：全站任意地方均可使用

标签作用：用于调导航菜单栏目列表，对应后台的“基础内容>内容栏目”

1、指定栏目列表

{pboot:sort scode=*}

<a href= "[sort:link]">[sort:name]</a>

{/pboot:sort}

控制参数：

scode=*  栏目编码，必填，用于控制输出的栏目，可以同时输出多个（V1.1.6+）,使用逗号隔开即可，如：1,2,3

scode={sort:pcode} 可用于输出当前栏目父菜单的信息

scode={sort:scode} 可用于输出当前栏目的信息

scode={sort:tcode} 可用于输出当前栏目顶级菜单的信息

2、可使用的列表标签

[sort:n]	序号，从0开始
[sort:i]	序号，从1开始
[sort:pcode]	父栏目编码
[sort:parentname]	父栏目名称
[sort:scode]	当前栏目编码
[sort:name]	栏目名称
[sort:subname]	栏目副名称
[sort:link]	栏目链接
[sort:type]	栏目类型，1单页、2列表
[sort:outlink]	后台设置的跳转链接
[sort:listtpl]	列表页模板
[sort:contenttpl]	详情页模板
[sort:ico]	栏目缩略图
[sort:pic]	栏目大图
[sort:title]	栏目标题(V1.3+)
[sort:keywords]	栏目关键字
[sort:description]	栏目描述
[sort:rows]	栏目下内容数量(V1.3+)
[sort:toprows]	顶级栏目下内容数量(V1.3+)
[sort:parentrows]	父栏目下内容数量(V1.3+)
[sort:def1]	栏目描述1（V3.0.6+）
[sort:def2]	栏目描述2（V3.0.6+）
[sort:def3]	栏目描述3（V3.0.6+）

内容列表：

适用范围：指定栏目编码时全站可用，适用当前列表

标签作用：用于调取指定栏目的内容列表或自动当前列表

1、当前栏目内容列表

{pboot:list}

<a href= "[list:link]">[list:title]</a>

{/pboot:list}

只能在列表页面使用，带分页，同一个页面只能使用一次，否则：老版本会出现分页冲突，新版会显示一样的内容。

V1.2.2版本开始order排序进行调整，默认情况下置顶、推荐、头条具有优先显示，包括使用date、sorting、visits、likes、oppose时，那么如果要想按照自己的设置来可以使用自定义模式，可以自己任意组合：如order='date desc,id desc' 此时意味着将按照时间倒序,然后添加顺序倒序。如order='sorting desc,id desc' 将先按照后台排序，然后按照id倒序。更多情况自己参照例子定义即可。

               

控制参数：

num=*  每页数量，非必填，用于控制分页大小

order=*   排序方式，非必填，用于输出内容的排序方式，可选：date、sorting、istop、isrecommend、isheadline、visits、likes、oppose、等字段，其中sorting为按后台填写的排序，122版本开始支持自定义模式，如：order='date desc,id desc' 、order='sorting desc,id desc'，(V1.3.7+)还支持random随机排序

filter=*|x,y 数据过滤，非必填，用于对列表内容进行过滤筛选，如：filter=title|ASP,PHP 只显示标题含有ASP和PHP的内容，如果需要只显示推荐，可使用如下过滤参数： filter=isrecommend|1 （V1.2.0+版本用下面的方式更好）

isico=*、ispics=*、istop=*、isrecommend=*、isheadline=* 用于对数据进行特殊筛选，可选值1和0，非必填，比如只调取推荐内容：isrecommend=1

tags=x,y tags方式数据过滤，非必填，用于对列表内容进行过滤筛选，如：tags='ASP,PHP',则为含有asp或php标签的内容,那么可以用 tags={content:tags}来调用当前文章的相关文章

start=* 起始数据(V1.3.2+)，非必填，用于需要从第几条开始

2、指定栏目内容列表

{pboot:list scode=*}

<a href= "[list:link]">[list:title]</a>

{/pboot:list}

可以全站使用，多个栏目编码使用逗号隔开，如果使用星号，意味全部栏目。指定栏目内容列表默认不分页，当然你还是可以通过page参数控制强制分页，但要注意不可在同一页面使用多个带分页的列表。

如果要使用本循环标签调用当前内容列表，可以使用scode={sort:scode}，同时也避免了同一个页面多次调用当前栏目内容时分页冲突问题。

               

控制参数：

scode=* 栏目编码，必填，用于指定需要调取的栏目编码，读取的内容会同时包含该栏目下子菜单的内容,支持多个栏目如:1,2,3

page=* 是否分页，非必填，用于列表是否执行分页，可设置1或0，本功能适合首页分页等场景

start=* 起始数据(V1.3.2+)，非必填，用于需要从第几条开始

其余控制参数同上面当前栏目内容列表

3、可使用的列表标签

               

[list:n]	计数0开始
[list:i]	计数1开始
[list:id]	编号
[list:scode]	栏目编码
[list:subscode]	副栏目编码
[list:sortname]	栏目名称
[list:subsortname]	副栏目名称
[list:sortlink]	栏目链接
[list:subsortlink]	副栏目链接
[list:title]	标题
[list:titlecolor]	标题颜色
[list:subtitle]	副标题
[list:tags]	直接输出tags
[list:author]	作者
[list:source]	来源
[list:link]	链接
[list:outlink]	外部链接
[list:date]	发布日期
[list:ico]	缩略图，不存在时自动调用文章第一张图，[list:isico]可用于判断，返回1或0
[list:pics]	多图，V2.0.2新增[list:ispics]可用于判断，返回1或0
[list:content]	内容
[list:enclosure]	附件
[list:enclosuresize]	附件大小
[list:keywords]	关键词
[list:description]	描述
[list:istop]	是否置顶
[list:isrecommend]	是否推荐
[list:isheadline]	是否头条
[list:visits]	访问数量
[list:likes]	点赞数量
[list:oppose]	反对数量
[list:likeslink]	点赞链接
[list:opposelink]	反对链接
[list:ext_***]	调取扩展字段内容

 

分页条：

适用范围：分页条标签适用所有执行了分页的页面

标签作用：用于输出分页代码

1、分页条标签

{page:bar}	系统内置的完整分页条
{page:current}	当前页码
{page:count}	总页数
{page:rows}	总数据行数
{page:index}	首页链接
{page:pre}	前一页链接
{page:next}	下一页链接
{page:last}	尾页链接
{page:status}	分页状态信息
{page:numbar}	数字条,数字带class名称为page-num，当前的同时还带page-num-current
{page:selectbar}	下拉选择条

2、分页条自带的HTML样式class名称

状态：page-status

首页：page-index

上一页：page-pre

下一页：page-next

尾页：page-last

数字条：page-numbar ,数字条下面的数字：page-num ，如果是当前页，那么该数字还同时带有：page-num-current

下拉条：page-select （默认条已经不显示）

如果使用系统完整分页条，则以上样式名称在输出的HTML代码中都带，你可以直接使用对应名称在自己的css中定义具体样式即可；

如果使用自定义方式，那么就按照自己写的html代码来定义，但是数字条下面的page-num 、page-num-current依然有效。

内容详情页：

适用范围：在内容详情页使用，包括单页和列表点击后的详情页

标签作用：用于输出当前内容的相关信息

{content:id}	编号
{content:scode}	栏目编码
{content:subscode}	副栏目编码
{content:sortname}	栏目名称
{content:subsortname}	副栏目名称
{content:sortlink}	栏目链接
{content:subsortlink}	副栏目链接
{content:title}	标题
{content:titlecolor}	标题颜色
{content:subtitle}	副标题
{content:author}	作者
{content:source}	来源
{content:link}	链接
{content:outlink}	外部链接
{content:date}	发布日期
{content:ico}	缩略图，不存在时自动调用文章第一张图，{content:isico}可用于判断，返回1或0
{content:pics}	多图，V2.0.2+新增{content:ispics}可用于判断，返回1或0
{content:content}	内容
{content:tags}	直接输出tags
{content:enclosure}	附件
{content:enclosuresize}	附件大小
{content:keywords}	关键词
{content:description}	描述
{content:istop}	是否置顶
{content:isrecommend}	是否推荐
{content:isheadline}	是否头条
{content:visits}	访问数量
{content:likes}	点赞数量
{content:oppose}	反对数量
{content:likeslink}	点赞链接
{content:opposelink}	反对链接
{content:ext_***}	调取扩展字段内容
{content:precontent}	上一篇内容（带链接）
{content:nextcontent}	下一篇内容（带链接）
{content:prelink}	上一篇内容链接
{content:nextlink}	下一篇内容链接
{content:pretitle}	上一篇内容标题
{content:nexttitle}	下一篇内容标题
{content:nexttitle notext='no more'}	设置“没有了”文本，设置参数时如果带空格，需要用单引号
{content:preico}	上一篇内容缩略图（V2.0+）
{content:nextico}	下一篇内容缩略图（V2.0+）

指定内容：

适用范围：全站任意地方均可使用

标签作用：用于调取指定id的内容

1、调取指定内容

{pboot:content id=*}

<a href= "[content:link]">[content:title]</a>

{/pboot:content}

控制参数：

id=*  内容的ID号，必填，用于控制输出的内容，适用单页或列表页内容

scode=* 单页的分类编码，必填，用于控制输出单页的内容，只适用单页内容

2、可使用的内容标签

[content:id]	编号
[content:scode]	栏目编码
[content:subscode]	副栏目编码
[content:sortname]	栏目名称
[content:subsortname]	副栏目名称
[content:sortlink]	栏目链接
[content:subsortlink]	副栏目链接
[content:title]	标题
[content:titlecolor]	标题颜色
[content:subtitle]	副标题
[content:author]	作者
[content:source]	来源
[content:link]	链接
[content:outlink]	外部链接
[content:date]	发布日期
[content:ico]	缩略图
[content:pics]	图集
[content:content]	内容
[content:tags]	直接输出tags
[content:enclosure]	附件
[content:enclosuresize]	附件大小
[content:keywords]	关键词
[content:description]	描述
[content:istop]	是否置顶
[content:isrecommend]	是否推荐
[content:isheadline]	是否头条
[content:visits]	访问数量
[content:likes]	点赞数量
[content:oppose]	反对数量
[content:likeslink]	点赞链接
[content:opposelink]	反对链接
[content:ext_***]	调取扩展字段内容

 

指定内容多图遍历：

适用范围：全站任意地方均可使用

标签作用：用于依次输出指定内容的多张图片

1、指定内容多图遍历

{pboot:pics id=* num=*}

<img src="[pics:src]" alt="[pics:title]">

{/pboot:pics}

控制参数：

id=*  内容ID号，必填，用于控制需要输出图片的内容，也可使用id={content:id}、id=[list:id]自适应当前内容及列表

num=*  数量，非必填，用于控制需要输出图片得数量

field=*  多图字段名称（V3.1.0+），默认为pics，即系统默认的多图字段，如果使用扩展字段则必须指定字段名称

2、可使用的多图标签

[pics:n]	序号从0开始
[pics:i]	序号从1开始
[pics:src]	图片地址
[pics:title]	图片标题（V3.0.6+）

内容tags标签调用：

适用范围：全站任意地方均可使用

获取当前tags值可用：{$get.tag}

1、调用指定栏目下的内容tags

{pboot:tags scode=*,*}

<a href="[tags:link]">[tags:text]</a>

{/pboot:tags}

    此处tags的链接指向所填scode分类下列表页，比如如果填写5,7,那么5下面的内容指向5，7下面的指向7。

控制参数：

scode=*  栏目编码，用于控制需要输出内容的栏目编码，多个用逗号隔开

num=*  数量，非必填，用于控制需要输出的数量

target=tag （V2.0.6+）可以指定链接跳转到tags.html独立模板

2、调用指定内容的tags

{pboot:tags id=*}

<a href="[tags:link]">[tags:text]</a>

{/pboot:tags}

    此处tags的链接默认指向内容本身的分类，如果你不想这样，那么可以指定scode=* 来设置跳转的分类。

控制参数：

id=*  内容ID，用于控制需要输出的内容ID，如果与列表标签嵌套可以用id=[list:id]

num=*  数量，非必填，用于控制需要输出的数量

target=tag （V2.0.6+）可以指定链接跳转到tags.html独立模板

3、使用tags显示相似内容列表

{pboot:list scode=* tags='x,y'}

<p><a href="[list:link]">[list:title]</a></p>

{/pboot:list}

此处scode可以是当前栏目标签{sort:scode}，详情页可配合tags={content:tags}来调用当前文章的相关相似文章

4、可使用的列表标签

[tags:n]	序号从0开始
[tags:i]	序号从1开始
[tags:link]	链接地址
[tags:text]	tags名称

 

指定内容多选字段遍历：

适用范围：全站任意地方均可使用

标签作用：用于依次输出指定内容的多选值，也可用于遍历逗号隔开的字段，如tag

1、指定内容多选遍历

{pboot:checkbox id=* field=*}

[checkbox:text]

{/pboot:checkbox}

控制参数：

id=*  内容ID号，必填，用于控制需遍历多选的内容，也可使用id={content:id}、id=[list:id]自适应当前内容及列表

field=*  字段，必填，用于控制需要遍历的字段，如扩展字段产品特色：ext_cpts

2、可使用的多选遍历标签

[checkbox:n]	序号从0开始
[checkbox:i]	序号从1开始
[checkbox:text]	文本

幻灯片轮播图：

适用范围：全站任意地方均可使用

标签作用：用于依次输出指定分组的幻灯片图片

1、幻灯片轮播图列表

{pboot:slide gid=* num=*}

<img src="[slide:src]">

{/pboot:slide}                   

控制参数：

gid=*  分组，必填，用于控制需要输出的幻灯片分组

num=*  数量，非必填，用于控制需要输出的数量，默认为5个

2、可使用的列表标签

[slide:n]	序号从0开始
[slide:i]	序号从1开始
[slide:id]	编号
[slide:pic]	图片地址
[slide:link]	链接地址
[slide:title]	标题
[slide:subtitle]	副标题

 

友情链接：

适用范围：全站任意地方均可使用

标签作用：用于依次输出指定分组的友情链接

1、友情链接列表

{pboot:link  gid=* num=*}

<a href="[link:link]" title="[link:name]"><img src="[link:logo]"></a>

{/pboot:link}

控制参数：

gid=*  分组，必填，用于控制需要输出的友情链接分组

num=*  数量，非必填，用于控制需要输出的数量，默认为10个

2、可使用的列表标签

[link:n]	序号从0开始
[link:i]	序号从1开始
[link:id]	编号
[link:name]	链接名称
[link:link]	链接地址
[link:logo]	链接Logo图

留言板：

适用范围：全站任意地方均可使用

标签作用：用于用户提交留言和调取留言记录

1、留言提交表单

<form action="{pboot:msgaction}"  method="post">

    联系人：<input type="text" name="contacts" >

    手机：<input type="text" name="mobile" >

    内容：<input type="text" name="content" >

    验证码：<input type="text" name="checkcode" ><img   title="点击刷新"  src="{pboot:checkcode}" onclick="this.src='{pboot:checkcode}?'+Math.round(Math.random()*10);" />

    <button type="submit">提交</button>

</form>

表单提交方式为post，表单中提交的字段名称需要与后台自定义表单中添加的字段一致，否则会导致提交失败。

需要更多字段时请在后台自定义表单中新增留言表单字段，然后再在前台新增form字段.

标签说明：

{pboot:msgaction} 为留言表单接收地址

{pboot:checkcode} 为验证码图片地址

2、留言记录列表

{pboot:message num=*}

    <p>[message:contacts]</p>

    <p>[message:content]</p>

{/pboot:message}

调取的留言记录默认执行分页，使用内容列表的分页代码即可.

内容隐私，使用截取功能： [message:mobile substr=1,3]****[message:mobile substr=8]  输出效果：187****6563

控制参数：

num=* 数量，非必填，为调取的留言分页大小

page=* 是否分页1或0，非必填，用于关闭分页

lg=* 调取指定语言留言，非必填，设置all则所有语言，不添加该参数则默认为当前语言（V1.3.7+）

3、留言记录列表可用标签

[message:n]	序号从0开始
[message:i]	序号从1开始
[message:contacts]	联系人
[message:mobile]	手机
[message:content]	内容
[message:recontent]	回复内容
[message:ip]	用户IP
[message:os]	用户操作系统
[message:bs]	用户浏览器
[message:askdate]	留言时间
[message:replydate]	回复时间
[message:***]	自定义的其它字段
[message:nickname]	会员昵称(V3.0+)
[message:username]	会员账号(V3.0+)
[message:headpic]	会员头像(V3.0+)

 

自定义表单：

适用范围：全站任意地方均可使用

标签作用：用于用户提交表单和调取表单记录

1、使用步骤

• 1）到后台”扩展内容>自定义表单“中添加表单

• 2）对新增的表单添加字段

• 3）到前台模板中新增form表单

问：为什么自定义表单后台添加字段没有类型选择？？？

答：表单中字段类型只不过是页面表现的形式，类型只需在前端模板中根据实际需要编写对应HTML表单字段类型即可，数据对于后端存储来说均为文本，PbootCMS希望给前端开发者最大的开发自由，想什么类型模板说了算，这才是真正的前后端分离，那么PbootCMS的表单其实给与了最大的灵活性和通用性。

2、提交表单示例

<form action="{pboot:form fcode=*}"  method="post">

    姓名(单行文本)：<input type="text" name="name" >

    性别(单选类型)：

    <input type="radio" value="男" name="sex" >男

    <input type="radio" value="女" name="sex" >女

    爱好(多选类型)：

    <input type="checkbox" value="篮球" name="like[]" >篮球

    <input type="checkbox" value="足球" name="like[]" >足球

    省份(下拉类型)：

    <select name="province">

      <option value="北京">北京</option>

      <option value="上海">上海</option>

    </select>

    简介(多行文本)：<textarea name="description" ></textarea>

    <button type="submit">提交</button>

</form>

               

表单提交方式为post，表单中提交的字段名称需要与后台自定义表单中添加的字段一致，否则会导致提交失败。

需要特别提醒的是，如果字段为多选类型，那么表单字段名称需要用中括号，比如选择爱好：

    <input type="checkbox" value="篮球" name="like[]" >篮球

    <input type="checkbox" value="足球" name="like[]" >足球

标签说明：

{pboot:form fcode=*} 为表单接收地址，fcode对应后台接收表单的编码

注意：此处与留言板的提交地址不可混淆，内置的留言表单使用专用地址{pboot:msgaction}，其余自定义表单则按照此处规则定义提交地址。

3、表单记录列表

{pboot:formlist fcode=* num=*}

    <p>姓名：[form:name]</p>

    <p>公司：[form:company]</p>

    <p>职位：[form:position]</p>

{/pboot:formlist}

调取的留言记录默认执行分页，使用内容列表的分页代码即可.

V1.3.3之前版本使用{pboot:form}，但是如果同时使用提交表单会有冲突，所以变更了标签。

调取表单的内容的标签名称与自定义的表单字段一致。

控制参数：

fcode=* 表单编码，必填，用于控制调取的表单

num=* 数量，非必填，用于控制调取的记录分页大小

page=* 是否分页1或0，非必填，用于关闭分页

4、表单记录列表可用标签

[form:n]	序号从0开始
[form:i]	序号从1开始
[form:date]	提交时间
[form:***]	自定义的其它字段

会员标签：

标签全站可用，具体使用建议参考默认模板

1、基本标签

{pboot:ucenter} 个人中心地址

{pboot:login} 登录地址

{pboot:register} 注册地址

{pboot:umodify} 资料修改地址

{pboot:logout} 退出登录地址

{pboot:upload} 文件上传AJAX接口

{pboot:islogin} 是否登录状态

{pboot:mustlogin} 设置页面必须登录

{pboot:sendemail} 发送邮件验证码接口,参数to

{pboot:registercodestatus} 会员注册验证码状态0、1、2

{pboot:logincodestatus} 会员登录验证码状态

{pboot:registerstatus} 是否开启注册

{pboot:loginstatus} 是否开启登录

{pboot:commentstatus} 是否开启评论

2、标签权限控制参数

showgcode=* 指定等级显示，支持多个逗号隔开

showucode=* 指定用户显示，支持多个逗号隔开

hidegcode=* 指定等级隐藏，支持多个逗号隔开

hideucode=* 指定用户隐藏，支持多个逗号隔开

showgcodelt=* 等级小于显示

showgcodegt=* 等级大于显示

showgcodele=* 等级小于等于显示

showgcodege=* 等级大于等于显示

hidegcodelt=* 等级小于隐藏

hidegcodegt=* 等级大于隐藏

hidegcodele=* 等级小于等于隐藏

hidegcodege=* 等级大于等于隐藏

showlogin=1 登录后显示

hidelogin=1 登录后隐藏

对于内容及栏目，也支持在后台直接控制;

标签使用，如：{content:content showlogin=1} 内容登录后可见

3、会员资料标签

{user:ucode} 会员编码

{user:username} 会员用户名

{user:useremail} 会员邮箱

{user:usermobile} 会员手机

{user:gcode} 等级编码

{user:gname} 等级名称

{user:registertime} 注册时间

{user:logincount} 登录次数

{user:lastloginip} 最后登录IP

{user:lastlogintime} 最后登录时间

{user:headpic} 头像URL

{user:***} 自定义会员字段，如果{user:sex}

3、会员相关表单字段

username、password、checkcode 登录必填

username、nickname、password、rpassword、checkcode 注册必填

 

文章评论：

文章评论调用在内容详情页可用，具体使用建议参考默认模板

1、基本标签

{pboot:commentcodestatus} 验证码是否开启

{pboot:commentaction} 评论提交地址

comment、checkcode 评论表单必填

注：由于涉及东西较多，具体使用可参考默认模板

2、评论循环输出

    {pboot:comment contentid={content:id}}

        [comment:***]

        {pboot:commentsub}
        [commentsub:***]
    {/pboot:commentsub}

    {/pboot:comment}

3、可使用的输出标签

[comment:n]	序号，从0开始
[comment:i]	序号，从1开始
[comment:pid]	父评论ID
[comment:contentid]	评论文章ID
[comment:comment]	评论内容
[comment:ip]	IP地址
[comment:os]	操作系统
[comment:bs]	浏览器
[comment:date]	日期
[comment:uid]	评论人ID
[comment:username]	评论人账号
[comment:nickname]	评论人昵称
[comment:headpic]	评论人头像
[comment:pid]	父评论人ID
[comment:pusername]	父评论人账号
[comment:pnickname]	父评论人昵称
[comment:pheadpic]	父评论人头像
[comment:likes]	点赞数量
[comment:oppose]	反对数量
[comment:replyaction]	评论回复提交地址
{pboot:commentsub} 子评论输出     [commentsub:***] 子评论调用字段同上 {/pboot:commentsub}	子评论输出

我的评论：

用于在个人中心我的评论页面调用，具体使用建议参考默认模板

1、基本标签

{pboot:mycommentpage}  我的评论页面地址

2、评论循环输出

{pboot:mycomment}

    [comment:***]

{/pboot:mycomment}

3、可使用的输出标签

[mycomment:n]	序号，从0开始
[mycomment:i]	序号，从1开始
[mycomment:pid]	父评论ID
[mycomment:contentid]	评论文章ID
[mycomment:title]	评论文章标题
[mycomment:comment]	评论内容
[mycomment:ip]	IP地址
[mycomment:os]	操作系统
[mycomment:bs]	浏览器
[mycomment:date]	日期
[mycomment:uid]	评论人ID
[mycomment:username]	评论人账号
[mycomment:nickname]	评论人昵称
[mycomment:headpic]	评论人头像
[mycomment:pid]	父评论人ID
[mycomment:pusername]	父评论人账号
[mycomment:pnickname]	父评论人昵称
[mycomment:pheadpic]	父评论人头像
[mycomment:likes]	点赞数量
[mycomment:oppose]	反对数量
[mycomment:status]	评论状态：1审核2待审核
[mycomment:delaction]	评论删除地址

 

多条件筛选标签：

适用范围：内容列表页使用，其实也可以用在首页等

标签作用：用于对内容列表进行筛选

1、使用步骤

• 1）到后台对模型添加扩展字段，字段类型选择单选或多选，同时填写单选或多选的可选内容；

• 2）添加对应模型的栏目，并对栏目添加内容；

• 3）到前台模板中调用相关扩展字段进行输出，具体见下面的例子。

  注意：如果需要在首页使用筛选，列表需要启用分页功能，添加page=1参数才有效。

• 4）获取筛选值可以用{$get.xxxx}，如获取类型：{$get.ext_leixing}

2、筛选调用标签

1）全部标签

{pboot:selectall field=* text=* class=* active=*}

控制参数：

field=* 筛选的字段，必填，用于控制调取的筛选字段名称

text=* 显示文字，非必填，用于控制显示的文字，默认显示”全部“

class=* 非选中时样式，非必填，用于设置为文字非选中时的class常规样式

active=* 选中时样式，非必填，用于设置为文字选中时的class高亮样式

2）筛选值标签

{pboot:select field=*}

<a href= "[select:link]">[select:value]</a>

{/pboot:select}

               

控制参数：

field=* 筛选的字段，必填，用于控制调取的筛选字段名称

一般情况下我们会有多个字段，那么只要重复上面的代码即可。

选中值高亮处理：{pboot:if('[select:value]'=='[select:current]')}class= "active" {/pboot:if}

2）筛选可用标签

[select:i]	序号
[select:current]	当前选中值
[select:link]	链接
[select:value]	筛选值

3、多条件筛选示例

<p>

类型：{pboot:selectall field=ext_leixing text=全部 class='btn btn-light'  active='btnbtn-info'} |

{pboot:select field=ext_leixing}

{pboot:if([select:i]>1)}|{/pboot:if}

<a href="[select:link]"{pboot:if('[select:value]'=='[select:current]')}class="active" {/pboot:if}>[select:value]</a>

{/pboot:select}

</p>

<p>

颜色：{pboot:selectall field=ext_yanse text=全部 class='btn btn-light' active='btnbtn-info'} |

{pboot:select field=ext_yanse}

{pboot:if([select:i]>1)}|{/pboot:if}

<a href="[select:link]"{pboot:if('[select:value]'=='[select:current]')}class="active" {/pboot:if}>[select:value]</a>

{/pboot:select}

</p>

多条件搜索：

适用范围：全站任意地方均可使用

标签作用：用于执行站内搜索功能

1、最简单的搜索示例

<form action="{pboot:scaction}"  method="get">

    关键字：<input type="text" name="keyword" >

    <button type="submit">搜索</button>

</form>

               

    表单提交方式为get.

使用说明：

{pboot:scaction} 为搜索提交地址

注意：表单提交方式为get，此表单默认匹配title标题字段

2、定义搜索字段示例

<form action="{pboot:scaction}"  method="get">

    关键字：<input type="text" name="keyword" >

    <input type="hidden" name="field" value="title" >

    <button type="submit">搜索</button>

</form>

    或：

<form action="{pboot:scaction}"  method="get">

 

    <select name="field">

        <option value="title">内容标题</option>

        <option value="content">内容详情</option>

    </select>

    关键字：<input type="text" name="keyword" >

    <button type="submit">搜索</button>

</form>

               

    通过添加隐藏域传递field值来控制搜索的字段，也可以同时设置多个字段，如： value="title|content" ，当然这只是方式之一，后面还有！

3、定义更多搜索条件示例

<form action="{pboot:scaction}"  method="get">

    关键字：<input type="text" name="keyword" >

    <input type="hidden" name="field" value="title" >

    <input type="hidden" name="scode" value="2,3" >

    <button type="submit">搜索</button>

</form>

               

    这里只定义搜索的字段和搜索的分类，其实你可以定义更多数据库中任意可用的字段。如author为admin的：name="author" value="admin"，当然你可以使用非隐藏域，那么就相当于综合搜索类型。

如果需要定义的scode分类有多个，可以用逗号隔开，同时需要注意，如果表单传递的分类和字段无效时，要考虑结果页循环是否做了限制。

（V1.3.7+）如果有多个搜索表单想定义不同的结果页模板，那么可以传递searchtpl字段来定义模板页，如：

    <input type="hidden" name="searchtpl" value="test.html" >

4、多条件综合搜索示例

<form action="{pboot:scaction}"  method="get">

    内容：<input type="text" name="content" >

    标题：<input type="text" name="title" >

    作者：<input type="text" name="author" >

    <input type="hidden" name="scode" value="2,3" >

    <button type="submit">搜索</button>

</form>

               

    这里自定义了三个字段，其实你可以定义更多数据库中任意可用的字段。

    如果URL采用兼容模式，这时候搜索应该使用POST，或者在首行添加隐藏域，<input type="hidden" name="search" >

5、搜索结果列表

{pboot:search}

<a href="[search:link]">[search:title]</a>

{/pboot:search}

使用说明：

搜索结果页面使用模板search.html

num=*  每页数量，非必填，用于控制分页大小

order=*   排序方式，非必填，用于输出内容的排序方式，可选：date、sorting、istop、isrecommend、isheadline、visits、likes、oppose等字段，其中sorting为按后台填写的排序，122版本开始支持自定义模式，如：order='date desc,id desc' 、order='sorting desc,id desc',(V1.3.7+)还支持random随机排序

scode=*  分类编码，非必填，加前面说的方式，此作为第二种限制搜索分类的方式,多个分类用逗号隔开，如： scode='2,3,4'

field=* 字段限制，非必填，在使用了keyword时用于限定匹配的数据库字段，多个字段用竖线隔开即可，如：field='title|content'

filter=*|x,y 数据过滤，非必填，用于对列表内容进行过滤筛选，如：filter=title|ASP,PHP 只显示标题含有ASP和PHP的内容

fuzzy=*  是否模糊匹配，非必填，可选1或0，1时为默认的模糊匹配，0则关闭

    搜索结果默认执行分页，使用内容列表的分页代码即可.

6、搜索结果列表可用标签

 获取当前搜索内容：{pboot:keyword}   

 对搜索结果关键字进行标红 mark=1 （V2.0.5新增），如：[search:title mark=1]；

[search:n]	序号从0开始
[search:i]	序号从1开始
[search:id]	编号
[search:scode]	分类编码
[search:subscode]	副分类编码
[search:sortname]	分类名称
[search:subsortname]	副分类名称
[search:sortlink]	分类链接
[search:subsortlink]	副分类链接
[search:title]	标题
[search:titlecolor]	标题颜色
[search:subtitle]	副标题
[search:author]	作者
[search:source]	来源
[search:link]	链接
[search:outlink]	外部链接
[search:date]	发布日期
[search:ico]	缩略图
[search:pics]	多图
[search:content]	内容
[search:enclosure]	附件
[search:enclosuresize]	附件大小
[search:keywords]	关键词
[search:description]	描述
[search:istop]	是否置顶
[search:isrecommend]	是否推荐
[search:isheadline]	是否头条
[search:visits]	访问数量
[search:likes]	点赞数量
[search:oppose]	反对数量
[search:likeslink]	点赞链接
[search:opposelink]	反对链接

 

多语言/区域建站：

标签作用：用于使用同一个后台建立多国语言网站或多区域网站

1、使用步骤

• 1）在后台"系统管理>数据区域"添加相应的区域，具体参考默认区域；

• 2）将多语言的模板放入模板目录，不同语言的模板均放在template目录下；

• 3）在后台选择语言切换到不同语言，分别设置：站点信息（注意选择模板）、公司信息、栏目信息、添加内容等；

• 4）在不同模板中添加多语言切换按钮。

2、多语言切换按钮

<a href="{pboot:lgpath}&lg=cn">切换中文</a>

<a href="{pboot:lgpath}&lg=en">切换英文</a>

请注意：PB2.0开始lg前面用&符号，之前老版本用?符号！

更多语言，类似方式添加即可。

如何判断当前语言并高亮？

在按钮上添加判断语句：{pboot:if('{pboot:sitelanguage}'=='cn')}class="active"{/pboot:if}

IF条件语句使用：

标签作用：用于根据条件输出不同内容

注意：从V3.2.0开始，if标签仅支持'>'、'>='、'!='、'=='、'<='、'<'、'&&'、'||'、'%'等符号，详情可查看V3.2.0开发日志

1、IF语句格式

{pboot:if('a'=='b')}

  内容1

{else}

  内容2

{/pboot:if}

使用提示：

对于非数字类的条件均为字符串类型，请加上引号，如：{pboot:if('[list:author]'=='admin')}，但是数字类的可以不加：{pboot:if([list:i]==1)}

如果条件有多个，可以按照PHP的语法进行运算，如下：

条件并列：{pboot:if('[list:author]'=='admin' && [list:i]==1)}

条件或：{pboot:if('[list:author]'=='admin' || [list:i]==1)}

2、IF语句嵌套

{pboot:if('a'=='b')}

  {pboot:2if('a'=='c')}

    内容1

  {2else}

    内容2

  {/pboot:2if}

{else}

  内容3

{/pboot:if}

 嵌套层级理论上不受限制，按此方式用数字依次嵌套即可。

 

lopp循环语句使用：

标签作用：用于根据循环输出一段内容

1、Loop语句格式

{pboot:loop start=* end=*}

  <p>这是第[loop:i]次，索引号为[loop:index]</p>

{/pboot:loop}

控制参数：

start=* 起始数字,默认1开始

end=* 结束数字，必填

API接口列表：

标签作用：用于远程调取系统数据，使用小程序、公众号、APP等。

使用说明

• 1）请先到后台进行API相关参数配置，强烈建议启用强制认证；

• 2）客户端发起请求必须包含appid（认证用户）、timestamp（时间戳）、signature（签名）三个参数

• 3）签名参数signature通过appid、secret、timestamp三个值连接为一个字符串,然后进行双层md5加密生成;

站内使用Ajax获取数据示例：

<script>

$(document).ready(function (e) {

  var url='/api.php/cms/site';

  $.ajax({

    type: 'POST',

    url: url,

    dataType: 'json',

    data: {

      appid: '{pboot:appid}',

      timestamp: '{pboot:timestamp}',

      signature: '{pboot:signature}'

     },

    success: function (response, status) {

      if(response.code){

        //获取数据成功

        alert(response.data.title);

      }else{

        //返回错误数据

        alert(response.data);

      }

    },

    error:function(xhr,status,error){

      //返回数据异常

      alert('返回数据异常！');

    }

  });

});

</script>

此处使用了三个站内标签：{pboot:appid} 认证用户名、{pboot:timestamp} 时间戳、{pboot:signature} 认证签名

1、网站信息接口

http://IP/api.php/cms/site

http://IP/api.php/cms/site/name/*  单个调用

注意此处和CMS标签比不带site前缀，所以返回整体数据和调取单个时直接写名称，如：标题title

2、公司信息接口

http://IP/api.php/cms/company

http://IP/api.php/cms/company/name/* 单个调用

注意此处和CMS标签比不带company前缀，所以返回整体数据和调取单个时直接写名称，如：名称name

3、自定义标签接口

http://IP/api.php/cms/label

http://IP/api.php/cms/label/name/*  单个调用

4、栏目列表树接口

http://IP/api.php/cms/nav

http://IP/api.php/cms/nav/scode/*   获取指定分类的子类

5、当前栏目位置接口

http://IP/api.php/cms/position/scode/*  此处传递当前栏目scode值

6、指定分类信息接口

http://IP/api.php/cms/sort/scode/* 此处传递需要调用栏目的scode值

7、指定内容多图接口

http://IP/api.php/cms/pics/id/*  此处传递内容ID值

8、幻灯片接口

http://IP/api.php/cms/slide/gid/*/num/*  此处传递分组gid及调取的数量num值，默认num为5

9、友情链接接口

http://IP/api.php/cms/link/gid/*/num/*  此处传递分组gid及调取的数量num值,默认num为10

10、指定内容列表接口

http://IP/api.php/list/*  此处传递需要调用的栏目scode

http://IP/api.php/list/*/page/2 调取第二页，如果数据已获取完，返回类似{"code":0,"data":"已经到底了！","rowtotal":"5"}

同时还支持URL中传递num/*参数控制数量，传递order/* 控制排序方式，用POST方式会更好传递值

11、指定内容详情接口

http://IP/api.php/content/*  传递需要调用的内容ID(单页一样适用)

12、指定单页详情接口

http://IP/api.php/about/*  传递需要调用的单页scode

13、搜索内容接口

http://IP/api.php/cms/search   建议使用POST提交,keyword传递搜索关键字单条件搜索

同时支持传递num/*参数控制数量，传递order/* 控制排序方式，建议POST方式

可传递参数 field指定字段，多个用|隔开；

可传递参数 scode指定分类，多个用逗号隔开；

可传递参数 fuzzy等于0关闭模糊匹配，另外也可使用多数据库字段名称传递值来多条件搜索

14、留言提交接口

http://IP/api.php/cms/addmsg  要求POST提交，传递的字段同后台自定义的留言字段

15、留言内容接口

http://IP/api.php/cms/msg/num/*   传递num分页大小

http://IP/api.php/cms/msg/num/*/page/2   调取第二页

16、表单提交接口

http://IP/api.php/cms/addform/fcode/*  要求POST提交,fcode为表单编码，传递的字段同后台自定义的字段

17、表单数据读取接口

http://IP/api.php/cms/form/fcode/*     传递fcode表单编码

http://IP/api.php/cms/form/fcode/*/num/*/page/*   num控制条数，page控制页码

温馨提示：

以上接口对于多语言（区域）的情况，请地址中附加acode参数指定语言,否则调用默认语言，如:http://IP/api.php/cms/site/acode/en