Skip to main content
Cet article explique comment résoudre les problèmes de compatibilité des applications avec Upcart et présente les bonnes pratiques pour des performances optimales.

Aperçu

Upcart est conçu pour s’intégrer harmonieusement avec la plupart des applications Shopify. Cependant, certaines applications tierces peuvent provoquer des problèmes de fonctionnement selon la manière dont elles modifient la logique du panier, du checkout, des prix ou des devises de Shopify.
Upcart fonctionne comme une superposition de type panier coulissant, améliorant l’expérience du panier d’achat sans remplacer complètement le panier ou le checkout natifs de Shopify.
Les applications qui remplacent le comportement du panier de Shopify, interceptent les actions Add to Cart ou remplacent le système natif de prix ou de devises de Shopify peuvent entrer en conflit avec Upcart. Nous vous recommandons d’utiliser autant que possible les fonctionnalités natives de Shopify (comme Shopify Markets pour la conversion de devises). Notre équipe dispose d’un champ d’assistance limité pour les applications tierces qui modifient de manière significative la structure de panier par défaut de Shopify. Même si une application est disponible sur le Shopify App Store, elle peut néanmoins être considérée comme une application tierce et présenter certaines limitations lorsqu’elle est utilisée avec Upcart.

Applications incompatibles

Les applications suivantes se sont révélées causer systématiquement des problèmes avec Upcart et ne sont pas prises en charge : BUCKS (application de conversion de devises)
Upcart n’est pas compatible avec les applications tierces de conversion de devises. Upcart utilise la conversion de devises native de Shopify via Shopify Markets. Les applications de conversion de devises comme BUCKS ne modifient les prix que visuellement sur la boutique en ligne et ne changent pas la devise réelle du panier. Pour cette raison, elles n’affecteront pas l’affichage des devises dans Upcart et peuvent provoquer des incohérences.
Si vous avez besoin d’une fonctionnalité multidevise, nous vous recommandons d’utiliser Shopify Markets. CloudFox Checkout
Les applications tierces de remplacement du checkout ne sont pas compatibles avec Upcart.
CartPanda
Les systèmes de checkout tiers ne sont pas pris en charge.

Applications susceptibles de causer des problèmes

Les applications suivantes ont été signalées comme provoquant des conflits ou pouvant ne pas fonctionner entièrement comme prévu avec Upcart :
  • qikify Quick View Popups
  • Vitals
  • Bundle Bear
Bien que ces applications puissent fonctionner dans certains cas, certains éléments ou fonctionnalités d’Upcart peuvent ne pas s’afficher ou fonctionner comme prévu. Si vous rencontrez des problèmes en utilisant l’une de ces applications, nous vous recommandons d’activer le paramètre de compatibilité décrit ci-dessous.
Les développeurs peuvent également utiliser l’Upcart Public API pour travailler à une résolution.

Enhanced AJAX API Compatibility

Si vous rencontrez des conflits avec une autre application, nous vous recommandons d’activer : Enhanced AJAX API Compatibility Pour activer ce paramètre : Allez dans Upcart → Settings → Advanced Settings → Enhanced AJAX API Compatibility Ce paramètre indique à Upcart de cesser d’intercepter les appels Add to Cart. Cela permet à d’autres applications, telles que les applications de bundles, les constructeurs de pages, les applications de personnalisation et les applications d’options de produits, de fonctionner sans interférence.

Important :

Ce paramètre comporte toutefois un compromis. Comme Upcart n’interceptera plus les appels Add to Cart, il ne pourra pas empêcher d’autres applications de rediriger les clients vers la page de panier native. Si les clients sont redirigés hors du panier coulissant après l’activation de ce paramètre :
  1. Vérifiez les paramètres de l’application en conflit.
  2. Recherchez des options telles que :
    • Disable redirect to cart
    • Stay on page after add to cart
    • Enable AJAX add to cart
  3. Ajustez ces paramètres pour empêcher les redirections forcées vers la page de panier.
Il est fortement recommandé d’effectuer des tests après l’activation de ce paramètre. Les applications répertoriées ci-dessus sont des exemples d’applications ayant présenté des problèmes de compatibilité avec Upcart. Il peut exister d’autres applications non encore identifiées. Cette liste sera mise à jour à mesure que de nouveaux cas seront signalés.

Si Upcart ne s’ouvre pas ou effectue une redirection

Si Upcart ne s’ouvre pas correctement ou redirige vers la page de panier à la place, veuillez consulter notre guide de dépannage : Dépannage : Upcart ne s’ouvre pas ou redirige vers la page de panier Ce guide passe en revue les causes courantes et les solutions étape par étape, notamment :
  • Les conflits avec le thème ou le code personnalisé
  • Les problèmes liés aux paramètres du panier AJAX
  • Les vérifications de compatibilité des applications
  • Les étapes de dépannage du navigateur et du cache
Si le problème persiste après avoir suivi le guide, veuillez contacter l’assistance avec l’URL de votre boutique et une brève description du problème.

Recommandation de test

Avant de mettre en ligne des modifications, nous vous recommandons de tester Upcart sur une version dupliquée de votre thème. Pour ce faire :
  • Dans l’interface administrateur Shopify, allez dans Online Store > Themes
  • Cliquez sur Actions à côté de votre thème actif, puis sélectionnez Duplicate
  • Ouvrez le thème dupliqué et cliquez sur Preview
  • Testez les interactions avec le panier, les bundles, les remises, l’affichage des devises et les ventes incitatives
  • Une fois la confirmation obtenue, publiez le thème mis à jour
Tester à l’avance permet d’éviter les problèmes d’affichage ou de performance avant qu’ils n’affectent les clients.