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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(2.5: ソートパラメータに RAND 追加、配列形式での値の取得が可能に。)
(差分表示用に版番号追記、未翻訳テンプレ追加)
1行目: 1行目:
 +
{{NeedTrans|一部}}
 +
 
<div id="Description">
 
<div id="Description">
 
== 説明 ==
 
== 説明 ==
150行目: 152行目:
 
{{PHP Function Tag Footer}}
 
{{PHP Function Tag Footer}}
  
{{原文|Template Tags/wp_tag_cloud}}
+
{{原文|Template Tags/wp_tag_cloud|54356}}
  
 
{{DEFAULTSORT:wp_tag_cloud}}
 
{{DEFAULTSORT:wp_tag_cloud}}

2008年3月28日 (金) 23:45時点における版

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

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' => '');

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

  • smallest - 一番小さいタグを 8(pt) で表示(件数が少ないタグ)
  • largest - 一番大きいタグを 22(pt) で表示(件数が多いタグ)
  • 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>
<?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 のタグのみを表示。デフォルトでは全てのタグが対象。

タグアーカイブの作成

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. According to the Template_Hierarchy if a tag.php template does not exist then the archives.php template will be used. By making this tag.php template you can customize the way your Tag Archive will look, this template includes the tag cloud at the top for very easy navigation.


To do this a new template will need to be added to your theme files. These are good resources for everything pertaining to templates, Template_Hierarchy. Basic steps needed are

  • 1. Create file with the contents below named tag.php.
  • 2. Upload file to your themes directory.
  • 3. This is optional only if you would like to have a link in your page navigation to the Tag archive, otherwise when clicking on a tag this template will be used.
    • Create a new blank page using this template, give this page the title Tag Archive.

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

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.

変更履歴

  • 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最新版との差分