Loco Translate: installeren, instellen en problemen oplossen
Laatst bijgewerkt:
Met Loco Translate pas je de Nederlandse teksten van je thema en plugins aan in het WordPress-beheer, zonder bestanden te downloaden. Handig als een knop “Add to cart” blijft heten of een vertaling je niet bevalt. Het gaat vaak mis op één punt: waar je de vertaling opslaat. Kies je de verkeerde plek, dan is je werk bij de volgende update weg.
Wat doet Loco Translate?
WordPress, thema’s en plugins halen hun teksten uit vertaalbestanden: .po (bewerkbaar), .mo (wat WordPress leest) en sinds WordPress 6.5 ook .l10n.php. Daarnaast zijn er .json-bestanden voor teksten in JavaScript, zoals in de blokeditor. Loco Translate laat je die bestanden bewerken in een editor in het beheer, maakt nieuwe talen aan en compileert de bestanden voor je.
Loco is bedoeld voor teksten die in de code staan (“Lees meer”, “Afrekenen”). Teksten die je zelf in pagina’s typt, vertaal je met een meertalige plugin zoals WPML of Polylang.
Installeren
- Ga naar Plugins → Nieuwe plugin, zoek op “Loco Translate”, installeer en activeer.
- Kies in het menu Loco Translate → Thema’s of Plugins het onderdeel dat je wilt vertalen.
- Klik bij de taal (Nederlands) op Bewerken, of maak via “Nieuwe taal” een vertaling aan.
- Kies bij een nieuwe vertaling de opslaglocatie Aangepast (Custom). Zie hieronder waarom.
Instellingen die ertoe doen
- Opslaglocatie. Loco kent drie plekken: Aangepast (
wp-content/languages/loco/), Systeem (wp-content/languages/pluginsofthemes) en Auteur (in de map van de plugin of het thema zelf). Alleen Aangepast is veilig: de map van de plugin wordt bij elke update vervangen, en de systeemmap wordt bijgewerkt door automatische taalpakketten. - Sjabloon (.pot). Loco vergelijkt je vertaling met het sjabloonbestand van de maker. Met “Synchroniseren” komen nieuwe teksten erbij en verdwijnen oude.
- Back-up van vertalingen. In de instellingen kun je Loco een aantal eerdere versies laten bewaren. Zet dat aan voor je grote wijzigingen doet.
- Schrijfrechten. Loco moet kunnen schrijven in
wp-content/languages. Onder het tabblad met de bestandscontrole zie je of dat lukt.
Veelvoorkomende problemen en oplossingen
Vertaling verdwenen na een update. De vertaling stond in de Auteur- of Systeemlocatie en is overschreven. Maak de vertaling opnieuw aan (of kopieer hem) naar de locatie Aangepast. Loco geeft de aangepaste vertaling voorrang op de andere bestanden.
Wijziging opgeslagen, maar niet zichtbaar op de site. Mogelijke oorzaken: de site of je gebruikersprofiel staat op een andere taal (Instellingen → Algemeen en je profiel), de pagina komt uit een cache, of de tekst wordt door JavaScript getoond en het bijbehorende .json-bestand is niet bijgewerkt. Leeg de cache, controleer de taal en sla de vertaling opnieuw op met een recente versie van Loco, zodat alle bestandstypen opnieuw worden gemaakt. Een verouderd .l10n.php-bestand van een oude kopie kan je wijziging ook overschaduwen.
De tekst staat niet in de lijst. Het sjabloon is verouderd: synchroniseer. Staat hij er dan nog niet in, dan is de tekst in de code niet vertaalbaar gemaakt of komt hij uit een andere plugin, of uit de database (bijvoorbeeld een instelling of een widget). Dan pas je hem aan op die plek.
Foutmelding over bestandsrechten. Loco kan niet schrijven. Laat de rechten van wp-content/languages controleren; op sommige servers mag WordPress alleen via FTP schrijven, dan vraagt Loco om FTP-gegevens.
Melding “Vertaling laden … werd te vroeg geactiveerd” in de log. Dat is een melding sinds WordPress 6.7 over plugins die vertalingen te vroeg laden. Loco lost dat niet op; de maker van die plugin moet het aanpassen. Zie debug.log lezen.
Loco naast meertalige plugins
Loco botst zelden, maar het verschil met meertalige plugins zorgt vaak voor verwarring. WPML en Polylang hebben elk een eigen “stringvertaling” voor teksten uit thema’s en plugins. Vertaal je dezelfde tekst op twee plekken, dan wint er één en lijkt de andere niet te werken. Spreek af waar je teksten uit code vertaalt: in Loco óf in de stringvertaling van je meertalige plugin. Bij TranslatePress vertaal je op de voorkant; ook daar geldt: kies één plek.
Veilig bijwerken
Een update van Loco zelf raakt je vertalingen niet. Een update van het thema of een plugin kan nieuwe teksten toevoegen: open daarna de vertaling, synchroniseer en vul de nieuwe teksten in. Maak vóór grote wijzigingen een back-up van wp-content/languages/loco/. Verhuis je de site, neem die map dan mee.
Wanneer schakel je hulp in?
Verdwijnen vertalingen steeds, toont de webshop half Engels en half Nederlands, of wil je een thema volledig in het Nederlands? Wij helpen met installeren, instellen, de juiste opslaglocatie, synchroniseren en het oplossen van vertaalproblemen.
Veelgestelde vragen
Waarom is mijn Loco-vertaling weg na een update?
Omdat de vertaling in de map van de plugin of in de systeemmap stond. Die worden bij updates overschreven. Sla vertalingen op in de locatie Aangepast (wp-content/languages/loco/).
Kan ik met Loco Translate mijn pagina’s vertalen?
Nee. Loco vertaalt teksten uit de code van thema’s en plugins. Voor de inhoud van pagina’s en berichten gebruik je een meertalige plugin zoals WPML, Polylang of TranslatePress.
Mijn vertaling staat erin, maar de site toont nog Engels. Hoe kan dat?
Controleer de taal van de site en van je profiel, leeg de cache en sla de vertaling opnieuw op. Teksten die met JavaScript worden getoond, hebben een eigen vertaalbestand dat ook bijgewerkt moet zijn.
Wat doet de knop Synchroniseren?
Die vergelijkt je vertaling met het sjabloonbestand van de maker. Nieuwe teksten komen erbij, verdwenen teksten worden gemarkeerd of weggehaald.
Hulp nodig met Loco Translate?
Wij helpen met installeren, instellen, bijwerken en het oplossen van fouten en conflicten. Vertel wat er speelt; je hoort vooraf wat we gaan doen.
Hulp aanvragen Site plat? SpoedhulpLees ook: WPML · Polylang · TranslatePress · WooCommerce · debug.log lezen · alle WordPress-plugins