Uitbreiden van de vertaling van aangepaste velden voor de Polylang AI automatische vertaling add-on

Robbert Vermeulen

Robbert Vermeulen

· 6 min leestijd

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

  1. Voeg de filtercode toe via één van de bovenstaande methodes
  2. Leeg eventuele caches (indien je caching plugins gebruikt)
  3. Navigeer naar de vertaalinterface in je WordPress-beheeromgeving
  4. Controleer of je custom velden zichtbaar zijn in de vertaalopties
  5. Test het vertalen van een bericht/term met je custom velden
  6. 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

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

Bekijk alle berichten →