编辑“WordPressInclude标签”

<span style="border:1px solid #000; text-align:center; float:right; padding:6px;"><strong>导航:</strong> [[WordPress开发文档|上一页]] | {{Template:WordPress导航}}</span>
<div style="clear:both;"></div>
Include标签可以将一个模板文件（例如header.php）中的[http://codex.wordpress.org/Glossary#HTML HTML]和[http://codex.wordpress.org/Glossary#PHP PHP]代码包含到另一模板文件（例如index.php）中。[[PHP]]内置的[http://us3.php.net/manual/en/function.include.php include()]语句可以实现这一效果，但[[WordPress]][[模板]]标签能够更轻松地包含指定文件。

关于模板和主题的信息请参考[http://www.wordpress.la/codex-%E4%BD%BF%E7%94%A8WordPress%E4%B8%BB%E9%A2%98.html 使用WordPress主题]和[http://www.wordpress.la/codex-WordPress%E4%B8%BB%E9%A2%98%E5%BC%80%E5%8F%91.html 主题开发]。

==页眉模板==
<PRE>&lt;?php get_header(); ?&gt;  </PRE>
该模板标签可包含当前主题目录下的 header.php文件。如果找不到header.php文件， 该标签可包含 [http://core.trac.wordpress.org/browser/trunk/wp-content/themes/default/header.php wp-content/themes/default/header.php]。

==页脚模板==
<PRE>&lt;?php get_footer(); ?&gt;  </PRE>
该模板标签可包含当前主题目录下的footer.php文件。 如果找不到footer.php文件，该标签可包含 [http://core.trac.wordpress.org/browser/trunk/wp-content/themes/default/footer.php wp-content/themes/default/footer.php]。

==侧边栏/工具栏模板==
<PRE>&lt;?php get_sidebar(); ?&gt;  </PRE>
该模板[[标签]]可包含当前主题目录下的sidebar.php文件。 如果找不到sidebar.php文件，该标签可包含[http://core.trac.wordpress.org/browser/trunk/wp-content/themes/default/sidebar.php wp-content/themes/default/sidebar.php]。

<PRE>&lt;?php get_sidebar('right'); ?&gt;  </PRE>

在上面的代码中，'sidebar-right.php'文件被包含。注意：WordPress   2.5新增了包含指定侧边栏的功能，这意味着一个主题中可以使用两个或两个以上侧边栏模板。

==查询表单模板==
<PRE>&lt;?php get_search_form(); ?&gt;  </PRE>

该模板标签可包含当前主题目录下的searchform.php文件。 如果找不到searchform.php文件，该标签生成查询表单。

==评论表单模板==
<PRE>&lt;?php comments_template(); ?&gt;  </PRE>

该模板标签可包含当前主题目录下的comments.php文件。 如果找不到comments.php文件，该标签
包含[http://core.trac.wordpress.org/browser/trunk/wp-content/themes/default/comments.php wp-content/themes/default/comments.php]。用户要在调用评论表单标签前将$withcomments变量值设为“1”以使评论显示在主索引或存档页面上。

==包含所有模板==
以上各个标签都能够包含相应的模板，但有一种简便的方法能够包含所有模板文件。我们需要使用[[PHP]]函数[http://us2.php.net/manual/en/function.include.php include]与WordPress定义的一个常量——TEMPLATEPATH来达到上述目标。

如果我们要将一个名为header2.php的文件包含到某个模板中，只要在这个模板中插入下面的代码行：
<PRE>&lt;?php include( TEMPLATEPATH . '/header2.php' ); ?&gt;  </PRE>

[http://wwwcodex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_header%28%29.html get_header()]可以包含正常的header.php文件，使用以上代码后我们还可以包含其它header。
注意：
*TEMPLATEPATH是对当前模板文件绝对路径的引用（没有结尾斜线/）。   
*TEMPLATEPATH用于包含子主题下的文件。 
==示例==
下面是一个“HTTP 404错误：页面未找到”模板（包含在主题中的404.php）的简单示例：
<PRE>&lt;?php get_header(); ?&gt;  &lt;h2&gt;Error 404 - Not Found&lt;/h2&gt;  &lt;?php get_sidebar(); ?&gt;  &lt;?php get_footer(); ?&gt;</PRE>

==参数==
[http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_header%28%29.html get_header()], [http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_footer%28%29.html get_footer()] 与[http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_sidebar%28%29.html get_sidebar()]都接收一个参数：

<STRONG>$name</STRONG>
（字符串）（可选）调用sidebar-name.php。例如：sidebar-right.php,   header-single.php或footer-8.php。
默认值：None
==修改记录==
*WordPress 1.5
**添加[http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_header%28%29.html get_header()]以包含模板的页眉     
**添加[http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_footer%28%29.html get_footer()]以包含模板的页脚     
**添加[http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_sidebar%28%29.html get_sidebar()]以包含模板的侧边栏 
*WordPress 2.5
*[http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_sidebar%28%29.html get_sidebar()]中添加了name参数
*WordPress 2.7
*[http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_header%28%29.html get_header()]和[http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_footer%28%29.html get_footer()]中也添加了name参数     
*添加[http://www.wordpress.la/codex-%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0-get_search_form%28%29.html get_search_form()]以包含查询表单

源文件
[http://core.trac.wordpress.org/browser/trunk/wp-includes/general-template.php wp-includes/general-template.php]

==相关条目==
*[[Drupal]] 
*[[OBLOG]] 
*[[X-Space]] 
*[[SaBlog-X]] 
*[[Bo-Blog]]

[[category:WordPress中文文档|I]]
[[category:WordPress网站开发|I]]
[[category:WordPress开发文档|I]]