関連する関数
get_header()関数完全リファレンス
WordPressテーマ開発で必須となるget_header()関数の基本と活用法を解説。引数による異なるヘッダーファイルの読み込み方法や実用的なコード例を交え、初心者でも理解できるよう詳しく紹介します。
WordPressテーマ開発で必須となる get_footer()
関数の基本と活用法を解説します。引数による異なるフッターファイルの読み込み方法や実用的なコード例を交え、初心者でも理解できるよう詳しく紹介。フッターファイルの管理と構造化を完全マスターできます。
WordPressでテーマを作成する際、フッターファイルを読み込むために get_footer()
関数を使用します。
get_footer()
は「フッターファイル(footer.php)を読み込んで表示する」ための関数で、通常はテンプレートファイルの末尾部分で使用されます。
この関数を理解する上で最も重要なのは、引数によって読み込むファイルが変わることです。
get_footer()
は引数なしで呼び出すと footer.php を読み込み、引数を指定すると footer-{引数}.php を読み込みます。
重要: 引数は単純にファイル名を指定するものであり、ページのスラッグや種類とは関係ありません。どのテンプレートファイルからでも、任意のフッターファイルを読み込むことができます。
目次
get_footer()
は、WordPressテーマのフッター部分を読み込むための関数です。
get_footer();
PHP引数なしで呼び出すと、テーマディレクトリの footer.php ファイルを読み込みます。
<main>
<p>ここはメインコンテンツです</p>
</main>
<?php get_footer(); ?>
PHPget_footer()
→ footer.phpget_footer('custom')
→ footer-custom.php$name
: 読み込むフッターファイル名$args
: フッターファイルに渡す変数(WordPress 5.5以降)戻り値はありません(ファイルを直接出力)
// footer.php を読み込み
get_footer();
// footer-custom.php を読み込み
get_footer('custom');
// 変数を渡して読み込み(WordPress 5.5以降)
get_footer('custom', ['page_type' => 'special']);
PHP<?php get_header(); ?>
<div class="container">
<h1>ページタイトル</h1>
<p>ページの内容</p>
</div>
<?php get_footer(); ?>
PHP<footer class="site-footer">
<nav class="footer-nav">
<ul>
<li><a href="/">ホーム</a></li>
<li><a href="/about">会社概要</a></li>
<li><a href="/contact">お問い合わせ</a></li>
</ul>
</nav>
<p>© 2024 サイト名. All rights reserved.</p>
</footer>
PHP// footer-shop.php を読み込む
get_footer('shop');
PHPget_footer('shop')
→ footer-shop.phpget_footer('blog')
→ footer-blog.php<div class="main-content">
<!-- メインコンテンツ -->
</div>
<?php
if (is_front_page()) {
get_footer('home');
} else {
get_footer();
}
?>
PHPこの場合、以下のファイルが読み込まれます。
<?php
// index.php
?>
<main>
<!-- コンテンツ -->
</main>
<?php
if (is_front_page()) {
get_footer('front');
} else {
get_footer();
}
?>
PHP<main>
<!-- 記事コンテンツ -->
</main>
<?php
$footer_args = [
'page_type' => 'single',
'show_related' => true
];
get_footer('post', $footer_args);
?>
PHP<?php
$page_type = $args['page_type'] ?? 'default';
$show_related = $args['show_related'] ?? false;
?>
<footer class="site-footer <?php echo $page_type; ?>">
<?php if ($show_related) : ?>
<div class="related-posts">
<h3>関連記事</h3>
<!-- 関連記事の表示 -->
</div>
<?php endif; ?>
<p>© 2024 サイト名. All rights reserved.</p>
</footer>
PHP<?php
// page.php
get_header();
?>
<main>
<h1>ページタイトル</h1>
<p>ページの内容</p>
</main>
<?php get_footer(); ?>
PHP<?php
// どのテンプレートファイルからでも任意のフッターファイルを読み込める
// 標準のフッター
get_footer();
// 「simple」という名前のフッター
get_footer('simple');
// 「minimal」という名前のフッター
get_footer('minimal');
?>
PHPget_footer()
→ footer.phpget_footer('simple')
→ footer-simple.phpget_footer('minimal')
→ footer-minimal.php重要: 引数は単なるファイル名の指定であり、ページの種類やスラッグとは無関係です。
<?php
// index.php で特別なフッターを使用
get_footer('special');
// single.php で標準のフッターを使用
get_footer();
// page.php でシンプルなフッターを使用
get_footer('simple');
?>
PHPこのように、どのテンプレートファイルからでも任意のフッターファイルを読み込めます。
例えば page-about.php でも
<?php
// page-about.php
get_header();
?>
<main>
<!-- 会社概要ページのコンテンツ -->
</main>
<?php
get_footer('contact'); // footer-contact.php を読み込む
?>
PHPページのスラッグが「about
」でも、footer-about.php を使う必要はありません。
// 間違い: footer-nonexistent.php が存在しない
get_footer('nonexistent');
// 正解: 存在するファイルを指定
get_footer('custom'); // footer-custom.php が存在する場合
PHP間違い footer.php 内で get_footer()
を呼び出す
<footer>
<!-- フッターコンテンツ -->
</footer>
<?php get_footer(); ?>
<!-- これは無限ループを引き起こす -->
// 正解: footer.php 内では get_footer() を使わない
<footer>
<p>© 2024 サイト名. All rights reserved.</p>
</footer>
PHP間違い ページのスラッグと関連付けて考える。
page-about.php だから footer-about.php を使わなければならない、という考えは間違い。
// 正解: 引数は単なるファイル名の指定
// page-about.php でも任意のフッターファイルを使える
get_footer('simple'); // footer-simple.php を読み込む
get_footer('contact'); // footer-contact.php を読み込む
PHP// 間違い: 複数のフッターを読み込む
get_footer();
get_footer('custom');
// 正解: 一つのフッターファイルのみ読み込む
get_footer('custom');
PHPget_footer()
関数は WordPressテーマ作成で必須の関数です。
重要なポイント
get_footer()
: footer.phpを読み込みget_footer('name')
: footer-name.phpを読み込み基本的な使い方
フッターファイルの管理には get_footer() を使用すると覚えておけば間違いありません。
WordPressを効率よく確実に学ぶためには、学習の順序が大切です。知識が自然に積み上がるよう、学習ステップに沿って記事を順番に並べています。
学習ストーリー第40話まで掲載中