当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

関数リファレンス/load template

提供: WordPress Codex 日本語版
< 関数リファレンス
2018年5月23日 (水) 15:53時点におけるGblsm (トーク | 投稿記録)による版 (en:Function Reference/load_template 10:12, 26 December 2013 Mistercat 版を流し込み。)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

このページ「関数リファレンス/load template」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

Description

Require once the template file with WordPress environment.

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.

Usage

<?php load_template( $_template_file, $require_once ) ?>

Parameters

$_template_file
string) (必須) Path to template file.
初期値: なし
$require_once
bool) (optional) Whether to require_once or require.
初期値: true

Return Values

(void) 
This function does not return a value.

Examples

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' );
  }

Notes

  • Uses global: (object) $wp_query to extract extract() global variables returned by the query_vars method while protecting the current values in these global variables:
    • (unknown type) $posts
    • (unknown type) $post
    • (boolean) $wp_did_header Returns true if the WordPress header was already loaded. See the /wp-blog-header.php file for details.
    • (boolean) $wp_did_template_redirect
    • (object) $wp_rewrite
    • (object) $wpdb
    • (string) $wp_version holds the installed WordPress version number.
    • (string) $wp
    • (string) $id
    • (string) $comment
    • (string) $user_ID

Change Log

Since: 1.5.0

Source File

load_template() is located in wp-includes/template.php.

Related

テンプレート関数: locate_template(), load_template(), get_template(), get_template_part(), get_template_directory(), get_template_directory_uri(), get_page_templates() /en, comments_template(), get_query_template(), is_page_template()


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/load_template最新版との差分