一文讲透phpcms列表标签调用方法 新手也能轻松上手

为啥你搞phpcms列表标签调用总出问题？

前两年帮一个开五金店的老板改官网模板，他自己跟着网上瞎教程折腾，调列表调了整整三天，半夜两点给我发语音吐槽，说要么整站内容全蹦出来，要么啥都不显示，跟摆摊摆错了货柜似的，白瞎了一下午功夫。我上去一看，得，连最基础的phpcms列表标签调用方法都没搞对，参数写错还漏了闭合标签，这不纯纯给自己找罪受嘛。

我做网站快十年了，摸phpcms也快十年，踩过的坑比你喝过的奶茶还多，今天就把我压箱底的经验掏出来，给你把phpcms列表标签调用方法掰碎了讲，你直接抄作业就行，不用自己瞎摸。

先唠唠最基础的phpcms列表标签调用方法

咱们打个接地气的比方哈，把phpcms建站比作你去赶集摆地摊：你的所有文章内容就是你放在仓库里的货，不同分类就是不同品类的货，你要把对应品类摆到摊子对应的位置，这个帮你从仓库掏货摆整齐的小弟，就是phpcms的列表标签。你喊不对小弟的名字，说不清楚要啥货，他当然给你拿不对对吧？所以先把基础的调用格式记牢，phpcms列表标签调用方法的核心就是格式对、参数准，没那么多花里胡哨的。

新手直接抄的基础通用代码

别到处搜乱七八糟的教程了，我帮你试过N次，这个基础格式百分百能用，适合栏目页调用当前分类的列表：

``` {pc:content action="listing" catid="$catid" num="10" page="$page"}

{loop $data $r}
• {str_cut($r[title], 24, '...')}
{/loop}

{/pc} ```

我给你把每个参数掰碎了说，还是用摆地摊那套：action="listing"就是你跟小弟说我要的是分类列表，不是别的杂活，别拿错东西；catid="$catid"就是说就拿当前这个摊子对应分类的货，别把隔壁袜子摊的货拿我这来；num="10"就是一次摆10件，摊子小摆多了放不下；page="$page"就是货多了分页，让客人翻页看下一波，那个{str_cut($r[title], 24, '...')}就是标题太长了截一下，超出24个字就用省略号代替，不挤版面，太实用了对不对？

很多新手刚学phpcms列表标签调用方法的时候，总觉得参数多记不住，其实根本不用死记硬背，翻来覆去就那几个常用参数，phpcms列表标签调用方法真的没你想的那么难，试两次就会了。

这些坑我全帮你踩过了，别再跳了

我见过至少上千个新手，栽在同一个坑里，今天给你列出来，避坑指南直接拿好：

• 坑一：忘记写PC标签的闭合标签

  好多人写了开头{pc:content}，结尾忘加{/pc}，这就相当于你摆完摊不收摊，下雨了货全淋湿，整个页面直接报错白屏，我刚学phpcms列表标签调用方法的时候就犯过这个错，找了俩小时才找到问题，说出来都是泪。

• 坑二：catid参数写错，调用错分类

  你想要首页调用新闻分类，结果填成了产品分类的ID，出来的全是你不想要的内容，这不就相当于你想要袜子结果掏出来一堆螺丝刀，货不对板太尴尬。我教你个笨办法：分类ID直接去后台「管理栏目」那里看，清清楚楚明明白白，别瞎蒙，phpcms列表标签调用方法里，参数错一个都不行，别偷懒。

• 坑三：首页调用直接复制栏目页代码，啥都出不来

  很多人把上面的基础代码直接粘到首页，结果一片空白，为啥？因为首页根本没有当前栏目ID啊，$catid在首页识别不出来！你直接写死你要调用的分类ID不就完了？想要调用ID是2和3的分类，直接写catid="2,3"就行，就这么简单，我当初刚学phpcms列表标签调用方法的时候，就在这卡了一下午，说出来真丢撵。

常用特殊场景的phpcms列表标签调用方法，直接用

咱们做网站，90%的需求都是那几个场景，我把对应调用方法都给你整理好了，拿过去改改参数就能用：

首页调用多个分类的最新内容

做网站首页，谁不要放几个分类的最新内容引流啊？phpcms列表标签调用方法太简单了，多个分类ID用逗号隔开就行，按发布时间倒序，最新的放最前面，代码直接抄：

``` {pc:content action="listing" catid="1,3,5" num="12" order="id DESC"}

{loop $data $r}
• {str_cut($r[title], 20, '...')}
{/loop}

{/pc} ```

调用热门点击排行榜

想要放个热门文章/热门产品榜吸引点击？改个排序参数就行，phpcms列表标签调用方法里，把排序改成按点击量倒序就ok：order="hits DESC"，卖的最好、点击最高的自动放最前面，跟你摆摊把爆品放最前面吸引人流一个道理，完美适配所有需求。

调用带缩略图的文章列表

做图文列表需要显示缩略图？只需要加一个参数thumb="1"，然后循环里输出缩略图地址就行，代码片段给你：

``` {pc:content action="listing" catid="$catid" num="8" thumb="1"} {loop $data $r}

{$r[title]}

{/loop} {/pc} ```

其实说白了啊，phpcms列表标签调用方法真的没网上说的那么玄乎，很多人把它说的多么高深，其实咱们日常改模板做调用，就会上面这些，就能搞定90%的常用需求了。我跟你说句掏心窝子的，我不是卖课也不是卖程序的，就是个踩了十几年坑的老站长，知道新手学的时候找对教程有多难，当年我学的时候，网上的教程全是抄来抄去，错漏百出，我花了一个星期才摸清楚这些规则，现在我给你整理好了，你直接抄作业就行，省下来的时间喝杯奶茶不好吗？

说句土味真心话啊，只要你肯动手试一遍，保准你十分钟就能学会phpcms列表标签调用方法，我那个初中毕业开五金店的客户都学会自己改了，你肯定也没问题。遇到问题别慌，把这篇收藏起来，用的时候掏出来看看，比你瞎搜半天乱七八糟的教程靠谱多了。