Extension de la traduction des champs personnalisés pour le module complémentaire Polylang AI Automatic Translation

Robbert Vermeulen

Robbert Vermeulen

· 7 min de lecture

Aperçu

Le plugin Polylang Automatic AI Translation offre une prise en charge intégrée de la traduction des champs personnalisés provenant de plugins populaires comme ACF, Yoast SEO, Rank Math et d’autres. Cependant, pour les champs personnalisés créés avec votre propre code ou des plugins spécialisés, vous devrez étendre les fonctionnalités du plugin à l’aide des crochets de filtre fournis.

Pourquoi les champs personnalisés nécessitent une configuration manuelle

Par conception, le plugin ne traduit que les champs personnalisés explicitement configurés afin d’éviter :

  • La traduction de données sensibles (clés API, valeurs de configuration)
  • De casser des fonctionnalités qui dépendent de valeurs de champs spécifiques
  • Des coûts indésirables liés à la traduction de contenus non textuels

Crochets de filtre disponibles

Le plugin fournit deux principaux crochets de filtre pour étendre la prise en charge de la traduction des champs personnalisés :

1. Crochet des champs meta des publications

Nom du crochet : pllat_available_post_meta_translation_fields

Objectif : Ajouter des champs personnalisés pour les articles, pages et types de publication personnalisés

Utilisation :

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. Crochet des champs meta des termes

Nom du crochet : pllat_available_term_meta_translation_fields

Objectif : Ajouter des champs personnalisés pour les catégories, étiquettes et taxonomies personnalisées

Utilisation :

add_filter('pllat_available_term_meta_translation_fields', function($fields) {
    $fields[] = 'category_description';
    $fields[] = 'term_subtitle';
    $fields[] = 'custom_term_field';
    return $fields;
});

Méthodes d’implémentation

Méthode 1 : fichier de fonctions du thème

Ajoutez le code du filtre dans le fichier functions.php de votre thème actif :

// 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);
});

Méthode 2 : plugin personnalisé

Créez un petit plugin pour vous assurer que les filtres persistent lors des changements de thème :

<?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();

Identifier les clés de vos champs personnalisés

Pour trouver les bonnes clés de champ pour vos champs personnalisés :

Méthode 1 : Inspection de la base de données

-- For post meta fields
SELECT DISTINCT meta_key FROM wp_postmeta WHERE meta_key NOT LIKE '\_%' ORDER BY meta_key;

-- For term meta fields  
SELECT DISTINCT meta_key FROM wp_termmeta WHERE meta_key NOT LIKE '\_%' ORDER BY meta_key;

Méthode 2 : Débogage WordPress

Ajoutez ce code temporaire pour voir tous les champs meta d’un article spécifique :

// Temporary debug code - remove after identifying fields
$post_id = 123; // Replace with your post ID
$meta = get_post_meta($post_id);
error_log(print_r($meta, true));

Méthode 3 : Revue du code

Vérifiez le code d’enregistrement de votre type de publication personnalisé ou de création de meta box pour les noms de champs :

// Look for calls like:
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);

Bonnes pratiques

Recommandations de sélection des champs

  • Inclure : Champs de texte, descriptions, titres, contenu destiné aux visiteurs
  • Exclure : ID, URL, valeurs de configuration, données sérialisées, contenu encodé

Organisation du code

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);
});

Tester votre implémentation

  1. Ajoutez le code de filtre en utilisant l’une des méthodes ci-dessus
  2. Videz les caches (si vous utilisez des extensions de cache)
  3. Accédez à l’interface de traduction dans votre administration WordPress
  4. Vérifiez que vos champs personnalisés apparaissent dans les options de traduction
  5. Testez la traduction d’un article/terme avec vos champs personnalisés
  6. Consultez la version traduite pour confirmer que les champs ont été traduits

Types de champs courants pris en charge

L’extension peut traduire différents types de champs personnalisés :

  • Champs de texte
  • Champs de zone de texte
  • Contenu de texte enrichi/WYSIWYG
  • Contenu HTML simple
  • Descriptions en texte brut

Dépannage

Champs n’apparaissant pas

  • Vérifiez que les noms des clés de champ sont corrects
  • Vérifiez que le filtre est correctement accroché
  • Assurez-vous qu’il n’y a pas d’erreurs PHP dans votre code
  • Videz tout cache

Champs ne se traduisant pas

  • Confirmez que le champ contient du texte traduisible
  • Vérifiez que la valeur du champ n’est pas vide
  • Vérifiez que votre clé API OpenAI fonctionne
  • Consultez les journaux de traduction pour détecter les erreurs

Considérations relatives aux performances

  • N’ajoutez que les champs qui doivent réellement être traduits
  • Évitez d’ajouter des champs contenant de grandes quantités de données
  • Considérez les implications en termes de coût liées à la traduction de nombreux champs

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

Voir tous les articles →