A-A+

Dede织梦_模板标签代码参考

2011年01月16日 DedeCMS 暂无评论

DedeCms系统的模板是非固定的,用户可以在新建栏目时可以自行选择栏目模板,官方仅提供最基本的默认模板,即是内置系统模型的各个模板,由于 DedeCms支持自定义频道模型,用户自定义新频道模型后,还需要按该模型的字段设计一套新的模板,此外,DedeCms也支持使用风格的形式使用模 板,默认风格是 default,它表示系统默认使用 cmspath/templets/default 这个文件夹的模板,假如你下载了一套新的模板,你可以不必要删除 default 原有的文件,把下载的模板文件夹命名你想要的风格名称,如 style2 等,然后在后台修改了默认的模板风格名称为 style2 ,那系统将使用 templets/style2 这文件当作默认模板,但是若你手工指定了栏目模板的位置,则后台参数风格的定义无效。

一、概念,设计和使用模板,必需要理解下面几个概念

1、板块(封面)模板:
指网站主页或比较重要的栏目封面频道使用的模板,一般用“index_识别ID.htm”命名,此外,用户单独定义的单个页面或自定义标记,也可选是否支持板块模板标记,假如支持,系统会用板块模板标记引擎去解析后才输出内容或生成特定的文件。
2、列表模板:
指网站某个栏目的一切文章列表的模板,一般用 “list_识别ID.htm” 命名。
3、档案模板:
表示文档查看页的模板,如文章模板,一般用 “article_识别ID.htm” 命名。
4、其它模板:
一般系统常规包含的模板有:主页模板、搜索模板、RSS、JS编译功能模板等,此外用户也可以自定义一个模板创建为任意文件。

二、 命名,DedeCms模板默认命名规则如下

1、模板保存位置:
模板目录:cmspath/templets/样式名称(英文,默认为default,其中system为系统底层模板,plus为插件使用的模板)/具体功能模板文件}
2、 模板文件命名规范:
(1)index_识别ID.htm: 表示板块(栏目封面)模板;
(2)list_识别ID.htm: 表示栏目列表模板;
(3)article_识别ID.htm: 表示内容查看页(文档模板,包括专题查看页);
(4)search.htm: 搜索结果列表模板; 
(5)index.htm: 主页模板; 

注解:[识别ID]可以在“频道模型治理”的地方获得,当然,你也可以在“频道模型治理”的地方确定某个频道的模板命名。

例:list_image.htm 表示是就是内容类型为图片集的栏目默认列表模板。
article_article.htm 表示的是文章查看页模板。

三、其它模板说明

1、默认底层模板
位置: cmspath/templets/system
功能:在没有指定标记的默认底层模板的时候,系统将自动调用这个文件夹的相应文件作为底层模板。
2、插件目录模板
位置: cmspath/templets/plus
功能:评论、友情链接、RSS地图等模板。
3、会员后台模板
位置: cmspath/member/templets
功能:会员后台的模板。

四、二次开发 

DedeCms主要的模板解析类是 include/inc_arcpart_view.php、include/inc_arclist_view.php、include /inc_archives_view.php,这些类是与pub_dedetag.php一起工作的,假如你想为文档模板、列表模板、板块模板增加一些 功能,可以直接修改这几个类的ParseTemplet()或ParseTempletsFirst()这类的方法,把标记名称,属性对应试相应该的功能 函数即时。 

Power by Dedecms.com 版权一切

◆ 织梦模板标记简介:


在了解DedeCms的模板代码之前,了解一下织梦模板引擎的知识是非常有意义的。织梦模板引擎是一种使用XML名字空间形式的模板解析器,使用织梦解析器解析模板的最大好处是可以轻松的制定标记的属性,感觉上就像在用HTML一样,使模板代码非常直观灵活,新版的织梦模板引擎不单能实现模板的解析还能分析模板里错误的标记。

1、织梦模板引擎的代码样式有如下几种形式:
{dede:标记名称 属性='值'/}
{dede:标记名称 属性='值'}{/dede:标记名称}
{dede:标记名称 属性='值'}自定义样式模板(InnerText){/dede:标记名称}

提示:
假如使用带底层模板的标记,必需严格用{dede:标记名称 属性='值'}{/dede:标记名称} 这种格式,否则会报错。

2、织梦模板引擎内置有多个系统标记,这些系统标记在任何场合都是能直接使用的。

(1) global 标记,表示获取一个外部变量,除了数据库密码之外,能调用系统的任何配置参数,形式为:
{dede:global name='变量名称'}{/dede:global}

{dede:global name='变量名称'/}

其中变量名称不能加 $ 符号,如变量 $cfg_cmspath ,应该写成 {dede:global name='cfg_cmspath'/} 。

(2) foreach 用来输出一个数组,形式为:
{dede:foreach array='数组名称'}[field:key/] [field:value/]{/dede:foreach}

(3) include 引入一个文件,形式为:
{dede:include file='文件名称' ismake='是否为dede板块模板(yes/no)'/}
对文件的搜索路径为顺序为:绝对路径、include文件夹,CMS安装目录,CMS主模板目录

3、织梦标记答应在任何标记中使用函数对得到的值进行处理,形式为:
{dede:标记名称 属性='值' function='youfunction("参数一","参数二","@me")'/}
其中 @me 用于表示当前标记的值,其它参数由你的函数决定是否存在,例如:
{dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")'/}

4、织梦标记答应有限的编程扩展。
格式为:
{dede:tagname runphp='yes'}
$aaa = @me;
@me = "123456";
{/dede:tagname} 
@me 表示这个标记本身的值,因此标记内编程是不能使用echo之类的语句的,只能把一切返回值传递给@me。
此外由于程序代码占用了底层模板InnerText的内容,因此需编程的标记只能使用默认的InnerText。

Power by Dedecms.com 版权一切

◆织梦内容治理系统模板标签代码参考


【Arclist 标记   这个标记是DedeCms最常用的一个标记,也叫自由列表标记,其中 hotart、coolart、likeart、artlist、imglist、imginfolist、specart、autolist 这些标记都是由这个标记所定义的不同属性延伸出来的别名标记。 功能说明:获取指定的文档列表 适用范围:封面模板、列表模板、文档模板 基本语法:
{dede:arclist typeid='' row='' col='' titlelen='' infolen='' 
imgwidth='' imgheight='' listtype='' orderby='' keyword=''}
底层模板(InnerText)
{/dede:arclist} 属性说明:
typeid='' 表示栏目ID,在列表模板和档案模板中一般不需要指定,在封面模板中答应用","分开表示多个栏目;
row='' 表示返回文档列表总数;
col='' 表示分多少列显示(默认为单列);
titlelen='' 表示标题长度;
infolen='' 表示内容简介长度;
imgwidth='' 表示缩略图宽度;
imgheight='' 表示缩略图高度;
type='' 表示档案类型,其中空值、不使用这个属性或type='all'时为普通文档
§ type='commend'时,表示推荐文档,同等于 {dede:coolart}{/dede:coolart}
§ type='image'时,表示必需含有缩略图片的文档,同等于{dede:imglist}{/dede:imglist}、{dede:imginfolist}{/dede:imginfolist}
§ type='spec'时,表示专题,同等于标记{dede:specart}{/dede:specart}
以上属性值可以联合使用,如: type='commend image' 表示推荐的图片文档
orderby='' 表示排序方式,默认值是 senddate 按发布时间排列。 
§ orderby='hot' 或 orderby='click' 表示按点击数排列
§ orderby='pubdate' 按出版时间排列(即是前台答应更改的时间值)
§ orderby='sortrank' 按文章的新排序级别排序(假如你想使用置顶文章则使用这个属性)
§ orderby='id' 按文章ID排序
§ orderby='postnum' 按文章评论次数排序
§ orderby='rank' 随机获得指定条件的文档列表
orderway='' 值为 desc 或 asc ,指定排序方式是降序还是顺向排序,默认为降序。
keyword='' 表示含有指定要害字的文档列表,多个要害字用","分开
channelid='' 表示特定的频道模型ID,内置的频道:专题(-1)、文章(1)、图集(2)、Flash(4)、软件(3)
limit='起始,结束' 表示限定的记载范围,row属性必需等于"结束 - 起始",mysql的limit语句是由0起始的,如 “limit 0,5”表示的是取前五笔记载,“limit 5,5”表示由第五笔记载起,取下五笔记载,使用了本属性后,row属性将无效。
att='数值' 表示自定义属性值
subday='天数' 表示在多少天以内的文档,通常用于获取指定天数的热门文档、推荐文档、热门评论文档等
partsort='排列位数' 表示自动获得父栏目的一切子数中排列在第几位的栏目ID,标记为 {dede:autolist}{/dede:autolist} 时,使用本属性才有效。

底层模板字段:
ID(同 id),title,iscommend,color,typeid,ismake,description(同 info),writer,shorttitle,memberid
pubdate,senddate,arcrank,click,litpic(同 picname),typedir,typename,
arcurl(同 filename),typeurl,stime(pubdate 的"0000-00-00"格式),
textlink,typelink,imglink,image 
其中:
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'> 
字段调用方法:[field:varname/]
如:
{dede:arclist infolen='100'}
[field:textlink/]
<br>
[field:info/]
<br>
{/dede:arclist} 
注:底层模板里的Field实现也是织梦标记的一种形式,因此支持使用PHP语法,Function扩展等功能
如: 给当天发布的内容加上 (new) 标志
[field:senddate runphp='yes'] 
$ntime = time();
$oneday = 3600 * 24;
if(($ntime - @me)<$oneday) @me = "<font color='red'>(new)</font>";
else @me = "";
[/field:senddate]
【Field 标记】

功能说明:用于获取特定栏目或档桉的字段值及常用的环境变量值
适用范围:封面模板、列表模板、文档模板
(1)基本语法
{dede:field name='字段名'/}
(2) 系统分配的field
板块模板:phpurl,indexurl,indexname,templeturl,memberurl,powerby,webname,specurl 
列表模板:position,title,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl,栏目表dede_arctype的一切字段
其中 position 为 “栏目一 > 栏目二” 这样形式的链接,title则为这种形式的标题 
文档模板:position,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl,id(同 ID,aid)
(3) 文档一切内容字段
档案dede_archives表 和 附加表的一切字段。 

【Channel 标记】 

功能说明:用于获取栏目列表 
适用范围:封面模板、列表模板、文档模板 
(1)基本语法
{dede:channel row='' type=''}
自定义样式模板(InnerText)
{/dede:channel} 
(2)属性 
row='数字' 表示获取记载的条数(通用在某级栏目太多的时候使用,默认是 8) 
type = top,sun/son,self 
type='top' 表示顶级栏目
type='son' 或 'sun' 表示上级栏目
type='self' 表示同级栏目 
其中后两个属性必需在列表模板中使用。 
(3)底层模板变量 
ID,typename,typedir,typelink(仅表示栏目的网址) 
例:
{dede:channel type='top'}
<a href='[field:typelink /]'>[field:typename/]</a> 
{/dede:channel} 
注:在没有指定typeid的情况下,type标记与模板的环境有关,如,模板生成到栏目一,那么type='son'就表示栏目一的一切子类

【Type 标记】别名 onetype 

功能说明:表示指定的单个栏目的链接
适用范围:
封面模板、列表模板、文档模板
(1)语法
 {dede:type typeid=''}{/dede:type}
(2)属性 typeid='栏目ID'
(3)底层模板变量 
typename,typelink(仅表示栏目的网址)

【Autochannel 标记】
功能说明:表示指定排序位置的单个栏目的链接
适用范围:
封面模板、列表模板、文档模板
(1)语法
 {dede:autochannel partsort=''}{/dede:autochannel}
(2)属性 partsort='栏目所在的排序位置'
(3)底层模板变量 
typename,typelink(仅表示栏目的网址)

【Mytag 标记】 

功能说明:用于获取自定义宏标记的内容 
适用范围:封面模板、列表模板、文档模板 
(1)基本语法 
{dede:mytag typeid='' name='' ismake=''/} 
(2)属性 
typeid = '数字' 表示栏目ID,默认为 0,在没有设定的栏目没有定义这个名称的标记,会按如下搜索方式来搜索“先向上查找父栏目 -> 通用标记(typeid=0)的同名标记”。 
name = '' 标记名称。 
ismake = yes|no 默认为 no 表示mytag里的内容不包含其它封面模板的标记,yes则表示标记内容含有其它封面模板标记。 

【Vote 标记】
 

功能说明:用于获取一组投票表单 
适用范围:封面模板 
(1) 基本语法
{dede:vote id='投票ID' lineheight='22'
tablewidth='100%' titlebgcolor='#EDEDE2'
titlebackground='' tablebgcolor='#FFFFFF'}
{/dede:vote} 
注:本标记直接生成投票的HTML表单,为了让你更方便修改其样式,建议在后台->投票治理的地方直接复制生成的HTML代码来使用。

【Flink 标记】,同等 friendlink 

功能说明:用于获取友情链接 
适用范围:封面模板 
(1)基本语法 
{dede:flink type='' row='' col='' titlelen='' tablestyle=''}{/dede:flink}
(2)属性
type:链接类型,值:
a. textall 全部用文字显示
b. textimage 文字和图得混合排列
c. text 仅显示不带Logo的链接
d. image 仅显示带Logo的链接
-------------------------------------
row:显示多少行,默认为4行
col:显示多少列,默认为6列
titlelen:站点文字的长度
tablestyle: 表示 <table 这里的内容

【Mynews 标记】 
功能说明:用于获取站内新闻 
适用范围:封面模板 
(1) 基本语法 
{dede:mynews row='条数' titlelen='标题长度'}Innertext{/dede:mynews}
(2)属性
row 新闻条数
titlelen 标题长度
(3)底层模板变量
[field:title/]、[field:writer/]、
[field:senddate function="strftime('%y-%m-%d %H:%M',@me)"/](时间)、[field:body/] 

【LOOP 标记】
 

功能说明:用于调用任意表的数据,一般用于调用论坛贴子之类的操作
适用范围:一切模板
(1) 基本语法
{dede:loop table=' sort='' row='' if=''} 
底层模板
{dede:loop} 
(2) 属性
table 表示查询的数据表
sort 用于排序的字段
row 返回结果的条数
if 查询条件
(3)底层模板变量
这个标记的底层模板变量即是被查询表的一切字段
例:获取DZ论坛的最新主题贴子

标签:

给我留言

Copyright © 破晓Web实验室 保留所有权利.   Theme  Ality 沪ICP备14044094号

用户登录