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

「関数リファレンス/get query template」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
()
(Code Reference の get_query_template() をマージ。)
 
(同じ利用者による、間の1版が非表示)
1行目: 1行目:
== 説明 ==
+
== 説明<span id="Description"></span> ==
拡張子無しでファイルのパスを取得します。
+
  
ファイルの拡張子を含まないファイルのパスを直接取得するために使用します。
+
拡張子を含めずファイル名を指定してテンプレートのパスを取得します。[[関数リファレンス/locate_template|<tt>locate_template()</tt>]] を利用して、テンプレートの有無を親テーマについてもチェックします。他の <tt>get_*_template()</tt> 関数を使わずに、より汎用的なテンプレートの取得が行えます。
  
もし[[関数リファレンス/locate_template|<tt>locate_template()</tt>]] /[[:en:Function_Reference/locate_template|en]] を使用したファイルが存在する場合、親テンプレートもチェックします。
+
== 使い方<span id="Usage"></span> ==
  
他の<tt>get_*_template()</tt>関数を使用せずに、より汎用的なファイルパスの設定を可能にします。
+
<?php get_query_template( $type, $templates ); ?>
  
パスを取得するのに、 [http://us3.php.net/manual/en/function.include.php <tt>include()</tt>] または [http://us3.php.net/manual/en/function.require.php <tt>require()</tt>] を使うことができます。
+
== パラメータ<span id="Parameters"></span> ==
  
<code>
+
{{Parameter|$type|文字列|拡張子なしのファイル名。}}
    if ( &#39;&#39; != get_query_template( '404' ) )
+
        include( get_query_template( '404' ) );
+
</code>
+
  
or the same can be accomplished with
+
{{Parameter|$templates|配列|テンプレート候補のリスト。|オプション|array()}}
<code>
+
    if ( &#39;&#39; != get_404_template() )
+
        include( get_404_template() );
+
</code>
+
  
== 使い方 ==
+
== 戻り値<span id="Return_Values"></span> ==
  
<?php get_query_template( $type, $templates ); ?>
+
; (文字列) : テンプレートファイルへのフルパス。
  
== パラメータ ==
+
== 用例<span id="Examples"></span> ==
  
{{Parameter|$type|string|拡張子なしのファイル名}}
+
取得したパスのファイルを読み込むには [http://us3.php.net/manual/ja/function.include.php <tt>include()</tt>] や [http://us3.php.net/manual/ja/function.require.php <tt>require()</tt>] が使えます。
 +
<pre>
 +
    if ( &#39;&#39; != get_query_template( '404' ) )
 +
        include( get_query_template( '404' ) );
 +
</pre>
  
{{Parameter|$templates|array|テンプレート候補のオプションのリスト|optional|array()}}
+
以下のコードでも実現できます。
 +
<pre>
 +
    if ( &#39;&#39; != get_404_template() )
 +
        include( get_404_template() );
 +
</pre>
  
== 戻り値 ==
+
== 参考<span id="Notes"></span> ==
; (string) : ファイルへのフルパス
+
  
== 用例 ==
+
* <tt>$templates</tt> が空の場合、<tt>{$type}.php</tt> を探します。
<!-- Need creative examples. Feel free to link to external examples. -->
+
* 動的なフィルター <tt>[https://developer.wordpress.org/reference/hooks/type_template_hierarchy/ '{$type}_template_hierarchy']</tt> を <tt>$templates</tt> に適用します。
 +
* [[関数リファレンス/locate_template|<tt>locate_template()</tt>]] でテンプレートファイルを特定した後、動的なフィルター <tt>[https://developer.wordpress.org/reference/hooks/type_template/ '{$type}_template']</tt> を適用します。
  
== ==
+
== 変更履歴<span id="Change_Log"></span> ==
* Uses: [[関数リファレンス/apply_filters|<tt>apply_filters()</tt>]] on <tt>[[Filter_Reference/type_template|{$type}_template]]</tt> on result from [[関数リファレンス/locate_template|<tt>locate_template()</tt>]] /[[:en:Function_Reference/locate_template|en]].
+
* Uses:"{<tt>$type</tt>}.php" では[[関数リファレンス/locate_template|<tt>locate_template()</tt>]] /[[:en:Function_Reference/locate_template|en]]を使用してください。
+
  
== 更新履歴 ==
 
 
新規導入: 1.5.0
 
新規導入: 1.5.0
  
== ソースファイル ==
+
== ソースファイル<span id="Source_File"></span> ==
  
<tt>get_query_template()</tt> は {{Trac|wp-includes/template.php}}にあります。
+
<tt>get_query_template()</tt> は {{Trac|wp-includes/template.php}} にあります。
  
== 関連 ==
+
== 関連項目<span id="Related"></span> ==
  
 
{{Tag Footer}}
 
{{Tag Footer}}
  
{{原文|Function Reference/get query template|139334}}<!-- 23:11, 12 December 2013‎ Mistercat 版 -->
+
<!-- {{原文|Function Reference/get query template|153412}}  05:59, 14 August 2015 Miccweb 版 -->
 +
最新英語版: [https://developer.wordpress.org/reference/functions/get_query_template/ Reference / Functions / get_query_template()]
 +
 
 +
[[en:Function Reference/get_query_template]]
 +
[[it:Riferimento funzioni/get_query_template]]

2018年6月2日 (土) 12:35時点における最新版

説明

拡張子を含めずファイル名を指定してテンプレートのパスを取得します。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() );

参考

変更履歴

新規導入: 1.5.0

ソースファイル

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

関連項目

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


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