Scarica manuale - API

Plugin di integrazione con OsCommerce
Requisiti:
OsCommerce
Un account 4Dem.it
Accesso ftp all'host su cui risiede OsCommerce
4Dem.it - Plugin di integrazione con OSCOMMERCE
DESCRIZIONE
Il modulo di integrazione OsCommerce – 4Dem.it permette di sincronizzare in maniera automatizzata gli utenti di OsCommerce con una lista iscritti sulla console di email marketing 4Dem.it.
Quando viene attivato creato un nuovo utente su un E-Shop gestito con OsCommerce il suo indirizzo email ed i dati accessori del suo indirizzo (se configurati) verranno importati automaticamente dentro una lista a scelta sulla console di email marketing. Sempre in modalità del tutto
automatica, qualora un utente aggiorni il proprio indirizzo predefinito o i propri dati, questi verranno aggiornati anche sulla console 4Dem.it.
E’ inoltre possibile effettuare una sincronizzazione manuale di tutti gli utenti presenti nella piattaforma OsCommerce all’interno della lista scelta direttamente dal pannello di configurazione
dell’estensione.
2
4Dem.it - Plugin di integrazione con OSCOMMERCE
FUNZIONALITA'
• Sincronia automatica degli utenti OsCommerce con una lista iscritti sulla console 4Dem.it
• Sincronia manuale degli utenti OsCommerce con una lista iscritti sulla console 4Dem.it
• Mappatura e sincronia dei campi disponibili nell'indirizzo di default dell'utente OsCommerce
con i campi personalizzati impostati sulla console 4Dem.it
3
4Dem.it - Plugin di integrazione con OSCOMMERCE
INSTALLAZIONE
Accedere tramite il proprio client Ftp all'hosting sul quale risiede l'installazione di OsCommerce.
In base al proprio sistema scegliere ed eseguire il metodo di installazione corretto:
•
Metodo A: installazione di una nuova istanza di OsCommerce priva di moduli aggiuntivi o
personalizzazioni
•
Metodo B: installazione di OsCommerce con personalizzazioni e moduli aggiuntivi oppure
installazione del modulo 4Dem all’interno di una istanza di OsCommerce già configurata e
personalizzata
Metodo A
•
Collegarsi al server ftp e sfogliare le cartelle sino ad individuare la cartella “catalog”
posizionata all’interno della cartella di installazione di OsCommerce
•
Estrarre in una cartella locale il contenuto del file compresso (zip) di installazione
•
Copiare all’interno della cartella “catalog” del server il contenuto della cartella “catalog”
che avete appena estratto dal file compresso
Metodo B
•
Collegarsi al server ftp e sfogliare le cartelle sino ad individuare la cartella “catalog”
posizionata all’interno della cartella di installazione di OsCommerce
•
Estrarre in una cartella locale il contenuto del file compresso (.zip) di installazione
•
Accedere alla cartella sul server CATALOG\ADMIN\INCLUDES\FUNCTIONS e copiare in
locale il file general.php presente sul server
•
Integrare all’interno del file general.php che avete appena copiato il locale il contenuto
del file general.php che trovate nella cartella catalog\admin\includes\functions e che avete
precedentemente estratto dal file compresso di installazione.
Le righe da aggiungere sono quelle comprese tra i tag commento
//START 4DEM INSERTION ed //END 4DEM INTERTION presenti alla file del file
•
Sovrascrivere il file general.php presente sul server ftp con quello risultante
dall’integrazione/modifica precedente
•
Caricare il contenuto della la cartella locale “catalog\admin\includes” all’interno della
cartella sul server “catalog\admin\includes” sovrascrivendo eventuali files già presenti
•
Caricare il file ht_fourdem.php dalla cartella locale “catalog\admin” all’interno della cartella
sul server “catalog\admin”
•
Caricare il contenuto della cartella “catalog\includes” dalla cartella locale all’interno della
cartella sul server “catalog\includes”
4
4Dem.it - Plugin di integrazione con OSCOMMERCE
Attivazione del modulo
Per attivare il modulo 4Dem accedere alla pagina di amministrazione di OsCommerce quindi:
-
Selezionare Modules->Header Tags dal menu di sinistra (punto 1)
-
Cliccare sul pulsante Install Modules (punto 2)
Verrà presentato un elenco di moduli da installare, selezionare 4Dem e cliccare su Install Plugin: a
questo punto il modulo 4Dem sarà visibile nell’elenco degli Header Tags di OsCommerce
5
4Dem.it - Plugin di integrazione con OSCOMMERCE
CONFIGURAZIONE
Per configurare il modulo accedere alla sezione Modules->Header Tags, selezionare il modulo
4Dem e cliccare su Edit
6
4Dem.it - Plugin di integrazione con OSCOMMERCE
A questo punto sarà possibile modificare il valore dei campi di configurazione del modulo 4Dem
inserendo tutte le informazioni necessarie alla connessione con la console, ovvero:
ABILITARE LA SINCRONIZZAZIONE AUTOMATICA DEI DATI: se abilitate questa funzione i dati
degli utenti verranno importati automaticamente ad ogni nuova registrazione. In caso contrario
sarà necessario eseguire periodicamente delle sincronizzazioni manuali al fine di mantenere
allineate le basi dati.
INSERIMENTTO DELLE INFORMAZIONI DI CONNESSIONE E SELEZIONE DELLA LISTA DI
DESTINAZIONE SULLA CONSOLE (username, password ed URL)
7
4Dem.it - Plugin di integrazione con OSCOMMERCE
ABILTIARE I CAMPI PERSONALIZZATI ED IMPOSTARE IL MATCH TRA I CAMPI DI
OSCOMMERCE E QUELLI CREATI SULLA CONSOLE: questo permetterà al modulo di importare
non soltanto l’indirizzo email degli utenti ma anche altre informazioni utili a fini statistici o di
ricerca/filtro
ABILTIARE I CAMPI PERSONALIZZATI ED IMPOSTARE IL MATCH TRA I CAMPI DI
EFFFETTUARE LA SINCRONIA MANUALE DEI DATI PREMENDO IL PULSANTE “SYNCH DATA
NOW”: in questo modo tutti gli utenti presenti nel repository di OsCommerce verranno importati
nella console.
8
www.4dem.it