Inhoudsopgave
Technische vereisten Craft CMS
Voor de neurale automatische vertaling die met Craft CMS gebruikt moet worden, is een PHP-script nodig (dat hieronder gedownload kan worden). Om het Linguise script te installeren, heb je de volgende vereisten nodig:
- Ondersteunt PHP 7+
- Apache, LiteSpeed, NGINX, IIS-server
- Zorg ervoor dat URL-herschrijving is geactiveerd op uw server
- Craft CMS 3 of 4 en hoger
- De hoofdmap van Craft CMS doorgaans /web ".
1. Genereer de API-sleutel
Nadat je verbinding hebt gemaakt met of je hebt geregistreerd op je Linguise dashboard , moet je eerst een nieuw domein instellen en de instellingen opslaan om de API-sleutel te verkrijgen.
Selecteer het Craft CMS platform om de juiste link naar deze documentatie en de bron- en doeltaal te verkrijgen.
Daarna ontvang 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 Craft CMS website te activeren. De API-sleutel controleert welke taal op uw domein is geactiveerd en maakt automatische vertaling van de inhoud mogelijk.
Voorlopig kun je de API-sleutel kopiëren en in je klembord bewaren.
2. Upload en verbind het Linguise vertalingsscript
Het Linguise vertalingsscript moet worden geüpload naar de server waarop Craft CMS is geïnstalleerd:
Nadat het script is gedownload, pak je het uit en upload je het naar de hoofdmap waar Craft CMS is geïnstalleerd.
- Zorg ervoor dat het zich op het hoogste niveau van je website bevindt (waar je Craft CMS bestanden zich bevinden; standaard is dit in /web ).
- Zorg ervoor dat de map de standaardnaam " linguise "
Hoe krijg ik toegang tot Linguise Script-interface?
Na de Linguise
linguise volgende URL: https://www.domein.com/linguise
Wijzig het domeinadres naar het adres van uw website.*
Zorg ervoor dat Linguise de juiste lees- en schrijfrechten heeft.*
Stel een wachtwoord en databaseverbinding in
Zodra je de scriptinterface opent, krijg je een instelscherm te zien waar je een wachtwoord kunt aanmaken en verbinding kunt maken met de database van je keuze.
Je kunt:
- Stel een wachtwoord in, dat vereist is voor toekomstige toegang tot deze interface.
- Kies het type database dat bij uw configuratie en voorkeur past: MySQL of SQLite.
Deze initiële configuratie zorgt voor veilige toegang en stelt u in staat het script aan te passen aan uw omgeving.
MySQL-databaseverbinding
Als u voor MySQL kiest, verschijnt er een andere interface waarin u de volgende verbindingsgegevens voor de MySQL-configuratievelden moet invullen:
Zorg ervoor dat de informatie correct is om een succesvolle verbinding met uw MySQL-database tot stand te brengen.
MySQL versus SQLite – Wat is het verschil?
Zowel MySQL als SQLite zijn populaire databasesystemen die worden gebruikt voor het opslaan en beheren van gegevens voor websites en applicaties. Ze zijn echter ontworpen voor verschillende toepassingen en hebben een aantal belangrijke verschillen:
| Functie | SQLite | MySQL |
|---|---|---|
| Instellen | Heel eenvoudig (SQLite-installatie vereist) | Serverconfiguratie is vereist |
| Opslag | Enkele rij | Beheerd door MySQL-server |
| Prestatie | Uitstekend geschikt voor kleinschalige apps | Beter geschikt voor grote systemen met veel verkeer |
| Gebruikscase | Lokale apps, testen, kleine websites | Webapplicaties, e-commerce, bedrijfssystemen |
Linguise Script Interface: Installatie voor PHP-platform
Het Linguise vertaaldashboard, dat voorheen alleen beschikbaar was voor Joomla en WordPress, biedt nu ook ondersteuning voor PHP en andere platforms. Dankzij deze update kunnen gebruikers taalinstellingen – zoals weergaveopties, vlagstijlen en uiterlijke aanpassingen – naadloos configureren vanuit één uniforme interface, ongeacht hun CMS of framework.
Beheerders kunnen Linguise instellingen efficiënter beheren dankzij consistente functies zoals pop-ups voor taalselectie, schaduweffecten en regiospecifieke vlagopties. Het dashboard behoudt zijn gebruiksvriendelijke ontwerp en biedt tegelijkertijd bredere compatibiliteit voor diverse webomgevingen.
3. Stel de URL-herschrijving in Craft CMS
Standaard is URL-herschrijving actief in Craft CMS. Als dit niet het geval is, kunt u dit activeren via uw hostingprovider.
De URL per taal moet worden geconfigureerd in het .htaccess-bestand. Kopieer de onderstaande code na de code " RewriteEngine on " die standaard in het Craft CMS .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>
Tot slot zou uw Craft CMS .htaccess-bestand er ongeveer zo uit moeten zien:
<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]
# Send would-be 404 requests to Craft
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !^/(favicon\.ico|apple-touch-icon.*\.png)$ [NC]
RewriteRule (.+) index.php?p=$1 [QSA,L]
</IfModule>
Je kunt nu al je vertaalde pagina's laden via de URL, bijvoorbeeld: www.shop.com/fr/
Laten we nu de taalschakelaar laden.
4. Activeer de taalschakelaar
4.1 Laad het Linguise JS-script
De Linguise JS-scriptlink moet op al uw Craft CMS pagina's worden geladen om de taalschakelaar met vlaggen en alternatieve URL's in uw HTML-headers weer te geven (voor SEO-doeleinden).
Om de scriptlink te kopiëren, ga je vanuit het Linguise dashboard naar de domeininstellingen en kopieer je de scriptlink.
De eenvoudigste manier om deze code in craft CMS , is door deze toe te voegen aan je template-index. Open de map /template en bewerk het indexbestand om de scriptlink in de header op te nemen.
De taalschakelaar is een pop-upvenster waarmee je de gewenste taal kunt selecteren. Om deze te laden, kopieer je de code die aan het einde van de websiteconfiguratie staat naar de <head> van je HTML-pagina. De taalschakelaar wordt dan automatisch geladen.
De taalschakelaar wordt standaard zwevend rechtsboven op uw website weergegeven. U kunt deze naar wens aanpassen, zoals uitgelegd in het volgende hoofdstuk.
Belangrijke SEO-opmerking: Het aantal talen dat u instelt, heeft een grote impact op SEO. Als u veel pagina's (>500) hebt geïndexeerd, kan het verwerken van de vertalingen door zoekmachines veel tijd in beslag nemen. Dit kan uw SEO in de oorspronkelijke taal negatief beïnvloeden. Daarom raden we aan om in eerste instantie maximaal 5 talen toe te voegen. Zodra deze pagina's zijn geïndexeerd, kunt u maandelijks 3 talen toevoegen.
Stel de taalwisselaar in
De taalschakelaar kan worden aangepast via het Linguise dashboard > Instellingen > Weergave taalvlaggen. Elke wijziging die u hier aanbrengt, wordt automatisch op de website doorgevoerd.
Aan de rechterkant van het scherm ziet u een voorbeeld van de taalschakelaar. Dit zijn de elementen die u kunt instellen:
- 3 lay-outs: naast elkaar, dropdown of pop-up
- De positie van de taalwisselaar
- De inhoud van de taalwisselaar
- Taalnamen in het Engels of de moedertaal
- Vlaggen vormen en grootte
- Kleuren en schaduw van de doos
Laad de taalschakelaar in Craft CMS content
Om de taalschakelaar op een specifieke plek in de Craft CMS content weer te geven, moet u de positie instellen op 'Op de juiste plaats'. Linguise
hebt ingesteld , kunt u de onderstaande shortcode toevoegen om deze te integreren. Klik op de code hieronder om deze naar uw klembord te kopiëren.
<div>[linguise]</div>
Zodra het is toegevoegd, worden de vlag- en taalnamen op de frontend weergegeven in het HTML-gedeelte waar je de code hebt geplaatst.
Activeer de optie voor het lokale cachesysteem
Als optie kunt u een lokaal cachesysteem activeren dat URL's en de bijbehorende meertalige inhoud opslaat om pagina's sneller te laden. De lokale cache bespaart dataverkeer tussen Linguise server en uw website-server. De cache wordt alleen gebruikt wanneer een pagina al is vertaald en niet is bijgewerkt. De cache van de meest bezochte meertalige pagina's krijgt prioriteit.
Als aanvulling daarop kunt u de hoeveelheid cachegeheugen in MB definiëren. In het volgende voorbeeld is de cache geactiveerd en is de te bewaren hoeveelheid cachegeheugen 500 MB.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Automatische vertaling op Windows IIS-servers
Voeg de regel die overeenkomt met uw websitebouwer toe aan uw Web.config-bestand.
Deze moet vóór elke andere omleiding worden ingesteld, met name vóór de omleiding naar uw PHP-hoofdbestand:
<rule name="Linguise" stopProcessing="true">
<match url="^(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)(?:$|/)(.*)$" ignoreCase="false" />
<conditions logicalGrouping="MatchAll" trackAllCaptures="false" />
<action type="Rewrite" url="linguise/linguise.php?linguise_language={R:1}&original_url={R:2}" appendQueryString="true" />
</rule>
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;