WordPress どこからテンプレートが読み込まれているのか？

Question

Wordpressを使用しています。オリジナルテンプレートで作成しているのですが、<?php get_sidebar()?>と入力したのですが、デフォルトのオリジナルテンプレートにはsidebar.phpがありません。と、するとこのsidebar.phpはどこから読み込まれているのかが知りたいです。もしかしたら他のテンプレートのsidebar.phpが読み込まれているのではないでしょうか？
ちなみに他のテンプレートを使用しない、デフォルトではsidebar.phpが存在しませんでした。

どこから読み込まれているかご教授お願いします。

Answer 1

まず、WordPress には親テーマと子テーマという概念があります。WordPress でテーマの PHP ファイルなどを読み込む時は、子テーマ > 親テーマ > デフォルト（wp-includes/theme-compat/） という順番でファイルを探しに行きます。親テーマは子テーマの元になっているテーマを指します。子テーマについては、以下のリンクをご覧ください。

https://wpdocs.osdn.jp/%E5%AD%90%E3%83%86%E3%83%BC%E3%83%9E

ファイルの読み込みの仕組みですが、get_sidebar() 関数、get_header() 関数、get_footer() 関数の内部では、locate_template() 関数が呼ばれています。以下に示すのは、get_sidebar() 関数のコアソースです。

/**
 * Load sidebar template.
 *
 * Includes the sidebar template for a theme or if a name is specified then a
 * specialised sidebar will be included.
 *
 * For the parameter, if the file is called "sidebar-special.php" then specify
 * "special".
 *
 * @since 1.5.0
 *
 * @param string $name The name of the specialised sidebar.
 */
function get_sidebar( $name = null ) {
	/**
	 * Fires before the sidebar template file is loaded.
	 *
	 * The hook allows a specific sidebar template file to be used in place of the
	 * default sidebar template file. If your file is called sidebar-new.php,
	 * you would specify the filename in the hook as get_sidebar( 'new' ).
	 *
	 * @since 2.2.0
	 * @since 2.8.0 $name parameter added.
	 *
	 * @param string|null $name Name of the specific sidebar file to use. null for the default sidebar.
	 */
	do_action( 'get_sidebar', $name );

	$templates = array();
	$name = (string) $name;
	if ( '' !== $name )
		$templates[] = "sidebar-{$name}.php";

	$templates[] = 'sidebar.php';

	locate_template( $templates, true );
}

最後にlocate_template( $templates, true );という記述がありますが、この部分がファイルを読み込んでいる部分です。locate_template() 関数が何をしているのかというと、単純に PHP の関数である file_exists() 関数でファイルが有るか無いかをチェックして、有れば PHP の関数である require_once() 関数でファイルを読み込んでいるだけです。

改変は厳禁ですが、WordPress の関数がどのような動きをしているのか気になったら、WordPress のコアファイルを覗いてみると色々発見があり面白いと思いますよ。

Comments

[ebifurai55]

詳細な投稿ありがとうございます。ただ、今の段階で私の頭がついていけないので、何をやっているかわかりません。コアファイルを見ても、引数、メソッド、関数、の概念が解ってない私にはちょっときつい労働です。ですが、頑張って覚えたいと思います。何度かこの投稿を見させて貰います。ありがとうございました。

Answer 2

【関数リファレンス/get sidebar - WordPress Codex 日本語版】
https://wpdocs.osdn.jp/関数リファレンス/get_sidebar

現在のテーマディレクトリの sidebar.php テンプレートファイルを読み込みます。

名前 ($name) を指定すると、対応するサイドバー sidebar-{name}.php を読み込みます。sidebar-{name}.php が存在しない場合は、かわりに sidebar.php を読み込みます。
sidebar.php ファイルがテーマに含まれていない場合は、デフォルトテーマの wp-includes/theme-compat/sidebar.php からサイドバーを読み込みます。

Comments

[ebifurai55]

ありがとうございます。参考にします。

Answer 3

詳しい仕組みはわかりませんが、

wordpress/wp-includes/theme-compat/
```基本的なものは、このtheme-compatのフォルダに入っているテンプレートが使われるみたいです。
（最初のwordpressのフォルダは人によって違うかもしれません）

Comments

[ebifurai55]

ありがとうございます、参考にします。

Answer 4

みなさんありがとうございます。解決のご報告が遅れてしまいましたが、一応自己解決。
wordpress/wp-includes/theme-compat/

ちなみにフロントページがどこなのかは未だに解ってませんが、その内トレースしたいと思います。

Sidebar.phpが結局のところここにウィジットを表示させるコードを書かないと動かないと判明したので、のんびりコードを追加していきたいと思います。

ありがとうございました。

Answer 5

デバッグ環境を整えて、ステップ実行すると面白いです。
コアファイルをどのように通ってくるのか、一度見てみるとイイです。

Comments

[ebifurai55]

ありがとうございます、参考にします。