Completed
Branch FET/extract-activation-detecti... (285969)
by
unknown
10:31 queued 07:29
created
acceptance_tests/Page/TicketSelector.php 1 patch
Indentation   +21 added lines, -21 removed lines patch added patch discarded remove patch
@@ -12,27 +12,27 @@
 block discarded – undo
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
Please login to merge, or discard this patch.
acceptance_tests/Page/RegistrationsAdmin.php 1 patch
Indentation   +43 added lines, -43 removed lines patch added patch discarded remove patch
@@ -12,47 +12,47 @@
 block discarded – undo
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
Please login to merge, or discard this patch.
acceptance_tests/Page/Checkout.php 1 patch
Indentation   +67 added lines, -67 removed lines patch added patch discarded remove patch
@@ -13,71 +13,71 @@
 block discarded – undo
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
 }
Please login to merge, or discard this patch.
modules/ticket_selector/TicketDatetimeAvailabilityTracker.php 2 patches
Spacing   +13 added lines, -13 removed lines patch added patch discarded remove patch
@@ -66,24 +66,24 @@  discard block
 block discarded – undo
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
 block discarded – undo
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
 block discarded – undo
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
 block discarded – undo
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
     }
Please login to merge, or discard this patch.
Indentation   +213 added lines, -213 removed lines patch added patch discarded remove patch
@@ -21,217 +21,217 @@
 block discarded – undo
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
 }
Please login to merge, or discard this patch.
acceptance_tests/Helpers/EventsAdmin.php 1 patch
Indentation   +129 added lines, -129 removed lines patch added patch discarded remove patch
@@ -14,133 +14,133 @@
 block discarded – undo
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
Please login to merge, or discard this patch.
core/services/activation/ActivationHistory.php 2 patches
Indentation   +276 added lines, -276 removed lines patch added patch discarded remove patch
@@ -20,282 +20,282 @@
 block discarded – undo
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
 
Please login to merge, or discard this patch.
Spacing   +8 added lines, -8 removed lines patch added patch discarded remove patch
@@ -87,7 +87,7 @@  discard block
 block discarded – undo
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
 block discarded – undo
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
 block discarded – undo
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
 block discarded – undo
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
 block discarded – undo
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
 block discarded – undo
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(
Please login to merge, or discard this patch.
core/services/activation/InitializeAddon.php 1 patch
Indentation   +138 added lines, -138 removed lines patch added patch discarded remove patch
@@ -24,144 +24,144 @@
 block discarded – undo
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
 
Please login to merge, or discard this patch.
core/services/bootstrap/BootstrapDependencyInjectionContainer.php 2 patches
Spacing   +2 added lines, -2 removed lines patch added patch discarded remove patch
@@ -78,13 +78,13 @@
 block discarded – undo
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,
Please login to merge, or discard this patch.
Indentation   +119 added lines, -119 removed lines patch added patch discarded remove patch
@@ -24,123 +24,123 @@
 block discarded – undo
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
 }
Please login to merge, or discard this patch.
core/domain/services/custom_post_types/RegisterCustomTaxonomyTerms.php 2 patches
Spacing   +1 added lines, -1 removed lines patch added patch discarded remove patch
@@ -65,7 +65,7 @@
 block discarded – undo
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
Please login to merge, or discard this patch.
Indentation   +165 added lines, -165 removed lines patch added patch discarded remove patch
@@ -15,181 +15,181 @@
 block discarded – undo
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
 }
Please login to merge, or discard this patch.