????
Current Path : /home/innovagencyco/public_html/statxpress/wp-content/plugins/wpforms-lite/src/Tasks/ |
Current File : /home/innovagencyco/public_html/statxpress/wp-content/plugins/wpforms-lite/src/Tasks/Task.php |
<?php namespace WPForms\Tasks; /** * Class Task. * * @since 1.5.9 */ class Task { /** * This task is async (runs asap). * * @since 1.5.9 */ const TYPE_ASYNC = 'async'; /** * This task is a recurring. * * @since 1.5.9 */ const TYPE_RECURRING = 'scheduled'; /** * This task is run once. * * @since 1.5.9 */ const TYPE_ONCE = 'once'; /** * Type of the task. * * @since 1.5.9 * * @var string */ private $type; /** * Action that will be used as a hook. * * @since 1.5.9 * * @var string */ private $action; /** * Task meta ID. * * @since 1.5.9 * * @var int */ private $meta_id; /** * All the params that should be passed to the hook. * * @since 1.5.9 * * @var array */ private $params; /** * When the first instance of the job will run. * Used for ONCE ane RECURRING tasks. * * @since 1.5.9 * * @var int */ private $timestamp; /** * How long to wait between runs. * Used for RECURRING tasks. * * @since 1.5.9 * * @var int */ private $interval; /** * Task meta. * * @since 1.7.0 * * @var Meta */ private $meta; /** * Log title. * * @since 1.9.1 * * @var string */ protected $log_title = 'Task'; /** * Task constructor. * * @since 1.5.9 * * @param string $action Action of the task. * * @throws \InvalidArgumentException When action is not a string. * @throws \UnexpectedValueException When action is empty. */ public function __construct( $action ) { if ( ! is_string( $action ) ) { throw new \InvalidArgumentException( 'Task action should be a string.' ); } $this->action = sanitize_key( $action ); $this->meta = new Meta(); if ( empty( $this->action ) ) { throw new \UnexpectedValueException( 'Task action cannot be empty.' ); } } /** * Define the type of the task as async. * * @since 1.5.9 * * @return \WPForms\Tasks\Task */ public function async() { $this->type = self::TYPE_ASYNC; return $this; } /** * Define the type of the task as recurring. * * @since 1.5.9 * * @param int $timestamp When the first instance of the job will run. * @param int $interval How long to wait between runs. * * @return \WPForms\Tasks\Task */ public function recurring( $timestamp, $interval ) { $this->type = self::TYPE_RECURRING; $this->timestamp = (int) $timestamp; $this->interval = (int) $interval; return $this; } /** * Define the type of the task as one-time. * * @since 1.5.9 * * @param int $timestamp When the first instance of the job will run. * * @return \WPForms\Tasks\Task */ public function once( $timestamp ) { $this->type = self::TYPE_ONCE; $this->timestamp = (int) $timestamp; return $this; } /** * Pass any number of params that should be saved to Meta table. * * @since 1.5.9 * * @return \WPForms\Tasks\Task */ public function params() { $this->params = func_get_args(); return $this; } /** * Register the action. * Should be the final call in a chain. * * @since 1.5.9 * * @return null|string Action ID. */ public function register() { $action_id = null; // No processing if ActionScheduler is not usable. if ( ! wpforms()->obj( 'tasks' )->is_usable() ) { return $action_id; } // Save data to tasks meta table. if ( $this->params !== null ) { $this->meta_id = $this->meta->add( [ 'action' => $this->action, 'data' => $this->params, ] ); if ( empty( $this->meta_id ) ) { return $action_id; } } // Prevent 500 errors when Action Scheduler tables don't exist. try { switch ( $this->type ) { case self::TYPE_ASYNC: $action_id = $this->register_async(); break; case self::TYPE_RECURRING: $action_id = $this->register_recurring(); break; case self::TYPE_ONCE: $action_id = $this->register_once(); break; } } catch ( \RuntimeException $exception ) { $action_id = null; } return $action_id; } /** * Register the async task. * * @since 1.5.9 * * @return null|string Action ID. */ protected function register_async() { if ( ! function_exists( 'as_enqueue_async_action' ) ) { return null; } return as_enqueue_async_action( $this->action, [ 'tasks_meta_id' => $this->meta_id ], Tasks::GROUP ); } /** * Register the recurring task. * * @since 1.5.9 * * @return null|string Action ID. */ protected function register_recurring() { if ( ! function_exists( 'as_schedule_recurring_action' ) ) { return null; } return as_schedule_recurring_action( $this->timestamp, $this->interval, $this->action, [ 'tasks_meta_id' => $this->meta_id ], Tasks::GROUP ); } /** * Register the one-time task. * * @since 1.5.9 * * @return null|string Action ID. */ protected function register_once() { if ( ! function_exists( 'as_schedule_single_action' ) ) { return null; } return as_schedule_single_action( $this->timestamp, $this->action, [ 'tasks_meta_id' => $this->meta_id ], Tasks::GROUP ); } /** * Cancel all occurrences of this task. * * @since 1.6.1 * * @return null|bool|string Null if no matching action found, * false if AS library is missing, * true if scheduled task has no params, * string of the scheduled action ID if a scheduled action was found and unscheduled. */ public function cancel() { if ( ! function_exists( 'as_unschedule_all_actions' ) ) { return false; } if ( $this->params === null ) { as_unschedule_all_actions( $this->action ); return true; } $this->meta_id = $this->meta->get_meta_id( $this->action, $this->params ); if ( $this->meta_id === null ) { return null; } return as_unschedule_action( $this->action, [ 'tasks_meta_id' => $this->meta_id ], Tasks::GROUP ); } /** * Log message to WPForms logger and standard debug.log file. * * @since 1.9.1 * * @param string $message The error message that should be logged. */ protected function log( $message ) { wpforms_log( $this->log_title, $message, [ 'type' => 'log' ] ); } }