> ## 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 وCSS مخصصين لإظهار أو إخفاء شريط المكافآت بناءً على موقع العميل.

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

إذا كنت تقدم المكافآت في مناطق معينة فقط، يمكنك إخفاء شريط المكافآت عن العملاء في دول محددة باستخدام مزيج من JavaScript وCSS. يساعد ذلك في الحفاظ على سلة نظيفة وذات صلة للمتسوقين بناءً على المكان الذي يتصفحون منه.

**ملاحظة:**

حتى عند إخفائه، يستمر منطق المكافآت في العمل في الخلفية. على سبيل المثال، قد تُضاف هدية مجانية إلى السلة إذا تحققت الشروط، حتى لو لم يكن الشريط مرئيًا.

***

<div id="step-1-find-your-target-country-codes">
  ## الخطوة 1: العثور على رموز الدول المستهدفة
</div>

ستحتاج إلى تحديد الدول التي يجب أن ترى شريط المكافآت. للعثور على الرموز، راجع قائمة Shopify لـ **رموز الدول ISO المكونة من حرفين**.

**أمثلة:**

* `US` → الولايات المتحدة
* `CA` → كندا
* `MX` → المكسيك

***

<div id="step-2-add-custom-html">
  ## الخطوة 2: إضافة HTML مخصص
</div>

1. انتقل إلى **Upcart > Cart Editor > Settings > Custom HTML**
2. الصق الكود التالي في **كلا** الموقعين التاليين:

   * Above announcements/rewards
   * On empty cart

استبدل `"US"` برمز (رموز) الدولة التي تريدها.

```
<script>  
  function hideRewards() {  
    let rewardsBar = window.upcartDocumentOrShadowRoot.querySelector(".upcart-rewards");  
    let country = window.Shopify.country;  
  
    if (country.includes("US")) {  
      rewardsBar.classList.remove("hide");  
      return;  
    }  
  
    rewardsBar.classList.add("hide");  
  }  
  
  window.upcartSubscribeCartOpened(() => setTimeout(hideRewards, 300));  
  window.upcartSubscribeCartLoaded(hideRewards);  
</script>
```

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

<div id="alternative-code-for-rewards-v20-version">
  ## كود بديل لإصدار Rewards V2.0
</div>

إذا قمت بترقية مكافآتك إلى إصدار V2، فالكود مختلف قليلاً فقط حيث يُستبدل محدد المكافآت بالمحدد الجديد `.upcart-public-rewards`. استخدم الكود أدناه إذا قمت بترقية وحدة المكافآت المتدرجة الخاصة بك

```
<script>  
  function hideRewards() {  
    let rewardsBar = window.upcartDocumentOrShadowRoot.querySelector(".upcart-public-rewards");  
    let country = window.Shopify.country;  
  
    if (country.includes("US")) {  
      rewardsBar.classList.remove("hide");  
      return;  
    }  
  
    rewardsBar.classList.add("hide");  
  }  
  
  window.upcartSubscribeCartOpened(() => setTimeout(hideRewards, 300));  
  window.upcartSubscribeCartLoaded(hideRewards);  
</script>
```

لدعم عدة دول، عدّل الشرط على النحو التالي:

```
if (["US", "CA", "GB"].includes(country)) {
```

***

<div id="step-3-add-custom-css">
  ## الخطوة 3: إضافة CSS مخصص
</div>

1. انتقل إلى **Upcart > Cart Editor > Settings > Custom CSS**
2. الصق هذا الكود للتحكم في الظهور:

```
.hide {  
  display: none;   
}
```

***

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

لن يرى العملاء من الدول المستبعدة شريط المكافآت في سلتهم، على الرغم من أن منطق المكافآت لا يزال يعمل في الخلفية.

استخدم هذه الطريقة إذا:

* كنت تقدم المكافآت في أسواق مختارة فقط
* كنت تريد تجنب عرض عروض ترويجية غير قابلة للتطبيق
* كنت بحاجة إلى حل مؤقت قصير الأمد قبل إعداد منطق قائم على المناطق بشكل صحيح

***

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

للمنطق الإقليمي المتقدم أو دعم JavaScript، نوصي بالعمل مع **Shopify Expert**. لا يساعد دعم Upcart في كتابة الأكواد المخصصة أو استكشاف أخطائها وإصلاحها.

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