¿Cuál es la Diferencia Entre los Hooks de Filtro y Acción?

Si miras el código fuente de la función principal add_action(), verás que es simplemente un envoltorio para la función add_filter()...

Y si examinas la función principal do_action(), es muy similar a la función principal apply_filters(), con una diferencia clave: no devuelve ningún valor.

¿Qué significa esto? Las acciones son como filtros, excepto que una acción no devuelve un valor, por lo que no puedes modificar datos. Esto demuestra que fue sencillo crear el mecanismo de acciones de WordPress simplemente copiando el mecanismo de filtros y omitiendo el retorno de valores. Básicamente, todo lo que puedes hacer con una acción es ejecutar una función sin modificar ningún valor.

En palabras simples.

Acciones son aquellas funciones PHP que ejecutan la salida.

Filtros son aquellas funciones PHP que retornan la salida.

Actualizado: Podemos extender cualquier plugin que use acciones y filtros sin modificar su código. Añadiendo filtros y acciones en nuestro propio tema o plugin.

¿Cómo usarlos?

Acciones:

Revisa los siguientes ejemplos simples en el archivo functions.php de tu tema.

1. Ejemplo Uno: (Ejemplo simple de PHP)

function test() {
     echo "Salida";
}

test();

El programa anterior imprime la salida:

Salida

[NOTA: Aquí test() simplemente llama a la función. Y ejecuta la función callback 'test'.]

2. Ejemplo Dos: (Uso simple de Acción)

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

do_action( 'test' );

El programa anterior imprime la salida:

Salida

[NOTA: Aquí do_action('test') funciona como llamar a una función. Y ejecuta la función callback 'test1'.]

3. Ejemplo Tres: (Otro uso de Acciones)

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

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

do_action( 'test' );

El programa anterior imprime la salida:

Test 2Test 1

[NOTA: Aquí do_action('test') funciona como llamar a una función. Y ejecuta las funciones callback según sus prioridades.

La función callback 'test1' tiene prioridad 2 y 'test2' tiene prioridad 1. ]

Si las prioridades se cambian, 'test1' con prioridad 1 y 'test2' con prioridad 2, la salida será:

Test 1Test 2

4. Ejemplo Cuatro: (Soporte para terceros) Añade el siguiente código en functions.php

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

do_action( 'test' );

El programa anterior imprime la salida:

Test 1

Ahora, crea un plugin de ejemplo para ver cómo funciona para desarrolladores externos.

1. Crea la carpeta 'simple' en el directorio /wp-content/plugins/.
2. Crea un archivo llamado 'simple.php' y añade el siguiente código.

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

Ahora, activa nuestro Plugin Simple desde el panel de administración de WordPress.

Ve al menú de plugins y actívalo.

Después de activar el plugin, el programa imprime la salida:

Test 1Desde el plugin

[NOTA: Si añadimos una prioridad para la acción de nuestro plugin de 1 a 9, imprimirá la salida así:

Desde el pluginTest 1

Porque WordPress considera la prioridad 10 por defecto para todas las acciones añadidas.]

Filtros

Revisa los siguientes ejemplos:

Ejemplo simple de PHP:

$data = array( 'uno', 'dos' );
print_r( $data );

El programa anterior imprime la salida:

Array ( [0] => uno [1] => dos )

1. Ejemplo Uno: (Uso simple de Filtro)

$data = apply_filters( 'my_filter_name', array( 'uno', 'dos' ) );
print_r( $data );

add_filter( 'my_filter_name', function( $old_data ) {
     return array( 'tres', 'cuatro' );
});

El programa anterior imprime la salida:

Array ( [0] => tres [1] => cuatro )

Aquí, hemos añadido el filtro my_filter_name y cambiado la salida existente array( 'uno', 'dos' ) por array( 'tres', 'cuatro' ) sin modificar los archivos del tema/plugin.

La principal diferencia entre una acción y un filtro puede resumirse así:

• una acción toma la información que recibe, hace algo con ella y no devuelve nada. En otras palabras: actúa sobre algo y luego termina, sin devolver nada al hook que la llamó.
• un filtro toma la información que recibe, la modifica de alguna manera y la devuelve. Es decir: filtra algo y lo pasa de vuelta al hook para su uso posterior.

Dicho de otra forma:

• una acción interrumpe el flujo del código para hacer algo y luego retorna al flujo normal sin modificar nada;
• un filtro se usa para modificar algo de manera específica, de modo que dicha modificación sea utilizada más adelante por el código.

El "algo" mencionado se refiere a la lista de parámetros enviados mediante la definición del hook.

Según la documentación oficial de WordPress