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

概要

woocommerce_cart_coupon_typesフィルタは、WooCommerceで利用可能なクーポンの種類を変更するために使用されます。このフィルタを利用することで、特定の取引条件に応じたクーポンの提供や、特別なプロモーションのためにクーポンのタイプを追加・変更することができます。よく使われる場面としては以下のようなものがあります。

1. クーポンの新しいタイプを追加する。
2. 特定のユーザーグループ向けのクーポンを作成する。
3. 実施したいプロモーションに応じたクーポンを設定する。
4. クーポンの有効期限や使用条件を制限する。
5. セールイベントに合わせた特別クーポンを提供する。
6. カスタムフィールドを基にした特定の割引を提供する。

構文

add_filter('woocommerce_cart_coupon_types', 'custom_coupon_types');

パラメータ

• $coupon_types: 既存のクーポンタイプの配列。

戻り値

• 修正されたクーポンタイプの配列。

バージョン

• WooCommerce: 3.0.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

このサンプルコードでは、新しいクーポンタイプ「特別割引」を追加しています。

add_filter('woocommerce_cart_coupon_types', function($coupon_types) {
    $coupon_types[] = 'special_discount';
    return $coupon_types;
});

引用元: https://developer.wordpress.org/plugins/hooks/

サンプルコード 2

カスタムクーポンタイプ「ボリュームディスカウント」を追加するサンプルです。

function add_volume_discount_coupon_type($coupon_types) {
    $coupon_types[] = 'volume_discount';
    return $coupon_types;
}
add_filter('woocommerce_cart_coupon_types', 'add_volume_discount_coupon_type');

引用元: https://developer.wordpress.org/plugins/hooks/

サンプルコード 3

特定の条件を満たした場合にのみクーポンタイプを追加する例です。

add_filter('woocommerce_cart_coupon_types', function($coupon_types) {
    if (is_user_logged_in()) {
        $coupon_types[] = 'logged_in_discount';
    }
    return $coupon_types;
});

引用元: https://developer.wordpress.org/plugins/hooks/

サンプルコード 4

クーポンタイプの説明を変更するサンプルです。

add_filter('woocommerce_cart_coupon_types', function($coupon_types) {
    $coupon_types['general_discount'] = '通常割引 - 一般';
    return $coupon_types;
});

引用元: https://developer.wordpress.org/plugins/hooks/

サンプルコード 5

特別なプロモーション用のクーポンタイプを追加するサンプルです。

function add_promotional_coupon_type($coupon_types) {
    $coupon_types[] = 'holiday_promo';
    return $coupon_types;
}
add_filter('woocommerce_cart_coupon_types', 'add_promotional_coupon_type');

引用元: https://developer.wordpress.org/plugins/hooks/