Personalizar o WooCommerce com hooks sem mexer no núcleo nem no tema pai

Prompt

Atua como programador sénior de WordPress e WooCommerce que segue os padrões de código do WordPress.

Contexto:
- Personalização de que preciso: {{personalizacao}}
- Onde deve aparecer ou atuar: {{zona}}
- Versões do WordPress e do WooCommerce: {{versoes}}
- Tema e construtor que uso: {{tema}}

Entregáveis:
1. Abordagem: que hooks (actions ou filters) do WooCommerce ou do WordPress vais usar e porquê; se houver uma opção nativa ou uma definição que o resolva sem código, diz-mo primeiro.
2. Aviso de compatibilidade: se {{zona}} usar o carrinho ou o checkout em blocos, explica que hooks clássicos não funcionam aí e a alternativa (API de extensibilidade de blocos ou Store API).
3. Código completo como plugin pequeno (cabeçalho do plugin, prefixo único nas funções, verificação de ABSPATH e de que o WooCommerce está ativo), não no functions.php do tema pai.
4. Segurança: sanitizar entradas, escapar saídas (esc_html, esc_attr, wp_kses_post), nonces nos formulários e verificação de capacidades na administração.
5. Dados de encomenda compatíveis com HPOS: usar os métodos de WC_Order (get_meta, update_meta_data, save) em vez de aceder diretamente aos postmeta, e declarar a compatibilidade.
6. Textos traduzíveis com __() e o text domain do plugin.
7. Plano de testes num ambiente de staging: casos normais, produtos variáveis, cupões, compra como convidado e desativação do plugin.

Restrições:
- Não alteres ficheiros do núcleo do WordPress nem do WooCommerce.
- Se não tiveres a certeza de que um hook existe na minha versão, marca como [VERIFICAR na documentação do WooCommerce].
- Faz uma cópia de segurança antes de instalar código em produção.
- Se a personalização for ambígua, pergunta-me antes de escrever o código.

Formato: secções numeradas, o plugin num bloco de código PHP e os passos de instalação.

Como utilizar

Exemplo de utilização

Exemplo de resultado

<?php
/**
 * Plugin Name: Aviso de portes grátis
 * Description: Mostra no carrinho clássico quanto falta para os portes grátis.
 * Version:     1.0.0
 * Requires Plugins: woocommerce
 * Text Domain: aviso-portes-gratis
 */

defined( 'ABSPATH' ) || exit;

const APG_LIMIAR = 50.0; // [COMPLETAR] igual ao valor mínimo do método «Envio gratuito»

add_action( 'before_woocommerce_init', function () {
	if ( class_exists( \Automattic\WooCommerce\Utilities\FeaturesUtil::class ) ) {
		\Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility( 'custom_order_tables', __FILE__, true );
	}
} );

add_action( 'woocommerce_before_cart', 'apg_mostrar_aviso' );

function apg_mostrar_aviso(): void {
	if ( ! function_exists( 'WC' ) || ! WC()->cart ) {
		return;
	}
	$falta = APG_LIMIAR - (float) WC()->cart->get_displayed_subtotal();

	if ( $falta > 0 ) {
		wc_print_notice(
			sprintf(
				/* translators: %s: valor em falta para os portes grátis */
				esc_html__( 'Faltam %s para teres portes grátis.', 'aviso-portes-gratis' ),
				wp_kses_post( wc_price( $falta ) )
			),
			'notice'
		);
	}
}

Dados-chave

Categoria

Programação e desenvolvimento · WordPress

Tipo de resultado

Código

Nível

Intermédio

Pensado para

ChatGPT, Claude, Gemini e Microsoft Copilot

Verificado em

Pendente de verificação editorial

Variáveis

Personalização, Zona, Versões e Tema e construtor

Idioma

Português

Preço

Gratuito, sem registo

Atualizado

07/11/2026

Perguntas frequentes