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