Overzicht
De Polylang Automatic AI Translation plugin biedt ingebouwde ondersteuning voor het vertalen van aangepaste velden van populaire plugins zoals ACF, Yoast SEO, Rank Math en anderen. Voor aangepaste velden die zijn aangemaakt met eigen code of specialistische plugins, moet je echter de functionaliteit van de plugin uitbreiden met behulp van de beschikbare filter hooks.
Waarom aangepaste velden handmatige configuratie vereisen
Standaard vertaalt de plugin alleen expliciet geconfigureerde aangepaste velden om te voorkomen dat:
- Gevoelige gegevens (API-sleutels, configuratiewaarden) worden vertaald
- Functionaliteit wordt aangetast die afhankelijk is van specifieke veldwaarden
- Ongewenste kosten ontstaan door het vertalen van niet-tekstuele inhoud
Beschikbare filter hooks
De plugin biedt twee hoofd filter hooks om de ondersteuning voor vertaling van aangepaste velden uit te breiden:
1. Post Meta Fields Hook
Hooknaam: pllat_available_post_meta_translation_fields
Doel: Voeg aangepaste velden toe voor berichten, pagina’s en custom post types
Gebruik:
add_filter('pllat_available_post_meta_translation_fields', function($fields) {
$fields[] = 'your_custom_field_key';
$fields[] = 'another_custom_field';
$fields[] = 'description_field';
return $fields;
});2. Term Meta Fields Hook
Hooknaam: pllat_available_term_meta_translation_fields
Doel: Aangepaste velden toevoegen voor categorieën, tags en aangepaste taxonomieën
Gebruik:
add_filter('pllat_available_term_meta_translation_fields', function($fields) {
$fields[] = 'category_description';
$fields[] = 'term_subtitle';
$fields[] = 'custom_term_field';
return $fields;
});Implementatiemethoden
Methode 1: Thema functions-bestand
Voeg de filtercode toe aan het functions.php-bestand van je actieve thema:
// Add to wp-content/themes/your-theme/functions.php
add_filter('pllat_available_post_meta_translation_fields', function($fields) {
// Add your custom post meta fields
$custom_fields = [
'product_description',
'location_address',
'company_bio',
'custom_excerpt'
];
return array_merge($fields, $custom_fields);
});
add_filter('pllat_available_term_meta_translation_fields', function($fields) {
// Add your custom term meta fields
$custom_term_fields = [
'category_subtitle',
'term_description_extended',
'location_details'
];
return array_merge($fields, $custom_term_fields);
});Methode 2: Aangepaste plugin
Maak een kleine plugin om ervoor te zorgen dat de filters behouden blijven bij het wisselen van thema:
<?php
/**
* Plugin Name: Custom Fields Translation Extension
* Description: Extends Polylang AI Translation to support custom fields
* Version: 1.0
*/
// Prevent direct access
if (!defined('ABSPATH')) {
exit;
}
class CustomFieldsTranslationExtension {
public function __construct() {
add_filter('pllat_available_post_meta_translation_fields', [$this, 'add_post_meta_fields']);
add_filter('pllat_available_term_meta_translation_fields', [$this, 'add_term_meta_fields']);
}
public function add_post_meta_fields($fields) {
$custom_fields = [
'your_custom_field_1',
'your_custom_field_2',
'product_specifications',
'location_description'
];
return array_merge($fields, $custom_fields);
}
public function add_term_meta_fields($fields) {
$custom_term_fields = [
'category_banner_text',
'term_seo_description',
'location_details'
];
return array_merge($fields, $custom_term_fields);
}
}
new CustomFieldsTranslationExtension();Je aangepaste veldsleutels identificeren
Zo vind je de juiste sleutels voor je custom velden:
Methode 1: Database Inspectie
-- Voor post meta velden
SELECT DISTINCT meta_key FROM wp_postmeta WHERE meta_key NOT LIKE '\_%' ORDER BY meta_key;
-- Voor term meta velden
SELECT DISTINCT meta_key FROM wp_termmeta WHERE meta_key NOT LIKE '\_%' ORDER BY meta_key;Methode 2: WordPress Debug
Voeg deze tijdelijke code toe om alle meta velden van een specifiek bericht te bekijken:
// Tijdelijke debug code - verwijder na het identificeren van velden
$post_id = 123; // Vervang door je bericht ID
$meta = get_post_meta($post_id);
error_log(print_r($meta, true));Methode 3: Code Review
Controleer je registratiecode voor aangepaste berichttypen of de code voor het aanmaken van meta boxen op veldnamen:
// Zoek naar aanroepen zoals:
add_meta_box('my_meta_box', 'Title', 'callback', 'post_type');
update_post_meta($post_id, 'field_name', $value);
get_post_meta($post_id, 'field_name', true);Beste Praktijken
Richtlijnen voor veldselectie
- Inclusief: Tekstvelden, omschrijvingen, titels, inhoud bedoeld voor bezoekers
- Uitsluiten: ID’s, URL’s, configuratiewaarden, geserialiseerde data, gecodeerde inhoud
Codeorganisatie
add_filter('pllat_available_post_meta_translation_fields', function($fields) {
$custom_fields = [
// Product fields
'product_short_description',
'product_benefits',
// Location fields
'location_description',
'opening_hours_note',
// Event fields
'event_summary',
'speaker_bio'
];
return array_merge($fields, $custom_fields);
});Je implementatie testen
- Voeg de filtercode toe via één van de bovenstaande methodes
- Leeg eventuele caches (indien je caching plugins gebruikt)
- Navigeer naar de vertaalinterface in je WordPress-beheeromgeving
- Controleer of je custom velden zichtbaar zijn in de vertaalopties
- Test het vertalen van een bericht/term met je custom velden
- Controleer de vertaalde versie om te verifiëren dat de velden zijn vertaald
Ondersteunde veelvoorkomende veldtypes
De plugin kan verschillende typen aangepaste velden vertalen:
- Tekstvelden
- Textarea-velden
- Rijke tekst/WYSIWYG-inhoud
- Eenvoudige HTML-inhoud
- Platte tekstomschrijvingen
Probleemoplossing
Velden worden niet weergegeven
- Controleer of de veldsleutelnamen correct zijn
- Controleer of het filter goed is gekoppeld
- Zorg dat er geen PHP-fouten in je code staan
- Leeg alle cache
Velden worden niet vertaald
- Controleer of het veld vertaalbare tekst bevat
- Kijk of de veldwaarde niet leeg is
- Controleer of je OpenAI API-sleutel werkt
- Bekijk vertaal-logboeken op fouten
Prestatieoverwegingen
- Voeg alleen velden toe die daadwerkelijk vertaald moeten worden
- Vermijd het toevoegen van velden met grote hoeveelheden data
- Houd rekening met de kosten van het vertalen van veel velden