Premessa
Questa guida ti accompagnerà passo dopo passo nell'installazione e nella configurazione della nostra soluzione di traduzione.
Il team tecnico Reversia si occupa dell'intero setup tecnico.
Lavoriamo in collaborazione con te, la tua agenzia o i tuoi sviluppatori a seconda delle esigenze del progetto. Non esitare a contattarci in qualsiasi momento: siamo qui per garantire un'integrazione fluida e senza intoppi.
Compatibilità tecnica
Reversia è compatibile con PrestaShop a partire dalla versione 1.7.6 fino all'ultima versione disponibile.
La nostra soluzione funziona sia in modalità multilingua che in modalità multinegozio, offrendoti così la massima flessibilità per la tua strategia internazionale.
Whitelisting del nostro IP (IMPORTANTE ⚠️)
Per tutta la durata del progetto, devi assolutamente inserire in whitelist il nostro indirizzo IP fisso.
Ti preghiamo di richiederlo al tuo gestore di sistema o alla persona che amministra il tuo server.
Ecco il nostro IP fisso: 34.140.252.103
Questo IP deve essere autorizzato su tutte le tue protezioni:
- File .htpasswd (protezione tramite password)
- Cloudflare o qualsiasi altro firewall/CDN
- Modalità manutenzione PrestaShop
- Web Application Firewall (WAF)
- Qualsiasi altra restrizione di accesso al back-office o all'API
Senza questa autorizzazione, Reversia non potrà comunicare con il tuo negozio.
Passaggio 1: Esportazione dei moduli front-office
Per iniziare, abbiamo bisogno di recuperare l'elenco dei moduli visualizzati nel front-office (visibili ai tuoi clienti finali). I moduli del back-office non devono essere tradotti.
Procedura:
- Accedi al tuo back-office PrestaShop
- Vai su Personalizza > Moduli > Gestione moduli
- Se il modulo Reversia non è ancora installato, clicca su « Installa il modulo »
- Una volta installato, clicca sul pulsante « Configura » del modulo Reversia
- Clicca sul pulsante « Esporta i moduli »
- Seleziona solo i moduli front-office che saranno visibili ai tuoi clienti finali. Non preoccuparti se dimentichi alcuni moduli, potremo integrarli in seguito
- Clicca su « Esporta i moduli selezionati »
- Invia il file di esportazione al team Reversia
Passaggio 2: Integrazione tecnica da parte di Reversia
Il nostro team tecnico procederà ora a integrare i tuoi moduli alla piattaforma Reversia. Questo passaggio è interamente a nostro carico.
La forza di Reversia
Riceviamo regolarmente moduli che non seguono gli standard di traduzione di PrestaShop.
È del resto il caso per la grande maggioranza dei moduli sul mercato.
La nostra competenza consiste proprio nel rendere questi moduli perfettamente compatibili con la traduzione, qualunque sia la loro provenienza:
- Marketplace Addons di PrestaShop
- Moduli sviluppati da agenzie
- Moduli di sviluppatori indipendenti
Reversia si occupa di tutta questa integrazione tecnica. Se necessario, contattiamo la tua agenzia, i tuoi sviluppatori o direttamente il tuo team per ottenere informazioni aggiuntive.
Non devi compiere alcuna azione durante questo passaggio.
Passaggio 3: Fase di test in preproduzione
Promemoria importante: Whitelisting IP ⚠️
Prima di iniziare i test, verifica che il nostro IP 34.140.252.103 sia correttamente inserito in whitelist su tutte le tue protezioni (htpasswd, Cloudflare, modalità manutenzione PrestaShop, WAF ecc.). Senza questa autorizzazione, i test non potranno funzionare.
Obiettivo dei test
In questo passaggio, verifichiamo che Reversia sia in grado di:
- ✅ Recuperare i contenuti del tuo negozio
- ✅ Tradurli con qualità
- ✅ Inserire le traduzioni correttamente
I test riguardano un campione rappresentativo di contenuti: prodotti, categorie e traduzioni di moduli.
Una volta validati tutti i test, passiamo alla messa in produzione.
Passaggio 4: Messa in produzione
Importante: Nessun nuovo onboarding!
Non hai bisogno di rifare un onboarding completo. Segui scrupolosamente le indicazioni qui sotto per modificare semplicemente i parametri di configurazione del modulo dalla preproduzione alla produzione.
Procedura:
- Installa il modulo Reversia sul tuo ambiente di produzione. Vai su Personalizza > Moduli > Gestione moduli
- Installa il modulo Reversia se non è già fatto
- Clicca sul pulsante « Configura »
- Configura la connessione con il tuo progetto Reversia. Clicca sul pulsante « Debug » (in alto a destra)
- Clicca sul pulsante « Impostazioni » (in alto a destra)
- Devi ora inserire la chiave API del tuo progetto Reversia
- Recupera la tua chiave API Reversia. Accedi al tuo back-office Reversia
- Vai su Impostazioni > Generale
- Seleziona la scheda « Comunicazione e sicurezza »
- Copia la Chiave API (⚠️ attenzione a non confonderla con il cookie sicuro)
- Finalizza la configurazione. Incolla la chiave API nel campo previsto nel tuo modulo PrestaShop
- Salva
È fatta! La configurazione della produzione è ora operativa.
Passaggio 5: Avvio della traduzione completa
Reversia è ormai configurato e può tradurre e poi inserire automaticamente tutti i contenuti del tuo negozio PrestaShop nelle lingue desiderate.
Per il futuro
- Nuovi moduli front-office? Se installi nuovi moduli visibili ai tuoi clienti, esportali tramite la procedura descritta nel Passaggio 1 e inviaceli.
- Whitelisting permanente: Ricordati di mantenere il whitelisting del nostro IP 34.140.252.103 su tutte le tue protezioni (modalità manutenzione, Cloudflare, htpasswd, ecc.) per garantire il corretto funzionamento continuo di Reversia.
Supporto
Il team Reversia resta a tua disposizione durante tutto il processo e oltre. Non esitare a contattarci se hai qualsiasi domanda o necessità di assistenza.
Benvenuto nell'avventura internazionale con Reversia! 🌍