Skip to main content

كيف يعمل نمط واجهة API

تتبع معظم سكربتات Upcart API النمط البسيط نفسه: الاستماع لحدث سلة ← التحقق من شرط ← تنفيذ إجراء على سبيل المثال: “عند تحميل السلة ← تحقق مما إذا كانت فارغة ← أخفِ الزر الثابت.” 💡 جديد على واجهات API؟ ابدأ بـ ما هي واجهة API؟ قبل الخوض في الأمثلة أدناه.

أين تضيف سكربتاتك

توضع جميع السكربتات أدناه في: Cart Editor → Settings → Custom HTML → Scripts (before load) لفّ كل مقطع بوسوم <script>...</script> واحفظ. للاختبار، افتح وحدة تحكم أدوات المطورين في متصفحك (F12) وابحث عن أي رسائل console.log.

ملاحظة حول دوال رد النداء القديمة مقابل الحديثة

لدى Upcart طريقتان للاستماع إلى أحداث السلة: تستخدم جميع الأمثلة أدناه واجهة API الحديثة. ستستمر السكربتات الحالية التي تستخدم الأسلوب القديم في العمل.

المثال 1: إخفاء زر السلة الثابت عندما تكون السلة فارغة

كيف يعمل: يُطلق upcartSubscribeCartLoaded في كل مرة يتم فيها تحميل السلة. تتلقى دالة رد النداء event يحتوي على كائن cart يتضمن مصفوفة items. نجمع quantity لكل عنصر لتحديد ما إذا كانت السلة فارغة. ⚠️ هام:event.cart لا يحتوي على خاصية item_count. يجب عليك حساب الإجمالي عبر المرور على event.cart.items.

المثال 2: تسجيل رسالة عند إضافة عنصر إلى السلة

الخصائص المتاحة في event.item:

المثال 3: التكامل مع تطبيق تحليلات من طرف ثالث (مثل TripleWhale)

ملاحظة: كل تطبيق طرف ثالث مختلف. راجع فريق دعم تطبيقك لمعرفة تنسيق الحدث الصحيح.

المثال 4: فتح السلة تلقائيًا بعد إضافة منتج

ملاحظة: إذا كان خيار “Open cart drawer on add to cart” مفعّلًا بالفعل في Cart Editor → Settings → Cart settings، فلن تحتاج إلى هذا السكربت.

مرجع سريع: دوال الاشتراك (واجهة API الحديثة)


دوال الإجراءات المباشرة

للاطلاع على وثائق API الكاملة، راجع وثائق Upcart Public API.

استكشاف الأخطاء وإصلاحها

  • السكربت لا يعمل؟ تحقق مرة أخرى من الموضع: يجب أن يكون في Scripts (before load)، وليس بعد التحميل.
  • لم يُعثر على العنصر؟ تأكد من أن المحدد (مثل #upCartStickyButton) يطابق معرّف العنصر الفعلي في سلتك.
  • حدث خلل ما؟ علّق سكربتك بإضافة // في بداية كل سطر، واحفظ، وحدّث الصفحة.
  • لا تزال عالقًا؟ راجع الأسئلة الشائعة حول API لمزيد من خطوات استكشاف الأخطاء.