Fehlerbehebung
Beheben Sie Probleme mit dem Sylius-Plugin, von einer fehlgeschlagenen Installation bis zu einem Import, der nicht abgeschlossen wird.
Beginnen Sie immer mit Prüfungen, die nichts verändern. Klicken Sie weder in Sylius noch in Fullmetrix auf Disconnect bzw. Trennen, um "von vorn anzufangen". In Sylius kappt das Trennen die Verbindung, und der Code lässt sich nicht wiederverwenden. In Fullmetrix löscht es die importierten Daten.
Mehrere Prüfungen auf dieser Seite betreffen den Projektcode. Geben Sie sie an Ihren Entwickler weiter, mit der Uhrzeit und der genauen Meldung des Problems.
Composer weigert sich, das Plugin zu installieren
Ihr Entwickler führt diesen Befehl aus, um herauszufinden, was die Installation blockiert.
composer why-not fullmetrix/sylius-plugin '*'Die üblichen Ursachen sind eine PHP-Version unter 8.1, eine fehlende cURL- oder JSON-Erweiterung oder eine Version von Sylius, Symfony oder Doctrine außerhalb der Liste unter Kompatibilität. Er löst die Abhängigkeiten auf seinem Rechner auf und deployt dann die entstandene Datei composer.lock. Den Ordner vendor/ von einem Rechner auf einen anderen zu kopieren, ist keine gute Idee, wenn die PHP-Versionen abweichen.
Symfony lädt das Plugin nicht
Wenn bin/console cache:clear fehlschlägt oder keine Fullmetrix-Route existiert, prüfen Sie, dass config/bundles.php diese Zeile enthält.
Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],Ihr Entwickler führt dann composer dump-autoload aus und leert den Cache mit derselben Umgebung wie die Live-Website. Bei mehreren Servern prüft er jeden einzelnen.
Die Fullmetrix-Seite erscheint nicht im Admin
- Öffnen Sie die Adresse
/admin/fullmetrixIhres Shops direkt mit einem Admin-Konto. Wenn die Seite erscheint, fehlt nur das Menü, oft wegen eines angepassten Admin-Menüs oder Themes. - Wenn die Adresse einen Fehler 404 zurückgibt, sind die Routen nicht importiert. Ihr Entwickler prüft die Datei
config/routes/fullmetrix.yamlund führt dannbin/console debug:router fullmetrix_admin_connectionaus, was die Route anzeigen muss. - Er leert den Cache, danach laden Sie die Seite neu.
Die Migration schlägt fehl
- Sichern Sie die Datenbank, bevor Sie es erneut versuchen.
- Ihr Entwickler prüft
bin/console doctrine:migrations:statusund den ersten angezeigten Fehler. - Er prüft, dass der Datenbankbenutzer Tabellen anlegen darf.
- Er legt die Tabellen nicht von Hand an und markiert die Migration nicht als ausgeführt, ohne den Fehler zu verstehen.
Fehlermeldungen bei der Verbindung
Wenn die Verbindung fehlschlägt, zeigt die Seite Connection failed gefolgt von einem Grund. Einige Gründe erscheinen auf Französisch. Sie sind unten so zitiert, wie sie angezeigt werden.
| Angezeigter Grund | Was er bedeutet | Was zu tun ist |
|---|---|---|
invalid_code_format | Der Code hat nicht die Form FMTX-XXXX-XXXX-XXXX | Kopieren Sie ihn erneut aus Fullmetrix. Er enthält nie die Buchstaben O und I oder die Ziffern 0 und 1. |
storage_failed | Das Plugin konnte seine Einstellungen nicht speichern | Wahrscheinlich wurde die Migration nicht ausgeführt. Ihr Entwickler führt bin/console doctrine:migrations:migrate aus. |
| Code de connexion introuvable | Dieser Code existiert in Fullmetrix nicht | Kopieren Sie den in Ihrer Organisation angezeigten Code erneut, ohne zusätzliche Zeichen |
| Plateforme incorrecte pour ce code | Der Code wurde für eine andere Plattform erstellt | Gehen Sie in Fullmetrix zurück zur Plattformauswahl, wählen Sie Sylius, kopieren Sie dann den angezeigten Code und versuchen Sie es erneut |
| Ce code est déjà associé à un autre site | Ein Shop hat diesen Code bereits akzeptiert | Siehe den nächsten Abschnitt |
| Trop de tentatives, réessayez dans quelques minutes. | Zu viele Versuche in kurzer Zeit | Warten Sie zehn Minuten, bevor Sie es erneut versuchen |
| Cette boutique est déjà connectée à une autre Organization. | Der Shop gehört bereits zu einer anderen Fullmetrix-Organisation | Verwenden Sie diese Organisation oder entfernen Sie den Shop zuerst daraus |
| Cette boutique a déjà bénéficié d'un essai Fullmetrix... | Die kostenlose Testphase wurde für diesen Shop bereits genutzt | Ein Abonnement ist erforderlich, siehe Abrechnung |
invalid_response, register_failed oder eine Netzwerkmeldung | Der Server konnte Fullmetrix nicht richtig erreichen | Ihr Entwickler prüft, dass PHP ausgehende HTTPS-Verbindungen zu fullmetrix.com öffnen kann (Firewall, Proxy, DNS, Zertifikate) |
Teilen Sie keinen aktiven Code
Der Code ist ein Geheimnis. Wenn Sie einen Screenshot der Fullmetrix-Seite in Sylius senden, verdecken Sie das Feld Connection code vollständig.
Der Code ist "bereits mit einer anderen Website verknüpft"
Ein Code funktioniert nur einmal. Diese Meldung, Ce code est déjà associé à un autre site, erscheint, wenn Sie es mit einem Code erneut versuchen, der bereits akzeptiert wurde, zum Beispiel nach einem Klick auf Disconnect in Sylius oder wenn eine andere Installation (etwa eine Staging-Website) ihn zuerst verwendet hat.
Wenn die Shop-Karte in Fullmetrix weiterhin funktioniert, ist nichts zu tun. Wenn Sie den Shop in Sylius getrennt haben und ihn erneut verbinden möchten, brauchen Sie einen neuen Code. Öffnen Sie Einstellungen und dann Integrationen, klicken Sie auf der Sylius-Karte auf Trennen, bestätigen Sie und fügen Sie den Shop dann erneut hinzu, um einen frischen Code zu erhalten. Dadurch werden die in Fullmetrix importierten Daten gelöscht und anschließend erneut aus Ihrem Shop importiert.
Verbunden, aber der Import wird nicht abgeschlossen
- Öffnen Sie in Sylius Marketing und dann Fullmetrix und sehen Sie sich das Feld Sync activity an. Notieren Sie, ob es Waiting for sync, Sync in progress oder Sync complete anzeigt.
- Lesen Sie das Feld Recent activity. Eine Zeile
sync_errorenthält die Ursache des Fehlers. Notieren Sie sie, bevor Sie auf Clear logs klicken. - Lesen Sie in Fullmetrix die Sylius-Karte unter Einstellungen und dann Integrationen. Die Meldung Die letzte Synchronisierung konnte Ihren Shop nicht erreichen bedeutet, dass Fullmetrix Ihre Website nicht aufrufen konnte.
- Ihr Entwickler prüft, dass die Adressen unter
/fullmetrix/api/durch den Proxy, den Cache und die Firewall gelangen. Wenn Sie Cloudflare nutzen, folgen Sie Cloudflare und Firewalls. - Er prüft die PHP- und Webserver-Logs zum Zeitpunkt des Problems und dass jeder Server dieselbe Plugin-Version ausführt.
Nach einem Fehler weichen die Schaltflächen Synchronisieren den Schaltflächen Fortsetzen und Zurücksetzen. Sobald die Ursache behoben ist, klicken Sie auf Fortsetzen, um dort weiterzumachen, wo der Import stehen geblieben ist. Wird Fortsetzen nicht angeboten, klicken Sie auf Zurücksetzen. Das setzt den Fortschritt auf null zurück und startet die Synchronisierung neu, ohne bereits importierte Bestellungen zu löschen. Die übrigen Zustände der Karte werden unter Sync-Status beschrieben.
Die Shop-Adresse ist in Fullmetrix falsch
Die Karte zeigt die Adresse, die das Plugin bei der Verbindung gesendet hat. Ist es eine interne Adresse, eine HTTP-Adresse oder eine andere Domain, wurde der Admin mit dieser Adresse geöffnet, oder Symfony vertraut dem Proxy vor der Website nicht. Ihr Entwickler korrigiert die Proxy-Konfiguration. Damit die richtige Adresse gespeichert wird, muss der Shop danach mit einem neuen Code erneut verbunden werden, wie oben erklärt.
Das Besucher-Tracking empfängt nichts
- Prüfen Sie, dass die Fullmetrix-Seite in Sylius weiterhin Connected anzeigt.
- Testen Sie auf einer öffentlichen Seite des Shops, nicht im Admin.
- Leeren Sie jeden Seiten-Cache vor der Website.
- Führen Sie Ihren Test nach dem Akzeptieren der Cookies durch, falls ein Einwilligungsbanner aktiv ist.
- Prüfen Sie die Zustellung unter Tracking-Skript.
Den Support kontaktieren
Wenn das Problem bestehen bleibt, kontaktieren Sie uns mit den folgenden Angaben.
- Die öffentliche Adresse des Shops und der Name Ihrer Fullmetrix-Organisation.
- Die Versionen von Sylius, Plugin, PHP, Symfony und Doctrine.
- Die genaue Meldung, die Uhrzeit ihres Erscheinens und die Zeitzone.
- Die Ausgabe von
bin/console debug:router fullmetrix_admin_connection. - Ein Screenshot der Felder Sync activity und Recent activity, mit verdecktem Code.
Senden Sie niemals ein Passwort, einen Verbindungscode oder einen Auszug Ihrer Produktionsdatenbank.
Kompatibilität
Prüfen Sie, ob Ihr Sylius-Projekt das Fullmetrix-Plugin aufnehmen kann und was Ihre Infrastruktur durchlassen muss.
Deinstallation
Beenden Sie die Synchronisierung Ihres Sylius-Shops, löschen Sie die Daten in Fullmetrix und entfernen Sie das Plugin aus dem Projekt, ohne etwas zu beschädigen.