- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
関数リファレンス/get query template
提供: WordPress Codex 日本語版
< 関数リファレンス
説明
拡張子を含めずファイル名を指定してテンプレートのパスを取得します。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
にあります。
関連項目
関数リファレンス、テンプレートタグ目次もご覧ください。