pbootcms模板开发教程之核心标签详解

pbootcms全局系统标签（{pboot:xxx}）

pbootcms全局标签可在‌任何模板页面‌中使用，用于调用站点全局信息。
标签 说明 示例
{pboot:sitename} 站点名称 我的外贸网站
{pboot:sitetitle} 站点标题（首页用） XX公司 – 专业产品供应商
{pboot:sitekeywords} 站点关键词 外贸,产品,工厂
{pboot:sitedescription} 站点描述 专业生产XX产品的工厂…
{pboot:siteurl} 站点域名 https://www.example.com
{pboot:sitetplpath} 当前模板目录路径 /template/default
{pboot:sitepath} 网站根目录路径 /
{pboot:today} 当前日期 2026-09-24
{pboot:ip} 访客IP 192.168.1.1
{pboot:online} 在线人数 128
{pboot:runinfo} 系统运行信息 页面加载耗时…
常用导航标签（全局可用）

html
<!– 面包屑导航 –>
<div class=”breadcrumb”>
<a href=”{pboot:sitepath}”>首页</a>
{pboot:position}
</div>

<!– 输出：首页 > 产品中心 > 产品分类1 –>

2.2 栏目导航标签（{sort:xxx}）

栏目标签用于调用栏目信息，支持‌循环输出多级栏目‌、当前栏目信息等。
1）根栏目循环（一级导航）

html
<ul class=”nav”>
{sort:parent=0 num=10 order=asc}

<a href=”[sort:link]”>[sort:name]</a>
<!– 二级子栏目 –>
<ul class=”subnav”>
{sort:parent=[sort:id] num=10 order=asc}
<a href=”[sort:link]”>[sort:name]</a></li>
{/sort}
</ul>
</li>
{/sort}
</ul>

参数说明

参数 说明 可选值
parent 父栏目ID 0=顶级栏目，指定ID=该栏目下的子栏目
num 显示数量 数字，默认10
order 排序方式 asc（升序）、desc（降序）、sort（后台排序）
type 栏目类型 1=单页，2=列表，3=外链，留空=全部
2）当前栏目信息（列表页/内容页可用）

标签 说明
{sort:id} 当前栏目ID
{sort:name} 当前栏目名称
{sort:link} 当前栏目链接
{sort:description} 当前栏目标题（SEO title）
{sort:keywords} 当前栏目关键词
{sort:description} 当前栏目描述
{sort:parentid} 父栏目ID
{sort:parentname} 父栏目名称
{sort:parentlink} 父栏目链接
{sort:content} 单页面内容（仅单页栏目）
2.3 内容列表标签（{list:xxx}）

列表标签是‌最常用的核心标签‌，用于循环输出文章、产品等内容。
基础用法

html
<div class=”product-list”>
{list:scode=2 num=8 order=date paging=0}
<div class=”product-item”>
<a href=”[list:link]”>
<img src=”[list:ico]” alt=”[list:title]”>
[list:title]</h3>
[list:description|substr=0,80]…</p>
[list:date|date=’Y-m-d’]</span>
</a>
</div>
{/list}
</div>

常用参数

参数 说明 示例
scode 栏目ID（可多个用逗号分隔） scode=2,3,4
num 每页显示数量 num=12
order 排序方式 date（按日期）、sort（后台排序）、visits（浏览量）、id（ID）
paging 是否分页 0=不分页，1=分页
flag 推荐/置顶属性 r=推荐，h=头条，s=置顶
keyword 关键词筛选（搜索页用） keyword={get:keyword}
length 标题自动截取长度 length=30（超出显示…）
列表项可用字段

字段 说明
[list:id] 内容ID
[list:title] 标题
[list:link] 链接地址
[list:ico] 缩略图地址
[list:pics] 多图数组（需循环输出）
[list:description] 摘要/描述
[list:content] 正文内容
[list:date] 发布时间（时间戳）
[list:visits] 浏览量
[list:author] 作者
[list:source] 来源
[list:sortname] 所属栏目名称
[list:sortlink] 所属栏目链接
[list:is_top] 是否置顶（1/0）
[list:is_recommend] 是否推荐（1/0）
多图输出示例

html
{list:scode=2 num=1}
<div class=”product-gallery”>
{pboot:foreach([list:pics] as $pic)}
<img src=”{$pic}” alt=”[list:title]”>
{/pboot:foreach}
</div>
{/list}

2.4 内容详情标签（{content:xxx}）

内容页模板中使用，调用单篇内容的详细信息。
常用字段
表格
标签 说明
{content:id} 内容ID
{content:title} 标题
{content:keywords} 内容关键词（SEO）
{content:description} 内容描述（SEO）
{content:ico} 缩略图
{content:content} 正文内容
{content:date} 发布时间
{content:visits} 浏览量
{content:author} 作者
{content:source} 来源
{content:sortname} 所属栏目名称
{content:sortlink} 所属栏目链接
{content:prevlink} 上一篇链接
{content:prevtitle} 上一篇标题
{content:nextlink} 下一篇链接
{content:nexttitle} 下一篇标题
内容页模板示例

html
{include file=header.html}

<div class=”article”>
<div class=”article-header”>
{content:title}</h1>
<div class=”meta”>
发布时间：{content:date|date=’Y-m-d’}</span>
浏览量：{content:visits}</span>
栏目：<a href=”{content:sortlink}”>{content:sortname}</a></span>
</div>
</div>

<div class=”article-body”>
{content:content}
</div>

<div class=”article-footer”>
上一篇：<a href=”{content:prevlink}”>{content:prevtitle|默认值=没有了}</a></p>
下一篇：<a href=”{content:nextlink}”>{content:nexttitle|默认值=没有了}</a></p>
</div>
</div>

{include file=footer.html}

2.5 分页标签

当列表设置 paging=1 时，需要配合分页标签使用。
基础用法

html
{list:scode=2 num=10 paging=1}
<div class=”item”>…</div>
{/list}

<!– 分页条 –>
<div class=”pagination”>
{pboot:pagelist}
</div>

分页样式定制

默认分页输出格式可在后台配置，也可通过CSS自定义样式。常用分页类名：

.pagination：分页容器
.prev / .next：上一页/下一页
.first / .last：第一页/最后一页
.num：页码数字
.current：当前页

2.6 其他常用标签
1）引入公共模板

html
{include file=header.html} <!– 引入同目录下的header.html –>
{include file=common/nav.html} <!– 引入子目录中的模板 –>

2）条件判断

html
{pboot:if(‘{pboot:iswap}’==1)}
这是手机端
{pboot:else}
这是PC端
{/pboot:if}

{pboot:if(‘{sort:id}’==2)}
当前是产品中心栏目
{/pboot:if}

3）PHP原生代码

模板中可直接写PHP代码：

php
<?php
$a = 10;
$b = 20;
echo $a + $b;
?>

4）获取URL参数

html
{get:keyword} <!– 获取?keyword=xxx的参数值 –>
{get:id} <!– 获取?id=xxx的参数值 –>

5）循环数字（非数据库数据）

html
{pboot:for($i=1; $i<=5; $i++)}
第{$i}条
{/pboot:for}