HEX
Server: Apache/2.4.65 (Ubuntu)
System: Linux ielts-store-v2 6.8.0-1036-gcp #38~22.04.1-Ubuntu SMP Thu Aug 14 01:19:18 UTC 2025 x86_64
User: root (0)
PHP: 7.2.34-54+ubuntu20.04.1+deb.sury.org+1
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,
Upload Files
File: /var/www/html/ielts-store/wp-content/plugins/automatewoo/includes/Triggers/Wishlist_Reminder.php
<?php
// phpcs:ignoreFile

namespace AutomateWoo;

use AutomateWoo\Exceptions\InvalidArgument;
use AutomateWoo\Triggers\AbstractBatchedDailyTrigger;
use RuntimeException;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * @class Trigger_Wishlist_Reminder
 */
class Trigger_Wishlist_Reminder extends AbstractBatchedDailyTrigger {

	public $supplied_data_items = [ 'customer', 'wishlist' ];

	const SUPPORTS_QUEUING = false;

	function load_admin_details() {
		$this->title       = sprintf( __( 'Wishlist Reminder (%s)', 'automatewoo' ), Wishlists::get_integration_title() );
		$this->group       = __( 'Wishlists', 'automatewoo' );
		$this->description = __( "Setting the 'Reminder Interval' field to 30 means this trigger will fire every 30 days for any users that have items in their wishlist. Please note this doesn't work for guests because their wishlist data only exists locally in their browser.", 'automatewoo' );
		$this->description .= ' ' . $this->get_description_text_workflow_not_immediate();
	}


	/**
	 * Add options to the trigger
	 */
	function load_fields() {

		$period = new Fields\Positive_Number();
		$period->set_name( 'interval' );
		$period->set_title( __( 'Reminder interval (days)', 'automatewoo' ) );
		$period->set_description( __( 'E.g. Reminder any customers with items in a Wishlist every 30 days.', 'automatewoo' ) );
		$period->set_required();

		$once_only = new Fields\Checkbox();
		$once_only->set_name( 'once_only' );
		$once_only->set_title( __( 'Once per customer', 'automatewoo' ) );
		$once_only->set_description( __( 'If checked the trigger will fire only once for each customer for each wishlist they create. Most customers only use the one wishlist so use with caution. Setting a high Reminder interval may be a better plan.', 'automatewoo' ) );

		$this->add_field( $period );
		$this->add_field( $this->get_field_time_of_day() );
		$this->add_field( $once_only );
	}


	/**
	 * Get a batch of items to process for given workflow.
	 *
	 * @param Workflow $workflow
	 * @param int      $offset The batch query offset.
	 * @param int      $limit  The max items for the query.
	 *
	 * @return array[] Array of items in array format. Items will be stored in the database so they should be IDs not objects.
	 */
	public function get_batch_for_workflow( Workflow $workflow, int $offset, int $limit ): array {
		$tasks = [];

		foreach ( Wishlists::get_wishlist_ids( $limit, $offset ) as $wishlist_id ) {
			$tasks[] = [
				'wishlist' => $wishlist_id
			];
		}

		return $tasks;
	}

	/**
	 * Process a single item for a workflow to process.
	 *
	 * @param Workflow $workflow
	 * @param array    $item
	 *
	 * @throws InvalidArgument If wishlist is not set
	 * @throws RuntimeException If the item fails to be processed.
	 */
	public function process_item_for_workflow( Workflow $workflow, array $item ) {
		if ( ! isset( $item['wishlist'] ) ) {
			throw InvalidArgument::missing_required( 'wishlist' );
		}

		$wishlist = Wishlists::get_wishlist( absint( $item['wishlist'] ) );
		if ( ! $wishlist ) {
			throw new RuntimeException( 'Wishlist not found.' );
		}

		if ( ! $wishlist->get_customer() ) {
			throw new RuntimeException( 'Wishlist customer not found.' );
		}

		$workflow->maybe_run(
			[
				'customer' => $wishlist->get_customer(),
				'wishlist' => $wishlist
			]
		);
	}

	/**
	 * @param $workflow Workflow
	 *
	 * @return bool
	 */
	function validate_workflow( $workflow ) {
		$customer = $workflow->data_layer()->get_customer();
		$wishlist = $workflow->data_layer()->get_wishlist();

		if ( ! $customer || ! $wishlist ) {
			return false;
		}

		if ( ! $this->validate_wishlist_date_created( $workflow ) ) {
			return false;
		}

		// Only do this once for each user for each workflow and each wishlist
		if ( $workflow->get_trigger_option( 'once_only' ) ) {
			if ( $workflow->has_run_for_data_item( 'wishlist' ) ) {
				return false;
			}
		}

		$interval = absint( $workflow->get_trigger_option( 'interval' ) );

		if ( ! $interval ) {
			return false;
		}

		if ( $workflow->has_run_for_data_item( 'wishlist', $interval * DAY_IN_SECONDS ) ) {
			return false;
		}

		return true;
	}


	/**
	 * Check that the wishlist was created at least 1 interval ago by using the date created property.
	 *
	 * The date created property was added in v3.7 so we must assume that wishlists might not have this set.
	 *
	 * @param Workflow $workflow
	 *
	 * @return bool
	 */
	protected function validate_wishlist_date_created( $workflow ) {
		$wishlist = $workflow->data_layer()->get_wishlist();
		$interval = absint( $workflow->get_trigger_option( 'interval' ) );

		if ( ! $interval ) {
			return false;
		}

		$date_created = $wishlist->get_date_created();

		if ( ! $date_created ) {
			// no date set yet, so set to now and return invalid
			$wishlist->set_date_created( new DateTime() );

			return false;
		}

		$min_interval_date = new DateTime();
		$min_interval_date->modify( "-$interval days" );

		return $date_created->getTimestamp() < $min_interval_date->getTimestamp();
	}

}