HUSKY - WooCommerce Product Filter Professional

Como recolher subcategorias no filtro de categorias do WooCommerce

Um filtro de categorias que lista todas as subcategorias vira uma parede de checkboxes. A maioria das lojas prefere uma árvore: categorias pai visíveis, subcategorias recolhidas sob um sinal de mais e, às vezes, as categorias pai exibidas como simples títulos. Para recolher subcategorias em um filtro de categorias do WooCommerce criado com o HUSKY, você trabalha com dois mecanismos distintos que são fáceis de confundir: o pequeno abridor +/- ao lado de uma categoria que tem filhas e o botão de alternar no título do bloco, que recolhe o bloco inteiro do filtro. Eles têm configurações diferentes e guardam o estado de maneiras diferentes, o que explica a maioria das surpresas do tipo “ele abre sozinho”.

Recolher subcategorias no filtro de categorias do WooCommerce

Na aba Opções (Options) do plugin, defina Ocultar filhos em checkboxes e botões de opção (Hide childs in checkboxes and radio) como Sim (Yes) (as novas instalações já vêm com ela ativada). Cada lista de subcategorias passa então a ser impressa oculta, e cada termo que tem filhos recebe um abridor depois do nome: um pequeno sinal de mais que vira menos quando o ramo está aberto. Funciona em qualquer profundidade, de modo que uma subcategoria com filhas próprias ganha o seu próprio abridor.

  • Aplica-se apenas aos tipos de filtro Checkbox e Botão de opção (Radio). Os tipos de lista suspensa nunca recolhem subcategorias (veja a última seção).
  • Com Não (No), todas as subcategorias ficam sempre visíveis e não há abridores.
  • Para uma lista longa de categorias de nível superior, abra as opções adicionais (additional options) da taxonomia (o botão de engrenagem ao lado dela na aba Estrutura (Structure)) e preencha Quantidade de termos não recolhidos (Not toggled terms count): apenas essa quantidade de termos é mostrada, e um botão Mostrar mais (Show more) revela o resto.

Se alguns pais não devem listar de forma alguma as suas subcategorias no filtro, o hook woof_terms_where_hidden_childs as remove. Funciona para checkboxes, botões de opção e listas suspensas:

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

Retorne 1 para todos os termos para mostrar somente o nível superior.

Por que as subcategorias abertas continuam abertas depois de recarregar

Quando um visitante clica em um abridor, o plugin salva o estado desse ramo no armazenamento local do navegador. A cada carregamento de página, e depois de cada redesenho AJAX do filtro, os ramos salvos como abertos são abertos novamente. O armazenamento local não expira, então um ramo que você abriu durante um teste na semana passada continua aberto no seu navegador hoje, enquanto um novo visitante vê tudo fechado. Verifique sempre o estado padrão em uma janela privada.

Dois efeitos colaterais decorrem desse desenho:

  • O estado salvo decide qual ramo está aberto, não a seleção atual. Um visitante que chega por um link filtrado, por exemplo de um item de menu que aponta para um filtro de subcategoria, pode encontrar a subcategoria selecionada escondida dentro de um ramo fechado.
  • O estado é guardado sob a classe do item de lista do pai. As categorias de nível superior têm a sua própria classe (woof_term_15 e assim por diante), mas os itens abaixo do primeiro nível não, então todos os ramos abaixo do primeiro nível compartilham um único estado guardado: abra um ramo de segundo nível e, no próximo carregamento de página, todos os ramos de segundo nível estarão abertos.

Não há configuração para desligar a memória, e as edições do js/front.js sugeridas para isso no passado se perdem a cada atualização. O snippet abaixo faz isso a partir do seu tema. O plugin dispara o evento woof_init_search_form cada vez que termina de montar o filtro, no carregamento da página e depois dos redesenhos AJAX; o snippet escuta esse evento e define cada ramo de novo: aberto se contiver um termo selecionado, fechado caso contrário.

/*
 * 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 todos os ramos abertos por padrão mantendo os abridores, troque a linha var open por var open = true;.

Recolher blocos inteiros do filtro sob os seus títulos

O segundo mecanismo oculta um bloco inteiro, exceto o título. Abra as opções adicionais da taxonomia na aba Estrutura (Structure) e defina a opção de alternar como Sim, mostrar como fechado (Yes, show as closed) ou Sim, mostrar como aberto (Yes, show as opened). Na versão 3.4.6, essa opção se chama Mostrar botão de alternar para radio (Show toggle button for radio) no pop-up da taxonomia, mas é o botão de alternar do bloco dessa taxonomia. O título precisa estar visível (Mostrar rótulo do título (Show title label) = Sim (Yes)), porque o botão fica dentro dele. Na aba Design, Tipo de botão de alternar do bloco (Toggle block type) escolhe texto ou imagens, e os campos ao lado definem os textos (por padrão + e -) ou duas imagens de cerca de 20×20 px.

O estado do bloco não é memorizado no navegador. O servidor o define a cada página: um bloco definido para aparecer como fechado abre quando um dos seus termos faz parte do filtro atual, de modo que o visitante vê o que está selecionado. Para manter os blocos fechados mesmo assim, ou para forçá-los abertos, use o 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
});

O hook recebe apenas o estado, não a taxonomia, portanto se aplica a todos os blocos que têm o botão de alternar ativado.

Tornar o título inteiro clicável

Por padrão, só o +/- abre um bloco. O FAQ sobre fazer o botão de alternar incluir o título anexa o clique no carregamento da página. A versão abaixo é delegada, por isso continua funcionando depois que a filtragem AJAX redesenha o formulário, e ignora os cliques no próprio +/-, que de outra forma alternariam o bloco duas vezes:

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

Se você alterou a tag do título com o hook woof_title_tag, troque h4 pela sua tag. Um botão de alternar em texto é um link, então a cor dele é definida com CSS como .woof_container_inner h4 a.woof_front_toggle { color: #222; }.

Para recolher vários blocos sob um único título, por exemplo todos os atributos sob “Mais filtros”, use a extensão Sections. Depois de ativada na aba Extensões (Extensions), as configurações dela em Avançado (Advanced) → Seções (Sections) envolvem uma sequência de elementos do filtro em uma seção que abre e fecha; Comportamento das seções (Sections behavior) Como checkbox (As checkbox) permite que várias seções fiquem abertas ao mesmo tempo, e Como radio (As radio) mantém apenas uma aberta.

Mostrar uma categoria pai como título, sem checkbox

Quando os produtos são atribuídos somente às subcategorias, a categoria pai funciona melhor como título. Com um Skin de botões de opção e caixas de seleção (Radio and checkboxes skin) selecionado na aba Design, o input real é envolvido em uma div cuja classe é o nome do skin com hífen: o skin square_blue gera icheckbox_square-blue (e iradio_square-blue para botões de opção). O CSS escrito com icheckbox_square_grey, com sublinhado, portanto não corresponde a nada. As regras abaixo funcionam com qualquer skin e com inputs simples. O script do plugin adiciona a classe woof_childs_list_li a todo item que tem filhos, em todos os níveis. Coloque o CSS em Avançado (Advanced) → Código (Code) → Código CSS personalizado (Custom CSS code) ou no seu 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 apenas uma categoria de nível superior, use a classe de termo dela, por exemplo .woof_term_123 > div[class*="icheckbox_"]. Os itens abaixo do primeiro nível não têm classe de termo; use como alvo a lista do pai deles: ul.woof_childs_list_123 > li.woof_childs_list_li > div[class*="icheckbox_"].

O nome de um pai continua sendo um rótulo do seu input oculto, então um clique nele selecionaria o pai. O próximo snippet transforma esse clique em abrir e fechar o ramo. Ele também é a resposta quando você mantém os checkboxes mas quer que um clique no nome da categoria expanda as subcategorias dela:

/*
 * 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 outra taxonomia, troque product_cat pelo slug dela, por exemplo .woof_container_pa_brand.

Subcategorias sem recuo, ou em uma única linha

O plugin recua cada lista de subcategorias em 17 px. Quando as subcategorias se alinham sob o pai como se fossem categorias pai, uma regra do tema para listas em widgets ou barras laterais remove esse preenchimento com um seletor mais forte. Restaure-o:

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

Subcategorias lado a lado em uma só linha costumam vir da opção do bloco Exibir itens em linha (Display items in a row): ela coloca em linha todo termo sem filhos, inclusive as subcategorias. Defina-a como Não (No) para uma árvore. Se a opção estiver desativada, procure uma regra do tema que dê às listas display: flex ou aos itens de lista display: inline-block.

Se o mais e o menos dos abridores forem difíceis de ver no seu fundo, substitua-os na aba Design por Imagem para subcategorias abertas (Image for subcategories open) (o mais) e Imagem para subcategorias fechadas (Image for subcategories close) (o menos). Elas são exibidas em uma caixa de 13×13 px, então use ícones simples e de alto contraste.

Filtros de categoria em lista suspensa

Os tipos Lista suspensa (Drop-down) e Lista suspensa múltipla (Multi drop-down) não conseguem recolher subcategorias. A lista suspensa simples recua as subcategorias com espaços; a múltipla as lista de forma plana. Cada opção de subcategoria traz uma classe com a sua profundidade, woof-padding-1, woof-padding-2 e assim por diante, enquanto as opções de nível superior não têm nenhuma. Os navegadores permitem pouca estilização das opções nativas, mas com Skin da lista suspensa (Drop-down skin) definido como Chosen as classes chegam à lista visível, e assim você pode marcar os níveis:

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

Se os visitantes devem escolher primeiro um pai e depois a subcategoria dele em uma segunda lista suspensa, use a extensão Hierarchy drop-down; o artigo sobre um filtro de ano, marca e modelo mostra a configuração.

Checklist

  • O bloco de categorias usa o tipo Checkbox ou Botão de opção (Radio) e Ocultar filhos em checkboxes e botões de opção (Hide childs in checkboxes and radio) está em Sim (Yes).
  • O estado padrão foi verificado em uma janela privada, não em um navegador que memoriza ramos abertos.
  • O snippet dos ramos está no lugar, se os ramos devem seguir a seleção em vez dos cliques anteriores do visitante.
  • Os botões de alternar dos blocos estão definidos nas opções adicionais da taxonomia, o título é exibido e woof_block_toggle_state só é usado se o comportamento padrão de abrir na seleção não for desejado.
  • O CSS personalizado usa a classe de skin com hífen ou a forma [class*="icheckbox_"], e os caches da página e do navegador foram limpos após cada alteração.

Se a árvore ainda não se comportar como descrito, abra um tópico no fórum de suporte do HUSKY com um link para a página do filtro e as configurações do bloco de categorias.