Reversia: Guida all'installazione su PrestaShop
Integrazione nativa con PrestaShop
Sta per tradurre il Suo negozio PrestaShop con Reversia?
Allora segua questa guida che La aiuterà a installare la soluzione
Introduzione
Questa guida La accompagnerà passo dopo passo nell’installazione e configurazione della nostra soluzione di traduzione.
Il team tecnico di Reversia si occupa dell’intero setup tecnico.
Lavoriamo in collaborazione con Lei, la Sua agenzia o i Suoi sviluppatori a seconda delle esigenze del progetto. Non esiti a contattarci in qualsiasi momento: siamo qui per garantire un’integrazione fluida e senza problemi.
Compatibilità tecnica
Reversia è compatibile con PrestaShop dalla versione 1.7.6 fino all’ultima versione disponibile.
La nostra soluzione funziona sia in modalità multilingua che in modalità multinegozio, offrendole così la massima flessibilità per la Sua strategia internazionale.
Whitelisting del nostro IP (IMPORTANTE ⚠️)
Per tutta la durata del progetto, deve assolutamente inserire nella whitelist il nostro indirizzo IP fisso.
La preghiamo di richiederlo al Suo amministratore di sistema o alla persona che gestisce il Suo server.
Ecco il nostro IP fisso:34.140.252.103
Questo IP deve essere autorizzato su tutte le Sue 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 API
Senza questa autorizzazione, Reversia non potrà comunicare con il Suo negozio.
Fase 1: Esportazione dei moduli front-office
Per iniziare, abbiamo bisogno di recuperare l’elenco dei moduli visualizzati nel front-office (visibili dai Suoi clienti finali). I moduli del back-office non necessitano di traduzione.
Procedura:
- Acceda al Suo back-office PrestaShop
- Navighi su Personalizza > Moduli > Gestore moduli
- Se il modulo Reversia non è ancora installato, clicchi su “Installa il modulo”
- Una volta installato, clicchi sul pulsante “Configura” del modulo Reversia
- Clicchi sul pulsante “Esporta i moduli”
- Selezioni solo i moduli front-office che saranno visibili dai Suoi clienti finali.
Non si preoccupi se dimentica alcuni moduli, potremo integrarli successivamente - Clicchi su “Esporta i moduli selezionati”
- Invii il file di esportazione al team Reversia
Fase 2: Integrazione tecnica da parte di Reversia
Il nostro team tecnico integrerà ora i Suoi moduli sulla piattaforma Reversia. Questa fase è completamente gestita da noi.
La forza di Reversia
Recuperiamo regolarmente moduli che non seguono gli standard di traduzione di PrestaShop.
È infatti il caso della maggior parte dei moduli sul mercato.
La nostra competenza consiste precisamente nel rendere questi moduli perfettamente compatibili con la traduzione, indipendentemente dalla loro origine:
- Marketplace Addons di PrestaShop
- Moduli sviluppati da agenzie
- Moduli di sviluppatori indipendenti
Reversia si occupa di tutta questa integrazione tecnica. Se necessario, contattiamo la Sua agenzia, i Suoi sviluppatori o direttamente il Suo team per ottenere informazioni aggiuntive.
Non deve eseguire alcuna azione durante questa fase.
Fase 3: Test in pre-produzione
Promemoria importante: Whitelisting IP ⚠️
Prima di iniziare i test, verifichi che il nostro IP 34.140.252.103 sia correttamente inserito nella whitelist su tutte le Sue protezioni (htpasswd, Cloudflare, modalità manutenzione PrestaShop, WAF ecc.). Senza questa autorizzazione, i test non potranno funzionare.
Obiettivo dei test
In questa fase, verifichiamo che Reversia sia in grado di:
- ✅ Recuperare i contenuti del Suo negozio
- ✅ Tradurli con qualità
- ✅ Inserire correttamente le traduzioni
I test si concentrano su un campione rappresentativo di contenuti: prodotti, categorie e traduzioni di moduli.
Una volta che tutti i test sono stati convalidati, passiamo alla messa in produzione.
Fase 4: Messa in produzione
Importante: Nessun nuovo onboarding!
Non è necessario rifare un onboarding completo. Segua scrupolosamente le indicazioni qui sotto per modificare semplicemente i parametri di configurazione del modulo dalla pre-produzione alla produzione.
Procedura:
- Installi il modulo Reversia sul Suo ambiente di produzione
- Vada su Personalizza > Moduli > Gestore moduli
- Installi il modulo Reversia se non è già installato
- Clicchi sul pulsante “Configura”
- Configuri la connessione con il Suo progetto Reversia
- Clicchi sul pulsante “Debug” (in alto a destra)
- Clicchi sul pulsante “Impostazioni” (in alto a destra)
- Deve ora inserire la chiave API del Suo progetto Reversia
- Clicchi sul pulsante “Debug” (in alto a destra)
- Recuperi la Sua chiave API Reversia
- Acceda al Suo back-office Reversia
- Vada su Impostazioni > Generale
- Selezioni la scheda “Comunicazione e sicurezza”
- Copi la Chiave API (⚠️ attenzione a non confonderla con il cookie sicuro)
- Finalizzi la configurazione
- Incolli la chiave API nel campo previsto nel Suo modulo PrestaShop
- Salvi
- Incolli la chiave API nel campo previsto nel Suo modulo PrestaShop
È tutto! La configurazione della produzione è ora operativa.
Fase 5: Avvio della traduzione completa
Reversia è ora configurato e può tradurre e inserire automaticamente tutti i contenuti del Suo negozio PrestaShop nelle lingue desiderate.
Per il futuro
- Nuovi moduli front-office? Se installa nuovi moduli visibili ai Suoi clienti, li esporti tramite la procedura descritta nella Fase 1 e ce li invii.
- Whitelisting permanente: Ricordi di mantenere il whitelisting del nostro IP
34.140.252.103su tutte le Sue protezioni (modalità manutenzione, Cloudflare, htpasswd, ecc.) per garantire il corretto funzionamento continuo di Reversia.
Supporto
Il team di Reversia è a Sua disposizione durante tutto il processo e oltre. Non esiti a contattarci se ha domande o necessita di assistenza.
Benvenuto nell’avventura internazionale con Reversia! 🌍
