{"id":36856,"date":"2020-05-31T03:15:03","date_gmt":"2020-05-31T10:15:03","guid":{"rendered":"https:\/\/kinsta.com\/?p=72202"},"modified":"2023-03-03T12:56:35","modified_gmt":"2023-03-03T11:56:35","slug":"hook-wordpress","status":"publish","type":"post","link":"https:\/\/kinsta.com\/it\/blog\/hook-wordpress\/","title":{"rendered":"Il Bootcamp degli Hook di WordPress: Come Utilizzare Azioni, Filtri e Hook Personalizzati"},"content":{"rendered":"

Gli Hook di WordPress sono uno degli strumenti pi\u00f9 importanti da avere nell’arsenale di uno sviluppatore WordPress<\/a>. Sono il fondamento dello sviluppo dei plugin e dei temi di WordPress. Potete utilizzare i numerosi hook integrati in WordPress per ‘agganciare’ il Core di WordPress al proprio codice personalizzato e fare<\/strong> o modificare<\/strong> qualcosa.<\/p>\n

Ci sono due tipi di hook in WordPress: Azioni<\/strong> e Filtri<\/strong>. Gli hook sono cos\u00ec comuni che anche lo stesso Core di WordPress li utilizza ampiamente. WordPress include anche un modo per definire i propri hook personalizzati<\/strong>, cos\u00ec che altri sviluppatori possano agganciarsi al vostro codice.<\/p>\n

Imparare come funzionano le azioni, i filtri e gli hook personalizzati \u00e8 essenziale per padroneggiare lo sviluppo di WordPress.<\/p>\n

La prima met\u00e0 di questo articolo tratta le basi dei hook di WordPress e spiega come funzionano, offrendo molteplici esempi. Nella seconda met\u00e0, imparerete come utilizzare gli hook per personalizzare WordPress, creare i propri hook personalizzati e utilizzarli per costruire i plugin estendibili.<\/p>\n

Sembra eccitante? Cominciamo!<\/p>\n

<\/div><\/kinsta-auto-toc>\n

Cosa Sono gli Hook di WordPress?<\/h2>\n

Una pagina di WordPress<\/a> \u00e8 composta da tonnellate di funzioni e di richieste al database. Il Core, i plugin e il tema di WordPress lavorano insieme per produrre gli elementi della pagina, come il testo, le immagini<\/a>, gli script e gli stili. Una volta completamente assemblato, il browser li mette tutti insieme e rende la pagina.<\/p>\n

Gli hook di WordPress vi permettono di ‘agganciarvi’ a questo processo di costruzione in alcuni punti ed eseguire codice personalizzato. La funzione principale degli hook \u00e8 quella di permettere di modificare o aggiungere funzionalit\u00e0 a WordPress senza toccare i file del Core<\/a>.<\/p>\n

\"Gli
Gli hook vi aiutano ad estendere WordPress con il vostro codice<\/figcaption><\/figure>\n

La WordPress Plugin API<\/a> offre le funzionalit\u00e0 degli hook di WordPress. Gli hook si utilizzano invocando alcune funzioni di WordPress chiamate Funzioni di Hook<\/strong> in specifiche istanze durante il processo di runtime di WordPress.<\/p>\n

Utilizzando le funzioni di hook, potete raggruppare il codice personalizzato all’interno di una funzione di Callback<\/strong> e registrarlo con qualsiasi hook. Una volta registrata, questa callback verr\u00e0 eseguita ovunque si trovi l’hook, consentendovi di estendere o sostituire le funzioni predefinite di WordPress.<\/p>\n

La posizione dell’hook nel processo di esecuzione del codice \u00e8 un fattore importante. Nelle prossime sezioni vi diremo di pi\u00f9 sul suo significato.<\/p>\n\n

I Due Tipi di Hooks di WordPress: Azioni e Filtri<\/h3>\n

WordPress dispone di due tipi di hook chiamati Azioni<\/strong> e Filtri<\/strong>. Le azioni consentono di fare<\/strong> qualcosa in determinati punti predefiniti del runtime di WordPress, mentre i filtri consentono di modificare<\/strong> i dati elaborati da WordPress e di restituirli con un return<\/code><\/strong>.<\/p>\n

Le azioni dono definite nel codice di WordPress come segue:<\/p>\n

do_action( 'action_name', [optional_arguments] );<\/code><\/pre>\n
La stringa action_name<\/strong><\/code> \u00e8 il nome dell’azione. Potete specificare la variabile [optional_arguments]<\/strong><\/code> per passare altri argomenti alla funzione di callback. Se questo campo non viene specificato, il suo valore predefinito sar\u00e0 vuoto.<\/p>\n
Esempio:<\/strong> L’azione do_action( 'wp_head' )<\/strong><\/code> pu\u00f2 essere agganciata per eseguire codice personalizzato ogni volta che WordPress elabora l’header del sito<\/a>. Questa azione non ha altri argomenti.<\/p>\n
I filtri sono definiti nel codice di WordPress cos\u00ec:<\/p>\n
apply_filters( 'filter_name', 'value_to_be_filtered', [optional_arguments] );<\/code><\/pre>\n
La stringa filter_name<\/strong><\/code> \u00e8 il nome del filtro, la variabile value_to_be_filtered<\/strong><\/code> \u00e8 il valore che deve essere filtrato e restituito, e la variabile [optional_arguments]<\/strong><\/code> pu\u00f2 passare altri argomenti, proprio come avviene con le azioni.<\/p>\n
Esempio:<\/strong> Il filtro apply_filters( 'admin_footer_text' , stringa $text )<\/strong><\/code> pu\u00f2 essere agganciato per modificare il testo visualizzato nel footer dell’area di amministrazione. A partire da WordPress 5.4<\/em>, il suo valore predefinito mostrer\u00e0 la frase Grazie per aver creato con WordPress<\/a>.<\/em><\/code> nel footer dell’area di amministrazione.<\/p>\n
Di seguito, imparerete come agganciarvi alle azioni e ai filtri con molti esempi dal Core di WordPress.<\/p>\n
Una volta agganciati, potete indirizzare il vostro codice da fare<\/strong> o personalizzare<\/strong> qualcosa sul vostro sito. Ad esempio, potete utilizzare gli hook per inviare un’email automatica<\/a> dopo aver pubblicato un post, o caricare fogli di stile personalizzati<\/a> per cambiare l’aspetto del vostro sito.<\/p>\n
\"Gli
Gli hook di WordPress vi aiutano a interagire con il vostro sito web o a modificarlo<\/figcaption><\/figure>\n
Il modo pi\u00f9 semplice per capire gli hook \u00e8 immaginare il vostro sito WordPress<\/a> come una casa in costruzione.<\/p>\n
Utilizzare gli hook \u00e8 come utilizzare una gru per spostare avanti e indietro gli oggetti da costruzione. Gli oggetti che vengono trasferiti sono le Funzioni di Callback<\/strong> che contengono il vostro codice personalizzato<\/a>. Questi elementi (o funzioni) possono aiutarvi a costruire o modificare la casa.<\/p>\n
\"Esempio
Esempio di hook all’azione ‘wp_head’ in WordPress<\/figcaption><\/figure>\n
Le funzioni di callback possono essere normali funzioni PHP, funzioni WordPress predefinite o funzioni personalizzate da voi definite.<\/p>\n
Possiamo trasportare determinati elementi solo su specifici vettori attaccati a particolari hook. Pertanto, le azioni possono essere agganciate solo alle Funzioni di Azione<\/strong>. Allo stesso modo, i filtri possono essere agganciati solo alle Funzioni di Filtro<\/strong>.<\/p>\n
Mentre \u00e8 noioso cambiare i ganci e i trasportatori su una gru, in WordPress \u00e8 super semplice, dato che dispone di oltre 2.200 tipi di hooks predefiniti<\/a>.<\/p>\n
\"WordPress
WordPress 5.1 ha 2200+ hook nativi (Fonte: Adam Brown)<\/figcaption><\/figure>\n
Potete trovare hooks sparsi in tutto il Core di WordPress, e vi permettono di individuare la posizione esatta in cui volete agganciarvi e di eseguire il vostro codice personalizzato.<\/p>\n\n
Hooks, Azioni e Filtri<\/h2>\n
Come da WordPress Plugin Handbook<\/a>:<\/p>\n
“Gli hook sono un modo per un blocco di codice di interagire\/modificare un altro blocco di codice… Ci sono due tipi di hook: Azioni e Filtri. <\/em>\u201d<\/p><\/blockquote>\n
C’\u00e8 una diffusa incoerenza nel modo in cui vengono utilizzati i termini Hook<\/strong>, Azione<\/strong> e Filtro<\/strong>. Alcune guide e tutorial li confondono con le funzioni ad essi associate. Una delle ragioni principali di questa confusione \u00e8 la natura complessa del funzionamento dei hook.<\/p>\n
Anche quando si guarda attentamente all’interno del Core di WordPress, si scopre che non c’\u00e8 molta differenza tra l’aggiunta di azioni e filtri. Ecco il codice sorgente della funzione add_action()<\/a> dal file wp-includes\/plugin.php<\/strong>:<\/p>\n
function add_action( $tag, $function_to_add, $priority = 10, $accepted_args = 1 ) {\n    return add_filter( $tag, $function_to_add, $priority, $accepted_args );\n}<\/code><\/pre>\n
La funzione add_action()<\/strong><\/code> si limita a richiamare la funzione add_filter()<\/strong><\/code> e ne restituisce il valore. Perch\u00e9? Perch\u00e9 entrambi funzionano fondamentalmente allo stesso modo, tranne che per una differenza.<\/p>\n
La funzione apply_filters()<\/strong><\/code> restituisce un valore che pu\u00f2 cambiare i tipi di dati esistenti, mentre la funzione do_action()<\/strong><\/code> non restituisce nulla (valore NULL in PHP<\/a>).<\/p>\n
Se siete ancora confusi, non vi preoccupate! Una volta superata la prima met\u00e0 di questo articolo, tutto sar\u00e0 chiaro. Ci atterremo alla terminologia ufficiale del Codex di WordPress, perch\u00e9 \u00e8 chiara, precisa e universale.<\/p>\n
Per ora, familiarizzate con la routine degli hook illustrata di seguito.<\/p>\n
\"La
La routine degli hook: Hook, funzioni di hooks e funzioni di callback<\/figcaption><\/figure>\n
Analizziamo le differenze tra Azioni e Hook.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Hook di WordPress<\/strong><\/td>\n<\/tr>\n
Azioni<\/strong><\/td>\nFiltri<\/strong><\/td>\n<\/tr>\n
Le azioni vengono utilizzate per eseguire funzioni personalizzate in un punto specifico durante l’esecuzione del Core di WordPress.<\/td>\nI filtri vengono utilizzati per modificare o personalizzare i dati utilizzati da altre funzioni.<\/td>\n<\/tr>\n
Le azioni sono definite\/create dalla funzione do_action( 'action_name' )<\/code><\/strong> nel codice di WordPress.<\/td>\nI filtri sono definiti\/creati dalla funzione apply_filters( 'filter_name', 'value_to_be_filtered' )<\/code><\/strong> nel codice di WordPress.<\/td>\n<\/tr>\n
Le azioni sono anche chiamate Action Hook<\/strong>.<\/td>\nI filtri sono anche chiamati Filter Hook<\/strong>.<\/td>\n<\/tr>\n
Le azioni possono essere agganciate solo alle funzioni di Azione. Ad es. add_action()<\/code><\/strong>, remove_action()<\/code><\/strong>.<\/td>\nI filtri possono essere agganciati solo alle funzioni di Filtro. Ad es. add_filter()<\/code><\/strong>, remove_filter()<\/code><\/strong>.<\/td>\n<\/tr>\n
Le funzioni di azione non devono passare alcun argomento alle loro funzioni di callback.<\/td>\nLe funzioni di filtro devono passare almeno un argomento alle loro funzioni di callback.<\/td>\n<\/tr>\n
Le funzioni di azione possono eseguire qualsiasi tipo di compito, compreso il cambiamento del funzionamento di WordPress.<\/td>\nLe funzioni di filtro esistono solo per modificare i dati trasmessi loro dai filtri.<\/td>\n<\/tr>\n
Le funzioni di azione non dovrebbero restituire (return<\/code><\/strong>) nulla. Tuttavia, possono produrre un echo<\/code><\/strong> all’uscita o interagire con il database.<\/td>\nLe funzioni di filtro devono restituire (return<\/code><\/strong>) le loro modifiche all’uscita. Anche se una funzione di filtro non cambia nulla, deve comunque restituire l’input non modificato.<\/td>\n<\/tr>\n
Le azioni possono eseguire quasi tutto, purch\u00e9 il codice sia valido.<\/td>\nI filtri dovrebbero funzionare in modo isolato, in modo da non avere effetti indesiderati.<\/td>\n<\/tr>\n
Riepilogo:<\/strong> un’azione interrompe il regolare processo di esecuzione del codice per fare qualcosa con le informazioni che riceve, ma non restituisce nulla, e poi esce.<\/td>\nRiepilogo:<\/strong> un filtro modifica le informazioni che riceve, le restituisce alla funzione di hook chiamante e altre funzioni possono utilizzare il valore che restituisce.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
A volte, potete utilizzare un’azione o un filtro per raggiungere lo stesso obiettivo. Per esempio, se desiderate modificare il testo di un post, potete registrare una funzione di callback con l’azione publish_post<\/a> e modificare il contenuto del post quando viene salvato nel database<\/a>.<\/p>\n
\/\/ define the callback function to change the text\nfunction change_text_callback() { \n    \/\/ add the code to change text here\n}\n\n\/\/ hook in to the 'publish_post' action with the add_action() function\nadd_action( 'publish_post', 'change_text_callback' );<\/code><\/pre>\n
Oppure potete registrare un’altra funzione di callback con il filtro the_content<\/a> per modificare il contenuto del post prima che venga visualizzato nel browser.<\/p>\n
\/\/ define the callback function to modify the text\nfunction change_text_another_callback( $content ) { \n    \/\/ add the code to change text here and then return it \n    return $filtered_content;\n}\n\n\/\/ hook in to 'the_content' filter with the add_filter() function\nadd_filter( 'the_content', 'change_text_another_callback');<\/code><\/pre>\n
Due approcci diversi con lo stesso risultato. Sapere quando usare l’uno rispetto all’altro \u00e8 la chiave per essere un buon sviluppatore di WordPress<\/a>.<\/p>\n
Come Funzionano gli Hook di WordPress?<\/h2>\n
L’esempio della casa era abbastanza semplice per comprendere il funzionamento di base degli hook, ma non coglie la complessit\u00e0 del loro funzionamento. Soprattutto i concetti della posizione e della specificit\u00e0 degli hook.<\/p>\n
Un esempio migliore potrebbe essere quello di immaginare di elaborare una pagina di WordPress come l’assemblaggio di un’auto. A differenza della produzione di un’auto, che richiede tempo, l’assemblaggio di una pagina web \u00e8 quasi istantaneo.<\/p>\n
\"Assemblare
Assemblare una pagina web \u00e8 come assemblare un’auto<\/figcaption><\/figure>\n
Proprio come una macchina viene assemblata pezzo per pezzo in una moderna catena di montaggio, una pagina web di WordPress viene assemblata elemento per elemento dal server e dal client.<\/p>\n
Il Core di WordPress \u00e8 come il motore dell’auto, il telaio e altri elementi essenziali, che alimentano la funzionalit\u00e0 “core” del sito web.<\/p>\n
Potete avere un sito web funzionale con il solo Core di WordPress, ma dov’\u00e8 il divertimento? \u00c8 necessario aggiungere funzionalit\u00e0 entusiasmanti al sito. \u00c8 qui che entrano in gioco i plugin<\/a> e i temi di WordPress<\/a>, che utilizzano entrambi ampiamente gli hook.<\/p>\n
Nell’esempio sopra riportato, ogni stazione numerata \u00e8 come un hook all’interno del Core di WordPress. Ci sono due tipi di stazioni, come le azioni e i filtri. Ogni stazione include un tipo specifico di slot che accetta solo alcuni strumenti, come le funzioni di azione e le funzioni di filtro.<\/p>\n
Tutte le stazioni sono posizionate ad intervalli frequenti per modularit\u00e0 ed efficienza.<\/p>\n
In base alla richiesta effettuata in una particolare posizione, possiamo attaccare (o agganciare) l’utensile pi\u00f9 appropriato per il lavoro in quella specifica stazione. Questi strumenti sono come le funzioni di callback utilizzate per interagire o modificare WordPress.<\/p>\n
Alcuni strumenti possono alterare in modo significativo il funzionamento dell’auto, proprio come callback registrate alle azioni. Altri strumenti sono utilizzati solo per personalizzare l’aspetto dell’auto, come le callback registrate ai filtri.<\/p>\n
L’utilizzo degli strumenti giusti nelle stazioni giuste \u00e8 fondamentale per costruire un’auto di prim’ordine. Allo stesso modo, gli hook ci aiutano a personalizzare WordPress in base alle nostre specifiche esigenze.<\/p>\n
Se si estende questa analogia, i plugin sono come un’aggiunta di utili elementi dell’auto come airbag, console di intrattenimento, sistema keyless remoto, ecc. (come quelli utili per migliorare le funzionalit\u00e0 di WooCommerce<\/a>). I temi sono analoghi alla personalizzazione dell’estetica dell’auto, come il design generale, la verniciatura, i cerchioni, ecc. (ecco come personalizzare il vostro tema WordPress<\/a>).<\/p>\n
Dove Registrare gli Hook e le Loro Funzioni?<\/h2>\n
Sono due le modalit\u00e0 raccomandate per aggiungere hook in WordPress:<\/p>\n