プラグインWooCommerceのwoocommerce_taxonomy_args_$NAMEフィルタの使用方法・解説

概要

woocommerce_taxonomy_args_$NAME フィルタは、WooCommerceでカスタムタクソノミーの引数を変更するために使用されます。このフックは、特定のタクソノミーに関連する設定をカスタマイズする際に便利です。このフィルタを利用することにより、タクソノミーのラベル、階層構造、公開状態、表示設定などを変更できます。

よく使われる機能

タクソノミーのラベルを変更する
タクソノミーの階層性を設定する
カスタムメタデータを追加する
タクソノミーの投稿タイプを変更する
タクソノミーの公開権限を設定する
タクソノミーの初期値を設定する

構文

add_filter('woocommerce_taxonomy_args_$NAME', 'your_custom_function');

パラメータ

$args : タクソノミーの引数の配列。
$NAME : 変更対象のタクソノミーの名前。

戻り値

変更された引数の配列。

使用可能なバージョン

WooCommerce : バージョン 3.0 以降
WordPress : バージョン 4.0 以降

サンプルコード

サンプルコード 1

add_filter('woocommerce_taxonomy_args_product_cat', 'custom_product_cat_args');

function custom_product_cat_args($args) {
    $args['hierarchical'] = true; // 階層を有効にする
    return $args;
}

このサンプルでは、商品カテゴリー（product_cat）の階層を有効にしています。

サンプルコード 2

add_filter('woocommerce_taxonomy_args_product_tag', 'custom_product_tag_labels');

function custom_product_tag_labels($args) {
    $args['labels'] = array(
        'name' => 'カスタム商品タグ',
        'singular_name' => 'カスタム商品タグ',
    );
    return $args;
}

こちらは、商品タグ（product_tag）のラベルをカスタマイズしたサンプルです。

サンプルコード 3

add_filter('woocommerce_taxonomy_args_product_cat', 'modify_product_cat_meta');

function modify_product_cat_meta($args) {
    $args['meta_box_cb'] = false; // メタボックスを非表示にする
    return $args;
}

このコードは、商品カテゴリーのメタボックス表示を無効にしています。

サンプルコード 4

add_filter('woocommerce_taxonomy_args_product_cat', 'change_product_cat_capabilities');

function change_product_cat_capabilities($args) {
    $args['capabilities'] = array(
        'manage_terms' => 'manage_product_terms',
        'edit_terms' => 'edit_product_terms',
        'delete_terms' => 'delete_product_terms',
        'assign_terms' => 'assign_product_terms',
    );
    return $args;
}

このサンプルでは、商品カテゴリーの権限設定を変更しています。

サンプルコード 5

add_filter('woocommerce_taxonomy_args_product_tag', 'set_product_tag_default');

function set_product_tag_default($args) {
    $args['default'] = '新しい商品タグ'; // デフォルトのタグを設定
    return $args;
}

このコードは、商品タグにデフォルト値を設定しています。

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

アクション	使用可能性
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

概要