Gli hook di WordPress sono il fondamento dello sviluppo di plugin. Ti permettono di modificare il comportamento di WordPress senza modificare i file core — un concetto che rende WordPress estensibile, mantenibile e aggiornabile. Comprendere a fondo gli hook è ciò che separa gli sviluppatori WordPress principianti dagli esperti.
Questa guida copre tutto ciò che devi sapere sugli hook di WordPress, dalle basi di actions e filters alla creazione di hook personalizzati per l'estensibilità dei plugin.
Actions vs Filters
WordPress ha due tipi di hook: actions e filters. Le action ti permettono di aggiungere funzionalità in punti specifici — inviare un'email dopo la pubblicazione di un post, aggiungere un widget della sidebar o reindirizzare gli utenti dopo il login. I filter ti permettono di modificare i dati — cambiare il contenuto di un post prima che venga visualizzato, modificare la query prima del recupero dei post o tradurre il testo dei plugin.
La differenza chiave: le action non restituiscono valori, mentre i filter accettano e restituiscono un valore. Le action servono per fare cose. I filter servono per cambiare cose. Entrambi usano add_action() o add_filter() per registrarsi, e l'hook viene attivato con do_action() o apply_filters().
Registrazione degli Hook
Registra un hook con add_action() o add_filter(). Entrambe le funzioni accettano il nome dell'hook, una funzione callback, una priorità (predefinita 10) e il numero di argomenti accettati. I numeri di priorità più bassi vengono eseguiti per primi. Più callback possono registrarsi allo stesso hook e WordPress le esegue in ordine di priorità.
La callback può essere un nome di funzione, un array per i metodi di classe o una closure (funzione anonima). Per lo sviluppo di plugin, i metodi di classe con $this sono il pattern più comune. Passa parametri aggiuntivi specificando il conteggio accepted_args e accedendovi nella callback.
Hook Core di WordPress
Il core di WordPress attiva centinaia di hook durante l'esecuzione. I più importanti per lo sviluppo di plugin includono: init — si attiva dopo il caricamento di WordPress, usato per registrare tipi di contenuto e tassonomie; wp_enqueue_scripts — per l'enqueue di CSS e JavaScript del frontend; admin_enqueue_scripts — per l'enqueue di CSS e JavaScript admin; admin_menu — per registrare le pagine di menu admin; the_content — filtra il contenuto dei post; e save_post — si attiva dopo il salvataggio di un post.
Impara l'ordine degli hook per capire quando il tuo codice viene eseguito in relazione alle altre parti di WordPress. Il flusso di esecuzione di WordPress segue una sequenza specifica: must-use plugins, plugin attivi, tema, poi core WordPress. I plugin si caricano prima del tema, il che influisce su quali hook sono disponibili in ogni fase.
Creare Hook Personalizzati
Gli hook personalizzati rendono il tuo plugin estensibile da altri sviluppatori. Usa do_action() per creare un action hook personalizzato a cui altri plugin possono collegarsi. Passa dati contestuali come parametri aggiuntivi così che gli altri sviluppatori abbiano le informazioni necessarie.
Usa apply_filters() per creare filter hook personalizzati che permettano ad altri sviluppatori di modificare i dati del tuo plugin. Prima di emettere qualsiasi valore che altri sviluppatori potrebbero voler personalizzare, passalo attraverso apply_filters(). Questa semplice pratica rende il tuo plugin significativamente più flessibile.
Best Practices
Dai nomi coerenti ai tuoi hook. Usa un prefisso basato sul nome del tuo plugin — «mioplugin_before_save», «mioplugin_filter_data». Documenta i tuoi hook personalizzati con blocchi PHPDoc così che gli sviluppatori che usano il tuo plugin conoscano i parametri disponibili. Usa prefissi univoci per evitare conflitti con altri plugin.
Rimuovi gli hook con remove_action() e remove_filter() quando devi sovrascrivere la funzionalità. Ricorda che remove_action() richiede lo stesso oggetto funzione callback usato per registrare l'hook. Per i metodi di classe, ti serve un riferimento alla stessa istanza.
Il punto fondamentale
Gli hook di WordPress sono il concetto più importante da comprendere come sviluppatore di plugin. Le action ti permettono di aggiungere funzionalità in punti specifici, i filter ti permettono di modificare i dati e gli hook personalizzati rendono il tuo plugin estensibile da altri sviluppatori. Padroneggia gli hook e avrai padroneggiato l'architettura che rende WordPress il CMS più flessibile del mondo.
