¿Cómo ejecutar una función cada 5 minutos?

Puedes crear nuevos intervalos de programación mediante cron_schedules:

function my_cron_schedules($schedules){
    if(!isset($schedules["5min"])){
        $schedules["5min"] = array(
            'interval' => 5*60,
            'display' => __('Una vez cada 5 minutos'));
    }
    if(!isset($schedules["30min"])){
        $schedules["30min"] = array(
            'interval' => 30*60,
            'display' => __('Una vez cada 30 minutos'));
    }
    return $schedules;
}
add_filter('cron_schedules','my_cron_schedules');

Ahora puedes programar tu función:

wp_schedule_event(time(), '5min', 'my_schedule_hook', $args);

Para programarla solo una vez, envuélvela en una función y verifica antes de ejecutarla:

$args = array(false);
function schedule_my_cron(){
    wp_schedule_event(time(), '5min', 'my_schedule_hook', $args);
}
if(!wp_next_scheduled('my_schedule_hook',$args)){
    add_action('init', 'schedule_my_cron');
}

¡Nota el parámetro $args! No especificar el parámetro $args en wp_next_scheduled, pero tener $args para wp_schedule_event, causará que se programen casi infinitamente el mismo evento (en lugar de solo uno).

Finalmente, crea la función real que deseas ejecutar:

function my_schedule_hook(){
    // tu código aquí
}

Creo que es importante mencionar que wp-cron verifica el programa y ejecuta los trabajos pendientes cada vez que se carga una página.

Por lo tanto, si tienes un sitio web con poco tráfico que solo recibe 1 visitante por hora, wp-cron solo se ejecutará cuando ese visitante navegue por tu sitio (una vez por hora). Si tienes un sitio con mucho tráfico donde los visitantes solicitan una página cada segundo, wp-cron se activará cada segundo causando carga adicional en el servidor.

La solución es desactivar wp-cron y activarlo mediante un trabajo cron real en el intervalo de tiempo de tu tarea programada más frecuente (5 minutos en tu caso).

Lucas Rolff explica el problema y da la solución en detalle.

Como alternativa, podrías usar un servicio gratuito de terceros como UptimeRobot para consultar tu sitio (y activar wp-cron) cada 5 minutos, si no deseas desactivar wp-cron y activarlo mediante un cron real.

Si tu sitio recibe mucho tráfico, podrías intentar usar set_transient() para ejecutarlo (de forma muy aproximada) cada 5 minutos, por ejemplo:

function run_every_five_minutes() {
    // Probablemente necesitaría algo de lógica aquí para evitar que se ejecute justo después de haberlo hecho.
    // el código va aquí
}

if ( ! get_transient( 'every_5_minutes' ) ) {
    set_transient( 'every_5_minutes', true, 5 * MINUTE_IN_SECONDS );
    run_every_five_minutes();

    // Es mejor usar un hook para llamar a una función en el plugin/tema
    //add_action( 'init', 'run_every_five_minutes' );
}

La respuesta de @johano explica correctamente cómo configurar un intervalo personalizado para un trabajo cron en WordPress. Sin embargo, la segunda pregunta no está respondida, que es cómo ejecutar un cron cada minuto:

1. En el archivo wp-config.php, agrega el siguiente código:

   define('DISABLE_WP_CRON', true);
   

2. Agrega un trabajo cron (crontab -e en unix/linux):

   1 * * * * wget -q -O - http://example.com/wp-cron.php?doing_wp_cron
   

La primera parte (paso 1) desactivará el trabajo cron interno de WordPress. La segunda parte (paso 2) ejecutará manualmente el trabajo cron de WordPress cada minuto.

Con la respuesta de @Johano (cómo ejecutar una tarea cada 5 minutos) y la mía (cómo ejecutar manualmente el cron), deberías poder lograr tu objetivo.

Puedes activarlo durante la activación del plugin en lugar de en cada llamada al plugin:

// Añade una función de utilidad para manejar los logs de forma más limpia.
if ( ! function_exists('write_log')) {
    function write_log ( $log )  {
        if ( is_array( $log ) || is_object( $log ) ) {
            error_log( print_r( $log, true ) );
        } else {
            error_log( $log );
        }
    }
}

/**
 * No permitir que el plugin sea accedido directamente
 **/
if ( ! defined( 'ABSPATH' ) ) {
    write_log( "¡El plugin no debe ser accedido directamente!" );
    exit; // Salir si se accede directamente
}

/**
 * -----------------------------------------------------------------------------------------------------------
 * No olvides activar una llamada de sistema a la página wp-cron.php al menos cada 30 minutos.
 * De lo contrario, no podemos asegurar que el trigger será llamado.
 * -----------------------------------------------------------------------------------------------------------
 * Comando en Linux:
 * crontab -e
 * 30 * * * * wget http://<url>/wp-cron.php
 */

/**
 * Añade un horario personalizado a WordPress.
 * @param $schedules array Los horarios existentes
 *
 * @return mixed Los horarios existentes + el nuevo.
 */
function woocsp_schedules( $schedules ) {
    write_log("Creando horario personalizado.");
    if ( ! isset( $schedules["10s"] ) ) {
        $schedules["10s"] = array(
            'interval' => 10,
            'display'  => __( 'Una vez cada 10 segundos' )
        );
    }

    write_log("Horario personalizado creado.");
    return $schedules;
}

// Añade el filtro de horarios cron con el horario definido anteriormente.
add_filter( 'cron_schedules', 'woocsp_schedules' );

// Función personalizada que será llamada cuando se active el horario.
function scheduleTriggered() {
    write_log( "¡Programador activado!" );
}
add_action( 'woocsp_cron_delivery', 'scheduleTriggered' );

// Registra un hook de activación para realizar operaciones solo al activar el plugin
register_activation_hook(__FILE__, 'woocsp_activation');
function woocsp_activation() {
    write_log("Activando plugin.");

    // Activa nuestro método en el evento de horario personalizado.
    if ( ! wp_get_schedule( 'woocsp_cron_delivery' ) ) {
        wp_schedule_event( time(), '10s', 'woocsp_cron_delivery' );
    }

    write_log("Plugin activado.");
}

// Desactiva los eventos programados al desactivar el plugin.
register_deactivation_hook(__FILE__, 'woocsp_deactivation');
function woocsp_deactivation() {
    write_log("Desactivando plugin.");

    // Elimina nuestro hook programado.
    wp_clear_scheduled_hook('woocsp_cron_delivery');

    write_log("Plugin desactivado.");
}

Me temo que, aparte de esperar a que alguien visite tu sitio y ejecute una función, la única otra opción es configurar un trabajo cron en tu servidor usando algo como esto https://stackoverflow.com/questions/878600/how-to-create-cronjob-using-bash o si tienes una interfaz estilo cPanel en tu servidor, a veces hay una GUI para configurar esto.

El plugin Programador de Cronjobs te permite ejecutar tareas frecuentes de manera confiable y puntual sin que nadie tenga que visitar tu sitio, todo lo que necesitas es al menos 1 acción y un horario Unix Crontab.

Es muy fácil de usar y muy flexible. Creas tu propia función y defines una acción dentro de ella. Luego puedes elegir tu acción desde el menú del plugin y activarla cuando quieras.

Tengo una posible solución usando una función programada y una función recursiva de WP Ajax.

1. Crear un evento programado cada 60 minutos para ejecutar una función
2. Esta función activará una función recursiva usando Ajax a través de file_get_contents()
3. La función ajax tendrá un contador en la base de datos con un número total de 60 (por cada minuto dentro de la hora).
4. Esta función ajax verificará tu contador para:

Si el contador es igual o mayor a 60, reiniciará el contador y esperará el próximo cron job.

Si el contador es múltiplo de 5 (cada 5 minutos) ejecutará tu función deseada

Y, además de las condiciones, esperará 59 segundos sleep(59); (asumiendo que tu función es rápida). Después de la espera, se activará a sí misma usando file_get_contents() nuevamente.

Cosas importantes a considerar:

1. Crear una forma de interrumpir el proceso (ej. verificando un valor en la BD)
2. Crear una forma de prevenir 2 procesos al mismo tiempo
3. En file_get_contents establecer el límite de tiempo en el encabezado a 2 o 3 segundos, de lo contrario el servidor podría tener varios procesos esperando sin razón
4. Puedes usar set_time_limit(90); para intentar evitar que el servidor detenga tu función antes del sleep

Es una solución, no la mejor, y podría ser bloqueada por el servidor. Usando un cron externo puedes configurar una función simple y el servidor usará recursos una vez cada 5 minutos. Con esta solución, el servidor estará usando recursos todo el tiempo.