Como alterar textos comuns do WooCommerce com código

O WooCommerce está repleto de filtros, ganchos e funções para ajudá-lo a personalizar e utilizar o plug-in em seu tema ou plug-in. Aqui estão alguns exemplos de código pequenos, mas úteis, a-ha’s e instruções de mudanças comuns de diferentes saídas de texto.

Alterando os textos do botão "Adicionar ao carrinho"

Existem dois filtros; um para textos “adicionar ao carrinho" em loop (woocommerce_product_add_to_cart_text), e outro para o botão em produto único (woocommerce_product_single_add_to_cart_text):

// Single product view
add_filter('woocommerce_product_single_add_to_cart_text', function($text) {
    return __('Buy this now', 'txtdomain');
});
 
// Loop
add_filter('woocommerce_product_add_to_cart_text', function($text) {
    return __('Buy this', 'txtdomain');
});

No entanto, lembre-se de que isso substitui todos os textos "Adicionar ao carrinho". Mesmo aqueles que originalmente eram “Selecionar opções” (produtos variáveis) ou “Leia mais” (produtos não compráveis ​​– sem preço ou sem estoque). Se desejar mais ajuste fino, inclua o segundo argumento nesses filtros; o objeto do produto. Use o objeto do produto para controlar condicionalmente a saída. Por exemplo, por tipo de produto ou se o produto pode ou não ser comprado:

Altere a saída da faixa de preço em produtos variáveis ​​e agrupados

Como padrão, o WooCommerce exibirá o menor e o maior preço em produtos variáveis ​​e agrupados, com um “-” no meio. Você pode facilmente modificar essa saída de intervalo. Por exemplo, certifique-se de que ele mostre apenas o preço mais baixo, na forma de “De: “. O WooCommerce tem um filtro para produtos variáveis ​​e outro para produtos agrupados, então vamos dar uma olhada em ambos.

O controle da saída HTML da faixa de preço para produtos variáveis ​​é feito com o filtro woocommerce_variable_price_html. O objeto do produto é fornecido como segundo argumento.

Dentro da função precisamos buscar todos os preços. O WooCommerce oferece uma função útil em objetos de produtos variáveis, get_variation_prices(). Isso retorna uma matriz de todos os preços de variantes, classificados primeiro pelo menor. Tudo o que precisamos fazer se destacar o primeiro elemento na matriz de preços e produzi-lo bem:

O filtro de saída HTML da faixa de preço para produtos agrupados é muito semelhante aos produtos variáveis, mas com uma diferença; uma matriz de preços de todos os produtos agrupados “crianças” é incluída como argumento para o filtro. O filtro a ser usado é woocommerce_grouped_price_html:

Modificar saída de texto de status de estoque

Se você ativou a exibição do status do estoque nas configurações do WooCommerce, ele deve exibir a quantidade exata de estoque restante na visualização de um único produto (por exemplo, "42 em estoque"). No entanto, você pode modificar a saída para mostrar um intervalo em vez da quantidade exata. Ou apenas "Em estoque" se você quiser ocultar o número.

O filtro para fazer isso é woocommerce_get_stock_htmle, se você incluir o segundo argumento, obterá o objeto do produto. Com o objeto produto, você pode fazer as operações necessárias para ajustar a saída. Tenha em mente que a saída filtrável é encapsulada dentro de um <p>elemento, e sua saída também.

Para simplesmente mostrar “Em estoque” ou “Não em estoque”, isso será suficiente:

Mostrar estoque em “valores de intervalo” pode ser feito assim:

Renomear status do pedido

Às vezes, um cliente deseja que rótulos diferentes nos status do pedido façam mais sentido de acordo com as práticas de sua loja virtual. Por exemplo, você pode querer que “Em espera” seja renomeado para “Não enviado” ou “Concluído” para ser renomeado como “Enviado”. Só para fazer mais sentido quais pedidos precisam ser enviados e quais já foram enviados. O WooCommerce oferece um filtro simples, wc_order_statuses, em todos os nomes de status de pedidos disponíveis.

add_filter('wc_order_statuses', function($order_statuses) {
    $order_statuses['wc-on-hold'] = __('Unsent', 'txtdomain');
    $order_statuses['wc-completed'] = __('Sent', 'txtdomain');
    return $order_statuses;
});

As chaves disponíveis são wc-pending, wc-processing, wc-on-hold, wc-completed, wc-cancelled, wc-refundede wc-failed.