Хуки, действия и фильтры WordPress: что они делают и как работают

В этой статье рассматривается одна из самых важных тем в разработке WordPress: хуки WordPress, включая хуки действий и хуки фильтров. Хуки лежат в основе не только работы плагинов WordPress, но и почти всего кода в экосистеме WordPress: большинство тем WordPress активно используют хуки, как и само “ядро WordPress”. Хуки WordPress — это абсолютно обязательная тема для изучения при разработке WordPress.

Мы снабдили это объяснение хуков WordPress полезным обзорным видео, ключевыми моментами, подробной инфографикой, викториной и даже кратким отрывком (!). Это потому, что это не просто одна из наших обычных статей: это примерная глава из нашего запущенного курса “Освоение разработки WordPress”.

Если вам понравилась эта статья, обязательно ознакомьтесь с «Запущено». Там еще около 40 глав, из которых взята эта. Мы поддерживаем это как единственное лучшее руководство по разработке WordPress в мире.

В этой главе мы рассмотрим одну из самых важных идей в разработке плагинов и тем WordPress: хуки. Можно также сказать, что эта глава посвящена «действиям и фильтрам”, потому что действия и фильтры — это два вида функций, которые взаимодействуют с хуками WordPress.

Понять хуки не так-то просто, отчасти потому, что сами термины довольно сложно визуализировать и отличать друг от друга.

Но отдача огромна: как разработчик, мы обнаруживаем, что работа с фильтрами и действиями, вероятно, является наиболее распространенным способом взаимодействия с WordPress. Со временем это стало одним из наших любимых занятий и в WordPress.

Определения, которые мы используем в этой главе, являются наиболее распространенными, которые вы найдете в WordPress в целом, и они лучше всего подходят для реального понимания происходящего. Поэтому придерживайтесь понимания, которое мы здесь представляем, и не расстраивайтесь, когда другие люди используют эти термины по-разному.

Это только начало; не волнуйтесь, если на данный момент это не имеет смысла:

• Хук — это место в коде WordPress, в которое можно добавлять функции. Создавая хук, вы даете себе и другим разработчикам возможность добавить дополнительную функциональность в этом месте.
• Подключенные функции — это пользовательские функции PHP, которые мы можем “подключить” к WordPress в местах, указанных его хуками.
• Существует два типа подключаемых функций: действия и фильтры. Фильтры изменяют существующий вывод, в то время как действия могут выполнять любые пользовательские функции.
• Хуки бывают двух типов — хуки действий и хуки фильтров — в зависимости от того, какой тип подключаемой функции они принимают.

Пока все хорошо? В любом случае, не волнуйтесь и давайте двигаться дальше. (В конце, возможно, вы захотите вернуться и посмотреть, имеет ли смысл вышесказанное.)

Пока не пытайтесь углубляться в это слишком глубоко — просто поймите, что “Действия подключаются к хукам действий, а фильтры подключаются к хукам фильтров”.

Чтобы объяснить хуки, мы вернемся к нашей центральной аналогии с WordPress как фабрикой.

Помните, что WordPress привлекает внешних подрядчиков для выполнения некоторой части своей работы. У наших подрядчиков нет постоянного места на фабрике WordPress — они застряли снаружи, пока их не пригласит сама фабрика.

Для наших целей эти внешние подрядчики приходят из двух мест:

1. Плагины
2. functions.phpФайл внутри родительской или дочерней темы

Внешние подрядчики сами являются пользовательским кодом в плагинах и functions.php которые изменяют функционирование фабрики WordPress.

Хукеры подключаются к внешнему коду определенными способами и в определенных местах.

Хуки — как хуки действий, так и хуки фильтров — это то, как WordPress обращается к этим внешним подрядчикам. Другими словами, хукеры WordPress подключаются к внешнему коду определенными способами и в определенных местах.

/* Environment: We're in functions.php or a PHP file in a plugin */

function wpshout_filter_example( $title ) {
    return 'Хуки: ' . $title;
}
add_filter( 'the_title', 'wpshout_filter_example' );

Каждый хук помечен определенным именем, например, wp_head, соответствующим части процесса WordPress factory (в случае с wp_head, процессом создания HTML-раздела страницы <head>).

Эти хуки отправляются в лобби, чтобы подрядчики могли использовать их, и они делают это в определенном порядке. wp_head Хук отправляется в лобби и обратно непосредственно перед <head> завершением, wp_footer хук отправляется в лобби и обратно непосредственно перед <body> завершением и так далее. Таким образом, подрядчик всегда подключается непосредственно к активной части фабрики, над которой предстоит поработать.

Когда подрядчик хочет стать частью определенного процесса, он ждет, пока этот хук появится на входе, и едет по нему прямо в нужную часть фабрики.

Если подрядчик не использовал надлежащий хук, он не смог бы добиться желаемого на заводе. Хукеры — это то, что “приглашает” внешний код (из functions.php, плагины и так далее) В определенные области обработки PHP WordPress.

Посмотрите еще раз на диаграмму Хуки WordPress, и давайте разберемся с хуками действий и фильтров.

Итак, подрядчик, использующий хуки фильтров, обычно не просто делает все, что хочет; он работает с тем, что ему предоставлено в его разделе фабрики. “Этот раздел работает с заголовком публикации”, — может сказать менеджер раздела. “Делайте с заголовком поста все, что хотите, но если вы не вернете мне заголовок поста после внесения изменений, весь этот процесс не будет работать должным образом”.

Надеюсь, пока у нас все получается; теперь мы собираемся немного углубиться в технические вопросы, чтобы вы действительно могли начать писать эти вещи.

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

Поскольку эти функции попадают в WordPress, прикрепляясь к хукам WordPress, то есть будучи “подключенными” извне, формальный термин для них — подключенные функции.

Существует два вида подключаемых функций:

1. Действия, также называемые функциями действий, которые подключаются к хукерам действий WordPress и
2. Фильтры, также называемые функциями фильтрации, которые подключаются к хукам фильтров WordPress.

Давайте рассмотрим по одному из них.

/* Environment: We're in functions.php or a PHP file in a plugin */

function wpshout_action_example( ) {
    echo "Земляника здесь.";
}
add_action( 'wp_footer', 'wpshout_action_example' );

Подводя итог: WordPress регистрирует хукеры действий и фильтров в определенных местах процесса создания страницы WordPress. Затем любой разработчик может написать свои собственные функции, которые подключаются к этим хукам действий и фильтров. Фильтры (или “функции фильтрации”) изменяют то, что им предоставляется, и передают это обратно через return; действия (или “функции действия”) могут echo вводить текст, изменять данные и практически все остальное, и им не нужно return значение.

Система хуков WordPress — это действительно путь к полноценной разработке WordPress, поэтому не бойтесь возвращаться к материалу, экспериментировать с ним и создавать его по-своему.