HUSKY - WooCommerce Product Filter Professional

Filtro de produtos WooCommerce não aparece no celular: causas e soluções

O filtro funciona no computador, mas no celular a barra lateral sumiu, o botão Abrir filtro (Open filter) nunca aparece, ou aparece e não faz nada. Um filtro de produtos WooCommerce que não aparece no celular raramente está quebrado. O modo móvel do HUSKY tem três partes em movimento: o servidor decide que o visitante usa um celular, um script move o botão para o seu lugar e um toque abre o formulário como um painel em tela cheia. Cada uma dessas partes pode ser interrompida pelo tema, por um page builder, por um cache ou por um otimizador. Este guia mostra qual parte falhou e como corrigir.

Como funciona o modo móvel do HUSKY

Muitos temas simplesmente não exibem a barra lateral em celulares. Se o filtro é um widget da barra lateral e nada mais foi configurado, isso por si só explica por que ele não aparece. O modo móvel é a forma que o plugin oferece para dar aos celulares um botão que abre o filtro. Não existe uma chave global “móvel” nas configurações; o modo móvel é ativado em cada formulário de filtro:

  • Widget: defina Modo móvel (Mobile mode) como Sim no widget do HUSKY.
  • Shortcode: [woof sid="mobile" mobile_mode=1]. O atributo sid é obrigatório; sem ele, mobile_mode é ignorado.
  • Front builder: ative Modo móvel (Mobile mode) nas opções do formulário [woof_front_builder].

Quando a página é gerada para um celular, o plugin imprime esse formulário oculto e adiciona a ele dois botões, Abrir filtro (Open filter) e Fechar filtro (Close filter). Em computadores, o mesmo formulário é exibido normalmente. Quando a página carrega em um celular, um script move o botão Abrir filtro (Open filter) do formulário oculto para um lugar visível:

  1. o contêiner impresso pelo shortcode [woof_mobile], se a página tiver um;
  2. caso contrário, o elemento que corresponde a .woocommerce-products-header, o bloco com o título da loja ou da categoria no template de arquivo padrão do WooCommerce.

Um toque no botão adiciona a classe woof_show_filter_for_mobile ao formulário, que o transforma em um painel fixo em tela cheia sobre a página. No modo AJAX, o painel se fecha sozinho após cada filtragem, para que o visitante veja os novos produtos.

Dois fatos explicam a maioria dos problemas. Primeiro, o que é “celular” é decidido no servidor pela função wp_is_mobile() do WordPress, a partir dos cabeçalhos da requisição, e não pela largura da tela. Segundo, [woof_mobile] apenas marca um lugar: ele não mostra nada se a mesma página não tiver também um formulário com o modo móvel ativado.

O botão Abrir filtro não aparece

O template não tem um lugar para ele. Templates do theme builder do Elementor e do Divi, layouts do Avada, páginas personalizadas que listam produtos com o shortcode [products] e muitos temas personalizados costumam não ter o bloco .woocommerce-products-header. O botão então fica dentro do formulário oculto. Coloque [woof_mobile] exatamente onde o botão deve ficar, normalmente acima dos produtos, em um widget ou bloco de Shortcode. Essa é a correção mais comum. Ele não imprime nada em computadores, então pode permanecer na página.

Se você não consegue colocar um shortcode nesse template, aponte o botão para um elemento seu com o hook woof_mobile_btn_place_container. Dê a esse elemento um ID único (no Elementor: Avançado → ID do CSS (Advanced → CSS ID)) e use-o:

/*
 * HUSKY: where to put the mobile "Open filter" button.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_mobile_btn_place_container', function ($selector) {
    return '#filter-button-place';
});

Use um seletor que corresponda a um único elemento. Uma classe ampla como .elementor-widget-container copia o botão para todos os elementos correspondentes da página. O hook não é usado quando a página tem um contêiner [woof_mobile].

Outros motivos para o botão não aparecer:

  • O lugar é ocultado em celulares pelo tema (um cabeçalho ou barra de ferramentas que só aparece em computadores). Escolha um lugar que seja visível no celular.
  • O botão aparece no início e some depois da filtragem: o contêiner [woof_mobile] está dentro da lista de produtos que o AJAX substitui. Mova-o para cima da lista.
  • A otimização de JavaScript adia os scripts até o primeiro toque ou rolagem (“atrasar a execução do JavaScript” no WP Rocket e recursos semelhantes). O botão só é movido quando o script do plugin é executado. Exclua /wp-content/plugins/woocommerce-products-filter/ do atraso, do adiamento (defer) e da combinação, e depois limpe os caches. Os detalhes estão em o filtro com WP Rocket e cache.
  • A otimização de CSS (combinar ou “remover CSS não utilizado”) removeu os estilos do plugin, e o botão existe na página, mas está oculto ou sem estilo. Exclua também o CSS do plugin.
  • Você está testando em um tablet. O Safari no iPad e o Chrome em tablets Android maiores solicitam por padrão a versão desktop dos sites, de modo que esses tablets recebem o layout de computador. Se o tema oculta a barra lateral na largura de tablet, o filtro some ali; mostre a barra lateral com CSS ou coloque o formulário na área de conteúdo.

O botão está lá, mas nada abre

O formulário está dentro de algo oculto. O botão saiu do formulário, mas o painel continua sendo o próprio formulário, no lugar original. Se o tema oculta a barra lateral em celulares com display: none, o painel abre dentro de uma caixa oculta e permanece invisível. Há três saídas:

  • Mostrar a barra lateral em celulares com CSS. O formulário do HUSKY dentro dela continua oculto até o botão ser tocado, mas os outros widgets dessa barra lateral também ficam visíveis, então isso serve para uma barra lateral que contém apenas o filtro.
  • Mover o formulário em modo móvel para fora da barra lateral, para a área de conteúdo, por exemplo acima dos produtos.
  • Deixar o widget para computadores (com Modo móvel (Mobile mode) em Não) e deixar o plugin colocar um filtro acima dos produtos somente em celulares: Opções → Definir filtro automaticamente → Sim, mas somente para dispositivos móveis (Options → Set filter automatically → Yes, but only for mobile devices), mais Design → Ocultar o filtro automático por padrão → Sim (Design → Hide auto filter by default → Yes) para ter um botão de mostrar/ocultar. Isso exige um template que execute o loop de produtos padrão do WooCommerce.

Uma regra típica para a primeira saída, com o seletor adaptado ao seu tema:

/* Theme hides #secondary (sidebar) on phones: keep it for the HUSKY panel */
@media (max-width: 768px) {
    body.woocommerce-page #secondary {
        display: block;
    }
}

O mesmo acontece quando o filtro está dentro de um menu deslizante (off-canvas) do tema ou de um popup do Elementor: o menu ou o popup tem a sua própria visibilidade e seus próprios scripts, e o painel não consegue abrir de dentro dele. Use o menu deslizante ou o modo móvel do HUSKY, não os dois.

O sid contém um espaço. A sintaxe de skin como sid="flat_grey woof_auto_3_columns" funciona para a aparência do formulário, mas na versão 3.4.6 o botão móvel não encontra um formulário cujo sid tem duas palavras. Use um sid de uma palavra para um formulário em modo móvel.

Há duas cópias do filtro. Os page builders costumam conter uma seção para computador e uma duplicata para celular, ocultadas com a visibilidade responsiva. As duas estão no HTML, ocultas apenas por CSS, e dois formulários com os mesmos identificadores brigam entre si: as seções deixam de abrir, aparecem dois ícones de filtro ou o botão abre a cópia que você não vê. Mantenha um filtro por página e deixe o modo móvel cuidar dos celulares.

Um erro de script. Abra a página no celular, ou na emulação de dispositivo do navegador no desktop depois de recarregar, e verifique o console do navegador. Um erro em qualquer script carregado antes do HUSKY também o interrompe.

Layout móvel no computador, layout de computador no celular

Como a decisão é tomada quando a página é gerada, um cache de página que guarda uma única cópia para todos serve o que o primeiro dispositivo visitante recebeu. Os visitantes no computador passam então a receber o botão Abrir filtro (Open filter) e um formulário oculto, ou os visitantes no celular recebem a barra lateral completa e nenhum botão, e isso muda a cada limpeza do cache. A correção está no cache, não no filtro:

  • WP Rocket: ative o cache para dispositivos móveis e Arquivos de cache separados para dispositivos móveis (Separate cache files for mobile devices).
  • LiteSpeed Cache: ative Cache móvel (Cache Mobile).
  • Cache de página do Cloudflare, Varnish ou cache da hospedagem: faça o cache por tipo de dispositivo ou exclua as páginas da loja e das categorias.

Limpe todos os caches depois da alteração. O mesmo vale para a visibilidade móvel da extensão slideout e para Definir filtro automaticamente (Set filter automatically) com os valores Sim, mas somente para dispositivos móveis (Yes, but only for mobile devices) e Sim, mas somente para desktop (Yes, but only for desktop), que também usam wp_is_mobile().

Pelo mesmo motivo, redimensionar a janela do navegador no computador nunca muda o filtro para o modo móvel. Teste em um celular real, sem estar conectado, ou na emulação de dispositivo do navegador com recarga da página.

Problemas dentro do painel aberto

As listas suspensas aparecem recolhidas, vazias ou abrem o teclado. As listas suspensas Chosen e SelectWoo calculam a largura quando a página carrega, enquanto o formulário ainda está oculto, e vêm com um campo de busca que faz o teclado do celular aparecer. A correção mais limpa é Design → Skin da lista suspensa → Nativo (Design → Drop-down skin → Native): os celulares passam a mostrar a sua própria lista de seleção, sem campo de busca e sem problemas de largura. Para manter o Chosen ou o SelectWoo, dê a eles uma largura mínima:

/* HUSKY: drop-downs collapsed in a hidden or narrow container */
.woof .chosen-container,
.woof .select2-container {
    min-width: 200px;
}

O painel está transparente, escondido sob um cabeçalho fixo, ou o texto está invisível. O painel é levemente transparente por padrão e usa z-index: 9999, valor que alguns cabeçalhos fixos superam. Ajuste-o no seu CSS personalizado:

/* HUSKY mobile panel: opaque, above the sticky header, readable text */
.woof_show_filter_for_mobile.woof {
    opacity: 1;
    z-index: 100000;
}
.woof_show_filter_for_mobile.woof h4,
.woof_show_filter_for_mobile.woof label {
    color: #333;
}

Se o painel ainda abrir sob o cabeçalho (o cabeçalho está em um contexto de empilhamento acima do qual o painel não consegue subir), adicione padding-top: 90px; à primeira regra, para que o botão Fechar filtro (Close filter) comece abaixo do cabeçalho.

O painel fecha a cada toque. Com o envio automático e o AJAX, cada escolha executa o filtro, e o painel se fecha para mostrar os resultados. Se os visitantes costumam combinar várias opções, desative o envio automático para este formulário, [woof sid="mobile" mobile_mode=1 autosubmit=0], para que eles escolham e depois toquem no botão de filtrar.

Pequenos problemas no iPhone. Um placeholder desalinhado no campo de busca por texto é corrigido com .woof_container .woof_container_inner input[type="search"] { line-height: normal !important; }. Os contadores de produtos dos filtros do tipo rótulo que se afastam dos seus rótulos são corrigidos com .woof_container_label .woof_list_label li { position: relative; }.

Como alterar o botão

A aparência do botão é definida na aba Design: Imagem do botão de filtro móvel (Image for mobile filter button), Texto do botão de filtro móvel (Text for mobile filter button), Imagem para fechar o filtro móvel (Image to close mobile filter) e Texto para fechar o filtro móvel (Text to close mobile filter). Digite -1 em um campo de imagem para mostrar apenas o texto, ou em um campo de texto para mostrar apenas o ícone. O espaçamento e a cor são CSS simples em .woof_show_mobile_filter, por exemplo .woof_show_mobile_filter { margin: 10px 0 20px; color: #796699; }.

Para os passos básicos de configuração, veja como exibir o filtro em dispositivos móveis; para todos os atributos do shortcode principal, a referência do [woof].

Lista de verificação

  • Um único formulário de filtro na página, com o modo móvel ativado (opção do widget, ou mobile_mode=1 com um sid de uma palavra, ou a opção do front builder).
  • [woof_mobile] colocado onde o botão deve ficar, fora da lista de produtos, em um lugar visível em celulares.
  • O próprio formulário não está dentro de uma barra lateral, de um menu deslizante ou de um popup oculto em celulares.
  • O JavaScript e o CSS do plugin estão excluídos do atraso, do adiamento (defer), da combinação e da remoção de CSS não utilizado.
  • O cache de página mantém cópias separadas para dispositivos móveis, e todos os caches foram limpos.
  • Testado em um celular real ou com emulação de dispositivo e recarga da página, sem estar conectado.

Se o filtro ainda não aparecer no celular, abra um tópico no fórum de suporte do HUSKY com o link da página, as configurações do shortcode ou do widget que você usa e os erros do console do navegador.