编辑“WordPress:Include Tags”

模板'''include tags'''是用在[[WordPress:Templates|模板]] 文件内（例如<tt>index.php</tt>)以执行其它模板文件内的[[WordPress:Glossary#HTML|HTML]] 和[[WordPress:Glossary#PHP|PHP]] (例如<tt>header.php</tt>)。[http://www.php.net PHP]有一个内置的[http://us3.php.net/manual/en/function.include.php include()]声明，但是这些WordPress模板标签使得包含某些特别的文件变得更加简单。

关于模板和主题的更多的信息，请看看[[WordPress:Using Themes|使用主题]] 和[[WordPress:Theme Development|主题发展]]。

== 标题模板 ==

&lt;?php get_header(); ?>

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

== 页底文字模板 ==

&lt;?php get_footer(); ?>

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

== 工具条模板 ==

<?php get_sidebar(); ?>

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

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

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

== 评论模板 ==

&lt;?php comments_template(); ?>

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

== 包含任何模板 ==

WordPress提供了上述标签，用来包含这些特别的[[WordPress:Templates|模板]]，但是还有一个更简便的方法，能够包含''任何''文件。要使用这种方法，你需要使用<tt>[http://us2.php.net/manual/en/function.include.php include]</tt> [[WordPress:Glossary#PHP|PHP]]函数，和一个WordPress能够方便地为你定义的一个恒量，使得问题变得更加简单：<tt>TEMPLATEPATH</tt>。

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

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

例如，你可以使用这个作为包含一个不同的标题而不是正常的<tt>header.php</tt>的方式，<tt>header.php</tt>可能包含在<tt>[[#WordPress:The Header Template|get_header()]]</tt>。

'''注''': <tt>TEMPLATEPATH</tt>是一个到达当前主题目录的绝对路径的一个reference（结尾没有/）。关于referencing URI而不是包含文件的信息，请看看[[WordPress:Theme Development#Referencing Files From a Template|从一个模板中Referencing 文件]]。

== 例子 ==

下面是有关"HTTP 404:没有找到"错误模板的一个''非常''简单的例子（可能包含在你的[[WordPress:Theme Development|主题]]中作为<tt>404.php</tt>）。
 &lt;?php get_header(); ?>
 &lt;h2>Error 404 - Not Found</h2>
 &lt;?php get_sidebar(); ?>
 &lt;?php get_footer(); ?>

== 参数 ==

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