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

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

「テンプレートタグ/wp tag cloud」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(8 版)
(2.8, 2.7: taxonomy, echo, link パラメータ追加、未翻訳)
1行目: 1行目:
 +
{{NeedTrans|一部}}
 +
 
<div id="Description">
 
<div id="Description">
 
== 説明 ==
 
== 説明 ==
 
</div>
 
</div>
[[テンプレートタグ/wp_tag_cloud|wp_tag_cloud]] は、各タグが記事に付けられた回数によってタグの文字サイズを決める、「タグクラウド」というタグの一覧を表示します。
+
[[テンプレートタグ/wp_tag_cloud|wp_tag_cloud]] は、各タグが記事に付けられた回数によってタグの文字サイズを決める、「[[Wikipedia:ja:タグクラウド|タグクラウド]]」というタグの一覧を表示します。
  
 
<p class="important">注: このタグは WordPress バージョン '''2.3 以上'''でのみ使えます。</p>
 
<p class="important">注: このタグは WordPress バージョン '''2.3 以上'''でのみ使えます。</p>
 +
 +
Beginning with [[Version 2.8]], the '''taxonomy''' parameter was added so that any taxonony could be used as the basis of generating the cloud.  That means, for example, that a cloud for posts categories can be presented to visitors.
  
 
<div id="Usage">
 
<div id="Usage">
 
== 使い方 ==
 
== 使い方 ==
 
</div>
 
</div>
  <?php wp_tag_cloud('引数'); ?>
+
  <?php wp_tag_cloud('[[#パラメータ|引数]]'); ?>
  
 
<div id="Examples">
 
<div id="Examples">
18行目: 22行目:
 
=== 初期設定での使用 ===
 
=== 初期設定での使用 ===
 
</div>
 
</div>
 +
 +
<?php wp_tag_cloud(); ?>
 +
 +
初期値:
 
<pre>
 
<pre>
$defaults = array('smallest' => 8, 'largest' => 22,
+
<?php $defaults = array(
  'unit' => 'pt', 'number' => 45, 'format' => 'flat',  
+
          'smallest' => 8,  
  'orderby' => 'name', 'order' => 'ASC', 'exclude' => '', 'include' => '');
+
          'largest' => 22,
 +
          'unit' => 'pt',  
 +
          'number' => 45,
 +
          'format' => 'flat',
 +
          'orderby' => 'name',  
 +
          'order' => 'ASC',
 +
          'exclude' => '',  
 +
          'include' => '',
 +
          'link' => 'view',
 +
          'taxonomy' => 'post_tag',
 +
          'echo' => true
 +
          ); ?>
 
</pre>
 
</pre>
  
34行目: 53行目:
 
* ''exclude'' - 除外タグなし
 
* ''exclude'' - 除外タグなし
 
* ''include'' - 全タグ対象
 
* ''include'' - 全タグ対象
 
+
* ''link'' - view
<?php wp_tag_cloud(); ?>
+
* ''taxonomy'' - Use post tags for basis of cloud
 +
* ''echo'' - echo the results
  
 
<div id="Cloud_displayed_under_Popluar_Tags_title">
 
<div id="Cloud_displayed_under_Popluar_Tags_title">
92行目: 112行目:
 
; include  
 
; include  
 
: (''文字列'') 表示対象とするタグの <code>term_id</code> をカンマ区切りで指定。例えば、<code>'include=5,27'</code> とすれば <code>term_id</code> が 5 または 27 のタグのみを表示。デフォルトでは全てのタグが対象。
 
: (''文字列'') 表示対象とするタグの <code>term_id</code> をカンマ区切りで指定。例えば、<code>'include=5,27'</code> とすれば <code>term_id</code> が 5 または 27 のタグのみを表示。デフォルトでは全てのタグが対象。
 +
; link
 +
: (''string'') Set link to allow edit of a particular tag.  Note: this parameter was introduced with [[Version 2.7]].  Valid values:
 +
:* <tt>'view'</tt> (Default)
 +
:* <tt>'edit'</tt>
 +
; taxonomy
 +
: (''string'') Taxonomy to use in generating the cloud.  Note: this parameter was introduced with [[Version 2.8]].
 +
:* <tt>'post_tag' </tt> - (Default) Post tags are used as source of cloud
 +
:* <tt>'category' </tt> -  Post categories are used to generate cloud
 +
:* <tt>'link_category' </tt> - Link categories are used to generate cloud
 +
; echo
 +
: (''boolean'') Show the result or keep it in a variable. The default is ''true'' (display the tag cloud). Note: this parameter was introduced with [[Version 2.8]].  Valid values:
 +
:* <tt>1 (true)</tt> - default
 +
:* <tt>0 (false)</tt>
  
 
<div id="Creating_a_Tag Archive">
 
<div id="Creating_a_Tag Archive">
 
== タグアーカイブの作成 ==
 
== タグアーカイブの作成 ==
 
</div>
 
</div>
素晴らしいタグ機能がバージョン 2.3 で追加されましたが、wp_tag_cloud タグはタグアーカイブを表示するのにも使えます。つまり、読者があるタグをクリックするとタグクラウドとそのタグが付いている全ての記事を表示することができます。[[Template_Hierarchy#Tag_page|テンプレート階層]]によると、tag.php テンプレートが存在しない場合は archives.php テンプレートが使われます。この tag.php テンプレートを作ることによって、タグアーカイブの表示をカスタマイズすることができるし、タグクラウドを最上位に表示させてより便利なナビゲーションを付けることも出来ます。
+
素晴らしいタグ機能がバージョン 2.3 で追加されましたが、wp_tag_cloud タグはタグアーカイブを表示するのにも使えます。つまり、読者があるタグをクリックするとタグクラウドとそのタグが付いている全ての記事を表示することができます。[[テンプレート階層#Tag_page|テンプレート階層]]によると、tag.php テンプレートが存在しない場合は archives.php テンプレートが使われます。この tag.php テンプレートを作ることによって、タグアーカイブの表示をカスタマイズすることができるし、タグクラウドを最上位に表示させてより便利なナビゲーションを付けることも出来ます。
  
そうするには、あなたのテーマにテンプレートを追加する必要があります。以下は[[Templates|テンプレート]]や[[Template_Hierarchy#Tag_page|テンプレート階層]]に関係した良い見本です。
+
そうするには、あなたのテーマにテンプレートを追加する必要があります。以下は[[テンプレート]]や[[テンプレート階層#Tag_page|テンプレート階層]]に関係した良い見本です。
  
 
基本的な手順は、
 
基本的な手順は、
139行目: 172行目:
 
== 変更履歴 ==
 
== 変更履歴 ==
  
 +
* [[Version 2.8|2.8]] : <code>taxonomy</code>、<code>echo</code> パラメータが追加されました。
 +
* [[Version 2.7|2.7]] : <code>link</code> パラメータが追加されました。
 
* [[Version 2.5|2.5]] :  
 
* [[Version 2.5|2.5]] :  
 
** パラメータ <code>order</code>(ソート順)の値として <code>'RAND'</code> を指定できるようになりました。
 
** パラメータ <code>order</code>(ソート順)の値として <code>'RAND'</code> を指定できるようになりました。
147行目: 182行目:
 
== 関連 ==
 
== 関連 ==
 
</div>
 
</div>
 +
* ソースコード: {{BrowseSource|wp-includes/category-template.php|trunk|2.8}}
 
{{Tag Tag Tags}}
 
{{Tag Tag Tags}}
 
{{PHP Function Tag Footer}}
 
{{PHP Function Tag Footer}}
  
{{原文|Template Tags/wp_tag_cloud|54356}}
+
{{原文|Template Tags/wp_tag_cloud|73075}}<!-- 12:07, May 30, 2009 Bono 版 -->
  
{{DEFAULTSORT:wp_tag_cloud}}
+
{{DEFAULTSORT:Wp_tag_cloud}}
 
[[Category:wp2.3]]
 
[[Category:wp2.3]]
 
[[Category:wp2.5]]
 
[[Category:wp2.5]]
 +
[[Category:wp2.8]]
  
 
[[en:Template Tags/wp_tag_cloud]]
 
[[en:Template Tags/wp_tag_cloud]]
 
[[fr:Marqueurs de Tags/wp_tag_cloud]]
 
[[fr:Marqueurs de Tags/wp_tag_cloud]]

2009年6月1日 (月) 21:43時点における版

このページ「テンプレートタグ/wp tag cloud」は一部未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

wp_tag_cloud は、各タグが記事に付けられた回数によってタグの文字サイズを決める、「タグクラウド」というタグの一覧を表示します。

注: このタグは WordPress バージョン 2.3 以上でのみ使えます。

Beginning with Version 2.8, the taxonomy parameter was added so that any taxonony could be used as the basis of generating the cloud. That means, for example, that a cloud for posts categories can be presented to visitors.

使い方

<?php wp_tag_cloud('引数'); ?>

用例

初期設定での使用

<?php wp_tag_cloud(); ?>

初期値:

<?php $defaults = array(
          'smallest' => 8, 
          'largest' => 22,
          'unit' => 'pt', 
          'number' => 45,  
          'format' => 'flat',
          'orderby' => 'name', 
          'order' => 'ASC',
          'exclude' => '', 
          'include' => '', 
          'link' => 'view', 
          'taxonomy' => 'post_tag', 
          'echo' => true
          ); ?>

デフォルトでは次のように表示します。各タグの文字サイズは、付けられた記事数に応じて smallestlargest の間で段階的に変化します。

  • smallest - 一番小さいタグを 8(pt) で表示(件数が少ないタグ)
  • largest - 一番大きいタグを 22(pt) で表示(件数が多いタグ)
  • unit - 最少・最多値のフォントサイズの単位として 'pt' (point) を使用
  • number - 最大 45 タグを表示
  • format - flat(ホワイトスペース区切り)形式でタグを表示
  • orderby - タグ名順に表示
  • order - 昇順でソート(前項でタグ名を指定しているので「タグ名の昇順」となる)
  • exclude - 除外タグなし
  • include - 全タグ対象
  • link - view
  • taxonomy - Use post tags for basis of cloud
  • echo - echo the results

タイトル「Popluar Tags」の下にタグクラウドを表示

<?php if ( function_exists('wp_tag_cloud') ) : ?>
<li><h2>Popular Tags</h2>
<?php wp_tag_cloud('smallest=8&largest=22'); ?>
</li>
<?php endif; ?>

注: 全体が <li>~</li> で括られているのは、デフォルトテーマなどのサイドバー用の形式です。サイドバー全体が番号なし箇条書きの入れ子になっています(サイドバーのカスタマイズ/en 参照)。

サイズ指定、タグ名ではなく使用数順のタグクラウド

<?php wp_tag_cloud('smallest=8&largest=22&number=30&orderby=count'); ?>

タグクラウドを表示せずに配列として取得

タグクラウドのデータを他の PHP コードで使うために、変数 $a に格納

<?php $a = wp_tag_cloud('format=array' );?>

パラメータ

smallest
整数) 最少使用数のタグの表示に使うフォントサイズ。初期値は 8。
largest
整数) 最多使用数のタグの表示に使うフォントサイズ。初期値は 22。
unit
文字列smallestlargest の値の単位。pt, px, em, % 等、CSS でフォントサイズに用いる単位を指定可能。初期値は point の pt
number
整数) クラウドに表示するタグ数。初期値は 45。'0' を指定すると全タグを表示。
format
文字列) クラウド表示のフォーマット
  • 'flat' (初期値) タグをホワイトスペースで区切る
  • 'list' タグを class='wp-tag-cloud' 付きの ul(番号なし箇条書き)内に表示
  • 'array' タグを配列に格納し、タグクラウドデータを PHP で扱えるように配列のまま返す。注: 配列の取得(表示ではなく)は WordPress 2.5 以上で使えます。
orderby
文字列) タグの表示順とする項目。有効値:
  • 'name' - タグ名(初期値)
  • 'count' - 使用数
order
文字列) ソート順。有効値(大文字):
  • 'ASC' - 昇順(初期値)
  • 'DESC' - 降順
  • 'RAND' - ランダム(WordPress 2.5 以上で指定可能)
exclude
文字列) 除外するタグの term_id をカンマ区切りで指定。例えば、'exclude=5,27' とすれば term_id が 5 と 27 のタグは表示されない。デフォルトでは除外なし。
include
文字列) 表示対象とするタグの term_id をカンマ区切りで指定。例えば、'include=5,27' とすれば term_id が 5 または 27 のタグのみを表示。デフォルトでは全てのタグが対象。
link
(string) Set link to allow edit of a particular tag. Note: this parameter was introduced with Version 2.7. Valid values:
  • 'view' (Default)
  • 'edit'
taxonomy
(string) Taxonomy to use in generating the cloud. Note: this parameter was introduced with Version 2.8.
  • 'post_tag' - (Default) Post tags are used as source of cloud
  • 'category' - Post categories are used to generate cloud
  • 'link_category' - Link categories are used to generate cloud
echo
(boolean) Show the result or keep it in a variable. The default is true (display the tag cloud). Note: this parameter was introduced with Version 2.8. Valid values:
  • 1 (true) - default
  • 0 (false)

タグアーカイブの作成

素晴らしいタグ機能がバージョン 2.3 で追加されましたが、wp_tag_cloud タグはタグアーカイブを表示するのにも使えます。つまり、読者があるタグをクリックするとタグクラウドとそのタグが付いている全ての記事を表示することができます。テンプレート階層によると、tag.php テンプレートが存在しない場合は archives.php テンプレートが使われます。この tag.php テンプレートを作ることによって、タグアーカイブの表示をカスタマイズすることができるし、タグクラウドを最上位に表示させてより便利なナビゲーションを付けることも出来ます。

そうするには、あなたのテーマにテンプレートを追加する必要があります。以下はテンプレートテンプレート階層に関係した良い見本です。

基本的な手順は、

  1. コンテンツを作成し、tag.php という名前のファイルに保存する
  2. ファイルをあなたが使用しているテーマのディレクトリにアップロードする
  3. これは任意です。ページナビゲーションにタグアーカイブへのリンクを入れたい場合は行ってください。行わない場合は、タグをクリックしたときにこのテンプレートが使用されます。
    1. 新しくページを作成し、このテンプレートを適用し、ページ名を Tag Archive とする。

3 番目のステップを詳しく説明します。

WordPress は異なるページテンプレートを各ページごとに使用することができます。管理パネルの作成 > ページ作成で表示されるページの下に (使用中の WordPress バージョンによってはサイドバーにあります) 「ページテンプレート」という名前のドロップダウンがあります。そこでどのテンプレートを使ってページを表示するかを選択できます。

<?php /*
Template Name: Tag Archive
*/ ?>
<div>
<?php get_header(); ?>
<h2>Tag Archive</h2>
<?php wp_tag_cloud(''); ?>
	<div class="navigation">
<div class="alignleft"><?php next_posts_link('« Older Entries') ?></div>
<div class="alignright"><?php previous_posts_link('Newer Entries »') ?></div>
	</div>
<?php if (have_posts()) : ?>
		<?php while (have_posts()) : the_post(); ?>
		<h2><a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title(); ?>"><?php the_title(); ?></a></h2>
	<div class="entry">
	<?php the_content('Read the rest of this entry »'); ?>
	</div>

	<?php endwhile; ?>
	<?php endif; ?>
</div>
<?php get_footer(); ?>

このテンプレートはスタイリングされていないことに注意してください。あなたが使っているテーマの single.php ファイルを見て構造を決めると良いでしょう。

変更履歴

  • 2.8 : taxonomyecho パラメータが追加されました。
  • 2.7 : link パラメータが追加されました。
  • 2.5 :
    • パラメータ order(ソート順)の値として 'RAND' を指定できるようになりました。
    • パラメータ format(表示形式) で 'array' を指定したとき、表示せずに値を返すようになりました。
  • 2.3 : 新規テンプレートタグ

タグ: 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/wp_tag_cloud最新版との差分