Inhoudsopgave
Magento technische vereisten
Voor neurale automatische vertaling in combinatie met Magento is een PHP-script nodig (dat u hieronder kunt downloaden). Om het Linguise script te installeren, heeft u de volgende vereisten nodig:
- Voer PHP 7+ uit
- Apache, LiteSpeed, NGINX, IIS-server
- Activeer URL-herschrijving via de Magento -configuratie
- Magento 2+
- De hoofdmap van Magento /pub ". Zorg ervoor dat je Linguise in deze map
Genereer de API-sleutel
De API-sleutel is nodig om de vertaling op uw Magento -website te activeren. De API-sleutel controleert welke taal op welk domein is geactiveerd en maakt het mogelijk om de pagina's met neurale vertaling te genereren.
Kopieer de API-sleutel en bewaar deze in uw klembord.

Klik vervolgens op het tabblad "PHP-script" voor de installatie-instructies die we hieronder in detail zullen volgen.

Upload en verbind het Linguise vertalingsscript
Het Linguise vertalingsscript moet worden geüpload naar de server waarop Magento is geïnstalleerd:
Nadat het script is gedownload, pak je het uit en upload je het naar de hoofdmap waar het CMS is geïnstalleerd.
- Zorg ervoor dat het zich op het hoogste niveau van uw website bevindt (waar uw Magento bestanden zich bevinden; standaard is dit in /pub ).
- Zorg ervoor dat de map de standaardnaam " linguise "

Hoe toegang te krijgen tot de interface van Linguise -script?
Nadat u de Linguise -installatie hebt voltooid, kunt u toegang krijgen tot het dashboard door uw website te bezoeken met het volgende URL -formaat:
https://www.domain.com/ linguise
Wijzig het domeinadres volgens uw website -adres*
Zorg ervoor dat Linguise de juiste lees- en schrijf toestemming heeft*
Wachtwoord instellen en databaseverbinding
Nadat u toegang hebt tot de scriptinterface, krijgt u een setup -scherm gepresenteerd waar u een wachtwoord kunt maken en verbinding kunt maken met uw voorkeursdatabase.
U kunt:
- Stel een wachtwoord in, dat vereist is voor toekomstige toegang tot deze interface.
- Kies uw databasetype - MySQL of SQLite, afhankelijk van uw installatie en voorkeur.
Deze eerste opstelling zorgt voor veilige toegang en stelt u in staat om het script te configureren volgens uw omgeving.

MySQL -databaseverbinding
Als u MySQL kiest, verschijnt er een andere interface om de volgende verbindingsdetails van MySQL -configuratievelden hieronder te vragen:

Zorg ervoor dat de informatie correct is om een succesvolle verbinding tot stand te brengen met uw MySQL -database.
MySQL vs Sqlite - Wat is het verschil?
Zowel MySQL als SQLite zijn populaire databasesystemen die worden gebruikt om gegevens op te slaan en te beheren voor websites en applicaties. Ze zijn echter ontworpen voor verschillende use cases en hebben enkele belangrijke verschillen:
| Functie | Sqlite | MySQL |
|---|---|---|
| Instellen | Zeer eenvoudig (sqlite -installatie vereist) | Vereist Server Setup |
| Opslag | Enkel bestand | Beheerd door MySQL Server |
| Prestatie | Geweldig voor kleinschalige apps | Beter voor grote systemen met veel verkeer |
| Gebruikscase | Lokale apps, testen, kleine sites | Web -apps, e -commerce, bedrijfssystemen |
Linguise Script Interface: Setup voor PHP -platform
Het Linguise Translation Dashboard, voorheen alleen beschikbaar voor Joomla en WordPress, breidt nu ondersteuning uit aan PHP en extra platforms. Met deze update kunnen gebruikers naadloos taalinstellingen configureren - zoals weergave -opties, vlagstijlen en aanpassing van het uiterlijk - direct vanuit een uniforme interface, ongeacht hun CMS of framework.

Beheerders kunnen Linguise efficiënter beheren, met consistente functies zoals taalselectie-pop-ups, schaduweffecten en regiospecifieke vlagkeuzes varianten. Het dashboard behoudt zijn gebruiksvriendelijke ontwerp en biedt een bredere compatibiliteit voor diverse webomgevingen.


Extra Magento -configuratie
Ga in de beheerderszijbalk naar Winkels > Instellingen > Configuratie > Algemeen > Web > URL-opties en stel de 'Winkelcode toevoegen aan URL's' in op ' Nee '.

Open de code van je website en ga naar app/etc/env.php . Stel 'document_root_is_pub' in op true.

Zorg ervoor dat je beide stappen uitvoert en ga verder met het instellen van URL-herschrijving om ervoor te zorgen dat Linguise probleemloos op je Magento -website kan werken.
Stel het herschrijven van URL's in
Ga in de zijbalk van het beheerderspaneel naar Winkels > Instellingen > Configuratie > Algemeen > Web > Zoekmachineoptimalisatie en schakel de Webserver herschrijven gebruiken' . Meer informatie vindt u in de officiële Magento documentatie.

De URL per taal moet worden geconfigureerd in het .htaccess-bestand. Kopieer deze code na de code " RewriteEngine on " in het standaard Magento 2 .htaccess-bestand:
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,END]
Tot slot zou uw Magento .htaccess-bestand er ongeveer zo uit moeten zien:

Activeer de taalschakelaar
Laad het Linguise JS-script
U kunt nu al uw vertaalde pagina's laden via de URL, bijvoorbeeld: www.shop.com /fr/

De taalwisselaar is de vlagpop-up waarmee u de gewenste taal kunt selecteren. Om het te laden, moet u de code aan het einde van de websiteconfiguratie naar de kop van uw HTML-pagina kopiëren. De vlagtaalwisselaar wordt dan automatisch geladen.
De code die je moet kopiëren en in de header van je website moet plaatsen, vind je in je Linguise dashboard > Je domein > Instellingen > Tabblad: PHP-script

Het moet in de header van je pagina worden geladen. Magento 2 biedt je de mogelijkheid om via de configuratie content in de head van je pagina toe te voegen.

Ga in het beheerderspaneel naar Inhoud > Configuratie , bewerk de standaardweergave van je winkelthema, klik vervolgens op het gedeelte HTML-header en voeg het gekopieerde script toe aan het invoerveld Scripts en stijlbladen. Sla tot slot de configuratie op.

Installeer de Magento -beveiligingsmodule
Sinds Magento 2.3.5 moet je een beveiligingsmodule toevoegen om Magento bestanden van Linguise domein te laten laden. Als je bekend bent met Magento , is dat geen probleem. Zo niet, dan vind je hier een stapsgewijze handleiding:
- Download de module via deze link.
- Pak de inhoud van het zipbestand uit in de map app/code/ van je Magento -installatie
- Voer vervolgens de volgende opdrachten uit:
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
De taalschakelaar wordt standaard zwevend rechtsonder op uw website weergegeven. U kunt deze naar wens aanpassen via het Linguise dashboard.

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 pop-up
- 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 taalschakelaar in Magento content

Om de taalschakelaar op een specifieke plek in de Magento -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.
[linguise]
Zodra het is toegevoegd, worden op de frontend de vlag- en taalnamen weergegeven in het HTML-gebied waar u de code heeft toegevoegd.
Activeer het lokale cachesysteem
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.

Als optie kunt u de hoeveelheid cachegeheugen in MB instellen. 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