Appearance
DedeCMS全局標簽 ?
arclist ?
功能: ?
用于獲取系統主從表模型(如:文章、軟件、圖集、商品等)的一列文檔,也稱(chēng)自由列表塊標記,其中 imglist
、imginfolist
、specart
、coolart
、autolist
都是由該標記所定義的不同屬性延伸出來(lái)的別名標記。
語(yǔ)法: ?
html
{dede:arclist flag='h' typeid='' row='' col='' titlelen='' infolen=''
imgwidth='' imgheight='' listtype='' orderby='' keyword='' limit='0,1'}
<a href='[field:arcurl/]'>[field:title/]</a>
{/dede:arclist}
文件: ?
\include\taglib\arclist.lib.php
function lib_arclist(&$ctag,&$refObj)
默認底層模板: ?
imglist :part_imglist.htm
imginfolist :part_imginfolist.htm
arclist :part_arclist.htm
參數: ?
col=' '
分多少列顯示(默認為單列);
TIP
5.3 版中本屬性可以通過(guò)多種方式進(jìn)行多行顯示
如果 col='1'
要多列顯示的可用 div + css
實(shí)現
以下為通過(guò) div + css
實(shí)現多列的范例:
html
<style type=text/css>
div{ width: 400px; float: left; }
</style>
{dede:arclist row='10' titlelen='24' orderby='pubdate' idlist='' col='2'}
[field:textlink/] ([field:pubdate function=MyDate('m-d',@me)/]) <br/>
{/dede:arclist}
當 col>1
將使用原來(lái)的 table
多列方式顯示
row='10'
返回文檔列表總數;typeid=''
欄目 ID ,在列表模板和檔案模板中一般不需要指定,在首頁(yè)模板中允許用,
分開(kāi)表示多個(gè)欄目;getall='1'
在沒(méi)有指定這屬性的情況下,在欄目頁(yè)、文章頁(yè)模板,不會(huì )獲取以,
分開(kāi)的多個(gè)欄目的下級子類(lèi);titlelen = '30'
標題長(cháng)度,等同于titlelength
;
infolen='160' 表示內容簡(jiǎn)介長(cháng)度 等同于infolength(只控制infos,并不控制description的內容)
imgwidth='120' 縮略圖寬度
imgheight='90' 縮略圖高度
listtype='all' 欄目類(lèi)型 image含有縮略圖 commend推薦
orderby='sortrank' 文檔排序方式
l orderby='hot' 或 orderby='click' 表示按點(diǎn)擊數排列
l orderby='sortrank' 或 orderby='pubdate' 按出版時(shí)間排列
l orderby='near'
l orderby=='lastpost' 按最后評論時(shí)間
l orderby=='scores' 按得分排序
l orderby='id' 按文章ID排序
l orderby='rand' 隨機獲得指定條件的文檔列表
keyword='' 含有指定關(guān)鍵字的文檔列表,多個(gè)關(guān)鍵字用","分
innertext = '' 單條記錄樣式
aid='' 指定文檔ID
idlist ='' 提取特定文檔(文檔ID)
channelid 頻道ID
limit='起始ID,記錄數'(起始ID從0開(kāi)始)表示限定的記錄范圍(如:limit='1,2' 表示從ID為1的記錄開(kāi)始,取2條記錄)
flag = 'h' 自定義屬性值:頭條[h]推薦[c]圖片[p]幻燈[f]滾動(dòng)[s]跳轉[j]圖文[a]加粗[b]
noflag = '' 同flag,但這里是表示不包含這些屬性
orderway='desc' 值為 desc 或 asc ,指定排序方式是降序還是順向排序,默認為降序
subday='天數' 表示在多少天以?xún)鹊奈臋n
底層字段:
ID(同 id),typeid,sortrank,flag,ismake,channel,arcrank,click,money,title,shorttitle,color,writer,
source,litpic(同picname),pubdate,senddate,mid, lastpost,scores,goodpost,badpost,notpost,
description(同infos),filename, image, imglink, fulltitle, textlink, typelink,plusurl, memberurl, templeturl,
stime(pubdate 的"0000-00-00"格式)
其中:
html
textlink = <a href='arcurl'>title</a>
typelink = <a href='typeurl'>typename</a>
imglink=<a href='arcurl'><img src='picname' border='0' width='imgwidth' height='imgheight'></a>
image = <img src='picname' border='0' width='imgwidth' height='imgheight' alt=’titile’>
注:字段調用方法[field:varname/],同樣適用于其他標簽
如:
html
{dede:arclist infolen='100'}
[field:textlink/]<br>
[field:infos/]<br>
{/dede:arclist}
底層模板里的Field實(shí)現也是織夢(mèng)標記的一種形式,因此支持使用PHP語(yǔ)法,Function擴展等功能。
如: 給當天發(fā)布的內容加上 (new)
標志
html
[field:senddate runphp='yes']
$ntime = time();
$oneday = 3600 * 24;
if(($ntime - @me)<$oneday) @me = "<font color='red'>(new)</font>";
else @me = "";
[/field:senddate]
arclistsg 獨立單表模型文檔列表 ?
**名稱(chēng):**arclistsg
**功能:**類(lèi)似arclist標簽,獲取指定單表模型(例如:分類(lèi)信息),指定欄目,指定排序及呈現樣式的一列文檔
語(yǔ)法:
html
{dede:arclistsg flag='h' typeid='' row='' col='' titlelen='' orderway='' keyword='' limit='0,1'}
<a href='[field:arcurl/]'>[field:title/]</a>
{/dede:arclistsg}
文件:
\include\taglib\arclistsg.lib.php
function lib_arclistsg(&$ctag,&$refObj)
默認底層模板:
part_arclistsg.htm
參數:
col='' 分多少列顯示(默認為單列),5.3版中本屬性無(wú)效,要多列顯示的可用div+css實(shí)現
row='10' 返回文檔列表總數
typeid='' 欄目ID,在列表模板和檔案模板中一般不需要指定,在封面模板中允許用","分開(kāi)表示多個(gè)欄目;
titlelen = '30' 標題長(cháng)度 等同于titlelength
orderwey='desc'或'asc' 排序方向
keyword= 含有指定關(guān)鍵字的文檔列表,多個(gè)關(guān)鍵字用","分
innertext = "[field:title/]" 單條記錄樣式(innertext是放在標簽之間的代碼)
arcid='' 指定文檔ID
idlist ='' 提取特定文檔(文檔ID)
channelid = '' 頻道ID
limit='' 起始,結束 表示限定的記錄范圍(如:limit='1,2')
flag = 'h' 自定義屬性值:頭條[h]推薦[c]圖片[p]幻燈[f]滾動(dòng)[s]跳轉[j]圖文[a]加粗[b]
subday='天數' 表示在多少天以?xún)鹊奈臋n
底層字段:
ID(同 id), typeid, channel, arcrank, mid, click, title, senddate, flag, litpic(同picname), userip, lastpost, scores, goodpost, badpost, textlink
范例:
這個(gè)標簽用于調用單表模型的內容,在V5.3系統中加入了單表模型的概念,脫離了以前的主從表的數據表關(guān)聯(lián)結構,一般我們在添加內容模型的時(shí)候會(huì )選擇是否為單表模型還是主從表模型。
我們可以進(jìn)入系統后臺[核心]-[內容模型管理],查看系統現有的內容模型,在系統默認環(huán)境下,只有分類(lèi)信息是單表模型,一般添加單表模型,模型的id號都小于-1,即分類(lèi)信息模型id號為-8。
在使用這個(gè)標簽的時(shí)候,使用方法同arclist大致相同,我們來(lái)通過(guò)以下的標簽內容來(lái)調用分類(lèi)信息的內容:
html
{dede:arclistsg channelid='-8' limit='0,2'}
<a href='[field:arcurl/]'>[field:title/]</a> <br/>
{/dede:arclistsg}
這個(gè)標簽就是調用分類(lèi)信息的內容,從id為0開(kāi)始調用2條記錄,在系統后臺的[全局標簽測試]中顯示以下的內容:
autochannel 指定欄目 ?
**名稱(chēng):**autochannel
**功能:**指定排序位置的單個(gè)欄目的鏈接
語(yǔ)法:
html
{dede:autochannel partsort='2' typeid=1}
<a href='[field:typelink/]'>[field:typename/]</a>
{/dede:autochannel}
文件:
\include\taglib\autochannel.lib.php
function lib_autochannel(&$ctag,&$refObj)
默認底冊模板:
part_autochannel.htm
參數:
partsort = '0' 欄目所在的排序位置
typeid='0' 獲取單個(gè)欄目的頂級欄目
底層字段:
id,typelink,typedir,isdefault,defaultname,ispart,namerule2,typename,moresite,siteurl,sitepath,listman
cattree 樹(shù)形類(lèi)目 ?
**名稱(chēng):**cattree
**功能:**樹(shù)形類(lèi)目標簽
語(yǔ)法:
html
{dede:cattree typeid='' catid='' showall=''/}
文件:
\include\taglib\cattree.lib.php
lib_cattree(&$ctag, &$refObj)
**默認底層模板:**無(wú)
參數:
typeid='' 頂級樹(shù)id
catid=0 上級欄目id
showall='' 在空或不存在時(shí),強制用產(chǎn)品模型id;如果是 yes 剛顯示整個(gè)語(yǔ)言區欄目樹(shù);為其它數字則是這個(gè)數字的模型的id
底層字段:
無(wú)
channel 獲取欄目列表標簽 ?
**名稱(chēng):**channel
**功能:**織夢(mèng)常用標記,通常用于網(wǎng)站頂部以獲取站點(diǎn)欄目信息,方便網(wǎng)站會(huì )員分類(lèi)瀏覽整站信息
語(yǔ)法:
html
{dede:channel type='top' row='8' currentstyle="<li><a href='~typelink~' class='thisclass'>~typename~</a> </li>"}
<li><a href='[field:typelink/]'>[field:typename/]</a> </li>
{/dede:channel}
文件:
\include\taglib\channel.lib.php function lib_channel(&$ctag,&$refObj)
默認底層模板:
channel_list.htm
參數:
typeid = '0' 欄目ID
reid = '0' 上級欄目ID
row = '100' 調用欄目數
col = '1' 分多少列顯示(默認為單列)
type = 'son | sun' son表示下級欄目,self表示同級欄目,top頂級欄目
currentstyle = '' 應用樣式
底層字段:
ID(同 id),typeid, typelink, typename, typeurl,typedir(僅表示欄目的網(wǎng)址) 例:
html
{dede:channel type='top'}
<a href='[field:typelink /]'>[field:typename/]</a> {/dede:channel}
currentstyle中支持~rel~、~id~、~typelink~、~typename~
注:在沒(méi)有指定typeid的情況下,type標記與模板的環(huán)境有關(guān),如,模板生成到欄目一,那么type='son'就表示欄目一的所有子類(lèi)
范例:
這個(gè)標簽是全局常用標記,主要用于顯示頁(yè)面的欄目分類(lèi),我們可以查看默認模板\templets\default\head.htm中的相關(guān)代碼:
html
{dede:channel type='top' currentstyle="<li class='thisclass'><a href='~typelink~'>~typename~</a> </li>"}
<li><a href='[field:typeurl/]'>[field:typename/]</a></li>
{/dede:channel}
這里的欄目可以通過(guò)后臺進(jìn)行設置,欄目顯示順序按照排序的高低進(jìn)行,我們可以在系統后臺[核心]-[欄目管理]中進(jìn)行欄目設置:
設置完成我們可以在首頁(yè)頂部看到相關(guān)的效果
當然這里涉及到一個(gè)頂級欄目和子級欄目顯示的問(wèn)題,我們可以在模板中使用相應的標簽進(jìn)行調用,我們來(lái)看一個(gè)封面的頁(yè)面內容:
我們查看這個(gè)文章封面\templets\default\index_article.htm的模板標簽
html
<ul>
{dede:channel type='son' currentstyle="<li class='thisclass'><a href='~typelink~'><span>~typename~</span></a> </li>"}
<li>
<a href='[field:typeurl/]'>
<span>[field:typename/]</span>
</a>
</li>
{/dede:channel}
</ul>
這里就使用了 type='son'這個(gè)屬性用來(lái)顯示子欄目,currentstyle則代表當前選中項的呈現樣式。
很多用戶(hù)希望頂部導航連接便于SEO,需要去除超鏈接中的“index.html”,我們可以在這里對標簽進(jìn)行一個(gè)修改:
html
{dede:channel type='top'}
<li>
<a href='[field:typeurl function='str_replace("index.html","",@me)'/]'>
[field:typename/]
</a>
</li>
{/dede:channel}
channelartlist 當前頻道的下級欄目的內容列表 ?
**名稱(chēng):**channelartlist
**功能:**獲取當前頻道的下級欄目的內容列表標簽
語(yǔ)法:
html
{dede:channelartlist row=6}
<dl>
<dt>
<a href='{dede:field name='typeurl'/}'>
{dede:field name='typename'/}
</a>
</dt>
<dd>
{dede:arclist titlelen='42' row='10'}
<ul class='autod'>
<li><a href="[field:arcurl /]">[field:title /]</a></li>
<li>([field:pubdate function="MyDate('m-d',@me)"/])</li>
</ul>
{/dede:arclist}
</dl>
{/dede:channelartlist}
文件:
\include\taglib\channelartlist.lib.php function lib_channelartlist(&$ctag,&$refObj)
默認底層模板:
part_channelartlist.htm
參數:
typeid = '0' 頻道ID,多個(gè)請用","分開(kāi),如果調用1個(gè)欄目可以使用typeid='5,0'來(lái)調用。分隔 row = '20' 獲取的欄目返回值 其他說(shuō)明: 除了宏標記外,channelArtlist 是唯一一個(gè)可以直接嵌套其它標記的標記,不過(guò)僅限于嵌套 {dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist} 兩個(gè)標記。
底層字段:
包含{dede:type}{/dede:type}及{dede:arclist}{/dede:arclist}下面所有底層模板變量。
范例:
這個(gè)標簽是系統中不多的一個(gè)支持嵌套的標簽,這個(gè)標簽通常使用在首頁(yè)(含封面首頁(yè)),用于輸出一組欄目?jì)热萘斜?,我們可以看到默認模板首頁(yè):
這部分的內容就是通過(guò)這個(gè)標簽進(jìn)行顯示的,我們可以查看首頁(yè)模板\templets\default\index.htm
html
{dede:channelartlist}
<dl class="tbox">
<dt>
<strong>
<a href="{dede:field name='typeurl'/}">
{dede:field name='typename'/}
</a>
</strong>
<span class="more">
<a href="{dede:field name='typeurl'/}">更多...</a>
</span>
</dt>
<dd>
<ul class="d1 ico3">
{dede:arclist titlelen='60' row='8'}
<li>
<span class="date">
[field:pubdate function="MyDate('m-d',@me)"/]
</span>
<a href="[field:arcurl /]">[field:title /]</a>
</li>
{/dede:arclist}
</ul>
</dd>
</dl>
{/dede:channelartlist}
feedback 評論內容 ?
**名稱(chēng):**feedback
**功能:**用于調用最新評論
語(yǔ)法:
html
{dede:feedback}
<ul>
<li class='fbtitle'>[field:username function="(@me=='guest' ? '游客' : @me)"/] 對 [field:title/] 的評論:</li>
<li class='fbmsg'> <a href="plus/feedback.php?aid=[field:aid/]" class='fbmsg'>[field:msg /]</a></li>
</ul>
{/dede:feedback}
文件:
文件\include\taglib\feedback.lib.php
function lib_feedback(&$ctag,&$refObj)
默認底層模板:
tag_feedback.htm
參數:
row='12' 調用評論條數
titlelen='24' 標題長(cháng)度
infolen='100' 評論長(cháng)度
底層字段:
id,aid,typeid,username,arctitle,ip,ischeck,dtime,mid,bad,good,ftype,face,msg,title
范例:
這個(gè)標簽主要調用系統的會(huì )員評論信息,我們在默認模板首頁(yè)可以查看到相關(guān)的內容:
我們可以查看首頁(yè)的模板\templets\default\index.htm有如下代碼:
html
{dede:feedback row='5' titlelen='24' infolen='80'}
<li>
<small>
<a href="#" class="username">[field:username function="(@me=='guest' ? '游客' : @me)"/]</a> 評論
<a href="[field:global.cfg_phpurl/]/feedback.php?aid=[field:aid/]" class="title">[field:title/]</a>
</small>
<p>[field:msg/]</p>
</li>
{/dede:feedback}
這里調用的是會(huì )員最新評論的內容,當然我們也可以在系統后臺的[核心]-[評論管理]中對現有的評論進(jìn)行審核和編輯:
在[系統]-[系統基本參數] 的”互動(dòng)設置“中也有評論的相關(guān)設置選項,可以控制會(huì )員評論。
field 內容變量 ?
**名稱(chēng):**field
**功能:**用于獲取特定欄目或者檔案的字段值及常用的環(huán)境變量值
語(yǔ)法:
{dede:field name='字段名'/} 或者
文件:
所有視圖類(lèi)中
默認底層模板:
無(wú)
參數:
**板塊模板:**phpurl,indexurl,indexname,templeturl,memberurl, specurl
**列表模板:**position,title,phpurl,templeturl,memberurl,indexurl,indexname,specurl,欄目表dede_arctype的所有字段其中 position 為 “欄目一 > 欄目二” 這樣形式的鏈接,title則為這種形式的標題
**文檔模板:**position,phpurl,templeturl,memberurl,indexurl,indexname,specurl,id(同 ID,aid)
**文檔所有內容字段:**檔案#@__archives 表 和 附加表的所有字段。
flink 友情鏈接 ?
**名稱(chēng):**flink
**功能:**用于獲取友情鏈接,在DedeCMS系統中已經(jīng)默認集成友情鏈接插件,所以無(wú)需其他安裝即可使用該標簽。
語(yǔ)法:
文件:
\include\taglib\flink.lib.php
function lib_flink(&$ctag,&$refObj)
默認底層模板:
參數:
type='textall' 鏈接類(lèi)型
row=24 鏈接數量
titlelen=24 站點(diǎn)標題文字的長(cháng)度
linktype=1 鏈接位置內頁(yè)
typeid=0 友情鏈接類(lèi)型,默認為所有類(lèi)型,可以在系統后臺[模塊]-[友情鏈接]中的“網(wǎng)站類(lèi)型管理”中查看。
底層字段:
url,webname,logo,link
flinktype 友情鏈接類(lèi)型 ?
**名稱(chēng):**flinktype
**功能:**用于獲取友情鏈接類(lèi)型
語(yǔ)法:
html
{dede:flinktype type="dedecms"}
<a href="#" _for="flink_[field:id/]">[field:typename/]</a>
{/dede:flinktype}
文件:
\include\taglib\flinktype.lib.php
function lib_flinktype(&$ctag,&$refObj)
默認底層模板:
參數:
row=24 鏈接類(lèi)型數量
titlelen=24 鏈接文字的長(cháng)度
底層字段:
id,typename
范例:
html
{dede:flinktype type="dedecms"}
<a href="#" _for="flink_[field:id/]">[field:typename/]</a>
{/dede:flinktype}
同時(shí)flinktype可以同flink標簽進(jìn)行嵌套使用,用于循環(huán)生成分類(lèi)標簽,類(lèi)似channelarclist標簽。
html
{dede:flinktype type="dedecms"}
<dd id="flink_[field:id/]">
<ul class="f5">
{dede:flink/}
</ul>
</dd>
{/dede:flinktype}
global 全局配置變量標簽 ?
**名稱(chēng):**global
**功能:**獲取系統全局配置變量?jì)热?/p>
語(yǔ)法:
[field:global.cfg_webname/] 用于底層模板中
文件:
系統模板引擎
默認底層模板:
無(wú)
參數:
無(wú)
底層字段:
無(wú)
hotwords 搜索關(guān)鍵詞 ?
**名稱(chēng):**hotwords
**功能:**獲取網(wǎng)站搜索的熱門(mén)關(guān)鍵字
語(yǔ)法:
文件:
\include\taglib\hotwords.lib.php
function lib_hotwords(&$ctag,&$refObj)
默認底層模板:
無(wú)
參數:
num=6 關(guān)鍵詞數目
subday=365 調用天數以?xún)鹊年P(guān)鍵詞
maxlength=16 關(guān)鍵詞最大長(cháng)度
底層字段:
無(wú)
JSON數據調用 ?
**名稱(chēng):**json
**功能:**調用某個(gè)遠程連接的json接口,方便同遠程站點(diǎn)之間進(jìn)行通信來(lái)調取內容
語(yǔ)法:
html
{dede:json url='http://yoursite/json.php' cache=300}
[field:id/]-[field:title/]<br/>
{/dede:json}
文件:
\include\taglib\json.lib.php
function lib_json(&$ctag,&$refObj)
默認底層模板:
無(wú)
參數:
url='' 遠程json接口地址
注:所傳遞的數據需要是UTF-8編碼格式,否則可能會(huì )出現亂碼。
cache=300 緩存時(shí)間,0為不緩存
底層字段:
json傳遞數組字段
范例:
我們首先編寫(xiě)一個(gè)簡(jiǎn)單的服務(wù)器端API,將其存放在系統根目錄/api下,由于系統是GB2312編碼,所以服務(wù)端編寫(xiě)的時(shí)候我們進(jìn)行了一些編碼轉換的處理,保證服務(wù)端訪(fǎng)問(wèn)的編碼是UTF-8即可。
php
<?php
$cfg_NotPrintHead = false;
header("Content-Type: text/html; charset=utf-8");
include_once (dirname(__FILE__)."/../include/common.inc.php");
error_reporting(E_ALL || ~E_NOTICE);
require_once(DEDEINC.'/json.class.php');
$reval = array();
$dsql->SetQuery("SELECT id,title FROM `#@__archives` ORDER BY id DESC LIMIT 0,10");
$dsql->Execute('me');
while ($row = $dsql->GetArray('me')) {
$row['title'] = gb2utf8($row['title']);
$reval[] = $row;
}
$json = new Services_JSON(SERVICES_JSON_SUPPRESS_ERRORS);
echo $json->encode($reval);
?>
通過(guò)地址 http://help.dedecms.com/api/arcticle.php 我們可以訪(fǎng)問(wèn)到剛才編寫(xiě)的服務(wù)端文件。
下面我們就可以通過(guò)標簽來(lái)進(jìn)行訪(fǎng)問(wèn)。
html
{dede:json url='http://help.dedecms.com/api/arcticle.php' cache=0}
[field:id/]-[field:title/]<br/>
{/dede:json}
測試標記結果如下:
如果您是想獲取單條記錄,可以構造如下的數組:
$row[] = $dsql->GetOne(“SELECT * FROM #@__archives WHERE id=88”);
然后將這個(gè)數組通過(guò)JSON格式化進(jìn)行處理。
loop 萬(wàn)能調用標簽 ?
**名稱(chēng):**loop
**功能:**調用任意表的數據標簽
語(yǔ)法:
html
{dede:loop table='dede_archives' sort='' row='4' if=''}
<a href='[field:arcurl/]'>[field:title/]</a>
{/dede:loop}
文件:
\include\taglib\loop.lib.php
function lib_loop(&$ctag,&$refObj)
默認底層模板:
無(wú)
參數:
table='' 數據表名稱(chēng)
tablename='' 同table
row=8 調用數據的行數
sort='' 用于排序的字段
if='' 查詢(xún)的條件
ifcase='' 同if
orderway='desc' 排序方式,desc降序、asc升序
底層字段:
這個(gè)標記的底層模板變量即是被查詢(xún)表的所有字段
范例:
我們來(lái)查詢(xún)用戶(hù)id為1的用戶(hù)發(fā)布的文檔,可以用下面的標簽來(lái)表示:
html
{dede:loop table='#@__archives' sort='mid' row='4' if='mid=1'}
<a href='[field:arcurl/]'>[field:title/]</a>([field:mid/])<br />
{/dede:loop}
查詢(xún)結果如下:
loop標簽同時(shí)可以查詢(xún)跟DedeCMS處在同一個(gè)數據庫的數據表,如果您的論壇或者商城程序安裝在同一數據庫,也可以使用loop標簽進(jìn)行調用。
memberlist 會(huì )員列表 ?
**名稱(chēng):**memberlist
**功能:**調用會(huì )員列表
語(yǔ)法:
html
{dede:memberlist orderby='scores' row='20'}
<a href="../member/index.php?uid={dede:field.userid /}">
{dede:field.userid /}
</a>
<span>{dede:field.scores /}</span>
{/dede:memberlist}
文件:
\include\taglib\memberlist.lib.php
function lib_memberlist(&$ctag, &$refObj)
默認底層模板:
memberlist.htm
參數:
row = '6' 調用數目
iscommend = '0' 是否為推薦會(huì )員
orderby = 'logintime' 按登陸時(shí)間排序 money 按金錢(qián)排序 scores 按積分排序
signlen=50 簽名長(cháng)度
底層字段:
#@__member所有字段及spacename(空間名稱(chēng))、sign(用戶(hù)簽名)
范例:
用于調用會(huì )員相關(guān)的列表信息,我們可以在默認模板中查看\templets\default\index.htm
html
<div class="latestlogin">
<strong>最近登陸的會(huì )員</strong>
<ul class="e7">
{dede:memberlist row=6 signlen=30}
<li>
<a href="[field:spaceurl/]" target="_blank">
<img src="[field:face/]" alt='[field:spacename/]' width="52" height="52" />
[field:uname/]
</a>
</li>
{/dede:memberlist}
</ul>
</div>
<!-- /latestlogin -->
我們可以查看網(wǎng)站首頁(yè)部分:
當然這里也可以通過(guò)指定orderby的屬性來(lái)調用不同形式排序的內容。
myad 廣告 ?
**名稱(chēng):**myad
**功能:**調用廣告內容
語(yǔ)法:
文件:
\include\taglib\myad.lib.php
function lib_myad(&$ctag, &$refObj)
默認底層模板:
無(wú)
參數:
name='' 標記名稱(chēng),該項是必須的屬性,以下 2、3是可選屬性
ismake='no' 默認是 no 表示設定的純HTML代碼, yes 表示含板塊標記的代碼
typeid=0 表示所屬欄目的ID,默認為 0 ,表示所有欄目通用的顯示內容,在列表和文檔模板中,typeid默認是這個(gè)列表或文檔本身的欄目ID
底層字段:
無(wú)
范例:
在系統后臺可以添加一個(gè)廣告
廣告位標識就是廣告標簽的id,那么可以使用:
html
<div class="banner">
{dede:myad name='innerTopBanner1'/}
</div>
來(lái)調用出對應的廣告位內容。
可以直接在廣告管理頁(yè)面,點(diǎn)擊“代碼”選項來(lái)獲取對應的代碼。
mynews 站內新聞 ?
**名稱(chēng):**mynews
**功能:**站內新聞
語(yǔ)法:
[field:title /]
發(fā)布人:[field:writer /]
時(shí)間:[field:senddate function='MyDate("Y-m-d H:i:s","@me")'/]
[field:body /]
文件:
\include\taglib\mynews.lib.php
function lib_mynews(&$ctag,&$refObj)
默認底層模板:
mynews.htm
參數:
row=1 調用站內新聞數
titlelen=24 新聞標題長(cháng)度
底層字段:
aid,typeid,title,writer,senddate,body
范例:
系統默認已經(jīng)安裝了站內新聞的插件,我們直接在后臺[模塊]-[站內新聞]選項卡中來(lái)添加站內新聞。
我們使用下面的標簽:
html
{dede:mynews row='2' titlelen=''/}
<b>[field:title /]</b>
發(fā)布人:[field:writer /]
時(shí)間:[field:senddate function='MyDate("Y-m-d H:i:s","@me")'/]<br />
{/dede:mynews}
測試后標簽調用信息內容如下:
mytag 自定義宏標簽 ?
**名稱(chēng):**mytag
**功能:**自定義宏標記調用標簽
語(yǔ)法:
文件:
\include\taglib\mytag.lib.php
function lib_mytag(&$ctag, &$refObj)
默認底層模板:
無(wú)
參數:
name='' 標記名稱(chēng),該項是必須的屬性,以下 2、3是可選屬性
ismake='no' 默認是 no 表示設定的純HTML代碼, yes 表示含板塊標記的代碼
typeid=0 表示所屬欄目的ID,默認為 0 ,表示所有欄目通用的顯示內容,在列表和文檔模板中,typeid默認是這個(gè)列表或文檔本身的欄目ID
底層字段:
無(wú)
范例:
可以在系統后臺[模板]-[自定義宏標記](méi)中增加一個(gè)內容,這個(gè)內容可以是一段普通的HTML,也可以是織夢(mèng)的某個(gè)標簽塊。
這樣我們可以直接使用標簽:
{dede:mytag name='auto_1' ismake='yes'/}來(lái)調用上面的內容。
php php標簽 ?
**名稱(chēng):**php
**功能:**執行PHP代碼
語(yǔ)法:
php
{dede:php}
$a = "dede";
echo $a;
{/dede:php}
文件:
\include\taglib\php.lib.php
function lib_php(&$ctag, &$refObj)
默認底層模板:
無(wú)
參數:
無(wú)
底層字段:
無(wú)
范例:
注:PHP標簽由于采用直接執行php代碼,在使用的時(shí)候需要注意其安全性。
softmsg 軟件下載提示信息 ?
**名稱(chēng):**softmsg
**功能:**調用下載說(shuō)明
語(yǔ)法:
文件:
\include\taglib\softmsg.lib.php
function lib_softmsg(&$ctag,&$refObj)
默認底層模板:
無(wú)
參數:
無(wú)
底層字段:
無(wú)
范例:
在系統后臺[系統]-[軟件頻道設置]中配置下載說(shuō)明:
使用標簽就可以調用這里的信息。
sonchannel 子欄目調用 ?
**名稱(chēng):**sonchannel
**功能:**子欄目調用標簽
語(yǔ)法:
html
{dede:sonchannel}
<a href='[field:typeurl/]'>[field:typename/]</a>
{/dede:sonchannel}
文件:
\include\taglib\sonchannel.lib.php
function lib_sonchannel(&$ctag,&$refObj)
默認底層模板:
無(wú)
參數:
row=100 返回數目
col=1 默認單列顯示
nosonmsg='' 沒(méi)有指定ID子欄目顯示的信息內容
底層字段:
id,typename,typedir,isdefault,ispart,defaultname,namerule2,moresite,siteurl,sitepath,listman
范例:
這個(gè)標簽使用的時(shí)候需要注意要在某個(gè)特定欄目下才能夠正常被調用。
sql SQL查詢(xún)標簽 ?
**名稱(chēng):**sql
**功能:**用于獲取MySQL數據庫內容的標簽
語(yǔ)法:
html
{dede:sql sql='' appname='default'}
[field:title/]
{/dede}
文件:
\include\taglib\sql.lib.php
function lib_sql(&$ctag,&$refObj)
默認底層模板:
無(wú)
參數:
sql='' 需要查詢(xún)的sql語(yǔ)句
appname='default' 這個(gè)參數在DedeCMS 5.7中有效,可以調用其他服務(wù)器或者數據庫上的信息,默認為default,即當前系統所運行的數據庫,可在data/tag/sql.inc.php中擴展,在DedeCMS V5.7 中用戶(hù)可以通過(guò)后臺[模板]-[SQL標簽應用管理]來(lái)配置應用。
底層字段:
所有SQL語(yǔ)句查詢(xún)出來(lái)的字段
范例:
我們通過(guò)下列標簽來(lái)調用phpwind論壇的會(huì )員信息。
html
{dede:sql sql='SELECT uid,username,email,memberid FROM `phpwind87`.pw_members ORDER BY uid desc' appname='phpwind'}
[field:uid/]-[field:username/]<br />
{/dede:sql}
標簽調試結果內容如下:
TAG調用標簽 ?
**名稱(chēng):**tag
**功能:**TAG調用
語(yǔ)法:
html
{dede:tag sort='new' getall='0'}
<a href='[field:link/]'>[field:tag /]</a>
{/dede:tag}
文件:
\include\taglib\tag.lib.php
function lib_tag(&$ctag,&$refObj)
默認底層模板:
tag_one.htm
參數:
row=30 調用條數
sort='new' 排序方式 month,rand,week,hot,total
底層字段:
keyword,tag,link,highlight,
type 指定欄目調用標簽 ?
**名稱(chēng):**type
**功能:**獲取指定欄目鏈接
語(yǔ)法:
html
{dede:type}
<a href="[field:typelink /]">[field:typename /]</a>
{/dede:type}
文件:
\include\taglib\type.lib.php
function lib_type(&$ctag,&$refObj)
默認底層模板:
part_type_list.htm
參數:
typeid=0 指定欄目ID,如果沒(méi)有指定則獲取當前頁(yè)面下的環(huán)境變量
底層字段:
id,typelink,typename,typedir,isdefault,ispart,defaultname,namerule2,moresite,siteurl,sitepath,listman
范例:
vote 投票標簽 ?
**名稱(chēng):**vote
**功能:**用于獲取一組投票表單,系統默認安裝了投票插件,可在[模塊]-[輔助插件]-[投票模塊]中來(lái)添加或者獲取投票標簽
語(yǔ)法:
html
{dede:vote id='' lineheight='22' tablewidth='100%' titlebgcolor='#EDEDE2' titlebackground='' tablebgcolor='#FFFFFF'/}
{/dede}
文件:
\include\taglib\vote.lib.php
function lib_vote(&$ctag,&$refObj)
默認底層模板:
無(wú)
參數:
id=0 數字,當前投票ID
lineheight=24 表格高度
tablewidth='100%' 表格寬度
titlebgcolor='#EDEDE2' 投票標題背景色
titlebackgroup='' 標題背景圖
tablebg='#FFFFFF' 投票表格背景色
底層字段:
無(wú)