Indholdsfortegnelse
PyroCMS tekniske krav
Den neurale automatiske oversættelse, der skal bruges med PyroCMS kræver, at du bruger PHP-scriptet (kan downloades nedenfor). For at installere Linguise scriptet skal du have følgende krav:
- Kør PHP 7+
- Apache, LiteSpeed, NGINX, IIS server
- Sørg for, at URL-omskrivning er aktiveret på din server
- PyroCMS 3 og nyere
1. Generer API-nøglen
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, der validerer dit medlemskab
- Linket til Linguise -scriptet til sprogskifteren
API-nøglen er det, der kræves for at aktivere oversættelsen på dit PyroCMS 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.
2. Upload og tilslut Linguise oversættelsesscriptet
Linguise oversættelsesscriptet skal uploades på din server, hvor PyroCMS er installeret:
Når scriptet er downloadet, skal du udpakke det og uploade det til rodmappen, hvor PyroCMS er installeret.
- Sørg for, at det er på rodniveauet på dit websted (hvor dine PyroCMS filer er placeret, som standard er det placeret i /public folder )
- Sørg for, at mappen beholder sit standardnavn " linguise "
Fortæl os venligst Kontakt os .
Hvordan får du adgang til Linguise script -interface?
Efter at have afsluttet Linguise , kan du få adgang til instrumentbrættet ved at besøge dit websted med følgende URL -format:
https://www.domain.com/ linguise
Skift domæneadresse i henhold til din webstedsadresse*
Sørg for, at Linguise har korrekt læsning og skriv tilladelse*
Opsætning af adgangskode og databaseforbindelse
Når du får adgang til script -interface, får du en opsætningskærm, hvor du kan oprette en adgangskode og oprette forbindelse til din foretrukne database.
Du kan:
- Indstil en adgangskode, som kræves for fremtidig adgang til denne grænseflade.
- Vælg din databasetype - enten MySQL eller SQLite, afhængigt af din opsætning og præference.
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 grænseflade, der beder om følgende forbindelsesoplysninger om MySQL -konfigurationsfelter nedenfor:
Sørg for, at oplysningerne er korrekte for at etablere 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 brugssager og har nogle vigtige forskelle:
| Feature | Sqlite | MySQL |
|---|---|---|
| Opsætning | Meget let (SQLite installation krævet) | Kræver serveropsætning |
| Opbevaring | Enkelt fil | Administreret af MySQL Server |
| Præstation | Fantastisk til små apps | Bedre til store systemer med høj trafik |
| Use case | Lokale apps, test, små websteder | Webapps, e -handel, virksomhedssystemer |
Linguise Script Interface: Opsætning til PHP -platform
Linguise Translation Dashboard, der tidligere kun er tilgængelig for Joomla og WordPress, udvider nu support til PHP og yderligere platforme. Denne opdatering giver brugerne mulighed for problemfrit at konfigurere sprogindstillinger - såsom visningsindstillinger, flagstilarter og tilpasning af udseende - direkte fra en samlet grænseflade, uanset deres CMS eller rammer.
Administratorer kan administrere Linguise -indstillinger mere effektivt med konsistente funktioner som sprogvalg af popups, skyggeeffekter og regionspecifikke flagvalgsvarianter. Dashboardet bevarer sit brugervenlige design, mens den tilbyder bredere kompatibilitet til forskellige webmiljøer.
3. Konfigurer PyroCMS URLs omskrivning
Som standard er URL-omskrivningen aktiv i PyroCMS. 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 PyroCMS .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 PyroCMS .htaccess se sådan ud:
<IfModule mod_rewrite.c>
<IfModule mod_negotiation.c>
Options -MultiViews
</IfModule>
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]
RewriteBase /
# Redirect trailing slashes
RewriteRule ^(.*)/$ /$1 [L,R=301]
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.
4. Aktiver sprogskifteren
4.1 Indlæs Linguise JS-scriptet
Linguise JS-scriptlinket skal indlæses på alle dine PyroCMS 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 PyroCMS på er at tilføje den i din hjemmesides header eller kode. PyroCMS kommer med et specielt miljø, og det har en specifik fil til at tilføje et script til headeren.
Det er placeret i scripts.twig , som du kan finde det ved at navigere i din CMS installationsmappe her:
vendor/ pyrocms /*YOUR_THEME*/resources/views/partials/scripts.twig . Som standard er PyroCMS starter-tema.
Rediger scriptfilen for at inkludere scriptlinket i overskriftssektionen som nedenfor.
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.
Konfigurer sprogskifteren i PyroCMS
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:
- 3 layouts: side om side, dropdown eller popup
- Sprogskifterpositionen
- Sprogskifterindholdet
- Sprognavne på engelsk eller modersmål
- Flags former og størrelse
- Farver og kasseskygge
Indlæs sprogskifteren i PyroCMS -indhold
For at vise sprogskifteren på det specifikke sted, i PyroCMS 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.
<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.
Aktiver indstillingen for det lokale cachesystem
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
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;