ووکامرس (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

فعال‌سازی اعلان‌های وب‌اپلیکیشن

از آخرین تخفیف‌های شگفت‌انگیز، وضعیت سفارشات و به‌روزرسانی‌های اختصاصی روی گوشی خود باخبر شوید.