一、作用
用于循環(huán)查詢模塊內(nèi)容數(shù)據(jù)（支持分頁查詢）
二、語法
{module module=模塊名稱 ....}{/module}
三、參數(shù)介紹
| 參數(shù) | 介紹 |
|---|---|
| module | 模塊名稱，默認為當前模塊（僅在模塊模板中有效），例如新聞模塊，填寫news，只能填寫一個模塊目錄 |
| site | 站點id，默認當前站點，填寫其他站點id表示查詢其他站點的模塊數(shù)據(jù) |
| catid | 欄目id，支持多個欄目以小寫逗號分開，例如1,2,3,4 |
| field | 可用字段，多個字段以小寫逗號分開，默認全部字段 |
| order | 排序方式，多個排序以小寫逗號分開，默認降序排列，例如updatetime_asc表示按更新時間升序排列 |
| num | 表示顯示數(shù)量，支持定點查詢，例如1,2表示從第1條記錄開始，共顯示2條數(shù)據(jù) |
| more | 當?shù)扔趍ore=1時表示查詢欄目模型字段，附表字段不支持查詢 |
| flag | 推薦位id，多個推薦位用,分隔 |
| not_flag | 排除推薦位id，排除多個推薦位用,分隔 |
| join | 關(guān)聯(lián)表查詢 |
| on | 關(guān)聯(lián)條件，格式為on=關(guān)聯(lián)字段,被關(guān)聯(lián)字段 |
| maxlimit | 當分頁時，限制最多查詢多少條數(shù)據(jù)量 |
| page | 當page=1時表示開啟分頁查詢，否則pagesize與urlrule是不會生效的 |
| pagesize | 分頁顯示數(shù)據(jù)量（當存在catid時會自動取該欄目設(shè)置的數(shù)量，修改欄目-模塊設(shè)置-設(shè)置數(shù)量即可） |
| urlrule | 分頁地址規(guī)則：[page]表示分頁標識符（當存在catid時會自動取該欄目設(shè)置的URL分頁規(guī)則） |
| sbpage | 當存在catid參數(shù)時又想按照自定義方式來分頁需要設(shè)置參數(shù)sbpage=1，表示強制按自定義分頁 |
| cache | 緩存時間單位秒，默認關(guān)閉緩存；當cache=3600時，表示緩存時間1小時，建議數(shù)據(jù)查詢的標簽都加上緩存參數(shù) |
| return | 默認返回變量為t，調(diào)用方式就是{$t.字段值} |
四、返回變量
| 變量 | 參數(shù) |
|---|---|
| {$debug} | 當查詢不到數(shù)據(jù)時，會返回錯誤信息，調(diào)試模板時很有用哦（寫在標簽以外） |
| {$total} | 用于分頁時查詢的總記錄數(shù)量（寫在標簽以外） |
| {$count} | 當前查詢的記錄，當存在分頁時，表示當前頁的記錄數(shù)（寫在標簽以外） |
| {$nums} | 用于分頁時返回總的頁數(shù)（寫在標簽以外） |
| {$pagesize} | 用于分頁時返回當前每頁查詢數(shù)量（寫在標簽以外） |
| {$pages} | 顯示分頁代碼（寫在標簽以外） |
| {$key} | 當前記錄指針位置，從0開始（寫在標簽以內(nèi)） |
| {$return} | 當前查詢的結(jié)果集數(shù)組 |
| 當存在return=字母時，以上變量都要寫成這種格式{$變量_字母}，例如{...reutrn=a}時，變量格式{$key_a} | |
| {$is_first} | 判斷是否第一條，{if $is_first}第一條{/if} |
| {$is_last} | 判斷是否最后一條，{if $is_last}最后一條{/if} |
五、顯示字段
在線生成顯示字段：http://www.apdwn.com/doc/code/field.html--t
每個字段類型的輸出方式不一樣
六、字段查詢方法
| 修飾符 | 介紹 |
|---|---|
| LIKE_字段 | 模糊匹配查詢，例如LIKE_title=%名稱%表示like title '%標題%' |
| IN_字段 | IN子句查詢，例如IN_id=1,2,3,4表示id in (1,2,3,4) |
| NOTIN_字段 | NOT 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_字段 | 同上，簡寫 |
| NOT_字段 | 邏輯非查詢，例如NOT_name=1，表示name不能等1的數(shù)據(jù) |
| 字段=值 | 字段條件查詢，例如uid=1表示會員id=1的數(shù)據(jù) |
七、部分實例
1、顯示文章指定欄目1的數(shù)據(jù)，num表示顯示10條，order表示按更新時間排序，默認cache緩存時間10小時
2、顯示文章指定欄目1,2,3,4,5數(shù)據(jù)，num表示顯示10條，order表示按人氣排序
3、顯示文章在站點2的數(shù)據(jù)
4、顯示其他模塊photo的數(shù)據(jù)
5、分頁顯示文章模塊的欄目為10的數(shù)據(jù)（當存在catid參數(shù)時只需加page參數(shù)就能分頁輸出）
6、自定義分頁顯示文章模塊的數(shù)據(jù)（本例子用于網(wǎng)站首頁）
7、推薦位查詢,flag表示推薦位的id號，后臺可以看到，你懂得
8、錯誤排查方式，必須掌握，很實用
9、顯示news模塊的帶縮略圖的10條文章并按時間先后順序排列
10、隨機調(diào)用news模塊的10條內(nèi)容
11、調(diào)用欄目1的內(nèi)容和模型字段的內(nèi)容
12、欄目模型字段調(diào)用
13、查詢某個會員發(fā)布的news內(nèi)容
14、查詢當前內(nèi)容的作者的全部發(fā)布news內(nèi)容
15、前端列表排序方式按照后臺設(shè)定的排序值來顯示方法
order=displayorder,updatetime
本文地址：http://www.apdwn.com/doc/15.html
技術(shù)求助：不會操作怎么辦？點擊前往技術(shù)求助！
文檔修改：
文檔有誤、不完善、我來提醒官方修改此文檔（5）