В чем разница между фильтрами и хуками действий?

Если посмотреть исходный код основной функции add_action(), то это просто обёртка для функции add_filter()...

А если изучить функцию do_action(), то она очень похожа на основную функцию apply_filters(), с одним ключевым отличием: она не возвращает значение.

Что это значит? Действия (actions) похожи на фильтры (filters), за исключением того, что действие не возвращает значение, поэтому вы не можете модифицировать данные. Это показывает, что механизм действий в WordPress был создан просто копированием механизма фильтров, но без возврата значения. По сути, всё что вы можете сделать с действием — это просто выполнить функцию без модификации какого-либо значения.

Простыми словами.

Действия (Actions) — это PHP-функции, которые выполняют вывод.

Фильтры (Filters) — это PHP-функции, которые возвращают вывод.

Обновлено: Мы можем расширить любой плагин, который использует действия и фильтры, без изменения его кода. Добавляя фильтры и действия в нашей собственной теме или плагине.

Как использовать?

Действия (Actions):

Проверьте простые примеры ниже в файле functions.php вашей темы.

1. Пример первый: (Простой пример на PHP)

function test() {
     echo "Вывод";
}

test();

Вывод программы выше:

Вывод

[ПРИМЕЧАНИЕ: Здесь test() просто вызывает функцию и выполняет callback-функцию 'test'.]

2. Пример второй: (Простое использование действия)

function test1() {
     echo "Вывод";
}
add_action( 'test', 'test1' );

do_action( 'test' );

Вывод программы выше:

Вывод

[ПРИМЕЧАНИЕ: Здесь do_action('test') работает как вызов функции и выполняет callback-функцию 'test1'.]

3. Пример третий: (Другое использование действий)

function test2() {
     echo "Тест 2";
}
add_action( 'test', 'test2', 1 );

function test1() {
     echo "Тест 1";
}
add_action( 'test', 'test1', 2 );

do_action( 'test' );

Вывод программы выше:

Тест 2Тест 1

[ПРИМЕЧАНИЕ: Здесь do_action('test') работает как вызов функции и выполняет callback-функции в соответствии с их приоритетами.

Callback-функция 'test1' имеет приоритет 2, а 'test2' — приоритет 1.]

Если изменить приоритеты, например, 'test1' с приоритетом 1 и 'test2' с приоритетом 2, то вывод будет:

Тест 1Тест 2

4. Пример четвертый: (Поддержка сторонних разработчиков) Добавьте следующий код в functions.php

function test1() {
     do_action( 'test_before' );
     echo "Тест 1";
     do_action( 'test_after' );
}
add_action( 'test', 'test1' );

do_action( 'test' );

Вывод программы выше:

Тест 1

Теперь создадим простой плагин, чтобы проверить, как это работает для сторонних разработчиков.

1. Создайте папку 'simple' в директории /wp-content/plugins/.
2. Создайте файл с именем 'simple.php' и добавьте следующий код.

/*
* Plugin Name: Simple Plugin
*/
function test_callback_function() {
     echo "Из плагина";
}
add_action( 'test', 'test_callback_function' );

Теперь активируйте наш Simple plugin из админ-панели WordPress.

Перейдите в меню "Плагины" и активируйте его.

После активации плагина вывод программы будет:

Тест 1Из плагина

[ПРИМЕЧАНИЕ: Если мы установим приоритет для действия нашего плагина от 1 до 9, то вывод будет таким:

Из плагинаТест 1

Потому что WordPress по умолчанию использует приоритет 10 для всех добавленных действий.]

Фильтры (Filters)

Проверьте следующие примеры:

Простой пример на PHP:

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

Вывод программы выше:

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

1. Пример первый: (Простое использование фильтра)

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

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

Вывод программы выше:

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

Здесь мы добавили фильтр my_filter_name и изменили существующий вывод array( 'one', 'two' ) на array( 'three', 'four' ) без изменения файлов темы/плагина.

Основное различие между действием (action) и фильтром (filter) можно описать следующим образом:

• Действие получает информацию, выполняет с ней какие-то операции и ничего не возвращает. Другими словами: оно действует на что-то и завершает работу, не возвращая данных обратно в вызывающий хук.
• Фильтр получает информацию, каким-то образом её изменяет и возвращает обратно. То есть: он фильтрует что-то и передаёт это обратно в хук для дальнейшего использования.

Или иначе:

• Действие прерывает поток выполнения кода, чтобы что-то сделать, а затем возвращается к обычному потоку, ничего не изменяя;
• Фильтр используется для изменения чего-то определённым образом, чтобы это изменение затем использовалось в дальнейшем коде.

Что-то, о чём идёт речь, — это список параметров, передаваемых через определение хука.

Из официальной документации WordPress