W3Cschool
恭喜您成為首批注冊用戶
獲得88經驗值獎勵
標簽調用是根據(jù)調用條件(condition)從數(shù)據(jù)表(table)讀取調用數(shù)量(pagesize)條數(shù)據(jù),并按排序方式(order)排序,最終通過標簽模板的布局輸出數(shù)據(jù)。
可以看出,標簽的工作分兩個部分,一是讀取數(shù)據(jù),二是顯示數(shù)據(jù)。
標簽函數(shù)原型
標簽函數(shù)保存于 include/tag.func.phptag($parameter, $expires = 0)
$parameter 表示傳遞給tag函數(shù)的字符串,系統(tǒng)自動將其轉換為多個變量。
例如傳遞 table=destoon&pagesize=10&hello=world
系統(tǒng)相當于得到:
$table = 'destoon';
$pagesize = 10;
$hello = 'world';
三個變量
$expires 表示標簽緩存過期時間
0 緩存$expires秒;0 - 系統(tǒng)默認標簽緩存時間;-1 - 不緩存;-2 - 緩存SQL結果;
一般情況保持默認不需要傳遞。
數(shù)據(jù)讀取過程
例如以下標簽:<!--{tag("moduleid=5&condition=status=3&order=addtime desc&pagesize=10")}-->
會被轉換為如下的SQL語句:
SELECT *
FROM destoon_sell
WHERE status=3
ORDER BY addtime DESC
LIMIT 0,10
讀出的數(shù)據(jù)會保存在 $tags 數(shù)組里
通常情況下不需要寫table=xxx,應該寫moduleid=模塊ID,系統(tǒng)會自動對應模塊的表
數(shù)據(jù)顯示過程
1、通過標簽模板顯示
傳遞&template=abc給標簽函數(shù),例如:<!--{tag("moduleid=...&template=abc")}-->
默認的標簽模板保存在模板目錄/tag/目錄里,例如&template=abc將調用模板目錄/tag/abc.htm模板來顯示數(shù)據(jù)。
如果標簽模板存放于其他目錄,例如def,則傳遞&dir=def&template=abc,系統(tǒng)將調用模板目錄/def/abc.htm模板。
2、直接在模板里循環(huán)數(shù)據(jù)
<!--{php $tags=tag("moduleid=...&template=null");}-->
此寫法傳遞標簽模板為null,并且直接返回數(shù)據(jù)給$tags數(shù)組,此時可以直接在模板里循環(huán)了。
以下為一個完整的示例:
<!--{php $tags=tag("moduleid=...&template=null");}-->
{loop $tags $t}
...
{/loop}
第一種寫法一般用于多次調用的數(shù)據(jù),第二種寫法一般用于只調用一次的數(shù)據(jù)。
常用參數(shù)及含義
moduleid
moduleid指模塊ID,可在后臺模塊管理里查詢。對于直接調用模塊的數(shù)據(jù),設置正確的模塊ID后,將不需要傳遞table參數(shù),系統(tǒng)會自動獲取。
例如傳遞moduleid=5,系統(tǒng)將識別為調用供應信息,自動設置table參數(shù)為sell。
一般情況下,除了擴展模塊里的功能都需要通過moduleid來調用。
table
table指表名,可在后臺數(shù)據(jù)庫維護里查詢。對于Destoon系統(tǒng)表,不需要加表的前綴;對于非Destoon系統(tǒng)表,需要填寫完整的表名,且傳遞prefix參數(shù)。
例如對于Destoon系統(tǒng)表,傳遞table=announce,如果表前綴為destoon_,系統(tǒng)將識別表名為 destoon_announce。
對于非Destoon系統(tǒng)表,傳遞table=tbabc&prefix=或者table=abc&prefix=tb,系統(tǒng)將識別表名為 tb_abc。
fields
fields指查詢的字段,默認為*。可以傳遞例如 fields=title,addtime,但是一般情況下無需傳遞,Destoon獨有的標簽緩存機制會自動緩存查詢結果,不必擔心效率問題。
condition
condition指查詢的條件,如果不傳遞,則為1,代表任意條件的數(shù)據(jù)(此項需了解SQL語法)。Destoon所有模塊遵循統(tǒng)一標準開發(fā),所以很多條件是通用的。
例如 status=3表示正常通過的信息、status=3 and level=1表示級別為1的信息、status=3 and thumb<>''表示有標題圖片的信息等。
order
order指數(shù)據(jù)的排序方法(此項需了解SQL語法)。
例如order=addtime desc表示按添加時間降序排列、order=itemid desc表示按itemid降序排列、order=rand()表示隨機數(shù)據(jù)等。
pagesize
pagesize指調用數(shù)據(jù)的數(shù)量,如果不傳遞,默認為10。
template
template指指定的標簽模板,如果不傳遞,默認為list,位于模板目錄/tag/list.htm,如果傳遞為null,表示不應用標簽模板。參見上述數(shù)據(jù)顯示過程。
debug
debug參數(shù)用于調試標簽,例如傳遞&debug=1,系統(tǒng)將輸出標簽構造成的SQL語句,以便驗證標簽寫法是否正確,不需要調試的標簽不用加此參數(shù)。
&和and的區(qū)別
&用來分割參數(shù),and是sql語句where后的讀取條件,二者完全不同。
多表聯(lián)合查詢
例如查詢會員名為destoon的會員和公司資料,可以使用:
{tag("table=destoon_member m,destoon_company c&prefix=&condition=m.userid=c.userid and m.username='destoon'&template=list-com")}
destoon_member和destoon_company是表的實際名稱(包含表前綴),prefix=表示系統(tǒng)不再自動在表名前加前綴。
通常通過傳遞moduleid可以實現(xiàn)大部分的調用,除非您確認熟悉聯(lián)合查詢,否則不推薦使用。
截至目前,系統(tǒng)默認模板里還沒有一個功能需要用到聯(lián)合查詢。
控制標題長度
在標簽里傳遞length參數(shù),例如&length=20表示20個字符長度(一個漢字占2個字符),一般情況建議用css隱藏多余字符(定義height和overflow:hidden)。
傳遞length參數(shù),系統(tǒng)僅對title字段自動截取,如果需要截取其他字段,可用dsubstr函數(shù)。
例如 {dsubstr($t[company], 20, '...')} 表示截取company字段為20個字符,截取后,結尾追加...
設置日期顯示格式
可以在標簽里傳遞datetype參數(shù):
1 表示 年;
2 表示 月-日;
3 表示 年-月-日;
4 表示 月-日 時:分;
5 表示 年-月-日 時:分;
6 表示 年-月-日 時:分:秒
也可以在模板里直接使用date函數(shù),例如{date('Y-m-d', $t[addtime])} 表示將時間轉換為 年-月-日 格式
date函數(shù)的使用請參閱PHP手冊。
調用某一分類的信息
在標簽里傳遞catid參數(shù),例如&catid=5表示調用分類ID為5的所有信息。
如果調用多個分類,用逗號分隔分類ID,例如 &catid=5,6,7表示調用分類ID為5、6、7的所有信息。
分類調用默認包含子分類的信息,如果不需要包含子分類,可設置&child=0參數(shù)。
例如&catid=5&child=0表示只調用分類ID為5的信息,不包括子分類的信息。
調用某一地區(qū)的信息
調用地區(qū)信息和上述調用分類信息的方法完全相同,將其中的catid換為areaid即可。
顯示信息所在分類<a href="{$MODULE[$moduleid][linkurl]}{$CATEGORY[$t[catid]][linkurl]}">{$CATEGORY[$t[catid]][catname]}</a>
注意:自V4.0,以上寫法將不可用,需要在標簽里傳遞&showcat=1參數(shù),然后在模板里寫<a href="{$t[caturl]}">{$t[catname]}</a>
控制列數(shù)
此項常用于圖片的布局,可使用cols參數(shù)。
例如調用12張圖片,一行顯示4個,共3行,則傳遞&pagesize=12&cols=4
支持cols參數(shù)的標簽模板限thumb-table.htm和list-table.htm
其中,thumb-table.htm顯示圖片列表,list-table.htm顯示文字列表
如果新建支持cols的標簽模板或直接循環(huán)$tags,可參考以上兩個模板的寫法
上述效果可以也可以通過CSS實現(xiàn),無需使用表格,請自行書寫
顯示文章的簡介
使用{$t[introduce]}變量,如果要截取字數(shù),例如80字符,可使用{dsubstr($t[introduce], 80, '...')}
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: