0 Day Analytics – Crons Module Developer Documentation

<?php
public const TRANSIENT_NAME = 'advana_cron_test_ok';

public const WP_CORE_CRONS = array(
    'recovery_mode_clean_expired_keys',
    'wp_delete_temp_updater_backups',
    'wp_privacy_delete_old_export_files',
    'wp_update_user_counts',
    'wp_version_check',
    'wp_update_plugins',
    'wp_update_themes',
    'wp_scheduled_delete',
    'delete_expired_transients',
    // ... 20+ WordPress core hook names
);

<?php
use ADVAN\Helpers\Crons_Helper;

// Schedule a daily cron event starting in 1 hour
Crons_Helper::schedule_event(
    'my_custom_daily_task',   // hook name
    'daily',                  // recurrence
    time() + 3600,            // first run timestamp
    array( 'arg1', 42 )      // arguments
);

// Check if scheduled
if ( Crons_Helper::is_scheduled( 'my_custom_daily_task' ) ) {
    // It is scheduled!
}

// Unschedule
Crons_Helper::unschedule_event( 'my_custom_daily_task' );

<?php
const CRON_MENU_SLUG   = 'advan_cron_jobs';
const PAGE_SLUG        = '0-day_page_advan_cron_jobs';
const UPDATE_ACTION    = 'advan_crons_update';
const NEW_ACTION       = 'advan_crons_new';
const NONCE_NAME       = 'advana_crons_manager';
const SEARCH_INPUT     = 'sgp';
const PLUGIN_FILTER_ACTION = self::PAGE_SLUG . '_filter_plugin';
const SITE_FILTER_ACTION   = self::PAGE_SLUG . '_filter_site';

<?php
// Hook to register custom cron jobs
\add_action( 'after_setup_theme', [ Cron_Jobs::class, 'initialize_hooks' ], 30000 );

// Use the filter to add plugin-specific cron jobs
\add_filter( 'advan_cron_hooks', function( $hooks ) {
    $hooks[] = array(
        'hook'       => 'my_plugin_cleanup',
        'recurrence' => 'daily',
        'callback'   => 'my_cleanup_function',
    );
    return $hooks;
});

<?php
$event = array(
    'hash'         => 'a1b2c3d4',           // md5 hash (first 8 chars)
    'hook'         => 'my_custom_hook',     // WordPress action hook name
    'schedule'     => 1711360000,           // Unix timestamp (next run, UTC)
    'recurrence'   => 'daily',              // Schedule name or empty for one-time
    'args'         => array( 1, 'arg2' ),  // Arguments passed to the hook
    'site_id'      => 1,                    // Blog ID (multisite)
    'site_name'    => 'My Site',            // Blog name (multisite)
    'plugin_slug'  => 'my-plugin',          // Originating plugin (backward compat)
    'plugin_slugs' => array( 'my-plugin' ), // Array of plugins (new format)
);

<?php
$hash = substr(
    md5(
        $hook .
        $recurrence .
        $schedule .
        wp_json_encode( $args )
    ),
    0,
    8
);

<?php
\add_filter( 'cron_schedules', function( $schedules ) {
    $schedules['every_five_minutes'] = array(
        'interval' => 300,
        'display'  => __( 'Every 5 Minutes' ),
    );
    return $schedules;
});

// This new schedule will automatically appear in the
// schedule dropdown on Edit/Add Cron screens.

<?php
\add_filter( 'advan_cron_hooks', function( $hooks ) {
    $hooks[] = array(
        'hook'       => 'my_plugin_daily_cleanup',
        'recurrence' => 'daily',
        'callback'   => 'my_cleanup_callback',
    );
    return $hooks;
});

function my_cleanup_callback() {
    // Your daily cleanup logic here
}

<?php
// Check if cron module is enabled
$enabled = Settings::get_option( 'cron_module_enabled' );

// Check if WP Cron is disabled globally
$wp_cron_disabled = defined( 'DISABLE_WP_CRON' ) && DISABLE_WP_CRON;

<?php
// How the settings are defined in cron-list.php
Settings::build_option(
    array(
        'title' => esc_html__( 'Cron Options', '0-day-analytics' ),
        'id'    => 'options-settings-tab',
        'type'  => 'tab-title',
    )
);

Settings::build_option(
    array(
        'name'    => esc_html__( 'Enable cron module', '0-day-analytics' ),
        'id'      => 'cron_module_enabled',
        'type'    => 'checkbox',
        'hint'    => esc_html__( 'Disables plugin cron module only.', '0-day-analytics' ),
        'default' => Settings::get_option( 'cron_module_enabled' ),
    )
);

<?php
use ADVAN\Helpers\Crons_Helper;

// Test whether WP-Cron can be spawned (cached by default)
$status = Crons_Helper::test_cron_spawn();

if ( is_wp_error( $status ) ) {
    error_log( 'WP-Cron spawn failed: ' . $status->get_error_message() );
} else {
    error_log( 'WP-Cron spawn is working correctly.' );
}

<?php
use ADVAN\Helpers\Crons_Helper;

$all_events = Crons_Helper::get_events();

// Filter to only events from 'woocommerce' plugin
$woo_events = array_filter( $all_events, function( $event ) {
    return isset( $event['plugin_slugs'] )
        && in_array( 'woocommerce', $event['plugin_slugs'], true );
});

foreach ( $woo_events as $event ) {
    printf(
        "Hook: %s | Next: %s | Interval: %s\n",
        $event['hook'],
        date( 'Y-m-d H:i:s', $event['schedule'] ),
        $event['recurrence'] ?: 'once'
    );
}

<?php
// Programmatic REST API call within WordPress
$request = new \WP_REST_Request( 'GET', '/0-day/v1/cron_run/a1b2c3d4/' );
$response = rest_do_request( $request );

if ( $response->is_error() ) {
    $error = $response->as_error();
    error_log( 'Cron execution failed: ' . $error->get_error_message() );
} else {
    $data = $response->get_data();
    error_log( 'Cron executed: ' . print_r( $data, true ) );
}

<?php
use ADVAN\Helpers\Crons_Helper;

if ( Crons_Helper::is_scheduled( 'my_plugin_sync_task' ) ) {
    // Already scheduled – skip registration
    return;
}

// Schedule it now
Crons_Helper::schedule_event(
    'my_plugin_sync_task',
    'hourly'
);

<?php
use ADVAN\Helpers\Crons_Helper;

// Get crons for blog ID 3
$site_events = Crons_Helper::get_events_for_site( 3 );

echo count( $site_events ) . ' cron events on site #3';

<?php
use ADVAN\Helpers\Crons_Helper;

$result = Crons_Helper::delete_event( 'a1b2c3d4' );

if ( is_wp_error( $result ) ) {
    error_log( 'Failed to delete: ' . $result->get_error_message() );
} elseif ( $result ) {
    error_log( 'Cron deleted successfully' );
} else {
    error_log( 'Cron not found' );
}