Inhoudsopgave
TYPO3 CMS technische vereisten
De neurale automatische vertaling die gebruikt moet worden met TYPO3 CMS vereist het gebruik van het PHP-script (kan hieronder worden gedownload). Om het Linguise script te installeren, hebt u de volgende vereisten nodig:
- Voer PHP 7+ uit
- Apache, LiteSpeed, NGINX, IIS-server
- Zorg ervoor dat het herschrijven van URL's is geactiveerd op uw server
- TYPO3 CMS 9 en hoger
1. 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 TYPO3 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.
2. Upload en koppel het Linguise vertaalscript
Het Linguise vertaalscript moet worden geüpload naar uw server waarop TYPO3 CMS is geïnstalleerd:
Nadat het script is gedownload, pakt u het uit en uploadt u het naar de hoofdmap waar het TYPO3 CMS is geïnstalleerd.
- Zorg ervoor dat dit zich op het rootniveau van uw website bevindt (waar uw TYPO3 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.
3. Stel het herschrijven van de TYPO3 CMS-URL's in
Standaard is het herschrijven van URL's actief in TYPO3 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 TYPO3 CMS .htaccess.
# Set PHP version to 7.4 >> Please Add this code before the Rewrite rules to ensure Linguise works in PHP v7.4
AddHandler application/x-httpd-php74 .php
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]
Ten slotte zou uw TYPO3 CMS .htaccess-bestand er ongeveer zo uit moeten zien:
# Set PHP version to 7.4
AddHandler application/x-httpd-php74 .php
# Enable URL rewriting
RewriteEngine On
RewriteBase /typo10/ # Set the RewriteBase to the subfolder
# Add a condition to check if the request starts with the subfolder
RewriteCond %{REQUEST_URI} !^/typo10/
# Rewrite requests that don't start with the subfolder to include it
RewriteRule ^(.*)$ /typo10/$1 [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
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)(?:$|/)(.*)$ /typo10/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.
4. Activeer de taalwisselaar
4.1 Laad het Linguise JS-script
De Linguise JS-scriptlink moet op al uw TYPO3 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.
TYPO3 te laden is door deze toe te voegen aan de header van uw website code. TYPO3 CMS wordt geleverd met een speciale omgeving en moet een specifiek bestand maken om een script aan de header toe te voegen.
U kunt dit bereiken door de onderstaande stappen te volgen:
- Log in op Typo3 beheerder,
- Selecteer “ Pagina ” > “ +Inhoud ” > klik op het tabblad Speciale elementen > Plain HTML
Bewerk het scriptbestand zodat het de scriptlink in het HTML-codegedeelte 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 TYPO3 CMS 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 TYPO3 CMS-inhoud
Om de Taalwisselaar op de specifieke plaats in de TYPO3 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 = '';