> ## 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.

# وحدة الإعلانات

> تعرّف على كيفية تخصيص شريط الإعلانات في درج Upcart، بما في ذلك الارتفاع والموضع ومؤقت العد التنازلي وتنسيق النص والألوان.

<div id="height">
  # الارتفاع
</div>

يتحكم إعداد الارتفاع في مدى سماكة شريط الإعلانات. يوفر ثلاثة خيارات: **Slim** و**Normal** و**Thick**. يُبقي Slim الدرج أكثر إحكامًا، مما يفسح المجال لمحتوى السلة — وهو مفيد بشكل خاص على الشاشات الأصغر. يقع Normal بين الاثنين. أما Thick فيوفر تأكيدًا بصريًا أكبر، مما يساعد رسالتك على لفت انتباه العملاء.

<div id="position">
  # الموضع
</div>

استخدم إعداد الموضع لاختيار ما إذا كان شريط الإعلانات يظهر **قبل المنتجات** أو **بعد المنتجات** داخل الدرج الجانبي لسلة التسوق.

* **قبل المنتجات** يضع الشريط في أعلى جسم السلة، مباشرة تحت الترويسة.
* **بعد المنتجات** يضعه في أسفل جسم السلة، فوق التذييل مباشرة — تحت وحدتي الملاحظات وعروض البيع الإضافي إذا كانتا موضوعتين هناك أيضًا.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/announcements-bar-position-comparison.png?fit=max&auto=format&n=uxKAdY-e0h16xa48&q=85&s=10c93ddb37a1b682ee6ffd8c22ca0365" alt="سلّتا Upcart تقارنان شريط الإعلانات في موضعه فوق المنتجات وتحتها" width="1845" height="1380" data-path="images/upcart/announcements-bar-position-comparison.png" />

<div id="timer-duration">
  ## مدة المؤقت
</div>

إذا كنت تريد أن ينتهي الإعلان بعد وقت محدد، فاضبط عدًا تنازليًا في حقل **Timer duration**. يقبل الحقل الصيغة `MM:SS` — أي `05:00` لخمس دقائق، و`00:30` لثلاثين ثانية. يجب أن تكون الثواني بين `00` و`59`؛ يرفض الحقل أي قيمة أعلى.

لا يعمل العد التنازلي إلا إذا كان نص إعلانك يحتوي على متغير المؤقت. بمجرد انتهائه، يُزال شريط الإعلانات بالكامل تلقائيًا من السلة.

<Note>
  مؤقت العد التنازلي المدمج يعتمد على الجلسة ويعد تنازليًا من عدد محدد من الدقائق. لا يدعم العدّ التنازلي المتكرر أو اليومي الذي يُعاد ضبطه في وقت محدد (على سبيل المثال، العد التنازلي حتى الساعة 2:00 ظهرًا كل يوم). هذه الوظيفة غير متاحة حاليًا في Upcart.
</Note>

<div id="announcement-text">
  ## نص الإعلان
</div>

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

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/announcements-color-picker-open-styling.png?fit=max&auto=format&n=uxKAdY-e0h16xa48&q=85&s=b5cf7eef319675ff522346102babd4ff" alt="منتقي الألوان مفتوح لتنسيق النص في محرر نص الإعلان" width="990" height="758" data-path="images/upcart/announcements-color-picker-open-styling.png" />

<Note>
  لا يدعم حقل نص الإعلان الروابط التشعبية — لا يوجد زر رابط أو URL في شريط أدوات التنسيق، وتُحذف وسوم `<a>` الملصقة أو روابط Markdown عند الحفظ. لجعل الإعلان قابلًا للنقر أو لتضمين رابط، استخدم وحدة **Custom HTML** بدلًا من ذلك (انظر أدناه).
</Note>

<div id="adding-a-link-or-url-to-the-announcement">
  ### إضافة رابط أو URL إلى الإعلان
</div>

نظرًا لأن حقل نص الإعلان المدمج لا يعرض الروابط التشعبية، يمكنك إما استبدال شريط الإعلانات أو استكماله عبر إدراج رابط باستخدام Custom HTML:

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

2. اضبط **HTML Location** على **Above announcements/rewards** (ليظهر فوق شريط الإعلانات) أو **Below header/announcements/rewards** (ليظهر تحته مباشرة).

3. الصق مقطعًا يحتوي على رابطك، على سبيل المثال:

   ```html theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
   <div style="text-align: center; padding: 8px;">
     <a href="https://yourstore.com/sale" style="color: #ffffff; text-decoration: underline;">
       Shop the sale →
     </a>
   </div>
   ```

4. انقر على **Save**، ثم اختبر في سلتك المنشورة.

لمزيد من المعلومات حول مواقع Custom HTML والتنسيق، راجع [Custom HTML](/ar/upcart/custom_html) و[Custom CSS](/ar/upcart/custom_css). لا يكتب فريق دعم Upcart كودًا مخصصًا ولا يصحح أخطاءه — تواصل مع أحد خبراء Shopify إذا كنت بحاجة إلى مساعدة في بنائه.

إذا كنت تستخدم ميزة العد التنازلي، فأدخل متغير المؤقت مباشرة في رسالتك. استخدم `{{timer}}` لسلال V2 أو `{TIMER}` لسلال V1.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/announcements-announcement-text-field-timer.png?fit=max&auto=format&n=uxKAdY-e0h16xa48&q=85&s=4ba5a19c53cfefb36cc37c1d560c6b3e" alt="حقل نص الإعلان مع إضافة متغير العد التنازلي للمؤقت إلى الرسالة" width="1094" height="462" data-path="images/upcart/announcements-announcement-text-field-timer.png" />

<div id="important">
  ## هام
</div>

احرص على كتابة متغير المؤقت يدويًا (`{{timer}}` لـ V2 و`{TIMER}` لـ V1) بدلًا من نسخه ولصقه. هذا يتجنب مشاكل التنسيق المخفية التي قد تمنع المؤقت من الظهور بشكل صحيح في سلتك المنشورة.

<div id="font-size">
  # حجم الخط
</div>

يمكنك التحكم في حجم نص الإعلان باستخدام شريط التمرير، بخيارات تتراوح من 10px إلى 24px. يساعد ذلك على ضمان سهولة القراءة عبر تجربتَي الجوال وسطح المكتب.

<div id="colors">
  # الألوان
</div>

يتيح لك Background Color تحديد لون التعبئة العام لشريط الإعلانات. أما Border Color فيتيح لك ضبط الخطوط الأفقية فوق اللافتة وتحتها للحصول على مظهر حاوية منسّقة.

<div id="advanced-timer-configuration">
  # إعدادات المؤقت المتقدمة
</div>

للحصول على وظائف إضافية، يمكن استخدام JavaScript لتخصيص مؤقت العد التنازلي. أضف السكربت الخاص بك في قسم **"Scripts (Before Load)"** بدلًا من وحدة Custom HTML. هذا متطلب متعلق بتوقيت التحميل وليس قيدًا أمنيًا — ينفّذ Custom HTML السكربتات فعلًا، لكنها تعمل متأخرة جدًا بحيث لا يمكنها الارتباط بحدث تحميل السلة بشكل موثوق. يشغّل قسم "Scripts (Before Load)" الكود الخاص بك قبل تحميل السلة، لذا تعمل دوال رد النداء مثل `upcartSubscribeCartLoaded` بشكل صحيح. مثال على الكود:

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
<script>
  window.upcartSubscribeCartLoaded(function(event) {
    // Your countdown timer code here
    // event.cart contains the cart object with .items[], .total, .currency
  });
</script>
```

ملاحظة قديمة: لا يزال window\.upcartOnCartLoaded يعمل ولكنه مهمل ويسجّل تحذيرًا في وحدة التحكم. استخدم upcartSubscribeCartLoaded لجميع السكربتات الجديدة.

احرص على اختبار موضع الكود وصياغته بعناية. قد تظل بعض قيود المنصة تؤثر في كيفية معالجة السكربتات.