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
- Aggiungi il codice del filtro utilizzando uno dei metodi sopra
- Svuota eventuali cache (se utilizzi plugin di caching)
- Vai all’interfaccia di traduzione nel tuo pannello di amministrazione di WordPress
- Verifica che i tuoi campi personalizzati compaiano tra le opzioni di traduzione
- Prova a tradurre un post/termine con i tuoi campi personalizzati
- 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