码迷,mamicode.com
首页 > 其他好文 > 详细

dede模板制作

时间:2015-04-04 10:41:03      阅读:133      评论:0      收藏:0      [点我收藏+]

标签:

解析引擎概述  模板设计规范  代码参考
标记参考: arclist(artlist,likeart,hotart,imglist,imginfolist,coolart,specart) field channel mytag vote friendlink mynews loop channelartlist page list pagelist pagebreak fieldlist

一、织梦模板解析引擎概述 在了解DedeCms的模板代码之前,了解一下织梦模板引擎的知识是非常有意义的。cfg_cmspath ,应该写成 {dede:global name=‘cfg_cmspath‘ /} 。

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

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

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

二、DedeCms 模板制作规范

  DedeCms系统的模板是非固定的,用户可以在新建栏目时可以自行选择栏目模板,官方仅提供最基本的默认模板,即是内置系统模型的各个模板,DedeCms支持自定义频道模型,用户自定义新频道模型后,需要按该模型设计一套新的模板。
一、概念,设计和使用模板,必须要理解下面几个概念:
1、板块(封面)模板:
  指网站主页或比较重要的栏目封面使用的模板,一般用“index_识别ID.htm”命名,此外,用户单独定义的单个页面或自定义标记,也可选是否支持板块模板标记,如果支持,系统会用板块模板标记引擎去解析后才输出内容或生成特定的文件。
2、列表模板:
  指网站某个栏目的所有文章列表的模板,一般用 “list_识别ID.htm” 命名。
3、档案模板:
  表示文档查看页的模板,一般用 “article_识别ID.htm” 命名。
4、其它模板:
  一般系统常规包含的模板有:主页模板、搜索模板、RSS、JS编译功能模板等,此外用户也可以自定义一个模板创建为任意文件。

二、 命名,为了规范起见,织梦官方建议使用统一的方式来命名模板,具体如下:
1、模板保存位置:
  模板目录:{cmspath/templets/样式名称(英文,默认为default,其中system为系统底层模板,plus为插件使用的模板)/具体功能模板文件}
  一般的模板位置:“/templets/default”
2、 模板文件命名规范:
(1)index_识别ID.htm: 表示板块(栏目封面)模板;
(2)list_识别ID.htm: 表示栏目列表模板;
(3)article_识别ID.htm: 表示内容查看页(文档模板,包括专题查看页);
(4)search.htm: 搜索结果列表模板;
(5)index.htm: 主页模板;
注解:
你的系统各个内容频道的[识别ID]分别为:
例:list_image.htm 表示是就是内容类型为图片集的栏目默认列表模板。

三、主要标记参考

1、arclist 标记

这个标记是DedeCms最常用的一个标记,其中 hotart、coolart、likeart、artlist、imglist、imginfolist、specart 这些标记都是由这个标记所定义的不同属性延伸出来的。

作用:获取一个指定的文档列表

适用范围:封面模板、列表模板、文档模板

(1)基本语法:

{dede:arclist
typeid=‘‘ row=‘‘ col=‘‘ titlelen=‘‘
infolen=‘‘ imgwidth=‘‘ imgheight=‘‘ listtype=‘‘ orderby=‘‘ keyword=‘‘}

自定义样式模板(InnerText)

{/dede:arclist}

本标记等同于artlist、imglist、imginfolist标记,其中与artlist是完全等同的,与imglist、imginfolist仅是默认的底层模板不同。


(2)属性参考:

[1] typeid=‘‘ 表示栏目ID,在列表模板和档案模板中一般不需要指定,在封面模板中允许用","分开表示多个栏目;
[2] row=‘‘ 表示返回文档行数,如果和col联合使用,刚结果数等于row * col;
[3] col=‘‘ 表示分多少列显示(默认为单列);
[4] titlelen=‘‘ 表示标题长度;
[5] infolen=‘‘ 表示内容简介长度;
[6] imgwidth=‘‘ 表示缩略图宽度;
[7] imgheight=‘‘ 表示缩略图高度;
[8] type=‘‘ 表示档案类型,其中默认值或type=‘all‘时为普通文档
§ type=‘commend‘时,表示推荐文档,等同于
§ type=‘image‘时,表示必须含有缩略图片的文档
[9] orderby=‘‘ 表示排序方式,默认值是 senddate 按发布时间排列。
§ orderby=‘hot‘ 或 orderby=‘click‘ 表示按点击数排列
§ orderby=‘pubdate‘ 按出版时间排列(即是前台允许更改的时间值)
§ orderby=‘sortrank‘ 按文章的新排序级别排序(如果你想使用置顶文章则使用这个属性)
§ orderby=‘id‘ 按文章ID排序
[10] keyword=‘‘ 表示含有指定关键字的文档列表,多个关键字用","分开
[11] channelid=‘数字‘ 表示特定的频道类型,内置的频道:专题(-1)、文章(1)、图集(2)、Flash(4)、软件(3)
[12] limit=‘起始,结束‘ 表示限定的记录范围,row属性必须等于"结束 - 起始",mysql的limit语句是由0起始的,如 “limit 0,5”表示的是取前五笔记录,“limit 5,5”表示由第五笔记录起,取下五笔记录。

(3)底层模板变量

ID(同 id),title,iscommend,color,typeid,ismake,description(同 info),
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}

2、field 标记

这个标记用于获取特定栏目或档桉的字段值及常用的环境变量值

适用范围:封面模板、列表模板、文档模板

(1)基本语法

{dede:field name=‘‘/}

(2) name 属性的值:

板块模板: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),档案dede_archives表和附加表的所有字段。


3、channel 标记

用于获取栏目列表

适用范围:封面模板、列表模板、文档模板

(1)基本语法
{dede:channel row=‘‘ type=‘‘}
自定义样式模板(InnerText)
{/dede:channel}

(2)属性

[1] row=‘数字‘ 表示获取记录的条数(通用在某级栏目太多的时候使用,默认是 8)

[2] type = top,sun,self

type=‘top‘ 表示顶级栏目
type=‘sun‘ 表示下级栏目
type=‘self‘ 表示同级栏目

其中后两个属性必须在列表模板中使用。

(3)底层模板变量

ID,typename,typedir,typelink(这里仅表示栏目的网址)

例:
{dede:channel type=‘top‘}
<a href=‘[field:typelink /]‘> [field:typename/] </a>
{/dede:channel}

4、mytag 标记

用于获取自定义标记的内容

适用范围:封面模板、列表模板、文档模板

(1)基本语法

{dede:mytag typeid=‘‘ name=‘‘ ismake=‘‘ /}

(2)属性

[1] typeid = ‘数字‘ 表示栏目ID,默认为 0,在没有设定的栏目没有定义这个名称的标记,会按如下搜索方式来搜索“先向上查找父栏目 -> 通用标记(typeid=0)的同名标记”。

[2] name = ‘‘ 标记名称。

[3] ismake = yes|no 默认为 no 表示mytag里的内容不包含其它封面模板的标记,yes则表示标记内容含有其它封面模板标记。

5、vote 标记

用于获取一组投票表单

适用范围:封面模板

(1) 基本语法
{dede:vote id=‘投票ID‘ lineheight=‘22‘
tablewidth=‘100%‘ titlebgcolor=‘#EDEDE2‘
titlebackground=‘‘ tablebgcolor=‘#FFFFFF‘}
{/dede:vote}


6、friendlink 标记,等同 flink

用于获取友情链接

适用范围:封面模板

(1)基本语法

{dede:flink type=‘‘ row=‘‘ col=‘‘ titlelen=‘‘ tablestyle=‘‘}{/dede:flink}
属性注解:
[1]type:链接类型,值:
a. textall 全部用文字显示
b. textimage 文字和图得混合排列
c. text 仅显示不带Logo的链接
d. image 仅显示带Logo的链接
-------------------------------------
[2]row:显示多少行,默认为4行
[3]col:显示多少列,默认为6列
[4]titlelen:站点文字的长度
[5]tablestyle: 表示 <table 这里的内容>

7、mynews 标记

用于获取站内新闻

适用范围:封面模板

(1) 基本语法

{dede:mynews row=‘条数‘ titlelen=‘标题长度‘}Innertext{/dede:mynews}

Innertext支持的字段为:[field:title /],[field:writer /],[field:senddate /](时间),[field:body /]

8、
loop 标记

用于调用任意表的数据,一般用于调用论坛贴子之类的操作,请参阅论坛扩展插件。

9、channelartlist 标记

用于获取频道的下级栏目的内容列表

适用范围:封面模板

语法:

{dede:channelArtlist typeid=0 col=2 tablewidth=‘100%‘}
<table width="99%" border="0" cellpadding="3" cellspacing="1" bgcolor="#BFCFA9">
<tr>
<td bgcolor="#E6F2CC">
{dede:type}
<table border="0" cellpadding="0" cellspacing="0" width="98%">
<tr>
<td width=‘10%‘ align="center"><img src=‘ [field:global name=‘cfg_plus_dir‘/] /img/channellist.gif‘ width=‘14‘ height=‘16‘></td>
<td width=‘60%‘>
<a href=" [field:typelink /] "> [field:typename /] </a>
</td>
<td width=‘30%‘ align=‘right‘>
<a href="[field:typelink /]">更多...</a>
</td>
</tr>
</table>
{/dede:type}
</td>
</tr>
<tr>
<td height="150" valign="top" bgcolor="#FFFFFF">
{dede:arclist row="8"}
·<a href="[field:arcurl /]">[field:title /]</a><br>
{/dede:arclist}
</td>
</tr>
</table>
<div style=‘font-size:2px‘> </div>
{/dede:channelArtlist}

channelArtlist 是唯一一个可以直接嵌套其它标记的标记,不过仅限于嵌套

{dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist}

标记。

(1) 属性
typeid=0 频道ID,默认的情况下,嵌套的标记使用的是这个栏目ID的下级栏目,如果你想用特定的栏目,可以用","分开多个ID。

col=2 分多列显示

tablewidth=‘100%‘ 外围表格的大小


10、page 标记

表示分页页面的附加参数

适用范围:列表模板

语法:

{dede:page pagesize="每页结果条数"/}

11、list 标记

表示列表模板里的内容列表

语法:

{dede:list col=‘‘ titlelen=‘‘
infolen=‘‘ imgwidth=‘‘ imgheight=‘‘ orderby=‘‘}{/dede:list}

底层模板变量

ID(同 id),title,iscommend,color,typeid,ismake,description(同 info),
pubdate,senddate,arcrank,click,litpic(同 picname),typedir,typename,
arcurl(同 filename),typeurl,stime(pubdate 的"0000-00-00"格式),
textlink,typelink,imglink,image

12、pagelist 标记

表示分页页码列表

适用范围:列表模板

语法:

{dede:pagelist listsize="3"/}

listsize 表示 [1][2][3] 这些项的长度 x 2

13、pagebreak 标记

用途:表示文档的分页链接列表。
适用范围:仅文档模板。
语法:{dede:pagebreak /}

14、 fieldlist 标记
用途:获得附加表的所有字段信息。
适用范围:仅文档模板。
语法:
{dede:fieldlist}
[field:name /] : [field:value /] <br>
{/dede:fieldlist}

dede模板制作

标签:

原文地址:http://www.cnblogs.com/onlylove2015/p/4391679.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!