WP Crontrol

Часто задаваемые вопросы

Этот плагин работает с PHP 8?

Да, он активно тестируется и работает вплоть до PHP 8.4.

Я получаю ошибку «Возникла проблема при запуске обращения к системе WP-Cron на вашем сайте». Как это исправить?

Вы можете прочитать всё о проблемах с запуском WP-Cron на сайте WP Crontrol.

Почему некоторые cron события не выполняются в соответствии с расписанием?

Вы можете прочитать всё о просроченных событиях cron на сайте WP Crontrol.

Почему некоторые события cron снова появляются вскоре после того, как я их удаляю?

Если событие добавлено плагином, то, скорее всего, плагин заново запланировал его, как только заметил, что событие отсутствует. Чтобы обойти это поведение, вместо этого можно использовать действие «Приостановить этот хук» — тогда он останется на месте, но не будет выполнять никаких действий при срабатывании.

Безопасно ли удалять cron события?

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

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

Почему я не могу удалить некоторые cron события?

Ядро WordPress использует события cron для выполнения некоторых своих функций, и удалить эти события невозможно, потому что WordPress сразу же запланирует их заново, если вы всё-таки их удалите. По этой причине WP Crontrol изначально не позволяет удалять эти события из ядра WordPress.

Чтобы отменить запуск этих событий, используйте действие «Приостановить этот хук».

Что происходит, когда я приостанавливаю событие?

Приостановка события отключит все коллбэки, привязанные к его хуку. Само событие останется на месте и будет выполняться по своему расписанию, но все коллбеки, привязанные к его хуку, будут отключены. Из-за этого событие станет фактически неработоспособным, хотя и останется в расписании, чтобы сохранить полную совместимость с событиями, которые в противном случае автоматически переназначались бы при их отсутствии.

Так как при приостановке события фактически приостанавливается его хук, все события, использующие тот же хук, будут приостановлены/возобновлены при приостановке/возобновлении этого события. Это гораздо полезнее и надёжнее, чем приостанавливать отдельные события по отдельности.

Что происходит, когда я возобновляю событие?

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

Что значит, когда для действия cron события указано «Отсутствует»?

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

Вы можете ознакомиться со всеми событиями без действий на сайте WP Crontrol.

Как изменить время следующего запуска или расписание события cron?

Вы можете изменить время и расписание события cron, щёлкнув ссылку «Изменить» рядом с событием.

Почему изменения, которые я вношу в некоторые cron события, не сохраняются?

Вы можете прочитать всё о проблемах с редактированием событий cron на сайте WP Crontrol.

Можно ли экспортировать список cron событий?

Да, CSV-файл со списком событий можно экспортировать и скачать с помощью кнопки «Экспорт» на экране списка событий cron. Этот файл можно открыть в любом табличном редакторе.

Могу ли я посмотреть исторический журнал всех событий cron, которые выполнялись на моём сайте?

Да. Откройте Cron → Cron журналы и включите запись в журнал для нужных событий или воспользуйтесь ссылкой «Включить запись в журнал» рядом с событием на экране «Cron события». По умолчанию запись отключена. Для каждого запуска записываемого события сохраняются длительность, ошибки и предупреждения, HTTP-запросы, отправленные письма и запросы к базе данных. Записи хранятся 30 дней, но не более 10 000 на сайт. Аргументы событий не сохраняются, а строки запросов из записанных HTTP-запросов удаляются.

На экране Cron → Cron аналитика показано, когда запланированы события на бл��жайшую неделю, и ошибки за последние семь дней.

Могу ли я просмотреть журнал изменений, добавлений и удалений событий и расписаний cron?

Да. Отличный плагин Simple History имеет встроенную поддержку ведения журнала действий, выполняемых через WP Crontrol.

Зачем добавлять новые cron расписания?

Расписания cron используются ядром WordPress и плагинами для планирования событий, которые должны выполняться через регулярные промежутки времени. Чтобы их можно было использовать, интервалы должны быть предусмотрены ядром WordPress или плагином. Например, многие плагины для резервного копирования поддерживают периодическое создание резервных копий. Чтобы выполнять резервное копирование раз в неделю, сначала в WP Crontrol нужно добавить еженедельное расписание cron, после чего плагин резервного копирования сможет использовать его как интервал.

Как создать новое cron событие?

Чтобы настроить работающее cron-событие, которое будет выполняться регулярно, нужно выполнить два шага. Первый — сообщить WordPress о хуке. Именно для этого и был создан WP Crontrol. Второй шаг — вызов функции в момент, когда ваш хук выполняется.

Шаг первый: Добавление события

В меню Инструменты → Cron события щёлкните по «Добавить cron событие». Заполните данные события. Лучше всего использовать такое название хука, которое соответствует обычным правилам именования переменных в PHP. Расписание определяет, как часто будет выполняться событие. Если вы не видите подходящего интервала, ��обавьте его в меню Cron → Cron расписания.

Шаг второй: Написание функции

Эту часть нужно поместить в PHP-код (например, в файл functions.php вашей темы). Чтобы выполнить ваш хук, WordPress запускает действие. Поэтому нам нужно указать WordPress, какую функцию следует выполнить при запуске этого действия. Следующая строка делает именно это:

add_action( 'my_hookname', 'my_function' );

Следующий шаг — написать вашу функцию. Вот простой пример:

function my_function() {
    wp_mail( 'hello@example.com', 'WP Crontrol', 'WP Crontrol rocks!' );
}

Как создать cron событие, которое запрашивает URL?

В меню Инструменты → Cron события щёлкните «Добавить cron событие». Выберите опцию «URL cron событие», заполните данные и нажмите кнопку «Добавить событие».

Вы можете узнать всё о возможностях и безопасности URL cron-событий на сайте WP Crontrol.

Как создать новое PHP cron событие?

В меню Инструменты → Cron события щёлкните по «Добавить cron событие». Выберите вариант «PHP cron-событие» и введите расписание и время следующего запуска. Расписание события определяет, как часто ваше событие будет выполняться. Если вы не видите подходящий интервал, добавьте его в меню Cron → Cron расписания. В области «PHP код» введите PHP-код, который должен выполняться при запуске вашего cron-события. Указывать открывающий тег PHP (<?php) не нужно.

Создание, редактирование и запуск PHP cron-событий строго регулируются политикой безопасности. Вы можете прочитать всё о возможностях и безопасности PHP cron-событий на сайте WP Crontrol.

Какие пользователи могут управлять событиями и расписаниями cron?

Управлять событиями cron и расписаниями могут только пользователи с возможностью manage_options. По умолчанию эта возможность есть только у администраторов.

Какие пользователи могут управлять PHP cron событиями? Является ли это потенциально опасным?

Только пользователи с возможностью edit_files могут управлять PHP-событиями cron. Это означает, что если пользователь не может редактировать файлы через административную область WordPress (то есть через редактор плагинов или редактор тем), то он также не может добавлять, редактировать или удалять PHP-событие cron в WP Crontrol. По умолчанию этой возможностью обладают только администраторы, а при включённом Multisite этой возможностью обладают только суперадминистраторы.

Если редактирование файлов отключено с помощью констант конфигурации DISALLOW_FILE_MODS или DISALLOW_FILE_EDIT, то ни у одного пользователя не будет возможности edit_files, а это значит, что добавление, редактирование или удаление PHP-события cron будет запрещено.

Таким образом, уровень доступа, необходимый для выполнения произвольного PHP-кода, не меняется при активированном WP Crontrol.

Если константа CRONTROL_DISALLOW_PHP_EVENTS определена и установлена в значение true, то PHP cron события будут полностью отключены. Все существующие PHP cron события сохранятся (и могут быть удалены, если это разрешено правами пользователя), но их PHP код не будет выполняться при запуске события, и никакие PHP cron события не смогут быть добавлены, отредактированы или запущены.

Вы можете прочитать всё о возможностях и безопасности PHP cron-событий на сайте WP Crontrol.

Можно ли вернуть WP Crontrol в меню «Инструменты»?

Да. WP Crontrol добавляет собственное меню Cron, а пункт «Инструменты → Cron события» продолжает работать. Чтобы убрать меню Cron, добавьте следующий код в обязательный плагин или файл functions.php вашей темы:

add_filter( 'crontrol/top_level_menu', '__return_false' );

Доступны ли какие-нибудь команды WP-CLI?

Команды cron, которые раньше входили в WP Crontrol, теперь являются частью самого WP-CLI. Подробнее см. в wp help cron.

Что произойдет когда я отключу плагин WP Crontrol?

Вы можете прочитать всё о том, что происходит при деактивации ��лагина, на сайте WP Crontrol.

Как я могу сообщить об ошибке безопасности?

Вы можете конфиденциально сообщить об уязвимости в WP Crontrol через вкладку Security в репозитории на GitHub. GitHub Security Advisory позволяет конфиденциально обсуждать проблемы безопасности и совместно работать над их устранением. Если уязвимость подтвердится, вас укажут как автора отчёта, а при необходимости уязвимости присвоят идентификатор CVE.

Не сообщайте о проблемах безопасности на форумах поддержки WordPress.org или по электронной почте. Спасибо.

Кто сделал фотографию, представленную в шапке плагина?

Фотография была сделана Майклом Пардо и является общественным достоянием.