Estendere la traduzione dei campi personalizzati per l’add-on di traduzione automatica Polylang AI

Robbert Vermeulen

Robbert Vermeulen

· 7 min di lettura

Panoramica

Il plugin Polylang Automatic AI Translation offre un supporto integrato per tradurre i campi personalizzati di plugin popolari come ACF, Yoast SEO, Rank Math e altri. Tuttavia, per i campi personalizzati creati con il tuo codice o con plugin specializzati, dovrai estendere le funzionalità del plugin utilizzando gli hook di filtro forniti.

Perché i campi personalizzati richiedono una configurazione manuale

Per progettazione, il plugin traduce solo i campi personalizzati configurati esplicitamente per evitare:

  • La traduzione di dati sensibili (chiavi API, valori di configurazione)
  • Il malfunzionamento di funzionalità che dipendono da valori specifici dei campi
  • Costi indesiderati dovuti alla traduzione di contenuti non testuali

Hook di filtro disponibili

Il plugin fornisce due hook di filtro principali per estendere il supporto alla traduzione dei campi personalizzati:

1. Hook per i campi meta dei post

Nome hook: pllat_available_post_meta_translation_fields

Scopo: Aggiungere campi personalizzati per articoli, pagine e tipi di post personalizzati

Utilizzo:

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 per i campi meta dei termini

Nome hook: pllat_available_term_meta_translation_fields

Scopo: Aggiungere campi personalizzati per categorie, tag e tassonomie personalizzate

Utilizzo:

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

Metodi di implementazione

Metodo 1: file functions del tema

Aggiungi il codice del filtro nel file functions.php del tema attivo:

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

Metodo 2: plugin personalizzato

Crea un piccolo plugin per assicurarti che i filtri persistano anche quando cambi 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();

Identificare le chiavi dei campi personalizzati

Per trovare le chiavi campo corrette per i tuoi campi personalizzati:

Metodo 1: Ispezione del database

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

Metodo 2: Debug di WordPress

Aggiungi questo codice temporaneo per vedere tutti i campi meta per un post specifico:

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

Metodo 3: Revisione del codice

Controlla il codice di registrazione del tuo custom post type o di creazione delle meta box per i nomi dei campi:

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

Best practice

Linee guida per la selezione dei campi

  • Includi: campi di testo, descrizioni, titoli, contenuti destinati ai visitatori
  • Escludi: ID, URL, valori di configurazione, dati serializzati, contenuti codificati

Organizzazione del codice

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

Testare l’implementazione

  1. Aggiungi il codice del filtro utilizzando uno dei metodi sopra
  2. Svuota eventuali cache (se utilizzi plugin di caching)
  3. Vai all’interfaccia di traduzione nel tuo pannello di amministrazione di WordPress
  4. Verifica che i tuoi campi personalizzati compaiano tra le opzioni di traduzione
  5. Prova a tradurre un post/termine con i tuoi campi personalizzati
  6. Controlla la versione tradotta per confermare che i campi siano stati tradotti

Tipi di campi comuni supportati

Il plugin può tradurre vari tipi di campi personalizzati:

  • Campi di testo
  • Campi textarea
  • Contenuti rich text/WYSIWYG
  • Contenuti HTML semplici
  • Descrizioni in testo semplice

Risoluzione dei problemi

Campi non visualizzati

  • Verifica che i nomi delle chiavi dei campi siano corretti
  • Controlla che il filtro sia agganciato correttamente
  • Assicurati che non ci siano errori PHP nel tuo codice
  • Svuota eventuali cache

Campi non tradotti

  • Conferma che il campo contenga contenuti testuali traducibili
  • Controlla che il valore del campo non sia vuoto
  • Verifica che la tua chiave API di OpenAI funzioni
  • Controlla i log di traduzione per eventuali errori

Considerazioni sulle prestazioni

  • Aggiungi solo i campi che hanno effettivamente bisogno di essere tradotti
  • Evita di aggiungere campi con grandi quantità di dati
  • Considera l’impatto sui costi della traduzione di molti campi

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

Vedi tutti gli articoli →