Problemen oplossen
Los installatie-, route-, code-, webhook- en synchronisatieproblemen in Sylius op.
Noteer de exacte fout, tijd en tijdzone, pluginversie, Sylius-versie, PHP-versie en implementatiecommit voordat je de installatie wijzigt.
Composer kan de plugin niet installeren
- Voer
composer why-not fullmetrix/sylius-plugin '*'uit. - Controleer PHP 8.1+, cURL en JSON.
- Controleer of het project een ondersteunde versie van Sylius, Symfony en Doctrine gebruikt.
- Controleer of Composer zich kan authenticeren bij de repository die het Fullmetrix-pakket levert.
- Wijzig de afhankelijkheid eerst in een ontwikkelomgeving en implementeer daarna het resulterende lockbestand.
Symfony laadt FullmetrixPlugin niet
Controleer config/bundles.php:
Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],- Voer
composer dump-autoloaduit nadat je hebt gecontroleerd dat het pakket invendor/fullmetrix/sylius-pluginstaat. - Wis de cache met hetzelfde
APP_ENVdat de webapplicatie gebruikt. - Controleer het pakket en de configuratie op elke node van een installatie met meerdere nodes.
Fullmetrix ontbreekt in het menu
- Controleer de bundle-entry en route-import uit de installatiehandleiding.
- Voer
bin/console debug:router fullmetrix_admin_connectionuit. - Wis de applicatiecache.
- Open
/admin/fullmetrixrechtstreeks terwijl je als Sylius-beheerder bent aangemeld. - Werkt de rechtstreekse route, controleer dan aangepaste beheer-menu-listeners of thema’s die het Sylius-menu vervangen.
Migratie mislukt
- Maak een nieuwe back-up voordat je het opnieuw probeert.
- Voer
bin/console doctrine:migrations:statusuit en onderzoek de eerste databasefout. - Controleer of de implementatiedatabasegebruiker tabellen mag maken en wijzigen.
- Maak de plugintabellen niet handmatig, tenzij Fullmetrix Support het schemaverschil heeft beoordeeld.
- Markeer een mislukte migratie niet als uitgevoerd alleen om de implementatie te deblokkeren.
De code wordt geweigerd
- Genereer de code vanuit de bedoelde Fullmetrix-organisatie en het juiste platform.
- Kopieer de volledige
FMTX-…-waarde zonder spaties of leestekens. - Gebruik geen code opnieuw die voor een ander CMS of een andere organisatie is gemaakt.
- Controleer of de openbare winkel-URL juist en via HTTPS bereikbaar is.
- Controleer uitgaande HTTPS, DNS, proxy en CA-certificaten vanuit de PHP-runtime.
- Maak pas een nieuwe openstaande verbinding in Fullmetrix nadat je hebt bevestigd dat de eerdere poging niet is geaccepteerd.
Plaats nooit een actieve code in een screenshot
Behandel de verbindingscode als een inloggegeven. Support kan onderzoek doen met de organisatie-ID, winkel-URL, exacte tijd, pluginversie en een screenshot waarop de code volledig is afgedekt.
Connected, maar de import stopt
- Laat de Fullmetrix-verbindingspagina open totdat deze de plugin detecteert.
- Controleer in Marketing > Fullmetrix of de status Waiting for sync, Sync in progress of Sync complete is.
- Controleer Recent activity op
sync_error; wis het logboek niet voordat je het bericht hebt vastgelegd. - Controleer of Fullmetrix de openbare
/fullmetrix/api/*-routes door een proxy of WAF kan bereiken. - Controleer de PHP- en webserverlogboeken op hetzelfde tijdstip.
- Controleer of alle applicatienodes de database delen en dezelfde pluginversie gebruiken.
Storefronttracking ontbreekt
- Controleer of de plugin nog steeds Connected toont.
- Laad een openbare storefrontpagina, geen beheer- of API-route.
- Zoek de Fullmetrix-tracker in de paginabron en het browsernetwerklogboek.
- Controleer de toestemmingsmanager, Content Security Policy, proxy, cache en thema-aanpassingen.
- Wis na een implementatie de storefrontcaches, maar wis Fullmetrix-activiteit pas nadat het probleem is vastgelegd.
Informatie voor ondersteuning
Stuur het volgende zonder wachtwoorden, verbindingscodes, verbindingsgeheimen, klantgegevens of inhoud van de productiedatabase:
- Openbare winkel-URL en Fullmetrix-organisatie-ID of slug
- Versies van Sylius, Fullmetrix-plugin, PHP, Symfony en Doctrine
- Exacte fout, tijdstempel, tijdzone en implementatiecommit
- Uitvoer van
debug:router fullmetrix_admin_connection - Huidig statuslabel en geredigeerd bericht uit de recente activiteit
- Relevante statuscode van de proxy of webserver
Lees vóór verwijdering Verbinding verbreken en verwijderen.