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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(5 版)
(03:09, 8 November 2009 MichaelH に更新)
2行目: 2行目:
 
== 説明 ==
 
== 説明 ==
 
</div>
 
</div>
このテンプレートタグ [[テンプレートタグ/the_tags|the_tags()]]は、現在の記事に付けられたタグへのリンクを表示します。<!--タグが付けられていない場合は、カテゴリが代わりに表示されます。 ←本当? ←間違い?
+
このテンプレートタグ [[テンプレートタグ/the_tags|the_tags()]]は、現在の記事に付けられたタグへのリンクを表示します。<!--タグが付けられていない場合は、カテゴリが代わりに表示されます。 ←本当? ←間違い? 「2.9 だとタグが無い場合何も表示しないっぽい--~~~~」
 
--> [[:ja:The Loop|ループ]]の中で使います。
 
--> [[:ja:The Loop|ループ]]の中で使います。
  
12行目: 12行目:
 
  <?php the_tags('前', '区切り文字', '後'); ?>
 
  <?php the_tags('前', '区切り文字', '後'); ?>
  
<div id="Examples">
+
<div id="Parameters">
== 用例 ==
+
== パラメータ ==
 
</div>
 
</div>
タグの一覧をカンマ区切りで表示した後、改行します。
+
; 前
 +
: (''文字列'') タグ一覧の前に表示する文字列。初期値は '''Tags: '''。
 +
; 区切り文字
 +
: (''文字列'') 各タグリンクの間に表示する文字列・記号。初期値では、各タグ間をカンマ(, )で区切ります。
 +
; 後
 +
: (''文字列'') 最後のタグの後ろに表示する文字列。初期値では何も表示しません。
  
<pre><?php the_tags('Tags:', ', ', '<br />'); ?></pre>
+
== 用例 ==
 +
</div>
  
 
<div id="Default_Usage">
 
<div id="Default_Usage">
27行目: 33行目:
  
 
<div class="example">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 id="Separated_by_Arrow">
48行目: 60行目:
  
 
=== リスト表示 ===
 
=== リスト表示 ===
タグのリストを (X)HTML のリスト (&lt;ul&gt; / &lt;ol&gt; / &lt;dl&gt;) で表示します。
+
タグのリストを (X)HTML の順不同リストで表示します。
  
 
<pre><?php the_tags('<ul><li>','</li><li>','</li></ul>');?></pre>
 
<pre><?php the_tags('<ul><li>','</li><li>','</li></ul>');?></pre>
54行目: 66行目:
 
<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>
 
<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」というタグを新たに付けたとすると、読者にとってわかりやすく、シンプルに見せるために、以下のように表示したいと思うかもしれません。
 
既にある記事にカテゴリを付けていて、これからタグを付けようとする場合、各記事のカテゴリとタグを一つのリストにまとめたいと思うかもしれません。例えば、ある記事に Culture と Media というカテゴリを付けていて、「Arts」と「Painting」というタグを新たに付けたとすると、読者にとってわかりやすく、シンプルに見せるために、以下のように表示したいと思うかもしれません。
70行目: 82行目:
 
</pre>
 
</pre>
  
<div id="Parameters">
 
== パラメータ ==
 
</div>
 
; 前
 
: (''文字列'') タグ一覧の前に表示する文字列。初期値は '''Tags: '''。
 
; 区切り文字
 
: (''文字列'') 各タグリンクの間に表示する文字列・記号。初期値では、各タグ間をカンマ(, )で区切ります。
 
; 後
 
: (''文字列'') 最後のタグの後ろに表示する文字列。初期値では何も表示しません。
 
  
 
<div id="Related">
 
<div id="Related">
89行目: 92行目:
 
[[Category:wp2.3]]
 
[[Category:wp2.3]]
  
{{原文|Template Tags/the_tags|53997}}
+
{{原文|Template Tags/the_tags|79979}} <!-- 03:09, 8 November 2009 MichaelH -->
  
 
[[en:Template Tags/the_tags]]
 
[[en:Template Tags/the_tags]]

2010年2月23日 (火) 19:29時点における版

このテンプレートタグ the_tags()は、現在の記事に付けられたタグへのリンクを表示します。 ループの中で使います。

注: このタグは WordPress 2.3 以上でのみ使えます。

使い方

<?php the_tags('前', '区切り文字', '後'); ?>

パラメータ

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

用例

</div>

デフォルトでの使用

デフォルトのまま使うと、各タグ(複数のとき)をカンマ(,)で区切り、先頭に 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(); ?>


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


テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。

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