DEDECMS扩展标签与自定义标签实现方法

在网站开发中，了解DedeCMS的扩展标签存放目录及文件命名规则是非常重要的。这些扩展标签通常存放在/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/}，显示结果为“Hello Word!”。这表明标签已成功起作用并输出了指定内容。

完成上述步骤后，我们可以看到标签生成的内容实际上是函数的一个返回值，且返回的内容必须是字符串形式。接下来，我们将进一步探讨如何修改和增强这个标签。

例如，如果我们需要创建一个查询文章相关内容页的标签（如writerarc），可以按照以下步骤操作：


$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语句，可以根据$row确定查询的内容数目。

最后，执行查询并对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();
}
return $revalue;

将查询结果与底层模板中的相关变量替换，并将所有字符串信息存储到$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}

这样，我们就完成了从基础到高级的标签编写过程，能够实现更复杂的功能需求。

推荐阅读