Actions в WordPress

ФункцииКомментариев нет

В данной статье мы рассмотрим все основные действия(actions) в вордпресс. Статья действий будет построено следующим образом. Название действия(action), описание действия, ссылка на документацию и пример(если у действия есть возвращаемые переменные).

Actions при стандартном запросе

Следующие действия(экшены) срабатываю при посещение сайта пользователем. Следует учитывать что они срабатывают только один раз. Данные действия следует рассматривать как направляющие(основные) в вордпресс. Действия указаны в порядке очереди, начиная с muplugins_loaded(самого первого).

Действия вызываются с помощью функции do_action(), за исключением случаев, отмеченных (ref array), которые вызываются функцией do_action_ref_array ().

muplugins_loaded

Срабатывает после загрузки обязательных плагинов. Он вызывается до загрузки других плагинов.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/muplugins_loaded

registered_taxonomy

Срабатывает после того как пользовательская таксономия была зарегистрирована. Регистрируются как стандартные таксономии(category, post_tag и т.д.), так и пользовательские.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/registered_taxonomy

Пример:

registered_post_type

Срабатывает после того как были зарегистрированы произвольные типы записей. Регистрируются как типы записей(post, page и т.д.), так и пользовательские.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/registered_post_type

plugins_loaded

Срабатывает после загрузки активных плагинов и подключаемых функций.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/plugins_loaded

sanitize_comment_cookies

Очищает поля формы комментирвоания имя, почту и сайт находящихся в кукисах.

Документация: https://developer.wordpress.org/reference/hooks/sanitize_comment_cookies/

setup_theme

Событие срабатывает до загрузки темы.

Документация: https://codex.wordpress.org/index.php?title=Plugin_API/Action_Reference/setup_theme

load_textdomain

load_textdomain запускается непосредственно перед загрузкой файла .mo для перевода, когда функция load_textdomain() вызывается либо напрямую, либо через load_plugin_textdomain() для плагина и load_theme_textdomain () для темы. Эти две функции, в свою очередь, являются обертками для load_textdomain().

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/load_textdomain

Пример:

after_setup_theme

Обычно используется для инициализации settings/options темы. Хук запускается сразу после загрузки файла functions.php. Функцию add_theme_support() следует использовать именно с этим хуком, так как например хук init запускается слишком поздно дне некоторых настроек. На этом этапе текущий пользователь еще не аутентифицирован.

Документация: https://developer.wordpress.org/reference/hooks/after_setup_theme/

Пример:

auth_cookie_malformed

Срабатывает, если файл cookie для проверки подлинности имеет неверный формат.

Документация: https://developer.wordpress.org/reference/hooks/auth_cookie_malformed/

Пример:

auth_cookie_valid

Вызывается если проверка подлинности кукис прошла успешно.

Документация: https://developer.wordpress.org/reference/hooks/auth_cookie_valid/

Пример:

set_current_user

Аутентификация пользователя.

Документация: https://developer.wordpress.org/reference/hooks/set_current_user/

init

Вызывается после завершения загрузки WordPress, но до отправки каких-либо заголовков. Пользователь уже аутентифицирован.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/init

widgets_init

Вызывается после того, как все стандартные виджеты WordPress были зарегистрированы.

Документация: https://developer.wordpress.org/reference/hooks/widgets_init/

register_sidebar

Вызывается  как только боковая панель(сайдбар) был зарегистрирован.

Документация: https://developer.wordpress.org/reference/hooks/register_sidebar/

Пример:

wp_register_sidebar_widget

Вызывается при регистрации каждого виджета.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp_register_sidebar_widget

Пример:

wp_default_scripts

(ref array) Выполняется при инициализации экземпляра WP_Scripts(Основной класс, используемый для регистрации скриптов). Принимает экземпляр класса WP_Scripts.

Документация: https://developer.wordpress.org/reference/hooks/wp_default_scripts/

wp_default_styles

(ref array) Выполняется при инициализации экземпляра WP_Styles(Основной класс, используемый для регистрации стилей). Принимает экземпляр класса WP_Styles.

Документация: https://developer.wordpress.org/reference/hooks/wp_default_styles/

admin_bar_init

Вызывается после инициализации WP_Admin_Bar(Основной класс, используемый для реализации API панели инструментов.).

Документация: https://developer.wordpress.org/reference/hooks/admin_bar_init/

add_admin_bar_menus

Вызывается после добавления меню в меню бар.

Документация: https://developer.wordpress.org/reference/hooks/add_admin_bar_menus/

wp_loaded

Этот крюк запускается после того, как WP, все плагины и тема полностью загружены(WordPress полностью загружен).

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp_loaded

Пример:

parse_request

(ref array)  Вызывается когда все переменные из HTTP заголовка для текущего запроса были обработаны.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/parse_request

Пример:

send_headers

(ref array)  Вызывается после отправки запрошенных HTTP-заголовков, например для кеширования, типа контента и т. д. Этот хук используется для добавления дополнительных заголовков к исходящему ответу HTTP.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/send_headers

Пример:

parse_query

(ref array) Выполняется после установки переменных запроса

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/parse_query

Пример:

pre_get_posts

Событие срабатывает перед каждым запросом WP_Query. До того, как был сделан запрос в базу. Используется для изменения запроса.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/pre_get_posts

Пример:

posts_selection

Вызывается перед запросом WP_Query в базу. Возвращает строку запроса, изменения которой на повлияет на сам запрос, данный хук в первую очередь создан для использования плагинов кеширования.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/posts_selection

Пример:

wp

Вызывается после установки объекта WP

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp

Пример:

template_redirect

Этот хук выполняется непосредственно перед тем, как WordPress определяет, какую страницу шаблона загрузить. Это хук хорошо использовать для переадресации, так как уже известны данные о станице которая должна открыться.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/template_redirect

Пример:

get_header

Выполняется до загрузки файла шаблона заголовка(header.php). С помощью данного хука можно выбрать другой файл шаблона для шапки(header.php) например new-header.php. Примечание. Этот хук лучше всего использовать для настройки и выполнения кода, который не будет отображаться в браузере. Хук передает имя конкретного файла заголовка для использования. Null для заголовка по умолчанию.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/get_header

Пример:

wp_enqueue_scripts

Это правильный хук, который следует использовать для подключения скриптов и стилей(не смотря на название).

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp_enqueue_scripts

Пример:

wp_head

Выводит скрипты или данные в теге head на фронтенде.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp_head

Пример:

wp_print_styles

С версии WordPress 3.3 не следует использовать

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp_print_styles

wp_print_scripts

С версии WordPress 3.3 не следует использовать

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp_print_scripts

get_search_form

Фильтрует вывод HTML формы поиска. Передает html формы поиска.

Документация: https://developer.wordpress.org/reference/hooks/get_search_form/

loop_start

(ref array) Вызывается после запуска цикла(основной цикл вордпресс).  Передает экземпляр WP_Query.

Документация: https://developer.wordpress.org/reference/hooks/loop_start/

the_post

(ref array) Позволяет разработчикам изменять пост-объект($post_object) сразу после запроса.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/the_post

Пример:

get_template_part_content

Запускается перед загрузкой указанного файла шаблона (в данном случае шаблонная часть для контента(content)).

Документация: https://developer.wordpress.org/reference/hooks/get_template_part_slug/

loop_end

Вызывается как только основной цикл вордпресс закончился. Хук передает WP_Query.

Документация: https://developer.wordpress.org/reference/hooks/loop_end/

get_sidebar

Выполняется до загрузки файла шаблона боковой панели(сайдбар). Хук позволяет использовать конкретный файл шаблона боковой панели(сайдбар) вместо стандартного sidebar.php. Если ваш файл называется sidebar-new.php, вы должны указать имя файла в hook как get_sidebar (‘new’). Хук передает имя конкретного файла боковой панели. Null для боковой панели по умолчанию.

Документация: https://developer.wordpress.org/reference/hooks/get_sidebar/

dynamic_sidebar

Это действие, вызывается при отображении динамической боковой панели и непосредственно перед вызовом функции отображения виджета. Этот хук предоставляет ассоциативный массив аргументов виджетов в качестве параметра.

Документация: https://developer.wordpress.org/reference/hooks/dynamic_sidebar/

get_search_form

Фильтрует вывод HTML формы поиска.

Документация: https://developer.wordpress.org/reference/hooks/get_search_form/

pre_get_comments

Вызывается до получения комментариев. Передает объект WP_Comment_Query.

Документация: https://developer.wordpress.org/reference/hooks/pre_get_comments/

wp_meta

Хук wp_meta создается путем вызова функции wp_meta () на боковых панелях(сайдбарах) темы и / или отдельными виджетами. Данный хук завит от шаблона(разработчик может не добавить).

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp_meta

Пример:

get_footer

Выполняется до загрузки шаблона подвала сайта(footer.php). Хук позволяет использовать не стандартный шаблон(footer.php) для подвала. Если ваш файл называется footer-new.php, вы должны указать имя файла в hook как get_footer (‘new’).

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/get_footer

Пример:

get_sidebar

Эта «боковая панель» является областью подвала (footer.php)

Документация: https://developer.wordpress.org/reference/hooks/get_sidebar/

wp_footer

Срабатывает перед закрывающимся тегом «</body>». Чаще всего используется для вывода скриптов и стилей.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp_footer

Пример:

wp_print_footer_scripts

Срабатывает при выводе скриптов в подвале сайта.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp_print_footer_scripts

admin_bar_menu

(ref array) Это хук, используемый для добавления, удаления или управления элементами панели администрирования(админ бар).

Документация: https://developer.wordpress.org/reference/hooks/admin_bar_menu/

wp_before_admin_bar_render

Вызывается до отображения панели администрирования. Можно добавить или удалить пункты меню.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp_before_admin_bar_render

Пример:

wp_after_admin_bar_render

Вызывается после отображения панели администрирования.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/wp_after_admin_bar_render

shutdown

Вызывается перед завершением всех действий PHP.

Документация: https://codex.wordpress.org/Plugin_API/Action_Reference/shutdown


Будь первым кто прокомментирует статью.

Добавить комментарий

Войти с помощью: