プラグインCustom Post Type UIのcptui_attach_taxonomies_to_post_type関数の使用方法・解説

概要

cptui_attach_taxonomies_to_post_type 関数は、特に WordPress でのカスタム投稿タイプとタクソノミー（分類法）を結びつけるために使用されます。この関数を使用すると、特定のカスタム投稿タイプに対して、指定したタクソノミーを関連付けることができます。よく使われる機能には以下のようなものがあります。

カスタム投稿タイプにタグ付け機能を追加する
特定のカテゴリーをカスタム投稿タイプに適用する
カスタムポートフォリオにジャンルを設定する
カスタムレビュー投稿に評価タクソノミーを関連付ける
イベント投稿に対してタイプを指定する
商品投稿にカテゴリを設定する

構文

cptui_attach_taxonomies_to_post_type( $post_type, $taxonomies );

パラメータ

$post_type (string): タクソノミーを結び付けるカスタム投稿タイプのスラッグ。
$taxonomies (array): 結び付けるタクソノミーのスラッグの配列。

戻り値

この関数は値を返さず、指定されたカスタム投稿タイプにタクソノミーを結びつけます。

対応プラグイン

Custom Post Type UI: バージョン 1.9.0 以降
WordPress: バージョン 4.0 以降

この関数のアクションでの使用可能性

アクション	使用可能性
mu_plugin_loaded
registered_post_type	〇
plugins_loaded	〇
wp_roles_init
setup_theme
after_setup_theme
set_current_user
init	〇
register_sidebar
wp_loaded	〇
send_headers
parse_query
pre_get_posts
wp	〇
template_redirect
get_header
wp_head

サンプルコード

サンプル1: カスタム投稿タイプ「Book」にタクソノミー「Genre」を関連付ける

function attach_genre_taxonomy_to_book() {
    cptui_attach_taxonomies_to_post_type('book', ['genre']);
}
add_action('init', 'attach_genre_taxonomy_to_book');

このサンプルは、カスタム投稿タイプ「Book」にタクソノミー「Genre」を追加する例です。

サンプル2: カスタム投稿タイプ「Movie」にて「Director」タクソノミーを結びつけ

function attach_director_taxonomy_to_movie() {
    cptui_attach_taxonomies_to_post_type('movie', ['director']);
}
add_action('registered_post_type', 'attach_director_taxonomy_to_movie');

このサンプルでは、カスタム投稿タイプ「Movie」に、「Director」というタクソノミーを関連付ける方法を示しています。

サンプル3: 商品投稿タイプに「Product Category」を適用する

function attach_product_category_taxonomy() {
    cptui_attach_taxonomies_to_post_type('product', ['product_category']);
}
add_action('wp_loaded', 'attach_product_category_taxonomy');

この例は、カスタム投稿タイプ「Product」に「Product Category」というタクソノミーを結びつけています。

サンプル4: カスタムレビューに「Review Type」を付加する

function attach_review_type_to_reviews() {
    cptui_attach_taxonomies_to_post_type('review', ['review_type']);
}
add_action('template_redirect', 'attach_review_type_to_reviews');

このサンプルは、「Review」というカスタム投稿タイプに「Review Type」というタクソノミーを追加するものです。

サンプル5: イベントカスタム投稿に「Event Type」を実装

function attach_event_type_to_events() {
    cptui_attach_taxonomies_to_post_type('event', ['event_type']);
}
add_action('after_setup_theme', 'attach_event_type_to_events');

この例では、カスタム投稿タイプ「Event」に「Event Type」を結びつけています。

概要

構文