विजेट दस्तावेज
Currency.Wiki मुद्रा रूपान्तरण विजेट तपाईंको वेबसाइटमा एम्बेड र अनुकूलन गर्ने पूर्ण मार्गदर्शिका।
विषय सूची
1 सुरु गर्दै
आफ्नो वेबसाइटमा मुद्रा रूपान्तरण विजेट थप्न सजिलो छ। यी सरल चरणहरू पालना गर्नुहोस्:
- विजेट बिल्डर पृष्ठमा जानुहोस् र विजेटको देखावट अनुकूलन गर्नुहोस्
- आफ्नो मनपर्ने विजेट शैली, मुद्रा, र थिम छान्नुहोस्
- उत्पन्न भएको एम्बेड कोड (Script वा Iframe) प्रतिलिपि गर्नुहोस्
- कोड तपाईंको वेबसाइटको HTML मा जहाँ विजेट देखाउन चाहनुहुन्छ त्यहाँ टाँस्नुहोस्
टिप: छिटो सुरु प्रिसेटहरू प्रयोग गरेर पहिले नै कन्फिगर गरिएको विजेटबाट छिटो सुरु गर्नुहोस्।
2 एम्बेड विधिहरू
Script एम्बेड (सिफारिस गरिएको)
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>
- तपाईंको पृष्ठ शैलीबाट पूर्ण रूपमा पृथक
- कडा सामग्री सुरक्षा नीतिसँग काम गर्छ
- सरल र सुरक्षित कार्यान्वयन
नोट: पूर्ण अन्तरक्रियाका लागि Script एम्बेड प्रयोग गर्नुहोस् (ड्रपडाउनहरू सामग्रीमाथि देखिन्छन्)। पृथकता वा 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 प्यारामिटर प्रयोग गरेर विजेट अनुकूलन गर्नुहोस्। यी प्यारामिटर 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 | एक्सेन्ट रंग (hex मा # बिना) |
| lang | en | विजेट भाषा कोड (जस्तै en, es, fr, de) |
| flags | 1 | देशको झन्डा देखाउनुहोस् (1=देखाउनुहोस्, 0=लुकाउनुहोस्) |
| display | iso | मुद्रा देखाउने ढाँचा (iso=USD, symbol=$) |
| lock | 0 | मुद्रा लक गर्नुहोस् (1=लक, 0=अनलक) |
| currencies | EUR,GBP,JPY | बहु-मुद्रा विजेटका लागि मुद्रा सूची (comma-separated) |
| dropdown | all | ड्रपडाउनमा मुद्राहरू (all, top10, top20, वा comma-separated सूची) |
| 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
३०-दिने चार्ट सहित सानो रूपान्तरणकर्ता:
?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 - 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 मा सही स्थानमा राखिएको छ कि छैन सुनिश्चित गर्नुहोस्। Script एम्बेडका लागि, कन्टेनर div सहि ID सहित छ कि छैन जाँच गर्नुहोस्। ब्राउजर कन्सोलमा कुनै JavaScript त्रुटि छ कि छैन हेर्नुहोस्।
ड्रपडाउन काम गरिरहेको छैन
Iframe एम्बेड प्रयोग गर्दा, ड्रपडाउन विजेट क्षेत्रमा स्क्रोल हुन्छ। पूर्ण ड्रपडाउन कार्यक्षमताका लागि Script एम्बेड विधि प्रयोग गर्नुहोस्।
शैली द्वन्द्व
तपाईंको वेबसाइटको CSS ले विजेटको देखावटमा असर गरिरहेको छ भने, विजेट शैली पृथक गर्न Iframe एम्बेड विधि प्रयास गर्नुहोस्।
सामग्री सुरक्षा नीति समस्या
यदि तपाईंको CSP कडा छ भने, script-src र frame-src निर्देशनमा currency.wiki थप्नु आवश्यक हुन सक्छ। उदाहरण: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
सहायता चाहनुहुन्छ?
तपाईं खोजिरहनु भएको कुरा फेला परेन? हाम्रो समर्थन टोली सहायता गर्न तयार छ।