dedecms arclist 参数有哪些？如何正确使用？

arclist 标签主要用于获取并列表显示文章、图集等文档内容，相当于一个万能的内容调用器，无论是在首页、列表页还是内容页，你都可以用它来调用其他栏目的文章、热门文章、推荐文章等。

基本语法

arclist 标签的基本语法结构如下：

{dede:arclist}
    <a href="[field:arcurl/]">[field:title/]</a>
    <span>[field:pubdate function="MyDate('Y-m-d',@me)"/]</span>
    <p>[field:description function="cn_substr(@me, 100)"/]...</p>
{/dede:arclist}

• {dede:arclist}: 开始标签，用于定义调用参数。
• 循环体内的内容，即每一条文章的显示样式。
• {/dede:arclist}: 结束标签。

循环体内通过 [field:字段名/] 或 [field:字段名 function="处理函数"/] 的方式来获取文章的各个字段信息。

核心参数说明

arclist 的强大之处在于其丰富的参数，下面我将参数分为几类，方便你理解和查找。

栏目限制参数

这些参数用于控制从哪些栏目中获取文章。

数量与排序参数

这些参数控制调用的文章数量和显示顺序。

条件过滤参数

这些参数用于对文章进行筛选,如只调用推荐文章、只调用有缩略图的文章等。

高级功能参数

常用调用示例

示例1：调用指定栏目的最新文章

调用栏目ID为 1 的最新5篇文章，标题长度限制为30个字。

{dede:arclist typeid='1' row='5' titlelen='30'}
    <li><a href="[field:arcurl/]" title="[field:title/]">[field:title/]</a></li>
{/dede:arclist}

示例2：调用全站的头条文章

调用全站所有被设为“头条”的文章，按点击量排序，显示10条。

{dede:arclist flag='h' orderby='click' row='10'}
    <li><a href="[field:arcurl/]" target="_blank">[field:title/]</a></li>
{/dede:arclist}

示例3：调用带有缩略图的文章

调用栏目ID为 2 和 3 的文章，只显示有缩略图的，并显示缩略图、标题和简介。

{dede:arclist typeid='2,3' row='4' imgwidth='120' imgheight='90'}
    <div class="item">
        <a href="[field:arcurl/]"><img src="[field:litpic/]" alt="[field:title/]" width="120" height="90" /></a>
        <h3><a href="[field:arcurl/]">[field:title/]</a></h3>
        <p>[field:description function='cn_substr(@me, 80)'/]...</p>
    </div>
{/dede:arclist}

注意：[field:litpic/] 用于获取文章的缩略图地址。

示例4：排除某个栏目并按权重排序

调用除了栏目ID为 5 之外的所有文章，按“权重”（sortrank）降序排列，显示8条。

{dede:arclist typeid='not5' orderby='sortrank' orderway='desc' row='8'}
    <a href="[field:arcurl/]" title="[field:title function='htmlspecialchars(@me)'/]">[field:title/]</a>
{/dede:arclist}

示例5：调用指定时间段内的热门文章

调用最近7天内发布的、点击量最高的5篇文章。

{dede:arclist subday='7' orderby='click' row='5'}
    <a href="[field:arcurl/]">[field:title/]</a> ([field:click/]次点击)
{/dede:arclist}

注意：[field:click/] 用于获取文章的点击量。

常用字段调用

在 {dede:arclist} 循环体内，你可以使用以下常用字段：

处理函数：很多时候，需要对字段值进行格式化处理，这时就需要使用 function。

• 日期格式化：[field:pubdate function='MyDate("Y-m-d H:i", @me)'/]
  • MyDate 是DedeCMS的日期处理函数。
  • "Y-m-d H:i" 是你想要的日期格式。
  • @me 代表当前字段的原始值。
• 截取字符串：[field:title function='cn_substr(@me, 20)'/]
  • cn_substr 是DedeCMS的截取字符串函数，支持中英文混合。
  • 20 是要截取的长度。
• 去除HTML标签：[field:description function='htmlspecialchars(strip_tags(@me))'/]
  • strip_tags 去除HTML标签。
  • htmlspecialchars 转义HTML特殊字符，防止XSS攻击。

重要注意事项

1. 性能优化：arclist 是一个非常消耗数据库资源的标签，尤其是在首页或调用大量数据时，尽量避免在首页使用无限制的 arclist 调用。
2. limit vs row：当需要分页或指定起始位置时，使用 limit 参数，如果只需要固定数量，使用 row 即可。
3. flag 参数的灵活性：flag 参数非常强大，可以组合使用，如 flag='h,c' 表示同时是头条和推荐。
4. 官方文档：DedeCMS的官方文档是最好的参考资料，虽然可能有些陈旧，但大部分参数和说明依然是准确的。

希望这份详细的 arclist 参数指南能帮助你更好地使用 DedeCMS！