首页 > 织梦cms教程 阅读:0

dedecms 标签扩展

定义标签

在解析式模板引擎中我们需要定义全局标签,在上面的文档说明中已经知道在系统根目录下/include/taglib中进行扩展,标签的文件名应该是:标签.lib.php,例如arclist所对应的标签名称则为:arclist.lib.php

我们创建一个测试的标签{dede:test name='tianya'/},那就需要创建一个名为test.lib.php的文件。

标签文件内容结构

标签内容的文件结构如下,为一个函数

<?php

if(!defined('DEDEINC')) exit("Request Error!");

function lib_test(&$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;

}

?>

这里function lib_test(&$ctag,&$refObj)就是我们标签的扩展函数,所有标签生成的内容都是由这个函数解析后获得的。

属性处理

函数中$attlist="row|12,titlelen|24"为系统默认属性的参数,例如我们上面test标签需要一个默认的属性name,并且name为空,则需要更改为:

$attlist="name|"

这里符号“,”用来隔开各个属性,符号“|”用来分隔变量的名称和值,这里“name|”则代表默认参数name为空。

我们在使用参数的时候,直接使用$name就可以在函数中进行调用了,例如:

function lib_test(&$ctag,&$refObj)

{

    global $dsql,$envs;

    //属性处理

    $attlist="name|";

    FillAttsDefault($ctag->CAttribute->Items,$attlist);

    extract($ctag->CAttribute->Items, EXTR_SKIP);

    $revalue = '我的名字:'.$name;

    return $revalue;

}

?>

我们在系统后台标签测试器中进行测试:

1.png

底层模板处理

一般的标签会涉及到底层模板,例如:arclistchannel等,我们来扩展下我们上面标签的功能:

{dede:test name='tianya'/}

我的名字叫:[field:name/]

{dede:test}

这里“我的名字叫:[field:name/]”则为我们要处理的底层模板,[field:name/]为我们标签属性中的name

这里我们需要了解lib_test(&$ctag,&$refObj)函数中$ctag参数,这个参数就是我们解析式模板引擎获取的当前标签内容,其中这个对象下有一个GetInnerText()方法能够获取当前标签的底层模板。

<?php

if(!defined('DEDEINC')) exit("Request Error!");

function lib_test(&$ctag,&$refObj)

{

    global $dsql,$envs;

    //属性处理

    $attlist="name|";

    FillAttsDefault($ctag->CAttribute->Items,$attlist);

    extract($ctag->CAttribute->Items, EXTR_SKIP);

    $innertext= $ctag->GetInnerText(); // 获取底层模板

    $revalue = str_replace("[field:name/]", $name, $innertext); // 对标签进行解析

    return $revalue;

}

?>

这样我们就完成了一个简单的对底层模板解析的处理。

2.png

标签其他一些开发技巧可参考/include/taglib其他标签文件。


beylze编程学院,一个分享编程知识和seo优化知识的网站。跟着beylze一起学习,每天都有进步。

通俗易懂,深入浅出,一篇文章只讲一个知识点。

文章不深奥,不需要钻研,在公交、在地铁、在厕所都可以阅读,随时随地涨姿势。

文章不涉及代码,不烧脑细胞,人人都可以学习。

当你决定关注beylze(公众号:beylze),你已然超越了90%的其他从业者!

优秀教程