وجیٹ ڈاکیومنٹیشن
Currency.Wiki کرنسی کنورٹر وجیٹ کو اپنی ویب سائٹ پر ایمبیڈ اور کسٹمائز کرنے کے لیے مکمل گائیڈ۔
مواد کی فہرست
1 آغاز کرنا
اپنی ویب سائٹ پر کرنسی کنورٹر وجیٹ شامل کرنا آسان ہے۔ یہ سادہ مراحل فالو کریں:
- وجیٹ بلڈر پیج پر جائیں اور وجیٹ کی ظاہری شکل حسب منشا بنائیں
- اپنا پسندیدہ وجیٹ اسٹائل، کرنسیاں اور تھیم منتخب کریں
- جنریٹڈ ایمبیڈ کوڈ (Script یا Iframe) کاپی کریں
- کوڈ اپنی ویب سائٹ کے HTML میں اس جگہ پیسٹ کریں جہاں آپ وجیٹ دکھانا چاہتے ہیں
ٹپ: وجیٹ بلڈر میں Quick Start Presets استعمال کریں تاکہ پہلے سے کنفیگرڈ وجیٹ کے ساتھ فوراً آغاز کریں۔
2 ایمبیڈ طریقے
Script ایمبیڈ (تجویز کردہ)
اسکرپٹ ایمبیڈ طریقہ وجیٹ کو براہ راست آپ کے صفحے میں شامل کرتا ہے۔ کرنسی ڈراپ ڈاؤن مینو آسان انتخاب کے لیے اردگرد کے مواد کے اوپر ظاہر ہوں گے۔
<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>
- آپ کے صفحے کے اسٹائلز سے مکمل طور پر الگ
- سخت Content Security Policies کے ساتھ کام کرتا ہے
- سادہ اور محفوظ نفاذ
نوٹ: مکمل انٹرایکٹیویٹی کے لیے Script ایمبیڈ استعمال کریں (ڈراپ ڈاؤنز مواد کے اوپر ظاہر ہوں گے)۔ اگر آپ کو علیحدگی یا CSP پابندیاں درکار ہیں تو Iframe ایمبیڈ استعمال کریں۔
3 وجیٹ اسٹائلز
اپنی ویب سائٹ کے ڈیزائن سے میل کھانے کے لیے 11 مختلف وجیٹ اسٹائلز میں سے انتخاب کریں۔ ہر اسٹائل مختلف استعمال اور ڈسپلے سائز کے لیے بہتر بنایا گیا ہے۔
mini
250x140px
کمپیکٹ سنگل لائن کنورٹر۔ ہیڈرز یا تنگ جگہوں کے لیے بہترین۔
square
250x250px
1:1 تناسب وجیٹ سوئپ بٹن کے ساتھ۔ سائیڈبارز کے لیے بہترین۔
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 پیرا میٹرز کے ذریعے حسب منشا بنائیں۔ یہ پیرا میٹرز Script اور Iframe دونوں ایمبیڈ طریقوں کے ساتھ کام کرتے ہیں۔
| پیرا میٹر | ڈیفالٹ | تفصیل |
|---|---|---|
| style | compact | وجیٹ اسٹائل (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | رنگ تھیم (light, dark, یا auto) |
| from | USD | سورس کرنسی کوڈ (مثلاً USD, EUR, GBP) |
| to | EUR | ٹارگٹ کرنسی کوڈ (مثلاً EUR, USD, JPY) |
| amount | 1000 | کنورژن کے لیے ڈیفالٹ رقم |
| accent | #2563eb | ایکسینٹ رنگ ہییکس فارمیٹ میں (# کے بغیر) |
| lang | en | وجیٹ زبان کوڈ (مثلاً en, es, fr, de) |
| flags | 1 | ملکی جھنڈے دکھائیں (1=دکھائیں، 0=چھپائیں) |
| display | iso | کرنسی ڈسپلے فارمیٹ (iso=USD, symbol=$) |
| lock | 0 | کرنسیاں لاک کریں (1=لاکڈ، 0=ان لاکڈ) |
| currencies | EUR,GBP,JPY | ملٹی کرنسی وجیٹس کے لیے کرنسیوں کی کوما سے جدا فہرست |
| dropdown | all | ڈراپ ڈاؤن میں کرنسیاں (all, top10, top20، یا کوما سے جدا فہرست) |
| branding | 1 | برانڈنگ دکھائیں (1=دکھائیں، 0=چھپائیں) |
| brandinglink | 1 | برانڈنگ کلک ایبل بنائیں (1=لنک، 0=صرف ٹیکسٹ) |
| format | auto | نمبر فارمیٹ (auto, us, eu, french, indian) |
| decimals | 2 | اعشاریہ مقامات کی تعداد (0-6) |
| chart | 0 | چارٹ فعال کریں (1=فعال، 0=غیر فعال) |
| chartperiod | 7d | چارٹ مدت (7d, 14d, 30d, 90d) |
مثالیں
ڈارک تھیم کمپیکٹ کنورٹر:
?style=compact&theme=dark&from=USD&to=EUR
ملٹی کرنسی ایکسچینج ریٹس:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
منی کنورٹر 30 دن کے چارٹ کے ساتھ:
?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 - US فارمیٹ: 1,234.56
- eu - یورپی فارمیٹ: 1.234,56
- french - فرینچ فارمیٹ: 1 234,56
- indian - انڈین فارمیٹ: 1,23,456.78
ڈراپ ڈاؤن کرنسی آپشنز
- all - تمام 170+ سپورٹڈ کرنسیاں
- top10 - سب سے زیادہ مقبول ٹاپ 10 کرنسیاں
- top20 - تجارتی حجم کے لحاظ سے ٹاپ 20 کرنسیاں
- USD,EUR,GBP,... - مخصوص کرنسیوں کی کسٹم فہرست
ٹپ: وجیٹ بلڈر استعمال کریں تاکہ یہ تمام آپشنز بصری طور پر کنفیگر کریں اور ایمبیڈ کوڈ خودکار طور پر حاصل کریں۔
6 ٹربل شوٹنگ
وجیٹ نظر نہیں آ رہا
یقینی بنائیں کہ ایمبیڈ کوڈ آپ کے HTML میں درست جگہ پر ہے۔ Script ایمبیڈ کے لیے کنٹینر div درست ID کے ساتھ موجود ہو۔ کسی بھی JavaScript ایرر کے لیے براؤزر کنسول چیک کریں۔
ڈراپ ڈاؤن کام نہیں کر رہا
اگر آپ iframe ایمبیڈ استعمال کر رہے ہیں تو ڈراپ ڈاؤنز وجیٹ ایریا کے اندر اسکرول ہوں گے۔ مکمل ڈراپ ڈاؤن فنکشن کے لیے Script ایمبیڈ طریقہ استعمال کریں۔
اسٹائل تضاد
اگر آپ کی ویب سائٹ کا CSS وجیٹ کی ظاہری شکل متاثر کر رہا ہے تو Iframe ایمبیڈ طریقہ آزمائیں جو وجیٹ کے اسٹائلز کو آپ کے صفحے سے الگ کرتا ہے۔
Content Security Policy مسائل
اگر آپ کے پاس سخت CSP ہے تو آپ کو currency.wiki کو اپنے script-src اور frame-src ڈائریکٹیوز میں شامل کرنا پڑ سکتا ہے۔ مثال: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
مدد چاہیے؟
جو تلاش کر رہے ہیں وہ نہیں ملا؟ ہماری سپورٹ ٹیم مدد کے لیے حاضر ہے۔
