pbootcms模板如何调用置顶文章

在PbootCMS模板开发中，灵活调用不同类型的文章是每个开发者必须掌握的技能。本文将详细介绍如何使用PbootCMS的标签参数调用置顶、推荐、头条等各种特殊文章，并提供实用示例和最佳实践建议。

一、基本调用方法

PbootCMS使用{pboot:list}标签来调用文章列表，通过添加不同的参数可以筛选出特定类型的文章。

1. 调用置顶文章

html 复制代码

{pboot:list istop=1}
  <li><a href="[list:link]">[list:title]</a></li>
{/pboot:list}

2. 调用推荐文章

html 复制代码

{pboot:list isrecommend=1}
  <li><a href="[list:link]">[list:title]</a></li>
{/pboot:list}

3. 调用头条文章

html 复制代码

{pboot:list isheadline=1}
  <li><a href="[list:link]">[list:title]</a></li>
{/pboot:list}

二、高级筛选技巧

1. 按图片属性筛选

调用带缩略图的文章：

html 复制代码

{pboot:list isico=1}
  <div class="article-item">
    <img src="[list:ico]" alt="[list:title]">
    <h3><a href="[list:link]">[list:title]</a></h3>
  </div>
{/pboot:list}

调用无缩略图的文章：

html 复制代码

{pboot:list isico=0}
  <div class="article-item no-image">
    <h3><a href="[list:link]">[list:title]</a></h3>
    <p>[list:description lencn=100]</p>
  </div>
{/pboot:list}

调用带多图的文章（图集）：

html 复制代码

{pboot:list ispics=1}
  <div class="gallery-article">
    <h3><a href="[list:link]">[list:title]</a></h3>
    <div class="gallery-preview">
      <!-- 这里可以调用文章内的多张图片 -->
    </div>
  </div>
{/pboot:list}

2. 组合多个条件

PbootCMS支持同时使用多个筛选条件：

html 复制代码

{pboot:list istop=1 isrecommend=1 num=5}
  <div class="important-article">
    <span class="badge">置顶推荐</span>
    <h2><a href="[list:link]">[list:title]</a></h2>
  </div>
{/pboot:list}

3. 指定栏目下的特殊文章

html 复制代码

{pboot:list scode=2 istop=1 num=3}
  <!-- scode=2表示栏目ID为2 -->
  <li><a href="[list:link]">[list:title]</a></li>
{/pboot:list}

三、实际应用示例

1. 首页置顶文章专区

html 复制代码

<!-- 首页顶部置顶文章展示 -->
<section class="top-articles">
  <div class="container">
    <h2 class="section-title">重点推荐</h2>
    <div class="row">
      {pboot:list istop=1 num=3}
      <div class="col-md-4">
        <div class="top-article-card">
          <div class="image-wrap">
            {if [list:ico]}
            <img src="[list:ico]" alt="[list:title]">
            {else}
            <div class="no-image-placeholder">
              <i class="fa fa-file-text"></i>
            </div>
            {/if}
            <span class="top-badge">置顶</span>
          </div>
          <div class="content">
            <h3><a href="[list:link]">[list:title]</a></h3>
            <p class="summary">[list:description lencn=60]</p>
            <div class="meta">
              <span><i class="fa fa-clock-o"></i> [list:date style=Y-m-d]</span>
              <span><i class="fa fa-eye"></i> [list:visits]</span>
            </div>
          </div>
        </div>
      </div>
      {/pboot:list}
    </div>
  </div>
</section>

2. 侧边栏推荐文章列表

html 复制代码

<!-- 侧边栏推荐文章 -->
<div class="sidebar-recommend">
  <h3 class="sidebar-title">编辑推荐</h3>
  <ul class="recommend-list">
    {pboot:list isrecommend=1 num=8}
    <li class="recommend-item">
      <a href="[list:link]" title="[list:title]">
        <span class="index">[list:i]</span>
        <span class="title">[list:title lencn=20]</span>
        {if [list:istop]}
        <span class="label label-top">置顶</span>
        {/if}
      </a>
    </li>
    {/pboot:list}
  </ul>
</div>

3. 多条件组合筛选

html 复制代码

<!-- 头条且带图的文章 -->
{pboot:list isheadline=1 isico=1 num=4}
<div class="headline-with-image">
  <div class="row">
    <div class="col-sm-6">
      <a href="[list:link]">
        <img src="[list:ico]" alt="[list:title]" class="img-responsive">
      </a>
    </div>
    <div class="col-sm-6">
      <span class="headline-label">头条</span>
      <h2><a href="[list:link]">[list:title]</a></h2>
      <p>[list:description lencn=120]</p>
      <div class="meta-info">
        <span>发布时间：[list:date style=Y-m-d H:i]</span>
        <span>阅读：[list:visits]</span>
      </div>
    </div>
  </div>
</div>
{/pboot:list}

四、参数详解与注意事项

1. 常用参数说明

参数	说明	示例
`istop`	是否置顶（1=是，0=否）	`istop=1`
`isrecommend`	是否推荐（1=是，0=否）	`isrecommend=1`
`isheadline`	是否头条（1=是，0=否）	`isheadline=1`
`isico`	是否有缩略图（1=有，0=无）	`isico=1`
`ispics`	是否多图文章（1=是，0=否）	`ispics=1`
`num`	调用数量	`num=10`
`scode`	栏目ID	`scode=5`
`order`	排序方式	`order=date`

2. 重要注意事项

参数组合逻辑：多个参数同时使用时是"AND"（与）的关系，即同时满足所有条件。
性能优化：尽量避免同时使用过多筛选条件，特别是数据量较大时。
缓存机制：PbootCMS有缓存机制，修改参数后可能需要更新缓存才能看到效果。
分页处理：当调用文章数量较多时，考虑添加分页参数：
html 复制代码
```
{pboot:list istop=1 num=10 page=1}

{/pboot:list}
```

空数据判断：建议添加空数据提示：

html 复制代码

{pboot:if([list:count]>0)}
  {pboot:list istop=1}
    <!-- 列表内容 -->
  {/pboot:list}
{else}
  <div class="no-data">暂无置顶文章</div>
{/pboot:if}

五、扩展技巧

1. 使用自定义排序

html 复制代码

{pboot:list istop=1 order=sorting,date}
  <!-- 先按排序号排序，再按日期排序 -->
  <li>[list:title]</li>
{/pboot:list}

2. 时间范围筛选

html 复制代码

<!-- 调用最近7天的置顶文章 -->
{pboot:list istop=1 startdate=-7d}
  <li>[list:title] - [list:date style=Y-m-d]</li>
{/pboot:list}

3. 结合其他字段筛选

html 复制代码

<!-- 调用置顶且作者为"admin"的文章 -->
{pboot:list istop=1 author=admin}
  <li>[list:title] (作者：[list:author])</li>
{/pboot:list}

六、总结

通过合理使用PbootCMS的筛选参数，我们可以轻松调用各类特殊文章，满足不同的网站展示需求。关键点包括：

掌握基本参数：istop、isrecommend、isheadline等
理解参数组合逻辑：多个参数是"AND"关系
注意性能优化，合理控制调用数量
善用条件判断，处理空数据情况

这些技巧的灵活运用将大大提升PbootCMS网站的展示效果和用户体验。根据实际需求组合不同的参数，可以创建出丰富多样的内容展示模块。