تنظیم گام شمارش و ضریب تعداد خرید در ووکامرس (Product Quantity Step)
با فیلتر `woocommerce_quantity_input_step` گام افزایش/کاهش تعداد محصول را روی ضریب دلخواه (مثلاً ۵ یا ۶) تنظیم نمایید.
مشخصات فنی و شناسنامه کد (Code Information)
بازبینی: 1405/06/29<?php
/**
* تنظیم گام افزایش و ضریب شمارش تعداد محصول (مثلاً مضرب‌های ۵تایی: ۵، ۱۰، ۱۵، ۲۰)
*/
function bisco_set_quantity_step( $step, $product ) {
return 5; // هر کلیک ۵ عدد اضافه کند
}
add_filter( 'woocommerce_quantity_input_step', 'bisco_set_quantity_step', 10, 2 );کد را کجا قرار دهیم؟ (Placement Guide)
کد را در functions.php قرار دهید.
این کد چگونه کار می‌کند؟ (How it Works)
صفت HTML5 `step="5"` بر روی ورودی عددی ست شده و مرورگر افزایش و کاهش را فقط با مضارب ۵ انجام می‌دهد.
چه زمانی از این کد استفاده کنیم؟ (Use Cases)
در فروشگاه‌های کاشی و سرامیک (بر اساس مترمربع)، کالاهای بسته‌بندی شده یا خوراکی‌های کیلویی.
چه زمانی نباید از این کد استفاده کنیم؟ (Anti-patterns)
در کالاهای تکی که مشتری باید بتواند عدد ۱، ۲، ۳ را برگزیند.
پیش‌نیازهای اجرا
ووکامرس فعال.
نحوه تست و اطمینان از عملکرد
دکمه مثبت فیلد تعداد را بزنید؛ اعداد به صورت ۵، ۱۰، ۱۵ جهش پیدا می‌کنند.
نحوه بازگردانی سریع (Rollback)
فیلتر را حذف کنید.
خطاهای رایج و راه‌حل رفع
تنظیم step بدون تعیین min متناسب (بهتر است مقدار min نیز برابر یا مضربی از step باشد).
ملاحظات و نکات امنیتی
اعتبارسنجی خودکار توسط مرورگر و هسته ووکامرس.
تاثیر بر سرعت و پرفورمنس
بدون بار محاسباتی.
