BIBLIOTECA DE SNIPPETS

Personalizar o texto “Adicionar ao carrinho” em produtos simples

Define um texto próprio para o botão de produtos simples, preservando as ações específicas de produtos variáveis e externos.

Antes de começares

Dificuldade: Iniciante
Requisitos: WooCommerce com botões que usem os filtros clássicos de adicionar ao carrinho.
Local de aplicação: Snippet PHP com execução no frontend ou em todo o site. Cola sem a abertura <?php.

Como aplicar

Cria um snippet PHP e cola o código.
Troca Adicionar ao cesto pelo texto pretendido. Escolhe uma expressão que descreva a ação real do botão.
Ativa o snippet e abre um produto simples disponível para compra.
Verifica também o botão desse produto na listagem da loja.

Como confirmar o resultado

Adiciona um produto simples ao carrinho e confirma que o botão continua funcional.
Verifica que um produto variável conserva a ação de escolher opções e que um produto externo mantém o seu texto.
Confirma que o texto de um produto esgotado não foi alterado.

Compatibilidade e limites

Altera apenas o texto, sem redirecionar para o checkout. Aplica-se a produtos simples compráveis e em stock. Blocos e widgets com rótulos próprios podem ignorar estes filtros. Em sites multilingues, adapta a tradução antes de publicar.

Como desfazer

Desativa ou remove apenas este snippet e limpa a cache relevante. No caso do CSS, remove as regras adicionadas.

Referências técnicas

WooCommerce — documentação oficial

Código do snippet

Faz uma cópia de segurança e testa num ambiente de desenvolvimento antes de aplicar no site principal. Consulta o local de aplicação indicado neste guia.

$ed_cart_button_text = static function ($text, $product) {
    if (!$product instanceof WC_Product
        || !$product->is_type('simple')
        || !$product->is_purchasable()
        || !$product->is_in_stock()) {
        return $text;
    }
    return 'Adicionar ao cesto';
};
add_filter('woocommerce_product_single_add_to_cart_text', $ed_cart_button_text, 10, 2);
add_filter('woocommerce_product_add_to_cart_text', $ed_cart_button_text, 10, 2);