Tradurre le etichette del filtro prodotti WooCommerce: Polylang, WPML, Loco
In un negozio multilingua il filtro prodotti finisce spesso tradotto a metà: i nomi dei colori cambiano lingua, ma i titoli dei blocchi, il pulsante Filtra (Filter) o Cancella tutto (Clear All) restano nell'originale. Il filtro mostra testi che arrivano da più fonti, e ciascuna si traduce in un punto diverso. Questa guida mostra come tradurre le etichette del filtro prodotti WooCommerce con Polylang, WPML o Loco Translate, fonte per fonte, con la sintassi esatta che il plugin si aspetta.
Da dove arriva ogni testo del filtro
| Testo nel filtro | Da dove arriva | Dove tradurlo |
|---|---|---|
| Nomi dei termini: categorie, colori, taglie | Termini di WordPress | Il tuo plugin multilingua, come per qualsiasi categoria o termine di attributo |
| Titoli dei blocchi senza etichetta personalizzata | Il nome della tassonomia, per gli attributi "Product Color" e simili | Il tuo plugin multilingua, o meglio un'etichetta personalizzata (vedi sotto) |
| Testi digitati nelle impostazioni del filtro: etichette personalizzate, testi dei pulsanti, segnaposto, testi di apertura/chiusura e Mostra altro (Show more), tooltip, titoli e opzioni dei filtri meta, titoli delle sezioni | Impostazioni di HUSKY | Traduzioni delle etichette delle tassonomie WPML (WPML taxonomies labels translations) in Avanzate (Advanced) → Codice (Code) |
| Stringhe dell'interfaccia integrate: Filtra (Filter), Reimposta (Reset), Cancella tutto (Clear All), fascia di prezzo (price range), Disponibile (In stock), Mostra il modulo del filtro prodotti (Show products filter form) | Text domain woocommerce-products-filter | WPML String Translation, Loco Translate o file .po/.mo |
| Titolo del widget del filtro | Il widget di WordPress | Traduzione dei widget del tuo plugin multilingua |
La maggior parte dei tentativi falliti traduce un testo nel posto sbagliato, per esempio il titolo di un attributo in Loco Translate, o un'etichetta personalizzata in WPML String Translation, dove il plugin non la registra mai.
Tradurre le etichette del filtro prodotti WooCommerce con Polylang o WPML
I titoli del filtro e tutti i testi digitati nelle impostazioni del plugin si traducono con un'unica tabella di corrispondenze nel plugin. Funziona allo stesso modo per WPML e Polylang; il campo compare solo quando uno dei due è attivo.
- Dai al blocco un originale fisso. Nella scheda Struttura (Structure) clicca sull'ingranaggio (opzioni aggiuntive (additional options)) accanto alla tassonomia e compila Etichetta personalizzata della tassonomia (Taxonomy custom label), per esempio
Color. Senza un'etichetta personalizzata l'originale è il nome della tassonomia che WordPress restituisce nella lingua corrente. Per gli attributi WooCommerce lo costruisce come "Product Color", e un plugin di traduzione potrebbe averlo già modificato, quindi una riga scritta per una forma non corrisponde in un'altra lingua. - Apri Avanzate (Advanced) → Codice (Code) → Traduzioni delle etichette delle tassonomie WPML (WPML taxonomies labels translations) e aggiungi una riga per ogni etichetta e lingua: lingua, due punti, testo originale, accento circonflesso, traduzione.
- Usa il codice lingua corretto. Con WPML è il codice lingua di WPML (
fr,de,pt-br). Con Polylang è il locale della lingua (fr_FR,en_GB,uk), come mostrato nella colonna Locale dell'elenco lingue di Polylang. Usareensu un sito Polylang che funziona conen_GBè il motivo più comune per cui non cambia nulla. - Salva, poi svuota la cache delle pagine e controlla la pagina nell'altra lingua.
Per un negozio in inglese con francese e tedesco, su WPML:
fr:Color^Couleur
fr:Size^Taille
de:Color^Farbe
de:Size^Größe
La stessa cosa su Polylang:
fr_FR:Color^Couleur
fr_FR:Size^Taille
de_DE:Color^Farbe
de_DE:Size^Größe
La lingua predefinita non richiede righe: senza corrispondenza viene mostrato l'originale.
Come funziona la corrispondenza
- L'originale deve essere il testo che il blocco mostrerebbe senza traduzione: l'etichetta personalizzata, oppure il nome della tassonomia se non ce n'è una. Gli spazi alle estremità e la differenza tra maiuscole e minuscole non contano, e le etichette funzionano in qualsiasi alfabeto.
- Ogni riga richiede il prefisso della lingua. Una riga come
Containertyp^Container typeviene ignorata. - L'originale può contenere i due punti, ma non l'accento circonflesso: il primo
^lo chiude. - È una tabella, non un'impostazione per singolo campo. Una riga traduce quel testo ovunque passi nel filtro: il titolo del blocco, il titolo nel pannello dei filtri selezionati, un pulsante o un segnaposto.
La stessa tabella traduce anche i testi che hai digitato nelle impostazioni: Testo del pulsante Filtra (Filter button text) e Testo del pulsante Reimposta (Reset button text), il titolo del filtro prezzo, i segnaposto della ricerca per testo, SKU e autore, i testi di apertura/chiusura, i testi Mostra altro (Show more) e Mostra meno (Show less), i tooltip, i titoli e le opzioni dei filtri meta e ACF, e i titoli delle sezioni. Scrivi la riga con esattamente il testo che hai digitato, per esempio fr:Sort by price^Trier par prix.
Un effetto collaterale conta per il CSS personalizzato: ogni blocco riceve anche una classe costruita dal titolo mostrato, quindi woof_container_couleur nella pagina francese e woof_container_color in quella inglese. Applica gli stili ai blocchi tramite la classe costruita dallo slug della tassonomia, come .woof_container_pa_color, che è uguale in ogni lingua.
Stringhe dell'interfaccia: Loco Translate, WPML String Translation e file .po
I testi integrati del plugin sono normali stringhe di WordPress nel text domain woocommerce-products-filter. Due impostazioni li riguardano: Testo del pulsante Filtra (Filter button text) e Testo del pulsante Reimposta (Reset button text). Quando questi campi sono vuoti, i pulsanti usano i valori predefiniti traducibili Filtra (Filter) e Reimposta (Reset); non appena digiti un testo tuo, diventa un testo delle impostazioni e finisce nella tabella di corrispondenze descritta sopra.
WPML. Analizza il plugin in WPML → Localizzazione di temi e plugin (Theme and plugins localization), poi traduci le stringhe del dominio woocommerce-products-filter in String Translation.
Loco Translate, scelta abituale anche con Polylang, il cui elenco di stringhe non include quelle dei plugin:
- Vai in Loco Translate → Plugin (Plugins), apri HUSKY e aggiungi una nuova lingua.
- Scegli la posizione Personalizzata (Custom) o Sistema (System), non la cartella
languagesdel plugin. Gli aggiornamenti del plugin sostituiscono quella cartella, e nella 3.4.6 il plugin non carica da essa i file di traduzione. - Prima di sincronizzare, apri Loco Translate → Impostazioni (Settings) e porta Salta i file PHP più grandi di (Skip PHP files larger than) ad almeno 200 KB. Il file principale del plugin pesa circa 145 KB e contiene stringhe come Cancella tutto (Clear All), fascia di prezzo (price range), i nomi degli ordinamenti nel pannello dei filtri selezionati e Mostra il modulo del filtro prodotti (Show products filter form). Con il limite predefinito di 100 KB Loco salta il file, quelle stringhe mancano e una sincronizzazione le rimuove da una traduzione esistente.
- Sincronizza, traduci, salva. Loco compila il file .mo accanto al file .po.
I file di traduzione già pronti per molte lingue si trovano nella pagina delle traduzioni. Qualunque strumento tu usi, il nome del file deve terminare con il locale esatto del tuo sito, per esempio woocommerce-products-filter-de_DE.mo, e il file va in wp-content/languages/plugins/ o nella cartella personalizzata di Loco. La FAQ lavorare con WPML contiene la versione breve della sintassi della tabella.
Singole stringhe tramite hook, per lingua
Alcuni testi si impostano più facilmente nel codice, soprattutto quando lo stesso testo deve cambiare da una lingua all'altra. Nella 3.4.6 esistono questi hook:
- woof_filter_title: riceve ogni testo che passa per la tabella di corrispondenze, dopo la tabella, quindi può modificare qualsiasi titolo di blocco, pulsante o segnaposto.
- woof_clear_all_text: il link Cancella tutto (Clear All) del pannello dei filtri selezionati.
- woof_start_filtering_btn_txt: il pulsante Mostra il modulo del filtro prodotti (Show products filter form).
woof_ext_custom_title_by_instock,woof_ext_custom_title_by_onsales,woof_ext_custom_title_by_featured,woof_ext_custom_title_by_backorder: le etichette delle caselle Disponibile, In offerta, In evidenza e ordinabile su richiesta.
/*
* Product filter: per-language texts set in code.
* Child theme functions.php or a code snippets plugin.
*/
function my_filter_lang() {
if (function_exists('pll_current_language')) {
return pll_current_language(); // Polylang: language slug, e.g. "fr"
}
return apply_filters('wpml_current_language', null); // WPML: language code
}
add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
$texts = array(
'en' => array('Formations' => 'Bands'),
'de' => array('Formations' => 'Besetzungen'),
);
return $texts[my_filter_lang()][$title] ?? $title;
}, 10, 3);
add_filter('woof_clear_all_text', function ($text) {
return my_filter_lang() === 'fr' ? 'Tout effacer' : $text;
});
Tieni presente che qui la lingua è lo slug di Polylang (fr), non il locale usato nella tabella di corrispondenze.
Termini, ordine dei termini e swatch in altre lingue
Il filtro stampa i termini della lingua corrente restituiti da WordPress. Se un valore compare nella lingua originale, il termine stesso non è ancora tradotto: traducilo in WPML (gli attributi tramite WooCommerce Multilingual) o in Polylang. Se è tradotto e mostra ancora il vecchio nome, svuota la cache delle pagine e la Cache dei termini (Cache terms) del plugin con il pulsante svuota la cache dei termini (clear terms cache) in Avanzate (Advanced) → Opzioni (Options).
I termini tradotti sono termini separati, con un proprio ordine. Per mantenere l'ordine della lingua predefinita, apri l'elenco dei termini (Prodotti (Products) → Categorie (Categories), oppure Prodotti (Products) → Attributi (Attributes) → Configura i termini (Configure terms)), cambia la lingua dell'amministrazione e riordina di nuovo i termini. I colori e le immagini dei tipi Colore e Immagine vanno impostati solo sui termini della lingua predefinita: un termine tradotto senza un colore o un'immagine propri usa quelli del suo originale.
Checklist
- Ogni blocco che ha bisogno di un titolo tradotto ha un'Etichetta personalizzata della tassonomia (Taxonomy custom label), e le righe in Traduzioni delle etichette delle tassonomie WPML (WPML taxonomies labels translations) ripetono esattamente quell'etichetta.
- Il prefisso della lingua è il codice lingua di WPML su WPML e il locale completo su Polylang.
- I testi digitati nei campi delle impostazioni sono nella tabella di corrispondenze; le stringhe integrate si traducono nel dominio
woocommerce-products-filter. - I file di Loco sono nella posizione Personalizzata o Sistema, e il limite di dimensione dei file PHP è stato alzato prima della sincronizzazione.
- Il CSS personalizzato individua i blocchi tramite lo slug della tassonomia, non tramite il titolo.
- La cache delle pagine e quella dei termini sono state svuotate prima di provare la seconda lingua.
Se un'etichetta continua a non cambiare, apri un topic sul forum di supporto di HUSKY con il link alla pagina nella seconda lingua, il plugin di traduzione che usi e le righe che hai aggiunto.