当我们进行 WordPress 开发的时候,首先我们必须要了解主循环和全局变量,这样才知道可以访问哪个全局变量。下面就讲解下 WordPress 主循环,以便能更好理解哪些全局变量可以被主循环中的模板函数调用。

WordPress 主循环

WordPress 主循环(The Loop)是用来显示日志列表,和在单篇日志页面页显示留言列表的。

在默认主题的 index.php 中,主循环的代码如下:

<?php if (have_posts()) : ?><?php while (have_posts()) : the_post(); ?>

have_posts() 和 the_post()这两个函数都是类 WP_Query 的方法。

have_posts 这个函数去查看当前显示的日志数是否达到了在 WordPress 后台设置的要显示的日志数,这个主循环将会继续直到达到为止。

如果你看过过 the_post 函数的源代码,就会发现它会搜索 $post 这个全局变量。 the_post 函数获取第一篇日志(随后的日志通过每次循环获取下一个),并设置日志的数据(如作者,多重-页面,等等),这些数据是 WordPress 赋给 $post 这个全局变量的,所以我们可以访问它。

the_post() 函数被调用之后,我们就可以使用许多模板函数和全局变量。

下面就是现在可用的部分模板函数:

  • the_author:获取作者的名字。
  • the_title:显示当前日志的标题。
  • the_content:显示日志的内容。
  • the_permalink:显示日志的永久链接的 URL 。
  • the_ID:显示日志的 ID 。

下面是在主循环中可用的全局变量:

全局变量 authordata:

global $authordata;
echo $authordata->display_name;

通过 authordata 这个全局变量还可以获取作者的下面这些信息:last_name,first_name,ID,user_email,user_url,user_login,description 和其他。

全局变量 post:

global $post;
echo $post->post_content;

通过 post 这个全局变量还可以获取文章的这些信息:ID,post_title, post_author,post_date,post_excerpt,comment_count 和其他。

注意通过这种方法获取的日志内容是没有经过过虑的。如果你想自己去操纵日志的内容,比如自己设置日志内容的显示方式,通过这种方式获取的日志内容非常有用。

全局变量 id:

global $id;
echo $id;

制作你自己的模板函数

假设我们写了一个叫做 get_my_trackback 自定义的模板函数,它能够在文章的留言循环中每次检测到留言如果是 trackback 的时候做出一些动作。我们可以把这个函数放入 comment.php 模板文件的 foreach 留言循环中。

<?php foreach ($comments as $comment) : ?><?php get_my_trackback();?><?php endforeach; /* end for each comment */ ?>

然后在当前主题的 function 文件中添加 get_my_trackback 函数代码:

<?php function get_my_trackback() {
    global $comment;
    if (empty($comment))
        return;
    if ($comment->comment_type != 'comment') {
        //do trackback stuff
    }
}
?>

comments 这个全局变量能够让我们访问到当前留言的所有数据,所以可以让我们对留言做任何事情。