add_filter( 'woocommerce_package_rates', 'free_shipping_for_product_qty', 100, 2 );

function shipping_for_product_qty( $rates, $package ) {

    // شناسه محصول اصلی (والد) را وارد کنید؛ نه شناسه تنوع
    $target_product_id = 1234;

    // حداقل تعداد موردنیاز
    $required_qty = 2;

    $target_qty = 0;

    // شمارش تعداد محصول در همین بسته حمل‌ونقل
    if ( ! empty( $package['contents'] ) ) {
        foreach ( $package['contents'] as $cart_item ) {

            $product_id   = isset( $cart_item['product_id'] )
                ? (int) $cart_item['product_id']
                : 0;

            $variation_id = isset( $cart_item['variation_id'] )
                ? (int) $cart_item['variation_id']
                : 0;

            /*
             * برای محصولات متغیر، product_id معمولاً شناسه محصول والد است.
             * شرط variation_id نیز برای انعطاف بیشتر بررسی می‌شود.
             */
            if (
                $product_id === $target_product_id ||
                $variation_id === $target_product_id
            ) {
                $target_qty += (int) $cart_item['quantity'];
            }
        }
    }

    /*
     * اگر حداقل ۲ عدد وجود دارد:
     * فقط ارسال رایگان نمایش داده شود.
     */
    if ( $target_qty >= $required_qty ) {

        $free_rates = array();

        foreach ( $rates as $rate_id => $rate ) {
            if ( 'free_shipping' === $rate->method_id ) {
                $free_rates[ $rate_id ] = $rate;
            }
        }

        // فقط در صورتی جایگزین می‌کنیم که روش ارسال رایگان موجود باشد
        if ( ! empty( $free_rates ) ) {
            return $free_rates;
        }

        return $rates;
    }

    /*
     * اگر تعداد کمتر از ۲ است:
     * ارسال رایگان حذف شود و روش‌های پولی باقی بمانند.
     */
    foreach ( $rates as $rate_id => $rate ) {
        if ( 'free_shipping' === $rate->method_id ) {
            unset( $rates[ $rate_id ] );
        }
    }

    return $rates;
}

add_filter( 'woocommerce_package_rates', 'free_shipping_for_selected_products', 100, 2 );

function free_shipping_for_selected_products( $rates, $package ) {

    /*
     * شناسه محصولات اصلی/والد را وارد کنید.
     * برای محصولات متغیر، شناسه محصول والد را قرار دهید، نه شناسه تنوع.
     */
    $target_product_ids = array(
        1234,
        5678,
        9012,
    );

    // حداقل تعداد از یکی از محصولات منتخب
    $required_qty = 2;

    // نگهداری تعداد هر محصول به‌صورت جداگانه
    $product_quantities = array();

    foreach ( $target_product_ids as $product_id ) {
        $product_quantities[ $product_id ] = 0;
    }

    // شمارش تعداد هر محصول منتخب در بسته حمل‌ونقل
    if ( ! empty( $package['contents'] ) ) {

        foreach ( $package['contents'] as $cart_item ) {

            $product_id = isset( $cart_item['product_id'] )
                ? (int) $cart_item['product_id']
                : 0;

            $quantity = isset( $cart_item['quantity'] )
                ? (int) $cart_item['quantity']
                : 0;

            /*
             * در محصول متغیر، product_id شناسه محصول والد است.
             */
            if ( in_array( $product_id, $target_product_ids, true ) ) {
                $product_quantities[ $product_id ] += $quantity;
            }
        }
    }

    $free_shipping_allowed = false;

    // بررسی می‌کند آیا حداقل یکی از محصولات به تعداد موردنیاز رسیده است
    foreach ( $product_quantities as $quantity ) {
        if ( $quantity >= $required_qty ) {
            $free_shipping_allowed = true;
            break;
        }
    }

    /*
     * در صورت برقرار بودن شرط، فقط روش ارسال رایگان نمایش داده شود.
     */
    if ( $free_shipping_allowed ) {

        $free_rates = array();

        foreach ( $rates as $rate_id => $rate ) {
            if ( 'free_shipping' === $rate->method_id ) {
                $free_rates[ $rate_id ] = $rate;
            }
        }

        if ( ! empty( $free_rates ) ) {
            return $free_rates;
        }

        return $rates;
    }

    /*
     * در صورت برقرار نبودن شرط، ارسال رایگان مخفی شود.
     */
    foreach ( $rates as $rate_id => $rate ) {
        if ( 'free_shipping' === $rate->method_id ) {
            unset( $rates[ $rate_id ] );
        }
    }

    return $rates;
}

add_filter( 'woocommerce_package_rates', 'free_shipping_for_selected_products_total_qty', 100, 2 );

function free_shipping_for_selected_products_total_qty( $rates, $package ) {

    /*
     * شناسه محصولات اصلی/والد
     */
    $target_product_ids = array(
        1234,
        5678,
        9012,
    );

    // حداقل مجموع تعداد محصولات منتخب
    $required_qty = 2;

    $total_target_qty = 0;

    if ( ! empty( $package['contents'] ) ) {

        foreach ( $package['contents'] as $cart_item ) {

            $product_id = isset( $cart_item['product_id'] )
                ? (int) $cart_item['product_id']
                : 0;

            $quantity = isset( $cart_item['quantity'] )
                ? (int) $cart_item['quantity']
                : 0;

            /*
             * تمام تنوع‌های محصول بر اساس شناسه والد محاسبه می‌شوند.
             */
            if ( in_array( $product_id, $target_product_ids, true ) ) {
                $total_target_qty += $quantity;
            }
        }
    }

    /*
     * اگر مجموع محصولات منتخب حداقل ۲ عدد باشد،
     * فقط ارسال رایگان نمایش داده شود.
     */
    if ( $total_target_qty >= $required_qty ) {

        $free_rates = array();

        foreach ( $rates as $rate_id => $rate ) {
            if ( 'free_shipping' === $rate->method_id ) {
                $free_rates[ $rate_id ] = $rate;
            }
        }

        if ( ! empty( $free_rates ) ) {
            return $free_rates;
        }

        return $rates;
    }

    /*
     * اگر شرط برقرار نیست، ارسال رایگان مخفی شود.
     */
    foreach ( $rates as $rate_id => $rate ) {
        if ( 'free_shipping' === $rate->method_id ) {
            unset( $rates[ $rate_id ] );
        }
    }

    return $rates;
}