适用范围
内容调用通用循环标签可以在模板内任何位置进行内容列表的调用
循环基本格式
基本循环
<!--循环前缀:{table="content" 属性="值" }--> 循环调用信息 <!--/循环前缀-->1. 2. 3.
循环前缀可以随意自定义但是只能为英文和下划线，循环内的所有循环前缀必须保持一致，否则会无法调用循环内的内容。
属性和值是循环内的条件属性，属性和值以等号作为区分，可以同时设置多个属性每个属性之间用空格分开。
属性和值是循环内的条件属性，属性和值以等号作为区分，可以同时设置多个属性每个属性之间用空格分开。
可调用属性
| 属性 | 功能 | 可用值 | 值说明 | 例子 | 必要 |
|---|---|---|---|---|---|
| id | 模型ID | 数字 | 后台模型管理中的ID，默认为全部模型，文章模型为1，单页模型为2，跳转模型为3 | 调用文章模型的内容 mid="1" | 否 |
| cid | 栏目ID | 数字 | 后台栏目中的列表ID，多个ID用英文逗号分隔开 | 调用栏目ID为1、2和3的内容 cid="1,2,3" | 否 |
| type | 内容调用属性 | sub | 调用cid栏目下的所有子栏目的内容，必须和cid配合使用，且cid不能为多个栏目ID | 调用栏目ID为4下的所有子栏目内容 cid="4" type="sub" | 否 |
| image | 形象图 | true | 调用带有形象图的内容 | 调用带有形象图的内容 image="true" | 否 |
| false | 调用不带有形象图的内容 |
调用不带有形象图的内容 image="false" |
|||
| position | 推荐位ID | 数字 | 调用置顶推荐位的内容，值为后台推荐位管理中的ID | 调用推荐位ID为1的内容 position="1" | 否 |
| expand | 扩展模型ID | 数字 |
本属性仅作为辅助属性，主要用于如果栏目绑定的扩展模型中的字段无法调用可以使用此属性重新定位。 当CID为多个时可以使用本属性作为辅助 |
重新定位扩展模型ID为1 expand="1" | 否 |
| where | 附加条件 | 字符串 | 标准SQL条件语句，条件内调用字段请用"<"和">"代替"{"和"}"作为标识 |
调用10条栏目为1的内容 where="cid=1" 调用所属栏目为指定字段的值 here="cid=<$class.cid>" |
否 |
| limit | 条数 | 数字 | 调用多少条内容 | 调用10条内容 limit="10" | 是 |
| order | 排序 | 字符 | 针对内容循环列表进行排序，标准SQL排序 | 按照内容更新时间从大到小 order="updatetime desc" | 是 |
| 按照内容更新时间从小到大 order="updatetime asc" | |||||
| rand | 随机排序 | true | 对内容列表进行随机排序，使用本属性时order属性将失效 | 对内容列表进行随机排序 rand="true" | 否 |
| related | 相关内容 | 数字 | 当本属性为内容ID时时则调用该内容的相关内容 | 调用内容ID为1的相关文章 related="1" | 否 |
| 字符串 | 当本属性为关键词时则调用本关键词相关的内容，关键词用,分割 | 调用关键词为duxcms的相关文章 related="duxcms" |
字段基本格式
循环内的字段调用必须包含在循环内且循环前缀必须一致，否则调用无效或报错，下面是字段基本格式：
{$循环前缀.字段}
1.
例如调用内容标题：{$list.title}，下面是可用字段说明
可用字段
| 属性 | 功能 |
|---|---|
| aid | 内容ID |
| cid | 所属栏目ID |
| title | 内容标题 |
| titlex | 带样式的内容标题如颜色和加粗 |
| urltitle | 标题英文URL名 |
| subtitle | 副标题名称 |
| keywords | 内容关键词 |
| description | 内容描述 |
| updatetime | 内容最后更新时间(需要使用时间格式化标签) |
| inputtime | 内容插入时间(需要使用时间格式化标签) |
| image | 内容形象图 |
| url | 内容跳转地址 |
| copyfrom | 内容来源 |
| views | 内容浏览量 |
| aurl | 内容超链接地址 |
| cname | 内容所属栏目名称 |
| csubname | 内容所属栏目副名称 |
| curl | 内容所属栏目的超链接地址 |
| i | 循环序列 |
| 扩展字段 | 扩展模型中的字段以添加的扩展字段名为准直接调用即可 |
实例展示
调用10条栏目ID为1下的所有的子内容
<!--list:{table="content" type="sub" cid="1" order="updatetime desc" limit="10"}--> <li> <a href="{$list.aurl}">{$list.titlex}</a> </li> <!--/list-->1. 2. 3.
效果如下：
内容标题一
内容标题二
内容标题三
内容标题四
内容标题五
....
....
调用5个顶级栏目，并且各调用出他们栏目下的所有子内容
<!--channel:{table="category" type="top" order="cid asc" limit="5"}--> <div> <h2>{$channel.name}</h2> <ul> <!--list:{table="content" type="sub" cid="<$channel.cid>" order="updatetime desc" limit="10"}--> <li> <a href="{$list.aurl}">{$list.title}</a> </li> <!--/list--> </ul> </div> <!--/channel-->1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
效果如下：
内容标题一
内容标题三
内容标题二
内容标题三
...
栏目一
栏目二
...