LECMS怎么调用文章列表

照着这篇做完，你就能在 LECMS 任意模板里把指定栏目的文章列表调出来，并控制条数、排序和显示字段。

第一步：确认要调用的栏目 ID

这一步要做的是拿到栏目的数字 ID，它是后面标签里最重要的参数，填错了页面不会报错，只是列表一片空白。

登录后台（默认入口是 /admin.php，如果你改过就按实际地址），左侧菜单进「内容管理 → 栏目管理」，在栏目列表里每个栏目名称后面或表格的「ID」列就是栏目编号，比如 10。如果栏目很多，鼠标移到栏目名上，浏览器状态栏显示的链接里 catid=10 这类参数也能看出 ID。

注意：顶级栏目和子栏目的 ID 是不同的，调子栏目文章必须填子栏目的 ID，填父栏目只会调出该父栏目直属的文章。

第二步：找到要改的模板文件

这一步是定位代码写在哪，改完才能在页面上看到结果。

用 FTP 或主机文件管理器进入站点根目录下的 template/ 目录，里面是各套模板的文件夹。常见的文件名约定：首页 index.html、栏目列表页 list.html、文章内容页 show.html。也可以直接在后台进「模板管理」，找到对应模板点击在线编辑，效果一样，改完记得点保存。

第三步：写入文章列表标签

在模板里想显示列表的位置插入下面这段标签，保存后刷新前台页面，就能看到文章列表。

{list catid="10" num="10" order="id DESC"}
  <li>
    <a href="{$list.url}" title="{$list.title}">{$list.title}</a>
    <span>{$list.inputtime|date="Y-m-d"}</span>
    <p>{$list.description}</p>
  </li>
{/list}

标签的结构是固定的：{list 参数} 开始，{/list} 结束，中间每个循环项用 {$list.字段名} 取值。

注意：部分 LECMS 版本标签前缀写作 {lecms:list}，循环变量默认名是 vo 而不是 list。以后台「标签说明 / 标签向导」页面里实际给出的写法为准，改前缀时循环变量名要跟着一起改，写成 {$vo.title} 才有效。

第四步：按需要调整参数

常用的几个参数如下，直接写在开始标签里，用空格分隔：

• catid：栏目 ID，多个栏目用英文逗号隔开，如 catid="10,11"；填 catid="0" 一般表示不限栏目。
• num：调用条数，如 num="8"。
• order：排序方式，最新在前写 order="id DESC"，按发布时间写 order="inputtime DESC"。
• thumb：thumb="1" 时只调有缩略图的文章。
• cache：缓存秒数，调试阶段建议写 cache="0"，避免改了看不到效果。

第五步：取用你需要的字段

在循环体里可以取到的常见字段有：title（标题）、url（文章链接）、thumb（缩略图地址）、description（摘要）、inputtime（发布时间）、catname（栏目名）、hits（点击数）。

输出缩略图时建议加个判断，避免没有图的文章出现空图：

{if $list.thumb}<img src="{$list.thumb}" alt="{$list.title}">{/if}

注意：url 字段通常已经是完整可点的地址，不要再手工拼域名，否则会出现双域名链接。

第六步：更新缓存后验证

改完模板后进后台「系统 → 缓存管理」，点「更新模板缓存」和「更新数据缓存」；如果页面还是旧内容，手动删除根目录 /runtime/ 或 /cache/ 下的缓存文件再刷新。验证时看三件事：条数对不对、链接能不能点开、排序是不是最新在前。

小结

• 调列表的核心是先拿对栏目 ID，再去对应模板文件里写 {list} 标签。
• 标签格式固定为 {list 参数}...{/list}，循环体用 {$list.字段} 取值。
• catid、num、order 是最常改的三个参数，调试时把 cache 设为 0。
• 标签前缀和循环变量名以本地后台标签说明为准，不同版本可能写作 {lecms:list} / {$vo.title}。
• 改完必须更新模板缓存，否则看不到变化。