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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(2008年2月26日 (火) 01:36 Klawdyo 版を反映、未翻訳)
(説明の一部が間違いかもしれないのでコメントアウトしました。)
2行目: 2行目:
 
== 説明 ==
 
== 説明 ==
 
</div>
 
</div>
このテンプレートタグ [[テンプレートタグ/the_tags|the_tags()]]は、現在の記事に付けられたタグへのリンクを表示します。If no tags are associated with the current entry, the associated category is displayed instead.<!-- ←本当? --> [[:ja:The Loop|ループ]]の中で使います。
+
このテンプレートタグ [[テンプレートタグ/the_tags|the_tags()]]は、現在の記事に付けられたタグへのリンクを表示します。<!--タグが付けられていない場合は、カテゴリが代わりに表示されます。 ←本当? ←間違い?
 +
--> [[:ja:The Loop|ループ]]の中で使います。
  
 
<p class="important">注: このタグは [[Version 2.3|WordPress 2.3]] 以上でのみ使えます。</p>
 
<p class="important">注: このタグは [[Version 2.3|WordPress 2.3]] 以上でのみ使えます。</p>
46行目: 47行目:
 
<div class="example">Tagged with: [[#Examples|WordPress]] &bull; [[#Examples|Computers]] &bull; [[#Examples|Blogging]]</div>
 
<div class="example">Tagged with: [[#Examples|WordPress]] &bull; [[#Examples|Computers]] &bull; [[#Examples|Blogging]]</div>
  
===A List Example===
+
=== リスト表示 ===
Displays a list of the tags as a real and simple (X)HTML list (&lt;ul&gt; / &lt;ol&gt; / &lt;dl&gt; ):
+
タグのリストを (X)HTML のリスト (&lt;ul&gt; / &lt;ol&gt; / &lt;dl&gt;) で表示します。
  
 
<pre><?php the_tags('<ul><li>','</li><li>','</li></ul>');?></pre>
 
<pre><?php the_tags('<ul><li>','</li><li>','</li></ul>');?></pre>
53行目: 54行目:
 
<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>
  
===Integrating Categories and Tags===
+
=== カテゴリとタグの統合 ===
  
If you have existing posts associated with categories, and have started adding tags to posts as well, you may want to show an integrated list of categories and tags beneath each post. For example, assume you have pre-existing categories called Culture and Media, and have added tags to a post "Arts" and "Painting".  To simplify the reader's experience and keep things uncluttered, you may want to display these as if they were all tags:
+
既にある記事にカテゴリを付けていて、これからタグを付けようとする場合、各記事のカテゴリとタグを一つのリストにまとめたいと思うかもしれません。例えば、ある記事に Culture Media というカテゴリを付けていて、「Arts」と「Painting」というタグを新たに付けたとすると、読者にとってわかりやすく、シンプルに見せるために、以下のように表示したいと思うかもしれません。
  
 
<div style="padding: 10px; width: 50%; border:solid 1px blue">
 
<div style="padding: 10px; width: 50%; border:solid 1px blue">
61行目: 62行目:
 
</div>
 
</div>
  
This code will get you there, and will only render categories or tags if they're non-empty for the current post:
+
以下のコードを使えば、カテゴリもタグも、設定されているときだけ表示されます。
  
 
<pre>
 
<pre>
78行目: 79行目:
 
; 後  
 
; 後  
 
: (''文字列'') 最後のタグの後ろに表示する文字列。初期値では何も表示しません。
 
: (''文字列'') 最後のタグの後ろに表示する文字列。初期値では何も表示しません。
 
{{NeedTrans|一部}}
 
  
 
<div id="Related">
 
<div id="Related">

2008年3月31日 (月) 02:24時点における版

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

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

使い方

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

用例

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

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

デフォルトでの使用

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

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

矢印で区切る

各タグを矢印(>)で区切り、先頭に 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 のリスト (<ul> / <ol> / <dl>) で表示します。

<?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(); ?>

パラメータ

文字列) タグ一覧の前に表示する文字列。初期値は 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最新版との差分