> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# قصر السلة على عرض بيع إضافي واحد في كل مرة

> استخدم HTML مخصصًا لإخفاء وحدة البيع الإضافي بعد إضافة عرض بيع إضافي واحد إلى السلة.

<div id="overview">
  # نظرة عامة
</div>

يمنع هذا التخصيص إضافة عدة عروض بيع إضافي (upsells) في وقت واحد عن طريق إخفاء قسم البيع الإضافي بمجرد قبول عرض واحد. وبمجرد إزالة العرض، تظهر الوحدة مرة أخرى.

هذا مفيد إذا كنت تريد:

* تبسيط تجربة السلة
* تقليل إرهاق اتخاذ القرار
* الحفاظ على حصرية عروض معينة

***

<div id="how-it-works">
  ## كيف يعمل
</div>

* عندما يقبل العميل عرض بيع إضافي، يُخفى قسم البيع الإضافي
* إذا أُزيل عنصر البيع الإضافي، يصبح قسم البيع الإضافي مرئيًا مرة أخرى
* يعمل مع كل من عروض البيع الإضافي الموصى بها بالذكاء الاصطناعي واليدوية

***

<div id="where-to-add-the-code">
  ## أين تضيف الكود
</div>

1. انتقل إلى **Upcart > Cart Editor > Settings > Custom HTML**

<Warning>
  **المحدد أدناه خاص بالإصدار 1 فقط.** `.upcart-upsells-module` موجود في كاروسيل عروض البيع الإضافي في V1. إذا كانت وحدة Upsells لديك على **الإصدار 2**، فاستبدله بـ `.upcart-public-upsell` في المعالجات الثلاثة جميعها — بقية السكربت لا تتغير. راجع [مكتبة محددات CSS لـ V2](/ar/upcart/upcart_css_selector_library_v2).
</Warning>

2. الصق الكود التالي في موقع **Above announcements/rewards**

***

<div id="html-script-to-copy">
  ## سكربت HTML للنسخ
</div>

```
<script>  
  // Show upsells again when upsells are removed  
  window.upcartSubscribeItemRemoved((event) => {  
    if (event.item?.properties?.__upcartUpsell) {  
      const upsells = window.upcartDocumentOrShadowRoot.querySelector(".upcart-upsells-module");  
      if (upsells) upsells.style.display = "block";  
    }  
  });  
  
  // Hide upsells once one is added  
  window.upcartSubscribeUpsellsAddedToCart(() => {  
    const upsells = window.upcartDocumentOrShadowRoot.querySelector(".upcart-upsells-module");  
    if (upsells) upsells.style.display = "none";  
  });  
  
  // Check for upsell in cart when it loads  
  window.upcartSubscribeCartLoaded((event) => {  
    const upsells = window.upcartDocumentOrShadowRoot.querySelector(".upcart-upsells-module");  
    const items = event.cart.items || [];  
    const hasUpsell = items.some(item => item?.properties?.__upcartUpsell);  
    if (upsells && hasUpsell) {  
      upsells.style.display = "none";  
    }  
  });  
</script>
```

<Note>
  **ملاحظة حول الإصدارات القديمة:** لا تزال دوال الاستدعاء `window.upcartOnItemRemoved` و`window.upcartOnAddUpsell` و`window.upcartOnCartLoaded` تعمل ولكنها مهملة وتسجل تحذيرات في وحدة التحكم. استخدم `upcartSubscribeItemRemoved` و`upcartSubscribeUpsellsAddedToCart` و`upcartSubscribeCartLoaded` لجميع السكربتات الجديدة.
</Note>

***

<div id="result">
  ## النتيجة
</div>

بمجرد إضافة هذا التخصيص:

* يرى العملاء عروض البيع الإضافي فقط إذا لم يقبلوا أحدها بالفعل
* تُخفى وحدة البيع الإضافي بمجرد إضافة عرض بيع إضافي
* تظهر الوحدة مرة أخرى تلقائيًا إذا أُزيل عنصر البيع الإضافي
* لا حاجة لتهيئة معرّفات المنتجات أو الوسوم

يحافظ هذا على تجربة بيع إضافي مركّزة وغير مزدحمة وسهلة التفاعل للعملاء.

***

<div id="still-need-help">
  ## هل ما زلت بحاجة إلى مساعدة؟
</div>

للتخصيصات الأكثر تقدمًا، نوصي بالعمل مع **Shopify Expert**. يمكنهم المساعدة في HTML وCSS وJavaScript داخل درج السلة الخاص بك.

[اطّلع على Shopify Experts](https://www.shopify.com/partners/directory)