is_page_template()


WordPress関数is_page_template()は、現在のページが特定のページテンプレートを使用しているかどうかを判定するために使用されます。

構文

is_page_template( string $template = '' );

引数の説明:

  • $template (string) — チェックしたいテンプレートファイルの名前を指定します。例: 'about-us.php'。

例 1: 特定のテンプレートのチェック

現在のページが'custom-template.php'を使用している場合に処理を実行します。

<?php
if ( is_page_template( 'custom-template.php' ) ) {
    echo 'このページはカスタムテンプレートを使用しています。';
}
?>

例 2: すべてのページテンプレートのチェック

現在のページがページテンプレートを使用している場合に処理を実行します。

<?php
if ( is_page_template() ) {
    echo 'このページはテンプレートを使用しています。';
}
?>

例 3: デフォルトテンプレートでない場合のチェック

現在のページがデフォルトテンプレート以外を使用している場合に別の出力をします。

<?php
if ( ! is_page_template( 'default' ) ) {
    echo 'デフォルト以外のテンプレートが使用されています。';
}
?>

例 4: テンプレートによる条件分岐

ページテンプレートごとに異なる内容を表示します。

<?php
if ( is_page_template( 'template-one.php' ) ) {
    echo 'テンプレート1の内容を表示します。';
} elseif ( is_page_template( 'template-two.php' ) ) {
    echo 'テンプレート2の内容を表示します。';
} else {
    echo 'その他のテンプレートです。';
}
?>

例 5: テンプレートの動的チェック

テンプレート名を動的に取得してチェックします。

<?php
$template_name = 'dynamic-template.php';
if ( is_page_template( $template_name ) ) {
    echo $template_name . ' が使用されています。';
}
?>

注意事項

  • is_page_template()は、ページがテンプレートを使用していない場合にfalseを返します。
  • テンプレートファイル名はテーマディレクトリに存在する必要があります。
  • 引数を指定しない場合、現在のページがテンプレートを使用しているかどうかだけを判定します。

関連機能：