Il plugin al quale questa guida fa riferimento è approvato e certificato da magnews.
Cosmobile è il partner certificato Adobe Commerce che ne ha seguito lo sviluppo, ne gestisce compatibilità e aggiornamenti.
Il plugin sviluppato da Cosmobile risponde a due necessità primarie di tutti gli E-commerce manager che hanno il proprio store su Magento / Adobe Commerce.
La prima problematica che risolve è quella di superare tutte le difficoltà di layout, aggiornamento, manutenzione e maggiore adesione alla brand identity delle principali comunicazioni transazionali che costituiscono una parte fondamentale dell'esperienza d'acquisto del cliente di ogni e-commerce.
Infatti, con questo plugin potrai utilizzare non solo tutta la potenza e la capacità di delivery delle email di magnews, ma anche tutta la flessibilità, facilità e autonomia nel gestire i template dei messaggi transazionali direttamente su magnews, sfruttando l'editor Giotto e i template Inspire.
La seconda funzionalità invece permette di inviare immediatamente a magnews tutti i contatti che si registrano ai form di subscription newsletter, per far partire immediatamente Welcome program e programmi di onboarding grazie allo strumento di Marketing Automation di magnews.
Compatibilità del plugin
La versione corrente del plugin è compatibile con:
- Magento Open Source 2.4.5
- Adobe Commerce 2.4.5
Procedura di installazione
Installazione del modulo tramite composer
Per installare il modulo tramite composer usare il comando:
composer config repositories.magnewsconnector vcs https://github.com/diennea/cosmobile-magnewsconnector
composer require cosmobile/magnewsconnector
Successivamente eseguire:
bin/magento setup:upgrade
bin/magento module:enable Cosmobile_MagnewsConnector
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
Per usare questa modalità devi avere un account su Github e richiedere preventivamente tramite l'Helpdesk l'accesso al repository privato del plugin.
Installazione del modulo in app/code
Copiare il contenuto del modulo in
app/code/Cosmobile/MagnewsConnector
Successivamente eseguire:
bin/magento setup:upgrade
bin/magento module:enable Cosmobile_MagnewsConnector
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
Configurazione permessi
Per la configurazione il modulo utilizza due permessi diversi:
- Configurazione del modulo per l’integrazione con Magnews;
Permessi richiesti:-
Stores → Settings → Configuration → Cosmobile MagnewsConnector
-
-
Associazione dei template di Magento da gestire con Magnews
Permessi richiesti:
-
Cosmobile MagnewsConnector
-
Configurazione per l’integrazione con Magnews
Per configurare l’integrazione occorre compilare i campi come indicato nella sezione:
Stores → Configuration → Cosmobile → Magnews Connector
A seguito la spiegazione delle diverse sezioni.
Magnews API Configuration
Contiene i parametri, recuperabili da magnews, per attivare l’integrazione tramite API da Magento.
Una volta configurati i parametri, prima di procedere col pulsante di autenticazione è importante ricordare di salvare la configurazione.
Alla pressione del pulsante verranno utilizzati i dati salvati per attivare l’integrazione tra Magento e Magnews.
La configurazione Enabled permette di abilitare/disattivare l’operatività dell’integrazione con Magnews e quindi del modulo.
Magnews general configuration
Tra le configurazioni generali è necessario indicare l'ID del database magnews sul quale insisteranno le attività sia di invio messaggi transazionali che di iscrizione dei contatti (se attive).
Magnews mail configuration
Attiva la funzionalità del plugin che permette l'invio delle e-mail transazionali associate e configurate nell'apposita sezione tramite magnews, bypassando l’invio standard di Magento.
Impostando questa configurazione a Yes, le email configurate saranno inviate tramite magnews; diversamente, questa feature del plugin rimane disattiva.
Magnews newsletter configuration
Permette di attivare la sincronizzazione degli iscritti alla newsletter di Magento verso magnews.
È possibile associare e sincronizzare verso Magnews eventuali attributi aggiuntivi degli iscritti alla Newsletter, presenti nella tabella standard di Magento (newsletter_subscriber), mediante il loro codice.
L’ID per ogni attributo aggiuntivo è recuperabile direttamente da magnews, nella sezione di gestione Campi contatti.
Associazione dei template di Magento da gestire con magnews
La sezione lato magento è raggiungibile da:
Marketing → Cosmobile Magnews Connector → Mail templates
La griglia permette velocemente di controllare i template delle mail transazionali di Magento associate all’integrazione con Magnews.
Se l’invio mail tramite Magnews è attivo, tutte le mail transazionali di Magento che utilizzano un template con un’associazione attiva verranno inviate tramite Magnews, attraverso il template definito in piattaforma Magnews.
La sezione permette di aggiungere nuovi template da associare, rimuovere associazioni o modificarne di già esistenti.
Ogni associazione è identificata da:
- il riferimento ad un template di Magento
- il riferimento ad un template di Magnews (indicato tramite nome o ID)
In caso vengano specificati entrambi, il nome ha priorità rispetto all’ID.
Ogni associazione può venire attivata o disattivata singolarmente.
Se un’associazione è disattivata, la rispettiva mail transazionale non verrà inviata tramite Magnews ma utilizzando il flusso standard di Magento.
Condizioni per l’invio della mail transazionale
- La configurazione Magnews API Configuration → Enabled deve essere a Yes
- La configurazione Magnews mail configuration → Send mails with magnews deve essere a Yes
- È stata creata l’associazione per il template della mail transazionale di Magento nella sezione Marketing → Cosmobile Magnews Connector → Mail templates
- L’associazione deve avere Status configurato come Enabled
- L’associazione non deve avere le configurazioni Magnews Mail template ID e Magnews Mail template Name entrambe vuote.
In caso di errore nell’invio della mail tramite Magnews, viene inviata la mail tramite il flusso standard di Magento.
In caso di uso di server SMTP esterni per l’invio delle mail
Per bypassare l’invio delle mail operato da Magento (in favore di quello di magnews), viene intercettato il flusso standard della piattaforma.
Nel caso siano presenti moduli esterni che interferiscono con questo flusso, ad esempio per consentire l’uso di un server SMTP esterno rispetto al server di Magento, potrebbe non essere garantito il normale invio delle mail.
I moduli di terze parti di cui è stata verificata la compatibilità sono:
- Mageplaza - Module SMTP: https://github.com/mageplaza/magento-2-smtp