{"id":233537,"date":"2023-02-15T20:00:00","date_gmt":"2023-02-15T17:00:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=233537"},"modified":"2022-11-11T00:13:43","modified_gmt":"2022-11-10T21:13:43","slug":"guida-tutto-sugli-hook-in-wordpress","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/it\/guida-tutto-sugli-hook-in-wordpress\/","title":{"rendered":"Guida: Tutto sugli Hook in WordPress"},"content":{"rendered":"\n

Ti \u00e8 mai stato detto che la soluzione al tuo problema \u00e8 che devi "agganciarti" a qualcosa per fare la tua cosa o usarla add_filter<\/code>senza capire davvero perch\u00e9 incasina le cose? Gli hook costituiscono le fondamenta di WordPress e forniscono temi e plug-in un modo per interagire o modificare il codice In questo post analizzeremo cosa sono gli hook, come funzionano e come possiamo usarli.<\/p>\n

Cosa sono i ganci?<\/h2>\n

Mentre WordPress esegue il suo codice (dall’inizio del caricamento delle classi, del caricamento dei plugin, del caricamento del tema, della query per la richiesta corrente e infine del rendering dell’HTML), passa attraverso una serie di "punti di controllo"; ganci. Quando viene rilevato un hook, WordPress interrompe ci\u00f2 che sta facendo e controlla se ci sono funzioni (nel tema, nel plug-in o nello stesso WordPress) che sono registrate per essere eseguite su questo hook. Se ci sono, WordPress eseguir\u00e0 tutte queste funzioni e poi continuer\u00e0 da dove era stato interrotto.<\/p>\n

Ci\u00f2 consente a plug-in, temi e WordPress stesso di "agganciarsi" a determinati punti per aggiungere, ad esempio, fogli di stile nel <head><\/code>tag del tema, modificare il modo in cui WordPress interroga i post o semplicemente modificare il contenuto del post, se lo si desidera.<\/p>\n

Esistono due tipi di ganci; azioni e filtri. Funzionano in modo abbastanza simile tra loro, ma con un’eccezione che esamineremo pi\u00f9 da vicino di seguito.<\/p>\n

Azioni e filtri<\/h2>\n

Per agganciare un’azione o un filtro, \u00e8 necessario definire quale hook (in base al suo nome) si desidera utilizzare e definire un callback, che \u00e8 il nome della funzione che si desidera eseguire. Nella maggior parte dei casi gli hook forniscono parametri o variabili rilevanti per l’hook.<\/p>\n

Le azioni sono semplicemente "punti di controllo" nell’esecuzione di WordPress, dove puoi eseguire un’attivit\u00e0 o fare eco a qualcosa. In alcuni rari casi \u00e8 possibile modificare un oggetto (fornito nei parametri), in modo che tutte le successive esecuzioni funzionino con quell’oggetto modificato.<\/p>\n

I filtri servono per modificare una variabile o un output. Tutti i filtri hook forniranno la variabile che puoi modificare come primo parametro e ti permetteranno di modificarla o restituire qualcosa di diverso.<\/p>\n

WordPress esegue molti hook, ma puoi crearne uno tuo nel tuo plugin o tema. Ci\u00f2 consente agli sviluppatori di estendere e modificare il codice; ad esempio modificando un plug-in tramite un tema o modificando il tema principale tramite il tema figlio.<\/p>\n

Molte delle funzioni di WordPress, generalmente utilizzate per stampare i post, sono anche filtri o azioni. Ad esempio la funzione the_title()<\/code>stampa il titolo del post, ma \u00e8 anche un filtro.<\/p>\n

Diamo un’occhiata a come ci agganciamo a questi in pratica.<\/p>\n

Agganciarsi alle azioni<\/h2>\n

Per agganciare un’azione, usi il metodo add_action()<\/code>. Come minimo richiede due parametri; il nome dell’hook e la richiamata; il nome della funzione che si desidera eseguire. Facoltativamente puoi fornire la priorit\u00e0 come terzo parametro e definire il numero di argomenti che verranno passati alla tua funzione di callback. Esamineremo i due parametri opzionali in seguito, ma per ora, ecco un esempio di add_action<\/code>:<\/p>\n

add_action('init', 'my_function_name');\nfunction my_function_name() {\n    \/\/ Do your stuff\n}<\/code><\/pre>\n
Il primo parametro to add_action<\/code>\u00e8 il nome dell’azione; in questo caso init<\/code>, che \u00e8 un hook di WordPress piuttosto comune che si verifica durante l’inizializzazione. Il secondo parametro \u00e8 la tua callback, in questo caso il nome della funzione che desideriamo eseguire. Quindi tutto ci\u00f2 che devi fare \u00e8 definire una funzione con quel nome e aggiungere il tuo codice al suo interno.<\/p>\n
Puoi anche usare funzioni anonime che \u00e8 dove definisci la funzione all’interno add_action<\/code>invece di fornire un nome di funzione, in questo modo;<\/p>\n
add_action('init', function() {\n    \/\/ Do your stuff\n});<\/code><\/pre>\n
Molti sviluppatori preferiscono questo metodo in quanto impedisce il rischio di ridefinire una funzione PHP con lo stesso nome.<\/p>\n
Se devi eseguire una funzione definita all’interno di una classe PHP, devi fornire un array come parametro di callback; dove il primo elemento \u00e8 l’oggetto classe e il secondo elemento \u00e8 il nome della funzione:<\/p>\n
class MyClass {\n    public function __construct() {\n        add_action('init', [$this, 'myFunctionName']);\n    }\n\u00a0\n    public function myFunctionName() {\n        \/\/ Do your stuff\n    }\n}<\/code><\/pre>\n
Aggancio ai filtri<\/h2>\n
Per agganciare un filtro si usa la funzione add_filter()<\/code>. Analogamente alle azioni precedenti, il primo parametro \u00e8 il nome del filtro e il secondo \u00e8 la richiamata. Facoltativamente puoi fornire la priorit\u00e0 come terzo parametro e il numero di argomenti come quarto. Ecco un esempio di add_filter<\/code>:<\/p>\n
add_filter('the_title', 'my_function_name');\nfunction my_function_name($title) {\n    \/\/ Do your stuff\n    return $title;\n}<\/code><\/pre>\n
Nell’esempio sopra ci colleghiamo al filtro the_title<\/code>(che stampa il titolo del post) e diciamo a WordPress di eseguire la nostra funzione. Tutti i filtri forniranno sempre un argomento; la variabile da modificare. Nella mia funzione l’ho chiamato perch\u00e9 $title<\/code>so che contiene il titolo del post. All’interno della funzione posso modificarla o sovrascrivere completamente la variabile. \u00c8 importante ricordare che nei filtri devi sempre restituire la variabile<\/strong>. Se non restituisci qualcosa nella tua funzione di callback, la variabile si svuota. Se ho saltato la dichiarazione di ritorno nell’esempio sopra, nessun titolo dei post riecheggia mai da nessuna parte.<\/p>\n
L’argomento variabile e la regola di restituire qualcosa nella tua funzione di callback \u00e8 praticamente l’unica differenza tra filtri e azioni. Tutto il resto funziona allo stesso modo. Puoi seguire gli esempi per le funzioni e le classi anonime mostrate per le azioni sopra per i filtri, cos\u00ec come i parametri facoltativi priorit\u00e0 e numero di argomenti; che vedremo in seguito.<\/p>\n
Priorit\u00e0<\/h2>\n
Il terzo parametro (facoltativo) per add_action<\/code>ed add_filter<\/code>\u00e8 un numero intero che definisce la priorit\u00e0 della funzione di callback. Questo \u00e8 utile nei casi in cui ci sono pi\u00f9 funzioni (non necessariamente da te nel tuo tema o plugin, ricorda che WordPress stesso usa i suoi hook) e devi decidere quale eseguire per primo.<\/p>\n
Se non viene fornita alcuna priorit\u00e0, il valore predefinito \u00e8 10. Minore \u00e8 la priorit\u00e0, prima viene eseguita e maggiore \u00e8 la priorit\u00e0, pi\u00f9 tardi viene eseguita. Non puoi fornire una priorit\u00e0 negativa.<\/p>\n
Immagina pi\u00f9 funzioni di richiamata registrate in init<\/code>. Se non \u00e8 stata fornita alcuna priorit\u00e0 per pi\u00f9 richiamate, WordPress le eseguir\u00e0 nell’ordine in cui sono state trovate (ad esempio nel functions.php<\/code>codice o nel codice del plug-in).<\/p>\n
add_action('init', 'my_function_name');\nadd_action('init', 'my_second_function_name');\nadd_action('init', 'my_third_function_name', 12);\nadd_action('init', 'my_fourth_function_name', 1);<\/code><\/pre>\n
Questo sarebbe l’ordine in cui WordPress eseguir\u00e0 le richiamate di cui sopra:<\/p>\n
    \n
  1. my_fourth_function_name<\/code>(priorit\u00e0 1)<\/li>\n
  2. my_function_name<\/code>(priorit\u00e0 10)<\/li>\n
  3. my_second_function_name<\/code>(priorit\u00e0 10, ma appare pi\u00f9 avanti nel codice)<\/li>\n
  4. my_third_function_name<\/code>(priorit\u00e0 12)<\/li>\n<\/ol>\n
    Numero di argomenti<\/h2>\n
    Di solito gli hook forniscono alcuni dati aggiuntivi che sono rilevanti e utili per le funzioni di callback. Ad esempio l’azione save_post<\/code>(viene eseguita ogni volta che un post viene aggiornato) fornisce due possibili argomenti; l’ID del post e l’oggetto del post. Questi sono utili per le operazioni che devi comunemente eseguire su questo hook (ad esempio se vuoi salvare un meta post, hai bisogno dell’ID post).<\/p>\n
    Se non \u00e8 stato fornito alcun numero di argomenti per un’azione o un filtro, il valore predefinito \u00e8 1. Questo \u00e8 il motivo per cui non \u00e8 necessario definire 1 su add_filter<\/code>per accedere alla variabile a cui \u00e8 agganciato il filtro. Le azioni, tuttavia, non possono passare argomenti anche se il numero di argomenti \u00e8 impostato su 1 come predefinito.<\/p>\n
    Diamo un’occhiata a un esempio di definizione del numero di argomenti e di come accediamo ad essi nella nostra funzione di callback:<\/p>\n
    add_action('save_post', 'my_function_name', 10, 2);\nfunction my_function_name($post_id, $post) {\n    \/\/ Do your stuff\n}<\/code><\/pre>\n
    Nell’esempio sopra, diciamo a WordPress di passare due argomenti alla nostra funzione di callback. Ricorda che dobbiamo definire la priorit\u00e0 come terzo parametro, quindi di solito definiamo il valore predefinito, che \u00e8 10. Per quanto riguarda la nostra funzione di callback, ora possiamo definire lo stesso numero di argomenti che abbiamo chiesto, nell’esempio sopra era 2.<\/p>\n
    Se nell’esempio precedente avessimo impostato il numero di argomenti su 1, solo il primo argomento nella nostra funzione di callback sarebbe stato popolato. Il secondo, $post<\/code>, sarebbe indefinito.<\/p>\n
    E se avessimo bisogno di dati che non sono stati passati nell’hook?<\/h2>\n
    Spetta interamente allo sviluppatore che ha creato l’hook definire quali argomenti possono essere passati. Ci\u00f2 significa che non puoi semplicemente forzare gli argomenti che desideri o di cui hai bisogno nel tuo add_action<\/code>o add_filter<\/code>. Fortunatamente nella maggior parte dei casi abbiamo alternative per ottenere le variabili di cui abbiamo bisogno. Se stai agganciando un’azione o un filtro in cui sai che alcune variabili globali dovrebbero essere definite, puoi accedere a queste variabili globali nella tua funzione di callback. Inoltre, WordPress ha un’intera gamma di tag condizionali<\/a> che puoi utilizzare nelle tue funzioni agganciate (con l’eccezione dei primissimi hook che si verificano prima che WordPress definisca questi tag condizionali)<\/p>\n
    Diamo un’occhiata a un esempio di accesso a variabili globali. Il filtro the_title<\/code>fornisce l’ID del post come argomento opzionale, a cui possiamo accedere definendolo come argomento accettabile;<\/p>\n
    add_filter('the_title', 'my_function_name', 10, 2);\nfunction my_function_name($title, $post_id) {\n    if ($post_id == 1) {\n        return 'First post ever!';\n    }\n    return $title;\n}<\/code><\/pre>\n
    Tuttavia, possiamo ottenere lo stesso risultato;<\/p>\n
    add_filter('the_title', 'my_function_name');\nfunction my_function_name($title) {\n    global $post;\n    if ($post->ID == 1) {\n        return 'First post ever!';\n    }\n    return $title;\n}<\/code><\/pre>\n
    Se sai che una variabile globale \u00e8 definita dal punto in cui viene eseguito l’hook, puoi definirla come globale nella tua funzione di callback e accedere ai dati da l\u00ec. Ad esempio, la definizione global $wp_query<\/code>nell’esempio sopra ti darebbe anche accesso all’oggetto wp_query completo all’interno della tua funzione di callback.<\/p>\n
    I tag condizionali di WordPress<\/a> sono estremamente utili. A meno che tu non sia agganciato a un hook che si verifica molto presto nell’esecuzione di WordPress, sono disponibili. Ci sono tag condizionali per controllare a quale pagina (modello) ti trovi, se ti trovi all’interno di un menu o di un ciclo di post e molto altro. Ad esempio, quando si modifica la query del post utilizzando l’hook pre_get_posts<\/code>, \u00e8 molto utile assicurarsi che il codice venga eseguito solo in determinati casi. Per esempio;<\/p>\n
    add_action('pre_get_posts', 'my_function_name');\nfunction my_function_name($query) {\n    if (!is_admin()) {\n        \/\/ Do your stuff\n    }\n}<\/code><\/pre>\n
    Poich\u00e9 l’hook pre_get_posts<\/code>viene eseguito sia in admin che in frontend, possiamo utilizzare un tag condizionale per garantire che il nostro codice influisca solo sulla query frontend.<\/p>\n
    Creare i tuoi ganci<\/h2>\n
    \u00c8 possibile definire le proprie azioni e filtri. Se sei uno sviluppatore di temi o plugin, sei incoraggiato a farlo, in modo da consentire ad altri di modificare il tuo codice senza cambiare il codice sorgente.<\/p>\n
    Registra un’azione con do_action()<\/code>e registra un filtro con apply_filters()<\/code>.<\/p>\n
    Il do_action()<\/code>richiede un minimo di 1 parametro; il nome del gancio. Tieni presente che il nome dell’hook deve essere univoco (non chiamarlo ad esempio init<\/code>perch\u00e9 si tratta di un hook principale di WordPress). Posiziona il do_action()<\/code>punto dove vuoi che appaia il gancio. Ad esempio, puoi posizionare l’hook nel tuo tema header.php<\/code>, subito dopo il corpo per definire un hook in cui gli sviluppatori possono produrre script o altro contenuto.<\/p>\n
    ...\n<body>\n    <?php do_action('mytheme_after_body'); ?><\/code><\/pre>\n
    Puoi aggiungere tutti i parametri do_action<\/code>che vuoi dopo il nome dell’hook. Cerca di tenere a mente ci\u00f2 di cui gli sviluppatori di dati avrebbero bisogno nei tuoi hook, che altrimenti non sarebbero facilmente accessibili.<\/p>\n
    Il apply_filters()<\/code>richiede un minimo di 2 parametri; il nome dell’hook e la variabile su cui stai registrando il filtro. Ad esempio, il tuo tema pu\u00f2 registrare un filtro attorno ad alcune classi HTML per consentire agli sviluppatori di modificarle o aggiungerle:<\/p>\n
    <section class=\"<?php echo apply_filters('mytheme_section_classes', 'section default-class'); ?>\">\n    ...\n<\/section><\/code><\/pre>\n
    Come per le azioni, puoi aggiungere tutti i parametri apply_filters<\/code>che desideri dopo i due parametri obbligatori.<\/p>\n
    Conclusione e risorse utili<\/h2>\n
    Con questo spero che tu abbia raggiunto una solida comprensione di come WordPress esegue la maggior parte del suo codice, come puoi modificare il codice e come tu come sviluppatore puoi consentire anche ad altri sviluppatori di apportare modifiche al tuo codice.<\/p>\n