聯(lián)系官方銷(xiāo)售客服
1835022288
028-61286886
一、作用
用于循環(huán)查詢多個(gè)模塊內(nèi)容數(shù)據(jù)（支持分頁(yè)查詢）
二、語(yǔ)法
{modules module=模塊名稱(chēng)1,模塊名稱(chēng)2 field=字段1,字段2 ....}{/modules}
三、參數(shù)介紹
| 參數(shù) | 介紹 |
|---|---|
| module | 模塊名稱(chēng)，填寫(xiě)至少兩個(gè)模塊目錄以上，例如news,image,book |
| site | 站點(diǎn)id，默認(rèn)當(dāng)前站點(diǎn)，填寫(xiě)其他站點(diǎn)id表示查詢其他站點(diǎn)的模塊數(shù)據(jù) |
| catid | 欄目id，支持多個(gè)欄目以小寫(xiě)分號(hào)分開(kāi)，例如1,2,3,4 |
| field | 可用字段，多個(gè)字段以小寫(xiě)分號(hào)分開(kāi)，默認(rèn)全部字段 |
| order | 排序方式，多個(gè)排序以小寫(xiě)分號(hào)分開(kāi)，默認(rèn)降序排列，例如updatetime_asc表示按更新時(shí)間升序排列 |
| num | 表示顯示數(shù)量，支持定點(diǎn)查詢，例如1,2表示從第1條記錄開(kāi)始，共顯示2條數(shù)據(jù) |
| more | modules標(biāo)簽不支持 |
| flag | 推薦位id，多個(gè)推薦位用,分隔 |
| not_flag | 排除推薦位id，排除多個(gè)推薦位用,分隔 |
| join | modules標(biāo)簽不支持 |
| on | modules標(biāo)簽不支持 |
| page | 當(dāng)page=1時(shí)表示開(kāi)啟分頁(yè)查詢，否則pagesize與urlrule是不會(huì)生效的 |
| pagesize | 分頁(yè)顯示數(shù)據(jù)量（當(dāng)存在catid時(shí)會(huì)自動(dòng)取該欄目設(shè)置的數(shù)量，修改欄目-模塊設(shè)置-設(shè)置數(shù)量即可） |
| urlrule | 分頁(yè)地址規(guī)則：[page]表示分頁(yè)標(biāo)識(shí)符（當(dāng)存在catid時(shí)會(huì)自動(dòng)取該欄目設(shè)置的URL分頁(yè)規(guī)則） |
| sbpage | modules標(biāo)簽不支持 |
| 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.字段值} |
四、返回變量
| 變量 | 參數(shù) |
|---|---|
| {$debug} | 當(dāng)查詢不到數(shù)據(jù)時(shí)，會(huì)返回錯(cuò)誤信息，調(diào)試模板時(shí)很有用哦（寫(xiě)在標(biāo)簽以外） |
| {$total} | 用于分頁(yè)時(shí)查詢的總記錄數(shù)量（寫(xiě)在標(biāo)簽以外） |
| {$count} | 當(dāng)前查詢的記錄，當(dāng)存在分頁(yè)時(shí)，表示當(dāng)前頁(yè)的記錄數(shù)（寫(xiě)在標(biāo)簽以外） |
| {$nums} | 用于分頁(yè)時(shí)返回總的頁(yè)數(shù)（寫(xiě)在標(biāo)簽以外） |
| {$pagesize} | 用于分頁(yè)時(shí)返回當(dāng)前每頁(yè)查詢數(shù)量（寫(xiě)在標(biāo)簽以外） |
| {$pages} | 顯示分頁(yè)代碼（寫(xiě)在標(biāo)簽以外） |
| {$key} | 當(dāng)前記錄指針位置，從0開(kāi)始（寫(xiě)在標(biāo)簽以內(nèi)） |
| {$return} | 當(dāng)前查詢的結(jié)果集數(shù)組 |
| 當(dāng)存在return=字母時(shí)，以上變量都要寫(xiě)成這種格式{$變量_字母}，例如{...reutrn=a}時(shí)，變量格式{$key_a} | |
| {$is_first} | 判斷是否第一條，{if $is_first}第一條{/if} |
| {$is_last} | 判斷是否最后一條，{if $is_last}最后一條{/if} |
五、顯示字段
在線生成顯示字段：http://223987.com/doc/code/field.html--t
六、字段查詢方法
| 修飾符 | 介紹 |
|---|---|
| LIKE_字段 | 模糊匹配查詢，例如LIKE_title=%名稱(chēng)%表示like title '%標(biāo)題%' |
| IN_字段 | IN子句查詢，例如IN_id=1,2,3,4表示id in (1,2,3,4) |
| NOTIN_字段 | NOTE IN子句查詢，例如NOTIN_id=1,2,3,4表示id not in (1,2,3,4) |
| BEWTEEN_字段 | 兩者之間查詢，例如BEWTEEN_id=1,100表示id在1到100的數(shù)據(jù) |
| BW_字段 | 同上，簡(jiǎn)寫(xiě) |
| NOT_字段 | 邏輯非查詢，例如NOT_name=1，表示name不能等1的數(shù)據(jù) |
| 字段=值 | 字段條件查詢，例如uid=1表示會(huì)員id=1的數(shù)據(jù) |
七、部分實(shí)例
1、共同查詢模塊：test,demo,news，num表示顯示10條，order表示按更新時(shí)間排序，默認(rèn)cache緩存時(shí)間10小時(shí)
2、共同查詢模塊：test,demo,news，num表示顯示10條，order表示按人氣排序
3、共同查詢模塊：test,demo,news, 自定義分頁(yè)顯示數(shù)據(jù)（可以在任何頁(yè)面）
4、共同查詢模塊：test,demo,news，只顯示推薦位1的10條內(nèi)容（4.3.12起可使用）
5、共同查詢模塊：test,demo,news，只顯示推薦位1,2,3的10條內(nèi)容（4.3.12起可使用）
6、共同查詢模塊：test,demo,news，只顯示欄目1,2,3的10條內(nèi)容（4.3.12起可使用）
如果遇到以下錯(cuò)誤時(shí)：
Illegal mix of collations for operation “UNION”
說(shuō)明field參數(shù)的字段存在不一樣的編碼，通過(guò)phpmyadmin工具把他們的編碼改為一致的就行了
模板標(biāo)簽里面多模塊查詢標(biāo)簽（modules）時(shí)候，url只有系統(tǒng)域名沒(méi)有具體地址，應(yīng)該是mid沒(méi)有傳入，flied字段需要怎么加mid。order好像沒(méi)有生效，在調(diào)試的時(shí)候看sql語(yǔ)句沒(méi)有order如
如何調(diào)用全站所有模塊最新發(fā)布的5條內(nèi)容
調(diào)用多欄目下的內(nèi)容為什么調(diào)用不出來(lái)了
模板標(biāo)簽里面隨機(jī)輸出單個(gè)模塊是“news”{modulemodule=newsorder=randnum=10}如果我要隨機(jī)輸出全站的文章應(yīng)該是怎么參數(shù)！謝謝??！
請(qǐng)問(wèn)這里能不能應(yīng)用兩個(gè)模塊？一個(gè)新聞模塊一個(gè)軟件版塊，如果可以應(yīng)用兩個(gè)，那該怎么應(yīng)用呢？
