开源达人之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
————————————————

版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。

原文链接:https://blog.csdn.net/CMDGY01/article/details/131100968

发表评论