当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「テンプレートタグ/the tags」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/the_tags 2007年6月13日 (水) 00:17 Johannes Ries 版)
 
(カスタム分類に関する注意: 和訳を修正。)
 
(5人の利用者による、間の15版が非表示)
1行目: 1行目:
{{stub}}
+
<div id="Description">
-----
+
== 説明 ==
<p style="color:#c00;">'''Note: This function is only available in WordPress 2.3 or newer.'''</p>
+
</div>
-----
+
== Description ==
+
This template tag will become available with WordPress '''Version 2.3''', displays a link to the tag or tags a post belongs to. This tag should be used within [[The Loop]].
+
  
== Usage ==
+
このテンプレートタグは、現在の記事に付けられたタグを表示します。
%%% <?php the_tags('before', 'separator', 'after'); ?> %%%
+
各タグは、そのタグのアーカイブページへリンクします。
 +
タグが付けられていない場合は、何も表示しません。
 +
必ず[[:ja:The Loop|ループ]]の中で使います。
  
== Examples ==
+
<div id="Usage">
Displays a list of the tags with a linebreak after it.
+
== 使い方 ==
%%% <?php the_tags('Tags:', ',', '<br />'); ?> %%%
+
</div>
  
===Default Usage===
+
<?php the_tags( $before, $sep, $after ); ?>
The default usage lists tags with each tag (if more than one) separated by a comma (,) and preceded with the default text '''Tags: '''.
+
 
 +
<div id="Parameters">
 +
 
 +
== パラメータ ==
 +
</div>
 +
 
 +
; $before
 +
: (''文字列'') タグ一覧の前に表示する文字列。初期値は '''Tags: '''。
 +
; $sep
 +
: (''文字列'') 各タグリンクの間に表示する文字列・記号。初期値では、各タグ間をコンマ(<code>,</code>)で区切ります。
 +
; $after
 +
: (''文字列'') 最後のタグに続けて表示する文字列。初期値では何も表示しません。
 +
 
 +
<div id="Return_Values">
 +
== 戻り値 ==
 +
</div>
 +
 
 +
なし。
 +
 
 +
<div id="Examples">
 +
== 用例 ==
 +
</div>
 +
 
 +
<div id="Default_Usage">
 +
=== デフォルトでの使用 ===
 +
</div>
 +
 
 +
デフォルトのまま使うと、各タグ(複数のとき)をコンマ( , )で区切り、先頭に '''Tags: ''' という文字付きで、タグの一覧を表示します。
  
 
<pre><p><?php the_tags(); ?></p></pre>
 
<pre><p><?php the_tags(); ?></p></pre>
  
<div style="border:1px solid blue; width:50%; padding:10px">Tags: [[#Examples|WordPress]], [[#Examples|Computers]], [[#Examples|Blogging]]</div>
+
<div class="example">Tags: [[#Examples|WordPress]], [[#Examples|Computers]], [[#Examples|Blogging]]</div>
 +
 
 +
<div id="Separated_by_Commas">
 +
=== コンマで区切る ===
 +
</div>
 +
 
 +
タグの一覧をコンマ区切りで表示した後、改行します。
 +
<pre> <?php the_tags( 'Tags: ', ', ', '<br />' ); ?> </pre>
 +
 
 +
<div id="Separated_by_Arrow">
 +
=== 矢印で区切る ===
 +
</div>
 +
 
 +
各タグを矢印(&gt;)で区切り、先頭に '''Social tagging: ''' という文字を付けて、タグへのリンクを表示します。
 +
 
 +
<pre><?php the_tags( 'Social tagging: ',' > ' ); ?></pre>
 +
 
 +
<div class="example">Social tagging: [[#Examples|WordPress]] > [[#Examples|Computers]] > [[#Examples|Blogging]]</div>
 +
 
 +
<div id="Separated_by_a_Bullet">
 +
=== 中点で区切る ===
 +
</div>
 +
 
 +
各タグを中点(&bull;)で区切り、先頭に '''Tagged with: ''' という文字を付けて、タグへのリンクを表示し、その後で改行します。
 +
 
 +
<pre><?php the_tags( 'Tagged with: ', ' &bull; ', '<br />' ); ?></pre>
 +
 
 +
<div class="example">Tagged with: [[#Examples|WordPress]] &bull; [[#Examples|Computers]] &bull; [[#Examples|Blogging]]</div>
 +
 
 +
<div id="A_List_Example">
 +
=== リスト表示 ===
 +
</div>
 +
 
 +
タグのリストを (X)HTML の順不同リストで表示します。
 +
 
 +
<pre><?php the_tags( '<ul><li>', '</li><li>', '</li></ul>' ); ?></pre>
 +
 
 +
<div style="padding: 10px; width: 50%; border:solid 1px blue"><ul><li>[[#Examples|WordPress]]</li><li>[[#Examples|Computers]]</li><li>[[#Examples|Blogging]]</li></ul></div>
 +
 
 +
=== カテゴリとタグの統合<!-- 英語版に無 --~~~~ --> ===
 +
 
 +
既にある記事にカテゴリを付けていて、これからタグを付けようとする場合、各記事のカテゴリとタグを一つのリストにまとめたいと思うかもしれません。例えば、ある記事に Culture と Media というカテゴリを付けていて、「Arts」と「Painting」というタグを新たに付けたとすると、読者にとってわかりやすく、シンプルに見せるために、以下のように表示したいと思うかもしれません。
 +
 
 +
<div style="padding: 10px; width: 50%; border:solid 1px blue">
 +
Tags: Culture, Media, Arts, Painting
 +
</div>
 +
 
 +
以下のコードを使えば、カテゴリもタグも、設定されているときだけ表示されます。
 +
 
 +
<pre>
 +
Tags:
 +
<?php if (the_category(', '))  the_category(); ?>
 +
<?php if (get_the_tags()) the_tags(); ?>
 +
</pre>
 +
 
 +
<div id="Source_Code">
 +
== ソースコード ==
 +
</div>
 +
 
 +
* <tt>the_tags()</tt> は {{Trac|wp-includes/category-template.php}} にあります。
  
===Separated by Arrow===
+
<div id="Change Log">
Displays links to tags with an arrow (&gt;) separating the tags and preceded with the text '''Social tagging:'''
+
== 変更履歴 ==
 +
</div>
  
<pre><?php the_tags('Social tagging: ',' > '); ?></pre>
+
バージョン [[Version 2.3|2.3.0]] から導入されました。
  
<div style="padding: 10px; width: 50%; border:solid 1px blue">Social tagging: [[#Examples|WordPress]] > [[#Examples|Computers]] > [[#Examples|Blogging]]</div>
+
<div id="Note_About_Custom_Taxonomies">
 +
== カスタム分類に関する注意 ==
 +
</div>
  
===Separated by a Bullet===
+
独自のカスタム[[Post Types|投稿タイプ]]を使用している場合は、the_tags() と関連の関数が動作しません。[[関数リファレンス/the_terms|the_terms()]] およびその関連の関数を使用する必要があります。
  
Displays links to tags with a bullet (&bull;) separating the tags and preceded with the text '''Tagged with: ''' and followed by a line break.
 
  
<pre><?php the_tags('Tagged with: ',' &amp;bull; ',<br />'; ?></pre>
+
<div id="Related">
 +
== 関連項目 ==
 +
</div>
  
<div style="padding: 10px; width: 50%; border:solid 1px blue">Tagged with: [[#Examples|WordPress]] &bull; [[#Examples|Computers]] &bull; [[#Examples|Blogging]]</div>
+
{{Tag Tag Tags}}, [[関数リファレンス/the_taxonomies|the_taxonomies]]
  
== Parameters ==
+
{{Tag Post Tags}}
; before : (''string'') Text to display before the actual tags are displayed.  Defaults to '''Tags: '''
+
; separator : (''string'') Text or character to display between each tag link. The default is a comma (,) between each tag.
+
; after : (''string'') Text to display after the last tag.  The default is to display nothing.
+
  
== Related ==
+
{{Tag Footer}}
{{Tag Category Tags}}
+
  
{{PHP Function Tag Footer}}
+
{{DEFAULTSORT:the_tags}}
 +
[[Category:テンプレートタグ]]
 +
[[Category:wp2.3]]
  
[[Category:New page created]]
+
{{原文|Template Tags/the_tags|149675}} <!-- 18:25, 17 February 2015‎ Aternus 版 -->
  
 
[[en:Template Tags/the_tags]]
 
[[en:Template Tags/the_tags]]
 +
[[tr:Tema_Etiketleri/the tags]]
 +
[[ru:Теги_шаблонов/the_tags]]

2015年9月12日 (土) 17:02時点における最新版

このテンプレートタグは、現在の記事に付けられたタグを表示します。 各タグは、そのタグのアーカイブページへリンクします。 タグが付けられていない場合は、何も表示しません。 必ずループの中で使います。

使い方

<?php the_tags( $before, $sep, $after ); ?>

パラメータ

$before
文字列) タグ一覧の前に表示する文字列。初期値は Tags:
$sep
文字列) 各タグリンクの間に表示する文字列・記号。初期値では、各タグ間をコンマ(,)で区切ります。
$after
文字列) 最後のタグに続けて表示する文字列。初期値では何も表示しません。

戻り値

なし。

用例

デフォルトでの使用

デフォルトのまま使うと、各タグ(複数のとき)をコンマ( , )で区切り、先頭に Tags: という文字付きで、タグの一覧を表示します。

<p><?php the_tags(); ?></p>

コンマで区切る

タグの一覧をコンマ区切りで表示した後、改行します。

 <?php the_tags( 'Tags: ', ', ', '<br />' ); ?> 

矢印で区切る

各タグを矢印(>)で区切り、先頭に Social tagging: という文字を付けて、タグへのリンクを表示します。

<?php the_tags( 'Social tagging: ',' > ' ); ?>
Social tagging: WordPress > Computers > Blogging

中点で区切る

各タグを中点(•)で区切り、先頭に Tagged with: という文字を付けて、タグへのリンクを表示し、その後で改行します。

<?php the_tags( 'Tagged with: ', ' • ', '<br />' ); ?>
Tagged with: WordPressComputersBlogging

リスト表示

タグのリストを (X)HTML の順不同リストで表示します。

<?php the_tags( '<ul><li>', '</li><li>', '</li></ul>' ); ?>

カテゴリとタグの統合

既にある記事にカテゴリを付けていて、これからタグを付けようとする場合、各記事のカテゴリとタグを一つのリストにまとめたいと思うかもしれません。例えば、ある記事に Culture と Media というカテゴリを付けていて、「Arts」と「Painting」というタグを新たに付けたとすると、読者にとってわかりやすく、シンプルに見せるために、以下のように表示したいと思うかもしれません。

Tags: Culture, Media, Arts, Painting

以下のコードを使えば、カテゴリもタグも、設定されているときだけ表示されます。

Tags:
<?php if (the_category(', '))  the_category(); ?>
<?php if (get_the_tags()) the_tags(); ?>

ソースコード

変更履歴

バージョン 2.3.0 から導入されました。

カスタム分類に関する注意

独自のカスタム投稿タイプを使用している場合は、the_tags() と関連の関数が動作しません。the_terms() およびその関連の関数を使用する必要があります。



タグ: get_tag(), get_tag_link(), get_tags(), get_the_tag_list(), get_the_tags(), is_tag(), the_tags(), single_tag_title(), tag_description(), wp_generate_tag_cloud(), wp_tag_cloud() , the_taxonomies


投稿タグ: body_class(), next_image_link(), next_post_link(), next_posts_link(), post_class(), post_password_required(), posts_nav_link(), previous_image_link(), previous_post_link(), previous_posts_link(), single_post_title(), sticky_class(), the_category(), the_category_rss(), the_content(), the_content_rss(), the_excerpt(), the_excerpt_rss(), the_ID(), the_meta(), the_shortlink(), the_tags(), the_title(), the_title_attribute(), the_title_rss(), wp_link_pages(),


関数リファレンステンプレートタグ目次もご覧ください。

最新英語版: WordPress Codex » Template Tags/the_tags最新版との差分