Tabel de Conținut
Cerințe tehnice Craft CMS
Traducerea automată neuronală care va fi utilizată cu Craft CMS va necesita scriptul 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+
- Server Apache, LiteSpeed, NGINX, IIS
- Asigurați-vă că rescrierea URL-urilor este activată pe serverul dvs
- Craft CMS 3 sau 4 și versiuni ulterioare
- De obicei, folderul rădăcină al Craft CMS /web ”.
1. Generați cheia API
După conectarea sau înregistrarea la tabloul de bord Linguise , va trebui mai întâi să configurați un domeniu nou și să salvați setările acestuia pentru a obține cheia API.
Trebuie doar să selectați platforma Craft CMS pentru a obține linkul corect către această documentație și limbile sursă și destinație.
După aceea veți primi:
- Cheia API care îți validează calitatea de membru
- Legătura către scriptul Linguise pentru comutatorul de limbi
Cheia API este necesară pentru a activa traducerea pe site-ul tău Craft CMS . Practic, cheia API va verifica ce limbă este activată pe domeniul tău și permite traducerea automată a conținutului.
Deocamdată, 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 încărcat pe serverul unde este instalat Craft CMS :
După ce scriptul este descărcat, dezarhivați-l și încărcați-l în folderul rădăcină unde este instalat Craft CMS .
- Asigură-te că se află la nivelul rădăcină al site-ului tău web (unde se află fișierele tale Craft CMS , în mod implicit se află în folderul /web
- Asigurați-vă că folderul își păstrează numele implicit „ linguise ”.
Cum se accesează interfața Linguise Script?
După finalizarea Linguise , puteți accesa tabloul de bord vizitând site-ul web cu următorul format URL
linguise https://www.domain.com/linguise
Schimbați adresa domeniului în funcție de adresa site-ului web*
Asigurați-vă că Linguise are permisiunile de citire și scriere necesare*
Configurarea parolei și a conexiunii la baza de date
După ce accesați interfața scriptului, vi se va afișa un ecran de configurare unde puteți crea o parolă și vă puteți conecta la baza de date preferată.
Puteți:
- Setați o parolă, care va fi necesară pentru accesul viitor la această interfață.
- Alegeți tipul bazei de date — fie MySQL, fie SQLite, în funcție de configurație și preferințe.
Această configurare inițială asigură acces securizat și vă permite să configurați scriptul în funcție de mediul dumneavoastră.
Conexiune la baza de date MySQL
Dacă alegeți MySQL, va apărea o interfață diferită care vă va solicita următoarele detalii de conexiune pentru câmpurile de configurare MySQL de mai jos:
Asigurați-vă că informațiile sunt corecte pentru a stabili o conexiune cu succes la baza de date MySQL.
MySQL vs SQLite – Care este diferența?
Atât MySQL, cât și SQLite sunt sisteme de baze de date populare utilizate pentru stocarea și gestionarea datelor pentru site-uri web și aplicații. Cu toate acestea, sunt concepute pentru cazuri de utilizare diferite și au câteva diferențe cheie:
| Funcție | SQLite | MySQL |
|---|---|---|
| Înființat | Foarte ușor (necesită instalare SQLite) | Necesită configurarea serverului |
| Depozitare | Fișier unic | Gestionat de serverul MySQL |
| Performanţă | Excelent pentru aplicații la scară mică | Mai bun pentru sisteme mari, cu trafic intens |
| Caz de utilizare | Aplicații locale, testare, site-uri mici | Aplicații web, comerț electronic, sisteme pentru întreprinderi |
Interfață Linguise Script: Configurare pentru platforma PHP
Tabloul de bord pentru traduceri Linguise , disponibil anterior doar pentru Joomla și WordPress, extinde acum suportul pentru PHP și alte platforme. Această actualizare permite utilizatorilor să configureze fără probleme setările de limbă - cum ar fi opțiunile de afișare, stilurile de steaguri și personalizarea aspectului - direct dintr-o interfață unificată, indiferent de CMS-ul sau framework-ul lor.
Administratorii pot gestiona setările Linguise mai eficient, cu funcții consistente, cum ar fi ferestrele pop-up pentru selectarea limbii, efectele de umbră și variantele de opțiuni pentru steaguri specifice regiunii. Tabloul de bord își păstrează designul ușor de utilizat, oferind în același timp o compatibilitate mai largă pentru diverse medii web.
3. Configurați rescrierea URL-urilor în Craft CMS
În mod implicit, rescrierea URL-urilor este activă în Craft CMS. Dacă nu este cazul, o puteți activa de la furnizorul dvs. de găzduire.
URL-ul în funcție de limbă trebuie configurat în fișierul .htaccess. Copiați codul de mai jos după codul „ RewriteEngine activat ” disponibil în Craft 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>
În cele din urmă, fișierul .htaccess al Craft CMS 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]
# Send would-be 404 requests to Craft
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !^/(favicon\.ico|apple-touch-icon.*\.png)$ [NC]
RewriteRule (.+) index.php?p=$1 [QSA,L]
</IfModule>
Acum puteți încărca toate paginile traduse folosind adresa URL, de exemplu: www.shop.com /fr/
Să încărcăm acum comutatorul de limbă.
4. Activați comutatorul de limbă
4.1 Încărcați scriptul Linguise JS
Linkul către scriptul Linguise JS trebuie încărcat pe toate paginile Craft CMS pentru a afișa comutatorul de limbă cu steaguri și adrese URL alternative în antetele HTML (în scopuri SEO).
Pentru a copia linkul scriptului, din tabloul de bord Linguise accesați setările domeniului și copiați linkul scriptului.
Cea mai ușoară modalitate de a încărca acest cod în craft CMS este să îl adăugați la indexul șabloanelor. Deschideți folderul /template și editați fișierul index pentru a include linkul scriptului în secțiunea antetului.
Comutatorul de limbă este fereastra pop-up cu stegulețe pentru a selecta limba dorită. Pentru a-l încărca, va trebui să copiați codul de la sfârșitul configurării site-ului web în partea de sus a paginii HTML. Comutatorul de limbă cu stegulețe se va încărca apoi automat.
Comutatorul de limbă va fi afișat în mod implicit într-o poziție flotantă în dreapta sus pe site-ul dvs. web. Îl puteți personaliza 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. Atunci când configurați limbile de traducere, dacă aveți un număr mare de pagini indexate (>500), motorul de căutare poate avea nevoie de mult timp pentru a le procesa. Acest lucru poate afecta SEO-ul în limba originală. De aceea, vă recomandăm să adăugați inițial maximum 5 limbi, apoi, după ce sunt indexate, puteți adăuga limbi în loturi de câte 3 pe lună.
Configurați selectorul de limbă
Comutatorul de limbă poate fi personalizat din panoul de control Linguise > Setări > afișajul Indicatori de limbă. Fiecare modificare de 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 layout-uri: alăturate, dropdown sau popup
- Poziția selectorului de limbă
- Conținutul selectorului de limbă
- Numele limbilor în engleză sau în limba maternă
- Forme și dimensiuni ale steagurilor
- Culori și umbră de cutie
Încărcați comutatorul de limbă în conținutul Craft CMS
Pentru a afișa comutatorul de limbă în locul specific, în Craft CMS , trebuie să setați poziția ca „Pe loc”.
După ce ați setat poziția în Linguise , puteți adăuga shortcode-ul de mai jos pentru a-l include. Faceți clic pe codul de mai jos pentru a-l pune în clipboard.
<div>[linguise]</div>
După ce este adăugat, pe frontend veți avea steagul și numele limbilor afișate în zona HTML în care ați adăugat codul.
Activați opțiunea sistemului de cache local
Opțional, puteți activa un sistem de cache local care stochează adrese URL și conținutul multilingv aferent pentru a servi paginile mai rapid. Cache-ul local va economisi o parte din transferul de date între serverul Linguise și serverul site-ului dvs. web. Cache-ul este utilizat 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 paginilor multilingve cel mai vizualizate.
Pentru a completa acest lucru, puteți defini cantitatea de memorie cache stocată în MB. În exemplul următor, memoria cache este activată, iar cantitatea de memorie cache care trebuie păstrată este de 500 MB.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Traducere automată pe serverele Windows IIS
Adăugați linia corespunzătoare constructorului de site-uri web în fișierul Web.config.
Ar trebui setată înainte de orice altă redirecționare, în special redirecționarea către fișierul principal PHP:
<rule name="Linguise" stopProcessing="true">
<match url="^(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)(?:$|/)(.*)$" ignoreCase="false" />
<conditions logicalGrouping="MatchAll" trackAllCaptures="false" />
<action type="Rewrite" url="linguise/linguise.php?linguise_language={R:1}&original_url={R:2}" appendQueryString="true" />
</rule>
Traducere automată pe serverele NGINX
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;