Gli hook sono uno degli aspetti più potenti e flessibili di WordPress, permettendo agli sviluppatori di estendere e personalizzare le funzionalità di WordPress senza modificare il core del codice. Gli hook sono fondamentali per creare temi e plugin che possono interagire con WordPress in modo dinamico.
Esistono due tipi principali di hook in WordPress: action hook e filter hook.
1. Action Hook
Gli action hook permettono di aggiungere o eseguire codice personalizzato in punti specifici dell'esecuzione di WordPress. Quando WordPress arriva a un action hook, esegue tutte le funzioni ad esso associate.
Esempio di Action Hook
Ecco un esempio di come utilizzare un action hook per aggiungere un messaggio personalizzato nel footer del tuo sito WordPress:
// Funzione personalizzata che aggiunge un messaggio nel footer
function aggiungi_messaggio_footer() {
echo '<p>Grazie per aver visitato il nostro sito!</p>';
}
// Associa la funzione personalizzata all'action hook wp_footer
add_action('wp_footer', 'aggiungi_messaggio_footer');
In questo esempio, la funzione aggiungi_messaggio_footer
verrà eseguita quando WordPress arriva all'action hook wp_footer
, aggiungendo il messaggio personalizzato al footer del sito.
2. Filter Hook
I filter hook permettono di modificare dati prima che vengano salvati nel database o visualizzati sullo schermo. Quando WordPress arriva a un filter hook, passa i dati attraverso tutte le funzioni associate al filtro, permettendo a ciascuna di esse di modificarli.
Esempio di Filter Hook
Ecco un esempio di come utilizzare un filter hook per modificare il titolo di un post prima che venga visualizzato:
// Funzione personalizzata che modifica il titolo del post
function modifica_titolo_post($title) {
return 'Titolo modificato: ' . $title;
}
// Associa la funzione personalizzata al filter hook the_title
add_filter('the_title', 'modifica_titolo_post');
In questo esempio, la funzione modifica_titolo_post
modifica il titolo di un post aggiungendo il prefisso "Titolo modificato: " prima che venga visualizzato sullo schermo.
Differenza Tra Action e Filter Hook
- Action Hook: Utilizzati per eseguire codice personalizzato in punti specifici dell'esecuzione di WordPress (es. salvare un post, caricare un tema, inviare un'email).
- Filter Hook: Utilizzati per modificare dati in transito (es. titolo di un post, contenuto di un commento, query SQL).
Creare i Tuoi Hook
Puoi anche creare i tuoi custom hook nei tuoi temi o plugin per permettere ad altri sviluppatori di estendere le tue funzionalità.
// Definisci un custom hook nel tuo tema o plugin
do_action('mio_custom_hook');
// Associa una funzione personalizzata al custom hook
function mia_funzione_personalizzata() {
echo '<p>Questa è una funzione personalizzata associata al custom hook!</p>';
}
add_action('mio_custom_hook', 'mia_funzione_personalizzata');
Esempio di Creazione di un Filter Hook
// Definisci un custom hook nel tuo tema o plugin
$value = apply_filters('mio_custom_filter', 'Valore originale');
// Associa una funzione personalizzata al custom hook
function mia_funzione_personalizzata_filter($value) {
return $value . ' - Valore modificato!';
}
add_filter('mio_custom_filter', 'mia_funzione_personalizzata_filter');
Lista degli Hook Più Comuni in WordPress
Ecco una lista degli hook più comunemente utilizzati in WordPress:
-
Action Hook:
init
: Eseguito dopo che WordPress è stato inizializzato.wp_enqueue_scripts
: Utilizzato per registrare e caricare gli script e gli stili.save_post
: Eseguito quando un post viene salvato.wp_footer
: Eseguito prima della chiusura del tag</body>
.
-
Filter Hook:
the_title
: Modifica il titolo del post.the_content
: Modifica il contenuto del post.excerpt_length
: Modifica la lunghezza del riassunto.upload_mimes
: Modifica i tipi di file permessi per il caricamento.