views(); ?> items ) ) ); } /** * Gets the status of WP-Cron functionality on the site by performing a test spawn if necessary. Cached for one hour when all is well. * * @param bool $cache Whether to use the cached result from previous calls. * @return true|WP_Error Boolean true if the cron spawner is working as expected, or a `WP_Error` object if not. */ function test_cron_spawn( $cache = true ) { global $wp_version; $cron_runner_plugins = array( '\HM\Cavalcade\Plugin\Job' => 'Cavalcade', '\Automattic\WP\Cron_Control' => 'Cron Control', ); foreach ( $cron_runner_plugins as $class => $plugin ) { if ( class_exists( $class ) ) { return new WP_Error( 'crontrol_info', sprintf( /* translators: 1: 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: 1: 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: 1: 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 ), ), ) ); $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: 1: 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; } } /** * Determines whether the given feature is enabled. * * The feature directly corresponds to one of WP Crontrol's tabs. Currently the only feature * that's not enabled by default is "logs" which are provided by WP Crontrol Pro. * * @param string $feature The feature name. * @return bool Whether the specified tab is active. */ function is_feature_enabled( $feature ) { $enabled = ( 'logs' !== $feature ); return apply_filters( "crontrol/enabled/{$feature}", $enabled ); } /** * 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. */ function show_cron_status( $tab ) { if ( ! is_feature_enabled( $tab ) ) { return; } if ( 'UTC' !== date_default_timezone_get() ) { ?> get_error_code() ) { ?> hook && intval( $_GET['next_run_utc'] ) === $event->time && $event->sig === $_GET['sig'] ) { $existing = array( 'hookname' => $event->hook, 'next_run' => $event->time, // UTC 'schedule' => ( $event->schedule ? $event->schedule : '_oneoff' ), 'sig' => $event->sig, 'args' => $event->args, ); break; } } if ( empty( $existing ) ) { ?> functions.php' ); } if ( is_array( $existing ) ) { $other_fields = wp_nonce_field( "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( $existing['next_run'] ) ); if ( ! empty( $existing['args'] ) ) { $display_args = wp_json_encode( $existing['args'] ); } $action = $is_editing_php ? 'edit_php_cron' : 'edit_cron'; $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( '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 ) { if ( ! isset( $existing['args']['code'] ) ) { $existing['args']['code'] = ''; } if ( ! isset( $existing['args']['name'] ) ) { $existing['args']['name'] = ''; } } $can_add_php = current_user_can( 'edit_files' ) && ! $editing; $allowed = ( ! $is_editing_php || current_user_can( 'edit_files' ) ); ?> array( /* translators: 1: 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: 1: The name of the cron event. */ __( 'Deleted all %s cron events.', 'wp-crontrol' ), 'success', ), '3' => array( /* translators: 1: The name of the cron event. */ __( 'There are no %s cron events to delete.', 'wp-crontrol' ), 'info', ), '4' => array( /* translators: 1: The name of the cron event. */ __( 'Saved the cron event %s.', 'wp-crontrol' ), 'success', ), '5' => array( /* translators: 1: The name of the cron event. */ __( 'Created the cron event %s.', 'wp-crontrol' ), 'success', ), '6' => array( /* translators: 1: The name of the cron event. */ __( 'Deleted the cron event %s.', 'wp-crontrol' ), 'success', ), '7' => array( /* translators: 1: The name of the cron event. */ __( 'Failed to the delete the cron event %s.', 'wp-crontrol' ), 'error', ), '8' => array( /* translators: 1: 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: 1: The name of the cron event. */ __( 'Failed to save the cron event %s.', 'wp-crontrol' ), 'error', ), 'error' => array(), ); 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 ) { $messages['error'] = array( get_message(), 'error', ); } printf( '', 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']: ?> ( ! empty( $_GET['page'] ) && 'crontrol_admin_manage_page' === $_GET['page'] && empty( $_GET['action'] ) ), 'schedules' => ( ! empty( $_GET['page'] ) && 'crontrol_admin_options_page' === $_GET['page'] ), 'add-event' => ( ! empty( $_GET['action'] ) && 'new-cron' === $_GET['action'] ), 'edit-event' => ( ! empty( $_GET['action'] ) && 'edit-cron' === $_GET['action'] ), ); } /** * Output the cron-related tabs if we're on a cron-related admin screen. */ 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' ), ), ); ?> $callbacks ) { foreach ( $callbacks as $callback ) { $callback = populate_callback( $callback ); $actions[] = array( 'priority' => $priority, 'callback' => $callback, ); } } } return $actions; } /** * Populates the details of the given callback function. * * @param array $callback A callback entry. * @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'] . '()'; } return $callback; } /** * Returns a user-friendly representation of the callback function. * * @param array $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 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' ) ) { if ( ! empty( $callback['callback']['error'] ) ) { $return = '' . $callback['callback']['name'] . ''; $return .= '
'; $return .= esc_html( $callback['callback']['error']->get_error_message() ); $return .= ''; return $return; } 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 $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: 1: The number of years in an interval of time. */ array( 60 * 60 * 24 * 365, _n_noop( '%s year', '%s years', 'wp-crontrol' ) ), /* translators: 1: The number of months in an interval of time. */ array( 60 * 60 * 24 * 30, _n_noop( '%s month', '%s months', 'wp-crontrol' ) ), /* translators: 1: The number of weeks in an interval of time. */ array( 60 * 60 * 24 * 7, _n_noop( '%s week', '%s weeks', 'wp-crontrol' ) ), /* translators: 1: The number of days in an interval of time. */ array( 60 * 60 * 24, _n_noop( '%s day', '%s days', 'wp-crontrol' ) ), /* translators: 1: The number of hours in an interval of time. */ array( 60 * 60, _n_noop( '%s hour', '%s hours', 'wp-crontrol' ) ), /* translators: 1: The number of minutes in an interval of time. */ array( 60, _n_noop( '%s minute', '%s minutes', 'wp-crontrol' ) ), /* translators: 1: 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: */ $j = count( $chunks ); // Step one: the first chunk. for ( $i = 0; $i < $j; $i++ ) { $seconds = $chunks[ $i ][0]; $name = $chunks[ $i ][1]; // Finding the biggest chunk (if the chunk fits, break). $count = 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 < $j ) { $seconds2 = $chunks[ $i + 1 ][0]; $name2 = $chunks[ $i + 1 ][1]; $count2 = 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. */ function setup_manage_page() { // Initialise the list table Event\get_list_table(); // Add the initially hidden admin notice about the out of date events list add_action( 'admin_notices', function() { printf( '', esc_html__( 'The scheduled cron events have changed since you first opened this page. Reload the page to see the up to date list.', 'wp-crontrol' ) ); } ); } /** * Registers the stylesheet and JavaScript for the admin areas. * * @param string $hook_suffix The admin screen ID. */ function enqueue_assets( $hook_suffix ) { $tab = get_tab_states(); if ( ! array_filter( $tab ) ) { return; } $ver = filemtime( plugin_dir_path( __FILE__ ) . 'css/wp-crontrol.css' ); wp_enqueue_style( 'wp-crontrol', plugin_dir_url( __FILE__ ) . 'css/wp-crontrol.css', array( 'dashicons' ), $ver ); $ver = filemtime( plugin_dir_path( __FILE__ ) . 'js/wp-crontrol.js' ); wp_enqueue_script( 'wp-crontrol', plugin_dir_url( __FILE__ ) . 'js/wp-crontrol.js', array( 'jquery', 'wp-a11y' ), $ver, true ); $vars = array(); if ( ! empty( $tab['events'] ) ) { $vars['eventsHash'] = md5( json_encode( Event\get_list_table()->items ) ); $vars['eventsHashInterval'] = 20; } 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 string[] $args List of removable query arguments. * @return string[] 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 string[] Array of hook names. */ function get_persistent_core_hooks() { return array( 'delete_expired_transients', 'recovery_mode_clean_expired_keys', 'update_network_counts', 'wp_https_detection', 'wp_privacy_delete_old_export_files', 'wp_scheduled_auto_draft_delete', 'wp_scheduled_delete', 'wp_site_health_scheduled_check', 'wp_update_plugins', 'wp_update_themes', 'wp_version_check', ); } /** * Returns an array of all cron event hooks that are added by WordPress core. * * @return string[] Array of hook names. */ function get_all_core_hooks() { return array_merge( get_persistent_core_hooks(), array( 'do_pings', 'importer_scheduled_cleanup', 'publish_future_post', 'upgrader_scheduled_cleanup', 'wp_maybe_auto_update', 'wp_split_shared_term_batch', 'wp_update_comment_type_batch', ) ); } /** * Returns an array of cron schedules that are added by WordPress core. * * @return string[] 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. * @return string The JSON-encoded output. */ function json_output( $input ) { $json_options = 0; if ( defined( 'JSON_UNESCAPED_SLASHES' ) ) { // phpcs:ignore PHPCompatibility.Constants.NewConstants.json_unescaped_slashesFound $json_options |= JSON_UNESCAPED_SLASHES; } if ( defined( 'JSON_PRETTY_PRINT' ) ) { $json_options |= JSON_PRETTY_PRINT; } return wp_json_encode( $input, $json_options ); } /** * 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. * * @param string $code The PHP code to evaluate. */ function action_php_cron_event( $code ) { // phpcs:ignore Squiz.PHP.Eval.Discouraged eval( $code ); } // Get this show on the road. init_hooks();