- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
テンプレートタグ
意見募集: 一覧表の形式について検討しています。このページのノートをご覧ください。
目次
テンプレートタグは、ブログのデータを動的に表示したり、個性的で面白いブログにカスタマイズしたりするときに、テンプレートの中で使います。下記は、WordPress で使える一般ユーザ向けタグの機能別一覧です。
テンプレートタグとテンプレートについてのさらなる情報は、次のページをご覧ください。
- テンプレートタグ入門
- テンプレートタグ大解剖
- テンプレートタグへのパラメータの渡し方 (パラメータの使い方の詳細)
- インクルードタグ (テンプレートファイルを他のテンプレートファイルに読み込むための、下記には載っていないタグ)
- 条件分岐タグ (ページの状況に応じて処理を変えたいときに使える、下記には載っていないタグ)
- 関数リファレンス (その他の関数)
- WordPress サイトデザイン リファレンス (テーマ・テンプレート・タグに関するページの総覧)
各テンプレートタグの使い方を工夫したら、他の WordPress ユーザのために、ぜひそのタグのページに用例として書き込んでください。
status について:
- 2.x↑
- WordPress の特定のバージョンから追加されたテンプレートタグには、「2.1↑」のような注記があります。それより古いバージョンでは使えません。
- 非推奨
- 将来削除される予定のテンプレートタグです。後継のタグに切り替えてください。
- 「非推奨」: バージョン 2.0 以前に非推奨となったもの。2.0.x 以降で使うことはお勧めしません。
- 「2.x から非推奨」: そのバージョン以降において使うことをお勧めしません。
一覧・ドロップダウンタグ
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
wp_list_authors | ブログの著者一覧を表示。投稿があれば著者アーカイブへのリンク付き | - | 投稿数、管理者除外、表示名、未投稿者、フィードリンク | 原文 | |
wp_list_categories | 2.1↑ | リンク付きカテゴリリストを表示/取得 | - | 表示/取得、ソート順ほか多数 | 原文 |
wp_list_pages | 1.5↑ | 「ページ」一覧を表示/取得 | - | 表示/取得、ソート順、除外/表示ページ、表示階層の深さ、サブページ指定、日付表示、見出し有無 | 原文 |
wp_list_bookmarks | 2.1↑ | ブックマーク(ブログロール)一覧を表示/取得 | 表示/取得、ソート順ほか多数 | 原文 | |
wp_list_comments | 2.7↑ | 現在の投稿に対する全てのコメントを表示。従来のコメントループに替わるもの。 | 原文 | ||
wp_get_archives | 月別アーカイブリスト等、日付に基づくリンク付きアーカイブリストを表示。月別・日別・週別、最近の投稿 n件 | - | 種別、件数、リスト形式、前後の文字、記事数の表示 | 原文 | |
wp_page_menu | 2.7↑ | 原文 | |||
wp_dropdown_pages | 「ページ」一覧をセレクトボッックス(ドロップダウンメニュー)で表示 | - | 原文 | ||
wp_dropdown_categories | 2.1↑ | セレクトボックス(ドロップダウンメニューなど)を使ったカテゴリリストを表示/取得 | - | 表示/取得、ソート順ほか多数 | 原文 |
wp_dropdown_users | 2.3↑ | 原文 | |||
the_widget | 2.8↑ | 任意のウィジェットをテンプレートの任意の位置に表示 | - | 表示したいウィジェット、前後の文字、各ウィジェットのパラメータ | 原文 |
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
the_author | 現在の記事の著者名(公開用)を表示。 取得するには get_the_author |
ループ中 | - | 原文 | |
the_modified_author | 2.8↑ | 現在の記事を最後に更新した執筆者名を表示。 取得するには get_the_modified_author |
ループ中 | - | 原文 |
the_author_meta | 2.8↑ | 現在の、または指定した記事の著者・登録ユーザの各種情報を表示。 取得するには get_the_author_meta/en |
表示したい項目、ユーザID | 原文 | |
the_author_link | 2.1↑ | 現在の記事の著者名(公開用)をウェブサイトへのリンク付きで表示 | ループ中 | - | 原文 |
get_the_author_link | 3.0↑ | 原文 | |||
the_author_posts | 現在の記事の著者の投稿数を表示。 取得するには get_the_author_posts |
ループ中 | - | 原文 | |
the_author_posts_link | 現在の記事の著者名(公開用)を著者アーカイブへのリンク付きで表示 | ループ中 | - | 原文 | |
get_author_posts_url | 2.1↑ | 現在の記事の著者の著者ページのURLを取得 | 著者ID、著者名(公開用) | 原文 | |
wp_list_authors | ブログの著者一覧を表示。投稿があれば著者アーカイブへのリンク付き | - | 投稿数、管理者除外、表示名、未投稿者、フィードリンク | 原文 | |
wp_dropdown_users | 2.3↑ | 原文 | |||
|
2.8 から非推奨 | 現在の記事の著者の自己紹介文を表示 → the_author_meta |
ループ中 | - | 原文 |
|
2.8 から非推奨 | 現在の記事の著者のログインユーザ名を表示 → the_author_meta |
ループ中 | - | 原文 |
|
2.8 から非推奨 | 現在の記事の著者の(下の)名を表示 → the_author_meta |
ループ中 | - | 原文 |
|
2.8 から非推奨 | 現在の記事の著者の姓を表示 → the_author_meta |
ループ中 | - | 原文 |
|
2.8 から非推奨 | 現在の記事の著者のニックネームを表示 → the_author_meta |
ループ中 | - | 原文 |
|
2.8 から非推奨 | 現在の記事の著者のユーザID を表示 → the_author_meta |
ループ中 | - | 原文 |
|
2.8 から非推奨 | 現在の記事の著者の E-メールアドレスを表示 → the_author_meta |
ループ中 | - | 原文 |
|
2.8 から非推奨 | 現在の記事の著者のウェブサイトの URI を表示 → the_author_meta |
ループ中 | - | 原文 |
|
2.8 から非推奨 | 現在の記事の著者の ICQ 番号(2.0.x 以下にあった項目)を表示 → the_author_meta |
ループ中 | - | 原文 |
|
2.8 から非推奨 | 現在の記事の著者の AIM(AOLインスタント・メッセンジャー)のスクリーンネームを表示 → the_author_meta |
ループ中 | - | 原文 |
|
2.8 から非推奨 | 現在の記事の著者の Yahoo IM ID を表示 → the_author_meta |
ループ中 | - | 原文 |
|
2.8 から非推奨 | 現在の記事の著者の MSN IM ID(2.0.x 以下にあった項目)を表示 → the_author_meta |
ループ中 | - | 原文 |
|
非推奨 | → wp_list_authors | 原文 |
ソースコード: wp-includes/author-template.php
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
the_category | 現在の記事が属する全カテゴリを、そのカテゴリアーカイブへのリンク付きで表示 | ループ中 | 区切り文字、親カテゴリの併記 | 原文 | |
get_the_category | 現在の記事が属する各カテゴリの情報を取得。カテゴリID・カテゴリ名・カテゴリスラッグ・カテゴリ概要・親カテゴリが配列に格納されるので、好きに取り出して使う。 | ループ中 | - | 原文 | |
get_the_category_by_ID | 指定したカテゴリのカテゴリ名を取得 | - | カテゴリID | 原文 | |
get_the_category_list | HTMLリストまたはカスタム形式のカテゴリ一覧を取得 | - | 区切り文字、親カテゴリの表示方法、記事ID | 原文 | |
in_category | 条件分岐タグ:現在の記事がパラメータで指定したカテゴリに属するとき true を返す | ループ中/ ループ外 | カテゴリID | 原文 | |
get_category_parents | 現在の または 指定したカテゴリと、そこから最上位までの各カテゴリを取得 | - | 原文 | ||
get_category_link | 指定したカテゴリのURLを取得 | カテゴリID | 原文 | ||
category_description | 指定したカテゴリの概要を取得 | - | カテゴリID | 原文 | |
the_category_rss | (フィード用) | 原文 | |||
|
非推奨 | → get_the_category | 原文 | ||
|
非推奨 | → get_the_category_by_ID, get_the_category | 原文 | ||
single_cat_title | 現在のカテゴリアーカイブページのカテゴリ名を表示/取得 | - | 表示/取得、接頭辞 | 原文 | |
wp_dropdown_categories | 2.1↑ | セレクトボックス(ドロップダウンメニューなど)を使ったカテゴリ一覧を表示/取得 | - | 表示/取得、ソート順ほか多数 | 原文 |
|
2.1 から非推奨 | → wp_dropdown_categories | 原文 | ||
wp_list_categories | 2.1↑ | リンク付きカテゴリ一覧を表示/取得 | - | 表示/取得、ソート順ほか多数 | 原文 |
|
2.1 から非推奨 | リンク付きカテゴリ一覧を表示。wp_list_cats とはパラメータの書き方が異なる。2.0.x 系の EasyAll テーマで使用→ wp_list_categories |
- | 原文 | |
|
2.1 から非推奨 | リンク付きカテゴリ一覧を表示。そのリンク先はカテゴリアーカイブページ。2.0.x 系のデフォルトテーマで使用 → wp_list_categories |
- | 原文 |
ソースコード: wp-includes/category-template.php
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
コメント表示 | |||||
wp_list_comments | 2.7↑ | 現在の投稿に対する全てのコメントを表示。従来のコメントループに替わるもの。参照: コメント表示を WordPress 2.7以降に対応させる方法 | 原文 | ||
comment_author | コメント投稿者名を表示。 取得するには get_comment_author |
ループ中 | - | 原文 | |
comment_author_email | コメント投稿者のメールアドレスを表示。 取得するには get_comment_author_email |
ループ中 | - | 原文 | |
comment_author_email_link | コメント投稿者へメールを送るリンクを表示。 取得するには get_comment_author_email_link |
ループ中 | リンクラベルテキスト、前後テキスト | 原文 | |
comment_author_link | コメント投稿者名と、もしあればサイトへのリンクを表示。 取得するには get_comment_author_link |
ループ中 | - | 原文 | |
comment_author_IP | コメント投稿者のIPアドレスを表示。 取得するには get_comment_author_IP |
ループ中 | - | 原文 | |
comment_author_url | コメント投稿者のサイトURLを表示。 取得するには get_comment_author_url |
ループ中 | - | 原文 | |
comment_author_url_link | コメント投稿者のサイトへのリンクを表示。 取得するには get_comment_author_url_link |
ループ中 | リンクラベルテキスト、前後テキスト | 原文 | |
comment_class | 2.7↑ | 各コメントの class 属性を表示/取得。 取得するには get_comment_class |
原文 | ||
comment_date | コメント投稿日時を表示。 取得するには get_comment_date |
ループ中 | 出力形式 | 原文 | |
comment_excerpt | コメント概要を表示。 取得するには get_comment_excerpt |
ループ中 | - | 原文 | |
comment_ID | コメントのIDを表示。 取得するには get_comment_ID |
ループ中 | - | 原文 | |
get_comment_link | コメントのURLを取得 | 原文 | |||
comments_link | 現在の投稿に対するコメントのURLを表示。 取得するには get_comments_link |
ループ中 | - | 原文 | |
comments_number | 記事のコメント・トラックバック・ピンバックの合計数を表示。 取得するには get_comments_number |
ループ中 | コメント数表示テキスト | 原文 | |
comment_text | コメント本文を表示。 取得するには get_comment_text |
ループ中 | - | 原文 | |
comment_time | コメント投稿日時を表示。 取得するには get_comment_time |
ループ中 | 出力形式 | 原文 | |
comment_type | フィードバックの種類を出力。 取得するには get_comment_type |
ループ中 | 表示テキスト | 原文 | |
get_avatar | 2.5↑ | 原文 | |||
コメント投稿フォーム | |||||
comments_open | 現在の投稿がコメントを受け付けているか否かを判定 | 原文 | |||
pings_open | 現在の投稿がトラックバック・ピンバックを受け付けているか否かを判定 | 原文 | |||
comment_form | 3.0↑ | 標準化したコメント投稿欄(フォーム)を出力 | 原文 | ||
comments_popup_script | ポップアップコメントフォーム(次項)用のJavaScriptを出力。 | ループ外 | ポップアップウィンドウサイズ | 原文 | |
comments_popup_link | コメントフォームのポップアップへのリンクを表示。 | ループ中 | コメント数表示テキスト、CSSクラス | 原文 | |
comment_reply_link | 2.7↑ | 既存コメントに返信するためのリンクを表示。 取得するには get_comment_reply_link |
原文 | ||
post_reply_link | 2.7↑ | 取得するには get_post_reply_link | 原文 | ||
cancel_comment_reply_link | 2.7↑ | 既存コメントへの返信を止める(コメント投稿欄を通常に戻す)ためのリンクを表示。 取得するには get_cancel_comment_reply_link |
原文 | ||
comment_id_fields | 2.7↑ | 取得するには get_comment_id_fields |
原文 | ||
comment_form_title | 2.7↑ | コメント投稿欄の見出しを表示 | 原文 | ||
フィード用 | |||||
|
2.5から非推奨 | 記事コメントRSSフィードのURLを表示。 | ループ中 | リンクラベルテキスト、リンク先ファイル名 | 原文 |
comment_author_rss | フィード用形式でコメント投稿者名を表示。 | ループ中 | - | 原文 | |
comment_text_rss | フィード用形式でコメント本文を表示。 | ループ中 | - | 原文 | |
|
フィード用形式でコメントへのリンクを表示。 | ループ中 | - | 原文 | |
|
フィード用形式でコメントがつけられた記事の固定リンクを表示。 | ループ中 | - | 原文 |
ソースコード: wp-includes/comment-template.php
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
the_date_xml | 現在の記事の投稿日を YYYY-MM-DD フォーマットで表示 | ループ中 | - | 原文 | |
the_date | 現在の記事の投稿日時を表示/取得。フォーマットを指定しなければ一般設定「日付のフォーマット」で表示。1ページに同一投稿日の記事があれば、その最初の記事にのみ出力。全記事に表示するには the_time 、3.0以降は get_the_date も利用可能 |
ループ中 | 日時フォーマット、前後の文字、表示/取得 |
原文 | |
get_the_date | 3.0↑ | 現在の記事の投稿日時を取得。the_date とは異なり常に日時を取得できる。 |
ループ中 | 日時フォーマット | 原文 |
the_time | 現在の記事の投稿日時を表示。フォーマットを指定しなければ一般設定「時間のフォーマット」で表示。 | ループ中 | 日時フォーマット | 原文 | |
get_the_time | 1.5↑ | 現在の、または指定した記事の投稿日時を取得 | - | 日時フォーマット、投稿ID | 原文 |
get_post_time | 2.0↑ | 原文 | |||
the_modified_date | 2.1↑ | 現在の記事の最終更新日時を表示/取得。フォーマットを指定しなければ一般設定「日付のフォーマット」で表示。 取得するには get_the_modified_date |
ループ中 | 日時フォーマット、前後の文字列、表示/取得 | 原文 |
the_modified_time | 2.1↑ | 現在の記事の最終更新日時を表示。フォーマットを指定しなければ一般設定「時間のフォーマット」で表示。 取得するには get_the_modified_time |
ループ中 | 日時フォーマット | 原文 |
get_post_modified_time | 2.0↑ | 原文 | |||
the_weekday | (非推奨?)[1] | 現在の記事が投稿された曜日を表示 → the_time | ループ中 | - | 原文 |
the_weekday_date | (非推奨?)[1] | 現在の記事が投稿された曜日を、前の記事と異なるときにのみ表示 → the_date を利用した the_time | ループ中 | 前後テキスト | 原文 |
single_month_title | 現在のページの年月タイトルを表示/取得。月別アーカイブでのみ動作 | - | 表示/取得、前テキスト | 原文 | |
wp_get_archives | 月別アーカイブリスト等、日付に基づくリンク付きアーカイブリストを表示。月別・日別・週別、最近の投稿 n件 | - | 種別、件数、リスト形式、前後の文字、記事数の表示 | 原文 | |
|
2.1 から非推奨 | → wp_get_archives | 原文 | ||
get_calendar | カレンダーを表示。投稿のある日付は日別アーカイブへリンク | - | 曜日表示形式 | 原文 |
ソースコード: wp-includes/general-template.php
タグ名 | 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 | ウェブページの題名を取得/表示。<title> 要素などに使用 |
- | 表示/取得、区切り文字 | 原文 | |
wp_meta | 原文 | ||||
feed_links | 2.8↑ | サイト全体のフィードへのリンクを表示 | 原文 | ||
feed_links_extra | 2.8↑ | その他のフィード(カテゴリ等)へのリンクを表示 | 原文 | ||
ログイン/ログアウト | |||||
wp_register | 1.5↑ | ユーザ登録/サイト管理リンクを表示 | - | 前後テキスト | 原文 |
wp_loginout | 1.5↑ | ログイン/ログアウトリンクを表示 | - | リダイレクト | 原文 |
wp_logout_url | 2.7↑ | 原文 | |||
wp_login_url | 2.7↑ | 原文 | |||
wp_login_form | 3.0↑ | 原文 | |||
wp_lostpassword_url | 2.8↑ | 原文 | |||
ナビゲーションメニュー | |||||
wp_page_menu | 2.7↑ | 「ホーム」へのリンク付き(任意)で「ページ」一覧を表示/取得 | - | 原文 | |
wp_list_pages | 1.5↑ | 「ページ」一覧を表示/取得 | - | 表示/取得、ソート順、除外/表示ページ、表示階層の深さ、サブページ指定、日付表示、見出し有無 | 原文 |
wp_dropdown_pages | 「ページ」一覧をセレクトボッックス(ドロップダウンメニュー)で表示 | - | 原文 | ||
→ ナビゲーションメニュー・タグ | |||||
その他 | |||||
the_search_query | 2.1↑ | 現在の検索文字列を表示。 取得するには get_search_query |
原文 | ||
paginate_links | 2.1↑ | 原文 | |||
rss_enclosure | 1.5↑ | 記事の音声・動画ファイルへのリンクを RSSフィード内に挿入(ポッドキャスト向け) | - | 原文 |
ソースコード:
Geo(Geographic)機能は、WordPress 1.5 からプラグインによる実装となりました。括弧内のタグはプラグイン版です。
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
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 | 現在また指定した記事の編集リンクを表示。 編集画面のURIを取得するには get_edit_post_link |
|
リンク・前後の文字列、投稿ID | 原文 | |
edit_comment_link | 現在のコメントの編集リンクを表示。 編集画面のURIを取得するには get_edit_comment_link |
ループ・コメントループ中 | リンク・前後の文字列 | 原文 | |
edit_tag_link | 2.7↑ | タグ編集画面へのリンクを表示。 編集画面のURIを取得するには get_edit_tag_link |
リンク文字列、前後の文字列、タグ | 原文 | |
edit_bookmark_link | 2.7↑ | リンク編集画面へのリンクを表示。 編集画面のURIを取得するには get_edit_bookmark_link |
リンク・前後の文字列、リンクID | 原文 | |
アーカイブページへのリンク | |||||
get_year_link | 任意の年別アーカイブページのURIを取得 | 年 | 原文 | ||
get_month_link | 任意の月別アーカイブページのURIを取得 | 年・月 | 原文 | ||
get_day_link | 任意の日別アーカイブページのURIを取得 | 年・月・日 | 原文 | ||
get_search_link | 3.0↑ | 検索結果ページのURIを取得 | クエリ文字列 | 原文 | |
フィードへのリンク | |||||
the_feed_link | 3.0↑ | 指定したフィード種別のパーマリンクを表示 | リンク文字列、フィード種別 | 原文 | |
get_feed_link | 指定したフィード種別のパーマリンクURIを取得 | フィード種別 | 原文 | ||
post_comments_feed_link | 2.5↑ | 現在または指定した投稿のコメントフィードのパーマリンクを表示 | リンク文字列、投稿ID、フィード種別 | 原文 | |
get_post_comments_feed_link | 2.2↑ | 現在または指定した投稿のコメントフィードのURIを取得 | 投稿ID、フィード種別 | 原文 | |
get_author_feed_link | 2.5↑ | 指定した執筆者の執筆者アーカイブページのフィードURIを取得 | 執筆者ID(ユーザID)、フィード種別 | 原文 | |
get_category_feed_link | 2.5↑ | 指定したカテゴリのカテゴリアーカイブページのフィードURIを取得 | カテゴリID、フィード種別 | 原文 | |
get_tag_feed_link | 2.3↑ | 指定したタグのタグアーカイブページのフィードURIを取得 | タグID、フィード種別 | 原文 | |
get_search_feed_link | 2.5 | 検索結果のフィードURIを取得 | 検索クエリ、フィード種別 | 原文 | |
get_search_comments_feed_link | 2.5 | 検索結果のコメントフィードURIを取得 | 検索クエリ、フィード種別 | 原文 | |
前後ページへのリンク | |||||
next_posts_link | アーカイブページで次のページ(通常は古い記事)へのリンクを表示。 取得するには get_next_posts_link、URIを取得するには next_posts |
- | リンク文字列、最大ページ数 | 原文 | |
previous_posts_link | アーカイブページで前のページ(通常は新しい記事)へのリンクを表示。 取得するには get_previous_posts_link、URIを取得するには previous_posts |
- | ラベル(リンクテキスト)、最大ページ数 | 原文 | |
posts_nav_link | index・カテゴリ・アーカイブページなどで前後のページへのリンクを表示。 取得するには get_posts_nav_link |
前後リンク間の区切り文字、リンク文字列 | 原文 | ||
next_comments_link | 2.7↑ | 単体ページでコメントを改ページする場合に、次ページへのリンクを表示。 取得するには get_next_comments_link |
リンク文字列、最大ページ | 原文 | |
previous_comments_link | 2.7↑ | 単体ページでコメントを改ページする場合に、前ページへのリンクを表示。 取得するには get_previous_comments_link |
原文 | ||
paginate_comments_links | 2.7↑ | 単体ページでコメントを改ページする場合に、ページ番号リンクを表示/取得 | 原文 | ||
サイト・ディレクトリへのリンク | |||||
home_url | 3.0↑ | 原文 | |||
get_home_url | 3.0↑ | 原文 | |||
site_url | 2.6↑ | 原文 | |||
get_site_url | 3.0↑ | 原文 | |||
admin_url | 2.6↑ | 原文 | |||
get_admin_url | 3.0↑ | 原文 | |||
includes_url | 2.6↑ | 原文 | |||
content_url | 2.6↑ | 原文 | |||
plugins_url | 2.6↑ | 原文 | |||
network_site_url | 3.0↑ | 原文 | |||
network_home_url | 3.0↑ | 原文 | |||
network_admin_url | 3.0↑ | 原文 | |||
短縮リンク | |||||
the_shortlink | 3.0↑ | 現在の記事の短縮リンクを表示 | ループ中 | リンク文字列、title属性の値、前後の文字列 | 原文 |
wp_get_shortlink | 3.0↑ | 原文 | |||
wp_shortlink_wp_head | 3.0↑ | 原文 | |||
wp_shortlink_header | 3.0↑ | 原文 |
ソースコード: wp-includes/link-template.php
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
wp_list_bookmarks | 2.1↑ | リンク集(ブックマーク(ブログロール)一覧)を表示/取得 | 表示/取得、ソート順ほか多数 | 原文 | |
get_bookmarks | 2.1↑ | 原文 | |||
|
2.3 から非推奨 | リンク管理画面で「表示:はい」になっている全てのリンクを、カテゴリ順に表示する。リンクカテゴリ画面の「カテゴリー設定」は有効だが「フォーマット」は無視される。 → wp_list_bookmarks |
ソート順(カテゴリ名順/カテゴリID順。昇順/降順はアンダーバーで) | 原文 | |
|
2.3 から非推奨 | パラメータで指定したカテゴリIDに属するリンクを表示。各リンクはカテゴリの「フォーマット」で設定したタグで括られるので、もしそれが <li> タグなら、<ul> タグや見出しの追加が必要。→ get_bookmarks |
原文 | ||
|
2.3 から非推奨 | → get_bookmarks | 原文 | ||
|
2.1 から非推奨 | 全カテゴリまたは指定したカテゴリのリンクを、パラメータの条件に従って表示 → wp_get_links |
原文 | ||
|
2.1 から非推奨 | → get_links | 原文 |
ソースコード: wp-includes/bookmark-template.php
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
wp_nav_menu | 3.0↑ | ナビゲーションメニューを表示/取得 | 原文 | ||
wp_get_nav_menu_item | 3.0↑ | 原文 |
ソースコード: wp-includes/nav-menu-template.php
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
the_permalink | 現在の記事のパーマリンクURIを表示 | ループ中 | - | 原文 | |
get_permalink | 指定した記事のパーマリンクURIを取得。ループ中でパラメータなしで使うと、現在の記事のパーマリンクURIを取得。 | - | 記事ID | 原文 | |
permalink_anchor | 現在の記事へのアンカータグ(<a id="....)を出力 | ループ中 | id 属性の値(記事ID/スラッグ) | 原文 | |
get_post_permalink | 3.0↑ | 現在の、または指定した投稿のパーマリンクURIをカスタム投稿種別付きで取得(?) | 原文 | ||
|
2.3 から非推奨 | (フィード用) → the_permalink_rss | 原文 |
ソースコード: wp-includes/link-template.php
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
the_ID | 現在の記事の記事IDを表示。取得するには get_the_ID | ループ中 | - | 原文 | |
the_title | 現在の記事のタイトルを表示/取得 | ループ中 | 表示/取得、前後テキスト | 原文 | |
the_title_attribute | 2.3↑ | 現在の記事のタイトルを表示/取得。HTMLタグ除去・文字実体参照に変換 | ループ中 | 表示/取得、前後テキスト | 原文 |
get_the_title | 原文 | ||||
single_post_title | 単体記事ページのときに記事タイトルを表示/取得 | - | 表示/取得、前テキスト | 原文 | |
the_title_rss | (フィード用) | 原文 | |||
the_content | 現在の記事の本文を表示。記事中に <!--more--> がある場合、単体記事ページ以外ではそれより前の部分を表示し「続きを読む」リンクを添える。 | ループ中 | 「続きを読む」の文言、 | 原文 | |
get_the_content | 原文 | ||||
|
2.9 から非推奨 | (フィード用) → the_content_feed | 原文 | ||
the_excerpt | 現在の記事の抜粋文を表示。HTMLタグや画像は除外。「抜粋表示オプション」が空なら最初の120語を出力。抜粋されずに長文となるときは日本語・マルチバイト特有の問題を参照 | ループ中 | - | 原文 | |
get_the_excerpt | 原文 | ||||
the_excerpt_rss | (フィード用) | 原文 | |||
body_class | 2.8↑ | ページ種類に応じた class 属性を表示。body 要素で使用。取得するには get_body_class |
class 属性に追加したい文字列 | 原文 | |
post_class | 2.7↑ | 各投稿に応じた classs 属性を表示。取得するには get_post_class | 原文 | ||
sticky_class | 2.7↑ | 原文 | |||
post_password_required | 2.7↑ | 原文 | |||
wp_link_pages | 改ページ(<!--nextpage-->)されている記事に各ページへのリンクを表示 | ループ中 | 前後テキスト、ページ番号/次頁、リンクフォーマット、リンク表示先 | 原文 | |
|
2.1から非推奨 | → wp_link_pages | 原文 | ||
カスタムフィールド | |||||
the_meta | 現在の記事のメタ情報(カスタムフィールドの「キー:値」の組)を番号なし箇条書きリストで表示 | ループ中 | - | 原文 | |
紐付けメディア | |||||
the_attachment_link | 原文 | ||||
wp_get_attachment_link | 2.5↑ | 原文 | |||
get_attachment_link | 現在または指定した記事に紐付けされたメディアのパーマリンクを取得 | 原文 | |||
wp_attachment_is_image | 2.1↑ | 原文 | |||
wp_get_attachment_image | 2.5↑ | 原文 | |||
wp_get_attachment_image_src | 2.5↑ | 原文 | |||
wp_get_attachment_metadata | 2.1↑ | 原文 | |||
→ 投稿サムネイルタグ | |||||
前後の記事へのリンク | |||||
next_post_link | 単体記事ページで次の記事へのリンクを表示 | ループ中 | 表示フォーマット、リンクテキスト、同一カテゴリ、除外カテゴリ | 原文 | |
previous_post_link | 単体記事ページで前の記事へのリンクを表示 | ループ中 | 表示フォーマット、リンクテキスト、同一カテゴリ、除外カテゴリ | 原文 | |
|
非推奨 | → next_post_link | 原文 | ||
|
非推奨 | → previous_post_link | 原文 |
ソースコード:
投稿サムネイルタグ
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
the_post_thumbnail | 2.9↑ | 現在の記事の投稿サムネイルを表示 | ループ中 | サイズ、属性 | 原文 |
get_the_post_thumbnail | 2.9↑ | 現在または指定した記事の投稿サムネイルを取得 | - | 投稿ID、サイズ、属性 | 原文 |
has_post_thumbnail | 2.9↑ | 現在または指定した記事に投稿サムネイルがあるか判定 | 投稿ID | 原文 | |
get_post_thumbnail_id | 2.9↑ | 現在または指定した記事の投稿サムネイルIDを取得 | 投稿ID | 原文 |
ソースコード: wp-includes/post-thumbnail-template.php
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
the_tags | 2.3↑ | 現在の記事のタグ一覧を表示 | ループ中 | 前・後・区切り文字 | 原文 |
get_the_tags | 2.3↑ | 現在の記事のタグ情報を配列で取得 | ループ中 | 原文 | |
get_the_tag_list | 2.3↑ | 現在の記事のタグを HTML文字列に整形して取得 | ループ中 | 前・後・区切り文字 | 原文 |
single_tag_title | 2.3↑ | 現在のタグアーカイブページのタグ名を表示/取得 | - | 表示/取得、接頭辞 | 原文 |
get_tag_link | 2.3↑ | 原文 | |||
tag_description | 2.8↑ | 原文 | |||
wp_tag_cloud | 2.3↑ | タグクラウドを表示 | - | 文字サイズ、表示数・順序・形式、除外/対象タグ | 原文 |
wp_generate_tag_cloud | 2.3↑ | 原文 |
ソースコード: wp-includes/category-template.php
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
trackback_url | 現在の記事のトラックバック URI を表示/取得 | ループ中 | 表示/取得 | 原文 | |
|
3.0 から非推奨 | 現在の記事のトラックバック RDF 情報を出力。トラックバックURI を自動的に検出する Trackback Auto-Discovery 用コード(参考) 3.0 から非推奨。rel="trackback" を使用 |
ループ中 | - | 原文 |
ソースコード: wp-includes/comment-template.php
クエリタグ
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
get_posts | マルチループ(複数ループ)作成時の条件指定 | 原文 | |||
query_posts | 1.5↑ | ループの前に書くことで、ページに表示する記事をコントロール | ループ前 | カテゴリ、著者、記事、日時、ソート順、表示数、改ページ、オフセット | 原文 |
rewind_posts | 原文 | ||||
wp_reset_query | 原文 |
脚注
外部資料
最新英語版: WordPress Codex » Template Tags (最新版との差分)