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

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

テンプレートタグ/wp tag cloud

提供: WordPress Codex 日本語版
< テンプレートタグ
2007年9月26日 (水) 21:17時点におけるBono (トーク | 投稿記録)による版 (除外・表示タグパラメータ修正、Creating a Tag Archive 節追加。(2007年9月25日 (火) 19:19 Sahaskatta 版より))

移動先: 案内検索

テンプレート:stub

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

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

使い方

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

用例

デフォルトでの使用

$defaults = array('smallest' => 8, 'largest' => 22,
  'unit' => 'pt', 'number' => 45, 'format' => 'flat', 
  'orderby' => 'name', 'order' => 'ASC', 'exclude' => '', 'include' => '');

デフォルトのまま使うと、次のように表示します。

  • smallest - 最少数のタグを表示するフォントサイズを 8 (point) とする
  • largest - 最多数のタグを表示するフォントサイズを 22 (point) とする
  • unit - 最少・最多値のフォントサイズの単位として 'pt' (point) を使用
  • number - 最大 45 タグを表示
  • format - flat(ホワイトスペース区切り)形式でタグを表示
  • orderby - タグ名順に表示
  • order - 昇順でソート(前項でタグ名を指定しているので「タグ名の昇順」となる)
  • exclude - 除外タグなし
  • include - 全タグ対象
<?php wp_tag_cloud(); ?>

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

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

(前後を ul で括るなら format=list かも?)

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

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

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

パラメータ

smallest
整数) 最少使用数のタグの表示に使うフォントサイズ。初期値は 8。
largest
整数) 最多使用数のタグの表示に使うフォントサイズ。初期値は 22。
unit
文字列smallestlargestの値の単位。初期値は point の pt
number
整数) クラウドに表示するタグ数。初期値は 45。'0' を指定すると全タグを表示。
format
文字列) クラウド表示のフォーマット
  • 'flat' (初期値) タグをホワイトスペースで区切る
  • 'list' タグを class='wp-tag-cloud' 付きの ul(番号なし箇条書き)内に表示
  • 'array' tags are in an array(タグを配列に格納?配置の形を指しているのか未確認)
orderby
文字列) タグの表示順とする項目。有効値:
  • 'name' - タグ名(初期値)
  • 'count' - 使用数
order
文字列) ソート順。有効値:
  • 'ASC' - 昇順(初期値)
  • 'DESC' - 降順
exclude
文字列) 除外するタグの term_id をカンマ区切りで指定。例えば、'exclude=5,27' とすれば term_id が 5 と 27 のタグは表示されない。デフォルトでは除外なし。
include
文字列) 表示対象とするタグの term_id をカンマ区切りで指定。例えば、'include=5,27' とすれば term_id が 5 または 27 のタグのみを表示。デフォルトでは全てのタグが対象。

Creating a Tag Archive

While the new tagging feature in 2.3 is a great addition, the wp_tag_cloud tag can be used to display a Tag Archive. What this means is that when a visitor clicks on any particular tag a page displaying the tag cloud and all posts tagged the same will be displayed.

To do this a new template will need to be added to your theme files. This is a good resource for everything pertaining to templates. Basic steps needed are

  • 1. Create file with the contents below.
  • 2. Upload file to your themes directory.
  • 3. Create a new blank page using this template.

To elobarate more on step three.

WordPress can be configured to use different Page Templates for different Pages. Toward the bottom of the Write->Write Page administration panel (or on the sidebar, depending on which version of WordPress you are using) is a drop-down labeled "Page Template". From there you can select which Template will be used when displaying this particular Page.

<?php /*
Template Name: Tag Archive
*/ ?>
<div id="content">
<h2>Tag Archive</h2>
<?php get_header(); ?>
<?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 class="posttitle"><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(); ?>

Please Note that styling has not been added to this template. A good way to determine the structure that your theme uses is to view the single.php theme file.

最新英語版: WordPress Codex » Template Tags/wp_tag_cloud

Related

カテゴリータグ: the_category(), the_category_rss(), single_cat_title(), category_description(), wp_dropdown_categories(), wp_list_categories(), get_the_category(), get_the_category_by_ID(), get_category_by_slug(), get_the_category_list(), get_category_parents(), get_category_link(), is_category(), in_category()


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