Documentation du plugin WordPress
Apprenez à installer, configurer et personnaliser votre widget de conversion de devises
Table des matières
1 Installation
Méthode 1 : Installer depuis WordPress (recommandé)
- Accédez à votre tableau de bord administrateur WordPress
- Allez dans Extensions > Ajouter
- Recherchez "Currency.Wiki Converter"
- Cliquez sur "Installer maintenant" puis sur "Activer"
Méthode 2 : Installation manuelle
- Téléchargez le plugin depuis WordPress.org
- Allez dans Extensions > Ajouter > Téléverser une extension
- Sélectionnez le fichier ZIP téléchargé et cliquez sur "Installer maintenant"
- Activez le plugin après l'installation
2 Utilisation du bloc Gutenberg
La façon la plus simple d’ajouter le convertisseur de devises à vos pages :
- Modifiez n'importe quelle page ou publication avec l'éditeur Gutenberg
- Cliquez sur le bouton + pour ajouter un nouveau bloc
- Recherchez "Currency Converter" ou parcourez la catégorie Widgets
- Configurez le widget via le panneau latéral à droite
Astuce : Vous pouvez voir un aperçu en direct de votre widget en modifiant les paramètres dans l’éditeur de blocs.
3 Utilisation du shortcode
Vous pouvez également ajouter le widget via des shortcodes dans vos publications, pages ou modèles de thème :
Utilisation de base
[currencywiki_converter]
Attributs disponibles
| Attribut | Par défaut | Description |
|---|---|---|
| style | compact | Style du widget (compact, en ligne, vertical, mini-graphique, etc.) |
| theme | auto | Thème de couleur (auto, clair, sombre) |
| from | USD | Devise source par défaut (code ISO à 3 lettres) |
| to | EUR | Devise cible par défaut (code ISO à 3 lettres) |
| amount | 1 | Montant par défaut à convertir |
| accent | #3b82f6 | Couleur d’accentuation (code hexadécimal comme #3b82f6) |
| embed | script | Méthode d’intégration (script ou iframe) |
| width | auto | Largeur personnalisée en pixels |
| height | auto | Hauteur personnalisée en pixels |
Exemples
Widget en thème sombre :
[currencywiki_converter theme="dark"]
Devises et montant personnalisés :
[currencywiki_converter from="GBP" to="JPY" amount="100"]
Style mini graphique :
[currencywiki_converter style="mini-chart"]
Utilisation de l’intégration iframe (pour compatibilité avec le thème) :
[currencywiki_converter embed="iframe"]
4 Styles du widget
Choisissez parmi plusieurs styles de widget pour s’adapter au design de votre site :
mini
Convertisseur minimal, idéal pour les petits espaces (250x140px)
square
Convertisseur carré au ratio 1:1 (250x250px)
compact
Convertisseur compact et peu encombrant (280x200px)
inline
Disposition horizontale, idéale pour les en-têtes (450x120px)
tall
Disposition verticale avec étiquettes classiques (220x360px)
mini-chart
Convertisseur compact avec graphique historique (250x260px)
multi-expandable
Conversion vers plusieurs devises, l'utilisateur peut ajouter/retirer (300x400px)
multi-fixed
Liste fixe de conversions multiples (280x360px)
rates-compact
Liste simple des taux de change (260x260px)
rates-viewer
Affichage complet des taux avec graphique (350x420px)
rates-viewer-compact
Affichage compact des taux avec graphique (300x340px)
Astuce : Utilisez le générateur de widget dans votre admin WordPress pour prévisualiser tous les styles avant de les ajouter à votre site.
5 Options de configuration
La page des paramètres du plugin dans votre admin WordPress vous permet de configurer les options par défaut :
Options de thème
- auto - S’adapte automatiquement au schéma de couleurs de votre site
- light - Toujours utiliser un fond clair
- dark - Toujours utiliser un fond sombre
Méthode d’intégration
- script - Par défaut. Le widget se charge en ligne avec toutes les fonctionnalités. Les menus déroulants s’affichent au-dessus du contenu environnant.
- iframe - Option de secours. Le widget se charge dans une iframe isolée. À utiliser en cas de conflits de style avec votre thème.
Remarque : Si les menus déroulants de devises apparaissent derrière d'autres éléments ou sont coupés, essayez de passer en mode iframe.
6 Dépannage
Le widget ne s’affiche pas ?
Assurez-vous que le plugin est activé. Vérifiez si des plugins de cache doivent être vidés. Essayez la méthode iframe si l’intégration script ne fonctionne pas.
Le widget est cassé ou les styles sont en conflit ?
Certains thèmes WordPress peuvent entrer en conflit avec le script du widget. Passez en mode iframe en ajoutant embed="iframe" à votre shortcode.
Menu déroulant de devises masqué ou coupé ?
Cela peut arriver si les éléments conteneurs ont overflow:hidden. Essayez le mode iframe ou ajustez le CSS de votre thème pour autoriser l’overflow sur le conteneur du widget.
Le widget affiche d’anciens taux ?
Les taux de change sont mis à jour automatiquement. Si vous utilisez un plugin de cache, excluez les scripts du widget du cache ou videz-le après modification.
Besoin d’aide ?
Vous ne trouvez pas ce que vous cherchez ? Notre équipe support est là pour vous aider.
