公共标签:
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