Include标签

0条评论

Include标签

Include标签可以将一个模板文件(例如header.php)中的HTMLPHP代码包含到另一模板文件(例如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

修改记录

源文件

wp-includes/general-template.php