Installer Linguise på en hjemmeside, der kører PHP

Table of Contents

Tekniske krav

For at køre Linguise -oversættelsesscriptet skal du bruge følgende:

  • Kør PHP 7+
  • Apache, LiteSpeed, NGINX, IIS-server
  • Aktivér URL-omskrivning i din serverkonfiguration

Sådan installeres scriptet i videoen

1. Generer API-nøglen

Efter din forbindelse til dit Linguise dashboard skal du først konfigurere et nyt domæne og gemme dets indstillinger for at få API-nøglen.

API-nøglen er det, der kræves for at aktivere oversættelsen på dit websted. Grundlæggende set vil API-nøglen kontrollere, hvilket sprog der er aktiveret på hvilket domæne, og tillade generering af neurale oversættelsessider.

Kopiér API-nøglen og behold den i dit udklipsholder.

Trin 2 ud af 2, færdig. Du kan begynde at oversætte!

Ved at klikke på fanen “Script PHP” får du installationsvejledningen, som vi vil følge her i detaljer.

Et skærmbillede af installationsvejledningen til et WordPress plugin, der viser trin til at installere social proof på et websted.

2. Upload og tilslut Linguise -oversættelsesskriptet

Linguise oversættelsesskriptet skal uploades til din server og kan downloades her:

Når scriptet er downloadet, skal du pakke det ud og uploade det til rodmappen, hvor CMS'et er installeret.

  • Sørg for, at det er på rodniveauet af dit websted (normalt der, hvor dine CMS-filer er placeret)
  • Sørg for at mappen hedder " linguise " (standardnavnet når mappen udpakkes)
Mappeoversigt over et filsystem med mapper

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:

FunktionSQLiteMySQL
OpsætningMeget nemt (SQLite-installation kræves)Kræver serveropsætning
LagringEnkelt filAdministreret af MySQL-server
YdeevneFantastisk til små appsBedre til store systemer med høj trafik
AnvendelsestilfældeLokale apps, test, små webstederWebapps, 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.

API-grænseflade

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.

displaygrænseflade
udseende-grænseflade

3. Opsæt sprog-URL'erne

URL'en efter sprog skal konfigureres i .htaccess-filen. Hvis du har en "RewriteBase /" i din fil, skal du blot kopiere al følgende kode efter det. Det er bedre at placere koden i starten af ​​filen:

				
					<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>
				
			
Et skærmbillede af en computermappe på Mac OS.

4. Aktivér sprogskifteren

Sprogskifteren , hvor du kan vælge det ønskede sprog. For at indlæse den skal du kopiere den givne kode for at indlæse scriptet et sted i din hjemmesidekonfiguration eller skabelonfil.

Det vigtigste er at indlæse scriptet på alle dine sider, i head-sektionen.

Cookie-samtykkebanner på en hjemmeside

Sprogskifteren vises som standard i en flydende position nederst til højre på dit websted. Du er velkommen til at tilpasse den fra Linguise dashboardet.

En rullemenu til valg af sprog på et websted. Mulighederne omfatter engelsk, spansk, fransk og mere.

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.

Et skærmbillede, der viser en rullemenu til valg af sprogindstillinger med muligheder for engelsk.

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

flag-position-in-place

For at vise sprogskifteren på det specifikke sted i PHP-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>&#091;linguise&#093;</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 det lokale cachesystem

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.

Eksempel på konfigurationskode til Laravel -oversættelse. Konfiguration til opsætning af oversættelser.

Som en mulighed 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å 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}&amp;original_url={R:2}" appendQueryString="true" />
</rule>
				
			

Automatisk oversættelse på NGINX-servere

Tilføj den linje, der svarer til dit CMS, i din NGINX-serverkonfigurationsblok.
Den bør indstilles før enhver anden omdirigering, især omdirigeringen i din PHP-hovedfil.
				
					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;