نظرة عامة
- أين تُضاف نصوص Upcart API البرمجية؟
- هل يجب أن أكون مطوّرًا لاستخدام واجهة Upcart API؟
- هل يمكن لواجهة Upcart API التكامل مع تطبيقات خارجية أخرى؟
- كيف أختبر ما إذا كانت تغييرات API تعمل؟
- ماذا أفعل إذا لم يعمل نص API برمجي؟
- كيف أتراجع عن التغييرات إذا أضفت نصًا برمجيًا يعطّل شيئًا ما؟
أين تُضاف نصوص Upcart API البرمجية؟
كيف أستخدم Custom HTML في Upcart؟
- انتقل إلى Upcart → Settings → Custom HTML
- استخدم نصوص API البرمجية لتعديل سلوك السلة، مثل توقيت الفتح أو عروض البيع الإضافي (upsell)
- عدّل عناصر خارج Upcart، مثل إخفاء أزرار صفحة المنتج
ملاحظة قديمة: ما زالت دوال الاستدعاء
window.upcartOnCartLoaded تعمل لكنها مهملة وتسجّل تحذيرات في وحدة التحكم. استخدم upcartSubscribeCartLoaded لجميع النصوص البرمجية الجديدة. لاحظ أن event.cart لا يحتوي على خاصية item_count — استخدم event.cart.items.reduce((total, item) => total + item.quantity, 0) لحساب إجمالي عدد العناصر.هل يجب أن أكون مطوّرًا لاستخدام واجهة Upcart API؟
هل يمكن لواجهة Upcart API التكامل مع تطبيقات خارجية أخرى؟
ملاحظة قديمة: ما زالت دوال الاستدعاء
window.upcartOnAddToCart تعمل لكنها مهملة وتسجّل تحذيرات في وحدة التحكم. استخدم upcartSubscribeAddedToCart لجميع النصوص البرمجية الجديدة. لاحظ أن خصائص الحدث موجودة في event.item (مع variantId وquantityAdded)، ولا تُمرَّر كمعاملات منفصلة.كيف أختبر ما إذا كانت تغييرات API تعمل؟
- حدّث متجرك وأضف عنصرًا إلى السلة.
- امسح ذاكرة التخزين المؤقت وحاول مرة أخرى لرؤية أحدث التغييرات.
-
أضف رسالة اختبار: أدرج
console.log("The script works!");قبل</script>للتحقق من تشغيل نصك البرمجي. -
تحقق من وحدة تحكم المتصفح:
- افتح Dev Tools (
F12أوCtrl + Shift + Jعلى Windows، وCmd + Option + Jعلى Mac). - انتقل إلى علامة تبويب Console وابحث عن “The script works!”
- إذا رأيت الرسالة، فنصك البرمجي يعمل! وإذا لم ترها، فقد لا يكون النص البرمجي يُنفَّذ بشكل صحيح.
- افتح Dev Tools (
- اختبر إجراءات مختلفة (مثل إزالة عنصر) للتأكد من السلوك المتوقع.
ماذا أفعل إذا لم يعمل نص API برمجي؟
- تحقق من الأخطاء الإملائية – حتى الأخطاء الصغيرة قد تعطّل النص البرمجي. ابحث عن أحرف مفقودة أو صيغة غير صحيحة.
- تحقق من موضع النص البرمجي – تأكد من أن النص البرمجي في القسم الصحيح ضمن Upcart → Settings → Custom HTML. لدى Upcart عشرة أقسام للنصوص البرمجية (تسع نقاط حقن HTML بالإضافة إلى قسم Scripts-before-load واحد) — راجع هذه الأقسام هنا.
- تحقق من وحدة تحكم المتصفح – اتبع الخطوات أعلاه للبحث عن الأخطاء.
- جرّب نصًا برمجيًا مختلفًا – جرّب نص Upcart API برمجيًا جاهزًا آخر لمعرفة ما إذا كانت المشكلة في الكود الخاص بك.
- ما زلت عالقًا؟ – إذا كنت تعدّل قالب Shopify أو تدمج تطبيقات خارجية، فيمكن لخبير Shopify من دليل شركاء Shopify مساعدتك.
كيف أتراجع عن التغييرات إذا أضفت نصًا برمجيًا يعطّل شيئًا ما؟
- انتقل إلى إعدادات Custom HTML في Upcart حيث أُضيف النص البرمجي.
-
أزل النص البرمجي أو عطّله مؤقتًا بإضافة
//في بداية كل سطر (هذا يحوّله إلى تعليق ويمنع تشغيله). - احفظ التغييرات وحدّث متجرك للتحقق من حل المشكلة.
🚧 هل تبحث عن تخصيصات متقدمة؟ هل تحتاج إلى تخصيصات على مستوى المتجر أو تكاملات مع تطبيقات خارجية؟ قد تحتاج إلى مطوّر لإضافة واجهة Upcart API إلى قالب Shopify الخاص بك. فكّر في توظيف خبير Shopify عبر دليل شركاء Shopify وشارك معه وثائق API الخاصة بنا للمساعدة