HUSKY - WooCommerce Product Filter Professional

Remover o prefixo Product e renomear títulos do filtro WooCommerce

Product Color, Product Size, Product Material: quando todo bloco de atributo do filtro da sua loja começa com a mesma palavra, o filtro está apenas exibindo o nome que o WooCommerce deu ao atributo. Para remover o prefixo Product dos títulos do filtro WooCommerce, você dá ao bloco um título próprio, seja um a um nas configurações do filtro, seja para todos os atributos de uma vez com algumas linhas de código. Os mesmos lugares controlam os demais textos do filtro: os títulos dos blocos, a primeira opção de uma lista suspensa, Limpar tudo (Clear All), Redefinir (Reset), Filtrar (Filter), Mostrar mais (Show more) e até os nomes de termos individuais. Todos podem ser alterados sem editar arquivos do plugin.

De onde vem cada texto do filtro

O HUSKY não guarda um nome próprio para uma taxonomia. Ele pede ao WordPress o nome no plural da taxonomia e o exibe, a menos que você defina um rótulo personalizado. O WooCommerce registra cada atributo global com o nome no plural Product %s, de modo que o atributo Cor (Color) vira uma taxonomia chamada "Product Color", enquanto o singular continua "Color". Categorias e tags funcionam do mesmo jeito: seus nomes no plural são "Product categories" e "Product tags". A tabela mostra de onde vem cada texto visível e onde alterá-lo.

Texto na páginaDe onde vemOnde alterar
Título acima de todo o filtro ("HUSKY Filter")O título do widgetO campo Título (Title) do widget
Título de um bloco (Product Color, Product categories)O nome da taxonomiaRótulo personalizado da taxonomia (Taxonomy custom label) ou o hook woof_filter_title
Primeira opção de uma lista suspensaO mesmo nome da taxonomiaO título do bloco ou uma cópia do template da lista suspensa
Título do filtro de preçoO Texto do título (Title text) do filtro de preçoOpções adicionais de Pesquisar por preço (Search by Price)
Em estoque (In stock), Em promoção (On sale), Produtos em destaque (Featured products)Textos das extensõesOs hooks woof_ext_custom_title_*
Limpar tudo (Clear All) no painel de filtros ativosString do pluginO hook woof_clear_all_text
Botões Filtrar (Filter) e Redefinir (Reset), rótulo ordenar por (orderby)Strings e opções do pluginA aba Opções ou uma tradução
Mostrar mais (Show more) / Mostrar menos (Show less), no celular Abrir filtro (Open filter) / Fechar filtro (Close filter)Opções da aba DesignA aba Design
Nome de um termo individualO próprio termoO hook woof_sort_terms_before_out

Remover o prefixo Product dos títulos do filtro WooCommerce

Há três maneiras, do efeito mais restrito ao mais amplo. Escolha uma; você não precisa de todas.

Um bloco por vez: Rótulo personalizado da taxonomia

  1. Abra WooCommerce > Configurações > Filtro de produtos (WooCommerce > Settings > Products Filter), aba Estrutura (Structure).
  2. Na linha do atributo (por exemplo pa_color), clique no ícone de engrenagem, opções adicionais (additional options).
  3. Digite o título desejado em Rótulo personalizado da taxonomia (Taxonomy custom label), por exemplo Color. Deixe o campo vazio para voltar ao nome do WooCommerce.
  4. Clique em Aplicar (Apply) no popup e depois em Salvar alterações (Save changes) no final da página de configurações.

O rótulo personalizado substitui o nome da taxonomia em todos os lugares em que o filtro o usa: o título do bloco, a primeira opção de uma lista suspensa, o placeholder de uma seleção múltipla e o rótulo do valor selecionado no painel de filtros ativos. É também assim que você renomeia "Product categories" para "Categorias" ou "Comprar por tipo", ou dá um título diferente a uma taxonomia de marcas. Em uma lista suspensa hierárquica, o mesmo campo guarda os títulos de cada nível; o guia do filtro de ano, marca e modelo explica esse formato.

Todos os atributos de uma vez: o hook woof_filter_title

Com vinte atributos, digitar um rótulo para cada um é tedioso, e cada novo atributo exige isso de novo. Todo título de bloco do filtro passa pelo hook woof_filter_title, então um único trecho de código pode substituir o nome "Product ..." de cada atributo pelo seu nome no 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);

A verificação $title === $taxonomy_info->labels->name preserva qualquer Rótulo personalizado da taxonomia (Taxonomy custom label) que você tenha definido: o trecho só mexe nos títulos que ainda são o nome do WooCommerce. Ele não altera nada fora do filtro. O hook também recebe alguns textos de botões com um $taxonomy_info vazio, e é por isso que o trecho verifica is_object() primeiro.

Em todo o site: alterar a string do WooCommerce

Se você quer o prefixo removido em todos os lugares que exibem nomes de taxonomias de atributos, incluindo outros widgets e telas do painel, altere a própria string do WooCommerce. O prefixo vem de _x( 'Product %s', 'Product Attribute', 'woocommerce' ), então um filtro de tradução pode retornar apenas o 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);

O mesmo resultado pode ser obtido com o Loco Translate, traduzindo Product %s para %s no domínio de texto do WooCommerce; salve o arquivo no local personalizado do Loco para que uma atualização do WooCommerce não o sobrescreva. Em um site em outro idioma, a string traduzida (por exemplo "Produkt %s") é o que você vê, mas o trecho compara o texto original em inglês, então funciona para qualquer idioma do site.

Um efeito colateral de qualquer método de renomeação: cada bloco também recebe uma classe CSS construída a partir do seu título, como woof_container_productcolor. Depois da renomeação, ela passa a ser woof_container_color. Se o seu CSS personalizado usa a classe antiga, troque-o pela classe baseada no slug, woof_container_pa_color, que nunca muda.

Alterar ou ocultar o título do filtro e o cabeçalho do widget

O texto "HUSKY Filter" acima de todo o filtro não é uma configuração do plugin: é o título do widget. Abra Aparência > Widgets (Appearance > Widgets) (ou o editor de widgets em blocos), abra o widget do HUSKY e altere o campo Título (Title) ou esvazie-o. Um título vazio não exibe nada. Um filtro colocado com o shortcode [woof] não tem esse cabeçalho de forma alguma.

Para ocultar o título de um bloco, defina Mostrar rótulo do título (Show title label) como Não (No) nas opções adicionais dele. Isso é comum em listas suspensas, em que a primeira opção já diz o que a lista é. O filtro de preço tem seu próprio campo: abra as opções adicionais de Pesquisar por preço (Search by Price) e preencha Texto do título (Title text); quando está vazio, o bloco de preço fica sem título. Para um filtro de preço em lista suspensa, Texto do filtro de preço em lista suspensa (Drop-down price filter text) no mesmo popup define a primeira opção.

Uma taxonomia tem um único título para a loja inteira. Se uma categoria precisa de um título diferente, por exemplo "Shoe size" na categoria Shoes, o FAQ do rótulo por categoria trata do assunto; o código mais simples é uma condição 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);

Isso funciona quando a página recarrega após cada mudança do filtro. No modo AJAX, o formulário do filtro é reconstruído por uma requisição em segundo plano em que is_product_category() é falso, então o título volta ao padrão após a primeira seleção.

Alterar o texto do placeholder da lista suspensa

A primeira opção de uma lista suspensa de taxonomia, a que significa "nada selecionado", exibe o mesmo texto do título do bloco. Um rótulo personalizado, portanto, altera os dois. Se você quer que sejam diferentes, por exemplo o título Cor (Color) e a primeira opção Qualquer cor (Any colour), use uma cópia do template da lista suspensa. O plugin o carrega pelo hook woof_html_types_view_select, de modo que a cópia pode ficar no seu tema filho e sobrevive às atualizações do plugin.

  1. Copie wp-content/plugins/woocommerce-products-filter/views/html_types/select.php para wp-content/themes/your-child-theme/husky/select.php.
  2. Diga ao plugin para usar a cópia:
    /*
     * 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. Na cópia, encontre a linha <option value="0"> e substitua-a pelo seu próprio texto. $tax_slug está disponível ali, então um único template pode servir a todas as listas suspensas:
    <option value="0"><?php echo esc_html( 'pa_color' === $tax_slug ? 'Any colour' : 'All' ); ?></option>

Os blocos de seleção múltipla mostram o título como placeholder; o template deles é views/html_types/mselect.php, carregado pelo woof_html_types_view_mselect da mesma maneira. Após uma atualização do plugin, compare a sua cópia com o novo original e transfira as alterações.

Alterar Clear All, Reset, Filter e outros textos integrados

Os textos do próprio plugin se dividem em três grupos.

Opções. Na aba Opções (Options), Texto do botão Filtrar (Filter button text) e Texto do botão Redefinir (Reset button text) definem os dois botões do formulário; escrever none em Texto do botão Redefinir (Reset button text) oculta esse botão. Na versão gratuita, os dois campos são ignorados e as palavras padrão são exibidas; altere-as com o trecho de tradução abaixo. Na aba Design você encontra Texto para bloco mais/menos aberto (Text for block more/less opened) e Texto para bloco mais/menos fechado (Text for block more/less closed) (por padrão Mostrar mais (Show more) e Mostrar menos (Show less), usados quando um bloco tem Quantidade de termos não alternados (Not toggled terms count) definida), além de Texto do botão de filtro para dispositivos móveis (Text for mobile filter button) e Texto para fechar o filtro móvel (Text to close mobile filter).

Hooks. Limpar tudo (Clear All) no painel de filtros ativos tem seu próprio hook woof_clear_all_text, e as extensões de caixa de seleção têm os hooks 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';
});

O texto de Limpar tudo (Clear All) é gravado em uma string JavaScript entre aspas duplas, portanto não use aspas duplas nele.

Tradução. Todo o resto, como os rótulos ordenar por (orderby), por página (per page) e faixa de preço (price range) do painel de filtros ativos e os valores de ordenação como popularidade (popularity), é uma string traduzível do domínio de texto woocommerce-products-filter. Em uma loja de um só idioma, a ferramenta mais simples é um filtro gettext com uma lista de strings exatas:

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

As strings precisam corresponder exatamente, inclusive maiúsculas e minúsculas: o texto padrão do botão é Clear All, não "Clear all". A condição is_admin() mantém as páginas de configurações do plugin com o texto original, sem deixar de cobrir as requisições AJAX que redesenham o filtro. Uma string substituída muda em todos os lugares em que o plugin a exibe: Filter também é o botão do controle deslizante de preço no estilo WooCommerce e o texto padrão da aba deslizante. O Loco Translate faz o mesmo sem código. Traduzir o filtro para vários idiomas é outra tarefa, tratada em traduzir os rótulos do filtro com WPML, Polylang ou Loco Translate.

Renomear um termo apenas dentro do filtro

Às vezes uma categoria ou um valor de atributo deve aparecer de forma diferente no filtro e na página do produto, por exemplo um nome de categoria longo que quebra o layout da barra lateral. Toda lista de termos passa por woof_sort_terms_before_out antes de ser exibida, para caixas de seleção, botões de opção, listas suspensas, rótulos, cores e imagens igualmente:

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

Encontre o ID de um termo passando o mouse sobre o termo em Produtos > Categorias (Products > Categories) ou na tela Configurar termos (Configure terms) do atributo: é o tag_ID no link. O hook também é executado para termos filhos, então as subcategorias podem ser renomeadas da mesma forma. A lista já está ordenada quando a prioridade 99 é executada, de modo que um termo renomeado mantém a posição do nome original. Sempre retorne o array completo: retornar apenas os termos alterados remove todos os outros do filtro.

Se o novo nome não aparecer

  • Não foi salvo. Aplicar (Apply) no popup de opções adicionais apenas preenche o formulário; o rótulo é armazenado quando você clica em Salvar alterações (Save changes) na página de configurações.
  • Cache de termos. Se Cache de termos (Cache terms) está ativado em Avançado > Opções (Advanced > Options), o filtro mantém os nomes de termos que guardou em cache. Um termo renomeado no WooCommerce mostra o nome antigo até você clicar em limpar cache de termos (clear terms cache) ou o período de limpeza automática se esgotar.
  • Cache de páginas. As páginas em cache mantêm o HTML antigo. Limpe o cache do seu plugin de cache, servidor ou CDN e teste em uma janela privada.
  • O trecho não está sendo executado. Verifique se o código está no functions.php do tema (filho) ativo ou em um snippet ativo, e se o nome do filtro, o número de argumentos e as strings estão exatamente como acima.

Se um texto do seu filtro não é tratado aqui, pergunte no fórum de suporte do HUSKY e inclua o texto exato e onde ele aparece.