【WordPress】フッターを読み込む関数「get_footer()」解説
こんにちは、岐阜・名古屋を拠点に全国各地からご依頼いただくWEBサイトを制作しているフリーランスエンジニアの寺井です。
WordPressではヘッダーやフッターなどサイトの共通部分はひとつのファイルにまとめることが一般的な開発手順となっています。
今回の記事ではフッターにスポットを当てて、別ファイルに切り分けたフッター部分のHTMLを各ページに読み込む方法をご紹介します。
基本的な使用方法
テーマ内にあるfooter.phpをpage.phpやindex.phpなどで読み込む場合、WordPressの独自関数として定義されているget_footer()
関数を使用します。
使用方法は以下の通りです。
<?php get_footer(); ?>
これで同じテーマ内にあるfooter.phpを読み込むことが出来ます。
応用した使用方法
続いてget_footer()
関数の少し応用した使用方法を見てみましょう。get_footer()
関数は以下のように定義されていて引数を2つ渡すことが出来ます。
get_footer( $name = null, $args = array() )
- $name:読み込むフッターテンプレートの名前を指定できます。
- $args:変数を配列としてフッターテンプレートに渡すことが出来ます。
複数のフッターファイルを使い分ける
仕様によっては複数のフッターを使い分ける必要があるかもしれません。
この場合、以下のように複数のフッターファイルを用意します。
- footer.php
- footer-recruit.php
footer-recruit.phpを読み込む場合、以下のようにget_footer()
関数を使用します。
<?php get_footer('recruit'); ?>
これで同じテーマ内にあるfooter-recruit.phpを読み込むことが出来ます。
引数を指定しなければ、footer.phpを読み込むことが出来ます。
フッターに引数を渡す
仕様やカスタマイズ内容によってはfooter.phpに引数を渡したい場合もあるかもしれません。
この場合、以下のように引数を指定することでfooter.phpに引数を渡すことが出来ます。
フッターを読み込む側は以下のように記述し引数を渡します。
<?php
$args = [
'name' => 'site-name',
];
get_footer('', $args);
?>
フッター側では以下のように記述し受け取った引数を表示します。
<?php echo $args['name']; ?>
この機能がWordPress5.5から追加され、開発やカスタマイズが格段に行いやすくなりました。
まとめ
今回の記事ではWordPressでフッターテンプレートを読み込む方法をご紹介しました。WordPressでWEB制作をする場合、必ず使用する関数なので、どんな機能があり、どのように使用するのか予め把握しておきたいですね。