Inhoudsopgave
Technische vereisten voor Zen Cart CMS
Voor de neurale automatische vertaling die met Zen Cart 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:
- Voer PHP 7+ uit
- Apache, NGINX
- Zorg ervoor dat het herschrijven van URL's is geactiveerd op uw server
- Zen Cart CMS 1.5.x 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 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 Zen Cart CMS-website te activeren. De API-sleutel controleert welke taal op uw domein is geactiveerd en maakt 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 vertalingsscript moet worden geüpload naar de server waarop Zen Cart CMS is geïnstalleerd. Download het hier.
Nadat het script is gedownload, pak je het uit en upload je het naar de hoofdmap waar het Zen Cart CMS is geïnstalleerd.
- Zorg ervoor dat het bestand zich in de hoofdmap van uw website bevindt (waar uw Zen Cart CMS-bestanden zich bevinden).
- 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.


3. Stel de URL-herschrijving in voor het Zen Cart CMS
Standaard is URL-herschrijving actief in Zen Cart 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 " in het standaard Zen Cart CMS .
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.
4. Activeer de taalwisselaar
4.1 Laad het Linguise JS-script
De Linguise JS-scriptlink moet op al uw Zen Cart 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, gaat u vanuit het Linguise dashboard naar de domeininstellingen en kopieert u de scriptlink.

De eenvoudigste manier om deze code in Zen Cart CMS te laden, is door deze in de header van je website te plaatsen of Zen Zen Cart CMS wordt geleverd met een sjabloon met een gedeelte voor de header, en er is een specifiek bestand om het Linguise script in dat headergedeelte te laden.
Het bevindt zich in tpl_header.php , dat je kunt vinden door naar de installatiemap van je CMS te navigeren (zie onderstaande link). In dit voorbeeld is het de standaard Zen Cart CMS-template genaamd responsive_classic:
/includes/template/*JE_TEMPLATE*/common/tpl_header.php.
Bewerk het scriptbestand en voeg de scriptlink toe aan de header, zoals hieronder weergegeven.

De taalschakelaar wordt standaard zwevend rechtsonder op uw website weergegeven. U kunt deze naar wens aanpassen, 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 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 Zen Cart inhoud

Om de taalschakelaar op een specifieke plek in de Zen Cart 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 plaatsen. 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 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;
Van SQLite naar MySQL
In het Configuration.php-bestand is er nog steeds een instelling om het gebruik van MySQL af te dwingen in plaats van SQLite, voor het geval SQLite niet op de server is geïnstalleerd.
In dit geval moet u de MySQL-gegevens invullen in dit gedeelte 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 = '';