专注于WEB技术的IT博客

ThinkPHP自定义模板标签详解

时间:2013-09-06分类: Thinkphp浏览:11776
分享到:

模板标签让网站前台开发更加快速和简单,这让本该由程序猿才能完成的工作,现在只要稍懂得HTM的人也能轻易做到,这也就是模板标签的强大之处。接触过dedecms或者phpcms等内容管理系统的人都知道,cms的前台都是使用模板标签来调用数据,如列表,内容。来看一个phpcms v9调用数据排行列表的标签:

{pc:content action="hits" catid="6" num="10" order="views DESC"}
     {loop $data $r}
       <li><a href="{$r[url]}"  title="{$r[title]}">{$r[title]}</a></li>
     {/loop}
{/pc}

说明:

pc大括号的的参数形式是:

{pc:content 参数名=”参数值” 参数名=”参数值” 参数名=”参数值”}

action:本参数的值表示为操作事件,模型类PC标签必须使用包含本参数,以说明要进行的操作。

catid:获取频道栏目的ID,和该栏目的数据

num:获取记录的条数,最后会被模板引擎处理成limit传送到处理函数中。

order:表示数据列表的排序方式


上面那段phpcms模板模签的功能就是获取ID等于6的栏目的10条数据,然后按照点击量排序。


不过上面的因为PHPCMS V9已经是一个成熟的CMS,它的模板标签是已经定义好的了,如"pc","num"等标签,我们只能通过阅读PHPCMS V9的使用文档来学习如何调用,而不可以更改它的名称,而ThinkPHP只是一个框架,每个开发者都可以通过自定义模板标签来简化数据的调用方式。

下面来自定义一个ThinkPHP模板标签,使它具体这样的功能:

1、 获取记录的条数,类似上面phpcms v9的"num"

2、对数据进行排序


准备工作:先找一个没有自定义模板标签的ThinkPHP的CMS或者博客程序安装,为了便于说明,我就使用wblog3.1.3_2.

注意,这是ThinkPHP3.1.3版本


建立自定义标签库

打开W3note\Lib\,没有TagLib文件夹的,自己建立一个,然后在TagLib目录建立标签库文件,我就命名为TagLibLists.class.php。

自定义标签库的命名格式:"TagLib"+"Lists"+".class.php",其中Lists"是自定义的,第一个字母大写。


打开TagLibLists.class.php文件,写入如下代码:

<?php
class TagLibLists extends TagLib{
    protected $tags = array(
         
         'list' => array('attr' => 'limit,order','close' =>1)// attr 属性列表close 是否闭合(0 或者1 默认为1,表示闭合)
 );
 public function _list ($attr,$content){
         
       $attr = $this->parseXmlAttr($attr);
       $limit=$attr['limit'];//参数$limit,可通过模板传入参数值
        $order=$attr['order'];//$order$limit,可通过模板传入参数值
       $str='<?php ';
       $str .= '$field=array("id","title","hits");';//定义需要调用的字段
       $str .= '$_list_news=M("News")->field($field)->limit('.$limit.')->order("'.$order.'")->select();';//查询语句
       $str .= 'foreach ($_list_news as $_list_value):';
       $str .= 'extract($_list_value);';
       $str .= '$url=U("read/".$id);?>';//自定义文章生成路径$url
       $str .= $content;
       $str .='<?php endforeach ?>';
       return $str;
       }
 }

注意:上面代码的第12行的'<?php'的后面一定要加一个空格!我因为没加空格,调试中出现错误,弄得我好晕,后来还是根据错误提示,查看缓存文件才发现,原来是'<?php'因为后面没有空格,被屏蔽掉了,出现语法错误。


配置项目配置文件


在W3note\Conf\config.php配置文件加上下面三个配置项:

'TAGLIB_LOAD'               => true,//加载标签库打开
'APP_AUTOLOAD_PATH'         =>'@.TagLib',
'TAGLIB_BUILD_IN'           =>'Cx,Lists',

说明:Cx为核心标签库名称,Lists为自定义标签库名称,不能弄错。


在模板上调用自定义标签

到这里我们已经建立起了自己的标签库,接下来就可以在模板上随心所欲地调用了。


1、调用最新文章

<list limit="9" order="id desc">
     <li> <a title="{$title}" href="{$url}">{$title}</a></li>
 </list>


说明:

list 是上面自定义标签库数组$tags键名,因为设置为闭合形式,所以<list>和</list>是成双成对出现的。

limit和order是前面标签库中定义的两个参数,通过它们可以在模板接受参数值,如上面给imit传递参数值"9"。

$title和$hits是标签库中根据需求选择的数据表字段


2、调用热点文章

<list limit="9" order="hits desc">
      <li> <a title="{$title}" href="{$url}">{$title}</a>[{$hits}]</li>
  </list>


3、调用随机文章

<list limit="9" order="rand()">
     <li> <a title="{$title}" href="{$url}">{$title}</a></li>
</list>


说明:真没想到,在自定义模板标签里面还能解释php函数rand(),万万没想到,呵呵,这真是一个惊喜啊!

在调试中还发现,可以模板自定义签标中截取字符串:

<list limit="9" order="rand()">
     <li> <a title="{$title}" href="{$url}">{$title|msubstr=0,12,'utf-8'}</a></li>
</list>


通过前后对比,似乎ThinkPHP的自定义模板标签的调用比phpcms v9的标签更加方便简单,但功能还没有phpcms v9的灵活与强大,这需要众多TPer的参与与完善。

小结:ThinkPHP自定义模板标签,可以在同一项目的不同模板里调用,方便简单,只是在定义标签库时要费点劲儿。




猜你喜欢
wblog3.1.3_2升级说明
ThinkPHP普通分组下Widget的使用
如何让ThinkPHP的模板引擎达到最佳效率
WBlog博客前台独立栏目页的实现方法
WB3.1.2_2版本使用说明
封装ThinkPHP的一个文件上传方法
ThinkPHP3.1.2整合UCenter详解(四)
ThinkPHP3.1.2整合UCenter详解(三)
ThinkPHP3.1.2整合UCenter详解(二)
ThinkPHP3.1.2整合UCenter详解(一)
标签 : ThinkPHP
除非注明,本文首发网志博客,欢迎转载!转载请注明本文地址:http://w3note.com/web/124.html,谢谢。
  • 评论
  • 赞助本站