abstract-wcs-scheduler.php
2.33 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
<?php
/**
* Base class for creating a scheduler
*
* Schedulers are responsible for triggering subscription events/action, like when a payment is due
* or subscription expires.
*
* @class WCS_Scheduler
* @version 2.0.0
* @package WooCommerce Subscriptions/Abstracts
* @category Abstract Class
* @author Prospress
*/
abstract class WCS_Scheduler {
/** @protected array The types of dates which this class should schedule */
protected $date_types_to_schedule;
public function __construct() {
add_action( 'init', array( $this, 'set_date_types_to_schedule' ) );
add_action( 'woocommerce_subscription_date_updated', array( &$this, 'update_date' ), 10, 3 );
add_action( 'woocommerce_subscription_date_deleted', array( &$this, 'delete_date' ), 10, 2 );
add_action( 'woocommerce_subscription_status_updated', array( &$this, 'update_status' ), 10, 3 );
}
public function set_date_types_to_schedule() {
$this->date_types_to_schedule = apply_filters( 'woocommerce_subscriptions_date_types_to_schedule', array_keys( wcs_get_subscription_date_types() ) );
}
/**
* When a subscription's date is updated, maybe schedule an event
*
* @param object $subscription An instance of a WC_Subscription object
* @param string $date_type Can be 'start', 'trial_end', 'next_payment', 'last_payment', 'end', 'end_of_prepaid_term' or a custom date type
* @param string $datetime A MySQL formated date/time string in the GMT/UTC timezone.
*/
abstract public function update_date( $subscription, $date_type, $datetime );
/**
* When a subscription's date is deleted, clear it from the scheduler
*
* @param object $subscription An instance of a WC_Subscription object
* @param string $date_type Can be 'start', 'trial_end', 'next_payment', 'last_payment', 'end', 'end_of_prepaid_term' or a custom date type
*/
abstract public function delete_date( $subscription, $date_type );
/**
* When a subscription's status is updated, maybe schedule an event
*
* @param object $subscription An instance of a WC_Subscription object
* @param string $date_type Can be 'start', 'trial_end', 'next_payment', 'last_payment', 'end', 'end_of_prepaid_term' or a custom date type
* @param string $datetime A MySQL formated date/time string in the GMT/UTC timezone.
*/
abstract public function update_status( $subscription, $new_status, $old_status );
}