PHPのコード

以下のコードをfunctions.phpに追加すると、記事APIにカテゴリ情報を含めることができます。

add_action( 'rest_api_init', 'api_add_fields' );
function api_add_fields() {
  register_rest_field( 'post',
    'cat_info',
     array(
      'get_callback'    => 'register_fields',
      'update_callback' => null,
      'schema'          => null,
    )
  );
}
function register_fields( $post, $name ) {
  return get_the_category($post['id']);
}

get_the_category()は記事に含まれるカテゴリ一覧を連想配列で返すので、そのままAPIに放り込むことができます。

カテゴリ部分の出力結果はこんな↓感じになります。

"cat_info": [
  {
    "term_id": 14,
    "name": "REST API",
    "slug": "wp-rest-api",
    "term_group": 0,
    "term_taxonomy_id": 14,
    "taxonomy": "category",
    "description": "",
    "parent": 8,
    "count": 9,
    "filter": "raw",
    "cat_ID": 14,
    "category_count": 9,
    "category_description": "",
    "cat_name": "REST API",
    "category_nicename": "wp-rest-api",
    "category_parent": 8
  },
  {
    "term_id": 8,
    "name": "WordPress",
    "slug": "wp",
    "term_group": 0,
    "term_taxonomy_id": 8,
    "taxonomy": "category",
    "description": "",
    "parent": 0,
    "count": 12,
    "filter": "raw",
    "cat_ID": 8,
    "category_count": 12,
    "category_description": "",
    "cat_name": "WordPress",
    "category_nicename": "wp",
    "category_parent": 0
  }
]

カテゴリの必要な情報だけ含めるコード

上のコードだとPHP部分は簡単ですが、カテゴリの要素がWordPressそのままになっていて、無駄が多いし「id」がないので直感的でない部分もあります。

それを解決するためにコールバック関数を書き換えたコードがコレ↓です。

function register_fields( $post, $name ) {
  $cats = get_the_category($post['id']);
  
  $data = array();
  
  foreach ( $cats as $cat ) {
    $current = array();
    
    $current['id'] = $cat->term_id;
    $current['slug'] = $cat->slug;
    $current['name'] = $cat->name;
    $current['url'] = get_category_link($cat->term_id);
    
    array_push($data, $current);
  }
  
  return $data;
}

URLが欲しい人もいると思うのでWordPress側で先にカテゴリページのURLを取得しています。

出力結果はこんな↓感じになります。

"cat_info": [
  {
    "id": 14,
    "slug": "wp-rest-api",
    "name": "REST API",
    "url": "https://dev.ore-shika.com/cat/wp/wp-rest-api/"
  },
  {
    "id": 8,
    "slug": "wp",
    "name": "WordPress",
    "url": "https://dev.ore-shika.com/cat/wp/"
  }
]

上記コードの注意点

APIに追加するキー「cat_info」の部分。

普通に考えると「categories」とか付けてしまいそうですが、「categories」にするとデフォルトで入っている「categories」を上書きしてしまいます。

上書きしてしまって問題ないことを確認している場合は問題ありませんが、上書きされると困る場合(categories以下にカテゴリID配列が入ってるものとして既に処理してる場合など)は別の名前にしましょう。

まぁ内容的には上位互換なので問題ないケースが多いと思います。