Den automatiske oversættelse, der skal bruges med MODX Content Management Framework, kræver brug af PHP-scriptet (kan downloades nedenfor). For at installere Linguise scriptet skal du have følgende krav:
Efter din forbindelse eller registrering til dit Linguise dashboard , skal du først konfigurere et nyt domæne og gemme dets indstillinger for at få API-nøglen.
Du kan vælge "Anden PHP"-platform for at fortsætte med Linguise registreringsdomænet, som denne dokumentation og kilde- og destinationssprogene.
Derefter får du:
API-nøglen er det, der kræves for at aktivere oversættelsen på dit MODX CMS-websted. Grundlæggende vil API-nøglen kontrollere, hvilket sprog der er aktiveret på dit domæne og tillader automatisk oversættelse af indholdet.
Indtil videre kan du kopiere API-nøglen og beholde den i dit udklipsholder.
Linguise oversættelsesscriptet skal uploades på din server, hvor MODX CMS er installeret:
Når scriptet er downloadet, skal du udpakke det og uploade det til rodmappen, hvor MODX CMS er installeret.
Linguise API-nøglen skal kopieres ind i Configuration.php- Linguise din server, rediger filen og kopier din API-nøgle mellem de simple anførselstegn, erstat teksten REPLACE_BY_TOUR TOKEN.
Som standard er URL-omskrivningen allerede aktiv i MODX CMS. Hvis det ikke er tilfældet, kan du aktivere det fra din hostingudbyder.
URL'en efter sprog skal konfigureres i .htaccess. Bare kopier koden nedenfor efter koden " RewriteEngine on " tilgængelig i standard 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>
Endelig skulle din MODX CMS .htaccess se sådan ud:
<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]
Du kan nu indlæse alle dine oversatte sider ved hjælp af URL'en, for eksempel: www.shop.com /fr/
Lad os nu indlæse sprogskifteren.
Linguise JS-scriptlinket skal indlæses på alle dine MODX CMS-sider for at vise sprogskifteren med flag og alternative URL'er i dine HTML-headers (til SEO-formål).
For at kopiere scriptlinket skal du fra Linguise dashboardet gå til domæneindstillingerne og kopiere scriptlinket.
Den nemmeste måde at indlæse denne kode i MODX CMS er at tilføje den i din hjemmesides header eller kode.
For at opnå dette skal du åbne MODX Manager-sider / admin-sider. Gå derefter til Elements, Vælg BaseTemplate , og rul ned, du vil have en skærmskabelonkode (HTML), rediger koden for at inkludere scriptlinket i hovedkoden.
Sprogskifteren er flag-pop-op-vinduet for at vælge det sprog, du ønsker. For at indlæse det, skal du kopiere koden, der er angivet i slutningen af webstedskonfigurationen, til hovedet på din HTML-side. Flagsprogsskifteren indlæses derefter automatisk.
Sprogskifteren vil som standard blive vist i en flydende øverste højre position på dit websted. Du er velkommen til at tilpasse den som forklaret i næste kapitel.
SEO vigtig note: Antallet af sprog, du opsætter, har stor indflydelse på SEO. Når du opsætter dine oversættelsessprog, og hvis du har en stor mængde indekserede sider (>500), kan søgemaskinen tage meget tid at behandle dem. Det kan påvirke din SEO på dit originalsprog. Derfor anbefaler vi først at tilføje maksimalt 5 sprog, så når det er indekseret, kan du tilføje sprog i en batch på 3 om måneden.
Sprogskifteren kan tilpasses fra Linguise dashboardet > Indstillinger > Sprogflag-displayet. Hver ændring her vil blive afspejlet på hjemmesiden.
På højre side af skærmen har du forhåndsvisningen af sprogskifteren. Her er de elementer, du kan konfigurere:
For at vise sprogskifteren på det specifikke sted, i MODX indholdet, skal du indstille positionen som "På plads". Når du har indstillet positionen i Linguise dashboardet, kan du tilføje kortkoden nedenfor for at inkludere den. Klik på koden nedenfor for at sætte den i dit udklipsholder.
Når det først er tilføjet, vil du på frontenden få flaget og sprognavnene vist i HTML-området, hvor du har tilføjet koden.
Som en mulighed kan du aktivere et lokalt cachesystem, der gemmer URL'er og dets relaterede flersprogede indhold for at betjene siderne hurtigere. Den lokale cache gemmer en del dataoverførsel mellem Linguise serveren og din hjemmesideserver. Cachen bruges kun, når en side allerede er oversat og ikke er blevet opdateret. Cachen, der holdes i prioritet, vil være cachen fra de mest viste flersprogede sider.
For at supplere det kan du definere mængden af cache, der er gemt i MB. I det følgende eksempel er cachen aktiveret, og mængden af cache, der skal opbevares, er 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;
