wp_list_categories()


WordPressのwp_list_categories()関数は、カテゴリーのリストを表示するために使用されます。この関数は、カテゴリーの階層やオプションに基づいてリストを生成します。

構文

wp_list_categories( array|string $args = '' );
  • $args(array|string) — カテゴリーリストの表示方法を制御するための引数。デフォルトは空の文字列。

例1: 基本的なカテゴリーリストの表示

この例では、すべてのカテゴリーをリスト形式で表示します。

<?php wp_list_categories(); ?>

例2: 特定のカテゴリーを除外する

この例では、IDが5と9のカテゴリーを除外してリストを表示します。

<?php wp_list_categories( array( 'exclude' => '5,9' ) ); ?>

例3: カテゴリー名の順序を変更する

この例では、カテゴリー名をアルファベット順に表示します。

<?php wp_list_categories( array( 'orderby' => 'name', 'order' => 'ASC' ) ); ?>

例4: カテゴリーの階層を表示する

この例では、カテゴリーの階層を表示し、親カテゴリーと子カテゴリーを区別します。

<?php wp_list_categories( array( 'hierarchical' => true ) ); ?>

例5: カテゴリーの投稿数を表示する

この例では、各カテゴリーに属する投稿数を表示します。

<?php wp_list_categories( array( 'show_count' => true ) ); ?>

例6: カテゴリーの説明を表示する

この例では、カテゴリーの説明をリストに表示します。

<?php wp_list_categories( array( 'use_desc_for_title' => true ) ); ?>

例7: カテゴリーのスラッグをクラスとして追加する

この例では、各カテゴリーのスラッグをクラスとして追加します。

<?php wp_list_categories( array( 'current_category' => true ) ); ?>

注意点:

  • wp_list_categories()は、カテゴリーのリストを表示するための強力な関数ですが、引数を正しく設定しないと意図しない結果が表示されることがあります。
  • カテゴリーの順序や階層を変更する場合は、orderbyやhierarchicalなどの引数を適切に設定してください。

関連機能：