destoon調用標簽大全2013版.doc

Destoon B2B標簽調用手冊作者八世紀供求網（www.80g.cc）什么是標簽調用？標簽調用是根據(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ù)讀取過程例如以下標簽： 會被轉換為如下的SQL語句：SELECT *FROM destoon_sellWHERE status=3ORDER BY addtime DESCLIMIT 0,10讀出的數(shù)據(jù)會保存在 $tags 數(shù)組里數(shù)據(jù)顯示過程1、通過標簽模板顯示傳遞&template=abc給標簽函數(shù)，例如： 默認的標簽模板保存在模板目錄/tag/目錄里，例如&template=abc將調用模板目錄/tag/abc.htm模板來顯示數(shù)據(jù)如果標簽模板放于其他目錄，例如def，則傳遞&dir=def&template=abc，系統(tǒng)將調用模板目錄/def/abc.htm模板2、直接在模板里循環(huán)數(shù)據(jù) 此寫法傳遞標簽模板為null，并且直接返回數(shù)據(jù)給$tags數(shù)組，此時可以直接在模板里循環(huán)了以下為一個完整的示例：loop $tags $t./loop第一種寫法一般用于多次調用的數(shù)據(jù)，第二種寫法一般用于只調用一次的數(shù)據(jù)。常用參數(shù)及含義moduleidmoduleid指模塊ID，可在后臺模塊管理里查詢。對于直接調用模塊的數(shù)據(jù)，設置正確的模塊ID后，將不需要傳遞table參數(shù)，系統(tǒng)會自動獲取。例如傳遞moduleid=5，系統(tǒng)將識別為調用供應信息，自動設置table參數(shù)為selltabletable指表名，可在后臺數(shù)據(jù)庫維護里查詢。對于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_abcfieldsfields指查詢的字段，默認為*?？梢詡鬟f例如 fields=title,addtime，但是一般情況下無需傳遞，Destoon獨有的標簽緩存機制會自動緩存查詢結果，不必擔心效率問題。conditioncondition指查詢的條件，如果不傳遞，則為1，代表任意條件的數(shù)據(jù)(此項需了解SQL語法)。Destoon所有模塊遵循統(tǒng)一標準開發(fā)，所以很多條件是通用的。例如 status=3表示正常通過的信息、status=3 and level=1表示級別為1的信息、status=3 and thumb表示有標題圖片的信息等。orderorder指數(shù)據(jù)的排序方法(此項需了解SQL語法)。例如order=addtime desc表示按添加時間降序排列、order=itemid desc表示按itemid降序排列、order=rand()表示隨機數(shù)據(jù)等。pagesizepagesize指調用數(shù)據(jù)的數(shù)量，如果不傳遞，默認為10。templatetemplate指指定的標簽模板，如果不傳遞，默認為list，位于模板目錄/tag/list.htm，如果傳遞為null，表示不應用標簽模板。參見上述數(shù)據(jù)顯示過程。其他常見用法舉例多表聯(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)不再自動在表名前加前綴控制標題長度在標簽里傳遞length參數(shù)，例如&length=20表示20個字符長度(一個漢字占2個字符)，一般情況建議用css隱藏多余字符(定義height和overflow:hidden)傳遞length參數(shù)，系統(tǒng)僅對title字段自動截取，如果需要截取其他字段，可用dsubstr函數(shù)例如 dsubstr($tcompany, 20, .) 表示截取company字段為20個字符，截取后，結尾追加.設置日期顯示格式可以在標簽里傳遞datetype參數(shù)：1 表示 年； 2 表示 月-日；3 表示 年-月-日；4 表示 月-日 時:分；5 表示 年-月-日 時:分；6 表示 年-月-日 時:分:秒也可以在模板里直接使用date函數(shù)，例如date(Y-m-d, $taddtime) 表示將時間轉換為 年-月-日 格式調用某一分類的信息在標簽里傳遞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即可。顯示信息所在分類$CATEGORY$tcatidcatname控制列數(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)，無需使用表格，請自行書寫顯示文章的簡介使用$tintroduce變量，如果要截取字數(shù)，例如80字符，可使用dsubstr($tintroduce, 80, .)函數(shù)原型tag($parameter, $expires = 0)$parameter 表示傳遞給tag函數(shù)的字符串，系統(tǒng)自動將其轉換為多個變量例如傳遞 table=destoon&pagesize=10，系統(tǒng)相當于得到$table = destoon；$pagesize = 10；兩個變量$expires 表示緩存過期時間0 緩存$expires秒；0 - 系統(tǒng)默認時間；-1 - 不緩存；-2 - 緩存SQL；一般情況保持默認即可。常量DT_SKIN系統(tǒng)風格網址。DT_PATH網站首頁網址。變量$tags以數(shù)組類型保存標簽調用的數(shù)據(jù)，可通過loop語法遍歷顯示。$pages保存數(shù)據(jù)分頁代碼，僅在調用了分頁時有效。$MODULE5nameID為5的模塊名稱。$MODULE5linkurlID為5的模塊網址。$CATEGORY5catnameID為5的分類名稱(僅變量$CATEGORY存在時有效)。$CATEGORY5linkurlID為5的分類網址(僅變量$CATEGORY存在時有效)。常用字段title 標題； linkurl 鏈接； catid 分類ID； introduce 簡介； addtime 添加時間； 常用函數(shù) 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是標簽截取字數(shù)&pagesize=10是調用條數(shù)&datetype=2是顯示時間添加時間2.調用最新加入企業(yè)4&pagesize=10&order=userid desc&template=list-com”)3.如何調用其中一個企業(yè)會員的供求信息及資訊在condition=里加 and username=xxx xxx為會員登錄名4.如何調用 供應 求購 產品 下的 某個分類調用分類下的信息可以設置 &catid=行業(yè)id&child=1 child=1表示同時調用下屬的行業(yè)5.調用二級欄目信息列表如果你是在文章模塊里調用 可以用上面的代碼 $catid 改為你要調用的欄目id即可如果需要同時調用欄目下的信息 child=1即可 否則 child=0如果是在網站其他地方調用，可以用下面的代碼：注意moduleid的值要與你調用的模塊id保持一致補充：下面這個在首頁調用成功但是我想要資訊頁內部的模版列表，也就是每條只顯示22個字。6.首頁資訊欄目這里怎么調用“9”為你模塊的IDphp $C = get_maincat(0, cache_read(category-9.php);loop $C $k $v$vcatname/loop7.公司列表 不能控制字數(shù)！你可以直接修改 list-com.htm$tcompany 為 dsubstr($tcompany, $length)8.TAG常用標簽$CATEGORY$tcatidcatname 所屬欄目名稱； timetodate($taddtime, $datetype) 發(fā)布時間9.其他你可以通過&template= 來指定標簽模版如果沒用這個參數(shù) 默認是list位于模版目錄tag目錄資訊 級別level 1級為 推薦文章 ；2級為 幻燈圖片；3級為 推薦圖文；4級為 頭條文章；5級為 頭條相關 推薦 niaoshi66 退出山歌千里之行始于足下，分享生活瑣事，讓你的生活亂起來2012-06-05 17:10destoon 標簽大全一覽1.全局標簽網站名稱：$DTsitename網站地址：DT_PATH網站LOGO： if $MODULE$moduleidlogoDT_SKINimage/logo_$moduleid.gifelseif $DTlogo$DTlogoelseDT_SKINimage/logo.gif/if版權信息：$DTcopyright風格路徑：DT_PATH客服電話：$DTtelephoneICP備案號：if $DTicpno$DTicpno /ifVIP會員名稱：VIP真實貨幣名稱：$DTmoney_name真實貨幣單位：$DTmoney_unit虛擬積分名稱：$DTcredit_name虛擬積分單位：$DTcredit_unitTitle(網站標題)：$seo_titleMeta Keywords(網頁關鍵詞)：$head_keywordsMeta Description(網頁描述)：$head_description2.連接地址默認各個模塊連接：會員：$MODULE2linkurl 供應：$MODULE5linkurl 求購：$MODULE6linkurl 行情：$MODULE7linkurl 公司：$MODULE4linkurl 展會：$MODULE8linkurl 資訊：$MODULE21linkurl 招商：$MODULE22linkurl 品牌：$MODULE13linkurl 人才：$MODULE9linkurl 知道：$MODULE10linkurl 專題：$MODULE11linkurl 圖庫：$MODULE12linkurl視頻：$MODULE14linkurl下載：$MODULE15linkurl發(fā)布信息：$MODULE2linkurl$DTfile_my企業(yè)商鋪：$MODULE2linkurlhome.php查看站內信：$MODULE2linkurlmessage.php管理買賣交易：$MODULE2linkurltrade.php完善企業(yè)資料：$MODULE2linkurledit.php?tab=2注冊：$MODlinkurl$DTfile_register登錄：$MODULE2linkurl$DTfile_login找回密碼：$MODlinkurlsend.phpVIP頁面：$MODULE2linkurlgrade.phpWAP瀏覽：if extend_setting(wap_enable) WAP瀏覽/ifRSS訂閱：if extend_setting(feed_enable) | RSS訂閱/if行情速遞：$MODULE7linkurlrewrite(price.php?product=all)企業(yè)新聞：$MODULE4linkurlrewrite(news.php?more=1)公告：extendurl(announce)推廣：extendurl(spread)廣告：extendurl(ad)友情鏈接：extendurl(link)申請友情鏈接：extendurl(link)rewrite(index.php?action=reg)留言本：extendurl(guestbook)投票：extendurl(vote)3.首頁調用導航菜單：liif $moduleid首頁loop $MODULE $mif $mismenu$mname/if/loop調用登錄模塊：if $DTpage_logintemplate user, chip/if調用分類模塊：php $mid = 5;template catalog, chip4.各個模塊數(shù)據(jù)的調用免費發(fā)布信息網供應：最新供應信息：1.2.loop $tags $k $tarea_pos($tareaid, /, 1)$ttitle/loop簽調用理論上需要網站管理人員有一定的HTML+CSS知識，并對PHP+MySQL有初步的了解。調用過程實際是按照調用條件從數(shù)據(jù)表讀取調用數(shù)量條數(shù)據(jù)，并依排序方式排序，最終通過標簽模板的布局輸出數(shù)據(jù)。函數(shù)原型 tag($parameter, $expires = 0) $parameter 表示傳遞給tag函數(shù)的字符串，系統(tǒng)自動將其轉換為多個變量 例如傳遞 table=destoon&pagesize=10，系統(tǒng)相當于得到$table = destoon；$pagesize = 10；兩個變量 $expires 表示緩存過期時間 0 緩存$expires秒；0 – 系統(tǒng)默認時間；-1 – 不緩存；-2 – 緩存SQL；一般情況保持默認即可。變量 $tags 以數(shù)組類型保存標簽調用的數(shù)據(jù)，可通過loop語法遍歷顯示。$pages 保存數(shù)據(jù)分頁代碼，僅在調用了分頁時有效。 $path 模塊路徑。 常用字段 title 標題； linkurl 鏈接； catid 分類ID； introduce 簡介； addtime 添加時間；常用函數(shù) dsubstr($string, $length, $suffix = ”) 將字符串$string截取為$length長,尾部追加$suffix(例如.)set_style($string, $style = ”, $tag = span) 將字符串$string置于$tagHTML標簽中并設置style為$style linkurl($linkurl, $absurl = 0) 將相對路徑$linkurl修補為絕對路徑(防止鏈接錯誤)date($format, $timestamp) 將時間戳$timestamp轉化為$format(例如Y-m-d)格式標簽模板 模板保存于./template/default/tag/目錄； 建議不要刪除或者修改自帶的模板，推薦在自帶模板基礎上新建模板并應用。Category:Destoon標簽調用Comments (0)destoon顯示地區(qū)Posted byjinpeng998on 星期一, 12 07月, 2010顯示地區(qū)：需要的函數(shù)是 include/module.func.php/get_mainarea($areaid, $area);php頁面：$AREA=cache_read(area.php); /讀取緩存文件靜態(tài)頁面調用： php $mainarea = get_mainarea(0, $AREA)loop $mainarea $k $vif $k%2=0/if$vareanameif $k%2=1/if/loop還有一種方法就是 直接標簽調用，不錯的，直接從destoon數(shù)據(jù)庫里取出信息Category:Destoondestoon顯示地區(qū)Comments (0)destoon 學習標簽調用Posted byjinpeng998on 星期日, 11 07月, 2010鏈接：$tlinkurl供應模塊 更多：$MODULE-模塊ID-linkurl 模塊ID把 鼠標放在其下鏈接上 出現(xiàn) moduleid=？ 就能看到圖片路徑：$t;資訊模塊 更多：$MODlinkurl$clinkurl查看 名稱是屬于哪個字段？選中–右鍵看name值 eg name=postbrand 即為brand字段每個模塊的首頁 都是其 template/文件夾下的 index.htmpagesize=”.$MODpagesize.” 可寫成 pagesize=4；記住不要加 單引號 or 雙引號調用分頁：分頁標簽：分頁：if $showpage & $pages$pages/if調用分類：主要方法$maincat = get_maincat(0, $CATEGORY);get_maincat(0, $CATEGORY)在include/global_func.php 中$childcat = get_maincat(0, $CATEGORY, 1); 調用超級欄目下的1級目錄0 代表 最最根目錄 1代表 level為1的目錄 level 手動設置 默認都為1如果0改為3 則為 catid 為3 的目錄小注意：$CATEGORY = cache_read(category-.$moduleid.php);此文件在模塊頁的common.inc.php頁面中調用loop $maincat $k $vif $k%$DTpage_subcat=0/ifset_style($vcatname,$vstyle) ($ITEMS$vcatid)if $k%$DTpage_subcat=($DTpage_subcat-1)/if/loop注意：在其模塊 module 文件夾下的 php頁面里必須有 $maincat$MODlinkurl 是模塊也首頁地址 $vlinkurl其下列表頁 加 catidCategory:Destoon標簽調用Comments (0)非常好的Destoon B2B標簽調用手冊Posted byjinpeng998on 星期日, 11 07月, 2010Destoon B2B標簽調用手冊什么是標簽調用？標簽調用是根據(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ù)讀取過程例如以下標簽：會被轉換為如下的SQL語句：SELECT *FROM destoon_sellWHERE status=3ORDER BY addtime DESCLIMIT 0,10讀出的數(shù)據(jù)會保存在 $tags 數(shù)組里數(shù)據(jù)顯示過程 1、通過標簽模板顯示傳遞&template=abc給標簽函數(shù)，例如：默認的標簽模板保存在模板目錄/tag/目錄里，例如&template=abc將調用模板目錄/tag/abc.htm模板來顯示數(shù)據(jù)如果標簽模板放于其他目錄，例如def，則傳遞&dir=def&template=abc，系統(tǒng)將調用模板目錄/def/abc.htm模板 2、直接在模板里循環(huán)數(shù)據(jù)此寫法傳遞標簽模板為null，并且直接返回數(shù)據(jù)給$tags數(shù)組，此時可以直接在模板里循環(huán)了以下為一個完整的示例：loop $tags $t/loop第一種寫法一般用于多次調用的數(shù)據(jù)，第二種寫法一般用于只調用一次的數(shù)據(jù)。常用參數(shù)及含義moduleidmoduleid指模塊ID，可在后臺模塊管理里查詢。對于直接調用模塊的數(shù)據(jù)，設置正確的模塊ID后，將不需要傳遞table參數(shù)，系統(tǒng)會自動獲取。例如傳遞moduleid=5，系統(tǒng)將識別為調用供應信息，自動設置table參數(shù)為selltabletable指表名，可在后臺數(shù)據(jù)庫維護里查詢。對于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_abcfieldsfields指查詢的字段，默認為星號?？梢詡鬟f例如 fields=title,addtime，但是一般情況下無需傳遞，Destoon獨有的標簽緩存機制會自動緩存查詢結果，不必擔心效率問題。 orderorder指數(shù)據(jù)的排序方法(此項需了解SQL語法)。例如order=addtime desc表示按添加時間降序排列、order=itemid desc表示按itemid降序排列、order=rand()表示隨機數(shù)據(jù)等。pagesizepagesize指調用數(shù)據(jù)的數(shù)量，如果不傳遞，默認為10。templatetemplate指指定的標簽模板，如果不傳遞，默認為list，位于模板目錄/tag/list.htm，如果傳遞為null，表示不應用標簽模板。參見上述數(shù)據(jù)顯示過程。其他常見用法舉例控制標題長度在標簽里傳遞length參數(shù)，例如&length=20表示20個字符長度(GBK一個漢字占2個字符，UTF-8一個漢字占3個字符)，一般情況建議用css隱藏多余字符(定義height和overflow:hidden)傳遞length參數(shù)，系統(tǒng)僅對title字段自動截取，如果需要截取其他字段，可用dsubstr函數(shù)例如 dsubstr($tcompany, 20, ) 表示截取company字段為20個字符，截取后，結尾追加設置日期顯示格式可以在標簽里傳遞datetype參數(shù)： 1 表示 年；2 表示 月-日；3 表示 年-月-日；4 表示 月-日 時:分；5 表示 年-月-日 時:分；6 表示 年-月-日 時:分:秒也可以在模板里直接使用date函數(shù)，例如date(Y-m-d, $taddtime) 表示將時間轉換為 年-月-日 格式調用某一分類的信息在標簽里傳遞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即可。顯示信息所在分類$CATEGORY$tcatidcatname控制列數(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)，無需使用表格，請自行