Installazione
Connetti il tuo negozio Sylius a Fullmetrix passo dopo passo, dall'ottenimento del codice alla conferma della connessione, con cosa fa ogni comando.
Questa pagina segue l'ordine reale della connessione. Le parti indicate per il tuo sviluppatore possono essergli inoltrate così come sono. Aggiungere il plugin richiede qualche minuto, più il tempo del tuo consueto processo di distribuzione. L'importazione dello storico dipende poi dal volume del tuo negozio.
Tieni pronte due cose
Il nome della persona che sviluppa il tuo progetto Sylius (sviluppatore o agenzia), e un account amministratore di Sylius. Controlla anche la compatibilità del tuo negozio.
Ottieni il tuo codice di connessione
Il codice di connessione collega il tuo negozio alla tua organizzazione Fullmetrix. Assomiglia a FMTX-7K4M-Q2HD-9WXR. Funziona una sola volta. Non appena un negozio lo ha accettato, non può essere usato altrove.
Durante la procedura guidata
Crea l'organizzazione e imposta le basi
Nella schermata Benvenuto su Fullmetrix, inserisci un nome in Nome del tuo negozio, poi clicca su Crea e continua. Nella schermata Impostazioni di base, scegli il tuo Fuso orario e la tua Valuta, poi clicca su Salva e continua, oppure su Salta questo passaggio per farlo più tardi in Generale.
Scegli Sylius
Nella schermata Connetti il tuo negozio, clicca sulla riga Sylius, indicata come Sylius 1.13+ / 2.0. Fullmetrix mostra Generazione del codice di connessione... per un secondo.

Copia il comando e il codice
La schermata mostra due riquadri numerati.
- Installa l'estensione contiene il comando Composer. Il pulsante a destra lo copia e mostra Comando copiato.
- Collega il tuo negozio contiene il tuo codice di connessione. Un clic lo copia e mostra copiato.
Sotto questi riquadri, il pannello In attesa della connessione del plugin ti chiede di lasciare la pagina aperta. Si aggiorna da solo non appena il tuo negozio accetta il codice.
Puoi chiudere la pagina e tornare più tardi. Quando accedi di nuovo a Fullmetrix, la procedura guidata riprende dallo stesso punto con lo stesso codice. Il link Cambia piattaforma ti riporta all'elenco se hai scelto la piattaforma sbagliata.
Dalle Impostazioni
Se hai già completato la procedura guidata, o stai aggiungendo un negozio, apri Impostazioni, poi la scheda Integrazioni. Nella categoria Commercio elettronico, clicca su Connetti nella scheda Negozio e-commerce, oppure sul riquadro Aggiungi un negozio se un negozio è già connesso. Nella finestra Connetti una piattaforma, scegli Sylius.
La finestra mostra il Codice di connessione con un pulsante di copia, il comando di installazione e un link Invia le istruzioni al mio sviluppatore.
Affida l'installazione al tuo sviluppatore
Invia le istruzioni per email
Nella finestra Connetti una piattaforma, clicca su Invia le istruzioni al mio sviluppatore. Inserisci il suo indirizzo in Email dello sviluppatore, poi clicca su Invia istruzioni. Il messaggio Istruzioni inviate a seguito dall'indirizzo conferma l'invio.
Il tuo sviluppatore riceve un'email con i passaggi di installazione, il tuo codice di connessione e il percorso del menu Fullmetrix in Sylius. Questo link non è proposto nella procedura guidata. Durante la procedura guidata, copia il comando e il codice, poi inviali tu stesso con un link a questa pagina.
Il codice è riservato
Chiunque abbia il tuo codice può connettere un negozio ad esso. Invialo solo alla persona che installa il plugin, e non metterlo mai nel repository del codice, in un ticket pubblico o in uno screenshot condiviso.
Aggiungi il plugin al progetto (per il tuo sviluppatore)
Il plugin è il pacchetto Composer fullmetrix/sylius-plugin. Viene aggiunto come bundle Symfony. Installalo nel tuo ambiente di sviluppo, controllalo, poi distribuisci con il tuo consueto processo. Fai un backup del database prima di eseguire la migrazione in produzione.
Installa il pacchetto
Dalla radice del progetto, esegui il comando seguente.
composer require fullmetrix/sylius-pluginScarica il plugin e lo aggiunge a composer.json e composer.lock.
Registra il bundle
Controlla che config/bundles.php contenga questa riga, e aggiungila se Composer non l'ha fatto.
Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],Indica a Symfony di caricare il plugin in ogni ambiente. Il plugin porta con sé la propria configurazione, quindi non c'è nessun file di configurazione da aggiungere.
Importa le rotte
Crea il file config/routes/fullmetrix.yaml con questo contenuto.
fullmetrix:
resource: '@FullmetrixPlugin/Resources/config/routing.yaml'Queste rotte aprono la pagina Fullmetrix dell'amministrazione, gli indirizzi /fullmetrix/api/ che Fullmetrix chiama per leggere il negozio e il link che permette a un cliente di riprendere un carrello abbandonato.
Crea le tabelle del plugin
bin/console doctrine:migrations:migrateLa migrazione crea due piccole tabelle, una per le impostazioni di connessione e una per il registro delle attività mostrato nell'amministrazione. Non tocca nessuna tabella di Sylius.
Svuota la cache
bin/console cache:clearSvuota la cache con lo stesso ambiente del sito in produzione, di solito APP_ENV=prod. Un comando che termina senza errori conferma che Symfony carica il plugin.
Il plugin non richiede nessuna attività pianificata. Invia le modifiche a Fullmetrix subito dopo che ogni risposta è stata inviata al visitatore.
Se il sito gira su più server, distribuisci la stessa versione ovunque, esegui la migrazione una sola volta e svuota la cache su ogni server.
Incolla il codice in Sylius
Questa parte avviene nell'amministrazione di Sylius. Puoi farla tu stesso una volta distribuito il plugin. La pagina Fullmetrix nell'amministrazione è in inglese, qualunque sia la lingua della tua amministrazione.
Apri la pagina Fullmetrix
Apri l'amministrazione di Sylius con l'indirizzo HTTPS pubblico del tuo negozio, quello che usano i tuoi clienti. Il plugin registra questo indirizzo quando ti connetti. Nel menu a sinistra, clicca su Marketing, poi su Fullmetrix. A seconda della tua versione di Sylius, la voce può comparire anche direttamente nel menu principale. Porta sempre all'indirizzo /admin/fullmetrix.
Incolla il codice e connetti
La pagina riepiloga i tre passaggi di connessione. Incolla il tuo codice in Connection code, poi clicca su Connect. Maiuscole, minuscole e spazi attorno al codice non contano.

Leggi la conferma
La pagina si ricarica con un badge Connected, il codice in sola lettura e un pulsante Disconnect. Sotto compaiono due riquadri, Sync activity per l'importazione e Recent activity per il registro.
Se invece compare un banner rosso Connection failed, il motivo segue subito dopo. I motivi possibili sono spiegati in Risoluzione dei problemi.
Segui l'importazione
Torna su Fullmetrix. Durante la procedura guidata, il pannello passa a Plug-in collegato e la schermata prosegue da sola verso Preparazione del tuo spazio. Una barra di avanzamento segue l'importazione di ordini, prodotti, clienti e storico dei ricavi. Il pulsante Vai comunque alla dashboard ti fa entrare nell'app senza aspettare, mentre l'importazione continua in background.
Dalle Impostazioni, la finestra si chiude con il messaggio Importazione avviata e la scheda Sylius mostra Importazione in corso con una percentuale.
Lato Sylius, il riquadro Sync activity mostra Waiting for sync, poi Sync in progress, poi Sync complete con il numero di elementi importati per tipo. Il riquadro Recent activity elenca gli ultimi 30 eventi, con la data (When), il tipo (Type), il messaggio (Message) e il numero di elementi (Count). Il pulsante Clear logs svuota questo registro senza toccare la connessione.
Controlla che tutto funzioni
- In Fullmetrix, apri Impostazioni, poi Integrazioni. La scheda Sylius mostra l'indirizzo del negozio, un punto verde e la riga Ultima sincronizzazione.
- Fai un ordine di prova o modifica un prodotto. La modifica compare in Fullmetrix pochi istanti dopo.
- Apri il tuo negozio, naviga qualche pagina, poi controlla la ricezione degli eventi in Script di tracciamento.
Aggiorna il plugin
Quando esce una nuova versione, il tuo sviluppatore la scarica con Composer, esegue le eventuali nuove migrazioni, svuota la cache e distribuisce.
composer update fullmetrix/sylius-plugin
bin/console doctrine:migrations:migrate
bin/console cache:clearLa connessione viene mantenuta durante un aggiornamento. Non c'è nessun codice da inserire di nuovo.