توثيق إضافة ووردبريس
تعلم كيفية تثبيت، إعداد وتخصيص أداة تحويل العملات الخاصة بك
جدول المحتويات
1 التثبيت
الطريقة 1: التثبيت من ووردبريس (موصى به)
- انتقل إلى لوحة تحكم ووردبريس الخاصة بك
- اذهب إلى الإضافات > أضف جديد
- ابحث عن "Currency.Wiki Converter"
- انقر على "تثبيت الآن" ثم "تفعيل"
الطريقة 2: التثبيت اليدوي
- قم بتنزيل الإضافة من WordPress.org
- اذهب إلى الإضافات > أضف جديد > رفع إضافة
- اختر ملف ZIP الذي تم تنزيله وانقر على "تثبيت الآن"
- فعّل الإضافة بعد التثبيت
2 استخدام كتلة Gutenberg
أسهل طريقة لإضافة محول العملات إلى صفحاتك:
- حرر أي صفحة أو منشور باستخدام محرر Gutenberg
- انقر على زر + لإضافة كتلة جديدة
- ابحث عن "Currency Converter" أو تصفح فئة الأدوات
- قم بضبط الأداة باستخدام لوحة الإعدادات الجانبية على اليمين
نصيحة: يمكنك مشاهدة معاينة مباشرة للأداة أثناء تغيير الإعدادات في محرر الكتلة.
3 استخدام الرمز القصير
يمكنك أيضًا إضافة الأداة باستخدام الرموز القصيرة في المنشورات أو الصفحات أو قوالب القالب:
الاستخدام الأساسي
[currencywiki_converter]
السمات المتاحة
| السمة | الافتراضي | الوصف |
|---|---|---|
| style | compact | نمط الأداة (مضغوط، أفقي، رأسي، مخطط صغير، إلخ.) |
| theme | auto | سمة الألوان (تلقائي، فاتح، داكن) |
| from | USD | عملة المصدر الافتراضية (رمز ISO من 3 أحرف) |
| to | EUR | عملة الهدف الافتراضية (رمز ISO من 3 أحرف) |
| amount | 1 | المبلغ الافتراضي للتحويل |
| accent | #3b82f6 | لون التمييز (رمز hex مثل #3b82f6) |
| embed | script | طريقة التضمين (سكريبت أو iframe) |
| width | auto | العرض المخصص بالبكسل |
| height | auto | الارتفاع المخصص بالبكسل |
أمثلة
أداة السمة الداكنة:
[currencywiki_converter theme="dark"]
عملات ومبلغ مخصص:
[currencywiki_converter from="GBP" to="JPY" amount="100"]
نمط المخطط الصغير:
[currencywiki_converter style="mini-chart"]
استخدام تضمين iframe (لتوافق القالب):
[currencywiki_converter embed="iframe"]
4 أنماط الأداة
اختر من بين عدة أنماط للأداة لتناسب تصميم موقعك:
mini
محول صغير، مثالي للمساحات الضيقة (250×140 بكسل)
square
محول مربع بنسبة 1:1 (250×250 بكسل)
compact
محول صغير وموفر للمساحة (280×200 بكسل)
inline
تخطيط أفقي، رائع للرؤوس (450×120 بكسل)
tall
تخطيط رأسي مع تسميات تقليدية (220×360 بكسل)
mini-chart
محول مدمج مع مخطط تاريخي (250×260 بكسل)
multi-expandable
تحويل لعدة عملات، يمكن للمستخدمين الإضافة/الإزالة (300×400 بكسل)
multi-fixed
قائمة ثابتة لتحويلات عملات متعددة (280×360 بكسل)
rates-compact
قائمة أسعار صرف بسيطة (260×260 بكسل)
rates-viewer
عارض أسعار كامل مع مخطط (350×420 بكسل)
rates-viewer-compact
عارض أسعار مدمج مع مخطط (300×340 بكسل)
نصيحة: استخدم منشئ الأداة في لوحة تحكم ووردبريس لمعاينة جميع الأنماط قبل إضافتها إلى موقعك.
5 خيارات الإعداد
تتيح لك صفحة إعدادات الإضافة في لوحة تحكم ووردبريس ضبط الخيارات الافتراضية:
خيارات السمة
- auto - تتوافق تلقائيًا مع نظام ألوان موقعك
- light - استخدم دائمًا خلفية فاتحة
- dark - استخدم دائمًا خلفية داكنة
طريقة التضمين
- script - افتراضي. يتم تحميل الأداة ضمن الصفحة بكامل الوظائف. تظهر قوائم العملات فوق المحتوى المحيط.
- iframe - خيار احتياطي. يتم تحميل الأداة في iframe معزول. استخدمه إذا واجهت تعارضات في الأنماط مع القالب.
ملاحظة: إذا ظهرت قوائم العملات خلف عناصر أخرى أو تم اقتطاعها، جرب التبديل إلى وضع تضمين iframe.
6 استكشاف الأخطاء
الأداة لا تظهر؟
تأكد من تفعيل الإضافة. تحقق إذا كان يجب مسح أي إضافات تخزين مؤقت. جرب استخدام طريقة تضمين iframe إذا لم يعمل تضمين السكريبت.
الأداة تظهر بشكل غير صحيح أو يوجد تعارض في الأنماط؟
قد تتعارض بعض قوالب ووردبريس مع سكريبت الأداة. انتقل إلى وضع تضمين iframe بإضافة embed="iframe" إلى الرمز القصير.
قائمة العملات مخفية أو مقطوعة؟
قد يحدث ذلك عندما تحتوي عناصر الحاوية على overflow:hidden. جرب استخدام وضع تضمين iframe، أو عدل CSS الخاص بقالبك للسماح بالظهور الكامل للأداة.
الأداة تعرض أسعار قديمة؟
تُحدث أسعار الصرف تلقائيًا. إذا كنت تستخدم إضافة تخزين مؤقت، تأكد من استثناء سكريبتات الأداة من التخزين المؤقت أو امسح ذاكرة التخزين بعد إجراء تغييرات.
تحتاج مساعدة؟
لا يمكنك العثور على ما تبحث عنه؟ فريق الدعم لدينا هنا لمساعدتك.
