DestoonB2B標(biāo)簽調(diào)用手冊
什么是標(biāo)簽調(diào)用捺癞？
標(biāo)簽調(diào)用是根據(jù)調(diào)用條件(condition)從數(shù)據(jù)表(table)讀取調(diào)用數(shù)量(pagesize)條數(shù)據(jù)肛响，并按排序方式(order)排序仍律，最終通過標(biāo)簽?zāi)０宓牟季州敵鰯?shù)據(jù)。
可以看出，標(biāo)簽的工作分兩個部分壶谒，一是讀取數(shù)據(jù)，二是顯示數(shù)據(jù)膳沽。

標(biāo)簽函數(shù)原型
標(biāo)簽函數(shù)保存于 include/tag.func.PHP
tag($parameter, $expires = 0)
$parameter 表示傳遞給tag函數(shù)的字符串汗菜，系統(tǒng)自動將其轉(zhuǎn)換為多個變量
例如傳遞 table=destoon&pagesize=10&hello=world
系統(tǒng)相當(dāng)于得到
$table = 'destoon';
$pagesize = 10;
$hello = 'world';
三個變量
$expires 表示標(biāo)簽緩存過期時間>0 緩存$expires秒；0 - 系統(tǒng)默認(rèn)標(biāo)簽緩存時間挑社；-1 - 不緩存陨界；-2 - 緩存SQL結(jié)果；
一般情況保持默認(rèn)不需要傳遞痛阻。

數(shù)據(jù)讀取過程
例如以下標(biāo)簽：

會被轉(zhuǎn)換為如下的SQL語句：
SELECT *
FROM destoon_sell
WHERE status=3
ORDER BY addtime DESC
LIMIT 0,10
讀出的數(shù)據(jù)會保存在 $tags 數(shù)組里

數(shù)據(jù)顯示過程
1菌瘪、通過標(biāo)簽?zāi)０屣@示
傳遞&template=abc給標(biāo)簽函數(shù)，例如：

默認(rèn)的標(biāo)簽?zāi)０灞４嬖谀０迥夸?tag/目錄里阱当，例如&template=abc將調(diào)用模板目錄/tag/abc.htm模板來顯示數(shù)據(jù)
如果標(biāo)簽?zāi)０宸庞谄渌夸浨卫鏳ef，則傳遞&dir=def&template=abc弊添，系統(tǒng)將調(diào)用模板目錄/def/abc.htm模板

2录淡、直接在模板里循環(huán)數(shù)據(jù)

此寫法傳遞標(biāo)簽?zāi)０鍨閚ull，并且直接返回數(shù)據(jù)給$tags數(shù)組油坝，此時可以直接在模板里循環(huán)了
以下為一個完整的示例：

{loop $tags $t}
...
{/loop>

第一種寫法一般用于多次調(diào)用的數(shù)據(jù)嫉戚，第二種寫法一般用于只調(diào)用一次的數(shù)據(jù)。

常用參數(shù)及含義
moduleid
moduleid指模塊ID免钻，可在后臺模塊管理里查詢彼水。對于直接調(diào)用模塊的數(shù)據(jù)，設(shè)置正確的模塊ID后极舔，將不需要傳遞table參數(shù)凤覆，系統(tǒng)會自動獲取。
例如傳遞moduleid=5拆魏，系統(tǒng)將識別為調(diào)用供應(yīng)信息盯桦，自動設(shè)置table參數(shù)為sell
table
table指表名慈俯，可在后臺數(shù)據(jù)庫維護(hù)里查詢。對于Destoon系統(tǒng)表拥峦，不需要加表的前綴贴膘；對于非Destoon系統(tǒng)表，需要填寫完整的表名略号，且傳遞prefix參數(shù)
例如對于Destoon系統(tǒng)表刑峡，傳遞table=sell，如果表前綴為destoon_玄柠，系統(tǒng)將識別表名為 destoon_sell
對于非Destoon系統(tǒng)表突梦，傳遞table=tb_abc&prefix=或者table=abc&prefix=tb_，系統(tǒng)將識別表名為 tb_abc
fields
fields指查詢的字段羽利，默認(rèn)為*宫患。可以傳遞例如 fields=title,addtime这弧，但是一般情況下無需傳遞娃闲，Destoon獨(dú)有的標(biāo)簽緩存機(jī)制會自動緩存查詢結(jié)果，不必?fù)?dān)心效率問題匾浪。
condition
condition指查詢的條件皇帮，如果不傳遞，則為1户矢，代表任意條件的數(shù)據(jù)(此項需了解SQL語法)玲献。Destoon所有模塊遵循統(tǒng)一標(biāo)準(zhǔn)開發(fā)，所以很多條件是通用的梯浪。
例如 status=3表示正常通過的信息、status=3 and level=1表示級別為1的信息瓢娜、status=3 and thumb<>''表示有標(biāo)題圖片的信息等挂洛。
order
order指數(shù)據(jù)的排序方法(此項需了解SQL語法)。
例如order=addtimedesc表示按添加時間降序排列眠砾、order=itemid desc表示按itemid降序排列虏劲、order=rand()表示隨機(jī)數(shù)據(jù)等。
pagesize
pagesize指調(diào)用數(shù)據(jù)的數(shù)量褒颈，如果不傳遞柒巫，默認(rèn)為10。
template
template指指定的標(biāo)簽?zāi)０骞韧瑁绻粋鬟f堡掏，默認(rèn)為list，位于模板目錄/tag/list.htm刨疼，如果傳遞為null泉唁，表示不應(yīng)用標(biāo)簽?zāi)０宥炝洹⒁娚鲜鰯?shù)據(jù)顯示過程。

其他常見用法舉例

多表聯(lián)合查詢
例如查詢會員名為destoon的會員和公司資料亭畜，可以使用：
{tag("table=destoon_memberm,destoon_company c&prefix=''&condition=m.userid=c.userid andm.username='destoon'&template=list-com")}
destoon_member和destoon_company是表的實(shí)際名稱(包含表前綴)扮休，prefix=''表示系統(tǒng)不再自動在表名前加前綴

控制標(biāo)題長度
在標(biāo)簽里傳遞length參數(shù)，例如&length=20表示20個字符長度(一個漢字占2個字符)拴鸵，一般情況建議用css隱藏多余字符(定義height和overflow:hidden)
傳遞length參數(shù)玷坠，系統(tǒng)僅對title字段自動截取，如果需要截取其他字段劲藐，可用dsubstr函數(shù)
例如{dsubstr($t[company], 20, '...')} 表示截取company字段為20個字符侨糟，截取后，結(jié)尾追加...

設(shè)置日期顯示格式
可以在標(biāo)簽里傳遞datetype參數(shù)：
1 表示 年瘩燥；
2 表示 月-日秕重；
3 表示 年-月-日；
4 表示 月-日 時:分厉膀；
5 表示 年-月-日 時:分溶耘；
6 表示 年-月-日 時:分:秒
也可以在模板里直接使用date函數(shù)，例如{date('Y-m-d', $t[addtime])} 表示將時間轉(zhuǎn)換為 年-月-日 格式

調(diào)用某一分類的信息
在標(biāo)簽里傳遞catid參數(shù)服鹅，例如&catid=5表示調(diào)用分類ID為5的所有信息凳兵。
如果調(diào)用多個分類，用逗號分隔分類ID企软，例如 &catid=5,6,7表示調(diào)用分類ID為5庐扫、6、7的所有信息仗哨。
分類調(diào)用默認(rèn)包含子分類的信息形庭，如果不需要包含子分類，可設(shè)置&child=0參數(shù)厌漂。
例如&catid=5&child=0表示只調(diào)用分類ID為5的信息萨醒，不包括子分類的信息。

調(diào)用某一地區(qū)的信息
調(diào)用地區(qū)信息和上述調(diào)用分類信息的方法完全相同苇倡，將其中的catid換為areaid即可富纸。

顯示信息所在分類
<ahref="{$MODULE[$moduleid][linkurl]}{$CATEGORY[$t[catid]][linkurl]}">{$CATEGORY[$t[catid]][catname]}</a>

控制列數(shù)
此項常用于圖片的布局，可使用cols參數(shù)旨椒。
例如調(diào)用12張圖片晓褪，一行顯示4個，共3行综慎，則傳遞&pagesize=12&cols=4
支持cols參數(shù)的標(biāo)簽?zāi)０逑辴humb-table.htm和list-table.htm
其中涣仿，thumb-table.htm顯示圖片列表，list-table.htm顯示文字列表
如果新建支持cols的標(biāo)簽?zāi)０寤蛑苯友h(huán)$tags寥粹，可參考以上兩個模板的寫法
上述效果可以也可以通過CSS實(shí)現(xiàn)变过，無需使用表格埃元，請自行書寫

顯示文章的簡介
使用{$t[introduce]}變量，如果要截取字?jǐn)?shù)媚狰，例如80字符岛杀，可使用{dsubstr($t[introduce], 80, '...')}

函數(shù)原型
tag($parameter, $expires = 0)
$parameter 表示傳遞給tag函數(shù)的字符串，系統(tǒng)自動將其轉(zhuǎn)換為多個變量
例如傳遞table=destoon&pagesize=10崭孤，系統(tǒng)相當(dāng)于得到$table = 'destoon'类嗤；$pagesize = 10；兩個變量
$expires 表示緩存過期時間

0 緩存$expires秒辨宠；0 - 系統(tǒng)默認(rèn)時間遗锣；-1 - 不緩存；-2 - 緩存SQL嗤形；一般情況保持默認(rèn)即可精偿。
常量
{DT_SKIN}
系統(tǒng)風(fēng)格網(wǎng)址。
{DT_PATH}
網(wǎng)站首頁網(wǎng)址赋兵。
變量
$tags
以數(shù)組類型保存標(biāo)簽調(diào)用的數(shù)據(jù)笔咽，可通過loop語法遍歷顯示。
$pages
保存數(shù)據(jù)分頁代碼霹期，僅在調(diào)用了分頁時有效叶组。
$MODULE[5][name]
ID為5的模塊名稱。
$MODULE[5][linkurl]
ID為5的模塊網(wǎng)址历造。
$CATEGORY[5][catname]
ID為5的分類名稱(僅變量$CATEGORY存在時有效)甩十。
$CATEGORY[5][linkurl]
ID為5的分類網(wǎng)址(僅變量$CATEGORY存在時有效)。
常用字段
title 標(biāo)題吭产； linkurl 鏈接侣监； catid 分類ID； introduce 簡介垮刹； addtime 添加時間达吞； 常用函數(shù)dsubstr($string,$length, $suffix = '')
將字符串$string截取為$length長,尾部追加$suffix(例如..)
date($format, $timestamp)
將時間戳$timestamp轉(zhuǎn)化為$format(例如Y-m-d)格式
標(biāo)簽?zāi)０?/strong>
模板保存于./template/default/tag/目錄；
建議不要刪除或者修改自帶的模板荒典，推薦在自帶模板基礎(chǔ)上新建模板并應(yīng)用。