Ensure 1st healthcheck runs in the future, not immediately before dispatch

Author: ianmjones

classes/wp-background-process.php

@@ -650,6 +650,25 @@ protected function completed() {
 		do_action( $this->identifier . '_completed' );
 	}
 
+	/**
+	 * Get the cron healthcheck interval in minutes.
+	 *
+	 * Default is 5 minutes, minimum is 1 minute.
+	 *
+	 * @return int
+	 */
+	public function get_cron_interval() {
+		$interval = 5;
+
+		if ( property_exists( $this, 'cron_interval' ) ) {
+			$interval = $this->cron_interval;
+		}
+
+		$interval = apply_filters( $this->cron_interval_identifier, $interval );
+
+		return is_int( $interval ) && 0 < $interval ? $interval : 5;
+	}
+
 	/**
 	 * Schedule the cron healthcheck job.
 	 *
@@ -660,11 +679,7 @@ protected function completed() {
 	 * @return mixed
 	 */
 	public function schedule_cron_healthcheck( $schedules ) {
-		$interval = apply_filters( $this->cron_interval_identifier, 5 );
-
-		if ( property_exists( $this, 'cron_interval' ) ) {
-			$interval = apply_filters( $this->cron_interval_identifier, $this->cron_interval );
-		}
+		$interval = $this->get_cron_interval();
 
 		if ( 1 === $interval ) {
 			$display = __( 'Every Minute' );
@@ -707,7 +722,7 @@ public function handle_cron_healthcheck() {
 	 */
 	protected function schedule_event() {
 		if ( ! wp_next_scheduled( $this->cron_hook_identifier ) ) {
-			wp_schedule_event( time(), $this->cron_interval_identifier, $this->cron_hook_identifier );
+			wp_schedule_event( time() + ( $this->get_cron_interval() * MINUTE_IN_SECONDS ), $this->cron_interval_identifier, $this->cron_hook_identifier );
 		}
 	}
 

tests/Test_WP_Background_Process.php

@@ -5,7 +5,7 @@
  * @package WP-Background-Processing
  */
 
- require_once __DIR__ . '/fixtures/Test_Batch_Data.php';
+require_once __DIR__ . '/fixtures/Test_Batch_Data.php';
 
 use PHPUnit\Framework\MockObject\MockObject;
 
@@ -208,31 +208,31 @@ public function test_get_batch() {
 		$this->assertEquals( array( $batch_data_object ), $this->getWPBPProperty( 'data' ) );
 		$this->wpbp->save();
 		$third_batch = $this->executeWPBPMethod( 'get_batch' );
-		$this->assertCount( 1,  $third_batch->data );
+		$this->assertCount( 1, $third_batch->data );
 		$this->assertInstanceOf( Test_Batch_Data::class, $third_batch->data[0] );
 
 		// Explicitly set allowed classes to Test_Batch_Data.
 		$this->setWPBPProperty( 'allowed_batch_data_classes', array( Test_Batch_Data::class ) );
 		$third_batch = $this->executeWPBPMethod( 'get_batch' );
-		$this->assertCount( 1,  $third_batch->data );
+		$this->assertCount( 1, $third_batch->data );
 		$this->assertInstanceOf( Test_Batch_Data::class, $third_batch->data[0] );
 
 		// Allow a different class.
 		$this->setWPBPProperty( 'allowed_batch_data_classes', array( stdClass::class ) );
 		$third_batch = $this->executeWPBPMethod( 'get_batch' );
-		$this->assertCount( 1,  $third_batch->data );
+		$this->assertCount( 1, $third_batch->data );
 		$this->assertInstanceOf( __PHP_Incomplete_Class::class, $third_batch->data[0] );
 
 		// Disallow all classes.
 		$this->setWPBPProperty( 'allowed_batch_data_classes', false );
 		$third_batch = $this->executeWPBPMethod( 'get_batch' );
-		$this->assertCount( 1,  $third_batch->data );
+		$this->assertCount( 1, $third_batch->data );
 		$this->assertInstanceOf( __PHP_Incomplete_Class::class, $third_batch->data[0] );
 
 		// Allow everything.
 		$this->setWPBPProperty( 'allowed_batch_data_classes', true );
 		$third_batch = $this->executeWPBPMethod( 'get_batch' );
-		$this->assertCount( 1,  $third_batch->data );
+		$this->assertCount( 1, $third_batch->data );
 		$this->assertInstanceOf( Test_Batch_Data::class, $third_batch->data[0] );
 	}
 
@@ -642,4 +642,31 @@ public function test_is_active() {
 		$this->wpbp->maybe_handle();
 		$this->assertFalse( $this->wpbp->is_active(), 'cancel handled, queue emptied, so no longer active' );
 	}
+
+	/**
+	 * Test get_cron_interval.
+	 *
+	 * @return void
+	 */
+	public function test_get_cron_interval() {
+		// Default value.
+		$this->assertEquals( 5, $this->wpbp->get_cron_interval() );
+
+		// Override via property (usually on subclass).
+		$this->wpbp->cron_interval = 3;
+		$this->assertEquals( 3, $this->wpbp->get_cron_interval() );
+
+		// Override via filter.
+		$callback = function ( $interval ) {
+			return 1;
+		};
+		add_filter( $this->getWPBPProperty( 'identifier' ) . '_cron_interval', $callback );
+		$this->assertEquals( 1, $this->wpbp->get_cron_interval() );
+
+		remove_filter( $this->getWPBPProperty( 'identifier' ) . '_cron_interval', $callback );
+		$this->assertEquals( 3, $this->wpbp->get_cron_interval() );
+
+		unset( $this->wpbp->cron_interval );
+		$this->assertEquals( 5, $this->wpbp->get_cron_interval() );
+	}
 }