استكشاف امتداد سمة Shopify وإصلاحه

مشاكل وحلول شائعة عند استخدام بلوك سمة نموذج الاتصال SupportRetriever في Shopify.

المشاكل الشائعة

المشكلة 1: بلوك النموذج لا يظهر في محرر السمات

الأعراض:

• لا أجد "نموذج الاتصال" تحت التطبيقات عند إضافة البلوكات
• SupportRetriever لا يظهر في قائمة التطبيقات
• محرر السمات لا يعرض خيار البلوك

أسباب محتملة:

1. التطبيق غير مثبت على متجر Shopify
2. السمة لا تدعم بلوكات التطبيقات (سمات قديمة جداً)
3. مشكلة ذاكرة التخزين المؤقت للمتصفح
4. نوع قسم غير صحيح

الحلول:

الحل 1: التحقق من تثبيت التطبيق

1. انتقل إلى لوحة إدارة Shopify → التطبيقات
2. تحقق إن كان SupportRetriever في التطبيقات المثبتة
3. إن لم يكن، ثبّت التطبيق من متجر تطبيقات Shopify
4. حدّث محرر السمات

الحل 2: التحقق من توافق السمة

1. تأكد من استخدامك سمة Shopify 2.0 (معظم السمات من 2021+)
2. جرّب إضافة البلوك إلى أنواع أقسام مختلفة:
   • قوالب الصفحات
   • قوالب المنتجات
   • أقسام مخصصة
3. إن كانت سمتك قديمة جداً، فكّر بتحديثها لسمة أحدث

الحل 3: مسح ذاكرة التخزين المؤقت للمتصفح

1. امسح ذاكرة التخزين المؤقت والكوكيز
2. سجّل الخروج من لوحة إدارة Shopify
3. سجّل الدخول مرة أخرى وجرّب
4. جرّب متصفحاً آخر أو وضع التصفح الخاص

الحل 4: استخدام رابط الاختراق

1. سجّل الدخول إلى SupportRetriever
2. انتقل إلى الإعدادات → تكامل Shopify
3. انقر زر "فتح محرر السمات"
4. هذا ينتقل تلقائياً إلى الموقع الصحيح

---

المشكلة 2: النموذج يظهر فارغاً أو "النموذج غير موجود"

الأعراض:

• البلوك مضاف لكن يظهر مساحة بيضاء
• تظهر رسالة خطأ "النموذج غير موجود"
• خطأ 404 داخل الإطار (iframe)

أسباب محتملة:

1. رابط النموذج غير مُعد
2. رابط النموذج غير صحيح (خطأ مطبعي)
3. تم حذف النموذج في SupportRetriever
4. RLS (أمان مستوى الصف) يمنع الوصول

الحلول:

الحل 1: إضافة رابط النموذج

1. انقر على بلوك نموذج الاتصال في محرر السمات
2. انظر إلى لوحة الإعدادات على اليمين
3. الصق رابط النموذج في حقل "رابط النموذج"
4. احصل على الرابط من: SupportRetriever → إدارة النماذج

الحل 2: التحقق من رابط النموذج

1. انسخ رابط النموذج من SupportRetriever
2. الصقه في تبويب متصفح جديد
3. تحقق من تحميل النموذج بشكل صحيح
4. إن لم يُحمّل، الرابط غير صحيح
5. التنسيق المتوقع: https://supportretriever.com/form/[id]

الحل 3: التحقق من وجود النموذج

1. سجّل الدخول إلى SupportRetriever
2. انتقل إلى إدارة النماذج
3. تحقق من ظهور نموذجك في القائمة
4. إن لم يظهر، ربما حذفته
5. أنشئ نموذجاً جديداً وحدّث الرابط

الحل 4: مشاكل RLS (نادرة)

إذا كان النموذج يُحمّل مباشرة لكن ليس في Shopify:

1. تواصل مع دعم SupportRetriever
2. قدّم معرّف النموذج
3. الدعم يمكنه التحقق من صلاحيات RLS

---

المشكلة 3: النموذج مقطوع (قصير جداً)

الأعراض:

• الجزء العلوي فقط من النموذج ظاهر
• زر الإرسال غير ظاهر
• الحاجة للتمرير داخل مساحة صغيرة

السبب: إعداد ارتفاع النموذج منخفض جداً

الحل:

1. انقر على بلوك نموذج الاتصال في محرر السمات
2. ابحث عن شريط "ارتفاع النموذج" في الإعدادات
3. اسحب لزيادة الارتفاع (يُوصى بـ 1000px)
4. احفظ وتحقق من المعاينة

الارتفاعات الموصى بها:

• الحد الأدنى: 600px
• مريح: 800px
• نموذج كامل: 1000px

---

المشكلة 4: لا يمكن إرسال رسائل اختبار

الأعراض:

• زر الإرسال يبدو غير نشط
• الرسائل لا تُرسل
• لا تأكيد بعد النقر على إرسال

أسباب محتملة:

• مشكلة اتصال الشبكة
• إعداد النموذج غير صحيح
• تحديد المعدل (إرسالات اختبار كثيرة)

الحل:

1. تحقق من اتصالك بالإنترنت
2. تحقق من صحة رابط النموذج في إعدادات البلوك
3. انتظر دقائق قليلة إن أرسلت رسائل اختبار متعددة (تحديد المعدل)
4. تحقق من لوحة تحكم SupportRetriever للتأكد من أن النموذج نشط

لاختبار النموذج:

1. افتح رابط النموذج مباشرة في تبويب جديد
2. أرسل رسالة اختبار
3. تحقق من ظهورها في صندوق الوارد SupportRetriever

---

المشكلة 5: إرسالات النموذج لا تعمل على الموقع المباشر

الأعراض:

• النموذج يظهر بشكل صحيح
• زر الإرسال مفعّل
• لكن لا يحدث شيء عند النقر على إرسال
• أو تظهر رسالة خطأ

أسباب محتملة:

1. Turnstile (حماية البوتات) لا يُحمّل
2. تجاوز حد البريد
3. المتصفح يمنع الإرسال
4. بريد المستلم غير مُتحقق

الحلول:

الحل 1: انتظار Turnstile

النموذج يتضمن حماية من البوتات تحتاج لحظة للتحميل:

1. انتظر 3–5 ثوانٍ بعد تحميل الصفحة
2. ابحث عن علامة صح صغيرة أو مؤشر
3. ثم أرسل النموذج

الحل 2: التحقق من حدود البريد

1. سجّل الدخول إلى SupportRetriever
2. انتقل إلى الإعدادات → الحساب
3. تحقق من استخدامك للبريد
4. إن وصلت للحد، حدّث الخطة أو انتظر إعادة التعيين

الحل 3: تعطيل إضافات المتصفح

بعض إضافات المتصفح تمنع إرسال النماذج:

1. جرّب في وضع التصفح الخاص/الخاص
2. عطّل مانعات الإعلانات مؤقتاً
3. تحقق من وحدة تحكم المتصفح للأخطاء (F12)

الحل 4: التحقق من بريد المستلم

1. انتقل إلى SupportRetriever → الإعدادات
2. تحقق من حقل "بريد المستلم"
3. تأكد من التحقق من البريد (تحقق من صندوق الوارد لرسالة التحقق)
4. أعد إرسال التحقق إن لزم

---

المشكلة 6: تذييل "Powered by SupportRetriever" لا يظهر

الأعراض:

• النموذج يعمل بشكل صحيح لكن لا يعرض التذييل "Powered by SupportRetriever"

هذا طبيعي:

تذييل العلامة التجارية SupportRetriever يُخفى تلقائياً عند تضمين النموذج في متاجر Shopify. يكتشف النموذج عرضه في إطار iframe لمتجر Shopify ويخفى العلامة للامتثال لسياسات العلامة التجارية لتطبيقات Shopify.

أين تظهر العلامة:

• ✅ عند الوصول إلى النموذج مباشرة (ليس في iframe)
• ✅ عند التضمين في مواقع غير Shopify
• ❌ عند التضمين في متاجر Shopify (تُخفى تلقائياً عبر كشف المُحيل)

كيف يعمل: يتحقق النموذج إن كان داخل iframe وإن كانت الصفحة الأم على نطاق .myshopify.com أو shopify.com. إن كان كذلك، تُخفى العلامة.

لا حاجة لإجراء — هذا السلوك متوقع.

---

المشكلة 7: النموذج يظهر لكن لديه مشاكل تنسيق

الأعراض:

• ألوان النموذج لا تتطابق
• التخطيط يبدو مكسوراً
• النص غير مقروء
• الشعار لا يظهر

أسباب محتملة:

1. النموذج غير مخصص في SupportRetriever
2. مشاكل تباين الألوان
3. رابط الشعار غير صحيح
4. توافق المتصفح

الحلول:

الحل 1: التخصيص في SupportRetriever

مظهر النموذج يُتحكم به في SupportRetriever، وليس في Shopify:

1. سجّل الدخول إلى SupportRetriever
2. انتقل إلى إدارة النماذج
3. مرّر إلى "مظهر النموذج"
4. اضبط لون الخلفية، لون الزر، لون النص
5. أضف رابط الشعار إن رغبت
6. احفظ التغييرات

الحل 2: التحقق من تباين الألوان

تأكد من قراءة النص:

• نص غامق على خلفية فاتحة
• أو نص فاتح على خلفية غامقة
• اختبر بأدوات إمكانية الوصول

الحل 3: إصلاح الشعار

إن لم يظهر الشعار:

1. تحقق من صحة رابط الشعار
2. تأكد من أن صورة الشعار متاحة للعموم
3. الحجم الموصى به: 200px × 60px
4. استخدم تنسيق PNG أو JPG

---

المشكلة 8: النموذج يعمل على سطح المكتب لكن ليس على الجوال

الأعراض:

• النموذج يعرض ويعمل على سطح المكتب
• مكسور أو غير ظاهر على الأجهزة المحمولة
• مشاكل تخطيط على شاشات صغيرة

أسباب محتملة:

1. قسم سمة Shopify غير متجاوب
2. الارتفاع صغير جداً على الجوال
3. مشاكل جوال خاصة بالسمة

الحلول:

الحل 1: التحقق من إعدادات السمة

1. تأكد من ضبط القسم الذي يحتوي النموذج على عرض كامل على الجوال
2. تحقق من معاينة الجوال في محرر السمات
3. تحقق من عدم وجود إعدادات جوال متضاربة

الحل 2: ضبط الارتفاع للجوال

النموذج متجاوب، لكن تأكد من ارتفاع كافٍ:

1. على الجوال، 600–800px عادةً مناسبان
2. اختبر في معاينة الجوال لمحرر السمات
3. اضبط عند الحاجة

الحل 3: الاختبار على أجهزة حقيقية

1. انشر التغييرات
2. زر الموقع المباشر على جهاز جوال فعلي
3. اختبر الإرسال
4. تحقق من أجهزة متعددة إن أمكن

---

المشكلة 9: النموذج يُحمّل ببطء

الأعراض:

• مساحة فارغة حيث يجب أن يكون النموذج
• النموذج يظهر بعد ثوانٍ
• العملاء قد لا ينتظرون تحميله

أسباب محتملة:

1. تأخر الشبكة
2. صفحة ثقيلة بعناصر كثيرة
3. سمة Shopify بطيئة
4. إضافات المتصفح

الحلول:

الحل 1: تحسين الصفحة

1. أزل التطبيقات/السكربتات غير الضرورية من الصفحة
2. حسّن الصور على الصفحة
3. استخدم سمة أسرع إن أمكن

الحل 2: إضافة مؤشر تحميل

فكّر بإضافة رسالة تحميل فوق بلوك النموذج في محتوى الصفحة:

• "جاري تحميل نموذج الاتصال..."
• هذا يحدد توقعات العملاء

الحل 3: اختبار سرعة الشبكة

1. اختبر على اتصالات إنترنت مختلفة
2. تحقق إن كانت المشكلة ثابتة
3. إن كانت بطيئة للجميع، تواصل مع دعم SupportRetriever

---

المشكلة 10: لا يمكن تعديل أو إزالة بلوك النموذج

الأعراض:

• البلوك يظهر في محرر السمات لكن لا يمكن تحديده
• لا يمكن حذف البلوك
• الإعدادات لا تظهر

الحلول:

الحل 1: تحديث محرر السمات

1. احفظ التغييرات
2. اخرج من محرر السمات
3. ارجع إلى صفحة السمات
4. انقر تخصيص مرة أخرى

الحل 2: التعديل من مستوى القسم

1. انقر القسم الذي يحتوي النموذج
2. استخدم عناصر تحكم القسم لإدارة البلوكات
3. احذف أو أعد الترتيب من عرض القسم

الحل 3: مسح ذاكرة التخزين المؤقت للمتصفح

1. امسح الذاكرة المؤقتة والكوكيز
2. أعد تشغيل المتصفح
3. جرّب مرة أخرى

---

المشكلة 11: رابط النموذج يتغير بشكل غير متوقع

الأعراض:

• النموذج كان يعمل، والآن يظهر "النموذج غير موجود"
• الرابط في الإعدادات يبدو مختلفاً عما هو متوقع

السبب: تم حذف النموذج وإعادة إنشائه، فتُنشأ رابط جديد

الحل:

الوقاية:

• لا تحذف النماذج دون داعٍ
• حدّث الإعدادات بدلاً من إعادة الإنشاء

الإصلاح:

1. سجّل الدخول إلى SupportRetriever
2. احصل على رابط النموذج الحالي من إدارة النماذج
3. حدّث الرابط في جميع بلوكات سمة Shopify
4. احفظ وانشر

---

قائمة فحص تشخيصية

استخدم هذه القائمة لاستكشاف المشاكل بشكل منهجي:

• رابط النموذج مُلصق في إعدادات البلوك
• رابط النموذج صحيح (اختبر في المتصفح مباشرة)
• النموذج موجود في حساب SupportRetriever
• ارتفاع النموذج مضبوط على 800px على الأقل
• بريد المستلم مُتحقق في SupportRetriever
• لم يتم تجاوز حد استخدام البريد
• تم الاختبار في متصفح مختلف
• تم الاختبار مع تعطيل إضافات المتصفح
• تغييرات محرر السمات محفوظة ومنشورة
• تم الاختبار على الموقع المباشر (وليس محرر السمات فقط)

الحصول على مساعدة إضافية

إن جربت الحلول أعلاه وما زالت لديك مشاكل:

التحقق من حالة SupportRetriever

1. زر [صفحة حالة SupportRetriever]
2. تحقق من أي انقطاعات في الخدمة
3. راجع الحوادث الأخيرة

التواصل مع الدعم

قدّم هذه المعلومات عند التواصل مع الدعم:

• وصف المشكلة: ما يحدث مقابل ما يجب أن يحدث
• رابط النموذج: رابط النموذج المحدد
• رابط متجر Shopify: عنوان .myshopify.com لمتجرك
• الخطوات المتخذة: استكشاف الأخطاء الذي قمت به
• المتصفح/الجهاز: ما تستخدمه للاختبار
• لقطات الشاشة: أظهر المشكلة (إن كانت بصرية)

دعم Shopify

لمشاكل خاصة بـ Shopify (السمة، محرر السمات):

1. تواصل مع دعم Shopify
2. اذكر أنك تستخدم امتداد تطبيق سمة
3. قدّم اسم التطبيق: SupportRetriever

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

• وثائق SupportRetriever
• وثائق امتداد تطبيق سمة Shopify
• منتديات مجتمع Shopify

أفضل ممارسات الوقاية

تجنب المشاكل الشائعة باتباع هذه الممارسات:

1. لا تحذف النماذج: حدّث الإعدادات بدلاً من ذلك
2. اختبر قبل النشر: استخدم معاينة محرر السمات
3. احتفظ بالروابط في متناول اليد: احفظ رابط النموذج في مكان آمن
4. راقب حدود البريد: تحقق من الاستخدام بانتظام
5. حدّث تدريجياً: اختبر التغييرات قبل البث المباشر
6. وثّق الإعداد: احتفظ بملاحظات عن تكوينك
7. اختبار دوري: أرسل رسائل اختبار بشكل دوري

مواضيع ذات صلة

• تثبيت بلوك سمة نموذج الاتصال
• الحصول على رابط النموذج
• تخصيص مظهر بلوك السمة
• النموذج لا يستقبل الإرسالات
• مشاكل تسليم البريد