Summery Summery

Require the template file with WordPress environment.

Syntax Syntax

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

Description 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.

Parameters Parameters


(Required) Path to template file.


(Optional) Whether to require_once or require.

Default value: true

Source Source

File: wp-includes/template.php

 * @global int        $user_ID
 * @param string $_template_file Path to template file.
 * @param bool   $require_once   Whether to require_once or require. Default true.
 * @param array  $args           Optional. Additional arguments passed to the template.
 *                               Default empty array.
function load_template( $_template_file, $require_once = true, $args = array() ) {
	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 ) ) {
		 * This use of extract() cannot be removed. There are many possible ways that
		 * templates could depend on variables that it creates existing, and no way to
		 * detect and deprecate it.
		 * Passing the EXTR_SKIP flag is the safest option, ensuring globals and
		 * function variables cannot be overwritten.
		// phpcs:ignore WordPress.PHP.DontExtract.extract_extract
		extract( $wp_query->query_vars, EXTR_SKIP );

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


Changelog Changelog

Version Description
1.5.0 Introduced.


Leave a Reply