dedecms 扩展标签

作者: jiukeshuju 分类: DEDECMS 发布时间: 2020-11-27 21:53
内容纲要
DedeCMS从V5.3开始就支持自己扩展标签,不过许多新人很少用那个东西,简单的介绍下如何编写自己的调用标签。
我们需要知道下扩展标签的存放目录及文件名构成,首先,扩展的标签都是存放在/include/taglib这个目录,名称都是以“标签名.lib.php”格式,例如{dede:channel/}标签对应的是channel.lib.php文件。
我们可以看一个示例标签:demotag.lib.php

if(!defined(‘DEDEINC’))
{
exit(“Request Error!”);
}
function lib_demotag(&$ctag,&$refObj)
{
global $dsql,$envs;
//属性处理
$attlist=”row|12,titlelen|24″;
FillAttsDefault($ctag->CAttribute->Items,$attlist);
extract($ctag->CAttribute->Items, EXTR_SKIP);
$revalue = ”;
//你需编写的代码,不能用echo之类语法,把最终返回值传给$revalue
//——————————————————
$revalue = ‘Hello Word!’;
//——————————————————
return $revalue;
}
?>
我们登录系统后台的[模板]-[全局标签测试]中运行{dede:demotag/},显示如下的结果:
,我们会发现标签起作用了,输出了我们的内容。

至此我们完成了标签的编写,这里面主要涉及到PHP、MySQL的很多知识,需要有一定相关方面的基础才能够编写标签了,当然这里只是一个简单的标签开发例子,还有许多的东西可以去开发。


这里我们知道,其实标签生成的内容其实是这个函数的一个返回值,这里返回的内容都是字符串,也就是函数return $revalue;中的$revalue需要是经过处理后生成的字符串。
$attlist=”row|12,titlelen|24″;这个是属性列表,这个经过函数处理后会直接生成变量并复制,我们可以测试下,做如下的修改:
$revalue = ‘Hello Word!’;
$revalue .=”
Row:”.$row.”;TitleLen:”.$titlelen;

这样我们可以看到,这个属性已经被创建变量并且赋值了。
接下来我们可以再进一步去修改这个标签。
比如说我们需要写一个标签专门来查询文章内容页的那个相关文章,功能类似于上面sql标签中的那个sql,只是这里我们将其分装为一个标签。
我们可以新建一个标签,例如叫writerarc,那我们就需要创建一个writerarc.lib.php,然后模仿demotag编写函数,注意需要修改为
function lib_writerarc(&$ctag,&$refObj)
接下来我们就可以编写查询语句及对底层模板处理的相关函数了
$revalue = ”;
$innertext = $ctag->GetInnerText();
$ctp = new DedeTagParse();
$ctp->SetNameSpace(‘field’, ‘[‘, ‘]’);
$sql = “SELECT * FROM dede_archives WHERE writer='{$refObj->Fields[‘writer’]}’ limit 0, $row”;
$innertext这个是用来获取标签的底层模板的,$ctp创建用于处理底层模板中的变量,并处理进行替换。我们根据获取的属性编写我们的sql语句,这里我们使用limit 0, $row,这样就可以根据$row来确定查询的内容数目。
当然我们可以获取更多的属性以便我们这个标签更强大,例如我们可以增加类似于arclist中的相关属性,并在函数中进行处理,不过这个需要有一定的PHP基础。
接下来我们通过执行查询对sql及输出变量进行处理:
$dsql->Execute(‘me’,$sql);
while($rs = $dsql->GetArray(‘me’))
{
//根据属性处理查询变量
$rs[‘title’] = cn_substr($rs[‘title’], $titlelen);
//获取底层模板
$ctp->LoadSource($innertext);
foreach($ctp->CTags as $tagid=>$ctag) {
if(!empty($rs[strtolower($ctag->GetName())])) {
$ctp->Assign($tagid,$rs[$ctag->GetName()]);
}
}
//根据底层模板及查询变量得到处理结果
$revalue .= $ctp->GetResult();
}
这样我们就将查询出来的结果同底层模板中出现的相关变量进行替换,然后生成输出字符串,将所有的字符串信息存储到$revalue中。
最后返回这个值return $revalue;
整个文件内容如下:

if(!defined(‘DEDEINC’))
{
exit(“Request Error!”);
}
function lib_writerarc(&$ctag,&$refObj)
{
global $dsql,$envs;
//属性处理
$attlist=”row|12,titlelen|24″;
FillAttsDefault($ctag->CAttribute->Items,$attlist);
extract($ctag->CAttribute->Items, EXTR_SKIP);
$revalue = ”;
$innertext = $ctag->GetInnerText();
$ctp = new DedeTagParse();
$ctp->SetNameSpace(‘field’, ‘[‘, ‘]’);
$sql = “SELECT * FROM dede_archives WHERE writer='{$refObj->Fields[‘writer’]}’ limit 0, $row”;
$dsql->Execute(‘me’,$sql);
while($rs = $dsql->GetArray(‘me’))
{
//根据属性处理查询变量
$rs[‘title’] = cn_substr($rs[‘title’], $titlelen);
//获取底层模板
$ctp->LoadSource($innertext);
foreach($ctp->CTags as $tagid=>$ctag) {
if(!empty($rs[strtolower($ctag->GetName())])) {
$ctp->Assign($tagid,$rs[$ctag->GetName()]);
}
}
//根据底层模板及查询变量得到处理结果
$revalue .= $ctp->GetResult();
}
return $revalue;
}
?>
接下来我们来测试我们这个标签,我们修改article_article.htm模板,在里面加入以下的标签代码:
{dede:writerarc row=’10’ titlelen=’6′}
[field:title/]

{/dede:writerarc}
通过动态浏览页面进行查看调试http://www.dedecms.com/plus/view.php?aid=3

至此我们完成了标签的编写,这里面主要涉及到PHP、MySQL的很多知识,需要有一定相关方面的基础才能够编写标签了,当然这里只是一个简单的标签开发例子,还有许多的东西可以去开发。

如果觉得我的文章对您有用,请随意赞赏。您的支持将鼓励我继续创作!

发表评论

标签云
dede dedecms dede标签 echo empty field index li mysql php stus thinkphp 再温 授权 本类 标签 每日更新|织梦插件|Tag标签|充值 程序员 织梦dede:flink友情链接标签自定义输出bug修复 织梦Fatal error: Call to a member function fetchArray解决方法 织梦Fatal error: Call to undefined function dede_htmlspecialchars 织梦TAG标签列表页和搜索结果页调用自定义字段内容 织梦上传图片提示缺少图像源文件地址 织梦上传文件大小限制修改 织梦内容页分页标题提取 织梦判断缩略图是否为空输出不同样式 织梦前台搜索标题和文档内容关键词实现教程 织梦前台模板里显示当前登录会员名 织梦取消mysql错误日志生成文件功能防止暴露后台和管理员 织梦后台自定义表单添加搜索功能 织梦图集302与FILEID:X处理方法 织梦图集上传图片自动获取图片名称做注释 织梦实现url不变电脑和手机显示不同模板 织梦开启绝对路径缩略图https绝对路径时缩略图地址前面多了个域名 织梦手机站去除文章内容中图片的宽高达到自适应+绝对路径图片 织梦手机站搜索结果显示为电脑站的搜索结果模板的解决方法 织梦批量修改栏目的保存目录和文章命名规则 织梦搜索结果为空时输出自定义提示信息 织梦搜索结果增加dede:type、dede:arclist、dede:channelartlist、dede:tag、dede:php等标签支持 织梦搜索结果页分页条样式修改 织梦数据库内容替换,正则去掉文章内容中的img标签 织梦文档内容页title按文章名_当前栏目名_上级栏目名_顶级栏目名_网站名输出 织梦无法上传ico图标格式文件的解决方法 织梦标签array runphp静态生成乱码BUG解决方法 织梦栏目添加 [英文名称] [栏目大图] [栏目小图] 功能