• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(和訳/「wp2.3」)
(2007年10月11日 (木) 18:06 Otto42 版に更新(未訳)、tagフッタ差し替え)
1行目: 1行目:
 
{{stub}}
 
{{stub}}
 
-----
 
-----
<p class="important">'''注: このタグは WordPress 2.3 以上でのみ使えます。'''</p>
+
<p class="important">'''注: このタグは [[Version 2.3|WordPress 2.3]] 以上でのみ使えます。'''</p>
 
-----
 
-----
 
<div id="Description">
 
<div id="Description">
 
== 説明 ==
 
== 説明 ==
 
</div>
 
</div>
このテンプレートタグは、WordPress '''バージョン 2.3''' から使えるようになる予定です。記事に属するタグへのリンクを表示します。[[:ja:The Loop|ループ]]の中で使います。
+
このテンプレートタグ [[テンプレートタグ/the_tags|the_tags()]]は、現在の記事に付けられたタグへのリンクを表示します。<!-- If no tags are associated with the current entry, the associated category is displayed instead. ←本当? --> [[:ja:The Loop|ループ]]の中で使います。
  
 
<div id="Usage">
 
<div id="Usage">
18行目: 18行目:
 
タグの一覧をカンマ区切りで表示した後、改行します。
 
タグの一覧をカンマ区切りで表示した後、改行します。
  
<pre><?php the_tags('Tags:', ',', '<br />'); ?></pre>
+
<pre><?php the_tags('Tags:', ', ', '<br />'); ?></pre>
  
 
<div id="Default_Usage">
 
<div id="Default_Usage">
44行目: 44行目:
 
各タグを中点(&bull;)で区切り、先頭に '''Tagged with: ''' という文字を付けて、タグへのリンクを表示し、その後で改行します。
 
各タグを中点(&bull;)で区切り、先頭に '''Tagged with: ''' という文字を付けて、タグへのリンクを表示し、その後で改行します。
  
<pre><?php the_tags('Tagged with: ',' &amp;bull; ',<br />'; ?></pre>
+
<pre><?php the_tags('Tagged with: ',' &amp;bull; ','<br />'); ?></pre>
  
 
<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; ):
 +
 +
<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>
 +
 +
===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:
 +
 +
<div style="padding: 10px; width: 50%; border:solid 1px blue">
 +
Tags: Culture, Media, Arts, Painting
 +
</div>
 +
 +
This code will get you there, and will only render categories or tags if they're non-empty for the current post:
 +
 +
<pre>
 +
Tags:
 +
<?php if (the_category(', '))  the_category(); ?>
 +
<?php if (the_tags(', ', ', ', '')) the_tags(); ?>
 +
</pre>
  
 
<div id="Parameters">
 
<div id="Parameters">
57行目: 80行目:
 
; 後  
 
; 後  
 
: (''文字列'') 最後のタグの後ろに表示する文字列。初期値では何も表示しません。
 
: (''文字列'') 最後のタグの後ろに表示する文字列。初期値では何も表示しません。
 
{{原文|Template Tags/the_tags}}
 
  
 
<div id="Related">
 
<div id="Related">
 
== 関連 ==
 
== 関連 ==
 
</div>
 
</div>
{{Tag Category Tags}}
+
{{Tag Tag Tags}}
  
 
{{PHP Function Tag Footer}}
 
{{PHP Function Tag Footer}}
69行目: 90行目:
 
{{DEFAULTSORT:the_tags}}
 
{{DEFAULTSORT:the_tags}}
 
[[Category:wp2.3]]
 
[[Category:wp2.3]]
 +
 +
{{原文|Template Tags/the_tags}}
  
 
[[en:Template Tags/the_tags]]
 
[[en:Template Tags/the_tags]]

2007年10月14日 (日) 04:16時点における版

テンプレート:stub


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


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

使い方

<?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

A List Example

Displays a list of the tags as a real and simple (X)HTML list (<ul> / <ol> / <dl> ):

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

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:

Tags: Culture, Media, Arts, Painting

This code will get you there, and will only render categories or tags if they're non-empty for the current post:

Tags:
<?php if (the_category(', '))  the_category(); ?>
<?php if (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