wp_get_post_categories()


WordPressのwp_get_post_categories()関数は、指定された投稿に関連付けられたカテゴリーのIDを取得するために使用されます。この関数は、投稿のカテゴリー情報を取得する際に便利です。

構文

wp_get_post_categories( int $post_id = 0, array $args = array() );

引数の説明:

  • $post_id(int) — カテゴリーを取得したい投稿のID。デフォルトは0で、現在の投稿を指します。
  • $args(array) — カテゴリーを取得する際のオプションを指定する配列。以下のキーを持つことができます：
    • fields — 返されるフィールドを指定。’ids’（デフォルト）または ‘all’。
    • orderby — カテゴリーを並べ替える基準。デフォルトは ‘name’。
    • order — 並べ替え順序。’ASC’（昇順）または ‘DESC’（降順）。デフォルトは ‘ASC’。

例1: 現在の投稿のカテゴリーIDを取得

現在の投稿に関連付けられたカテゴリーIDを取得する基本的な例です。

$categories = wp_get_post_categories(get_the_ID());

例2: カテゴリー名を取得

カテゴリーIDではなく、カテゴリー名を取得する例です。

$categories = wp_get_post_categories(get_the_ID(), array('fields' => 'names'));

例3: カテゴリーを降順で取得

カテゴリーを名前の降順で取得する例です。

$categories = wp_get_post_categories(get_the_ID(), array('orderby' => 'name', 'order' => 'DESC'));

例4: 特定の投稿のカテゴリーを取得

特定の投稿ID（例: 123）のカテゴリーを取得する例です。

$categories = wp_get_post_categories(123);

例5: カテゴリーの全情報を取得

カテゴリーの全情報（ID、名前、スラッグなど）を取得する例です。

$categories = wp_get_post_categories(get_the_ID(), array('fields' => 'all'));

例6: カテゴリーのスラッグを取得

カテゴリーのスラッグを取得する例です。

$categories = wp_get_post_categories(get_the_ID(), array('fields' => 'slugs'));

例7: カテゴリーをIDで並べ替え

カテゴリーをIDで並べ替えて取得する例です。

$categories = wp_get_post_categories(get_the_ID(), array('orderby' => 'id'));

例8: カテゴリーをカスタム順序で取得

カテゴリーをカスタム順序で取得する例です。

$categories = wp_get_post_categories(get_the_ID(), array('orderby' => 'include'));

注意点

  • 投稿IDが存在しない場合、関数は空の配列を返します。
  • fieldsオプションに無効な値を指定すると、デフォルトの’ids’が使用されます。
  • カテゴリーが設定されていない投稿の場合、空の配列が返されます。

関連機能：