関数リファレンス/get query template

説明

拡張子を含めずファイル名を指定してテンプレートのパスを取得します。locate_template() を利用して、テンプレートの有無を親テーマについてもチェックします。他の get_*_template() 関数を使わずに、より汎用的なテンプレートの取得が行えます。

使い方

<?php get_query_template( $type, $templates ); ?>

パラメータ

$type

（文字列） （必須） 拡張子なしのファイル名。

初期値： なし

$templates

（配列） （オプション） テンプレート候補のリスト。

初期値： array()

戻り値

(文字列) 

テンプレートファイルへのフルパス。

用例

取得したパスのファイルを読み込むには include() や require() が使えます。

    if ( '' != get_query_template( '404' ) )
        include( get_query_template( '404' ) );

以下のコードでも実現できます。

    if ( '' != get_404_template() )
        include( get_404_template() );

参考

• $templates が空の場合、{$type}.php を探します。
• 動的なフィルター '{$type}_template_hierarchy' を $templates に適用します。
• locate_template() でテンプレートファイルを特定した後、動的なフィルター '{$type}_template' を適用します。

変更履歴

新規導入: 1.5.0

ソースファイル

get_query_template() は wp-includes/template.php にあります。

関連項目

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

最新英語版: Reference / Functions / get_query_template()