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
- Ajoutez le code de filtre en utilisant l’une des méthodes ci-dessus
- Videz les caches (si vous utilisez des extensions de cache)
- Accédez à l’interface de traduction dans votre administration WordPress
- Vérifiez que vos champs personnalisés apparaissent dans les options de traduction
- Testez la traduction d’un article/terme avec vos champs personnalisés
- 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