Sommario
Requisiti tecnici Magento
La traduzione automatica neurale da utilizzare con Magento richiederà l'utilizzo dello script PHP (scaricabile di seguito). Per installare lo Linguise , avrai bisogno dei seguenti requisiti:
- Esegui PHP 7+
- Server Apache, LiteSpeed, NGINX, IIS
- Attiva la riscrittura dell'URL tramite la configurazione Magento
- Magento +
- La cartella root di Magento /pub ", assicurati di installare Linguise all'interno di questa cartella
Genera la chiave API
La chiave API è ciò che è necessario per attivare la traduzione sul tuo sito Magento . Fondamentalmente, la chiave API controllerà quale lingua è attivata su quale dominio e consentirà la generazione delle pagine di traduzione neurale.
Copia la chiave API e conservala negli appunti.
Cliccando poi sulla scheda “Script PHP” otterrete le istruzioni di installazione che seguiremo qui in dettaglio.
Carica e collega lo script di traduzione Linguise
Lo script di traduzione Linguise deve essere caricato sul tuo server su cui è installato Magento :
Dopo aver scaricato lo script, decomprimilo e caricalo nella cartella principale in cui è installato il CMS.
- Assicurati che sia al livello root del tuo sito web (dove si trovano i tuoi Magento , per impostazione predefinita è nella cartella /pub
- Assicurati che la cartella mantenga il nome predefinito " linguise "
La Linguise dovrà essere copiata nel Configuration.php che hai caricato sul tuo server, modificare il file e copiare la tua chiave API tra virgolette semplici, sostituire il testo REPLACE_BY_TOUR TOKEN.
Configurazione aggiuntiva Magento
Nella barra laterale di amministrazione vai su Negozi > Impostazioni > Configurazione > Generale > Web > Opzioni URL e imposta l' Aggiungi codice negozio agli URL su " No ".
Accedi al codice del tuo sito web e apri app/etc/env.php . Imposta "document_root_is_pub" su true.
Assicurati di impostare entrambi questi passaggi e continua a configurare la riscrittura dell'URL per garantire che Linguise possa essere eseguito correttamente sul tuo sito Web Magento senza problemi.
Imposta la riscrittura degli URL
Nella barra laterale di amministrazione vai su Negozi > Impostazioni > Configurazione > Generale > Web > Ottimizzazione per i motori di ricerca e abilita l' opzione Usa riscrittura server Web Maggiori informazioni nella documentazione ufficiale Magento
L'URL per lingua deve essere configurato nel file .htaccess. Basta copiare questo codice dopo il codice “ RewriteEngine on ” disponibile nel file .htaccess predefinito Magento 2 :
RewriteEngine On
RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA,END]
Infine, il tuo Magento .htaccess dovrebbe assomigliare a questo:
Attiva il cambio lingua
Carica lo script Linguise JS
Ora puoi caricare tutte le tue pagine tradotte utilizzando l'URL, ad esempio: www.shop.com /fr/
Il selettore di lingua è il popup di bandiera per selezionare la lingua desiderata. Per caricarlo dovrai copiare all'inizio della tua pagina HTML il codice fornito alla fine della configurazione del sito. Il cambio della lingua delle bandiere verrà quindi caricato automaticamente.
Il codice da copiare e caricare nell'intestazione del tuo sito web è disponibile nella Linguise > Il tuo dominio > Impostazioni > Scheda: Script PHP
Deve essere caricato nell'intestazione della pagina. Magento 2 ti dà la possibilità di aggiungere contenuti nella testa della tua pagina attraverso la configurazione.
Nel pannello di amministrazione vai su Contenuto > Configurazione , modifica la visualizzazione predefinita del tema del negozio, quindi fai clic sulla sezione Testata HTML e aggiungi lo script copiato all'input Script e fogli di stile. Infine, salva la configurazione.
Installa il modulo di sicurezza Magento
A partire da Magento 2.3.5 è necessario aggiungere un modulo di sicurezza per consentire Magento di caricare file dal dominio Linguise . Se hai familiarità con Magento non sarà un problema, altrimenti ecco una guida passo passo:
- Scarica il modulo da questo link
- Decomprimi il contenuto dello zip nella tua installazione Magento nella directory app/code/
- Quindi esegui i comandi:
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
Il selettore di lingua verrà visualizzato per impostazione predefinita in una posizione mobile in basso a destra sul tuo sito web. Puoi personalizzarlo dalla dashboard Linguise .
Nota importante sulla SEO: il numero di lingue impostate ha un grande impatto sulla SEO. Quando imposti le tue lingue di traduzione, se hai una grande quantità di pagine indicizzate (>500), il motore di ricerca potrebbe impiegare molto tempo per elaborarle. Potrebbe avere un impatto sulla tua SEO nella tua lingua originale. Ecco perché ti consigliamo di aggiungere all'inizio un massimo di 5 lingue, poi, una volta indicizzato, puoi aggiungere le lingue in un batch di 3 al mese.
Imposta il selettore di lingua
Il selettore di lingua può essere personalizzato dalla dashboard Linguise > Impostazioni > Visualizzazione flag lingua. Ogni modifica qui si rifletterà sul sito web.
Sul lato destro dello schermo hai l'anteprima del selettore di lingua. Ecco gli elementi che puoi impostare:
- 3 layout: affiancati, a discesa o popup
- La posizione del selettore di lingua
- Il contenuto del selettore di lingua
- Nomi delle lingue in inglese o nella lingua madre
- Forme e dimensioni delle bandiere
- Colori e ombra della scatola
Carica il selettore di lingua nel contenuto Magento
Per visualizzare il selettore di lingua in un punto specifico, nel Magento , è necessario impostare la posizione come "Sul posto".
Una volta impostata la posizione nella Linguise , puoi aggiungere lo shortcode qui sotto per includerla. Clicca sul codice qui sotto per inserirlo negli appunti.
Una volta aggiunto, sul frontend avrai la bandiera e i nomi delle lingue visualizzati nell'area HTML in cui hai aggiunto il codice.
Attiva il sistema di cache locale
Come opzione, puoi attivare un sistema di cache locale che memorizza gli URL e il relativo contenuto multilingue per servire le pagine più velocemente. La cache locale salverà alcuni trasferimenti di dati tra il server Linguise e il server del tuo sito web. La cache viene utilizzata solo quando una pagina è già stata tradotta e non è stata aggiornata. La cache mantenuta prioritaria sarà la cache delle pagine multilingue più visualizzate.
Come opzione è possibile definire la quantità di cache archiviata in MB. Nell'esempio seguente la cache è attivata e la quantità di cache da conservare è 500 MB:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte