Группа: WordPress. Самые используемые WordPress хуки (action) для плагинов. Топ-50+
В первой части я разобрал топ-100 WordPress функций и рассказал о методике, по которой я собирал данные (почитайте по ссылке).
В этой части входные данные всё те же, только я отобрал более 50 самых используемых вордпресс экшенов (add_action). И снова повторюсь — для познания мастерства плагиностроения под ВП вы должны знать эти хуки.
Их конечно огромное кол-во, но этот топ, в виде настольной книги, у вас быть обязан. Новичок (да и не только), часто сталкивается с ситуацией когда ему необходимо в определенный момент (событие) выполнить свой код — вордпресс actions для этих целей и созданы. Написать свой плагин новичку становится проще когда он знает что почитать и с чего начать.
В вордпресс есть некоторые динамические хуки — статистика по ним тут может быть не совсем верной или вовсе отсутствовать. Например такой хитрый хук состояний записи {old_status}_to_{new_status} — его и без этой таблицы вы обязаны знать.
| ActionИспользований | Codex | Developers | WP-Kama |
|---|---|---|---|
| wp_ajax_(action)(841) | |||
| init(700) | |||
| admin_init(506) | |||
| admin_notices(300) | |||
| admin_menu(297) | |||
| admin_enqueue_scripts(284) | |||
| load(247) | |||
| plugins_loaded(215) | |||
| wp_enqueue_scripts(183) | |||
| admin_head(157) | |||
| admin_print_styles(142) | |||
| wp_head(141) | |||
| wp_ajax_nopriv_(action)(134) | |||
| widgets_init(126) | — | ||
| wp_footer(113) | |||
| admin_footer(104) | |||
| admin_print_scripts(98) | |||
| wp(94) | |||
| save_post(77) | |||
| wp_loaded(67) | |||
| network_admin_notices(62) | |||
| after_setup_theme(61) | |||
| shutdown(60) | |||
| add_meta_boxes(53) | |||
| admin_print_footer_scripts(48) | — | ||
| all_admin_notices(47) | — | ||
| current_screen(45) | |||
| user_register(40) | |||
| update_option_(option) | — | ||
| admin_action_(action)(32) | — | ||
| edit_user_profile_update(31) | |||
| edit_user_profile(30) | |||
| network_admin_menu(29) | |||
| wp_login(29) | |||
| delete_user(28) | |||
| personal_options_update(27) | |||
| show_user_profile(26) | |||
| login_head(26) | |||
| admin_post_(action)(26) | |||
| delete_post(25) | |||
| transition_post_status(24) | — | ||
| wp_dashboard_setup(24) | |||
| wpmu_new_blog(24) | |||
| wp_print_scripts(21) | |||
| switch_theme(21) | |||
| customize_register(20) | |||
| login_form_(action)(19) | — | ||
| profile_update(18) | |||
| wp_logout(17) | |||
| comment_post(17) | |||
| rest_api_init(17) | — | ||
| save_post_(post_type)(17) | — | ||
| wp_before_admin_bar_render(16) | |||
| after_plugin_row_(plugin_file) | — | ||
И снова вопрос: много хуков вы из этого списка знали и использовали? И есть ли в этом списке интересные и полезные для вас открытия? — Что вот теперь вы этот хук точно примените.
Высказывайтесь в комментариях.
планировщик действий — фоновая обработка очереди заданий для WordPress | Планировщик действий
Очередь заданий WordPress с фоновой обработкой
Планировщик действий — это библиотека для запуска хука WordPress в будущем (или как можно скорее, в случае асинхронного действия). Каждый хук может быть запланирован с уникальными данными, чтобы обратные вызовы могли выполнять операции с этими данными. Хук также может быть запланирован для запуска в один или несколько раз.
Думайте об этом как о расширении до do_action() , который добавляет возможность откладывать и повторять хук.
Так уж получилось, что эта функция также создает надежную очередь заданий для фоновой обработки больших очередей задач в WordPress. Благодаря добавлению ведения журнала и интерфейса администрирования он также обеспечивает отслеживание ваших задач, выполняемых в фоновом режиме.
Проверенная в боях фоновая обработка
Каждый месяц планировщик действий обрабатывает миллионы платежей за подписки, веб-перехватчики для WooCommerce, а также электронные письма и другие события для ряда других плагинов.
Было замечено, что на действующих сайтах обрабатываются очереди, превышающие 50 000 заданий, и выполняются ресурсоемкие операции, такие как обработка платежей и создание заказов, в 10 одновременных очередях со скоростью более 10 000 действий в час без негативного влияния на нормальную работу сайта.
Все это возможно на инфраструктуре и сайтах WordPress вне контроля автора плагина.
Планировщик действийспециально разработан для распространения в плагинах (и темах) WordPress — доступ к серверу не требуется. Если вашему плагину требуется фоновая обработка, особенно больших наборов задач, вам может помочь планировщик действий.
Как это работает
Планировщик действий хранит имя хука, аргументы и запланированную дату для действия, которое должно быть запущено в будущем.
Планировщик будет пытаться запускаться каждую минуту, присоединяясь в качестве обратного вызова к хуку 'action_scheduler_run_schedule' , который планируется с помощью встроенной системы WordPress WP-Cron.
Раз в минуту он также проверяет хук 'shutdown' запросов администратора WP на наличие ожидающих действий, и если они есть, он инициирует очередь с помощью асинхронного запроса обратной связи.
При запуске планировщик действий будет проверять запланированные действия, срок выполнения которых совпадает или предшествует этому моменту времени, т. е. действия, запланированные для выполнения сейчас или когда-либо в прошлом. Действия, запланированные для асинхронного выполнения, то есть незапланированные, имеют нулевую дату, то есть они всегда будут выполняться независимо от того, когда происходит проверка.
Пакетная обработка фоновых заданий
Если есть действия, которые нужно обработать, планировщик действий выделит уникальную заявку на пакет из 25 действий и начнет обработку этого пакета. Процесс PHP, созданный для запуска пакета, затем продолжит обработку пакетов из 25 действий, пока не будет использовано 9 действий.0% доступной памяти или обрабатывается в течение 30 секунд.
В этот момент, если есть дополнительные действия для обработки, к сайту будет отправлен асинхронный циклический запрос для продолжения обработки действий в новом запросе.
Этот процесс и запросы замыкания на себя будут продолжаться до тех пор, пока не будут обработаны все действия.
Ведение домашнего хозяйства
Перед обработкой пакета планировщик удалит все существующие заявки на действия, которые находятся в очереди более пяти минут (или, точнее, в 10 раз больше разрешенного срока, который по умолчанию равен 30 секундам).
Планировщик действий также удалит все действия, которые были завершены или отменены более месяца назад.
Если действие выполняется более 5 минут, Планировщик действий будет считать, что время действия истекло, и помечает его как невыполненное. Однако, если все обратные вызовы, связанные с действием, будут успешно завершены через какое-то время после этого 5-минутного тайм-аута, его статус позже будет обновлен до завершенного.
Отслеживаемая фоновая обработка
Ваше фоновое задание выполнялось?
Никогда не оставайтесь в недоумении благодаря встроенному ведению записей планировщика действий.
Все события для каждого действия регистрируются в таблице actionscheduler_logs и отображаются в административном интерфейсе.
События, регистрируемые по умолчанию, включают действия:
- создано Запуск
- (включая сведения о том, как он был запущен, например, через WP CLI или WP Cron)
- завершает
- не удается
В случае сбоя с ошибкой, которую можно записать, эта ошибка будет записана в журнал и видна в административном интерфейсе, что позволит отследить, что пошло не так в какой-то момент в прошлом на сайте, к которому у вас не было доступа чтобы в прошлом.
Кредиты
Планировщик действий разработан и поддерживается людьми из Automattic, а значительная часть ранней разработки была завершена Flightless.
Сотрудничество — это круто. Мы будем рады работать с вами над улучшением планировщика действий. Пулл-реквесты приветствуются.
Actions — wpDataTables — Плагин для таблиц и диаграмм WordPress
Actions — wpDataTables — Плагин для таблиц и диаграмм WordPressДействия WordPress – это удобный способ «подключиться» к различным плагинам без изменения их кода. По сути, «действия» — это определяемые пользователем функции, назначенные определенным меткам, которые вызываются ядром плагина в определенные моменты его выполнения. В отличие от фильтров действия не возвращают никаких данных, они просто выполняются.
Вы можете узнать больше об использовании действий WordPress и назначении своих функций действиям в WordPress Codex. Здесь мы предоставим список действий, определенных в плагине wpDataTables, которые вы можете использовать, чтобы настроить его для своих нужд.
Это действие выполняется перед получением метаданных таблицы из базы данных (параметры таблицы, ссылка на файл или SQL-запрос).
Вы можете использовать его для вызова нужной вам функции или установки глобальной переменной.
Это действие выполняется перед получением метаданных столбцов из базы данных (настройки столбцов). Вы можете использовать его для вызова нужной вам функции или установки какой-либо глобальной переменной.
Это действие выполняется до начала рендеринга таблицы (с шорткодом или без него).
Это действие выполняется после того, как wpDataTables сохранит данные настроек (после того, как пользователь нажмет «Сохранить настройки» на странице настроек бэкенда).
Это действие выполняется после того, как wpDataTables сохранит данные таблицы (после того, как пользователь нажмет «Сохранить таблицу» на странице настроек бэкенда).
Это действие выполняется после того, как wpDataTables сохранит данные столбца (после того, как пользователь нажмет «Сохранить таблицу» на странице настроек бэкенда).
Это действие выполняется, когда страница настроек открыта в админке.
Это действие выполняется, когда пользователь открывает «Добавить новый wpDataTable» в админке.
Это действие выполняется, когда пользователь открывает страницу просмотра.
Это действие выполняется при первом сохранении новой таблицы: wpDataTables пытается сгенерировать таблицу на основе предоставленных данных и создает столбцы и таблицы в базе данных на основе результатов.
$type — тип таблицы (xls, csv, mysql, json, xml, php).
$content — это либо ссылка на файл источника данных, либо запрос MySQL.
Это действие выполняется перед сохранением данных столбца в базу данных (при нажатии кнопки Сохранить столбцы в панели администратора).
$table – это объект wpDataTable (источник класса/class.wpdatatable.php).
$tableId — идентификатор описания таблицы в MySQL.
$frontendColumns — это массив объектов, где каждый объект является столбцом из внешнего интерфейса.
Это действие выполняется после того, как новый столбец будет вставлен в базу данных (когда плагин впервые сгенерирует столбцы).
$columnConfig — это массив параметров столбца, загружаемых из базы данных.
$tableId — идентификатор таблицы из MySQL.
Это действие выполняется перед получением данных AJAX для таблиц обработки на стороне сервера.
$tableId — это идентификатор таблицы из таблицы MySQL.
Это действие выполняется перед началом визуализации диаграммы.
$chartId — это идентификатор таблицы из таблицы MySQL.
Это действие выполняется после применения действия редактирования.
$formdata — массив ключей и значений для редактирования.
$rowId — поле идентификатора строки в таблице MySQL, которая была отредактирована.
$tableId — это идентификатор таблицы из таблицы плагинов MySQL (wp_wpdatatables).
Это действие вызывается перед удалением строки из внешнего редактора.
$rowId — значение столбца ID.
$tableId — это идентификатор таблицы из таблицы wp_wpdatatables.
Это действие вызывается перед отображением формы фильтрации на странице.
$tableId — это идентификатор таблицы из таблицы wp_wpdatatables.
Это действие вызывается после отображения формы фильтрации на странице.
$tableId — это идентификатор таблицы из таблицы wp_wpdatatables.
Это действие вызывается перед отображением самой таблицы на странице.
$tableId — это идентификатор таблицы из таблицы wp_wpdatatables.
Это действие вызывается после отображения таблицы на странице.
$tableId — это идентификатор таблицы из таблицы wp_wpdatatables.
Это действие вызывается перед отображением первой строки таблицы на странице.
$tableId — это идентификатор таблицы из таблицы wp_wpdatatables.
Это действие вызывается перед отображением строки таблицы на странице.
$tableId — это идентификатор таблицы из таблицы wp_wpdatatables.
$rowIndex — индекс строки, начинающийся с нуля.
Это действие вызывается после отображения строки таблицы на странице.
$tableId — это идентификатор таблицы из таблицы wp_wpdatatables.