انتقل إلى المحتوى
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويقالعودة للمتجر
القائمة

تمايز / معلومات تهمك

لماذا لا يظهر تطبيق Shopify في القالب بعد تثبيته؟

دليل عملي لمعرفة الفرق بين App Block وApp Embed في Shopify وتفعيل التطبيق داخل القالب واختباره دون تعديل Liquid يدويًا.

تثبيت تطبيق في Shopify لا يعني أن مكوّنه سيظهر تلقائيًا في واجهة المتجر. بعض التطبيقات توفر App Block يضيفه صاحب المتجر إلى قسم محدد، وبعضها يستخدم App Embed يعمل على مستوى القالب، وقد يجمع التطبيق النوعين. إذا بقي المكوّن غير مفعّل في محرر القالب فلن يفيد وجود التطبيق في قائمة التطبيقات.

توضح وثائق Shopify عن Theme App Extensions أن الامتداد يضم بلوكات وأصولًا ومقاطع يمكن إدارتها من محرر القالب دون تعديل ملفات Liquid يدويًا. وتشرح وثائق إعداد الامتدادات أن App Block لا يضاف افتراضيًا بعد التثبيت، وأن App Embed يكون غير مفعّل افتراضيًا ويحتاج إلى تفعيل من إعدادات القالب.

افهم الفرق بين App Block وApp Embed

App Block مناسب لمكوّن مرئي يحتاج إلى موضع داخل صفحة، مثل التقييمات أو شارة المنتج أو جدول المقاسات. يضيفه التاجر إلى قسم يدعم نوع البلوك الخاص بالتطبيق، ويمكن نقله داخل بنية الصفحة. إذا كان القسم القديم ثابتًا ولا يدعم بلوكات التطبيقات فلن يظهر الخيار حتى لو كان التطبيق يعمل.

أما App Embed فيناسب العناصر التي تعمل على مستوى الصفحة أو تظهر فوقها، مثل نافذة محادثة أو شريط عائم أو بعض وسوم التحليل. يُفعل عادة من Theme settings ثم App embeds. لا تبحث عن App Embed داخل قائمة بلوكات صفحة المنتج، ولا تضف كودًا يدويًا قبل التأكد من نوع الامتداد الذي يوفره التطبيق.

يمكن تنفيذ هذه المراجعة أثناء إنشاء متجر Shopify حتى لا تُنشر نسخة القالب قبل تفعيل التطبيقات الأساسية.

افحص القالب المنشور ونسخة المعاينة

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

راجع القالب بعد تحديثه أو استبداله. Theme App Extension لا يكتب عادة تعديلات دائمة داخل Liquid، لكن موضع البلوك وإعداداته مرتبطان بتكوين القالب. عند نقل التصميم إلى نسخة جديدة قد تحتاج إلى إعادة إضافة البلوك أو مراجعة إعدادات App Embed.

ثلاث خطوات لتفعيل تطبيق Shopify داخل القالب

  1. حدد نوع الامتداد: اقرأ تعليمات التطبيق أو افتح محرر القالب وابحث في Apps عن App Block، ثم راجع App embeds لمعرفة ما إذا كان التطبيق يوفر مكوّنًا عامًا.
  2. أضف المكوّن إلى المكان الصحيح: ضع App Block في قسم متوافق داخل قالب الصفحة المقصودة، أو فعّل App Embed واحفظ الإعداد. لا تستخدم قالب منتج واحدًا ثم تتوقع ظهوره في كل القوالب.
  3. اختبر الواجهة والوظيفة: افتح المعاينة على الهاتف وسطح المكتب، وتحقق من تحميل المكوّن ومن وظيفته الفعلية، ثم راقب الشبكة والأخطاء إذا ظهر الشكل من دون بيانات.

راجع كذلك اختبار توافق تطبيقات Shopify مع Checkout Extensibility، لأن مكوّنات واجهة المتجر لا تعني أن التطبيق متوافق تلقائيًا مع صفحة الدفع.

مثال افتراضي

مثال افتراضي: يثبت متجر تطبيق تقييمات، لكنه لا يرى النجوم في صفحة المنتج. يكتشف الفريق أن التطبيق وفر App Block، بينما قسم المنتج في القالب المخصص لا يدعم بلوكات النوع @app. يختبر الفريق البلوك داخل قسم متوافق في نسخة من القالب، ثم يحدّث القسم المخصص لدعم البلوك بدل لصق كود التطبيق في ملفات متعددة.

وفي الحالة نفسها يظهر زر عائم للتقييمات فقط بعد تفعيل App Embed. يوثق الفريق كلا الإعدادين حتى لا يختفي أحدهما عند تبديل القالب. المثال للتوضيح ولا يمثل تطبيقًا أو متجرًا بعينه.

قائمة مراجعة قبل نشر القالب

  • [ ] اسم القالب الجاري تعديله معروف.
  • [ ] نوع الامتداد App Block أو App Embed محدد.
  • [ ] القسم يدعم بلوكات التطبيقات عند الحاجة.
  • [ ] البلوك مضاف إلى قالب الصفحة الصحيح.
  • [ ] App Embed مفعّل ومحفوظ إن كان مطلوبًا.
  • [ ] تمت معاينة الهاتف وسطح المكتب.
  • [ ] التطبيق يعرض بيانات صحيحة ولا يكرر سكربتًا قديمًا.
  • [ ] توجد ملاحظة توضح ما يجب إعادة فحصه عند تغيير القالب.

ظهور التطبيق في لوحة Shopify يثبت تثبيته فقط. اكتمال الربط يحتاج إلى موضع صحيح، وحفظ إعدادات القالب، واختبار الوظيفة على النسخة التي سيشاهدها العميل.

المراجع والمصادر

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

نسمعك

اكتب سؤالك أو ملاحظتك. يُنشر التعليق بعد المراجعة، ويبقى البريد خاصًا.