Documentation de l’application Shopify
Tout ce dont vous avez besoin pour configurer et personnaliser la conversion de devises sur votre boutique Shopify
Table des matières
1 Installation
Installer depuis le Shopify App Store
- Visitez la page de l’application Currency.Wiki sur le Shopify App Store
- Cliquez sur 'Ajouter l’application' et autorisez l’installation
- L’application s’ouvrira et vous guidera via l’assistant de configuration
- Terminez l’assistant pour commencer à convertir les prix
Astuce : L’assistant de configuration prend environ 2 minutes et vous guide à chaque étape.
2 Assistant de configuration
L’assistant de configuration vous aide à paramétrer correctement l’application. Il vous guide pour mettre à jour le format de devise et activer l’intégration de l’application.
Étape 1 : Bienvenue
Consultez le déroulement de la configuration et cliquez sur 'C’est parti !'.
Étape 2 : Mettre à jour le format de devise
Allez dans Shopify Admin → Paramètres → Général → Paramètres par défaut de la boutique. Trouvez votre devise et cliquez sur le menu à trois points → 'Modifier le format de la devise'. Mettez à jour les champs HTML avec notre classe wrapper :
HTML avec devise :
<span class="cwiki">${{amount}} USD</span>
HTML sans devise :
<span class="cwiki">${{amount}}</span>
Important : La classe wrapper cwiki est essentielle. Elle indique à notre application quels éléments sont des prix, pour ne convertir que les montants et non les numéros de téléphone ou les identifiants de commande.
Étape 3 : Activer l’intégration de l’application
Activez l’application dans la section App Embeds de votre thème :
- Allez dans Boutique en ligne → Thèmes → Personnaliser
- Cherchez 'App embeds' dans la barre latérale gauche
- Trouvez 'Currency.Wiki App' et activez-le
- Cliquez sur Enregistrer dans l’éditeur de thème
Étape 4 : Vérifier la configuration
Cliquez sur 'Scanner ma boutique' pour vérifier que la configuration est complète. L’assistant vérifiera la présence de la classe cwiki et de l’intégration. Si tout est ok, vous êtes prêt !
3 Styles du widget
Choisissez parmi 6 styles de widget pour s’adapter au design de votre boutique. Chaque style est personnalisable avec les couleurs de votre marque.
Menu déroulant minimal
Intégration compacte à l’en-tête avec une simple liste déroulante. Idéal pour le coin supérieur droit.
Bouton flottant
Bouton flottant mobile avec panneau extensible. Parfait pour les boutiques orientées mobile. Positionné dans les coins.
Tiroir latéral
Panneau coulissant pleine hauteur avec fonction de recherche. Idéal pour les boutiques proposant de nombreuses devises.
Fenêtre modale
Superposition centrée avec disposition en grille. Rend la sélection de devise plus visible.
Onglets en ligne
Onglets horizontaux pour les devises populaires. Changement rapide sans ouvrir de menu.
Badge d’angle
Icône minimaliste dans un coin qui s’agrandit au clic. Idéal pour les designs épurés.
Astuce : Utilisez la page des paramètres du widget dans l’admin de l’application pour prévisualiser tous les styles avec les couleurs de votre boutique.
4 Tableau de bord admin
Le tableau de bord admin vous donne un contrôle total sur la conversion de devises dans votre boutique.
Accueil du tableau de bord
Activez/désactivez le widget, consultez les statistiques de conversion et visualisez un aperçu en direct de votre widget.
Paramètres du widget
Choisissez le style, la position, les couleurs, la taille, le rayon de bordure et les options d’affichage des drapeaux.
Gestion des devises
Activez/désactivez des devises, réorganisez la liste, configurez la détection automatique et les préférences de taux de change.
Analyses
Consultez les graphiques de conversion, les devises les plus utilisées et la répartition de votre clientèle internationale.
Thème & Apparence
Choisissez le mode de thème (auto, clair, sombre, personnalisé), définissez les couleurs, activez les effets glassmorphism et configurez le comportement du mode sombre.
Message au paiement
Activez un message sur les pages panier/paiement pour informer les clients de la devise de paiement.
5 Paramètres avancés
Les paramètres avancés offrent aux utilisateurs Pro un contrôle accru sur le formatage des prix et le comportement de conversion.
Formatage des prix (Pro)
- Décimales - Contrôlez le nombre de décimales affichées (0-6).
- Format du nombre - Choisissez le style de format (Auto, US, EU, Indien, Espace•Point, Espace•Virgule).
- Position du symbole - Placez le symbole avant ou après le montant, ou auto selon la devise.
- Arrondi - Standard, toujours au-dessus, toujours en dessous, ou sans arrondi. Option pour arrondir au plus proche .99.
Intégration au thème (Pro)
Intégrez manuellement le widget ou l’avis panier n’importe où dans votre thème avec ces extraits HTML :
Intégration du widget (à ajouter dans header.liquid ou toute section) :
<div class="cwiki-widget"></div>
Intégration de l’avis panier (à ajouter dans cart.liquid) :
<div class="cwiki-banner"></div>
Options développeur (Pro)
- Surcharges CSS - Injectez du CSS personnalisé pour ajuster le style du widget.
- Écouteurs de clic - Reconversions des prix lors du clic sur certains éléments (ex : sélecteurs de taille, options produit).
- Éléments de prix supplémentaires - Ciblez d’autres éléments de prix en plus du wrapper .cwiki par défaut.
- Modèles d’URL - Rescannez les prix lorsque l’URL contient certains mots (pour contenu AJAX, scroll infini).
- Délai de conversion - Attendez avant de convertir les prix (pour le contenu chargé après la page).
Attention : Ces options sont réservées aux utilisateurs avancés. Testez sur un thème de prévisualisation avant publication.
6 Dépannage
Les prix ne se convertissent pas ?
Assurez-vous que la classe cwiki est présente dans vos paramètres de format de devise. Allez dans Paramètres → Général → Paramètres par défaut et vérifiez le format HTML. Vérifiez aussi que l’intégration de l’application est activée dans le personnalisateur de thème.
Le widget ne s’affiche pas ?
Vérifiez que l’intégration de l’application est activée dans la section App Embeds de votre thème. Ouvrez le personnalisateur, trouvez App Embeds et assurez-vous que Currency.Wiki est activé. Enregistrez et actualisez votre boutique.
Les prix clignotent au chargement ?
Notre application est conçue pour un chargement sans clignotement. Si vous constatez un clignotement, vérifiez si des plugins de cache interfèrent. Assurez-vous aussi que l’intégration de l’application se charge dans la section head de votre thème.
Mauvaise devise détectée ?
La détection géographique se base sur l’adresse IP du visiteur. Les VPN ou réseaux d’entreprise peuvent fausser la détection. Les visiteurs peuvent toujours choisir leur devise manuellement. Vous pouvez aussi définir une devise de secours par défaut dans les paramètres.
Le widget ne correspond pas à mon thème ?
Utilisez les paramètres Thème & Apparence pour personnaliser les couleurs, ou activez le mode Auto pour détecter automatiquement les couleurs de votre thème. Vous pouvez aussi utiliser du CSS personnalisé dans les paramètres avancés.
Besoin d’aide ?
Notre équipe support est prête à vous aider pour toute question sur la configuration ou l’utilisation.
