WEB制作のための情報サイト / unazuki Library
条件にマッチしたカテゴリーオブジェクトの配列を取得します。ここでいうカテゴリーは、カスタムタクソノミーではなくデフォルトの投稿のカテゴリーを指します。（WordPressインストール時に最初から設定されているカテゴリー）
get_categories($args)| 引数 | 必須/任意 | 引数に指定するもの |
|---|---|---|
| 第１引数 $args | 任意 | 取得するカテゴリーの条件（パラメーター）を配列で指定（文字列での指定も可能ですが配列で理解しておく方が柔軟性がありオススメです）。初期値： ''（空の文字列）初期値ではすべてのカテゴリーを取得します。 利用できる主なパラメーターは下記の通り。 orderby 返す値の順番を何順にするか指定、nameやcountなど。省略時はnameorder ASC/DESCを指定。ASCは昇順、DESCが降順。省略時はASChide_empty 真偽値を指定。trueなら記事件数が0のカテゴリーを除外。省略時はtrueinclude 取得するカテゴリーのIDを配列で指定。省略時は空の配列（指定なし）exclude 取得しないカテゴリーのIDを配列で指定。省略時は空の配列（指定なし）exclude_tree 子カテゴリーを含めて取得しないカテゴリーのIDを配列で指定number 取得件数の上限。省略時は全件name 取得したいカテゴリーの名前あるいはその配列slug 取得したいカテゴリーのスラッグあるいはその配列meta_query メタクエリの指定（カスタムフィールドを条件に取得）すべてのパラメーターは下記公式に記載があります。（英語） https://developer.wordpress.org/reference/classes/wp_term_query/__construct/ |
戻り値（返す値）：条件にマッチしたカテゴリーオブジェクトの配列
取得したカテゴリーオブジェクトを配列として返します。foreachでループを回して配列から１つ１つ要素（カテゴリーのオブジェクト）を取り出してカテゴリーの名前を取得したりすることができます。
the_categories()はthe_terms()のラッパー関数です。the_categories()の内部でthe_terms()を実行しています。the_categories()は内部でthe_terms()を実行する際に、taxonomyの値をcategory（投稿に標準実装されているカテゴリー）にデフォルトで指定します。
このオブジェクトが持つ主なプロパティ（中身）は以下の通りです。
term_id カテゴリーのIDname カテゴリーの名前slug カテゴリーのスラッグtaxonomy 所属するタクソノミーの名前（= category）description カテゴリーの説明文（管理画面からカテゴリーを追加する際の「説明」欄）count カテゴリーに所属する記事数cat_ID term_idのエイリアスcat_name nameのエイリアスcategory_nicename slugのエイリアスcategory_description descriptionのエイリアスcategory_count countのエイリアス
<?php
$args = [
'exclude' => [10, 12], // ID10と12のカテゴリーを除外
'orderby' => 'count', // 表示する際の順番をcount（記事数）を基準にする
'order' => 'DESC', // 表示順を降順（この場合、記事件数が多い順）にする
];
$categories = get_categories($args);
foreach ($categories as $category) { // 配列から１つ１つ要素（カテゴリーオブジェクト）を取り出して処理
echo $category->term_id; // カテゴリーのIDを取得して表示
echo $category->name; // カテゴリーの名前を取得して表示
}
?>【引数とは】
テンプレートタグ（=関数）を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。
【引数について】
【オブジェクトとは？】
オブジェクトとはデータの集合体です。例えば１つの記事には、記事の公開日、タイトル、本文など様々なデータがあります。それらを１つのデータにまとめたものがオブジェクトです。WordPressに関わらず、オブジェクトはプログラミングで一般的に使われるデータの集合体を示す言葉です。
【戻り値とは？】
テンプレートタグ（＝関数）を実行した結果、返ってくる値のことを戻り値といいます。戻り値を変数に格納してその後の処理に使ったりします。また、テンプレートタグによって、真偽値、オブジェクト、整数など、戻り値の型は様々です。
※戻り値はechoしない限り画面には表示されません。あくまでもプログラミング上で値として返ってくるだけです。戻り値ではなく、値を画面に表示するテンプレートタグもあります。（例：the_title は画面に記事のタイトルを表示するテンプレートタグ）
ニュースやブログページのサイドバーにカテゴリー一覧を表示するなどで使われます。具体的なコードは下記「参考コード」を参考にしてください。
下記例では、カテゴリーの一覧をカテゴリーに紐づく記事が多い順番に表示するコードです。
取得した配列（カテゴリーオブジェクトの配列）からループ処理でカテゴリーオブジェクトを取り出し、そのオブジェクトから必要情報を取得してHTMLに埋め込んでいます。
<?php
$args = [
'orderby' => 'count',
'order' => 'DESC',
];
$categories = get_categories($args);
if (!empty($categories) && !is_wp_error($categories)) { // 空の配列あるいはエラーではないか
echo '<ul>';
foreach ($categories as $category) {
echo '<li>';
echo '<a href="' . get_term_link($category) . '">';
echo $category->name;
echo '</a> (' . $category->count . ')';
echo '</li>';
}
echo '</ul>';
}
?>※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。
