PbootCMS 模板标签序号从 2 开始

一、需求场景

在 PbootCMS 模板开发中，需实现标签序号从 2 开始计数，适用于以下场景：

• 导航栏需隐藏第一个默认栏目（如 “首页”），从第二个栏目开始显示；

• 内容列表需跳过第一条置顶内容，从第二条开始展示；

• 自定义模块需按特定规则调整序号起始值。

二、导航标签（{pboot:nav}）

1. 核心问题

PbootCMS 导航标签默认通过 [nav:i] 输出序号（从 1 开始），需通过条件判断跳过第一个导航项。

2. 实现代码

{pboot:nav}
    {pboot:if([nav:i] > 1)} <!-- 判断序号是否大于1（即从2开始） -->
        <li>
            <a href="[nav:link]">[nav:name]</a>
        </li>
    {/pboot:if}
{/pboot:nav}

3. 代码解析

• {pboot:nav}：遍历所有导航栏目；

• [nav:i]：输出当前导航项的序号（从 1 开始）；

• {pboot:if([nav:i] > 1)}：仅当序号大于 1 时，渲染导航项；

• 若需显示第 2-5 个导航项，可叠加条件：

{pboot:if([nav:i] > 1) && [nav:i] <= 5}

三、列表标签（{pboot:list}）

1. 核心问题

PbootCMS 列表标签默认从第 1 条内容开始显示，需通过 start 参数 调整起始位置（V1.3.2 + 版本支持）。

2. 实现代码

{pboot:list scode=1 start=2 num=5}
    <a href="[list:link]">[list:title]</a>
{/pboot:list}

3. 代码解析

• scode=1：指定内容所属栏目（需替换为实际栏目 ID）；

• start=2：从第 2 条内容开始显示；

• num=5：共显示 5 条内容（即第 2-6 条）；

• 若需显示第 2-5 条内容，可调整 num=4（2-5 共 4 条）。

四、综合示例（导航 + 列表）

1. 导航栏隐藏第一个栏目

<nav class="nav-menu">
    {pboot:nav}
        {pboot:if([nav:i] > 1)}
            <a href="[nav:link]" class="nav-item">[nav:name]</a>
        {/pboot:if}
    {/pboot:nav}
</nav>

2. 内容列表跳过第一条

<div class="content-list">
    {pboot:list scode=2 start=2 num=4}
        <div class="content-item">
            <h3>[list:title]</h3>
            <p>[list:description len=80]</p>
        </div>
    {/pboot:list}
</div>

五、注意事项

1. 版本兼容性：

• start 参数仅支持 V1.3.2 及以上版本，低版本需升级 PbootCMS；

• 导航标签条件判断需确保 {pboot:if} 语法正确（V1.2.0 + 支持）。

2. 缓存清理：
   修改模板后需清空 PbootCMS 缓存（后台→系统设置→缓存设置→清空缓存），否则修改可能不生效。

3. 序号逻辑：

• 导航标签 [nav:i] 从 1 开始计数；

• 列表标签 start=2 表示从第 2 条内容开始（数据库中 ID 不一定连续，需依赖排序规则）。