wp_tag_cloud()

関数の概要

wp_tag_cloud() は、WordPressテーマ内でタグクラウドを表示するために使用される関数です。この関数は、投稿に付けられたタグのリストを表示し、各タグのサイズはそのタグが使用された頻度に基づいて変わります。タグクラウドは、サイトのコンテンツに関連するキーワードやトピックを視覚的に強調し、訪問者が興味のあるトピックを簡単に見つけるのに役立ちます。

パラメータの説明

wp_tag_cloud( $args )

  • $args (array|string)(省略可能):タグクラウドをカスタマイズするための引数の配列またはクエリ文字列。主な引数は以下の通りです:
  • smallest (float):最小のフォントサイズ。デフォルトは 8
  • largest (float):最大のフォントサイズ。デフォルトは 22
  • unit (string):フォントサイズの単位。例:'pt', 'px', 'em'。デフォルトは 'pt'
  • number (int):表示するタグの最大数。デフォルトは 45
  • format (string):タグクラウドのフォーマット。'flat', 'list', 'array' のいずれか。デフォルトは 'flat'
  • separator (string):タグ間の区切り文字。'format''flat' の場合に使用されます。デフォルトは空白文字です。
  • orderby (string):タグの並び順を指定します。例:'name', 'count'。デフォルトは 'name'
  • order (string):並び順を指定します。'ASC'(昇順)または 'DESC'(降順)。デフォルトは 'ASC'
  • link (string):タグリンクのターゲット。'view', 'edit' のいずれか。デフォルトは 'view'
  • taxonomy (string):タグクラウドに使用するタクソノミー。デフォルトは 'post_tag'
  • echo (bool):true ならタグクラウドを表示し、false ならタグクラウドを返します。デフォルトは true です。

使用例

以下は、wp_tag_cloud() 関数を使用してデフォルトのタグクラウドを表示する基本的な例です:

<?php wp_tag_cloud(); ?>

特定のフォントサイズと数でタグクラウドを表示する例:

<?php wp_tag_cloud( array(
    'smallest' => 10,
    'largest'  => 20,
    'number'   => 30,
) ); ?>

リスト形式でタグクラウドを表示する例:

<?php wp_tag_cloud( array(
    'format' => 'list',
    'separator' => ', ',
) ); ?>

タグクラウドを変数に格納して後で使用する例:

<?php
$tag_cloud = wp_tag_cloud( array( 'echo' => false ) );
echo '<div class="custom-tag-cloud">' . $tag_cloud . '</div>';
?>

関連する関数

  • get_tags(): タグのリストを取得し、返しますが、表示はしません。wp_tag_cloud() 関数と異なり、タグリストを変数に格納するために使用されます。
  • the_tags(): 投稿のタグを表示するために使用されます。タグクラウドよりもシンプルなタグリストを生成します。
  • wp_generate_tag_cloud(): タグクラウドのHTMLを生成し、返しますが、表示はしません。タグクラウドをカスタマイズするために使用されます。

タグクラウドのカスタマイズ

タグクラウドのスタイルや構造をカスタマイズするために、CSSクラスやカスタムHTMLを追加することができます。以下は、CSSクラスを追加してタグクラウドをカスタマイズする例です:

<div class="custom-tag-cloud">
    <?php wp_tag_cloud( array( 'smallest' => 10, 'largest' => 22, 'unit' => 'px' ) ); ?>
</div>

タクソノミーの変更

タグクラウドに表示するタクソノミーを変更することもできます。以下は、カスタムタクソノミーのタグクラウドを表示する例です:

<?php wp_tag_cloud( array( 'taxonomy' => 'custom_taxonomy' ) ); ?>

wp_tag_cloud() 関数を使用することで、テーマのテンプレートファイル内でタグクラウドを簡単に表示することができます。これにより、訪問者がサイトのコンテンツに関連するキーワードやトピックを視覚的に見つけやすくなり、ユーザーエクスペリエンスが向上します。