Handleiding voor vertaling en Poedit

Dit document legt uit hoe de ADP Car Market Hub-plugin omgaat met meertalige WordPress-sites, welke vertaalbestanden met de plugin worden meegeleverd en hoe u plugin-teksten kunt vertalen of bijwerken met Poedit of vergelijkbare tools.

Wanneer u dit document moet gebruiken

Gebruik dit document als u:

• De plugin instelt op een site waarvan de WordPress-taal niet Engels is en u wilt controleren of de vertalingen worden geladen.
• Een dealer of bureau bent die vertalingen toevoegt of corrigeert voor een taal die al in de plugin is opgenomen.
• Een ontwikkelaar bent die een nieuw taalbestand bijdraagt voor een locale die nog niet met de plugin is meegeleverd.
• Problemen oplost met plugin-teksten die in het Engels verschijnen terwijl de sitetaal is ingesteld op een andere locale.

De doelgroep is een WordPress-beheerder of een ontwikkelaar die vertrouwd is met de WordPress-internationaliseringsworkflow en basisgebruik van de opdrachtregel.

Overzicht

De plugin maakt gebruik van het standaard WordPress-lokalisatiemechanisme. Alle voor de gebruiker zichtbare teksten in de PHP-code van de plugin zijn verpakt in WordPress-vertaalfuncties (__(), _e(), esc_html__() en dergelijke) met het textdomain adp-car-market-hub. WordPress laadt het bijbehorende vertaalbestand uit de map languages/ van de plugin wanneer de sitetaal is ingesteld in Instellingen → Algemeen → Sitetaal.

De volgende taalbestanden zijn op het moment van schrijven bij de plugin inbegrepen:

Controleer de actuele lijst door de map languages/ in de plugin-map (wp-content/plugins/adp-car-market-hub/languages/) te bekijken. Elke locale heeft een .po-bronbestand (door mensen te bewerken) en, indien er een gecompileerd .mo-bestand aanwezig is, is dat het bestand dat WordPress daadwerkelijk laadt tijdens runtime.

Als de site een locale gebruikt die niet in de bovenstaande lijst staat, toont de plugin alle teksten in de terugvaltaal, namelijk het Engels.

Systeemvereisten

• Toegang als WordPress-beheerder.
• Voor het bewerken van vertalingen: Poedit (https://poedit.net/) of een vergelijkbare editor voor .po- / .mo-bestanden, of de Loco Translate WordPress-plugin (https://wordpress.org/plugins/loco-translate/).
• Voor het genereren van een nieuw POT-bestand: WP-CLI versie 2.6 of hoger, of het make-pot.sh-script in bin/make-pot.sh.
• Voor het compileren van .mo-bestanden vanaf de opdrachtregel: het hulpprogramma GNU gettext msgfmt, of het WP-CLI-commando wp i18n make-mo.

Hoe de plugin vertalingen laadt

De plugin roept load_plugin_textdomain() aan bij de actie plugins_loaded met prioriteit 1. Dit betekent dat het vertaalbestand voor de huidige sitetaal wordt geladen voordat er andere plugin-code op de standaardprioriteit wordt uitgevoerd, zodat alle beheer- en frontend-teksten beschikbaar zijn voor vertaling vanaf het moment dat de plugin initialiseert.

WordPress zoekt het taalbestand in de volgende volgorde:

1. wp-content/languages/plugins/adp-car-market-hub-{locale}.mo (vertaalbestanden geïnstalleerd door WordPress zelf of door een vertaalbeheertool).
2. wp-content/plugins/adp-car-market-hub/languages/adp-car-market-hub-{locale}.mo (bestanden die met de plugin zijn meegeleverd).

Bestanden in wp-content/languages/plugins/ hebben prioriteit. Als u een meegeleverde vertaling bijwerkt met een plugin zoals Loco Translate, wordt het bijgewerkte bestand doorgaans op het eerste pad opgeslagen, wat voorkomt dat uw wijzigingen worden overschreven wanneer de plugin wordt bijgewerkt.

Stapsgewijze instructies

Een bestaande meegeleverde vertaling gebruiken

1. Open in WordPress Instellingen → Algemeen.
2. Stel Sitetaal in op de gewenste locale (bijvoorbeeld Duits (Zwitserland) voor de_CH).
3. Sla de instellingen op.
4. Navigeer naar een beheerpagina van de plugin of bezoek het voertuigarchief op de frontend. De teksten van de plugin (labels, knoppen, foutmeldingen) moeten in de geselecteerde taal verschijnen.
5. Als er nog steeds teksten in het Engels verschijnen, raadpleeg dan Problemen oplossen hieronder.

Een bestaande vertaling bewerken of corrigeren met Poedit

1. Download en installeer Poedit vanaf https://poedit.net/.
2. Zoek het .po-bestand voor de locale die u wilt bewerken in de map languages/ van de plugin. Bijvoorbeeld: wp-content/plugins/adp-car-market-hub/languages/adp-car-market-hub-de_CH.po.
3. Open het .po-bestand in Poedit.
4. Zoek de tekst die u wilt wijzigen in de lijst met teksten. De kolom Brontekst toont het Engelse origineel en de kolom Vertaling toont de huidige vertaalde waarde. Klik op een rij om de vertaling in het bewerkingsvenster eronder aan te passen.
5. Sla het bestand op. Poedit compileert automatisch het bijbehorende .mo-bestand in dezelfde map.
6. Aanbevolen: Kopieer de bijgewerkte .po- en .mo-bestanden naar wp-content/languages/plugins/ zodat plugin-updates ze niet overschrijven: - wp-content/languages/plugins/adp-car-market-hub-de_CH.po - wp-content/languages/plugins/adp-car-market-hub-de_CH.mo
7. Wis eventuele WordPress-caching die verouderde uitvoer kan serveren en controleer vervolgens de wijziging op de relevante plugin-pagina.

Een bestaande vertaling bewerken met Loco Translate

1. Installeer en activeer de Loco Translate-plugin vanuit de WordPress-pluginmap.
2. Navigeer in WordPress naar Loco Translate → Plugins.
3. Zoek ADP Car Market Hub in de lijst en klik erop.
4. Selecteer de taal die u wilt bewerken.
5. Bewerk de teksten in de Loco Translate-editor en sla ze op. Loco Translate compileert het .mo-bestand automatisch en slaat uw wijzigingen op in wp-content/languages/plugins/, waardoor ze beschermd zijn tegen plugin-updates.

Een vertaling maken voor een nieuwe taal

1. Open het POT-sjabloonbestand: wp-content/plugins/adp-car-market-hub/languages/adp-car-market-hub.pot. Het POT-bestand bevat alle vertaalbare teksten in de plugin zonder vertalingen.
2. Kies in Poedit Bestand → Nieuw van POT/PO-bestand, selecteer het .pot-bestand en kies de doeltaal.
3. Vertaal de teksten.
4. Sla op als adp-car-market-hub-{locale}.po en compileer naar adp-car-market-hub-{locale}.mo. Gebruik exact de locale-code die WordPress voor die taal gebruikt (bijvoorbeeld fr_CH voor Frans (Zwitserland)). Controleer de code in Instellingen → Algemeen → Sitetaal.
5. Plaats beide bestanden in wp-content/languages/plugins/ zodat ze niet worden overschreven door plugin-updates.
6. Stel de sitetaal in en controleer of de nieuwe vertaling correct wordt geladen.

Vertaalbestanden bijwerken na een plugin-update

Wanneer de plugin wordt bijgewerkt, kunnen er nieuwe teksten worden toegevoegd. De meegeleverde .po-bestanden worden bijgewerkt door de onderhouders van de plugin, maar eventuele aangepaste vertalingen die buiten de plugin-map zijn opgeslagen, worden niet automatisch ververst.

Om uw aangepaste vertaalbestand up-to-date te brengen:

1. Download het bijgewerkte POT-bestand uit de map languages/ van de plugin.
2. Open uw aangepaste .po-bestand in Poedit, kies vervolgens Vertaling → Bijwerken van POT-bestand en selecteer het nieuwe .pot-bestand. Poedit voegt de nieuwe teksten samen in uw bestand en markeert onvertaalde teksten voor uw aandacht.
3. Vertaal de nieuwe teksten.
4. Sla op en compileer.

Als u WP-CLI gebruikt, kunt u een .po-bestand bijwerken met msgmerge:

msgmerge --update languages/adp-car-market-hub-de_CH.po languages/adp-car-market-hub.pot

Compileer het bijgewerkte bestand:

msgfmt -o languages/adp-car-market-hub-de_CH.mo languages/adp-car-market-hub-de_CH.po

Of compileer alle .po-bestanden tegelijk met WP-CLI:

wp i18n make-mo languages/

Configuratiereferentie

Er is geen speciale pagina voor vertaalinstellingen in het beheergedeelte van de plugin. Vertalingen worden volledig afgehandeld via de WordPress-sitetaalinstelling en het standaard WordPress-lokalisatiesysteem.

Operationele opmerkingen

• Textdomain. Elke vertaalbare tekst in de plugin gebruikt het textdomain adp-car-market-hub. Dit textdomain is gedeclareerd in de plugin-header en moet overeenkomen met het bestandsnaamvoorvoegsel van vertaalbestanden (bijvoorbeeld adp-car-market-hub-de_DE.mo). Een mismatch tussen textdomain en bestandsnaam is de meest voorkomende reden waarom teksten niet worden vertaald.
• Gecompileerde .mo-bestanden zijn vereist tijdens runtime. WordPress leest gecompileerde .mo-bestanden, niet de voor mensen leesbare .po-bronbestanden. Compileer een nieuw of bijgewerkt .po-bestand altijd naar .mo voordat u verwacht wijzigingen in de browser te zien.
• Formeel vs. informeel Duits. De locale de_DE_formal biedt een formele aanspreekvorm (Sie) voor het Duits. Kies deze locale op sites waar formele formuleringen worden verwacht.
• Zowel frontend- als beheerteksten worden gedekt. Het textdomain van de plugin bevat teksten voor zowel beheerpagina's (instellingen, importstatus, logs) als frontend-uitvoer (voertuiglabeletiketten, filterlabels, berichten van het contactformulier, financieringscalculator). Beide sets teksten bevinden zich in hetzelfde .po- / .mo-bestand.
• WordPress-taalpakketten. Als het WordPress-taalpakketsysteem een communityvertaling heeft voor adp-car-market-hub voor de geselecteerde locale, kan WordPress aanbieden deze automatisch te downloaden. Bestanden die op deze manier zijn verkregen, worden opgeslagen in wp-content/languages/plugins/ en worden samen met de WordPress-core bijgewerkt. Controleer of de communityvertaling compleet is voordat u deze in productie gebruikt.
• Caching. Als vertalingen na een wijziging niet verschijnen, wis dan eventuele WordPress-objectcache, paginacache of opcode-cache. Gecachte bytecode van oude .mo-bestanden kan blijven bestaan totdat de cache wordt geleegd.
• Documentatiebestanden. De documentatie in docs/ is uitsluitend in het Engels geschreven. Er zijn geen vertaalde documentatiebestanden. Het vertalen van PHP-teksten van de plugin (zoals beschreven in deze handleiding) en het vertalen van documentatie zijn afzonderlijke zaken.

Problemen oplossen

Gerelateerde documenten

• Installatiehandleiding
• Eerste installatie
• Go-live checklist
• Staging to Live Migration
• Theme Integration