Drupal：关于template.php的分析

你可能知道在drupal的模板中（比如node.tpl.php）隐藏了很多信息，比如：

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

如果你是个设计人员或者drupal的使用者，你可能不知道$links中都包含了哪些信息，deve模块提供一个函数dsm（）可以很轻松的查看$links的详细信息，用法如下：
8 b. H8 a8 s/ v

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

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

5 V/ Y1 `7 w2 s0 K. q0 B( [9 ~

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

' F1 A- d9 v' D, A9 M6 B

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

    <h1><?php print $title;  ?></h1>
    <div class="meta"><?php print $name ." | " . $date; ?> </div>
# X2 J9 U; U$ j- P% f    <p><?php print $content ?></p>
    <div><?php print $links; ?></div>

如果要做到我们想要的必须要拆分$links，应该是这样的：
4 P; e7 b. W& ]+ E

    <h1><?php print $title;  ?></h1>
: L6 @! v! B, r    <div class="meta"><?php print $name ." | " . $date . " | " . $number_of_comments; ?></div>
- L. b6 Q$ I4 \" [    <p><?php print $content ?></p>
4 P+ Y$ I% U7 Z! T: h$ ^6 x    <div><?php print $read_more; ?></div>  //这行代码将被删除，因为需求是删除全部阅读的链接。

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

( ]2 p$ a. R4 G    <?php dsm($node->links); ?>

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

    <h1><?php print $title;  ?></h1>
    <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'],
         $vars['node']->links['comment_comments']['href'],
! K( ]% z  b8 i- P. j& Y9 c$ r7 b         array('attributes' => array('class' => 'comment','title' => $vars['node']->links['comment_comments']['attributes']['title'] ))
- }: u3 w* Z8 q& q& T    );         

% D5 t! \8 q5 J( t    ?>

所以我们的node.tpl.php就是：
: k" a/ R. f( ~' }/ d

    <?php
    //link comment
7 z. u9 v. Z0 x1 m& w    $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
9 l7 l" i+ |2 r5 P6 ?6 M$ ]    $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'] )));                    
    ?>

    <h1><?php print $title;  ?></h1>
9 b! O  I  _0 \    <div class="meta"><?php print $name ." | " . $date . " | " . $link_comment; ?> </div>
2 D% ^8 W' o, L( c+ N# o    <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）我们还需要每一个页面都手动修改，这是编程的大忌。
3 o& n2 a8 U- o1 i$ J/ d6 z& i+ M0 y而template.php可以很好的解决这个问题，你可以把所有的逻辑代码都放到这个文件里，从而保证了node.tpl.php干净。如果没有template.php可以在主题（theme）文件夹下新建这个文件，更多信息请参考http://drupal.org/node/11811

<?php
8 A( p; ?$ ?+ u. H( y# G" x3 X//----------------------------
//file template.php
$ H0 a1 f4 ]7 v% R//----------------------------
. i, A- [* _+ y! a$ mfunction THEMENAME_preprocess_node(&$vars) {
    //comments
+ w4 ]: @6 u4 K$ B0 {- g2 kif($vars['node']->links['comment_comments']){
           $vars['link_comment'] =  l($vars['node']->links['comment_comments']['title'], $vars['node']->links['comment_comments']['href'],
& l4 r! `* Q; @  W, E) l               array(
& Q8 u- J5 j. b1 V6 j; [( ?& F3 K                 'attributes' => array('class' => 'comment', 'title' => $vars['node']->links['comment_comments']['attributes']['title']),
                   'fragment' => $vars['node']->links['comment_comments']['fragment']
               )
     );         
9 _: F. D$ m% J* H( d4 J   }
+ {) Y5 t" L) v: Y9 V; |' fif($vars['node']->links['node_read_more']){
     $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'] )));         
, s3 V1 f" }& F! U   }

?>

THEMENAME_preprocess_node是会在node.tpl.php之前运行的函数，类似的还有THEMENAME_preprocess_page、THEMENAME_preprocess_block等等。
node.tpl.php不变：
" ~0 x( v7 r- X$ A7 `" i1 O

<h1><?php print $title;  ?></h1>
<div class="meta"><?php print $name ." | " . $date . " | " . $link_comment; ?> </div>
<p><?php print $content ?></p>
6 \2 E  D% U: X<div><?php print $link_read_more; ?></div>

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

& }) Q$ e- Z9 j8 t/ A: M9 L- ^


* S4 N' k; q7 }: q" ^* s

& c7 C5 m# f0 n. v/ G5 x
' d/ T( v9 Z, a) ^