WordPress でテンプレートを取得するために使用される関連する PHP 関数の分析

locate_template() は、既存のテンプレート ファイルを最優先で取得するために使用され、テンプレート ファイルを直接ロードすることもできます。

locate_template()関数を使用して取得する場合、子テーマがある場合は、子テーマのテンプレートが最初に使用され、親テーマは再度検索されません。

Usage

locate_template( $template_names, $load, $<strong>require</strong>_once );

Parameters

$template_names

(配列) (必須) インポートするテンプレートファイルの名前(拡張子が必要)、配列に従ってファイルが存在するかどうかを1つずつ照合します、優先度が高いほど優先度が高くなります。

デフォルト値: なし

$load

(ブール値) (オプション) True に設定すると、テンプレート ファイルが直接インポートされます。

デフォルト値: False

$require_once

(ブール値) (オプション) True に設定すると、以前に導入されている場合は今回は導入されません (require_once)。それ以外の場合は導入されます。以前に導入されたかどうかに関係なく導入されます (必須)。

(このパラメータは、$load が True の場合にのみ有効です)。

デフォルト値: False

戻り値

(文字列) 指定されたテンプレートファイルが存在する限りそのパスを返し、それ以外の場合は空の文字列を返します。

例

if( locate_template( 'content-' . $pageName . '.php' ) !== '' ){
  //存在，引入模板文件
  get_template_part( 'content', $pageName );
}else{
  //不存在，直接显示内容
  the_content();
}

その他

この関数は、wp-includes/template.phpにあります

テンプレートを素早く取得します

get_query_template()は、ページテンプレートを素早く取得するために使用されます。所定のページタイプ (type) に設定します。

locate_template() との違いは、ページのタイプを入力する必要があり、{$type}_template テンプレート パス フィルターが生成されることです。
Usage

get_query_template( $type, $templates );

Parameters

$type

(文字列) (必須) 取得するテンプレートファイルのページの種類、対応するテンプレートファイルのファイル名を拡張子なし(シングルなど)で記入します。

デフォルト値: なし

$templates

(配列) (オプション) 代替テンプレートのリスト。

デフォルト値: 空の配列

戻り値

テンプレートファイルへのパスを返します。

例

404 ページのテンプレートが存在する場合はそれを導入します:

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

Others

この関数は次の場所にあります: wp-includes/template.php

上記では、必要なコンテンツを含め、WordPress でテンプレートを取得するために使用される関連する PHP 関数の分析を紹介しました。PHP チュートリアルに興味のある友人に役立つことを願っています。