WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

zh-cn:调用模板部分/get template part

Description 描述

包含另外一个模板的部分代码到当前模板(区别于header, sidebar, footer)。使得当前主题可以更加容易的重用代码段,并且对于子主题,通过此函数可以容易的替换父主题的代码段。

根据参数 $slug 引入 主题中指定的文件 {slug}.php ,而当 name 被指定的时候,就会包含一个特更为特定的文件 {slug}-{name}.php,

如果主题中如果连{slug}.php文件都没有,则不会引入任何文件

(注:与name不同,slug 在 wordpress 具有特定但模糊的意义——它可以是任何东西,且是可自定义的,但它往往用作前缀 或者分类缩略词。如需了解更多,可参考术语:醒目词(Glossary:slug) )

Usage 用法

 <?php get_template_part$slug$name ); ?> 

Parameters 参数

$slug
(string) (required) The slug name for the generic template. 表示一般性模板的 slug 名
Default: None
$name
(string) (optional) The name of the specialized template. 特别的模板的名字
Default: None

Example 示例

在子主题中调用 loop.php

假设主题所在的文件夹为wp-content/themes, 父主题为twentyten, 子主题为 twentytenchild, 如果我们使用代码:

<?php get_template_part( 'loop', 'index' ); ?>

那么系统将会通过 PHP require() 函数按照下面所示的优先级顺序调用文件:

  1. wp-content/themes/twentytenchild/loop-index.php
  2. wp-content/themes/twentytenchild/loop.php
  3. wp-content/themes/twentyten/loop-index.php
  4. wp-content/themes/twentyten/loop.php

导航条

向主题中添加导航条:

<?php get_template_part( 'nav' );           // Navigation bar (nav.php) ?>
<?php get_template_part( 'nav', '2' );      // Navigation bar #2 (nav-2.php) ?>
<?php get_template_part( 'nav', 'single' ); // Navigation bar to use in single pages (nav-single.php) ?>

source: wp-tricks.co.il - using get_template_part() to create generic navigation bar

说明 Notes

更改记录 Change Log

  • 自WordPress版本起: 3.0

源文件 Source File

get_template_part() 位于 wp-includes/general-template.php.

相关阅读 Related

Include Tags

See also index of Function Reference and index of Template Tags.