HUSKY - WooCommerce Product Filter Professional

Cómo contraer subcategorías en un filtro de categorías de WooCommerce

Un filtro de categorías que lista todas las subcategorías se convierte en un muro de casillas. La mayoría de las tiendas prefieren un árbol: categorías padre visibles, subcategorías plegadas bajo un signo más y, a veces, los padres mostrados como simples encabezados. Para contraer las subcategorías en un filtro de categorías de WooCommerce creado con HUSKY trabajas con dos mecanismos distintos que es fácil confundir: el pequeño control +/- junto a una categoría que tiene hijos, y el conmutador del título del bloque que pliega todo el bloque del filtro. Tienen ajustes diferentes y guardan su estado de distinta manera, lo que explica la mayoría de las sorpresas del tipo "se abre solo".

Contraer subcategorías en el filtro de categorías de WooCommerce

En la pestaña Opciones (Options) del plugin establece Ocultar las miniaturas en las casillas de verificación y en la radio (Hide childs in checkboxes and radio) en Sí (Yes) (las instalaciones nuevas ya lo tienen activado). Cada lista de subcategorías se imprime entonces oculta, y cada término que tiene hijos recibe un control de apertura después de su nombre: un pequeño signo más que se convierte en menos cuando la rama está abierta. Funciona en todos los niveles de profundidad, así que una subcategoría con sus propios hijos tiene su propio control.

  • Se aplica solo a los tipos de filtro Casilla de verificación (Checkbox) y Radio. Los tipos de lista desplegable nunca pliegan subcategorías (consulta la última sección).
  • Con No, todas las subcategorías son siempre visibles y no hay controles de apertura.
  • Para una lista larga de categorías de primer nivel, abre las opciones adicionales (additional options) de la taxonomía (el botón de engranaje junto a ella en la pestaña Estructura (Structure)) y rellena Los términos no conmutados cuentan (Not toggled terms count): solo se muestran esa cantidad de términos y un botón Mostrar más (Show more) revela el resto.

Si algunos padres no deben listar sus subcategorías en el filtro en absoluto, el hook woof_terms_where_hidden_childs las elimina. Funciona con casillas, botones de radio y listas desplegables:

/*
 * Product filter: list these parent categories without their subcategories.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_terms_where_hidden_childs', function ($term_id) {
    $parents = array(15, 27); // IDs of the parent categories
    return in_array((int) $term_id, $parents, true) ? 1 : 0;
});

Devuelve 1 para todos los términos para mostrar solo el nivel superior.

Por qué las subcategorías abiertas siguen abiertas tras recargar

Cuando un visitante hace clic en un control de apertura, el plugin guarda el estado de esa rama en el almacenamiento local del navegador. En cada carga de página, y después de cada redibujado AJAX del filtro, las ramas guardadas como abiertas vuelven a abrirse. El almacenamiento local no caduca, así que una rama que abriste mientras probabas la semana pasada sigue abierta hoy en tu navegador, mientras que un visitante nuevo lo ve todo cerrado. Comprueba siempre el estado predeterminado en una ventana privada.

Este diseño tiene dos efectos secundarios:

  • El estado guardado decide qué rama está abierta, no la selección actual. Un visitante que llega mediante un enlace filtrado, por ejemplo desde un elemento de menú que apunta a un filtro de subcategoría, puede encontrar la subcategoría seleccionada oculta dentro de una rama cerrada.
  • El estado se almacena bajo la clase del elemento de lista del padre. Las categorías de primer nivel tienen su propia clase (woof_term_15 y así sucesivamente), pero los elementos por debajo del primer nivel no, de modo que todas las ramas por debajo del primer nivel comparten un único estado almacenado: abre una rama de segundo nivel y, tras la siguiente carga de página, todas las ramas de segundo nivel están abiertas.

No hay ningún ajuste para desactivar esa memoria, y las ediciones de js/front.js que se sugerían antes para ello se pierden con cada actualización. El fragmento siguiente lo resuelve desde tu tema. El plugin lanza el evento woof_init_search_form cada vez que ha construido el filtro, al cargar la página y tras los redibujados AJAX; el fragmento lo escucha y vuelve a configurar cada rama: abierta si contiene un término seleccionado, cerrada en caso contrario.

/*
 * Product filter: ignore remembered branches. A branch of subcategories is
 * open only when it contains a selected term.
 * Child theme functions.php or a code snippets plugin.
 */
add_action('wp_footer', function () {
    ?>
    <script>
    document.addEventListener('woof_init_search_form', function () {
        jQuery('ul.woof_childs_list').each(function () {
            var list = jQuery(this);
            var sign = list.parent('li').children('.woof_childs_list_opener').find('span');
            if (!sign.length) {
                return; // this list has no +/- opener
            }
            var open = list.find('input:checked').length > 0;
            list.toggle(open);
            sign.toggleClass('woof_is_opened', open).toggleClass('woof_is_closed', !open);
        });
    });
    </script>
    <?php
}, 100);

Para mostrar todas las ramas abiertas por defecto conservando los controles, cambia la línea var open por var open = true;.

Plegar bloques de filtro enteros bajo sus títulos

El segundo mecanismo oculta un bloque completo salvo su título. Abre las opciones adicionales de la taxonomía en la pestaña Estructura (Structure) y establece la opción de conmutador en Sí, mostrar cerrado (Yes, show as closed) o Sí, mostrar abierto (Yes, show as opened). En la versión 3.4.6 esta opción se llama Mostrar botón de conmutación para radio (Show toggle button for radio) en la ventana emergente de la taxonomía, pero es el conmutador del bloque de esa taxonomía. El título debe estar visible (Mostrar etiqueta de título (Show title label) = Sí (Yes)), porque el conmutador está dentro de él. En la pestaña Diseño (Design), Tipo de bloque de conmutación (Toggle block type) elige entre texto o imágenes, y los campos contiguos establecen los textos (por defecto + y -) o dos imágenes de unos 20×20 px.

El estado del bloque no se recuerda en el navegador. Lo establece el servidor en cada página: un bloque configurado para mostrarse cerrado se abre cuando uno de sus términos forma parte del filtro actual, de modo que el visitante ve lo que está seleccionado. Para mantener los bloques cerrados incluso entonces, o para forzarlos abiertos, usa el hook woof_block_toggle_state:

/*
 * Product filter: blocks with a toggle always start closed.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_block_toggle_state', function ($block_is_closed) {
    return true; // true = closed, false = opened
});

El hook recibe solo el estado, no la taxonomía, así que se aplica a todos los bloques que tienen el conmutador activado.

Hacer clicable todo el título

Por defecto solo el +/- abre un bloque. Las preguntas frecuentes sobre hacer que el conmutador incluya el título asocian el clic al cargar la página. La versión siguiente está delegada, de modo que sigue funcionando después de que el filtrado AJAX redibuje el formulario, e ignora los clics sobre el propio +/-, que de otro modo alternarían el bloque dos veces:

/*
 * Product filter: a click anywhere on a block title opens or closes the block.
 * Child theme functions.php or a code snippets plugin.
 */
add_action('wp_footer', function () {
    ?>
    <style>.woof_container_inner > h4:has(> .woof_front_toggle) { cursor: pointer; }</style>
    <script>
    jQuery(document).on('click', '.woof_container_inner > h4', function (e) {
        if (jQuery(e.target).closest('.woof_front_toggle, .woof_tooltip_header').length) {
            return; // the +/- or the tooltip icon was clicked
        }
        jQuery(this).children('.woof_front_toggle').trigger('click');
    });
    </script>
    <?php
}, 100);

Si cambiaste la etiqueta del título con el hook woof_title_tag, sustituye h4 por tu etiqueta. Un conmutador de texto es un enlace, así que su color se define con CSS como .woof_container_inner h4 a.woof_front_toggle { color: #222; }.

Para plegar varios bloques bajo un mismo encabezado, por ejemplo todos los atributos bajo "Más filtros", usa la extensión Sections. Una vez activa en la pestaña Extensiones (Extensions), sus ajustes en Avanzadas (Advanced) → Secciones (Sections) agrupan un rango de elementos del filtro en una sección que se abre y se cierra; Comportamiento de las secciones (Sections behavior) con Como casilla de verificación (As checkbox) permite tener varias secciones abiertas a la vez, y con Como radio (As radio) solo se mantiene una abierta.

Mostrar una categoría padre como encabezado sin casilla

Cuando los productos se asignan solo a subcategorías, el padre funciona mejor como encabezado. Con una Piel de radio y casillas de verificación (Radio and checkboxes skin) seleccionada en la pestaña Diseño (Design), el input real queda envuelto en un div cuya clase es el nombre de la piel con un guion: la piel square_blue da icheckbox_square-blue (y iradio_square-blue para botones de radio). El CSS escrito con icheckbox_square_grey, con guion bajo, no coincide por tanto con nada. Las reglas siguientes funcionan con cualquier piel y con inputs simples. El script del plugin añade la clase woof_childs_list_li a cada elemento que tiene hijos, en todos los niveles. Pon el CSS en Avanzadas (Advanced) → Código (Code) → Código CSS personalizado (Custom CSS code) o en tu tema:

/* Product categories filter: parents become headings without a box */
.woof_container_product_cat li.woof_childs_list_li > input,
.woof_container_product_cat li.woof_childs_list_li > div[class*="icheckbox_"],
.woof_container_product_cat li.woof_childs_list_li > div[class*="iradio_"] {
    display: none !important;
}
.woof_container_product_cat li.woof_childs_list_li > label {
    font-weight: bold;
    cursor: pointer;
}

Para una sola categoría de primer nivel, usa su clase de término, por ejemplo .woof_term_123 > div[class*="icheckbox_"]. Los elementos por debajo del primer nivel no tienen clase de término; apúntalos a través de la lista de su padre: ul.woof_childs_list_123 > li.woof_childs_list_li > div[class*="icheckbox_"].

El nombre de un padre sigue siendo la etiqueta de su input oculto, así que un clic sobre él seleccionaría al padre. El siguiente fragmento convierte ese clic en abrir y cerrar la rama. También es la respuesta cuando conservas las casillas pero quieres que un clic sobre el nombre de la categoría despliegue sus subcategorías:

/*
 * Product filter: a click on the name of a parent category opens or closes
 * its subcategories instead of selecting it.
 * Child theme functions.php or a code snippets plugin.
 */
add_action('wp_footer', function () {
    ?>
    <script>
    document.addEventListener('click', function (e) {
        var label = e.target.closest ? e.target.closest('.woof_container_product_cat li.woof_childs_list_li > label') : null;
        if (!label) {
            return;
        }
        e.preventDefault(); // do not select the parent
        e.stopPropagation();
        jQuery(label).siblings('.woof_childs_list_opener').find('span').trigger('click');
    }, true);
    </script>
    <?php
}, 100);

Para otra taxonomía, sustituye product_cat por su slug, por ejemplo .woof_container_pa_brand.

Subcategorías sin sangría, o en una sola línea

El plugin aplica una sangría de 17 px a cada lista de subcategorías. Cuando las subcategorías se alinean bajo el padre como si fueran padres, una regla del tema para listas en widgets o barras laterales elimina ese relleno con un selector más fuerte. Restáuralo:

.woof .woof_block_html_items .woof_childs_list {
    padding: 0 0 0 17px !important;
}

Las subcategorías una al lado de otra en una sola fila suelen venir de la opción de bloque Visualizar artículos en una línea (Display items in a row): coloca en línea todos los términos sin hijos, subcategorías incluidas. Establécela en No para un árbol. Si la opción está desactivada, busca una regla del tema que dé a las listas display: flex o a los elementos de lista display: inline-block.

Si el más y el menos de los controles de apertura se ven mal sobre tu fondo, sustitúyelos en la pestaña Diseño (Design) con Imagen para subcategorías abiertas (Image for subcategories open) (el más) e Imagen para subcategorías cerradas (Image for subcategories close) (el menos). Se muestran en una caja de 13×13 px, así que usa iconos simples y de alto contraste.

Filtros de categorías en lista desplegable

Los tipos Desplegable (Drop-down) y Desplegable múltiple (Multi drop-down) no pueden plegar subcategorías. La lista desplegable simple aplica sangría a las subcategorías con espacios; la múltiple las lista en plano. Cada opción de subcategoría lleva una clase con su profundidad, woof-padding-1, woof-padding-2 y así sucesivamente, mientras que las opciones de primer nivel no tienen ninguna. Los navegadores permiten poco estilo en las opciones nativas, pero con la Piel de lista desplegable (Drop-down skin) en Chosen las clases llegan a la lista visible, de modo que puedes marcar los niveles:

/* Category drop-downs with the Chosen skin: bold top level */
.woof_container_product_cat .chosen-results li.active-result:not([class*="woof-padding-"]) {
    font-weight: bold;
}
/* Multi drop-down: indent subcategories by level */
.woof_container_mselect.woof_container_product_cat .chosen-results li.woof-padding-1 { padding-left: 20px; }
.woof_container_mselect.woof_container_product_cat .chosen-results li.woof-padding-2 { padding-left: 34px; }

Si los visitantes deben elegir primero un padre y después su subcategoría en una segunda lista desplegable, usa la extensión Hierarchy drop-down; el artículo sobre un filtro de año, marca y modelo muestra la configuración.

Lista de comprobación

  • El bloque de categorías usa el tipo Casilla de verificación (Checkbox) o Radio y Ocultar las miniaturas en las casillas de verificación y en la radio (Hide childs in checkboxes and radio) está en Sí (Yes).
  • El estado predeterminado se comprobó en una ventana privada, no en un navegador que recuerda las ramas abiertas.
  • El fragmento de ramas está instalado si las ramas deben seguir la selección en lugar de los clics anteriores del visitante.
  • Los conmutadores de bloque se configuran en las opciones adicionales de la taxonomía, el título se muestra y woof_block_toggle_state se usa solo si no se desea la apertura por defecto al haber selección.
  • El CSS personalizado usa la clase de piel con guion o la forma [class*="icheckbox_"], y las cachés de la página y del navegador se vaciaron tras cada cambio.

Si el árbol sigue sin comportarse como se describe, abre un tema en el foro de soporte de HUSKY con un enlace a la página del filtro y los ajustes del bloque de categorías.