In questa guida approfondita vedremo cosa sono gli hooks, la differenza tra action<\/strong> e filter<\/strong>, quali sono i pi\u00f9 utili in WooCommerce e come utilizzarli con esempi pratici pronti da copiare nel proprio progetto. Che tu sia uno sviluppatore alle prime armi o un professionista che desidera un ripasso completo, troverai indicazioni concrete per portare il tuo e-commerce al livello successivo.<\/p>\n Un hook<\/strong> \u00e8 un punto predefinito nel codice di WordPress (e di WooCommerce) in cui \u00e8 possibile agganciare le proprie funzioni personalizzate. Quando il sistema raggiunge quel punto durante il caricamento della pagina, esegue automaticamente tutte le funzioni registrate su quel particolare hook.<\/p>\n Esistono due tipologie fondamentali:<\/p>\n Modificare direttamente i file di WooCommerce (o di qualsiasi plugin) \u00e8 una pratica fortemente sconsigliata per diverse ragioni:<\/p>\n Gli hooks risolvono tutti questi problemi: il codice personalizzato vive in un file separato, resta attivo anche dopo gli aggiornamenti e pu\u00f2 essere attivato o disattivato in modo indipendente.<\/p>\n WooCommerce mette a disposizione centinaia di action hooks. Di seguito analizziamo quelli che ogni sviluppatore dovrebbe conoscere, con esempi pratici per ciascuno.<\/p>\n Questo hook si attiva subito prima del contenuto principale delle pagine di archivio (negozio, categorie, tag). \u00c8 ideale per inserire banner promozionali, messaggi informativi o breadcrumb personalizzati che devono apparire in cima alla pagina del catalogo.<\/p>\n Esempio di utilizzo:<\/p>\n Si attiva dopo ogni prodotto nel loop del catalogo, subito dopo il pulsante \u00abAggiungi al carrello\u00bb. Questo hook \u00e8 perfetto per aggiungere badge, etichette personalizzate o informazioni aggiuntive sotto ciascun prodotto nella griglia.<\/p>\n Un utilizzo frequente consiste nel mostrare la disponibilit\u00e0 residua quando le scorte sono basse, creando un senso di urgenza che incentiva il completamento degli acquisti.<\/p>\n Questo hook \u00e8 legato alla pagina del singolo prodotto e si attiva nella sezione del riepilogo (titolo, prezzo, descrizione breve, pulsante di acquisto). Accetta una priorit\u00e0<\/strong> che determina la posizione esatta: con priorit\u00e0 5 il contenuto appare prima del titolo, con priorit\u00e0 25 dopo il prezzo, con 35 dopo la descrizione breve.<\/p>\n Gestire le priorit\u00e0 \u00e8 fondamentale per posizionare correttamente gli elementi nella pagina prodotto senza dover intervenire sui template.<\/p>\n Si attiva prima della tabella del carrello. \u00c8 il punto ideale per inserire messaggi che motivino il cliente ad aggiungere altri articoli, come ad esempio \u00abAggiungi ancora 15 \u20ac al carrello per ottenere la spedizione gratuita\u00bb \u2014 una tecnica di upselling molto efficace.<\/p>\n Questo hook si attiva nella pagina di checkout, prima dei campi per i dati del cliente. Viene comunemente utilizzato per mostrare garanzie di sicurezza, badge di pagamento sicuro, informazioni sulla politica di reso o qualsiasi elemento che riduca le esitazioni del cliente nel momento critico della conversione.<\/p>\n Si attiva nella pagina di conferma ordine, dopo che il pagamento \u00e8 stato elaborato con successo. Riceve come parametro il numero di ordine, il che consente di personalizzare il messaggio in base al tipo di prodotto acquistato, al metodo di pagamento scelto o al valore totale.<\/p>\n Molti negozi utilizzano questo hook per inserire il codice di conversione di Google Ads, script di tracciamento per Facebook Pixel o per mostrare coupon di sconto validi per il prossimo acquisto.<\/p>\n I filtri sono ancora pi\u00f9 potenti delle azioni perch\u00e9 permettono di trasformare i dati prima che raggiungano il browser del visitatore. Ecco i cinque filtri indispensabili.<\/p>\n Questo filtro controlla le schede (tab) visualizzate nella pagina del singolo prodotto. Di default WooCommerce mostra \u00abDescrizione\u00bb, \u00abInformazioni aggiuntive\u00bb e \u00abRecensioni\u00bb. Con questo filtro \u00e8 possibile rimuovere schede, riordinarle o aggiungerne di completamente nuove.<\/p>\n Esempio pratico \u2014 aggiungere una scheda \u00abGuida alle taglie\u00bb:<\/p>\n Controlla tutti i campi del modulo di checkout. Permette di aggiungere campi personalizzati (codice fiscale, partita IVA, note di consegna), rimuovere quelli non necessari, modificare le etichette o cambiare la posizione dei campi esistenti.<\/p>\n Per un e-commerce italiano, ad esempio, \u00e8 spesso necessario aggiungere il campo \u00abCodice Fiscale\u00bb o \u00abPEC\u00bb per la fatturazione elettronica. Il filtro Intercetta le tariffe di spedizione calcolate e permette di modificarle, rimuoverle o aggiungerne di nuove in modo condizionale. Questo filtro \u00e8 estremamente utile per implementare logiche di spedizione avanzate.<\/p>\n Un caso comune: nascondere la spedizione a pagamento quando il carrello supera una certa soglia, lasciando visibile solo la spedizione gratuita. Oppure applicare un supplemento per le isole o per determinate zone postali.<\/p>\n Modifica il codice HTML del prezzo visualizzato nella pagina prodotto e nel catalogo. Permette di aggiungere testo prima o dopo il prezzo, formattarlo in modo diverso o sostituirlo completamente con un messaggio personalizzato.<\/p>\n Esempio \u2014 aggiungere la dicitura \u00abIVA inclusa\u00bb sotto ogni prezzo:<\/p>\n Filtra il nome del prodotto visualizzato nel carrello. Si utilizza per aggiungere informazioni extra accanto al nome, come badge \u00abIn saldo\u00bb, icone di disponibilit\u00e0 o messaggi relativi ai tempi di consegna stimati per quello specifico articolo.<\/p>\n Sapere quali hooks utilizzare \u00e8 solo met\u00e0 della questione. \u00c8 altrettanto importante scegliere il posto giusto<\/strong> dove scrivere il codice. Esistono tre opzioni principali, ciascuna con vantaggi e svantaggi specifici.<\/p>\n Il metodo classico prevede di inserire il codice nel file Creare un piccolo plugin dedicato \u00e8 la soluzione pi\u00f9 professionale. Basta creare un file PHP nella cartella Questa soluzione \u00e8 particolarmente indicata quando le modifiche riguardano la logica di business (calcolo prezzi, regole di spedizione, integrazioni con sistemi esterni) piuttosto che la presentazione visiva.<\/p>\n Per chi preferisce evitare la gestione diretta dei file via FTP o SSH, il plugin Code Snippets<\/strong> offre un comodo editor integrato nella bacheca di WordPress. Ogni frammento di codice pu\u00f2 essere attivato, disattivato, organizzato con tag e persino esportato.<\/p>\n Passiamo ora a scenari reali che combinano pi\u00f9 hooks per ottenere risultati concreti.<\/p>\n Un negozio di elettronica vuole aggiungere la scheda \u00abSpecifiche Tecniche\u00bb a tutti i prodotti di una determinata categoria. Si combinano il filtro Un negozio B2B desidera mostrare il prezzo unitario e quello per quantit\u00e0. Si utilizza il filtro Per la fatturazione elettronica italiana \u00e8 indispensabile raccogliere il Codice SDI<\/strong> o la PEC<\/strong> del cliente. Con il filtro Se il carrello supera i 50 \u20ac, si desidera nascondere la spedizione standard a pagamento e lasciare solo quella gratuita. Il filtro Quando un hook non produce il risultato atteso, \u00e8 fondamentale disporre di strumenti adeguati per individuare il problema.<\/p>\n Il plugin Query Monitor<\/strong> \u00e8 lo strumento di debug pi\u00f9 completo per WordPress. Mostra tutti gli hooks eseguiti durante il caricamento della pagina, le funzioni agganciate a ciascun hook, la priorit\u00e0 e il file di origine. Inoltre evidenzia le query SQL lente e gli errori PHP.<\/p>\n WooCommerce include una sezione Stato del sistema<\/strong> (WooCommerce \u2192 Stato) che fornisce informazioni preziose per il debug: versione PHP, limiti di memoria, log degli errori, template sovrascritti e molto altro. \u00c8 il primo posto da controllare quando qualcosa non funziona come previsto.<\/p>\n Per verificare che un hook venga effettivamente eseguito, si pu\u00f2 scrivere un messaggio nel log di WooCommerce utilizzando la classe Dopo anni di sviluppo su WooCommerce, ecco le pratiche che garantiscono un codice robusto e facile da mantenere nel tempo:<\/p>\n Gli hooks di WooCommerce offrono possibilit\u00e0 quasi illimitate, ma personalizzazioni complesse richiedono una conoscenza approfondita di PHP, delle API di WordPress e delle logiche interne di WooCommerce. Errori nel codice possono compromettere il funzionamento del checkout, i calcoli fiscali o le integrazioni con i gateway di pagamento.<\/p>\n Se il tuo progetto richiede personalizzazioni avanzate \u2014 integrazioni con gestionali, logiche di prezzo dinamiche, funzionalit\u00e0 su misura per il tuo settore \u2014 affidarsi a sviluppatori esperti \u00e8 la scelta pi\u00f9 sicura. Il team di G Tech Group<\/a> vanta anni di esperienza nella realizzazione di e-commerce WooCommerce personalizzati, dalla configurazione iniziale fino alle integrazioni pi\u00f9 complesse.<\/p>\n Per una consulenza personalizzata o per richiedere un preventivo, visita la pagina contatti di G Tech Group<\/a>.<\/p>\n Scopri le nostre guide complete sugli altri plugin essenziali per WordPress:<\/p>\n WooCommerce Hooks e Filtri: Personalizzare il Negozio Senza Modificare il Core Uno dei punti di forza di WooCommerce risiede nella sua estrema flessibilit\u00e0. Grazie al…<\/p>","protected":false},"author":2,"featured_media":168155,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_seopress_titles_title":"WooCommerce Hooks e Filtri: Personalizzazione | Guida Dev","_seopress_titles_desc":"Come usare hooks e filtri WooCommerce per personalizzare il negozio senza toccare il core. Action, filter, esempi pratici e best practice.","_seopress_robots_index":"","_seopress_robots_follow":"","_seopress_robots_imageindex":"","_seopress_robots_snippet":"","_seopress_robots_primary_cat":"","_seopress_robots_breadcrumbs":"","_seopress_robots_freeze_modified_date":"","_seopress_robots_custom_modified_date":"","_seopress_robots_canonical":"","_seopress_social_fb_title":"","_seopress_social_fb_desc":"","_seopress_social_fb_img":"","_seopress_social_fb_img_attachment_id":0,"_seopress_social_fb_img_width":0,"_seopress_social_fb_img_height":0,"_seopress_social_twitter_title":"","_seopress_social_twitter_desc":"","_seopress_social_twitter_img":"","_seopress_social_twitter_img_attachment_id":0,"_seopress_social_twitter_img_width":0,"_seopress_social_twitter_img_height":0,"_seopress_redirections_value":"","_seopress_redirections_enabled":"","_seopress_redirections_enabled_regex":"","_seopress_redirections_logged_status":"","_seopress_redirections_param":"","_seopress_redirections_type":0,"_seopress_analysis_target_kw":"WooCommerce Hooks Filtri: Personalizzare","_seopress_news_disabled":"","_seopress_video_disabled":"","_seopress_video":[],"_seopress_pro_schemas_manual":[],"_seopress_pro_rich_snippets_disable_all":"","_seopress_pro_rich_snippets_disable":[],"_seopress_pro_schemas":[],"footnotes":""},"categories":[61],"tags":[3136,3135,471,2920,3084,475,492],"class_list":["post-166847","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-wordpress","tag-filtri","tag-hooks","tag-personalizzazione","tag-php","tag-sviluppo","tag-woocommerce","tag-wordpress"],"_links":{"self":[{"href":"https:\/\/gtechgroup.it\/blog\/de\/wp-json\/wp\/v2\/posts\/166847","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/gtechgroup.it\/blog\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/gtechgroup.it\/blog\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/gtechgroup.it\/blog\/de\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/gtechgroup.it\/blog\/de\/wp-json\/wp\/v2\/comments?post=166847"}],"version-history":[{"count":1,"href":"https:\/\/gtechgroup.it\/blog\/de\/wp-json\/wp\/v2\/posts\/166847\/revisions"}],"predecessor-version":[{"id":170059,"href":"https:\/\/gtechgroup.it\/blog\/de\/wp-json\/wp\/v2\/posts\/166847\/revisions\/170059"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/gtechgroup.it\/blog\/de\/wp-json\/wp\/v2\/media\/168155"}],"wp:attachment":[{"href":"https:\/\/gtechgroup.it\/blog\/de\/wp-json\/wp\/v2\/media?parent=166847"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/gtechgroup.it\/blog\/de\/wp-json\/wp\/v2\/categories?post=166847"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/gtechgroup.it\/blog\/de\/wp-json\/wp\/v2\/tags?post=166847"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}![\"Schermata](\"https:\/\/gtechgroup.it\/blog\/wp-content\/uploads\/2026\/05\/wc-13-product-edit.png\")
<\/p>\nCosa Sono gli Hooks di WordPress<\/h2>\n
\n
Perch\u00e9 usare gli hooks invece di modificare i file del plugin<\/h3>\n
\n
Gli Action Hooks Pi\u00f9 Utili di WooCommerce<\/h2>\n
woocommerce_before_main_content<\/h3>\n
add_action( woocommerce_before_main_content, gtg_banner_spedizione_gratuita );
\nfunction gtg_banner_spedizione_gratuita() {
\n echo <div class=\"promo-banner\">Spedizione gratuita per ordini superiori a 50 \u20ac<\/div>;
\n}<\/code><\/p>\nwoocommerce_after_shop_loop_item<\/h3>\n
woocommerce_single_product_summary<\/h3>\n
woocommerce_before_cart<\/h3>\n
woocommerce_checkout_before_customer_details<\/h3>\n
woocommerce_thankyou<\/h3>\n
I Filter Hooks Pi\u00f9 Utili di WooCommerce<\/h2>\n
woocommerce_product_tabs<\/h3>\n
add_filter( woocommerce_product_tabs, gtg_tab_guida_taglie );
\nfunction gtg_tab_guida_taglie( $tabs ) {
\n $tabs[guida_taglie] = array(
\n title => Guida alle Taglie,
\n priority => 50,
\n callback => gtg_contenuto_guida_taglie,
\n );
\n return $tabs;
\n}
\nfunction gtg_contenuto_guida_taglie() {
\n echo <h2>Guida alle Taglie<\/h2>;
\n echo <p>Consulta la tabella seguente per individuare la taglia corretta.<\/p>;
\n}<\/code><\/p>\nwoocommerce_checkout_fields<\/h3>\n
woocommerce_checkout_fields<\/code> rende questa operazione semplice e pulita.<\/p>\nwoocommerce_package_rates<\/h3>\n
woocommerce_get_price_html<\/h3>\n
add_filter( woocommerce_get_price_html, gtg_prezzo_iva_inclusa, 10, 2 );
\nfunction gtg_prezzo_iva_inclusa( $price, $product ) {
\n return $price . <small class=\"iva-info\"> IVA inclusa<\/small>;
\n}<\/code><\/p>\nwoocommerce_cart_item_name<\/h3>\n
Dove Inserire il Codice Personalizzato<\/h2>\n
File functions.php del tema figlio (child theme)<\/h3>\n
functions.php<\/code> di un tema figlio<\/strong>. Mai nel tema principale, perch\u00e9 le modifiche verrebbero perse con il prossimo aggiornamento del tema.<\/p>\n\n
Plugin personalizzato dedicato<\/h3>\n
wp-content\/plugins\/<\/code> con un header standard di WordPress. In questo modo le personalizzazioni restano attive indipendentemente dal tema utilizzato.<\/p>\nPlugin Code Snippets<\/h3>\n
\n
![\"Pagina](\"https:\/\/gtechgroup.it\/blog\/wp-content\/uploads\/2026\/05\/wc-status.png\")
<\/p>\nEsempi Pratici Completi<\/h2>\n
Esempio 1: Aggiungere una scheda personalizzata al prodotto<\/h3>\n
woocommerce_product_tabs<\/code> con una condizione sulla categoria del prodotto corrente. La funzione di callback recupera un campo personalizzato (custom field) e lo visualizza in una tabella ordinata.<\/p>\nEsempio 2: Modificare la visualizzazione del prezzo<\/h3>\n
woocommerce_get_price_html<\/code> verificando se il cliente appartiene al ruolo \u00abwholesale\u00bb. In caso affermativo, il prezzo viene ricalcolato applicando lo sconto per quantit\u00e0 e visualizzato con una formattazione dedicata.<\/p>\nEsempio 3: Aggiungere un campo al checkout<\/h3>\n
woocommerce_checkout_fields<\/code> si aggiunge il campo, con la action woocommerce_checkout_update_order_meta<\/code> si salva il valore nei metadati del relativo ordine, e con woocommerce_admin_order_data_after_billing_address<\/code> lo si visualizza nel pannello amministrativo.<\/p>\nadd_filter( woocommerce_checkout_fields, gtg_campo_codice_sdi );
\nfunction gtg_campo_codice_sdi( $fields ) {
\n $fields[billing][billing_codice_sdi] = array(
\n type => text,
\n label => Codice SDI,
\n placeholder => Inserisci il codice destinatario,
\n required => false,
\n class => array( form-row-wide ),
\n priority => 120,
\n );
\n return $fields;
\n}<\/code><\/p>\nEsempio 4: Nascondere metodi di spedizione in modo condizionale<\/h3>\n
woocommerce_package_rates<\/code> riceve tutte le tariffe calcolate: basta verificare la presenza della tariffa gratuita e, se il totale del carrello supera la soglia, rimuovere le altre opzioni.<\/p>\nDebugging degli Hooks: Strumenti e Tecniche<\/h2>\n
Query Monitor<\/h3>\n
La pagina Stato del sistema<\/h3>\n
Log personalizzati<\/h3>\n
WC_Logger<\/code>. I log sono consultabili dalla sezione Stato \u2192 Log nella bacheca.<\/p>\nErrori comuni e soluzioni<\/h3>\n
\n
remove_all_actions<\/code> eseguito da un altro plugin.<\/li>\nreturn<\/code>. Dimenticare il return \u00e8 un errore frequentissimo che pu\u00f2 causare la scomparsa di prezzi, nomi prodotto o intere sezioni della pagina.<\/li>\ndid_action()<\/code> previene il problema.<\/li>\n<\/ul>\nBest Practice per un Codice Sostenibile<\/h2>\n
\n
gtg_<\/code>, mionegozio_<\/code>) per evitare conflitti con altri plugin o temi.<\/li>\nQuando Rivolgersi a Professionisti<\/h2>\n
Migliora il Tuo Sito WordPress<\/h3>\n
\n