Include标签

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。

注意：

• TEMPLATEPATH是对当前模板文件绝对路径的引用（没有结尾斜线/）。
• TEMPLATEPATH用于包含子主题下的文件。

示例

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

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

参数

get_header(), get_footer() 与get_sidebar()都接收一个参数：

$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()以包含查询表单

源文件

wp-includes/general-template.php

分类：中文手册