ووکامرس (WooCommerce) Filter Hook / Output Hook پلتفرم: woocommerce متوسط (Medium) سطح ریسک: پایین و بی‌خطر (Low Risk)

تغییر تعداد محصولات پیشنهادی بیش‌فروشی در ووکامرس (Upsell Products Count)

تست‌شده و بازبینی‌شده در 1405/06/29 ۵۷۵ بار کپی ۲۷۳۸ مشاهده
پاسخ سریع و خلاصه کاربردی (Quick Answer)

با لغو اکشن پیش‌فرض و تعریف مجدد `woocommerce_upsell_display` با آرگومان‌های سفارشی (مثلاً ۳ ستونه)، نمایش آن را تنظیم کنید.

مشخصات فنی و شناسنامه کد (Code Information)

بازبینی: 1405/06/29
پلتفرم اجرایی (Platform) woocommerce
نوع کد (Code Type) Filter Hook / Output Hook
محل قرارگیری فایل (Location) functions.php
سطح دشواری (Difficulty) متوسط (Medium)
سطح ریسک (Risk Level) پایین و بی‌خطر (Low Risk)
نیاز به بکاپ اولیه؟ خیر (کم‌ریسک)
سازگاری با وردپرس تمامی نسخه‌ها
سازگاری با ووکامرس و HPOS سازگار
|
<?php
/**
 * تغییر تعداد کل و تعداد ستون‌های بخش بیش‌فروشی (Upsells) ووکامرس
 */
function bisco_custom_upsell_display() {
    // ۳ محصول در یک ردیف ۳ ستونه
    woocommerce_upsell_display( 3, 3 );
}
remove_action( 'woocommerce_after_single_product_summary', 'woocommerce_upsell_display', 15 );
add_action( 'woocommerce_after_single_product_summary', 'bisco_custom_upsell_display', 15 );

کد را کجا قرار دهیم؟ (Placement Guide)

کد را در functions.php قرار دهید.

مسیر فایل: functions.php

این کد چگونه کار می‌کند؟ (How it Works)

تابع پیش‌فرض با اولویت ۱۵ حذف شده و تابع بازنویسی شده با تعداد محدود و مشخص در همان اولویت جایگزین می‌شود.

چه زمانی از این کد استفاده کنیم؟ (Use Cases)

هنگامی که می‌خواهید محصولات لوکس‌تر و گران‌تر با ابعاد کارت بزرگ‌تر (مثلاً ۳ ستونه) چشمگیرتر شوند.

چه زمانی نباید از این کد استفاده کنیم؟ (Anti-patterns)

در محصولاتی که هیچ لینک بیش‌فروشی برای آن‌ها در پنل ثبت نشده است.

پیش‌نیازهای اجرا

تعریف محصولات در تب پیوندها > تشویق برای خرید بیشتر در ویرایش محصول.

نحوه تست و اطمینان از عملکرد

برای یک محصول آپ‌سل تعریف کنید و صفحه آن را ببینید؛ دقیقاً به تعداد تعیین شده ظاهر خواهند شد.

نحوه بازگردانی سریع (Rollback)

کد را حذف کنید.

خطاهای رایج و راه‌حل رفع

فراموشی تعیین شناسه کالای آپ‌سل در تب پیوندهای ووکامرس.

ملاحظات و نکات امنیتی

فاقد ریسک امنیتی.

تاثیر بر سرعت و پرفورمنس

کاهش حجم DOM صفحه.

پرسش‌های متداول پیرامون این کد (FAQ)

بیش‌فروشی (Upsell) در صفحه خود محصول برای معرفی مدل بهتر و گران‌تر است، در حالی که بیش‌خرید (Cross-sell) در سبد خرید برای اقلام مکمل (مثل گلس برای موبایل) است.
منابع و مستندات رسمی بررسی‌شده (Official Sources):

سبد خرید شما

0 افزونه

سبد خرید شما خالی است

هنوز محصولی را به سبد خرید اضافه نکرده‌اید. می‌توانید از افزونه‌های اختصاصی ما دیدن فرمایید.

مشاهده فروشگاه افزونه‌ها

ثبت درخواست مشاوره

با تکمیل فرم زیر، کارشناسان فنی بیسکو وب در سریع‌ترین زمان ممکن با شما تماس می‌گیرند.

مشاور
پشتیبانی و مشاوره تخصصی
پاسخگویی سریع کارشناسان
09903336117