@@ -12,27 +12,27 @@ |
||
12 | 12 | class TicketSelector |
13 | 13 | { |
14 | 14 | |
15 | - /** |
|
16 | - * Return the selector for the ticket option select input for the given event id. |
|
17 | - * @param int|string $event_id |
|
18 | - * @return string |
|
19 | - */ |
|
20 | - public static function ticketOptionByEventIdSelector($event_id) |
|
21 | - { |
|
22 | - return "//select[@id='ticket-selector-tbl-qty-slct-$event_id-1']"; |
|
23 | - } |
|
15 | + /** |
|
16 | + * Return the selector for the ticket option select input for the given event id. |
|
17 | + * @param int|string $event_id |
|
18 | + * @return string |
|
19 | + */ |
|
20 | + public static function ticketOptionByEventIdSelector($event_id) |
|
21 | + { |
|
22 | + return "//select[@id='ticket-selector-tbl-qty-slct-$event_id-1']"; |
|
23 | + } |
|
24 | 24 | |
25 | 25 | |
26 | - /** |
|
27 | - * Return the selector for the submit button for the ticket selector for the given event id. |
|
28 | - * @param int|string $event_id |
|
29 | - * @param bool $admin Used to return the selector from the context of the admin (true) or frontend (false) |
|
30 | - * @return string |
|
31 | - */ |
|
32 | - public static function ticketSelectionSubmitSelectorByEventId($event_id, $admin = false) |
|
33 | - { |
|
34 | - return $admin |
|
35 | - ? "#ee-new-registration-step-button" |
|
36 | - : "#ticket-selector-submit-$event_id-btn"; |
|
37 | - } |
|
26 | + /** |
|
27 | + * Return the selector for the submit button for the ticket selector for the given event id. |
|
28 | + * @param int|string $event_id |
|
29 | + * @param bool $admin Used to return the selector from the context of the admin (true) or frontend (false) |
|
30 | + * @return string |
|
31 | + */ |
|
32 | + public static function ticketSelectionSubmitSelectorByEventId($event_id, $admin = false) |
|
33 | + { |
|
34 | + return $admin |
|
35 | + ? "#ee-new-registration-step-button" |
|
36 | + : "#ticket-selector-submit-$event_id-btn"; |
|
37 | + } |
|
38 | 38 | } |
39 | 39 | \ No newline at end of file |
@@ -12,47 +12,47 @@ |
||
12 | 12 | class RegistrationsAdmin extends CoreAdmin |
13 | 13 | { |
14 | 14 | |
15 | - const REGISTRATION_STATUS_NOT_APPROVED = 'RNA'; |
|
16 | - const REGISTRATION_STATUS_APPROVED = 'RAP'; |
|
17 | - const REGISTRATION_STATUS_PENDING_PAYMENT = 'RPP'; |
|
18 | - const SEARCH_INPUT_SELECTOR_LIST_TABLE_REGISTRATION = '#event-espresso_page_espresso_registrations-search-input'; |
|
19 | - const BUTTON_ADD_NEW_REGISTRATION = '#add-new-registration'; |
|
20 | - const DROPDOWN_REGISTRATION_STATUS = '#reg-status-change-form-reg-status'; |
|
21 | - const BUTTON_UPDATE_REGISTRATION_STATUS = '#reg-status-change-form-submit-submit'; |
|
22 | - const DROPDOWN_SEND_RELATED_MESSAGES = '#reg-status-change-form-send-notifications'; |
|
23 | - |
|
24 | - |
|
25 | - /** |
|
26 | - * @param string $additional_params |
|
27 | - * @return string |
|
28 | - */ |
|
29 | - public static function registrationsDefaultAdminListTableUrl($additional_params = '') |
|
30 | - { |
|
31 | - return self::adminUrl('espresso_registrations', 'default', $additional_params); |
|
32 | - } |
|
33 | - |
|
34 | - |
|
35 | - /** |
|
36 | - * Given a registration id, this will return the selector for all the checkbox for that id. |
|
37 | - * Assumes the view is the default registrations list table. |
|
38 | - * @param int $registration_id |
|
39 | - * @return string |
|
40 | - */ |
|
41 | - public static function listTableCheckBoxSelectorForRegistrationId($registration_id) |
|
42 | - { |
|
43 | - return "//input[@name='_REG_ID[]' and @value='{$registration_id}']"; |
|
44 | - } |
|
45 | - |
|
46 | - |
|
47 | - /** |
|
48 | - * Given a registration id, this will return the selector for the link to the registration details. |
|
49 | - * Assumes the view is the default registrations list table. |
|
50 | - * @param int $registration_id |
|
51 | - * @return string |
|
52 | - */ |
|
53 | - public static function viewDetailsLinkSelectorForRegistrationId($registration_id) |
|
54 | - { |
|
55 | - return "//tbody[@id='the-list']/tr/td[contains(@class, 'column-_REG_ID') and contains(., $registration_id)]" |
|
56 | - . "//ancestor::tr/td[contains(@class, 'column-ATT_fname')]/a[1]"; |
|
57 | - } |
|
15 | + const REGISTRATION_STATUS_NOT_APPROVED = 'RNA'; |
|
16 | + const REGISTRATION_STATUS_APPROVED = 'RAP'; |
|
17 | + const REGISTRATION_STATUS_PENDING_PAYMENT = 'RPP'; |
|
18 | + const SEARCH_INPUT_SELECTOR_LIST_TABLE_REGISTRATION = '#event-espresso_page_espresso_registrations-search-input'; |
|
19 | + const BUTTON_ADD_NEW_REGISTRATION = '#add-new-registration'; |
|
20 | + const DROPDOWN_REGISTRATION_STATUS = '#reg-status-change-form-reg-status'; |
|
21 | + const BUTTON_UPDATE_REGISTRATION_STATUS = '#reg-status-change-form-submit-submit'; |
|
22 | + const DROPDOWN_SEND_RELATED_MESSAGES = '#reg-status-change-form-send-notifications'; |
|
23 | + |
|
24 | + |
|
25 | + /** |
|
26 | + * @param string $additional_params |
|
27 | + * @return string |
|
28 | + */ |
|
29 | + public static function registrationsDefaultAdminListTableUrl($additional_params = '') |
|
30 | + { |
|
31 | + return self::adminUrl('espresso_registrations', 'default', $additional_params); |
|
32 | + } |
|
33 | + |
|
34 | + |
|
35 | + /** |
|
36 | + * Given a registration id, this will return the selector for all the checkbox for that id. |
|
37 | + * Assumes the view is the default registrations list table. |
|
38 | + * @param int $registration_id |
|
39 | + * @return string |
|
40 | + */ |
|
41 | + public static function listTableCheckBoxSelectorForRegistrationId($registration_id) |
|
42 | + { |
|
43 | + return "//input[@name='_REG_ID[]' and @value='{$registration_id}']"; |
|
44 | + } |
|
45 | + |
|
46 | + |
|
47 | + /** |
|
48 | + * Given a registration id, this will return the selector for the link to the registration details. |
|
49 | + * Assumes the view is the default registrations list table. |
|
50 | + * @param int $registration_id |
|
51 | + * @return string |
|
52 | + */ |
|
53 | + public static function viewDetailsLinkSelectorForRegistrationId($registration_id) |
|
54 | + { |
|
55 | + return "//tbody[@id='the-list']/tr/td[contains(@class, 'column-_REG_ID') and contains(., $registration_id)]" |
|
56 | + . "//ancestor::tr/td[contains(@class, 'column-ATT_fname')]/a[1]"; |
|
57 | + } |
|
58 | 58 | } |
59 | 59 | \ No newline at end of file |
@@ -13,71 +13,71 @@ |
||
13 | 13 | class Checkout |
14 | 14 | { |
15 | 15 | |
16 | - /** |
|
17 | - * The class selector for the next step button in the checkout. |
|
18 | - * @var string |
|
19 | - */ |
|
20 | - const NEXT_STEP_BUTTON_SELECTOR = '.spco-next-step-btn'; |
|
21 | - |
|
22 | - |
|
23 | - const PAYMENT_METHOD_STEP_FORM = '#ee-spco-payment_options-reg-step-form'; |
|
24 | - |
|
25 | - |
|
26 | - const SELECTOR_PAYMENT_OPTIONS_CONTAINER = '#spco-available-methods-of-payment-dv'; |
|
27 | - |
|
28 | - |
|
29 | - /** |
|
30 | - * @param int $attendee_number |
|
31 | - * @param bool $admin Used to indicate whether we're retrieving the selector from the context of the admin or not. |
|
32 | - * @return string |
|
33 | - */ |
|
34 | - public static function firstNameFieldSelectorForAttendeeNumber($attendee_number = 1, $admin = false) |
|
35 | - { |
|
36 | - return self::fieldSelectorForAttendeeNumber('fname', $attendee_number, $admin); |
|
37 | - } |
|
38 | - |
|
39 | - |
|
40 | - /** |
|
41 | - * @param int $attendee_number |
|
42 | - * @param bool $admin Used to indicate whether we're retrieving the selector from the context of the admin or not. |
|
43 | - * @return string |
|
44 | - */ |
|
45 | - public static function lastNameFieldSelectorForAttendeeNumber($attendee_number = 1, $admin = false) |
|
46 | - { |
|
47 | - return self::fieldSelectorForAttendeeNumber('lname', $attendee_number, $admin); |
|
48 | - } |
|
49 | - |
|
50 | - |
|
51 | - /** |
|
52 | - * @param int $attendee_number |
|
53 | - * @param bool $admin Used to indicate whether we're retrieving the selector from the context of the admin or not. |
|
54 | - * @return string |
|
55 | - */ |
|
56 | - public static function emailFieldSelectorForAttendeeNumber($attendee_number = 1, $admin = false) |
|
57 | - { |
|
58 | - return self::fieldSelectorForAttendeeNumber('email', $attendee_number, $admin); |
|
59 | - } |
|
60 | - |
|
61 | - /** |
|
62 | - * @param string $field_name |
|
63 | - * @param int $attendee_number |
|
64 | - * @param bool $admin Used to indicate whether we're retrieving the selector from the context of the admin or not. |
|
65 | - * @return string |
|
66 | - */ |
|
67 | - public static function fieldSelectorForAttendeeNumber($field_name, $attendee_number = 1, $admin = false) |
|
68 | - { |
|
69 | - return $admin |
|
70 | - ? "//fieldset[starts-with(@id, 'ee-registration-$attendee_number')]//input[contains(@class, 'ee-reg-qstn-$field_name')]" |
|
71 | - : "//div[starts-with(@id, 'spco-attendee-panel-dv-$attendee_number')]//input[contains(@class, 'ee-reg-qstn-$field_name')]"; |
|
72 | - } |
|
73 | - |
|
74 | - |
|
75 | - /** |
|
76 | - * @param string $payment_method_slug Slug for the payment method. |
|
77 | - * @return string |
|
78 | - */ |
|
79 | - public static function fieldSelectorForPaymentOption($payment_method_slug) |
|
80 | - { |
|
81 | - return "#ee-available-payment-method-inputs-{$payment_method_slug}"; |
|
82 | - } |
|
16 | + /** |
|
17 | + * The class selector for the next step button in the checkout. |
|
18 | + * @var string |
|
19 | + */ |
|
20 | + const NEXT_STEP_BUTTON_SELECTOR = '.spco-next-step-btn'; |
|
21 | + |
|
22 | + |
|
23 | + const PAYMENT_METHOD_STEP_FORM = '#ee-spco-payment_options-reg-step-form'; |
|
24 | + |
|
25 | + |
|
26 | + const SELECTOR_PAYMENT_OPTIONS_CONTAINER = '#spco-available-methods-of-payment-dv'; |
|
27 | + |
|
28 | + |
|
29 | + /** |
|
30 | + * @param int $attendee_number |
|
31 | + * @param bool $admin Used to indicate whether we're retrieving the selector from the context of the admin or not. |
|
32 | + * @return string |
|
33 | + */ |
|
34 | + public static function firstNameFieldSelectorForAttendeeNumber($attendee_number = 1, $admin = false) |
|
35 | + { |
|
36 | + return self::fieldSelectorForAttendeeNumber('fname', $attendee_number, $admin); |
|
37 | + } |
|
38 | + |
|
39 | + |
|
40 | + /** |
|
41 | + * @param int $attendee_number |
|
42 | + * @param bool $admin Used to indicate whether we're retrieving the selector from the context of the admin or not. |
|
43 | + * @return string |
|
44 | + */ |
|
45 | + public static function lastNameFieldSelectorForAttendeeNumber($attendee_number = 1, $admin = false) |
|
46 | + { |
|
47 | + return self::fieldSelectorForAttendeeNumber('lname', $attendee_number, $admin); |
|
48 | + } |
|
49 | + |
|
50 | + |
|
51 | + /** |
|
52 | + * @param int $attendee_number |
|
53 | + * @param bool $admin Used to indicate whether we're retrieving the selector from the context of the admin or not. |
|
54 | + * @return string |
|
55 | + */ |
|
56 | + public static function emailFieldSelectorForAttendeeNumber($attendee_number = 1, $admin = false) |
|
57 | + { |
|
58 | + return self::fieldSelectorForAttendeeNumber('email', $attendee_number, $admin); |
|
59 | + } |
|
60 | + |
|
61 | + /** |
|
62 | + * @param string $field_name |
|
63 | + * @param int $attendee_number |
|
64 | + * @param bool $admin Used to indicate whether we're retrieving the selector from the context of the admin or not. |
|
65 | + * @return string |
|
66 | + */ |
|
67 | + public static function fieldSelectorForAttendeeNumber($field_name, $attendee_number = 1, $admin = false) |
|
68 | + { |
|
69 | + return $admin |
|
70 | + ? "//fieldset[starts-with(@id, 'ee-registration-$attendee_number')]//input[contains(@class, 'ee-reg-qstn-$field_name')]" |
|
71 | + : "//div[starts-with(@id, 'spco-attendee-panel-dv-$attendee_number')]//input[contains(@class, 'ee-reg-qstn-$field_name')]"; |
|
72 | + } |
|
73 | + |
|
74 | + |
|
75 | + /** |
|
76 | + * @param string $payment_method_slug Slug for the payment method. |
|
77 | + * @return string |
|
78 | + */ |
|
79 | + public static function fieldSelectorForPaymentOption($payment_method_slug) |
|
80 | + { |
|
81 | + return "#ee-available-payment-method-inputs-{$payment_method_slug}"; |
|
82 | + } |
|
83 | 83 | } |
@@ -66,24 +66,24 @@ discard block |
||
66 | 66 | public function ticketDatetimeAvailability(EE_Ticket $ticket, $get_original_ticket_spaces = false) |
67 | 67 | { |
68 | 68 | // if the $_available_spaces array has not been set up yet... |
69 | - if (! isset($this->available_spaces['tickets'][ $ticket->ID() ])) { |
|
69 | + if ( ! isset($this->available_spaces['tickets'][$ticket->ID()])) { |
|
70 | 70 | $this->setInitialTicketDatetimeAvailability($ticket); |
71 | 71 | } |
72 | 72 | $available_spaces = $ticket->qty() - $ticket->sold(); |
73 | - if (isset($this->available_spaces['tickets'][ $ticket->ID() ])) { |
|
73 | + if (isset($this->available_spaces['tickets'][$ticket->ID()])) { |
|
74 | 74 | // loop thru tickets, which will ALSO include individual ticket records AND a total |
75 | - foreach ($this->available_spaces['tickets'][ $ticket->ID() ] as $DTD_ID => $spaces) { |
|
75 | + foreach ($this->available_spaces['tickets'][$ticket->ID()] as $DTD_ID => $spaces) { |
|
76 | 76 | // if we want the original datetime availability BEFORE we started subtracting tickets ? |
77 | 77 | if ($get_original_ticket_spaces) { |
78 | 78 | // then grab the available spaces from the "tickets" array |
79 | 79 | // and compare with the above to get the lowest number |
80 | 80 | $available_spaces = min( |
81 | 81 | $available_spaces, |
82 | - $this->available_spaces['tickets'][ $ticket->ID() ][ $DTD_ID ] |
|
82 | + $this->available_spaces['tickets'][$ticket->ID()][$DTD_ID] |
|
83 | 83 | ); |
84 | 84 | } else { |
85 | 85 | // we want the updated ticket availability as stored in the "datetimes" array |
86 | - $available_spaces = min($available_spaces, $this->available_spaces['datetimes'][ $DTD_ID ]); |
|
86 | + $available_spaces = min($available_spaces, $this->available_spaces['datetimes'][$DTD_ID]); |
|
87 | 87 | } |
88 | 88 | } |
89 | 89 | } |
@@ -114,7 +114,7 @@ discard block |
||
114 | 114 | 'order_by' => array('DTT_EVT_start' => 'ASC'), |
115 | 115 | ) |
116 | 116 | ); |
117 | - if (! empty($datetimes)) { |
|
117 | + if ( ! empty($datetimes)) { |
|
118 | 118 | // now loop thru all of the datetimes |
119 | 119 | foreach ($datetimes as $datetime) { |
120 | 120 | if ($datetime instanceof EE_Datetime) { |
@@ -122,17 +122,17 @@ discard block |
||
122 | 122 | $spaces_remaining = $datetime->spaces_remaining(); |
123 | 123 | // save the total available spaces ( the lesser of the ticket qty minus the number of tickets sold |
124 | 124 | // or the datetime spaces remaining) to this ticket using the datetime ID as the key |
125 | - $this->available_spaces['tickets'][ $ticket->ID() ][ $datetime->ID() ] = min( |
|
125 | + $this->available_spaces['tickets'][$ticket->ID()][$datetime->ID()] = min( |
|
126 | 126 | $ticket->qty() - $ticket->sold(), |
127 | 127 | $spaces_remaining |
128 | 128 | ); |
129 | 129 | // if the remaining spaces for this datetime is already set, |
130 | 130 | // then compare that against the datetime spaces remaining, and take the lowest number, |
131 | 131 | // else just take the datetime spaces remaining, and assign to the datetimes array |
132 | - $this->available_spaces['datetimes'][ $datetime->ID() ] = isset( |
|
133 | - $this->available_spaces['datetimes'][ $datetime->ID() ] |
|
132 | + $this->available_spaces['datetimes'][$datetime->ID()] = isset( |
|
133 | + $this->available_spaces['datetimes'][$datetime->ID()] |
|
134 | 134 | ) |
135 | - ? min($this->available_spaces['datetimes'][ $datetime->ID() ], $spaces_remaining) |
|
135 | + ? min($this->available_spaces['datetimes'][$datetime->ID()], $spaces_remaining) |
|
136 | 136 | : $spaces_remaining; |
137 | 137 | } |
138 | 138 | } |
@@ -148,11 +148,11 @@ discard block |
||
148 | 148 | */ |
149 | 149 | public function recalculateTicketDatetimeAvailability(EE_Ticket $ticket, $qty = 0) |
150 | 150 | { |
151 | - if (isset($this->available_spaces['tickets'][ $ticket->ID() ])) { |
|
151 | + if (isset($this->available_spaces['tickets'][$ticket->ID()])) { |
|
152 | 152 | // loop thru tickets, which will ALSO include individual ticket records AND a total |
153 | - foreach ($this->available_spaces['tickets'][ $ticket->ID() ] as $DTD_ID => $spaces) { |
|
153 | + foreach ($this->available_spaces['tickets'][$ticket->ID()] as $DTD_ID => $spaces) { |
|
154 | 154 | // subtract the qty of selected tickets from each datetime's available spaces this ticket has access to, |
155 | - $this->available_spaces['datetimes'][ $DTD_ID ] -= $qty; |
|
155 | + $this->available_spaces['datetimes'][$DTD_ID] -= $qty; |
|
156 | 156 | } |
157 | 157 | } |
158 | 158 | } |
@@ -21,217 +21,217 @@ |
||
21 | 21 | */ |
22 | 22 | class TicketDatetimeAvailabilityTracker |
23 | 23 | { |
24 | - /** |
|
25 | - * array of datetimes and the spaces available for them |
|
26 | - * |
|
27 | - * @var array[][] |
|
28 | - */ |
|
29 | - private $available_spaces = array(); |
|
30 | - |
|
31 | - /** |
|
32 | - * @var EEM_Datetime $datetime_model |
|
33 | - */ |
|
34 | - private $datetime_model; |
|
35 | - |
|
36 | - |
|
37 | - /** |
|
38 | - * TicketDatetimeAvailabilityTracker constructor. |
|
39 | - * |
|
40 | - * @param EEM_Datetime $datetime_model |
|
41 | - */ |
|
42 | - public function __construct(EEM_Datetime $datetime_model) |
|
43 | - { |
|
44 | - $this->datetime_model = $datetime_model; |
|
45 | - } |
|
46 | - |
|
47 | - |
|
48 | - /** |
|
49 | - * ticketDatetimeAvailability |
|
50 | - * creates an array of tickets plus all of the datetimes available to each ticket |
|
51 | - * and tracks the spaces remaining for each of those datetimes |
|
52 | - * |
|
53 | - * @param EE_Ticket $ticket - selected ticket |
|
54 | - * @param bool $get_original_ticket_spaces |
|
55 | - * @return int |
|
56 | - * @throws EE_Error |
|
57 | - * @throws InvalidArgumentException |
|
58 | - * @throws InvalidDataTypeException |
|
59 | - * @throws InvalidInterfaceException |
|
60 | - */ |
|
61 | - public function ticketDatetimeAvailability(EE_Ticket $ticket, $get_original_ticket_spaces = false) |
|
62 | - { |
|
63 | - // if the $_available_spaces array has not been set up yet... |
|
64 | - if (! isset($this->available_spaces['tickets'][ $ticket->ID() ])) { |
|
65 | - $this->setInitialTicketDatetimeAvailability($ticket); |
|
66 | - } |
|
67 | - $available_spaces = $ticket->qty() - $ticket->sold(); |
|
68 | - if (isset($this->available_spaces['tickets'][ $ticket->ID() ])) { |
|
69 | - // loop thru tickets, which will ALSO include individual ticket records AND a total |
|
70 | - foreach ($this->available_spaces['tickets'][ $ticket->ID() ] as $DTD_ID => $spaces) { |
|
71 | - // if we want the original datetime availability BEFORE we started subtracting tickets ? |
|
72 | - if ($get_original_ticket_spaces) { |
|
73 | - // then grab the available spaces from the "tickets" array |
|
74 | - // and compare with the above to get the lowest number |
|
75 | - $available_spaces = min( |
|
76 | - $available_spaces, |
|
77 | - $this->available_spaces['tickets'][ $ticket->ID() ][ $DTD_ID ] |
|
78 | - ); |
|
79 | - } else { |
|
80 | - // we want the updated ticket availability as stored in the "datetimes" array |
|
81 | - $available_spaces = min($available_spaces, $this->available_spaces['datetimes'][ $DTD_ID ]); |
|
82 | - } |
|
83 | - } |
|
84 | - } |
|
85 | - return $available_spaces; |
|
86 | - } |
|
87 | - |
|
88 | - |
|
89 | - /** |
|
90 | - * @param EE_Ticket $ticket |
|
91 | - * @return void |
|
92 | - * @throws InvalidArgumentException |
|
93 | - * @throws InvalidInterfaceException |
|
94 | - * @throws InvalidDataTypeException |
|
95 | - * @throws EE_Error |
|
96 | - */ |
|
97 | - private function setInitialTicketDatetimeAvailability(EE_Ticket $ticket) |
|
98 | - { |
|
99 | - // first, get all of the datetimes that are available to this ticket |
|
100 | - $datetimes = $ticket->get_many_related( |
|
101 | - 'Datetime', |
|
102 | - array( |
|
103 | - array( |
|
104 | - 'DTT_EVT_end' => array( |
|
105 | - '>=', |
|
106 | - $this->datetime_model->current_time_for_query('DTT_EVT_end'), |
|
107 | - ), |
|
108 | - ), |
|
109 | - 'order_by' => array('DTT_EVT_start' => 'ASC'), |
|
110 | - ) |
|
111 | - ); |
|
112 | - if (! empty($datetimes)) { |
|
113 | - // now loop thru all of the datetimes |
|
114 | - foreach ($datetimes as $datetime) { |
|
115 | - if ($datetime instanceof EE_Datetime) { |
|
116 | - // the number of spaces available for the datetime without considering individual ticket quantities |
|
117 | - $spaces_remaining = $datetime->spaces_remaining(); |
|
118 | - // save the total available spaces ( the lesser of the ticket qty minus the number of tickets sold |
|
119 | - // or the datetime spaces remaining) to this ticket using the datetime ID as the key |
|
120 | - $this->available_spaces['tickets'][ $ticket->ID() ][ $datetime->ID() ] = min( |
|
121 | - $ticket->qty() - $ticket->sold(), |
|
122 | - $spaces_remaining |
|
123 | - ); |
|
124 | - // if the remaining spaces for this datetime is already set, |
|
125 | - // then compare that against the datetime spaces remaining, and take the lowest number, |
|
126 | - // else just take the datetime spaces remaining, and assign to the datetimes array |
|
127 | - $this->available_spaces['datetimes'][ $datetime->ID() ] = isset( |
|
128 | - $this->available_spaces['datetimes'][ $datetime->ID() ] |
|
129 | - ) |
|
130 | - ? min($this->available_spaces['datetimes'][ $datetime->ID() ], $spaces_remaining) |
|
131 | - : $spaces_remaining; |
|
132 | - } |
|
133 | - } |
|
134 | - } |
|
135 | - } |
|
136 | - |
|
137 | - |
|
138 | - /** |
|
139 | - * @param EE_Ticket $ticket |
|
140 | - * @param int $qty |
|
141 | - * @return void |
|
142 | - * @throws EE_Error |
|
143 | - */ |
|
144 | - public function recalculateTicketDatetimeAvailability(EE_Ticket $ticket, $qty = 0) |
|
145 | - { |
|
146 | - if (isset($this->available_spaces['tickets'][ $ticket->ID() ])) { |
|
147 | - // loop thru tickets, which will ALSO include individual ticket records AND a total |
|
148 | - foreach ($this->available_spaces['tickets'][ $ticket->ID() ] as $DTD_ID => $spaces) { |
|
149 | - // subtract the qty of selected tickets from each datetime's available spaces this ticket has access to, |
|
150 | - $this->available_spaces['datetimes'][ $DTD_ID ] -= $qty; |
|
151 | - } |
|
152 | - } |
|
153 | - } |
|
154 | - |
|
155 | - |
|
156 | - /** |
|
157 | - * @param EE_Ticket $ticket |
|
158 | - * @param $qty |
|
159 | - * @param int $total_ticket_count |
|
160 | - * @throws EE_Error |
|
161 | - * @throws InvalidArgumentException |
|
162 | - * @throws InvalidDataTypeException |
|
163 | - * @throws InvalidInterfaceException |
|
164 | - */ |
|
165 | - public function processAvailabilityError(EE_Ticket $ticket, $qty, $total_ticket_count = 1) |
|
166 | - { |
|
167 | - // tickets can not be purchased but let's find the exact number left |
|
168 | - // for the last ticket selected PRIOR to subtracting tickets |
|
169 | - $available_spaces = $this->ticketDatetimeAvailability($ticket, true); |
|
170 | - // greedy greedy greedy eh? |
|
171 | - if ($available_spaces > 0) { |
|
172 | - if ( |
|
173 | - apply_filters( |
|
174 | - 'FHEE__EE_Ticket_Selector___add_ticket_to_cart__allow_display_availability_error', |
|
175 | - true, |
|
176 | - $ticket, |
|
177 | - $qty, |
|
178 | - $available_spaces |
|
179 | - ) |
|
180 | - ) { |
|
181 | - $this->availabilityError( |
|
182 | - $available_spaces, |
|
183 | - $total_ticket_count |
|
184 | - ); |
|
185 | - } |
|
186 | - } else { |
|
187 | - EE_Error::add_error( |
|
188 | - esc_html__( |
|
189 | - 'We\'re sorry, but there are no available spaces left for this event at this particular date and time.', |
|
190 | - 'event_espresso' |
|
191 | - ), |
|
192 | - __FILE__, |
|
193 | - __FUNCTION__, |
|
194 | - __LINE__ |
|
195 | - ); |
|
196 | - } |
|
197 | - } |
|
198 | - |
|
199 | - |
|
200 | - /** |
|
201 | - * @param int $available_spaces |
|
202 | - * @param int $total_ticket_count |
|
203 | - */ |
|
204 | - private function availabilityError($available_spaces = 1, $total_ticket_count = 1) |
|
205 | - { |
|
206 | - // add error messaging - we're using the _n function that will generate |
|
207 | - // the appropriate singular or plural message based on the number of $available_spaces |
|
208 | - if ($total_ticket_count) { |
|
209 | - $msg = sprintf( |
|
210 | - esc_html( |
|
211 | - _n( |
|
212 | - 'We\'re sorry, but there is only %1$s available space left for this event at this particular date and time. Please select a different number (or different combination) of tickets by cancelling the current selection and choosing again, or proceed to registration.', |
|
213 | - 'We\'re sorry, but there are only %1$s available spaces left for this event at this particular date and time. Please select a different number (or different combination) of tickets by cancelling the current selection and choosing again, or proceed to registration.', |
|
214 | - $available_spaces, |
|
215 | - 'event_espresso' |
|
216 | - ) |
|
217 | - ), |
|
218 | - $available_spaces, |
|
219 | - '<br />' |
|
220 | - ); |
|
221 | - } else { |
|
222 | - $msg = sprintf( |
|
223 | - esc_html( |
|
224 | - _n( |
|
225 | - 'We\'re sorry, but there is only %1$s available space left for this event at this particular date and time. Please select a different number (or different combination) of tickets.', |
|
226 | - 'We\'re sorry, but there are only %1$s available spaces left for this event at this particular date and time. Please select a different number (or different combination) of tickets.', |
|
227 | - $available_spaces, |
|
228 | - 'event_espresso' |
|
229 | - ) |
|
230 | - ), |
|
231 | - $available_spaces, |
|
232 | - '<br />' |
|
233 | - ); |
|
234 | - } |
|
235 | - EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__); |
|
236 | - } |
|
24 | + /** |
|
25 | + * array of datetimes and the spaces available for them |
|
26 | + * |
|
27 | + * @var array[][] |
|
28 | + */ |
|
29 | + private $available_spaces = array(); |
|
30 | + |
|
31 | + /** |
|
32 | + * @var EEM_Datetime $datetime_model |
|
33 | + */ |
|
34 | + private $datetime_model; |
|
35 | + |
|
36 | + |
|
37 | + /** |
|
38 | + * TicketDatetimeAvailabilityTracker constructor. |
|
39 | + * |
|
40 | + * @param EEM_Datetime $datetime_model |
|
41 | + */ |
|
42 | + public function __construct(EEM_Datetime $datetime_model) |
|
43 | + { |
|
44 | + $this->datetime_model = $datetime_model; |
|
45 | + } |
|
46 | + |
|
47 | + |
|
48 | + /** |
|
49 | + * ticketDatetimeAvailability |
|
50 | + * creates an array of tickets plus all of the datetimes available to each ticket |
|
51 | + * and tracks the spaces remaining for each of those datetimes |
|
52 | + * |
|
53 | + * @param EE_Ticket $ticket - selected ticket |
|
54 | + * @param bool $get_original_ticket_spaces |
|
55 | + * @return int |
|
56 | + * @throws EE_Error |
|
57 | + * @throws InvalidArgumentException |
|
58 | + * @throws InvalidDataTypeException |
|
59 | + * @throws InvalidInterfaceException |
|
60 | + */ |
|
61 | + public function ticketDatetimeAvailability(EE_Ticket $ticket, $get_original_ticket_spaces = false) |
|
62 | + { |
|
63 | + // if the $_available_spaces array has not been set up yet... |
|
64 | + if (! isset($this->available_spaces['tickets'][ $ticket->ID() ])) { |
|
65 | + $this->setInitialTicketDatetimeAvailability($ticket); |
|
66 | + } |
|
67 | + $available_spaces = $ticket->qty() - $ticket->sold(); |
|
68 | + if (isset($this->available_spaces['tickets'][ $ticket->ID() ])) { |
|
69 | + // loop thru tickets, which will ALSO include individual ticket records AND a total |
|
70 | + foreach ($this->available_spaces['tickets'][ $ticket->ID() ] as $DTD_ID => $spaces) { |
|
71 | + // if we want the original datetime availability BEFORE we started subtracting tickets ? |
|
72 | + if ($get_original_ticket_spaces) { |
|
73 | + // then grab the available spaces from the "tickets" array |
|
74 | + // and compare with the above to get the lowest number |
|
75 | + $available_spaces = min( |
|
76 | + $available_spaces, |
|
77 | + $this->available_spaces['tickets'][ $ticket->ID() ][ $DTD_ID ] |
|
78 | + ); |
|
79 | + } else { |
|
80 | + // we want the updated ticket availability as stored in the "datetimes" array |
|
81 | + $available_spaces = min($available_spaces, $this->available_spaces['datetimes'][ $DTD_ID ]); |
|
82 | + } |
|
83 | + } |
|
84 | + } |
|
85 | + return $available_spaces; |
|
86 | + } |
|
87 | + |
|
88 | + |
|
89 | + /** |
|
90 | + * @param EE_Ticket $ticket |
|
91 | + * @return void |
|
92 | + * @throws InvalidArgumentException |
|
93 | + * @throws InvalidInterfaceException |
|
94 | + * @throws InvalidDataTypeException |
|
95 | + * @throws EE_Error |
|
96 | + */ |
|
97 | + private function setInitialTicketDatetimeAvailability(EE_Ticket $ticket) |
|
98 | + { |
|
99 | + // first, get all of the datetimes that are available to this ticket |
|
100 | + $datetimes = $ticket->get_many_related( |
|
101 | + 'Datetime', |
|
102 | + array( |
|
103 | + array( |
|
104 | + 'DTT_EVT_end' => array( |
|
105 | + '>=', |
|
106 | + $this->datetime_model->current_time_for_query('DTT_EVT_end'), |
|
107 | + ), |
|
108 | + ), |
|
109 | + 'order_by' => array('DTT_EVT_start' => 'ASC'), |
|
110 | + ) |
|
111 | + ); |
|
112 | + if (! empty($datetimes)) { |
|
113 | + // now loop thru all of the datetimes |
|
114 | + foreach ($datetimes as $datetime) { |
|
115 | + if ($datetime instanceof EE_Datetime) { |
|
116 | + // the number of spaces available for the datetime without considering individual ticket quantities |
|
117 | + $spaces_remaining = $datetime->spaces_remaining(); |
|
118 | + // save the total available spaces ( the lesser of the ticket qty minus the number of tickets sold |
|
119 | + // or the datetime spaces remaining) to this ticket using the datetime ID as the key |
|
120 | + $this->available_spaces['tickets'][ $ticket->ID() ][ $datetime->ID() ] = min( |
|
121 | + $ticket->qty() - $ticket->sold(), |
|
122 | + $spaces_remaining |
|
123 | + ); |
|
124 | + // if the remaining spaces for this datetime is already set, |
|
125 | + // then compare that against the datetime spaces remaining, and take the lowest number, |
|
126 | + // else just take the datetime spaces remaining, and assign to the datetimes array |
|
127 | + $this->available_spaces['datetimes'][ $datetime->ID() ] = isset( |
|
128 | + $this->available_spaces['datetimes'][ $datetime->ID() ] |
|
129 | + ) |
|
130 | + ? min($this->available_spaces['datetimes'][ $datetime->ID() ], $spaces_remaining) |
|
131 | + : $spaces_remaining; |
|
132 | + } |
|
133 | + } |
|
134 | + } |
|
135 | + } |
|
136 | + |
|
137 | + |
|
138 | + /** |
|
139 | + * @param EE_Ticket $ticket |
|
140 | + * @param int $qty |
|
141 | + * @return void |
|
142 | + * @throws EE_Error |
|
143 | + */ |
|
144 | + public function recalculateTicketDatetimeAvailability(EE_Ticket $ticket, $qty = 0) |
|
145 | + { |
|
146 | + if (isset($this->available_spaces['tickets'][ $ticket->ID() ])) { |
|
147 | + // loop thru tickets, which will ALSO include individual ticket records AND a total |
|
148 | + foreach ($this->available_spaces['tickets'][ $ticket->ID() ] as $DTD_ID => $spaces) { |
|
149 | + // subtract the qty of selected tickets from each datetime's available spaces this ticket has access to, |
|
150 | + $this->available_spaces['datetimes'][ $DTD_ID ] -= $qty; |
|
151 | + } |
|
152 | + } |
|
153 | + } |
|
154 | + |
|
155 | + |
|
156 | + /** |
|
157 | + * @param EE_Ticket $ticket |
|
158 | + * @param $qty |
|
159 | + * @param int $total_ticket_count |
|
160 | + * @throws EE_Error |
|
161 | + * @throws InvalidArgumentException |
|
162 | + * @throws InvalidDataTypeException |
|
163 | + * @throws InvalidInterfaceException |
|
164 | + */ |
|
165 | + public function processAvailabilityError(EE_Ticket $ticket, $qty, $total_ticket_count = 1) |
|
166 | + { |
|
167 | + // tickets can not be purchased but let's find the exact number left |
|
168 | + // for the last ticket selected PRIOR to subtracting tickets |
|
169 | + $available_spaces = $this->ticketDatetimeAvailability($ticket, true); |
|
170 | + // greedy greedy greedy eh? |
|
171 | + if ($available_spaces > 0) { |
|
172 | + if ( |
|
173 | + apply_filters( |
|
174 | + 'FHEE__EE_Ticket_Selector___add_ticket_to_cart__allow_display_availability_error', |
|
175 | + true, |
|
176 | + $ticket, |
|
177 | + $qty, |
|
178 | + $available_spaces |
|
179 | + ) |
|
180 | + ) { |
|
181 | + $this->availabilityError( |
|
182 | + $available_spaces, |
|
183 | + $total_ticket_count |
|
184 | + ); |
|
185 | + } |
|
186 | + } else { |
|
187 | + EE_Error::add_error( |
|
188 | + esc_html__( |
|
189 | + 'We\'re sorry, but there are no available spaces left for this event at this particular date and time.', |
|
190 | + 'event_espresso' |
|
191 | + ), |
|
192 | + __FILE__, |
|
193 | + __FUNCTION__, |
|
194 | + __LINE__ |
|
195 | + ); |
|
196 | + } |
|
197 | + } |
|
198 | + |
|
199 | + |
|
200 | + /** |
|
201 | + * @param int $available_spaces |
|
202 | + * @param int $total_ticket_count |
|
203 | + */ |
|
204 | + private function availabilityError($available_spaces = 1, $total_ticket_count = 1) |
|
205 | + { |
|
206 | + // add error messaging - we're using the _n function that will generate |
|
207 | + // the appropriate singular or plural message based on the number of $available_spaces |
|
208 | + if ($total_ticket_count) { |
|
209 | + $msg = sprintf( |
|
210 | + esc_html( |
|
211 | + _n( |
|
212 | + 'We\'re sorry, but there is only %1$s available space left for this event at this particular date and time. Please select a different number (or different combination) of tickets by cancelling the current selection and choosing again, or proceed to registration.', |
|
213 | + 'We\'re sorry, but there are only %1$s available spaces left for this event at this particular date and time. Please select a different number (or different combination) of tickets by cancelling the current selection and choosing again, or proceed to registration.', |
|
214 | + $available_spaces, |
|
215 | + 'event_espresso' |
|
216 | + ) |
|
217 | + ), |
|
218 | + $available_spaces, |
|
219 | + '<br />' |
|
220 | + ); |
|
221 | + } else { |
|
222 | + $msg = sprintf( |
|
223 | + esc_html( |
|
224 | + _n( |
|
225 | + 'We\'re sorry, but there is only %1$s available space left for this event at this particular date and time. Please select a different number (or different combination) of tickets.', |
|
226 | + 'We\'re sorry, but there are only %1$s available spaces left for this event at this particular date and time. Please select a different number (or different combination) of tickets.', |
|
227 | + $available_spaces, |
|
228 | + 'event_espresso' |
|
229 | + ) |
|
230 | + ), |
|
231 | + $available_spaces, |
|
232 | + '<br />' |
|
233 | + ); |
|
234 | + } |
|
235 | + EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__); |
|
236 | + } |
|
237 | 237 | } |
@@ -14,133 +14,133 @@ |
||
14 | 14 | trait EventsAdmin |
15 | 15 | { |
16 | 16 | |
17 | - /** |
|
18 | - * @param string $additional_params |
|
19 | - */ |
|
20 | - public function amOnDefaultEventsListTablePage($additional_params = '') |
|
21 | - { |
|
22 | - $this->actor()->amOnAdminPage(EventsPage::defaultEventsListTableUrl($additional_params)); |
|
23 | - } |
|
24 | - |
|
25 | - |
|
26 | - /** |
|
27 | - * Triggers the publishing of the Event. |
|
28 | - */ |
|
29 | - public function publishEvent() |
|
30 | - { |
|
31 | - $this->actor()->scrollTo(EventsPage::EVENT_EDITOR_TITLE_FIELD_SELECTOR); |
|
32 | - $this->actor()->wait(3); |
|
33 | - $this->actor()->click(EventsPage::EVENT_EDITOR_PUBLISH_BUTTON_SELECTOR); |
|
34 | - $this->actor()->waitForText('Event published.', 30); |
|
35 | - } |
|
36 | - |
|
37 | - |
|
38 | - /** |
|
39 | - * Triggers saving the Event. |
|
40 | - */ |
|
41 | - public function saveEvent() |
|
42 | - { |
|
43 | - $this->actor()->scrollTo(EventsPage::EVENT_EDITOR_TITLE_FIELD_SELECTOR); |
|
44 | - $this->actor()->wait(2); |
|
45 | - $this->actor()->click(EventsPage::EVENT_EDITOR_SAVE_BUTTON_SELECTOR); |
|
46 | - } |
|
47 | - |
|
48 | - |
|
49 | - /** |
|
50 | - * Navigates the actor to the event list table page and will attempt to edit the event for the given title. |
|
51 | - * First this will search using the given title and then attempt to edit from the results of the search. |
|
52 | - * |
|
53 | - * Assumes actor is already logged in. |
|
54 | - * @param $event_title |
|
55 | - */ |
|
56 | - public function amEditingTheEventWithTitle($event_title) |
|
57 | - { |
|
58 | - $this->amOnDefaultEventsListTablePage(); |
|
59 | - $this->actor()->fillField(EventsPage::EVENT_LIST_TABLE_SEARCH_INPUT_SELECTOR, $event_title); |
|
60 | - $this->actor()->click(CoreAdmin::LIST_TABLE_SEARCH_SUBMIT_SELECTOR); |
|
61 | - $this->actor()->waitForText($event_title, 15); |
|
62 | - $this->actor()->click(EventsPage::eventListTableEventTitleEditLinkSelectorForTitle($event_title)); |
|
63 | - } |
|
64 | - |
|
65 | - |
|
66 | - /** |
|
67 | - * Navigates the user to the single event page (frontend view) for the given event title via clicking the "View" |
|
68 | - * link for the event in the event list table. |
|
69 | - * Assumes the actor is already logged in and on the Event list table page. |
|
70 | - * |
|
71 | - * @param string $event_title |
|
72 | - */ |
|
73 | - public function amOnEventPageAfterClickingViewLinkInListTableForEvent($event_title) |
|
74 | - { |
|
75 | - $this->actor()->moveMouseOver(EventsPage::eventListTableEventTitleEditLinkSelectorForTitle($event_title)); |
|
76 | - $this->actor()->click(EventsPage::eventListTableEventTitleViewLinkSelectorForTitle($event_title)); |
|
77 | - } |
|
78 | - |
|
79 | - |
|
80 | - /** |
|
81 | - * Used to retrieve the event id for the event via the list table and for the given event. |
|
82 | - * @param string $event_title |
|
83 | - */ |
|
84 | - public function observeEventIdInListTableForEvent($event_title) |
|
85 | - { |
|
86 | - return $this->actor()->observeValueFromInputAt(EventsPage::eventListTableEventIdSelectorForTitle($event_title)); |
|
87 | - } |
|
88 | - |
|
89 | - |
|
90 | - /** |
|
91 | - * This performs the click action on the gear icon that triggers the advanced settings view state. |
|
92 | - * Assumes the actor is already logged in and editing an event. |
|
93 | - * |
|
94 | - * @param int $row_number What ticket row to toggle open/close. |
|
95 | - */ |
|
96 | - public function toggleAdvancedSettingsViewForTicketRow($row_number = 1) |
|
97 | - { |
|
98 | - $this->actor()->click(EventsPage::eventEditorTicketAdvancedDetailsSelector($row_number)); |
|
99 | - } |
|
100 | - |
|
101 | - |
|
102 | - /** |
|
103 | - * Toggles the TKT_is_taxable checkbox for the ticket in the given row. |
|
104 | - * Assumes the actor is already logged in and editing an event and that the advanced settings view state for that |
|
105 | - * ticket is "open". |
|
106 | - * |
|
107 | - * @param int $row_number What ticket row to toggle the checkbox for. |
|
108 | - */ |
|
109 | - public function toggleTicketIsTaxableForTicketRow($row_number = 1) |
|
110 | - { |
|
111 | - $this->actor()->click(EventsPage::eventEditorTicketTaxableCheckboxSelector($row_number)); |
|
112 | - } |
|
113 | - |
|
114 | - |
|
115 | - /** |
|
116 | - * Use to change the default registration status for the event. |
|
117 | - * Assumes the view is already on the event editor. |
|
118 | - * @param $registration_status |
|
119 | - */ |
|
120 | - public function changeDefaultRegistrationStatusTo($registration_status) |
|
121 | - { |
|
122 | - $this->actor()->selectOption( |
|
123 | - EventsPage::EVENT_EDITOR_DEFAULT_REGISTRATION_STATUS_FIELD_SELECTOR, |
|
124 | - $registration_status |
|
125 | - ); |
|
126 | - } |
|
127 | - |
|
128 | - |
|
129 | - /** |
|
130 | - * Use this from the context of the event editor to select the given custom template for a given message type and |
|
131 | - * messenger. |
|
132 | - * |
|
133 | - * @param string $message_type_label The visible label for the message type (eg Registration Approved) |
|
134 | - * @param string $messenger_slug The slug for the messenger (eg 'email') |
|
135 | - * @param string $custom_template_label The visible label in the select input for the custom template you want |
|
136 | - * selected. |
|
137 | - */ |
|
138 | - public function selectCustomTemplateFor($message_type_label, $messenger_slug, $custom_template_label) |
|
139 | - { |
|
140 | - $this->actor()->click(EventsPage::eventEditorNotificationsMetaBoxMessengerTabSelector($messenger_slug)); |
|
141 | - $this->actor()->selectOption( |
|
142 | - EventsPage::eventEditorNotificationsMetaBoxSelectSelectorForMessageType($message_type_label), |
|
143 | - $custom_template_label |
|
144 | - ); |
|
145 | - } |
|
17 | + /** |
|
18 | + * @param string $additional_params |
|
19 | + */ |
|
20 | + public function amOnDefaultEventsListTablePage($additional_params = '') |
|
21 | + { |
|
22 | + $this->actor()->amOnAdminPage(EventsPage::defaultEventsListTableUrl($additional_params)); |
|
23 | + } |
|
24 | + |
|
25 | + |
|
26 | + /** |
|
27 | + * Triggers the publishing of the Event. |
|
28 | + */ |
|
29 | + public function publishEvent() |
|
30 | + { |
|
31 | + $this->actor()->scrollTo(EventsPage::EVENT_EDITOR_TITLE_FIELD_SELECTOR); |
|
32 | + $this->actor()->wait(3); |
|
33 | + $this->actor()->click(EventsPage::EVENT_EDITOR_PUBLISH_BUTTON_SELECTOR); |
|
34 | + $this->actor()->waitForText('Event published.', 30); |
|
35 | + } |
|
36 | + |
|
37 | + |
|
38 | + /** |
|
39 | + * Triggers saving the Event. |
|
40 | + */ |
|
41 | + public function saveEvent() |
|
42 | + { |
|
43 | + $this->actor()->scrollTo(EventsPage::EVENT_EDITOR_TITLE_FIELD_SELECTOR); |
|
44 | + $this->actor()->wait(2); |
|
45 | + $this->actor()->click(EventsPage::EVENT_EDITOR_SAVE_BUTTON_SELECTOR); |
|
46 | + } |
|
47 | + |
|
48 | + |
|
49 | + /** |
|
50 | + * Navigates the actor to the event list table page and will attempt to edit the event for the given title. |
|
51 | + * First this will search using the given title and then attempt to edit from the results of the search. |
|
52 | + * |
|
53 | + * Assumes actor is already logged in. |
|
54 | + * @param $event_title |
|
55 | + */ |
|
56 | + public function amEditingTheEventWithTitle($event_title) |
|
57 | + { |
|
58 | + $this->amOnDefaultEventsListTablePage(); |
|
59 | + $this->actor()->fillField(EventsPage::EVENT_LIST_TABLE_SEARCH_INPUT_SELECTOR, $event_title); |
|
60 | + $this->actor()->click(CoreAdmin::LIST_TABLE_SEARCH_SUBMIT_SELECTOR); |
|
61 | + $this->actor()->waitForText($event_title, 15); |
|
62 | + $this->actor()->click(EventsPage::eventListTableEventTitleEditLinkSelectorForTitle($event_title)); |
|
63 | + } |
|
64 | + |
|
65 | + |
|
66 | + /** |
|
67 | + * Navigates the user to the single event page (frontend view) for the given event title via clicking the "View" |
|
68 | + * link for the event in the event list table. |
|
69 | + * Assumes the actor is already logged in and on the Event list table page. |
|
70 | + * |
|
71 | + * @param string $event_title |
|
72 | + */ |
|
73 | + public function amOnEventPageAfterClickingViewLinkInListTableForEvent($event_title) |
|
74 | + { |
|
75 | + $this->actor()->moveMouseOver(EventsPage::eventListTableEventTitleEditLinkSelectorForTitle($event_title)); |
|
76 | + $this->actor()->click(EventsPage::eventListTableEventTitleViewLinkSelectorForTitle($event_title)); |
|
77 | + } |
|
78 | + |
|
79 | + |
|
80 | + /** |
|
81 | + * Used to retrieve the event id for the event via the list table and for the given event. |
|
82 | + * @param string $event_title |
|
83 | + */ |
|
84 | + public function observeEventIdInListTableForEvent($event_title) |
|
85 | + { |
|
86 | + return $this->actor()->observeValueFromInputAt(EventsPage::eventListTableEventIdSelectorForTitle($event_title)); |
|
87 | + } |
|
88 | + |
|
89 | + |
|
90 | + /** |
|
91 | + * This performs the click action on the gear icon that triggers the advanced settings view state. |
|
92 | + * Assumes the actor is already logged in and editing an event. |
|
93 | + * |
|
94 | + * @param int $row_number What ticket row to toggle open/close. |
|
95 | + */ |
|
96 | + public function toggleAdvancedSettingsViewForTicketRow($row_number = 1) |
|
97 | + { |
|
98 | + $this->actor()->click(EventsPage::eventEditorTicketAdvancedDetailsSelector($row_number)); |
|
99 | + } |
|
100 | + |
|
101 | + |
|
102 | + /** |
|
103 | + * Toggles the TKT_is_taxable checkbox for the ticket in the given row. |
|
104 | + * Assumes the actor is already logged in and editing an event and that the advanced settings view state for that |
|
105 | + * ticket is "open". |
|
106 | + * |
|
107 | + * @param int $row_number What ticket row to toggle the checkbox for. |
|
108 | + */ |
|
109 | + public function toggleTicketIsTaxableForTicketRow($row_number = 1) |
|
110 | + { |
|
111 | + $this->actor()->click(EventsPage::eventEditorTicketTaxableCheckboxSelector($row_number)); |
|
112 | + } |
|
113 | + |
|
114 | + |
|
115 | + /** |
|
116 | + * Use to change the default registration status for the event. |
|
117 | + * Assumes the view is already on the event editor. |
|
118 | + * @param $registration_status |
|
119 | + */ |
|
120 | + public function changeDefaultRegistrationStatusTo($registration_status) |
|
121 | + { |
|
122 | + $this->actor()->selectOption( |
|
123 | + EventsPage::EVENT_EDITOR_DEFAULT_REGISTRATION_STATUS_FIELD_SELECTOR, |
|
124 | + $registration_status |
|
125 | + ); |
|
126 | + } |
|
127 | + |
|
128 | + |
|
129 | + /** |
|
130 | + * Use this from the context of the event editor to select the given custom template for a given message type and |
|
131 | + * messenger. |
|
132 | + * |
|
133 | + * @param string $message_type_label The visible label for the message type (eg Registration Approved) |
|
134 | + * @param string $messenger_slug The slug for the messenger (eg 'email') |
|
135 | + * @param string $custom_template_label The visible label in the select input for the custom template you want |
|
136 | + * selected. |
|
137 | + */ |
|
138 | + public function selectCustomTemplateFor($message_type_label, $messenger_slug, $custom_template_label) |
|
139 | + { |
|
140 | + $this->actor()->click(EventsPage::eventEditorNotificationsMetaBoxMessengerTabSelector($messenger_slug)); |
|
141 | + $this->actor()->selectOption( |
|
142 | + EventsPage::eventEditorNotificationsMetaBoxSelectSelectorForMessageType($message_type_label), |
|
143 | + $custom_template_label |
|
144 | + ); |
|
145 | + } |
|
146 | 146 | } |
147 | 147 | \ No newline at end of file |
@@ -20,282 +20,282 @@ |
||
20 | 20 | class ActivationHistory |
21 | 21 | { |
22 | 22 | |
23 | - /** |
|
24 | - * option name for recording the activation history for core |
|
25 | - */ |
|
26 | - const EE_ACTIVATION_HISTORY_OPTION_NAME = 'espresso_db_update'; |
|
27 | - |
|
28 | - /** |
|
29 | - * option name for indicating that the current request is for activating core |
|
30 | - */ |
|
31 | - const EE_ACTIVATION_INDICATOR_OPTION_NAME = 'ee_espresso_activation'; |
|
32 | - |
|
33 | - /** |
|
34 | - * stores the values for the activation history option name for core or an addon |
|
35 | - * |
|
36 | - * @var string $activation_history_option_name |
|
37 | - */ |
|
38 | - protected $activation_history_option_name; |
|
39 | - |
|
40 | - /** |
|
41 | - * stores the values for the activation indicator option name for core or an addon |
|
42 | - * |
|
43 | - * @var string $activation_indicator_option_name |
|
44 | - */ |
|
45 | - protected $activation_indicator_option_name; |
|
46 | - |
|
47 | - /** |
|
48 | - * the current version for core or an addon, like "1.2.3.p" |
|
49 | - * |
|
50 | - * @var string $current_version |
|
51 | - */ |
|
52 | - protected $current_version; |
|
53 | - |
|
54 | - /** |
|
55 | - * array of activated versions and activation dates for core or an addon |
|
56 | - * |
|
57 | - * @var array $version_history |
|
58 | - */ |
|
59 | - protected $version_history; |
|
60 | - |
|
61 | - |
|
62 | - |
|
63 | - /** |
|
64 | - * ActivationHistory constructor. |
|
65 | - * |
|
66 | - * @param string $activation_history_option_name |
|
67 | - * @param string $activation_indicator_option_name |
|
68 | - * @param string $current_version |
|
69 | - * @throws InvalidDataTypeException |
|
70 | - */ |
|
71 | - public function __construct( |
|
72 | - $activation_history_option_name = '', |
|
73 | - $activation_indicator_option_name = '', |
|
74 | - $current_version = '' |
|
75 | - ) { |
|
76 | - $this->setActivationHistoryOptionName($activation_history_option_name); |
|
77 | - $this->setActivationIndicatorOptionName($activation_indicator_option_name); |
|
78 | - $this->setCurrentVersion($current_version); |
|
79 | - $this->version_history = (array) get_option($this->activation_history_option_name, array()); |
|
80 | - } |
|
81 | - |
|
82 | - |
|
83 | - |
|
84 | - /** |
|
85 | - * @param string $activation_history_option_name |
|
86 | - * @throws InvalidDataTypeException |
|
87 | - */ |
|
88 | - protected function setActivationHistoryOptionName($activation_history_option_name) |
|
89 | - { |
|
90 | - if(! is_string($activation_history_option_name)) { |
|
91 | - throw new InvalidDataTypeException( |
|
92 | - '$activation_history_option_name', |
|
93 | - $activation_history_option_name, |
|
94 | - 'string' |
|
95 | - ); |
|
96 | - } |
|
97 | - $this->activation_history_option_name = $activation_history_option_name !== '' |
|
98 | - ? $activation_history_option_name |
|
99 | - : ActivationHistory::EE_ACTIVATION_HISTORY_OPTION_NAME; |
|
100 | - } |
|
101 | - |
|
102 | - |
|
103 | - |
|
104 | - /** |
|
105 | - * @param string $activation_indicator_option_name |
|
106 | - * @throws InvalidDataTypeException |
|
107 | - */ |
|
108 | - protected function setActivationIndicatorOptionName($activation_indicator_option_name) |
|
109 | - { |
|
110 | - if (! is_string($activation_indicator_option_name)) { |
|
111 | - throw new InvalidDataTypeException( |
|
112 | - '$activation_indicator_option_name', |
|
113 | - $activation_indicator_option_name, |
|
114 | - 'string' |
|
115 | - ); |
|
116 | - } |
|
117 | - $this->activation_indicator_option_name = $activation_indicator_option_name !== '' |
|
118 | - ? $activation_indicator_option_name |
|
119 | - : ActivationHistory::EE_ACTIVATION_INDICATOR_OPTION_NAME; |
|
120 | - } |
|
121 | - |
|
122 | - |
|
123 | - |
|
124 | - /** |
|
125 | - * @param string $current_version |
|
126 | - * @throws InvalidDataTypeException |
|
127 | - */ |
|
128 | - protected function setCurrentVersion($current_version) |
|
129 | - { |
|
130 | - if (! is_string($current_version)) { |
|
131 | - throw new InvalidDataTypeException( |
|
132 | - '$current_version', |
|
133 | - $current_version, |
|
134 | - 'string' |
|
135 | - ); |
|
136 | - } |
|
137 | - $this->current_version = $current_version !== '' |
|
138 | - ? $current_version |
|
139 | - : espresso_version(); |
|
140 | - } |
|
141 | - |
|
142 | - |
|
143 | - |
|
144 | - |
|
145 | - /** |
|
146 | - * Gets the wp option which stores the activation history for this addon |
|
147 | - * |
|
148 | - * @return array|bool |
|
149 | - */ |
|
150 | - public function getVersionHistory() |
|
151 | - { |
|
152 | - return $this->version_history; |
|
153 | - } |
|
154 | - |
|
155 | - |
|
156 | - |
|
157 | - /** |
|
158 | - * @return string |
|
159 | - */ |
|
160 | - public function getCurrentVersion() |
|
161 | - { |
|
162 | - return $this->current_version; |
|
163 | - } |
|
164 | - |
|
165 | - |
|
166 | - |
|
167 | - /** |
|
168 | - * Gets the most recently active version listed in the activation history, |
|
169 | - * and if none are found (ie, it's a brand new install) returns '0.0.0.dev.000'. |
|
170 | - * |
|
171 | - * @return string |
|
172 | - */ |
|
173 | - public function getMostRecentActiveVersion() |
|
174 | - { |
|
175 | - $most_recently_active_version_activation = '1970-01-01 00:00:00'; |
|
176 | - $most_recently_active_version = '0.0.0.dev.000'; |
|
177 | - if (is_array($this->version_history) && count($this->version_history)) { |
|
178 | - foreach ($this->version_history as $version => $times_activated) { |
|
179 | - // check there is a record of when this version was activated. |
|
180 | - // Otherwise, mark it as unknown |
|
181 | - if (! $times_activated) { |
|
182 | - $times_activated = array('unknown-date'); |
|
183 | - } |
|
184 | - if (is_string($times_activated)) { |
|
185 | - $times_activated = array($times_activated); |
|
186 | - } |
|
187 | - foreach ($times_activated as $an_activation) { |
|
188 | - if ( |
|
189 | - $an_activation !== 'unknown-date' |
|
190 | - && $an_activation > $most_recently_active_version_activation |
|
191 | - ) { |
|
192 | - $most_recently_active_version = $version; |
|
193 | - $most_recently_active_version_activation = $an_activation === 'unknown-date' |
|
194 | - ? '1970-01-01 00:00:00' |
|
195 | - : $an_activation; |
|
196 | - } |
|
197 | - } |
|
198 | - } |
|
199 | - } |
|
200 | - return $most_recently_active_version; |
|
201 | - } |
|
202 | - |
|
203 | - |
|
204 | - |
|
205 | - /** |
|
206 | - * Updates the version history for this addon |
|
207 | - * |
|
208 | - * @param array|null $version_history |
|
209 | - * @param string $current_version |
|
210 | - * @param bool $add_current |
|
211 | - * @return bool success |
|
212 | - */ |
|
213 | - public function updateActivationHistory($version_history = null, $current_version = '', $add_current = true) |
|
214 | - { |
|
215 | - if ($version_history !== null) { |
|
216 | - $this->version_history = $version_history; |
|
217 | - } |
|
218 | - if ($current_version !== '') { |
|
219 | - $this->current_version = $current_version; |
|
220 | - } |
|
221 | - if(! isset($this->version_history[$this->current_version])) { |
|
222 | - $this->version_history[$this->current_version] = array(); |
|
223 | - } |
|
224 | - if($add_current) { |
|
225 | - $this->version_history[$this->current_version][] = date('Y-m-d H:i:s'); |
|
226 | - } |
|
227 | - return update_option( |
|
228 | - $this->activation_history_option_name, |
|
229 | - $this->version_history |
|
230 | - ); |
|
231 | - } |
|
232 | - |
|
233 | - |
|
234 | - |
|
235 | - /** |
|
236 | - * Updates the version history for this addon |
|
237 | - * |
|
238 | - * @param array|null $version_history |
|
239 | - * @param string $current_version |
|
240 | - * @return boolean success |
|
241 | - */ |
|
242 | - public function addActivationHistory($version_history = null, $current_version = '') |
|
243 | - { |
|
244 | - if ($version_history !== null) { |
|
245 | - $this->version_history = $version_history; |
|
246 | - } |
|
247 | - if ($current_version !== '') { |
|
248 | - $this->current_version = $current_version; |
|
249 | - } |
|
250 | - return add_option( |
|
251 | - $this->activation_history_option_name, |
|
252 | - $this->version_history, |
|
253 | - '', |
|
254 | - 'no' |
|
255 | - ); |
|
256 | - } |
|
257 | - |
|
258 | - |
|
259 | - |
|
260 | - /** |
|
261 | - * @return bool |
|
262 | - */ |
|
263 | - public function getActivationIndicator() |
|
264 | - { |
|
265 | - return get_option($this->activation_indicator_option_name, false); |
|
266 | - } |
|
267 | - |
|
268 | - |
|
269 | - |
|
270 | - /** |
|
271 | - * @return bool |
|
272 | - */ |
|
273 | - public function setActivationIndicator() |
|
274 | - { |
|
275 | - return update_option($this->activation_indicator_option_name, true); |
|
276 | - } |
|
277 | - |
|
278 | - |
|
279 | - |
|
280 | - /** |
|
281 | - * @return bool |
|
282 | - */ |
|
283 | - public function deleteActivationIndicator() |
|
284 | - { |
|
285 | - return delete_option($this->activation_indicator_option_name); |
|
286 | - } |
|
287 | - |
|
288 | - |
|
289 | - |
|
290 | - /** |
|
291 | - * DANGER!!! HOPE YOU KNOW WHAT YOU ARE DOING !!! |
|
292 | - * |
|
293 | - * @return bool |
|
294 | - */ |
|
295 | - public function deleteActivationHistory() |
|
296 | - { |
|
297 | - return delete_option($this->activation_history_option_name); |
|
298 | - } |
|
23 | + /** |
|
24 | + * option name for recording the activation history for core |
|
25 | + */ |
|
26 | + const EE_ACTIVATION_HISTORY_OPTION_NAME = 'espresso_db_update'; |
|
27 | + |
|
28 | + /** |
|
29 | + * option name for indicating that the current request is for activating core |
|
30 | + */ |
|
31 | + const EE_ACTIVATION_INDICATOR_OPTION_NAME = 'ee_espresso_activation'; |
|
32 | + |
|
33 | + /** |
|
34 | + * stores the values for the activation history option name for core or an addon |
|
35 | + * |
|
36 | + * @var string $activation_history_option_name |
|
37 | + */ |
|
38 | + protected $activation_history_option_name; |
|
39 | + |
|
40 | + /** |
|
41 | + * stores the values for the activation indicator option name for core or an addon |
|
42 | + * |
|
43 | + * @var string $activation_indicator_option_name |
|
44 | + */ |
|
45 | + protected $activation_indicator_option_name; |
|
46 | + |
|
47 | + /** |
|
48 | + * the current version for core or an addon, like "1.2.3.p" |
|
49 | + * |
|
50 | + * @var string $current_version |
|
51 | + */ |
|
52 | + protected $current_version; |
|
53 | + |
|
54 | + /** |
|
55 | + * array of activated versions and activation dates for core or an addon |
|
56 | + * |
|
57 | + * @var array $version_history |
|
58 | + */ |
|
59 | + protected $version_history; |
|
60 | + |
|
61 | + |
|
62 | + |
|
63 | + /** |
|
64 | + * ActivationHistory constructor. |
|
65 | + * |
|
66 | + * @param string $activation_history_option_name |
|
67 | + * @param string $activation_indicator_option_name |
|
68 | + * @param string $current_version |
|
69 | + * @throws InvalidDataTypeException |
|
70 | + */ |
|
71 | + public function __construct( |
|
72 | + $activation_history_option_name = '', |
|
73 | + $activation_indicator_option_name = '', |
|
74 | + $current_version = '' |
|
75 | + ) { |
|
76 | + $this->setActivationHistoryOptionName($activation_history_option_name); |
|
77 | + $this->setActivationIndicatorOptionName($activation_indicator_option_name); |
|
78 | + $this->setCurrentVersion($current_version); |
|
79 | + $this->version_history = (array) get_option($this->activation_history_option_name, array()); |
|
80 | + } |
|
81 | + |
|
82 | + |
|
83 | + |
|
84 | + /** |
|
85 | + * @param string $activation_history_option_name |
|
86 | + * @throws InvalidDataTypeException |
|
87 | + */ |
|
88 | + protected function setActivationHistoryOptionName($activation_history_option_name) |
|
89 | + { |
|
90 | + if(! is_string($activation_history_option_name)) { |
|
91 | + throw new InvalidDataTypeException( |
|
92 | + '$activation_history_option_name', |
|
93 | + $activation_history_option_name, |
|
94 | + 'string' |
|
95 | + ); |
|
96 | + } |
|
97 | + $this->activation_history_option_name = $activation_history_option_name !== '' |
|
98 | + ? $activation_history_option_name |
|
99 | + : ActivationHistory::EE_ACTIVATION_HISTORY_OPTION_NAME; |
|
100 | + } |
|
101 | + |
|
102 | + |
|
103 | + |
|
104 | + /** |
|
105 | + * @param string $activation_indicator_option_name |
|
106 | + * @throws InvalidDataTypeException |
|
107 | + */ |
|
108 | + protected function setActivationIndicatorOptionName($activation_indicator_option_name) |
|
109 | + { |
|
110 | + if (! is_string($activation_indicator_option_name)) { |
|
111 | + throw new InvalidDataTypeException( |
|
112 | + '$activation_indicator_option_name', |
|
113 | + $activation_indicator_option_name, |
|
114 | + 'string' |
|
115 | + ); |
|
116 | + } |
|
117 | + $this->activation_indicator_option_name = $activation_indicator_option_name !== '' |
|
118 | + ? $activation_indicator_option_name |
|
119 | + : ActivationHistory::EE_ACTIVATION_INDICATOR_OPTION_NAME; |
|
120 | + } |
|
121 | + |
|
122 | + |
|
123 | + |
|
124 | + /** |
|
125 | + * @param string $current_version |
|
126 | + * @throws InvalidDataTypeException |
|
127 | + */ |
|
128 | + protected function setCurrentVersion($current_version) |
|
129 | + { |
|
130 | + if (! is_string($current_version)) { |
|
131 | + throw new InvalidDataTypeException( |
|
132 | + '$current_version', |
|
133 | + $current_version, |
|
134 | + 'string' |
|
135 | + ); |
|
136 | + } |
|
137 | + $this->current_version = $current_version !== '' |
|
138 | + ? $current_version |
|
139 | + : espresso_version(); |
|
140 | + } |
|
141 | + |
|
142 | + |
|
143 | + |
|
144 | + |
|
145 | + /** |
|
146 | + * Gets the wp option which stores the activation history for this addon |
|
147 | + * |
|
148 | + * @return array|bool |
|
149 | + */ |
|
150 | + public function getVersionHistory() |
|
151 | + { |
|
152 | + return $this->version_history; |
|
153 | + } |
|
154 | + |
|
155 | + |
|
156 | + |
|
157 | + /** |
|
158 | + * @return string |
|
159 | + */ |
|
160 | + public function getCurrentVersion() |
|
161 | + { |
|
162 | + return $this->current_version; |
|
163 | + } |
|
164 | + |
|
165 | + |
|
166 | + |
|
167 | + /** |
|
168 | + * Gets the most recently active version listed in the activation history, |
|
169 | + * and if none are found (ie, it's a brand new install) returns '0.0.0.dev.000'. |
|
170 | + * |
|
171 | + * @return string |
|
172 | + */ |
|
173 | + public function getMostRecentActiveVersion() |
|
174 | + { |
|
175 | + $most_recently_active_version_activation = '1970-01-01 00:00:00'; |
|
176 | + $most_recently_active_version = '0.0.0.dev.000'; |
|
177 | + if (is_array($this->version_history) && count($this->version_history)) { |
|
178 | + foreach ($this->version_history as $version => $times_activated) { |
|
179 | + // check there is a record of when this version was activated. |
|
180 | + // Otherwise, mark it as unknown |
|
181 | + if (! $times_activated) { |
|
182 | + $times_activated = array('unknown-date'); |
|
183 | + } |
|
184 | + if (is_string($times_activated)) { |
|
185 | + $times_activated = array($times_activated); |
|
186 | + } |
|
187 | + foreach ($times_activated as $an_activation) { |
|
188 | + if ( |
|
189 | + $an_activation !== 'unknown-date' |
|
190 | + && $an_activation > $most_recently_active_version_activation |
|
191 | + ) { |
|
192 | + $most_recently_active_version = $version; |
|
193 | + $most_recently_active_version_activation = $an_activation === 'unknown-date' |
|
194 | + ? '1970-01-01 00:00:00' |
|
195 | + : $an_activation; |
|
196 | + } |
|
197 | + } |
|
198 | + } |
|
199 | + } |
|
200 | + return $most_recently_active_version; |
|
201 | + } |
|
202 | + |
|
203 | + |
|
204 | + |
|
205 | + /** |
|
206 | + * Updates the version history for this addon |
|
207 | + * |
|
208 | + * @param array|null $version_history |
|
209 | + * @param string $current_version |
|
210 | + * @param bool $add_current |
|
211 | + * @return bool success |
|
212 | + */ |
|
213 | + public function updateActivationHistory($version_history = null, $current_version = '', $add_current = true) |
|
214 | + { |
|
215 | + if ($version_history !== null) { |
|
216 | + $this->version_history = $version_history; |
|
217 | + } |
|
218 | + if ($current_version !== '') { |
|
219 | + $this->current_version = $current_version; |
|
220 | + } |
|
221 | + if(! isset($this->version_history[$this->current_version])) { |
|
222 | + $this->version_history[$this->current_version] = array(); |
|
223 | + } |
|
224 | + if($add_current) { |
|
225 | + $this->version_history[$this->current_version][] = date('Y-m-d H:i:s'); |
|
226 | + } |
|
227 | + return update_option( |
|
228 | + $this->activation_history_option_name, |
|
229 | + $this->version_history |
|
230 | + ); |
|
231 | + } |
|
232 | + |
|
233 | + |
|
234 | + |
|
235 | + /** |
|
236 | + * Updates the version history for this addon |
|
237 | + * |
|
238 | + * @param array|null $version_history |
|
239 | + * @param string $current_version |
|
240 | + * @return boolean success |
|
241 | + */ |
|
242 | + public function addActivationHistory($version_history = null, $current_version = '') |
|
243 | + { |
|
244 | + if ($version_history !== null) { |
|
245 | + $this->version_history = $version_history; |
|
246 | + } |
|
247 | + if ($current_version !== '') { |
|
248 | + $this->current_version = $current_version; |
|
249 | + } |
|
250 | + return add_option( |
|
251 | + $this->activation_history_option_name, |
|
252 | + $this->version_history, |
|
253 | + '', |
|
254 | + 'no' |
|
255 | + ); |
|
256 | + } |
|
257 | + |
|
258 | + |
|
259 | + |
|
260 | + /** |
|
261 | + * @return bool |
|
262 | + */ |
|
263 | + public function getActivationIndicator() |
|
264 | + { |
|
265 | + return get_option($this->activation_indicator_option_name, false); |
|
266 | + } |
|
267 | + |
|
268 | + |
|
269 | + |
|
270 | + /** |
|
271 | + * @return bool |
|
272 | + */ |
|
273 | + public function setActivationIndicator() |
|
274 | + { |
|
275 | + return update_option($this->activation_indicator_option_name, true); |
|
276 | + } |
|
277 | + |
|
278 | + |
|
279 | + |
|
280 | + /** |
|
281 | + * @return bool |
|
282 | + */ |
|
283 | + public function deleteActivationIndicator() |
|
284 | + { |
|
285 | + return delete_option($this->activation_indicator_option_name); |
|
286 | + } |
|
287 | + |
|
288 | + |
|
289 | + |
|
290 | + /** |
|
291 | + * DANGER!!! HOPE YOU KNOW WHAT YOU ARE DOING !!! |
|
292 | + * |
|
293 | + * @return bool |
|
294 | + */ |
|
295 | + public function deleteActivationHistory() |
|
296 | + { |
|
297 | + return delete_option($this->activation_history_option_name); |
|
298 | + } |
|
299 | 299 | |
300 | 300 | |
301 | 301 |
@@ -87,7 +87,7 @@ discard block |
||
87 | 87 | */ |
88 | 88 | protected function setActivationHistoryOptionName($activation_history_option_name) |
89 | 89 | { |
90 | - if(! is_string($activation_history_option_name)) { |
|
90 | + if ( ! is_string($activation_history_option_name)) { |
|
91 | 91 | throw new InvalidDataTypeException( |
92 | 92 | '$activation_history_option_name', |
93 | 93 | $activation_history_option_name, |
@@ -107,7 +107,7 @@ discard block |
||
107 | 107 | */ |
108 | 108 | protected function setActivationIndicatorOptionName($activation_indicator_option_name) |
109 | 109 | { |
110 | - if (! is_string($activation_indicator_option_name)) { |
|
110 | + if ( ! is_string($activation_indicator_option_name)) { |
|
111 | 111 | throw new InvalidDataTypeException( |
112 | 112 | '$activation_indicator_option_name', |
113 | 113 | $activation_indicator_option_name, |
@@ -127,7 +127,7 @@ discard block |
||
127 | 127 | */ |
128 | 128 | protected function setCurrentVersion($current_version) |
129 | 129 | { |
130 | - if (! is_string($current_version)) { |
|
130 | + if ( ! is_string($current_version)) { |
|
131 | 131 | throw new InvalidDataTypeException( |
132 | 132 | '$current_version', |
133 | 133 | $current_version, |
@@ -178,7 +178,7 @@ discard block |
||
178 | 178 | foreach ($this->version_history as $version => $times_activated) { |
179 | 179 | // check there is a record of when this version was activated. |
180 | 180 | // Otherwise, mark it as unknown |
181 | - if (! $times_activated) { |
|
181 | + if ( ! $times_activated) { |
|
182 | 182 | $times_activated = array('unknown-date'); |
183 | 183 | } |
184 | 184 | if (is_string($times_activated)) { |
@@ -210,7 +210,7 @@ discard block |
||
210 | 210 | * @param bool $add_current |
211 | 211 | * @return bool success |
212 | 212 | */ |
213 | - public function updateActivationHistory($version_history = null, $current_version = '', $add_current = true) |
|
213 | + public function updateActivationHistory($version_history = null, $current_version = '', $add_current = true) |
|
214 | 214 | { |
215 | 215 | if ($version_history !== null) { |
216 | 216 | $this->version_history = $version_history; |
@@ -218,10 +218,10 @@ discard block |
||
218 | 218 | if ($current_version !== '') { |
219 | 219 | $this->current_version = $current_version; |
220 | 220 | } |
221 | - if(! isset($this->version_history[$this->current_version])) { |
|
222 | - $this->version_history[$this->current_version] = array(); |
|
221 | + if ( ! isset($this->version_history[$this->current_version])) { |
|
222 | + $this->version_history[$this->current_version] = array(); |
|
223 | 223 | } |
224 | - if($add_current) { |
|
224 | + if ($add_current) { |
|
225 | 225 | $this->version_history[$this->current_version][] = date('Y-m-d H:i:s'); |
226 | 226 | } |
227 | 227 | return update_option( |
@@ -24,144 +24,144 @@ |
||
24 | 24 | class InitializeAddon implements InitializeInterface |
25 | 25 | { |
26 | 26 | |
27 | - /** |
|
28 | - * @var EE_Addon $addon |
|
29 | - */ |
|
30 | - private $addon; |
|
31 | - |
|
32 | - /** |
|
33 | - * @var EE_Data_Migration_Manager $data_migration_manager |
|
34 | - */ |
|
35 | - private $data_migration_manager; |
|
36 | - |
|
37 | - /** |
|
38 | - * @var EE_Maintenance_Mode $maintenance_mode |
|
39 | - */ |
|
40 | - private $maintenance_mode; |
|
41 | - |
|
42 | - /** |
|
43 | - * @var EE_Registry $registry |
|
44 | - */ |
|
45 | - private $registry; |
|
46 | - |
|
47 | - |
|
48 | - |
|
49 | - /** |
|
50 | - * InitializeDatabase constructor. |
|
51 | - * |
|
52 | - * @param EE_Addon $addon |
|
53 | - * @param EE_Data_Migration_Manager $data_migration_manager |
|
54 | - * @param EE_Maintenance_Mode $maintenance_mode |
|
55 | - * @param EE_Registry $registry |
|
56 | - */ |
|
57 | - public function __construct( |
|
58 | - EE_Addon $addon, |
|
59 | - EE_Data_Migration_Manager $data_migration_manager, |
|
60 | - EE_Maintenance_Mode $maintenance_mode, |
|
61 | - EE_Registry $registry |
|
62 | - ) { |
|
63 | - $this->addon = $addon; |
|
64 | - $this->data_migration_manager = $data_migration_manager; |
|
65 | - $this->maintenance_mode = $maintenance_mode; |
|
66 | - $this->registry = $registry; |
|
67 | - } |
|
68 | - |
|
69 | - |
|
70 | - /** |
|
71 | - * Takes care of double-checking that we're not in maintenance mode, and then |
|
72 | - * initializing this addon's necessary initial data. This is called by default on new activations |
|
73 | - * and reactivations |
|
74 | - * |
|
75 | - * @param boolean $verify_schema whether to verify the database's schema for this addon, or just its data. |
|
76 | - * This is a resource-intensive job so we prefer to only do it when necessary |
|
77 | - * @return void |
|
78 | - * @throws ReflectionException |
|
79 | - * @throws EE_Error |
|
80 | - */ |
|
81 | - public function initialize($verify_schema = true) |
|
82 | - { |
|
83 | - if ($this->maintenance_mode->level() !== EE_Maintenance_Mode::level_2_complete_maintenance) { |
|
84 | - if ($verify_schema) { |
|
85 | - $this->initializeDatabase(); |
|
86 | - } |
|
87 | - $this->initializeDefaultData(); |
|
88 | - //@todo: this will probably need to be adjusted in 4.4 as the array changed formats I believe |
|
89 | - $this->data_migration_manager->update_current_database_state_to( |
|
90 | - array( |
|
91 | - 'slug' => $this->addon->name(), |
|
92 | - 'version' => $this->addon->version() |
|
93 | - ) |
|
94 | - ); |
|
95 | - //in case there are lots of addons being activated at once, let's force garbage collection |
|
96 | - //to help avoid memory limit errors |
|
97 | - //EEH_Debug_Tools::instance()->measure_memory( 'db content initialized for ' . get_class( $this), true ); |
|
98 | - gc_collect_cycles(); |
|
99 | - } else { |
|
100 | - //ask the data migration manager to init this addon's data |
|
101 | - //when migrations are finished because we can't do it now |
|
102 | - $this->data_migration_manager->enqueue_db_initialization_for($this->addon->name()); |
|
103 | - } |
|
104 | - } |
|
105 | - |
|
106 | - |
|
107 | - /** |
|
108 | - * Used to setup this addon's database tables, but not necessarily any default |
|
109 | - * data in them. The default is to actually use the most up-to-date data migration script |
|
110 | - * for this addon, and just use its schema_changes_before_migration() and schema_changes_after_migration() |
|
111 | - * methods to setup the db. |
|
112 | - * |
|
113 | - * @throws ReflectionException |
|
114 | - * @throws EE_Error |
|
115 | - */ |
|
116 | - public function initializeDatabase() |
|
117 | - { |
|
118 | - //find the migration script that sets the database to be compatible with the code |
|
119 | - $current_dms_name = $this->data_migration_manager->get_most_up_to_date_dms($this->addon->name()); |
|
120 | - if ($current_dms_name) { |
|
121 | - $current_data_migration_script = $this->registry->load_dms($current_dms_name); |
|
122 | - $current_data_migration_script->set_migrating(false); |
|
123 | - $current_data_migration_script->schema_changes_before_migration(); |
|
124 | - $current_data_migration_script->schema_changes_after_migration(); |
|
125 | - if ($current_data_migration_script->get_errors()) { |
|
126 | - foreach ($current_data_migration_script->get_errors() as $error) { |
|
127 | - EE_Error::add_error($error, __FILE__, __FUNCTION__, __LINE__); |
|
128 | - } |
|
129 | - } |
|
130 | - } |
|
131 | - //if not DMS was found that should be ok. This addon just doesn't require any database changes |
|
132 | - $this->data_migration_manager->update_current_database_state_to( |
|
133 | - array( |
|
134 | - 'slug' => $this->addon->name(), |
|
135 | - 'version' => $this->addon->version() |
|
136 | - ) |
|
137 | - ); |
|
138 | - } |
|
139 | - |
|
140 | - |
|
141 | - |
|
142 | - /** |
|
143 | - * If you want to setup default data for the addon, override this method, and call |
|
144 | - * parent::initialize_default_data() from within it. This is normally called |
|
145 | - * from EE_Addon::initialize_db_if_no_migrations_required(), just after EE_Addon::initialize_db() |
|
146 | - * and should verify default data is present (but this is also called |
|
147 | - * on reactivations and just after migrations, so please verify you actually want |
|
148 | - * to ADD default data, because it may already be present). |
|
149 | - * However, please call this parent (currently it just fires a hook which other |
|
150 | - * addons may be depending on) |
|
151 | - */ |
|
152 | - public function initializeDefaultData() |
|
153 | - { |
|
154 | - /** |
|
155 | - * Called when an addon is ensuring its default data is set (possibly called |
|
156 | - * on a reactivation, so first check for the absence of other data before setting |
|
157 | - * default data) |
|
158 | - * |
|
159 | - * @param EE_Addon $addon the addon that called this |
|
160 | - */ |
|
161 | - do_action('AHEE__EE_Addon__initialize_default_data__begin', $this); |
|
162 | - //override to insert default data. It is safe to use the models here |
|
163 | - //because the site should not be in maintenance mode |
|
164 | - } |
|
27 | + /** |
|
28 | + * @var EE_Addon $addon |
|
29 | + */ |
|
30 | + private $addon; |
|
31 | + |
|
32 | + /** |
|
33 | + * @var EE_Data_Migration_Manager $data_migration_manager |
|
34 | + */ |
|
35 | + private $data_migration_manager; |
|
36 | + |
|
37 | + /** |
|
38 | + * @var EE_Maintenance_Mode $maintenance_mode |
|
39 | + */ |
|
40 | + private $maintenance_mode; |
|
41 | + |
|
42 | + /** |
|
43 | + * @var EE_Registry $registry |
|
44 | + */ |
|
45 | + private $registry; |
|
46 | + |
|
47 | + |
|
48 | + |
|
49 | + /** |
|
50 | + * InitializeDatabase constructor. |
|
51 | + * |
|
52 | + * @param EE_Addon $addon |
|
53 | + * @param EE_Data_Migration_Manager $data_migration_manager |
|
54 | + * @param EE_Maintenance_Mode $maintenance_mode |
|
55 | + * @param EE_Registry $registry |
|
56 | + */ |
|
57 | + public function __construct( |
|
58 | + EE_Addon $addon, |
|
59 | + EE_Data_Migration_Manager $data_migration_manager, |
|
60 | + EE_Maintenance_Mode $maintenance_mode, |
|
61 | + EE_Registry $registry |
|
62 | + ) { |
|
63 | + $this->addon = $addon; |
|
64 | + $this->data_migration_manager = $data_migration_manager; |
|
65 | + $this->maintenance_mode = $maintenance_mode; |
|
66 | + $this->registry = $registry; |
|
67 | + } |
|
68 | + |
|
69 | + |
|
70 | + /** |
|
71 | + * Takes care of double-checking that we're not in maintenance mode, and then |
|
72 | + * initializing this addon's necessary initial data. This is called by default on new activations |
|
73 | + * and reactivations |
|
74 | + * |
|
75 | + * @param boolean $verify_schema whether to verify the database's schema for this addon, or just its data. |
|
76 | + * This is a resource-intensive job so we prefer to only do it when necessary |
|
77 | + * @return void |
|
78 | + * @throws ReflectionException |
|
79 | + * @throws EE_Error |
|
80 | + */ |
|
81 | + public function initialize($verify_schema = true) |
|
82 | + { |
|
83 | + if ($this->maintenance_mode->level() !== EE_Maintenance_Mode::level_2_complete_maintenance) { |
|
84 | + if ($verify_schema) { |
|
85 | + $this->initializeDatabase(); |
|
86 | + } |
|
87 | + $this->initializeDefaultData(); |
|
88 | + //@todo: this will probably need to be adjusted in 4.4 as the array changed formats I believe |
|
89 | + $this->data_migration_manager->update_current_database_state_to( |
|
90 | + array( |
|
91 | + 'slug' => $this->addon->name(), |
|
92 | + 'version' => $this->addon->version() |
|
93 | + ) |
|
94 | + ); |
|
95 | + //in case there are lots of addons being activated at once, let's force garbage collection |
|
96 | + //to help avoid memory limit errors |
|
97 | + //EEH_Debug_Tools::instance()->measure_memory( 'db content initialized for ' . get_class( $this), true ); |
|
98 | + gc_collect_cycles(); |
|
99 | + } else { |
|
100 | + //ask the data migration manager to init this addon's data |
|
101 | + //when migrations are finished because we can't do it now |
|
102 | + $this->data_migration_manager->enqueue_db_initialization_for($this->addon->name()); |
|
103 | + } |
|
104 | + } |
|
105 | + |
|
106 | + |
|
107 | + /** |
|
108 | + * Used to setup this addon's database tables, but not necessarily any default |
|
109 | + * data in them. The default is to actually use the most up-to-date data migration script |
|
110 | + * for this addon, and just use its schema_changes_before_migration() and schema_changes_after_migration() |
|
111 | + * methods to setup the db. |
|
112 | + * |
|
113 | + * @throws ReflectionException |
|
114 | + * @throws EE_Error |
|
115 | + */ |
|
116 | + public function initializeDatabase() |
|
117 | + { |
|
118 | + //find the migration script that sets the database to be compatible with the code |
|
119 | + $current_dms_name = $this->data_migration_manager->get_most_up_to_date_dms($this->addon->name()); |
|
120 | + if ($current_dms_name) { |
|
121 | + $current_data_migration_script = $this->registry->load_dms($current_dms_name); |
|
122 | + $current_data_migration_script->set_migrating(false); |
|
123 | + $current_data_migration_script->schema_changes_before_migration(); |
|
124 | + $current_data_migration_script->schema_changes_after_migration(); |
|
125 | + if ($current_data_migration_script->get_errors()) { |
|
126 | + foreach ($current_data_migration_script->get_errors() as $error) { |
|
127 | + EE_Error::add_error($error, __FILE__, __FUNCTION__, __LINE__); |
|
128 | + } |
|
129 | + } |
|
130 | + } |
|
131 | + //if not DMS was found that should be ok. This addon just doesn't require any database changes |
|
132 | + $this->data_migration_manager->update_current_database_state_to( |
|
133 | + array( |
|
134 | + 'slug' => $this->addon->name(), |
|
135 | + 'version' => $this->addon->version() |
|
136 | + ) |
|
137 | + ); |
|
138 | + } |
|
139 | + |
|
140 | + |
|
141 | + |
|
142 | + /** |
|
143 | + * If you want to setup default data for the addon, override this method, and call |
|
144 | + * parent::initialize_default_data() from within it. This is normally called |
|
145 | + * from EE_Addon::initialize_db_if_no_migrations_required(), just after EE_Addon::initialize_db() |
|
146 | + * and should verify default data is present (but this is also called |
|
147 | + * on reactivations and just after migrations, so please verify you actually want |
|
148 | + * to ADD default data, because it may already be present). |
|
149 | + * However, please call this parent (currently it just fires a hook which other |
|
150 | + * addons may be depending on) |
|
151 | + */ |
|
152 | + public function initializeDefaultData() |
|
153 | + { |
|
154 | + /** |
|
155 | + * Called when an addon is ensuring its default data is set (possibly called |
|
156 | + * on a reactivation, so first check for the absence of other data before setting |
|
157 | + * default data) |
|
158 | + * |
|
159 | + * @param EE_Addon $addon the addon that called this |
|
160 | + */ |
|
161 | + do_action('AHEE__EE_Addon__initialize_default_data__begin', $this); |
|
162 | + //override to insert default data. It is safe to use the models here |
|
163 | + //because the site should not be in maintenance mode |
|
164 | + } |
|
165 | 165 | |
166 | 166 | |
167 | 167 |
@@ -78,13 +78,13 @@ |
||
78 | 78 | // EE_Dependency_Map: info about how to load classes required by other classes |
79 | 79 | espresso_load_required( |
80 | 80 | 'EE_Dependency_Map', |
81 | - EE_CORE . 'EE_Dependency_Map.core.php' |
|
81 | + EE_CORE.'EE_Dependency_Map.core.php' |
|
82 | 82 | ); |
83 | 83 | $this->dependency_map = EE_Dependency_Map::instance($this->class_cache); |
84 | 84 | // EE_Registry: central repository for classes (legacy) |
85 | 85 | espresso_load_required( |
86 | 86 | 'EE_Registry', |
87 | - EE_CORE . 'EE_Registry.core.php' |
|
87 | + EE_CORE.'EE_Registry.core.php' |
|
88 | 88 | ); |
89 | 89 | $this->registry = EE_Registry::instance( |
90 | 90 | $this->dependency_map, |
@@ -24,123 +24,123 @@ |
||
24 | 24 | */ |
25 | 25 | class BootstrapDependencyInjectionContainer |
26 | 26 | { |
27 | - /** |
|
28 | - * @var EE_Dependency_Map $dependency_map |
|
29 | - */ |
|
30 | - protected $dependency_map; |
|
31 | - |
|
32 | - /** |
|
33 | - * @type LoaderInterface $loader |
|
34 | - */ |
|
35 | - protected $loader; |
|
36 | - |
|
37 | - /** |
|
38 | - * @var EE_Registry $registry |
|
39 | - */ |
|
40 | - protected $registry; |
|
41 | - |
|
42 | - /** |
|
43 | - * @var ClassInterfaceCache $class_cache |
|
44 | - */ |
|
45 | - private $class_cache; |
|
46 | - |
|
47 | - /** |
|
48 | - * @var Mirror |
|
49 | - */ |
|
50 | - private $mirror; |
|
51 | - |
|
52 | - /** |
|
53 | - * @var ObjectIdentifier |
|
54 | - */ |
|
55 | - private $object_identifier; |
|
56 | - |
|
57 | - |
|
58 | - /** |
|
59 | - * Can't use this just yet until we exorcise some more of our singleton usage from core |
|
60 | - */ |
|
61 | - public function buildDependencyInjectionContainer() |
|
62 | - { |
|
63 | - // build DI container |
|
64 | - // $OpenCoffeeShop = new EventEspresso\core\services\container\OpenCoffeeShop(); |
|
65 | - // $OpenCoffeeShop->addRecipes(); |
|
66 | - // $CoffeeShop = $OpenCoffeeShop->CoffeeShop(); |
|
67 | - } |
|
68 | - |
|
69 | - |
|
70 | - /** |
|
71 | - * Setups EE_Registry and EE_Dependency_Map |
|
72 | - * |
|
73 | - * @throws EE_Error |
|
74 | - */ |
|
75 | - public function buildLegacyDependencyInjectionContainer() |
|
76 | - { |
|
77 | - $this->class_cache = new ClassInterfaceCache(); |
|
78 | - $this->object_identifier = new ObjectIdentifier($this->class_cache); |
|
79 | - $this->mirror = new Mirror(); |
|
80 | - // EE_Dependency_Map: info about how to load classes required by other classes |
|
81 | - espresso_load_required( |
|
82 | - 'EE_Dependency_Map', |
|
83 | - EE_CORE . 'EE_Dependency_Map.core.php' |
|
84 | - ); |
|
85 | - $this->dependency_map = EE_Dependency_Map::instance($this->class_cache); |
|
86 | - // EE_Registry: central repository for classes (legacy) |
|
87 | - espresso_load_required( |
|
88 | - 'EE_Registry', |
|
89 | - EE_CORE . 'EE_Registry.core.php' |
|
90 | - ); |
|
91 | - $this->registry = EE_Registry::instance( |
|
92 | - $this->dependency_map, |
|
93 | - $this->mirror, |
|
94 | - $this->class_cache, |
|
95 | - $this->object_identifier |
|
96 | - ); |
|
97 | - } |
|
98 | - |
|
99 | - |
|
100 | - /** |
|
101 | - * Performs initial setup for the generic Loader |
|
102 | - * |
|
103 | - * @throws InvalidDataTypeException |
|
104 | - * @throws InvalidInterfaceException |
|
105 | - * @throws InvalidArgumentException |
|
106 | - */ |
|
107 | - public function buildLoader() |
|
108 | - { |
|
109 | - $this->loader = LoaderFactory::getLoader( |
|
110 | - $this->registry, |
|
111 | - $this->class_cache, |
|
112 | - $this->object_identifier |
|
113 | - ); |
|
114 | - $this->loader->share('EventEspresso\core\services\loaders\ClassInterfaceCache', $this->class_cache); |
|
115 | - $this->loader->share('EventEspresso\core\services\loaders\ObjectIdentifier', $this->object_identifier); |
|
116 | - $this->loader->share('EventEspresso\core\services\container\Mirror', $this->mirror); |
|
117 | - $this->dependency_map->setLoader($this->loader); |
|
118 | - } |
|
119 | - |
|
120 | - |
|
121 | - /** |
|
122 | - * @return EE_Dependency_Map |
|
123 | - */ |
|
124 | - public function getDependencyMap() |
|
125 | - { |
|
126 | - return $this->dependency_map; |
|
127 | - } |
|
128 | - |
|
129 | - |
|
130 | - /** |
|
131 | - * @return EE_Registry |
|
132 | - */ |
|
133 | - public function getRegistry() |
|
134 | - { |
|
135 | - return $this->registry; |
|
136 | - } |
|
137 | - |
|
138 | - |
|
139 | - /** |
|
140 | - * @return LoaderInterface |
|
141 | - */ |
|
142 | - public function getLoader() |
|
143 | - { |
|
144 | - return $this->loader; |
|
145 | - } |
|
27 | + /** |
|
28 | + * @var EE_Dependency_Map $dependency_map |
|
29 | + */ |
|
30 | + protected $dependency_map; |
|
31 | + |
|
32 | + /** |
|
33 | + * @type LoaderInterface $loader |
|
34 | + */ |
|
35 | + protected $loader; |
|
36 | + |
|
37 | + /** |
|
38 | + * @var EE_Registry $registry |
|
39 | + */ |
|
40 | + protected $registry; |
|
41 | + |
|
42 | + /** |
|
43 | + * @var ClassInterfaceCache $class_cache |
|
44 | + */ |
|
45 | + private $class_cache; |
|
46 | + |
|
47 | + /** |
|
48 | + * @var Mirror |
|
49 | + */ |
|
50 | + private $mirror; |
|
51 | + |
|
52 | + /** |
|
53 | + * @var ObjectIdentifier |
|
54 | + */ |
|
55 | + private $object_identifier; |
|
56 | + |
|
57 | + |
|
58 | + /** |
|
59 | + * Can't use this just yet until we exorcise some more of our singleton usage from core |
|
60 | + */ |
|
61 | + public function buildDependencyInjectionContainer() |
|
62 | + { |
|
63 | + // build DI container |
|
64 | + // $OpenCoffeeShop = new EventEspresso\core\services\container\OpenCoffeeShop(); |
|
65 | + // $OpenCoffeeShop->addRecipes(); |
|
66 | + // $CoffeeShop = $OpenCoffeeShop->CoffeeShop(); |
|
67 | + } |
|
68 | + |
|
69 | + |
|
70 | + /** |
|
71 | + * Setups EE_Registry and EE_Dependency_Map |
|
72 | + * |
|
73 | + * @throws EE_Error |
|
74 | + */ |
|
75 | + public function buildLegacyDependencyInjectionContainer() |
|
76 | + { |
|
77 | + $this->class_cache = new ClassInterfaceCache(); |
|
78 | + $this->object_identifier = new ObjectIdentifier($this->class_cache); |
|
79 | + $this->mirror = new Mirror(); |
|
80 | + // EE_Dependency_Map: info about how to load classes required by other classes |
|
81 | + espresso_load_required( |
|
82 | + 'EE_Dependency_Map', |
|
83 | + EE_CORE . 'EE_Dependency_Map.core.php' |
|
84 | + ); |
|
85 | + $this->dependency_map = EE_Dependency_Map::instance($this->class_cache); |
|
86 | + // EE_Registry: central repository for classes (legacy) |
|
87 | + espresso_load_required( |
|
88 | + 'EE_Registry', |
|
89 | + EE_CORE . 'EE_Registry.core.php' |
|
90 | + ); |
|
91 | + $this->registry = EE_Registry::instance( |
|
92 | + $this->dependency_map, |
|
93 | + $this->mirror, |
|
94 | + $this->class_cache, |
|
95 | + $this->object_identifier |
|
96 | + ); |
|
97 | + } |
|
98 | + |
|
99 | + |
|
100 | + /** |
|
101 | + * Performs initial setup for the generic Loader |
|
102 | + * |
|
103 | + * @throws InvalidDataTypeException |
|
104 | + * @throws InvalidInterfaceException |
|
105 | + * @throws InvalidArgumentException |
|
106 | + */ |
|
107 | + public function buildLoader() |
|
108 | + { |
|
109 | + $this->loader = LoaderFactory::getLoader( |
|
110 | + $this->registry, |
|
111 | + $this->class_cache, |
|
112 | + $this->object_identifier |
|
113 | + ); |
|
114 | + $this->loader->share('EventEspresso\core\services\loaders\ClassInterfaceCache', $this->class_cache); |
|
115 | + $this->loader->share('EventEspresso\core\services\loaders\ObjectIdentifier', $this->object_identifier); |
|
116 | + $this->loader->share('EventEspresso\core\services\container\Mirror', $this->mirror); |
|
117 | + $this->dependency_map->setLoader($this->loader); |
|
118 | + } |
|
119 | + |
|
120 | + |
|
121 | + /** |
|
122 | + * @return EE_Dependency_Map |
|
123 | + */ |
|
124 | + public function getDependencyMap() |
|
125 | + { |
|
126 | + return $this->dependency_map; |
|
127 | + } |
|
128 | + |
|
129 | + |
|
130 | + /** |
|
131 | + * @return EE_Registry |
|
132 | + */ |
|
133 | + public function getRegistry() |
|
134 | + { |
|
135 | + return $this->registry; |
|
136 | + } |
|
137 | + |
|
138 | + |
|
139 | + /** |
|
140 | + * @return LoaderInterface |
|
141 | + */ |
|
142 | + public function getLoader() |
|
143 | + { |
|
144 | + return $this->loader; |
|
145 | + } |
|
146 | 146 | } |
@@ -65,7 +65,7 @@ |
||
65 | 65 | */ |
66 | 66 | public function registerCustomTaxonomyTerm($taxonomy, $term_slug, array $cpt_slugs = array()) |
67 | 67 | { |
68 | - $this->custom_taxonomy_terms[][ $term_slug ] = new CustomTaxonomyTerm( |
|
68 | + $this->custom_taxonomy_terms[][$term_slug] = new CustomTaxonomyTerm( |
|
69 | 69 | $taxonomy, |
70 | 70 | $term_slug, |
71 | 71 | $cpt_slugs |
@@ -15,181 +15,181 @@ |
||
15 | 15 | */ |
16 | 16 | class RegisterCustomTaxonomyTerms |
17 | 17 | { |
18 | - /** |
|
19 | - * @var array[] $custom_taxonomy_terms |
|
20 | - */ |
|
21 | - public $custom_taxonomy_terms = array(); |
|
18 | + /** |
|
19 | + * @var array[] $custom_taxonomy_terms |
|
20 | + */ |
|
21 | + public $custom_taxonomy_terms = array(); |
|
22 | 22 | |
23 | 23 | |
24 | - /** |
|
25 | - * RegisterCustomTaxonomyTerms constructor. |
|
26 | - */ |
|
27 | - public function __construct() |
|
28 | - { |
|
29 | - // hook into save_post so that we can make sure that the default terms get saved on publish of registered cpts |
|
30 | - // IF they don't have a term for that taxonomy set. |
|
31 | - add_action('save_post', array($this, 'saveDefaultTerm'), 100, 2); |
|
32 | - do_action( |
|
33 | - 'AHEE__EventEspresso_core_domain_services_custom_post_types_RegisterCustomTaxonomyTerms__construct_end', |
|
34 | - $this |
|
35 | - ); |
|
36 | - } |
|
24 | + /** |
|
25 | + * RegisterCustomTaxonomyTerms constructor. |
|
26 | + */ |
|
27 | + public function __construct() |
|
28 | + { |
|
29 | + // hook into save_post so that we can make sure that the default terms get saved on publish of registered cpts |
|
30 | + // IF they don't have a term for that taxonomy set. |
|
31 | + add_action('save_post', array($this, 'saveDefaultTerm'), 100, 2); |
|
32 | + do_action( |
|
33 | + 'AHEE__EventEspresso_core_domain_services_custom_post_types_RegisterCustomTaxonomyTerms__construct_end', |
|
34 | + $this |
|
35 | + ); |
|
36 | + } |
|
37 | 37 | |
38 | 38 | |
39 | - public function registerCustomTaxonomyTerms() |
|
40 | - { |
|
41 | - // setup default terms in any of our taxonomies (but only if we're in admin). |
|
42 | - // Why not added via register_activation_hook? |
|
43 | - // Because it's possible that in future iterations of EE we may add new defaults for specialized taxonomies |
|
44 | - // (think event_types) and register_activation_hook only reliably runs when a user manually activates the plugin. |
|
45 | - // Keep in mind that this will READ these terms if they are deleted by the user. Hence MUST use terms. |
|
46 | - // if ( is_admin() ) { |
|
47 | - // $this->set_must_use_event_types(); |
|
48 | - // } |
|
49 | - // set default terms |
|
50 | - $this->registerCustomTaxonomyTerm( |
|
51 | - 'espresso_event_type', |
|
52 | - 'single-event', |
|
53 | - array('espresso_events') |
|
54 | - ); |
|
55 | - } |
|
39 | + public function registerCustomTaxonomyTerms() |
|
40 | + { |
|
41 | + // setup default terms in any of our taxonomies (but only if we're in admin). |
|
42 | + // Why not added via register_activation_hook? |
|
43 | + // Because it's possible that in future iterations of EE we may add new defaults for specialized taxonomies |
|
44 | + // (think event_types) and register_activation_hook only reliably runs when a user manually activates the plugin. |
|
45 | + // Keep in mind that this will READ these terms if they are deleted by the user. Hence MUST use terms. |
|
46 | + // if ( is_admin() ) { |
|
47 | + // $this->set_must_use_event_types(); |
|
48 | + // } |
|
49 | + // set default terms |
|
50 | + $this->registerCustomTaxonomyTerm( |
|
51 | + 'espresso_event_type', |
|
52 | + 'single-event', |
|
53 | + array('espresso_events') |
|
54 | + ); |
|
55 | + } |
|
56 | 56 | |
57 | 57 | |
58 | - /** |
|
59 | - * Allows us to set what the default will be for terms when a cpt is PUBLISHED. |
|
60 | - * |
|
61 | - * @param string $taxonomy The taxonomy we're using for the default term |
|
62 | - * @param string $term_slug The slug of the term that will be the default. |
|
63 | - * @param array $cpt_slugs An array of custom post types we want the default assigned to |
|
64 | - */ |
|
65 | - public function registerCustomTaxonomyTerm($taxonomy, $term_slug, array $cpt_slugs = array()) |
|
66 | - { |
|
67 | - $this->custom_taxonomy_terms[][ $term_slug ] = new CustomTaxonomyTerm( |
|
68 | - $taxonomy, |
|
69 | - $term_slug, |
|
70 | - $cpt_slugs |
|
71 | - ); |
|
72 | - } |
|
58 | + /** |
|
59 | + * Allows us to set what the default will be for terms when a cpt is PUBLISHED. |
|
60 | + * |
|
61 | + * @param string $taxonomy The taxonomy we're using for the default term |
|
62 | + * @param string $term_slug The slug of the term that will be the default. |
|
63 | + * @param array $cpt_slugs An array of custom post types we want the default assigned to |
|
64 | + */ |
|
65 | + public function registerCustomTaxonomyTerm($taxonomy, $term_slug, array $cpt_slugs = array()) |
|
66 | + { |
|
67 | + $this->custom_taxonomy_terms[][ $term_slug ] = new CustomTaxonomyTerm( |
|
68 | + $taxonomy, |
|
69 | + $term_slug, |
|
70 | + $cpt_slugs |
|
71 | + ); |
|
72 | + } |
|
73 | 73 | |
74 | 74 | |
75 | - /** |
|
76 | - * hooked into the wp 'save_post' action hook for setting our default terms found in the $_default_terms property |
|
77 | - * |
|
78 | - * @param int $post_id ID of CPT being saved |
|
79 | - * @param WP_Post $post Post object |
|
80 | - * @return void |
|
81 | - */ |
|
82 | - public function saveDefaultTerm($post_id, WP_Post $post) |
|
83 | - { |
|
84 | - if (empty($this->custom_taxonomy_terms)) { |
|
85 | - return; |
|
86 | - } |
|
87 | - // no default terms set so lets just exit. |
|
88 | - foreach ($this->custom_taxonomy_terms as $custom_taxonomy_terms) { |
|
89 | - foreach ($custom_taxonomy_terms as $custom_taxonomy_term) { |
|
90 | - if ( |
|
91 | - $post->post_status === 'publish' |
|
92 | - && $custom_taxonomy_term instanceof CustomTaxonomyTerm |
|
93 | - && in_array($post->post_type, $custom_taxonomy_term->customPostTypeSlugs(), true) |
|
94 | - ) { |
|
95 | - // note some error proofing going on here to save unnecessary db queries |
|
96 | - $taxonomies = get_object_taxonomies($post->post_type); |
|
97 | - foreach ($taxonomies as $taxonomy) { |
|
98 | - $terms = wp_get_post_terms($post_id, $taxonomy); |
|
99 | - if (empty($terms) && $taxonomy === $custom_taxonomy_term->taxonomySlug()) { |
|
100 | - wp_set_object_terms( |
|
101 | - $post_id, |
|
102 | - array($custom_taxonomy_term->termSlug()), |
|
103 | - $taxonomy |
|
104 | - ); |
|
105 | - } |
|
106 | - } |
|
107 | - } |
|
108 | - } |
|
109 | - } |
|
110 | - } |
|
75 | + /** |
|
76 | + * hooked into the wp 'save_post' action hook for setting our default terms found in the $_default_terms property |
|
77 | + * |
|
78 | + * @param int $post_id ID of CPT being saved |
|
79 | + * @param WP_Post $post Post object |
|
80 | + * @return void |
|
81 | + */ |
|
82 | + public function saveDefaultTerm($post_id, WP_Post $post) |
|
83 | + { |
|
84 | + if (empty($this->custom_taxonomy_terms)) { |
|
85 | + return; |
|
86 | + } |
|
87 | + // no default terms set so lets just exit. |
|
88 | + foreach ($this->custom_taxonomy_terms as $custom_taxonomy_terms) { |
|
89 | + foreach ($custom_taxonomy_terms as $custom_taxonomy_term) { |
|
90 | + if ( |
|
91 | + $post->post_status === 'publish' |
|
92 | + && $custom_taxonomy_term instanceof CustomTaxonomyTerm |
|
93 | + && in_array($post->post_type, $custom_taxonomy_term->customPostTypeSlugs(), true) |
|
94 | + ) { |
|
95 | + // note some error proofing going on here to save unnecessary db queries |
|
96 | + $taxonomies = get_object_taxonomies($post->post_type); |
|
97 | + foreach ($taxonomies as $taxonomy) { |
|
98 | + $terms = wp_get_post_terms($post_id, $taxonomy); |
|
99 | + if (empty($terms) && $taxonomy === $custom_taxonomy_term->taxonomySlug()) { |
|
100 | + wp_set_object_terms( |
|
101 | + $post_id, |
|
102 | + array($custom_taxonomy_term->termSlug()), |
|
103 | + $taxonomy |
|
104 | + ); |
|
105 | + } |
|
106 | + } |
|
107 | + } |
|
108 | + } |
|
109 | + } |
|
110 | + } |
|
111 | 111 | |
112 | 112 | |
113 | - /** |
|
114 | - * @return void |
|
115 | - */ |
|
116 | - public function setMustUseEventTypes() |
|
117 | - { |
|
118 | - $term_details = array( |
|
119 | - // Attendee's register for the first date-time only |
|
120 | - 'single-event' => array( |
|
121 | - 'term' => esc_html__('Single Event', 'event_espresso'), |
|
122 | - 'desc' => esc_html__( |
|
123 | - 'A single event that spans one or more consecutive days.', |
|
124 | - 'event_espresso' |
|
125 | - ), |
|
126 | - ), |
|
127 | - // example: a party or two-day long workshop |
|
128 | - // Attendee's can register for any of the date-times |
|
129 | - 'multi-event' => array( |
|
130 | - 'term' => esc_html__('Multi Event', 'event_espresso'), |
|
131 | - 'desc' => esc_html__( |
|
132 | - 'Multiple, separate, but related events that occur on consecutive days.', |
|
133 | - 'event_espresso' |
|
134 | - ), |
|
135 | - ), |
|
136 | - // example: a three day music festival or week long conference |
|
137 | - // Attendee's register for the first date-time only |
|
138 | - 'event-series' => array( |
|
139 | - 'term' => esc_html__('Event Series', 'event_espresso'), |
|
140 | - 'desc' => esc_html__( |
|
141 | - ' Multiple events that occur over multiple non-consecutive days.', |
|
142 | - 'event_espresso' |
|
143 | - ), |
|
144 | - ), |
|
145 | - // example: an 8 week introduction to basket weaving course |
|
146 | - // Attendee's can register for any of the date-times. |
|
147 | - 'recurring-event' => array( |
|
148 | - 'term' => esc_html__('Recurring Event', 'event_espresso'), |
|
149 | - 'desc' => esc_html__( |
|
150 | - 'Multiple events that occur over multiple non-consecutive days.', |
|
151 | - 'event_espresso' |
|
152 | - ), |
|
153 | - ), |
|
154 | - // example: a yoga class |
|
155 | - 'ongoing' => array( |
|
156 | - 'term' => esc_html__('Ongoing Event', 'event_espresso'), |
|
157 | - 'desc' => esc_html__( |
|
158 | - 'An "event" that people can purchase tickets to gain access for anytime for this event regardless of date times on the event', |
|
159 | - 'event_espresso' |
|
160 | - ), |
|
161 | - ) |
|
162 | - // example: access to a museum |
|
163 | - // 'walk-in' => array( esc_html__('Walk In', 'event_espresso'), esc_html__('Single datetime and single entry recurring events. Attendees register for one or multiple datetimes individually.', 'event_espresso') ), |
|
164 | - // 'reservation' => array( esc_html__('Reservation', 'event_espresso'), esc_html__('Reservations are created by specifying available datetimes and quantities. Attendees choose from the available datetimes and specify the quantity available (if the maximum is greater than 1)') ), //@TODO to avoid confusion we'll implement this in a later iteration > EE4.1 |
|
165 | - // 'multiple-session' => array( esc_html__('Multiple Session', 'event_espresso'), esc_html__('Multiple event, multiple datetime, hierarchically organized, custom entry events. Attendees may be required to register for a parent event before being allowed to register for child events. Attendees can register for any combination of child events as long as the datetimes do not conflict. Parent and child events may have additional fees or registration questions.') ), //@TODO to avoid confusion we'll implement this in a later iteration > EE4.1 |
|
166 | - // 'appointment' => array( esc_html__('Appointments', 'event_espresso'), esc_html__('Time slotted events where datetimes are generally in hours or minutes. For example, attendees can register for a single 15 minute or 1 hour time slot and this type of availability frequently reoccurs.', 'event_espresso') ) |
|
167 | - ); |
|
168 | - $this->setMustUseTerms('espresso_event_type', $term_details); |
|
169 | - } |
|
113 | + /** |
|
114 | + * @return void |
|
115 | + */ |
|
116 | + public function setMustUseEventTypes() |
|
117 | + { |
|
118 | + $term_details = array( |
|
119 | + // Attendee's register for the first date-time only |
|
120 | + 'single-event' => array( |
|
121 | + 'term' => esc_html__('Single Event', 'event_espresso'), |
|
122 | + 'desc' => esc_html__( |
|
123 | + 'A single event that spans one or more consecutive days.', |
|
124 | + 'event_espresso' |
|
125 | + ), |
|
126 | + ), |
|
127 | + // example: a party or two-day long workshop |
|
128 | + // Attendee's can register for any of the date-times |
|
129 | + 'multi-event' => array( |
|
130 | + 'term' => esc_html__('Multi Event', 'event_espresso'), |
|
131 | + 'desc' => esc_html__( |
|
132 | + 'Multiple, separate, but related events that occur on consecutive days.', |
|
133 | + 'event_espresso' |
|
134 | + ), |
|
135 | + ), |
|
136 | + // example: a three day music festival or week long conference |
|
137 | + // Attendee's register for the first date-time only |
|
138 | + 'event-series' => array( |
|
139 | + 'term' => esc_html__('Event Series', 'event_espresso'), |
|
140 | + 'desc' => esc_html__( |
|
141 | + ' Multiple events that occur over multiple non-consecutive days.', |
|
142 | + 'event_espresso' |
|
143 | + ), |
|
144 | + ), |
|
145 | + // example: an 8 week introduction to basket weaving course |
|
146 | + // Attendee's can register for any of the date-times. |
|
147 | + 'recurring-event' => array( |
|
148 | + 'term' => esc_html__('Recurring Event', 'event_espresso'), |
|
149 | + 'desc' => esc_html__( |
|
150 | + 'Multiple events that occur over multiple non-consecutive days.', |
|
151 | + 'event_espresso' |
|
152 | + ), |
|
153 | + ), |
|
154 | + // example: a yoga class |
|
155 | + 'ongoing' => array( |
|
156 | + 'term' => esc_html__('Ongoing Event', 'event_espresso'), |
|
157 | + 'desc' => esc_html__( |
|
158 | + 'An "event" that people can purchase tickets to gain access for anytime for this event regardless of date times on the event', |
|
159 | + 'event_espresso' |
|
160 | + ), |
|
161 | + ) |
|
162 | + // example: access to a museum |
|
163 | + // 'walk-in' => array( esc_html__('Walk In', 'event_espresso'), esc_html__('Single datetime and single entry recurring events. Attendees register for one or multiple datetimes individually.', 'event_espresso') ), |
|
164 | + // 'reservation' => array( esc_html__('Reservation', 'event_espresso'), esc_html__('Reservations are created by specifying available datetimes and quantities. Attendees choose from the available datetimes and specify the quantity available (if the maximum is greater than 1)') ), //@TODO to avoid confusion we'll implement this in a later iteration > EE4.1 |
|
165 | + // 'multiple-session' => array( esc_html__('Multiple Session', 'event_espresso'), esc_html__('Multiple event, multiple datetime, hierarchically organized, custom entry events. Attendees may be required to register for a parent event before being allowed to register for child events. Attendees can register for any combination of child events as long as the datetimes do not conflict. Parent and child events may have additional fees or registration questions.') ), //@TODO to avoid confusion we'll implement this in a later iteration > EE4.1 |
|
166 | + // 'appointment' => array( esc_html__('Appointments', 'event_espresso'), esc_html__('Time slotted events where datetimes are generally in hours or minutes. For example, attendees can register for a single 15 minute or 1 hour time slot and this type of availability frequently reoccurs.', 'event_espresso') ) |
|
167 | + ); |
|
168 | + $this->setMustUseTerms('espresso_event_type', $term_details); |
|
169 | + } |
|
170 | 170 | |
171 | 171 | |
172 | - /** |
|
173 | - * wrapper method for handling the setting up of initial terms in the db (if they don't already exist). |
|
174 | - * Note this should ONLY be used for terms that always must be present. Be aware that if an initial term is |
|
175 | - * deleted then it WILL be recreated. |
|
176 | - * |
|
177 | - * @param string $taxonomy The name of the taxonomy |
|
178 | - * @param array $term_details An array of term details indexed by slug and containing Name of term, and |
|
179 | - * description as the elements in the array |
|
180 | - * @return void |
|
181 | - */ |
|
182 | - public function setMustUseTerms($taxonomy, $term_details) |
|
183 | - { |
|
184 | - $term_details = (array) $term_details; |
|
185 | - foreach ($term_details as $slug => $details) { |
|
186 | - if (isset($details['term'], $details['desc']) && ! term_exists($slug, $taxonomy)) { |
|
187 | - $insert_arr = array( |
|
188 | - 'slug' => $slug, |
|
189 | - 'description' => $details['desc'], |
|
190 | - ); |
|
191 | - wp_insert_term($details['term'], $taxonomy, $insert_arr); |
|
192 | - } |
|
193 | - } |
|
194 | - } |
|
172 | + /** |
|
173 | + * wrapper method for handling the setting up of initial terms in the db (if they don't already exist). |
|
174 | + * Note this should ONLY be used for terms that always must be present. Be aware that if an initial term is |
|
175 | + * deleted then it WILL be recreated. |
|
176 | + * |
|
177 | + * @param string $taxonomy The name of the taxonomy |
|
178 | + * @param array $term_details An array of term details indexed by slug and containing Name of term, and |
|
179 | + * description as the elements in the array |
|
180 | + * @return void |
|
181 | + */ |
|
182 | + public function setMustUseTerms($taxonomy, $term_details) |
|
183 | + { |
|
184 | + $term_details = (array) $term_details; |
|
185 | + foreach ($term_details as $slug => $details) { |
|
186 | + if (isset($details['term'], $details['desc']) && ! term_exists($slug, $taxonomy)) { |
|
187 | + $insert_arr = array( |
|
188 | + 'slug' => $slug, |
|
189 | + 'description' => $details['desc'], |
|
190 | + ); |
|
191 | + wp_insert_term($details['term'], $taxonomy, $insert_arr); |
|
192 | + } |
|
193 | + } |
|
194 | + } |
|
195 | 195 | } |