Τεκμηρίωση Widget
Πλήρης οδηγός για την ενσωμάτωση και προσαρμογή του widget μετατροπέα νομισμάτων Currency.Wiki στον ιστότοπό σας.
Πίνακας Περιεχομένων
1 Ξεκινώντας
Η προσθήκη ενός widget μετατροπέα νομισμάτων στον ιστότοπό σας είναι εύκολη. Ακολουθήστε αυτά τα απλά βήματα:
- Μεταβείτε στη σελίδα Δημιουργού Widget και προσαρμόστε την εμφάνιση του widget σας
- Επιλέξτε το προτιμώμενο στυλ, νομίσματα και θέμα
- Αντιγράψτε τον παραγόμενο κώδικα ενσωμάτωσης (Script ή Iframe)
- Επικολλήστε τον κώδικα στο HTML του ιστότοπού σας όπου θέλετε να εμφανίζεται το widget
Συμβουλή: Χρησιμοποιήστε τις Γρήγορες Προεπιλογές στον Δημιουργό Widget για να ξεκινήσετε γρήγορα με ένα προρυθμισμένο widget.
2 Μέθοδοι Ενσωμάτωσης
Ενσωμάτωση Script (Συνιστάται)
Η μέθοδος ενσωμάτωσης script εισάγει το widget απευθείας στη σελίδα σας. Τα αναπτυσσόμενα μενού νομισμάτων θα εμφανίζονται μπροστά από το περιεχόμενο για εύκολη επιλογή.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Τα αναπτυσσόμενα εμφανίζονται εκτός του πλαισίου του widget
- Ιδανικό για διαδραστική επιλογή νομισμάτων
- Απρόσκοπτη ενσωμάτωση με τη σελίδα σας
Ενσωμάτωση Iframe
Η μέθοδος ενσωμάτωσης iframe δημιουργεί ένα απομονωμένο πλαίσιο για το widget. Αυτή η μέθοδος είναι ασφαλής και λειτουργεί σε περιβάλλοντα με αυστηρές πολιτικές περιεχομένου.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Πλήρως απομονωμένο από τα στυλ της σελίδας σας
- Λειτουργεί με αυστηρές Πολιτικές Ασφαλείας Περιεχομένου
- Απλή και ασφαλής υλοποίηση
Σημείωση: Χρησιμοποιήστε Script για πλήρη διαδραστικότητα (τα αναπτυσσόμενα εμφανίζονται πάνω από το περιεχόμενο). Χρησιμοποιήστε Iframe όταν χρειάζεστε απομόνωση ή έχετε περιορισμούς CSP.
3 Στυλ Widget
Επιλέξτε ανάμεσα σε 11 διαφορετικά στυλ widget για να ταιριάξετε με το σχεδιασμό του ιστότοπού σας. Κάθε στυλ είναι βελτιστοποιημένο για διαφορετικές χρήσεις και μεγέθη εμφάνισης.
mini
250x140px
Συμπαγής μετατροπέας μίας γραμμής. Ιδανικό για κεφαλίδες ή περιορισμένο χώρο.
square
250x250px
Widget αναλογίας 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
Προσαρμόστε το widget σας χρησιμοποιώντας παραμέτρους URL. Αυτές οι παράμετροι λειτουργούν και με τις δύο μεθόδους ενσωμάτωσης (Script και Iframe).
| Παράμετρος | Προεπιλογή | Περιγραφή |
|---|---|---|
| style | compact | Στυλ widget (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 | Κωδικός γλώσσας widget (π.χ. en, es, fr, de) |
| flags | 1 | Εμφάνιση σημαιών χωρών (1=εμφάνιση, 0=απόκρυψη) |
| display | iso | Μορφή εμφάνισης νομίσματος (iso=USD, symbol=$) |
| lock | 0 | Κλείδωμα νομισμάτων (1=κλειδωμένο, 0=ξεκλείδωτο) |
| currencies | EUR,GBP,JPY | Λίστα νομισμάτων διαχωρισμένη με κόμμα για widgets πολλαπλών νομισμάτων |
| dropdown | all | Νομίσματα στο dropdown (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 - Μορφή ΗΠΑ: 1,234.56
- eu - Ευρωπαϊκή μορφή: 1.234,56
- french - Γαλλική μορφή: 1 234,56
- indian - Ινδική μορφή: 1,23,456.78
Επιλογές Νομισμάτων Dropdown
- all - Όλα τα 170+ υποστηριζόμενα νομίσματα
- top10 - Κορυφαία 10 δημοφιλέστερα νομίσματα
- top20 - Κορυφαία 20 νομίσματα βάσει όγκου συναλλαγών
- USD,EUR,GBP,... - Προσαρμοσμένη λίστα συγκεκριμένων νομισμάτων
Συμβουλή: Χρησιμοποιήστε τον Δημιουργό Widget για να ρυθμίσετε οπτικά όλες αυτές τις επιλογές και να δημιουργήσετε αυτόματα τον κώδικα ενσωμάτωσης.
6 Αντιμετώπιση Προβλημάτων
Το Widget Δεν Εμφανίζεται
Βεβαιωθείτε ότι ο κώδικας ενσωμάτωσης έχει τοποθετηθεί σωστά στο HTML. Για ενσωμάτωση script, βεβαιωθείτε ότι το div container υπάρχει με το σωστό ID. Ελέγξτε την κονσόλα του περιηγητή για τυχόν σφάλματα JavaScript.
Το Dropdown Δεν Λειτουργεί
Αν χρησιμοποιείτε ενσωμάτωση iframe, τα dropdown θα κυλούν μέσα στην περιοχή του widget. Για πλήρη λειτουργικότητα dropdown με επικαλύψεις, χρησιμοποιήστε τη μέθοδο ενσωμάτωσης script.
Σύγκρουση Στυλ
Αν το CSS του ιστότοπού σας επηρεάζει την εμφάνιση του widget, δοκιμάστε τη μέθοδο ενσωμάτωσης iframe που απομονώνει τα στυλ του widget από τη σελίδα σας.
Θέματα Πολιτικής Ασφαλείας Περιεχομένου
Αν έχετε αυστηρή CSP, ίσως χρειαστεί να προσθέσετε το currency.wiki στις επιτρεπόμενες οδηγίες script-src και frame-src. Παράδειγμα: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Χρειάζεστε Βοήθεια;
Δεν βρίσκετε αυτό που ψάχνετε; Η ομάδα υποστήριξής μας είναι εδώ για να βοηθήσει.
