Inhoudsopgave
Technische vereisten voor Kirby CMS
Voor de neurale automatische vertaling die met Kirby CMS moet worden gebruikt, is het PHP-script vereist (kan hieronder worden gedownload). Om het Linguise script te installeren, hebt u de volgende vereisten nodig:
- Voer PHP 7+ uit
- Apache-, IIS- of NGINX-server
- Zorg ervoor dat het herschrijven van URL's is geactiveerd op uw server
Genereer de API-sleutel
Na uw verbinding met of registratie bij uw Linguise dashboard , moet u eerst een nieuw domein instellen en de instellingen opslaan om de API-sleutel te verkrijgen.
U kunt het "Andere PHP"-platform selecteren om verder te gaan met het Linguise registratiedomein, zoals deze documentatie en de bron- en doeltalen.
Daarna krijg je:
- De API-sleutel die uw lidmaatschap valideert
- De link naar het Linguise script voor de taalwisselaar
De API-sleutel is nodig om de vertaling op uw Kirby CMS-website te activeren. Kortom, de API-sleutel controleert welke taal op uw domein is geactiveerd en maakt de automatische vertaling van de inhoud mogelijk.
Voorlopig kunt u de API-sleutel kopiëren en op uw klembord bewaren.
Upload en verbind het Linguise vertaalscript
Het Linguise vertaalscript moet worden geüpload naar uw server waarop Kirby CMS is geïnstalleerd. Download het hier.
Nadat het script is gedownload, pakt u het uit en uploadt u het naar de hoofdmap waar Kirby CMS is geïnstalleerd.
- het rootniveau wordt geplaatst (waar uw Kirby CMS-bestanden zich bevinden)
- Zorg ervoor dat de map de standaardnaam " linguise "
De Linguise API-sleutel moet worden gekopieerd naar het Configuration.php- bestand dat u naar uw server hebt geüpload, bewerk het bestand en kopieer uw API-sleutel tussen de eenvoudige aanhalingstekens, vervang de tekst REPLACE_BY_TOUR TOKEN.
Stel het herschrijven van de Kirby CMS-URL's in
Standaard is het herschrijven van URL's actief in Kirby CMS. Als dat niet het geval is, kun je dit activeren bij je hostingprovider.
De URL per taal moet worden geconfigureerd in .htaccess. Kopieer gewoon de onderstaande code na de code “ RewriteEngine on ” die beschikbaar is in het standaard Kirby 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]
U kunt nu al uw vertaalde pagina's laden via de URL, bijvoorbeeld: www.shop.com /fr/
Laten we nu de taalwisselaar laden.
Activeer de taalwisselaar
Laad het Linguise Javascript
De Linguise Javascript-link moet op al uw Kirby CMS-pagina's worden geladen om de taalwisselaar met vlaggen en alternatieve URL's in uw HTML-headers weer te geven (voor SEO-doeleinden).
Om de scriptlink te kopiëren, gaat u vanuit het Linguise dashboard naar de domeininstellingen en kopieert u de scriptlink.
De eenvoudigste manier om deze code in Kirby CMS te laden, is door deze toe te voegen aan de header.php of code.
U kunt dit instellen door deze stappen te volgen: Ga naar de hoofdmap en ga vervolgens naar Site > Fragmenten > header.php-bestand . Standaard kunt u deze methode gebruiken.
Bewerk het scriptbestand zodat het de scriptlink in het koptekstgedeelte opneemt, zoals hieronder.
De taalwisselaar wordt standaard weergegeven in een zwevende positie rechtsboven op uw website. U bent van harte welkom om het aan te passen zoals uitgelegd in het volgende hoofdstuk.
SEO belangrijke opmerking: het aantal talen dat u instelt, heeft een grote invloed op SEO. Wanneer u uw vertaaltalen instelt en u een groot aantal geïndexeerde pagina's heeft (>500), kan het veel tijd kosten om ze door de zoekmachine te verwerken. Het kan uw SEO in uw oorspronkelijke taal beïnvloeden. Daarom raden we aan om in eerste instantie maximaal 5 talen toe te voegen, en wanneer het geïndexeerd is, kun je talen toevoegen in een batch van 3 per maand.
Stel de taalwisselaar in
De taalwisselaar kan worden aangepast via het Linguise dashboard > Instellingen > Weergave taalvlaggen. Elke wijziging hier wordt weergegeven op de website.
Aan de rechterkant van het scherm heb je het voorbeeld van de taalwisselaar. Dit zijn de elementen die u kunt instellen:
- 3 lay-outs: naast elkaar, dropdown of popup
- De positie van de taalwisselaar
- De inhoud van de taalwisselaar
- Taalnamen in het Engels of in de moedertaal
- Vlaggen vormen en grootte
- Kleuren en vakschaduw
Laad de taalwisselaar in Kirby CMS-inhoud
Om de Taalwisselaar op de specifieke plaats in de CMS-inhoud weer te geven, moet u de positie instellen op “In plaats”.
Linguise heeft ingesteld , kunt u de onderstaande shortcode toevoegen om deze op te nemen. Klik op onderstaande code om deze op uw klembord te plaatsen.
Zodra het is toegevoegd, worden op de frontend de vlag- en taalnamen weergegeven in het HTML-gebied waar u de code heeft toegevoegd.
Activeer de lokale cachesysteemoptie
Als optie kunt u een lokaal cachesysteem activeren dat URL's en de bijbehorende meertalige inhoud opslaat om de pagina's sneller te bedienen. De lokale cache zal enige gegevensoverdracht tussen Linguise -server en uw websiteserver besparen. De cache wordt alleen gebruikt als een pagina al is vertaald en niet is bijgewerkt. De cache die prioriteit krijgt, is de cache van de meest bekeken meertalige pagina's.
Om dat aan te vullen, kunt u de hoeveelheid cache definiëren die is opgeslagen in MB. In het volgende voorbeeld is de cache geactiveerd en is de hoeveelheid te bewaren cache 500 MB.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Automatische vertaling op NGINX-servers
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;
Automatische vertaling op Windows IIS-servers
Voeg de regel toe die overeenkomt met uw websitebouwer in uw Web.config-bestand.
Het moet worden ingesteld vóór elke andere omleiding, vooral de omleiding naar uw PHP-hoofdbestand:
Van SQLite tot MySQL
Nog steeds in Configuration.php is er een instelling om het gebruik van MySQL in plaats van SQLite te forceren, voor het geval SQLite niet op de server is geïnstalleerd.
In dit geval moet u de MySQL-informatie invullen in dit deel van het Configuration.php-bestand:
/** 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 = '';