CmsTop模板制作幫助手冊(cè)(6)——模板標(biāo)簽

2010-09-09 21:07:04來(lái)源:作者:

1.      Content標(biāo)簽

1.      Content標(biāo)簽

作用:調(diào)用CmsTop系統(tǒng)中各種內(nèi)容模型數(shù)據(jù);
示例:
{content catid="4" modelid="1" orderby="published desc, pv desc" page="$page" size="8"}
 • <a href="{$r[url]}">{$r[title]}</a> {date('Y-m-d',$r[published])}
{/content}
{pages($total, $page, $pagesize, 2, $urlrule)}
參數(shù)對(duì)照表:

參數(shù)
詳解
modelid
內(nèi)容模型ID,多個(gè)ID用“,”隔開
catid
欄目ID,多個(gè)ID用“,”開 ,可自動(dòng)取子欄目?jī)?nèi)容
sourceid
來(lái)源ID,多個(gè)ID用“,”隔開
weight
權(quán)重范圍
weight="60",表示權(quán)重值等于60
weight="60,",表示權(quán)重值大于等于60
weight=",60",表示權(quán)重值小于等于60
weight="60,100",表示權(quán)重值大于等于60,且小于等于100
published
發(fā)布時(shí)間范圍
published="2009-11-10" 表示調(diào)用發(fā)布時(shí)間為2009年 11月10日的內(nèi)容
published="2009-11-10," 表示調(diào)用發(fā)布時(shí)間大于2009年11月 10日的內(nèi)容
published=",2009-11-10" 表示調(diào)用發(fā)布時(shí)間小于2009年11月10日 的內(nèi)容
published="2009-11-10,2009-11-30" 表示調(diào)用發(fā)布時(shí)間大于2009年11 月10日,且小于2009年11月30日的內(nèi)容
published="1" 表示調(diào)用發(fā)布時(shí)間1天以內(nèi)的內(nèi)容
createdby
創(chuàng)建人 ID,多個(gè) ID 用“,”隔開
tags
關(guān)鍵詞,多個(gè)關(guān)鍵詞用“,”隔開,例如:tags="福布斯,權(quán)力"
orderby
排序方式,多個(gè)“,”隔開,例如:orderby="published desc, pv desc, comments desc, weight desc"
offset
數(shù)據(jù)庫(kù)查詢結(jié)果偏移值(必須是正整數(shù)),默認(rèn)值為 0
size
行數(shù)(必須是正整數(shù))
page
當(dāng)前頁(yè)碼(必須是正整數(shù))
return
返回值變量 return:返回結(jié)果變量名,默認(rèn)為 r

2.      Db標(biāo)簽
作用:通用的數(shù)據(jù)庫(kù)數(shù)據(jù)調(diào)用方法,通常用于調(diào)用cmstop_content表以外的數(shù)據(jù)表的數(shù)據(jù);
示例:
{db sql="select * from #table_content where catid=$catid and modelid=1 and status=6 order by published desc" size="$pagesize" page="$page"}
    <a href="{$r[url]}">{$r[title]}</a> {date('n月j日H:i',$r['published'])}
{/db}
{pages($total, $page, $pagesize, 2, $urlrule)}
參數(shù)對(duì)照表:

參數(shù)名
必選
說(shuō)明
dsn
數(shù)據(jù)源名,當(dāng)需要調(diào)用的數(shù)據(jù)庫(kù)帳號(hào)和當(dāng)前系統(tǒng)不同時(shí)使用,并且需要事先在后臺(tái)添加好數(shù)據(jù)源
dbname
數(shù)據(jù)庫(kù)名,當(dāng)需要調(diào)用的數(shù)據(jù)庫(kù)帳號(hào)和當(dāng)前系統(tǒng)相同而數(shù)據(jù)庫(kù)名不同時(shí)使用
charset
數(shù)據(jù)字符集,當(dāng)需要調(diào)用的數(shù)據(jù)和當(dāng)前系統(tǒng)字符集不同時(shí)設(shè)置,數(shù)據(jù)輸出的時(shí)候系統(tǒng)會(huì)根據(jù)此設(shè)置自動(dòng)轉(zhuǎn)碼
sql
要查詢的sql語(yǔ)句,數(shù)據(jù)表的前綴可以用 #table_ 代替
page
當(dāng)前的頁(yè)碼,一般用法都是 page="$page"
size
行數(shù)(必須是正整數(shù))
return
返回值變量 return:返回結(jié)果變量名,默認(rèn)為 r

3.      Discuz標(biāo)簽
作用:調(diào)用同一服務(wù)器上的discuz論壇帖子數(shù)據(jù)
示例:
{discuz dsn="discuz"  fid="1" filter="all" published="1" keywords="cmstop" author="1" special="1,2" prefix="cdb_" orderby="dateline desc" size="$pagesize" page="$page"}
      <!-更多可使用字段,請(qǐng)參考discuz數(shù)據(jù)表posts、threads-à
      <a href="htpp://url_to_discuz/tid={$r[tid]}">{$r[subject]}</a> {date('n月j日H:i',$r['dateline'])}
{/discuz}
{pages($total, $page, $pagesize, 2, $urlrule)}
參數(shù)對(duì)照表:

參數(shù)名
必選
說(shuō)明
dsn
數(shù)據(jù)源名,當(dāng)需要調(diào)用的數(shù)據(jù)庫(kù)帳號(hào)和當(dāng)前系統(tǒng)不同時(shí)使用,并且需要事先在后臺(tái)添加好數(shù)據(jù)源
fid
論壇版塊ID,多個(gè)以半角逗號(hào)分隔
filter
主題類型,全部主題(all) 、精華主題(digest)、 置頂主題(top)
published
時(shí)間范圍,數(shù)字n表示n天之內(nèi)的帖子
keywords
關(guān)鍵字,關(guān)鍵詞寫法參考discuz搜索,以(AND、&、空格) (OR、|)組合查詢,*模糊匹配
author
作者ID或者作者名稱,多個(gè)以逗號(hào)分隔
special
特殊主題:投票主題(1)、商品主題(2)、懸賞主題(3)、活動(dòng)主題(4)、辯論主題(5)、
多個(gè)以逗號(hào)分隔
orderby
排序類型:
lastpost (asc|desc) 最后回復(fù)
 dateline (asc|desc) 發(fā)表時(shí)間
 replies (asc|desc)   回復(fù)數(shù)
 views (asc|desc)     查看數(shù)
prefix
默認(rèn)‘cdb_’ discuz數(shù)據(jù)表前綴
其它字段
page,offset,size,charset參考db標(biāo)簽

4.      Section標(biāo)簽
作用:定義頁(yè)面區(qū)塊屬性,通常用于通過頁(yè)面模板自動(dòng)創(chuàng)建頁(yè)面區(qū)塊;
示例: 
<!--{section name="熱點(diǎn)專題 圖片" type="hand" width="0" frequency="0" rows="1" output="html" description=""}-->
模板代碼當(dāng)type為html的時(shí)候只能為html,其他可以是html跟模板標(biāo)簽組合的代碼
<!--{/section}-->
區(qū)塊類型對(duì)照表:

類型
說(shuō)明
代碼
支持html和js代碼,通常用于不規(guī)則數(shù)據(jù)和廣告位維護(hù)等
自動(dòng)
支持通過模板標(biāo)簽調(diào)用數(shù)據(jù),可以定時(shí)刷新,無(wú)需人工維護(hù)
手動(dòng)
支持手動(dòng)更新數(shù)據(jù),并通過設(shè)定的模板代碼輸出
rss
獲取指定的rss新聞源,并通過設(shè)定的模板代碼輸出,可定時(shí)刷新,通常用于RSS數(shù)據(jù)遠(yuǎn)程調(diào)用
json
獲取指定的json數(shù)據(jù)源,并通過設(shè)定的模板代碼輸出,可定時(shí)刷新,通常用于JSON數(shù)據(jù)遠(yuǎn)程調(diào)用
rpc
獲取指定的rpc接口數(shù)據(jù),并通過設(shè)定的模板代碼輸出,可定時(shí)刷新,通常用于RPC協(xié)議接口

參數(shù)對(duì)照表:

參數(shù)名
必選
說(shuō)明
sectionid
區(qū)塊ID,如果沒填寫就會(huì)自動(dòng)創(chuàng)建此碎片
name
區(qū)塊名稱,可以重復(fù)
type
區(qū)塊類型,(html,auto,hand,rss,json,rpc)其中之一。
url
當(dāng)type為(rss,json,rpc)時(shí)有效
method
當(dāng)type為rpc時(shí)有效
args
當(dāng)type為rpc時(shí)有效
width
區(qū)塊寬度,主要用來(lái)參考標(biāo)題長(zhǎng)度是否合適
frequency
更新頻率,當(dāng)type為html和hand時(shí)此選項(xiàng)無(wú)效
rows
默認(rèn)的行數(shù),僅type為hand時(shí)有效
origdata
默認(rèn)的數(shù)據(jù),需php序列化以后的數(shù)據(jù)
output
輸出格式,(html,xml,json)三者之一 ,僅type為hand時(shí)有效
description
區(qū)塊備注,一般用來(lái)說(shuō)明區(qū)塊顯示在什么位置,縮略圖規(guī)格,標(biāo)題最大長(zhǎng)度等

關(guān)鍵詞:CmsTop

贊助商鏈接: