wp_generate_tag_cloud()


WordPressのwp_generate_tag_cloud()関数は、タグクラウドを生成するために使用されます。この関数は、指定されたタグの配列に基づいてHTML形式のタグクラウドを返します。

構文

wp_generate_tag_cloud( array $tags, array|string $args = '' );

引数の説明:

  • $tags(array) — タグクラウドに表示するタグの配列。
  • $args(array|string) — タグクラウドの表示オプションを指定する配列または文字列。
  • smallest(int|string) — 最小フォントサイズ。
  • largest(int|string) — 最大フォントサイズ。
  • unit(string) — フォントサイズの単位（例: ‘pt’, ‘px’, ‘em’）。
  • number(int) — 表示するタグの数。
  • format(string) — タグクラウドの形式（’flat’, ‘list’, ‘array’）。
  • separator(string) — タグ間の区切り文字。
  • orderby(string) — タグの並び順（’name’, ‘count’）。
  • order(string) — 並び順の方向（’ASC’, ‘DESC’）。
  • topic_count_text_callback(callable) — タグのカウントテキストを生成するコールバック関数。

例1: 基本的なタグクラウドの表示

この例では、基本的なタグクラウドを表示します。

<?php echo wp_generate_tag_cloud( get_tags() ); ?>

例2: フォントサイズと単位の指定

フォントサイズと単位を指定してタグクラウドを表示します。

<?php echo wp_generate_tag_cloud( get_tags(), array( 'smallest' => 8, 'largest' => 22, 'unit' => 'pt' ) ); ?>

例3: タグの数と並び順の指定

表示するタグの数と並び順を指定します。

<?php echo wp_generate_tag_cloud( get_tags(), array( 'number' => 10, 'orderby' => 'count', 'order' => 'DESC' ) ); ?>

例4: リスト形式でのタグクラウド表示

タグクラウドをリスト形式で表示します。

<?php echo wp_generate_tag_cloud( get_tags(), array( 'format' => 'list' ) ); ?>

例5: カスタムテキストコールバックの使用

カスタムテキストコールバックを使用してタグのカウントテキストを生成します。

<?php echo wp_generate_tag_cloud( get_tags(), array( 'topic_count_text_callback' => 'custom_topic_count_text' ) ); ?>

注意点

  • $tags引数には、タグオブジェクトの配列を渡す必要があります。
  • $args引数で指定するオプションは、タグクラウドの外観を細かく制御します。
  • フォントサイズや単位を指定する際は、適切な値を設定してください。

関連機能：