Descripción general
El plugin Polylang Automatic AI Translation proporciona soporte integrado para traducir campos personalizados de plugins populares como ACF, Yoast SEO, Rank Math y otros. Sin embargo, para campos personalizados creados con tu propio código o con plugins especializados, tendrás que ampliar la funcionalidad del plugin usando los hooks de filtro proporcionados.
Por qué los campos personalizados necesitan configuración manual
Por diseño, el plugin solo traduce los campos personalizados configurados explícitamente para evitar:
- La traducción de datos sensibles (claves API, valores de configuración)
- Romper la funcionalidad que depende de valores específicos de los campos
- Costes no deseados por traducir contenido no textual
Hooks de filtro disponibles
El plugin proporciona dos hooks de filtro principales para ampliar el soporte de traducción de campos personalizados:
1. Hook de campos meta de entradas
Nombre del hook: pllat_available_post_meta_translation_fields
Propósito: Añadir campos personalizados para entradas, páginas y tipos de contenido personalizados
Uso:
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. Hook de campos meta de términos
Nombre del hook: pllat_available_term_meta_translation_fields
Propósito: Añadir campos personalizados para categorías, etiquetas y taxonomías personalizadas
Uso:
add_filter('pllat_available_term_meta_translation_fields', function($fields) {
$fields[] = 'category_description';
$fields[] = 'term_subtitle';
$fields[] = 'custom_term_field';
return $fields;
});Métodos de implementación
Método 1: Archivo de funciones del tema
Añade el código del filtro al archivo functions.php de tu tema activo:
// 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étodo 2: Plugin personalizado
Crea un pequeño plugin para asegurar que los filtros se mantengan a través de los cambios de tema:
<?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();Identificación de las claves de tus campos personalizados
Para encontrar las claves de campo correctas para tus campos personalizados:
Método 1: Inspección de la base de datos
-- 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étodo 2: Depuración de WordPress
Añade este código temporal para ver todos los campos meta de una entrada específica:
// 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étodo 3: Revisión de código
Revisa el registro de tu tipo de contenido personalizado o el código de creación de la meta box para ver los nombres de los campos:
// 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);Buenas prácticas
Directrices para la selección de campos
- Incluir: Campos de texto, descripciones, títulos, contenido destinado a los visitantes
- Excluir: IDs, URLs, valores de configuración, datos serializados, contenido codificado
Organización del código
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);
});Prueba de tu implementación
- Añade el código del filtro usando uno de los métodos anteriores
- Borra cualquier caché (si usas plugins de caché)
- Ve a la interfaz de traducción en tu administración de WordPress
- Verifica que tus campos personalizados aparecen en las opciones de traducción
- Haz una traducción de prueba de una entrada/término con tus campos personalizados
- Comprueba la versión traducida para confirmar que los campos se tradujeron
Tipos de campos comunes compatibles
El plugin puede traducir varios tipos de campos personalizados:
- Campos de texto
- Campos de área de texto
- Contenido de texto enriquecido/WYSIWYG
- Contenido HTML simple
- Descripciones de texto sin formato
Solución de problemas
Los campos no aparecen
- Verifica que los nombres de las claves del campo sean correctos
- Comprueba que el filtro esté correctamente enganchado
- Asegúrate de que no haya errores de PHP en tu código
- Borra cualquier caché
Los campos no se traducen
- Confirma que el campo contenga contenido de texto traducible
- Comprueba que el valor del campo no esté vacío
- Verifica que tu clave de la API de OpenAI esté funcionando
- Revisa los registros de traducción en busca de errores
Consideraciones de rendimiento
- Añade solo los campos que realmente necesiten traducción
- Evita añadir campos con grandes cantidades de datos
- Considera las implicaciones de coste de traducir muchos campos