Installazione
Connetti il tuo negozio Magento 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. Calcola qualche minuto per l'installazione sul server, poi un tempo di importazione che dipende dal volume del tuo negozio.
Tieni pronte due cose
Il nome della persona che può installare un modulo sul tuo server Magento (sviluppatore, agenzia o fornitore di hosting), e l'accesso all'amministrazione di Magento con il menu Marketing. 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 Magento
Nella schermata Connetti il tuo negozio, clicca sulla riga Magento, indicata come Magento 2.4.4+ / AdobeCommerce. 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 di installazione. 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 Magento.
La finestra mostra il Codice di connessione con un pulsante di copia, il comando di installazione, un link Scarica il plugin 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 comandi da eseguire, il tuo codice di connessione e il percorso del menu Fullmetrix in Magento. Questo link non è proposto nella procedura guidata. Durante la procedura guidata, copia il comando e il codice, poi inviali tu stesso.
Il codice è riservato
Chiunque abbia il tuo codice può connettere un negozio ad esso. Invialo solo alla persona che installa il modulo e non pubblicarlo in un ticket pubblico né in uno screenshot condiviso.
Cosa puoi dirgli
Il modulo è un pacchetto Composer pubblico chiamato fullmetrix/magento-connector. Si installa come qualsiasi modulo Magento 2, con il normale processo di distribuzione del negozio. Aggiunge il menu Marketing, poi Fullmetrix all'amministrazione e richiede il cron di Magento.
Installa il modulo (per il tuo sviluppatore)
Esegui ogni comando dalla cartella radice del progetto Magento, con l'utente di sistema che di solito esegue Composer e bin/magento. Tieni un backup recente e la tua consueta finestra di rilascio.
composer require fullmetrix/magento-connector:^1.1
bin/magento module:enable Fullmetrix_Connector
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flushEcco cosa fa ogni riga.
| Comando | Cosa fa |
|---|---|
composer require fullmetrix/magento-connector:^1.1 | Scarica l'ultima versione 1.x del modulo nel progetto e la aggiunge a composer.json e composer.lock |
bin/magento module:enable Fullmetrix_Connector | Attiva il modulo in Magento |
bin/magento setup:upgrade | Registra il modulo e crea la sua tabella di coda nel database |
bin/magento setup:di:compile | Rigenera il codice compilato di Magento. Necessario quando il negozio funziona in modalità produzione. |
bin/magento cache:flush | Svuota la cache perché il menu Fullmetrix compaia nell'amministrazione |
Non saltare la compilazione in modalità produzione
Su un negozio in modalità produzione, dimenticare setup:di:compile dopo aver installato o aggiornato il modulo causa errori, anche al checkout. Se il tuo processo di distribuzione distribuisce anche i file statici, seguilo come al solito.
Per controllare che il modulo sia attivato, il tuo sviluppatore esegue questo comando.
bin/magento module:status Fullmetrix_ConnectorLa risposta deve indicare che il modulo è attivato.
Controlla il cron
Il modulo invia le modifiche a Fullmetrix ogni minuto tramite il cron di Magento, in un gruppo di job separato chiamato fullmetrix. Il cron di Magento deve quindi essere installato e in esecuzione. Se il tuo crontab esegue esplicitamente solo alcuni gruppi di job, aggiungi questo all'elenco.
bin/magento cron:run --group=fullmetrixInstalla dal file zip
Se Composer non può essere usato sul server, il link Scarica il plugin nella finestra Connetti una piattaforma fornisce il modulo come archivio zip. Estrai il suo contenuto in app/code/Fullmetrix/Connector, poi esegui gli stessi comandi a partire da module:enable. Gli aggiornamenti saranno allora manuali, sostituendo quella cartella.
Incolla il codice in Magento
Questa parte avviene nell'amministrazione di Magento. Puoi farla tu stesso una volta installato il modulo.
Apri la pagina Fullmetrix
Nel menu a sinistra dell'amministrazione, clicca su Marketing, poi su Fullmetrix. Se la voce non compare, esci dall'amministrazione e rientra. Se manca ancora, vedi Risoluzione dei problemi.

Scegli la store view
La pagina riepiloga i tre passaggi di connessione. Nell'elenco Store view, scegli la vista da connettere. Ogni riga mostra il sito web poi la vista, per esempio Main Website / Default Store View. Vengono proposte solo le viste attive.
La vista che scegli conta, perché vengono importati solo gli ordini effettuati su quella vista. Determina anche l'indirizzo del negozio, la valuta e la lingua inviati a Fullmetrix. Se hai dubbi, leggi la sezione sulla store view di Compatibilità.
Incolla il codice e connetti
Incolla il tuo codice in Connection code, poi clicca su Connect. Maiuscole, minuscole e spazi attorno al codice non contano.

Leggi la conferma
Magento mostra il messaggio di successo Store connected to Fullmetrix. The first sync starts automatically. La pagina mostra ora un badge Connected, il codice in sola lettura, la riga Store view con il nome della vista e un link Open the Fullmetrix dashboard.
Se invece compare un messaggio rosso che inizia con Échec de la connexion (connessione non riuscita), il motivo segue subito dopo. I motivi possibili sono spiegati in Risoluzione dei problemi.

Connetti da riga di comando
Il tuo sviluppatore può fare questo passaggio anche sul server. L'opzione --store-id indica il numero della store view. Senza, viene usata la vista predefinita.
bin/magento fullmetrix:connect FMTX-XXXX-XXXX-XXXX --store-id=1Segui 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 Magento mostra Importazione in corso con una percentuale.
Lato Magento, il riquadro Sync activity segue la stessa importazione. Mostra Waiting for sync, poi Sync in progress, poi Sync complete con il numero di elementi importati per tipo.
Controlla che tutto funzioni
- In Fullmetrix, apri Impostazioni, poi Integrazioni. La scheda Magento mostra l'indirizzo del negozio, un punto verde e la riga Ultima sincronizzazione.
- Fai un ordine di prova o modifica un prodotto, poi aspetta due o tre minuti. La modifica compare in Fullmetrix grazie al cron.
- Apri il tuo negozio, naviga qualche pagina, poi controlla la ricezione degli eventi in Script di tracciamento.
Se i dati non si muovono, parti dal cron, come spiegato in Risoluzione dei problemi.
Aggiorna il modulo
Quando esce una nuova versione, il tuo sviluppatore la scarica con Composer ed esegue di nuovo gli stessi passaggi di distribuzione.
composer update fullmetrix/magento-connector
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flushLa connessione viene mantenuta durante un aggiornamento. Non c'è nessun codice da inserire di nuovo.