Personalizzare WooCommerce con gli hook senza toccare il core né il tema padre

Prompt

Agisci come sviluppatore senior WordPress e WooCommerce che segue gli standard di codifica di WordPress.

Contesto:
- Personalizzazione che mi serve: {{personalizzazione}}
- Dove deve comparire o agire: {{area}}
- Versioni di WordPress e WooCommerce: {{versioni}}
- Tema e page builder che uso: {{tema}}

Consegne:
1. Approccio: quali hook (action o filter) di WooCommerce o WordPress userai e perché; se un'opzione nativa o un'impostazione lo risolve senza codice, dimmelo prima.
2. Avviso di compatibilità: se {{area}} usa il carrello o il checkout a blocchi, spiega quali hook classici lì non funzionano e l'alternativa (API di estensibilità dei blocchi o Store API).
3. Codice completo come piccolo plugin (intestazione del plugin, prefisso unico per le funzioni, controllo di ABSPATH e che WooCommerce sia attivo), non nel functions.php del tema padre.
4. Sicurezza: sanificare gli input, fare escape degli output (esc_html, esc_attr, wp_kses_post), nonce nei moduli e controllo delle capability nell'amministrazione.
5. Dati dell'ordine compatibili con HPOS: usare i metodi di WC_Order (get_meta, update_meta_data, save) invece di accedere direttamente ai postmeta, e dichiarare la compatibilità.
6. Testi traducibili con __() e il text domain del plugin.
7. Piano di test in un ambiente di staging: casi normali, prodotti variabili, coupon, ordine come ospite e disattivazione del plugin.

Vincoli:
- Non modificare file del core di WordPress o WooCommerce.
- Se non sei sicuro che un hook esista nella mia versione, segnalalo con [DA VERIFICARE nella documentazione di WooCommerce].
- Fai un backup del sito prima di installare codice in produzione.
- Se la personalizzazione è ambigua, chiedimelo prima di scrivere il codice.

Formato: sezioni numerate, il plugin in un blocco di codice PHP e i passaggi di installazione.

Come usarlo

Esempio d'uso

Esempio di risultato

<?php
/**
 * Plugin Name: Avviso spedizione gratuita
 * Description: Mostra nel carrello classico quanto manca alla spedizione gratuita.
 * Version:     1.0.0
 * Requires Plugins: woocommerce
 * Text Domain: avviso-spedizione-gratuita
 */

defined( 'ABSPATH' ) || exit;

const ASG_SOGLIA = 50.0; // [DA COMPLETARE] uguale all'importo minimo del metodo «Spedizione gratuita»

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', 'asg_mostra_avviso' );

function asg_mostra_avviso(): void {
	if ( ! function_exists( 'WC' ) || ! WC()->cart ) {
		return;
	}
	$mancano = ASG_SOGLIA - (float) WC()->cart->get_displayed_subtotal();

	if ( $mancano > 0 ) {
		wc_print_notice(
			sprintf(
				/* translators: %s: importo mancante alla spedizione gratuita */
				esc_html__( 'Aggiungi ancora %s e la spedizione è gratis.', 'avviso-spedizione-gratuita' ),
				wp_kses_post( wc_price( $mancano ) )
			),
			'notice'
		);
	}
}

Dati chiave

Categoria

Programmazione e sviluppo · WordPress

Tipo di output

Codice

Livello

Intermedio

Pensato per

ChatGPT, Claude, Gemini e Microsoft Copilot

Verificato in

In attesa di verifica editoriale

Variabili

Personalizzazione, Area, Versioni e Tema e builder

Lingua

Italiano

Prezzo

Gratuito, senza registrazione

Aggiornato

07/11/2026

Domande frequenti