テンプレートタグ – WordPress*リファレンス

WordPressのテンプレートタグを一覧にしました。
テーマ作成する時の、カスタマイズやテンプレートタグの引数を確認する時にお役立てください。

執筆者タグ
カテゴリータグ
コメントタグ
日付・時間タグ
全体的なタグ
リンクタグ
リンクマネージャータグ
パーマリンクタグ
タグ関連タグ
トラックバックタグ
インクルードタグ

WordPressテンプレートタグについて

テンプレートタグがダイナミックに情報を示すか、さもなければあなたのブログをカスタマイズするためにあなたのブログのテンプレートの中で使われます。そして、それをあなたと同じくらい独特で面白くするためのツールを提供します。下記はWordPressで利用できる一般的なユーザータグのリストです。そして、機能に特有のカテゴリーによって分類されます。

⇒Template tags are used within your blog’s Templates to display information dynamically or otherwise customize your blog, providing the tools to make it as individual and interesting as you are. Below is a list of the general user tags available in WordPress, sorted by function-specific category.

テンプレートタグと一般に、テンプレートの詳細に関しては、以下を見てください:

⇒For further information on template tags and templates in general, see the following:

テンプレートタグに踏み込む(テンプレートタグへの紹介)
テンプレートタグの検査(どうテンプレートファイルにタグを入れるかに関する詳細)
タグパラメータを通過する方法(どうTagsとParametersを使用するかに関する詳細)
インクルードタグ(別のものの中の1個のTemplateファイルを含んでいると関係づけられて、ここに示されなかった追加タグ)
条件付きタグ(あなたのTemplatesをオプションによりフレキシブルにすると関係づけられて、ここに示されなかったより多くの追加タグ)
テンプレート(テンプレート、テーマ、およびタグリソースに関する総覧)
テンプレートに踏み込む(テンプレートファイルへの序論)

⇒*Stepping Into Template Tags (an introduction to Template Tags)

Anatomy of a Template Tag (details of how to put Tags into Template files)

How to Pass Tag Parameters (details of how to use Parameters with Tags)

Include Tags (additional tags not shown here, related to including one Template file within another)

Conditional Tags (more additional tags not shown here, related to making your Templates more flexible with options)

Templates (a comprehensive list of Template, Theme, and Tag resources)

Stepping Into Templates (introduction to Template files)

あなたがテンプレートタグの実施の上に面白いねじれを持つならば、あなたは他のWordPressユーザーのためにそのドキュメンテーションを増すのを奨励されます。しかし、最初に、援助とCodexページを編集することに関するガイドラインのためにWordPressにContributingを見てください。

⇒If you have an interesting twist on the implementation of a template tag, you’re encouraged to add to its documentation for the benefit of other WordPress users. However, first see Contributing to WordPress for help and guidelines on editing Codex pages.

注意: 以下に記載されたいくつかのテンプレートタグがWordPressの特定のバージョンに新しく、そのように注意される、(例:、「バージョン2.1インチ)」これは、タグが旧バージョンでは利用可能でないことを意味します。したがって、「非難されたこと」は記載されていますが、バージョン2.0以前から、タグ付けをします。すなわち、より新しい推奨しないタグがバージョンでそれらが非難された時からマークされる、(「2.1インチで非難される」)

執筆者タグ

執筆者タグは、投稿者関連の情報を出力するテンプレートタグです。

タグ名	説明	ループ	引数	リンク	備考欄
the_author	投稿者の’公開’の名前	○	○	WordPress 本家
the_author_description	投稿者の自己紹介文	○	×	WordPress 本家
the_author_login	投稿者のログイン名	○	×	WordPress 本家
the_author_firstname	投稿者の名前を出力	○	×	WordPress 本家
the_author_lastname	投稿者の姓を出力	○	×	WordPress 本家
the_author_nickname	投稿者のニックネームを出力	○	×	WordPress 本家
the_author_ID	投稿者のユーザーIDを出力	○	×	WordPress 本家
the_author_email	投稿者のメールアドレスを出力	○	×	WordPress 本家
the_author_url	投稿者のサイトURLを出力	○	×	WordPress 本家
the_author_link	投稿者のWebsiteへのリンクを表示	○	×	WordPress 本家	2.1↑
the_author_icq	投稿者のICQメッセンジャーIDを出力	○	×	WordPress 本家	非推奨
the_author_aim	投稿者のAOLメッセンジャーIDを出力	○	×	WordPress 本家
the_author_yim	投稿者のYahoo!メッセンジャーIDを出力	○	×	WordPress 本家
the_author_msn	投稿者のMSNメッセンジャーIDを出力	○	×	WordPress 本家	非推奨
the_author_posts	投稿者名と現在までに公開した記事数を出力	○	×	WordPress 本家
the_author_posts_link	投稿者が公開した全記事へのリンクを出力	○	○	WordPress 本家
list_authors	投稿者一覧を出力	○	○	WordPress 本家	非推奨
wp_list_authors	投稿者一覧を出力。list_authorsと同機能。	○	○	WordPress 本家

Page TOP

カテゴリータグ一覧

カテゴリータグは、テーマ作成に必要なカテゴリー関連の情報を出力するテンプレートタグ一覧です。

タグ名	説明	ループ	引数	リンク	備考欄
the_category	記事が所属するカテゴリー名とそのカテゴリーへのリンクを出力	○	○	WordPress 本家
the_category_rss	RSS/Atom/RDFなどのFEED用にフォーマットされた形式で、記事が所属するカテゴリー名を出力	○	○	WordPress 本家
single_cat_title	現在のページのカテゴリー名を出力。カテゴリーページ以外は無効	×	○	WordPress 本家
category_description	カテゴリー管理画面で設定したカテゴリーの説明をPHPの値として返す。	×	○	WordPress 本家
wp_dropdown_categories	ドロップダウンのカテゴリのリストを表示します。	×	○	WordPress 本家	2.1↑
dropdown_cats	ドロップダウンメニュー形式でカテゴリーリンク一覧を出力。	×	○	WordPress 本家	2.1非推奨
wp_list_categories	リスト形式でカテゴリーリンク一覧を出力	×	○	WordPress 本家	2.1↑
list_cats	リスト形式でカテゴリーリンク一覧を出力	×	○	WordPress 本家	2.1非推奨
wp_list_cats	リスト形式でカテゴリーリンク一覧を出力。list_catsとほぼ同じ。	×	○	WordPress 本家	2.1非推奨
in_category	表示している記事が指定したIDのカテゴリーに所属しているかどうかを判断する。カテゴリーページを表示しているかどうかの判断をするin_category()タグと混合しないように注意。	○	○	WordPress 本家
get_category_parents	カテゴリーの親カテゴリーを取得する。	○・×	○	WordPress 本家
get_the_category	記事のカテゴリー名、ID、カテゴリースラッグ、説明、親カテゴリーなどの情報をPHPの配列として返す。	○	○	WordPress 本家

Page TOP

コメントタグ一覧

コメントタグは、コメント関連の情報を出力するテンプレートタグ一覧です。

タグ名	説明	ループ	引数	リンク
comments_number	記事に対するコメント、トラックバック、ピンバックの合計数を出力	○	○	WordPress 本家
comments_link	記事のコメント部分へのURLを出力。	○	○	WordPress 本家
comments_rss_link	記事のコメントRSSフィードのURLを出力	○	○	WordPress 本家
comments_popup_script	ポップアップで開くコメントフォーム用のjavascriptを出力。 head要素内に挿入し、body要素内のcomments_popup_linkでポップアップリンクを出力させると良い。	×	○	WordPress 本家
comments_popup_link	コメントフォームのポップアップへのリンクを出力。	コメント ○	○	WordPress 本家
comment_ID	それぞれのコメントのIDを出力。	コメント ○	×	WordPress 本家
comment_author	コメントの投稿者名を出力。	コメント ○	×	WordPress 本家
comment_author_IP	コメントの投稿者名のIPを出力。	コメント ○	×	WordPress 本家
comment_author_email	コメントの投稿者名のメールアドレスを出力。	コメント ○	×	WordPress 本家
comment_author_url	コメントの投稿者が投稿時に記入したサイトURLを出力。	コメント ○	×	WordPress 本家
comment_author_email_link	コメントの投稿者へメールを送るリンクを出力。	コメント ○	〇	WordPress 本家
comment_author_url_link	コメントの投稿者のサイトへのリンクを出力。	コメント ○	〇	WordPress 本家
comment_author_link	コメントの投稿者名と、もしあればその人のサイトへのリンクを出力。	コメント ○	〇	WordPress 本家
comment_type	フィードバックの種類（コメント、トラックバック、ピンバック）を出力。	コメント ○	〇	WordPress 本家
comment_text	コメント本文の内容を出力。	コメント ○	×	WordPress 本家
comment_excerpt	最大20単語のコメントの概要を出力。日本語のサイトで使うと単語の数え方がうまくいかないことがあるので注意。	コメント ○	×	WordPress 本家
comment_date	コメントが投稿された日を出力。PHPの日付文法が使用できる。	コメント ○	〇	WordPress 本家
comment_time	コメントが投稿された時間を出力。PHPの日付文法が使用できる。	コメント ○	〇	WordPress 本家
comment_author_rss	RSS、ATOM、RDFなどのフィード用にフォーマットされた形式で、コメント投稿者名を出力。	コメント ○	×	WordPress 本家
comment_text_rss	RSS、ATOM、RDFなどのフィード用にフォーマットされた形式で、コメントの本文を出力。	コメント ○	×	WordPress 本家
comment_link_rss	RSS、ATOM、RDFなどのフィード用にフォーマットされた形式で、コメントへのリンクを出力。	○	×	WordPress 本家
permalink_comments_rss	RSS、ATOM、RDFなどのフィード用にフォーマットされた形式で、コメントが付けられた記事のパーマリンクを出力。	○	×	WordPress 本家

Page TOP

日付・時間タグ一覧

日付・時間タグは、記事を投稿した日付・時間を出力するテンプレートタグ一覧です。
PHPの日付文法に則っています。

タグ名	説明	ループ	引数	リンク	備考欄
the_date_xml	YYYY-MM-DD形式で記事の投稿/更新日を出力。	○	×	WordPress 本家
the_date	記事の投稿/更新日を出力。PHPの日付文法が使用できる。同じ日に複数の記事がある場合、最初の記事と共に一度だけ出力される。	○	○	WordPress 本家
the_time	記事の投稿/更新時間を出力。PHPの日付文法が使用できる。デフォルト値は管理画面のオプションで設定した形式。	○	○	WordPress 本家
the_modified_date	記事が最後に変更された日付(そして、時間)を表示	○	○	WordPress 本家	2.1↑
the_modified_time	記事が最後に変更された日付を表示	○	○	WordPress 本家
get_the_time	記事の投稿/更新時間をPHPの値として返す。	○	○	WordPress 本家
single_month_title	月別アーカイブページで月・年名を出力。	○	○	WordPress 本家
get_calendar	カレンダー(現在の月/年をデフォルトとする)を表示	○	○	WordPress 本家
the_weekday	曜日を表示	○	○	WordPress 本家	↓非推奨
the_weekday_date	前のポストの平日と異なる場合にだけ、現在のポスト(例えば、金曜日)の平日を表示	○	○	WordPress 本家	↓非推奨

Page TOP

全体的なタグ

全体的なタグは、ブログの様々な情報を出力する時に使うテンプレートタグ一覧です。

タグ名	説明	ループ	引数	リンク
bloginfo	使用中のWordPressブログに関する様々な情報を出力。	○・×	○	WordPress 本家
bloginfo_rss	RSS,ATOM,RDFなどのフィード用にフォーマットされた形式で、ブログに関する様々な情報を出力。	○・×	○	WordPress 本家
get_bloginfo	ブログに関する様々な情報をPHPの値をして返す。	○・×	○	WordPress 本家
get_bloginfo_rss	フィード用にフォーマットしたブログに関する様々な情報をPHPの値として返す。	○・×	○	WordPress 本家
get_settings	ブログに関する様々な情報をPHPの値として返す。 bloginfo()タグと似ているが、選択できる情報にはプラグインの設定なども含まれる。	○・×	○	WordPress 本家
get_option	get_settings()タグとまったく同じ機能を持つエイリアス。	○・×	○	WordPress 本家
wp_title	表示中のページのタイトル。ページ名、記事名、カテゴリー名などを含む。	○・×	○	WordPress 本家
get_archives	月別・日別・週別・個別記事アーカイブへのリンクを出力。	○・×	○	WordPress 本家
wp_get_archives	月別・日別・週別・個別記事アーカイブへのリンクを出力。	○・×	○	WordPress 本家
wp_calendar	記事投稿日にリンクが付けられたテーブル形式のカレンダーを出力。	×	○	WordPress 本家
wp_post	ループを作る際、最新記事の情報を取得する。	○	○	WordPress 本家
wp_list_pages	ページ機能を使って作成したWordPressページのリンク付きタイトル一覧を出力。	○	○	WordPress 本家
wp_loginout	ログインしていればログアウト用のリンクを、していなければログイン用のリンクを出力。	○・×	×	WordPress 本家
wp_reginster	管理画面の「一般設定」で「誰でもユーザー登録ができるようにする」にチェックが入っている場合、ユーザー登録用のリンクを出力。ログインしていれば、代わりに管理画面へのリンクを出力。	○・×	○	WordPress 本家
query_posts	ループ内でクエリーを変更するために使う。	○	○	WordPress 本家
rss_enclosure	記事内の音声・画像ファイルへのリンクを、RSSエンクロージャー要素に変換する。ポッドキャスティングなどのフィードを配信するために使われる。	○	×	WordPress 本家

Page TOP

リンクタグ一覧

リンクタグは、記事の前後のページへのリンクを出力したりする、ユーザビリティーを向上するためのテンプレートタグです。

タグ名	説明	ループ	引数	リンク	備考欄
edit_post_link	記事やWordPressページの編集画面へのリンクを出力。	○	○	WordPress 本家
edit_comment_link	コメント編集画面へのリンクを出力	コメント○	○	WordPress 本家
link_pages	記事内を<!–nextpage–>で分割した場合の他セクション（記事内のページ）へのリンク。	○	○	WordPress 本家	非推奨
wp_link_pages	記事内を<!–nextpage–>で分割した場合の他セクション（記事内のページ）へのリンク。	○	○	WordPress 本家
get_year_link	特定の年別アーカイブページへのURLをPHPの値として返す。	○・×	○	WordPress 本家
get_month_link	特定の月別アーカイブページへのURLをPHPの値として返す。	○・×	○	WordPress 本家
get_day_link	特定の日別アーカイブページへのURLをPHPの値として返す。	○・×	○	WordPress 本家

Page TOP

リンクマネージャータグ一覧

リンクマネージャータグは、管理画面で登録したブックマーク関連を出力するテンプレートタグです。

タグ名	説明	ループ	引数	リンク	備考欄
get_links_list	リンク管理画面（リンクマネージャー）で追加・編集したリンクの一覧を出力。管理画面で指定したフォーマット設定を無視する。	×	○	WordPress 本家	非推奨2.3↓
wp_get_links	リンク管理画面（リンクマネージャー）で追加・編集したリンクのうち、特定のカテゴリー内のリンクを出力。管理画面で指定した「開始タグ」、「終了タグ」、「リンクと概要の間（に挿入するテキスト）」の設定を使用して出力結果をフォーマットする。	×	○	WordPress 本家	非推奨2.3↓
get_links	リンク管理画面（リンクマネージャー）で追加・編集したリンクのうち、特定のカテゴリー内のリンクを出力。管理画面で指定した「開始タグ」、「終了タグ」、「リンクと概要の間（に挿入するテキスト）」の設定を使用して出力結果をフォーマットする。	×	○	WordPress 本家	非推奨2.3↓
wp_list_bookmarks	ブックマークを追加します	×	○	WordPress 本家	2.1↑
wp_get_linksbyname	リンク管理画面（リンクマネージャー）で追加・編集したリンクを出力。出力する内容はget_linkと同じだが、コンマ区切りではなく&を使った書式で引数を指定する。	×	○	WordPress 本家	非推奨2.1↓
get_linksbyname	リンク管理画面（リンクマネージャー）で追加・編集したリンクを出力。出力する内容はget_linkと同じだが、出力するリンクカテゴリーIDの数字ではなくテキストで指定する。	×	○	WordPress 本家	非推奨2.1↓

Page TOP

パーマリンクタグ一覧

投稿された記事へのリンクタグ関連のテンプレートタグ一覧です。

タグ名	説明	ループ	引数	リンク
permalink_anchor	記事IDまたはタイトルをidとするアンカー(a要素）を出力。	○	○	WordPress 本家
get_permalink	記事のパーマリンクをPHPの値として返す。実際のページ内には表れないが、PHPコマンドや関数を使うことにより出力させることもできる。	○・×	○	WordPress 本家
the_permalink	記事内のパーマリンクを出力。	○	×	WordPress 本家
permalink_single_rss	RSS、ATOM、RDFなどのフィード用にフォーマットされた形式で記事のパーマリンクを出力。	○	×	WordPress 本家

Page TOP

投稿記事タグ

タグ名	説明	ループ	引数	リンク	備考欄
the_ID	記事IDを出力。	○	×	WordPress 本家
the_title	記事タイトルを出力	○	○	WordPress 本家
single_post_title	個別記事ページでループ外に記事のタイトルを出力。	×	○	WordPress 本家
the_title_rss	RSS,ATOM,RDFなどのフィード用にフォーマットされた形式で記事のタイトルを出力。	○	×	WordPress 本家
the_content	記事の本文を出力。本文中にクイックタグがある場合、それより前の内容のみを表示させることもできる。	○	○	WordPress 本家
the_content_rss	RSS,ATOM,RDFなどのフィード用にフォーマットされた形式で記事の本文を出力。本文中にクイックタグがある場合、それより前の内容のみを表示させることもできる。	○	○	WordPress 本家
the_excerpt	記事の概要を出力。画像などは取り除かれる。概要が特に指定されていない場合、本分の最初から120文字を表示することになっているが、日本語の場合は全文が表示される。	○	×	WordPress 本家
the_excerpt_rss	RSS,ATOM,RDFなどのフィード用にフォーマットされた形式で記事の概要を出力。画像やHTMLなどは取り除かれる。概要が特に指定されていない場合、本分の最初から120文字を表示することになっているが、日本語の場合は全文が表示される。	○	×	WordPress 本家
previous_post	個別記事ページで使用。時系列順で１つ前（より古い）の記事へのリンクを出力。	○	○	WordPress 本家	非推奨
next_post	個別記事ページで使用。時系列順で１つ次（より新しい）の記事へのリンクを出力。	○	○	WordPress 本家	非推奨
posts_nav_link	インデックスや月別・カテゴリー別アーカイブページが複数ページにわたる場合、その前後のページへのリンクを出力。	×	○	WordPress 本家
the_meta	記事に「カスタムフィールド」を使って追加されたメタ情報の内容を出力。	○	×	WordPress 本家
the_tags	記事が属すタグかタグへのリンクを表示	○	×	WordPress 本家	2.3↑
wp_count_posts	wp_postsにおける指定されたpost_typeとpost_statusに会う列のカウントを返します。	○	×	WordPress 本家	2.5↑

Page TOP

タグ関連タグ一覧

タグ名	説明	ループ	引数	リンク	備考欄
wp_tag_cloud	タグクラウドにおけるタグのリストを表示	×	○	WordPress 本家	2.3↑
the_tags	記事が属すタグかタグへのリンクを表示します。現在のエントリーに関連していない場合、代わりに関連カテゴリを表示。	○	○	WordPress 本家	2.3↑
get_the_tags	オブジェクト、記事に割り当てられた各タグあたり1個のオブジェクトの配列を返す	○	○	WordPress 本家	2.3↑
get_the_tag_list	記事に関連しているタグのHTML記号を発生させます。それぞれのタグの名前は関連’タグ’ページにリンクされるでしょう	○	×	WordPress 本家	2.3↑
single_tag_title	現在のページ単位でタグタイトルを表示するか、または返します。	×	○	WordPress 本家	2.3↑

Page TOP

トラックバックタグ一覧

タグ名	説明	ループ	引数	リンク	備考欄
trackback_url	記事のトラックバックURLを出力するか、PHPの値として返す。	○	○	WordPress 本家
trackback_rdf	他のサイトがトラックバック自動検出機能（ピン/Ping送信）を使えるよう、トラックバックURLなどの記事情報を出力。このタグを記事のテンプレートに含めない場合も、手動で送信されたトラックバックが受信できる。ブラウザによっては出力に問題があるので、HTMLコメントの中に書く方が安全。	○	×	WordPress 本家

Page TOP

インクルードタグ一覧

テーマ作成する時に、テーマファイルにインクルードするタグの一覧です。

タグ名	説明	ループ	引数	リンク
get_header	使用中テーマ内のheader.phpファイル（ヘッダーテンプレート）の内容を出力。テーマ内にheader.phpファイルが存在しない場合、defaultテーマの同名ファイルが読み込まれる。	×	×	WordPress 本家
get_footer	使用中テーマ内のfooter.phpファイル（ヘッダーテンプレート）の内容を出力。テーマ内にfooter.phpファイルが存在しない場合、defaultテーマの同名ファイルが読み込まれる。	×	×	WordPress 本家
get_sidebar	使用中テーマ内のsidebar.phpファイル（ヘッダーテンプレート）の内容を出力。テーマ内にsidebar.phpファイルが存在しない場合、defaultテーマの同名ファイルが読み込まれる。	×	×	WordPress 本家
comments_template	使用中テーマ内のcomments.phpファイル（ヘッダーテンプレート）の内容を出力。テーマ内にcomments.phpファイルが存在しない場合、defaultテーマの同名ファイルが読み込まれる。	×	×	WordPress 本家

Page TOP

HOME » WordPress便利帳 » テンプレートタグ – WordPress*リファレンス