テンプレートタグ

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:


原文⇒*Stepping Into Template Tags (an introduction to Template Tags)
あなたがテンプレートタグの実施の上に面白いねじれを持つならば、あなたは他の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インチで非難される」)

原文⇒Note: Some template tags listed below are new to a specific version of WordPress and will be so noted (example: "Version 2.1"). This means that tag is not available in previous versions. Tags listed as "Deprecated" have been so from version 2.0 or earlier. Newer deprecated tags are marked with the version from when they were deprecated (i.e. "Deprecated in 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 本家

カテゴリータグ

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

タグ名 説明 ループ 引数 リンク 備考欄
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 本家

コメントタグ

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

タグ名 説明 ループ 引数 リンク 備考欄
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 本家

日付・時間タグ

日付・時間タグは、記事を投稿した日付・時間を出力するテンプレートタグ一覧です。
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 本家 ↓非推奨

全体的なタグ

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

タグ名 説明 ループ 引数 リンク 備考欄
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 本家

Geo タグ

ジオの特徴はWordPress1.5とのplugin実現に動かされました。 括弧のタグはpluginバージョンです。 

Geo features were moved to a plugin implementation with WordPress 1.5. Tags in parentheses are the plugin version.
タグ名 説明 ループ 引数 リンク 備考欄
print_Lat(the_Lat)       WordPress 本家  
print_Lon (the_Lon)       WordPress 本家  
print_UrlPopNav (the_UrlPopNav)       WordPress 本家  
print_AcmeMap_Urllprint_AcmeMap_Url (the_AcmeMap_Url)       WordPress 本家  
print_GeoURL_Urllprint_GeoURL_Url (the_GeoURL_Url)       WordPress 本家  
print_GeoCache_Urllprint_GeoCache_Url (the_GeoCache_Url)       WordPress 本家  
print_MapQuest_Urllprint_MapQuest_Url (the_MapQuest_Url)       WordPress 本家  
print_SideBit_Urllprint_SideBit_Url (the_SideBit_Url)       WordPress 本家  
print_DegreeConfluence_Urllprint_DegreeConfluence_Url (the_DegreeConfluence_Url)       WordPress 本家  
print_TopoZone_Urllprint_TopoZone_Url (the_TopoZone_Url)       WordPress 本家  
print_FindU_Urllprint_FindU_Url (the_FindU_Url)       WordPress 本家  
print_MapTech_Urllprint_MapTech_Url (the_MapTech_Url)       WordPress 本家  

リンクタグ

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

タグ名 説明 ループ 引数 リンク 備考欄
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 本家

リンクマネージャータグ

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

タグ名 説明 ループ 引数 リンク 備考欄
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↓

パーマリンクタグ

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

投稿記事タグ

タグ名 説明 ループ 引数 リンク 備考欄
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↑

タグ tags

タグ名 説明 ループ 引数 リンク 備考欄
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↑

トラックバックタグ

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

インクルードタグ

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

タグ名 説明 ループ 引数 リンク 備考欄
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 本家

条件タグ

詳しい条件タグのリファレンスは、条件付きタグ一覧をご覧ください。

メインインデックスページ

  • is_home()：ホームページを表示している場合。

フロントページ

管理パネル

  • is_admin()：Dashboardか管理パネルを表示している場合

個別記事ページ

記事を含む様々なページ

  • comments_open()：コメントがWordPress Loopで処理される現在のポストのために許容されている場合。
  • pings_open()：pingsがWordPress Loopで処理される現在のポストのために許容されている場合。

ページ機能

ページテンプレート

カテゴリーアーカイブページ機能

タグページ

  • is_tag()：タグアーカイブページを表示している場合

執筆者ページ

  • is_author()：著者ページが表示されている場合。

日付ページ

  • is_date()：どんな日付に基づいたアーカイブ・ページも表示されている場合(つまり毎月か、年1回か、毎日か、時間に基づいたアーカイブ)。
  • is_year()：年1回のアーカイブが表示されている場合。
  • is_month()：毎月のアーカイブが表示されている場合。
  • is_day()：毎日のアーカイブが表示されている場合。
  • is_time()：いつ、1つの、一時間ごと、「微細に」あるいは「第2に」、アーカイブは表示されています。

アーカイブ

  • is_archive()：任意のタイプのアーカイブ・ページが表示されている場合。

検索結果ページ

  • is_search()：検索結果ページ・アーカイブが表示されている場合。

404ページ

  • is_404()：ページが「HTTP 404の後に表示する場合:見つけなかった」エラーが生じます。

ページがつけられたページ

  • is_paged()：表示されているページがそうである時、「ページをつけました。」これは、数ページ上にアーカイブあるいは主なページのある分裂を指します。

付属

  • is_attachment()：ポストまたはページへの付属ドキュメントが表示されている場合。

フィード

  • is_feed()：要求されたサイトが組織化である場合。

トラックバック

  • is_trackback()：要求されたサイトがWordPressのそのTrackbackエンジンの中へのホックである場合。

プレビュー

  • is_preview()：表示されている単一のポストがドラフトモードで見られる場合。

投稿者アーカイブページ機能

"http://wordpress.eternal-tears.com/lovelog/%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%82%BF%E3%82%B0" より作成
Lovelog+* -WordPressとXOOPSのテーマ、Mediawikiのスキン配布サイト-
カウンター
  • Total viewd pages:
  • Total visiters:
  • Viewed pages Today:
  • Visiters Today:
  • Online visiters:
    •
BookMark
  • このサイトのはてなブックマーク数
  • このサイトのはてなブックマーク数
  • このサイトのはてなブックマーク数