HUSKY - WooCommerce Product Filter Professional

Quitar el prefijo Product y renombrar los títulos del filtro de WooCommerce

Product Color, Product Size, Product Material: cuando todos los bloques de atributos del filtro de tu tienda empiezan con la misma palabra, el filtro solo está mostrando el nombre que WooCommerce dio al atributo. Para quitar el prefijo Product de los títulos del filtro de WooCommerce, das al bloque un título propio, bien uno por uno en los ajustes del filtro, bien para todos los atributos a la vez con unas pocas líneas de código. Los mismos lugares controlan los demás textos del filtro: los títulos de los bloques, la primera opción de un desplegable, Borrar todo (Clear All), Re-inicializar (Reset), Filtro (Filter), Mostrar más (Show more) e incluso los nombres de términos concretos. Todos se pueden cambiar sin editar archivos del plugin.

De dónde sale cada texto del filtro

HUSKY no guarda un nombre propio para una taxonomía. Pide a WordPress el nombre en plural de la taxonomía y lo muestra, salvo que definas una etiqueta personalizada. WooCommerce registra cada atributo global con el nombre en plural Product %s, de modo que el atributo Color se convierte en una taxonomía llamada "Product Color", mientras que su nombre en singular sigue siendo "Color". Las categorías y las etiquetas funcionan igual: sus nombres en plural son "Product categories" y "Product tags". La tabla muestra de dónde sale cada texto visible y dónde cambiarlo.

Texto en la páginaDe dónde saleDónde cambiarlo
Encabezado sobre todo el filtro ("HUSKY Filter")El título del widgetEl campo Títol (Title) del widget
Título de un bloque (Product Color, Product categories)El nombre de la taxonomíaTaxonomía etiqueta personalizada (Taxonomy custom label), o el hook woof_filter_title
Primera opción de un desplegableEl mismo nombre de la taxonomíaEl título del bloque, o una copia de la plantilla del desplegable
Título del filtro de preciosEl Texto del título (Title text) del filtro de preciosOpciones adicionales de Buscar por precio (Search by Price)
En stock (In stock), En oferta (On sale), Productos destacados (Featured products)Textos de las extensionesLos hooks woof_ext_custom_title_*
Borrar todo (Clear All) en el panel de filtros activosCadena del pluginEl hook woof_clear_all_text
Botones Filtro (Filter) y Re-inicializar (Reset), etiqueta orderbyCadenas y opciones del pluginLa pestaña Opciónes (Options), o una traducción
Mostrar más (Show more) / Mostrar menos (Show less), Abrir filtro (Open filter) / Cerrar filtro (Close filter) en móvilOpciones de la pestaña Diseño (Design)La pestaña Diseño (Design)
Nombre de un término concretoEl propio términoEl hook woof_sort_terms_before_out

Quitar el prefijo Product de los títulos del filtro de WooCommerce

Hay tres formas, de menor a mayor alcance. Elige una; no necesitas todas.

Un bloque cada vez: Taxonomía etiqueta personalizada

  1. Abre WooCommerce > Ajustes > Products Filter, pestaña Estructura (Structure).
  2. En la fila del atributo (por ejemplo pa_color), haz clic en el icono del engranaje, opciones adicionales (additional options).
  3. Escribe el título que quieras en Taxonomía etiqueta personalizada (Taxonomy custom label), por ejemplo Color. Deja el campo vacío para volver al nombre de WooCommerce.
  4. Haz clic en Aplicar (Apply) en la ventana emergente y después en Guardar cambios (Save changes), al final de la página de ajustes.

La etiqueta personalizada sustituye al nombre de la taxonomía en todos los sitios donde lo usa el filtro: el título del bloque, la primera opción de un desplegable, el marcador de posición de un desplegable múltiple y la etiqueta del valor seleccionado en el panel de filtros activos. Así también puedes renombrar "Product categories" a "Categorías" o "Comprar por tipo", o dar otro título a una taxonomía de marcas. En un desplegable jerárquico, el mismo campo contiene los títulos de cada nivel; la guía del filtro de año, marca y modelo explica ese formato.

Todos los atributos a la vez: el hook woof_filter_title

Con veinte atributos, escribir una etiqueta para cada uno es tedioso, y cada atributo nuevo la necesita de nuevo. Todos los títulos de bloque del filtro pasan por el hook woof_filter_title, así que un único fragmento de código puede sustituir el nombre "Product ..." de cada atributo por su nombre en singular:

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

La comprobación $title === $taxonomy_info->labels->name respeta cualquier Taxonomía etiqueta personalizada (Taxonomy custom label) que hayas definido: el fragmento solo toca los títulos que siguen siendo el nombre de WooCommerce. No cambia nada fuera del filtro. El hook también recibe algunos textos de botones con un $taxonomy_info vacío, por eso el fragmento comprueba primero is_object().

En todo el sitio: cambiar la cadena de WooCommerce

Si quieres que el prefijo desaparezca en todos los lugares que muestran nombres de taxonomías de atributos, incluidos otros widgets y pantallas de administración, cambia la propia cadena de WooCommerce. El prefijo procede de _x( 'Product %s', 'Product Attribute', 'woocommerce' ), así que un filtro de traducción puede devolver solo el nombre:

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

Se puede lograr el mismo resultado con Loco Translate traduciendo Product %s como %s en el dominio de texto de WooCommerce; guarda el archivo en la ubicación personalizada de Loco para que una actualización de WooCommerce no lo sobrescriba. En un sitio en otro idioma, lo que ves es la cadena traducida (por ejemplo "Produkt %s"), pero el fragmento compara el texto original en inglés, así que funciona con cualquier idioma del sitio.

Un efecto secundario de cualquier método de renombrado: cada bloque recibe también una clase CSS construida a partir de su título, como woof_container_productcolor. Tras el cambio se convierte en woof_container_color. Si tu CSS personalizado apunta a la clase antigua, cámbialo por la clase basada en el slug, woof_container_pa_color, que nunca cambia.

Cambiar u ocultar el título del filtro y el encabezado del widget

El texto "HUSKY Filter" sobre todo el filtro no es un ajuste del plugin: es el título del widget. Abre Apariencia > Widgets (Appearance > Widgets) (o el editor de widgets de bloques), abre el widget de HUSKY y cambia su campo Títol (Title) o vacíalo. Un título vacío no muestra nada. Un filtro colocado con el shortcode [woof] no tiene ese encabezado en absoluto.

Para ocultar el título de un bloque, establece Mostrar etiqueta de título (Show title label) en No en sus opciones adicionales. Es habitual en los desplegables, donde la primera opción ya dice qué es el desplegable. El filtro de precios tiene su propio campo: abre las opciones adicionales de Buscar por precio (Search by Price) y rellena Texto del título (Title text); cuando está vacío, el bloque de precios no tiene título. En un filtro de precios desplegable, Texto desplegable del filtro de precios (Drop-down price filter text) en la misma ventana emergente define su primera opción.

Una taxonomía tiene un único título para toda la tienda. Si una categoría necesita un título distinto, por ejemplo "Talla de calzado" en la categoría Zapatos, la FAQ de etiquetas por categoría lo trata; el código más sencillo es una condición dentro de 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);

Esto funciona cuando la página se recarga tras cada cambio del filtro. En modo AJAX, el formulario del filtro se reconstruye mediante una petición en segundo plano en la que is_product_category() es falso, así que el título vuelve al valor por defecto tras la primera selección.

Cambiar el texto del marcador de posición del desplegable

La primera opción de un desplegable de taxonomía, la que significa "nada seleccionado", muestra el mismo texto que el título del bloque. Por eso una etiqueta personalizada cambia ambos. Si quieres que sean distintos, por ejemplo el título Color y la primera opción Cualquier color, usa una copia de la plantilla del desplegable. El plugin la carga mediante el hook woof_html_types_view_select, de modo que la copia puede estar en tu tema hijo y sobrevive a las actualizaciones del plugin.

  1. Copia wp-content/plugins/woocommerce-products-filter/views/html_types/select.php en wp-content/themes/your-child-theme/husky/select.php.
  2. Indica al plugin que use 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. En la copia, busca la línea <option value="0"> y sustitúyela por tu propio texto. Aquí está disponible $tax_slug, así que una plantilla puede servir para todos los desplegables:
    <option value="0"><?php echo esc_html( 'pa_color' === $tax_slug ? 'Any colour' : 'All' ); ?></option>

Los bloques de selección múltiple muestran el título como marcador de posición; su plantilla es views/html_types/mselect.php, que se carga mediante woof_html_types_view_mselect del mismo modo. Tras una actualización del plugin, compara tu copia con el nuevo original y traslada los cambios.

Cambiar Borrar todo, Re-inicializar, Filtro y otros textos integrados

Los textos propios del plugin se dividen en tres grupos.

Opciones. En la pestaña Opciónes (Options), Texto del botón de filtro (Filter button text) y Texto del botón de reiniciar (Reset button text) definen los dos botones del formulario; escribir none en Texto del botón de reiniciar (Reset button text) oculta ese botón. En la versión gratuita ambos campos se ignoran y se muestran las palabras por defecto; cámbialas con el fragmento de traducción de más abajo. En la pestaña Diseño (Design) encontrarás Texto para bloque más/menos abierto (Text for block more/less opened) y Texto para bloque más/menos cerrado (Text for block more/less closed) (por defecto Mostrar más (Show more) y Mostrar menos (Show less), que se usan cuando un bloque tiene definido Los términos no conmutados cuentan (Not toggled terms count)), además de Texto del botón de filtro móvil (Text for mobile filter button) y Texto para cerrar el filtro móvil (Text to close mobile filter).

Hooks. Borrar todo (Clear All) en el panel de filtros activos tiene su propio hook woof_clear_all_text, y las extensiones de casillas tienen los hooks woof_ext_custom_title_*: woof_ext_custom_title_by_instock, _by_onsales, _by_featured, _by_backorder y 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';
});

El texto Borrar todo (Clear All) se escribe en una cadena de JavaScript entre comillas dobles, así que no uses comillas dobles en él.

Traducción. Todo lo demás, como las etiquetas orderby, por página (per page) y rango de precios (price range) del panel de filtros activos y los valores de ordenación como popularidad (popularity), es una cadena traducible del dominio de texto woocommerce-products-filter. En una tienda de un solo idioma, la herramienta más sencilla es un filtro gettext con una lista de cadenas exactas:

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

Las cadenas deben coincidir exactamente, incluidas las mayúsculas: el texto por defecto del botón es Clear All, no "Clear all". La condición is_admin() mantiene las páginas de ajustes del plugin con su redacción original y cubre a la vez las peticiones AJAX que redibujan el filtro. Una cadena sustituida cambia en todos los sitios donde el plugin la muestra: Filter es también el botón del control deslizante de precios al estilo WooCommerce y el texto por defecto de la pestaña desplegable. Loco Translate hace lo mismo sin código. Traducir el filtro a varios idiomas es otra tarea, tratada en traducir las etiquetas del filtro con WPML, Polylang o Loco Translate.

Renombrar un término solo dentro del filtro

A veces una categoría o un valor de atributo debe leerse de forma distinta en el filtro que en la página del producto, por ejemplo un nombre de categoría largo que rompe el diseño de la barra lateral. Cada lista de términos pasa por woof_sort_terms_before_out antes de mostrarse, tanto para casillas como para botones de radio, desplegables, etiquetas, colores e imágenes:

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

Encuentra el ID de un término pasando el ratón por encima del término en Productos > Categorías (Products > Categories) o en la pantalla Configurar términos (Configure terms) del atributo: es el tag_ID del enlace. El hook también se ejecuta para los términos hijos, así que las subcategorías se pueden renombrar del mismo modo. La lista ya está ordenada cuando se ejecuta la prioridad 99, por lo que un término renombrado conserva la posición de su nombre original. Devuelve siempre el array completo: si devuelves solo los términos modificados, se eliminan todos los demás del filtro.

Si el nuevo nombre no aparece

  • No guardado. Aplicar (Apply) en la ventana emergente de opciones adicionales solo rellena el formulario; la etiqueta se almacena al hacer clic en Guardar cambios (Save changes) en la página de ajustes.
  • Caché de términos. Si Términos de la caché (Cache terms) está activado en Avanzadas (Advanced) > Opciónes (Options), el filtro conserva los nombres de términos que guardó en caché. Un término renombrado en WooCommerce muestra su nombre antiguo hasta que haces clic en limpiar términos de la caché (clear terms cache) o termina el periodo de limpieza automática.
  • Caché de páginas. Las páginas en caché conservan el HTML antiguo. Purga la caché de tu plugin de caché, del servidor o de la CDN, y prueba en una ventana privada.
  • El fragmento no se ejecuta. Asegúrate de que el código está en el functions.php del tema (hijo) activo o en un snippet activo, y de que el nombre del filtro, el número de argumentos y las cadenas son exactamente los de arriba.

Si un texto de tu filtro no está cubierto aquí, pregunta en el foro de soporte de HUSKY e incluye el texto exacto y dónde aparece.