Risoluzione dei problemi
Risolvi i problemi del plugin Sylius, da un'installazione fallita a un'importazione che non finisce.
Parti sempre da controlli che non cambiano nulla. Non cliccare su Disconnect in Sylius, né in Fullmetrix, per "ricominciare da capo". In Sylius, disconnettere taglia il legame e il codice non può essere riutilizzato. In Fullmetrix, elimina i dati importati.
Diversi controlli di questa pagina riguardano il codice del progetto. Passali al tuo sviluppatore, con l'ora e il messaggio esatto del problema.
Composer rifiuta di installare il plugin
Il tuo sviluppatore esegue questo comando per scoprire cosa lo blocca.
composer why-not fullmetrix/sylius-plugin '*'Le cause abituali sono una versione di PHP inferiore alla 8.1, un'estensione cURL o JSON mancante, o una versione di Sylius, Symfony o Doctrine fuori dall'elenco di Compatibilità. Risolvono le dipendenze sulla loro macchina, poi distribuiscono il file composer.lock risultante. Copiare la cartella vendor/ da una macchina all'altra è una cattiva idea se le versioni di PHP differiscono.
Symfony non carica il plugin
Se bin/console cache:clear fallisce o non esiste nessuna rotta Fullmetrix, controlla che config/bundles.php contenga questa riga.
Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],Il tuo sviluppatore esegue poi composer dump-autoload e svuota la cache con lo stesso ambiente del sito in produzione. Su più server, li controlla uno per uno.
La pagina Fullmetrix non compare nell'amministrazione
- Apri direttamente l'indirizzo
/admin/fullmetrixdel tuo negozio con un account amministratore. Se la pagina compare, manca solo il menu, spesso a causa di un menu di amministrazione o di un tema personalizzato. - Se l'indirizzo restituisce un errore 404, le rotte non sono importate. Il tuo sviluppatore controlla il file
config/routes/fullmetrix.yaml, poi eseguebin/console debug:router fullmetrix_admin_connection, che deve mostrare la rotta. - Svuota la cache, poi ricarica la pagina.
La migrazione fallisce
- Fai un backup del database prima di riprovare.
- Il tuo sviluppatore controlla
bin/console doctrine:migrations:statuse il primo errore mostrato. - Controlla che l'utente del database sia autorizzato a creare tabelle.
- Non crea le tabelle a mano e non segna la migrazione come eseguita senza aver capito l'errore.
Messaggi di errore di connessione
Quando la connessione fallisce, la pagina mostra Connection failed seguito da un motivo. Alcuni motivi tornano in francese. Sono citati qui sotto così come compaiono.
| Motivo mostrato | Cosa significa | Cosa fare |
|---|---|---|
invalid_code_format | Il codice non ha la forma FMTX-XXXX-XXXX-XXXX | Copialo di nuovo da Fullmetrix. Non contiene mai le lettere O e I né le cifre 0 e 1. |
storage_failed | Il plugin non è riuscito a salvare le sue impostazioni | Probabilmente la migrazione non è stata eseguita. Il tuo sviluppatore esegue bin/console doctrine:migrations:migrate. |
| Code de connexion introuvable | Questo codice non esiste in Fullmetrix | Copia di nuovo il codice mostrato nella tua organizzazione, senza caratteri in più |
| Plateforme incorrecte pour ce code | Il codice è stato creato per un'altra piattaforma | In Fullmetrix, torna alla scelta della piattaforma, scegli Sylius, poi copia il codice mostrato e riprova |
| Ce code est déjà associé à un autre site | Un negozio ha già accettato questo codice | Vedi la sezione successiva |
| Trop de tentatives, réessayez dans quelques minutes. | Troppi tentativi in poco tempo | Aspetta dieci minuti prima di riprovare |
| Cette boutique est déjà connectée à une autre Organization. | Il negozio appartiene già a un'altra organizzazione Fullmetrix | Usa quell'organizzazione, oppure rimuovi prima il negozio da essa |
| Cette boutique a déjà bénéficié d'un essai Fullmetrix... | La prova gratuita è già stata usata per questo negozio | Serve un abbonamento, vedi Fatturazione |
invalid_response, register_failed o un messaggio di rete | Il server non è riuscito a raggiungere correttamente Fullmetrix | Il tuo sviluppatore controlla che PHP possa aprire connessioni HTTPS in uscita verso fullmetrix.com (firewall, proxy, DNS, certificati) |
Non condividere un codice attivo
Il codice è un segreto. Se invii uno screenshot della pagina Fullmetrix in Sylius, nascondi completamente il campo Connection code.
Il codice è "già associato a un altro sito"
Un codice funziona una sola volta. Questo messaggio, Ce code est déjà associé à un autre site, compare quando riprovi con un codice già accettato, per esempio dopo aver cliccato su Disconnect in Sylius, o se un'altra installazione (un sito di staging, per esempio) lo ha usato per prima.
Se la scheda del negozio in Fullmetrix funziona ancora, non c'è nulla da fare. Se hai disconnesso il negozio in Sylius e vuoi riconnetterlo, ti serve un nuovo codice. Apri Impostazioni, poi Integrazioni, clicca su Disconnetti sulla scheda Sylius, conferma, poi aggiungi di nuovo il negozio per ottenere un codice nuovo. Questo cancella i dati importati in Fullmetrix, che vengono poi importati di nuovo dal tuo negozio.
Connesso, ma l'importazione non finisce
- In Sylius, apri Marketing, poi Fullmetrix, e guarda il riquadro Sync activity. Annota se mostra Waiting for sync, Sync in progress o Sync complete.
- Leggi il riquadro Recent activity. Una riga
sync_errorcontiene la causa dell'errore. Annotala prima di cliccare su Clear logs. - In Fullmetrix, leggi la scheda Sylius in Impostazioni, poi Integrazioni. Il messaggio L'ultima sincronizzazione non ha potuto raggiungere il tuo negozio significa che Fullmetrix non è riuscito a chiamare il tuo sito.
- Il tuo sviluppatore controlla che gli indirizzi
/fullmetrix/api/passino attraverso il proxy, la cache e il firewall. Se usi Cloudflare, segui Cloudflare e firewall. - Controlla i log di PHP e del server web all'ora del problema, e che ogni server esegua la stessa versione del plugin.
Dopo un errore, il pulsante Sincronizza lascia il posto a Riprendi e Reimposta. Una volta risolta la causa, clicca su Riprendi per continuare da dove si era fermata l'importazione. Se Riprendi non è proposto, clicca su Reimposta, che riporta l'avanzamento a zero e riavvia la sincronizzazione senza eliminare gli ordini già importati. Gli altri stati della scheda sono descritti in Stato della sincronizzazione.
L'indirizzo del negozio è sbagliato in Fullmetrix
La scheda mostra l'indirizzo che il plugin ha inviato quando ti sei connesso. Se è un indirizzo interno, un indirizzo HTTP o un altro dominio, l'amministrazione è stata aperta con quell'indirizzo, oppure Symfony non si fida del proxy davanti al sito. Il tuo sviluppatore corregge la configurazione del proxy. Per registrare l'indirizzo giusto, il negozio va poi riconnesso con un nuovo codice, come spiegato sopra.
Il tracciamento dei visitatori non riceve nulla
- Controlla che la pagina Fullmetrix in Sylius mostri ancora Connected.
- Fai il test su una pagina pubblica del negozio, non sull'amministrazione.
- Svuota eventuali cache di pagina davanti al sito.
- Fai il tuo test dopo aver accettato i cookie se è presente un banner di consenso.
- Controlla la ricezione in Script di tracciamento.
Contatta l'assistenza
Se il problema persiste, contattaci con quanto segue.
- L'indirizzo pubblico del negozio e il nome della tua organizzazione Fullmetrix.
- Le versioni di Sylius, del plugin, di PHP, Symfony e Doctrine.
- Il messaggio esatto, l'ora in cui è comparso e il fuso orario.
- L'output di
bin/console debug:router fullmetrix_admin_connection. - Uno screenshot dei riquadri Sync activity e Recent activity, con il codice nascosto.
Non inviare mai una password, un codice di connessione o un estratto del tuo database di produzione.