ActionScheduler_AdminView::check_pastdue_actions │ protected │ WC 1.0

Check past-due actions, and print notice.

Method of the class: ActionScheduler_AdminView{}

Returns

null. Nothing (null).

Usage

// protected - for code of main (parent) or child class
$result = $this->check_pastdue_actions();

ActionScheduler_AdminView::check_pastdue_actions() ActionScheduler AdminView::check pastdue actions code ^{WC 10.3.6}

protected function check_pastdue_actions() {

	// Set thresholds.
	$threshold_seconds = (int) apply_filters( 'action_scheduler_pastdue_actions_seconds', DAY_IN_SECONDS );
	$threshold_min     = (int) apply_filters( 'action_scheduler_pastdue_actions_min', 1 );

	// Set fallback value for past-due actions count.
	$num_pastdue_actions = 0;

	// Allow third-parties to preempt the default check logic.
	$check = apply_filters( 'action_scheduler_pastdue_actions_check_pre', null );

	// If no third-party preempted and there are no past-due actions, return early.
	if ( ! is_null( $check ) ) {
		return;
	}

	// Scheduled actions query arguments.
	$query_args = array(
		'date'     => as_get_datetime_object( time() - $threshold_seconds ),
		'status'   => ActionScheduler_Store::STATUS_PENDING,
		'per_page' => $threshold_min,
	);

	// If no third-party preempted, run default check.
	if ( is_null( $check ) ) {
		$store               = ActionScheduler_Store::instance();
		$num_pastdue_actions = (int) $store->query_actions( $query_args, 'count' );

		// Check if past-due actions count is greater than or equal to threshold.
		$check = ( $num_pastdue_actions >= $threshold_min );
		$check = (bool) apply_filters( 'action_scheduler_pastdue_actions_check', $check, $num_pastdue_actions, $threshold_seconds, $threshold_min );
	}

	// If check failed, set transient and abort.
	if ( ! boolval( $check ) ) {
		$interval = apply_filters( 'action_scheduler_pastdue_actions_check_interval', round( $threshold_seconds / 4 ), $threshold_seconds );
		set_transient( 'action_scheduler_last_pastdue_actions_check', time(), $interval );

		return;
	}

	$actions_url = add_query_arg(
		array(
			'page'   => 'action-scheduler',
			'status' => 'past-due',
			'order'  => 'asc',
		),
		admin_url( 'tools.php' )
	);

	// Print notice.
	echo '<div class="notice notice-warning"><p>';
	printf(
		wp_kses(
			// translators: 1) is the number of affected actions, 2) is a link to an admin screen.
			_n(
				'<strong>Action Scheduler:</strong> %1$d <a href="%2$s">past-due action</a> found; something may be wrong. <a href="https://actionscheduler.org/faq/#my-site-has-past-due-actions-what-can-i-do" target="_blank">Read documentation &raquo;</a>',
				'<strong>Action Scheduler:</strong> %1$d <a href="%2$s">past-due actions</a> found; something may be wrong. <a href="https://actionscheduler.org/faq/#my-site-has-past-due-actions-what-can-i-do" target="_blank">Read documentation &raquo;</a>',
				$num_pastdue_actions,
				'woocommerce'
			),
			array(
				'strong' => array(),
				'a'      => array(
					'href'   => true,
					'target' => true,
				),
			)
		),
		absint( $num_pastdue_actions ),
		esc_attr( esc_url( $actions_url ) )
	);
	echo '</p></div>';

	// Facilitate third-parties to evaluate and print notices.
	do_action( 'action_scheduler_pastdue_actions_extra_notices', $query_args );
}