La traduzione automatica da utilizzare con MODX Content Management Framework richiederà l'utilizzo dello script PHP (scaricabile di seguito). Per installare lo script Linguise , avrai bisogno dei seguenti requisiti:
Dopo la connessione o la registrazione alla dashboard Linguise , dovrai prima impostare un nuovo dominio e salvarne le impostazioni per ottenere la chiave API.
Puoi selezionare la piattaforma "Altro PHP" per procedere con la registrazione del dominio Linguise , come questa documentazione e le lingue di origine e di destinazione.
Dopodiché otterrai:
La chiave API è ciò che è necessario per attivare la traduzione sul tuo sito web MODX CMS. In sostanza, la chiave API controllerà quale lingua è attivata sul tuo dominio e consentirà la traduzione automatica del contenuto.
Per ora, puoi copiare la chiave API e tenerla negli appunti.
Lo script di traduzione Linguise deve essere caricato sul tuo server su cui è installato MODX CMS:
Dopo aver scaricato lo script, decomprimilo e caricalo nella cartella principale in cui è installato MODX CMS.
La Linguise dovrà essere copiata nel Configuration.php che hai caricato sul tuo server, modifica il file e copia la tua chiave API tra virgolette semplici, sostituisci il testo REPLACE_BY_TOUR TOKEN.
Per impostazione predefinita, la riscrittura dell'URL è già attiva in MODX CMS. In caso contrario, puoi attivarlo dal tuo provider di hosting.
L'URL per lingua deve essere configurato nel file .htaccess. Basta copiare il codice qui sotto dopo il codice “ RewriteEngine on ” disponibile nel MODX CMS .htaccess.
<IfModule mod_rewrite.c> 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] </IfModule>
Infine, il tuo file .htaccess MODX CMS dovrebbe assomigliare a questo:
<IfModule mod_rewrite.c> 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] </IfModule> # Prevent rewrite the .well-known directory used by LetsEncrypt by rules below of this rule RewriteRule "^\.well-known/" - [L] # Prevent dot directories (hidden directories like .git) to be exposed to the public # Except for the .well-known directory used by LetsEncrypt a.o RewriteRule "/\.|^\.(?!well-known/)" - [F]
Ora puoi caricare tutte le tue pagine tradotte utilizzando l'URL, ad esempio: www.shop.com /fr/
Carichiamo ora il selettore di lingua.
Il collegamento allo script Linguise JS deve essere caricato su tutte le pagine del tuo CMS MODX per visualizzare il cambio di lingua con flag e URL alternativi nelle intestazioni HTML (per scopi SEO).
Per copiare il collegamento allo script, dalla dashboard Linguise vai alle impostazioni del dominio e copia il collegamento allo script.
Il modo più semplice per caricare questo codice in MODX CMS è aggiungerlo nell'intestazione del tuo sito web o codice.
Per raggiungere questo obiettivo, aprire le MODX Manager/pagine di amministrazione. Quindi vai su Elementi, Seleziona BaseTemplate e scorri verso il basso avrai un codice modello visualizzato (HTML), modifica il codice per includere il collegamento allo script all'interno del codice principale.
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 selettore di lingua verrà visualizzato per impostazione predefinita in una posizione mobile in alto a destra sul tuo sito web. Sei libero di personalizzarlo come spiegato nel prossimo capitolo.
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.
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:
Per visualizzare il selettore di lingua in una posizione specifica, nel MODX , è necessario impostare la posizione su "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.
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.
Per completare ciò, puoi definire la quantità di cache archiviata in MB. Nell'esempio seguente, la cache è attivata e la quantità di cache da mantenere è di 500 MB.
/** Basic configuration **/ public $cache_enabled = true; public $cache_max_size = 500; // In megabyte
rewrite ^/(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 last;
