load_template()


WordPressの関数load_template()は、指定されたPHPテンプレートファイルを読み込むために使用されます。

構文

load_template( string $template_file, bool $require_once = true );

引数の説明:

  • $template_file (string) — 読み込むテンプレートファイルのパス。
  • $require_once (bool) — ファイルを1回だけ読み込むかどうかを指定します。デフォルトはtrueです。

例1: 基本的なテンプレートの読み込み

以下のコードは、指定されたテンプレートファイルを読み込みます。

<?php load_template( get_template_directory() . '/custom-template.php' ); ?>

例2: ファイルを複数回読み込む

$require_onceをfalseに設定して、テンプレートファイルを複数回読み込むことができます。

<?php load_template( get_template_directory() . '/custom-template.php', false ); ?>

例3: プラグインディレクトリからテンプレートを読み込む

プラグイン内のテンプレートを読み込む場合は、以下のように記述します。

<?php load_template( plugin_dir_path( __FILE__ ) . 'plugin-template.php' ); ?>

例4: 条件に基づいてテンプレートを読み込む

特定の条件に基づいて異なるテンプレートを読み込む方法を示します。

<?php
if ( is_single() ) {
    load_template( get_template_directory() . '/single-template.php' );
} else {
    load_template( get_template_directory() . '/general-template.php' );
}
?>

例5: 配列をテンプレートに渡す

テンプレートに配列を渡す場合、extract()を使用します。

<?php
$data = array( 'key' => 'value' );
extract( $data );
load_template( get_template_directory() . '/template-with-data.php' );
?>

注意事項

  • テンプレートファイルのパスが正しいことを確認してください。
  • require_onceをfalseに設定すると、テンプレートが意図せず複数回読み込まれる場合があります。
  • カスタムテンプレートを使用する際には、ファイルの権限とセキュリティに注意してください。

関連機能：