HUSKY - WooCommerce Product Filter Professional

Rimuovere il prefisso Product e rinominare i titoli del filtro WooCommerce

Product Color, Product Size, Product Material: quando ogni blocco di attributo nel filtro del tuo negozio inizia con la stessa parola, il filtro sta solo stampando il nome che WooCommerce ha dato all'attributo. Per rimuovere il prefisso Product dai titoli del filtro WooCommerce devi dare al blocco un titolo tuo, uno alla volta nelle impostazioni del filtro oppure per tutti gli attributi insieme con poche righe di codice. Gli stessi punti controllano gli altri testi del filtro: i titoli dei blocchi, la prima opzione di un menu a tendina, Cancella tutto (Clear All), Reimposta (Reset), Filtra (Filter), Mostra altro (Show more) e perfino i nomi dei singoli termini. Tutti si possono cambiare senza modificare i file del plugin.

Da dove arriva ogni testo del filtro

HUSKY non memorizza un proprio nome per una tassonomia. Chiede a WordPress il nome plurale della tassonomia e lo stampa, a meno che tu non imposti un'etichetta personalizzata. WooCommerce registra ogni attributo globale con il nome plurale Product %s, quindi l'attributo Colore (Color) diventa una tassonomia chiamata "Product Color", mentre il suo nome singolare resta "Color". Categorie e tag funzionano allo stesso modo: i loro nomi plurali sono "Product categories" e "Product tags". La tabella mostra da dove arriva ogni testo visibile e dove cambiarlo.

Testo nella paginaDa dove arrivaDove cambiarlo
Titolo sopra l'intero filtro ("HUSKY Filter")Il titolo del widgetIl campo Titolo (Title) del widget
Titolo di un blocco (Product Color, Product categories)Il nome della tassonomiaEtichetta personalizzata della tassonomia (Taxonomy custom label), oppure l'hook woof_filter_title
Prima opzione di un menu a tendinaLo stesso nome della tassonomiaIl titolo del blocco, oppure una copia del template del menu a tendina
Titolo del filtro prezzoIl Testo del titolo (Title text) del filtro prezzoOpzioni aggiuntive di Cerca per prezzo (Search by Price)
Disponibile (In stock), In offerta (On sale), Prodotti in evidenza (Featured products)Testi delle estensioniGli hook woof_ext_custom_title_*
Cancella tutto (Clear All) nel pannello dei filtri attiviStringa del pluginL'hook woof_clear_all_text
Pulsanti Filtra (Filter) e Reimposta (Reset), etichetta orderbyStringhe e opzioni del pluginLa scheda Opzioni, oppure una traduzione
Mostra altro (Show more) / Mostra meno (Show less), Apri filtro (Open filter) / Chiudi filtro (Close filter) da mobileOpzioni della scheda DesignLa scheda Design
Nome di un singolo termineIl termine stessoL'hook woof_sort_terms_before_out

Rimuovere il prefisso Product dai titoli del filtro WooCommerce

Ci sono tre modi, dal più limitato al più esteso negli effetti. Scegline uno; non servono tutti.

Un blocco alla volta: Etichetta personalizzata della tassonomia

  1. Apri WooCommerce > Impostazioni > Products Filter (WooCommerce > Settings > Products Filter), scheda Struttura (Structure).
  2. Nella riga dell'attributo (per esempio pa_color) clicca sull'icona a forma di ingranaggio, opzioni aggiuntive (additional options).
  3. Digita il titolo che vuoi in Etichetta personalizzata della tassonomia (Taxonomy custom label), per esempio Color. Lascia il campo vuoto per tornare al nome di WooCommerce.
  4. Clicca Applica (Apply) nel popup, poi Salva le modifiche (Save changes) in fondo alla pagina delle impostazioni.

L'etichetta personalizzata sostituisce il nome della tassonomia ovunque il filtro lo usi: il titolo del blocco, la prima opzione di un menu a tendina, il segnaposto di una selezione multipla e l'etichetta del valore selezionato nel pannello dei filtri attivi. È anche così che rinomini "Product categories" in "Categorie" o "Acquista per tipo", o dai a una tassonomia dei marchi un titolo diverso. Per un menu a tendina gerarchico lo stesso campo contiene i titoli di ogni livello; la guida al filtro anno, marca e modello spiega quel formato.

Tutti gli attributi insieme: l'hook woof_filter_title

Con venti attributi, digitare un'etichetta per ciascuno è noioso, e ogni nuovo attributo la richiede di nuovo. Ogni titolo di blocco del filtro passa per l'hook woof_filter_title, quindi un solo snippet può sostituire il nome "Product ..." di ogni attributo con il suo nome singolare:

/*
 * HUSKY: show "Color" instead of "Product Color" in attribute filter titles.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
    if (is_object($taxonomy_info)
        && isset($taxonomy_info->name, $taxonomy_info->labels->name, $taxonomy_info->labels->singular_name)
        && 0 === strpos($taxonomy_info->name, 'pa_')
        && $title === $taxonomy_info->labels->name) {
        // No custom label is set: use the attribute name without the prefix
        return $taxonomy_info->labels->singular_name;
    }
    return $title;
}, 10, 3);

Il controllo $title === $taxonomy_info->labels->name conserva qualsiasi Etichetta personalizzata della tassonomia (Taxonomy custom label) che hai impostato: lo snippet tocca solo i titoli che sono ancora il nome di WooCommerce. Non cambia nulla fuori dal filtro. L'hook riceve anche alcuni testi dei pulsanti con un $taxonomy_info vuoto, ed è per questo che lo snippet controlla prima is_object().

Ovunque nel sito: cambiare la stringa di WooCommerce

Se vuoi eliminare il prefisso in ogni punto che mostra i nomi delle tassonomie degli attributi, compresi altri widget e schermate di amministrazione, cambia la stringa di WooCommerce stessa. Il prefisso viene da _x( 'Product %s', 'Product Attribute', 'woocommerce' ), quindi un filtro di traduzione può restituire il solo nome:

/*
 * Remove the "Product" prefix from WooCommerce attribute names site-wide.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('gettext_with_context', function ($translation, $text, $context, $domain) {
    if ('woocommerce' === $domain && 'Product Attribute' === $context && 'Product %s' === $text) {
        return '%s';
    }
    return $translation;
}, 10, 4);

Lo stesso risultato si ottiene con Loco Translate traducendo Product %s in %s nel text domain di WooCommerce; salva il file nella posizione personalizzata di Loco, così un aggiornamento di WooCommerce non lo sovrascrive. In un sito in un'altra lingua ciò che vedi è la stringa tradotta (per esempio "Produkt %s"), ma lo snippet confronta il testo originale inglese, quindi funziona per qualsiasi lingua del sito.

Un effetto collaterale di qualsiasi metodo di ridenominazione: ogni blocco riceve anche una classe CSS costruita dal suo titolo, come woof_container_productcolor. Dopo la ridenominazione diventa woof_container_color. Se il tuo CSS personalizzato punta alla vecchia classe, passa alla classe basata sullo slug woof_container_pa_color, che non cambia mai.

Cambiare o nascondere il titolo del filtro e l'intestazione del widget

Il testo "HUSKY Filter" sopra l'intero filtro non è un'impostazione del plugin: è il titolo del widget. Apri Aspetto > Widget (Appearance > Widgets) (o l'editor a blocchi dei widget), apri il widget HUSKY e cambia il suo campo Titolo (Title) oppure svuotalo. Un titolo vuoto non stampa nulla. Un filtro inserito con lo shortcode [woof] non ha affatto un'intestazione di questo tipo.

Per nascondere il titolo di un singolo blocco, imposta Mostra l'etichetta del titolo (Show title label) su No nelle sue opzioni aggiuntive. È una scelta comune per i menu a tendina, dove la prima opzione dice già cos'è il menu. Il filtro prezzo ha un campo proprio: apri le opzioni aggiuntive di Cerca per prezzo (Search by Price) e compila Testo del titolo (Title text); quando è vuoto, il blocco del prezzo non ha titolo. Per un filtro prezzo a tendina, Testo del filtro prezzo a tendina (Drop-down price filter text) nello stesso popup imposta la sua prima opzione.

Una tassonomia ha un solo titolo per tutto il negozio. Se una categoria ha bisogno di un titolo diverso, per esempio "Shoe size" nella categoria Shoes, la FAQ sull'etichetta per singola categoria lo spiega; il codice più semplice è una condizione dentro woof_filter_title:

add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
    if (is_object($taxonomy_info) && 'pa_size' === $taxonomy_info->name && is_product_category('shoes')) {
        return 'Shoe size';
    }
    return $title;
}, 10, 3);

Funziona quando la pagina si ricarica a ogni modifica del filtro. In modalità AJAX il modulo del filtro viene ricostruito da una richiesta in background in cui is_product_category() è falsa, quindi il titolo torna a quello predefinito dopo la prima selezione.

Cambiare il testo segnaposto del menu a tendina

La prima opzione di un menu a tendina di una tassonomia, quella che significa "nulla di selezionato", stampa lo stesso testo del titolo del blocco. Un'etichetta personalizzata cambia quindi entrambi. Se vuoi che siano diversi, per esempio il titolo Colore (Color) e la prima opzione Qualsiasi colore (Any colour), usa una copia del template del menu a tendina. Il plugin lo carica tramite l'hook woof_html_types_view_select, quindi la copia può stare nel tuo child theme e sopravvive agli aggiornamenti del plugin.

  1. Copia wp-content/plugins/woocommerce-products-filter/views/html_types/select.php in wp-content/themes/your-child-theme/husky/select.php.
  2. Indica al plugin di usare la copia:
    /*
     * HUSKY: load the drop-down template from the child theme.
     * Child theme functions.php.
     */
    add_filter('woof_html_types_view_select', function ($path) {
        $custom = get_stylesheet_directory() . '/husky/select.php';
        return file_exists($custom) ? $custom : $path;
    });
  3. Nella copia, trova la riga <option value="0"> e sostituiscila con il tuo testo. Lì è disponibile $tax_slug, quindi un solo template può servire ogni menu a tendina:
    <option value="0"><?php echo esc_html( 'pa_color' === $tax_slug ? 'Any colour' : 'All' ); ?></option>

I blocchi a selezione multipla mostrano il titolo come segnaposto; il loro template è views/html_types/mselect.php, caricato tramite woof_html_types_view_mselect nello stesso modo. Dopo un aggiornamento del plugin, confronta la tua copia con il nuovo originale e riporta le eventuali modifiche.

Cambiare Clear All, Reset, Filter e altri testi integrati

I testi del plugin si dividono in tre gruppi.

Opzioni. Nella scheda Opzioni (Options), Testo del pulsante Filtra (Filter button text) e Testo del pulsante Reimposta (Reset button text) impostano i due pulsanti del modulo; scrivere none in Testo del pulsante Reimposta (Reset button text) nasconde quel pulsante. Nella versione gratuita entrambi i campi vengono ignorati e si vedono le parole predefinite; cambiale con lo snippet di traduzione qui sotto. Nella scheda Design trovi Testo per blocco più/meno aperto (Text for block more/less opened) e Testo per blocco più/meno chiuso (Text for block more/less closed) (per impostazione predefinita Mostra altro (Show more) e Mostra meno (Show less), usati quando un blocco ha Numero di termini non comprimibili (Not toggled terms count) impostato), oltre a Testo per il pulsante del filtro mobile (Text for mobile filter button) e Testo per chiudere il filtro mobile (Text to close mobile filter).

Hook. Cancella tutto (Clear All) nel pannello dei filtri attivi ha un proprio hook woof_clear_all_text, e le estensioni con caselle hanno gli hook woof_ext_custom_title_*: woof_ext_custom_title_by_instock, _by_onsales, _by_featured, _by_backorder e woof_ext_custom_title_stock_quantity.

/*
 * HUSKY: rename built-in texts. Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_clear_all_text', function ($text) {
    return 'Remove all filters';
});

add_filter('woof_ext_custom_title_by_instock', function ($title) {
    return 'Only products in stock';
});

add_filter('woof_ext_custom_title_by_onsales', function ($title) {
    return 'Discounted products';
});

Il testo Cancella tutto (Clear All) viene scritto in una stringa JavaScript tra virgolette doppie, quindi non usare virgolette doppie al suo interno.

Traduzione. Tutto il resto, come le etichette orderby, per page e price range del pannello dei filtri attivi e i valori di ordinamento come popularity, è una stringa traducibile del text domain woocommerce-products-filter. In un negozio monolingua lo strumento più semplice è un filtro gettext con un elenco di stringhe esatte:

/*
 * HUSKY: replace front-end strings. Child theme functions.php or a code snippets plugin.
 */
add_filter('gettext', function ($translation, $text, $domain) {
    if ('woocommerce-products-filter' !== $domain || (is_admin() && ! wp_doing_ajax())) {
        return $translation;
    }
    $texts = array(
        'Filter'     => 'Show products',
        'Reset'      => 'Start over',
        'orderby'    => 'Sort by',
        'popularity' => 'Popularity',
        'rating'     => 'Rating',
    );
    return isset($texts[$text]) ? $texts[$text] : $translation;
}, 20, 3);

Le stringhe devono corrispondere esattamente, maiuscole e minuscole comprese: il testo predefinito del pulsante è Clear All, non "Clear all". La condizione is_admin() mantiene le pagine delle impostazioni del plugin con la formulazione originale, coprendo comunque le richieste AJAX che ridisegnano il filtro. Una stringa sostituita cambia ovunque il plugin la stampi: Filter è anche il pulsante dello slider di prezzo in stile WooCommerce e il testo predefinito della linguetta a scomparsa. Loco Translate fa lo stesso senza codice. Tradurre il filtro in più lingue è un compito diverso, trattato in tradurre le etichette del filtro con WPML, Polylang o Loco Translate.

Rinominare un termine solo all'interno del filtro

A volte una categoria o un valore di attributo dovrebbe leggersi in modo diverso nel filtro rispetto alla pagina del prodotto, per esempio un nome di categoria lungo che rompe il layout della barra laterale. Ogni elenco di termini passa per woof_sort_terms_before_out prima di essere stampato, per caselle, pulsanti radio, menu a tendina, etichette, colori e immagini allo stesso modo:

/*
 * HUSKY: show other names for some terms in the filter only.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_sort_terms_before_out', function ($terms, $type) {
    $new_names = array(
        1019 => 'Garden tools',    // term ID => name shown in the filter
        1697 => 'Kids (4-12)',
    );
    foreach ($terms as $key => $term) {
        if (isset($term['term_id'], $new_names[$term['term_id']])) {
            $terms[$key]['name'] = $new_names[$term['term_id']];
        }
    }
    return $terms; // always return the whole array
}, 99, 2);

Trova l'ID di un termine passando il mouse sul termine in Prodotti > Categorie (Products > Categories) o nella schermata Configura i termini (Configure terms) dell'attributo: è il tag_ID nel link. L'hook viene eseguito anche per i termini figli, quindi le sottocategorie si possono rinominare allo stesso modo. L'elenco è già ordinato quando viene eseguita la priorità 99, quindi un termine rinominato mantiene la posizione del suo nome originale. Restituisci sempre l'array completo: restituire solo i termini modificati toglie dal filtro tutti gli altri.

Se il nuovo nome non compare

  • Non salvato. Applica (Apply) nel popup delle opzioni aggiuntive compila solo il modulo; l'etichetta viene memorizzata quando clicchi Salva le modifiche (Save changes) nella pagina delle impostazioni.
  • Cache dei termini. Se Cache dei termini (Cache terms) è attiva in Avanzate > Opzioni (Advanced > Options), il filtro mantiene i nomi dei termini che ha messo in cache. Un termine rinominato in WooCommerce mostra il vecchio nome finché non clicchi svuota la cache dei termini (clear terms cache) o scade il periodo di pulizia automatica.
  • Cache delle pagine. Le pagine in cache conservano il vecchio HTML. Svuota la cache del tuo plugin di caching, del server o della CDN e prova in una finestra privata.
  • Snippet non eseguito. Assicurati che il codice sia nel functions.php del tema (child) attivo o in uno snippet attivo, e che il nome del filtro, il numero di argomenti e le stringhe siano esattamente come sopra.

Se un testo del tuo filtro non è trattato qui, chiedi sul forum di supporto di HUSKY indicando il testo esatto e dove compare.