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

概要

cptui_third_party_taxonomy_import 関数は、WordPress プラグイン「Custom Post Type UI」におけるカスタムタクソノミーのインポートを支援する機能です。この関数は、特に他のプラグインやテーマとの連携を必要とするシナリオで頻繁に使用されます。以下は、この関数がよく使われる機能の例です。

外部プラグインからのカスタムタクソノミーのインポート
他のテーマからのカスタムタクソノミーの統合
プラグインが提供するデフォルト設定の上書き
エクスポートされたデータのインポート
ユーザー定義のタクソノミー設定の管理
カスタムポストタイプ間でのタクソノミーの関連付け

構文

cptui_third_party_taxonomy_import($taxonomy_data);

パラメータ

$taxonomy_data (array): インポートするカスタムタクソノミーの設定情報を含む配列。

戻り値

返り値は特に設けられていないため、成功した場合には何も返さない。

使用可能なプラグインバージョン

Custom Post Type UI: バージョン 1.9.0 以降で使用可能。

使用可能なWordPressバージョン

WordPress: バージョン 4.5 以降で使用可能。

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

アクション	使用例の有無
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

サンプルコード

以下は cptui_third_party_taxonomy_import 関数を使用したサンプルコードです。

サンプルコード 1

function import_my_custom_taxonomy() {
    $taxonomy_data = array(
        'taxonomy' => 'my_custom_taxonomy',
        'object_type' => array('post', 'page'),
        'args' => array(
            'label' => 'My Custom Taxonomy',
            'hierarchical' => true,
        )
    );
    cptui_third_party_taxonomy_import($taxonomy_data);
}
add_action('init', 'import_my_custom_taxonomy');

このサンプルは、新しいカスタムタクソノミー「my_custom_taxonomy」を自分の投稿タイプに関連付ける例です。

サンプルコード 2

function import_additional_taxonomies() {
    $taxonomy_data = array(
        'taxonomy' => 'additional_taxonomy',
        'object_type' => array('post'),
        'args' => array(
            'label' => 'Additional Taxonomy',
        )
    );
    cptui_third_party_taxonomy_import($taxonomy_data);
}
add_action('plugins_loaded', 'import_additional_taxonomies');

このサンプルでは、「plugins_loaded」フックを使って追加のタクソノミーをインポートしています。

サンプルコード 3

function advanced_taxonomy_import() {
    $taxonomy_data = array(
        'taxonomy' => 'advanced_taxonomy',
        'object_type' => array('custom_post_type'),
        'args' => array(
            'show_admin_column' => true,
            'rewrite' => array('slug' => 'advanced-taxonomy')
        )
    );
    cptui_third_party_taxonomy_import($taxonomy_data);
}
add_action('wp_loaded', 'advanced_taxonomy_import');

このサンプルは、特定のカスタムポストタイプに関連付けた複雑なタクソノミーのインポートを行っています。

サンプルコード 4

function import_taxonomies_on_theme_setup() {
    $taxonomy_data = array(
        'taxonomy' => 'theme_taxonomy',
        'object_type' => array('portfolio'),
        'args' => array(
            'public' => true,
            'hierarchical' => false,
        )
    );
    cptui_third_party_taxonomy_import($taxonomy_data);
}
add_action('after_setup_theme', 'import_taxonomies_on_theme_setup');

このサンプルでは、テーマセットアップ時にカスタムタクソノミーをインポートします。

サンプルコード 5

function custom_taxonomy_import() {
    $taxonomy_data = array(
        'taxonomy' => 'custom_cat',
        'object_type' => array('news'),
        'args' => array(
            'labels' => array(),
            'rewrite' => array('slug' => 'custom-cat')
        )
    );
    cptui_third_party_taxonomy_import($taxonomy_data);
}
add_action('init', 'custom_taxonomy_import');

このサンプルは、カスタムのニュースポストタイプに関連付けたタクソノミーのインポート例です。

この解説を通じて、cptui_third_party_taxonomy_import 関数の概要とサンプルコードを理解していただけたかと思います。

概要

構文