一、語法
{list action=category module=模塊名稱 ....}{/list}
簡寫(3.2.19以上版本支持):{category module=模塊名稱 ....}{/category}
二、參數介紹(紅色表示必填參數,藍色表示系統默認參數)
參數 | 介紹 |
---|---|
action | category |
module | 模塊名稱,默認當前模塊(僅在模塊模板中有效),例如新聞模塊,填寫news |
site | 站點id,默認當前站點,填寫其他站點id表示查詢其他站點的模塊數據 |
id | 欄目id,支持多個欄目以小寫分號分開,例如1,2,3,4 |
show | 有show參數表示顯示隱藏導航(無論show=幾都有效) |
pid | 當前id下的所有下級欄目,pid只能是一個整數,當期為0時表示頂級欄目 |
num | 表示顯示數量,只能是一個整數 |
letter | 首字母匹配的欄目 |
more | 當more=1時,才顯示欄目的setting內容和自定義擴展屬性內容 |
return | 默認返回變量為t,調用方式就是{$t.字段值}(多級list查詢必須設置return=其他字母,否則你懂得) |
三、返回變量
變量 | 參數 |
---|---|
{$error} | 當查詢不到數據時,會返回錯誤信息,調試模板時很有用哦(寫在list標簽以外) |
{$count} | 當前查詢的記錄,當存在分頁時,表示當前頁的記錄數(寫在list標簽以外) |
{$key} | 當前記錄指針位置,從0開始(寫在list標簽以內) |
當存在return=字母時,以上變量都要寫成這種格式{$變量_字母},例如{list ...reutrn=a}時,變量格式{$key_a} | |
{$is_first} | 判斷是否第一條,{if $is_first}第一條{/if} |
{$is_last} | 判斷是否最后一條,{if $is_last}最后一條{/if} |
四、顯示字段
{$t.字段名稱}或者{$t['字段名稱']}
其他字段請參看后臺“數據結構”中單擊相應的表就知道了,字段有說明的
五、相關例子
1、查詢新聞news模塊的所有頂級欄目
{list action=category module=news pid=0} 欄目名稱{$t.name} 欄目地址{$t.url} {/list}
2、查詢當期模塊的指定id為1,2,3,4的欄目
{list action=category module=news id=1,2,3,4} 欄目名稱{$t.name} 欄目地址{$t.url} {/list}
3、兩級循環顯示欄目(先循環父欄目,再循環其子欄目)
{list action=category pid=0 return=c1} 我是父欄目:{$c1.name}<br> {list action=category pid=$c1.id return=c2} 我是{$c1.name}的子欄目:{$c2.name}<br> {/list} {/list}
如果有三級欄目,以此類推,不再舉例了,我相信你的能力
4、查詢news模塊中的以a字母開頭的欄目
{list action=category module=news letter=a} 欄目名稱{$t.name} 欄目地址{$t.url} {/list}
5、查詢news模塊中的屬性配置
{list action=category module=news more=1} 欄目名稱{$t.name} 欄目屬性seo標題{$t['setting']['seo']['list_keywords']} {/list}
文檔最后更新時間:2018-09-29 10:29:17