get_categories() の使い方｜説明・引数・注意点

説明

基本構文

get_categories( array|string $args = '' ): array|string|WP_Error

引数

• $args：get_terms() と同じ。hide_empty、orderby、parent など

戻り値

WP_Term の配列。

使い方（サンプル）

$cats = get_categories( array( 'hide_empty' => false ) );

注意点

• 内部的には get_terms() のラッパーです。
• カスタムタクソノミーには get_terms() を使います。

実務での使いどころ

• カテゴリーの一覧を、配列で取得するとき。
• サイドバーなどに、カテゴリーの一覧を、独自のHTMLで出すとき。

よくあるミスと対処

• hide_empty の既定は true。投稿のないカテゴリーは、取得されない。
• taxonomy の既定は category。カスタムタクソノミーを対象にするときは、taxonomy を指定するか、get_terms() を使う。

NG例

$cats = get_categories(); // 投稿のないカテゴリーは、含まれない

OK例

$cats = get_categories( array( 'hide_empty' => false ) );
foreach ( $cats as $cat ) {
	echo esc_html( $cat->name );
}

使い分け早見表

関連項目

get_terms()、get_category()、wp_list_categories()

公式リファレンス：get_categories() | Function | WordPress Developer Resources