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

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

「テンプレートタグ」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(Tag tags追加、冒頭訳/the_author_icq, the_author_msn, the_search_query は保留)
(一覧を表形式にしてみるテスト/原文・Wptags.comへのリンクも追加)
14行目: 14行目:
 
* [[WordPress サイトデザイン リファレンス]] (テーマ・テンプレート・タグに関する総覧)
 
* [[WordPress サイトデザイン リファレンス]] (テーマ・テンプレート・タグに関する総覧)
  
'''注:''' 各テンプレートタグの使い方を工夫したら、他の WordPress ユーザのために、ぜひそのタグのページに用例として書き込んでください!
+
'''注:''' 各テンプレートタグの使い方を工夫したら、他の WordPress ユーザのために、ぜひそのタグのページに用例として書き込んでください。
  
'''注: いくつかのタグは、WordPress の特定のバージョンから新規追加(以下の一覧に "Version 2.1" のように注記)。いくつかのタグは、version 2.0.x で非推奨(以下に "非推奨" と注記)。いくつかのタグは、2.1 から非推奨(以下に "2.1 から非推奨" と注記)。'''  
+
'''注: いくつかのタグは、WordPress の特定のバージョンから新規追加(以下の一覧に "Version 2.1" のように注記)。いくつかのタグは、version 2.0.x で非推奨(以下に "非推奨" と注記)。いくつかのタグは、2.1 から非推奨(以下に "2.1 から非推奨" と注記)。''' 詳しくは [[プラグインとテーマの 2.1 への移行]] を参照。
 
+
* [[プラグインとテーマの 2.1 への移行]] (2.1 から非推奨となったタグと後継タグのリスト)
+
  
 
{{refWPDS}}
 
{{refWPDS}}
 
以下、各タグの概要の書き添え方を模索中。素直に表形式にした方が見やすいか…。
 
  
 
<div id="Author_tags">
 
<div id="Author_tags">
28行目: 24行目:
 
</div>
 
</div>
  
; [[/the_author | the_author]]
+
{| class="list"
; [[/the_author_description | the_author_description]]
+
! タグ名 !! status !! 概要 !! ループ !! パラメータ !! リンク
; [[/the_author_login | the_author_login]]
+
|-
; [[/the_author_firstname | the_author_firstname]]
+
! [[/the_author | the_author]]
; [[/the_author_lastname | the_author_lastname]]
+
| <!--s--> || 現在の記事の著者を表示 || ループ中 || 非推奨? || {{TagLink|the_author|t}}
; [[/the_author_nickname | the_author_nickname]]
+
|-
; [[/the_author_ID | the_author_ID]]
+
! [[/the_author_description | the_author_description]]
; [[/the_author_email | the_author_email]]
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_description|t}}
; [[/the_author_url | the_author_url]]
+
|-
; [[/the_author_link | the_author_link]] (Version 2.1)
+
! [[/the_author_login | the_author_login]]
; [[/the_author_icq | the_author_icq]]
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_login|t}}
; [[/the_author_aim | the_author_aim]]
+
|-
; [[/the_author_yim | the_author_yim]]
+
! [[/the_author_firstname | the_author_firstname]]
; [[/the_author_msn | the_author_msn]]
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_firstname|t}}
; [[/the_author_posts | the_author_posts]]
+
|-
; [[/the_author_posts_link | the_author_posts_link]]
+
! [[/the_author_lastname | the_author_lastname]]
; [[/list_authors | list_authors]] (非推奨)
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_lastname|t}}
; [[/wp_list_authors | wp_list_authors]]
+
|-
 +
! [[/the_author_nickname | the_author_nickname]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_nickname|t}}
 +
|-
 +
! [[/the_author_ID | the_author_ID]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_ID|t}}
 +
|-
 +
! [[/the_author_email | the_author_email]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_email|t}}
 +
|-
 +
! [[/the_author_url | the_author_url]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_url|t}}
 +
|-
 +
! [[/the_author_link | the_author_link]]
 +
| 2.1↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_link}}
 +
|-
 +
! [[/the_author_icq | the_author_icq]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_icq|t}}
 +
|-
 +
! [[/the_author_aim | the_author_aim]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_aim|t}}
 +
|-
 +
! [[/the_author_yim | the_author_yim]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_yim|t}}
 +
|-
 +
! [[/the_author_msn | the_author_msn]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_msn|t}}
 +
|-
 +
! [[/the_author_posts | the_author_posts]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_posts|t}}
 +
|-
 +
! [[/the_author_posts_link | the_author_posts_link]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_author_posts_link|t}}
 +
|-
 +
! [[/list_authors | list_authors]]
 +
| 非推奨 || <!--概--> || <!--l--> || <!--p--> || {{TagLink|list_authors|t}}
 +
|-
 +
! [[/wp_list_authors | wp_list_authors]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_list_authors|t}}
 +
|}
  
 
<div id="Category_tags">
 
<div id="Category_tags">
51行目: 86行目:
 
</div>
 
</div>
  
; [[/the_category | the_category]]  
+
{| class="list"
: 現在の記事の全カテゴリを、そのカテゴリアーカイブへのリンク付きで表示。ループ中で使用。
+
! タグ名 !! status !! 概要 !! ループ !! パラメータ !! リンク
: パラメータ: 区切り文字、親カテゴリを併記するか
+
|-
; [[/the_category_rss | the_category_rss]]  
+
! [[/the_category|the_category]]
: RSS で使用
+
|  || 現在の記事の全カテゴリを、そのカテゴリアーカイブへのリンク付きで表示 || ループ中 || 区切り文字、親カテゴリの併記 || {{TagLink|the_category|t}}
; [[/the_category_ID | the_category_ID]] (非推奨)
+
|-
; [[/the_category_head | the_category_head]] (非推奨)
+
! [[/the_category_rss|the_category_rss]]
; [[/single_cat_title | single_cat_title]]
+
| <!--s--> || (RSS で使用) || <!--l--> || <!--p--> || {{TagLink|the_category_rss|t}}
; [[/category_description | category_description]]  
+
|-
: パラメータで指定したカテゴリの概要(カテゴリ管理画面で入力したもの)を取得。echo で表示。
+
! [[/the_category_ID|the_category_ID]]
; [[/wp_dropdown_categories | wp_dropdown_categories]] (Version 2.1)
+
| 非推奨 || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_category_ID|t}}
: セレクトボックス(ドロップダウンメニューなど)を使ったカテゴリリストを表示/値として取得
+
|-
; [[/dropdown_cats | dropdown_cats]] (2.1 から非推奨)
+
! [[/the_category_head|the_category_head]]
; [[/wp_list_categories | wp_list_categories]] (Version 2.1)
+
| 非推奨 || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_category_head|t}}
: リンク付きカテゴリリストを表示
+
|-
; [[/list_cats | list_cats]] (2.1 から非推奨)
+
! [[/single_cat_title|single_cat_title]]
: 機能は <tt>wp_list_cats</tt> と同様で、パラメータの書き方が異なる。こちらが古そう。2.0.x 系の EasyAll テーマで使用。
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|single_cat_title|t}}
: → <tt>wp_list_categories</tt>
+
|-
; [[/wp_list_cats | wp_list_cats]] (2.1 から非推奨)
+
! [[/category_description|category_description]]  
: リンク付きカテゴリリストを表示。そのリンクをクリックすると、当該カテゴリに属する全記事を [[:ja:Template_Hierarchy|テンプレート優先順位]] に従ったカテゴリ・テンプレートを用いて表示。2.0.x 系のデフォルトテーマで使用。
+
| <!--s--> || 指定したカテゴリの概要を取得 || <!--l--> || カテゴリID || {{TagLink|category_description|t}}
: → <tt>wp_list_categories</tt>
+
|-
; [[/in_category | in_category]]  
+
! [[/wp_dropdown_categories|wp_dropdown_categories]]
: [[:ja:Conditional Tags|条件分岐タグ]]の一つ。現在の記事がパラメータで指定したカテゴリに属するとき true を返す。ループ中で使用。ループ外で使うときは [[/in category#Use_OUTSIDE_The_Loop|Use OUTSIDE The Loop]] 参照。
+
| 2.1↑ || セレクトボックス(ドロップダウンメニューなど)を使ったカテゴリリストを表示/取得 || - || 表示/取得、ソート順ほか多数 || {{TagLink|wp_dropdown_categories}}
; [[/get_category_parents | get_category_parents]]  
+
|-
: 現在の または 指定したカテゴリと、そこから最上位までの各カテゴリを取得。echo で表示。
+
! [[/dropdown_cats|dropdown_cats]]
; [[/get_the_category | get_the_category]]  
+
| 2.1 から非推奨 || <!--概--> || <!--l--> || <!--p--> || {{TagLink|dropdown_cats|t}}
: 現在の記事が属する各カテゴリの情報を取得。ループ中で使用。
+
|-
: カテゴリID・カテゴリ名・カテゴリスラッグ・カテゴリ概要・親カテゴリが配列に格納されるので、好きなように取り出して使う。
+
! [[/wp_list_categories|wp_list_categories]]
 +
| 2.1↑ || リンク付きカテゴリリストを表示 || - || ソート順ほか多数 || {{TagLink|wp_list_categories}}
 +
|-
 +
! [[/list_cats|list_cats]]
 +
| 2.1 から非推奨 || リンク付きカテゴリリストを表示。<code>wp_list_cats</code> とはパラメータの書き方が異なる。2.0.x 系の EasyAll テーマで使用<br />wp_list_categories || - || <!--p--> || {{TagLink|list_cats|t}}
 +
|-
 +
! [[/wp_list_cats|wp_list_cats]]
 +
| 2.1 から非推奨 || リンク付きカテゴリリストを表示。そのリンク先はカテゴリアーカイブページ。2.0.x 系のデフォルトテーマで使用<br />wp_list_categories || - || <!--p--> || {{TagLink|wp_list_cats|t}}
 +
|-
 +
! [[/in_category|in_category]]  
 +
| <!--s--> || [[:ja:Conditional Tags|条件分岐タグ]]:現在の記事がパラメータで指定したカテゴリに属するとき true を返す || ループ中/ [[/in_category#ループ外で使う|ループ外]] || カテゴリID || {{TagLink|in_category|t}}
 +
|-
 +
! [[/get_category_parents|get_category_parents]]  
 +
| <!--s--> || 現在の または 指定したカテゴリと、そこから最上位までの各カテゴリを取得 || - || <!--p--> || {{TagLink|get_category_parents|t}}
 +
|-
 +
! [[/get_the_category|get_the_category]]  
 +
| <!--s--> || 現在の記事が属する各カテゴリの情報を取得。カテゴリID・カテゴリ名・カテゴリスラッグ・カテゴリ概要・親カテゴリが配列に格納されるので、好きに取り出して使う。 || ループ中 || なし || {{TagLink|get_the_category|t}}
 +
|}
  
 
<div id="Comment_tags">
 
<div id="Comment_tags">
111行目: 163行目:
 
</div>
 
</div>
  
; [[/the_date_xml | the_date_xml]]
+
{| class="list"
; [[/the_date | the_date]]  
+
! タグ名 !! status !! 概要 !! ループ !! パラメータ !! リンク
: 現在の記事の投稿日時を表示 or 取得。ループ中で使用。
+
|-
: 1ページに同一投稿日の記事があれば、その'''最初の記事にのみ表示'''。全ての記事にも表示したいときは <tt>the_time</tt> を使用。
+
! [[/the_date_xml | the_date_xml]]
: パラメータ: 日時フォーマット、前後の文字、表示/取得<br />フォーマットを指定しなければ、管理画面 > オプション > 一般設定 - 日付のフォーマット で設定したフォーマット。
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_date_xml|t}}
; [[/the_time | the_time]]  
+
|-
: 現在の記事の投稿日時を表示。ループ中で使用。
+
! [[/the_date | the_date]]
: パラメータ: 日時フォーマット<br />指定しなければ、管理画面 > オプション > 一般設定 - 時間のフォーマット で設定したフォーマット。
+
| <!--s--> || 現在の記事の投稿日時を表示/取得。フォーマットを指定しなければ一般設定「日付のフォーマット」で表示。1ページに同一投稿日の記事があれば、その'''最初の記事にのみ表示'''。全記事に表示するには <tt>the_time</tt> || ループ中 || 日時フォーマット、前後の文字、表示/取得<br /> || {{TagLink|the_date|t}}
; [[/the_modified_date | the_modified_date]] (Version 2.1)
+
|-
; [[/the_modified_time | the_modified_time]]
+
! [[/the_time | the_time]]
; [[/get_the_time | get_the_time]] (Version 1.5)
+
| <!--s--> || 現在の記事の投稿日時を表示。フォーマットを指定しなければ一般設定「時間のフォーマット」で表示。 || ループ中 || 日時フォーマット || {{TagLink|the_time|t}}
; [[/single_month_title | single_month_title]]
+
|-
; [[/get_calendar | get_calendar]]
+
! [[/the_modified_date | the_modified_date]]
; [[/the_weekday | the_weekday]]  
+
| 2.1↑ || 現在の記事の最終更新日時を表示。次項との違いは何? || ループ中 || 日時フォーマット || {{TagLink|the_modified_date}}
; [[/the_weekday_date | the_weekday_date]]  
+
|-
 +
! [[/the_modified_time | the_modified_time]]
 +
| <!--s--> || 現在の記事の最終更新日時を表示。前項との違いは何? || ループ中 || 日時フォーマット || {{TagLink|the_modified_time}}
 +
|-
 +
! [[/get_the_time | get_the_time]]
 +
| 1.5↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|get_the_time|t}}
 +
|-
 +
! [[/single_month_title | single_month_title]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|single_month_title|t}}
 +
|-
 +
! [[/get_calendar | get_calendar]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|get_calendar}}
 +
|-
 +
! [[/the_weekday | the_weekday]]  
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_weekday|t}}
 +
|-
 +
! [[/the_weekday_date | the_weekday_date]]  
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_weekday_date|t}}
 +
|}
  
 
<div id="General_tags">
 
<div id="General_tags">
131行目: 201行目:
 
</div>
 
</div>
  
; [[/bloginfo | bloginfo]]  
+
{| class="list"
: 設置した WordPress の各種情報(主に管理画面の一般設定やユーザープロフィールの項目)を表示。テンプレートのどこでも使える。sidebar.php や header.php でよく使われているので参考に。
+
! タグ名 !! status !! 概要 !! ループ !! パラメータ !! リンク
: パラメータ: 表示したい項目を指定。ブログ名、URI、RSS、文字コード、設置ディレクトリURI、ほか
+
|-
: 値を''取得''したいときは <tt>get_bloginfo</tt> を使用。
+
! [[/bloginfo | bloginfo]]
; [[/bloginfo_rss | bloginfo_rss]]
+
| <!--s--> || 設置した WordPress の各種情報(主に管理画面の一般設定やユーザープロフィールの項目)を'''表示'''。値を''取得''するには <code>get_bloginfo</code>。sidebar.php や header.php でよく使われる。 || - || 表示したい項目(ブログ名、URI、RSS、文字コード、設置ディレクトリURI、ほか) || {{TagLink|bloginfo|t}}
; [[/get_bloginfo | get_bloginfo]]  
+
|-
: <tt>bloginfo</tt> と同様の項目の値を取得。PHP のどこでも使える。
+
! [[/bloginfo_rss | bloginfo_rss]]
; [[/get_bloginfo_rss | get_bloginfo_rss]]
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|bloginfo_rss|t}}
; [[/wp_title | wp_title]]
+
|-
; [[/wp_get_archives | wp_get_archives]]  
+
! [[/get_bloginfo | get_bloginfo]]  
: 月別アーカイブリスト等、日付に基づくリンク付きアーカイブリストを表示。テンプレートのどこでも使える(サイドバーに限らない)。月・日・週別のほか、最近の投稿 n件のリストも可能。
+
| <!--s--> || <code>bloginfo</code> と同様の項目の値を'''取得''' || - || 取得したい項目(ブログ名、URI、RSS、文字コード、設置ディレクトリURI、ほか) || {{TagLink|get_bloginfo|t}}
: パラメータ: 種別、件数、リスト形式、前後の文字、記事数の表示
+
|-
; [[/get_archives | get_archives]] (2.1 から非推奨)
+
! [[/get_bloginfo_rss | get_bloginfo_rss]]
; [[/get_calendar | get_calendar]]
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|get_bloginfo_rss|t}}
; [[/get_posts | get_posts]]  
+
|-
: マルチループ(複数ループ)の作成に使用。
+
! [[/wp_title | wp_title]]
: 参照: [http://bono.s201.xrea.com/2007/04/394-wp_get_posts/ power source* » WP: テンプレートタグ get_posts で新着記事リスト等を表示]
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_title|t}}
; [[/wp_list_pages | wp_list_pages]] (Version 1.5)
+
|-
: 「ページ」一覧を表示
+
! [[/wp_get_archives | wp_get_archives]]  
: パラメータ: ソート順、除外/表示ページ、表示階層の深さ、サブページ指定、日付表示、リストの見出し有無、表示/取得
+
| <!--s--> || 月別アーカイブリスト等、日付に基づくリンク付きアーカイブリストを表示。月別・日別・週別、最近の投稿 n件 || - || 種別、件数、リスト形式、前後の文字、記事数の表示 || {{TagLink|wp_get_archives|t}}
; [[/wp_dropdown_pages | wp_dropdown_pages]]  
+
|-
; [[/wp_loginout | wp_loginout]] (Version 1.5)
+
! [[/get_archives | get_archives]]
; [[/wp_register | wp_register]] (Version 1.5)
+
| 2.1 から非推奨 || <!--概--> || <!--l--> || <!--p--> || {{TagLink|get_archives|t}}
; [[/query_posts | query_posts]] (Version 1.5)
+
|-
; [[/rss_enclosure | rss_enclosure]] (Version 1.5)
+
! [[/get_calendar | get_calendar]]
; [[/wp_tag_cloud | wp_tag_cloud]] (Version 2.3)
+
| <!--s--> || カレンダーを表示 || - || <!--p--> || {{TagLink|get_calendar|t}}
 +
|-
 +
! [[/get_posts | get_posts]]  
 +
| <!--s--> || マルチループ(複数ループ)作成時の条件指定 || <!--l--> || <!--p--> || {{TagLink|get_posts|t}}
 +
|-
 +
! [[/wp_list_pages | wp_list_pages]]
 +
| 1.5↑ || [[:ja:Pages|「ページ」]]一覧を表示/取得 || - || 表示/取得、ソート順、除外/表示ページ、表示階層の深さ、サブページ指定、日付表示、見出し有無 || {{TagLink|wp_list_pages|t}}
 +
|-
 +
! [[/wp_dropdown_pages | wp_dropdown_pages]]  
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_dropdown_pages}}
 +
|-
 +
! [[/wp_loginout | wp_loginout]]
 +
| 1.5↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_loginout|t}}
 +
|-
 +
! [[/wp_register | wp_register]]
 +
| 1.5↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_register|t}}
 +
|-
 +
! [[/query_posts | query_posts]]
 +
| 1.5↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|query_posts|t}}
 +
|-
 +
! [[/rss_enclosure | rss_enclosure]]
 +
| 1.5↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|rss_enclosure|t}}
 +
|-
 +
! [[/wp_tag_cloud | wp_tag_cloud]]
 +
| 2.3↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_tag_cloud}}
 +
|}
  
 
<div id="Geo_tags">
 
<div id="Geo_tags">
181行目: 276行目:
 
</div>
 
</div>
  
; [[/edit_post_link | edit_post_link]]
+
{| class="list"
; [[/edit_comment_link | edit_comment_link]]
+
! タグ名 !! status !! 概要 !! ループ !! パラメータ !! リンク
; [[/wp_link_pages | wp_link_pages]]
+
|-
; [[/link_pages | link_pages]] (2.1から非推奨)
+
! [[/edit_post_link | edit_post_link]]
; [[/get_year_link | get_year_link]]
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|edit_post_link|t}}
; [[/get_month_link | get_month_link]]
+
|-
; [[/get_day_link | get_day_link]]
+
! [[/edit_comment_link | edit_comment_link]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|edit_comment_link|t}}
 +
|-
 +
! [[/wp_link_pages | wp_link_pages]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_link_pages|t}}
 +
|-
 +
! [[/link_pages | link_pages]]
 +
| 2.1から非推奨 || <!--概--> || <!--l--> || <!--p--> || {{TagLink|link_pages|t}}
 +
|-
 +
! [[/get_year_link | get_year_link]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|get_year_link|t}}
 +
|-
 +
! [[/get_month_link | get_month_link]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|get_month_link|t}}
 +
|-
 +
! [[/get_day_link | get_day_link]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|get_day_link|t}}
 +
|}
  
 
<div id="Links_Manager_tags">
 
<div id="Links_Manager_tags">
193行目: 305行目:
 
</div>
 
</div>
  
; [[/get_links_list | get_links_list]]  
+
{| class="list"
: 管理画面 > リンク で「表示:はい」になっている全てのリンクを、カテゴリ順に表示する。リンクカテゴリ画面の「カテゴリー設定」は有効だが、「フォーマット」は無視される。
+
! タグ名 !! status !! 概要 !! ループ !! パラメータ !! リンク
: パラメータ: ソート順(カテゴリ名順/カテゴリID順。昇順/降順はアンダーバーで)  
+
|-
; [[/wp_get_links | wp_get_links]]  
+
! [[/get_links_list | get_links_list]]  
: パラメータで指定したカテゴリIDに属するリンクを表示。各リンクはカテゴリの「フォーマット」で設定したタグで括られるので、もしそれが <tt>&lt;li&gt;</tt> タグなら、<tt>&lt;ul&gt;</tt> タグや見出しの追加が必要。
+
| <!--s--> || リンク管理画面で「表示:はい」になっている全てのリンクを、カテゴリ順に表示する。リンクカテゴリ画面の「カテゴリー設定」は有効だが「フォーマット」は無視される。 || <!--l--> || ソート順(カテゴリ名順/カテゴリID順。昇順/降順はアンダーバーで) || {{TagLink|get_links_list|t}}
; [[/get_links | get_links]]
+
|-
; [[/wp_list_bookmarks | wp_list_bookmarks]] (Version 2.1)
+
! [[/wp_get_links | wp_get_links]]  
: ブックマーク(ブログロール)一覧を表示/値として返す。
+
| <!--s--> || パラメータで指定したカテゴリIDに属するリンクを表示。各リンクはカテゴリの「フォーマット」で設定したタグで括られるので、もしそれが <code><nowiki><li></nowiki></code> タグなら、<code><nowiki><ul></nowiki></code> タグや見出しの追加が必要。 || <!--l--> || <!--p--> || {{TagLink|wp_get_links|t}}
: パラメータ: ソート順ほか多数
+
|-
; [[/wp_get_linksbyname | wp_get_linksbyname]] (2.1 から非推奨)
+
! [[/get_links | get_links]]
: 全カテゴリまたは指定したカテゴリのリンクを、パラメータの条件に従って表示。
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|get_links|t}}
; [[/get_linksbyname | get_linksbyname]] (2.1 から非推奨)
+
|-
 +
! [[/wp_list_bookmarks | wp_list_bookmarks]]
 +
| 2.1↑ || ブックマーク(ブログロール)一覧を表示/取得 || <!--l--> || 表示/取得、ソート順ほか多数 || {{TagLink|wp_list_bookmarks}}
 +
|-
 +
! [[/wp_get_linksbyname | wp_get_linksbyname]]
 +
| 2.1 から非推奨 || 全カテゴリまたは指定したカテゴリのリンクを、パラメータの条件に従って表示 || <!--l--> || <!--p--> || {{TagLink|wp_get_linksbyname|t}}
 +
|-
 +
! [[/get_linksbyname | get_linksbyname]]
 +
| 2.1 から非推奨 || <!--概--> || <!--l--> || <!--p--> || {{TagLink|get_linksbyname|t}}
 +
|}
  
 
<div id="Permalink_tags">
 
<div id="Permalink_tags">
210行目: 331行目:
 
</div>
 
</div>
  
; [[/permalink_anchor | permalink_anchor]]
+
{| class="list"
; [[/get_permalink | get_permalink]]  
+
! タグ名 !! status !! 概要 !! ループ !! パラメータ !! リンク
: パラメータで ID を指定した記事のパーマリンクURI を取得。echo で表示。ループ中でパラメータなしで使うと、現在の記事のパーマリンクURI を取得。
+
|-
; [[/the_permalink | the_permalink]]  
+
! [[/permalink_anchor | permalink_anchor]]
: 現在の記事のパーマリンクURI を表示。ループ中で使用。パラメータなし。
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|permalink_anchor|t}}
; [[/permalink_single_rss | permalink_single_rss]]
+
|-
 +
! [[/get_permalink | get_permalink]]  
 +
| <!--s--> || 指定した記事のパーマリンクURI を取得。ループ中でパラメータなしで使うと、現在の記事のパーマリンクURI を取得。 || <!--l--> || 記事ID || {{TagLink|get_permalink|t}}
 +
|-
 +
! [[/the_permalink | the_permalink]]  
 +
| <!--s--> || 現在の記事のパーマリンクURI を表示 || ループ中 || なし || {{TagLink|the_permalink|t}}
 +
|-
 +
! [[/permalink_single_rss | permalink_single_rss]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|permalink_single_rss|t}}
 +
|}
  
 
<div id="Post_tags">
 
<div id="Post_tags">
221行目: 351行目:
 
</div>
 
</div>
  
; [[/the_ID | the_ID]]
+
{| class="list"
; [[/the_title | the_title]]
+
! タグ名 !! status !! 概要 !! ループ !! パラメータ !! リンク
; [[/single_post_title | single_post_title]]
+
|-
; [[/the_title_rss | the_title_rss]]
+
! [[/the_ID | the_ID]]
; [[/the_content | the_content]]  
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_ID|t}}
: 現在の記事の本文を表示。ループ中で使用。記事中に &lt;!--more--&gt; がある場合、単体記事ページ(パーマリンクページ)以外では、それより前の部分を表示し「続きを読む」リンクを添える。
+
|-
: パラメータ: 「続きを読む」の文言、strip_teaser はよく分からない…。
+
! [[/the_title | the_title]]
; [[/the_content_rss | the_content_rss]]
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_title|t}}
; [[/the_excerpt | the_excerpt]]  
+
|-
: 現在の記事の抜粋を表示。「抜粋表示オプション」が空なら最初の120語を出力。HTMLタグや画像は除外。ループ中で使用。パラメータなし。
+
! [[/single_post_title | single_post_title]]
: 抜粋されずに長文となってしまう場合、[[日本語・マルチバイト特有の問題]]を参照。
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|single_post_title|t}}
; [[/the_excerpt_rss | the_excerpt_rss]]
+
|-
; [[/previous_post_link | previous_post_link]]
+
! [[/the_title_rss | the_title_rss]]
; [[/previous_post | previous_post]] (非推奨)
+
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_title_rss|t}}
; [[/next_post_link | next_post_link]]
+
|-
; [[/next_post | next_post]] (非推奨)
+
! [[/the_content | the_content]]  
; [[/posts_nav_link | posts_nav_link]]
+
| <!--s--> || 現在の記事の本文を表示。記事中に <nowiki><!--more--></nowiki> がある場合、単体記事ページ以外ではそれより前の部分を表示し「続きを読む」リンクを添える。 || ループ中 || 「続きを読む」の文言、 || {{TagLink|the_content|t}}
; [[/the_tags | the_tags]] (Version 2.3)
+
|-
 +
! [[/the_content_rss | the_content_rss]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_content_rss|t}}
 +
|-
 +
! [[/the_excerpt | the_excerpt]]  
 +
| <!--s--> || 現在の記事の抜粋文を表示。HTMLタグや画像は除外。「抜粋表示オプション」が空なら最初の120語を出力。抜粋されずに長文となるときは[[日本語・マルチバイト特有の問題]]を参照 || ループ中 || なし || {{TagLink|the_excerpt|t}}
 +
|-
 +
! [[/the_excerpt_rss | the_excerpt_rss]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_excerpt_rss|t}}
 +
|-
 +
! [[/previous_post_link | previous_post_link]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|previous_post_link|t}}
 +
|-
 +
! [[/previous_post | previous_post]]
 +
| 非推奨 || → previous_post_link || <!--l--> || <!--p--> || {{TagLink|previous_post|t}}
 +
|-
 +
! [[/next_post_link | next_post_link]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|next_post_link|t}}
 +
|-
 +
! [[/next_post | next_post]]
 +
| 非推奨 || → next_post_link || <!--l--> || <!--p--> || {{TagLink|next_post|t}}
 +
|-
 +
! [[/posts_nav_link | posts_nav_link]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|posts_nav_link|t}}
 +
|-
 +
! [[/the_meta | the_meta]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_meta|t}}
 +
|-
 +
! [[/the_tags | the_tags]]
 +
| 2.3↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|the_tags}}
 +
|}
  
 
<div id="Tag_tags">
 
<div id="Tag_tags">
244行目: 404行目:
 
</div>
 
</div>
  
; [[/wp_tag_cloud | wp_tag_cloud]] (Version 2.3)
+
{| class="list"
; [[/the_tags | the_tags]] (Version 2.3)
+
! タグ名 !! status !! 概要 !! ループ !! パラメータ !! リンク
 +
|-
 +
! [[/wp_tag_cloud | wp_tag_cloud]]
 +
| 2.3↑ || タグクラウドを表示 || - || <!--p--> || {{TagLink|wp_tag_cloud}}
 +
|-
 +
! [[/the_tags | the_tags]]
 +
| 2.3↑ || (記事の?)タグ一覧を表示 || ループ中 || 前・後・区切り文字 || {{TagLink|the_tags}}
 +
|}
  
 
<div id="Trackback_tags">
 
<div id="Trackback_tags">
251行目: 418行目:
 
</div>
 
</div>
  
; [[/trackback_url | trackback_url]]
+
{| class="list"
; [[/trackback_rdf | trackback_rdf]]
+
! タグ名 !! status !! 概要 !! ループ !! パラメータ !! リンク
 +
|-
 +
! [[/trackback_url | trackback_url]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|trackback_url|t}}
 +
|-
 +
! [[/trackback_rdf | trackback_rdf]]
 +
| <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|trackback_rdf|t}}
 +
|}
  
 
<div id="External_Resources">
 
<div id="External_Resources">

2007年9月3日 (月) 22:52時点における版

テンプレートタグは、ブログのデータを動的に表示したり、個性的で面白いブログにカスタマイズしたりするときに、テンプレートの中で使います。下記は、WordPress で使える一般ユーザ向けタグの機能別一覧です。

テンプレートタグとテンプレートについてのさらなる情報は、次のページをご覧ください。

注: 各テンプレートタグの使い方を工夫したら、他の WordPress ユーザのために、ぜひそのタグのページに用例として書き込んでください。

注: いくつかのタグは、WordPress の特定のバージョンから新規追加(以下の一覧に "Version 2.1" のように注記)。いくつかのタグは、version 2.0.x で非推奨(以下に "非推奨" と注記)。いくつかのタグは、2.1 から非推奨(以下に "2.1 から非推奨" と注記)。 詳しくは プラグインとテーマの 2.1 への移行 を参照。

テンプレート:refWPDS

執筆者タグ

タグ名 status 概要 ループ パラメータ リンク
the_author 現在の記事の著者を表示 ループ中 非推奨? 原文
the_author_description 原文
the_author_login 原文
the_author_firstname 原文
the_author_lastname 原文
the_author_nickname 原文
the_author_ID 原文
the_author_email 原文
the_author_url 原文
the_author_link 2.1↑ 原文
the_author_icq 原文
the_author_aim 原文
the_author_yim 原文
the_author_msn 原文
the_author_posts 原文
the_author_posts_link 原文
list_authors 非推奨 原文
wp_list_authors 原文

カテゴリタグ

タグ名 status 概要 ループ パラメータ リンク
the_category 現在の記事の全カテゴリを、そのカテゴリアーカイブへのリンク付きで表示 ループ中 区切り文字、親カテゴリの併記 原文
the_category_rss (RSS で使用) 原文
the_category_ID 非推奨 原文
the_category_head 非推奨 原文
single_cat_title 原文
category_description 指定したカテゴリの概要を取得 カテゴリID 原文
wp_dropdown_categories 2.1↑ セレクトボックス(ドロップダウンメニューなど)を使ったカテゴリリストを表示/取得 表示/取得、ソート順ほか多数 原文
dropdown_cats 2.1 から非推奨 原文
wp_list_categories 2.1↑ リンク付きカテゴリリストを表示 ソート順ほか多数 原文
list_cats 2.1 から非推奨 リンク付きカテゴリリストを表示。wp_list_cats とはパラメータの書き方が異なる。2.0.x 系の EasyAll テーマで使用
→ wp_list_categories
原文
wp_list_cats 2.1 から非推奨 リンク付きカテゴリリストを表示。そのリンク先はカテゴリアーカイブページ。2.0.x 系のデフォルトテーマで使用
→ wp_list_categories
原文
in_category 条件分岐タグ:現在の記事がパラメータで指定したカテゴリに属するとき true を返す ループ中/ ループ外 カテゴリID 原文
get_category_parents 現在の または 指定したカテゴリと、そこから最上位までの各カテゴリを取得 原文
get_the_category 現在の記事が属する各カテゴリの情報を取得。カテゴリID・カテゴリ名・カテゴリスラッグ・カテゴリ概要・親カテゴリが配列に格納されるので、好きに取り出して使う。 ループ中 なし 原文

コメントタグ

comments_number
comments_link
comments_rss_link
comments_popup_script
comments_popup_link
comment_ID
comment_author
comment_author_IP
comment_author_email
comment_author_url
comment_author_email_link
comment_author_url_link
comment_author_link
comment_type
comment_text
comment_excerpt
comment_date
comment_time
comment_author_rss
comment_text_rss
comment_link_rss
permalink_comments_rss

日時タグ

タグ名 status 概要 ループ パラメータ リンク
the_date_xml 原文
the_date 現在の記事の投稿日時を表示/取得。フォーマットを指定しなければ一般設定「日付のフォーマット」で表示。1ページに同一投稿日の記事があれば、その最初の記事にのみ表示。全記事に表示するには the_time ループ中 日時フォーマット、前後の文字、表示/取得
原文
the_time 現在の記事の投稿日時を表示。フォーマットを指定しなければ一般設定「時間のフォーマット」で表示。 ループ中 日時フォーマット 原文
the_modified_date 2.1↑ 現在の記事の最終更新日時を表示。次項との違いは何? ループ中 日時フォーマット 原文
the_modified_time 現在の記事の最終更新日時を表示。前項との違いは何? ループ中 日時フォーマット 原文
get_the_time 1.5↑ 原文
single_month_title 原文
get_calendar 原文
the_weekday 原文
the_weekday_date 原文

General タグ

タグ名 status 概要 ループ パラメータ リンク
bloginfo 設置した WordPress の各種情報(主に管理画面の一般設定やユーザープロフィールの項目)を表示。値を取得するには get_bloginfo。sidebar.php や header.php でよく使われる。 表示したい項目(ブログ名、URI、RSS、文字コード、設置ディレクトリURI、ほか) 原文
bloginfo_rss 原文
get_bloginfo bloginfo と同様の項目の値を取得 取得したい項目(ブログ名、URI、RSS、文字コード、設置ディレクトリURI、ほか) 原文
get_bloginfo_rss 原文
wp_title 原文
wp_get_archives 月別アーカイブリスト等、日付に基づくリンク付きアーカイブリストを表示。月別・日別・週別、最近の投稿 n件 種別、件数、リスト形式、前後の文字、記事数の表示 原文
get_archives 2.1 から非推奨 原文
get_calendar カレンダーを表示 原文
get_posts マルチループ(複数ループ)作成時の条件指定 原文
wp_list_pages 1.5↑ 「ページ」一覧を表示/取得 表示/取得、ソート順、除外/表示ページ、表示階層の深さ、サブページ指定、日付表示、見出し有無 原文
wp_dropdown_pages 原文
wp_loginout 1.5↑ 原文
wp_register 1.5↑ 原文
query_posts 1.5↑ 原文
rss_enclosure 1.5↑ 原文
wp_tag_cloud 2.3↑ 原文

Geo タグ

Geo features were moved to a plugin implementation with WordPress 1.5. Tags in parentheses are the plugin version.

print_Lat (the_Lat)
print_Lon (the_Lon)
print_UrlPopNav (the_UrlPopNav)
print_AcmeMap_Url (the_AcmeMap_Url)
print_GeoURL_Url (the_GeoURL_Url)
print_GeoCache_Url (the_GeoCache_Url)
print_MapQuest_Url (the_MapQuest_Url)
print_SideBit_Url (the_SideBit_Url)
print_DegreeConfluence_Url (the_DegreeConfluence_Url)
print_TopoZone_Url (the_TopoZone_Url)
print_FindU_Url (the_FindU_Url)
print_MapTech_Url (the_MapTech_Url)
タグ名 status 概要 ループ パラメータ リンク
edit_post_link 原文
edit_comment_link 原文
wp_link_pages 原文
link_pages 2.1から非推奨 原文
get_year_link 原文
get_month_link 原文
get_day_link 原文
タグ名 status 概要 ループ パラメータ リンク
get_links_list リンク管理画面で「表示:はい」になっている全てのリンクを、カテゴリ順に表示する。リンクカテゴリ画面の「カテゴリー設定」は有効だが「フォーマット」は無視される。 ソート順(カテゴリ名順/カテゴリID順。昇順/降順はアンダーバーで) 原文
wp_get_links パラメータで指定したカテゴリIDに属するリンクを表示。各リンクはカテゴリの「フォーマット」で設定したタグで括られるので、もしそれが <li> タグなら、<ul> タグや見出しの追加が必要。 原文
get_links 原文
wp_list_bookmarks 2.1↑ ブックマーク(ブログロール)一覧を表示/取得 表示/取得、ソート順ほか多数 原文
wp_get_linksbyname 2.1 から非推奨 全カテゴリまたは指定したカテゴリのリンクを、パラメータの条件に従って表示 原文
get_linksbyname 2.1 から非推奨 原文
タグ名 status 概要 ループ パラメータ リンク
permalink_anchor 原文
get_permalink 指定した記事のパーマリンクURI を取得。ループ中でパラメータなしで使うと、現在の記事のパーマリンクURI を取得。 記事ID 原文
the_permalink 現在の記事のパーマリンクURI を表示 ループ中 なし 原文
permalink_single_rss 原文

投稿記事タグ

タグ名 status 概要 ループ パラメータ リンク
the_ID 原文
the_title 原文
single_post_title 原文
the_title_rss 原文
the_content 現在の記事の本文を表示。記事中に <!--more--> がある場合、単体記事ページ以外ではそれより前の部分を表示し「続きを読む」リンクを添える。 ループ中 「続きを読む」の文言、 原文
the_content_rss 原文
the_excerpt 現在の記事の抜粋文を表示。HTMLタグや画像は除外。「抜粋表示オプション」が空なら最初の120語を出力。抜粋されずに長文となるときは日本語・マルチバイト特有の問題を参照 ループ中 なし 原文
the_excerpt_rss 原文
previous_post_link 原文
previous_post 非推奨 → previous_post_link 原文
next_post_link 原文
next_post 非推奨 → next_post_link 原文
posts_nav_link 原文
the_meta 原文
the_tags 2.3↑ 原文

タグ用タグ

タグ名 status 概要 ループ パラメータ リンク
wp_tag_cloud 2.3↑ タグクラウドを表示 原文
the_tags 2.3↑ (記事の?)タグ一覧を表示 ループ中 前・後・区切り文字 原文

トラックバックタグ

タグ名 status 概要 ループ パラメータ リンク
trackback_url 原文
trackback_rdf 原文

外部資料

最新英語版: WordPress Codex » Template Tags