dedecms常用的函数,模板标签语法大全- 黄海平

DEDECMS模板引擎的代码样式有如下几种形式：

{dede:标记名称属性='值'/}

{dede:标记名称属性='值'} {/dede:标记名称}

{dede:标记名称属性='值'} 自定义样式模板(InnerText)，即底层模板 {/dede:标记名称}

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

1、标记通用特性

(1) 短标记：

{dede:tagname.name/} 等同于 {dede:tagname name='' /}

(2) 块标记：

{dede:tagname}

循环代码:

{/dede:tagname}

短标记：

{dede:global.name/} 外部变量等同于 <?php echo $name; ?>

{dede:var.name/} var数组等同于 <?php echo $_vars['name']; ?>

{dede:field.name/} field数组等同于 <?php echo $fields['name']; ?>

{dede:cfg.name/} 系统配置变量等同于 <?php echo $cfg_name; ?>

include 语法：

{dede:include file=''/}

{dede:include filename=''/}

{dede:include file='文件名称' ismake='是否为dede板块模板(yes/no)'/}

例如： {dede:include filename="head.htm"/}

对文件的搜索路径为顺序为：绝对路径、include文件夹，CMS安装目录，CMS主模板目录

函数、php 语法：

if 条件

仅支持 if ，else ，else 直接用{else}表示,但不支持{else if}这样的语法，一般建议模板中不要使用太复杂的条件语法，如果确实有需要，可以直接使用 php 语法。

{dede:if 条件}

a-block

{else}

b-block

{/dede:if}

条件中允许使用 var.name 、 global.name 、 field.name、cfg.name 表示相应的变量。

如：

{dede:if field.id>10 }

{/dede:if}

php 代码块:

{dede:php

php 代码

或

{dede:php}

php代码

{/dede:php}

模板编程：

{dede:tagname runphp='yes'}

$aaa = @me;

@me = "123456";

{/dede:tagname}

@me 表示这个标记本身的值，因此标记内编程是不能使用echo之类的语句的，只能把所有返回值传递给@me。

此外由于程序代码占用了底层模板InnerText的内容，因此需编程的标记只能使用默认的InnerText。

函数：

在任何标记中使用函数对得到的值进行处理，形式为：

{dede:标记名称属性='值' function='youfunction("参数一","参数二","@me")' /}

其中 @me 用于表示当前标记的值，其它参数由你的函数决定是否存在，例如：

{dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")'/}

完整的例子：

{dede:arclist flag='h' limit='0,1'}

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

[field:description function='cn_substr(@me,110)'/]...

{/dede:arclist}

</div>

标签名称：sql

功能说明：用于从模板中用一个SQL查询获得其返回内容适用范围,全局使用

基本语法：{dede:sql sql=""}底层模板{/dede:sql}

参数说明：sql="" 完整的SQL查询语句

底层模板字段：SQL语句中查出的所有字段都可以用[field:字段名/]来调用

应用实例：

1.调用某个特定会员发布的文章内容：

{dede:sql sql='Select * from dede_archives where mid=1'}

<a href='/plus/view.php?aid=[field:id/]' target='_blank'>[field:title/]</a>

{/dede:sql}

mid为用户ID ，可以参考二次开发中关于dede_archives的数据表字段介绍

首页调用文章正文内容，比较好的解决方法：

方法一：

{dede:sql sql="SELECT aid,typeid,body,body1,body2,body3,body4,body5 FROM `dede_addonarticle` where typeid=2 ORDER BY `aid` DESC LIMIT 0,1"}

[field:body /] [field:body1 /] [field:body2 /] [field:body3 /] [field:body4 /] [field:body5 /]

{/dede:sql}

方法二：

{dede:sql sql="SELECT aid,typeid,body FROM `dede_addonarticle` where typeid=2 ORDER BY `aid` DESC LIMIT 0,1"}

[field:body /]

{/dede:sql}

调用说明：

其中typeid=2，栏目ID号，表示调用此ID栏目内的文章，换成 aid=1 则表示调用的 aid 为 1 的文章，

DESC 表示排序，按从大到小排，换成 ASC 则按从小到大排序，

LIMIT 0,1 表示调用数量，也可以写成数量LIMIT 1，这个1代表调用的数量。

===============================================

SQL语句分为两类，功能型的和内容调用型，功能型的主要是对数据库进行常规的操作，例如{insert、update}，数据调用型的操作就(select)，两种类型的SQL语句使用发放也很简单，如果是功能型的只需要在系统后台[系统]-[SQL命令运行工具]中进行使用，如果是模板标签的数据调用类型，只需要在模板相应位置添加标签即可。

功能型SQL语句整理:

功能说明：添加自定义属性

insert into `dede_arcatt`(sortid,att,attname) values(9,'d','评论');

alter table `dede_archives` modify `flag` set ('c','h','p','f','s','j','a','b','d') default NULL;

功能说明：批量为作者和来源赋值

UPDATE dede_archives SET writer='要赋的值' WHERE writer='';

UPDATE dede_archives SET source='要赋的值' WHERE source='';

功能说明：删除指定IP的评论

DELETE FROM `dede_feedback` WHERE `dede_feedback`.`ip` = '000.000.000.000'

000.000.000.000 为垃圾评论发布者的IP

功能说明：清空文章中关键字字段

update dede_archives set keywords=''

功能说明：批量替换发布时间，入库时间，更新时间

第一步。在后台新增一个文章。

得到一个时间，比如2009-01-13 14:13:32，这可以通过管理文章那里看到。

第二步，后台执行SQL语句SELECT * FROM dede_archives order by id DESC limit 1

这样你可以看到你刚才新加加的文章一所有字段值。

观察以下的数据：

pubdate：1231846313

senddate：1231846313

sortrank：1231846313

其中1231846313就是时间数据了。

然后就是替换了:

UPDATE dede_archives SET sortrank = 1231846313;

UPDATE dede_archives SET senddate = 1231846313;

UPDATE dede_archives SET pubdate = 1231846313;

功能说明：批量修改栏目为动态或者静态

UPDATE `dede_arctype` SET `isdefault` = '-1' 动态

UPDATE `dede_arctype` SET `isdefault` = '1' 静态

功能说明：文章内容批量替换SQL语句

update `dede_addonarticle` set body=REPLACE(body,'论坛','社区') where body like "%论坛%"

以上SQL语句作用是查找所有文章带有“论坛”的词组，并将论坛替换为“社区”

数据调用SQL语句整理：

标签说明：常用内容统计代码:

·共有文章：** 篇

{dede:sql sql="select count(*) as c from dede_archives where channel=1"}·共有文章：[field:c /]篇{/dede:sql}

·共有图集：** 个

{dede:sql sql="select count(*) as c from dede_archives where channel=2"}·共有图集：[field:c /]个{/dede:sql}

·共有软件：** 个

{dede:sql sql="select count(*) as c from dede_archives where channel=3"}·共有软件：[field:c /]个{/dede:sql}

·共有评论：**条

{dede:sql sql="select count(*) as c from dede_feedback"}·共有评论：[field:c /]条{/dede:sql}

·共有会员：**名

{dede:sql sql="select count(mid) as c from dede_member "}·共有会员：[field:c /]名{/dede:sql}

·文章阅读：** 人次

{dede:sql sql="select sum(click) as c from dede_archives"}文章阅读：[field:c /]人次{/dede:sql}

·今日更新：**篇

{dede:sql sql="SELECT count( * ) AS c FROM dede_archives WHERE pubdate > UNIX_TIMESTAMP( CURDATE( ) ) "}今日更新：[field:c /]篇{/dede:sql}

总共留言：{dede:sql sql="select count(*) as cc From dede_guestbook"}[field:cc/]{/dede:sql}条

调用说明：调用Discuz论坛附件带图片的贴子

{dede:sql sql="SELECT` cdb_p_w_uploads`.`aid`, `cdb_p_w_uploads`.`p_w_upload`,`cdb_threads`.`tid`, `cdb_threads`.`fid`, `cdb_threads`.`subject` FROM `cdb_p_w_uploads` LEFT JOIN `cdb_threads` ON `cdb_threads`.`tid`=`cdb_p_w_uploads`.`tid` WHERE `cdb_p_w_uploads`.`readperm`='0' AND `displayorder`>='0' AND `filetype`='p_w_picpath/pjpeg' GROUP BY tid LIMIT 0,2"}

<li><A href="/bbs/viewthread.php?tid=[field:tid /]">[field:subject function="cn_substr()" /]</A></li>

{/dede:sql}

调用说明：调用UCHOME最新日志

{dede:sql sql="Select subject,viewnum,blogid,uid From uchome_blog order by blogid desc limit 0,8"}

<li><A href="/space.php?uid=[field:uid/]&do=blog&id=[field:blogid/]" > [field:subject function="cn_substr()" /]</A></li>

{/dede:sql}

调用说明：会员积分排行

{dede:sql sql="Select id,userid,uname,scores From dede_member order by scores desc limit 0,10"}

<dd><span class="name"><a href='[field:global name='cfg_cmspath'/]/member/?[field:userid/]/'>[field:uname/]</a>

</span><span class="jifen">积分[field:scores/]</span></dd>

{/dede:sql}

调用说明：企业最新产品调用方法（图片+标题）

{dede:sql sql="SELECT a.id,a.litpic,a.title FROM dede_addonproduct p left join dede_archives a on a.id = p.aid order by a.id desc LIMIT 0 , 4"}

<li><div><a href="/plus/view.php?aid=[field:aid/]" title="[field:title/]"><img src="[field:litpic/]" alt="[field:title/]"/></a></div><a href="/plus/view.php?aid=[field:aid/]" title="[field:title/]">[field:title/]</a></li>

{/dede:sql}

调用说明：调用最新加入企业及企业所属行业代码到首页

{dede:sql sql="SELECT m.mid,m.mtype,m.userid,m.matt,c.mid,c.company,c.comface,d.ename,d.evalue,d.egroup FROM dede_sys_enum as d ,dede_member as m left join dede_member_company c on m.mid = c.mid where m.mtype ='企业' and m.matt = 1 and c.vocation=d.evalue and d.egroup='vocation' LIMIT 0 , 10"}

[field:company/]

[field:ename/]

{/dede:sql}

调用说明：推荐会员（带用户头像）

{dede:sql sql="SELECT ID,type,userid,uname,matt,spacep_w_picpath FROM dede_member where matt = 1 and type=0 LIMIT 0 , 10"}

头像：<img src="[field:spacep_w_picpath runphp='yes']

if( = 'http://bbs.dedecms.com/p_w_picpath/post/smile/default/14.gif';

[/field:spacep_w_picpath]" />

用户名：<a href='[field:global name='cfg_cmspath'/]/member/?[field:userid/]/'>[field:uname/]</a>

{/dede:sql}

[field:spacep_w_picpath runphp='yes']

if( = 'http://bbs.dedecms.com/p_w_picpath/post/smile/default/14.gif';

[/field:spacep_w_picpath]

为用户头像图片

调用说明：推荐企业

{dede:sql sql="SELECT m.ID,m.type,m.userid,m.matt,m.spacep_w_picpath,c.id,c.comname FROM dede_member m left join dede_member_cominfo c on m.ID = c.id where m.type = 1 and m.matt = 1 LIMIT 0 , 10"}

头像：<img src="[field:spacep_w_picpath runphp='yes']

if( = 'http://bbs.dedecms.com/p_w_picpath/post/smile/default/14.gif';

[/field:spacep_w_picpath]" />

用户名：<a href='[field:global name='cfg_cmspath'/]/member/?[field:userid/]/'>[field:comname/]</a>

{/dede:sql}

调用说明：UCenter Home会员调用（带头像）

{dede:sql sql="SELECT * FROM `uchome_space` WHERE `avatar` =1 LIMIT 0 , 10"}

<br />

[field:username/]</a>

{/dede:sql}

全局函数：

1、common.func.php 公用函数

获得当前的脚本网址

function GetCurUrl()

返回格林威治标准时间

function MyDate($format='Y-m-d H:i:s',$timest=0)

把全角数字转为半角

function GetAlabNum($fnum)

把含HTML的内容转为纯text

function Html2Text($str,$r=0)

把文本转HTML

function Text2Html($txt)

输出Ajax头

function AjaxHead()

中文截取2，单字节截取模式

function cn_substr($str,$slen,$startdd=0)

把标准时间转为Unix时间戳

function GetMkTime($dtime)

获得一个 0000-00-00 00:00:00 标准格式的时间

function GetDateTimeMk($mktime)

获得一个 0000-00-00 标准格式的日期

function GetDateMk($mktime)

获得用户IP

function GetIP()

获取拼音以gbk编码为准

function GetPinyin($str,$ishead=0,$isclose=1)

dedecms通用消息提示框

function ShowMsg($msg,$gourl,$onlymsg=0,$limittime=0)

保存一个cookie

function PutCookie($key,$value,$kptime=0,$pa="/")

删除一个cookie

function DropCookie($key)

获取cookie

function GetCookie($key)

获取验证码

function GetCkVdValue()

过滤前台用户输入的文本内容

// $rptype = 0 表示仅替换 html标记

// $rptype = 1 表示替换 html标记同时去除连续空白字符

// $rptype = 2 表示替换 html标记同时去除所有空白字符

// $rptype = -1 表示仅替换 html危险的标记

function HtmlReplace($str,$rptype=0)

获得某文档的所有tag

function GetTags($aid)

过滤用于搜索的字符串

function FilterSearch($keyword)

处理禁用HTML但允许换行的内容

function TrimMsg($msg)

获取单篇文档信息

function GetOneArchive($aid)

数据库类：

系统会自动载入 dedesql.class.php 文件，并用

$dsql = $db = new DedeSql(false);

进行初始化数据库连接，因此在工程所有文件中均不需要单独初始化这个类，可直接用 $dsql 或 $db 进行操作，为了防止错误，操作完后不必关闭数据库。

常用的方法：

1、执行一个非查询类型的SQL语句，如 insert 、create 、update 等

$rs = $db->ExecuteNoneQuery($sql);

返回值为是否执行成功。

2、执行一个非查询类型的SQL语句，并返回成功记录数

$rs = $db->ExecuteNoneQuery2($sql);

与上面相比，它返回的是影响的记录数，而不是布尔值

3、返回单个记录

$arr = $db->GetOne($sql);

$dsql 如果不带 limit ，系统会自动加上 limit 0,1

4、执行条件查询语句

$db->SetQuery($dsql);

$db->Execute();

while($arr = $db->GetArray())

{

}

可以简化为：

$db->Execute('me',$dsql);

while($arr = $db->GetArray())

{

}

'me' 为记录集游标，用于区分不同的查询，如：

$db->Execute('me',$dsql);

while($arr = $db->GetArray())

{

$db->Execute('2',$dsql2);

while($arr2 = $db->GetArray())

{

}

像这种情况必须指定一个值区分默认的'me'参数，否则会出错

$db->GetArray($rsid,$acctype) 参数

$rsid="me"

$acctype=MYSQL_ASSOC

在查询游标中读取数据还可以用

$db->GetObject($rsid="me");

返回的结果是用类结构表示的值。

5、获取上一个插入的自动递增主键id值

$db->GetLastID();

6、获得查询的总记录数

$db->GetTotalRow($rsid="me")

7、获得MySql的版本号

$db->GetVersion($isformat=true)

默认的情况下会转换成 x.xx 形式浮点数

8、析放某查询的资源

$db->FreeResult($rsid="me");

9、在数据库中是否存在某数据表

$db->IsTable($tbname)

10、重新选择要操作的数据库

$db->SelectDB($dbname);

11、获得数据库连接标识

$db->linkID

获得这个连接标识后，可以直接用mysql相关函数进行数据库操作

在非不得已的情况，项目中一般不使用这个变量。

[field:spacep_w_picpath runphp='yes']

if( = 'http://bbs.dedecms.com/p_w_picpath/post/smile/default/14.gif';

dedecms常用的函数,模板标签语法大全

与本文相关的文章

网友最新评论 (0)