WordPressInclude标签
导航: 上一页 | 首页 | WordPress中文论坛 | WordPress主机 | CMS程序 | 论坛程序 | ECShop | ShopNC | PowerEasy
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