Хуки: фильтры и действия. Подробное руководство

Хук (hook) — в переводе означает крючок.

Где-то в самом коде ядра WordPress или в плагине WooCommerce (да и в любом плагине) или даже в теме есть крючки, на которые мы можем повесить свой код, никак не затрагивая при этом основные файлы WordPress или же файлы плагина. Тем самым вы сможете спокойно обновлять плагины и движок, а ваш код, подвешенный на эти крючки будет находиться где-то в отдельном месте.

Наши хуки будут делиться на два вида: фильтры и действия.

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

Чтобы скачать плагин, который получился в процессе этого урока, нужно купить курс.

Пошаговый разбор работы фильтра

Задача фильтра — дополнительно изменить значение какой-либо переменной при помощи произвольной функции, не затрагивая при этом основные файлы движка или плагинов.

Делается это в принципе при помощи двух функций — apply_filters() и add_filter().

1. Всё начинается с того, что где-то в коде движка WordPress или плагина находится переменная, на которую в последствии нужно будет воздействовать фильтром. На эту переменную вешается функция apply_filters(), и результат действия функции обычно присваивается самой же переменной. Кроме того, тут же задаётся и название фильтра. Например это может выглядит так:

$x = apply_filters( 'misha_filter', $x );

2. После этого мы уже можем воздействовать на эту переменную извне при помощи add_filter(). Для этого например в файле functions.php или в нашем собственном плагине, который мы разрабатываем на протяжении этого курса, мы создаём функцию с произвольным названием, аргумент функции — переменная $x, внутри функции выполняем с ней все необходимые действия и в конце концов возвращаем результативную переменную. Затем, рядом с функцией вызываем add_filter(), в которой в качестве параметров указываем название фильтра и название нашей произвольной функции. Меньше слов, больше дела — вот как это может выглядеть:

add_filter( 'misha_filter', 'misha_function' );
 
function misha_function( $x ) {
	$x = '<strong>' . $x . '</strong>'; // если переменная текстовая, мы просто сделали текст жирным шрифтом
	return $x; // возвращаем
}

Или вот так начиная с версии PHP 5.3

add_filter( 'misha_filter', function( $x ) {
	$x = '<strong>' . $x . '</strong>'; // если переменная текстовая, мы просто сделали текст жирным шрифтом
	return $x; // возвращаем
} );

Но у анонимной функции есть минус – такой хук невозможно будет отключить.

3. Стоп! Прежде, чем читать пост дальше, рекомендую опробовать всё это у себя. Вам не обязательно писать для этого плагин — просто в теме, например в header.php выведите переменную $x и перед выводом примените к ней фильтр, а в файле functions.php этот фильтр и наложите.

Пример с фильтром the_content

Скажите, то содержимое поста, которое находится у вас в редакторе в админке и то, которое выводится на сайте одно и то же или отличается?

Вероятно, это одна из тех вещей, которая фильтруется больше всего – при помощи фильтра the_content на содержимое поста накладываются функции wpautop(), wptexturize(), применяются шорткоды. Кроме того, пользователь тоже мог нагуглить какие-нибудь хуки и с их помощью, скажем, выводить кнопки социальных сетей под постом.

Чтобы посмотреть наглядно, попробуйте вставить этот код в удобное место в теме, в footer.php или в произвольный шаблон страницы:

$my_post = get_post( 5 ); // вместо 5 укажите ID интересующей вас записи
echo $my_post->post_content; // выводим содержимое поста как оно есть в базе данных
$filtered = apply_filters( 'the_content', $my_post->post_content ); // применяем фильтры
echo $filtered; // выводим, смотрим, что получилось

Пошаговый разбор работы хука действия

Задача хука действия — в определенном месте в коде дать возможность выполнить вспомогательную функцию извне, не изменяя при этом самого кода.

Делается всё это так же, как и в случае с фильтрами, двумя функциями — do_action() и add_action()

1. Всё начинается с того, что где-то в коде есть место, в котором потенциально нужно будет выполнить дополнительный код. Это место мы обозначим функцией do_action(), в качестве параметра которой укажем название «крючка». Это будет выглядеть очень просто:

do_action( 'misha_hook' );

2. Теперь на этот «крючок» мы уже можем повесить функцию, которая будет находиться например в functions.php вашем темы или в отдельном плагине. То есть открываем functions.php, создаём там произвольную функцию, затем рядом с ней (не в ней!) выполняем функцию add_action(), в которой указываем название хука и название произвольной функции.

add_action( 'misha_hook', 'misha_function2' );
 
function misha_function2(){
	echo 'Привет, мир!';
}

Ну разве не простой механизм?

Пример с использованием хука wp_head в WordPress

Просто wp_head это первое, что пришло мне сейчас в голову. Итак, прежде всего откройте страницу вашего сайта, откройте её и в виде HTML-кода в браузере. А теперь зайдите в файл header.php и быстрым нажатием клавиши удалите оттуда функцию wp_head() (она и запускает хук). После этого посмотрите, как сильно изменится ваша страница — исчезнут стили, скрипты, возможно какой-то произвольный код, который вы вручную добавляли через этот хук.

Параметры и приоритеты

Приоритеты

Про приоритеты рассказать гораздо проще, поэтому начну с них. Как вы уже поняли, на один и тот же хук («крючок») имеется возможность повесить довольно много функций. Но ведь иногда эти функции изменяют значение одной и той же переменной, а это значит, что если поменять их местами, то и значение переменной будет другим.

Покажу простейший пример с использованием анонимных функций (вам нужна версия PHP 5.3.0 или выше) и хуков действий. Если вы вставите этот код куда-нибудь на сайте, то привязанные к хуку функции будут выполняться в порядке подключения в коде

add_action( 'misha_priority', function(){ echo 'A'; } );
add_action( 'misha_priority', function(){ echo 'Б'; } );
add_action( 'misha_priority', function(){ echo 'В'; } );
 
// сам хук
do_action( 'misha_priority' ); // будет выведено АБВ

А теперь внимание — функции add_action() и add_filter() третьим параметров поддерживают указание приоритета, с учетом этого видоизменим наш код.

add_action( 'misha_priority', function(){ echo 'A'; }, 9999 );
add_action( 'misha_priority', function(){ echo 'Б'; }, 5 );
add_action( 'misha_priority', function(){ echo 'В'; }, 10 ); // 10 - значение по умолчанию, поэтому его можно и не указывать
 
// сам хук
do_action( 'misha_priority' ); // будет выведено БВА

Как видите, чем выше значение приоритета, тем позднее функция будет подключена к хуку и выполнена.

Передача дополнительных аргументов в функцию

Чего ещё не хватает для полного счастья — передачи в подвешенные на хук функции дополнительных параметров. И эта возможность тоже предусмотрена.

Всё начинается с того, что в функциях do_action() или apply_filters() указываются один или несколько параметров.

do_action( 'misha_action', $param1, $param2, $param3 );

После этого, четвёртым параметром функции add_action() или add_filter() соответственно вы можете решить, сколько из них можно передать непосредственно в функцию.

add_action( 'misha_action', 'misha_function_1', 10, 3 ); // 3 - количество параметров, можно указать и 2, тогда функция misha_function() примет только два параметра, единицу можно не указывать, так как это значение по умолчанию
 
function misha_function_1( $param1, $param2, $param3 ) {
 
 	...
 
}

Отключение хуков и действий

Всего для этих целей в WordPress существует 4 функции:

• remove_filter() — для отключения конкретной функции с фильтра.
• remove_action() — для удаления конкретной функции с хука действия.
• remove_all_filters() — для полной очистки хука фильтра.
• remove_all_actions() — для полной очистки хука действия.

Пример для WooCommerce, удаляющий опции сортировки со страницы «Магазин» и категорий товаров:

remove_action( 'woocommerce_before_shop_loop', 'woocommerce_catalog_ordering', 30 );

Подробнее – на видео.

Список уроков

• О чём этот курс?03:38
• Основы создания плагина16:18
• Руководство по хукам26:01
• Страницы настроек17:06
• Настройки товара12:05
• Настройки вариации11:52
• PHP-классы в плагинах09:27
• Классы и объекты13:10
• Локализация16:14
• Обновление плагина15:28
• Транзитный кэш09:02
• Валидация и очистка12:37