مستندات ویجت
راهنمای کامل درج و سفارشیسازی ویجت مبدل ارز Currency.Wiki در وبسایت شما.
فهرست مطالب
1 شروع به کار
افزودن ویجت مبدل ارز به وبسایت شما آسان است. این مراحل ساده را دنبال کنید:
- به صفحه سازنده ویجت بروید و ظاهر ویجت خود را سفارشی کنید
- استایل، ارزها و تم مورد نظر خود را انتخاب کنید
- کد درج تولیدشده (اسکریپت یا Iframe) را کپی کنید
- کد را در HTML وبسایت خود در محل دلخواه جایگذاری کنید
نکته: از پیشتنظیمات شروع سریع در سازنده ویجت برای شروع سریع با یک ویجت از پیش پیکربندیشده استفاده کنید.
2 روشهای درج
درج اسکریپت (توصیهشده)
روش درج اسکریپت، ویجت را مستقیماً در صفحه شما قرار میدهد. منوهای کشویی ارز برای انتخاب آسان در جلوی محتوای اطراف نمایش داده میشوند.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- منوهای کشویی خارج از جعبه ویجت نمایش داده میشوند
- مناسب برای انتخاب تعاملی ارز
- ادغام یکپارچه با صفحه شما
درج Iframe
روش درج Iframe یک جعبه ایزوله برای ویجت ایجاد میکند. این روش امن است و در محیطهایی با سیاستهای محتوای سخت کار میکند.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- کاملاً ایزوله از استایلهای صفحه شما
- سازگار با سیاستهای امنیتی سختگیرانه
- پیادهسازی ساده و امن
توجه: برای تعامل کامل (نمایش منوهای کشویی روی محتوا) از درج اسکریپت استفاده کنید. اگر به ایزوله بودن یا محدودیتهای CSP نیاز دارید، از درج Iframe استفاده کنید.
3 استایلهای ویجت
از میان ۱۱ استایل مختلف ویجت برای هماهنگی با طراحی وبسایت خود انتخاب کنید. هر استایل برای کاربردها و اندازههای مختلف بهینه شده است.
mini
250x140px
مبدل تکخطی فشرده. مناسب برای هدر یا فضاهای محدود.
square
250x250px
ویجت با نسبت ۱:۱ و دکمه تعویض. عالی برای نوار کناری.
compact
300x180px
مبدل کمجا با تمام امکانات ضروری.
inline
480x56px
چیدمان افقی. ایدهآل برای درج در محتوا یا ناوبری.
tall
200x280px
چیدمان عمودی نوار کناری با برچسبهای کلاسیک.
mini-chart
250x260px
مبدل فشرده با نمودار کوچک تاریخچه نرخ.
multi-expandable
300x320px
مبدل چند ارزی. کاربران میتوانند ارز اضافه/حذف کنند.
multi-fixed
300x300px
لیست ثابت نرخ ارز. مناسب برای نمایش نرخهای خاص.
rates-compact
250x320px
لیست فشرده نرخ ارز با زمان آخرین بهروزرسانی.
rates-viewer
300x500px
نمای کامل نمودار با اطلاعات دقیق نرخ.
rates-viewer-compact
300x400px
نسخه فشرده نمایشگر نرخ با نمودار.
4 پارامترهای URL
ویجت خود را با استفاده از پارامترهای URL سفارشی کنید. این پارامترها با هر دو روش درج اسکریپت و Iframe کار میکنند.
| پارامتر | پیشفرض | توضیح |
|---|---|---|
| style | compact | استایل ویجت (mini، square، compact، inline، tall، mini-chart، multi-expandable، multi-fixed، rates-compact، rates-viewer، rates-viewer-compact) |
| theme | light | تم رنگی (روشن، تیره یا خودکار) |
| from | USD | کد ارز مبدا (مثلاً USD، EUR، GBP) |
| to | EUR | کد ارز مقصد (مثلاً EUR، USD، JPY) |
| amount | 1000 | مقدار پیشفرض برای تبدیل |
| accent | #2563eb | رنگ تاکید به صورت hex (بدون #) |
| lang | en | کد زبان ویجت (مثلاً en، es، fr، de) |
| flags | 1 | نمایش پرچم کشورها (۱=نمایش، ۰=عدم نمایش) |
| display | iso | فرمت نمایش ارز (iso=USD، symbol=$) |
| lock | 0 | قفل کردن ارزها (۱=قفل، ۰=آزاد) |
| currencies | EUR,GBP,JPY | لیست ارزها به صورت کاما جداشده برای ویجت چند ارزی |
| dropdown | all | ارزهای منوی کشویی (all، top10، top20 یا لیست کاما جداشده) |
| branding | 1 | نمایش برند (۱=نمایش، ۰=عدم نمایش) |
| brandinglink | 1 | قابل کلیک بودن برند (۱=لینک، ۰=فقط متن) |
| format | auto | فرمت عدد (auto، us، eu، french، indian) |
| decimals | 2 | تعداد اعشار (۰ تا ۶) |
| chart | 0 | فعالسازی نمودار (۱=فعال، ۰=غیرفعال) |
| chartperiod | 7d | دوره زمانی نمودار (۷d، ۱۴d، ۳۰d، ۹۰d) |
نمونهها
مبدل فشرده با تم تیره:
?style=compact&theme=dark&from=USD&to=EUR
نرخ ارز چند ارزی:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
مبدل کوچک با نمودار ۳۰ روزه:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
نمایش نماد ارز به جای کد:
?style=compact&display=symbol&from=USD&to=EUR
ارزهای قفلشده با مقدار سفارشی:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 گزینههای سفارشیسازی
گزینههای تم
- light - پسزمینه روشن با متن تیره
- dark - پسزمینه تیره با متن روشن
- auto - به طور خودکار با ترجیح سیستم کاربر هماهنگ میشود
فرمت نمایش ارز
- iso - نمایش کدهای ISO مانند USD، EUR، GBP
- symbol - نمایش نماد ارز مانند $، €، £
فرمتهای عددی
- auto - تشخیص خودکار تنظیمات مرورگر بازدیدکننده
- us - فرمت آمریکایی: 1,234.56
- eu - فرمت اروپایی: 1.234,56
- french - فرمت فرانسوی: 1 234,56
- indian - فرمت هندی: 1,23,456.78
گزینههای ارز منوی کشویی
- all - تمام ۱۷۰+ ارز پشتیبانیشده
- top10 - ۱۰ ارز محبوب برتر
- top20 - ۲۰ ارز برتر بر اساس حجم معاملات
- USD,EUR,GBP,... - لیست سفارشی ارزهای خاص
نکته: از سازنده ویجت برای پیکربندی بصری همه این گزینهها و تولید خودکار کد درج استفاده کنید.
6 رفع اشکال
ویجت نمایش داده نمیشود
مطمئن شوید کد درج به درستی در HTML قرار گرفته است. برای درج اسکریپت، اطمینان حاصل کنید div کانتینر با شناسه صحیح وجود دارد. کنسول مرورگر را برای خطاهای جاوااسکریپت بررسی کنید.
منوی کشویی کار نمیکند
در صورت استفاده از درج Iframe، منوهای کشویی در داخل ناحیه ویجت اسکرول میشوند. برای عملکرد کامل منوهای کشویی با پوشش، از روش درج اسکریپت استفاده کنید.
تداخل استایل
اگر CSS وبسایت شما بر ظاهر ویجت تأثیر میگذارد، روش درج Iframe را امتحان کنید که استایلهای ویجت را از صفحه شما ایزوله میکند.
مشکلات سیاست امنیت محتوا
اگر سیاست امنیتی سختگیرانه دارید، ممکن است لازم باشد currency.wiki را به منابع مجاز script-src و frame-src اضافه کنید. مثال: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
نیاز به کمک دارید؟
آنچه را که به دنبال آن هستید پیدا نکردید؟ تیم پشتیبانی ما آماده کمک است.