የዊጅት ሰነድ
የ 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 የዊጅት ዘዴዎች
የድህረገፅዎን ንድፍ ለማሟሟል ከ 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 | የቀለም አስተላላፊ በ 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 እንዳለ ያረጋግጡ። በአሳሽዎ ኮንሶል ላይ ምንም የJavaScript ስህተቶች እንዳሉ ያረጋግጡ።
የዝርዝር ምርጫ አይሰራም
iframe መያዣ ከሚጠቀሙ ከሆነ፣ ዝርዝሮቹ በዊጅቱ አካባቢ ውስጥ ይንቀሳቀሳሉ። ሙሉ የዝርዝር ስራ ከፈጠራ ጋር ለማግኘት፣ የስክሪፕት መያዣ ዘዴ ይጠቀሙ።
የዘዴ ግጭቶች
የድህረ ገፅዎ CSS የዊጅቱን መልኩን ከሚጎዳ ከሆነ፣ ዊጅቱን ከገፅዎ ዘዴዎች የሚለይ የiframe መያዣ ዘዴ ይሞክሩ።
የይዘት ደህንነት ፖሊሲ ችግሮች
ጠንካራ CSP ካለዎት፣ currency.wikiን በscript-src እና frame-src መመከቻዎችዎ ውስጥ ማካተት ይኖርቦታል። ለምሳሌ፦ script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
