get_categories()


WordPress関数get_categories()は、投稿に関連付けられているカテゴリのリストを取得するために使用されます。

シンタックス

get_categories( array $args = array() );

引数の説明:

  • $args (array) — 関数の動作を変更するための引数の配列。
  • 'orderby' (string) — カテゴリの並び替え方法。デフォルトは'name'。
  • 'order' (string) — 並び順。値は'ASC'または'DESC'。
  • 'hide_empty' (bool) — 空のカテゴリを非表示にするかどうか。デフォルトはtrue。
  • 'exclude' (array) — 除外するカテゴリIDの配列。
  • 'include' (array) — 含めるカテゴリIDの配列。

例 1: 全カテゴリの一覧を表示する

<?php
$categories = get_categories();
foreach ( $categories as $category ) {
    echo '<a href="' . get_category_link( $category->term_id ) . '">' . $category->name . '</a>';
}
?>

例 2: 名前順でカテゴリを取得する

<?php
$categories = get_categories( array( 'orderby' => 'name', 'order' => 'ASC' ) );
foreach ( $categories as $category ) {
    echo $category->name;
}
?>

例 3: 空でないカテゴリのみを表示する

<?php
$categories = get_categories( array( 'hide_empty' => true ) );
foreach ( $categories as $category ) {
    echo $category->name;
}
?>

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

<?php
$categories = get_categories( array( 'exclude' => array( get_cat_ID( 'Uncategorized' ) ) ) );
foreach ( $categories as $category ) {
    echo $category->name;
}
?>

例 5: 特定のカテゴリのみを含める

<?php
$categories = get_categories( array( 'include' => array( get_cat_ID( 'News' ), get_cat_ID( 'Updates' ) ) ) );
foreach ( $categories as $category ) {
    echo $category->name;
}
?>

注意事項

  • get_categories()は、戻り値としてカテゴリオブジェクトの配列を提供します。
  • カテゴリIDを操作する際は、get_cat_ID()関数を使用すると便利です。
  • 結果をフィルタリングする場合は、引数'exclude'や'include'を適切に設定してください。

関連機能：