Ampliación de la traducción de campos personalizados para el complemento de traducción automática Polylang AI

Robbert Vermeulen

Robbert Vermeulen

· 7 min de lectura

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

  1. Añade el código del filtro usando uno de los métodos anteriores
  2. Borra cualquier caché (si usas plugins de caché)
  3. Ve a la interfaz de traducción en tu administración de WordPress
  4. Verifica que tus campos personalizados aparecen en las opciones de traducción
  5. Haz una traducción de prueba de una entrada/término con tus campos personalizados
  6. 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

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

Ver todas las publicaciones →