説明
load_template() は、指定したテンプレートファイルを読み込む関数です。
基本構文
load_template( string $_template_file, bool $load_once = true, array $args = array() ): void引数
$_template_file：テンプレートのパス$load_once：一度だけ読み込むか$args：引数
戻り値
戻り値はありません。
使い方（サンプル）
load_template( get_theme_file_path( 'inc/card.php' ), false );注意点
- ファイルのパスを直接指定します。パーツの読み込みは通常
get_template_part()を使います。
実務での使いどころ
- パスが分かっているテンプレートのファイルを、読み込むとき（通常は、
get_template_part()を使う）。
よくあるミスと対処
- ファイルが、存在しないとき、致命的エラーになる場合がある。
file_exists()で、確認してから読み込む。 - ユーザー入力で、パスを決めている。
- 通常は、この関数ではなく、
get_template_part()で足りる。
NG例
load_template( $_GET['tpl'] ); // 入力で、パスを決めているOK例
$file = locate_template( 'template-parts/card.php' );
if ( $file ) {
load_template( $file, false );
}使い分け早見表
| 関数 | 役割 |
|---|---|
load_template() |
パスを指定して、読み込む |
get_template_part() |
探して、読み込む（通常はこちら） |
locate_template() |
テンプレートのファイルの場所を、探す |
関連項目
get_template_part()、locate_template()
公式リファレンス：load_template() | Function | WordPress Developer Resources
コメント