Indholdsfortegnelse
Concrete CMS tekniske krav
Den neurale automatiske oversættelse, der skal bruges med Concrete CMS 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.3+
- Apache, IIS Server, NGINX
- Sørg for, at URL-omskrivning er aktiveret på din server
- Concrete CMS 9 og derover
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 Concrete 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.
2. Upload og tilslut Linguise oversættelsesscriptet
Linguise oversættelsesscriptet skal uploades på din server, hvor Concrete CMS er installeret. Download den her.
Når scriptet er downloadet, skal du udpakke det og uploade det til rodmappen, hvor Concrete CMS er installeret.
- Sørg for, at den er placeret på rodniveauet af dit websted (hvor dine Concrete CMS filer er placeret)
- Sørg for, at mappen beholder sit standardnavn " linguise "
Linguise API-nøglen skal kopieres ind i Configuration.php Linguise teksten REPLACE_BY_TOUR TOKEN .
3. Konfigurer omskrivning af Concrete CMS URL'er
Som standard er URL-omskrivningen aktiv i Concrete CMS . Hvis det ikke er tilfældet, kan du aktivere det fra din hostingudbyder.
URL'en efter sprog skal konfigureres i .htaccess. Du skal blot kopiere koden nedenfor efter koden " RewriteEngine on " , der er tilgængelig i standardbeton Concrete CMS .htaccess.
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]
Endelig din Concrete CMS .htaccess se sådan ud:
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)(?:$|/)(.*)$ /concretee/linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME}/index.html !-f
RewriteCond %{REQUEST_FILENAME}/index.php !-f
RewriteRule . /concretee/index.php [L]
Du kan nu indlæse alle dine oversatte sider ved hjælp af URL'en, for eksempel: www.concretewebsite.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 Concrete 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 på i Concrete CMS er at tilføje den på dit websted header.php eller kode.
Du kan konfigurere dette ved at følge disse trin: Få adgang til administratorpanelet , og gå derefter til højre på System og indstillinger > SEO og statistik > Sporingskoder . Som standard kan du bruge denne metode.
Men hvis du bruger et andet tema, der ikke er standard, skal du indsætte koden i din header.php-fil , som kan findes i dit CMS-websteds temamappe .
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.
Indstil sprogskifteren
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 Concrete CMS indhold
For at vise sprogskifteren på det specifikke sted, i Concrete CMS 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.
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;
Automatisk oversættelse på Windows IIS-servere
Tilføj den linje, der svarer til din webstedsbygger, i din Web.config-fil.
Det bør indstilles før enhver anden omdirigering, især omdirigeringen til din PHP-hovedfil:
Fra SQLite til MySQL
Stadig i Configuration.php er der en indstilling til at tvinge brugen af MySQL i stedet for SQLite, i tilfælde af at SQLite ikke er installeret på serveren.
I dette tilfælde skal du udfylde MySQL-oplysningerne i denne del af filen Configuration.php:
/** 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 = '';