get_template() の使い方|説明・引数・注意点

説明

get_template() は、親テーマのディレクトリ名(テンプレート名)を返す関数です。

基本構文

get_template(): string

引数

引数はありません。

戻り値

ディレクトリ名。

使い方(サンプル)

$parent = get_template();

注意点

  • 子テーマ利用時は、親テーマのディレクトリ名が返ります。

実務での使いどころ

  • 親テーマの、フォルダ名(スラッグ)を、取得するとき。

よくあるミスと対処

  • 有効なテーマの名前だと、考えている。子テーマを使っているとき、この関数は、親テーマのスラッグを返す。有効なテーマ(子テーマ)は、get_stylesheet()。
  • テーマの表示名(Name)が、返ると考えている。返るのは、フォルダ名。表示名は、wp_get_theme() から取得する。

NG例

$active = get_template(); // 子テーマ使用時は、親テーマのスラッグ

OK例

$active = get_stylesheet(); // 有効なテーマ(子テーマなら、子テーマ)のスラッグ
$parent = get_template();   // 親テーマのスラッグ

使い分け早見表

関数 返すもの
get_template() 親テーマのスラッグ
get_stylesheet() 有効なテーマ(子テーマなら、子テーマ)のスラッグ
wp_get_theme() テーマの情報(名前、バージョンなど)

関連項目

get_stylesheet()、wp_get_theme()

公式リファレンス:get_template() | Function | WordPress Developer Resources

コメント

タイトルとURLをコピーしました