1. テーマ
  2. インクルードタグとは

インクルードタグとは

2016/7/19

インクルードタグは、あるテンプレートファイルの中で他のテンプレートファイルを読み込むために使います。サイトのヘッダーやフッター、サイドバーを表示させるために、ほとんどのテーマの中で記述されています。

インクルードタグとは

WordPressのテーマは、ページの種類に応じて表示されるテンプレートファイルが異なります。例えば、いまご覧いただいているこの記事(投稿ページ)は、テーマの中にある「single.php」というテンプレートファイルによって表示されています。

さて、このページの中には、記事の内容の他にも「ヘッダー」や「フッター」、「サイドバー」が表示されていますよね?これらのメインコンテンツ以外の部分は、「single.php」の中にインクルードタグが記述されていることによって出力されています。

インクルードタグ

上の図は、「single.php」が出力されるときに、「header.php」「footer.php」「sidebar.php」が読み込まれる様子を示しています。このとき、「single.php」の中には、下記のインクルードタグが記述されています。

  • <?php get_header(); ?>
  • <?php get_footer(); ?>
  • <?php get_sidebar(); ?>

このように、テンプレートファイルの中にたった3行のインクルードタグを該当箇所に追加するだけで、「ヘッダー」や「フッター」、「サイドバー」が表示されるわけです。

インクルードタグの種類

インクルード(テンプレートファイルの結合)を実現するための記述には、「Wordpress独自のテンプレートタグ」を記述する方法と、「PHPのinclude文」を使う方法とがあります。

WordPress テンプレートタグによるインクルード

先程の例で示した「ヘッダー」や「フッター」、「サイドバー」のように、よく使われる特定のインクルードに対しては、WordPressのテンプレートタグを使って記述できます。

<?php get_header(); ?>: ヘッダー部分(header.php)を読み込む
<?php get_footer(); ?> フッター部分(footer.php)を読み込む
<?php get_sidebar(); ?> サイドバー部分(sidebar.php)を読み込む
<?php get_search_form(); ?> 検索フォーム(searchform.php)を読み込む
<?php comments_template(); ?> コメントテンプレート(comments.php)を読み込む

サイドバーテンプレートのファイル名指定

WordPress 2.5 以上では、サイドバーの読み込みに対してテンプレートファイル名を指定することができます。例えば、「sidebar-sample.php」というファイルを読み込むには、インクルードタグを下記のように記述します。

<?php get_sidebar('sample'); ?>

PHPのinclude文によるインクルード

上記以外のテンプレートファイルを読み込むには、PHPの「include文」を記述します。また、このinclude文の中に、WordPressで定義されている定数「TEMPLATEPATH」を含ませます。

例えば、サイト内の各ページに「サイト情報」を表示させたいとしましょう。このとき、サイト情報を「info.php」というファイルで作成するとします。このファイルを読み込むには、表示させたいページのテンプレートファイル内(例えば、メインページの「home.php」や個別記事の「single.php」など)に、次の記述を追加します。

<?php include( TEMPLATEPATH . '/info.php' ); ?>

この方法を使えば、表示させたい内容を表示させたいページだけに出力することができるので、カスタマイズの幅がグンと広がります。なお、表示させるページを決定するときには、テンプレート階層(テンプレートファイル出力の優先順位)を考慮するのを忘れないように注意してください。


今回ご紹介したインクルードタグについては、下記ページがとても参考になります。

おすすめの書籍

小さなお店&会社の WordPress超入門

WordPressでビジネスサイトを作るために必要な、基本的な知識が理解できる“超”入門書。Web制作に必要なHTML・CSS・PHPなどの専門知識がなくても読み進められる1冊です。SEO(検索エンジン最適化)やセキュリティの対策についても解説されています。

おすすめのテーマ

WordPressテーマ「NEXTAGE (tcd021)」

WordPressテーマ「LAW」

コーポレートサイト(企業サイト)向けのテーマ。第一印象で信頼性や専門性を的確にアピールし、Webサイトのゴールである「お問い合わせ」まで自然に繋がっていく“導線”にこだわったテンプレートです。

カテゴリー

ビジネスサイトを作りたいあなたに

おすすめのテーマ、あります。