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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(Gblsmトーク)による第7140版を取り消し)
(誤記訂正。)
2行目: 2行目:
 
== 説明 ==
 
== 説明 ==
 
</div>
 
</div>
このテンプレートタグは、現在の記事に付けられたタグへのリンクを表示します。
+
 
 +
このテンプレートタグは、現在の記事に付けられたタグを表示します。
 +
各タグは、そのタグのアーカイブページへリンクします。
 
タグが付けられていない場合は、何も表示しません。
 
タグが付けられていない場合は、何も表示しません。
 
必ず[[:ja:The Loop|ループ]]の中で使います。
 
必ず[[:ja:The Loop|ループ]]の中で使います。
9行目: 11行目:
 
== 使い方 ==
 
== 使い方 ==
 
</div>
 
</div>
<pre>
+
 
<?php the_tags( $before, $sep, $after ); ?>
+
<?php the_tags( $before, $sep, $after ); ?>
</pre>
+
  
 
<div id="Parameters">
 
<div id="Parameters">
 
== パラメータ ==
 
== パラメータ ==
 
</div>
 
</div>
 +
 
; $before  
 
; $before  
 
: (''文字列'') タグ一覧の前に表示する文字列。初期値は '''Tags: '''。
 
: (''文字列'') タグ一覧の前に表示する文字列。初期値は '''Tags: '''。
 
; $sep  
 
; $sep  
: (''文字列'') 各タグリンクの間に表示する文字列・記号。初期値では、各タグ間をカンマ( , )で区切ります。
+
: (''文字列'') 各タグリンクの間に表示する文字列・記号。初期値では、各タグ間をコンマ(<code>,</code>)で区切ります。
 
; $after  
 
; $after  
 
: (''文字列'') 最後のタグに続けて表示する文字列。初期値では何も表示しません。
 
: (''文字列'') 最後のタグに続けて表示する文字列。初期値では何も表示しません。
26行目: 28行目:
 
== 戻り値 ==
 
== 戻り値 ==
 
</div>
 
</div>
 +
 
なし。
 
なし。
  
35行目: 38行目:
 
=== デフォルトでの使用 ===
 
=== デフォルトでの使用 ===
 
</div>
 
</div>
デフォルトのまま使うと、各タグ(複数のとき)をカンマ( , )で区切り、先頭に '''Tags: ''' という文字付きで、タグの一覧を表示します。
+
 
 +
デフォルトのまま使うと、各タグ(複数のとき)をコンマ( , )で区切り、先頭に '''Tags: ''' という文字付きで、タグの一覧を表示します。
  
 
<pre><p><?php the_tags(); ?></p></pre>
 
<pre><p><?php the_tags(); ?></p></pre>
42行目: 46行目:
  
 
<div id="Separated_by_Commas">
 
<div id="Separated_by_Commas">
===カンマで区切る===
+
=== コンマで区切る ===
 
</div>
 
</div>
タグの一覧をカンマ区切りで表示した後、改行します。
+
 
 +
タグの一覧をコンマ区切りで表示した後、改行します。
 
<pre> <?php the_tags('Tags: ', ', ', '<br />'); ?> </pre>
 
<pre> <?php the_tags('Tags: ', ', ', '<br />'); ?> </pre>
  
50行目: 55行目:
 
=== 矢印で区切る ===
 
=== 矢印で区切る ===
 
</div>
 
</div>
 +
 
各タグを矢印(&gt;)で区切り、先頭に '''Social tagging: ''' という文字を付けて、タグへのリンクを表示します。
 
各タグを矢印(&gt;)で区切り、先頭に '''Social tagging: ''' という文字を付けて、タグへのリンクを表示します。
  
67行目: 73行目:
  
 
=== リスト表示 ===
 
=== リスト表示 ===
 +
 
タグのリストを (X)HTML の順不同リストで表示します。
 
タグのリストを (X)HTML の順不同リストで表示します。
  
92行目: 99行目:
 
== ソースコード ==
 
== ソースコード ==
 
</div>
 
</div>
 +
 
* <tt>the_tags()</tt> は {{Trac|wp-includes/category-template.php}} にあります。
 
* <tt>the_tags()</tt> は {{Trac|wp-includes/category-template.php}} にあります。
  
97行目: 105行目:
 
== 変更履歴 ==
 
== 変更履歴 ==
 
</div>
 
</div>
 +
 
バージョン [[Version 2.3|2.3.0]] から導入されました。
 
バージョン [[Version 2.3|2.3.0]] から導入されました。
  
102行目: 111行目:
 
== 関連 ==
 
== 関連 ==
 
</div>
 
</div>
 +
 
{{Tag Tag Tags}}, [[関数リファレンス/the_taxonomies|the_taxonomies]]
 
{{Tag Tag Tags}}, [[関数リファレンス/the_taxonomies|the_taxonomies]]
  

2014年8月10日 (日) 15:50時点における版

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

使い方

<?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: ',' &bull; ','<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 から導入されました。


タグ: 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


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

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