• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「インクルードタグ」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Include Tags 2007年2月16日 (金) 00:34 Raddaqii 版)
 
(和訳/WP2.3 版)
1行目: 1行目:
The Template '''include tags''' are used within one [[Templates|Template]] file (for example <tt>index.php</tt>) to execute the [[Glossary#HTML|HTML]] and [[Glossary#PHP|PHP]] found in another template file (for example <tt>header.php</tt>).  [http://www.php.net PHP] has a built in [http://us3.php.net/manual/en/function.include.php include()] statement for this purpose, but these WordPress template tags make including certain specific files much easier.
+
{{テーマ・テンプレートガイド|テンプレート}}
 +
テンプレート'''インクルードタグ'''は、ある[[テンプレート]]ファイル(例えば <code>index.php</code>)の中で、他のテンプレートファイル(例えば <code>header.php</code>)の [[用語集#HTML|HTML]] [[用語集#PHP|PHP]] を実行するために使います。[http://www.php.net PHP] にはこの用途の <code>[http://jp.php.net/manual/ja/function.include.php include()]</code> 文がありますが、以下の WordPress テンプレートタグを使えば、より簡単に特定のファイルを読み込めます。
  
See [[Using Themes]] and [[Theme Development]] for more information about Templates and Themes.
+
テンプレートとテーマについてのさらなる情報は、[[:ja:Using Themes|テーマの使い方]] ならびに [[テーマの作成]] をご覧ください。インクルードタグを用いて一つのウェブページを構成する仕組みについては、[[テンプレート入門]]で説明しています。
  
== The Header Template ==
+
<div id="The_Header_Template">
 +
== ヘッダテンプレート ==
 +
</div>
  
  &lt;?php get_header(); ?>
+
  <?php get_header(); ?>
  
This tag includes the file <tt>header.php</tt> from your current theme's directory.  If that file is not found, it will instead include <tt>wp-content/themes/default/header.php</tt>.
+
このタグは、現在のテーマディレクトリから <code>header.php</code> ファイルを読み込みます。このファイルがないときは、代わりに <code>wp-content/themes/default/header.php</code> を読み込みます。
  
== The Footer Template ==
+
<div id="The_Footer_Template">
 +
== フッタテンプレート ==
 +
</div>
  
  &lt;?php get_footer(); ?>
+
  <?php get_footer(); ?>
  
This tag includes the file <tt>footer.php</tt> from your current theme's directory.  If that file is not found, it will instead include <tt>wp-content/themes/default/footer.php</tt>.
+
このタグは、現在のテーマディレクトリから <code>footer.php</code> ファイルを読み込みます。このファイルが無いときは、代わりに <code>wp-content/themes/default/footer.php</code> を読み込みます。
  
== The Sidebar Template ==
+
<div id="The_Sidebar_Template">
 +
== サイドバーテンプレート ==
 +
</div>
  
 
  <?php get_sidebar(); ?>
 
  <?php get_sidebar(); ?>
  
This tag includes the file <tt>sidebar.php</tt> from your current theme's directory.  If that file is not found, it will instead include <tt>wp-content/themes/default/sidebar.php</tt>.
+
このタグは、現在のテーマディレクトリから <code>sidebar.php</code> ファイルを読み込みます。このファイルが無いときは、代わりに <code>wp-content/themes/default/sidebar.php</code> を読み込みます。
  
<?php get_sidebar('right'); ?>
+
<div id="The_Comments_Template">
 +
== コメントテンプレート ==
 +
</div>
  
Causes the template <code>TEMPLATEPATH . 'sidebar-right.php'</code> to be included.  Note: the ability to specify a particular sidebar, meaning more than one sidebar template can be used in a theme, was added with [[Version 2.5]].
+
<?php comments_template(); ?>
  
== The Comments Template ==
+
このタグは、現在のテーマディレクトリから <code>comments.php</code> ファイルを読み込みます。このファイルが無いときは、代わりに <code>wp-content/themes/default/comments.php</code> を読み込みます。メインインデックスページやアーカイブページにコメントを表示するには、このタグを呼ぶ前に、変数 <code>$withcomments</code> に <code>"1"</code> をセットする必要があります。
  
&lt;?php comments_template(); ?>
+
<div id="Including_Any_Template">
 +
== その他のテンプレートの読み込み ==
 +
</div>
  
This tag includes the file <tt>comments.php</tt> from your current theme's directory. If that file is not found, it will instead include <tt>wp-content/themes/default/comments.php</tt>.  To display comments on the main index or archive pages, you'll need to set the <tt>$withcomments</tt> variable to <tt>"1"</tt> before calling this tag.
+
WordPress には、これらの特定の[[テンプレート]]を読み込むために上記のタグがありますが、''どのようなファイルでも''読み込める便利な方法もあります。それには、[[用語集#PHP|PHP]] の <code>[http://jp.php.net/manual/ja/function.include.php include]</code> 文と、誰にでも簡単に使えるよう WordPress で定義されている定数 <code>TEMPLATEPATH</code> を使います。
  
== Including Any Template ==
+
仮に <code>header2.php</code> というファイルを読み込みたいとしましょう。このファイルの内容を表示したいテンプレートの中に、次の行を挿入するだけです。
  
WordPress offers the above tags for including those specific [[Templates]], but there is also a convenient way to include ''any'' file. To do so, you will need to use the <tt>[http://us2.php.net/manual/en/function.include.php include]</tt> [[Glossary#PHP|PHP]] function, and a constant WordPress conveniently defines for you to make things easy: <tt>TEMPLATEPATH</tt>.
+
  <?php include (TEMPLATEPATH . '/header2.php'); ?>
  
Suppose you want to include a file called <tt>header2.php</tt>.  Just insert the following line in your template where you want that file's information to appear.
+
これは例えば、<code>[[#ヘッダテンプレート|get_header()]]</code> で読み込まれる通常の <code>header.php</code> の替わりに、別のヘッダを読み込む手段として使えます。
 +
他の用例と説明が[[テンプレート入門#Template Files Within Template Files|テンプレート入門]]にあります。
  
&lt;?php include (TEMPLATEPATH . '/header2.php'); ?>
+
'''注''': <code>TEMPLATEPATH</code> は、現在のテーマディレクトリへの絶対パスへの参照です(末尾の <code>/</code> を除く)。ファイルの読み込みではなく URI参照についての情報であれば、[[テーマの作成#Referencing Files From a Template|テンプレートからのファイルの参照]]をご覧ください。
  
You could, for example, use this as a means of including a different header instead of the normal <tt>header.php</tt> which would be included with <tt>[[#The Header Template|get_header()]]</tt>.
+
<div id="Example">
 +
== 用例 ==
 +
</div>
  
'''NOTE''': <tt>TEMPLATEPATH</tt> is a reference to the absolute path to the current theme directory (without the / at the end).  For information on referencing URIs rather than including files, see [[Theme Development#Referencing Files From a Template|Referencing Files From a Template]].
+
次に示すのは、''極めて''簡素な "HTTP 404: Not Found" エラー用テンプレートの例です(<code>404.php</code> として[[テーマの作成|テーマ]]に加えます)。
  
== Example ==
+
<pre>
 +
<?php get_header(); ?>
 +
<h2>Error 404 - Not Found</h2>
 +
<?php get_sidebar(); ?>
 +
<?php get_footer(); ?>
 +
</pre>
  
The following is a ''very'' simple example of a template for an "HTTP 404: Not Found" error (which you could include in your [[Theme Development|Theme]] as <tt>404.php</tt>).
+
{{原文|Include Tags}}
  
&lt;?php get_header(); ?>
 
&lt;h2>Error 404 - Not Found</h2>
 
&lt;?php get_sidebar(); ?>
 
&lt;?php get_footer(); ?>
 
 
== Parameters ==
 
 
These tags do not accept any parameters.
 
 
<!-- == Related ==
 
 
{{Tag General Tags}}
 
 
{{No Param Tag Footer}}
 
-->
 
 
{{No Param Tag Footer}}
 
{{No Param Tag Footer}}
[[Category:Design and Layout]]
+
{{DEFAULTSORT:いんくるうとたく}}
 +
[[Category:デザインとレイアウト]]

2008年3月8日 (土) 19:15時点における版

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

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

<?php get_header(); ?>

このタグは、現在のテーマディレクトリから header.php ファイルを読み込みます。このファイルがないときは、代わりに wp-content/themes/default/header.php を読み込みます。

<?php get_footer(); ?>

このタグは、現在のテーマディレクトリから footer.php ファイルを読み込みます。このファイルが無いときは、代わりに wp-content/themes/default/footer.php を読み込みます。

サイドバーテンプレート

<?php get_sidebar(); ?>

このタグは、現在のテーマディレクトリから sidebar.php ファイルを読み込みます。このファイルが無いときは、代わりに wp-content/themes/default/sidebar.php を読み込みます。

コメントテンプレート

<?php comments_template(); ?>

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

その他のテンプレートの読み込み

WordPress には、これらの特定のテンプレートを読み込むために上記のタグがありますが、どのようなファイルでも読み込める便利な方法もあります。それには、PHPinclude 文と、誰にでも簡単に使えるよう WordPress で定義されている定数 TEMPLATEPATH を使います。

仮に header2.php というファイルを読み込みたいとしましょう。このファイルの内容を表示したいテンプレートの中に、次の行を挿入するだけです。

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

これは例えば、get_header() で読み込まれる通常の header.php の替わりに、別のヘッダを読み込む手段として使えます。 他の用例と説明がテンプレート入門にあります。

TEMPLATEPATH は、現在のテーマディレクトリへの絶対パスへの参照です(末尾の / を除く)。ファイルの読み込みではなく URI参照についての情報であれば、テンプレートからのファイルの参照をご覧ください。

用例

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

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

最新英語版: WordPress Codex » Include Tags


関数リファレンステンプレートタグ目次もご覧ください。