विजेट डाक्यूमेंटेशन
Currency.Wiki मुद्रा कन्वर्टर विजेट को अपनी वेबसाइट पर एम्बेड और कस्टमाइज़ करने के लिए पूरी गाइड।
सामग्री सूची
1 शुरुआत करें
अपनी वेबसाइट पर मुद्रा कन्वर्टर विजेट जोड़ना आसान है। ये सरल चरण अपनाएँ:
- विजेट बिल्डर पेज पर जाएँ और विजेट का रूप कस्टमाइज़ करें
- अपना पसंदीदा विजेट स्टाइल, मुद्राएँ और थीम चुनें
- जनरेटेड एम्बेड कोड (स्क्रिप्ट या आईफ्रेम) कॉपी करें
- कोड को अपनी वेबसाइट के 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 src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- आपके पेज स्टाइल्स से पूरी तरह अलग
- सख्त कंटेंट सिक्योरिटी पॉलिसी के साथ काम करता है
- सरल और सुरक्षित इम्प्लीमेंटेशन
नोट: फुल इंटरएक्टिविटी के लिए स्क्रिप्ट एम्बेड का उपयोग करें (ड्रॉपडाउन सामग्री के ऊपर दिखते हैं)। आइसोलेशन या CSP प्रतिबंध होने पर आईफ्रेम एम्बेड का उपयोग करें।
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 पैरामीटर्स से कस्टमाइज़ करें। ये पैरामीटर्स दोनों स्क्रिप्ट और आईफ्रेम एम्बेड विधियों के साथ काम करते हैं।
| पैरामीटर | डिफ़ॉल्ट | विवरण |
|---|---|---|
| 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 | एक्सेंट रंग (hex फॉर्मेट, बिना #) |
| 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 - USD, EUR, GBP जैसे ISO कोड्स दिखाता है
- symbol - $, €, £ जैसे मुद्रा प्रतीक दिखाता है
संख्या फॉर्मेट्स
- auto - स्वचालित रूप से विज़िटर के ब्राउज़र सेटिंग्स का पता लगाता है
- 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 में सही जगह पर है। स्क्रिप्ट एम्बेड के लिए, सुनिश्चित करें कि कंटेनर div सही ID के साथ मौजूद है। अपने ब्राउज़र कंसोल में कोई JavaScript त्रुटि देखें।
ड्रॉपडाउन काम नहीं कर रहा
यदि आप आईफ्रेम एम्बेड का उपयोग कर रहे हैं, तो ड्रॉपडाउन विजेट क्षेत्र के अंदर स्क्रॉल होंगे। ओवरले के साथ फुल ड्रॉपडाउन कार्यक्षमता के लिए स्क्रिप्ट एम्बेड विधि का उपयोग करें।
स्टाइल संघर्ष
यदि आपकी वेबसाइट का CSS विजेट के रूप को प्रभावित कर रहा है, तो आईफ्रेम एम्बेड विधि आज़माएँ जो विजेट स्टाइल्स को आपके पेज से अलग करता है।
कंटेंट सिक्योरिटी पॉलिसी समस्याएँ
यदि आपके पास सख्त CSP है, तो आपको currency.wiki को अपने script-src और frame-src निर्देशों में जोड़ना पड़ सकता है। उदाहरण: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
मदद चाहिए?
क्या आप जो खोज रहे हैं वह नहीं मिल रहा? हमारी सपोर्ट टीम आपकी मदद के लिए यहाँ है।
