fullmetrixDocs

Dépannage

Résoudre les problèmes du plugin Sylius, de l'installation qui échoue jusqu'à l'import qui ne se termine pas.

Commencez toujours par les vérifications qui ne changent rien. Ne cliquez pas sur Disconnect dans Sylius, ni sur Déconnecter dans Fullmetrix, pour « repartir de zéro ». Dans Sylius, la déconnexion coupe le lien et le code ne peut pas être réutilisé. Dans Fullmetrix, elle supprime les données importées.

Plusieurs vérifications de cette page concernent le code du projet. Transmettez-les à votre développeur, avec l'heure et le message exact du problème.

Composer refuse d'installer le plugin

Votre développeur lance cette commande pour savoir ce qui bloque.

composer why-not fullmetrix/sylius-plugin '*'

Les causes habituelles sont une version de PHP inférieure à 8.1, une extension cURL ou JSON absente, ou une version de Sylius, Symfony ou Doctrine hors de la liste de Compatibilité. Il résout les dépendances sur son poste, puis déploie le fichier composer.lock obtenu. Copier le dossier vendor/ d'une machine à l'autre n'est pas une bonne idée si les versions de PHP diffèrent.

Symfony ne charge pas le plugin

Si bin/console cache:clear échoue ou si aucune route Fullmetrix n'existe, vérifiez que config/bundles.php contient cette ligne.

Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],

Votre développeur exécute ensuite composer dump-autoload, puis vide le cache avec le même environnement que le site en ligne. Sur plusieurs serveurs, il vérifie chacun d'eux.

La page Fullmetrix n'apparaît pas dans l'administration

  1. Ouvrez directement l'adresse /admin/fullmetrix de votre boutique avec un compte administrateur. Si la page s'affiche, seul le menu manque, souvent à cause d'un menu ou d'un thème d'administration personnalisé.
  2. Si l'adresse renvoie une erreur 404, les routes ne sont pas importées. Votre développeur vérifie le fichier config/routes/fullmetrix.yaml, puis exécute bin/console debug:router fullmetrix_admin_connection, qui doit afficher la route.
  3. Il vide le cache, puis vous rechargez la page.

La migration échoue

  • Faites une sauvegarde de la base avant de réessayer.
  • Votre développeur consulte bin/console doctrine:migrations:status et la première erreur affichée.
  • Il vérifie que l'utilisateur de la base a le droit de créer des tables.
  • Il ne crée pas les tables à la main et ne marque pas la migration comme exécutée sans avoir compris l'erreur.

Messages d'erreur à la connexion

Quand la connexion échoue, la page affiche Connection failed suivi d'une raison.

Raison affichéeCe qu'elle veut direQue faire
invalid_code_formatLe code n'a pas la forme FMTX-XXXX-XXXX-XXXXRecopiez-le depuis Fullmetrix. Il ne contient jamais les lettres O et I ni les chiffres 0 et 1.
storage_failedLe plugin n'a pas pu enregistrer sa configurationLa migration n'a sans doute pas été lancée. Votre développeur exécute bin/console doctrine:migrations:migrate.
Code de connexion introuvableCe code n'existe pas dans FullmetrixRecopiez le code affiché dans votre organisation, sans caractère en trop
Plateforme incorrecte pour ce codeLe code a été créé pour une autre plateformeDans Fullmetrix, revenez au choix de la plateforme, choisissez Sylius, puis copiez le code affiché et réessayez
Ce code est déjà associé à un autre siteUne boutique a déjà accepté ce codeVoir la section suivante
Trop de tentatives, réessayez dans quelques minutes.Trop d'essais en peu de tempsAttendez dix minutes avant de réessayer
Cette boutique est déjà connectée à une autre Organization.La boutique appartient déjà à une autre organisation FullmetrixUtilisez cette organisation, ou retirez-en la boutique d'abord
Cette boutique a déjà bénéficié d'un essai Fullmetrix...La période d'essai a déjà servi pour cette boutiqueUn abonnement est nécessaire, voir Facturation
invalid_response, register_failed ou un message réseauLe serveur n'a pas pu joindre Fullmetrix correctementVotre développeur vérifie que PHP peut ouvrir des connexions HTTPS sortantes vers fullmetrix.com (pare-feu, proxy, DNS, certificats)

Ne partagez pas un code actif

Le code est un secret. Si vous envoyez une capture de la page Fullmetrix de Sylius, masquez entièrement le champ Connection code.

Le code est « déjà associé à un autre site »

Un code ne sert qu'une fois. Ce message apparaît quand vous réessayez avec un code déjà accepté, par exemple après avoir cliqué sur Disconnect dans Sylius, ou si une autre installation (une préproduction, par exemple) l'a utilisé avant.

Si la carte de la boutique dans Fullmetrix fonctionne toujours, il n'y a rien à faire. Si vous avez déconnecté la boutique dans Sylius et voulez la reconnecter, il faut un nouveau code. Ouvrez Paramètres, puis Intégrations, cliquez sur Déconnecter sur la carte Sylius, confirmez, puis ajoutez de nouveau la boutique pour obtenir un code neuf. Cette opération efface les données importées dans Fullmetrix, qui sont ensuite importées de nouveau depuis votre boutique.

Connecté, mais l'import ne se termine pas

  1. Dans Sylius, ouvrez Marketing, puis Fullmetrix, et regardez le cadre Sync activity. Notez s'il affiche Waiting for sync, Sync in progress ou Sync complete.
  2. Lisez le cadre Recent activity. Une ligne sync_error contient la cause de l'erreur. Notez-la avant de cliquer sur Clear logs.
  3. Dans Fullmetrix, lisez la carte Sylius dans Paramètres, puis Intégrations. Le message La dernière synchronisation n'a pas pu joindre votre boutique veut dire que Fullmetrix n'a pas pu appeler votre site.
  4. Votre développeur vérifie que les adresses en /fullmetrix/api/ passent à travers le proxy, le cache et le pare-feu. Si vous utilisez Cloudflare, suivez Cloudflare et pare-feu.
  5. Il consulte les journaux PHP et du serveur web à l'heure du problème, et vérifie que tous les serveurs ont la même version du plugin.

Après une erreur, le bouton Synchroniser laisse la place à Reprendre et Réinitialiser. Une fois la cause corrigée, cliquez sur Reprendre pour repartir de l'endroit où l'import s'était arrêté. Si Reprendre n'est pas proposé, cliquez sur Réinitialiser, qui remet l'avancement à zéro et relance la synchronisation sans effacer les commandes déjà importées. Les autres états de la carte sont décrits dans État de la synchronisation.

L'adresse de la boutique est incorrecte dans Fullmetrix

La carte affiche l'adresse que le plugin a envoyée au moment de la connexion. Si c'est une adresse interne, en HTTP ou un autre domaine, l'administration a été ouverte avec cette adresse, ou Symfony ne fait pas confiance au proxy placé devant le site. Votre développeur corrige la configuration du proxy. Pour enregistrer la bonne adresse, il faut ensuite reconnecter la boutique avec un nouveau code, comme expliqué plus haut.

Le suivi des visiteurs ne reçoit rien

  • Vérifiez que la page Fullmetrix de Sylius affiche toujours Connected.
  • Testez sur une page publique de la boutique, pas sur l'administration.
  • Videz le cache de pages s'il y en a un devant le site.
  • Faites votre test en acceptant les cookies si un bandeau de consentement est en place.
  • Contrôlez la réception dans Script de suivi.

Écrire au support

Si le problème persiste, contactez-nous avec les éléments suivants.

  • L'adresse publique de la boutique et le nom de votre organisation Fullmetrix.
  • Les versions de Sylius, du plugin, de PHP, de Symfony et de Doctrine.
  • Le message exact, l'heure à laquelle il est apparu et le fuseau horaire.
  • Le résultat de bin/console debug:router fullmetrix_admin_connection.
  • Une capture des cadres Sync activity et Recent activity, avec le code masqué.

N'envoyez jamais de mot de passe, de code de connexion ni d'extrait de votre base de production.

Sur cette page