Dépannage
Résolvez les problèmes d’installation, de route, de code, de webhook et de synchronisation dans Sylius.
Relevez l’erreur exacte, l’heure et le fuseau, les versions du plugin, de Sylius et de PHP, ainsi que le commit déployé avant toute modification.
Composer ne peut pas installer le plugin
- Exécutez
composer why-not fullmetrix/sylius-plugin '*'. - Vérifiez PHP 8.1+, cURL et JSON.
- Vérifiez les versions de Sylius, Symfony et Doctrine.
- Contrôlez l’authentification Composer au dépôt qui fournit le paquet.
- Résolvez les dépendances en développement, puis déployez le fichier verrouillé.
Symfony ne charge pas FullmetrixPlugin
Vérifiez l’entrée suivante dans config/bundles.php :
Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],Exécutez composer dump-autoload, vérifiez vendor/fullmetrix/sylius-plugin, puis videz le cache avec le même APP_ENV que l’application web. Sur plusieurs nœuds, contrôlez-les tous.
Fullmetrix n’apparaît pas dans le menu
- Vérifiez le bundle et l’import des routes.
- Exécutez
bin/console debug:router fullmetrix_admin_connection. - Videz le cache.
- Ouvrez
/admin/fullmetrixdirectement avec un compte administrateur. - Si la route fonctionne, contrôlez les menus ou thèmes personnalisés.
La migration échoue
- Refaites une sauvegarde avant de réessayer.
- Consultez
bin/console doctrine:migrations:statuset la première erreur SQL. - Vérifiez les droits de création et modification de tables.
- Ne créez pas les tables manuellement et ne marquez pas une migration échouée comme exécutée sans examen.
Le code est refusé
- Générez-le depuis la bonne organisation et la bonne plateforme.
- Copiez toute la valeur
FMTX-…, sans espace ni ponctuation. - Ne réutilisez pas un code d’un autre CMS ou d’une autre organisation.
- Vérifiez l’URL publique en HTTPS, le DNS, le proxy, les certificats et l’accès sortant de PHP.
- Ne créez un nouveau code qu’après avoir confirmé que le précédent n’a pas été accepté.
Ne transmettez jamais un code actif en capture
Le code est un secret. Le support peut travailler avec l’identifiant d’organisation, l’URL, l’heure, la version du plugin et une capture où le code est entièrement masqué.
Connected, mais l’import ne termine pas
- Gardez la page Fullmetrix ouverte jusqu’à la détection du plugin.
- Relevez Waiting for sync, Sync in progress ou Sync complete dans Marketing > Fullmetrix.
- Consultez Recent activity et conservez le message
sync_erroravant d’effacer le journal. - Vérifiez l’accès aux routes
/fullmetrix/api/*à travers le proxy ou le WAF. - Consultez les journaux PHP et du serveur web à la même heure.
- Vérifiez la base partagée et la version identique sur chaque nœud.
Le suivi de la boutique manque
- Vérifiez que le plugin affiche toujours Connected.
- Chargez une page publique, pas une route d’administration ou d’API.
- Cherchez le traceur Fullmetrix dans le code source et le réseau du navigateur.
- Contrôlez le gestionnaire de consentement, la CSP, le proxy, le cache et le thème.
Informations pour le support
Envoyez, sans mot de passe, code, secret, donnée client ou contenu de base de production :
- URL publique et identifiant ou slug de l’organisation
- Versions Sylius, plugin, PHP, Symfony et Doctrine
- Erreur, heure, fuseau et commit
- Résultat de
debug:router fullmetrix_admin_connection - État actuel et activité récente expurgée
- Code d’état pertinent du proxy ou serveur web
Avant tout retrait, consultez Déconnecter et désinstaller.