- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
「テンプレートタグ」の版間の差分
(trunkを元に整備、general-template.php までで一旦保存: 未掲載タグ(主にget系)掲載、表示順整理等。) |
|||
76行目: | 76行目: | ||
|- | |- | ||
! [[/the_author | the_author]] | ! [[/the_author | the_author]] | ||
− | | <!--s--> || | + | | <!--s--> || 現在の記事の著者名(公開用)を表示。<br />取得するには [[/get_the_author|get_the_author]] || ループ中 || - || {{TagLink|the_author}} |
+ | |- | ||
+ | ! [[/the_modified_author | the_modified_author]] | ||
+ | | 2.8↑ || 現在の記事を最後に更新した執筆者名を表示。<br />取得するには [[/get_the_modified_author|get_the_modified_author]] || ループ中 || - || {{TagLink|the_modified_author}} | ||
+ | |- | ||
+ | ! [[/the_author_meta | the_author_meta]] | ||
+ | | 2.8↑ || 現在の、または指定した記事の著者・登録ユーザの各種情報を表示。<br />取得するには [[関数リファレンス/get_the_author_meta|get_the_author_meta]]/[[:en:Function Reference/get_the_author_meta|en]] || <!--l--> || 表示したい項目、ユーザID || {{TagLink|the_author_meta}} | ||
|- | |- | ||
! [[/the_author_link | the_author_link]] | ! [[/the_author_link | the_author_link]] | ||
85行目: | 91行目: | ||
|- | |- | ||
! [[/the_author_posts | the_author_posts]] | ! [[/the_author_posts | the_author_posts]] | ||
− | | <!--s--> || | + | | <!--s--> || 現在の記事の著者の投稿数を表示。<br />取得するには [[/get_the_author_posts|get_the_author_posts]] || ループ中 || - || {{TagLink|the_author_posts}} |
|- | |- | ||
! [[/the_author_posts_link | the_author_posts_link]] | ! [[/the_author_posts_link | the_author_posts_link]] | ||
| <!--s--> || 現在の記事の著者名(公開用)を著者アーカイブへのリンク付きで表示 || ループ中 || - || {{TagLink|the_author_posts_link}} | | <!--s--> || 現在の記事の著者名(公開用)を著者アーカイブへのリンク付きで表示 || ループ中 || - || {{TagLink|the_author_posts_link}} | ||
|- | |- | ||
− | ! [[/ | + | ! [[/get_author_posts_url | get_author_posts_url]] |
− | | 2. | + | | 2.1↑ || 現在の記事の著者の著者ページのURLを取得 || <!--l--> || 著者ID、著者名(公開用) || {{TagLink|get_author_posts_url}} |
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
! [[/wp_list_authors | wp_list_authors]] | ! [[/wp_list_authors | wp_list_authors]] | ||
− | | <!--s--> || ブログの著者一覧を表示。投稿があれば著者アーカイブへのリンク付き || - || 投稿数、管理者除外、表示名、未投稿者、フィードリンク || {{TagLink|wp_list_authors}} | + | | <!--s--> || ブログの著者一覧を表示。投稿があれば著者アーカイブへのリンク付き || - || 投稿数、管理者除外、表示名、未投稿者、フィードリンク || {{TagLink|wp_list_authors}}<!-- in wp-includes/user.php --> |
|- | |- | ||
! [[/wp_dropdown_users | wp_dropdown_users]] | ! [[/wp_dropdown_users | wp_dropdown_users]] | ||
142行目: | 145行目: | ||
|} | |} | ||
− | ソースコード: {{Source|wp-includes/author-template.php}} | + | ソースコード: {{Source|wp-includes/author-template.php|3.0}} |
<div id="Category_tags"> | <div id="Category_tags"> | ||
152行目: | 155行目: | ||
|- | |- | ||
! [[/the_category|the_category]] | ! [[/the_category|the_category]] | ||
− | | || | + | | || 現在の記事が属する全カテゴリを、そのカテゴリアーカイブへのリンク付きで表示 || ループ中 || 区切り文字、親カテゴリの併記 || {{TagLink|the_category}} |
+ | |- | ||
+ | ! [[/get_the_category|get_the_category]] | ||
+ | | <!--s--> || 現在の記事が属する各カテゴリの情報を取得。カテゴリID・カテゴリ名・カテゴリスラッグ・カテゴリ概要・親カテゴリが配列に格納されるので、好きに取り出して使う。 || ループ中 || - || {{TagLink|get_the_category}} | ||
+ | |- | ||
+ | ! [[/get_the_category_by_ID | get_the_category_by_ID]] | ||
+ | | <!--s--> || 指定したカテゴリのカテゴリ名を取得 || - || カテゴリID || {{TagLink|get_the_category_by_ID}} | ||
+ | |- | ||
+ | ! [[/get_the_category_list | get_the_category_list]] | ||
+ | | <!--s--> || HTMLリストまたはカスタム形式のカテゴリ一覧を取得 || - || 区切り文字、親カテゴリの表示方法、記事ID || {{TagLink|get_the_category_list}} | ||
+ | |- | ||
+ | ! [[/in_category|in_category]] | ||
+ | | <!--s--> || [[Conditional Tags|条件分岐タグ]]:現在の記事がパラメータで指定したカテゴリに属するとき true を返す || ループ中/ [[/in_category#ループ外で使う|ループ外]] || カテゴリID || {{TagLink|in_category}} | ||
+ | |- | ||
+ | ! [[/get_category_parents|get_category_parents]] | ||
+ | | <!--s--> || 現在の または 指定したカテゴリと、そこから最上位までの各カテゴリを取得 || - || <!--p--> || {{TagLink|get_category_parents}} | ||
+ | |- | ||
+ | ! [[関数リファレンス/get_category_link|get_category_link]] | ||
+ | | <!--s--> || 指定したカテゴリのURLを取得 || <!-- l --> || カテゴリID || [[:en:Function Reference/get_category_link|原文]] | ||
+ | |- | ||
+ | ! [[/category_description|category_description]] | ||
+ | | <!--s--> || 指定したカテゴリの概要を取得 || - || カテゴリID || {{TagLink|category_description}} | ||
|- | |- | ||
! [[/the_category_rss|the_category_rss]] | ! [[/the_category_rss|the_category_rss]] | ||
− | | <!--s--> || (フィード用) || <!--l--> || <!--p--> || {{TagLink|the_category_rss | + | | <!--s--> || (フィード用) || <!--l--> || <!--p--> || {{TagLink|the_category_rss}} |
|- | |- | ||
! <s>[[/the_category_ID|the_category_ID]]</s> | ! <s>[[/the_category_ID|the_category_ID]]</s> | ||
− | | 非推奨 || → get_the_category || <!--l--> || <!--p--> || {{TagLink|the_category_ID | + | | 非推奨 || → get_the_category || <!--l--> || <!--p--> || {{TagLink|the_category_ID}} |
|- | |- | ||
! <s>[[/the_category_head|the_category_head]]</s> | ! <s>[[/the_category_head|the_category_head]]</s> | ||
− | | 非推奨 || → get_the_category_by_ID, get_the_category || <!--l--> || <!--p--> || {{TagLink|the_category_head | + | | 非推奨 || → get_the_category_by_ID, get_the_category || <!--l--> || <!--p--> || {{TagLink|the_category_head}} |
|- | |- | ||
! [[/single_cat_title|single_cat_title]] | ! [[/single_cat_title|single_cat_title]] | ||
− | | <!--s--> || 現在のページのカテゴリ名を表示/取得 || - || 表示/取得、接頭辞 || {{TagLink|single_cat_title | + | | <!--s--> || 現在のページのカテゴリ名を表示/取得 || - || 表示/取得、接頭辞 || {{TagLink|single_cat_title}}<!-- in wp-includes/general-template.php --> |
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
! [[/wp_dropdown_categories|wp_dropdown_categories]] | ! [[/wp_dropdown_categories|wp_dropdown_categories]] | ||
− | | 2.1↑ || | + | | 2.1↑ || セレクトボックス(ドロップダウンメニューなど)を使ったカテゴリ一覧を表示/取得 || - || 表示/取得、ソート順ほか多数 || {{TagLink|wp_dropdown_categories}} |
|- | |- | ||
! <s>[[/dropdown_cats|dropdown_cats]]</s> | ! <s>[[/dropdown_cats|dropdown_cats]]</s> | ||
− | | 2.1 から非推奨 || → wp_dropdown_categories || <!--l--> || <!--p--> || {{TagLink|dropdown_cats | + | | 2.1 から非推奨 || → wp_dropdown_categories || <!--l--> || <!--p--> || {{TagLink|dropdown_cats}} |
|- | |- | ||
! [[/wp_list_categories|wp_list_categories]] | ! [[/wp_list_categories|wp_list_categories]] | ||
− | | 2.1↑ || | + | | 2.1↑ || リンク付きカテゴリ一覧を表示/取得 || - || 表示/取得、ソート順ほか多数 || {{TagLink|wp_list_categories}} |
|- | |- | ||
! <s>[[/list_cats|list_cats]]</s> | ! <s>[[/list_cats|list_cats]]</s> | ||
− | | 2.1 から非推奨 || | + | | 2.1 から非推奨 || リンク付きカテゴリ一覧を表示。<code>wp_list_cats</code> とはパラメータの書き方が異なる。2.0.x 系の EasyAll テーマで使用<br />→ wp_list_categories || - || <!--p--> || {{TagLink|list_cats}} |
|- | |- | ||
! <s>[[/wp_list_cats|wp_list_cats]]</s> | ! <s>[[/wp_list_cats|wp_list_cats]]</s> | ||
− | | 2.1 から非推奨 || | + | | 2.1 から非推奨 || リンク付きカテゴリ一覧を表示。そのリンク先はカテゴリアーカイブページ。2.0.x 系のデフォルトテーマで使用<br />→ wp_list_categories || - || <!--p--> || {{TagLink|wp_list_cats}} |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
|} | |} | ||
− | ソースコード: {{Source|wp-includes/category-template.php}} | + | ソースコード: {{Source|wp-includes/category-template.php|3.0}} |
<div id="Comment_tags"> | <div id="Comment_tags"> | ||
206行目: | 215行目: | ||
! タグ名 !! [[#status|status]] !! 概要 !! [[The Loop|ループ]] !! [[/タグパラメータの渡し方|パラメータ]] !! リンク | ! タグ名 !! [[#status|status]] !! 概要 !! [[The Loop|ループ]] !! [[/タグパラメータの渡し方|パラメータ]] !! リンク | ||
|- | |- | ||
− | ! | + | ! colspan="6" style="background-color: #f9f9f9;" | '''コメント表示''' |
− | + | ||
|- | |- | ||
− | ! [[/ | + | ! [[/wp_list_comments | wp_list_comments]] |
− | | <!-- | + | | 2.7↑ || 現在の投稿に対する全てのコメントを表示。従来のコメントループに替わるもの。参照: [[Migrating Plugins and Themes to 2.7/Enhanced Comment Display|コメント表示を WordPress 2.7以降に対応させる方法]] || <!--l--> || <!--p--> || {{TagLink|wp_list_comments}} |
|- | |- | ||
− | ! [[/ | + | ! [[/comment_author | comment_author]] |
− | | <!--s--> || | + | | <!--s--> || コメント投稿者名を表示。<br />取得するには [[/get_comment_author|get_comment_author]] || ループ中 || - || {{TagLink|comment_author}} |
|- | |- | ||
− | ! [[/ | + | ! [[/comment_author_email | comment_author_email]] |
− | | <!--s--> || | + | | <!--s--> || コメント投稿者のメールアドレスを表示。<br />取得するには [[/get_comment_author_email|get_comment_author_email]] || ループ中 || - || {{TagLink|comment_author_email}} |
|- | |- | ||
− | ! [[/ | + | ! [[/comment_author_email_link | comment_author_email_link]] |
− | | <!--s--> || | + | | <!--s--> || コメント投稿者へメールを送るリンクを表示。<br />取得するには [[/get_comment_author_email_link|get_comment_author_email_link]] || ループ中 || リンクラベルテキスト、前後テキスト || {{TagLink|comment_author_email_link}} |
|- | |- | ||
− | ! [[/ | + | ! [[/comment_author_link | comment_author_link]] |
− | | <!--s--> || | + | | <!--s--> ||コメント投稿者名と、もしあればサイトへのリンクを表示。<br />取得するには [[/get_comment_author_link|get_comment_author_link]]|| ループ中 || - || {{TagLink|comment_author_link}} |
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
! [[/comment_author_IP | comment_author_IP]] | ! [[/comment_author_IP | comment_author_IP]] | ||
− | | <!--s--> || コメント投稿者のIPアドレスを表示。 | + | | <!--s--> || コメント投稿者のIPアドレスを表示。<br />取得するには [[/get_comment_author_IP|get_comment_author_IP]] || ループ中 || - || {{TagLink|comment_author_IP}} |
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
! [[/comment_author_url | comment_author_url]] | ! [[/comment_author_url | comment_author_url]] | ||
− | | <!--s--> || コメント投稿者のサイトURLを表示。 | + | | <!--s--> || コメント投稿者のサイトURLを表示。<br />取得するには [[/get_comment_author_url|get_comment_author_url]] || ループ中 || - || {{TagLink|comment_author_url}} |
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
! [[/comment_author_url_link | comment_author_url_link]] | ! [[/comment_author_url_link | comment_author_url_link]] | ||
− | | <!--s--> || コメント投稿者のサイトへのリンクを表示。|| ループ中 || リンクラベルテキスト、前後テキスト || {{TagLink|comment_author_url_link | + | | <!--s--> || コメント投稿者のサイトへのリンクを表示。<br />取得するには [[/get_comment_author_url_link | get_comment_author_url_link]] || ループ中 || リンクラベルテキスト、前後テキスト || {{TagLink|comment_author_url_link}} |
|- | |- | ||
− | ! [[/ | + | ! [[/comment_class | comment_class]] |
− | | <!-- | + | | 2.7↑ || 各コメントの class 属性を表示/取得。<br />取得するには [[/get_comment_class|get_comment_class]] || <!--l--> || <!--p--> || {{TagLink|comment_class}} |
|- | |- | ||
− | ! [[/ | + | ! [[/comment_date | comment_date]] |
− | | <!--s--> || | + | | <!--s--> || コメント投稿日時を表示。<br />取得するには [[/get_comment_date|get_comment_date]] || ループ中 || 出力形式 || {{TagLink|comment_date}} |
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
! [[/comment_excerpt | comment_excerpt]] | ! [[/comment_excerpt | comment_excerpt]] | ||
− | | <!--s--> || コメント概要を表示。 || ループ中 || - || {{TagLink|comment_excerpt | + | | <!--s--> || コメント概要を表示。<br />取得するには [[/get_comment_excerpt|get_comment_excerpt]] || ループ中 || - || {{TagLink|comment_excerpt}} |
|- | |- | ||
− | ! [[/ | + | ! [[/comment_ID | comment_ID]] |
− | | <!--s--> || | + | | <!--s--> || コメントのIDを表示。<br />取得するには [[/get_comment_ID|get_comment_ID]] || ループ中 || - || {{TagLink|comment_ID}} |
|- | |- | ||
− | ! [[/ | + | ! [[/get_comment_link | get_comment_link]] |
− | | <!--s--> || | + | | <!--s--> || コメントのURLを取得 || <!--l--> || <!--p--> || {{TagLink|get_comment_link}} |
|- | |- | ||
− | ! [[/ | + | ! [[/comments_link | comments_link]] |
− | | <!--s--> || | + | | <!--s--> || 現在の投稿に対するコメントのURLを表示。<br />取得するには [[/get_comments_link|get_comments_link]] || ループ中 || - || {{TagLink|comments_link}} |
|- | |- | ||
− | ! [[/ | + | ! [[/comments_number | comments_number]] |
− | | <!--s--> || | + | | <!--s--> || 記事のコメント・トラックバック・ピンバックの合計数を表示。<br />取得するには [[/get_comments_number|get_comments_number]] || ループ中 || コメント数表示テキスト || {{TagLink|comments_number}} |
|- | |- | ||
− | ! [[/ | + | ! [[/comment_text | comment_text]] |
− | | <!--s--> || | + | | <!--s--> || コメント本文を表示。<br />取得するには [[/get_comment_text|get_comment_text]] || ループ中 || - || {{TagLink|comment_text}} |
|- | |- | ||
− | ! [[/ | + | ! [[/comment_time | comment_time]] |
− | | <!--s--> || | + | | <!--s--> || コメント投稿日時を表示。<br />取得するには [[/get_comment_time|get_comment_time]] || ループ中 || 出力形式 || {{TagLink|comment_time}} |
+ | |- | ||
+ | ! [[/comment_type | comment_type]] | ||
+ | | <!--s--> || フィードバックの種類を出力。<br />取得するには [[/get_comment_type|get_comment_type]] || ループ中 || 表示テキスト || {{TagLink|comment_type}} | ||
|- | |- | ||
! [[関数リファレンス/get_avatar|get_avatar]] | ! [[関数リファレンス/get_avatar|get_avatar]] | ||
− | | 2.5↑ || <!--概--> || <!--l--> || <!--p--> || [[:en:Function Reference/get_avatar|原文]] | + | | 2.5↑ || <!--概--> || <!--l--> || <!--p--> || [[:en:Function Reference/get_avatar|原文]]<!-- in wp-includes/pluggable.php --> |
|- | |- | ||
− | ! [[/ | + | ! colspan="6" style="background-color: #f9f9f9;" | '''コメント投稿フォーム''' |
− | | | + | |- |
+ | ! [[/comments_open | comments_open]] | ||
+ | | <!--s--> || 現在の投稿がコメントを受け付けているか否かを判定 || <!--l--> || <!--p--> || {{TagLink|comments_open}} | ||
+ | |- | ||
+ | ! [[/pings_open | pings_open]] | ||
+ | | <!--s--> || 現在の投稿がトラックバック・ピンバックを受け付けているか否かを判定 || <!--l--> || <!--p--> || {{TagLink|pings_open}} | ||
+ | |- | ||
+ | ! [[/comment_form|comment_form]] | ||
+ | | 3.0↑ || 標準化したコメント投稿欄(フォーム)を出力 || <!--l--> || <!--p--> || {{TagLink|comment_form}} | ||
+ | |- | ||
+ | ! [[/comments_popup_script | comments_popup_script]] | ||
+ | | <!--s--> || ポップアップコメントフォーム(次項)用のJavaScriptを出力。 || ループ外 || ポップアップウィンドウサイズ || {{TagLink|comments_popup_script}} | ||
+ | |- | ||
+ | ! [[/comments_popup_link | comments_popup_link]] | ||
+ | | <!--s--> || コメントフォームのポップアップへのリンクを表示。 || ループ中 || コメント数表示テキスト、CSSクラス || {{TagLink|comments_popup_link}} | ||
|- | |- | ||
! [[/comment_reply_link|comment_reply_link]] | ! [[/comment_reply_link|comment_reply_link]] | ||
− | | 2.7↑ || | + | | 2.7↑ || 既存コメントに返信するためのリンクを表示。<br />取得するには [[/get_comment_reply_link|get_comment_reply_link]] || <!--l--> || <!--p--> || {{TagLink|comment_reply_link}} |
+ | |- | ||
+ | ! [[/post_reply_link | post_reply_link]] | ||
+ | | 2.7↑ || <!--概 --><!-- Displays the HTML content for reply to post link. --> 取得するには [[/get_post_reply_link|get_post_reply_link]] || <!--l--> || <!--p--> || {{TagLink|post_reply_link}} | ||
|- | |- | ||
! [[/cancel_comment_reply_link|cancel_comment_reply_link]] | ! [[/cancel_comment_reply_link|cancel_comment_reply_link]] | ||
− | | 2.7↑ || | + | | 2.7↑ || 既存コメントへの返信を止める(コメント投稿欄を通常に戻す)ためのリンクを表示。<br />取得するには [[/get_cancel_comment_reply_link|get_cancel_comment_reply_link]] || <!--l--> || <!--p--> || {{TagLink|cancel_comment_reply_link}} |
+ | |- | ||
+ | ! [[/comment_id_fields|comment_id_fields]] | ||
+ | | 2.7↑ || <!--概--><br />取得するには [[/get_comment_id_fields|get_comment_id_fields]] || <!--l--> || <!--p--> || {{TagLink|comment_id_fields}} | ||
|- | |- | ||
! [[/comment_form_title|comment_form_title]] | ! [[/comment_form_title|comment_form_title]] | ||
| 2.7↑ || コメント投稿欄の見出しを表示 || <!--l--> || <!--p--> || {{TagLink|comment_form_title}} | | 2.7↑ || コメント投稿欄の見出しを表示 || <!--l--> || <!--p--> || {{TagLink|comment_form_title}} | ||
|- | |- | ||
− | ! | + | ! colspan="6" style="background-color: #f9f9f9;" | フィード用 |
− | + | ||
|- | |- | ||
− | ! [[/ | + | ! [[/comments_rss_link | comments_rss_link]] |
− | + | | <!--s--> || 記事コメントRSSフィードのURLを表示。 || ループ中 || リンクラベルテキスト、リンク先ファイル名 || {{TagLink|comments_rss_link}} | |
|- | |- | ||
− | ! [[/ | + | ! [[/comment_author_rss | comment_author_rss]] |
− | | | + | | <!--s--> || フィード用形式でコメント投稿者名を表示。 || ループ中 || - || {{TagLink|comment_author_rss}} |
+ | |- | ||
+ | ! [[/comment_text_rss | comment_text_rss]] | ||
+ | | <!--s--> || フィード用形式でコメント本文を表示。 || ループ中 || - || {{TagLink|comment_text_rss}} | ||
+ | |- | ||
+ | ! [[/comment_link_rss | comment_link_rss]] | ||
+ | | <!--s--> || フィード用形式でコメントへのリンクを表示。 || ループ中 || - || {{TagLink|comment_link_rss}} | ||
+ | |- | ||
+ | ! [[/permalink_comments_rss | permalink_comments_rss]] | ||
+ | | <!--s--> || フィード用形式でコメントがつけられた記事の固定リンクを表示。 || ループ中 || - || {{TagLink|permalink_comments_rss}} | ||
|} | |} | ||
307行目: | 334行目: | ||
|- | |- | ||
! [[/the_date_xml | the_date_xml]] | ! [[/the_date_xml | the_date_xml]] | ||
− | | <!--s--> || 現在の記事の投稿日を YYYY-MM-DD フォーマットで表示 || ループ中 || - || {{TagLink|the_date_xml | + | | <!--s--> || 現在の記事の投稿日を YYYY-MM-DD フォーマットで表示 || ループ中 || - || {{TagLink|the_date_xml}} |
|- | |- | ||
! [[/the_date | the_date]] | ! [[/the_date | the_date]] | ||
− | | <!--s--> || | + | | <!--s--> || 現在の記事の投稿日時を表示/取得。フォーマットを指定しなければ[[Settings General SubPanel|一般設定]]「日付のフォーマット」で表示。1ページに同一投稿日の記事があれば、その'''最初の記事にのみ出力'''。全記事に表示するには <code>the_time</code>、3.0以降は <code>get_the_date</code> も利用可能 || ループ中 || 日時フォーマット、前後の文字、表示/取得<br /> || {{TagLink|the_date}} |
|- | |- | ||
! [[/get_the_date | get_the_date]] | ! [[/get_the_date | get_the_date]] | ||
− | | 3.0↑ || < | + | | 3.0↑ || 現在の記事の投稿日時を取得。<code>the_date</code> とは異なり常に日時を取得できる。 || ループ中 || 日時フォーマット || {{TagLink|get_the_date}} |
|- | |- | ||
! [[/the_time | the_time]] | ! [[/the_time | the_time]] | ||
− | | <!--s--> || | + | | <!--s--> || 現在の記事の投稿日時を表示。フォーマットを指定しなければ[[Settings General SubPanel|一般設定]]「時間のフォーマット」で表示。 || ループ中 || 日時フォーマット || {{TagLink|the_time}} |
+ | |- | ||
+ | ! [[/get_the_time | get_the_time]] | ||
+ | | 1.5↑ || 現在の、または指定した記事の投稿日時を取得 || - || 日時フォーマット、投稿ID || {{TagLink|get_the_time}} | ||
+ | |- | ||
+ | ! [[/get_post_time | get_post_time]] | ||
+ | | 2.0↑ || <!--概 --> || <!--l--> || <!--p--> || {{TagLink|get_post_time}} | ||
|- | |- | ||
! [[/the_modified_date | the_modified_date]] | ! [[/the_modified_date | the_modified_date]] | ||
− | | 2.1↑ || | + | | 2.1↑ || 現在の記事の最終更新日時を表示/取得。フォーマットを指定しなければ[[Settings General SubPanel|一般設定]]「日付のフォーマット」で表示。<br />取得するには [[/get_the_modified_date|get_the_modified_date]] || ループ中 || 日時フォーマット、前後の文字列、表示/取得 || {{TagLink|the_modified_date}} |
|- | |- | ||
! [[/the_modified_time | the_modified_time]] | ! [[/the_modified_time | the_modified_time]] | ||
− | | 2.1↑ || | + | | 2.1↑ || 現在の記事の最終更新日時を表示。フォーマットを指定しなければ[[Settings General SubPanel|一般設定]]「時間のフォーマット」で表示。<br />取得するには [[/get_the_modified_time|get_the_modified_time]] || ループ中 || 日時フォーマット || {{TagLink|the_modified_time}} |
|- | |- | ||
− | ! [[/ | + | ! [[/get_post_modified_time | get_post_modified_time]] |
− | | | + | | 2.0↑ || <!--概 --> || <!--l--> || <!--p--> || {{TagLink|get_post_modified_time}} |
+ | |- | ||
+ | ! [[/the_weekday | the_weekday]] | ||
+ | | (非推奨?)<ref name="deprecated">このテンプレートタグは、原文では「Deprecated」と表示されていますが、ソースコード上はその扱いとなっていないようです。詳しくは[[{{TALKPAGENAME}}#非推奨となっているが deprecated.php にないタグ|ノート]]をご覧ください。</ref> || 現在の記事が投稿された曜日を表示 → the_time || ループ中 || - || {{TagLink|the_weekday}} | ||
+ | |- | ||
+ | ! [[/the_weekday_date | the_weekday_date]] | ||
+ | | (非推奨?)<ref name="deprecated" /> || 現在の記事が投稿された曜日を、前の記事と異なるときにのみ表示 → the_date を利用した the_time || ループ中 || 前後テキスト || {{TagLink|the_weekday_date}} | ||
|- | |- | ||
! [[/single_month_title | single_month_title]] | ! [[/single_month_title | single_month_title]] | ||
− | | <!--s--> || 現在のページの年月タイトルを表示/取得。月別アーカイブでのみ動作 || - || 表示/取得、前テキスト || {{TagLink|single_month_title | + | | <!--s--> || 現在のページの年月タイトルを表示/取得。月別アーカイブでのみ動作 || - || 表示/取得、前テキスト || {{TagLink|single_month_title}}<!-- wp-includes/general-template.php --> |
|- | |- | ||
− | ! [[/ | + | ! [[/wp_get_archives | wp_get_archives]] |
− | | <!--s--> || | + | | <!--s--> || 月別アーカイブリスト等、日付に基づくリンク付きアーカイブリストを表示。月別・日別・週別、最近の投稿 n件 || - || 種別、件数、リスト形式、前後の文字、記事数の表示 || {{TagLink|wp_get_archives}} |
|- | |- | ||
− | ! | + | ! <s>[[/get_archives | get_archives]]</s> |
− | + | | 2.1 から非推奨 || → wp_get_archives || <!--l--> || <!--p--> || {{TagLink|get_archives}} | |
|- | |- | ||
− | ! [[/ | + | ! [[/get_calendar | get_calendar]] |
− | | | + | | <!--s--> || カレンダーを表示。投稿のある日付は日別アーカイブへリンク || - || 曜日表示形式 || {{TagLink|get_calendar}} |
|} | |} | ||
− | ソースコード: {{Source|wp-includes/general-template.php}} | + | ソースコード: {{Source|wp-includes/general-template.php|3.0}} |
<div id="General_tags"> | <div id="General_tags"> | ||
== General タグ == | == General タグ == | ||
</div> | </div> | ||
− | |||
{| class="list" | {| class="list" | ||
! タグ名 !! [[#status|status]] !! 概要 !! [[The Loop|ループ]] !! [[/タグパラメータの渡し方|パラメータ]] !! リンク | ! タグ名 !! [[#status|status]] !! 概要 !! [[The Loop|ループ]] !! [[/タグパラメータの渡し方|パラメータ]] !! リンク | ||
+ | |- | ||
+ | ! colspan="6" style="background-color: #f9f9f9;" | '''サイト情報''' | ||
|- | |- | ||
! [[/bloginfo | bloginfo]] | ! [[/bloginfo | bloginfo]] | ||
− | | <!--s--> || 設置した WordPress の各種情報(主に管理画面の一般設定やユーザープロフィールの項目)を'''表示'''。値を''取得''するには <code>get_bloginfo</code>。sidebar.php や header.php でよく使われる。 || - || 表示したい項目(ブログ名、URI、RSS、文字コード、設置ディレクトリURI、ほか) || {{TagLink|bloginfo | + | | <!--s--> || 設置した WordPress の各種情報(主に管理画面の一般設定やユーザープロフィールの項目)を'''表示'''。値を''取得''するには <code>get_bloginfo</code>。sidebar.php や header.php でよく使われる。 || - || 表示したい項目(ブログ名、URI、RSS、文字コード、設置ディレクトリURI、ほか) || {{TagLink|bloginfo}} |
|- | |- | ||
! [[/bloginfo_rss | bloginfo_rss]] | ! [[/bloginfo_rss | bloginfo_rss]] | ||
− | | <!--s--> || (フィード用) || <!--l--> || <!--p--> || {{TagLink|bloginfo_rss | + | | <!--s--> || (フィード用) || <!--l--> || <!--p--> || {{TagLink|bloginfo_rss}} |
|- | |- | ||
! [[/get_bloginfo | get_bloginfo]] | ! [[/get_bloginfo | get_bloginfo]] | ||
− | | <!--s--> || <code>bloginfo</code> と同様の項目の値を'''取得''' || - || 取得したい項目(ブログ名、URI、RSS、文字コード、設置ディレクトリURI、ほか) || {{TagLink|get_bloginfo | + | | <!--s--> || <code>bloginfo</code> と同様の項目の値を'''取得''' || - || 取得したい項目(ブログ名、URI、RSS、文字コード、設置ディレクトリURI、ほか) || {{TagLink|get_bloginfo}} |
|- | |- | ||
! [[/get_bloginfo_rss | get_bloginfo_rss]] | ! [[/get_bloginfo_rss | get_bloginfo_rss]] | ||
− | | <!--s--> || (フィード用) || <!--l--> || <!--p--> || {{TagLink|get_bloginfo_rss | + | | <!--s--> || (フィード用) || <!--l--> || <!--p--> || {{TagLink|get_bloginfo_rss}} |
|- | |- | ||
! [[/wp_title | wp_title]] | ! [[/wp_title | wp_title]] | ||
− | | <!--s--> || | + | | <!--s--> || ウェブページの題名を取得/表示。<code><nowiki><title></nowiki></code> 要素などに使用 || - || 表示/取得、区切り文字 || {{TagLink|wp_title}} |
|- | |- | ||
− | ! [[/ | + | ! [[/wp_meta | wp_meta]] |
− | | <!--s--> || | + | | <!--s--> || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_meta}} |
|- | |- | ||
− | ! | + | ! colspan="6" style="background-color: #f9f9f9;" | '''ログイン/ログアウト''' |
− | + | ||
|- | |- | ||
− | ! [[/ | + | ! [[/wp_register | wp_register]] |
− | | | + | | 1.5↑ || ユーザ登録/サイト管理リンクを表示 || - || 前後テキスト || {{TagLink|wp_register}} |
|- | |- | ||
− | ! [[/ | + | ! [[/wp_loginout | wp_loginout]] |
− | | 1.5↑ || [[ | + | | 1.5↑ || ログイン/ログアウトリンクを表示 || - || リダイレクト || {{TagLink|wp_loginout}} |
+ | |- | ||
+ | ! [[/wp_logout_url | wp_logout_url]] | ||
+ | | 2.7↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_logout_url}} | ||
+ | |- | ||
+ | ! [[/wp_login_url | wp_login_url]] | ||
+ | | 2.7↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_login_url}} | ||
+ | |- | ||
+ | ! [[/wp_login_form | wp_login_form]] | ||
+ | | 3.0↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_login_form}} | ||
+ | |- | ||
+ | ! [[/wp_lostpassword_url | wp_lostpassword_url]] | ||
+ | | 2.8↑ || <!--概--> || <!--l--> || <!--p--> || {{TagLink|wp_lostpassword_url}} | ||
+ | |- | ||
+ | ! colspan="6" style="background-color: #f9f9f9;" | '''ナビゲーションメニュー'''<!-- wp-includes/post-template.php --> | ||
|- | |- | ||
! [[/wp_page_menu | wp_page_menu]] | ! [[/wp_page_menu | wp_page_menu]] | ||
− | | 2.7↑ || | + | | 2.7↑ || 「ホーム」へのリンク付き(任意)で[[Pages|「ページ」]]一覧を表示/取得 || - || <!--p--> || {{TagLink|wp_page_menu}} |
+ | |- | ||
+ | ! [[/wp_list_pages | wp_list_pages]] | ||
+ | | 1.5↑ || [[Pages|「ページ」]]一覧を表示/取得 || - || 表示/取得、ソート順、除外/表示ページ、表示階層の深さ、サブページ指定、日付表示、見出し有無 || {{TagLink|wp_list_pages}} | ||
|- | |- | ||
! [[/wp_dropdown_pages | wp_dropdown_pages]] | ! [[/wp_dropdown_pages | wp_dropdown_pages]] | ||
| <!--s--> || [[Pages|「ページ」]]一覧をセレクトボッックス(ドロップダウンメニュー)で表示 || - || <!--p--> || {{TagLink|wp_dropdown_pages}} | | <!--s--> || [[Pages|「ページ」]]一覧をセレクトボッックス(ドロップダウンメニュー)で表示 || - || <!--p--> || {{TagLink|wp_dropdown_pages}} | ||
|- | |- | ||
− | ! | + | ! colspan="6" style="background-color: #f9f9f9;" | '''その他''' |
− | + | ||
|- | |- | ||
− | ! [[/ | + | ! [[/feed_links | feed_links]] |
− | | | + | | 2.8↑ || サイト全体のフィードへのリンクを表示 || <!--l--> || <!--p--> || {{TagLink|feed_links}} |
|- | |- | ||
− | ! [[/ | + | ! [[/feed_links_extra | feed_links_extra]] |
− | | 2. | + | | 2.8↑ || その他のフィード(カテゴリ等)へのリンクを表示 || <!--l--> || <!--p--> || {{TagLink|feed_links_extra}} |
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
! [[/the_search_query | the_search_query]] | ! [[/the_search_query | the_search_query]] | ||
− | | 2.1↑ || | + | | 2.1↑ || 現在の検索文字列を表示。<br />取得するには [[/get_search_query|get_search_query]] || <!--l--> || <!--p--> || {{TagLink|the_search_query}} |
|- | |- | ||
− | ! [[/ | + | ! [[/paginate_links | paginate_links]] |
− | | | + | | 2.1↑ || <!--概 --> || <!--l--> || <!--p--> || {{TagLink|paginate_links}} |
|- | |- | ||
− | ! [[/ | + | ! [[/rss_enclosure | rss_enclosure]] |
− | | | + | | 1.5↑ || 記事の音声・動画ファイルへのリンクを RSSフィード内に挿入(ポッドキャスト向け) || <!--l--> || - || {{TagLink|rss_enclosure}} |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
|} | |} | ||
− | ソースコード: {{Source|wp-includes/general-template.php|3.0}} | + | ソースコード: |
+ | * {{Source|wp-includes/general-template.php|3.0}} | ||
+ | * {{Source|wp-includes/post-template.php|3.0}} | ||
+ | <!-- rsd_link, wlwmanifest_link, noindex, rich_edit_exists, user_can_richedit, wp_default_editor, the_editor, language_attributes, wp_admin_css_color, register_admin_color_schemes, wp_admin_css_uri, wp_admin_css, add_thickbox, wp_generator, the_generator, get_the_generator, checked, selected, disabled は掲載を保留。 --> | ||
<div id="Geo_tags"> | <div id="Geo_tags"> | ||
643行目: | 691行目: | ||
|- | |- | ||
! [[/single_post_title | single_post_title]] | ! [[/single_post_title | single_post_title]] | ||
− | | <!--s--> || 単体記事ページのときに記事タイトルを表示/取得 || - || 表示/取得、前テキスト || {{TagLink|single_post_title|t}} | + | | <!--s--> || 単体記事ページのときに記事タイトルを表示/取得 || - || 表示/取得、前テキスト || {{TagLink|single_post_title|t}}<!-- wp-includes/general-template.php --> |
|- | |- | ||
! [[/the_title_rss | the_title_rss]] | ! [[/the_title_rss | the_title_rss]] | ||
757行目: | 805行目: | ||
|- | |- | ||
! [[/single_tag_title | single_tag_title]] | ! [[/single_tag_title | single_tag_title]] | ||
− | | 2.3↑ || 現在のページのタグ名を表示/取得 || - || 表示/取得、接頭辞 || {{TagLink|single_tag_title}} | + | | 2.3↑ || 現在のページのタグ名を表示/取得 || - || 表示/取得、接頭辞 || {{TagLink|single_tag_title}}<!-- wp-includes/general-template.php --> |
|- | |- | ||
! [[関数リファレンス/get_tag_link | get_tag_link]] | ! [[関数リファレンス/get_tag_link | get_tag_link]] | ||
| 2.3↑ || <!-- 概 --> || <!-- l --> || <!-- p --> || [[:en:Function Reference/get_tag_link|原文]] | | 2.3↑ || <!-- 概 --> || <!-- l --> || <!-- p --> || [[:en:Function Reference/get_tag_link|原文]] | ||
+ | |- | ||
+ | ! [[/tag_description | tag_description]] | ||
+ | | 2.8↑ || <!-- 概 --> || <!-- l --> || <!-- p --> || {{TagLink|tag_description}} | ||
|- | |- | ||
! [[/wp_tag_cloud | wp_tag_cloud]] | ! [[/wp_tag_cloud | wp_tag_cloud]] | ||
767行目: | 818行目: | ||
! [[/wp_generate_tag_cloud | wp_generate_tag_cloud]] | ! [[/wp_generate_tag_cloud | wp_generate_tag_cloud]] | ||
| 2.3↑ || <!-- 概 --> || <!-- l --> || <!-- p --> || {{TagLink|wp_generate_tag_cloud}} | | 2.3↑ || <!-- 概 --> || <!-- l --> || <!-- p --> || {{TagLink|wp_generate_tag_cloud}} | ||
− | |||
− | |||
− | |||
|} | |} | ||
2010年4月17日 (土) 02:42時点における版
意見募集: 一覧表の形式について検討しています。このページのノートをご覧ください。
目次
テンプレートタグは、ブログのデータを動的に表示したり、個性的で面白いブログにカスタマイズしたりするときに、テンプレートの中で使います。下記は、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↑ | コメント投稿欄の見出しを表示 | 原文 | ||
フィード用 | |||||
comments_rss_link | 記事コメントRSSフィードのURLを表示。 | ループ中 | リンクラベルテキスト、リンク先ファイル名 | 原文 | |
comment_author_rss | フィード用形式でコメント投稿者名を表示。 | ループ中 | - | 原文 | |
comment_text_rss | フィード用形式でコメント本文を表示。 | ループ中 | - | 原文 | |
comment_link_rss | フィード用形式でコメントへのリンクを表示。 | ループ中 | - | 原文 | |
permalink_comments_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 | 原文 | ||||
ログイン/ログアウト | |||||
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 | 「ページ」一覧をセレクトボッックス(ドロップダウンメニュー)で表示 | - | 原文 | ||
その他 | |||||
feed_links | 2.8↑ | サイト全体のフィードへのリンクを表示 | 原文 | ||
feed_links_extra | 2.8↑ | その他のフィード(カテゴリ等)へのリンクを表示 | 原文 | ||
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 | 現在の記事の編集リンクを表示 | ループ中 | リンク・前後テキスト | 原文 | |
edit_comment_link | 現在のコメントの編集リンクを表示 | ループ・コメントループ中 | リンク・前後テキスト | 原文 | |
edit_tag_link | 2.7↑ | 原文 | |||
edit_bookmark_link | 2.7↑ | 原文 | |||
wp_link_pages | 改ページ(<!--nextpage-->)されている記事に各ページへのリンクを表示 | ループ中 | 前後テキスト、ページ番号/次頁、リンクフォーマット、リンク表示先 | 原文 | |
|
2.1から非推奨 | → wp_link_pages | 原文 | ||
get_year_link | 任意の年別アーカイブページの URI を取得 | 年 | 原文 | ||
get_month_link | 任意の月別アーカイブページの URI を取得 | 年・月 | 原文 | ||
get_day_link | 任意の日別アーカイブページの URI を取得 | 年・月・日 | 原文 | ||
previous_posts_link | アーカイブページで前のページ(通常は新しい記事)へのリンクを表示 | - | ラベル(リンクテキスト)、最大ページ数 | 原文 | |
next_posts_link | アーカイブページで次のページ(通常は古い記事)へのリンクを表示 | - | ラベル(リンクテキスト)、最大ページ数 | 原文 | |
previous_comments_link | 2.7↑ | コメントを改ページする場合に、前ページへのリンクを表示 | 原文 | ||
next_comments_link | 2.7↑ | コメントを改ページする場合に、次ページへのリンクを表示 | 原文 | ||
paginate_comments_links | 2.7↑ | 原文 | |||
get_post_permalink | 3.0↑ | 原文 | |||
the_feed_link | 3.0↑ | 原文 | |||
get_search_link | 3.0↑ | 原文 | |||
home_url | 3.0↑ | 原文 | |||
get_home_url | 3.0↑ | 原文 | |||
get_site_url | 3.0↑ | 原文 | |||
get_admin_url | 3.0↑ | 原文 | |||
wp_ajaxurl | 3.0↑ | 原文 | |||
wp_get_shortlink | 3.0↑ | 原文 | |||
wp_shortlink_wp_head | 3.0↑ | 原文 | |||
wp_shortlink_header | 3.0↑ | 原文 | |||
the_shortlink | 3.0↑ | 原文 |
ソースコード: wp-includes/link-template.php
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
|
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_list_bookmarks | 2.1↑ | ブックマーク(ブログロール)一覧を表示/取得 | 表示/取得、ソート順ほか多数 | 原文 | |
get_bookmarks | 2.1↑ | 原文 |
ソースコード: wp-includes/bookmark-template.php
ナビゲーションメニュー・タグ
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
wp_nav_menu | 3.0↑ | ナビゲーションメニューを表示/取得 | 原文 | ||
wp_get_nav_menu | 3.0↑ | ナビゲーションメニューを取得 | 原文 | ||
wp_get_nav_menu_item | 3.0↑ | 原文 |
ソースコード: wp-includes/nav-menu-template.php
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
get_permalink | 指定した記事のパーマリンクURI を取得。ループ中でパラメータなしで使うと、現在の記事のパーマリンクURI を取得。 | - | 記事ID | 原文 | |
the_permalink | 現在の記事のパーマリンクURI を表示 | ループ中 | - | 原文 | |
permalink_single_rss | (フィード用) | 原文 | |||
permalink_anchor | 現在の記事へのアンカータグ(<a id="....)を出力 | ループ中 | id 属性の値(記事ID/スラッグ) | 原文 |
ソースコード: wp-includes/link-template.php
While in The Loop, these values can be accessed through the $post object.
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
the_ID | 現在の記事の記事ID を表示 | ループ中 | - | 原文 | |
the_title | 現在の記事のタイトルを表示/取得 | ループ中 | 表示/取得、前後テキスト | 原文 | |
the_title_attribute | 2.3↑ | 現在の記事のタイトルを表示/取得。HTMLタグ除去・文字実体参照に変換 | ループ中 | 表示/取得、前後テキスト | 原文 |
single_post_title | 単体記事ページのときに記事タイトルを表示/取得 | - | 表示/取得、前テキスト | 原文 | |
the_title_rss | (フィード用) | 原文 | |||
the_content | 現在の記事の本文を表示。記事中に <!--more--> がある場合、単体記事ページ以外ではそれより前の部分を表示し「続きを読む」リンクを添える。 | ループ中 | 「続きを読む」の文言、 | 原文 | |
|
2.9 から非推奨 | (フィード用) | 原文 | ||
the_excerpt | 現在の記事の抜粋文を表示。HTMLタグや画像は除外。「抜粋表示オプション」が空なら最初の120語を出力。抜粋されずに長文となるときは日本語・マルチバイト特有の問題を参照 | ループ中 | - | 原文 | |
the_excerpt_rss | (フィード用) | 原文 | |||
next_post_link | 単体記事ページで次の記事へのリンクを表示 | ループ中 | 表示フォーマット、リンクテキスト、同一カテゴリ、除外カテゴリ | 原文 | |
previous_post_link | 単体記事ページで前の記事へのリンクを表示 | ループ中 | 表示フォーマット、リンクテキスト、同一カテゴリ、除外カテゴリ | 原文 | |
next_posts_link | アーカイブページで次のページ(通常は古い記事)へのリンクを表示 | - | ラベル(リンクテキスト)、最大ページ数 | 原文 | |
previous_posts_link | アーカイブページで前のページ(通常は新しい記事)へのリンクを表示 | - | ラベル(リンクテキスト)、最大ページ数 | 原文 | |
|
非推奨 | → next_post_link | 原文 | ||
|
非推奨 | → previous_post_link | 原文 | ||
posts_nav_link | index・カテゴリ・アーカイブページなどで前後のページへのリンクを表示 | 前後リンク間の文字、リンクテキスト | 原文 | ||
sticky_class | 2.7↑ | 原文 | |||
post_password_required | 2.7↑ | 原文 | |||
the_meta | 現在の記事のメタ情報(カスタムフィールドの「キー:値」の組)を番号なし箇条書きリストで表示 | ループ中 | - | 原文 | |
the_tags | 2.3↑ | 現在の記事のタグ一覧を表示 | ループ中 | 前・後・区切り文字 | 原文 |
the_attachment_link | 原文 | ||||
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↑ | 原文 | |||
body_class | 2.8↑ | ページ種類に応じた class 属性を表示。body 要素で使用 |
class 属性に追加したい文字列 | 原文 | |
post_class | 2.7↑ | 原文 |
ソースコード: wp-includes/post-template.php
投稿サムネイルタグ
タグ名 | status | 概要 | ループ | パラメータ | リンク |
---|---|---|---|---|---|
the_post_thumbnail | 2.9↑ | 原文 | |||
get_the_post_thumbnail | 2.9↑ | 原文 | |||
has_post_thumbnail | 2.9↑ | 原文 | |||
get_post_thumbnail_id | 2.9↑ | 原文 |
ソースコード: 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 (最新版との差分)