DF Translate: volledige handleiding

DF Translate maakt uw WordPress-site en uw WooCommerce-winkel echt meertalig. Elke vertaling is een volwaardige inhoud in de database (zoals bij Polylang of WPML), geen tekstlaag die ter plekke wordt herschreven. Dat garandeert een vlekkeloze SEO en volledige compatibiliteit met uw thema, uw page builder en uw plugins. De automatische vertaling is optioneel en werkt met uw eigen API-sleutel. Deze handleiding behandelt de installatie, het instellen van de talen en de AI-motor, het vertalen van inhoud en teksten, meertalige SEO, de editor met bron en doel naast elkaar, de migratie vanuit Polylang, WooCommerce en het oplossen van problemen.

Installatie

1. Download het archief dftranslate.zip vanuit uw DataFirefly-account.
2. WordPress-beheer → Plugins → Nieuwe plugin → Plugin uploaden → verstuur de ZIP en klik daarna op Activeren.
3. Bij activering maakt de plugin haar tabellen aan (vertaalgroepen, teksten, tekstvertalingen) en voegt ze het menu DF Translate toe.

In vijf minuten aan de slag

1. Open DF Translate → Instellingen, tabblad Talen, en voeg uw tweede taal toe uit de lijst met voorinstellingen (de gratis versie ondersteunt 2 talen). Bepaal de standaardtaal.
2. Tabblad Vertaling: kies een AI-motor en vul uw API-sleutel in (of laat het leeg om alles handmatig te vertalen). Klik op Verbinding testen.
3. Open een bericht of een product: klik in het vak Taal en vertalingen op ⚡ Aanmaken en vertalen voor de doeltaal.
4. Lees de vertaling na in de editor met bron en doel naast elkaar en publiceer ze daarna.
5. Voeg de taalkiezer toe aan uw site (blok, widget, menu of beheerbalk) zodat uw bezoekers van taal kunnen wisselen.

De talen instellen

Alles gebeurt in DF Translate → Instellingen → Talen.

Een taal toevoegen

Gebruik de keuzelijst met voorinstellingen (27 talen met vooraf ingevulde code, locale, naam en vlag) of de knop Aangepast… om de code (bijvoorbeeld de), de locale (bijvoorbeeld de_DE) en de weergavenaam handmatig in te voeren. De gratis versie staat 2 talen toe; DF Translate Pro maakt het aantal onbeperkt.

Standaardtaal, volgorde en verwijderen

De standaardtaal is die van uw oorspronkelijke inhoud (die krijgt geen URL-voorvoegsel). Herschik de talen met de pijlen ▲▼ (die volgorde komt terug in de taalkiezer) en verwijder er een met ✕. Een taal uit de configuratie halen vernietigt de inhoud niet: die blijft in de database staan en wordt opnieuw gekoppeld als u de taal weer toevoegt.

De AI-vertaalmotor instellen

Kies in DF Translate → Instellingen → Vertaling de motor en vul uw sleutel in.

• Claude (Anthropic): de beste schrijfkwaliteit, ideaal voor marketingteksten en productpagina’s.
• DeepL: uitstekende prijs-kwaliteitverhouding, met een gratis niveau.
• OpenAI: generieke GPT-motor.
• LibreTranslate: zelfgehoste server, voor volledige controle over uw gegevens (u geeft de URL van uw instantie op).

Met het veld Toon stuurt u de stijl bij (bijvoorbeeld “professioneel” of “hartelijk”). Uw sleutels worden versleuteld opgeslagen (libsodium, met terugval op OpenSSL) en worden nooit aan de bezoekerszijde blootgesteld.

Inhoud vertalen

Elk bericht, elke pagina, elk product, elke categorie en elke tag heeft in de editor een vak Taal en vertalingen, en in de overzichten een kolom Taal.

Vanuit de editor

Het vak toont de taal van de inhoud en de status van elke vertaling. Voor elke ontbrekende taal maakt ⚡ Aanmaken en vertalen de vertaling aan en vult die met de AI-motor; zonder ingestelde motor maakt + Aanmaken een lege opzet aan. Inhoud die door AI is vertaald, krijgt de markering ⚑ MT (“na te lezen”) tot een mens ze bewerkt.

Vanuit de overzichten (vertaalmatrix)

In de kolom Taal toont een matrix per regel: de eigen taal (volledige vlag), een link ✎ naar elke bestaande vertaling (stippellijn bij een concept, oranje bij verouderd) en een knop ⚡ of + om de ontbrekende aan te maken. Bij inhoud zonder taal (“wezen”) kunt u de taal rechtstreeks in de cel toewijzen.

Filteren en in bulk bewerken

Boven de overzichten filteren weergavelinks op taal, met tellers, plus een weergave ⚑ Na te lezen. De taal is ook in te stellen via Snel bewerken en Bulkbewerking (met de optie “Geen wijziging” om regels die er niets mee te maken hebben niet te overschrijven).

De editor met bron en doel naast elkaar

Vanuit een vertaling opent de knop ⇆ Naast elkaar (in het vertaalvak, de rijacties of de editor) een scherm dat de bron en het doel vergelijkt: titel, slug, samenvatting en SEO-metagegevens netjes uitgelijnd. Elk veld heeft een knop ⧉ (kopiëren vanuit de bron) en ⚡ (dit veld met AI vertalen). Een statuskiezer, navigatie tussen de talen van de groep en een indicator voor veroudering maken het scherm compleet. De sneltoets Ctrl/Cmd + S slaat op.

Teksten vertalen (interfaceteksten)

Teksten die geen redactionele inhoud zijn, zoals de sitetitel, de slogan, widgettitels en thema-labels, beheert u in DF Translate → Teksten. Vul per taal de vertaling van elke tekst in, of gebruik de import en export van .po om dat werk aan een vertaler uit te besteden of een bestaande catalogus te hergebruiken.

Meertalige SEO

• hreflang: de hreflang-tags (met x-default) worden automatisch aan elke pagina toegevoegd om de zoekmachines op de taalversies te wijzen.
• URL’s per taal: elke taal die niet de standaardtaal is, krijgt een voorvoegsel (bijvoorbeeld /fr/), voor nette en indexeerbare URL’s.
• Vertaalde slugs: de slug van de vertaling wordt opnieuw opgebouwd vanuit de vertaalde titel.
• SEO-metagegevens: de titels, beschrijvingen en zoekwoorden van Yoast, Rank Math, AIOSEO en SEOPress worden samen met de inhoud vertaald.

De taalkiezer

Bied uw bezoekers de taalwissel aan op de manier die bij uw thema past:

• Gutenberg-blok “Taalkiezer” in de site- of inhoudseditor.
• Widget op de klassieke manier in een widgetzone.
• Shortcode [dft_switcher] waar u maar wilt.
• In een menu: voeg een aangepaste link toe met de URL #dft_switcher; die klapt open in één item per taal.
• Beheerbalk: er is een kiezer beschikbaar voor ingelogde gebruikers.

De vlaggen zijn ingebouwde SVG’s, scherp op elk systeem (ook op Windows, waar emoji-vlaggen niet worden weergegeven).

Vertaalde menu’s

Wijs in Weergave → Menu’s per themalocatie een ander menu per taal toe, of laat het leeg om het standaardmenu te hergebruiken. De knop ⚡ Genereren kloont het standaardmenu en koppelt elk item aan de vertaling ervan (de labels volgen dan de vertaalde titels), en vertaalt de aangepaste links.

WooCommerce

DF Translate vertaalt eenvoudige producten, productcategorieën en producttags net als elke andere inhoud. De voorraad en de prijs blijven tussen de talen van eenzelfde product gesynchroniseerd, en de taal van de klant wordt op de bestelling vastgelegd.

Migreren vanuit Polylang

Gebruikt u al Polylang, open dan DF Translate → Instellingen en start de migratie met één klik. Uw talen, de taaltoewijzingen van uw inhoud en uw vertaalgroepen worden automatisch geïmporteerd. Uw Polylang-gegevens worden niet gewijzigd en uw bestaande talen blijven behouden (samenvoegen, niet overschrijven).

Dashboard en gezondheidscontroles

Het dashboard (DF Translate) toont de vertaaldekking per inhoudstype en per taal, de inhoud die nagelezen moet worden, en gezondheidscontroles: permalinks, inhoud zonder taal, motor niet ingesteld. Meerdere problemen (zoals verweesde inhoud) lost u met één klik op.

Ondersteuning voor REST en headless

De velden dft_lang en dft_translations worden in de REST API beschikbaar gesteld op de vertaalbare inhoudstypen. Filteren op taal gebeurt uitdrukkelijk via ?lang=; de API-antwoorden worden nooit impliciet door een taalcookie gefilterd, wat voorkomt dat de resultaten van een headless front worden vervuild.

Verwijderen

Alleen deactiveren behoudt al uw gegevens. Vinkt u de optie voor gegevensverwijdering in de instellingen aan, dan wist het verwijderen van de plugin de tabellen en opties van DF Translate; uw WordPress-inhoud en uw bestellingen worden nooit geraakt.

Veelgestelde vragen en probleemoplossing

De verbindingstest met de motor mislukt. Controleer de API-sleutel, het quotum bij de provider, en of uw server de API via uitgaand verkeer kan bereiken. Controleer bij LibreTranslate de URL van de instantie.

Een vertaling blijft gemarkeerd als “na te lezen” (⚑ MT). Dat is normaal na een machinevertaling: open ze en sla een menselijke wijziging op (via de editor, de weergave naast elkaar of een import) om de markering weg te halen.

De taalkiezer verschijnt niet in mijn menu. Controleer of de aangepaste link exact de URL #dft_switcher heeft en sla het menu daarna op.

De vlaggen werden als letters weergegeven. DF Translate gebruikt juist ingebouwde SVG-vlaggen om dat te voorkomen (emoji-vlaggen worden onder Windows niet gerenderd). Leeg de cache als een oude weergave blijft hangen.

Een vertaalde pagina geeft een 404. Ververs de permalinks (Instellingen → Permalinks → Wijzigingen opslaan) nadat u een taal hebt toegevoegd of de URL-voorvoegsels hebt gewijzigd.

Hoe ga ik naar meer dan 2 talen? DF Translate Pro maakt het aantal talen onbeperkt en voegt bulkvertaling, autopilot, vertaalgeheugen, een woordenlijst, XLIFF-export en -import en WP-CLI-commando’s toe.