Table of Contents
Tekniske krav til Kirby CMS
Den neurale automatiske oversættelse, der skal bruges med Kirby CMS, kræver PHP-scriptet (kan downloades nedenfor). For at installere Linguise scriptet skal du opfylde følgende krav:
- Kør PHP 7+
- Apache-, IIS- eller NGINX-server
- Sørg for, at URL-omskrivning er aktiveret på din server
Generer API-nøglen
Efter din forbindelse eller registrering til dit Linguise dashboard , skal du først oprette 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 domæneregistreringen, såsom denne dokumentation og kilde- og destinationssprogene.
Derefter får du:
- API-nøglen, der validerer dit medlemskab
- Linket til Linguise scriptet for sprogskifteren
API-nøglen er det, der kræves for at aktivere oversættelsen på dit Kirby CMS-websted. Grundlæggende set vil API-nøglen kontrollere, hvilket sprog der er aktiveret på dit domæne, og tillade automatisk oversættelse af indholdet.
Indtil videre kan du kopiere API-nøglen og gemme den i dit udklipsholder.
Upload og tilslut Linguise -oversættelsesskriptet
Linguise oversættelsesskriptet skal uploades til den server, hvor Kirby CMS er installeret. Download det her.
Når scriptet er downloadet, skal du pakke det ud og uploade det til rodmappen, hvor Kirby CMS er installeret.
- Sørg for, at den er placeret på rodniveauet af dit websted (hvor dine Kirby CMS-filer er placeret)
- Sørg for, at mappen beholder standardnavnet " linguise ".
Hvordan får man adgang til Linguise Script-grænsefladen?
Når du har gennemført Linguise installationen, kan du få adgang til dashboardet ved at besøge dit websted med følgende URL-format
linguise https://www.domain.com/linguise
Skift domæneadressen i henhold til din hjemmesideadresse*
Sørg for, at Linguise har korrekt læse- og skrivetilladelse*
Opsætning af adgangskode og databaseforbindelse
Når du har adgang til scriptgrænsefladen, vil du blive præsenteret for en opsætningsskærm, hvor du kan oprette en adgangskode og oprette forbindelse til din foretrukne database.
Du kan:
- Indstil en adgangskode, som skal bruges til fremtidig adgang til denne brugerflade.
- Vælg din databasetype — enten MySQL eller SQLite, afhængigt af din opsætning og præferencer.
Denne indledende opsætning sikrer sikker adgang og giver dig mulighed for at konfigurere scriptet i henhold til dit miljø.
MySQL-databaseforbindelse
Hvis du vælger MySQL, vises en anden brugerflade, der beder om følgende forbindelsesoplysninger for MySQL-konfigurationsfelterne nedenfor:
Sørg for, at oplysningerne er korrekte for at oprette en vellykket forbindelse til din MySQL-database.
MySQL vs SQLite – Hvad er forskellen?
Både MySQL og SQLite er populære databasesystemer, der bruges til at gemme og administrere data til websteder og applikationer. De er dog designet til forskellige anvendelsesscenarier og har nogle vigtige forskelle:
| Funktion | SQLite | MySQL |
|---|---|---|
| Opsætning | Meget nemt (SQLite-installation kræves) | Kræver serveropsætning |
| Lagring | Enkelt fil | Administreret af MySQL-server |
| Ydeevne | Fantastisk til små apps | Bedre til store systemer med høj trafik |
| Anvendelsestilfælde | Lokale apps, test, små websteder | Webapps, e-handel, virksomhedssystemer |
Linguise Script-grænseflade: Opsætning til PHP-platform
Linguise -oversættelsesdashboardet, der tidligere kun var tilgængeligt for Joomla og WordPress, udvider nu understøttelsen til PHP og yderligere platforme. Denne opdatering giver brugerne mulighed for problemfrit at konfigurere sprogindstillinger – såsom visningsmuligheder, flagstile og tilpasning af udseende – direkte fra en samlet brugerflade, uanset deres CMS eller framework.
Administratorer kan administrere Linguise indstillinger mere effektivt med ensartede funktioner som pop op-vinduer til sprogvalg, skyggeeffekter og regionsspecifikke flagvarianter. Dashboardet bevarer sit brugervenlige design, samtidig med at det tilbyder bredere kompatibilitet til forskellige webmiljøer.
Opsæt omskrivning af Kirby CMS URL'er
Som standard er URL-omskrivning aktiv i Kirby CMS. Hvis det ikke er tilfældet, kan du aktivere det fra din hostingudbyder.
URL'en efter sprog skal konfigureres i .htaccess-filen. Du skal blot kopiere koden nedenfor efter koden " RewriteEngine on " , som er tilgængelig i standard Kirby 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>
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.
Aktivér sprogskifteren
Indlæs Linguise Javascript
Linguise Javascript-linket skal indlæses på alle dine Kirby CMS-sider for at vise sprogskifteren med flag og alternative URL'er i dine HTML-headere (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 Kirby CMS er at tilføje den i din hjemmesides header.php eller kode.
Du kan konfigurere dette ved at følge disse trin: Gå til rodmappen , og gå derefter til Websted > Snippets > header.php-filen . Som standard kan du bruge denne metode.
Rediger scriptfilen for at inkludere scriptlinket i header-sektionen som nedenfor.
Sprogskifteren vises som standard i en flydende position øverst til højre 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.
Opsætning af sprogskifteren
Sprogskifteren kan tilpasses fra Linguise dashboardet > Indstillinger > Visning af sprogflag. Enhver ændring her vil blive afspejlet på webstedet.
På højre side af skærmen har du forhåndsvisningen af sprogskifteren. Her er de elementer, du kan konfigurere:
- 3 layouts: side om side, dropdown eller pop op
- Sprogvælgerens position
- Sprogvælgerens indhold
- Sprognavne på engelsk eller modersmål
- Flag former og størrelse
- Farver og kasseskygge
Indlæs sprogskifteren i Kirby CMS-indhold
For at vise sprogskifteren på det specifikke sted i CMS-indholdet, skal du indstille positionen som "På plads".
Når du har angivet positionen i Linguise dashboardet, kan du tilføje shortcoden nedenfor for at inkludere den. Klik på koden nedenfor for at placere den i dit udklipsholder.
<div>[linguise]</div>
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.
Aktivér den lokale cache-systemindstilling
Som en mulighed kan du aktivere et lokalt cachesystem, der gemmer URL'er og det tilhørende flersprogede indhold for at vise siderne hurtigere. Den lokale cache sparer noget dataoverførsel mellem Linguise serveren og din hjemmesideserver. Cachen bruges kun, når en side allerede er oversat og ikke er blevet opdateret. Den cache, der prioriteres, vil være cachen fra de mest sete flersprogede sider.
For at supplere dette kan du definere mængden af cache, der er gemt i MB. I følgende eksempel er cachen aktiveret, og mængden af cache, der skal gemmes, er 500 MB.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Automatisk oversættelse på NGINX-servere
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;
Automatisk oversættelse på Windows IIS-servere
Tilføj linjen, der svarer til din hjemmesidebygger, i din Web.config-fil.
Den skal indstilles før enhver anden omdirigering, især omdirigeringen til din PHP-hovedfil:
<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>
Fra SQLite til MySQL
I Configuration.php er der stadig en indstilling til at gennemtvinge brugen af MySQL i stedet for SQLite, hvis SQLite ikke er installeret på serveren.
I dette tilfælde skal du udfylde MySQL-oplysningerne i denne del af Configuration.php-filen:
/** Advanced database configuration **/
/*
* In case you don't want to use Sqlite, you can use MySQL
* To do so, you need to fill the following variables
* Linguise will create the tables for you
*/
public static $db_host = '';
public static $db_user = '';
public static $db_password = '';
public static $db_name = '';
public static $db_prefix = '';