関連する関数
is_front_page()関数完全リファレンス
WordPressテーマ開発で必須となる is_front_page() と is_home() 関数の基本と活用法を解説します。管理画面の表示設定による動作の違いや実用的なコード例を交え、初心者でも理解できるよう詳しく紹介。トップページと投稿一覧ページの判定方法を完全マスターできます。
is_home()関数完全リファレンス
- 2025/08/06
- REFERENCE
- WordPressの関数
- 0comments
- 20views
- 約8分で読めます
WordPressでテーマを作成する際、現在表示されているページが特定のページかどうかを判定するために is_front_page() と is_home() 関数を使用します。
is_front_page() は「サイトのトップページ（フロントページ）かどうか」を判定し、is_home() は「投稿一覧ページ（ブログのメインページ）かどうか」を判定します。
目次
重要：表示設定による動作の違い
これらの関数を理解する上で最も重要なのは、管理画面 > 設定 > 表示設定 の「ホームページの表示」設定により、動作が大きく変わることです。
単純に「トップページ」と「投稿一覧ページ」を判定するだけでなく、WordPressの設定によって同じページを指す場合と、異なるページを指す場合があります。この設定の違いを理解せずに使用すると、期待通りに動作しない場合があります。
基本的な使い方
is_front_page() と is_home() は、どちらもページの種類を判定する関数です。初心者の方によくある混同を避けるため、まずそれぞれの役割を理解しましょう。
構文
is_front_page();
is_home();どちらも引数は不要で、戻り値は true または false です。
is_front_page() – サイトのトップページを判定
is_front_page() は、サイトのトップページ（フロントページ） を表示している時に true を返します。
<?php if (is_front_page()) : ?>
<p>ここはサイトのトップページです</p>
<?php endif; ?>is_home() – 投稿一覧ページを判定
is_home() は、メインの投稿一覧ページ（ブログのメインページ） を表示している時に true を返します。
<?php if (is_home()) : ?>
<p>ここは投稿一覧ページです</p>
<?php endif; ?>重要なポイント
WordPressの設定により、トップページ と 投稿一覧ページ が同じ場合と異なる場合があります：
- 同じ場合: 設定で「最新の投稿」を選択 → トップページに投稿一覧が表示
- 異なる場合: 設定で「固定ページ」を選択 → トップページは固定ページ、投稿一覧は別ページ
この違いが、2つの関数の動作に大きく影響します。
関数の詳細
is_front_page()
パラメータ: なし
戻り値: boolean（true または false）
説明: サイトのフロントページ（トップページ）を表示している場合に true を返します。
is_home()
パラメータ: なし
戻り値: boolean（true または false）
説明: メインの投稿一覧ページを表示している場合に true を返します。
設定による動作の違い
WordPressの管理画面 > 設定 > 表示設定 でのホームページ設定によって、これらの関数の動作が変わります。
設定パターン1: 最新の投稿
設定: ホームページの表示 → 最新の投稿
| 表示ページ | is_front_page() | is_home() |
|---|---|---|
| トップページ（投稿一覧） | true | true |
| 投稿詳細ページ | false | false |
| 固定ページ | false | false |
設定パターン2: 固定ページ
設定: ホームページの表示 → 固定ページ
ホームページ: 「トップページ」（ID: 10） 投稿ページ: 「ニュース」（ID: 20）
| 表示ページ | is_front_page() | is_home() |
|---|---|---|
| トップページ（固定ページ） | true | |
| ニュース（投稿一覧） | false | |
| 投稿詳細ページ | false | false |
| その他の固定ページ | false | false |
実用例
例1: トップページのみに表示
<?php if (is_front_page()) : ?>
<div class="hero-banner">
<h1>ようこそ、当サイトへ</h1>
</div>
<?php endif; ?>結果（最新の投稿設定時）
<div class="hero-banner">
<h1>ようこそ、当サイトへ</h1>
</div>例2: 投稿一覧ページのみに表示
<?php if (is_home()) : ?>
<div class="blog-header">
<h1>最新記事</h1>
</div>
<?php endif; ?>結果（固定ページ設定時、投稿一覧ページで）
<div class="blog-header">
<h1>最新記事</h1>
</div>例3: 条件に応じた表示切り替え
<?php
if (is_front_page() && is_home()) {
// 最新の投稿設定時のトップページ
echo '<h1>最新記事一覧</h1>';
} elseif (is_front_page()) {
// 固定ページ設定時のトップページ
echo '<h1>ホームページ</h1>';
} elseif (is_home()) {
// 固定ページ設定時の投稿一覧ページ
echo '<h1>ブログ</h1>';
}
?>結果（最新の投稿設定時）
<h1>最新記事一覧</h1>結果（固定ページ設定時、トップページで）
<h1>ホームページ</h1>結果（固定ページ設定時、投稿一覧ページで）
<h1>ブログ</h1>例4: CSSクラスの動的付与
<body class="<?php
if (is_front_page()) {
echo 'front-page ';
}
if (is_home()) {
echo 'home ';
}
?>">結果（最新の投稿設定時）
<body class="front-page home ">結果（固定ページ設定時、トップページで）
<body class="front-page ">例5: 特定のコンテンツをトップページから除外
<?php if (!is_front_page()) : ?>
<div class="breadcrumb">
<a href="<?php echo home_url(); ?>">ホーム</a> >
<?php echo get_the_title(); ?>
</div>
<?php endif; ?>結果（トップページ以外で）
<div class="breadcrumb">
<a href="https://example.com/">ホーム</a> > お問い合わせ
</div>例6: 投稿一覧ページでの表示制御
<?php if (is_home() && !is_front_page()) : ?>
<div class="blog-description">
<p>当サイトの最新記事をご覧いただけます。</p>
</div>
<?php endif; ?>結果（固定ページ設定時の投稿一覧ページで）
<div class="blog-description">
<p>当サイトの最新記事をご覧いただけます。</p>
</div>よくある間違い
間違い1: is_front_page() と is_home() の混同
// 間違い: トップページでこれを期待したが表示されない場合がある
<?php if (is_home()) : ?>
<div class="welcome-message">ようこそ！</div>
<?php endif; ?>正解
// 正解: 設定に関わらずトップページで表示
<?php if (is_front_page()) : ?>
<div class="welcome-message">ようこそ！</div>
<?php endif; ?>間違い2: 両方の条件を考慮しない
// 間違い: 最新の投稿設定時に動作しない
<?php if (is_front_page() && !is_home()) : ?>
<div class="static-page-content">固定ページコンテンツ</div>
<?php endif; ?>正解
// 正解: 条件を正しく設定
<?php if (is_front_page()) : ?>
<?php if (is_home()) : ?>
<div class="blog-front-page">ブログトップ</div>
<?php else : ?>
<div class="static-page-content">固定ページコンテンツ</div>
<?php endif; ?>
<?php endif; ?>間違い3: 設定変更時の動作確認不足
設定を変更した場合は、必ず両方のパターンでテストしましょう。
// テスト用コード
<?php
echo 'is_front_page(): ' . (is_front_page() ? 'true' : 'false') . '<br>';
echo 'is_home(): ' . (is_home() ? 'true' : 'false') . '<br>';
?>まとめ
is_front_page() と is_home() 関数は WordPressテーマ作成でよく使用される条件分岐関数です。
is_front_page(): サイトのトップページを判定is_home(): メインの投稿一覧ページを判定- 「管理画面 > 設定 > 表示設定」により動作が変わる
- 両方の条件を組み合わせることで柔軟な表示制御が可能
- 設定変更時は必ず動作確認を行う
トップページの表示制御には is_front_page()、投稿一覧ページの表示制御には is_home() を使用すると覚えておけば間違いありません。
