fullmetrixDocs

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:flush

Ecco cosa fa ogni riga.

ComandoCosa fa
composer require fullmetrix/magento-connector:^1.1Scarica l'ultima versione 1.x del modulo nel progetto e la aggiunge a composer.json e composer.lock
bin/magento module:enable Fullmetrix_ConnectorAttiva il modulo in Magento
bin/magento setup:upgradeRegistra il modulo e crea la sua tabella di coda nel database
bin/magento setup:di:compileRigenera il codice compilato di Magento. Necessario quando il negozio funziona in modalità produzione.
bin/magento cache:flushSvuota 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_Connector

La 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=fullmetrix

Installa 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.

Menu Marketing dell'amministrazione di Magento aperto con la voce Fullmetrix evidenziata

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.

Pagina Fullmetrix dell'amministrazione di Magento con l'elenco Store view, il campo Connection code compilato e il pulsante Connect evidenziato

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.

Pagina Fullmetrix dell'amministrazione di Magento con il badge Connected, la store view connessa e il riquadro Sync activity

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=1

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 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

  1. In Fullmetrix, apri Impostazioni, poi Integrazioni. La scheda Magento mostra l'indirizzo del negozio, un punto verde e la riga Ultima sincronizzazione.
  2. Fai un ordine di prova o modifica un prodotto, poi aspetta due o tre minuti. La modifica compare in Fullmetrix grazie al cron.
  3. 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:flush

La connessione viene mantenuta durante un aggiornamento. Non c'è nessun codice da inserire di nuovo.

In questa pagina