destoon官方標籤有哪些？ destoon官方標籤大全-php教程-PHP中文網

destoon官方標籤大全

一，什麼是標籤呼叫？標籤呼叫是根據呼叫條件(condition)從資料表(table)讀取呼叫數量(pagesize)條數據，並依排序方式(order)排序，最終透過標籤範本的佈局輸出資料。可以看出，標籤的工作分成兩個部分，一是讀取數據，二是顯示數據。

二，標籤函數原型標籤函數保存於 include/tag.func.php

tag($parameter, $expires = 0)
$parameter 表示傳遞給tag函數的字串，系統自動將其轉換為多個變數

複製程式碼

例如傳遞table=destoon&pagesize=10&hello=world 系統相當於得到：

$table = 'destoon';
$pagesize = 10;
$hello = 'world';

$hello = 'world';

複製程式碼

三個變數 $expires 表示標籤快取過期時間>0 快取$expires秒；0 – 系統預設標籤快取時間；-1 – 不快取；-2 – 快取SQL結果；一般情況保持預設不需要傳遞。

三，資料讀取過程例如以下標籤：

複製程式碼

SELECT *
FROM destoon_sell

WHERE status=3

ORDER BY addtime DESCMLIm 🎜>

複製程式碼

讀出的資料會保存在$tags 陣列中。

四，數據顯示過程 1、透過標籤模板顯示傳遞&template=abc給標籤函數，例如：

複製程式碼

此寫法傳遞標籤模板為null，並且直接返回資料給$tags數組，此時可以直接在模板裡循環了以下為一個完整的範例：

{loop $tags $t }
…

{/loop>

複製程式碼

第一種寫法一般用於多次呼叫的數據，第二種寫法一般用於只呼叫一次的數據。

五，常用參數及意義 moduleid moduleid指模組ID，可在後台模組管理裡查詢。對於直接呼叫模組的數據，設定正確的模組ID後，將不需要傳遞table參數，系統會自動取得。例如傳遞moduleid=5，系統將識別為呼叫供應訊息，自動設定table參數為sell

table table指表名，可在後台資料庫維護裡查詢。對於Destoon系統表，不需要加表的前綴；對於非Destoon系統表，需要填寫完整的表名，且傳遞prefix參數例如對於Destoon系統表，傳遞table=sell，如果表前綴為destoon_，系統將識別表名為 destoon_sell 對於非Destoon系統表，傳遞table=tb_abc&prefix=或table=abc&prefix=tb_，系統將識別表名為 tb_abc

fields fields指查詢的字段，預設為*。可以傳遞例如 fields=title,addtime，但是一般情況下無需傳遞，Destoon獨有的標籤快取機制會自動快取查詢結果，不必擔心效率問題。

condition condition指查詢的條件，如果不傳遞，則為1，代表任意條件的資料(此項需了解SQL語法)。 Destoon所有模組遵循統一標準開發，所以很多條件是通用的。例如 status=3表示正常通過的資訊、status=3 and level=1表示等級為1的資訊、status=3 and thumb」表示有標題圖片的資訊等。

order order指資料的排序方法(此項需了解SQL語法)。例如order=addtime desc表示依新增時間降序排列、order=itemid desc表示依itemid降序排列、order=rand()表示隨機資料等。

pagesize pagesize指呼叫資料的數量，如果不傳遞，預設為10。

template template指指定的標籤模板，如果不傳遞，預設為list，位於模板目錄/tag/list.htm，如果傳遞為null，表示不套用標籤模板。請參閱上述數據顯示過程。

六，其他常見用法舉例 1）、多表聯合查詢例如，查詢會員名為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=”表示系統不再自動在表名前加前綴

2）、控制標題長度在標籤裡傳遞length參數，例如&length=20表示20個字元長度(一個漢字佔2個字元)，一般情況建議用css隱藏多餘字元(定義height和overflow:hidden) 傳遞length參數，系統僅自動對title字段截取，如果需要截取其他字段，可用dsubstr函數例如 {dsubstr($t[company], 20, ‘…')} 表示截取company字段為20個字符，截取後，結尾追加…

3）、設定日期顯示格式可以在標籤裡傳遞datetype參數： 1 表示年； 2 表示月-日； 3 表示年-月-日； 4 表示月-日時:分； 5 表示年-月-日時:分； 6 表示年-月-日時:分:秒也可以在模板裡直接使用date函數，例如{date(‘Y-m-d', $t[addtime])} 表示將時間轉換為年-月-日格式

呼叫某一分類的訊息在標籤裡傳遞catid參數，例如&catid=5表示呼叫分類ID為5的所有資訊。如果呼叫多個分類，用逗號分隔分類ID，例如 &catid=5,6,7表示呼叫分類ID為5、6、7的所有資訊。分類呼叫預設包含子分類的信息，如果不需要包含子分類，可設定&child=0參數。例如&catid=5&child=0表示只呼叫分類ID為5的訊息，不包含子分類的資訊。

呼叫某一地區的信息呼叫地區資訊和上述調用分類資訊的方法完全相同，將其中的catid換成areaid即可。

顯示資訊所在分類

{$CATEGORY[$t[catid]][catname]}

複製程式碼

控制列數此項常用於圖片的佈局，可使用cols參數。例如呼叫12張圖片，一行顯示4個，共3行，則傳遞&pagesize=12&cols=4 支援cols參數的標籤範本限thumb-table.htm和list-table.htm 其中，thumb-table.htm顯示圖片列表，list-table.htm顯示文字列表如果新建支援cols的標籤模板或直接循環$tags，可參考以上兩個模板的寫法上述效果可以也可以透過CSS實現，無需使用表格，請自行書寫

顯示文章的簡介使用{$t[introduce]}變量，如果要截取字數，例如80字符，可使用{dsubstr($t[introduce], 80, ‘…')}

函數原型 tag($parameter, $expires = 0) $parameter 表示傳遞給tag函數的字串，系統自動將其轉換為多個變數例如傳遞 table=destoon&pagesize=10，系統就等於得到$table = ‘destoon'；$pagesize = 10；兩個變數 $expires 表示快取過期時間 >0 快取$expires秒；0 – 系統預設時間；-1 – 不快取；-2 – 快取SQL；一般情況保持預設即可。

常數 {DT_SKIN} 系統風格網址。 {DT_PATH} 網站首頁網址。

變數 $tags 以數組類型儲存標籤呼叫的數據，可透過loop語法遍歷顯示。 $pages 儲存資料分頁程式碼，僅在呼叫了分頁時有效。 $MODULE[5][name] ID為5的模組名稱。 $MODULE[5][linkurl] ID為5的模組網址。 $CATEGORY[5][catname] ID為5的分類名稱(僅變數$CATEGORY存在時有效)。 $CATEGORY[5][linkurl] ID為5的分類網址(僅變數$CATEGORY存在時有效)。

常用字段 title 標題； linkurl 連結； catid 分類ID； introduce 簡介； addtime 新增時間；常用函數 dsubstr($string, $length, $suffix = ”) 將字串$string截取為$length長,尾部追加$suffix(例如..) date($format, $timestamp) 將時間戳$timestamp轉換為$format(例如Y-m-d)格式

標籤模板模板儲存於./template/default/tag/目錄；建議不要刪除或修改自備的模板，推薦在自備模板基礎上新建模板並套用。

1.標籤格式的大致說明 moduleid=9是資訊模組ID, 模組ID去模組管理檢視； article是資訊模組目錄名； &length=40是標籤截取字數 &pagesize=10是呼叫條數 &datetype=2是顯示時間新增時間

2.呼叫最新加入企業 4&pagesize=10&order=userid desc&template=list-com”)}–> 3.如何調用其中一個企業會員的供需資訊及資訊在condition=裡加 and username='xxx'? xxx為會員登入名稱

4.如何呼叫供應求購產品下的某個分類呼叫分類下的資訊可以設定 &catid=產業id&child=1 child=1表示同時調用下屬的產業

5.呼叫二級欄位資訊列表如果你是在文章模組裡呼叫可以用上面的程式碼 $catid 改為你要呼叫的欄位id即可如果需要同時呼叫欄位下的資訊 child=1即可否則 child=0 如果是在網站其他地方調用，可以用下面的程式碼：注意moduleid的值要與你所呼叫的模組id一致

補充：下面這個在首頁呼叫成功但我想要資訊頁內部的模版列表，也就是每個只顯示22個字。

6.首頁資訊欄這裡怎麼調用「9」為你模組的ID