أداة محول العملات: دليل التضمين والاستخدام
وفّر لزوار موقعك تحويلات عملات سريعة وتفاعلية. تدعم أداة محول العملات أكثر من 150 عملة عالمية والمعادن الثمينة والبيتكوين مع حساب فوري ثنائي الاتجاه وقوائم عملات قابلة للبحث مع الأعلام دون أي حاجة للصيانة.
1. البدء السريع: تضمين الأداة في موقعك
تضمين محول العملات سهل ومباشر. أضف كود السكربت وعنصر HTML المخصص داخل وسم <body> في المكان الذي ترغب بظهور الأداة فيه:
<!-- تحميل محرك الأداة -->
<script src="https://www.forexinvestors.com/widgets/currency-converter/widget.js"></script>
<!-- عنصر محول العملات -->
<currency-converter
lang="ar"
from="USD"
to="EUR"
amount="1"
theme="default"
border-radius="5">
</currency-converter>
نصيحة للأداء: يكفي استيراد ملف السكربت widget.js مرة واحدة فقط في الصفحة، حتى عند تضمين عدة محولات عملات في نفس الصفحة.
2. خصائص التخصيص والإعدادات
يمكنك التحكم في المظهر الأولي وزوج العملات الافتراضي عبر تعديل الخصائص على عنصر <currency-converter>:
| الخاصية | النوع | القيمة الافتراضية | الوصف |
|---|---|---|---|
lang |
نص (String) | en |
تحدد لغة الواجهة لأسماء العملات المترجمة وتنسيق التاريخ (en، ar، fr، es، ru). |
from |
نص (String) | EUR |
رمز عملة المصدر الافتراضية (معيار ISO 4217 بالإضافة إلى BTC، XAU، XAG، XPT؛ مثل USD، EUR، GBP، SAR). |
to |
نص (String) | USD |
رمز العملة الهدف الافتراضية (معيار ISO 4217 أو BTC؛ مثل EUR، USD، JPY، AED، EGP). |
amount |
رقم (Number) | 1 |
المبلغ الرقمي الافتراضي المراد تحويله عند التحميل (أي رقم موجب، مثل 1، 100، 50.5). |
theme |
نص (String) | default |
اختيار نمط الألوان: default، blue، green، yellow، red، ocean، purple، teal، dark، rose، أو custom. |
border-radius |
رقم (Number) | 5 |
درجة استدارة الحواف بالبكسل لإطار الأداة (عدد صحيح من 0 إلى 20 في أداة الإعداد، ويدعم حتى 50، مثل 0، 5، 12). |
size |
نص (String) | normal |
التحكم في ارتفاع وحجم خط الحقول والقوائم المنسدلة (normal للحجم العادي أو large للحجم الكبير). |
native-dropdown |
نص (String) | off |
اضبطها على on لاستخدام قوائم المتصفح التقليدية <select> بدلاً من القائمة المنسدلة المزودة بالبحث والأعلام. |
خصائص ألوان المظهر المخصص (Custom Theme)
عند ضبط theme="custom"، يمكنك تخصيص ألوان الأداة باستخدام أكواد الألوان السداسية المكونة من 6 خانات (بدون علامة #):
| الخاصية | القيمة الافتراضية | الوصف |
|---|---|---|
bg-color |
F6F6F6 |
لون خلفية حاوية الأداة. |
border-color |
BCBCBC |
لون الإطار الخارجي للأداة والحقول والقوائم المنسدلة. |
text-color |
222222 |
لون النص الأساسي للحقول وأسماء العملات والتاريخ. |
input-bg-color |
FFFFFF |
لون خلفية حقول المبالغ وقوائم العملات المنسدلة. |
bg-color-button |
535353 |
لون خلفية زر تبديل العملات (⇆) وأزرار الشريط السفلي. |
button-border-color |
2E2E2E |
لون إطار زر التبديل وأزرار الشريط السفلي. |
button-hover-color |
8A8A8A |
لون التمييز عند تمرير المؤشر فوق زر التبديل وأزرار الشريط السفلي. |
3. مميزات الأداة للمستخدم النهائي
يستفيد زوار موقعك عند استخدام المحول من المزايا المدمجة التالية:
- حساب فوري ثنائي الاتجاه: اكتب المبلغ في الحقل العلوي (المصدر) أو السفلي (الهدف) لحساب التحويل في كلا الاتجاهين فورًا داخل المتصفح دون طلبات شبكة إضافية.
- تبديل العملات بضغطة واحدة (
⇆): اعكس عملتي المصدر والهدف فورًا باستخدام زر التبديل المجاور لحقل الإدخال العلوي. - أكثر من 150 عملة ومعادن ثمينة وعملات رقمية: التحويل بين العملات العالمية والبيتكوين (
BTC) والمعادن الثمينة (XAU،XAG،XPT)، مقسمة إلى العملات المفضلة (USD،EUR،GBP،CAD) وجميع العملات. - قوائم منسدلة قابلة للبحث مع الأعلام: ابحث بسرعة عن أي عملة بالرمز أو الاسم مع أيقونات أعلام الدول وتصفية بحث فورية.
- عزل التنسيقات عبر Shadow DOM وتباين تلقائي: تعمل الأداة داخل بيئة Shadow DOM معزولة حتى لا تتعارض تنسيقات موقعك مع المحول، مع ضبط تلقائي للون نص الأزرار لضمان الوضوح.
- توقيت آخر تحديث لأسعار الصرف: تعرض الأداة تاريخ ووقت آخر مزامنة للأسعار في الشريط السفلي إلى جانب روابط سريعة لمصدر البيانات (
FI) وصفحة إعداد الأداة (+).
4. تعليمات التضمين في أنظمة إدارة المحتوى (CMS)
ووردبريس (WordPress / Gutenberg & Elementor)
- أضف مكوّن HTML مخصص (Custom HTML) في المقال أو الصفحة أو الشريط الجانبي.
- الصق كود السكربت وعنصر
<currency-converter>الناتج أعلاه. - احفظ الصفحة أو انشرها.
Webflow وWix وShopify
- أدرج عنصر تضمين كود مخصص (Embed / Custom Code) في تخطيط الصفحة.
- الصق كود تضمين الأداة.
- تأكد من أن عرض الحاوية الأب لا يقل عن
240pxإلى340pxللحصول على أفضل مظهر.
5. الأسئلة الشائعة (FAQ)
كم مرة يتم تحديث أسعار الصرف في الأداة؟
يتم تحديث أسعار الصرف كل 5 دقائق من مصادر بيانات سوق العملات الحية. يوضح الطابع الزمني أسفل الأداة وقت آخر تحديث للأسعار.
هل يؤدي تغيير العملات أو كتابة المبالغ إلى إرسال طلبات إضافية للخادم؟
لا. تجلب الأداة جدول الأسعار الكامل مرة واحدة عند التحميل وتنفذ جميع عمليات التحويل وتغيير العملات والتبديل فورًا داخل المتصفح.
هل يمكنني وضع أكثر من محول عملات في نفس الصفحة؟
نعم. يمكنك إضافة عدة عناصر <currency-converter> بأزواج عملات أو مبالغ أو قوالب ألوان مختلفة، مع تضمين وسم <script> مرة واحدة فقط في الصفحة.
هل الأداة متوافقة مع الهواتف المحمولة؟
نعم. تستخدم الأداة تخطيطًا رأسيًا متجاوبًا يتكيف تلقائيًا مع عرض الحاوية الأب ليلائم شاشات الهواتف والأجهزة اللوحية والأشرطة الجانبية.
هل تتطلب الأداة مفتاح API أو خاصية data-endpoint؟
لا يلزم أي مفتاح API، ولا تحتاج إلى إضافة خاصية data-endpoint؛ حيث تستنتج الأداة رابط البيانات تلقائيًا من مسار ملف widget.js.