帝国CMS“灵动标签”应用方法教程

帝国CMS“灵动标签”可以快速的实现很多前端显示效果，可以大大的节省我们使用帝国CMS开发网站的时间和成本。

​一、为什么选择灵动标签？​​

帝国CMS提供了多种标签（如万能标签、灵动标签、专题标签等），其中灵动标签是最常用、最灵活的一种。它本质上是一个封装好的SQL查询循环，允许你通过简单的参数设置，从任何数据表中调用任何数据，并以任意方式显示出来。它比万能标签更直观，比SQL标签更安全。

​二、灵动标签基本语法结构​

完整的灵动标签语法如下：

[e:loop={栏目ID/专题ID/SQL语句， 显示条数， 操作类型， 只显示有标题图片}]
    <!-- 这里是循环体 HTML 代码 -->
    <?php echo $bqr[‘字段名’]; ?>
[/e:loop]

在实际使用中，最常用的简化结构是：

[e:loop={选择参数， 显示条数， 排序条件}]
    <?=$bqr[‘字段名’]?>
[/e:loop]

​三、常用参数详解​

​1. 选择参数（第一个参数）：决定数据来源​

• ​数字（栏目ID）​​：1。表示调用栏目ID=1下面的所有信息。这是最常用的方式。栏目ID可以在“栏目管理”中看到。
• ​数据表名​：‘news’。表示直接从新闻数据表phome_ecms_news中取数据，不受栏目限制。
• ​SQL语句​：‘select * from [!db.pre!]ecms_news where classid=1’。这是最强大的方式，可以编写复杂的SQL查询条件。[!db.pre!]是一个系统变量，会自动替换成你安装时设置的数据表前缀。

​2. 显示条数（第二个参数）​​

• 数字：如 5、10。
• 格式 起始行， 条数：如 0，5（从第0行开始，取5条，即最前面的5条），5,5（从第5行开始，取5条，即第6到第10条，用于分页）。

​3. 排序条件（第三个参数）​​

• ‘id DESC’：按信息ID降序排列，即最新发布的信息在前。
• ‘id ASC’：按信息ID升序，最旧的信息在前。
• ‘onclick DESC’：按点击量降序，即热门信息在前。
• ‘newstime DESC’：按发布时间降序。
• ‘rand（）’：随机排序。

​四、循环体内变量（$bqr数组）​​

在 [e:loop]和 [/e:loop]之间，你可以使用 $bqr[‘字段名’]来输出当前循环到的信息的所有字段值。

​五、实战案例​

​案例1：调用指定栏目（ID=2）下的最新8篇文章​

<ul>
[e:loop={2, 8, ‘id DESC’}]
  <li>
    <a href=”<?=$bqr[‘titleurl’]?>“ title=”<?=$bqr[‘title’]?>“><?=$bqr[‘title’]?></a>
    <span>(<?=date(‘m-d’， $bqr[‘newstime’])?>)</span>
  </li>
[/e:loop]
</ul>

​案例2：调用全站点击量最高的5篇热门文章​

<div class=“hot-news”>
  <h3>热门文章</h3>
  <ul>
    [e:loop={‘news’， 5, ‘onclick DESC’}]
      <li><a href=”<?=$bqr[‘titleurl’]?>“><?=$bqr[‘title’]?></a></li>
    [/e:loop]
  </ul>
</div>

​案例3：调用特定栏目（ID=3）下，带有标题图片的推荐信息​

<div class=“pic-news”>
  [e:loop={3, 6, ‘id DESC’， 1}] <!– 最后一个参数 ‘1’ 表示只调用有标题图片的信息 –>
    <div class=“item”>
      <a href=”<?=$bqr[‘titleurl’]?>“><img src=”<?=$bqr[‘titlepic’]?>“ alt=”<?=$bqr[‘title’]?>“></a>
      <p><a href=”<?=$bqr[‘titleurl’]?>“><?=$bqr[‘title’]?></a></p>
    </div>
  [/e:loop]
</div>

​六、总结​

灵动标签是帝国CMS模板制作的灵魂。通过灵活组合选择参数、排序条件和循环体内的变量，你可以实现几乎任何形式的内容调用。掌握它，你就真正掌控了帝国CMS的页面内容展示。​

强烈建议​：将帝国CMS官方自带的“标签手册”作为参考资料，随时查阅更多高级用法和参数。