$plugin_meta An array of the plugin row's meta data. * @param string $plugin_file Path to the plugin file relative to the plugins directory. * @return array An array of the plugin row's meta data. */ function filter_plugin_row_meta( array $plugin_meta, $plugin_file ) { if ( 'wp-crontrol/wp-crontrol.php' !== $plugin_file ) { return $plugin_meta; } $plugin_meta[] = sprintf( '%2$s', 'https://github.com/sponsors/johnbillion', esc_html_x( 'Sponsor', 'verb', 'wp-crontrol' ) ); return $plugin_meta; } /** * Run using the 'init' action. * * @return void */ function action_init() { load_plugin_textdomain( 'wp-crontrol', false, dirname( plugin_basename( PLUGIN_FILE ) ) . '/languages' ); /** @var array|false $paused */ $paused = get_option( PAUSED_OPTION ); if ( ! is_array( $paused ) ) { $paused = array(); update_option( PAUSED_OPTION, $paused, true ); } foreach ( $paused as $hook => $value ) { if ( ! is_string( $hook ) ) { continue; } add_action( $hook, __NAMESPACE__ . '\\pauser', -99999, 0 ); } } /** * @return void */ function pauser() { remove_all_actions( current_filter() ); } /** * Handles any POSTs and GETs made by the plugin. Run using the 'init' action. * * @return void */ function action_handle_posts() { $request = new Request(); if ( isset( $_POST['crontrol_action'] ) && ( 'new_cron' === $_POST['crontrol_action'] ) ) { if ( ! current_user_can( 'manage_options' ) ) { wp_die( esc_html__( 'You are not allowed to add new cron events.', 'wp-crontrol' ), 401 ); } check_admin_referer( 'crontrol-new-cron' ); $cr = $request->init( wp_unslash( $_POST ) ); if ( 'crontrol_cron_job' === $cr->hookname ) { wp_die( esc_html__( 'You are not allowed to add new PHP cron events.', 'wp-crontrol' ), 401 ); } $args = json_decode( $cr->args, true ); if ( empty( $args ) || ! is_array( $args ) ) { $args = array(); } $next_run_local = ( 'custom' === $cr->next_run_date_local ) ? $cr->next_run_date_local_custom_date . ' ' . $cr->next_run_date_local_custom_time : $cr->next_run_date_local; add_filter( 'schedule_event', function( $event ) { if ( ! $event ) { return $event; } /** * Fires after a new cron event is added. * * @param stdClass $event { * An object containing the event's data. * * @type string $hook Action hook to execute when the event is run. * @type int $timestamp Unix timestamp (UTC) for when to next run the event. * @type string|false $schedule How often the event should subsequently recur. * @type mixed[] $args Array containing each separate argument to pass to the hook's callback function. * @type int $interval The interval time in seconds for the schedule. Only present for recurring events. * } */ do_action( 'crontrol/added_new_event', $event ); return $event; }, 99 ); $added = Event\add( $next_run_local, $cr->schedule, $cr->hookname, $args ); $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_message' => '5', 'crontrol_name' => rawurlencode( $cr->hookname ), ); if ( is_wp_error( $added ) ) { set_message( $added->get_error_message() ); $redirect['crontrol_message'] = 'error'; } wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } elseif ( isset( $_POST['crontrol_action'] ) && ( 'new_php_cron' === $_POST['crontrol_action'] ) ) { if ( ! current_user_can( 'edit_files' ) ) { wp_die( esc_html__( 'You are not allowed to add new PHP cron events.', 'wp-crontrol' ), 401 ); } check_admin_referer( 'crontrol-new-cron' ); $cr = $request->init( wp_unslash( $_POST ) ); $next_run_local = ( 'custom' === $cr->next_run_date_local ) ? $cr->next_run_date_local_custom_date . ' ' . $cr->next_run_date_local_custom_time : $cr->next_run_date_local; $args = array( array( 'code' => $cr->hookcode, 'name' => $cr->eventname, 'hash' => wp_hash( $cr->hookcode ), ), ); add_filter( 'schedule_event', function( $event ) { if ( ! $event ) { return $event; } /** * Fires after a new PHP cron event is added. * * @param stdClass $event { * An object containing the event's data. * * @type string $hook Action hook to execute when the event is run. * @type int $timestamp Unix timestamp (UTC) for when to next run the event. * @type string|false $schedule How often the event should subsequently recur. * @type mixed[] $args Array containing each separate argument to pass to the hook's callback function. * @type int $interval The interval time in seconds for the schedule. Only present for recurring events. * } */ do_action( 'crontrol/added_new_php_event', $event ); return $event; }, 99 ); $added = Event\add( $next_run_local, $cr->schedule, 'crontrol_cron_job', $args ); $hookname = ( ! empty( $cr->eventname ) ) ? $cr->eventname : __( 'PHP Cron', 'wp-crontrol' ); $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_message' => '5', 'crontrol_name' => rawurlencode( $hookname ), ); if ( is_wp_error( $added ) ) { set_message( $added->get_error_message() ); $redirect['crontrol_message'] = 'error'; } wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } elseif ( isset( $_POST['crontrol_action'] ) && ( 'edit_cron' === $_POST['crontrol_action'] ) ) { if ( ! current_user_can( 'manage_options' ) ) { wp_die( esc_html__( 'You are not allowed to edit cron events.', 'wp-crontrol' ), 401 ); } $cr = $request->init( wp_unslash( $_POST ) ); check_admin_referer( "crontrol-edit-cron_{$cr->original_hookname}_{$cr->original_sig}_{$cr->original_next_run_utc}" ); if ( 'crontrol_cron_job' === $cr->hookname && ! current_user_can( 'edit_files' ) ) { wp_die( esc_html__( 'You are not allowed to edit PHP cron events.', 'wp-crontrol' ), 401 ); } $args = json_decode( $cr->args, true ); if ( empty( $args ) || ! is_array( $args ) ) { $args = array(); } $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_message' => '4', 'crontrol_name' => rawurlencode( $cr->hookname ), ); $original = Event\get_single( $cr->original_hookname, $cr->original_sig, $cr->original_next_run_utc ); if ( is_wp_error( $original ) ) { set_message( $original->get_error_message() ); $redirect['crontrol_message'] = 'error'; wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } $deleted = Event\delete( $cr->original_hookname, $cr->original_sig, $cr->original_next_run_utc ); if ( is_wp_error( $deleted ) ) { set_message( $deleted->get_error_message() ); $redirect['crontrol_message'] = 'error'; wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } $next_run_local = ( 'custom' === $cr->next_run_date_local ) ? $cr->next_run_date_local_custom_date . ' ' . $cr->next_run_date_local_custom_time : $cr->next_run_date_local; /** * Modifies an event before it is scheduled. * * @param stdClass|false $event An object containing the new event's data, or boolean false. */ add_filter( 'schedule_event', function( $event ) use ( $original ) { if ( ! $event ) { return $event; } /** * Fires after a cron event is edited. * * @param stdClass $event { * An object containing the new event's data. * * @type string $hook Action hook to execute when the event is run. * @type int $timestamp Unix timestamp (UTC) for when to next run the event. * @type string|false $schedule How often the event should subsequently recur. * @type mixed[] $args Array containing each separate argument to pass to the hook's callback function. * @type int $interval The interval time in seconds for the schedule. Only present for recurring events. * } * @param stdClass $original { * An object containing the original event's data. * * @type string $hook Action hook to execute when the event is run. * @type int $timestamp Unix timestamp (UTC) for when to next run the event. * @type string|false $schedule How often the event should subsequently recur. * @type mixed[] $args Array containing each separate argument to pass to the hook's callback function. * @type int $interval The interval time in seconds for the schedule. Only present for recurring events. * } */ do_action( 'crontrol/edited_event', $event, $original ); return $event; }, 99 ); $added = Event\add( $next_run_local, $cr->schedule, $cr->hookname, $args ); if ( is_wp_error( $added ) ) { set_message( $added->get_error_message() ); $redirect['crontrol_message'] = 'error'; } wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } elseif ( isset( $_POST['crontrol_action'] ) && ( 'edit_php_cron' === $_POST['crontrol_action'] ) ) { if ( ! current_user_can( 'edit_files' ) ) { wp_die( esc_html__( 'You are not allowed to edit PHP cron events.', 'wp-crontrol' ), 401 ); } $cr = $request->init( wp_unslash( $_POST ) ); check_admin_referer( "crontrol-edit-cron_{$cr->original_hookname}_{$cr->original_sig}_{$cr->original_next_run_utc}" ); $args = array( array( 'code' => $cr->hookcode, 'name' => $cr->eventname, 'hash' => wp_hash( $cr->hookcode ), ), ); $hookname = ( ! empty( $cr->eventname ) ) ? $cr->eventname : __( 'PHP Cron', 'wp-crontrol' ); $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_message' => '4', 'crontrol_name' => rawurlencode( $hookname ), ); $original = Event\get_single( $cr->original_hookname, $cr->original_sig, $cr->original_next_run_utc ); if ( is_wp_error( $original ) ) { set_message( $original->get_error_message() ); $redirect['crontrol_message'] = 'error'; wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } $deleted = Event\delete( $cr->original_hookname, $cr->original_sig, $cr->original_next_run_utc ); if ( is_wp_error( $deleted ) ) { set_message( $deleted->get_error_message() ); $redirect['crontrol_message'] = 'error'; wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } $next_run_local = ( 'custom' === $cr->next_run_date_local ) ? $cr->next_run_date_local_custom_date . ' ' . $cr->next_run_date_local_custom_time : $cr->next_run_date_local; /** * Modifies an event before it is scheduled. * * @param stdClass|false $event An object containing the new event's data, or boolean false. */ add_filter( 'schedule_event', function( $event ) use ( $original ) { if ( ! $event ) { return $event; } /** * Fires after a PHP cron event is edited. * * @param stdClass $event { * An object containing the new event's data. * * @type string $hook Action hook to execute when the event is run. * @type int $timestamp Unix timestamp (UTC) for when to next run the event. * @type string|false $schedule How often the event should subsequently recur. * @type mixed[] $args Array containing each separate argument to pass to the hook's callback function. * @type int $interval The interval time in seconds for the schedule. Only present for recurring events. * } * @param stdClass $original { * An object containing the original event's data. * * @type string $hook Action hook to execute when the event is run. * @type int $timestamp Unix timestamp (UTC) for when to next run the event. * @type string|false $schedule How often the event should subsequently recur. * @type mixed[] $args Array containing each separate argument to pass to the hook's callback function. * @type int $interval The interval time in seconds for the schedule. Only present for recurring events. * } */ do_action( 'crontrol/edited_php_event', $event, $original ); return $event; }, 99 ); $added = Event\add( $next_run_local, $cr->schedule, 'crontrol_cron_job', $args ); if ( is_wp_error( $added ) ) { set_message( $added->get_error_message() ); $redirect['crontrol_message'] = 'error'; } wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } elseif ( isset( $_POST['crontrol_new_schedule'] ) ) { if ( ! current_user_can( 'manage_options' ) ) { wp_die( esc_html__( 'You are not allowed to add new cron schedules.', 'wp-crontrol' ), 401 ); } check_admin_referer( 'crontrol-new-schedule' ); $name = wp_unslash( $_POST['crontrol_schedule_internal_name'] ); $interval = absint( $_POST['crontrol_schedule_interval'] ); $display = wp_unslash( $_POST['crontrol_schedule_display_name'] ); Schedule\add( $name, $interval, $display ); $redirect = array( 'page' => 'crontrol_admin_options_page', 'crontrol_message' => '3', 'crontrol_name' => rawurlencode( $name ), ); wp_safe_redirect( add_query_arg( $redirect, admin_url( 'options-general.php' ) ) ); exit; } elseif ( isset( $_GET['crontrol_action'] ) && 'delete-schedule' === $_GET['crontrol_action'] ) { if ( ! current_user_can( 'manage_options' ) ) { wp_die( esc_html__( 'You are not allowed to delete cron schedules.', 'wp-crontrol' ), 401 ); } $schedule = wp_unslash( $_GET['crontrol_id'] ); check_admin_referer( "crontrol-delete-schedule_{$schedule}" ); Schedule\delete( $schedule ); $redirect = array( 'page' => 'crontrol_admin_options_page', 'crontrol_message' => '2', 'crontrol_name' => rawurlencode( $schedule ), ); wp_safe_redirect( add_query_arg( $redirect, admin_url( 'options-general.php' ) ) ); exit; } elseif ( ( isset( $_POST['action'] ) && 'crontrol_delete_crons' === $_POST['action'] ) || ( isset( $_POST['action2'] ) && 'crontrol_delete_crons' === $_POST['action2'] ) ) { if ( ! current_user_can( 'manage_options' ) ) { wp_die( esc_html__( 'You are not allowed to delete cron events.', 'wp-crontrol' ), 401 ); } check_admin_referer( 'bulk-crontrol-events' ); if ( empty( $_POST['crontrol_delete'] ) ) { return; } /** * @var array> */ $delete = (array) wp_unslash( $_POST['crontrol_delete'] ); $deleted = 0; foreach ( $delete as $next_run_utc => $events ) { foreach ( (array) $events as $hook => $sig ) { if ( 'crontrol_cron_job' === $hook && ! current_user_can( 'edit_files' ) ) { continue; } $event = Event\get_single( urldecode( $hook ), $sig, $next_run_utc ); $deleted = Event\delete( urldecode( $hook ), $sig, $next_run_utc ); if ( ! is_wp_error( $deleted ) ) { $deleted++; /** This action is documented in wp-crontrol.php */ do_action( 'crontrol/deleted_event', $event ); } } } $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_name' => $deleted, 'crontrol_message' => '9', ); wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } elseif ( isset( $_GET['crontrol_action'] ) && 'delete-cron' === $_GET['crontrol_action'] ) { if ( ! current_user_can( 'manage_options' ) ) { wp_die( esc_html__( 'You are not allowed to delete cron events.', 'wp-crontrol' ), 401 ); } $hook = wp_unslash( $_GET['crontrol_id'] ); $sig = wp_unslash( $_GET['crontrol_sig'] ); $next_run_utc = wp_unslash( $_GET['crontrol_next_run_utc'] ); check_admin_referer( "crontrol-delete-cron_{$hook}_{$sig}_{$next_run_utc}" ); if ( 'crontrol_cron_job' === $hook && ! current_user_can( 'edit_files' ) ) { wp_die( esc_html__( 'You are not allowed to delete PHP cron events.', 'wp-crontrol' ), 401 ); } $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_message' => '6', 'crontrol_name' => rawurlencode( $hook ), ); $event = Event\get_single( $hook, $sig, $next_run_utc ); if ( is_wp_error( $event ) ) { set_message( $event->get_error_message() ); $redirect['crontrol_message'] = 'error'; wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } $deleted = Event\delete( $hook, $sig, $next_run_utc ); if ( is_wp_error( $deleted ) ) { set_message( $deleted->get_error_message() ); $redirect['crontrol_message'] = 'error'; } else { /** * Fires after a cron event is deleted. * * @param stdClass $event { * An object containing the event's data. * * @type string $hook Action hook to execute when the event is run. * @type int $timestamp Unix timestamp (UTC) for when to next run the event. * @type string|false $schedule How often the event should subsequently recur. * @type mixed[] $args Array containing each separate argument to pass to the hook's callback function. * @type int $interval The interval time in seconds for the schedule. Only present for recurring events. * } */ do_action( 'crontrol/deleted_event', $event ); } wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } elseif ( isset( $_GET['crontrol_action'] ) && 'delete-hook' === $_GET['crontrol_action'] ) { if ( ! current_user_can( 'manage_options' ) ) { wp_die( esc_html__( 'You are not allowed to delete cron events.', 'wp-crontrol' ), 401 ); } $hook = wp_unslash( $_GET['crontrol_id'] ); $deleted = false; check_admin_referer( "crontrol-delete-hook_{$hook}" ); if ( 'crontrol_cron_job' === $hook ) { wp_die( esc_html__( 'You are not allowed to delete PHP cron events.', 'wp-crontrol' ), 401 ); } if ( function_exists( 'wp_unschedule_hook' ) ) { /** @var int|false */ $deleted = wp_unschedule_hook( $hook ); } if ( 0 === $deleted ) { $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_message' => '3', 'crontrol_name' => rawurlencode( $hook ), ); wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } elseif ( $deleted ) { /** * Fires after all cron events with the given hook are deleted. * * @param string $hook The hook name. * @param int $deleted The number of events that were deleted. */ do_action( 'crontrol/deleted_all_with_hook', $hook, $deleted ); $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_message' => '2', 'crontrol_name' => rawurlencode( $hook ), ); wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } else { $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_message' => '7', 'crontrol_name' => rawurlencode( $hook ), ); wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } } elseif ( isset( $_GET['crontrol_action'] ) && 'run-cron' === $_GET['crontrol_action'] ) { if ( ! current_user_can( 'manage_options' ) ) { wp_die( esc_html__( 'You are not allowed to run cron events.', 'wp-crontrol' ), 401 ); } $hook = wp_unslash( $_GET['crontrol_id'] ); $sig = wp_unslash( $_GET['crontrol_sig'] ); check_admin_referer( "crontrol-run-cron_{$hook}_{$sig}" ); $ran = Event\run( $hook, $sig ); $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_message' => '1', 'crontrol_name' => rawurlencode( $hook ), ); if ( is_wp_error( $ran ) ) { $set = set_message( $ran->get_error_message() ); // If we can't store the error message in a transient, just display it. if ( ! $set ) { wp_die( esc_html( $ran->get_error_message() ), '', array( 'response' => 500, 'back_link' => true, ) ); } $redirect['crontrol_message'] = 'error'; } wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } elseif ( isset( $_GET['crontrol_action'] ) && 'pause-hook' === $_GET['crontrol_action'] ) { if ( ! current_user_can( 'manage_options' ) ) { wp_die( esc_html__( 'You are not allowed to pause or resume cron events.', 'wp-crontrol' ), 401 ); } $hook = wp_unslash( $_GET['crontrol_id'] ); if ( 'crontrol_cron_job' === $hook ) { wp_die( esc_html__( 'You are not allowed to pause or resume cron events.', 'wp-crontrol' ), 401 ); } check_admin_referer( "crontrol-pause-hook_{$hook}" ); $paused = Event\pause( $hook ); $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_message' => '11', 'crontrol_name' => rawurlencode( $hook ), ); if ( is_wp_error( $paused ) ) { $set = set_message( $paused->get_error_message() ); // If we can't store the error message in a transient, just display it. if ( ! $set ) { wp_die( esc_html( $paused->get_error_message() ), '', array( 'response' => 500, 'back_link' => true, ) ); } $redirect['crontrol_message'] = 'error'; } else { /** * Fires after a cron event hook is paused. * * @param string $hook The event hook name. */ do_action( 'crontrol/paused_hook', $hook ); } wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } elseif ( isset( $_GET['crontrol_action'] ) && 'resume-hook' === $_GET['crontrol_action'] ) { if ( ! current_user_can( 'manage_options' ) ) { wp_die( esc_html__( 'You are not allowed to pause or resume cron events.', 'wp-crontrol' ), 401 ); } $hook = wp_unslash( $_GET['crontrol_id'] ); if ( 'crontrol_cron_job' === $hook ) { wp_die( esc_html__( 'You are not allowed to pause or resume cron events.', 'wp-crontrol' ), 401 ); } check_admin_referer( "crontrol-resume-hook_{$hook}" ); $resumed = Event\resume( $hook ); $redirect = array( 'page' => 'crontrol_admin_manage_page', 'crontrol_message' => '12', 'crontrol_name' => rawurlencode( $hook ), ); if ( is_wp_error( $resumed ) ) { $set = set_message( $resumed->get_error_message() ); // If we can't store the error message in a transient, just display it. if ( ! $set ) { wp_die( esc_html( $resumed->get_error_message() ), '', array( 'response' => 500, 'back_link' => true, ) ); } $redirect['crontrol_message'] = 'error'; } else { /** * Fires after a paused cron event hook is resumed. * * @param string $hook The event hook name. */ do_action( 'crontrol/resumed_hook', $hook ); } wp_safe_redirect( add_query_arg( $redirect, admin_url( 'tools.php' ) ) ); exit; } elseif ( isset( $_POST['crontrol_action'] ) && 'export-event-csv' === $_POST['crontrol_action'] ) { check_admin_referer( 'crontrol-export-event-csv', 'crontrol_nonce' ); $type = isset( $_POST['crontrol_hooks_type'] ) ? $_POST['crontrol_hooks_type'] : 'all'; $headers = array( 'hook', 'arguments', 'next_run', 'next_run_gmt', 'action', 'recurrence', 'interval', ); $filename = sprintf( 'cron-events-%s-%s.csv', $type, gmdate( 'Y-m-d-H.i.s' ) ); $csv = fopen( 'php://output', 'w' ); if ( false === $csv ) { wp_die( esc_html__( 'Could not save CSV file.', 'wp-crontrol' ) ); } $events = Table::get_filtered_events( Event\get() ); header( 'Content-Type: text/csv; charset=utf-8' ); header( sprintf( 'Content-Disposition: attachment; filename="%s"', esc_attr( $filename ) ) ); fputcsv( $csv, $headers ); if ( isset( $events[ $type ] ) ) { foreach ( $events[ $type ] as $event ) { $next_run_local = get_date_from_gmt( gmdate( 'Y-m-d H:i:s', $event->timestamp ), 'c' ); $next_run_utc = gmdate( 'c', $event->timestamp ); $hook_callbacks = \Crontrol\get_hook_callbacks( $event->hook ); if ( 'crontrol_cron_job' === $event->hook ) { $args = __( 'PHP Code', 'wp-crontrol' ); } elseif ( empty( $event->args ) ) { $args = ''; } else { $args = \Crontrol\json_output( $event->args, false ); } if ( 'crontrol_cron_job' === $event->hook ) { $action = 'WP Crontrol'; } else { $callbacks = array(); foreach ( $hook_callbacks as $callback ) { $callbacks[] = $callback['callback']['name']; } $action = implode( ',', $callbacks ); } if ( $event->schedule ) { $recurrence = Event\get_schedule_name( $event ); if ( is_wp_error( $recurrence ) ) { $recurrence = $recurrence->get_error_message(); } } else { $recurrence = __( 'Non-repeating', 'wp-crontrol' ); } $row = array( $event->hook, $args, $next_run_local, $next_run_utc, $action, $recurrence, (int) $event->interval, ); fputcsv( $csv, $row ); } } fclose( $csv ); exit; } } /** * Adds options & management pages to the admin menu. * * Run using the 'admin_menu' action. * * @return void */ function action_admin_menu() { $schedules = add_options_page( esc_html__( 'Cron Schedules', 'wp-crontrol' ), esc_html__( 'Cron Schedules', 'wp-crontrol' ), 'manage_options', 'crontrol_admin_options_page', __NAMESPACE__ . '\admin_options_page' ); $events = add_management_page( esc_html__( 'Cron Events', 'wp-crontrol' ), esc_html__( 'Cron Events', 'wp-crontrol' ), 'manage_options', 'crontrol_admin_manage_page', __NAMESPACE__ . '\admin_manage_page' ); add_action( "load-{$schedules}", __NAMESPACE__ . '\admin_help_tab' ); add_action( "load-{$events}", __NAMESPACE__ . '\admin_help_tab' ); } /** * Adds a Help tab with links to help resources. * * @return void */ function admin_help_tab() { $screen = get_current_screen(); if ( ! $screen ) { return; } $content = '

' . esc_html__( 'There are several places to get help with issues relating to WP-Cron:', 'wp-crontrol' ) . '

'; $content .= '
    '; $content .= '
  • '; $content .= wp_kses( sprintf( /* translators: 1: URL to the documentation, 2: WP Crontrol */ __( 'Read the %2$s website which contains information about events that have missed their schedule, problems with spawning a call to the WP-Cron system, and much more.', 'wp-crontrol' ), 'https://wp-crontrol.com', 'WP Crontrol' ), array( 'a' => array( 'href' => array(), ), ) ); $content .= '
    • '; $content .= '
  • '; $content .= wp_kses( sprintf( /* translators: %s: URL to the documentation */ __( 'Read the Frequently Asked Questions (FAQ) which cover many common questions and answers.', 'wp-crontrol' ), 'https://wordpress.org/plugins/wp-crontrol/faq/' ), array( 'a' => array( 'href' => array(), ), ) ); $content .= '
    • '; $content .= '
  • '; $content .= wp_kses( sprintf( /* translators: %s: URL to the documentation */ __( 'Read the WordPress.org documentation on WP-Cron for more technical details about the WP-Cron system for developers.', 'wp-crontrol' ), 'https://developer.wordpress.org/plugins/cron/' ), array( 'a' => array( 'href' => array(), ), ) ); $content .= '
'; $screen->add_help_tab( array( 'id' => 'crontrol-help', 'title' => __( 'Help', 'wp-crontrol' ), 'content' => $content, ) ); } /** * Adds items to the plugin's action links on the Plugins listing screen. * * @param array $actions Array of action links. * @param string $plugin_file Path to the plugin file relative to the plugins directory. * @param mixed[] $plugin_data An array of plugin data. * @param string $context The plugin context. * @return array Array of action links. */ function plugin_action_links( $actions, $plugin_file, $plugin_data, $context ) { $new = array( 'crontrol-events' => sprintf( '%s', esc_url( admin_url( 'tools.php?page=crontrol_admin_manage_page' ) ), esc_html__( 'Events', 'wp-crontrol' ) ), 'crontrol-schedules' => sprintf( '%s', esc_url( admin_url( 'options-general.php?page=crontrol_admin_options_page' ) ), esc_html__( 'Schedules', 'wp-crontrol' ) ), 'crontrol-help' => sprintf( '%s', 'https://wp-crontrol.com', esc_html__( 'Help', 'wp-crontrol' ) ), ); return array_merge( $new, $actions ); } /** * Adds items to the plugin's action links on the Network Admin -> Plugins listing screen. * * @param array $actions Array of action links. * @return array Array of action links. */ function network_plugin_action_links( $actions ) { $new = array( 'crontrol-help' => sprintf( '%s', 'https://wp-crontrol.com', esc_html__( 'Help', 'wp-crontrol' ) ), ); return array_merge( $new, $actions ); } /** * Gives WordPress the plugin's set of cron schedules. * * Called by the `cron_schedules` filter. * * @param array> $scheds Array of cron schedule arrays. Usually empty. * @return array> Array of modified cron schedule arrays. */ function filter_cron_schedules( array $scheds ) { $new_scheds = get_option( 'crontrol_schedules', array() ); if ( ! is_array( $new_scheds ) ) { return $scheds; } return array_merge( $new_scheds, $scheds ); } /** * Displays the options page for the plugin. * * @return void */ function admin_options_page() { $messages = array( '2' => array( /* translators: %s: The name of the cron schedule. */ __( 'Deleted the cron schedule %s.', 'wp-crontrol' ), 'success', ), '3' => array( /* translators: %s: The name of the cron schedule. */ __( 'Added the cron schedule %s.', 'wp-crontrol' ), 'success', ), ); if ( isset( $_GET['crontrol_message'] ) && isset( $_GET['crontrol_name'] ) && isset( $messages[ $_GET['crontrol_message'] ] ) ) { $hook = wp_unslash( $_GET['crontrol_name'] ); $message = wp_unslash( $_GET['crontrol_message'] ); printf( '

%2$s

', esc_attr( $messages[ $message ][1] ), sprintf( esc_html( $messages[ $message ][0] ), '' . esc_html( $hook ) . '' ) ); } $table = new Schedule_List_Table(); $table->prepare_items(); ?>

views(); ?>

display(); ?>
'Cavalcade', '\Automattic\WP\Cron_Control\Main' => 'Cron Control', ); foreach ( $cron_runner_plugins as $class => $plugin ) { if ( class_exists( $class ) ) { return new WP_Error( 'crontrol_info', sprintf( /* translators: %s: The name of the plugin that controls the running of cron events. */ __( 'WP-Cron spawning is being managed by the %s plugin.', 'wp-crontrol' ), $plugin ) ); } } if ( defined( 'DISABLE_WP_CRON' ) && DISABLE_WP_CRON ) { return new WP_Error( 'crontrol_info', sprintf( /* translators: %s: The name of the PHP constant that is set. */ __( 'The %s constant is set to true. WP-Cron spawning is disabled.', 'wp-crontrol' ), 'DISABLE_WP_CRON' ) ); } if ( defined( 'ALTERNATE_WP_CRON' ) && ALTERNATE_WP_CRON ) { return new WP_Error( 'crontrol_info', sprintf( /* translators: %s: The name of the PHP constant that is set. */ __( 'The %s constant is set to true.', 'wp-crontrol' ), 'ALTERNATE_WP_CRON' ) ); } $cached_status = get_transient( 'crontrol-cron-test-ok' ); if ( $cache && $cached_status ) { return true; } $sslverify = version_compare( $wp_version, '4.0', '<' ); $doing_wp_cron = sprintf( '%.22F', microtime( true ) ); $cron_request = apply_filters( 'cron_request', array( 'url' => add_query_arg( 'doing_wp_cron', $doing_wp_cron, site_url( 'wp-cron.php' ) ), 'key' => $doing_wp_cron, 'args' => array( 'timeout' => 3, 'blocking' => true, 'sslverify' => apply_filters( 'https_local_ssl_verify', $sslverify ), ), ), $doing_wp_cron ); $cron_request['args']['blocking'] = true; $result = wp_remote_post( $cron_request['url'], $cron_request['args'] ); if ( is_wp_error( $result ) ) { return $result; } elseif ( wp_remote_retrieve_response_code( $result ) >= 300 ) { return new WP_Error( 'unexpected_http_response_code', sprintf( /* translators: %s: The HTTP response code. */ __( 'Unexpected HTTP response code: %s', 'wp-crontrol' ), intval( wp_remote_retrieve_response_code( $result ) ) ) ); } else { set_transient( 'crontrol-cron-test-ok', 1, 3600 ); return true; } } /** * Deletes the cached value of the cron status check. * * @return void */ function flush_status_cache() { delete_transient( 'crontrol-cron-test-ok' ); } /** * Shows the status of WP-Cron functionality on the site. Only displays a message when there's a problem. * * @param string $tab The tab name. * @return void */ function show_cron_status( $tab ) { if ( 'UTC' !== date_default_timezone_get() ) { ?>
%1$s

%3$s

', esc_html__( 'PHP default timezone is not set to UTC. This may cause issues with cron event timings.', 'wp-crontrol' ), 'https://wp-crontrol.com/help/php-default-timezone/', esc_html__( 'More information', 'wp-crontrol' ) ); ?>
get_error_code() ) { ?>

get_error_message() ); ?>

%1$s

%3$s

', sprintf( /* translators: %s: Error message text. */ esc_html__( 'There was a problem spawning a call to the WP-Cron system on your site. This means WP-Cron events on your site may not work. The problem was: %s', 'wp-crontrol' ), '

' . esc_html( $status->get_error_message() ) . '' ), 'https://wp-crontrol.com/help/problems-spawning-wp-cron/', esc_html__( 'More information', 'wp-crontrol' ) ); ?>

hook && intval( $_GET['crontrol_next_run_utc'] ) === $event->timestamp && $event->sig === $_GET['crontrol_sig'] ) { $existing = array( 'hookname' => $event->hook, 'next_run' => $event->timestamp, // UTC 'schedule' => ( $event->schedule ? $event->schedule : '_oneoff' ), 'sig' => $event->sig, 'args' => $event->args, ); break; } } if ( empty( $existing ) ) { ?>
%1$s

', esc_html__( 'The event you are trying to edit does not exist.', 'wp-crontrol' ) ); ?>
functions.php' ); } if ( is_array( $existing ) ) { $other_fields = wp_nonce_field( "crontrol-edit-cron_{$existing['hookname']}_{$existing['sig']}_{$existing['next_run']}", '_wpnonce', true, false ); $other_fields .= sprintf( '', esc_attr( $existing['hookname'] ) ); $other_fields .= sprintf( '', esc_attr( $existing['sig'] ) ); $other_fields .= sprintf( '', esc_attr( (string) $existing['next_run'] ) ); if ( ! empty( $existing['args'] ) ) { $display_args = wp_json_encode( $existing['args'] ); if ( false === $display_args ) { $display_args = ''; } } $button = __( 'Update Event', 'wp-crontrol' ); $next_run_gmt = gmdate( 'Y-m-d H:i:s', $existing['next_run'] ); $next_run_date_local = get_date_from_gmt( $next_run_gmt, 'Y-m-d' ); $next_run_time_local = get_date_from_gmt( $next_run_gmt, 'H:i:s' ); } else { $other_fields = wp_nonce_field( 'crontrol-new-cron', '_wpnonce', true, false ); $existing = array( 'hookname' => '', 'args' => array(), 'next_run' => 'now', // UTC 'schedule' => false, ); $button = __( 'Add Event', 'wp-crontrol' ); $next_run_date_local = ''; $next_run_time_local = ''; } if ( $is_editing_php && isset( $existing['args']['code'] ) ) { // Support the args array format used prior to WP Crontrol 1.16.2 $existing['args'] = array( array( 'code' => $existing['args']['code'], 'name' => $existing['args']['name'] ?? '', 'hash' => null, ), ); } $can_add_php = current_user_can( 'edit_files' ) && ! $editing; $allowed = ( ! $is_editing_php || current_user_can( 'edit_files' ) ); ?>
%s', esc_html( $heading ) ); printf( '

%s

', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped $helper_text ); ?>
', esc_attr( $action ) ); } elseif ( $can_add_php ) { ?>

%1$s

%3$s

', esc_html__( 'The PHP code in this event needs to be checked for integrity. This event will not run until you re-save it.', 'wp-crontrol' ), 'https://wp-crontrol.com/help/check-php-cron-events/', esc_html__( 'Read what to do', 'wp-crontrol' ) ); } ?>

<?php' ); ?>

[25]', '["asdf"]', '["i","want",25,"cakes"]' ); ?>

array( /* translators: %s: The name of the cron event. */ __( 'Scheduled the cron event %s to run now. The original event will not be affected.', 'wp-crontrol' ), 'success', ), '2' => array( /* translators: %s: The name of the cron event. */ __( 'Deleted all %s cron events.', 'wp-crontrol' ), 'success', ), '3' => array( /* translators: %s: The name of the cron event. */ __( 'There are no %s cron events to delete.', 'wp-crontrol' ), 'info', ), '4' => array( /* translators: %s: The name of the cron event. */ __( 'Saved the cron event %s.', 'wp-crontrol' ), 'success', ), '5' => array( /* translators: %s: The name of the cron event. */ __( 'Created the cron event %s.', 'wp-crontrol' ), 'success', ), '6' => array( /* translators: %s: The name of the cron event. */ __( 'Deleted the cron event %s.', 'wp-crontrol' ), 'success', ), '7' => array( /* translators: %s: The name of the cron event. */ __( 'Failed to the delete the cron event %s.', 'wp-crontrol' ), 'error', ), '8' => array( /* translators: %s: The name of the cron event. */ __( 'Failed to the execute the cron event %s.', 'wp-crontrol' ), 'error', ), '9' => array( __( 'Deleted the selected cron events.', 'wp-crontrol' ), 'success', ), '10' => array( /* translators: %s: The name of the cron event. */ __( 'Failed to save the cron event %s.', 'wp-crontrol' ), 'error', ), '11' => array( /* translators: %s: The name of the cron event. */ __( 'Paused the %s hook.', 'wp-crontrol' ), 'success', ), '12' => array( /* translators: %s: The name of the cron event. */ __( 'Resumed the %s hook.', 'wp-crontrol' ), 'success', ), 'error' => array( __( 'An unknown error occurred.', 'wp-crontrol' ), 'error', ), ); if ( isset( $_GET['crontrol_name'] ) && isset( $_GET['crontrol_message'] ) && isset( $messages[ $_GET['crontrol_message'] ] ) ) { $hook = wp_unslash( $_GET['crontrol_name'] ); $message = wp_unslash( $_GET['crontrol_message'] ); $link = ''; if ( 'error' === $message ) { $error = get_message(); if ( $error ) { $messages['error'][0] = $error; } } printf( '

%2$s%3$s

', esc_attr( $messages[ $message ][1] ), sprintf( esc_html( $messages[ $message ][0] ), '' . esc_html( $hook ) . '' ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped $link ); } $tabs = get_tab_states(); $table = Event\get_list_table(); switch ( true ) { case $tabs['events']: ?>

' . esc_html__( 'Add New', 'wp-crontrol' ) . ''; ?>
views(); ?>
search_box( esc_html__( 'Search Hook Names', 'wp-crontrol' ), 'cron-event' ); ?>
display(); ?>

Array of states keyed by tab name. */ function get_tab_states() { $tabs = array( 'events' => ( ! empty( $_GET['page'] ) && 'crontrol_admin_manage_page' === $_GET['page'] && empty( $_GET['crontrol_action'] ) ), 'schedules' => ( ! empty( $_GET['page'] ) && 'crontrol_admin_options_page' === $_GET['page'] ), 'add-event' => ( ! empty( $_GET['crontrol_action'] ) && 'new-cron' === $_GET['crontrol_action'] ), 'edit-event' => ( ! empty( $_GET['crontrol_action'] ) && 'edit-cron' === $_GET['crontrol_action'] ), ); $tabs = apply_filters( 'crontrol/tabs', $tabs ); return $tabs; } /** * Output the cron-related tabs if we're on a cron-related admin screen. * * @return void */ function do_tabs() { $tabs = get_tab_states(); $tab = array_filter( $tabs ); if ( ! $tab ) { return; } $tab = array_keys( $tab ); $tab = reset( $tab ); $links = array( 'events' => array( 'tools.php?page=crontrol_admin_manage_page', __( 'Cron Events', 'wp-crontrol' ), ), 'schedules' => array( 'options-general.php?page=crontrol_admin_options_page', __( 'Cron Schedules', 'wp-crontrol' ), ), ); ?>
> Array of callbacks attached to the hook. * @phpstan-return array, * }> */ function get_hook_callbacks( $name ) { global $wp_filter; $actions = array(); if ( isset( $wp_filter[ $name ] ) ) { // See http://core.trac.wordpress.org/ticket/17817. $action = $wp_filter[ $name ]; /** * @var int $priority */ foreach ( $action as $priority => $callbacks ) { foreach ( $callbacks as $callback ) { $callback = populate_callback( $callback ); if ( __NAMESPACE__ . '\\pauser()' === $callback['name'] ) { continue; } $actions[] = array( 'priority' => $priority, 'callback' => $callback, ); } } } return $actions; } /** * Populates the details of the given callback function. * * @param array $callback A callback entry. * @phpstan-param array{ * function: string|array|object, * accepted_args: int, * } $callback * @return array The updated callback entry. */ function populate_callback( array $callback ) { // If Query Monitor is installed, use its rich callback analysis. if ( method_exists( '\QM_Util', 'populate_callback' ) ) { return \QM_Util::populate_callback( $callback ); } if ( is_string( $callback['function'] ) && ( false !== strpos( $callback['function'], '::' ) ) ) { $callback['function'] = explode( '::', $callback['function'] ); } if ( is_array( $callback['function'] ) ) { if ( is_object( $callback['function'][0] ) ) { $class = get_class( $callback['function'][0] ); $access = '->'; } else { $class = $callback['function'][0]; $access = '::'; } $callback['name'] = $class . $access . $callback['function'][1] . '()'; } elseif ( is_object( $callback['function'] ) ) { if ( is_a( $callback['function'], 'Closure' ) ) { $callback['name'] = 'Closure'; } else { $class = get_class( $callback['function'] ); $callback['name'] = $class . '->__invoke()'; } } else { $callback['name'] = $callback['function'] . '()'; } if ( ! method_exists( '\QM_Util', 'populate_callback' ) && ! is_callable( $callback['function'] ) ) { $callback['error'] = new WP_Error( 'not_callable', sprintf( /* translators: %s: Function name */ __( 'Function %s does not exist', 'wp-crontrol' ), $callback['name'] ) ); } return $callback; } /** * Returns a user-friendly representation of the callback function. * * @param mixed[] $callback The callback entry. * @return string The displayable version of the callback name. */ function output_callback( array $callback ) { $qm = WP_PLUGIN_DIR . '/query-monitor/query-monitor.php'; $html = plugin_dir_path( $qm ) . 'output/Html.php'; if ( ! empty( $callback['callback']['error'] ) ) { $return = '' . $callback['callback']['name'] . ''; $return .= '
'; $return .= esc_html( $callback['callback']['error']->get_error_message() ); $return .= ''; return $return; } // If Query Monitor is installed, use its rich callback output. if ( class_exists( '\QueryMonitor' ) && file_exists( $html ) ) { require_once $html; if ( class_exists( '\QM_Output_Html' ) ) { return \QM_Output_Html::output_filename( $callback['callback']['name'], $callback['callback']['file'], $callback['callback']['line'] ); } } return '' . $callback['callback']['name'] . ''; } /** * Pretty-prints the difference in two times. * * @param int $older_date Unix timestamp. * @param int $newer_date Unix timestamp. * @return string The pretty time_since value * @link http://binarybonsai.com/code/timesince.txt */ function time_since( $older_date, $newer_date ) { return interval( $newer_date - $older_date ); } /** * Converts a period of time in seconds into a human-readable format representing the interval. * * Example: * * echo \Crontrol\interval( 90 ); * // 1 minute 30 seconds * * @param int|float $since A period of time in seconds. * @return string An interval represented as a string. */ function interval( $since ) { // Array of time period chunks. $chunks = array( /* translators: %s: The number of years in an interval of time. */ array( YEAR_IN_SECONDS, _n_noop( '%s year', '%s years', 'wp-crontrol' ) ), /* translators: %s: The number of months in an interval of time. */ array( MONTH_IN_SECONDS, _n_noop( '%s month', '%s months', 'wp-crontrol' ) ), /* translators: %s: The number of weeks in an interval of time. */ array( WEEK_IN_SECONDS, _n_noop( '%s week', '%s weeks', 'wp-crontrol' ) ), /* translators: %s: The number of days in an interval of time. */ array( DAY_IN_SECONDS, _n_noop( '%s day', '%s days', 'wp-crontrol' ) ), /* translators: %s: The number of hours in an interval of time. */ array( HOUR_IN_SECONDS, _n_noop( '%s hour', '%s hours', 'wp-crontrol' ) ), /* translators: %s: The number of minutes in an interval of time. */ array( MINUTE_IN_SECONDS, _n_noop( '%s minute', '%s minutes', 'wp-crontrol' ) ), /* translators: %s: The number of seconds in an interval of time. */ array( 1, _n_noop( '%s second', '%s seconds', 'wp-crontrol' ) ), ); if ( $since <= 0 ) { return __( 'now', 'wp-crontrol' ); } /** * We only want to output two chunks of time here, eg: * x years, xx months * x days, xx hours * so there's only two bits of calculation below: */ // Step one: the first chunk. foreach ( array_keys( $chunks ) as $i ) { $seconds = $chunks[ $i ][0]; $name = $chunks[ $i ][1]; // Finding the biggest chunk (if the chunk fits, break). $count = (int) floor( $since / $seconds ); if ( $count ) { break; } } // Set output var. $output = sprintf( translate_nooped_plural( $name, $count, 'wp-crontrol' ), $count ); // Step two: the second chunk. if ( $i + 1 < count( $chunks ) ) { $seconds2 = $chunks[ $i + 1 ][0]; $name2 = $chunks[ $i + 1 ][1]; $count2 = (int) floor( ( $since - ( $seconds * $count ) ) / $seconds2 ); if ( $count2 ) { // Add to output var. $output .= ' ' . sprintf( translate_nooped_plural( $name2, $count2, 'wp-crontrol' ), $count2 ); } } return $output; } /** * Sets up the Events listing screen. * * @return void */ function setup_manage_page() { // Initialise the list table Event\get_list_table(); } /** * Registers the stylesheet and JavaScript for the admin areas. * * @param string $hook_suffix The admin screen ID. * @return void */ function enqueue_assets( $hook_suffix ) { $tab = get_tab_states(); if ( ! array_filter( $tab ) ) { return; } wp_enqueue_style( 'wp-crontrol', plugin_dir_url( PLUGIN_FILE ) . 'css/wp-crontrol.css', array( 'dashicons', ), WP_CRONTROL_VERSION ); wp_enqueue_script( 'wp-crontrol', plugin_dir_url( PLUGIN_FILE ) . 'js/wp-crontrol.js', array(), WP_CRONTROL_VERSION, true ); $vars = array(); if ( ! empty( $tab['add-event'] ) || ! empty( $tab['edit-event'] ) ) { if ( function_exists( 'wp_enqueue_code_editor' ) && current_user_can( 'edit_files' ) ) { $settings = wp_enqueue_code_editor( array( 'type' => 'text/x-php', ) ); if ( false !== $settings ) { $vars['codeEditor'] = $settings; } } } wp_localize_script( 'wp-crontrol', 'wpCrontrol', $vars ); } /** * Filters the list of query arguments which get removed from admin area URLs in WordPress. * * @param array $args List of removable query arguments. * @return array Updated list of removable query arguments. */ function filter_removable_query_args( array $args ) { return array_merge( $args, array( 'crontrol_message', 'crontrol_name', ) ); } /** * Returns an array of cron event hooks that are persistently added by WordPress core. * * @return array Array of hook names. */ function get_persistent_core_hooks() { return array( 'wp_update_plugins', // 2.7.0 'wp_update_themes', // 2.7.0 'wp_version_check', // 2.7.0 'wp_scheduled_delete', // 2.9.0 'update_network_counts', // 3.1.0 'wp_scheduled_auto_draft_delete', // 3.4.0 'delete_expired_transients', // 4.9.0 'wp_privacy_delete_old_export_files', // 4.9.6 'recovery_mode_clean_expired_keys', // 5.2.0 'wp_site_health_scheduled_check', // 5.4.0 'wp_https_detection', // 5.7.0 'wp_update_user_counts', // 6.0.0 ); } /** * Returns an array of all cron event hooks that are added by WordPress core. * * @return array Array of hook names. */ function get_all_core_hooks() { return array_merge( get_persistent_core_hooks(), array( 'do_pings', // 2.1.0 'publish_future_post', // 2.1.0 'importer_scheduled_cleanup', // 2.5.0 'upgrader_scheduled_cleanup', // 3.2.2 'wp_maybe_auto_update', // 3.7.0 'wp_split_shared_term_batch', // 4.3.0 'wp_update_comment_type_batch', // 5.5.0 'wp_delete_temp_updater_backups', // 5.9.0 ) ); } /** * Returns an array of cron schedules that are added by WordPress core. * * @return array Array of schedule names. */ function get_core_schedules() { return array( 'hourly', 'twicedaily', 'daily', 'weekly', ); } /** * Encodes some input as JSON for output. * * @param mixed $input The input. * @param bool $pretty Whether to pretty print the output. Default true. * @return string The JSON-encoded output. */ function json_output( $input, $pretty = true ) { $json_options = 0; if ( defined( 'JSON_UNESCAPED_SLASHES' ) ) { // phpcs:ignore PHPCompatibility.Constants.NewConstants.json_unescaped_slashesFound $json_options |= JSON_UNESCAPED_SLASHES; } if ( $pretty && defined( 'JSON_PRETTY_PRINT' ) ) { $json_options |= JSON_PRETTY_PRINT; } $output = wp_json_encode( $input, $json_options ); if ( false === $output ) { $output = ''; } return $output; } /** * Evaluates the code in a PHP cron event using eval. * * Security: Only users with the `edit_files` capability can manage PHP cron events. This means if a user cannot edit * files on the site (eg. through the Plugin Editor or Theme Editor) then they cannot edit or add a PHP cron event. By * default, only Administrators have this capability, and with Multisite enabled only Super Admins have this capability. * * If file editing has been disabled via the `DISALLOW_FILE_MODS` or `DISALLOW_FILE_EDIT` configuration constants then * no user will have the `edit_files` capability, which means editing or adding a PHP cron event will not be permitted. * * Therefore, the user access level required to execute arbitrary PHP code does not change with WP Crontrol activated. * * The PHP code that's saved in a PHP cron event is protected with an integrity check which prevents it from being executed * if the code is tampered with. * * PHP cron events are secured via an integrity check that makes use of an HMAC to store a hash of the PHP code alongside * the code when the event is saved. When the event runs, the hash is checked to ensure the integrity of the PHP code and * confirm that it has not been tampered with. WP Crontrol will not execute the PHP code if the hashes do not match or if * a stored hash is not present. * * If an attacker with database-level access were to modify the PHP code in an event in an attempt to execute arbitrary * code, the code would no longer execute. * * @link https://wp-crontrol.com/docs/php-cron-events/ * * @param array|string $args The event args array, or a string containing the PHP code to evaluate. * @phpstan-param array{ * code?: string, * name?: string, * hash?: string, * }|string $args * @return void */ function action_php_cron_event( $args ) { if ( is_string( $args ) ) { // Prior to WP Crontrol 1.16.2, PHP cron events were saved with the associative arguments array at the top // level. This means arguments are passed as individual parameters to this function and the first parameter // contains the PHP code. $code = $args; $hash = null; } else { // Since WP Crontrol 1.16.2, PHP cron events are stored with the associative arguments array as the first element // in the args list. This means arguments are passed as a single associative array parameter to this function. $code = $args['code'] ?? null; $hash = $args['hash'] ?? null; } if ( empty( $hash ) ) { // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_trigger_error trigger_error( sprintf( 'The stored hash is missing for a PHP cron event; for more information see %s', esc_url_raw( admin_url( 'tools.php?page=crontrol_admin_manage_page&crontrol_hooks_type=php' ) ), ), E_USER_WARNING ); return; } // Check the integrity of the PHP code. if ( ! check_integrity( $code, $hash ) ) { // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_trigger_error trigger_error( sprintf( 'The stored hash for a PHP cron event is not valid; for more information see %s', esc_url_raw( admin_url( 'tools.php?page=crontrol_admin_manage_page&crontrol_hooks_type=php' ) ), ), E_USER_WARNING ); return; } // Please see the function description above for information about the safety of this code. // phpcs:ignore Squiz.PHP.Eval.Discouraged eval( $code ); }