- サイトデザイン工事中です。ご意見をお寄せください。
- 赤色のリンクは、まだ日本語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↑ | 添付されている画像をPHPのデータとして取得 | 原文 | ||
| 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 (最新版との差分)
pt-br:Template Tags