DedeCMS常用标签讲解笔记整理

 

DedeCMS常用标签讲解笔记整理

DedeCMS常用标签讲解笔记整理

 

在之前的课程中，我们也介绍了模板的解析原理，我们来回顾下：

 

这个是我们最常用的一个arclist标记，这个标记主要功能就是用于调用文档内容，以列表的形式显示在前台页面中。

 

系统首先读取模板文件，然后第一步就是解析标记，解析标记就是将整个标签的属性、属性值提取出来，让后根据这些不同的属性值来调用不同的内容。这个我们在后面单独的几个标记中具体说明。

 

我们下面来了解下DedeCMS模板文件的结构，网站内容显示部分的模板主要存放在根目录的/templets/模板目录(默认为default)下面，当然你也可以根据自己的路径进行修改，这里面的文件都是有相应的规则。

 

这里是模板文件命名规范：

（１）index_识别ID.htm：　表示板块（栏目封面）模板；

（２）list_识别ID.htm：　表示栏目列表模板；

（３）article_识别ID.htm：　表示内容查看页（文档模板，包括专题查看页）；

（４）search.htm： 搜索结果列表模板；

（５）index.htm： 主页模板；

这些模板都是可以通过系统后台对其进行指定，系统默认会读取这些模板内容

 

不同的标签作用域也不相同，这个在官方提供的标签说明中都有列出，所以在使用标签的时候一定要看好标签的作用域，例如{dede:list}这个标签只能在列表页使用，如果放到首页、内容页那是不会有效果的，所以在阅读手册、制作模板的时候需要注意。

 

下面我们来从不同的常用标签来讲解，我们依次顺序为：arclist（arclistsg）标签、list标签、field、global。

arclist（arclistsg）标签

这个标签是系统中非常常用的调用标签，主要功能就是通过指定标签的属性调用后台发布的内容，这个标签是一个全局标签，也就是说，这个标签可以在首页、列表页、内容页等多个地方进行使用。

 

当然我们可以通过系统后台的[模板]-[智能标记向导]来生成arclist标签，我们只需要指定不同的调用属性、指定单条记录样式（底层模板），直接生成即可，生成的标签可以直接使用到相应的模板中去。

 

我们这里先在后台添加一些测试数据，创建两个栏目，名字分别为“甲栏目”、“乙栏目”，并且在两个栏目分别中添加4篇文章。这里我们可以看到“[ID:13]”，即甲栏目的栏目ID为13，乙栏目的栏目ID为14。

甲栏目中的2篇文章在属性中设置为“推荐[c]”和“头条[h]”，乙栏目中一篇内容设置为“推荐[c]”。

因为这里arclist标签是属于全局标记，我们可以在系统后台[模板]-[全局标记测试]中进行测试。

 

基本的调用我们本节课就不多说，这里我们讲解这个标记几个非常用调用。1.常规属性的应用；2. 附加字段的调用；3.自定义函数function的使用；4.PHP编程扩展。

我们看下面这个调用标签：

{dede:arclist flag='c' typeid='13,14' row='4'}

<a href='[field:arcurl/]'>[field:title/]</a><br / >

{/dede:arclist}

 

 

这里的flag=’c’就是调用的发布文档中“推荐[c]”，当然引申下，如果调用“头条[h]”，则flag=’h’，所以我们在使用标记调用那些推荐、图文的时候可以对这些进行修改，当然系统后台中[系统]-[自定义文档属性]来修改相关的参数。

 

{dede:arclist typeid='13,14' limit='0,3'}

<a href='[field:arcurl/]'>[field:title/]</a><br / >

{/dede:arclist}

 

这里主要讲的是一个limit属性的使用，这个属性类似于MySQL中SQL查询语句中的limit，通过这个属性来控制调用的记录ID和记录条数。我们通过手册查阅这个属性的相关内容：

limit='起始ID,记录数'  （起始ID从0开始）表示限定的记录范围（如：limit='1,2'  表示从ID为1的记录开始，取2条记录）。

 

有了这个属性我们可以做出一种效果，就是一些门户网站的不规则长度新闻标题的样式，我们来查看以下的代码：

 

{dede:arclist typeid='13,14' limit='0,1'}

<a href='[field:arcurl/]'>[field:title/]</a><br / >

{/dede:arclist}

{dede:arclist typeid='13,14' limit='1,1' titlelen='8'}

<a href='[field:arcurl/]'>[field:title/]</a>

{/dede:arclist}

{dede:arclist typeid='13,14' limit='2,1' titlelen='4'}

<a href='[field:arcurl/]'>[field:title/]</a><br / >

{/dede:arclist}

 

 

这里调用的3条信息就是上面limit='0,3'调用的3条内容，只不过我们通过limit对其进行了再次的拆分，再结合titlelen属性控制标题的长度达到不规则标题的效果。

 

接下来我们再来看下调用附加表字段，织梦的内容模型有2种类型，一种是主从表，另外一种就是单表独立，主从表形式的就涉及到一个主表和一个附加表，系统的主表是#@__archives ，我们可以查看系统后台[系统]-[SQL命令行工具]，如果默认前缀为dede，则会有一个dede_archives的表，这个表中记录的都是常用字段。

 

一般附加表都是以#@__addon[识别ID]命名的，例如普通文章的附加表就是#@__addonarticle，软件模型的附加表就是#@__addonsoft，不同模型的附加字段可以通过系统后台[核心]-[内容模型管理]，编辑一个模型，查看里面的“字段管理”，一般我们调用都是调用这些内容。

 

我们在系统后台添加了一个软件下载的栏目，栏目设置模型为软件，然后我们发布几条软件下载的信息，接下来我们需要通过arclist这个标签将软件的一些信息调用到网站首页中进行显示。

 

我们可以查看到下面一些软件添加的信息内容。

 

我们查看下面的代码：

<table width="32%" height="79" border="0" cellpadding="0" cellspacing="1" bgcolor="#000000">{dede:arclist addfields='filetype,language,softtype' row='8' channelid='3'}  <tr>    <td width="25%" bgcolor="#FFFFFF">软件标题：</td>    <td width="75%" bgcolor="#FFFFFF">[field:textlink/] </td>  </tr>  <tr>    <td bgcolor="#FFFFFF">语言类型：</td>    <td bgcolor="#FFFFFF">[field:language/]</td>  </tr>  <tr>    <td bgcolor="#FFFFFF">软件类型：</td>    <td bgcolor="#FFFFFF">[field:softtype/]</td>  </tr>{/dede:arclist}</table>

 

我们通过addfields=’’这个属性来指定调用的附加字段，同时我们需要指定调用模型的id，即channelid，这个可以在系统后台的内容模型管理中查看。