Instalați traducerea automată Linguise pe MODX CMS

Cerințe tehnice MODX CMS

Traducerea automată care va fi utilizată cu cadrul MODX Content Management Framework va necesita utilizarea scriptului PHP (poate fi descărcat mai jos). Pentru a instala scriptul Linguise , veți avea nevoie de următoarele cerințe:

Rulați PHP 7+
Apache, LiteSpeed, NGINX, server IIS
Asigurați-vă că rescrierea URL-ului este activată pe serverul dvs
MODX CMS 2.x sau 3 și mai sus

1. Generați cheia API

După conectarea sau înregistrarea la tabloul de bord Linguise , va trebui mai întâi să configurați un nou domeniu și să salvați setările acestuia pentru a obține cheia API.

Puteți selecta platforma „Alt PHP” pentru a continua cu domeniul de înregistrare Linguise , cum ar fi această documentație și limbile sursă și destinație.

După aceea vei primi:

Cheia API care vă validează calitatea de membru
Link către scriptul Linguise pentru comutatorul de limbi

Cheia API este ceea ce este necesar pentru a activa traducerea pe site-ul dvs. MODX CMS. Practic, cheia API va verifica ce limbă este activată pe domeniul tău și permite traducerea automată a conținutului.

Pentru moment, puteți copia cheia API și o puteți păstra în clipboard.

2. Încărcați și conectați scriptul de traducere Linguise

Scriptul de traducere Linguise trebuie să fie încărcat pe serverul dvs. unde este instalat MODX CMS:

După ce scriptul este descărcat, dezarhivați-l și încărcați-l în folderul rădăcină unde este instalat MODX CMS.

Asigurați-vă că se află la nivelul rădăcină al site-ului dvs. (unde se află fișierele MODX
Asigurați-vă că folderul își păstrează numele implicit „ linguise ”

Cheia Linguise va trebui copiată în Configuration.php pe care l-ați încărcat pe server, editați fișierul și copiați cheia API între ghilimele simple, înlocuiți textul REPLACE_BY_TOUR TOKEN.

ÎNȚELEM CĂ CONFIGURAREA URL-urilor ȘI COMUTATORUL DE LIMBĂ SUNT CĂRUT TEHNIC DE CONFIGURAT; DAR VESTI BUNE! OFERIM INSTALARE GRATUITA

CONTACTAȚI SUPORTUL NOSTRU TEHNIC

3. Configurați rescrierea URL-urilor MODX CMS

În mod implicit, rescrierea URL-ului este deja activă în MODX CMS. Dacă nu este cazul, îl puteți activa de la furnizorul dvs. de găzduire.

URL-ul după limbă trebuie configurat în .htaccess. Doar copiați codul de mai jos după codul „ RewriteEngine on ” disponibil în CMS MODX .

				
					<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>

În cele din urmă, MODX CMS .htaccess ar trebui să arate cam așa:

				
					<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]

Acum puteți încărca toate paginile dvs. traduse folosind adresa URL, de exemplu: www.shop.com /fr/

Să încărcăm acum comutatorul de limbă.

ÎNȚELEM CĂ CONFIGURAREA URL-urilor ȘI COMUTATORUL DE LIMBĂ SUNT CĂRUT TEHNIC DE CONFIGURAT; DAR VESTI BUNE! OFERIM INSTALARE GRATUITA

CONTACTAȚI SUPORTUL NOSTRU TEHNIC

4. Activați comutatorul de limbă

4.1 Încărcați scriptul Linguise JS

Link-ul de script Linguise JS trebuie să fie încărcat pe toate paginile dvs. MODX CMS pentru a afișa comutatorul de limbi cu steaguri și URL-uri alternative în antetele dvs. HTML (în scopul SEO).

Pentru a copia linkul de script, din tabloul de bord Linguise accesați setările domeniului și copiați linkul de script.

Cel mai simplu mod de a încărca acest cod în MODX CMS este să îl adăugați în antetul site-ului dvs. sau cod.

Pentru a realiza acest lucru, deschideți MODX Manager / paginile de administrare. Apoi accesați Elemente, Selectați BaseTemplate și derulați în jos, veți avea un cod șablon de afișare (HTML), editați codul pentru a include linkul de script în codul principal.

Comutatorul de limbă este fereastra pop-up pentru a selecta limba dorită. Pentru a-l încărca, va trebui să copiați codul dat la sfârșitul configurației site-ului web în capul paginii dvs. HTML. Comutatorul de limbă a steagului va fi apoi încărcat automat.

Comutatorul de limbă va fi afișat implicit într-o poziție plutitoare din dreapta sus pe site-ul dvs. Sunteți binevenit să-l personalizați așa cum este explicat în capitolul următor.

Notă importantă SEO: numărul de limbi pe care le configurați are un impact mare asupra SEO. Când vă configurați limbile de traducere, dacă aveți o cantitate mare de pagini indexate (>500), motorul de căutare poate dura mult timp pentru a le procesa. Vă poate afecta SEO în limba originală. De aceea, vă recomandăm să adăugați la început maximum 5 limbi, apoi atunci când este indexat, puteți adăuga limbi într-un lot de 3 pe lună.

Configurați comutatorul de limbă

Comutatorul de limbă poate fi personalizat din tabloul de bord Linguise > Setări > Afișare steaguri de limbă. Fiecare modificare aici se va reflecta pe site.

În partea dreaptă a ecranului aveți previzualizarea comutatorului de limbă. Iată elementele pe care le puteți configura:

3 aspecte: unul lângă altul, drop-down sau pop-up
Poziția comutatorului de limbă
Conținutul comutatorului de limbă
Nume de limbi în engleză sau în limba maternă
Forme și dimensiuni pentru steaguri
Culori și umbra casetei

Încărcați comutatorul de limbă în conținutul MODX CMS

Pentru a afișa comutatorul de limbă la locul specific, în MODX , ar trebui să setați poziția ca „La loc”.
După ce ați setat poziția în Linguise , puteți adăuga codul scurt de mai jos pentru a-l include. Faceți clic pe codul de mai jos pentru a-l pune în clipboard.

[ linguise ]

');return false;"> [ linguise ]

Odată adăugat, pe front-end veți avea steagul și numele limbii afișate în zona HTML în care ați adăugat codul.

Activați opțiunea de sistem local de cache

Ca opțiune, puteți activa un sistem cache local care stochează adresele URL și conținutul multilingv aferent pentru a difuza paginile mai rapid. Cache-ul local va salva unele transferuri de date între serverul Linguise și serverul site-ului dvs. web. Memoria cache este folosită numai atunci când o pagină a fost deja tradusă și nu a fost actualizată. Cache-ul păstrat cu prioritate va fi cache-ul din cele mai vizualizate pagini multilingve.

Pentru a completa acest lucru, puteți defini cantitatea de cache stocată în MB. În exemplul următor, memoria cache este activată, iar cantitatea de cache de păstrat este de 500 MB.

				
					    /** Basic configuration **/
    public $cache_enabled = true;
    public $cache_max_size = 500; // In megabyte

Traducere automată pe serverele NGINX

Adăugați linia corespunzătoare CMS-ului dvs. în blocul de configurare a serverului NGINX.

Ar trebui setat înainte de orice altă redirecționare, în special redirecționarea în fișierul principal PHP.

				
					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;