WordPressInclude标签：修订间差异

2010年4月30日 (五) 10:21的最新版本

Include标签可以将一个模板文件（例如header.php）中的HTML和PHP代码包含到另一模板文件（例如index.php）中。PHP内置的include()语句可以实现这一效果，但WordPress 模板标签能够更轻松地包含指定文件。

关于模板和主题的信息请参考使用WordPress主题和主题开发。

<?php get_header(); ?>

该模板标签可包含当前主题目录下的 header.php文件。如果找不到header.php文件，该标签可包含 wp-content/themes/default/header.php。

<?php get_footer(); ?>

该模板标签可包含当前主题目录下的footer.php文件。如果找不到footer.php文件，该标签可包含 wp-content/themes/default/footer.php。

<?php get_sidebar(); ?>

该模板标签可包含当前主题目录下的sidebar.php文件。如果找不到sidebar.php文件，该标签可包含wp-content/themes/default/sidebar.php。

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

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

<?php get_search_form(); ?>

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

<?php comments_template(); ?>

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

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

如果我们要将一个名为header2.php的文件包含到某个模板中，只要在这个模板中插入下面的代码行：

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

get_header()可以包含正常的header.php文件，使用以上代码后我们还可以包含其它header。注意：

下面是一个“HTTP 404错误：页面未找到”模板（包含在主题中的404.php）的简单示例：

<?php get_header(); ?>  <h2>Error 404 - Not Found</h2>  <?php get_sidebar(); ?>  <?php get_footer(); ?>

$name （字符串）（可选）调用sidebar-name.php。例如：sidebar-right.php, header-single.php或footer-8.php。默认值：None

WordPress 1.5
- 添加get_header()以包含模板的页眉
- 添加get_footer()以包含模板的页脚
- 添加get_sidebar()以包含模板的侧边栏
WordPress 2.5
get_sidebar()中添加了name参数
WordPress 2.7
get_header()和get_footer()中也添加了name参数
添加get_search_form()以包含查询表单

@@ 第1行： / 第1行： @@
 <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模板标签能够更轻松地包含指定文件。
+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 主题开发]。