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

概要

woocommerce_quantity_input_minフィルタは、WooCommerceの製品ページにおいて、数量入力フィールドの最小値を変更するために使用されます。このフィルタを利用することで、ユーザーが選択できる最小数量をカスタマイズすることができます。具体的には、以下のような場合に非常に役立ちます。

特定の製品の購入制限を設定したい場合。
単位あたりの販売を行う場合（例：パッケージ販売）。
マーケティング戦略としての数量割引を強化したい場合。
在庫管理の観点から最小購入数量を設定したい場合。
プレゼントやギフトバスケットに最適な数量を制御したい場合。
複数商品をセットとして販売する場合。

構文

フィルタの構文は次の通りです。

add_filter('woocommerce_quantity_input_min', 'custom_min_quantity', 10, 2);

パラメータ

$min_quantity: 現在の最小数量。
$product: 対象のWooCommerce製品オブジェクト。

戻り値

このフィルタは、最小数量を表す整数値を戻り値として返します。

バージョン

WooCommerce: 2.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: 最小数量を1に設定

このコードは、すべての製品の最小数量を1に設定します。

add_filter('woocommerce_quantity_input_min', 'set_min_quantity_to_one', 10, 2);

function set_min_quantity_to_one($min_quantity, $product) {
    return 1; // 最小数量を1に設定
}

(出典: https://www.wpexplorer.com/)

サンプルコード2: 特定の製品の最小数量を3に設定

このコードでは、特定の製品の最小購入数量を3に変更します。

add_filter('woocommerce_quantity_input_min', 'set_specific_min_quantity', 10, 2);

function set_specific_min_quantity($min_quantity, $product) {
    if ($product->get_id() === 123) { // 製品IDが123の製品
        return 3; // 最小数量を3に設定
    }
    return $min_quantity; // それ以外は変更しない
}

(出典: https://woocommerce.com/)

サンプルコード3: 限定販売用の最小数量を設定

このコードは、限定販売用の製品に対してのみ最小数量を設定します。

add_filter('woocommerce_quantity_input_min', 'set_min_quantity_for_limited_sales', 10, 2);

function set_min_quantity_for_limited_sales($min_quantity, $product) {
    if ($product->is_type('limited-edition')) {
        return 5; // 限定販売商品の最小数量を5に設定
    }
    return $min_quantity;
}

(出典: https://www.businessbloomer.com/)

サンプルコード4: 属性に基づいて最小数量を設定

このコードは、特定の製品属性（色）に基づいて最小数量を決定します。

add_filter('woocommerce_quantity_input_min', 'set_min_quantity_based_on_attribute', 10, 2);

function set_min_quantity_based_on_attribute($min_quantity, $product) {
    $attributes = $product->get_attributes();
    if (isset($attributes['color']) && $attributes['color'] === 'red') {
        return 2; // 赤色の商品は最小数量を2に設定
    }
    return $min_quantity;
}

(出典: https://themeisle.com/)

サンプルコード5: カスタムユーザーロール向けの最小数量を設定

このコードは、特定のユーザーロール（「wholesale」）を持つユーザーに対して最小数量を設定します。

add_filter('woocommerce_quantity_input_min', 'set_min_quantity_for_wholesale', 10, 2);

function set_min_quantity_for_wholesale($min_quantity, $product) {
    if (current_user_can('wholesale')) {
        return 10; // 卸売業者には最小数量を10に設定
    }
    return $min_quantity;
}

(出典: https://www.wpbeginner.com/)

概要

構文