Skip to main content
⚠️ إشعار مهم ينطبق مقتطف القالب أدناه على كلا إصداري وحدات سلة Upcart — فهو يجعل Shopify تعرض أزرار الدفع المُعجَّل على الصفحة، وهو ما يحتاجه Upcart بغض النظر عن إصدار الوحدة. المحدد .additional-checkout-buttons أدناه هو فئة Shopify الخاصة على حاوية الدفع المُعجَّل، وليس فئة وحدة Upcart، لذا فهو نفسه في أي من إصداري السلة.

نظرة عامة

في بعض الأحيان تكون أزرار الدفع السريع غير قابلة للنقر أو لا تظهر داخل Upcart. هذه مشكلة شائعة سببها كيفية تحكم Shopify في عرض أزرار الدفع السريع داخل القوالب. يشرح هذا الدليل سبب حدوث ذلك وما يمكنك فعله لإصلاحه.

الإعداد المطلوب للوحدة الجديدة

⚠️ مهم: تنطبق هذه الخطوات على وحدة Express Payments الجديدة في Upcart، وليس الإصدار القديم. لكي تعمل أزرار الدفع السريع بشكل صحيح في Upcart، يجب عليك إضافة مقتطف صغير من الكود إلى قالب Shopify الخاص بك. بدون هذا المقتطف، لن تحمّل Shopify أزرار الدفع بشكل صحيح داخل درج السلة. قبل إجراء هذه التغييرات، تحقق من تفعيل طرق الدفع ذات الصلة (مثل Shop Pay وPayPal وApple Pay وGoogle Pay) في إعدادات حساب لوحة إدارة Shopify. بدون تفعيل هذه الطرق، لن تكون الأزرار مرئية. بالإضافة إلى ذلك، تأكد من وضع المقتطف مباشرةً أسفل وسم <body> الافتتاحي في ملف قالبك (مثل <body class="...">). إذا وُضع بشكل غير صحيح، مثل وضعه بعد وسم </body> الختامي، فقد لا تعمل أزرار الدفع السريع بشكل صحيح.

كيفية الإصلاح

  1. انتقل إلى لوحة إدارة Shopify.
  2. انتقل إلى Online Store > Themes > Edit Code.
  3. افتح layout/theme.liquid، وابحث عن سطر <body>، وأضف المقتطف أدناه في سطر جديد مباشرةً أسفله. يجب أن يوضع هناك — وليس في cart-drawer.liquid أو في مكان آخر — لأن الأزرار يجب أن توجد في كل صفحة يمكن أن تُفتح فيها السلة.
  1. احفظ تغييراتك وحدّث واجهة متجرك.
  2. أعد فتح درج السلة للتحقق من أن أزرار الدفع السريع (مثل Shop Pay أو PayPal أو Apple Pay أو Google Pay) تظهر الآن وقابلة للنقر.
راجع دليل وحدة Express Payments للحصول على تعليمات الإعداد الكاملة.

لماذا يحدث هذا

تُدار أزرار الدفع السريع بالكامل بواسطة Shopify، وليس Upcart. هذا يعني:
  • لا يعرض Upcart أزراره الخاصة. بل يستنسخ أزرار الدفع المُعجَّل الخاصة بـ Shopify من الصفحة إلى درج السلة، ولهذا يجب أن تكون موجودة على الصفحة في المقام الأول — وهذا ما يضمنه مقتطف القالب أعلاه.
  • سيظهر Apple Pay فقط على أجهزة Apple التي تم إعداد Apple Pay عليها.
  • لا يتحكم Upcart في أزرار الدفع السريع التي تظهر، إذ تتولى Shopify المحتوى والوظائف.
🎨 ملاحظة:
تعمل الأزرار في Upcart كحاويات مرئية، بينما تتحكم Shopify في عرضها وسلوكها. لا يستطيع Upcart تعديل مظهرها أو وظيفتها.

المشاكل الشائعة وحلولها

1. الأزرار غير معروضة على الصفحة

هذا هو السبب الأكثر شيوعًا. يستنسخ Upcart أزرار Shopify من الصفحة، لذا إذا لم تعرضها الصفحة فلا يوجد شيء لاستنساخه وتُظهر السلة مساحة فارغة. ما يجب فعله:
  • أضف مقتطف القالب من قسم كيفية الإصلاح أعلاه، مباشرةً أسفل سطر <body> في layout/theme.liquid.
لا تزل أزرار الدفع السريع الخاصة بقالبك “لتجنب التعارض”. يعتمد Upcart على وجودها. إزالتها من القالب، أو إيقافها في إعدادات القالب، تزيل المصدر الذي يستنسخ منه Upcart — ما يجعل هذه المشكلة أسوأ، لا أفضل.

3. ‏CSS يحجب الأزرار

تخفي بعض القوالب أزرار الدفع السريع افتراضيًا باستخدام CSS. على سبيل المثال:
ما يجب فعله:
  • راجع CSS الخاص بقالبك.
  • اطلب من مطور قالبك التأكد من عدم وجود قواعد CSS تخفي الأزرار أو تعطلها في درج Upcart.

4. الإعدادات القديمة تتداخل

إذا كنت قد استخدمت الإصدار الأقدم من وحدة Express Payments، فقد تتعارض الإعدادات المحفوظة مع الإعداد الجديد. ما يجب فعله:
  • افتح وحدة Express Payments القديمة (إذا كانت لا تزال مرئية).
  • ألغِ تحديد أي خيارات سابقة واحفظ.
  • اختبر مرة أخرى باستخدام الوحدة الجديدة.

ما زلت تواجه مشاكل؟

تعطيل Shadow DOM في Upcart

في بعض الحالات، قد تفشل أزرار الدفع السريع في التحميل أو التحديث لأن Shadow DOM مفعّل في Upcart. ما هو Shadow DOM؟
يعزل Shadow DOM ‏Upcart عن بقية كود متجرك لتحسين الاستقرار. ومع ذلك، في حالات نادرة، يمكن أن يمنع هذا الفصل أزرار الدفع السريع في Shopify من التحديث بشكل صحيح.
كيفية تعطيل Shadow DOM:
  1. انتقل إلى Upcart > Cart Editor > Settings > Cart settings، ثم وسّع Advanced Settings.
  2. ألغِ تحديد Render Cart in Shadow DOM.
  3. احفظ واختبر مرة أخرى.
⚠️ مهم:
اختبر سلتك دائمًا بعد إيقاف Shadow DOM، لأنه قد يؤثر على كيفية تفاعل التطبيقات الأخرى أو عناصر القالب مع Upcart.
💡 ملاحظة: قد يؤدي تعطيل Shadow DOM إلى إصلاح هذه المشكلة ولكنه قد يسبب تعارضات CSS مع قالبك. راجع مستند إعداد Shadow DOM للاطلاع على المقايضة الكاملة.

بحاجة إلى مزيد من المساعدة؟

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

المراجع

  • مساعدة Shopify – الدفع المُعجَّل (Accelerated Checkouts)
  • وثائق مطوري Shopify – أزرار الدفع السريع