一、語法
{list action=related tag=標簽名稱 module=模塊名稱 ....}{/list}
簡寫(3.2.19以上版本支持):{related tag=標簽名稱 module=模塊名稱 ....}{/related}
二、參數(shù)介紹(紅色表示必填參數(shù),藍色表示系統(tǒng)默認參數(shù))
| 參數(shù) | 介紹 |
|---|---|
| action | related |
| tag | 標簽名稱,支持多個標簽以小寫分號分開,例如tag=關(guān)鍵字1,關(guān)鍵字2 |
| module | 模塊名稱,默認當前模塊(僅僅),例如新聞模塊,填寫news |
| site | 站點id,默認當前站點,填寫其他站點id表示查詢其他站點的模塊數(shù)據(jù) |
| field | 可用字段,多個字段以小寫分號分開,默認全部字段(為了提高緩存效率,建議填寫此選項) |
| num | 表示顯示數(shù)量,支持定點查詢,例如1,2表示從第1條記錄開始,共顯示2條數(shù)據(jù) |
| cache | 緩存時間單位秒,默認關(guān)閉緩存;當cache=3600時,表示緩存時間1小時,建議數(shù)據(jù)查詢的標簽都加上緩存參數(shù) |
| return | 默認返回變量為t,調(diào)用方式就是{$t.字段值}(多級list查詢必須設(shè)置return=其他字母,否則你懂得) |
三、返回變量
| 變量 | 參數(shù) |
|---|---|
| {$error} | 當查詢不到數(shù)據(jù)時,會返回錯誤信息,調(diào)試模板時很有用哦(寫在list標簽以外) |
| {$sql} | 顯示當前查詢的sql語句,調(diào)試模板時候很有用哦(寫在list標簽以外) |
| {$total} | 用于分頁時查詢的總記錄數(shù)量(寫在list標簽以外) |
| {$count} | 當前查詢的記錄,當存在分頁時,表示當前頁的記錄數(shù)(寫在list標簽以外) |
| {$pages} | 顯示分頁代碼(寫在list標簽以外) |
| {$key} | 當前記錄指針位置,從0開始(寫在list標簽以內(nèi)) |
| 當存在return=字母時,以上變量都要寫成這種格式{$變量_字母},例如{list ...reutrn=a}時,變量格式{$key_a} | |
| {$is_first} | 判斷是否第一條,{if $is_first}第一條{/if} |
| {$is_last} | 判斷是否最后一條,{if $is_last}最后一條{/if} |
四、顯示字段
{$t.字段名稱}或者{$t['字段名稱']}
五、相關(guān)例子
1、在當前模塊中查詢關(guān)鍵字為:中國、美國、日本,的文章
{list action=related field=title,url tag=中國,美國,日本}
<a href="{$t.url}" data_ue_src="{$t.url}">{$t.title}</a>
{/list}
{$error}2、查詢自定模塊news的相關(guān)”中國、上海“的文章,只顯示5條
{list action=related module=news field=title,url tag=中國,上海 num=5}
<a href="{$t.url}" data_ue_src="{$t.url}">{$t.title}</a>
{/list}
{$error}
文檔最后更新時間:2018-09-29 12:30:19