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