Module automatisch vertalen met DeepL

Met de hulp van deze package kun je gemakkelijk je ontwikkelde module snel en efficiënt vertalen naar verschillende talen. Het biedt de mogelijkheid om de vertalingen te exporteren naar een XLF-formaat, dat vervolgens automatisch geïmporteerd kan worden door PrestaShop 8.

Deze package maakt het vertaalproces veel eenvoudiger en bespaart je kostbare tijd en moeite. In plaats van handmatig elke vertaling te moeten maken en in te voeren in PrestaShop 8, hoef je alleen maar de module te gebruiken om de vertalingen te genereren en ze vervolgens te exporteren naar het XLF-formaat.

Het XLF-formaat is een veelgebruikt bestandsformaat voor het uitwisselen van vertalingen. Het maakt het gemakkelijk om vertalingen te delen en te importeren in verschillende platforms en systemen, waaronder PrestaShop 8.

Met deze package kun je dus moeiteloos je module vertalen naar meerdere talen, zonder dat je je zorgen hoeft te maken over de complexiteit van het handmatige vertaalproces. Het biedt een gestroomlijnde oplossing die ervoor zorgt dat je module snel en nauwkeurig wordt vertaald, zodat je een breder publiek kunt bereiken en je verkoop- en conversiecijfers kunt verhogen.

Hoe te gebruiken?

De packageis beschikbaar als package op packagist.org: https://packagist.org/packages/vanengers/prestashop-module-translation

1. Installeren via composer

Om de package te installeren voer je het volgende composer commando uit: composer require --dev vanengers/prestashop-module-translation

Op github kan je het hier zien: https://github.com/vanengers/prestashop-module-translation

2. DeepL registratie en apiKey

Bij DeepL api kan je een account aanmaken: https://www.deepl.com/nl/pro-api?cta=header-pro-api 

Als je dat hebt gedaan ga je naar de account pagina en zie je onderaan je Apicode.

3. Deze apikey gebruik je in de aanroep van het 'extract' command.

Dit command voer je uit als volgt: php vendor/bin/extract extract MODULENAME DEEPLAPIKEY --translate_to=de-DE,ru-RU,it-IT,es-ES,pl-PL --locale=en-GB

Natuurlijk vervang je wel de MODULENAME met de naam van je nieuwe module en de DEEPLAPIKEY met de apiKey die je van DeepL hebt gekregen.

Je geeft hier aan in welke talen je vertaald wilt hebben en je geeft aan in welke taal je de 'nog niet vertaalde' teksten hebt neergezet in je module. --locale=en-GB gebruik dus --locale=nl-NL als je de teksten in het Nederlands hebt genoteerd in je module.

--translate-to=en-GB  hier zet je de locale codes van de talen neer die je vertaald wilt hebben. Voor Engels zijn er twee locales, en-GB en en-US. HEt is het handigst voor een module als je beide locales aanlevert zodat de gebruiker van je module in beide gevallen de vertaling te zien krijgt.

Er wordt per vertaal-domein en per taal een xlf bestand voor PrestaShop aangemaakt. Zie:

4. Dit upload je naar je PrestaShop.

Dan is de module automatisch vertaald in de talen die je hebt opgegeven.

Vertalingen die door DeepL zijn vertaald betaal je voor; in het geval van een Free account heb je tot max 500.000 tekens gratis. 

De vertalingen worden in je module in de map config opgeslagen voor later gebruik. Zodat je nooit dubbel hoeft te vertalen natuurlijk. Wanneer je nieuwe teksten toevoegt aan je module en je het extract script opnieuw draait dan worden alleen de nieuwe teksten vertaald, de rest wordt uit deze translations.json gehaald.

Je bent klaar om modules te vertalen!

Heb je een module vertaal met deze package? Laat het ons weten in een comment!