Diferența dintre Filtre și Hook-uri de Acțiune

Dacă te uiți la sursa funcției de bază add_action(), aceasta este doar un wrapper pentru funcția add_filter()...

Și dacă examinezi funcția de bază do_action(), aceasta este foarte asemănătoare cu funcția de bază apply_filters(), cu o diferență esențială: nu returnează nicio valoare.

Deci ce înseamnă asta? Acțiunile sunt ca filtrele, cu excepția faptului că o acțiune nu returnează o valoare, așa că nu poți modifica date. Aceasta arată că a fost simplu să creezi mecanismul de acțiuni al WordPress prin simpla copiere a mecanismului de filtrare, fără a returna o valoare. Practic, tot ce poți face cu o acțiune este să execuți o funcție fără a modifica vreo valoare.

În termeni simpli.

Acțiunile sunt acele funcții PHP care execută output-ul.

Filtrele sunt acele funcții PHP care returnează output-ul.

Actualizat: Putem extinde orice plugin care folosește acțiuni și filtre fără a modifica codul acestuia. Prin adăugarea de filtre și acțiuni în propriul nostru temă sau plugin.

Cum se folosesc?

Acțiuni:

Verificați exemplele simple de mai jos în fișierul functions.php al temei.

1. Exemplul Unu: (Exemplu PHP simplu)

function test() {
     echo "Output";
}

test();

Programul de mai sus afișează output-ul:

Output

[NOTĂ: Aici test() apelează pur și simplu funcția. Și execută funcția callback 'test'.]

2. Exemplul Doi: (Utilizare simplă a Acțiunilor)

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

do_action( 'test' );

Programul de mai sus afișează output-ul:

Output

[NOTĂ: Aici do_action('test') funcționează ca un apel de funcție. Și execută funcția callback 'test1'.]

3. Exemplul Trei: (Altă utilizare a Acțiunilor)

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

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

do_action( 'test' );

Programul de mai sus afișează output-ul:

Test 2Test 1

[NOTĂ: Aici do_action('test') funcționează ca un apel de funcție. Și execută funcțiile callback în funcție de prioritățile lor.

Funcția callback 'test1' are prioritatea 2 iar 'test2' are prioritatea 1. ]

Dacă prioritățile sunt schimbate, de exemplu 'test1' cu prioritatea 1 și 'test2' cu prioritatea 2, atunci output-ul va fi:

Test 1Test 2

4. Exemplul Patru: (Suport pentru terți) Adăugați codul de mai jos în functions.php

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

do_action( 'test' );

Programul de mai sus afișează output-ul:

Test 1

Acum, creați un plugin simplu pentru a verifica cum funcționează pentru dezvoltatorii terți.

1. Creați folderul 'simple' în directorul /wp-content/plugins/.
2. Creați un fișier numit 'simple.php' și adăugați codul de mai jos.

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

Acum, activați plugin-ul nostru Simple din panoul de administrare WordPress.

Accesați meniul de plugin-uri și activați-l.

După activarea plugin-ului, programul de mai sus va afișa output-ul:

Test 1From plugin

[NOTĂ: Dacă adăugăm prioritatea pentru acțiunea plugin-ului nostru de la 1 la 9, atunci va afișa output-ul astfel:

From pluginTest 1

Deoarece WordPress consideră prioritatea 10 implicit pentru toate acțiunile adăugate.]

Filtre

Verificați exemplele de mai jos:

Exemplu PHP simplu:

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

Programul de mai sus afișează output-ul:

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

1. Exemplul Unu: (Utilizare simplă a Filtrelor)

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

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

Programul de mai sus afișează output-ul:

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

Aici, am adăugat filtrul my_filter_name și am schimbat output-ul existent array( 'one', 'two' ) cu array( 'three', 'four' ) fără a modifica fișierele temei/plugin-ului.

Diferența principală dintre un action și un filter poate fi rezumată astfel:

• un action primește informația, face ceva cu ea și nu returnează nimic. Cu alte cuvinte: acționează asupra ceva și apoi iese, fără a returna nimic înapoi către hook-ul apelant.
• un filter primește informația, o modifică într-un fel și o returnează. Cu alte cuvinte: filtrează ceva și o trimite înapoi către hook pentru utilizare ulterioară.

Spus altfel:

• un action întrerupe fluxul de cod pentru a face ceva, apoi revine la fluxul normal fără a modifica nimic;
• un filter este folosit pentru a modifica ceva într-un anumit fel, astfel încât modificarea să fie folosită ulterior de cod.

Ceea ce se referă este lista de parametri trimisă prin definiția hook-ului.

Din documentația oficială WP