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

概要

woocommerce_variation_prices_array フィルタは、WooCommerceでの変数商品の価格情報（バリエーションの価格）をフィルタリングするために使用されます。このフィルタを使うことで、特定の条件に基づいて価格を変更したり、特定のデータを追加したりすることが可能です。主に以下のような機能を実装する際によく使われます。

商品の割引価格の設定
商品の価格を地域によって変更
特定の条件に基づいて価格の表示方法を変更
メール通知やカスタム通知に価格情報を追加
プロモーションキャンペーンのための特別価格の設定
顧客のロイヤルティに基づいた価格の調整

構文

apply_filters( 'woocommerce_variation_prices_array', $price, $product, $display_price );

パラメータ

$prices (array): 商品のバリエーション価格の配列。
$product (WC_Product): 価格を持つWC_Productオブジェクト。
$display_price (float): 商品の表示価格。

戻り値

(array): フィルタされたバリエーションの価格の配列。

使用可能なバージョン

WooCommerce: 3.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_variation_prices_array', 'custom_variation_discount', 10, 3 );
function custom_variation_discount( $prices, $product, $display_price ) {
    foreach ( $prices as $key => $price ) {
        if ( $price > 100 ) { // 100以上の商品に割引を適用
            $prices[$key] -= 10; // 10の割引
        }
    }
    return $prices;
}

サンプル2: 特定の地域に合わせた価格変更

このコードは、特定の地域にいる顧客に特別な価格を表示するものです。

add_filter( 'woocommerce_variation_prices_array', 'localize_variation_prices', 10, 3 );
function localize_variation_prices( $prices, $product, $display_price ) {
    if ( isset($_COOKIE['user_location']) && $_COOKIE['user_location'] == 'JP' ) {
        foreach ( $prices as $key => $price ) {
            $prices[$key] += 500; // 日本の顧客には500円の追加
        }
    }
    return $prices;
}

サンプル3: プロモーション価格の設定

このコードは、特定の日にプロモーション価格を適用するためのものです。

add_filter( 'woocommerce_variation_prices_array', 'promotion_price_on_special_day', 10, 3 );
function promotion_price_on_special_day( $prices, $product, $display_price ) {
    $today = date('Y-m-d');
    if ( $today == '2023-12-25' ) { // クリスマスに特別価格
        foreach ( $prices as $key => $price ) {
            $prices[$key] -= 20; // 20の割引
        }
    }
    return $prices;
}

サンプル4: 商品タグに基づく価格変更

このコードは、特定の商品のタグに基づいて価格を変更します。

add_filter( 'woocommerce_variation_prices_array', 'tag_based_price_adjustment', 10, 3 );
function tag_based_price_adjustment( $prices, $product, $display_price ) {
    if ( has_term( 'special', 'product_tag', $product->get_id() ) ) {
        foreach ( $prices as $key => $price ) {
            $prices[$key] -= 15; // 特別なタグが付いている商品の価格を15下げる
        }
    }
    return $prices;
}

サンプル5: 顧客グループに基づく価格調整

このコードは、顧客のグループに基づいて価格を調整します。

add_filter( 'woocommerce_variation_prices_array', 'group_based_price_adjustment', 10, 3 );
function group_based_price_adjustment( $prices, $product, $display_price ) {
    if ( current_user_can( 'wholesale_customer' ) ) {
        foreach ( $prices as $key => $price ) {
            $prices[$key] -= 5; // 卸売顧客には5の割引
        }
    }
    return $prices;
}

これらのサンプルコードにより、woocommerce_variation_prices_array フィルタを活用して、さまざまな条件で価格を調整する方法が示されています。

概要

構文