Drupal：关于template.php的分析

你可能知道在drupal的模板中（比如node.tpl.php）隐藏了很多信息，比如：
: v/ l0 O" h2 {/ D

     <div><?php print $links; ?></div>

如果你是个设计人员或者drupal的使用者，你可能不知道$links中都包含了哪些信息，deve模块提供一个函数dsm（）可以很轻松的查看$links的详细信息，用法如下：
) {  [  o* N! @, Z

    <?php dsm('$links'); ?>

这是一个不错的办法，可是虽然知道了$links的信息，如果要修改$links又要怎么做呢？

" P' j* c" v* L5 r$ X- v$ ^

比如有一个文章，后面跟了一些链接（$links），包括评论数、全部阅读和阅读次数。如果你想修改链接的格式或样子，只要重写theme_links()这个函数就可以了，但是如果你想改变评论数的位置，比如：

8 a2 @5 R. z$ t& d; J

要把评论数的链接放到日期后面然后删除全部阅读的链接，那我们又要怎么做呢?先来看看node.tpl.php的代码：
4 K/ n6 e9 ?; |% l5 b

    <h1><?php print $title;  ?></h1>
7 ^8 |7 j: R; R% f  L    <div class="meta"><?php print $name ." | " . $date; ?> </div>
    <p><?php print $content ?></p>
    <div><?php print $links; ?></div>

如果要做到我们想要的必须要拆分$links，应该是这样的：

    <h1><?php print $title;  ?></h1>
    <div class="meta"><?php print $name ." | " . $date . " | " . $number_of_comments; ?></div>
6 H5 f& [. W  h/ o/ s* e. i    <p><?php print $content ?></p>
    <div><?php print $read_more; ?></div>  //这行代码将被删除，因为需求是删除全部阅读的链接。

但是目前我们还没有$read_more和$number_of_comments变量，所以先看看$links的结构：

: K8 {8 `) R0 J. Y    <?php dsm($node->links); ?>

( }7 A" T# Q) M; I' K% }

可以看出comment_comments就是评论数的链接，所以我们直接将comment_comments放到日期的后面

    <h1><?php print $title;  ?></h1>
+ Y- Q. e% j. W+ `/ O    <div class="meta"><?php print $name ." | " . $date . " | " . $vars['node']->links['comment_comments']['title']; ?> </div>
    <p><?php print $content ?></p>

但是这种写法是错误的，我们需要的是链接，所以就要l()函数。

    <?php

    l(
         $vars['node']->links['comment_comments']['title'],
/ q9 d9 L- E- n  ~+ n0 Y         $vars['node']->links['comment_comments']['href'],
         array('attributes' => array('class' => 'comment','title' => $vars['node']->links['comment_comments']['attributes']['title'] ))
    );         

    ?>

所以我们的node.tpl.php就是：

    <?php
$ t% Y7 r' I0 V- u+ D8 l5 S    //link comment
2 K8 Y% D' |2 W7 Y1 q    $link_comment =  l($vars['node']->links['comment_comments']['title'], $vars['node']->links['comment_comments']['href'], array('attributes' => array('class' => 'comment','title' => $vars['node']->links['comment_comments']['attributes']['title'] )));         

    //and lets create the read more links
    $link_read_more =  l($vars['node']->links['node_read_more']['title'], $vars['node']->links['node_read_more']['href'],
$ u  C3 A6 |/ T# }0 @  j3 H4 zarray('attributes' => array('class' => 'read-more','title' => $vars['node']->links['node_read_more']['attributes']['title'] )));                    
    ?>

    <h1><?php print $title;  ?></h1>
    <div class="meta"><?php print $name ." | " . $date . " | " . $link_comment; ?> </div>
& L( ]& g" j) w; C! B    <p><?php print $content ?></p>
    <div><?php print $link_read_more; ?></div>

虽然实现了我们想要的功能，但是代码看起来很丑陋。如果我们有很多的node.tpl.php（node-blog.tpl.php, node-page.tpl.php, node-news.tpl.php）我们还需要每一个页面都手动修改，这是编程的大忌。
而template.php可以很好的解决这个问题，你可以把所有的逻辑代码都放到这个文件里，从而保证了node.tpl.php干净。如果没有template.php可以在主题（theme）文件夹下新建这个文件，更多信息请参考http://drupal.org/node/11811

<?php
8 N2 m4 P; K' h//----------------------------
//file template.php
& z5 K" q% b: Z) [! V//----------------------------
function THEMENAME_preprocess_node(&$vars) {
    //comments
if($vars['node']->links['comment_comments']){
           $vars['link_comment'] =  l($vars['node']->links['comment_comments']['title'], $vars['node']->links['comment_comments']['href'],
               array(
                 'attributes' => array('class' => 'comment', 'title' => $vars['node']->links['comment_comments']['attributes']['title']),
                   'fragment' => $vars['node']->links['comment_comments']['fragment']
) H2 n" ^! e; L" [1 V8 t; z6 f: T* i               )
% t4 K" r- u0 Y     );         
( }0 R1 _$ K( ~! l1 ~   }
& u4 [8 |+ ]( y) U" \if($vars['node']->links['node_read_more']){
* I/ Y$ D  t' I; p$ D     $vars['link_read_more'] =  l($vars['node']->links['node_read_more']['title'], $vars['node']->links['node_read_more']['href'], array('attributes' => array('class' => 'read-more','title' => $vars['node']->links['node_read_more']['attributes']['title'] )));         
   }

?>

THEMENAME_preprocess_node是会在node.tpl.php之前运行的函数，类似的还有THEMENAME_preprocess_page、THEMENAME_preprocess_block等等。
& [6 P: s1 c; Wnode.tpl.php不变：
1 g  ], t& G6 o9 n8 C

<h1><?php print $title;  ?></h1>
2 h! _- A2 I9 E( R<div class="meta"><?php print $name ." | " . $date . " | " . $link_comment; ?> </div>
* A* V- z9 N0 W8 m' F<p><?php print $content ?></p>
<div><?php print $link_read_more; ?></div>

这样看起来是不是更好一些呢。
“转自《开源黄页网》，http://yp.oss.org.cn”。

5 D2 d! P" M: T6 M: A
% V8 X6 v$ D: H2 E; j% R

6 A0 y5 m' I) X$ `( x2 S0 g) |6 N
5 n! d6 w9 R2 g' g