Inhoudsopgave
PyroCMS technische vereisten
Voor de neurale automatische vertaling die met PyroCMS 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, LiteSpeed, NGINX, IIS-server
- Zorg ervoor dat het herschrijven van URL's is geactiveerd op uw server
- PyroCMS 3 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 PyroCMS 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 PyroCMS is geïnstalleerd:
Nadat het script is gedownload, pakt u het uit en uploadt u het naar de hoofdmap waar PyroCMS is geïnstalleerd.
- Zorg ervoor dat deze zich op het hoofdniveau van uw website bevindt (waar uw PyroCMS bestanden zich bevinden, standaard bevindt deze zich in de map /public )
- Zorg ervoor dat de map de standaardnaam " linguise "
Laat het ons weten. Neem contact met ons .
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 PyroCMS URL's in
Standaard is het herschrijven van URL's actief in PyroCMS . 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 de standaard PyroCMS .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]
Ten slotte zou uw PyroCMS .htaccess er ongeveer zo uit moeten zien:
Options -MultiViews
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]
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 PyroCMS 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 PyroCMS is door deze toe te voegen aan de header of het code. PyroCMS wordt geleverd met een speciale omgeving en heeft een specifiek bestand om een script aan de header toe te voegen.
Het bevindt zich in scripts.twig en u kunt het vinden door hier in uw CMS-installatiemap te navigeren:
vendor/ pyrocms /*YOUR_THEME*/resources/views/partials/scripts.twig . Standaard PyroCMS thema een startersthema.
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 PyroCMS 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 PyroCMS inhoud
Om de Taalwisselaar op de specifieke plaats in de PyroCMS 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;