كيف يعمل نمط واجهة API
أين تضيف سكربتاتك
<script>...</script> واحفظ. للاختبار، افتح وحدة تحكم أدوات المطورين في متصفحك (F12) وابحث عن أي رسائل console.log.
ملاحظة حول دوال رد النداء القديمة مقابل الحديثة
تستخدم جميع الأمثلة أدناه واجهة API الحديثة. ستستمر السكربتات الحالية التي تستخدم الأسلوب القديم في العمل.
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 لمزيد من خطوات استكشاف الأخطاء.