WordPress:Include Tags

模板include tags是用在模板文件内（例如index.php)以执行其它模板文件内的HTML 和PHP (例如header.php)。PHP有一个内置的include()声明，但是这些WordPress模板标签使得包含某些特别的文件变得更加简单。

关于模板和主题的更多的信息，请看看使用主题和主题发展。

标题模板[ ]

<?php get_header(); ?>

这个标签包含来自当前主题目录的文件header.php。如果没有发现这个文件，标签会包含wp-content/themes/default/header.php。

<?php get_footer(); ?>

这个标签包含来自当前主题目录的文件footer.php。如果没有发现这个文件，标签会包含wp-content/themes/default/footer.php。

<?php get_sidebar(); ?>

这个标签包含当前主题目录的文件sidebar.php。如果没有发现这个文件，标签就会包含wp-content/themes/default/sidebar.php。

<?php get_sidebar('right'); ?>

导致模板TEMPLATEPATH . 'sidebar-right.php'被包含其中。注：能够规定一个特别的工具条，指的是一个主题中可以使用多个工具条模板，是在2.5版本中添加的。

<?php comments_template(); ?>

这个标签包含来自当前主题目录的文件comments.php。如果没有发现这个文件，主题会包含wp-content/themes/default/comments.php。要在主索引或者归档网页上显示评论，你需要将$withcomments变数设置为"1"，才能够访问这个标签。

WordPress提供了上述标签，用来包含这些特别的模板，但是还有一个更简便的方法，能够包含任何文件。要使用这种方法，你需要使用include PHP函数，和一个WordPress能够方便地为你定义的一个恒量，使得问题变得更加简单：TEMPLATEPATH。

假如你想要包含一个称为header2.php的文件。只要将下面的这些行插入到模板中，你想要文件信息显示的位置中。

<?php include (TEMPLATEPATH . '/header2.php'); ?>

例如，你可以使用这个作为包含一个不同的标题而不是正常的header.php的方式，header.php可能包含在get_header()。

注: TEMPLATEPATH是一个到达当前主题目录的绝对路径的一个reference（结尾没有/）。关于referencing URI而不是包含文件的信息，请看看从一个模板中Referencing 文件。

下面是有关"HTTP 404:没有找到"错误模板的一个非常简单的例子（可能包含在你的主题中作为404.php）。

<?php get_header(); ?>

<h2>Error 404 - Not Found

<?php get_sidebar(); ?>
<?php get_footer(); ?>

这些标签不接受任何参数。