Question

load_template( string $_template_file,  bool $require_once = true )

Require the template file with WordPress environment.

---

description

The globals are set up for the template file to ensure that the WordPress environment is available from within the function. The query variables are also available.

---

参数

$_template_file

(string) (Required) Path to template file.

$require_once

(bool) (Optional) Whether to require_once or require.

Default value: true

---

源代码

File: wp-includes/template.php

function load_template( $_template_file, $require_once = true ) {
	global $posts, $post, $wp_did_header, $wp_query, $wp_rewrite, $wpdb, $wp_version, $wp, $id, $comment, $user_ID;

	if ( is_array( $wp_query->query_vars ) ) {
		extract( $wp_query->query_vars, EXTR_SKIP );
	}

	if ( isset( $s ) ) {
		$s = esc_attr( $s );
	}

	if ( $require_once ) {
		require_once( $_template_file );
	} else {
		require( $_template_file );
	}
}

---

更新日志

Version	description
1.5.0	Introduced.

---

相关函数

Uses

• wp-includes/formatting.php: esc_attr()

---

Used By

• wp-includes/functions.php: do_feed_rdf()
• wp-includes/functions.php: do_feed_rss()
• wp-includes/functions.php: do_feed_rss2()
• wp-includes/functions.php: do_feed_atom()
• wp-includes/template.php: locate_template()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Loading a template in a plugin, but allowing theme and child theme to override template

   
   if ( $overridden_template = locate_template( 'some-template.php' ) ) {
   	/*
   	 * locate_template() returns path to file.
   	 * if either the child theme or the parent theme have overridden the template.
   	 */
   	load_template( $overridden_template );
   } else {
   	/*
   	 * If neither the child nor parent theme have overridden the template,
   	 * we load the template from the 'templates' sub-directory of the directory this file is in.
   	 */
   	load_template( dirname( __FILE__ ) . '/templates/some-template.php' );
   }