توثيق تطبيق Shopify
كل ما تحتاجه لإعداد وتخصيص تحويل العملات في متجر Shopify الخاص بك
جدول المحتويات
1 التثبيت
تثبيت من متجر تطبيقات Shopify
- قم بزيارة صفحة تطبيق Currency.Wiki على متجر تطبيقات Shopify
- انقر على 'إضافة تطبيق' ووافق على التثبيت
- سيفتح التطبيق ويقودك خلال معالج الإعداد
- أكمل معالج الإعداد لبدء تحويل الأسعار
نصيحة: يستغرق معالج الإعداد حوالي دقيقتين ويرشدك خلال كل خطوة.
2 معالج الإعداد
يساعدك معالج الإعداد على ضبط التطبيق بشكل صحيح. يرشدك خلال تحديث تنسيق العملة وتفعيل تضمين التطبيق.
الخطوة 1: الترحيب
راجع ما يتضمنه الإعداد وانقر على 'لنبدأ'.
الخطوة 2: تحديث تنسيق العملة
انتقل إلى Shopify Admin → الإعدادات → عام → إعدادات المتجر الافتراضية. ابحث عن عملتك وانقر على قائمة النقاط الثلاث → 'تغيير تنسيق العملة'. حدث حقول HTML بإضافة فئة التغليف الخاصة بنا:
HTML مع العملة:
<span class="cwiki">${{amount}} USD</span>
HTML بدون العملة:
<span class="cwiki">${{amount}}</span>
هام: فئة التغليف cwiki ضرورية. تخبر تطبيقنا بالعناصر التي تمثل الأسعار في صفحتك، حتى نقوم بتحويل الأسعار فقط وليس أرقام الهواتف أو أرقام الطلبات.
الخطوة 3: تفعيل تضمين التطبيق
فعّل التطبيق في قسم تضمينات التطبيقات في قالبك:
- انتقل إلى المتجر الإلكتروني → القوالب → تخصيص
- ابحث عن 'تضمينات التطبيقات' في الشريط الجانبي الأيسر
- ابحث عن 'Currency.Wiki App' وفعلها
- انقر على حفظ في محرر القالب
الخطوة 4: التحقق من الإعداد
انقر على 'فحص متجري' للتحقق من اكتمال الإعداد. سيتحقق المعالج من وجود فئة التغليف cwiki وتضمين التطبيق. إذا تم بنجاح، أنت جاهز للانطلاق!
3 أنماط الأداة
اختر من بين 6 أنماط للأداة لتناسب تصميم متجرك. يمكن تخصيص كل نمط بألوان علامتك التجارية.
قائمة منسدلة بسيطة
تكامل في رأس الصفحة مع قائمة منسدلة بسيطة. الأفضل لوضعها في أعلى يمين الرأس.
زر عائم
زر عائم متوافق مع الجوال مع لوحة قابلة للتوسيع. رائع للمتاجر التي تركز على الجوال. يتموضع في الزوايا.
لوحة جانبية منزلقة
لوحة منزلقة بارتفاع كامل مع وظيفة البحث. مثالية للمتاجر التي تقدم العديد من العملات.
نافذة منبثقة
تراكب مركزي بتخطيط شبكي. يجعل اختيار العملة تجربة مركزة.
مبدل علامات تبويب مدمج
علامات تبويب أفقية للعملات الشائعة. تبديل سريع دون فتح قوائم.
شارة الزاوية
أيقونة زاوية بسيطة تتوسع عند النقر. الأقل إزعاجًا للتصاميم النظيفة.
نصيحة: استخدم صفحة إعدادات الأداة في لوحة تحكم التطبيق لمعاينة جميع الأنماط مع ألوان متجرك.
4 لوحة تحكم المدير
توفر لوحة تحكم المدير تحكمًا كاملاً في كيفية عمل تحويل العملات في متجرك.
الصفحة الرئيسية للوحة التحكم
تبديل الأداة تشغيل/إيقاف، عرض إحصائيات التحويل، ومعاينة مباشرة للأداة.
إعدادات الأداة
اختر نمط الأداة، الموضع، الألوان، الحجم، نصف القطر، وخيارات عرض الأعلام.
إدارة العملات
تفعيل/تعطيل العملات، إعادة ترتيب القائمة، ضبط سلوك الكشف التلقائي، وتعيين تفضيلات أسعار الصرف.
التحليلات
عرض مخططات التحويل، العملات الأكثر استخدامًا، وفهم توزيع عملائك الدوليين.
السمة والمظهر
اختر وضع السمة (تلقائي، فاتح، داكن، مخصص)، عيّن الألوان، فعّل تأثيرات الزجاج، واضبط سلوك الوضع الداكن.
رسالة الدفع
فعّل رسالة في صفحات السلة/الدفع لإبلاغ العملاء بعملة الدفع.
5 إعدادات متقدمة
توفر الإعدادات المتقدمة لمستخدمي Pro تحكمًا أكبر في تنسيق الأسعار وسلوك التحويل.
تنسيق الأسعار (Pro)
- الأرقام العشرية - تحكم بعدد المنازل العشرية المعروضة (0-6).
- تنسيق الرقم - اختر نمط التنسيق (تلقائي، أمريكي، أوروبي، هندي، مسافة•نقطة، مسافة•فاصلة).
- موضع الرمز - ضع رمز العملة قبل أو بعد المبلغ، أو تلقائي حسب العملة.
- التقريب - قياسي، دائمًا للأعلى، دائمًا للأسفل، أو بدون تقريب. خيار التقريب لأقرب .99.
تكامل مع السمة (Pro)
قم بتضمين الأداة أو إشعار السلة يدويًا في أي مكان في القالب باستخدام هذه الشيفرات:
تضمين الأداة (أضف إلى header.liquid أو أي قسم):
<div class="cwiki-widget"></div>
تضمين إشعار السلة (أضف إلى cart.liquid):
<div class="cwiki-banner"></div>
خيارات المطور (Pro)
- تجاوزات الأنماط - أضف CSS مخصص لتعديل مظهر الأداة.
- مستمعو النقر - إعادة تحويل الأسعار عند النقر على عناصر معينة (مثل اختيار المقاس أو خيارات المنتج).
- عناصر أسعار إضافية - استهداف عناصر أسعار إضافية بجانب فئة cwiki الافتراضية.
- أنماط URL - إعادة الفحص عن الأسعار عندما يحتوي الرابط على نصوص معينة (لمحتوى AJAX أو التمرير اللانهائي).
- تأخير التحويل - انتظر قبل تحويل الأسعار (للمحتوى الذي يتم تحميله بعد جاهزية الصفحة).
تنبيه: هذه الخيارات للمستخدمين المتقدمين. اختبر على قالب تجريبي قبل النشر.
6 استكشاف الأخطاء
الأسعار لا تتحول؟
تأكد من وجود فئة cwiki في إعدادات تنسيق العملة. انتقل إلى الإعدادات → عام → إعدادات المتجر الافتراضية وتحقق من تنسيق HTML. تحقق أيضًا من تفعيل تضمين التطبيق في مخصص القالب.
الأداة لا تظهر؟
تحقق من تفعيل تضمين التطبيق في قسم تضمينات التطبيقات في القالب. جرب فتح مخصص القالب، وابحث عن تضمينات التطبيقات، وتأكد من تفعيل Currency.Wiki. احفظ وحدث متجرك.
الأسعار تومض عند التحميل؟
تم تصميم تطبيقنا للتحميل بدون وميض. إذا لاحظت وميضًا، تحقق من وجود إضافات تخزين مؤقت قد تتداخل. تأكد أيضًا من تحميل تضمين التطبيق في رأس القالب.
يتم اكتشاف عملة خاطئة؟
الكشف الجغرافي يعتمد على عنوان IP للزائر. قد تؤثر الشبكات الافتراضية أو شبكات الشركات على الكشف. يمكن للزوار دائمًا اختيار عملتهم يدويًا. يمكنك أيضًا تعيين عملة افتراضية احتياطية في الإعدادات.
الأداة لا تتوافق مع القالب؟
استخدم إعدادات السمة والمظهر لتخصيص الألوان، أو فعّل الوضع التلقائي لاكتشاف ألوان القالب تلقائيًا. يمكنك أيضًا استخدام CSS مخصص في الإعدادات المتقدمة لتخصيص أدق.
تحتاج مساعدة؟
فريق الدعم لدينا جاهز للمساعدة في أي استفسار حول الإعداد أو التكوين.
