Differenza tra Filter e Action Hooks in WordPress

Se osservi il codice sorgente della funzione core add_action(), vedrai che è semplicemente un wrapper per la funzione add_filter()...

E se esamini la funzione core do_action(), noterai che è molto simile alla funzione core apply_filters(), con una differenza fondamentale: non restituisce alcun valore.

Cosa significa questo? Le azioni (actions) sono simili ai filtri (filters), con la differenza che un'azione non restituisce un valore, quindi non puoi modificare i dati. Questo dimostra che è stato semplice creare il meccanismo delle azioni in WordPress semplicemente copiando il meccanismo dei filtri e omettendo il valore di ritorno. In sostanza, tutto ciò che puoi fare con un'azione è eseguire una funzione senza modificare alcun valore.

In parole semplici.

Azioni sono quelle funzioni PHP che eseguono l'output.

Filtri sono quelle funzioni PHP che restituiscono l'output.

Aggiornamento: Possiamo estendere qualsiasi plugin che utilizza azioni e filtri senza modificare il loro codice. Aggiungendo filtri e azioni nel nostro tema o plugin.

Come utilizzarli?

Azioni:

Controlla i semplici esempi qui sotto nel file functions.php del tuo tema.

1. Esempio Uno: (Semplice esempio PHP)

function test() {
     echo "Output";
}

test();

Il programma sopra stampa l'output:

Output

[NOTA: Qui test() semplicemente chiama la funzione. E esegue la funzione di callback 'test'.]

2. Esempio Due: (Semplice utilizzo di un'Azione)

function test1() {
     echo "Output";
}
add_action( 'test', 'test1' );

do_action( 'test' );

Il programma sopra stampa l'output:

Output

[NOTA: Qui do_action('test') funziona come una chiamata a funzione. E esegue la funzione di callback 'test1'.]

3. Esempio Tre: (Un altro utilizzo delle Azioni)

function test2() {
     echo "Test 2";
}
add_action( 'test', 'test2', 1 );

function test1() {
     echo "Test 1";
}
add_action( 'test', 'test1', 2 );

do_action( 'test' );

Il programma sopra stampa l'output:

Test 2Test 1

[NOTA: Qui do_action('test') funziona come una chiamata a funzione. E esegue le funzioni di callback in base alle loro priorità.

La funzione di callback 'test1' ha priorità 2 e 'test2' ha priorità 1.]

Se le priorità vengono cambiate, ad esempio 'test1' con priorità 1 e 'test2' con priorità 2, l'output sarà:

Test 1Test 2

4. Esempio Quattro: (Supporto per terze parti) Aggiungi il codice qui sotto in functions.php

function test1() {
     do_action( 'test_before' );
     echo "Test 1";
     do_action( 'test_after' );
}
add_action( 'test', 'test1' );

do_action( 'test' );

Il programma sopra stampa l'output:

Test 1

Ora, crea un plugin di esempio per verificare come funziona per gli Sviluppatori di terze parti.

1. Crea una cartella 'simple' nella directory /wp-content/plugins/.
2. Crea un file chiamato 'simple.php' e aggiungi il codice qui sotto.

/*
* Plugin Name: Simple Plugin
*/
function test_callback_function() {
     echo "Dal plugin";
}
add_action( 'test', 'test_callback_function' );

Ora, attiva il nostro Simple plugin dalla dashboard di amministrazione di WordPress.

Vai al menu plugin e attivalo.

Dopo aver attivato il plugin, il programma sopra stamperà l'output:

Test 1Dal plugin

[NOTA: Se aggiungiamo la priorità per l'azione del nostro plugin da 1 a 9, stamperà l'output come:

Dal pluginTest 1

Perché WordPress considera priorità 10 come predefinita per tutte le azioni aggiunte.]

Filtri

Controlla gli esempi qui sotto:

Semplice esempio PHP:

$data = array( 'one', 'two' );
print_r( $data );

Il programma sopra stampa l'output:

Array ( [0] => one [1] => two )

1. Esempio Uno: (Semplice utilizzo di un Filtro)

$data = apply_filters( 'my_filter_name', array( 'one', 'two' ) );
print_r( $data );

add_filter( 'my_filter_name', function( $old_data ) {
     return array( 'three', 'four' );
});

Il programma sopra stampa l'output:

Array ( [0] => three [1] => four )

Qui, abbiamo aggiunto il filtro my_filter_name e modificato l'output esistente array( 'one', 'two' ) con array( 'three', 'four' ) senza cambiare i file del tema/plugin.

La principale differenza tra un'azione e un filtro può essere riassunta così:

• un'azione prende le informazioni che riceve, fa qualcosa con esse e non restituisce nulla. In altre parole: agisce su qualcosa e poi termina, senza restituire nulla all'hook chiamante.
• un filtro prende le informazioni che riceve, le modifica in qualche modo e le restituisce. In altre parole: filtra qualcosa e lo passa nuovamente all'hook per un ulteriore utilizzo.

Per dirla in un altro modo:

• un'azione interrompe il flusso del codice per fare qualcosa, poi torna al flusso normale senza modificare nulla;
• un filtro viene utilizzato per modificare qualcosa in modo specifico, affinché la modifica venga poi utilizzata dal codice successivo.

Il qualcosa a cui ci si riferisce è la lista di parametri inviata tramite la definizione dell'hook.

Dalla documentazione ufficiale di WordPress