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

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

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

提供: WordPress Codex 日本語版
< テンプレートタグ
2007年9月5日 (水) 21:00時点におけるBono (トーク | 投稿記録)による版 (和訳・補足/'array' フォーマットを要確認)

移動先: 案内検索

テンプレート:stub


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


このテンプレートタグは、WordPress バージョン 2.3 から使えるようになる予定です。wp_tag_cloud は、各タグが記事に付けられた回数によってタグの文字サイズを決める、「タグクラウド」というタグの一覧を表示します。

使い方

<?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。
format
文字列) クラウド表示のフォーマット
  • 'flat' (初期値) タグをホワイトスペースで区切る
  • 'list' タグを class='wp-tag-cloud' 付きの ul(番号なし箇条書き)内に表示
  • 'array' tags are in an array(タグを配列に格納?配置の形を指しているのか未確認)
orderby
文字列) タグの表示順とする項目。有効値:
  • 'name' - タグ名(初期値)
  • 'count' - 使用数
order
文字列) ソート順。有効値:
  • 'ASC' - 昇順(初期値)
  • 'DESC' - 降順
exclude
文字列) 除外するタグをカンマ区切りで指定。例えば、'exclude=ship,navy' とすれば ship と navy タグは表示されない。デフォルトでは除外なし。
include
文字列) 表示対象とするタグをカンマ区切りで指定。例えば、'include=ship,navy' とすれば ship と navy タグのみを表示。デフォルトでは全てのタグが対象。

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

Related

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