当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

インクルードタグ

提供: WordPress Codex 日本語版
2013年1月15日 (火) 16:49時点におけるGatespace (トーク | 投稿記録)による版 (20:37, 21 January 2011 英語版を反映させました。一部未翻訳です。)

移動先: 案内検索


このページは最新情報に追随して更新されていません。英語版のテーマハンドブックコードリファレンスをご確認ください。翻訳にご協力くださる方はぜひご相談ください


このページ「インクルードタグ」は一部未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

テンプレートインクルードタグは、あるテンプレートファイル(例えば index.php)の中で、他のテンプレートファイル(例えば header.php)の HTMLPHP を実行するために使います。PHP にはこの用途の include() 文がありますが、以下の WordPress テンプレートタグを使えば、より簡単に特定のファイルを読み込めます。

テンプレートとテーマについてのさらなる情報は、テーマの使い方 ならびに テーマの作成 をご覧ください。インクルードタグを用いて一つのウェブページを構成する仕組みについては、テンプレート入門で説明しています。

Include Generic Files
Include Other Components



ヘッダテンプレート

<?php get_header(); ?>

get_header() タグは、現在のテーマディレクトリから header.php または header-{name}.php ファイルを読み込みます。 このファイルがないときは、代わりに wp-includes/theme-compat/header.php を読み込みます。

<?php get_footer(); ?>

get_footer() タグは、現在のテーマディレクトリから footer.php または footer-{name}.php ファイルを読み込みます。このファイルが無いときは、代わりに wp-includes/theme-compat/footer.php を読み込みます。

サイドバーテンプレート

<?php get_sidebar(); ?>

get_sidebar() タグは、現在のテーマディレクトリから sidebar.php または sidebar-{name}.php ファイルを読み込みます。このファイルが無いときは、代わりに wp-includes/theme-compat/sidebar.php を読み込みます。

Custom Template files

<?php get_template_part(); ?>

get_template_part() タグは、現在のテーマディレクトリから、ヘッダー、サイドバー、フッター以外のテンプレートパーツ {slug}.php または {slug}-{name}.php ファイルを読み込みます。

The Search Form Template

<?php get_search_form(); ?>

The get_search_form() タグは、現在のテーマディレクトリから searchform.php ファイルを読み込みます。このファイルが無いときは、代わりに検索フォームが生成されます。

詳しくは get_search_form および Migrating Plugins and Themes to 2.7 を参照してください。

コメントテンプレート

<?php comments_template(); ?>

このタグは、現在のテーマディレクトリから comments.php ファイルを読み込みます。このファイルが無いときは、代わりに wp-includes/theme-compat/comments.php を読み込みます。メインインデックスページやアーカイブページにコメントを表示するには、このタグを呼ぶ前に、変数 $withcomments"1" をセットする必要があります。

用例

次に示すのは、極めて簡素な "HTTP 404: Not Found" エラー用テンプレートの例です(404.php としてテーマに加えます)。

<?php get_header(); ?>
<?php get_template_part('nav'); ?>
<h2>Error 404 - Not Found</h2>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

パラメータ

get_header(), get_footer() and get_sidebar() は1つのパラメーターを受け取ります:

$name
文字列) (オプション) sidebar-{name}.php を読み込む。例: sidebar-right.php, header-single.php あるいは footer-8.php.
初期値: なし

get_template_part() は2つのパラメーターを受け取ります:

$slug
文字列) (必須) {slug}.php を読み込む。例: nav.php
初期値: なし
$name
文字列) (オプション) {slug}-{name}.php を読み込む。例: nav-home.php
初期値: なし

変更履歴

ソースコード

wp-includes/general-template.php

最新英語版: WordPress Codex » Include Tags最新版との差分


テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。