Probleemoplossing
Los problemen met de Sylius-plugin op, van een mislukte installatie tot een import die niet klaar komt.
Begin altijd met controles die niets veranderen. Klik niet op Disconnect in Sylius of op Ontkoppelen in Fullmetrix om "opnieuw te beginnen". In Sylius verbreekt ontkoppelen de link en kan de code niet opnieuw worden gebruikt. In Fullmetrix verwijdert het de geïmporteerde gegevens.
Verschillende controles op deze pagina betreffen de projectcode. Geef ze door aan je ontwikkelaar, met het tijdstip en de exacte melding van het probleem.
Composer weigert de plugin te installeren
Je ontwikkelaar voert dit commando uit om te achterhalen wat het blokkeert.
composer why-not fullmetrix/sylius-plugin '*'De gebruikelijke oorzaken zijn een PHP-versie lager dan 8.1, een ontbrekende cURL- of JSON-extensie, of een versie van Sylius, Symfony of Doctrine buiten de lijst in Compatibiliteit. Hij of zij lost de afhankelijkheden op zijn of haar eigen machine op en implementeert daarna het resulterende bestand composer.lock. De map vendor/ van de ene machine naar de andere kopiëren is een slecht idee als de PHP-versies verschillen.
Symfony laadt de plugin niet
Mislukt bin/console cache:clear of bestaat er geen enkele Fullmetrix-route, controleer dan of config/bundles.php deze regel bevat.
Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],Je ontwikkelaar voert daarna composer dump-autoload uit en maakt de cache leeg met dezelfde omgeving als de live site. Bij meerdere servers controleert hij of zij ze allemaal.
De Fullmetrix-pagina verschijnt niet in het beheer
- Open met een beheerdersaccount rechtstreeks het adres
/admin/fullmetrixvan je winkel. Verschijnt de pagina, dan ontbreekt alleen het menu, vaak door een aangepast beheermenu of thema. - Geeft het adres een 404-fout, dan zijn de routes niet geïmporteerd. Je ontwikkelaar controleert het bestand
config/routes/fullmetrix.yamlen voert daarnabin/console debug:router fullmetrix_admin_connectionuit, wat de route moet tonen. - Hij of zij maakt de cache leeg en daarna laad jij de pagina opnieuw.
De migratie mislukt
- Maak een back-up van de database voordat je het opnieuw probeert.
- Je ontwikkelaar controleert
bin/console doctrine:migrations:statusen de eerste getoonde fout. - Hij of zij controleert of de databasegebruiker tabellen mag aanmaken.
- Hij of zij maakt de tabellen niet met de hand aan en markeert de migratie niet als uitgevoerd zonder de fout te begrijpen.
Foutmeldingen bij het verbinden
Mislukt de verbinding, dan toont de pagina Connection failed gevolgd door een reden. Sommige redenen komen in het Frans terug. Ze worden hieronder geciteerd zoals ze verschijnen.
| Getoonde reden | Wat het betekent | Wat je doet |
|---|---|---|
invalid_code_format | De code heeft niet de vorm FMTX-XXXX-XXXX-XXXX | Kopieer hem opnieuw uit Fullmetrix. Hij bevat nooit de letters O en I of de cijfers 0 en 1. |
storage_failed | De plugin kon zijn instellingen niet opslaan | De migratie is waarschijnlijk niet uitgevoerd. Je ontwikkelaar voert bin/console doctrine:migrations:migrate uit. |
| Code de connexion introuvable | Deze code bestaat niet in Fullmetrix | Kopieer de code die in je organisatie wordt getoond opnieuw, zonder extra tekens |
| Plateforme incorrecte pour ce code | De code is aangemaakt voor een ander platform | Ga in Fullmetrix terug naar de platformkeuze, kies Sylius, kopieer de getoonde code en probeer opnieuw |
| Ce code est déjà associé à un autre site | Een winkel heeft deze code al geaccepteerd | Zie de volgende sectie |
| Trop de tentatives, réessayez dans quelques minutes. | Te veel pogingen in korte tijd | Wacht tien minuten voordat je het opnieuw probeert |
| Cette boutique est déjà connectée à une autre Organization. | De winkel hoort al bij een andere Fullmetrix-organisatie | Gebruik die organisatie, of verwijder de winkel er eerst uit |
| Cette boutique a déjà bénéficié d'un essai Fullmetrix... | De gratis proefperiode is voor deze winkel al gebruikt | Een abonnement is nodig, zie Facturering |
invalid_response, register_failed of een netwerkmelding | De server kon Fullmetrix niet goed bereiken | Je ontwikkelaar controleert of PHP uitgaande HTTPS-verbindingen naar fullmetrix.com kan openen (firewall, proxy, DNS, certificaten) |
Deel geen actieve code
De code is een geheim. Stuur je een screenshot van de Fullmetrix-pagina in Sylius, verberg dan het veld Connection code volledig.
De code is "already associated with another site"
Een code werkt maar één keer. Deze melding, Ce code est déjà associé à un autre site, verschijnt wanneer je het opnieuw probeert met een code die al is geaccepteerd, bijvoorbeeld nadat je in Sylius op Disconnect hebt geklikt, of als een andere installatie (bijvoorbeeld een stagingsite) hem eerst heeft gebruikt.
Werkt de winkelkaart in Fullmetrix nog, dan hoef je niets te doen. Heb je de winkel in Sylius losgekoppeld en wil je hem opnieuw verbinden, dan heb je een nieuwe code nodig. Open Instellingen en daarna Integraties, klik op de Sylius-kaart op Ontkoppelen, bevestig en voeg de winkel opnieuw toe om een verse code te krijgen. Hiermee worden de gegevens gewist die in Fullmetrix zijn geïmporteerd, die daarna opnieuw uit je winkel worden geïmporteerd.
Verbonden, maar de import komt niet klaar
- Open in Sylius Marketing en daarna Fullmetrix en kijk naar het vak Sync activity. Noteer of het Waiting for sync, Sync in progress of Sync complete toont.
- Lees het vak Recent activity. Een regel
sync_errorbevat de oorzaak van de fout. Noteer die voordat je op Clear logs klikt. - Lees in Fullmetrix de Sylius-kaart bij Instellingen en daarna Integraties. De melding De laatste synchronisatie kon uw winkel niet bereiken betekent dat Fullmetrix je site niet kon aanroepen.
- Je ontwikkelaar controleert of de adressen
/fullmetrix/api/door de proxy, de cache en de firewall komen. Gebruik je Cloudflare, volg dan Cloudflare en firewalls. - Hij of zij controleert de logs van PHP en de webserver rond het tijdstip van het probleem, en of elke server dezelfde pluginversie draait.
Na een fout maakt de knop Synchroniseren plaats voor Hervatten en Resetten. Klik na het oplossen van de oorzaak op Hervatten om verder te gaan waar de import stopte. Wordt Hervatten niet aangeboden, klik dan op Resetten. Die zet de voortgang terug naar nul en start de synchronisatie opnieuw, zonder bestellingen die al zijn geïmporteerd te wissen. De andere statussen van de kaart worden beschreven in Synchronisatiestatus.
Het winkeladres is onjuist in Fullmetrix
De kaart toont het adres dat de plugin heeft gestuurd toen je verbond. Is het een intern adres, een HTTP-adres of een ander domein, dan is het beheer met dat adres geopend, of vertrouwt Symfony de proxy vóór de site niet. Je ontwikkelaar herstelt de proxyconfiguratie. Om het juiste adres vast te leggen moet de winkel daarna met een nieuwe code opnieuw worden verbonden, zoals hierboven uitgelegd.
De bezoekerstracking ontvangt niets
- Controleer of de Fullmetrix-pagina in Sylius nog Connected toont.
- Test op een openbare pagina van de winkel, niet in het beheer.
- Leeg elke paginacache vóór de site.
- Voer je test uit nadat je cookies hebt geaccepteerd als er een toestemmingsbanner is.
- Controleer de aflevering in Trackingscript.
Contact opnemen met support
Blijft het probleem, neem dan contact met ons op met het volgende.
- Het openbare adres van de winkel en de naam van je Fullmetrix-organisatie.
- De versies van Sylius, de plugin, PHP, Symfony en Doctrine.
- De exacte melding, het tijdstip waarop die verscheen en de tijdzone.
- De uitvoer van
bin/console debug:router fullmetrix_admin_connection. - Een screenshot van de vakken Sync activity en Recent activity, met de code verborgen.
Stuur nooit een wachtwoord, een verbindingscode of een uittreksel van je productiedatabase.