@@ -17,318 +17,318 @@ |
||
17 | 17 | { |
18 | 18 | |
19 | 19 | |
20 | - /** |
|
21 | - * @return EED_Module|EED_Ticket_Selector_Caff |
|
22 | - */ |
|
23 | - public static function instance() |
|
24 | - { |
|
25 | - return parent::get_instance(__CLASS__); |
|
26 | - } |
|
20 | + /** |
|
21 | + * @return EED_Module|EED_Ticket_Selector_Caff |
|
22 | + */ |
|
23 | + public static function instance() |
|
24 | + { |
|
25 | + return parent::get_instance(__CLASS__); |
|
26 | + } |
|
27 | 27 | |
28 | 28 | |
29 | - /** |
|
30 | - * set_hooks - for hooking into EE Core, other modules, etc |
|
31 | - * |
|
32 | - * @access public |
|
33 | - * @return void |
|
34 | - */ |
|
35 | - public static function set_hooks() |
|
36 | - { |
|
37 | - add_action( |
|
38 | - 'AHEE__ticket_selector_chart_template__ticket_details__after_description', |
|
39 | - array('EED_Ticket_Selector_Caff', 'ticket_price_details'), |
|
40 | - 10, |
|
41 | - 3 |
|
42 | - ); |
|
43 | - } |
|
29 | + /** |
|
30 | + * set_hooks - for hooking into EE Core, other modules, etc |
|
31 | + * |
|
32 | + * @access public |
|
33 | + * @return void |
|
34 | + */ |
|
35 | + public static function set_hooks() |
|
36 | + { |
|
37 | + add_action( |
|
38 | + 'AHEE__ticket_selector_chart_template__ticket_details__after_description', |
|
39 | + array('EED_Ticket_Selector_Caff', 'ticket_price_details'), |
|
40 | + 10, |
|
41 | + 3 |
|
42 | + ); |
|
43 | + } |
|
44 | 44 | |
45 | - /** |
|
46 | - * set_hooks_admin - for hooking into EE Admin Core, other modules, etc |
|
47 | - * |
|
48 | - * @access public |
|
49 | - * @return void |
|
50 | - */ |
|
51 | - public static function set_hooks_admin() |
|
52 | - { |
|
53 | - define( |
|
54 | - 'TICKET_SELECTOR_CAFF_TEMPLATES_PATH', |
|
55 | - str_replace('\\', DS, plugin_dir_path(__FILE__)) . 'templates' . DS |
|
56 | - ); |
|
57 | - add_action( |
|
58 | - 'AHEE__template_settings__template__before_settings_form', |
|
59 | - array('EED_Ticket_Selector_Caff', 'template_settings_form'), |
|
60 | - 10 |
|
61 | - ); |
|
62 | - add_filter( |
|
63 | - 'FHEE__General_Settings_Admin_Page__update_template_settings__data', |
|
64 | - array('EED_Ticket_Selector_Caff', 'update_template_settings'), |
|
65 | - 10, |
|
66 | - 2 |
|
67 | - ); |
|
68 | - } |
|
45 | + /** |
|
46 | + * set_hooks_admin - for hooking into EE Admin Core, other modules, etc |
|
47 | + * |
|
48 | + * @access public |
|
49 | + * @return void |
|
50 | + */ |
|
51 | + public static function set_hooks_admin() |
|
52 | + { |
|
53 | + define( |
|
54 | + 'TICKET_SELECTOR_CAFF_TEMPLATES_PATH', |
|
55 | + str_replace('\\', DS, plugin_dir_path(__FILE__)) . 'templates' . DS |
|
56 | + ); |
|
57 | + add_action( |
|
58 | + 'AHEE__template_settings__template__before_settings_form', |
|
59 | + array('EED_Ticket_Selector_Caff', 'template_settings_form'), |
|
60 | + 10 |
|
61 | + ); |
|
62 | + add_filter( |
|
63 | + 'FHEE__General_Settings_Admin_Page__update_template_settings__data', |
|
64 | + array('EED_Ticket_Selector_Caff', 'update_template_settings'), |
|
65 | + 10, |
|
66 | + 2 |
|
67 | + ); |
|
68 | + } |
|
69 | 69 | |
70 | 70 | |
71 | - /** |
|
72 | - * @param \WP $WP |
|
73 | - */ |
|
74 | - public function run($WP) |
|
75 | - { |
|
76 | - $this->set_config(); |
|
77 | - } |
|
71 | + /** |
|
72 | + * @param \WP $WP |
|
73 | + */ |
|
74 | + public function run($WP) |
|
75 | + { |
|
76 | + $this->set_config(); |
|
77 | + } |
|
78 | 78 | |
79 | 79 | |
80 | - /** |
|
81 | - * @static |
|
82 | - * @return void |
|
83 | - * @throws EE_Error |
|
84 | - * @throws InvalidArgumentException |
|
85 | - * @throws InvalidDataTypeException |
|
86 | - * @throws InvalidInterfaceException |
|
87 | - */ |
|
88 | - public static function template_settings_form() |
|
89 | - { |
|
90 | - echo EED_Ticket_Selector_Caff::_ticket_selector_settings_form()->get_html(); |
|
91 | - } |
|
80 | + /** |
|
81 | + * @static |
|
82 | + * @return void |
|
83 | + * @throws EE_Error |
|
84 | + * @throws InvalidArgumentException |
|
85 | + * @throws InvalidDataTypeException |
|
86 | + * @throws InvalidInterfaceException |
|
87 | + */ |
|
88 | + public static function template_settings_form() |
|
89 | + { |
|
90 | + echo EED_Ticket_Selector_Caff::_ticket_selector_settings_form()->get_html(); |
|
91 | + } |
|
92 | 92 | |
93 | 93 | |
94 | - /** |
|
95 | - * @return \EE_Form_Section_Proper |
|
96 | - * @throws \EE_Error |
|
97 | - */ |
|
98 | - public static function _ticket_selector_settings_form() |
|
99 | - { |
|
94 | + /** |
|
95 | + * @return \EE_Form_Section_Proper |
|
96 | + * @throws \EE_Error |
|
97 | + */ |
|
98 | + public static function _ticket_selector_settings_form() |
|
99 | + { |
|
100 | 100 | |
101 | - return new EE_Form_Section_Proper( |
|
102 | - array( |
|
103 | - 'name' => 'ticket_selector_settings_form', |
|
104 | - 'html_id' => 'ticket_selector_settings_form', |
|
105 | - 'layout_strategy' => new EE_Div_Per_Section_Layout(), |
|
106 | - 'subsections' => apply_filters( |
|
107 | - 'FHEE__EED_Ticket_Selector_Caff___ticket_selector_settings_form__form_subsections', |
|
108 | - array( |
|
109 | - 'appearance_settings_hdr' => new EE_Form_Section_HTML( |
|
110 | - EEH_HTML::br(2) . |
|
111 | - EEH_HTML::h2(esc_html__('Ticket Selector Template Settings', 'event_espresso')) |
|
112 | - ), |
|
113 | - 'appearance_settings' => EED_Ticket_Selector_Caff::_ticket_selector_appearance_settings(), |
|
114 | - ) |
|
115 | - ), |
|
116 | - ) |
|
117 | - ); |
|
118 | - } |
|
101 | + return new EE_Form_Section_Proper( |
|
102 | + array( |
|
103 | + 'name' => 'ticket_selector_settings_form', |
|
104 | + 'html_id' => 'ticket_selector_settings_form', |
|
105 | + 'layout_strategy' => new EE_Div_Per_Section_Layout(), |
|
106 | + 'subsections' => apply_filters( |
|
107 | + 'FHEE__EED_Ticket_Selector_Caff___ticket_selector_settings_form__form_subsections', |
|
108 | + array( |
|
109 | + 'appearance_settings_hdr' => new EE_Form_Section_HTML( |
|
110 | + EEH_HTML::br(2) . |
|
111 | + EEH_HTML::h2(esc_html__('Ticket Selector Template Settings', 'event_espresso')) |
|
112 | + ), |
|
113 | + 'appearance_settings' => EED_Ticket_Selector_Caff::_ticket_selector_appearance_settings(), |
|
114 | + ) |
|
115 | + ), |
|
116 | + ) |
|
117 | + ); |
|
118 | + } |
|
119 | 119 | |
120 | 120 | |
121 | - /** |
|
122 | - * @return \EE_Form_Section_Proper |
|
123 | - * @throws \EE_Error |
|
124 | - */ |
|
125 | - public static function _ticket_selector_appearance_settings() |
|
126 | - { |
|
127 | - if (! EE_Registry::instance()->CFG->template_settings->EED_Ticket_Selector instanceof EE_Ticket_Selector_Config |
|
128 | - ) { |
|
129 | - EED_Ticket_Selector::instance()->set_config(); |
|
130 | - EE_Registry::instance()->CFG->template_settings->EED_Ticket_Selector = EED_Ticket_Selector::instance() |
|
131 | - ->config(); |
|
132 | - } |
|
133 | - $EE_Ticket_Selector_Config = EE_Registry::instance()->CFG->template_settings->EED_Ticket_Selector; |
|
134 | - // get option for whether to show datetime selector in TS |
|
135 | - $show_datetime_selector = $EE_Ticket_Selector_Config->getShowDatetimeSelector(); |
|
136 | - // and option for how may datetimes must exist if display is conditional |
|
137 | - $datetime_selector_threshold = $EE_Ticket_Selector_Config->getDatetimeSelectorThreshold(); |
|
121 | + /** |
|
122 | + * @return \EE_Form_Section_Proper |
|
123 | + * @throws \EE_Error |
|
124 | + */ |
|
125 | + public static function _ticket_selector_appearance_settings() |
|
126 | + { |
|
127 | + if (! EE_Registry::instance()->CFG->template_settings->EED_Ticket_Selector instanceof EE_Ticket_Selector_Config |
|
128 | + ) { |
|
129 | + EED_Ticket_Selector::instance()->set_config(); |
|
130 | + EE_Registry::instance()->CFG->template_settings->EED_Ticket_Selector = EED_Ticket_Selector::instance() |
|
131 | + ->config(); |
|
132 | + } |
|
133 | + $EE_Ticket_Selector_Config = EE_Registry::instance()->CFG->template_settings->EED_Ticket_Selector; |
|
134 | + // get option for whether to show datetime selector in TS |
|
135 | + $show_datetime_selector = $EE_Ticket_Selector_Config->getShowDatetimeSelector(); |
|
136 | + // and option for how may datetimes must exist if display is conditional |
|
137 | + $datetime_selector_threshold = $EE_Ticket_Selector_Config->getDatetimeSelectorThreshold(); |
|
138 | 138 | |
139 | - return new EE_Form_Section_Proper( |
|
140 | - array( |
|
141 | - 'name' => 'ticket_selector_settings_tbl', |
|
142 | - 'html_id' => 'ticket_selector_settings_tbl', |
|
143 | - 'html_class' => 'form-table', |
|
144 | - 'layout_strategy' => new EE_Admin_Two_Column_Layout(), |
|
145 | - 'subsections' => apply_filters( |
|
146 | - 'FHEE__EED_Ticket_Selector_Caff___ticket_selector_appearance_settings__form_subsections', |
|
147 | - array( |
|
148 | - 'show_ticket_details' => new EE_Yes_No_Input( |
|
149 | - array( |
|
150 | - 'html_label_text' => esc_html__( |
|
151 | - 'Show Ticket Details?', |
|
152 | - 'event_espresso' |
|
153 | - ), |
|
154 | - 'html_help_text' => esc_html__( |
|
155 | - 'This lets you choose whether the extra ticket details section is displayed with the ticket selector.', |
|
156 | - 'event_espresso' |
|
157 | - ), |
|
158 | - 'default' => isset($EE_Ticket_Selector_Config->show_ticket_details) |
|
159 | - ? $EE_Ticket_Selector_Config->show_ticket_details |
|
160 | - : true, |
|
161 | - 'display_html_label_text' => false, |
|
162 | - ) |
|
163 | - ), |
|
164 | - 'show_ticket_sale_columns' => new EE_Yes_No_Input( |
|
165 | - array( |
|
166 | - 'html_label_text' => esc_html__( |
|
167 | - 'Show Ticket Sale Info?', |
|
168 | - 'event_espresso' |
|
169 | - ), |
|
170 | - 'html_help_text' => esc_html__( |
|
171 | - 'This lets you indicate whether information about ticket sales is shown with ticket details in the ticket selector.', |
|
172 | - 'event_espresso' |
|
173 | - ), |
|
174 | - 'default' => isset($EE_Ticket_Selector_Config->show_ticket_sale_columns) |
|
175 | - ? $EE_Ticket_Selector_Config->show_ticket_sale_columns |
|
176 | - : true, |
|
177 | - 'display_html_label_text' => false, |
|
178 | - ) |
|
179 | - ), |
|
180 | - 'show_expired_tickets' => new EE_Yes_No_Input( |
|
181 | - array( |
|
182 | - 'html_label_text' => esc_html__( |
|
183 | - 'Show Expired Tickets?', |
|
184 | - 'event_espresso' |
|
185 | - ), |
|
186 | - 'html_help_text' => esc_html__( |
|
187 | - 'Indicate whether to show expired tickets in the ticket selector', |
|
188 | - 'event_espresso' |
|
189 | - ), |
|
190 | - 'default' => isset($EE_Ticket_Selector_Config->show_expired_tickets) |
|
191 | - ? $EE_Ticket_Selector_Config->show_expired_tickets |
|
192 | - : true, |
|
193 | - 'display_html_label_text' => false, |
|
194 | - ) |
|
195 | - ), |
|
196 | - 'show_datetime_selector' => new EE_Select_Input( |
|
197 | - $EE_Ticket_Selector_Config->getShowDatetimeSelectorOptions(false), |
|
198 | - array( |
|
199 | - 'html_label_text' => esc_html__( |
|
200 | - 'Show Date & Time Filter?', |
|
201 | - 'event_espresso' |
|
202 | - ), |
|
203 | - 'html_help_text' => sprintf( |
|
204 | - esc_html__( |
|
205 | - 'Indicates whether or not to display a dropdown select box above each ticket selector that displays dates and times for the available tickets. Ticket options can be unselected, which removes (hides) them from the list of tickets being displayed.%1$sOptions include:%1$s • %2$sdo not show date & time filter%3$s%1$s this option will NEVER display a date filter, regardless of how many dates exist.%1$s • %2$smaybe show date & time filter%3$s%1$s this option will conditionally display the date filter when the number of dates for the event matches the value set for "Date Filter Threshold".', |
|
206 | - 'event_espresso' |
|
207 | - ), |
|
208 | - '<br>', |
|
209 | - '<strong>', |
|
210 | - '</strong>' |
|
211 | - ), |
|
212 | - 'default' => ! empty($show_datetime_selector) |
|
213 | - ? $show_datetime_selector |
|
214 | - : EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR, |
|
215 | - 'display_html_label_text' => false, |
|
216 | - ) |
|
217 | - ), |
|
218 | - 'datetime_selector_threshold' => new EE_Select_Input( |
|
219 | - array_combine($r = range(1, 10), $r), |
|
220 | - array( |
|
221 | - 'html_label_text' => esc_html__( |
|
222 | - 'Date & Time Filter Threshold', |
|
223 | - 'event_espresso' |
|
224 | - ), |
|
225 | - 'html_help_text' => esc_html__( |
|
226 | - 'The number of unique dates an event has to have before conditionally displaying a date & time filter', |
|
227 | - 'event_espresso' |
|
228 | - ), |
|
229 | - 'default' => ! empty($datetime_selector_threshold) |
|
230 | - ? $datetime_selector_threshold |
|
231 | - : 3, |
|
232 | - 'display_html_label_text' => false, |
|
233 | - ) |
|
234 | - ), |
|
235 | - 'datetime_selector_max_checked' => new EE_Integer_Input( |
|
236 | - array( |
|
237 | - 'html_label_text' => esc_html__( |
|
238 | - 'Date & Time Filter Max Checked', |
|
239 | - 'event_espresso' |
|
240 | - ), |
|
241 | - 'html_help_text' => sprintf( |
|
242 | - esc_html__( |
|
243 | - 'Determines the maximum number of dates that will be checked upon initial loading for a Date and Time Filter.%1$sIf set to zero or left blank, then ALL dates will be checked upon initial loading.', |
|
244 | - 'event_espresso' |
|
245 | - ), |
|
246 | - '<br>' |
|
247 | - ), |
|
248 | - 'default' => $EE_Ticket_Selector_Config->getDatetimeSelectorMaxChecked(), |
|
249 | - 'display_html_label_text' => false, |
|
250 | - 'min_value' => 0, |
|
251 | - ) |
|
252 | - ), |
|
253 | - ) |
|
254 | - ), |
|
255 | - ) |
|
256 | - ); |
|
257 | - } |
|
139 | + return new EE_Form_Section_Proper( |
|
140 | + array( |
|
141 | + 'name' => 'ticket_selector_settings_tbl', |
|
142 | + 'html_id' => 'ticket_selector_settings_tbl', |
|
143 | + 'html_class' => 'form-table', |
|
144 | + 'layout_strategy' => new EE_Admin_Two_Column_Layout(), |
|
145 | + 'subsections' => apply_filters( |
|
146 | + 'FHEE__EED_Ticket_Selector_Caff___ticket_selector_appearance_settings__form_subsections', |
|
147 | + array( |
|
148 | + 'show_ticket_details' => new EE_Yes_No_Input( |
|
149 | + array( |
|
150 | + 'html_label_text' => esc_html__( |
|
151 | + 'Show Ticket Details?', |
|
152 | + 'event_espresso' |
|
153 | + ), |
|
154 | + 'html_help_text' => esc_html__( |
|
155 | + 'This lets you choose whether the extra ticket details section is displayed with the ticket selector.', |
|
156 | + 'event_espresso' |
|
157 | + ), |
|
158 | + 'default' => isset($EE_Ticket_Selector_Config->show_ticket_details) |
|
159 | + ? $EE_Ticket_Selector_Config->show_ticket_details |
|
160 | + : true, |
|
161 | + 'display_html_label_text' => false, |
|
162 | + ) |
|
163 | + ), |
|
164 | + 'show_ticket_sale_columns' => new EE_Yes_No_Input( |
|
165 | + array( |
|
166 | + 'html_label_text' => esc_html__( |
|
167 | + 'Show Ticket Sale Info?', |
|
168 | + 'event_espresso' |
|
169 | + ), |
|
170 | + 'html_help_text' => esc_html__( |
|
171 | + 'This lets you indicate whether information about ticket sales is shown with ticket details in the ticket selector.', |
|
172 | + 'event_espresso' |
|
173 | + ), |
|
174 | + 'default' => isset($EE_Ticket_Selector_Config->show_ticket_sale_columns) |
|
175 | + ? $EE_Ticket_Selector_Config->show_ticket_sale_columns |
|
176 | + : true, |
|
177 | + 'display_html_label_text' => false, |
|
178 | + ) |
|
179 | + ), |
|
180 | + 'show_expired_tickets' => new EE_Yes_No_Input( |
|
181 | + array( |
|
182 | + 'html_label_text' => esc_html__( |
|
183 | + 'Show Expired Tickets?', |
|
184 | + 'event_espresso' |
|
185 | + ), |
|
186 | + 'html_help_text' => esc_html__( |
|
187 | + 'Indicate whether to show expired tickets in the ticket selector', |
|
188 | + 'event_espresso' |
|
189 | + ), |
|
190 | + 'default' => isset($EE_Ticket_Selector_Config->show_expired_tickets) |
|
191 | + ? $EE_Ticket_Selector_Config->show_expired_tickets |
|
192 | + : true, |
|
193 | + 'display_html_label_text' => false, |
|
194 | + ) |
|
195 | + ), |
|
196 | + 'show_datetime_selector' => new EE_Select_Input( |
|
197 | + $EE_Ticket_Selector_Config->getShowDatetimeSelectorOptions(false), |
|
198 | + array( |
|
199 | + 'html_label_text' => esc_html__( |
|
200 | + 'Show Date & Time Filter?', |
|
201 | + 'event_espresso' |
|
202 | + ), |
|
203 | + 'html_help_text' => sprintf( |
|
204 | + esc_html__( |
|
205 | + 'Indicates whether or not to display a dropdown select box above each ticket selector that displays dates and times for the available tickets. Ticket options can be unselected, which removes (hides) them from the list of tickets being displayed.%1$sOptions include:%1$s • %2$sdo not show date & time filter%3$s%1$s this option will NEVER display a date filter, regardless of how many dates exist.%1$s • %2$smaybe show date & time filter%3$s%1$s this option will conditionally display the date filter when the number of dates for the event matches the value set for "Date Filter Threshold".', |
|
206 | + 'event_espresso' |
|
207 | + ), |
|
208 | + '<br>', |
|
209 | + '<strong>', |
|
210 | + '</strong>' |
|
211 | + ), |
|
212 | + 'default' => ! empty($show_datetime_selector) |
|
213 | + ? $show_datetime_selector |
|
214 | + : EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR, |
|
215 | + 'display_html_label_text' => false, |
|
216 | + ) |
|
217 | + ), |
|
218 | + 'datetime_selector_threshold' => new EE_Select_Input( |
|
219 | + array_combine($r = range(1, 10), $r), |
|
220 | + array( |
|
221 | + 'html_label_text' => esc_html__( |
|
222 | + 'Date & Time Filter Threshold', |
|
223 | + 'event_espresso' |
|
224 | + ), |
|
225 | + 'html_help_text' => esc_html__( |
|
226 | + 'The number of unique dates an event has to have before conditionally displaying a date & time filter', |
|
227 | + 'event_espresso' |
|
228 | + ), |
|
229 | + 'default' => ! empty($datetime_selector_threshold) |
|
230 | + ? $datetime_selector_threshold |
|
231 | + : 3, |
|
232 | + 'display_html_label_text' => false, |
|
233 | + ) |
|
234 | + ), |
|
235 | + 'datetime_selector_max_checked' => new EE_Integer_Input( |
|
236 | + array( |
|
237 | + 'html_label_text' => esc_html__( |
|
238 | + 'Date & Time Filter Max Checked', |
|
239 | + 'event_espresso' |
|
240 | + ), |
|
241 | + 'html_help_text' => sprintf( |
|
242 | + esc_html__( |
|
243 | + 'Determines the maximum number of dates that will be checked upon initial loading for a Date and Time Filter.%1$sIf set to zero or left blank, then ALL dates will be checked upon initial loading.', |
|
244 | + 'event_espresso' |
|
245 | + ), |
|
246 | + '<br>' |
|
247 | + ), |
|
248 | + 'default' => $EE_Ticket_Selector_Config->getDatetimeSelectorMaxChecked(), |
|
249 | + 'display_html_label_text' => false, |
|
250 | + 'min_value' => 0, |
|
251 | + ) |
|
252 | + ), |
|
253 | + ) |
|
254 | + ), |
|
255 | + ) |
|
256 | + ); |
|
257 | + } |
|
258 | 258 | |
259 | 259 | |
260 | - /** |
|
261 | - * callback for updating template settings |
|
262 | - * |
|
263 | - * @since 4.6.18.rc.006 |
|
264 | - * @param EE_Template_Config $CFG |
|
265 | - * @param array $REQ incoming request |
|
266 | - * @return EE_Template_Config |
|
267 | - * @throws EE_Error |
|
268 | - * @throws InvalidArgumentException |
|
269 | - * @throws ReflectionException |
|
270 | - * @throws InvalidDataTypeException |
|
271 | - * @throws InvalidInterfaceException |
|
272 | - */ |
|
273 | - public static function update_template_settings(EE_Template_Config $CFG, $REQ) |
|
274 | - { |
|
275 | - if (! $CFG->EED_Ticket_Selector instanceof EE_Ticket_Selector_Config) { |
|
276 | - EED_Ticket_Selector::instance()->set_config(); |
|
277 | - $CFG->EED_Ticket_Selector = EED_Ticket_Selector::instance()->config(); |
|
278 | - } |
|
279 | - try { |
|
280 | - $ticket_selector_form = EED_Ticket_Selector_Caff::_ticket_selector_settings_form(); |
|
260 | + /** |
|
261 | + * callback for updating template settings |
|
262 | + * |
|
263 | + * @since 4.6.18.rc.006 |
|
264 | + * @param EE_Template_Config $CFG |
|
265 | + * @param array $REQ incoming request |
|
266 | + * @return EE_Template_Config |
|
267 | + * @throws EE_Error |
|
268 | + * @throws InvalidArgumentException |
|
269 | + * @throws ReflectionException |
|
270 | + * @throws InvalidDataTypeException |
|
271 | + * @throws InvalidInterfaceException |
|
272 | + */ |
|
273 | + public static function update_template_settings(EE_Template_Config $CFG, $REQ) |
|
274 | + { |
|
275 | + if (! $CFG->EED_Ticket_Selector instanceof EE_Ticket_Selector_Config) { |
|
276 | + EED_Ticket_Selector::instance()->set_config(); |
|
277 | + $CFG->EED_Ticket_Selector = EED_Ticket_Selector::instance()->config(); |
|
278 | + } |
|
279 | + try { |
|
280 | + $ticket_selector_form = EED_Ticket_Selector_Caff::_ticket_selector_settings_form(); |
|
281 | 281 | |
282 | - // check for form submission |
|
283 | - if ($ticket_selector_form->was_submitted()) { |
|
284 | - // capture form data |
|
285 | - $ticket_selector_form->receive_form_submission(); |
|
282 | + // check for form submission |
|
283 | + if ($ticket_selector_form->was_submitted()) { |
|
284 | + // capture form data |
|
285 | + $ticket_selector_form->receive_form_submission(); |
|
286 | 286 | |
287 | - // validate form data |
|
288 | - if ($ticket_selector_form->is_valid()) { |
|
289 | - // grab validated data from form |
|
290 | - $valid_data = $ticket_selector_form->valid_data(); |
|
287 | + // validate form data |
|
288 | + if ($ticket_selector_form->is_valid()) { |
|
289 | + // grab validated data from form |
|
290 | + $valid_data = $ticket_selector_form->valid_data(); |
|
291 | 291 | |
292 | - // set data on config |
|
293 | - $CFG->EED_Ticket_Selector->show_ticket_sale_columns = $valid_data['appearance_settings']['show_ticket_sale_columns']; |
|
294 | - $CFG->EED_Ticket_Selector->show_ticket_details = $valid_data['appearance_settings']['show_ticket_details']; |
|
295 | - $CFG->EED_Ticket_Selector->show_expired_tickets = $valid_data['appearance_settings']['show_expired_tickets']; |
|
296 | - $CFG->EED_Ticket_Selector->setShowDatetimeSelector( |
|
297 | - $valid_data['appearance_settings']['show_datetime_selector'] |
|
298 | - ); |
|
299 | - $CFG->EED_Ticket_Selector->setDatetimeSelectorThreshold( |
|
300 | - $valid_data['appearance_settings']['datetime_selector_threshold'] |
|
301 | - ); |
|
302 | - $CFG->EED_Ticket_Selector->setDatetimeSelectorMaxChecked( |
|
303 | - $valid_data['appearance_settings']['datetime_selector_max_checked'] |
|
304 | - ); |
|
305 | - } else { |
|
306 | - if ($ticket_selector_form->submission_error_message() !== '') { |
|
307 | - EE_Error::add_error( |
|
308 | - $ticket_selector_form->submission_error_message(), |
|
309 | - __FILE__, |
|
310 | - __FUNCTION__, |
|
311 | - __LINE__ |
|
312 | - ); |
|
313 | - } |
|
314 | - } |
|
315 | - } |
|
316 | - } catch (EE_Error $e) { |
|
317 | - $e->get_error(); |
|
318 | - } |
|
292 | + // set data on config |
|
293 | + $CFG->EED_Ticket_Selector->show_ticket_sale_columns = $valid_data['appearance_settings']['show_ticket_sale_columns']; |
|
294 | + $CFG->EED_Ticket_Selector->show_ticket_details = $valid_data['appearance_settings']['show_ticket_details']; |
|
295 | + $CFG->EED_Ticket_Selector->show_expired_tickets = $valid_data['appearance_settings']['show_expired_tickets']; |
|
296 | + $CFG->EED_Ticket_Selector->setShowDatetimeSelector( |
|
297 | + $valid_data['appearance_settings']['show_datetime_selector'] |
|
298 | + ); |
|
299 | + $CFG->EED_Ticket_Selector->setDatetimeSelectorThreshold( |
|
300 | + $valid_data['appearance_settings']['datetime_selector_threshold'] |
|
301 | + ); |
|
302 | + $CFG->EED_Ticket_Selector->setDatetimeSelectorMaxChecked( |
|
303 | + $valid_data['appearance_settings']['datetime_selector_max_checked'] |
|
304 | + ); |
|
305 | + } else { |
|
306 | + if ($ticket_selector_form->submission_error_message() !== '') { |
|
307 | + EE_Error::add_error( |
|
308 | + $ticket_selector_form->submission_error_message(), |
|
309 | + __FILE__, |
|
310 | + __FUNCTION__, |
|
311 | + __LINE__ |
|
312 | + ); |
|
313 | + } |
|
314 | + } |
|
315 | + } |
|
316 | + } catch (EE_Error $e) { |
|
317 | + $e->get_error(); |
|
318 | + } |
|
319 | 319 | |
320 | - return $CFG; |
|
321 | - } |
|
320 | + return $CFG; |
|
321 | + } |
|
322 | 322 | |
323 | 323 | |
324 | - /** |
|
325 | - * @param \EE_Ticket $ticket |
|
326 | - * @param int $ticket_price |
|
327 | - * @param bool $display_ticket_price |
|
328 | - */ |
|
329 | - public static function ticket_price_details(EE_Ticket $ticket, $ticket_price = 0, $display_ticket_price = false) |
|
330 | - { |
|
331 | - require str_replace('\\', DS, plugin_dir_path(__FILE__)) |
|
332 | - . 'templates' . DS . 'ticket_selector_price_details.template.php'; |
|
333 | - } |
|
324 | + /** |
|
325 | + * @param \EE_Ticket $ticket |
|
326 | + * @param int $ticket_price |
|
327 | + * @param bool $display_ticket_price |
|
328 | + */ |
|
329 | + public static function ticket_price_details(EE_Ticket $ticket, $ticket_price = 0, $display_ticket_price = false) |
|
330 | + { |
|
331 | + require str_replace('\\', DS, plugin_dir_path(__FILE__)) |
|
332 | + . 'templates' . DS . 'ticket_selector_price_details.template.php'; |
|
333 | + } |
|
334 | 334 | } |
@@ -52,7 +52,7 @@ discard block |
||
52 | 52 | { |
53 | 53 | define( |
54 | 54 | 'TICKET_SELECTOR_CAFF_TEMPLATES_PATH', |
55 | - str_replace('\\', DS, plugin_dir_path(__FILE__)) . 'templates' . DS |
|
55 | + str_replace('\\', DS, plugin_dir_path(__FILE__)).'templates'.DS |
|
56 | 56 | ); |
57 | 57 | add_action( |
58 | 58 | 'AHEE__template_settings__template__before_settings_form', |
@@ -107,7 +107,7 @@ discard block |
||
107 | 107 | 'FHEE__EED_Ticket_Selector_Caff___ticket_selector_settings_form__form_subsections', |
108 | 108 | array( |
109 | 109 | 'appearance_settings_hdr' => new EE_Form_Section_HTML( |
110 | - EEH_HTML::br(2) . |
|
110 | + EEH_HTML::br(2). |
|
111 | 111 | EEH_HTML::h2(esc_html__('Ticket Selector Template Settings', 'event_espresso')) |
112 | 112 | ), |
113 | 113 | 'appearance_settings' => EED_Ticket_Selector_Caff::_ticket_selector_appearance_settings(), |
@@ -124,7 +124,7 @@ discard block |
||
124 | 124 | */ |
125 | 125 | public static function _ticket_selector_appearance_settings() |
126 | 126 | { |
127 | - if (! EE_Registry::instance()->CFG->template_settings->EED_Ticket_Selector instanceof EE_Ticket_Selector_Config |
|
127 | + if ( ! EE_Registry::instance()->CFG->template_settings->EED_Ticket_Selector instanceof EE_Ticket_Selector_Config |
|
128 | 128 | ) { |
129 | 129 | EED_Ticket_Selector::instance()->set_config(); |
130 | 130 | EE_Registry::instance()->CFG->template_settings->EED_Ticket_Selector = EED_Ticket_Selector::instance() |
@@ -272,7 +272,7 @@ discard block |
||
272 | 272 | */ |
273 | 273 | public static function update_template_settings(EE_Template_Config $CFG, $REQ) |
274 | 274 | { |
275 | - if (! $CFG->EED_Ticket_Selector instanceof EE_Ticket_Selector_Config) { |
|
275 | + if ( ! $CFG->EED_Ticket_Selector instanceof EE_Ticket_Selector_Config) { |
|
276 | 276 | EED_Ticket_Selector::instance()->set_config(); |
277 | 277 | $CFG->EED_Ticket_Selector = EED_Ticket_Selector::instance()->config(); |
278 | 278 | } |
@@ -329,6 +329,6 @@ discard block |
||
329 | 329 | public static function ticket_price_details(EE_Ticket $ticket, $ticket_price = 0, $display_ticket_price = false) |
330 | 330 | { |
331 | 331 | require str_replace('\\', DS, plugin_dir_path(__FILE__)) |
332 | - . 'templates' . DS . 'ticket_selector_price_details.template.php'; |
|
332 | + . 'templates'.DS.'ticket_selector_price_details.template.php'; |
|
333 | 333 | } |
334 | 334 | } |
@@ -12,180 +12,180 @@ |
||
12 | 12 | { |
13 | 13 | |
14 | 14 | |
15 | - /** |
|
16 | - * enqueues css and js, so that this can be called statically |
|
17 | - */ |
|
18 | - public static function enqueue_styles_and_scripts() |
|
19 | - { |
|
20 | - wp_register_style( |
|
21 | - 'checkbox_dropdown_selector', |
|
22 | - EE_GLOBAL_ASSETS_URL . 'css/checkbox_dropdown_selector.css', |
|
23 | - array('espresso_default'), |
|
24 | - EVENT_ESPRESSO_VERSION |
|
25 | - ); |
|
26 | - wp_register_style( |
|
27 | - 'espresso_default', |
|
28 | - EE_GLOBAL_ASSETS_URL . 'css/espresso_default.css', |
|
29 | - array('dashicons'), |
|
30 | - EVENT_ESPRESSO_VERSION |
|
31 | - ); |
|
32 | - wp_enqueue_style('checkbox_dropdown_selector'); |
|
33 | - wp_register_script( |
|
34 | - 'checkbox_dropdown_selector', |
|
35 | - EE_GLOBAL_ASSETS_URL . 'scripts/checkbox_dropdown_selector.js', |
|
36 | - array('jquery'), |
|
37 | - EVENT_ESPRESSO_VERSION, |
|
38 | - true |
|
39 | - ); |
|
40 | - wp_localize_script( |
|
41 | - 'ticket_selector', |
|
42 | - 'eeDTS', |
|
43 | - array( |
|
44 | - 'maxChecked' => EE_Registry::instance() |
|
45 | - ->CFG |
|
46 | - ->template_settings |
|
47 | - ->EED_Ticket_Selector |
|
48 | - ->getDatetimeSelectorMaxChecked() |
|
49 | - ) |
|
50 | - ); |
|
51 | - wp_enqueue_script('checkbox_dropdown_selector'); |
|
52 | - } |
|
15 | + /** |
|
16 | + * enqueues css and js, so that this can be called statically |
|
17 | + */ |
|
18 | + public static function enqueue_styles_and_scripts() |
|
19 | + { |
|
20 | + wp_register_style( |
|
21 | + 'checkbox_dropdown_selector', |
|
22 | + EE_GLOBAL_ASSETS_URL . 'css/checkbox_dropdown_selector.css', |
|
23 | + array('espresso_default'), |
|
24 | + EVENT_ESPRESSO_VERSION |
|
25 | + ); |
|
26 | + wp_register_style( |
|
27 | + 'espresso_default', |
|
28 | + EE_GLOBAL_ASSETS_URL . 'css/espresso_default.css', |
|
29 | + array('dashicons'), |
|
30 | + EVENT_ESPRESSO_VERSION |
|
31 | + ); |
|
32 | + wp_enqueue_style('checkbox_dropdown_selector'); |
|
33 | + wp_register_script( |
|
34 | + 'checkbox_dropdown_selector', |
|
35 | + EE_GLOBAL_ASSETS_URL . 'scripts/checkbox_dropdown_selector.js', |
|
36 | + array('jquery'), |
|
37 | + EVENT_ESPRESSO_VERSION, |
|
38 | + true |
|
39 | + ); |
|
40 | + wp_localize_script( |
|
41 | + 'ticket_selector', |
|
42 | + 'eeDTS', |
|
43 | + array( |
|
44 | + 'maxChecked' => EE_Registry::instance() |
|
45 | + ->CFG |
|
46 | + ->template_settings |
|
47 | + ->EED_Ticket_Selector |
|
48 | + ->getDatetimeSelectorMaxChecked() |
|
49 | + ) |
|
50 | + ); |
|
51 | + wp_enqueue_script('checkbox_dropdown_selector'); |
|
52 | + } |
|
53 | 53 | |
54 | 54 | |
55 | 55 | |
56 | - /** |
|
57 | - * Informs the rest of the forms system what CSS and JS is needed to display the input |
|
58 | - */ |
|
59 | - public function enqueue_js() |
|
60 | - { |
|
61 | - EE_Checkbox_Dropdown_Selector_Display_Strategy::enqueue_styles_and_scripts(); |
|
62 | - } |
|
56 | + /** |
|
57 | + * Informs the rest of the forms system what CSS and JS is needed to display the input |
|
58 | + */ |
|
59 | + public function enqueue_js() |
|
60 | + { |
|
61 | + EE_Checkbox_Dropdown_Selector_Display_Strategy::enqueue_styles_and_scripts(); |
|
62 | + } |
|
63 | 63 | |
64 | 64 | |
65 | 65 | |
66 | - /** |
|
67 | - * callback for Iframe::addStylesheets() child class methods |
|
68 | - * |
|
69 | - * @param array $iframe_css |
|
70 | - * @return array |
|
71 | - */ |
|
72 | - public function iframe_css(array $iframe_css) |
|
73 | - { |
|
74 | - $iframe_css['checkbox_dropdown_selector'] = EE_GLOBAL_ASSETS_URL . 'css/checkbox_dropdown_selector.css'; |
|
75 | - return $iframe_css; |
|
76 | - } |
|
66 | + /** |
|
67 | + * callback for Iframe::addStylesheets() child class methods |
|
68 | + * |
|
69 | + * @param array $iframe_css |
|
70 | + * @return array |
|
71 | + */ |
|
72 | + public function iframe_css(array $iframe_css) |
|
73 | + { |
|
74 | + $iframe_css['checkbox_dropdown_selector'] = EE_GLOBAL_ASSETS_URL . 'css/checkbox_dropdown_selector.css'; |
|
75 | + return $iframe_css; |
|
76 | + } |
|
77 | 77 | |
78 | 78 | |
79 | 79 | |
80 | - /** |
|
81 | - * callback for Iframe::addScripts() child class methods |
|
82 | - * |
|
83 | - * @param array $iframe_js |
|
84 | - * @return array |
|
85 | - */ |
|
86 | - public function iframe_js(array $iframe_js) |
|
87 | - { |
|
88 | - $iframe_js['checkbox_dropdown_selector'] = EE_GLOBAL_ASSETS_URL . 'scripts/checkbox_dropdown_selector.js'; |
|
89 | - return $iframe_js; |
|
90 | - } |
|
80 | + /** |
|
81 | + * callback for Iframe::addScripts() child class methods |
|
82 | + * |
|
83 | + * @param array $iframe_js |
|
84 | + * @return array |
|
85 | + */ |
|
86 | + public function iframe_js(array $iframe_js) |
|
87 | + { |
|
88 | + $iframe_js['checkbox_dropdown_selector'] = EE_GLOBAL_ASSETS_URL . 'scripts/checkbox_dropdown_selector.js'; |
|
89 | + return $iframe_js; |
|
90 | + } |
|
91 | 91 | |
92 | 92 | |
93 | - /** |
|
94 | - * @throws EE_Error |
|
95 | - * @return string of html to display the field |
|
96 | - */ |
|
97 | - public function display() |
|
98 | - { |
|
99 | - $input = $this->get_input(); |
|
100 | - $select_button_text = $input instanceof EE_Checkbox_Dropdown_Selector_Input ? $input->select_button_text() : ''; |
|
101 | - // $multi = count( $input->options() ) > 1 ? TRUE : FALSE; |
|
102 | - $input->set_label_sizes(); |
|
103 | - $label_size_class = $input->get_label_size_class(); |
|
104 | - if (! is_array($input->raw_value()) && $input->raw_value() !== null) { |
|
105 | - EE_Error::doing_it_wrong( |
|
106 | - 'EE_Checkbox_Display_Strategy::display()', |
|
107 | - sprintf( |
|
108 | - esc_html__( |
|
109 | - 'Input values for checkboxes should be an array of values, but the value for input "%1$s" is "%2$s". Please verify that the input name is exactly "%3$s"', |
|
110 | - 'event_espresso' |
|
111 | - ), |
|
112 | - $input->html_id(), |
|
113 | - var_export($input->raw_value(), true), |
|
114 | - $input->html_name() . '[]' |
|
115 | - ), |
|
116 | - '4.8.1' |
|
117 | - ); |
|
118 | - } |
|
93 | + /** |
|
94 | + * @throws EE_Error |
|
95 | + * @return string of html to display the field |
|
96 | + */ |
|
97 | + public function display() |
|
98 | + { |
|
99 | + $input = $this->get_input(); |
|
100 | + $select_button_text = $input instanceof EE_Checkbox_Dropdown_Selector_Input ? $input->select_button_text() : ''; |
|
101 | + // $multi = count( $input->options() ) > 1 ? TRUE : FALSE; |
|
102 | + $input->set_label_sizes(); |
|
103 | + $label_size_class = $input->get_label_size_class(); |
|
104 | + if (! is_array($input->raw_value()) && $input->raw_value() !== null) { |
|
105 | + EE_Error::doing_it_wrong( |
|
106 | + 'EE_Checkbox_Display_Strategy::display()', |
|
107 | + sprintf( |
|
108 | + esc_html__( |
|
109 | + 'Input values for checkboxes should be an array of values, but the value for input "%1$s" is "%2$s". Please verify that the input name is exactly "%3$s"', |
|
110 | + 'event_espresso' |
|
111 | + ), |
|
112 | + $input->html_id(), |
|
113 | + var_export($input->raw_value(), true), |
|
114 | + $input->html_name() . '[]' |
|
115 | + ), |
|
116 | + '4.8.1' |
|
117 | + ); |
|
118 | + } |
|
119 | 119 | |
120 | 120 | |
121 | - $html = \EEH_HTML::div('', '', 'checkbox-dropdown-selector-wrap-dv'); |
|
122 | - $html .= '<button id="' . $input->html_id() . '-btn"'; |
|
123 | - // $html .= ' name="' . $input->html_name() . '"'; |
|
124 | - $html .= ' class="' . $input->html_class() . ' checkbox-dropdown-selector-btn button-secondary button"'; |
|
125 | - $html .= ' style="' . $input->html_style() . '"'; |
|
126 | - $html .= ' data-target="' . $input->html_id() . '-options-dv"'; |
|
127 | - $html .= ' ' . $input->html_other_attributes() . '>'; |
|
128 | - $html .= '<span class="checkbox-dropdown-selector-selected-spn">'; |
|
129 | - $html .= $select_button_text; |
|
130 | - $html .= '</span> <span class="dashicons dashicons-arrow-down"></span>'; |
|
131 | - $html .= '</button>'; |
|
132 | - $html .= EEH_HTML::div( |
|
133 | - '', |
|
134 | - $input->html_id() . '-options-dv', |
|
135 | - 'checkbox-dropdown-selector' |
|
136 | - ); |
|
137 | - $html .= EEH_HTML::link( |
|
138 | - '', |
|
139 | - '<span class="dashicons dashicons-no"></span>', |
|
140 | - esc_html__('close datetime selector', 'event_espresso'), |
|
141 | - '', |
|
142 | - 'close-espresso-notice' |
|
143 | - ); |
|
144 | - $html .= EEH_HTML::ul(); |
|
145 | - $input_raw_value = (array) $input->raw_value(); |
|
146 | - foreach ($input->options() as $value => $display_text) { |
|
147 | - $html .= EEH_HTML::li(); |
|
148 | - $value = $input->get_normalization_strategy()->unnormalize_one($value); |
|
149 | - $html_id = $this->get_sub_input_id($value); |
|
150 | - $html .= EEH_HTML::nl(0, 'checkbox'); |
|
151 | - $html .= '<label for="' |
|
152 | - . $html_id |
|
153 | - . '" id="' |
|
154 | - . $html_id |
|
155 | - . '-lbl" class="ee-checkbox-label-after' |
|
156 | - . $label_size_class |
|
157 | - . '">'; |
|
158 | - $html .= EEH_HTML::nl(1, 'checkbox'); |
|
159 | - $html .= '<input type="checkbox"'; |
|
160 | - $html .= ' name="' . $input->html_name() . '[]"'; |
|
161 | - $html .= ' id="' . $html_id . '"'; |
|
162 | - $html .= ' class="' . $input->html_class() . '-option"'; |
|
163 | - $html .= $input->html_style() ? ' style="' . $input->html_style() . '"' : ''; |
|
164 | - $html .= ' value="' . esc_attr($value) . '"'; |
|
165 | - $html .= ! empty($input_raw_value) && in_array($value, $input_raw_value, true) |
|
166 | - ? ' checked="checked"' |
|
167 | - : ''; |
|
168 | - $html .= ' ' . $this->_input->other_html_attributes(); |
|
169 | - $html .= '>'; |
|
170 | - $html .= '<span class="datetime-selector-option-text-spn">' . $display_text . '</span>'; |
|
171 | - $html .= EEH_HTML::nl(-1, 'checkbox') . '</label>'; |
|
172 | - $html .= EEH_HTML::lix(); |
|
173 | - } |
|
174 | - $html .= EEH_HTML::ulx(); |
|
175 | - $html .= EEH_HTML::divx(); |
|
176 | - $html .= EEH_HTML::divx(); |
|
177 | - $html .= EEH_HTML::p( |
|
178 | - apply_filters( |
|
179 | - 'FHEE__EE_Checkbox_Dropdown_Selector_Display_Strategy__display__html', |
|
180 | - esc_html__( |
|
181 | - 'To view additional ticket options, click the "Filter by Date" button and select more dates.', |
|
182 | - 'event_espresso' |
|
183 | - ) |
|
184 | - ), |
|
185 | - $input->html_id() . '-date-time-filter-notice-pg', |
|
186 | - 'date-time-filter-notice-pg small-text lt-grey-text' |
|
187 | - ); |
|
188 | - $html .= \EEH_HTML::br(); |
|
189 | - return $html; |
|
190 | - } |
|
121 | + $html = \EEH_HTML::div('', '', 'checkbox-dropdown-selector-wrap-dv'); |
|
122 | + $html .= '<button id="' . $input->html_id() . '-btn"'; |
|
123 | + // $html .= ' name="' . $input->html_name() . '"'; |
|
124 | + $html .= ' class="' . $input->html_class() . ' checkbox-dropdown-selector-btn button-secondary button"'; |
|
125 | + $html .= ' style="' . $input->html_style() . '"'; |
|
126 | + $html .= ' data-target="' . $input->html_id() . '-options-dv"'; |
|
127 | + $html .= ' ' . $input->html_other_attributes() . '>'; |
|
128 | + $html .= '<span class="checkbox-dropdown-selector-selected-spn">'; |
|
129 | + $html .= $select_button_text; |
|
130 | + $html .= '</span> <span class="dashicons dashicons-arrow-down"></span>'; |
|
131 | + $html .= '</button>'; |
|
132 | + $html .= EEH_HTML::div( |
|
133 | + '', |
|
134 | + $input->html_id() . '-options-dv', |
|
135 | + 'checkbox-dropdown-selector' |
|
136 | + ); |
|
137 | + $html .= EEH_HTML::link( |
|
138 | + '', |
|
139 | + '<span class="dashicons dashicons-no"></span>', |
|
140 | + esc_html__('close datetime selector', 'event_espresso'), |
|
141 | + '', |
|
142 | + 'close-espresso-notice' |
|
143 | + ); |
|
144 | + $html .= EEH_HTML::ul(); |
|
145 | + $input_raw_value = (array) $input->raw_value(); |
|
146 | + foreach ($input->options() as $value => $display_text) { |
|
147 | + $html .= EEH_HTML::li(); |
|
148 | + $value = $input->get_normalization_strategy()->unnormalize_one($value); |
|
149 | + $html_id = $this->get_sub_input_id($value); |
|
150 | + $html .= EEH_HTML::nl(0, 'checkbox'); |
|
151 | + $html .= '<label for="' |
|
152 | + . $html_id |
|
153 | + . '" id="' |
|
154 | + . $html_id |
|
155 | + . '-lbl" class="ee-checkbox-label-after' |
|
156 | + . $label_size_class |
|
157 | + . '">'; |
|
158 | + $html .= EEH_HTML::nl(1, 'checkbox'); |
|
159 | + $html .= '<input type="checkbox"'; |
|
160 | + $html .= ' name="' . $input->html_name() . '[]"'; |
|
161 | + $html .= ' id="' . $html_id . '"'; |
|
162 | + $html .= ' class="' . $input->html_class() . '-option"'; |
|
163 | + $html .= $input->html_style() ? ' style="' . $input->html_style() . '"' : ''; |
|
164 | + $html .= ' value="' . esc_attr($value) . '"'; |
|
165 | + $html .= ! empty($input_raw_value) && in_array($value, $input_raw_value, true) |
|
166 | + ? ' checked="checked"' |
|
167 | + : ''; |
|
168 | + $html .= ' ' . $this->_input->other_html_attributes(); |
|
169 | + $html .= '>'; |
|
170 | + $html .= '<span class="datetime-selector-option-text-spn">' . $display_text . '</span>'; |
|
171 | + $html .= EEH_HTML::nl(-1, 'checkbox') . '</label>'; |
|
172 | + $html .= EEH_HTML::lix(); |
|
173 | + } |
|
174 | + $html .= EEH_HTML::ulx(); |
|
175 | + $html .= EEH_HTML::divx(); |
|
176 | + $html .= EEH_HTML::divx(); |
|
177 | + $html .= EEH_HTML::p( |
|
178 | + apply_filters( |
|
179 | + 'FHEE__EE_Checkbox_Dropdown_Selector_Display_Strategy__display__html', |
|
180 | + esc_html__( |
|
181 | + 'To view additional ticket options, click the "Filter by Date" button and select more dates.', |
|
182 | + 'event_espresso' |
|
183 | + ) |
|
184 | + ), |
|
185 | + $input->html_id() . '-date-time-filter-notice-pg', |
|
186 | + 'date-time-filter-notice-pg small-text lt-grey-text' |
|
187 | + ); |
|
188 | + $html .= \EEH_HTML::br(); |
|
189 | + return $html; |
|
190 | + } |
|
191 | 191 | } |
@@ -19,20 +19,20 @@ discard block |
||
19 | 19 | { |
20 | 20 | wp_register_style( |
21 | 21 | 'checkbox_dropdown_selector', |
22 | - EE_GLOBAL_ASSETS_URL . 'css/checkbox_dropdown_selector.css', |
|
22 | + EE_GLOBAL_ASSETS_URL.'css/checkbox_dropdown_selector.css', |
|
23 | 23 | array('espresso_default'), |
24 | 24 | EVENT_ESPRESSO_VERSION |
25 | 25 | ); |
26 | 26 | wp_register_style( |
27 | 27 | 'espresso_default', |
28 | - EE_GLOBAL_ASSETS_URL . 'css/espresso_default.css', |
|
28 | + EE_GLOBAL_ASSETS_URL.'css/espresso_default.css', |
|
29 | 29 | array('dashicons'), |
30 | 30 | EVENT_ESPRESSO_VERSION |
31 | 31 | ); |
32 | 32 | wp_enqueue_style('checkbox_dropdown_selector'); |
33 | 33 | wp_register_script( |
34 | 34 | 'checkbox_dropdown_selector', |
35 | - EE_GLOBAL_ASSETS_URL . 'scripts/checkbox_dropdown_selector.js', |
|
35 | + EE_GLOBAL_ASSETS_URL.'scripts/checkbox_dropdown_selector.js', |
|
36 | 36 | array('jquery'), |
37 | 37 | EVENT_ESPRESSO_VERSION, |
38 | 38 | true |
@@ -71,7 +71,7 @@ discard block |
||
71 | 71 | */ |
72 | 72 | public function iframe_css(array $iframe_css) |
73 | 73 | { |
74 | - $iframe_css['checkbox_dropdown_selector'] = EE_GLOBAL_ASSETS_URL . 'css/checkbox_dropdown_selector.css'; |
|
74 | + $iframe_css['checkbox_dropdown_selector'] = EE_GLOBAL_ASSETS_URL.'css/checkbox_dropdown_selector.css'; |
|
75 | 75 | return $iframe_css; |
76 | 76 | } |
77 | 77 | |
@@ -85,7 +85,7 @@ discard block |
||
85 | 85 | */ |
86 | 86 | public function iframe_js(array $iframe_js) |
87 | 87 | { |
88 | - $iframe_js['checkbox_dropdown_selector'] = EE_GLOBAL_ASSETS_URL . 'scripts/checkbox_dropdown_selector.js'; |
|
88 | + $iframe_js['checkbox_dropdown_selector'] = EE_GLOBAL_ASSETS_URL.'scripts/checkbox_dropdown_selector.js'; |
|
89 | 89 | return $iframe_js; |
90 | 90 | } |
91 | 91 | |
@@ -101,7 +101,7 @@ discard block |
||
101 | 101 | // $multi = count( $input->options() ) > 1 ? TRUE : FALSE; |
102 | 102 | $input->set_label_sizes(); |
103 | 103 | $label_size_class = $input->get_label_size_class(); |
104 | - if (! is_array($input->raw_value()) && $input->raw_value() !== null) { |
|
104 | + if ( ! is_array($input->raw_value()) && $input->raw_value() !== null) { |
|
105 | 105 | EE_Error::doing_it_wrong( |
106 | 106 | 'EE_Checkbox_Display_Strategy::display()', |
107 | 107 | sprintf( |
@@ -111,7 +111,7 @@ discard block |
||
111 | 111 | ), |
112 | 112 | $input->html_id(), |
113 | 113 | var_export($input->raw_value(), true), |
114 | - $input->html_name() . '[]' |
|
114 | + $input->html_name().'[]' |
|
115 | 115 | ), |
116 | 116 | '4.8.1' |
117 | 117 | ); |
@@ -119,19 +119,19 @@ discard block |
||
119 | 119 | |
120 | 120 | |
121 | 121 | $html = \EEH_HTML::div('', '', 'checkbox-dropdown-selector-wrap-dv'); |
122 | - $html .= '<button id="' . $input->html_id() . '-btn"'; |
|
122 | + $html .= '<button id="'.$input->html_id().'-btn"'; |
|
123 | 123 | // $html .= ' name="' . $input->html_name() . '"'; |
124 | - $html .= ' class="' . $input->html_class() . ' checkbox-dropdown-selector-btn button-secondary button"'; |
|
125 | - $html .= ' style="' . $input->html_style() . '"'; |
|
126 | - $html .= ' data-target="' . $input->html_id() . '-options-dv"'; |
|
127 | - $html .= ' ' . $input->html_other_attributes() . '>'; |
|
124 | + $html .= ' class="'.$input->html_class().' checkbox-dropdown-selector-btn button-secondary button"'; |
|
125 | + $html .= ' style="'.$input->html_style().'"'; |
|
126 | + $html .= ' data-target="'.$input->html_id().'-options-dv"'; |
|
127 | + $html .= ' '.$input->html_other_attributes().'>'; |
|
128 | 128 | $html .= '<span class="checkbox-dropdown-selector-selected-spn">'; |
129 | 129 | $html .= $select_button_text; |
130 | 130 | $html .= '</span> <span class="dashicons dashicons-arrow-down"></span>'; |
131 | 131 | $html .= '</button>'; |
132 | 132 | $html .= EEH_HTML::div( |
133 | 133 | '', |
134 | - $input->html_id() . '-options-dv', |
|
134 | + $input->html_id().'-options-dv', |
|
135 | 135 | 'checkbox-dropdown-selector' |
136 | 136 | ); |
137 | 137 | $html .= EEH_HTML::link( |
@@ -157,18 +157,18 @@ discard block |
||
157 | 157 | . '">'; |
158 | 158 | $html .= EEH_HTML::nl(1, 'checkbox'); |
159 | 159 | $html .= '<input type="checkbox"'; |
160 | - $html .= ' name="' . $input->html_name() . '[]"'; |
|
161 | - $html .= ' id="' . $html_id . '"'; |
|
162 | - $html .= ' class="' . $input->html_class() . '-option"'; |
|
163 | - $html .= $input->html_style() ? ' style="' . $input->html_style() . '"' : ''; |
|
164 | - $html .= ' value="' . esc_attr($value) . '"'; |
|
160 | + $html .= ' name="'.$input->html_name().'[]"'; |
|
161 | + $html .= ' id="'.$html_id.'"'; |
|
162 | + $html .= ' class="'.$input->html_class().'-option"'; |
|
163 | + $html .= $input->html_style() ? ' style="'.$input->html_style().'"' : ''; |
|
164 | + $html .= ' value="'.esc_attr($value).'"'; |
|
165 | 165 | $html .= ! empty($input_raw_value) && in_array($value, $input_raw_value, true) |
166 | 166 | ? ' checked="checked"' |
167 | 167 | : ''; |
168 | - $html .= ' ' . $this->_input->other_html_attributes(); |
|
168 | + $html .= ' '.$this->_input->other_html_attributes(); |
|
169 | 169 | $html .= '>'; |
170 | - $html .= '<span class="datetime-selector-option-text-spn">' . $display_text . '</span>'; |
|
171 | - $html .= EEH_HTML::nl(-1, 'checkbox') . '</label>'; |
|
170 | + $html .= '<span class="datetime-selector-option-text-spn">'.$display_text.'</span>'; |
|
171 | + $html .= EEH_HTML::nl(-1, 'checkbox').'</label>'; |
|
172 | 172 | $html .= EEH_HTML::lix(); |
173 | 173 | } |
174 | 174 | $html .= EEH_HTML::ulx(); |
@@ -182,7 +182,7 @@ discard block |
||
182 | 182 | 'event_espresso' |
183 | 183 | ) |
184 | 184 | ), |
185 | - $input->html_id() . '-date-time-filter-notice-pg', |
|
185 | + $input->html_id().'-date-time-filter-notice-pg', |
|
186 | 186 | 'date-time-filter-notice-pg small-text lt-grey-text' |
187 | 187 | ); |
188 | 188 | $html .= \EEH_HTML::br(); |
@@ -13,1355 +13,1355 @@ |
||
13 | 13 | class EE_Event extends EE_CPT_Base implements EEI_Line_Item_Object, EEI_Admin_Links, EEI_Has_Icon, EEI_Event |
14 | 14 | { |
15 | 15 | |
16 | - /** |
|
17 | - * cached value for the the logical active status for the event |
|
18 | - * |
|
19 | - * @see get_active_status() |
|
20 | - * @var string |
|
21 | - */ |
|
22 | - protected $_active_status = ''; |
|
23 | - |
|
24 | - /** |
|
25 | - * This is just used for caching the Primary Datetime for the Event on initial retrieval |
|
26 | - * |
|
27 | - * @var EE_Datetime |
|
28 | - */ |
|
29 | - protected $_Primary_Datetime; |
|
30 | - |
|
31 | - /** |
|
32 | - * @var EventSpacesCalculator $available_spaces_calculator |
|
33 | - */ |
|
34 | - protected $available_spaces_calculator; |
|
35 | - |
|
36 | - |
|
37 | - /** |
|
38 | - * @param array $props_n_values incoming values |
|
39 | - * @param string $timezone incoming timezone (if not set the timezone set for the website will be |
|
40 | - * used.) |
|
41 | - * @param array $date_formats incoming date_formats in an array where the first value is the |
|
42 | - * date_format and the second value is the time format |
|
43 | - * @return EE_Event |
|
44 | - * @throws EE_Error |
|
45 | - */ |
|
46 | - public static function new_instance($props_n_values = array(), $timezone = null, $date_formats = array()) |
|
47 | - { |
|
48 | - $has_object = parent::_check_for_object($props_n_values, __CLASS__, $timezone, $date_formats); |
|
49 | - return $has_object ? $has_object : new self($props_n_values, false, $timezone, $date_formats); |
|
50 | - } |
|
51 | - |
|
52 | - |
|
53 | - /** |
|
54 | - * @param array $props_n_values incoming values from the database |
|
55 | - * @param string $timezone incoming timezone as set by the model. If not set the timezone for |
|
56 | - * the website will be used. |
|
57 | - * @return EE_Event |
|
58 | - * @throws EE_Error |
|
59 | - */ |
|
60 | - public static function new_instance_from_db($props_n_values = array(), $timezone = null) |
|
61 | - { |
|
62 | - return new self($props_n_values, true, $timezone); |
|
63 | - } |
|
64 | - |
|
65 | - |
|
66 | - /** |
|
67 | - * @return EventSpacesCalculator |
|
68 | - * @throws \EE_Error |
|
69 | - */ |
|
70 | - public function getAvailableSpacesCalculator() |
|
71 | - { |
|
72 | - if (! $this->available_spaces_calculator instanceof EventSpacesCalculator) { |
|
73 | - $this->available_spaces_calculator = new EventSpacesCalculator($this); |
|
74 | - } |
|
75 | - return $this->available_spaces_calculator; |
|
76 | - } |
|
77 | - |
|
78 | - |
|
79 | - /** |
|
80 | - * Overrides parent set() method so that all calls to set( 'status', $status ) can be routed to internal methods |
|
81 | - * |
|
82 | - * @param string $field_name |
|
83 | - * @param mixed $field_value |
|
84 | - * @param bool $use_default |
|
85 | - * @throws EE_Error |
|
86 | - */ |
|
87 | - public function set($field_name, $field_value, $use_default = false) |
|
88 | - { |
|
89 | - switch ($field_name) { |
|
90 | - case 'status': |
|
91 | - $this->set_status($field_value, $use_default); |
|
92 | - break; |
|
93 | - default: |
|
94 | - parent::set($field_name, $field_value, $use_default); |
|
95 | - } |
|
96 | - } |
|
97 | - |
|
98 | - |
|
99 | - /** |
|
100 | - * set_status |
|
101 | - * Checks if event status is being changed to SOLD OUT |
|
102 | - * and updates event meta data with previous event status |
|
103 | - * so that we can revert things if/when the event is no longer sold out |
|
104 | - * |
|
105 | - * @access public |
|
106 | - * @param string $new_status |
|
107 | - * @param bool $use_default |
|
108 | - * @return void |
|
109 | - * @throws EE_Error |
|
110 | - */ |
|
111 | - public function set_status($new_status = null, $use_default = false) |
|
112 | - { |
|
113 | - // if nothing is set, and we aren't explicitly wanting to reset the status, then just leave |
|
114 | - if (empty($new_status) && ! $use_default) { |
|
115 | - return; |
|
116 | - } |
|
117 | - // get current Event status |
|
118 | - $old_status = $this->status(); |
|
119 | - // if status has changed |
|
120 | - if ($old_status !== $new_status) { |
|
121 | - // TO sold_out |
|
122 | - if ($new_status === EEM_Event::sold_out) { |
|
123 | - // save the previous event status so that we can revert if the event is no longer sold out |
|
124 | - $this->add_post_meta('_previous_event_status', $old_status); |
|
125 | - do_action('AHEE__EE_Event__set_status__to_sold_out', $this, $old_status, $new_status); |
|
126 | - // OR FROM sold_out |
|
127 | - } elseif ($old_status === EEM_Event::sold_out) { |
|
128 | - $this->delete_post_meta('_previous_event_status'); |
|
129 | - do_action('AHEE__EE_Event__set_status__from_sold_out', $this, $old_status, $new_status); |
|
130 | - } |
|
131 | - // clear out the active status so that it gets reset the next time it is requested |
|
132 | - $this->_active_status = null; |
|
133 | - // update status |
|
134 | - parent::set('status', $new_status, $use_default); |
|
135 | - do_action('AHEE__EE_Event__set_status__after_update', $this); |
|
136 | - return; |
|
137 | - } |
|
138 | - // even though the old value matches the new value, it's still good to |
|
139 | - // allow the parent set method to have a say |
|
140 | - parent::set('status', $new_status, $use_default); |
|
141 | - } |
|
142 | - |
|
143 | - |
|
144 | - /** |
|
145 | - * Gets all the datetimes for this event |
|
146 | - * |
|
147 | - * @param array $query_params like EEM_Base::get_all |
|
148 | - * @return EE_Base_Class[]|EE_Datetime[] |
|
149 | - * @throws EE_Error |
|
150 | - */ |
|
151 | - public function datetimes($query_params = array()) |
|
152 | - { |
|
153 | - return $this->get_many_related('Datetime', $query_params); |
|
154 | - } |
|
155 | - |
|
156 | - |
|
157 | - /** |
|
158 | - * Gets all the datetimes for this event, ordered by DTT_EVT_start in ascending order |
|
159 | - * |
|
160 | - * @return EE_Base_Class[]|EE_Datetime[] |
|
161 | - * @throws EE_Error |
|
162 | - */ |
|
163 | - public function datetimes_in_chronological_order() |
|
164 | - { |
|
165 | - return $this->get_many_related('Datetime', array('order_by' => array('DTT_EVT_start' => 'ASC'))); |
|
166 | - } |
|
167 | - |
|
168 | - |
|
169 | - /** |
|
170 | - * Gets all the datetimes for this event, ordered by the DTT_order on the datetime. |
|
171 | - * @darren, we should probably UNSET timezone on the EEM_Datetime model |
|
172 | - * after running our query, so that this timezone isn't set for EVERY query |
|
173 | - * on EEM_Datetime for the rest of the request, no? |
|
174 | - * |
|
175 | - * @param boolean $show_expired whether or not to include expired events |
|
176 | - * @param boolean $show_deleted whether or not to include deleted events |
|
177 | - * @param null $limit |
|
178 | - * @return EE_Datetime[] |
|
179 | - * @throws EE_Error |
|
180 | - */ |
|
181 | - public function datetimes_ordered($show_expired = true, $show_deleted = false, $limit = null) |
|
182 | - { |
|
183 | - return EEM_Datetime::instance($this->_timezone)->get_datetimes_for_event_ordered_by_DTT_order( |
|
184 | - $this->ID(), |
|
185 | - $show_expired, |
|
186 | - $show_deleted, |
|
187 | - $limit |
|
188 | - ); |
|
189 | - } |
|
190 | - |
|
191 | - |
|
192 | - /** |
|
193 | - * Returns one related datetime. Mostly only used by some legacy code. |
|
194 | - * |
|
195 | - * @return EE_Base_Class|EE_Datetime |
|
196 | - * @throws EE_Error |
|
197 | - */ |
|
198 | - public function first_datetime() |
|
199 | - { |
|
200 | - return $this->get_first_related('Datetime'); |
|
201 | - } |
|
202 | - |
|
203 | - |
|
204 | - /** |
|
205 | - * Returns the 'primary' datetime for the event |
|
206 | - * |
|
207 | - * @param bool $try_to_exclude_expired |
|
208 | - * @param bool $try_to_exclude_deleted |
|
209 | - * @return EE_Datetime |
|
210 | - * @throws EE_Error |
|
211 | - */ |
|
212 | - public function primary_datetime($try_to_exclude_expired = true, $try_to_exclude_deleted = true) |
|
213 | - { |
|
214 | - if (! empty($this->_Primary_Datetime)) { |
|
215 | - return $this->_Primary_Datetime; |
|
216 | - } |
|
217 | - $this->_Primary_Datetime = EEM_Datetime::instance($this->_timezone)->get_primary_datetime_for_event( |
|
218 | - $this->ID(), |
|
219 | - $try_to_exclude_expired, |
|
220 | - $try_to_exclude_deleted |
|
221 | - ); |
|
222 | - return $this->_Primary_Datetime; |
|
223 | - } |
|
224 | - |
|
225 | - |
|
226 | - /** |
|
227 | - * Gets all the tickets available for purchase of this event |
|
228 | - * |
|
229 | - * @param array $query_params like EEM_Base::get_all |
|
230 | - * @return EE_Base_Class[]|EE_Ticket[] |
|
231 | - * @throws EE_Error |
|
232 | - */ |
|
233 | - public function tickets($query_params = array()) |
|
234 | - { |
|
235 | - // first get all datetimes |
|
236 | - $datetimes = $this->datetimes_ordered(); |
|
237 | - if (! $datetimes) { |
|
238 | - return array(); |
|
239 | - } |
|
240 | - $datetime_ids = array(); |
|
241 | - foreach ($datetimes as $datetime) { |
|
242 | - $datetime_ids[] = $datetime->ID(); |
|
243 | - } |
|
244 | - $where_params = array('Datetime.DTT_ID' => array('IN', $datetime_ids)); |
|
245 | - // if incoming $query_params has where conditions let's merge but not override existing. |
|
246 | - if (is_array($query_params) && isset($query_params[0])) { |
|
247 | - $where_params = array_merge($query_params[0], $where_params); |
|
248 | - unset($query_params[0]); |
|
249 | - } |
|
250 | - // now add $where_params to $query_params |
|
251 | - $query_params[0] = $where_params; |
|
252 | - return EEM_Ticket::instance()->get_all($query_params); |
|
253 | - } |
|
254 | - |
|
255 | - |
|
256 | - /** |
|
257 | - * get all unexpired untrashed tickets |
|
258 | - * |
|
259 | - * @return EE_Ticket[] |
|
260 | - * @throws EE_Error |
|
261 | - */ |
|
262 | - public function active_tickets() |
|
263 | - { |
|
264 | - return $this->tickets( |
|
265 | - array( |
|
266 | - array( |
|
267 | - 'TKT_end_date' => array('>=', EEM_Ticket::instance()->current_time_for_query('TKT_end_date')), |
|
268 | - 'TKT_deleted' => false, |
|
269 | - ), |
|
270 | - ) |
|
271 | - ); |
|
272 | - } |
|
273 | - |
|
274 | - |
|
275 | - /** |
|
276 | - * @return bool |
|
277 | - * @throws EE_Error |
|
278 | - */ |
|
279 | - public function additional_limit() |
|
280 | - { |
|
281 | - return $this->get('EVT_additional_limit'); |
|
282 | - } |
|
283 | - |
|
284 | - |
|
285 | - /** |
|
286 | - * @return bool |
|
287 | - * @throws EE_Error |
|
288 | - */ |
|
289 | - public function allow_overflow() |
|
290 | - { |
|
291 | - return $this->get('EVT_allow_overflow'); |
|
292 | - } |
|
293 | - |
|
294 | - |
|
295 | - /** |
|
296 | - * @return bool |
|
297 | - * @throws EE_Error |
|
298 | - */ |
|
299 | - public function created() |
|
300 | - { |
|
301 | - return $this->get('EVT_created'); |
|
302 | - } |
|
303 | - |
|
304 | - |
|
305 | - /** |
|
306 | - * @return bool |
|
307 | - * @throws EE_Error |
|
308 | - */ |
|
309 | - public function description() |
|
310 | - { |
|
311 | - return $this->get('EVT_desc'); |
|
312 | - } |
|
313 | - |
|
314 | - |
|
315 | - /** |
|
316 | - * Runs do_shortcode and wpautop on the description |
|
317 | - * |
|
318 | - * @return string of html |
|
319 | - * @throws EE_Error |
|
320 | - */ |
|
321 | - public function description_filtered() |
|
322 | - { |
|
323 | - return $this->get_pretty('EVT_desc'); |
|
324 | - } |
|
325 | - |
|
326 | - |
|
327 | - /** |
|
328 | - * @return bool |
|
329 | - * @throws EE_Error |
|
330 | - */ |
|
331 | - public function display_description() |
|
332 | - { |
|
333 | - return $this->get('EVT_display_desc'); |
|
334 | - } |
|
335 | - |
|
336 | - |
|
337 | - /** |
|
338 | - * @return bool |
|
339 | - * @throws EE_Error |
|
340 | - */ |
|
341 | - public function display_ticket_selector() |
|
342 | - { |
|
343 | - return (bool) $this->get('EVT_display_ticket_selector'); |
|
344 | - } |
|
345 | - |
|
346 | - |
|
347 | - /** |
|
348 | - * @return bool |
|
349 | - * @throws EE_Error |
|
350 | - */ |
|
351 | - public function external_url() |
|
352 | - { |
|
353 | - return $this->get('EVT_external_URL'); |
|
354 | - } |
|
355 | - |
|
356 | - |
|
357 | - /** |
|
358 | - * @return bool |
|
359 | - * @throws EE_Error |
|
360 | - */ |
|
361 | - public function member_only() |
|
362 | - { |
|
363 | - return $this->get('EVT_member_only'); |
|
364 | - } |
|
365 | - |
|
366 | - |
|
367 | - /** |
|
368 | - * @return bool |
|
369 | - * @throws EE_Error |
|
370 | - */ |
|
371 | - public function phone() |
|
372 | - { |
|
373 | - return $this->get('EVT_phone'); |
|
374 | - } |
|
375 | - |
|
376 | - |
|
377 | - /** |
|
378 | - * @return bool |
|
379 | - * @throws EE_Error |
|
380 | - */ |
|
381 | - public function modified() |
|
382 | - { |
|
383 | - return $this->get('EVT_modified'); |
|
384 | - } |
|
385 | - |
|
386 | - |
|
387 | - /** |
|
388 | - * @return bool |
|
389 | - * @throws EE_Error |
|
390 | - */ |
|
391 | - public function name() |
|
392 | - { |
|
393 | - return $this->get('EVT_name'); |
|
394 | - } |
|
395 | - |
|
396 | - |
|
397 | - /** |
|
398 | - * @return bool |
|
399 | - * @throws EE_Error |
|
400 | - */ |
|
401 | - public function order() |
|
402 | - { |
|
403 | - return $this->get('EVT_order'); |
|
404 | - } |
|
405 | - |
|
406 | - |
|
407 | - /** |
|
408 | - * @return bool|string |
|
409 | - * @throws EE_Error |
|
410 | - */ |
|
411 | - public function default_registration_status() |
|
412 | - { |
|
413 | - $event_default_registration_status = $this->get('EVT_default_registration_status'); |
|
414 | - return ! empty($event_default_registration_status) |
|
415 | - ? $event_default_registration_status |
|
416 | - : EE_Registry::instance()->CFG->registration->default_STS_ID; |
|
417 | - } |
|
418 | - |
|
419 | - |
|
420 | - /** |
|
421 | - * @param int $num_words |
|
422 | - * @param null $more |
|
423 | - * @param bool $not_full_desc |
|
424 | - * @return bool|string |
|
425 | - * @throws EE_Error |
|
426 | - */ |
|
427 | - public function short_description($num_words = 55, $more = null, $not_full_desc = false) |
|
428 | - { |
|
429 | - $short_desc = $this->get('EVT_short_desc'); |
|
430 | - if (! empty($short_desc) || $not_full_desc) { |
|
431 | - return $short_desc; |
|
432 | - } |
|
433 | - $full_desc = $this->get('EVT_desc'); |
|
434 | - return wp_trim_words($full_desc, $num_words, $more); |
|
435 | - } |
|
436 | - |
|
437 | - |
|
438 | - /** |
|
439 | - * @return bool |
|
440 | - * @throws EE_Error |
|
441 | - */ |
|
442 | - public function slug() |
|
443 | - { |
|
444 | - return $this->get('EVT_slug'); |
|
445 | - } |
|
446 | - |
|
447 | - |
|
448 | - /** |
|
449 | - * @return bool |
|
450 | - * @throws EE_Error |
|
451 | - */ |
|
452 | - public function timezone_string() |
|
453 | - { |
|
454 | - return $this->get('EVT_timezone_string'); |
|
455 | - } |
|
456 | - |
|
457 | - |
|
458 | - /** |
|
459 | - * @return bool |
|
460 | - * @throws EE_Error |
|
461 | - */ |
|
462 | - public function visible_on() |
|
463 | - { |
|
464 | - return $this->get('EVT_visible_on'); |
|
465 | - } |
|
466 | - |
|
467 | - |
|
468 | - /** |
|
469 | - * @return int |
|
470 | - * @throws EE_Error |
|
471 | - */ |
|
472 | - public function wp_user() |
|
473 | - { |
|
474 | - return $this->get('EVT_wp_user'); |
|
475 | - } |
|
476 | - |
|
477 | - |
|
478 | - /** |
|
479 | - * @return bool |
|
480 | - * @throws EE_Error |
|
481 | - */ |
|
482 | - public function donations() |
|
483 | - { |
|
484 | - return $this->get('EVT_donations'); |
|
485 | - } |
|
486 | - |
|
487 | - |
|
488 | - /** |
|
489 | - * @param $limit |
|
490 | - * @throws EE_Error |
|
491 | - */ |
|
492 | - public function set_additional_limit($limit) |
|
493 | - { |
|
494 | - $this->set('EVT_additional_limit', $limit); |
|
495 | - } |
|
496 | - |
|
497 | - |
|
498 | - /** |
|
499 | - * @param $created |
|
500 | - * @throws EE_Error |
|
501 | - */ |
|
502 | - public function set_created($created) |
|
503 | - { |
|
504 | - $this->set('EVT_created', $created); |
|
505 | - } |
|
506 | - |
|
507 | - |
|
508 | - /** |
|
509 | - * @param $desc |
|
510 | - * @throws EE_Error |
|
511 | - */ |
|
512 | - public function set_description($desc) |
|
513 | - { |
|
514 | - $this->set('EVT_desc', $desc); |
|
515 | - } |
|
516 | - |
|
517 | - |
|
518 | - /** |
|
519 | - * @param $display_desc |
|
520 | - * @throws EE_Error |
|
521 | - */ |
|
522 | - public function set_display_description($display_desc) |
|
523 | - { |
|
524 | - $this->set('EVT_display_desc', $display_desc); |
|
525 | - } |
|
526 | - |
|
527 | - |
|
528 | - /** |
|
529 | - * @param $display_ticket_selector |
|
530 | - * @throws EE_Error |
|
531 | - */ |
|
532 | - public function set_display_ticket_selector($display_ticket_selector) |
|
533 | - { |
|
534 | - $this->set('EVT_display_ticket_selector', $display_ticket_selector); |
|
535 | - } |
|
536 | - |
|
537 | - |
|
538 | - /** |
|
539 | - * @param $external_url |
|
540 | - * @throws EE_Error |
|
541 | - */ |
|
542 | - public function set_external_url($external_url) |
|
543 | - { |
|
544 | - $this->set('EVT_external_URL', $external_url); |
|
545 | - } |
|
546 | - |
|
547 | - |
|
548 | - /** |
|
549 | - * @param $member_only |
|
550 | - * @throws EE_Error |
|
551 | - */ |
|
552 | - public function set_member_only($member_only) |
|
553 | - { |
|
554 | - $this->set('EVT_member_only', $member_only); |
|
555 | - } |
|
556 | - |
|
557 | - |
|
558 | - /** |
|
559 | - * @param $event_phone |
|
560 | - * @throws EE_Error |
|
561 | - */ |
|
562 | - public function set_event_phone($event_phone) |
|
563 | - { |
|
564 | - $this->set('EVT_phone', $event_phone); |
|
565 | - } |
|
566 | - |
|
567 | - |
|
568 | - /** |
|
569 | - * @param $modified |
|
570 | - * @throws EE_Error |
|
571 | - */ |
|
572 | - public function set_modified($modified) |
|
573 | - { |
|
574 | - $this->set('EVT_modified', $modified); |
|
575 | - } |
|
576 | - |
|
577 | - |
|
578 | - /** |
|
579 | - * @param $name |
|
580 | - * @throws EE_Error |
|
581 | - */ |
|
582 | - public function set_name($name) |
|
583 | - { |
|
584 | - $this->set('EVT_name', $name); |
|
585 | - } |
|
586 | - |
|
587 | - |
|
588 | - /** |
|
589 | - * @param $order |
|
590 | - * @throws EE_Error |
|
591 | - */ |
|
592 | - public function set_order($order) |
|
593 | - { |
|
594 | - $this->set('EVT_order', $order); |
|
595 | - } |
|
596 | - |
|
597 | - |
|
598 | - /** |
|
599 | - * @param $short_desc |
|
600 | - * @throws EE_Error |
|
601 | - */ |
|
602 | - public function set_short_description($short_desc) |
|
603 | - { |
|
604 | - $this->set('EVT_short_desc', $short_desc); |
|
605 | - } |
|
606 | - |
|
607 | - |
|
608 | - /** |
|
609 | - * @param $slug |
|
610 | - * @throws EE_Error |
|
611 | - */ |
|
612 | - public function set_slug($slug) |
|
613 | - { |
|
614 | - $this->set('EVT_slug', $slug); |
|
615 | - } |
|
616 | - |
|
617 | - |
|
618 | - /** |
|
619 | - * @param $timezone_string |
|
620 | - * @throws EE_Error |
|
621 | - */ |
|
622 | - public function set_timezone_string($timezone_string) |
|
623 | - { |
|
624 | - $this->set('EVT_timezone_string', $timezone_string); |
|
625 | - } |
|
626 | - |
|
627 | - |
|
628 | - /** |
|
629 | - * @param $visible_on |
|
630 | - * @throws EE_Error |
|
631 | - */ |
|
632 | - public function set_visible_on($visible_on) |
|
633 | - { |
|
634 | - $this->set('EVT_visible_on', $visible_on); |
|
635 | - } |
|
636 | - |
|
637 | - |
|
638 | - /** |
|
639 | - * @param $wp_user |
|
640 | - * @throws EE_Error |
|
641 | - */ |
|
642 | - public function set_wp_user($wp_user) |
|
643 | - { |
|
644 | - $this->set('EVT_wp_user', $wp_user); |
|
645 | - } |
|
646 | - |
|
647 | - |
|
648 | - /** |
|
649 | - * @param $default_registration_status |
|
650 | - * @throws EE_Error |
|
651 | - */ |
|
652 | - public function set_default_registration_status($default_registration_status) |
|
653 | - { |
|
654 | - $this->set('EVT_default_registration_status', $default_registration_status); |
|
655 | - } |
|
656 | - |
|
657 | - |
|
658 | - /** |
|
659 | - * @param $donations |
|
660 | - * @throws EE_Error |
|
661 | - */ |
|
662 | - public function set_donations($donations) |
|
663 | - { |
|
664 | - $this->set('EVT_donations', $donations); |
|
665 | - } |
|
666 | - |
|
667 | - |
|
668 | - /** |
|
669 | - * Adds a venue to this event |
|
670 | - * |
|
671 | - * @param EE_Venue /int $venue_id_or_obj |
|
672 | - * @return EE_Base_Class|EE_Venue |
|
673 | - * @throws EE_Error |
|
674 | - */ |
|
675 | - public function add_venue($venue_id_or_obj) |
|
676 | - { |
|
677 | - return $this->_add_relation_to($venue_id_or_obj, 'Venue'); |
|
678 | - } |
|
679 | - |
|
680 | - |
|
681 | - /** |
|
682 | - * Removes a venue from the event |
|
683 | - * |
|
684 | - * @param EE_Venue /int $venue_id_or_obj |
|
685 | - * @return EE_Base_Class|EE_Venue |
|
686 | - * @throws EE_Error |
|
687 | - */ |
|
688 | - public function remove_venue($venue_id_or_obj) |
|
689 | - { |
|
690 | - return $this->_remove_relation_to($venue_id_or_obj, 'Venue'); |
|
691 | - } |
|
692 | - |
|
693 | - |
|
694 | - /** |
|
695 | - * Gets all the venues related ot the event. May provide additional $query_params if desired |
|
696 | - * |
|
697 | - * @param array $query_params like EEM_Base::get_all's $query_params |
|
698 | - * @return EE_Base_Class[]|EE_Venue[] |
|
699 | - * @throws EE_Error |
|
700 | - */ |
|
701 | - public function venues($query_params = array()) |
|
702 | - { |
|
703 | - return $this->get_many_related('Venue', $query_params); |
|
704 | - } |
|
705 | - |
|
706 | - |
|
707 | - /** |
|
708 | - * check if event id is present and if event is published |
|
709 | - * |
|
710 | - * @access public |
|
711 | - * @return boolean true yes, false no |
|
712 | - * @throws EE_Error |
|
713 | - */ |
|
714 | - private function _has_ID_and_is_published() |
|
715 | - { |
|
716 | - // first check if event id is present and not NULL, |
|
717 | - // then check if this event is published (or any of the equivalent "published" statuses) |
|
718 | - return |
|
719 | - $this->ID() && $this->ID() !== null |
|
720 | - && ( |
|
721 | - $this->status() === 'publish' |
|
722 | - || $this->status() === EEM_Event::sold_out |
|
723 | - || $this->status() === EEM_Event::postponed |
|
724 | - || $this->status() === EEM_Event::cancelled |
|
725 | - ); |
|
726 | - } |
|
727 | - |
|
728 | - |
|
729 | - /** |
|
730 | - * This simply compares the internal dates with NOW and determines if the event is upcoming or not. |
|
731 | - * |
|
732 | - * @access public |
|
733 | - * @return boolean true yes, false no |
|
734 | - * @throws EE_Error |
|
735 | - */ |
|
736 | - public function is_upcoming() |
|
737 | - { |
|
738 | - // check if event id is present and if this event is published |
|
739 | - if ($this->is_inactive()) { |
|
740 | - return false; |
|
741 | - } |
|
742 | - // set initial value |
|
743 | - $upcoming = false; |
|
744 | - // next let's get all datetimes and loop through them |
|
745 | - $datetimes = $this->datetimes_in_chronological_order(); |
|
746 | - foreach ($datetimes as $datetime) { |
|
747 | - if ($datetime instanceof EE_Datetime) { |
|
748 | - // if this dtt is expired then we continue cause one of the other datetimes might be upcoming. |
|
749 | - if ($datetime->is_expired()) { |
|
750 | - continue; |
|
751 | - } |
|
752 | - // if this dtt is active then we return false. |
|
753 | - if ($datetime->is_active()) { |
|
754 | - return false; |
|
755 | - } |
|
756 | - // otherwise let's check upcoming status |
|
757 | - $upcoming = $datetime->is_upcoming(); |
|
758 | - } |
|
759 | - } |
|
760 | - return $upcoming; |
|
761 | - } |
|
762 | - |
|
763 | - |
|
764 | - /** |
|
765 | - * @return bool |
|
766 | - * @throws EE_Error |
|
767 | - */ |
|
768 | - public function is_active() |
|
769 | - { |
|
770 | - // check if event id is present and if this event is published |
|
771 | - if ($this->is_inactive()) { |
|
772 | - return false; |
|
773 | - } |
|
774 | - // set initial value |
|
775 | - $active = false; |
|
776 | - // next let's get all datetimes and loop through them |
|
777 | - $datetimes = $this->datetimes_in_chronological_order(); |
|
778 | - foreach ($datetimes as $datetime) { |
|
779 | - if ($datetime instanceof EE_Datetime) { |
|
780 | - // if this dtt is expired then we continue cause one of the other datetimes might be active. |
|
781 | - if ($datetime->is_expired()) { |
|
782 | - continue; |
|
783 | - } |
|
784 | - // if this dtt is upcoming then we return false. |
|
785 | - if ($datetime->is_upcoming()) { |
|
786 | - return false; |
|
787 | - } |
|
788 | - // otherwise let's check active status |
|
789 | - $active = $datetime->is_active(); |
|
790 | - } |
|
791 | - } |
|
792 | - return $active; |
|
793 | - } |
|
794 | - |
|
795 | - |
|
796 | - /** |
|
797 | - * @return bool |
|
798 | - * @throws EE_Error |
|
799 | - */ |
|
800 | - public function is_expired() |
|
801 | - { |
|
802 | - // check if event id is present and if this event is published |
|
803 | - if ($this->is_inactive()) { |
|
804 | - return false; |
|
805 | - } |
|
806 | - // set initial value |
|
807 | - $expired = false; |
|
808 | - // first let's get all datetimes and loop through them |
|
809 | - $datetimes = $this->datetimes_in_chronological_order(); |
|
810 | - foreach ($datetimes as $datetime) { |
|
811 | - if ($datetime instanceof EE_Datetime) { |
|
812 | - // if this dtt is upcoming or active then we return false. |
|
813 | - if ($datetime->is_upcoming() || $datetime->is_active()) { |
|
814 | - return false; |
|
815 | - } |
|
816 | - // otherwise let's check active status |
|
817 | - $expired = $datetime->is_expired(); |
|
818 | - } |
|
819 | - } |
|
820 | - return $expired; |
|
821 | - } |
|
822 | - |
|
823 | - |
|
824 | - /** |
|
825 | - * @return bool |
|
826 | - * @throws EE_Error |
|
827 | - */ |
|
828 | - public function is_inactive() |
|
829 | - { |
|
830 | - // check if event id is present and if this event is published |
|
831 | - if ($this->_has_ID_and_is_published()) { |
|
832 | - return false; |
|
833 | - } |
|
834 | - return true; |
|
835 | - } |
|
836 | - |
|
837 | - |
|
838 | - /** |
|
839 | - * calculate spaces remaining based on "saleable" tickets |
|
840 | - * |
|
841 | - * @param array $tickets |
|
842 | - * @param bool $filtered |
|
843 | - * @return int|float |
|
844 | - * @throws EE_Error |
|
845 | - * @throws DomainException |
|
846 | - * @throws UnexpectedEntityException |
|
847 | - */ |
|
848 | - public function spaces_remaining($tickets = array(), $filtered = true) |
|
849 | - { |
|
850 | - $this->getAvailableSpacesCalculator()->setActiveTickets($tickets); |
|
851 | - $spaces_remaining = $this->getAvailableSpacesCalculator()->spacesRemaining(); |
|
852 | - return $filtered |
|
853 | - ? apply_filters( |
|
854 | - 'FHEE_EE_Event__spaces_remaining', |
|
855 | - $spaces_remaining, |
|
856 | - $this, |
|
857 | - $tickets |
|
858 | - ) |
|
859 | - : $spaces_remaining; |
|
860 | - } |
|
861 | - |
|
862 | - |
|
863 | - /** |
|
864 | - * perform_sold_out_status_check |
|
865 | - * checks all of this events's datetime reg_limit - sold values to determine if ANY datetimes have spaces |
|
866 | - * available... if NOT, then the event status will get toggled to 'sold_out' |
|
867 | - * |
|
868 | - * @return bool return the ACTUAL sold out state. |
|
869 | - * @throws EE_Error |
|
870 | - * @throws DomainException |
|
871 | - * @throws UnexpectedEntityException |
|
872 | - */ |
|
873 | - public function perform_sold_out_status_check() |
|
874 | - { |
|
875 | - // get all unexpired untrashed tickets |
|
876 | - $tickets = $this->tickets( |
|
877 | - array( |
|
878 | - array('TKT_deleted' => false), |
|
879 | - 'order_by' => array('TKT_qty' => 'ASC'), |
|
880 | - ) |
|
881 | - ); |
|
882 | - $all_expired = true; |
|
883 | - foreach ($tickets as $ticket) { |
|
884 | - if (! $ticket->is_expired()) { |
|
885 | - $all_expired = false; |
|
886 | - break; |
|
887 | - } |
|
888 | - } |
|
889 | - // if all the tickets are just expired, then don't update the event status to sold out |
|
890 | - if ($all_expired) { |
|
891 | - return true; |
|
892 | - } |
|
893 | - $spaces_remaining = $this->spaces_remaining($tickets); |
|
894 | - if ($spaces_remaining < 1) { |
|
895 | - $this->set_status(EEM_Event::sold_out); |
|
896 | - $this->save(); |
|
897 | - $sold_out = true; |
|
898 | - } else { |
|
899 | - $sold_out = false; |
|
900 | - // was event previously marked as sold out ? |
|
901 | - if ($this->status() === EEM_Event::sold_out) { |
|
902 | - // revert status to previous value, if it was set |
|
903 | - $previous_event_status = $this->get_post_meta('_previous_event_status', true); |
|
904 | - if ($previous_event_status) { |
|
905 | - $this->set_status($previous_event_status); |
|
906 | - $this->save(); |
|
907 | - } |
|
908 | - } |
|
909 | - } |
|
910 | - do_action('AHEE__EE_Event__perform_sold_out_status_check__end', $this, $sold_out, $spaces_remaining, $tickets); |
|
911 | - return $sold_out; |
|
912 | - } |
|
913 | - |
|
914 | - |
|
915 | - /** |
|
916 | - * This returns the total remaining spaces for sale on this event. |
|
917 | - * |
|
918 | - * @uses EE_Event::total_available_spaces() |
|
919 | - * @return float|int |
|
920 | - * @throws EE_Error |
|
921 | - * @throws DomainException |
|
922 | - * @throws UnexpectedEntityException |
|
923 | - */ |
|
924 | - public function spaces_remaining_for_sale() |
|
925 | - { |
|
926 | - return $this->total_available_spaces(true); |
|
927 | - } |
|
928 | - |
|
929 | - |
|
930 | - /** |
|
931 | - * This returns the total spaces available for an event |
|
932 | - * while considering all the qtys on the tickets and the reg limits |
|
933 | - * on the datetimes attached to this event. |
|
934 | - * |
|
935 | - * @param bool $consider_sold Whether to consider any tickets that have already sold in our calculation. |
|
936 | - * If this is false, then we return the most tickets that could ever be sold |
|
937 | - * for this event with the datetime and tickets setup on the event under optimal |
|
938 | - * selling conditions. Otherwise we return a live calculation of spaces available |
|
939 | - * based on tickets sold. Depending on setup and stage of sales, this |
|
940 | - * may appear to equal remaining tickets. However, the more tickets are |
|
941 | - * sold out, the more accurate the "live" total is. |
|
942 | - * @return float|int |
|
943 | - * @throws EE_Error |
|
944 | - * @throws DomainException |
|
945 | - * @throws UnexpectedEntityException |
|
946 | - */ |
|
947 | - public function total_available_spaces($consider_sold = false) |
|
948 | - { |
|
949 | - $spaces_available = $consider_sold |
|
950 | - ? $this->getAvailableSpacesCalculator()->spacesRemaining() |
|
951 | - : $this->getAvailableSpacesCalculator()->totalSpacesAvailable(); |
|
952 | - return apply_filters( |
|
953 | - 'FHEE_EE_Event__total_available_spaces__spaces_available', |
|
954 | - $spaces_available, |
|
955 | - $this, |
|
956 | - $this->getAvailableSpacesCalculator()->getDatetimes(), |
|
957 | - $this->getAvailableSpacesCalculator()->getActiveTickets() |
|
958 | - ); |
|
959 | - } |
|
960 | - |
|
961 | - |
|
962 | - /** |
|
963 | - * Checks if the event is set to sold out |
|
964 | - * |
|
965 | - * @param bool $actual whether or not to perform calculations to not only figure the |
|
966 | - * actual status but also to flip the status if necessary to sold |
|
967 | - * out If false, we just check the existing status of the event |
|
968 | - * @return boolean |
|
969 | - * @throws EE_Error |
|
970 | - */ |
|
971 | - public function is_sold_out($actual = false) |
|
972 | - { |
|
973 | - if (! $actual) { |
|
974 | - return $this->status() === EEM_Event::sold_out; |
|
975 | - } |
|
976 | - return $this->perform_sold_out_status_check(); |
|
977 | - } |
|
978 | - |
|
979 | - |
|
980 | - /** |
|
981 | - * Checks if the event is marked as postponed |
|
982 | - * |
|
983 | - * @return boolean |
|
984 | - */ |
|
985 | - public function is_postponed() |
|
986 | - { |
|
987 | - return $this->status() === EEM_Event::postponed; |
|
988 | - } |
|
989 | - |
|
990 | - |
|
991 | - /** |
|
992 | - * Checks if the event is marked as cancelled |
|
993 | - * |
|
994 | - * @return boolean |
|
995 | - */ |
|
996 | - public function is_cancelled() |
|
997 | - { |
|
998 | - return $this->status() === EEM_Event::cancelled; |
|
999 | - } |
|
1000 | - |
|
1001 | - |
|
1002 | - /** |
|
1003 | - * Get the logical active status in a hierarchical order for all the datetimes. Note |
|
1004 | - * Basically, we order the datetimes by EVT_start_date. Then first test on whether the event is published. If its |
|
1005 | - * NOT published then we test for whether its expired or not. IF it IS published then we test first on whether an |
|
1006 | - * event has any active dates. If no active dates then we check for any upcoming dates. If no upcoming dates then |
|
1007 | - * the event is considered expired. |
|
1008 | - * NOTE: this method does NOT calculate whether the datetimes are sold out when event is published. Sold Out is a |
|
1009 | - * status set on the EVENT when it is not published and thus is done |
|
1010 | - * |
|
1011 | - * @param bool $reset |
|
1012 | - * @return bool | string - based on EE_Datetime active constants or FALSE if error. |
|
1013 | - * @throws EE_Error |
|
1014 | - */ |
|
1015 | - public function get_active_status($reset = false) |
|
1016 | - { |
|
1017 | - // if the active status has already been set, then just use that value (unless we are resetting it) |
|
1018 | - if (! empty($this->_active_status) && ! $reset) { |
|
1019 | - return $this->_active_status; |
|
1020 | - } |
|
1021 | - // first check if event id is present on this object |
|
1022 | - if (! $this->ID()) { |
|
1023 | - return false; |
|
1024 | - } |
|
1025 | - $where_params_for_event = array(array('EVT_ID' => $this->ID())); |
|
1026 | - // if event is published: |
|
1027 | - if ($this->status() === 'publish') { |
|
1028 | - // active? |
|
1029 | - if (EEM_Datetime::instance()->get_datetime_count_for_status( |
|
1030 | - EE_Datetime::active, |
|
1031 | - $where_params_for_event |
|
1032 | - ) > 0) { |
|
1033 | - $this->_active_status = EE_Datetime::active; |
|
1034 | - } else { |
|
1035 | - // upcoming? |
|
1036 | - if (EEM_Datetime::instance()->get_datetime_count_for_status( |
|
1037 | - EE_Datetime::upcoming, |
|
1038 | - $where_params_for_event |
|
1039 | - ) > 0) { |
|
1040 | - $this->_active_status = EE_Datetime::upcoming; |
|
1041 | - } else { |
|
1042 | - // expired? |
|
1043 | - if (EEM_Datetime::instance()->get_datetime_count_for_status( |
|
1044 | - EE_Datetime::expired, |
|
1045 | - $where_params_for_event |
|
1046 | - ) > 0 |
|
1047 | - ) { |
|
1048 | - $this->_active_status = EE_Datetime::expired; |
|
1049 | - } else { |
|
1050 | - // it would be odd if things make it this far because it basically means there are no datetime's |
|
1051 | - // attached to the event. So in this case it will just be considered inactive. |
|
1052 | - $this->_active_status = EE_Datetime::inactive; |
|
1053 | - } |
|
1054 | - } |
|
1055 | - } |
|
1056 | - } else { |
|
1057 | - // the event is not published, so let's just set it's active status according to its' post status |
|
1058 | - switch ($this->status()) { |
|
1059 | - case EEM_Event::sold_out: |
|
1060 | - $this->_active_status = EE_Datetime::sold_out; |
|
1061 | - break; |
|
1062 | - case EEM_Event::cancelled: |
|
1063 | - $this->_active_status = EE_Datetime::cancelled; |
|
1064 | - break; |
|
1065 | - case EEM_Event::postponed: |
|
1066 | - $this->_active_status = EE_Datetime::postponed; |
|
1067 | - break; |
|
1068 | - default: |
|
1069 | - $this->_active_status = EE_Datetime::inactive; |
|
1070 | - } |
|
1071 | - } |
|
1072 | - return $this->_active_status; |
|
1073 | - } |
|
1074 | - |
|
1075 | - |
|
1076 | - /** |
|
1077 | - * pretty_active_status |
|
1078 | - * |
|
1079 | - * @access public |
|
1080 | - * @param boolean $echo whether to return (FALSE), or echo out the result (TRUE) |
|
1081 | - * @return mixed void|string |
|
1082 | - * @throws EE_Error |
|
1083 | - */ |
|
1084 | - public function pretty_active_status($echo = true) |
|
1085 | - { |
|
1086 | - $active_status = $this->get_active_status(); |
|
1087 | - $status = '<span class="ee-status event-active-status-' |
|
1088 | - . $active_status |
|
1089 | - . '">' |
|
1090 | - . EEH_Template::pretty_status($active_status, false, 'sentence') |
|
1091 | - . '</span>'; |
|
1092 | - if ($echo) { |
|
1093 | - echo $status; |
|
1094 | - return ''; |
|
1095 | - } |
|
1096 | - return $status; |
|
1097 | - } |
|
1098 | - |
|
1099 | - |
|
1100 | - /** |
|
1101 | - * @return bool|int |
|
1102 | - * @throws EE_Error |
|
1103 | - */ |
|
1104 | - public function get_number_of_tickets_sold() |
|
1105 | - { |
|
1106 | - $tkt_sold = 0; |
|
1107 | - if (! $this->ID()) { |
|
1108 | - return 0; |
|
1109 | - } |
|
1110 | - $datetimes = $this->datetimes(); |
|
1111 | - foreach ($datetimes as $datetime) { |
|
1112 | - if ($datetime instanceof EE_Datetime) { |
|
1113 | - $tkt_sold += $datetime->sold(); |
|
1114 | - } |
|
1115 | - } |
|
1116 | - return $tkt_sold; |
|
1117 | - } |
|
1118 | - |
|
1119 | - |
|
1120 | - /** |
|
1121 | - * This just returns a count of all the registrations for this event |
|
1122 | - * |
|
1123 | - * @access public |
|
1124 | - * @return int |
|
1125 | - * @throws EE_Error |
|
1126 | - */ |
|
1127 | - public function get_count_of_all_registrations() |
|
1128 | - { |
|
1129 | - return EEM_Event::instance()->count_related($this, 'Registration'); |
|
1130 | - } |
|
1131 | - |
|
1132 | - |
|
1133 | - /** |
|
1134 | - * This returns the ticket with the earliest start time that is |
|
1135 | - * available for this event (across all datetimes attached to the event) |
|
1136 | - * |
|
1137 | - * @return EE_Base_Class|EE_Ticket|null |
|
1138 | - * @throws EE_Error |
|
1139 | - */ |
|
1140 | - public function get_ticket_with_earliest_start_time() |
|
1141 | - { |
|
1142 | - $where['Datetime.EVT_ID'] = $this->ID(); |
|
1143 | - $query_params = array($where, 'order_by' => array('TKT_start_date' => 'ASC')); |
|
1144 | - return EE_Registry::instance()->load_model('Ticket')->get_one($query_params); |
|
1145 | - } |
|
1146 | - |
|
1147 | - |
|
1148 | - /** |
|
1149 | - * This returns the ticket with the latest end time that is available |
|
1150 | - * for this event (across all datetimes attached to the event) |
|
1151 | - * |
|
1152 | - * @return EE_Base_Class|EE_Ticket|null |
|
1153 | - * @throws EE_Error |
|
1154 | - */ |
|
1155 | - public function get_ticket_with_latest_end_time() |
|
1156 | - { |
|
1157 | - $where['Datetime.EVT_ID'] = $this->ID(); |
|
1158 | - $query_params = array($where, 'order_by' => array('TKT_end_date' => 'DESC')); |
|
1159 | - return EE_Registry::instance()->load_model('Ticket')->get_one($query_params); |
|
1160 | - } |
|
1161 | - |
|
1162 | - |
|
1163 | - /** |
|
1164 | - * This returns the number of different ticket types currently on sale for this event. |
|
1165 | - * |
|
1166 | - * @return int |
|
1167 | - * @throws EE_Error |
|
1168 | - */ |
|
1169 | - public function countTicketsOnSale() |
|
1170 | - { |
|
1171 | - $where = array( |
|
1172 | - 'Datetime.EVT_ID' => $this->ID(), |
|
1173 | - 'TKT_start_date' => array('<', time()), |
|
1174 | - 'TKT_end_date' => array('>', time()), |
|
1175 | - ); |
|
1176 | - return EEM_Ticket::instance()->count(array($where)); |
|
1177 | - } |
|
1178 | - |
|
1179 | - |
|
1180 | - /** |
|
1181 | - * This returns whether there are any tickets on sale for this event. |
|
1182 | - * |
|
1183 | - * @return bool true = YES tickets on sale. |
|
1184 | - * @throws EE_Error |
|
1185 | - */ |
|
1186 | - public function tickets_on_sale() |
|
1187 | - { |
|
1188 | - return $this->countTicketsOnSale() > 0; |
|
1189 | - } |
|
1190 | - |
|
1191 | - |
|
1192 | - /** |
|
1193 | - * Gets the URL for viewing this event on the front-end. Overrides parent |
|
1194 | - * to check for an external URL first |
|
1195 | - * |
|
1196 | - * @return string |
|
1197 | - * @throws EE_Error |
|
1198 | - */ |
|
1199 | - public function get_permalink() |
|
1200 | - { |
|
1201 | - if ($this->external_url()) { |
|
1202 | - return $this->external_url(); |
|
1203 | - } |
|
1204 | - return parent::get_permalink(); |
|
1205 | - } |
|
1206 | - |
|
1207 | - |
|
1208 | - /** |
|
1209 | - * Gets the first term for 'espresso_event_categories' we can find |
|
1210 | - * |
|
1211 | - * @param array $query_params like EEM_Base::get_all |
|
1212 | - * @return EE_Base_Class|EE_Term|null |
|
1213 | - * @throws EE_Error |
|
1214 | - */ |
|
1215 | - public function first_event_category($query_params = array()) |
|
1216 | - { |
|
1217 | - $query_params[0]['Term_Taxonomy.taxonomy'] = 'espresso_event_categories'; |
|
1218 | - $query_params[0]['Term_Taxonomy.Event.EVT_ID'] = $this->ID(); |
|
1219 | - return EEM_Term::instance()->get_one($query_params); |
|
1220 | - } |
|
1221 | - |
|
1222 | - |
|
1223 | - /** |
|
1224 | - * Gets all terms for 'espresso_event_categories' we can find |
|
1225 | - * |
|
1226 | - * @param array $query_params |
|
1227 | - * @return EE_Base_Class[]|EE_Term[] |
|
1228 | - * @throws EE_Error |
|
1229 | - */ |
|
1230 | - public function get_all_event_categories($query_params = array()) |
|
1231 | - { |
|
1232 | - $query_params[0]['Term_Taxonomy.taxonomy'] = 'espresso_event_categories'; |
|
1233 | - $query_params[0]['Term_Taxonomy.Event.EVT_ID'] = $this->ID(); |
|
1234 | - return EEM_Term::instance()->get_all($query_params); |
|
1235 | - } |
|
1236 | - |
|
1237 | - |
|
1238 | - /** |
|
1239 | - * Adds a question group to this event |
|
1240 | - * |
|
1241 | - * @param EE_Question_Group|int $question_group_id_or_obj |
|
1242 | - * @param bool $for_primary if true, the question group will be added for the primary |
|
1243 | - * registrant, if false will be added for others. default: false |
|
1244 | - * @return EE_Base_Class|EE_Question_Group |
|
1245 | - * @throws EE_Error |
|
1246 | - */ |
|
1247 | - public function add_question_group($question_group_id_or_obj, $for_primary = false) |
|
1248 | - { |
|
1249 | - $extra = $for_primary |
|
1250 | - ? array('EQG_primary' => 1) |
|
1251 | - : array(); |
|
1252 | - return $this->_add_relation_to($question_group_id_or_obj, 'Question_Group', $extra); |
|
1253 | - } |
|
1254 | - |
|
1255 | - |
|
1256 | - /** |
|
1257 | - * Removes a question group from the event |
|
1258 | - * |
|
1259 | - * @param EE_Question_Group|int $question_group_id_or_obj |
|
1260 | - * @param bool $for_primary if true, the question group will be removed from the primary |
|
1261 | - * registrant, if false will be removed from others. default: false |
|
1262 | - * @return EE_Base_Class|EE_Question_Group |
|
1263 | - * @throws EE_Error |
|
1264 | - */ |
|
1265 | - public function remove_question_group($question_group_id_or_obj, $for_primary = false) |
|
1266 | - { |
|
1267 | - $where = $for_primary |
|
1268 | - ? array('EQG_primary' => 1) |
|
1269 | - : array(); |
|
1270 | - return $this->_remove_relation_to($question_group_id_or_obj, 'Question_Group', $where); |
|
1271 | - } |
|
1272 | - |
|
1273 | - |
|
1274 | - /** |
|
1275 | - * Gets all the question groups, ordering them by QSG_order ascending |
|
1276 | - * |
|
1277 | - * @param array $query_params @see EEM_Base::get_all |
|
1278 | - * @return EE_Base_Class[]|EE_Question_Group[] |
|
1279 | - * @throws EE_Error |
|
1280 | - */ |
|
1281 | - public function question_groups($query_params = array()) |
|
1282 | - { |
|
1283 | - $query_params = ! empty($query_params) ? $query_params : array('order_by' => array('QSG_order' => 'ASC')); |
|
1284 | - return $this->get_many_related('Question_Group', $query_params); |
|
1285 | - } |
|
1286 | - |
|
1287 | - |
|
1288 | - /** |
|
1289 | - * Implementation for EEI_Has_Icon interface method. |
|
1290 | - * |
|
1291 | - * @see EEI_Visual_Representation for comments |
|
1292 | - * @return string |
|
1293 | - */ |
|
1294 | - public function get_icon() |
|
1295 | - { |
|
1296 | - return '<span class="dashicons dashicons-flag"></span>'; |
|
1297 | - } |
|
1298 | - |
|
1299 | - |
|
1300 | - /** |
|
1301 | - * Implementation for EEI_Admin_Links interface method. |
|
1302 | - * |
|
1303 | - * @see EEI_Admin_Links for comments |
|
1304 | - * @return string |
|
1305 | - * @throws EE_Error |
|
1306 | - */ |
|
1307 | - public function get_admin_details_link() |
|
1308 | - { |
|
1309 | - return $this->get_admin_edit_link(); |
|
1310 | - } |
|
1311 | - |
|
1312 | - |
|
1313 | - /** |
|
1314 | - * Implementation for EEI_Admin_Links interface method. |
|
1315 | - * |
|
1316 | - * @see EEI_Admin_Links for comments |
|
1317 | - * @return string |
|
1318 | - * @throws EE_Error |
|
1319 | - */ |
|
1320 | - public function get_admin_edit_link() |
|
1321 | - { |
|
1322 | - return EEH_URL::add_query_args_and_nonce( |
|
1323 | - array( |
|
1324 | - 'page' => 'espresso_events', |
|
1325 | - 'action' => 'edit', |
|
1326 | - 'post' => $this->ID(), |
|
1327 | - ), |
|
1328 | - admin_url('admin.php') |
|
1329 | - ); |
|
1330 | - } |
|
1331 | - |
|
1332 | - |
|
1333 | - /** |
|
1334 | - * Implementation for EEI_Admin_Links interface method. |
|
1335 | - * |
|
1336 | - * @see EEI_Admin_Links for comments |
|
1337 | - * @return string |
|
1338 | - */ |
|
1339 | - public function get_admin_settings_link() |
|
1340 | - { |
|
1341 | - return EEH_URL::add_query_args_and_nonce( |
|
1342 | - array( |
|
1343 | - 'page' => 'espresso_events', |
|
1344 | - 'action' => 'default_event_settings', |
|
1345 | - ), |
|
1346 | - admin_url('admin.php') |
|
1347 | - ); |
|
1348 | - } |
|
1349 | - |
|
1350 | - |
|
1351 | - /** |
|
1352 | - * Implementation for EEI_Admin_Links interface method. |
|
1353 | - * |
|
1354 | - * @see EEI_Admin_Links for comments |
|
1355 | - * @return string |
|
1356 | - */ |
|
1357 | - public function get_admin_overview_link() |
|
1358 | - { |
|
1359 | - return EEH_URL::add_query_args_and_nonce( |
|
1360 | - array( |
|
1361 | - 'page' => 'espresso_events', |
|
1362 | - 'action' => 'default', |
|
1363 | - ), |
|
1364 | - admin_url('admin.php') |
|
1365 | - ); |
|
1366 | - } |
|
16 | + /** |
|
17 | + * cached value for the the logical active status for the event |
|
18 | + * |
|
19 | + * @see get_active_status() |
|
20 | + * @var string |
|
21 | + */ |
|
22 | + protected $_active_status = ''; |
|
23 | + |
|
24 | + /** |
|
25 | + * This is just used for caching the Primary Datetime for the Event on initial retrieval |
|
26 | + * |
|
27 | + * @var EE_Datetime |
|
28 | + */ |
|
29 | + protected $_Primary_Datetime; |
|
30 | + |
|
31 | + /** |
|
32 | + * @var EventSpacesCalculator $available_spaces_calculator |
|
33 | + */ |
|
34 | + protected $available_spaces_calculator; |
|
35 | + |
|
36 | + |
|
37 | + /** |
|
38 | + * @param array $props_n_values incoming values |
|
39 | + * @param string $timezone incoming timezone (if not set the timezone set for the website will be |
|
40 | + * used.) |
|
41 | + * @param array $date_formats incoming date_formats in an array where the first value is the |
|
42 | + * date_format and the second value is the time format |
|
43 | + * @return EE_Event |
|
44 | + * @throws EE_Error |
|
45 | + */ |
|
46 | + public static function new_instance($props_n_values = array(), $timezone = null, $date_formats = array()) |
|
47 | + { |
|
48 | + $has_object = parent::_check_for_object($props_n_values, __CLASS__, $timezone, $date_formats); |
|
49 | + return $has_object ? $has_object : new self($props_n_values, false, $timezone, $date_formats); |
|
50 | + } |
|
51 | + |
|
52 | + |
|
53 | + /** |
|
54 | + * @param array $props_n_values incoming values from the database |
|
55 | + * @param string $timezone incoming timezone as set by the model. If not set the timezone for |
|
56 | + * the website will be used. |
|
57 | + * @return EE_Event |
|
58 | + * @throws EE_Error |
|
59 | + */ |
|
60 | + public static function new_instance_from_db($props_n_values = array(), $timezone = null) |
|
61 | + { |
|
62 | + return new self($props_n_values, true, $timezone); |
|
63 | + } |
|
64 | + |
|
65 | + |
|
66 | + /** |
|
67 | + * @return EventSpacesCalculator |
|
68 | + * @throws \EE_Error |
|
69 | + */ |
|
70 | + public function getAvailableSpacesCalculator() |
|
71 | + { |
|
72 | + if (! $this->available_spaces_calculator instanceof EventSpacesCalculator) { |
|
73 | + $this->available_spaces_calculator = new EventSpacesCalculator($this); |
|
74 | + } |
|
75 | + return $this->available_spaces_calculator; |
|
76 | + } |
|
77 | + |
|
78 | + |
|
79 | + /** |
|
80 | + * Overrides parent set() method so that all calls to set( 'status', $status ) can be routed to internal methods |
|
81 | + * |
|
82 | + * @param string $field_name |
|
83 | + * @param mixed $field_value |
|
84 | + * @param bool $use_default |
|
85 | + * @throws EE_Error |
|
86 | + */ |
|
87 | + public function set($field_name, $field_value, $use_default = false) |
|
88 | + { |
|
89 | + switch ($field_name) { |
|
90 | + case 'status': |
|
91 | + $this->set_status($field_value, $use_default); |
|
92 | + break; |
|
93 | + default: |
|
94 | + parent::set($field_name, $field_value, $use_default); |
|
95 | + } |
|
96 | + } |
|
97 | + |
|
98 | + |
|
99 | + /** |
|
100 | + * set_status |
|
101 | + * Checks if event status is being changed to SOLD OUT |
|
102 | + * and updates event meta data with previous event status |
|
103 | + * so that we can revert things if/when the event is no longer sold out |
|
104 | + * |
|
105 | + * @access public |
|
106 | + * @param string $new_status |
|
107 | + * @param bool $use_default |
|
108 | + * @return void |
|
109 | + * @throws EE_Error |
|
110 | + */ |
|
111 | + public function set_status($new_status = null, $use_default = false) |
|
112 | + { |
|
113 | + // if nothing is set, and we aren't explicitly wanting to reset the status, then just leave |
|
114 | + if (empty($new_status) && ! $use_default) { |
|
115 | + return; |
|
116 | + } |
|
117 | + // get current Event status |
|
118 | + $old_status = $this->status(); |
|
119 | + // if status has changed |
|
120 | + if ($old_status !== $new_status) { |
|
121 | + // TO sold_out |
|
122 | + if ($new_status === EEM_Event::sold_out) { |
|
123 | + // save the previous event status so that we can revert if the event is no longer sold out |
|
124 | + $this->add_post_meta('_previous_event_status', $old_status); |
|
125 | + do_action('AHEE__EE_Event__set_status__to_sold_out', $this, $old_status, $new_status); |
|
126 | + // OR FROM sold_out |
|
127 | + } elseif ($old_status === EEM_Event::sold_out) { |
|
128 | + $this->delete_post_meta('_previous_event_status'); |
|
129 | + do_action('AHEE__EE_Event__set_status__from_sold_out', $this, $old_status, $new_status); |
|
130 | + } |
|
131 | + // clear out the active status so that it gets reset the next time it is requested |
|
132 | + $this->_active_status = null; |
|
133 | + // update status |
|
134 | + parent::set('status', $new_status, $use_default); |
|
135 | + do_action('AHEE__EE_Event__set_status__after_update', $this); |
|
136 | + return; |
|
137 | + } |
|
138 | + // even though the old value matches the new value, it's still good to |
|
139 | + // allow the parent set method to have a say |
|
140 | + parent::set('status', $new_status, $use_default); |
|
141 | + } |
|
142 | + |
|
143 | + |
|
144 | + /** |
|
145 | + * Gets all the datetimes for this event |
|
146 | + * |
|
147 | + * @param array $query_params like EEM_Base::get_all |
|
148 | + * @return EE_Base_Class[]|EE_Datetime[] |
|
149 | + * @throws EE_Error |
|
150 | + */ |
|
151 | + public function datetimes($query_params = array()) |
|
152 | + { |
|
153 | + return $this->get_many_related('Datetime', $query_params); |
|
154 | + } |
|
155 | + |
|
156 | + |
|
157 | + /** |
|
158 | + * Gets all the datetimes for this event, ordered by DTT_EVT_start in ascending order |
|
159 | + * |
|
160 | + * @return EE_Base_Class[]|EE_Datetime[] |
|
161 | + * @throws EE_Error |
|
162 | + */ |
|
163 | + public function datetimes_in_chronological_order() |
|
164 | + { |
|
165 | + return $this->get_many_related('Datetime', array('order_by' => array('DTT_EVT_start' => 'ASC'))); |
|
166 | + } |
|
167 | + |
|
168 | + |
|
169 | + /** |
|
170 | + * Gets all the datetimes for this event, ordered by the DTT_order on the datetime. |
|
171 | + * @darren, we should probably UNSET timezone on the EEM_Datetime model |
|
172 | + * after running our query, so that this timezone isn't set for EVERY query |
|
173 | + * on EEM_Datetime for the rest of the request, no? |
|
174 | + * |
|
175 | + * @param boolean $show_expired whether or not to include expired events |
|
176 | + * @param boolean $show_deleted whether or not to include deleted events |
|
177 | + * @param null $limit |
|
178 | + * @return EE_Datetime[] |
|
179 | + * @throws EE_Error |
|
180 | + */ |
|
181 | + public function datetimes_ordered($show_expired = true, $show_deleted = false, $limit = null) |
|
182 | + { |
|
183 | + return EEM_Datetime::instance($this->_timezone)->get_datetimes_for_event_ordered_by_DTT_order( |
|
184 | + $this->ID(), |
|
185 | + $show_expired, |
|
186 | + $show_deleted, |
|
187 | + $limit |
|
188 | + ); |
|
189 | + } |
|
190 | + |
|
191 | + |
|
192 | + /** |
|
193 | + * Returns one related datetime. Mostly only used by some legacy code. |
|
194 | + * |
|
195 | + * @return EE_Base_Class|EE_Datetime |
|
196 | + * @throws EE_Error |
|
197 | + */ |
|
198 | + public function first_datetime() |
|
199 | + { |
|
200 | + return $this->get_first_related('Datetime'); |
|
201 | + } |
|
202 | + |
|
203 | + |
|
204 | + /** |
|
205 | + * Returns the 'primary' datetime for the event |
|
206 | + * |
|
207 | + * @param bool $try_to_exclude_expired |
|
208 | + * @param bool $try_to_exclude_deleted |
|
209 | + * @return EE_Datetime |
|
210 | + * @throws EE_Error |
|
211 | + */ |
|
212 | + public function primary_datetime($try_to_exclude_expired = true, $try_to_exclude_deleted = true) |
|
213 | + { |
|
214 | + if (! empty($this->_Primary_Datetime)) { |
|
215 | + return $this->_Primary_Datetime; |
|
216 | + } |
|
217 | + $this->_Primary_Datetime = EEM_Datetime::instance($this->_timezone)->get_primary_datetime_for_event( |
|
218 | + $this->ID(), |
|
219 | + $try_to_exclude_expired, |
|
220 | + $try_to_exclude_deleted |
|
221 | + ); |
|
222 | + return $this->_Primary_Datetime; |
|
223 | + } |
|
224 | + |
|
225 | + |
|
226 | + /** |
|
227 | + * Gets all the tickets available for purchase of this event |
|
228 | + * |
|
229 | + * @param array $query_params like EEM_Base::get_all |
|
230 | + * @return EE_Base_Class[]|EE_Ticket[] |
|
231 | + * @throws EE_Error |
|
232 | + */ |
|
233 | + public function tickets($query_params = array()) |
|
234 | + { |
|
235 | + // first get all datetimes |
|
236 | + $datetimes = $this->datetimes_ordered(); |
|
237 | + if (! $datetimes) { |
|
238 | + return array(); |
|
239 | + } |
|
240 | + $datetime_ids = array(); |
|
241 | + foreach ($datetimes as $datetime) { |
|
242 | + $datetime_ids[] = $datetime->ID(); |
|
243 | + } |
|
244 | + $where_params = array('Datetime.DTT_ID' => array('IN', $datetime_ids)); |
|
245 | + // if incoming $query_params has where conditions let's merge but not override existing. |
|
246 | + if (is_array($query_params) && isset($query_params[0])) { |
|
247 | + $where_params = array_merge($query_params[0], $where_params); |
|
248 | + unset($query_params[0]); |
|
249 | + } |
|
250 | + // now add $where_params to $query_params |
|
251 | + $query_params[0] = $where_params; |
|
252 | + return EEM_Ticket::instance()->get_all($query_params); |
|
253 | + } |
|
254 | + |
|
255 | + |
|
256 | + /** |
|
257 | + * get all unexpired untrashed tickets |
|
258 | + * |
|
259 | + * @return EE_Ticket[] |
|
260 | + * @throws EE_Error |
|
261 | + */ |
|
262 | + public function active_tickets() |
|
263 | + { |
|
264 | + return $this->tickets( |
|
265 | + array( |
|
266 | + array( |
|
267 | + 'TKT_end_date' => array('>=', EEM_Ticket::instance()->current_time_for_query('TKT_end_date')), |
|
268 | + 'TKT_deleted' => false, |
|
269 | + ), |
|
270 | + ) |
|
271 | + ); |
|
272 | + } |
|
273 | + |
|
274 | + |
|
275 | + /** |
|
276 | + * @return bool |
|
277 | + * @throws EE_Error |
|
278 | + */ |
|
279 | + public function additional_limit() |
|
280 | + { |
|
281 | + return $this->get('EVT_additional_limit'); |
|
282 | + } |
|
283 | + |
|
284 | + |
|
285 | + /** |
|
286 | + * @return bool |
|
287 | + * @throws EE_Error |
|
288 | + */ |
|
289 | + public function allow_overflow() |
|
290 | + { |
|
291 | + return $this->get('EVT_allow_overflow'); |
|
292 | + } |
|
293 | + |
|
294 | + |
|
295 | + /** |
|
296 | + * @return bool |
|
297 | + * @throws EE_Error |
|
298 | + */ |
|
299 | + public function created() |
|
300 | + { |
|
301 | + return $this->get('EVT_created'); |
|
302 | + } |
|
303 | + |
|
304 | + |
|
305 | + /** |
|
306 | + * @return bool |
|
307 | + * @throws EE_Error |
|
308 | + */ |
|
309 | + public function description() |
|
310 | + { |
|
311 | + return $this->get('EVT_desc'); |
|
312 | + } |
|
313 | + |
|
314 | + |
|
315 | + /** |
|
316 | + * Runs do_shortcode and wpautop on the description |
|
317 | + * |
|
318 | + * @return string of html |
|
319 | + * @throws EE_Error |
|
320 | + */ |
|
321 | + public function description_filtered() |
|
322 | + { |
|
323 | + return $this->get_pretty('EVT_desc'); |
|
324 | + } |
|
325 | + |
|
326 | + |
|
327 | + /** |
|
328 | + * @return bool |
|
329 | + * @throws EE_Error |
|
330 | + */ |
|
331 | + public function display_description() |
|
332 | + { |
|
333 | + return $this->get('EVT_display_desc'); |
|
334 | + } |
|
335 | + |
|
336 | + |
|
337 | + /** |
|
338 | + * @return bool |
|
339 | + * @throws EE_Error |
|
340 | + */ |
|
341 | + public function display_ticket_selector() |
|
342 | + { |
|
343 | + return (bool) $this->get('EVT_display_ticket_selector'); |
|
344 | + } |
|
345 | + |
|
346 | + |
|
347 | + /** |
|
348 | + * @return bool |
|
349 | + * @throws EE_Error |
|
350 | + */ |
|
351 | + public function external_url() |
|
352 | + { |
|
353 | + return $this->get('EVT_external_URL'); |
|
354 | + } |
|
355 | + |
|
356 | + |
|
357 | + /** |
|
358 | + * @return bool |
|
359 | + * @throws EE_Error |
|
360 | + */ |
|
361 | + public function member_only() |
|
362 | + { |
|
363 | + return $this->get('EVT_member_only'); |
|
364 | + } |
|
365 | + |
|
366 | + |
|
367 | + /** |
|
368 | + * @return bool |
|
369 | + * @throws EE_Error |
|
370 | + */ |
|
371 | + public function phone() |
|
372 | + { |
|
373 | + return $this->get('EVT_phone'); |
|
374 | + } |
|
375 | + |
|
376 | + |
|
377 | + /** |
|
378 | + * @return bool |
|
379 | + * @throws EE_Error |
|
380 | + */ |
|
381 | + public function modified() |
|
382 | + { |
|
383 | + return $this->get('EVT_modified'); |
|
384 | + } |
|
385 | + |
|
386 | + |
|
387 | + /** |
|
388 | + * @return bool |
|
389 | + * @throws EE_Error |
|
390 | + */ |
|
391 | + public function name() |
|
392 | + { |
|
393 | + return $this->get('EVT_name'); |
|
394 | + } |
|
395 | + |
|
396 | + |
|
397 | + /** |
|
398 | + * @return bool |
|
399 | + * @throws EE_Error |
|
400 | + */ |
|
401 | + public function order() |
|
402 | + { |
|
403 | + return $this->get('EVT_order'); |
|
404 | + } |
|
405 | + |
|
406 | + |
|
407 | + /** |
|
408 | + * @return bool|string |
|
409 | + * @throws EE_Error |
|
410 | + */ |
|
411 | + public function default_registration_status() |
|
412 | + { |
|
413 | + $event_default_registration_status = $this->get('EVT_default_registration_status'); |
|
414 | + return ! empty($event_default_registration_status) |
|
415 | + ? $event_default_registration_status |
|
416 | + : EE_Registry::instance()->CFG->registration->default_STS_ID; |
|
417 | + } |
|
418 | + |
|
419 | + |
|
420 | + /** |
|
421 | + * @param int $num_words |
|
422 | + * @param null $more |
|
423 | + * @param bool $not_full_desc |
|
424 | + * @return bool|string |
|
425 | + * @throws EE_Error |
|
426 | + */ |
|
427 | + public function short_description($num_words = 55, $more = null, $not_full_desc = false) |
|
428 | + { |
|
429 | + $short_desc = $this->get('EVT_short_desc'); |
|
430 | + if (! empty($short_desc) || $not_full_desc) { |
|
431 | + return $short_desc; |
|
432 | + } |
|
433 | + $full_desc = $this->get('EVT_desc'); |
|
434 | + return wp_trim_words($full_desc, $num_words, $more); |
|
435 | + } |
|
436 | + |
|
437 | + |
|
438 | + /** |
|
439 | + * @return bool |
|
440 | + * @throws EE_Error |
|
441 | + */ |
|
442 | + public function slug() |
|
443 | + { |
|
444 | + return $this->get('EVT_slug'); |
|
445 | + } |
|
446 | + |
|
447 | + |
|
448 | + /** |
|
449 | + * @return bool |
|
450 | + * @throws EE_Error |
|
451 | + */ |
|
452 | + public function timezone_string() |
|
453 | + { |
|
454 | + return $this->get('EVT_timezone_string'); |
|
455 | + } |
|
456 | + |
|
457 | + |
|
458 | + /** |
|
459 | + * @return bool |
|
460 | + * @throws EE_Error |
|
461 | + */ |
|
462 | + public function visible_on() |
|
463 | + { |
|
464 | + return $this->get('EVT_visible_on'); |
|
465 | + } |
|
466 | + |
|
467 | + |
|
468 | + /** |
|
469 | + * @return int |
|
470 | + * @throws EE_Error |
|
471 | + */ |
|
472 | + public function wp_user() |
|
473 | + { |
|
474 | + return $this->get('EVT_wp_user'); |
|
475 | + } |
|
476 | + |
|
477 | + |
|
478 | + /** |
|
479 | + * @return bool |
|
480 | + * @throws EE_Error |
|
481 | + */ |
|
482 | + public function donations() |
|
483 | + { |
|
484 | + return $this->get('EVT_donations'); |
|
485 | + } |
|
486 | + |
|
487 | + |
|
488 | + /** |
|
489 | + * @param $limit |
|
490 | + * @throws EE_Error |
|
491 | + */ |
|
492 | + public function set_additional_limit($limit) |
|
493 | + { |
|
494 | + $this->set('EVT_additional_limit', $limit); |
|
495 | + } |
|
496 | + |
|
497 | + |
|
498 | + /** |
|
499 | + * @param $created |
|
500 | + * @throws EE_Error |
|
501 | + */ |
|
502 | + public function set_created($created) |
|
503 | + { |
|
504 | + $this->set('EVT_created', $created); |
|
505 | + } |
|
506 | + |
|
507 | + |
|
508 | + /** |
|
509 | + * @param $desc |
|
510 | + * @throws EE_Error |
|
511 | + */ |
|
512 | + public function set_description($desc) |
|
513 | + { |
|
514 | + $this->set('EVT_desc', $desc); |
|
515 | + } |
|
516 | + |
|
517 | + |
|
518 | + /** |
|
519 | + * @param $display_desc |
|
520 | + * @throws EE_Error |
|
521 | + */ |
|
522 | + public function set_display_description($display_desc) |
|
523 | + { |
|
524 | + $this->set('EVT_display_desc', $display_desc); |
|
525 | + } |
|
526 | + |
|
527 | + |
|
528 | + /** |
|
529 | + * @param $display_ticket_selector |
|
530 | + * @throws EE_Error |
|
531 | + */ |
|
532 | + public function set_display_ticket_selector($display_ticket_selector) |
|
533 | + { |
|
534 | + $this->set('EVT_display_ticket_selector', $display_ticket_selector); |
|
535 | + } |
|
536 | + |
|
537 | + |
|
538 | + /** |
|
539 | + * @param $external_url |
|
540 | + * @throws EE_Error |
|
541 | + */ |
|
542 | + public function set_external_url($external_url) |
|
543 | + { |
|
544 | + $this->set('EVT_external_URL', $external_url); |
|
545 | + } |
|
546 | + |
|
547 | + |
|
548 | + /** |
|
549 | + * @param $member_only |
|
550 | + * @throws EE_Error |
|
551 | + */ |
|
552 | + public function set_member_only($member_only) |
|
553 | + { |
|
554 | + $this->set('EVT_member_only', $member_only); |
|
555 | + } |
|
556 | + |
|
557 | + |
|
558 | + /** |
|
559 | + * @param $event_phone |
|
560 | + * @throws EE_Error |
|
561 | + */ |
|
562 | + public function set_event_phone($event_phone) |
|
563 | + { |
|
564 | + $this->set('EVT_phone', $event_phone); |
|
565 | + } |
|
566 | + |
|
567 | + |
|
568 | + /** |
|
569 | + * @param $modified |
|
570 | + * @throws EE_Error |
|
571 | + */ |
|
572 | + public function set_modified($modified) |
|
573 | + { |
|
574 | + $this->set('EVT_modified', $modified); |
|
575 | + } |
|
576 | + |
|
577 | + |
|
578 | + /** |
|
579 | + * @param $name |
|
580 | + * @throws EE_Error |
|
581 | + */ |
|
582 | + public function set_name($name) |
|
583 | + { |
|
584 | + $this->set('EVT_name', $name); |
|
585 | + } |
|
586 | + |
|
587 | + |
|
588 | + /** |
|
589 | + * @param $order |
|
590 | + * @throws EE_Error |
|
591 | + */ |
|
592 | + public function set_order($order) |
|
593 | + { |
|
594 | + $this->set('EVT_order', $order); |
|
595 | + } |
|
596 | + |
|
597 | + |
|
598 | + /** |
|
599 | + * @param $short_desc |
|
600 | + * @throws EE_Error |
|
601 | + */ |
|
602 | + public function set_short_description($short_desc) |
|
603 | + { |
|
604 | + $this->set('EVT_short_desc', $short_desc); |
|
605 | + } |
|
606 | + |
|
607 | + |
|
608 | + /** |
|
609 | + * @param $slug |
|
610 | + * @throws EE_Error |
|
611 | + */ |
|
612 | + public function set_slug($slug) |
|
613 | + { |
|
614 | + $this->set('EVT_slug', $slug); |
|
615 | + } |
|
616 | + |
|
617 | + |
|
618 | + /** |
|
619 | + * @param $timezone_string |
|
620 | + * @throws EE_Error |
|
621 | + */ |
|
622 | + public function set_timezone_string($timezone_string) |
|
623 | + { |
|
624 | + $this->set('EVT_timezone_string', $timezone_string); |
|
625 | + } |
|
626 | + |
|
627 | + |
|
628 | + /** |
|
629 | + * @param $visible_on |
|
630 | + * @throws EE_Error |
|
631 | + */ |
|
632 | + public function set_visible_on($visible_on) |
|
633 | + { |
|
634 | + $this->set('EVT_visible_on', $visible_on); |
|
635 | + } |
|
636 | + |
|
637 | + |
|
638 | + /** |
|
639 | + * @param $wp_user |
|
640 | + * @throws EE_Error |
|
641 | + */ |
|
642 | + public function set_wp_user($wp_user) |
|
643 | + { |
|
644 | + $this->set('EVT_wp_user', $wp_user); |
|
645 | + } |
|
646 | + |
|
647 | + |
|
648 | + /** |
|
649 | + * @param $default_registration_status |
|
650 | + * @throws EE_Error |
|
651 | + */ |
|
652 | + public function set_default_registration_status($default_registration_status) |
|
653 | + { |
|
654 | + $this->set('EVT_default_registration_status', $default_registration_status); |
|
655 | + } |
|
656 | + |
|
657 | + |
|
658 | + /** |
|
659 | + * @param $donations |
|
660 | + * @throws EE_Error |
|
661 | + */ |
|
662 | + public function set_donations($donations) |
|
663 | + { |
|
664 | + $this->set('EVT_donations', $donations); |
|
665 | + } |
|
666 | + |
|
667 | + |
|
668 | + /** |
|
669 | + * Adds a venue to this event |
|
670 | + * |
|
671 | + * @param EE_Venue /int $venue_id_or_obj |
|
672 | + * @return EE_Base_Class|EE_Venue |
|
673 | + * @throws EE_Error |
|
674 | + */ |
|
675 | + public function add_venue($venue_id_or_obj) |
|
676 | + { |
|
677 | + return $this->_add_relation_to($venue_id_or_obj, 'Venue'); |
|
678 | + } |
|
679 | + |
|
680 | + |
|
681 | + /** |
|
682 | + * Removes a venue from the event |
|
683 | + * |
|
684 | + * @param EE_Venue /int $venue_id_or_obj |
|
685 | + * @return EE_Base_Class|EE_Venue |
|
686 | + * @throws EE_Error |
|
687 | + */ |
|
688 | + public function remove_venue($venue_id_or_obj) |
|
689 | + { |
|
690 | + return $this->_remove_relation_to($venue_id_or_obj, 'Venue'); |
|
691 | + } |
|
692 | + |
|
693 | + |
|
694 | + /** |
|
695 | + * Gets all the venues related ot the event. May provide additional $query_params if desired |
|
696 | + * |
|
697 | + * @param array $query_params like EEM_Base::get_all's $query_params |
|
698 | + * @return EE_Base_Class[]|EE_Venue[] |
|
699 | + * @throws EE_Error |
|
700 | + */ |
|
701 | + public function venues($query_params = array()) |
|
702 | + { |
|
703 | + return $this->get_many_related('Venue', $query_params); |
|
704 | + } |
|
705 | + |
|
706 | + |
|
707 | + /** |
|
708 | + * check if event id is present and if event is published |
|
709 | + * |
|
710 | + * @access public |
|
711 | + * @return boolean true yes, false no |
|
712 | + * @throws EE_Error |
|
713 | + */ |
|
714 | + private function _has_ID_and_is_published() |
|
715 | + { |
|
716 | + // first check if event id is present and not NULL, |
|
717 | + // then check if this event is published (or any of the equivalent "published" statuses) |
|
718 | + return |
|
719 | + $this->ID() && $this->ID() !== null |
|
720 | + && ( |
|
721 | + $this->status() === 'publish' |
|
722 | + || $this->status() === EEM_Event::sold_out |
|
723 | + || $this->status() === EEM_Event::postponed |
|
724 | + || $this->status() === EEM_Event::cancelled |
|
725 | + ); |
|
726 | + } |
|
727 | + |
|
728 | + |
|
729 | + /** |
|
730 | + * This simply compares the internal dates with NOW and determines if the event is upcoming or not. |
|
731 | + * |
|
732 | + * @access public |
|
733 | + * @return boolean true yes, false no |
|
734 | + * @throws EE_Error |
|
735 | + */ |
|
736 | + public function is_upcoming() |
|
737 | + { |
|
738 | + // check if event id is present and if this event is published |
|
739 | + if ($this->is_inactive()) { |
|
740 | + return false; |
|
741 | + } |
|
742 | + // set initial value |
|
743 | + $upcoming = false; |
|
744 | + // next let's get all datetimes and loop through them |
|
745 | + $datetimes = $this->datetimes_in_chronological_order(); |
|
746 | + foreach ($datetimes as $datetime) { |
|
747 | + if ($datetime instanceof EE_Datetime) { |
|
748 | + // if this dtt is expired then we continue cause one of the other datetimes might be upcoming. |
|
749 | + if ($datetime->is_expired()) { |
|
750 | + continue; |
|
751 | + } |
|
752 | + // if this dtt is active then we return false. |
|
753 | + if ($datetime->is_active()) { |
|
754 | + return false; |
|
755 | + } |
|
756 | + // otherwise let's check upcoming status |
|
757 | + $upcoming = $datetime->is_upcoming(); |
|
758 | + } |
|
759 | + } |
|
760 | + return $upcoming; |
|
761 | + } |
|
762 | + |
|
763 | + |
|
764 | + /** |
|
765 | + * @return bool |
|
766 | + * @throws EE_Error |
|
767 | + */ |
|
768 | + public function is_active() |
|
769 | + { |
|
770 | + // check if event id is present and if this event is published |
|
771 | + if ($this->is_inactive()) { |
|
772 | + return false; |
|
773 | + } |
|
774 | + // set initial value |
|
775 | + $active = false; |
|
776 | + // next let's get all datetimes and loop through them |
|
777 | + $datetimes = $this->datetimes_in_chronological_order(); |
|
778 | + foreach ($datetimes as $datetime) { |
|
779 | + if ($datetime instanceof EE_Datetime) { |
|
780 | + // if this dtt is expired then we continue cause one of the other datetimes might be active. |
|
781 | + if ($datetime->is_expired()) { |
|
782 | + continue; |
|
783 | + } |
|
784 | + // if this dtt is upcoming then we return false. |
|
785 | + if ($datetime->is_upcoming()) { |
|
786 | + return false; |
|
787 | + } |
|
788 | + // otherwise let's check active status |
|
789 | + $active = $datetime->is_active(); |
|
790 | + } |
|
791 | + } |
|
792 | + return $active; |
|
793 | + } |
|
794 | + |
|
795 | + |
|
796 | + /** |
|
797 | + * @return bool |
|
798 | + * @throws EE_Error |
|
799 | + */ |
|
800 | + public function is_expired() |
|
801 | + { |
|
802 | + // check if event id is present and if this event is published |
|
803 | + if ($this->is_inactive()) { |
|
804 | + return false; |
|
805 | + } |
|
806 | + // set initial value |
|
807 | + $expired = false; |
|
808 | + // first let's get all datetimes and loop through them |
|
809 | + $datetimes = $this->datetimes_in_chronological_order(); |
|
810 | + foreach ($datetimes as $datetime) { |
|
811 | + if ($datetime instanceof EE_Datetime) { |
|
812 | + // if this dtt is upcoming or active then we return false. |
|
813 | + if ($datetime->is_upcoming() || $datetime->is_active()) { |
|
814 | + return false; |
|
815 | + } |
|
816 | + // otherwise let's check active status |
|
817 | + $expired = $datetime->is_expired(); |
|
818 | + } |
|
819 | + } |
|
820 | + return $expired; |
|
821 | + } |
|
822 | + |
|
823 | + |
|
824 | + /** |
|
825 | + * @return bool |
|
826 | + * @throws EE_Error |
|
827 | + */ |
|
828 | + public function is_inactive() |
|
829 | + { |
|
830 | + // check if event id is present and if this event is published |
|
831 | + if ($this->_has_ID_and_is_published()) { |
|
832 | + return false; |
|
833 | + } |
|
834 | + return true; |
|
835 | + } |
|
836 | + |
|
837 | + |
|
838 | + /** |
|
839 | + * calculate spaces remaining based on "saleable" tickets |
|
840 | + * |
|
841 | + * @param array $tickets |
|
842 | + * @param bool $filtered |
|
843 | + * @return int|float |
|
844 | + * @throws EE_Error |
|
845 | + * @throws DomainException |
|
846 | + * @throws UnexpectedEntityException |
|
847 | + */ |
|
848 | + public function spaces_remaining($tickets = array(), $filtered = true) |
|
849 | + { |
|
850 | + $this->getAvailableSpacesCalculator()->setActiveTickets($tickets); |
|
851 | + $spaces_remaining = $this->getAvailableSpacesCalculator()->spacesRemaining(); |
|
852 | + return $filtered |
|
853 | + ? apply_filters( |
|
854 | + 'FHEE_EE_Event__spaces_remaining', |
|
855 | + $spaces_remaining, |
|
856 | + $this, |
|
857 | + $tickets |
|
858 | + ) |
|
859 | + : $spaces_remaining; |
|
860 | + } |
|
861 | + |
|
862 | + |
|
863 | + /** |
|
864 | + * perform_sold_out_status_check |
|
865 | + * checks all of this events's datetime reg_limit - sold values to determine if ANY datetimes have spaces |
|
866 | + * available... if NOT, then the event status will get toggled to 'sold_out' |
|
867 | + * |
|
868 | + * @return bool return the ACTUAL sold out state. |
|
869 | + * @throws EE_Error |
|
870 | + * @throws DomainException |
|
871 | + * @throws UnexpectedEntityException |
|
872 | + */ |
|
873 | + public function perform_sold_out_status_check() |
|
874 | + { |
|
875 | + // get all unexpired untrashed tickets |
|
876 | + $tickets = $this->tickets( |
|
877 | + array( |
|
878 | + array('TKT_deleted' => false), |
|
879 | + 'order_by' => array('TKT_qty' => 'ASC'), |
|
880 | + ) |
|
881 | + ); |
|
882 | + $all_expired = true; |
|
883 | + foreach ($tickets as $ticket) { |
|
884 | + if (! $ticket->is_expired()) { |
|
885 | + $all_expired = false; |
|
886 | + break; |
|
887 | + } |
|
888 | + } |
|
889 | + // if all the tickets are just expired, then don't update the event status to sold out |
|
890 | + if ($all_expired) { |
|
891 | + return true; |
|
892 | + } |
|
893 | + $spaces_remaining = $this->spaces_remaining($tickets); |
|
894 | + if ($spaces_remaining < 1) { |
|
895 | + $this->set_status(EEM_Event::sold_out); |
|
896 | + $this->save(); |
|
897 | + $sold_out = true; |
|
898 | + } else { |
|
899 | + $sold_out = false; |
|
900 | + // was event previously marked as sold out ? |
|
901 | + if ($this->status() === EEM_Event::sold_out) { |
|
902 | + // revert status to previous value, if it was set |
|
903 | + $previous_event_status = $this->get_post_meta('_previous_event_status', true); |
|
904 | + if ($previous_event_status) { |
|
905 | + $this->set_status($previous_event_status); |
|
906 | + $this->save(); |
|
907 | + } |
|
908 | + } |
|
909 | + } |
|
910 | + do_action('AHEE__EE_Event__perform_sold_out_status_check__end', $this, $sold_out, $spaces_remaining, $tickets); |
|
911 | + return $sold_out; |
|
912 | + } |
|
913 | + |
|
914 | + |
|
915 | + /** |
|
916 | + * This returns the total remaining spaces for sale on this event. |
|
917 | + * |
|
918 | + * @uses EE_Event::total_available_spaces() |
|
919 | + * @return float|int |
|
920 | + * @throws EE_Error |
|
921 | + * @throws DomainException |
|
922 | + * @throws UnexpectedEntityException |
|
923 | + */ |
|
924 | + public function spaces_remaining_for_sale() |
|
925 | + { |
|
926 | + return $this->total_available_spaces(true); |
|
927 | + } |
|
928 | + |
|
929 | + |
|
930 | + /** |
|
931 | + * This returns the total spaces available for an event |
|
932 | + * while considering all the qtys on the tickets and the reg limits |
|
933 | + * on the datetimes attached to this event. |
|
934 | + * |
|
935 | + * @param bool $consider_sold Whether to consider any tickets that have already sold in our calculation. |
|
936 | + * If this is false, then we return the most tickets that could ever be sold |
|
937 | + * for this event with the datetime and tickets setup on the event under optimal |
|
938 | + * selling conditions. Otherwise we return a live calculation of spaces available |
|
939 | + * based on tickets sold. Depending on setup and stage of sales, this |
|
940 | + * may appear to equal remaining tickets. However, the more tickets are |
|
941 | + * sold out, the more accurate the "live" total is. |
|
942 | + * @return float|int |
|
943 | + * @throws EE_Error |
|
944 | + * @throws DomainException |
|
945 | + * @throws UnexpectedEntityException |
|
946 | + */ |
|
947 | + public function total_available_spaces($consider_sold = false) |
|
948 | + { |
|
949 | + $spaces_available = $consider_sold |
|
950 | + ? $this->getAvailableSpacesCalculator()->spacesRemaining() |
|
951 | + : $this->getAvailableSpacesCalculator()->totalSpacesAvailable(); |
|
952 | + return apply_filters( |
|
953 | + 'FHEE_EE_Event__total_available_spaces__spaces_available', |
|
954 | + $spaces_available, |
|
955 | + $this, |
|
956 | + $this->getAvailableSpacesCalculator()->getDatetimes(), |
|
957 | + $this->getAvailableSpacesCalculator()->getActiveTickets() |
|
958 | + ); |
|
959 | + } |
|
960 | + |
|
961 | + |
|
962 | + /** |
|
963 | + * Checks if the event is set to sold out |
|
964 | + * |
|
965 | + * @param bool $actual whether or not to perform calculations to not only figure the |
|
966 | + * actual status but also to flip the status if necessary to sold |
|
967 | + * out If false, we just check the existing status of the event |
|
968 | + * @return boolean |
|
969 | + * @throws EE_Error |
|
970 | + */ |
|
971 | + public function is_sold_out($actual = false) |
|
972 | + { |
|
973 | + if (! $actual) { |
|
974 | + return $this->status() === EEM_Event::sold_out; |
|
975 | + } |
|
976 | + return $this->perform_sold_out_status_check(); |
|
977 | + } |
|
978 | + |
|
979 | + |
|
980 | + /** |
|
981 | + * Checks if the event is marked as postponed |
|
982 | + * |
|
983 | + * @return boolean |
|
984 | + */ |
|
985 | + public function is_postponed() |
|
986 | + { |
|
987 | + return $this->status() === EEM_Event::postponed; |
|
988 | + } |
|
989 | + |
|
990 | + |
|
991 | + /** |
|
992 | + * Checks if the event is marked as cancelled |
|
993 | + * |
|
994 | + * @return boolean |
|
995 | + */ |
|
996 | + public function is_cancelled() |
|
997 | + { |
|
998 | + return $this->status() === EEM_Event::cancelled; |
|
999 | + } |
|
1000 | + |
|
1001 | + |
|
1002 | + /** |
|
1003 | + * Get the logical active status in a hierarchical order for all the datetimes. Note |
|
1004 | + * Basically, we order the datetimes by EVT_start_date. Then first test on whether the event is published. If its |
|
1005 | + * NOT published then we test for whether its expired or not. IF it IS published then we test first on whether an |
|
1006 | + * event has any active dates. If no active dates then we check for any upcoming dates. If no upcoming dates then |
|
1007 | + * the event is considered expired. |
|
1008 | + * NOTE: this method does NOT calculate whether the datetimes are sold out when event is published. Sold Out is a |
|
1009 | + * status set on the EVENT when it is not published and thus is done |
|
1010 | + * |
|
1011 | + * @param bool $reset |
|
1012 | + * @return bool | string - based on EE_Datetime active constants or FALSE if error. |
|
1013 | + * @throws EE_Error |
|
1014 | + */ |
|
1015 | + public function get_active_status($reset = false) |
|
1016 | + { |
|
1017 | + // if the active status has already been set, then just use that value (unless we are resetting it) |
|
1018 | + if (! empty($this->_active_status) && ! $reset) { |
|
1019 | + return $this->_active_status; |
|
1020 | + } |
|
1021 | + // first check if event id is present on this object |
|
1022 | + if (! $this->ID()) { |
|
1023 | + return false; |
|
1024 | + } |
|
1025 | + $where_params_for_event = array(array('EVT_ID' => $this->ID())); |
|
1026 | + // if event is published: |
|
1027 | + if ($this->status() === 'publish') { |
|
1028 | + // active? |
|
1029 | + if (EEM_Datetime::instance()->get_datetime_count_for_status( |
|
1030 | + EE_Datetime::active, |
|
1031 | + $where_params_for_event |
|
1032 | + ) > 0) { |
|
1033 | + $this->_active_status = EE_Datetime::active; |
|
1034 | + } else { |
|
1035 | + // upcoming? |
|
1036 | + if (EEM_Datetime::instance()->get_datetime_count_for_status( |
|
1037 | + EE_Datetime::upcoming, |
|
1038 | + $where_params_for_event |
|
1039 | + ) > 0) { |
|
1040 | + $this->_active_status = EE_Datetime::upcoming; |
|
1041 | + } else { |
|
1042 | + // expired? |
|
1043 | + if (EEM_Datetime::instance()->get_datetime_count_for_status( |
|
1044 | + EE_Datetime::expired, |
|
1045 | + $where_params_for_event |
|
1046 | + ) > 0 |
|
1047 | + ) { |
|
1048 | + $this->_active_status = EE_Datetime::expired; |
|
1049 | + } else { |
|
1050 | + // it would be odd if things make it this far because it basically means there are no datetime's |
|
1051 | + // attached to the event. So in this case it will just be considered inactive. |
|
1052 | + $this->_active_status = EE_Datetime::inactive; |
|
1053 | + } |
|
1054 | + } |
|
1055 | + } |
|
1056 | + } else { |
|
1057 | + // the event is not published, so let's just set it's active status according to its' post status |
|
1058 | + switch ($this->status()) { |
|
1059 | + case EEM_Event::sold_out: |
|
1060 | + $this->_active_status = EE_Datetime::sold_out; |
|
1061 | + break; |
|
1062 | + case EEM_Event::cancelled: |
|
1063 | + $this->_active_status = EE_Datetime::cancelled; |
|
1064 | + break; |
|
1065 | + case EEM_Event::postponed: |
|
1066 | + $this->_active_status = EE_Datetime::postponed; |
|
1067 | + break; |
|
1068 | + default: |
|
1069 | + $this->_active_status = EE_Datetime::inactive; |
|
1070 | + } |
|
1071 | + } |
|
1072 | + return $this->_active_status; |
|
1073 | + } |
|
1074 | + |
|
1075 | + |
|
1076 | + /** |
|
1077 | + * pretty_active_status |
|
1078 | + * |
|
1079 | + * @access public |
|
1080 | + * @param boolean $echo whether to return (FALSE), or echo out the result (TRUE) |
|
1081 | + * @return mixed void|string |
|
1082 | + * @throws EE_Error |
|
1083 | + */ |
|
1084 | + public function pretty_active_status($echo = true) |
|
1085 | + { |
|
1086 | + $active_status = $this->get_active_status(); |
|
1087 | + $status = '<span class="ee-status event-active-status-' |
|
1088 | + . $active_status |
|
1089 | + . '">' |
|
1090 | + . EEH_Template::pretty_status($active_status, false, 'sentence') |
|
1091 | + . '</span>'; |
|
1092 | + if ($echo) { |
|
1093 | + echo $status; |
|
1094 | + return ''; |
|
1095 | + } |
|
1096 | + return $status; |
|
1097 | + } |
|
1098 | + |
|
1099 | + |
|
1100 | + /** |
|
1101 | + * @return bool|int |
|
1102 | + * @throws EE_Error |
|
1103 | + */ |
|
1104 | + public function get_number_of_tickets_sold() |
|
1105 | + { |
|
1106 | + $tkt_sold = 0; |
|
1107 | + if (! $this->ID()) { |
|
1108 | + return 0; |
|
1109 | + } |
|
1110 | + $datetimes = $this->datetimes(); |
|
1111 | + foreach ($datetimes as $datetime) { |
|
1112 | + if ($datetime instanceof EE_Datetime) { |
|
1113 | + $tkt_sold += $datetime->sold(); |
|
1114 | + } |
|
1115 | + } |
|
1116 | + return $tkt_sold; |
|
1117 | + } |
|
1118 | + |
|
1119 | + |
|
1120 | + /** |
|
1121 | + * This just returns a count of all the registrations for this event |
|
1122 | + * |
|
1123 | + * @access public |
|
1124 | + * @return int |
|
1125 | + * @throws EE_Error |
|
1126 | + */ |
|
1127 | + public function get_count_of_all_registrations() |
|
1128 | + { |
|
1129 | + return EEM_Event::instance()->count_related($this, 'Registration'); |
|
1130 | + } |
|
1131 | + |
|
1132 | + |
|
1133 | + /** |
|
1134 | + * This returns the ticket with the earliest start time that is |
|
1135 | + * available for this event (across all datetimes attached to the event) |
|
1136 | + * |
|
1137 | + * @return EE_Base_Class|EE_Ticket|null |
|
1138 | + * @throws EE_Error |
|
1139 | + */ |
|
1140 | + public function get_ticket_with_earliest_start_time() |
|
1141 | + { |
|
1142 | + $where['Datetime.EVT_ID'] = $this->ID(); |
|
1143 | + $query_params = array($where, 'order_by' => array('TKT_start_date' => 'ASC')); |
|
1144 | + return EE_Registry::instance()->load_model('Ticket')->get_one($query_params); |
|
1145 | + } |
|
1146 | + |
|
1147 | + |
|
1148 | + /** |
|
1149 | + * This returns the ticket with the latest end time that is available |
|
1150 | + * for this event (across all datetimes attached to the event) |
|
1151 | + * |
|
1152 | + * @return EE_Base_Class|EE_Ticket|null |
|
1153 | + * @throws EE_Error |
|
1154 | + */ |
|
1155 | + public function get_ticket_with_latest_end_time() |
|
1156 | + { |
|
1157 | + $where['Datetime.EVT_ID'] = $this->ID(); |
|
1158 | + $query_params = array($where, 'order_by' => array('TKT_end_date' => 'DESC')); |
|
1159 | + return EE_Registry::instance()->load_model('Ticket')->get_one($query_params); |
|
1160 | + } |
|
1161 | + |
|
1162 | + |
|
1163 | + /** |
|
1164 | + * This returns the number of different ticket types currently on sale for this event. |
|
1165 | + * |
|
1166 | + * @return int |
|
1167 | + * @throws EE_Error |
|
1168 | + */ |
|
1169 | + public function countTicketsOnSale() |
|
1170 | + { |
|
1171 | + $where = array( |
|
1172 | + 'Datetime.EVT_ID' => $this->ID(), |
|
1173 | + 'TKT_start_date' => array('<', time()), |
|
1174 | + 'TKT_end_date' => array('>', time()), |
|
1175 | + ); |
|
1176 | + return EEM_Ticket::instance()->count(array($where)); |
|
1177 | + } |
|
1178 | + |
|
1179 | + |
|
1180 | + /** |
|
1181 | + * This returns whether there are any tickets on sale for this event. |
|
1182 | + * |
|
1183 | + * @return bool true = YES tickets on sale. |
|
1184 | + * @throws EE_Error |
|
1185 | + */ |
|
1186 | + public function tickets_on_sale() |
|
1187 | + { |
|
1188 | + return $this->countTicketsOnSale() > 0; |
|
1189 | + } |
|
1190 | + |
|
1191 | + |
|
1192 | + /** |
|
1193 | + * Gets the URL for viewing this event on the front-end. Overrides parent |
|
1194 | + * to check for an external URL first |
|
1195 | + * |
|
1196 | + * @return string |
|
1197 | + * @throws EE_Error |
|
1198 | + */ |
|
1199 | + public function get_permalink() |
|
1200 | + { |
|
1201 | + if ($this->external_url()) { |
|
1202 | + return $this->external_url(); |
|
1203 | + } |
|
1204 | + return parent::get_permalink(); |
|
1205 | + } |
|
1206 | + |
|
1207 | + |
|
1208 | + /** |
|
1209 | + * Gets the first term for 'espresso_event_categories' we can find |
|
1210 | + * |
|
1211 | + * @param array $query_params like EEM_Base::get_all |
|
1212 | + * @return EE_Base_Class|EE_Term|null |
|
1213 | + * @throws EE_Error |
|
1214 | + */ |
|
1215 | + public function first_event_category($query_params = array()) |
|
1216 | + { |
|
1217 | + $query_params[0]['Term_Taxonomy.taxonomy'] = 'espresso_event_categories'; |
|
1218 | + $query_params[0]['Term_Taxonomy.Event.EVT_ID'] = $this->ID(); |
|
1219 | + return EEM_Term::instance()->get_one($query_params); |
|
1220 | + } |
|
1221 | + |
|
1222 | + |
|
1223 | + /** |
|
1224 | + * Gets all terms for 'espresso_event_categories' we can find |
|
1225 | + * |
|
1226 | + * @param array $query_params |
|
1227 | + * @return EE_Base_Class[]|EE_Term[] |
|
1228 | + * @throws EE_Error |
|
1229 | + */ |
|
1230 | + public function get_all_event_categories($query_params = array()) |
|
1231 | + { |
|
1232 | + $query_params[0]['Term_Taxonomy.taxonomy'] = 'espresso_event_categories'; |
|
1233 | + $query_params[0]['Term_Taxonomy.Event.EVT_ID'] = $this->ID(); |
|
1234 | + return EEM_Term::instance()->get_all($query_params); |
|
1235 | + } |
|
1236 | + |
|
1237 | + |
|
1238 | + /** |
|
1239 | + * Adds a question group to this event |
|
1240 | + * |
|
1241 | + * @param EE_Question_Group|int $question_group_id_or_obj |
|
1242 | + * @param bool $for_primary if true, the question group will be added for the primary |
|
1243 | + * registrant, if false will be added for others. default: false |
|
1244 | + * @return EE_Base_Class|EE_Question_Group |
|
1245 | + * @throws EE_Error |
|
1246 | + */ |
|
1247 | + public function add_question_group($question_group_id_or_obj, $for_primary = false) |
|
1248 | + { |
|
1249 | + $extra = $for_primary |
|
1250 | + ? array('EQG_primary' => 1) |
|
1251 | + : array(); |
|
1252 | + return $this->_add_relation_to($question_group_id_or_obj, 'Question_Group', $extra); |
|
1253 | + } |
|
1254 | + |
|
1255 | + |
|
1256 | + /** |
|
1257 | + * Removes a question group from the event |
|
1258 | + * |
|
1259 | + * @param EE_Question_Group|int $question_group_id_or_obj |
|
1260 | + * @param bool $for_primary if true, the question group will be removed from the primary |
|
1261 | + * registrant, if false will be removed from others. default: false |
|
1262 | + * @return EE_Base_Class|EE_Question_Group |
|
1263 | + * @throws EE_Error |
|
1264 | + */ |
|
1265 | + public function remove_question_group($question_group_id_or_obj, $for_primary = false) |
|
1266 | + { |
|
1267 | + $where = $for_primary |
|
1268 | + ? array('EQG_primary' => 1) |
|
1269 | + : array(); |
|
1270 | + return $this->_remove_relation_to($question_group_id_or_obj, 'Question_Group', $where); |
|
1271 | + } |
|
1272 | + |
|
1273 | + |
|
1274 | + /** |
|
1275 | + * Gets all the question groups, ordering them by QSG_order ascending |
|
1276 | + * |
|
1277 | + * @param array $query_params @see EEM_Base::get_all |
|
1278 | + * @return EE_Base_Class[]|EE_Question_Group[] |
|
1279 | + * @throws EE_Error |
|
1280 | + */ |
|
1281 | + public function question_groups($query_params = array()) |
|
1282 | + { |
|
1283 | + $query_params = ! empty($query_params) ? $query_params : array('order_by' => array('QSG_order' => 'ASC')); |
|
1284 | + return $this->get_many_related('Question_Group', $query_params); |
|
1285 | + } |
|
1286 | + |
|
1287 | + |
|
1288 | + /** |
|
1289 | + * Implementation for EEI_Has_Icon interface method. |
|
1290 | + * |
|
1291 | + * @see EEI_Visual_Representation for comments |
|
1292 | + * @return string |
|
1293 | + */ |
|
1294 | + public function get_icon() |
|
1295 | + { |
|
1296 | + return '<span class="dashicons dashicons-flag"></span>'; |
|
1297 | + } |
|
1298 | + |
|
1299 | + |
|
1300 | + /** |
|
1301 | + * Implementation for EEI_Admin_Links interface method. |
|
1302 | + * |
|
1303 | + * @see EEI_Admin_Links for comments |
|
1304 | + * @return string |
|
1305 | + * @throws EE_Error |
|
1306 | + */ |
|
1307 | + public function get_admin_details_link() |
|
1308 | + { |
|
1309 | + return $this->get_admin_edit_link(); |
|
1310 | + } |
|
1311 | + |
|
1312 | + |
|
1313 | + /** |
|
1314 | + * Implementation for EEI_Admin_Links interface method. |
|
1315 | + * |
|
1316 | + * @see EEI_Admin_Links for comments |
|
1317 | + * @return string |
|
1318 | + * @throws EE_Error |
|
1319 | + */ |
|
1320 | + public function get_admin_edit_link() |
|
1321 | + { |
|
1322 | + return EEH_URL::add_query_args_and_nonce( |
|
1323 | + array( |
|
1324 | + 'page' => 'espresso_events', |
|
1325 | + 'action' => 'edit', |
|
1326 | + 'post' => $this->ID(), |
|
1327 | + ), |
|
1328 | + admin_url('admin.php') |
|
1329 | + ); |
|
1330 | + } |
|
1331 | + |
|
1332 | + |
|
1333 | + /** |
|
1334 | + * Implementation for EEI_Admin_Links interface method. |
|
1335 | + * |
|
1336 | + * @see EEI_Admin_Links for comments |
|
1337 | + * @return string |
|
1338 | + */ |
|
1339 | + public function get_admin_settings_link() |
|
1340 | + { |
|
1341 | + return EEH_URL::add_query_args_and_nonce( |
|
1342 | + array( |
|
1343 | + 'page' => 'espresso_events', |
|
1344 | + 'action' => 'default_event_settings', |
|
1345 | + ), |
|
1346 | + admin_url('admin.php') |
|
1347 | + ); |
|
1348 | + } |
|
1349 | + |
|
1350 | + |
|
1351 | + /** |
|
1352 | + * Implementation for EEI_Admin_Links interface method. |
|
1353 | + * |
|
1354 | + * @see EEI_Admin_Links for comments |
|
1355 | + * @return string |
|
1356 | + */ |
|
1357 | + public function get_admin_overview_link() |
|
1358 | + { |
|
1359 | + return EEH_URL::add_query_args_and_nonce( |
|
1360 | + array( |
|
1361 | + 'page' => 'espresso_events', |
|
1362 | + 'action' => 'default', |
|
1363 | + ), |
|
1364 | + admin_url('admin.php') |
|
1365 | + ); |
|
1366 | + } |
|
1367 | 1367 | } |
@@ -69,7 +69,7 @@ discard block |
||
69 | 69 | */ |
70 | 70 | public function getAvailableSpacesCalculator() |
71 | 71 | { |
72 | - if (! $this->available_spaces_calculator instanceof EventSpacesCalculator) { |
|
72 | + if ( ! $this->available_spaces_calculator instanceof EventSpacesCalculator) { |
|
73 | 73 | $this->available_spaces_calculator = new EventSpacesCalculator($this); |
74 | 74 | } |
75 | 75 | return $this->available_spaces_calculator; |
@@ -211,7 +211,7 @@ discard block |
||
211 | 211 | */ |
212 | 212 | public function primary_datetime($try_to_exclude_expired = true, $try_to_exclude_deleted = true) |
213 | 213 | { |
214 | - if (! empty($this->_Primary_Datetime)) { |
|
214 | + if ( ! empty($this->_Primary_Datetime)) { |
|
215 | 215 | return $this->_Primary_Datetime; |
216 | 216 | } |
217 | 217 | $this->_Primary_Datetime = EEM_Datetime::instance($this->_timezone)->get_primary_datetime_for_event( |
@@ -234,7 +234,7 @@ discard block |
||
234 | 234 | { |
235 | 235 | // first get all datetimes |
236 | 236 | $datetimes = $this->datetimes_ordered(); |
237 | - if (! $datetimes) { |
|
237 | + if ( ! $datetimes) { |
|
238 | 238 | return array(); |
239 | 239 | } |
240 | 240 | $datetime_ids = array(); |
@@ -427,7 +427,7 @@ discard block |
||
427 | 427 | public function short_description($num_words = 55, $more = null, $not_full_desc = false) |
428 | 428 | { |
429 | 429 | $short_desc = $this->get('EVT_short_desc'); |
430 | - if (! empty($short_desc) || $not_full_desc) { |
|
430 | + if ( ! empty($short_desc) || $not_full_desc) { |
|
431 | 431 | return $short_desc; |
432 | 432 | } |
433 | 433 | $full_desc = $this->get('EVT_desc'); |
@@ -881,7 +881,7 @@ discard block |
||
881 | 881 | ); |
882 | 882 | $all_expired = true; |
883 | 883 | foreach ($tickets as $ticket) { |
884 | - if (! $ticket->is_expired()) { |
|
884 | + if ( ! $ticket->is_expired()) { |
|
885 | 885 | $all_expired = false; |
886 | 886 | break; |
887 | 887 | } |
@@ -970,7 +970,7 @@ discard block |
||
970 | 970 | */ |
971 | 971 | public function is_sold_out($actual = false) |
972 | 972 | { |
973 | - if (! $actual) { |
|
973 | + if ( ! $actual) { |
|
974 | 974 | return $this->status() === EEM_Event::sold_out; |
975 | 975 | } |
976 | 976 | return $this->perform_sold_out_status_check(); |
@@ -1015,11 +1015,11 @@ discard block |
||
1015 | 1015 | public function get_active_status($reset = false) |
1016 | 1016 | { |
1017 | 1017 | // if the active status has already been set, then just use that value (unless we are resetting it) |
1018 | - if (! empty($this->_active_status) && ! $reset) { |
|
1018 | + if ( ! empty($this->_active_status) && ! $reset) { |
|
1019 | 1019 | return $this->_active_status; |
1020 | 1020 | } |
1021 | 1021 | // first check if event id is present on this object |
1022 | - if (! $this->ID()) { |
|
1022 | + if ( ! $this->ID()) { |
|
1023 | 1023 | return false; |
1024 | 1024 | } |
1025 | 1025 | $where_params_for_event = array(array('EVT_ID' => $this->ID())); |
@@ -1104,7 +1104,7 @@ discard block |
||
1104 | 1104 | public function get_number_of_tickets_sold() |
1105 | 1105 | { |
1106 | 1106 | $tkt_sold = 0; |
1107 | - if (! $this->ID()) { |
|
1107 | + if ( ! $this->ID()) { |
|
1108 | 1108 | return 0; |
1109 | 1109 | } |
1110 | 1110 | $datetimes = $this->datetimes(); |
@@ -14,2524 +14,2524 @@ discard block |
||
14 | 14 | final class EE_Config implements ResettableInterface |
15 | 15 | { |
16 | 16 | |
17 | - const OPTION_NAME = 'ee_config'; |
|
18 | - |
|
19 | - const LOG_NAME = 'ee_config_log'; |
|
20 | - |
|
21 | - const LOG_LENGTH = 100; |
|
22 | - |
|
23 | - const ADDON_OPTION_NAMES = 'ee_config_option_names'; |
|
24 | - |
|
25 | - /** |
|
26 | - * instance of the EE_Config object |
|
27 | - * |
|
28 | - * @var EE_Config $_instance |
|
29 | - * @access private |
|
30 | - */ |
|
31 | - private static $_instance; |
|
32 | - |
|
33 | - /** |
|
34 | - * @var boolean $_logging_enabled |
|
35 | - */ |
|
36 | - private static $_logging_enabled = false; |
|
37 | - |
|
38 | - /** |
|
39 | - * @var LegacyShortcodesManager $legacy_shortcodes_manager |
|
40 | - */ |
|
41 | - private $legacy_shortcodes_manager; |
|
42 | - |
|
43 | - /** |
|
44 | - * An StdClass whose property names are addon slugs, |
|
45 | - * and values are their config classes |
|
46 | - * |
|
47 | - * @var StdClass |
|
48 | - */ |
|
49 | - public $addons; |
|
50 | - |
|
51 | - /** |
|
52 | - * @var EE_Admin_Config |
|
53 | - */ |
|
54 | - public $admin; |
|
55 | - |
|
56 | - /** |
|
57 | - * @var EE_Core_Config |
|
58 | - */ |
|
59 | - public $core; |
|
60 | - |
|
61 | - /** |
|
62 | - * @var EE_Currency_Config |
|
63 | - */ |
|
64 | - public $currency; |
|
65 | - |
|
66 | - /** |
|
67 | - * @var EE_Organization_Config |
|
68 | - */ |
|
69 | - public $organization; |
|
70 | - |
|
71 | - /** |
|
72 | - * @var EE_Registration_Config |
|
73 | - */ |
|
74 | - public $registration; |
|
75 | - |
|
76 | - /** |
|
77 | - * @var EE_Template_Config |
|
78 | - */ |
|
79 | - public $template_settings; |
|
80 | - |
|
81 | - /** |
|
82 | - * Holds EE environment values. |
|
83 | - * |
|
84 | - * @var EE_Environment_Config |
|
85 | - */ |
|
86 | - public $environment; |
|
87 | - |
|
88 | - /** |
|
89 | - * settings pertaining to Google maps |
|
90 | - * |
|
91 | - * @var EE_Map_Config |
|
92 | - */ |
|
93 | - public $map_settings; |
|
94 | - |
|
95 | - /** |
|
96 | - * settings pertaining to Taxes |
|
97 | - * |
|
98 | - * @var EE_Tax_Config |
|
99 | - */ |
|
100 | - public $tax_settings; |
|
101 | - |
|
102 | - /** |
|
103 | - * Settings pertaining to global messages settings. |
|
104 | - * |
|
105 | - * @var EE_Messages_Config |
|
106 | - */ |
|
107 | - public $messages; |
|
108 | - |
|
109 | - /** |
|
110 | - * @deprecated |
|
111 | - * @var EE_Gateway_Config |
|
112 | - */ |
|
113 | - public $gateway; |
|
114 | - |
|
115 | - /** |
|
116 | - * @var array $_addon_option_names |
|
117 | - * @access private |
|
118 | - */ |
|
119 | - private $_addon_option_names = array(); |
|
120 | - |
|
121 | - /** |
|
122 | - * @var array $_module_route_map |
|
123 | - * @access private |
|
124 | - */ |
|
125 | - private static $_module_route_map = array(); |
|
126 | - |
|
127 | - /** |
|
128 | - * @var array $_module_forward_map |
|
129 | - * @access private |
|
130 | - */ |
|
131 | - private static $_module_forward_map = array(); |
|
132 | - |
|
133 | - /** |
|
134 | - * @var array $_module_view_map |
|
135 | - * @access private |
|
136 | - */ |
|
137 | - private static $_module_view_map = array(); |
|
138 | - |
|
139 | - |
|
140 | - /** |
|
141 | - * @singleton method used to instantiate class object |
|
142 | - * @access public |
|
143 | - * @return EE_Config instance |
|
144 | - */ |
|
145 | - public static function instance() |
|
146 | - { |
|
147 | - // check if class object is instantiated, and instantiated properly |
|
148 | - if (! self::$_instance instanceof EE_Config) { |
|
149 | - self::$_instance = new self(); |
|
150 | - } |
|
151 | - return self::$_instance; |
|
152 | - } |
|
153 | - |
|
154 | - |
|
155 | - /** |
|
156 | - * Resets the config |
|
157 | - * |
|
158 | - * @param bool $hard_reset if TRUE, sets EE_CONFig back to its original settings in the database. If FALSE |
|
159 | - * (default) leaves the database alone, and merely resets the EE_Config object to |
|
160 | - * reflect its state in the database |
|
161 | - * @param boolean $reinstantiate if TRUE (default) call instance() and return it. Otherwise, just leave |
|
162 | - * $_instance as NULL. Useful in case you want to forget about the old instance on |
|
163 | - * EE_Config, but might not be ready to instantiate EE_Config currently (eg if the |
|
164 | - * site was put into maintenance mode) |
|
165 | - * @return EE_Config |
|
166 | - */ |
|
167 | - public static function reset($hard_reset = false, $reinstantiate = true) |
|
168 | - { |
|
169 | - if (self::$_instance instanceof EE_Config) { |
|
170 | - if ($hard_reset) { |
|
171 | - self::$_instance->legacy_shortcodes_manager = null; |
|
172 | - self::$_instance->_addon_option_names = array(); |
|
173 | - self::$_instance->_initialize_config(); |
|
174 | - self::$_instance->update_espresso_config(); |
|
175 | - } |
|
176 | - self::$_instance->update_addon_option_names(); |
|
177 | - } |
|
178 | - self::$_instance = null; |
|
179 | - // we don't need to reset the static properties imo because those should |
|
180 | - // only change when a module is added or removed. Currently we don't |
|
181 | - // support removing a module during a request when it previously existed |
|
182 | - if ($reinstantiate) { |
|
183 | - return self::instance(); |
|
184 | - } else { |
|
185 | - return null; |
|
186 | - } |
|
187 | - } |
|
188 | - |
|
189 | - |
|
190 | - /** |
|
191 | - * class constructor |
|
192 | - * |
|
193 | - * @access private |
|
194 | - */ |
|
195 | - private function __construct() |
|
196 | - { |
|
197 | - do_action('AHEE__EE_Config__construct__begin', $this); |
|
198 | - EE_Config::$_logging_enabled = apply_filters('FHEE__EE_Config___construct__logging_enabled', false); |
|
199 | - // setup empty config classes |
|
200 | - $this->_initialize_config(); |
|
201 | - // load existing EE site settings |
|
202 | - $this->_load_core_config(); |
|
203 | - // confirm everything loaded correctly and set filtered defaults if not |
|
204 | - $this->_verify_config(); |
|
205 | - // register shortcodes and modules |
|
206 | - add_action( |
|
207 | - 'AHEE__EE_System__register_shortcodes_modules_and_widgets', |
|
208 | - array($this, 'register_shortcodes_and_modules'), |
|
209 | - 999 |
|
210 | - ); |
|
211 | - // initialize shortcodes and modules |
|
212 | - add_action('AHEE__EE_System__core_loaded_and_ready', array($this, 'initialize_shortcodes_and_modules')); |
|
213 | - // register widgets |
|
214 | - add_action('widgets_init', array($this, 'widgets_init'), 10); |
|
215 | - // shutdown |
|
216 | - add_action('shutdown', array($this, 'shutdown'), 10); |
|
217 | - // construct__end hook |
|
218 | - do_action('AHEE__EE_Config__construct__end', $this); |
|
219 | - // hardcoded hack |
|
220 | - $this->template_settings->current_espresso_theme = 'Espresso_Arabica_2014'; |
|
221 | - } |
|
222 | - |
|
223 | - |
|
224 | - /** |
|
225 | - * @return boolean |
|
226 | - */ |
|
227 | - public static function logging_enabled() |
|
228 | - { |
|
229 | - return self::$_logging_enabled; |
|
230 | - } |
|
231 | - |
|
232 | - |
|
233 | - /** |
|
234 | - * use to get the current theme if needed from static context |
|
235 | - * |
|
236 | - * @return string current theme set. |
|
237 | - */ |
|
238 | - public static function get_current_theme() |
|
239 | - { |
|
240 | - return isset(self::$_instance->template_settings->current_espresso_theme) |
|
241 | - ? self::$_instance->template_settings->current_espresso_theme : 'Espresso_Arabica_2014'; |
|
242 | - } |
|
243 | - |
|
244 | - |
|
245 | - /** |
|
246 | - * _initialize_config |
|
247 | - * |
|
248 | - * @access private |
|
249 | - * @return void |
|
250 | - */ |
|
251 | - private function _initialize_config() |
|
252 | - { |
|
253 | - EE_Config::trim_log(); |
|
254 | - // set defaults |
|
255 | - $this->_addon_option_names = get_option(EE_Config::ADDON_OPTION_NAMES, array()); |
|
256 | - $this->addons = new stdClass(); |
|
257 | - // set _module_route_map |
|
258 | - EE_Config::$_module_route_map = array(); |
|
259 | - // set _module_forward_map |
|
260 | - EE_Config::$_module_forward_map = array(); |
|
261 | - // set _module_view_map |
|
262 | - EE_Config::$_module_view_map = array(); |
|
263 | - } |
|
264 | - |
|
265 | - |
|
266 | - /** |
|
267 | - * load core plugin configuration |
|
268 | - * |
|
269 | - * @access private |
|
270 | - * @return void |
|
271 | - */ |
|
272 | - private function _load_core_config() |
|
273 | - { |
|
274 | - // load_core_config__start hook |
|
275 | - do_action('AHEE__EE_Config___load_core_config__start', $this); |
|
276 | - $espresso_config = $this->get_espresso_config(); |
|
277 | - foreach ($espresso_config as $config => $settings) { |
|
278 | - // load_core_config__start hook |
|
279 | - $settings = apply_filters( |
|
280 | - 'FHEE__EE_Config___load_core_config__config_settings', |
|
281 | - $settings, |
|
282 | - $config, |
|
283 | - $this |
|
284 | - ); |
|
285 | - if (is_object($settings) && property_exists($this, $config)) { |
|
286 | - $this->{$config} = apply_filters('FHEE__EE_Config___load_core_config__' . $config, $settings); |
|
287 | - // call configs populate method to ensure any defaults are set for empty values. |
|
288 | - if (method_exists($settings, 'populate')) { |
|
289 | - $this->{$config}->populate(); |
|
290 | - } |
|
291 | - if (method_exists($settings, 'do_hooks')) { |
|
292 | - $this->{$config}->do_hooks(); |
|
293 | - } |
|
294 | - } |
|
295 | - } |
|
296 | - if (apply_filters('FHEE__EE_Config___load_core_config__update_espresso_config', false)) { |
|
297 | - $this->update_espresso_config(); |
|
298 | - } |
|
299 | - // load_core_config__end hook |
|
300 | - do_action('AHEE__EE_Config___load_core_config__end', $this); |
|
301 | - } |
|
302 | - |
|
303 | - |
|
304 | - /** |
|
305 | - * _verify_config |
|
306 | - * |
|
307 | - * @access protected |
|
308 | - * @return void |
|
309 | - */ |
|
310 | - protected function _verify_config() |
|
311 | - { |
|
312 | - $this->core = $this->core instanceof EE_Core_Config |
|
313 | - ? $this->core |
|
314 | - : new EE_Core_Config(); |
|
315 | - $this->core = apply_filters('FHEE__EE_Config___initialize_config__core', $this->core); |
|
316 | - $this->organization = $this->organization instanceof EE_Organization_Config |
|
317 | - ? $this->organization |
|
318 | - : new EE_Organization_Config(); |
|
319 | - $this->organization = apply_filters( |
|
320 | - 'FHEE__EE_Config___initialize_config__organization', |
|
321 | - $this->organization |
|
322 | - ); |
|
323 | - $this->currency = $this->currency instanceof EE_Currency_Config |
|
324 | - ? $this->currency |
|
325 | - : new EE_Currency_Config(); |
|
326 | - $this->currency = apply_filters('FHEE__EE_Config___initialize_config__currency', $this->currency); |
|
327 | - $this->registration = $this->registration instanceof EE_Registration_Config |
|
328 | - ? $this->registration |
|
329 | - : new EE_Registration_Config(); |
|
330 | - $this->registration = apply_filters( |
|
331 | - 'FHEE__EE_Config___initialize_config__registration', |
|
332 | - $this->registration |
|
333 | - ); |
|
334 | - $this->admin = $this->admin instanceof EE_Admin_Config |
|
335 | - ? $this->admin |
|
336 | - : new EE_Admin_Config(); |
|
337 | - $this->admin = apply_filters('FHEE__EE_Config___initialize_config__admin', $this->admin); |
|
338 | - $this->template_settings = $this->template_settings instanceof EE_Template_Config |
|
339 | - ? $this->template_settings |
|
340 | - : new EE_Template_Config(); |
|
341 | - $this->template_settings = apply_filters( |
|
342 | - 'FHEE__EE_Config___initialize_config__template_settings', |
|
343 | - $this->template_settings |
|
344 | - ); |
|
345 | - $this->map_settings = $this->map_settings instanceof EE_Map_Config |
|
346 | - ? $this->map_settings |
|
347 | - : new EE_Map_Config(); |
|
348 | - $this->map_settings = apply_filters( |
|
349 | - 'FHEE__EE_Config___initialize_config__map_settings', |
|
350 | - $this->map_settings |
|
351 | - ); |
|
352 | - $this->environment = $this->environment instanceof EE_Environment_Config |
|
353 | - ? $this->environment |
|
354 | - : new EE_Environment_Config(); |
|
355 | - $this->environment = apply_filters( |
|
356 | - 'FHEE__EE_Config___initialize_config__environment', |
|
357 | - $this->environment |
|
358 | - ); |
|
359 | - $this->tax_settings = $this->tax_settings instanceof EE_Tax_Config |
|
360 | - ? $this->tax_settings |
|
361 | - : new EE_Tax_Config(); |
|
362 | - $this->tax_settings = apply_filters( |
|
363 | - 'FHEE__EE_Config___initialize_config__tax_settings', |
|
364 | - $this->tax_settings |
|
365 | - ); |
|
366 | - $this->messages = apply_filters('FHEE__EE_Config__initialize_config__messages', $this->messages); |
|
367 | - $this->messages = $this->messages instanceof EE_Messages_Config |
|
368 | - ? $this->messages |
|
369 | - : new EE_Messages_Config(); |
|
370 | - $this->gateway = $this->gateway instanceof EE_Gateway_Config |
|
371 | - ? $this->gateway |
|
372 | - : new EE_Gateway_Config(); |
|
373 | - $this->gateway = apply_filters('FHEE__EE_Config___initialize_config__gateway', $this->gateway); |
|
374 | - $this->legacy_shortcodes_manager = null; |
|
375 | - } |
|
376 | - |
|
377 | - |
|
378 | - /** |
|
379 | - * get_espresso_config |
|
380 | - * |
|
381 | - * @access public |
|
382 | - * @return array of espresso config stuff |
|
383 | - */ |
|
384 | - public function get_espresso_config() |
|
385 | - { |
|
386 | - // grab espresso configuration |
|
387 | - return apply_filters( |
|
388 | - 'FHEE__EE_Config__get_espresso_config__CFG', |
|
389 | - get_option(EE_Config::OPTION_NAME, array()) |
|
390 | - ); |
|
391 | - } |
|
392 | - |
|
393 | - |
|
394 | - /** |
|
395 | - * double_check_config_comparison |
|
396 | - * |
|
397 | - * @access public |
|
398 | - * @param string $option |
|
399 | - * @param $old_value |
|
400 | - * @param $value |
|
401 | - */ |
|
402 | - public function double_check_config_comparison($option = '', $old_value, $value) |
|
403 | - { |
|
404 | - // make sure we're checking the ee config |
|
405 | - if ($option === EE_Config::OPTION_NAME) { |
|
406 | - // run a loose comparison of the old value against the new value for type and properties, |
|
407 | - // but NOT exact instance like WP update_option does (ie: NOT type safe comparison) |
|
408 | - if ($value != $old_value) { |
|
409 | - // if they are NOT the same, then remove the hook, |
|
410 | - // which means the subsequent update results will be based solely on the update query results |
|
411 | - // the reason we do this is because, as stated above, |
|
412 | - // WP update_option performs an exact instance comparison (===) on any update values passed to it |
|
413 | - // this happens PRIOR to serialization and any subsequent update. |
|
414 | - // If values are found to match their previous old value, |
|
415 | - // then WP bails before performing any update. |
|
416 | - // Since we are passing the EE_Config object, it is comparing the EXACT instance of the saved version |
|
417 | - // it just pulled from the db, with the one being passed to it (which will not match). |
|
418 | - // HOWEVER, once the object is serialized and passed off to MySQL to update, |
|
419 | - // MySQL MAY ALSO NOT perform the update because |
|
420 | - // the string it sees in the db looks the same as the new one it has been passed!!! |
|
421 | - // This results in the query returning an "affected rows" value of ZERO, |
|
422 | - // which gets returned immediately by WP update_option and looks like an error. |
|
423 | - remove_action('update_option', array($this, 'check_config_updated')); |
|
424 | - } |
|
425 | - } |
|
426 | - } |
|
427 | - |
|
428 | - |
|
429 | - /** |
|
430 | - * update_espresso_config |
|
431 | - * |
|
432 | - * @access public |
|
433 | - */ |
|
434 | - protected function _reset_espresso_addon_config() |
|
435 | - { |
|
436 | - $this->_addon_option_names = array(); |
|
437 | - foreach ($this->addons as $addon_name => $addon_config_obj) { |
|
438 | - $addon_config_obj = maybe_unserialize($addon_config_obj); |
|
439 | - if ($addon_config_obj instanceof EE_Config_Base) { |
|
440 | - $this->update_config('addons', $addon_name, $addon_config_obj, false); |
|
441 | - } |
|
442 | - $this->addons->{$addon_name} = null; |
|
443 | - } |
|
444 | - } |
|
445 | - |
|
446 | - |
|
447 | - /** |
|
448 | - * update_espresso_config |
|
449 | - * |
|
450 | - * @access public |
|
451 | - * @param bool $add_success |
|
452 | - * @param bool $add_error |
|
453 | - * @return bool |
|
454 | - */ |
|
455 | - public function update_espresso_config($add_success = false, $add_error = true) |
|
456 | - { |
|
457 | - // don't allow config updates during WP heartbeats |
|
458 | - if (\EE_Registry::instance()->REQ->get('action', '') === 'heartbeat') { |
|
459 | - return false; |
|
460 | - } |
|
461 | - // commented out the following re: https://events.codebasehq.com/projects/event-espresso/tickets/8197 |
|
462 | - // $clone = clone( self::$_instance ); |
|
463 | - // self::$_instance = NULL; |
|
464 | - do_action('AHEE__EE_Config__update_espresso_config__begin', $this); |
|
465 | - $this->_reset_espresso_addon_config(); |
|
466 | - // hook into update_option because that happens AFTER the ( $value === $old_value ) conditional |
|
467 | - // but BEFORE the actual update occurs |
|
468 | - add_action('update_option', array($this, 'double_check_config_comparison'), 1, 3); |
|
469 | - // don't want to persist legacy_shortcodes_manager, but don't want to lose it either |
|
470 | - $legacy_shortcodes_manager = $this->legacy_shortcodes_manager; |
|
471 | - $this->legacy_shortcodes_manager = null; |
|
472 | - // now update "ee_config" |
|
473 | - $saved = update_option(EE_Config::OPTION_NAME, $this); |
|
474 | - $this->legacy_shortcodes_manager = $legacy_shortcodes_manager; |
|
475 | - EE_Config::log(EE_Config::OPTION_NAME); |
|
476 | - // if not saved... check if the hook we just added still exists; |
|
477 | - // if it does, it means one of two things: |
|
478 | - // that update_option bailed at the($value === $old_value) conditional, |
|
479 | - // or... |
|
480 | - // the db update query returned 0 rows affected |
|
481 | - // (probably because the data value was the same from it's perspective) |
|
482 | - // so the existence of the hook means that a negative result from update_option is NOT an error, |
|
483 | - // but just means no update occurred, so don't display an error to the user. |
|
484 | - // BUT... if update_option returns FALSE, AND the hook is missing, |
|
485 | - // then it means that something truly went wrong |
|
486 | - $saved = ! $saved ? has_action('update_option', array($this, 'double_check_config_comparison')) : $saved; |
|
487 | - // remove our action since we don't want it in the system anymore |
|
488 | - remove_action('update_option', array($this, 'double_check_config_comparison'), 1); |
|
489 | - do_action('AHEE__EE_Config__update_espresso_config__end', $this, $saved); |
|
490 | - // self::$_instance = $clone; |
|
491 | - // unset( $clone ); |
|
492 | - // if config remains the same or was updated successfully |
|
493 | - if ($saved) { |
|
494 | - if ($add_success) { |
|
495 | - EE_Error::add_success( |
|
496 | - __('The Event Espresso Configuration Settings have been successfully updated.', 'event_espresso'), |
|
497 | - __FILE__, |
|
498 | - __FUNCTION__, |
|
499 | - __LINE__ |
|
500 | - ); |
|
501 | - } |
|
502 | - return true; |
|
503 | - } else { |
|
504 | - if ($add_error) { |
|
505 | - EE_Error::add_error( |
|
506 | - __('The Event Espresso Configuration Settings were not updated.', 'event_espresso'), |
|
507 | - __FILE__, |
|
508 | - __FUNCTION__, |
|
509 | - __LINE__ |
|
510 | - ); |
|
511 | - } |
|
512 | - return false; |
|
513 | - } |
|
514 | - } |
|
515 | - |
|
516 | - |
|
517 | - /** |
|
518 | - * _verify_config_params |
|
519 | - * |
|
520 | - * @access private |
|
521 | - * @param string $section |
|
522 | - * @param string $name |
|
523 | - * @param string $config_class |
|
524 | - * @param EE_Config_Base $config_obj |
|
525 | - * @param array $tests_to_run |
|
526 | - * @param bool $display_errors |
|
527 | - * @return bool TRUE on success, FALSE on fail |
|
528 | - */ |
|
529 | - private function _verify_config_params( |
|
530 | - $section = '', |
|
531 | - $name = '', |
|
532 | - $config_class = '', |
|
533 | - $config_obj = null, |
|
534 | - $tests_to_run = array(1, 2, 3, 4, 5, 6, 7, 8), |
|
535 | - $display_errors = true |
|
536 | - ) { |
|
537 | - try { |
|
538 | - foreach ($tests_to_run as $test) { |
|
539 | - switch ($test) { |
|
540 | - // TEST #1 : check that section was set |
|
541 | - case 1: |
|
542 | - if (empty($section)) { |
|
543 | - if ($display_errors) { |
|
544 | - throw new EE_Error( |
|
545 | - sprintf( |
|
546 | - __( |
|
547 | - 'No configuration section has been provided while attempting to save "%s".', |
|
548 | - 'event_espresso' |
|
549 | - ), |
|
550 | - $config_class |
|
551 | - ) |
|
552 | - ); |
|
553 | - } |
|
554 | - return false; |
|
555 | - } |
|
556 | - break; |
|
557 | - // TEST #2 : check that settings section exists |
|
558 | - case 2: |
|
559 | - if (! isset($this->{$section})) { |
|
560 | - if ($display_errors) { |
|
561 | - throw new EE_Error( |
|
562 | - sprintf( |
|
563 | - __('The "%s" configuration section does not exist.', 'event_espresso'), |
|
564 | - $section |
|
565 | - ) |
|
566 | - ); |
|
567 | - } |
|
568 | - return false; |
|
569 | - } |
|
570 | - break; |
|
571 | - // TEST #3 : check that section is the proper format |
|
572 | - case 3: |
|
573 | - if (! ($this->{$section} instanceof EE_Config_Base || $this->{$section} instanceof stdClass) |
|
574 | - ) { |
|
575 | - if ($display_errors) { |
|
576 | - throw new EE_Error( |
|
577 | - sprintf( |
|
578 | - __( |
|
579 | - 'The "%s" configuration settings have not been formatted correctly.', |
|
580 | - 'event_espresso' |
|
581 | - ), |
|
582 | - $section |
|
583 | - ) |
|
584 | - ); |
|
585 | - } |
|
586 | - return false; |
|
587 | - } |
|
588 | - break; |
|
589 | - // TEST #4 : check that config section name has been set |
|
590 | - case 4: |
|
591 | - if (empty($name)) { |
|
592 | - if ($display_errors) { |
|
593 | - throw new EE_Error( |
|
594 | - __( |
|
595 | - 'No name has been provided for the specific configuration section.', |
|
596 | - 'event_espresso' |
|
597 | - ) |
|
598 | - ); |
|
599 | - } |
|
600 | - return false; |
|
601 | - } |
|
602 | - break; |
|
603 | - // TEST #5 : check that a config class name has been set |
|
604 | - case 5: |
|
605 | - if (empty($config_class)) { |
|
606 | - if ($display_errors) { |
|
607 | - throw new EE_Error( |
|
608 | - __( |
|
609 | - 'No class name has been provided for the specific configuration section.', |
|
610 | - 'event_espresso' |
|
611 | - ) |
|
612 | - ); |
|
613 | - } |
|
614 | - return false; |
|
615 | - } |
|
616 | - break; |
|
617 | - // TEST #6 : verify config class is accessible |
|
618 | - case 6: |
|
619 | - if (! class_exists($config_class)) { |
|
620 | - if ($display_errors) { |
|
621 | - throw new EE_Error( |
|
622 | - sprintf( |
|
623 | - __( |
|
624 | - 'The "%s" class does not exist. Please ensure that an autoloader has been set for it.', |
|
625 | - 'event_espresso' |
|
626 | - ), |
|
627 | - $config_class |
|
628 | - ) |
|
629 | - ); |
|
630 | - } |
|
631 | - return false; |
|
632 | - } |
|
633 | - break; |
|
634 | - // TEST #7 : check that config has even been set |
|
635 | - case 7: |
|
636 | - if (! isset($this->{$section}->{$name})) { |
|
637 | - if ($display_errors) { |
|
638 | - throw new EE_Error( |
|
639 | - sprintf( |
|
640 | - __('No configuration has been set for "%1$s->%2$s".', 'event_espresso'), |
|
641 | - $section, |
|
642 | - $name |
|
643 | - ) |
|
644 | - ); |
|
645 | - } |
|
646 | - return false; |
|
647 | - } else { |
|
648 | - // and make sure it's not serialized |
|
649 | - $this->{$section}->{$name} = maybe_unserialize($this->{$section}->{$name}); |
|
650 | - } |
|
651 | - break; |
|
652 | - // TEST #8 : check that config is the requested type |
|
653 | - case 8: |
|
654 | - if (! $this->{$section}->{$name} instanceof $config_class) { |
|
655 | - if ($display_errors) { |
|
656 | - throw new EE_Error( |
|
657 | - sprintf( |
|
658 | - __( |
|
659 | - 'The configuration for "%1$s->%2$s" is not of the "%3$s" class.', |
|
660 | - 'event_espresso' |
|
661 | - ), |
|
662 | - $section, |
|
663 | - $name, |
|
664 | - $config_class |
|
665 | - ) |
|
666 | - ); |
|
667 | - } |
|
668 | - return false; |
|
669 | - } |
|
670 | - break; |
|
671 | - // TEST #9 : verify config object |
|
672 | - case 9: |
|
673 | - if (! $config_obj instanceof EE_Config_Base) { |
|
674 | - if ($display_errors) { |
|
675 | - throw new EE_Error( |
|
676 | - sprintf( |
|
677 | - __('The "%s" class is not an instance of EE_Config_Base.', 'event_espresso'), |
|
678 | - print_r($config_obj, true) |
|
679 | - ) |
|
680 | - ); |
|
681 | - } |
|
682 | - return false; |
|
683 | - } |
|
684 | - break; |
|
685 | - } |
|
686 | - } |
|
687 | - } catch (EE_Error $e) { |
|
688 | - $e->get_error(); |
|
689 | - } |
|
690 | - // you have successfully run the gauntlet |
|
691 | - return true; |
|
692 | - } |
|
693 | - |
|
694 | - |
|
695 | - /** |
|
696 | - * _generate_config_option_name |
|
697 | - * |
|
698 | - * @access protected |
|
699 | - * @param string $section |
|
700 | - * @param string $name |
|
701 | - * @return string |
|
702 | - */ |
|
703 | - private function _generate_config_option_name($section = '', $name = '') |
|
704 | - { |
|
705 | - return 'ee_config-' . strtolower($section . '-' . str_replace(array('EE_', 'EED_'), '', $name)); |
|
706 | - } |
|
707 | - |
|
708 | - |
|
709 | - /** |
|
710 | - * _set_config_class |
|
711 | - * ensures that a config class is set, either from a passed config class or one generated from the config name |
|
712 | - * |
|
713 | - * @access private |
|
714 | - * @param string $config_class |
|
715 | - * @param string $name |
|
716 | - * @return string |
|
717 | - */ |
|
718 | - private function _set_config_class($config_class = '', $name = '') |
|
719 | - { |
|
720 | - return ! empty($config_class) |
|
721 | - ? $config_class |
|
722 | - : str_replace(' ', '_', ucwords(str_replace('_', ' ', $name))) . '_Config'; |
|
723 | - } |
|
724 | - |
|
725 | - |
|
726 | - /** |
|
727 | - * set_config |
|
728 | - * |
|
729 | - * @access protected |
|
730 | - * @param string $section |
|
731 | - * @param string $name |
|
732 | - * @param string $config_class |
|
733 | - * @param EE_Config_Base $config_obj |
|
734 | - * @return EE_Config_Base |
|
735 | - */ |
|
736 | - public function set_config($section = '', $name = '', $config_class = '', EE_Config_Base $config_obj = null) |
|
737 | - { |
|
738 | - // ensure config class is set to something |
|
739 | - $config_class = $this->_set_config_class($config_class, $name); |
|
740 | - // run tests 1-4, 6, and 7 to verify all config params are set and valid |
|
741 | - if (! $this->_verify_config_params($section, $name, $config_class, null, array(1, 2, 3, 4, 5, 6))) { |
|
742 | - return null; |
|
743 | - } |
|
744 | - $config_option_name = $this->_generate_config_option_name($section, $name); |
|
745 | - // if the config option name hasn't been added yet to the list of option names we're tracking, then do so now |
|
746 | - if (! isset($this->_addon_option_names[ $config_option_name ])) { |
|
747 | - $this->_addon_option_names[ $config_option_name ] = $config_class; |
|
748 | - $this->update_addon_option_names(); |
|
749 | - } |
|
750 | - // verify the incoming config object but suppress errors |
|
751 | - if (! $this->_verify_config_params($section, $name, $config_class, $config_obj, array(9), false)) { |
|
752 | - $config_obj = new $config_class(); |
|
753 | - } |
|
754 | - if (get_option($config_option_name)) { |
|
755 | - EE_Config::log($config_option_name); |
|
756 | - update_option($config_option_name, $config_obj); |
|
757 | - $this->{$section}->{$name} = $config_obj; |
|
758 | - return $this->{$section}->{$name}; |
|
759 | - } else { |
|
760 | - // create a wp-option for this config |
|
761 | - if (add_option($config_option_name, $config_obj, '', 'no')) { |
|
762 | - $this->{$section}->{$name} = maybe_unserialize($config_obj); |
|
763 | - return $this->{$section}->{$name}; |
|
764 | - } else { |
|
765 | - EE_Error::add_error( |
|
766 | - sprintf(__('The "%s" could not be saved to the database.', 'event_espresso'), $config_class), |
|
767 | - __FILE__, |
|
768 | - __FUNCTION__, |
|
769 | - __LINE__ |
|
770 | - ); |
|
771 | - return null; |
|
772 | - } |
|
773 | - } |
|
774 | - } |
|
775 | - |
|
776 | - |
|
777 | - /** |
|
778 | - * update_config |
|
779 | - * Important: the config object must ALREADY be set, otherwise this will produce an error. |
|
780 | - * |
|
781 | - * @access public |
|
782 | - * @param string $section |
|
783 | - * @param string $name |
|
784 | - * @param EE_Config_Base|string $config_obj |
|
785 | - * @param bool $throw_errors |
|
786 | - * @return bool |
|
787 | - */ |
|
788 | - public function update_config($section = '', $name = '', $config_obj = '', $throw_errors = true) |
|
789 | - { |
|
790 | - // don't allow config updates during WP heartbeats |
|
791 | - if (\EE_Registry::instance()->REQ->get('action', '') === 'heartbeat') { |
|
792 | - return false; |
|
793 | - } |
|
794 | - $config_obj = maybe_unserialize($config_obj); |
|
795 | - // get class name of the incoming object |
|
796 | - $config_class = get_class($config_obj); |
|
797 | - // run tests 1-5 and 9 to verify config |
|
798 | - if (! $this->_verify_config_params( |
|
799 | - $section, |
|
800 | - $name, |
|
801 | - $config_class, |
|
802 | - $config_obj, |
|
803 | - array(1, 2, 3, 4, 7, 9) |
|
804 | - ) |
|
805 | - ) { |
|
806 | - return false; |
|
807 | - } |
|
808 | - $config_option_name = $this->_generate_config_option_name($section, $name); |
|
809 | - // check if config object has been added to db by seeing if config option name is in $this->_addon_option_names array |
|
810 | - if (! isset($this->_addon_option_names[ $config_option_name ])) { |
|
811 | - // save new config to db |
|
812 | - if ($this->set_config($section, $name, $config_class, $config_obj)) { |
|
813 | - return true; |
|
814 | - } |
|
815 | - } else { |
|
816 | - // first check if the record already exists |
|
817 | - $existing_config = get_option($config_option_name); |
|
818 | - $config_obj = serialize($config_obj); |
|
819 | - // just return if db record is already up to date (NOT type safe comparison) |
|
820 | - if ($existing_config == $config_obj) { |
|
821 | - $this->{$section}->{$name} = $config_obj; |
|
822 | - return true; |
|
823 | - } elseif (update_option($config_option_name, $config_obj)) { |
|
824 | - EE_Config::log($config_option_name); |
|
825 | - // update wp-option for this config class |
|
826 | - $this->{$section}->{$name} = $config_obj; |
|
827 | - return true; |
|
828 | - } elseif ($throw_errors) { |
|
829 | - EE_Error::add_error( |
|
830 | - sprintf( |
|
831 | - __( |
|
832 | - 'The "%1$s" object stored at"%2$s" was not successfully updated in the database.', |
|
833 | - 'event_espresso' |
|
834 | - ), |
|
835 | - $config_class, |
|
836 | - 'EE_Config->' . $section . '->' . $name |
|
837 | - ), |
|
838 | - __FILE__, |
|
839 | - __FUNCTION__, |
|
840 | - __LINE__ |
|
841 | - ); |
|
842 | - } |
|
843 | - } |
|
844 | - return false; |
|
845 | - } |
|
846 | - |
|
847 | - |
|
848 | - /** |
|
849 | - * get_config |
|
850 | - * |
|
851 | - * @access public |
|
852 | - * @param string $section |
|
853 | - * @param string $name |
|
854 | - * @param string $config_class |
|
855 | - * @return mixed EE_Config_Base | NULL |
|
856 | - */ |
|
857 | - public function get_config($section = '', $name = '', $config_class = '') |
|
858 | - { |
|
859 | - // ensure config class is set to something |
|
860 | - $config_class = $this->_set_config_class($config_class, $name); |
|
861 | - // run tests 1-4, 6 and 7 to verify that all params have been set |
|
862 | - if (! $this->_verify_config_params($section, $name, $config_class, null, array(1, 2, 3, 4, 5, 6))) { |
|
863 | - return null; |
|
864 | - } |
|
865 | - // now test if the requested config object exists, but suppress errors |
|
866 | - if ($this->_verify_config_params($section, $name, $config_class, null, array(7, 8), false)) { |
|
867 | - // config already exists, so pass it back |
|
868 | - return $this->{$section}->{$name}; |
|
869 | - } |
|
870 | - // load config option from db if it exists |
|
871 | - $config_obj = $this->get_config_option($this->_generate_config_option_name($section, $name)); |
|
872 | - // verify the newly retrieved config object, but suppress errors |
|
873 | - if ($this->_verify_config_params($section, $name, $config_class, $config_obj, array(9), false)) { |
|
874 | - // config is good, so set it and pass it back |
|
875 | - $this->{$section}->{$name} = $config_obj; |
|
876 | - return $this->{$section}->{$name}; |
|
877 | - } |
|
878 | - // oops! $config_obj is not already set and does not exist in the db, so create a new one |
|
879 | - $config_obj = $this->set_config($section, $name, $config_class); |
|
880 | - // verify the newly created config object |
|
881 | - if ($this->_verify_config_params($section, $name, $config_class, $config_obj, array(9))) { |
|
882 | - return $this->{$section}->{$name}; |
|
883 | - } else { |
|
884 | - EE_Error::add_error( |
|
885 | - sprintf(__('The "%s" could not be retrieved from the database.', 'event_espresso'), $config_class), |
|
886 | - __FILE__, |
|
887 | - __FUNCTION__, |
|
888 | - __LINE__ |
|
889 | - ); |
|
890 | - } |
|
891 | - return null; |
|
892 | - } |
|
893 | - |
|
894 | - |
|
895 | - /** |
|
896 | - * get_config_option |
|
897 | - * |
|
898 | - * @access public |
|
899 | - * @param string $config_option_name |
|
900 | - * @return mixed EE_Config_Base | FALSE |
|
901 | - */ |
|
902 | - public function get_config_option($config_option_name = '') |
|
903 | - { |
|
904 | - // retrieve the wp-option for this config class. |
|
905 | - $config_option = maybe_unserialize(get_option($config_option_name, array())); |
|
906 | - if (empty($config_option)) { |
|
907 | - EE_Config::log($config_option_name . '-NOT-FOUND'); |
|
908 | - } |
|
909 | - return $config_option; |
|
910 | - } |
|
911 | - |
|
912 | - |
|
913 | - /** |
|
914 | - * log |
|
915 | - * |
|
916 | - * @param string $config_option_name |
|
917 | - */ |
|
918 | - public static function log($config_option_name = '') |
|
919 | - { |
|
920 | - if (EE_Config::logging_enabled() && ! empty($config_option_name)) { |
|
921 | - $config_log = get_option(EE_Config::LOG_NAME, array()); |
|
922 | - // copy incoming $_REQUEST and sanitize it so we can save it |
|
923 | - $_request = $_REQUEST; |
|
924 | - array_walk_recursive($_request, 'sanitize_text_field'); |
|
925 | - $config_log[ (string) microtime(true) ] = array( |
|
926 | - 'config_name' => $config_option_name, |
|
927 | - 'request' => $_request, |
|
928 | - ); |
|
929 | - update_option(EE_Config::LOG_NAME, $config_log); |
|
930 | - } |
|
931 | - } |
|
932 | - |
|
933 | - |
|
934 | - /** |
|
935 | - * trim_log |
|
936 | - * reduces the size of the config log to the length specified by EE_Config::LOG_LENGTH |
|
937 | - */ |
|
938 | - public static function trim_log() |
|
939 | - { |
|
940 | - if (! EE_Config::logging_enabled()) { |
|
941 | - return; |
|
942 | - } |
|
943 | - $config_log = maybe_unserialize(get_option(EE_Config::LOG_NAME, array())); |
|
944 | - $log_length = count($config_log); |
|
945 | - if ($log_length > EE_Config::LOG_LENGTH) { |
|
946 | - ksort($config_log); |
|
947 | - $config_log = array_slice($config_log, $log_length - EE_Config::LOG_LENGTH, null, true); |
|
948 | - update_option(EE_Config::LOG_NAME, $config_log); |
|
949 | - } |
|
950 | - } |
|
951 | - |
|
952 | - |
|
953 | - /** |
|
954 | - * get_page_for_posts |
|
955 | - * if the wp-option "show_on_front" is set to "page", then this is the post_name for the post set in the |
|
956 | - * wp-option "page_for_posts", or "posts" if no page is selected |
|
957 | - * |
|
958 | - * @access public |
|
959 | - * @return string |
|
960 | - */ |
|
961 | - public static function get_page_for_posts() |
|
962 | - { |
|
963 | - $page_for_posts = get_option('page_for_posts'); |
|
964 | - if (! $page_for_posts) { |
|
965 | - return 'posts'; |
|
966 | - } |
|
967 | - /** @type WPDB $wpdb */ |
|
968 | - global $wpdb; |
|
969 | - $SQL = "SELECT post_name from $wpdb->posts WHERE post_type='posts' OR post_type='page' AND post_status='publish' AND ID=%d"; |
|
970 | - return $wpdb->get_var($wpdb->prepare($SQL, $page_for_posts)); |
|
971 | - } |
|
972 | - |
|
973 | - |
|
974 | - /** |
|
975 | - * register_shortcodes_and_modules. |
|
976 | - * At this point, it's too early to tell if we're maintenance mode or not. |
|
977 | - * In fact, this is where we give modules a chance to let core know they exist |
|
978 | - * so they can help trigger maintenance mode if it's needed |
|
979 | - * |
|
980 | - * @access public |
|
981 | - * @return void |
|
982 | - */ |
|
983 | - public function register_shortcodes_and_modules() |
|
984 | - { |
|
985 | - // allow modules to set hooks for the rest of the system |
|
986 | - EE_Registry::instance()->modules = $this->_register_modules(); |
|
987 | - } |
|
988 | - |
|
989 | - |
|
990 | - /** |
|
991 | - * initialize_shortcodes_and_modules |
|
992 | - * meaning they can start adding their hooks to get stuff done |
|
993 | - * |
|
994 | - * @access public |
|
995 | - * @return void |
|
996 | - */ |
|
997 | - public function initialize_shortcodes_and_modules() |
|
998 | - { |
|
999 | - // allow modules to set hooks for the rest of the system |
|
1000 | - $this->_initialize_modules(); |
|
1001 | - } |
|
1002 | - |
|
1003 | - |
|
1004 | - /** |
|
1005 | - * widgets_init |
|
1006 | - * |
|
1007 | - * @access private |
|
1008 | - * @return void |
|
1009 | - */ |
|
1010 | - public function widgets_init() |
|
1011 | - { |
|
1012 | - // only init widgets on admin pages when not in complete maintenance, and |
|
1013 | - // on frontend when not in any maintenance mode |
|
1014 | - if (! EE_Maintenance_Mode::instance()->level() |
|
1015 | - || ( |
|
1016 | - is_admin() |
|
1017 | - && EE_Maintenance_Mode::instance()->level() !== EE_Maintenance_Mode::level_2_complete_maintenance |
|
1018 | - ) |
|
1019 | - ) { |
|
1020 | - // grab list of installed widgets |
|
1021 | - $widgets_to_register = glob(EE_WIDGETS . '*', GLOB_ONLYDIR); |
|
1022 | - // filter list of modules to register |
|
1023 | - $widgets_to_register = apply_filters( |
|
1024 | - 'FHEE__EE_Config__register_widgets__widgets_to_register', |
|
1025 | - $widgets_to_register |
|
1026 | - ); |
|
1027 | - if (! empty($widgets_to_register)) { |
|
1028 | - // cycle thru widget folders |
|
1029 | - foreach ($widgets_to_register as $widget_path) { |
|
1030 | - // add to list of installed widget modules |
|
1031 | - EE_Config::register_ee_widget($widget_path); |
|
1032 | - } |
|
1033 | - } |
|
1034 | - // filter list of installed modules |
|
1035 | - EE_Registry::instance()->widgets = apply_filters( |
|
1036 | - 'FHEE__EE_Config__register_widgets__installed_widgets', |
|
1037 | - EE_Registry::instance()->widgets |
|
1038 | - ); |
|
1039 | - } |
|
1040 | - } |
|
1041 | - |
|
1042 | - |
|
1043 | - /** |
|
1044 | - * register_ee_widget - makes core aware of this widget |
|
1045 | - * |
|
1046 | - * @access public |
|
1047 | - * @param string $widget_path - full path up to and including widget folder |
|
1048 | - * @return void |
|
1049 | - */ |
|
1050 | - public static function register_ee_widget($widget_path = null) |
|
1051 | - { |
|
1052 | - do_action('AHEE__EE_Config__register_widget__begin', $widget_path); |
|
1053 | - $widget_ext = '.widget.php'; |
|
1054 | - // make all separators match |
|
1055 | - $widget_path = rtrim(str_replace('\\', DS, $widget_path), DS); |
|
1056 | - // does the file path INCLUDE the actual file name as part of the path ? |
|
1057 | - if (strpos($widget_path, $widget_ext) !== false) { |
|
1058 | - // grab and shortcode file name from directory name and break apart at dots |
|
1059 | - $file_name = explode('.', basename($widget_path)); |
|
1060 | - // take first segment from file name pieces and remove class prefix if it exists |
|
1061 | - $widget = strpos($file_name[0], 'EEW_') === 0 ? substr($file_name[0], 4) : $file_name[0]; |
|
1062 | - // sanitize shortcode directory name |
|
1063 | - $widget = sanitize_key($widget); |
|
1064 | - // now we need to rebuild the shortcode path |
|
1065 | - $widget_path = explode(DS, $widget_path); |
|
1066 | - // remove last segment |
|
1067 | - array_pop($widget_path); |
|
1068 | - // glue it back together |
|
1069 | - $widget_path = implode(DS, $widget_path); |
|
1070 | - } else { |
|
1071 | - // grab and sanitize widget directory name |
|
1072 | - $widget = sanitize_key(basename($widget_path)); |
|
1073 | - } |
|
1074 | - // create classname from widget directory name |
|
1075 | - $widget = str_replace(' ', '_', ucwords(str_replace('_', ' ', $widget))); |
|
1076 | - // add class prefix |
|
1077 | - $widget_class = 'EEW_' . $widget; |
|
1078 | - // does the widget exist ? |
|
1079 | - if (! is_readable($widget_path . DS . $widget_class . $widget_ext)) { |
|
1080 | - $msg = sprintf( |
|
1081 | - __( |
|
1082 | - 'The requested %s widget file could not be found or is not readable due to file permissions. Please ensure the following path is correct: %s', |
|
1083 | - 'event_espresso' |
|
1084 | - ), |
|
1085 | - $widget_class, |
|
1086 | - $widget_path . DS . $widget_class . $widget_ext |
|
1087 | - ); |
|
1088 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1089 | - return; |
|
1090 | - } |
|
1091 | - // load the widget class file |
|
1092 | - require_once($widget_path . DS . $widget_class . $widget_ext); |
|
1093 | - // verify that class exists |
|
1094 | - if (! class_exists($widget_class)) { |
|
1095 | - $msg = sprintf(__('The requested %s widget class does not exist.', 'event_espresso'), $widget_class); |
|
1096 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1097 | - return; |
|
1098 | - } |
|
1099 | - register_widget($widget_class); |
|
1100 | - // add to array of registered widgets |
|
1101 | - EE_Registry::instance()->widgets->{$widget_class} = $widget_path . DS . $widget_class . $widget_ext; |
|
1102 | - } |
|
1103 | - |
|
1104 | - |
|
1105 | - /** |
|
1106 | - * _register_modules |
|
1107 | - * |
|
1108 | - * @access private |
|
1109 | - * @return array |
|
1110 | - */ |
|
1111 | - private function _register_modules() |
|
1112 | - { |
|
1113 | - // grab list of installed modules |
|
1114 | - $modules_to_register = glob(EE_MODULES . '*', GLOB_ONLYDIR); |
|
1115 | - // filter list of modules to register |
|
1116 | - $modules_to_register = apply_filters( |
|
1117 | - 'FHEE__EE_Config__register_modules__modules_to_register', |
|
1118 | - $modules_to_register |
|
1119 | - ); |
|
1120 | - if (! empty($modules_to_register)) { |
|
1121 | - // loop through folders |
|
1122 | - foreach ($modules_to_register as $module_path) { |
|
1123 | - /**TEMPORARILY EXCLUDE gateways from modules for time being**/ |
|
1124 | - if ($module_path !== EE_MODULES . 'zzz-copy-this-module-template' |
|
1125 | - && $module_path !== EE_MODULES . 'gateways' |
|
1126 | - ) { |
|
1127 | - // add to list of installed modules |
|
1128 | - EE_Config::register_module($module_path); |
|
1129 | - } |
|
1130 | - } |
|
1131 | - } |
|
1132 | - // filter list of installed modules |
|
1133 | - return apply_filters( |
|
1134 | - 'FHEE__EE_Config___register_modules__installed_modules', |
|
1135 | - EE_Registry::instance()->modules |
|
1136 | - ); |
|
1137 | - } |
|
1138 | - |
|
1139 | - |
|
1140 | - /** |
|
1141 | - * register_module - makes core aware of this module |
|
1142 | - * |
|
1143 | - * @access public |
|
1144 | - * @param string $module_path - full path up to and including module folder |
|
1145 | - * @return bool |
|
1146 | - */ |
|
1147 | - public static function register_module($module_path = null) |
|
1148 | - { |
|
1149 | - do_action('AHEE__EE_Config__register_module__begin', $module_path); |
|
1150 | - $module_ext = '.module.php'; |
|
1151 | - // make all separators match |
|
1152 | - $module_path = str_replace(array('\\', '/'), DS, $module_path); |
|
1153 | - // does the file path INCLUDE the actual file name as part of the path ? |
|
1154 | - if (strpos($module_path, $module_ext) !== false) { |
|
1155 | - // grab and shortcode file name from directory name and break apart at dots |
|
1156 | - $module_file = explode('.', basename($module_path)); |
|
1157 | - // now we need to rebuild the shortcode path |
|
1158 | - $module_path = explode(DS, $module_path); |
|
1159 | - // remove last segment |
|
1160 | - array_pop($module_path); |
|
1161 | - // glue it back together |
|
1162 | - $module_path = implode(DS, $module_path) . DS; |
|
1163 | - // take first segment from file name pieces and sanitize it |
|
1164 | - $module = preg_replace('/[^a-zA-Z0-9_\-]/', '', $module_file[0]); |
|
1165 | - // ensure class prefix is added |
|
1166 | - $module_class = strpos($module, 'EED_') !== 0 ? 'EED_' . $module : $module; |
|
1167 | - } else { |
|
1168 | - // we need to generate the filename based off of the folder name |
|
1169 | - // grab and sanitize module name |
|
1170 | - $module = strtolower(basename($module_path)); |
|
1171 | - $module = preg_replace('/[^a-z0-9_\-]/', '', $module); |
|
1172 | - // like trailingslashit() |
|
1173 | - $module_path = rtrim($module_path, DS) . DS; |
|
1174 | - // create classname from module directory name |
|
1175 | - $module = str_replace(' ', '_', ucwords(str_replace('_', ' ', $module))); |
|
1176 | - // add class prefix |
|
1177 | - $module_class = 'EED_' . $module; |
|
1178 | - } |
|
1179 | - // does the module exist ? |
|
1180 | - if (! is_readable($module_path . DS . $module_class . $module_ext)) { |
|
1181 | - $msg = sprintf( |
|
1182 | - __( |
|
1183 | - 'The requested %s module file could not be found or is not readable due to file permissions.', |
|
1184 | - 'event_espresso' |
|
1185 | - ), |
|
1186 | - $module |
|
1187 | - ); |
|
1188 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1189 | - return false; |
|
1190 | - } |
|
1191 | - // load the module class file |
|
1192 | - require_once($module_path . $module_class . $module_ext); |
|
1193 | - // verify that class exists |
|
1194 | - if (! class_exists($module_class)) { |
|
1195 | - $msg = sprintf(__('The requested %s module class does not exist.', 'event_espresso'), $module_class); |
|
1196 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1197 | - return false; |
|
1198 | - } |
|
1199 | - // add to array of registered modules |
|
1200 | - EE_Registry::instance()->modules->{$module_class} = $module_path . $module_class . $module_ext; |
|
1201 | - do_action( |
|
1202 | - 'AHEE__EE_Config__register_module__complete', |
|
1203 | - $module_class, |
|
1204 | - EE_Registry::instance()->modules->{$module_class} |
|
1205 | - ); |
|
1206 | - return true; |
|
1207 | - } |
|
1208 | - |
|
1209 | - |
|
1210 | - /** |
|
1211 | - * _initialize_modules |
|
1212 | - * allow modules to set hooks for the rest of the system |
|
1213 | - * |
|
1214 | - * @access private |
|
1215 | - * @return void |
|
1216 | - */ |
|
1217 | - private function _initialize_modules() |
|
1218 | - { |
|
1219 | - // cycle thru shortcode folders |
|
1220 | - foreach (EE_Registry::instance()->modules as $module_class => $module_path) { |
|
1221 | - // fire the shortcode class's set_hooks methods in case it needs to hook into other parts of the system |
|
1222 | - // which set hooks ? |
|
1223 | - if (is_admin()) { |
|
1224 | - // fire immediately |
|
1225 | - call_user_func(array($module_class, 'set_hooks_admin')); |
|
1226 | - } else { |
|
1227 | - // delay until other systems are online |
|
1228 | - add_action( |
|
1229 | - 'AHEE__EE_System__set_hooks_for_shortcodes_modules_and_addons', |
|
1230 | - array($module_class, 'set_hooks') |
|
1231 | - ); |
|
1232 | - } |
|
1233 | - } |
|
1234 | - } |
|
1235 | - |
|
1236 | - |
|
1237 | - /** |
|
1238 | - * register_route - adds module method routes to route_map |
|
1239 | - * |
|
1240 | - * @access public |
|
1241 | - * @param string $route - "pretty" public alias for module method |
|
1242 | - * @param string $module - module name (classname without EED_ prefix) |
|
1243 | - * @param string $method_name - the actual module method to be routed to |
|
1244 | - * @param string $key - url param key indicating a route is being called |
|
1245 | - * @return bool |
|
1246 | - */ |
|
1247 | - public static function register_route($route = null, $module = null, $method_name = null, $key = 'ee') |
|
1248 | - { |
|
1249 | - do_action('AHEE__EE_Config__register_route__begin', $route, $module, $method_name); |
|
1250 | - $module = str_replace('EED_', '', $module); |
|
1251 | - $module_class = 'EED_' . $module; |
|
1252 | - if (! isset(EE_Registry::instance()->modules->{$module_class})) { |
|
1253 | - $msg = sprintf(__('The module %s has not been registered.', 'event_espresso'), $module); |
|
1254 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1255 | - return false; |
|
1256 | - } |
|
1257 | - if (empty($route)) { |
|
1258 | - $msg = sprintf(__('No route has been supplied.', 'event_espresso'), $route); |
|
1259 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1260 | - return false; |
|
1261 | - } |
|
1262 | - if (! method_exists('EED_' . $module, $method_name)) { |
|
1263 | - $msg = sprintf( |
|
1264 | - __('A valid class method for the %s route has not been supplied.', 'event_espresso'), |
|
1265 | - $route |
|
1266 | - ); |
|
1267 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1268 | - return false; |
|
1269 | - } |
|
1270 | - EE_Config::$_module_route_map[ (string) $key ][ (string) $route ] = array('EED_' . $module, $method_name); |
|
1271 | - return true; |
|
1272 | - } |
|
1273 | - |
|
1274 | - |
|
1275 | - /** |
|
1276 | - * get_route - get module method route |
|
1277 | - * |
|
1278 | - * @access public |
|
1279 | - * @param string $route - "pretty" public alias for module method |
|
1280 | - * @param string $key - url param key indicating a route is being called |
|
1281 | - * @return string |
|
1282 | - */ |
|
1283 | - public static function get_route($route = null, $key = 'ee') |
|
1284 | - { |
|
1285 | - do_action('AHEE__EE_Config__get_route__begin', $route); |
|
1286 | - $route = (string) apply_filters('FHEE__EE_Config__get_route', $route); |
|
1287 | - if (isset(EE_Config::$_module_route_map[ $key ][ $route ])) { |
|
1288 | - return EE_Config::$_module_route_map[ $key ][ $route ]; |
|
1289 | - } |
|
1290 | - return null; |
|
1291 | - } |
|
1292 | - |
|
1293 | - |
|
1294 | - /** |
|
1295 | - * get_routes - get ALL module method routes |
|
1296 | - * |
|
1297 | - * @access public |
|
1298 | - * @return array |
|
1299 | - */ |
|
1300 | - public static function get_routes() |
|
1301 | - { |
|
1302 | - return EE_Config::$_module_route_map; |
|
1303 | - } |
|
1304 | - |
|
1305 | - |
|
1306 | - /** |
|
1307 | - * register_forward - allows modules to forward request to another module for further processing |
|
1308 | - * |
|
1309 | - * @access public |
|
1310 | - * @param string $route - "pretty" public alias for module method |
|
1311 | - * @param integer $status - integer value corresponding to status constant strings set in module parent |
|
1312 | - * class, allows different forwards to be served based on status |
|
1313 | - * @param array|string $forward - function name or array( class, method ) |
|
1314 | - * @param string $key - url param key indicating a route is being called |
|
1315 | - * @return bool |
|
1316 | - */ |
|
1317 | - public static function register_forward($route = null, $status = 0, $forward = null, $key = 'ee') |
|
1318 | - { |
|
1319 | - do_action('AHEE__EE_Config__register_forward', $route, $status, $forward); |
|
1320 | - if (! isset(EE_Config::$_module_route_map[ $key ][ $route ]) || empty($route)) { |
|
1321 | - $msg = sprintf( |
|
1322 | - __('The module route %s for this forward has not been registered.', 'event_espresso'), |
|
1323 | - $route |
|
1324 | - ); |
|
1325 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1326 | - return false; |
|
1327 | - } |
|
1328 | - if (empty($forward)) { |
|
1329 | - $msg = sprintf(__('No forwarding route has been supplied.', 'event_espresso'), $route); |
|
1330 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1331 | - return false; |
|
1332 | - } |
|
1333 | - if (is_array($forward)) { |
|
1334 | - if (! isset($forward[1])) { |
|
1335 | - $msg = sprintf( |
|
1336 | - __('A class method for the %s forwarding route has not been supplied.', 'event_espresso'), |
|
1337 | - $route |
|
1338 | - ); |
|
1339 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1340 | - return false; |
|
1341 | - } |
|
1342 | - if (! method_exists($forward[0], $forward[1])) { |
|
1343 | - $msg = sprintf( |
|
1344 | - __('The class method %s for the %s forwarding route is in invalid.', 'event_espresso'), |
|
1345 | - $forward[1], |
|
1346 | - $route |
|
1347 | - ); |
|
1348 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1349 | - return false; |
|
1350 | - } |
|
1351 | - } elseif (! function_exists($forward)) { |
|
1352 | - $msg = sprintf( |
|
1353 | - __('The function %s for the %s forwarding route is in invalid.', 'event_espresso'), |
|
1354 | - $forward, |
|
1355 | - $route |
|
1356 | - ); |
|
1357 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1358 | - return false; |
|
1359 | - } |
|
1360 | - EE_Config::$_module_forward_map[ $key ][ $route ][ absint($status) ] = $forward; |
|
1361 | - return true; |
|
1362 | - } |
|
1363 | - |
|
1364 | - |
|
1365 | - /** |
|
1366 | - * get_forward - get forwarding route |
|
1367 | - * |
|
1368 | - * @access public |
|
1369 | - * @param string $route - "pretty" public alias for module method |
|
1370 | - * @param integer $status - integer value corresponding to status constant strings set in module parent class, |
|
1371 | - * allows different forwards to be served based on status |
|
1372 | - * @param string $key - url param key indicating a route is being called |
|
1373 | - * @return string |
|
1374 | - */ |
|
1375 | - public static function get_forward($route = null, $status = 0, $key = 'ee') |
|
1376 | - { |
|
1377 | - do_action('AHEE__EE_Config__get_forward__begin', $route, $status); |
|
1378 | - if (isset(EE_Config::$_module_forward_map[ $key ][ $route ][ $status ])) { |
|
1379 | - return apply_filters( |
|
1380 | - 'FHEE__EE_Config__get_forward', |
|
1381 | - EE_Config::$_module_forward_map[ $key ][ $route ][ $status ], |
|
1382 | - $route, |
|
1383 | - $status |
|
1384 | - ); |
|
1385 | - } |
|
1386 | - return null; |
|
1387 | - } |
|
1388 | - |
|
1389 | - |
|
1390 | - /** |
|
1391 | - * register_forward - allows modules to specify different view templates for different method routes and status |
|
1392 | - * results |
|
1393 | - * |
|
1394 | - * @access public |
|
1395 | - * @param string $route - "pretty" public alias for module method |
|
1396 | - * @param integer $status - integer value corresponding to status constant strings set in module parent class, |
|
1397 | - * allows different views to be served based on status |
|
1398 | - * @param string $view |
|
1399 | - * @param string $key - url param key indicating a route is being called |
|
1400 | - * @return bool |
|
1401 | - */ |
|
1402 | - public static function register_view($route = null, $status = 0, $view = null, $key = 'ee') |
|
1403 | - { |
|
1404 | - do_action('AHEE__EE_Config__register_view__begin', $route, $status, $view); |
|
1405 | - if (! isset(EE_Config::$_module_route_map[ $key ][ $route ]) || empty($route)) { |
|
1406 | - $msg = sprintf( |
|
1407 | - __('The module route %s for this view has not been registered.', 'event_espresso'), |
|
1408 | - $route |
|
1409 | - ); |
|
1410 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1411 | - return false; |
|
1412 | - } |
|
1413 | - if (! is_readable($view)) { |
|
1414 | - $msg = sprintf( |
|
1415 | - __( |
|
1416 | - 'The %s view file could not be found or is not readable due to file permissions.', |
|
1417 | - 'event_espresso' |
|
1418 | - ), |
|
1419 | - $view |
|
1420 | - ); |
|
1421 | - EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1422 | - return false; |
|
1423 | - } |
|
1424 | - EE_Config::$_module_view_map[ $key ][ $route ][ absint($status) ] = $view; |
|
1425 | - return true; |
|
1426 | - } |
|
1427 | - |
|
1428 | - |
|
1429 | - /** |
|
1430 | - * get_view - get view for route and status |
|
1431 | - * |
|
1432 | - * @access public |
|
1433 | - * @param string $route - "pretty" public alias for module method |
|
1434 | - * @param integer $status - integer value corresponding to status constant strings set in module parent class, |
|
1435 | - * allows different views to be served based on status |
|
1436 | - * @param string $key - url param key indicating a route is being called |
|
1437 | - * @return string |
|
1438 | - */ |
|
1439 | - public static function get_view($route = null, $status = 0, $key = 'ee') |
|
1440 | - { |
|
1441 | - do_action('AHEE__EE_Config__get_view__begin', $route, $status); |
|
1442 | - if (isset(EE_Config::$_module_view_map[ $key ][ $route ][ $status ])) { |
|
1443 | - return apply_filters( |
|
1444 | - 'FHEE__EE_Config__get_view', |
|
1445 | - EE_Config::$_module_view_map[ $key ][ $route ][ $status ], |
|
1446 | - $route, |
|
1447 | - $status |
|
1448 | - ); |
|
1449 | - } |
|
1450 | - return null; |
|
1451 | - } |
|
1452 | - |
|
1453 | - |
|
1454 | - public function update_addon_option_names() |
|
1455 | - { |
|
1456 | - update_option(EE_Config::ADDON_OPTION_NAMES, $this->_addon_option_names); |
|
1457 | - } |
|
1458 | - |
|
1459 | - |
|
1460 | - public function shutdown() |
|
1461 | - { |
|
1462 | - $this->update_addon_option_names(); |
|
1463 | - } |
|
1464 | - |
|
1465 | - |
|
1466 | - /** |
|
1467 | - * @return LegacyShortcodesManager |
|
1468 | - */ |
|
1469 | - public static function getLegacyShortcodesManager() |
|
1470 | - { |
|
1471 | - |
|
1472 | - if (! EE_Config::instance()->legacy_shortcodes_manager instanceof LegacyShortcodesManager) { |
|
1473 | - EE_Config::instance()->legacy_shortcodes_manager = new LegacyShortcodesManager( |
|
1474 | - EE_Registry::instance() |
|
1475 | - ); |
|
1476 | - } |
|
1477 | - return EE_Config::instance()->legacy_shortcodes_manager; |
|
1478 | - } |
|
1479 | - |
|
1480 | - |
|
1481 | - /** |
|
1482 | - * register_shortcode - makes core aware of this shortcode |
|
1483 | - * |
|
1484 | - * @deprecated 4.9.26 |
|
1485 | - * @param string $shortcode_path - full path up to and including shortcode folder |
|
1486 | - * @return bool |
|
1487 | - */ |
|
1488 | - public static function register_shortcode($shortcode_path = null) |
|
1489 | - { |
|
1490 | - EE_Error::doing_it_wrong( |
|
1491 | - __METHOD__, |
|
1492 | - __( |
|
1493 | - 'Usage is deprecated. Use \EventEspresso\core\services\shortcodes\LegacyShortcodesManager::registerShortcode() as direct replacement, or better yet, please see the new \EventEspresso\core\services\shortcodes\ShortcodesManager class.', |
|
1494 | - 'event_espresso' |
|
1495 | - ), |
|
1496 | - '4.9.26' |
|
1497 | - ); |
|
1498 | - return EE_Config::instance()->getLegacyShortcodesManager()->registerShortcode($shortcode_path); |
|
1499 | - } |
|
1500 | -} |
|
1501 | - |
|
1502 | -/** |
|
1503 | - * Base class used for config classes. These classes should generally not have |
|
1504 | - * magic functions in use, except we'll allow them to magically set and get stuff... |
|
1505 | - * basically, they should just be well-defined stdClasses |
|
1506 | - */ |
|
1507 | -class EE_Config_Base |
|
1508 | -{ |
|
1509 | - |
|
1510 | - /** |
|
1511 | - * Utility function for escaping the value of a property and returning. |
|
1512 | - * |
|
1513 | - * @param string $property property name (checks to see if exists). |
|
1514 | - * @return mixed if a detected type found return the escaped value, otherwise just the raw value is returned. |
|
1515 | - * @throws \EE_Error |
|
1516 | - */ |
|
1517 | - public function get_pretty($property) |
|
1518 | - { |
|
1519 | - if (! property_exists($this, $property)) { |
|
1520 | - throw new EE_Error( |
|
1521 | - sprintf( |
|
1522 | - __( |
|
1523 | - '%1$s::get_pretty() has been called with the property %2$s which does not exist on the %1$s config class.', |
|
1524 | - 'event_espresso' |
|
1525 | - ), |
|
1526 | - get_class($this), |
|
1527 | - $property |
|
1528 | - ) |
|
1529 | - ); |
|
1530 | - } |
|
1531 | - // just handling escaping of strings for now. |
|
1532 | - if (is_string($this->{$property})) { |
|
1533 | - return stripslashes($this->{$property}); |
|
1534 | - } |
|
1535 | - return $this->{$property}; |
|
1536 | - } |
|
1537 | - |
|
1538 | - |
|
1539 | - public function populate() |
|
1540 | - { |
|
1541 | - // grab defaults via a new instance of this class. |
|
1542 | - $class_name = get_class($this); |
|
1543 | - $defaults = new $class_name; |
|
1544 | - // loop through the properties for this class and see if they are set. If they are NOT, then grab the |
|
1545 | - // default from our $defaults object. |
|
1546 | - foreach (get_object_vars($defaults) as $property => $value) { |
|
1547 | - if ($this->{$property} === null) { |
|
1548 | - $this->{$property} = $value; |
|
1549 | - } |
|
1550 | - } |
|
1551 | - // cleanup |
|
1552 | - unset($defaults); |
|
1553 | - } |
|
1554 | - |
|
1555 | - |
|
1556 | - /** |
|
1557 | - * __isset |
|
1558 | - * |
|
1559 | - * @param $a |
|
1560 | - * @return bool |
|
1561 | - */ |
|
1562 | - public function __isset($a) |
|
1563 | - { |
|
1564 | - return false; |
|
1565 | - } |
|
1566 | - |
|
1567 | - |
|
1568 | - /** |
|
1569 | - * __unset |
|
1570 | - * |
|
1571 | - * @param $a |
|
1572 | - * @return bool |
|
1573 | - */ |
|
1574 | - public function __unset($a) |
|
1575 | - { |
|
1576 | - return false; |
|
1577 | - } |
|
1578 | - |
|
1579 | - |
|
1580 | - /** |
|
1581 | - * __clone |
|
1582 | - */ |
|
1583 | - public function __clone() |
|
1584 | - { |
|
1585 | - } |
|
1586 | - |
|
1587 | - |
|
1588 | - /** |
|
1589 | - * __wakeup |
|
1590 | - */ |
|
1591 | - public function __wakeup() |
|
1592 | - { |
|
1593 | - } |
|
1594 | - |
|
1595 | - |
|
1596 | - /** |
|
1597 | - * __destruct |
|
1598 | - */ |
|
1599 | - public function __destruct() |
|
1600 | - { |
|
1601 | - } |
|
1602 | -} |
|
1603 | - |
|
1604 | -/** |
|
1605 | - * Class for defining what's in the EE_Config relating to registration settings |
|
1606 | - */ |
|
1607 | -class EE_Core_Config extends EE_Config_Base |
|
1608 | -{ |
|
1609 | - |
|
1610 | - const OPTION_NAME_UXIP = 'ee_ueip_optin'; |
|
1611 | - |
|
1612 | - |
|
1613 | - public $current_blog_id; |
|
1614 | - |
|
1615 | - public $ee_ueip_optin; |
|
1616 | - |
|
1617 | - public $ee_ueip_has_notified; |
|
1618 | - |
|
1619 | - /** |
|
1620 | - * Not to be confused with the 4 critical page variables (See |
|
1621 | - * get_critical_pages_array()), this is just an array of wp posts that have EE |
|
1622 | - * shortcodes in them. Keys are slugs, values are arrays with only 1 element: where the key is the shortcode |
|
1623 | - * in the page, and the value is the page's ID. The key 'posts' is basically a duplicate of this same array. |
|
1624 | - * |
|
1625 | - * @var array |
|
1626 | - */ |
|
1627 | - public $post_shortcodes; |
|
1628 | - |
|
1629 | - public $module_route_map; |
|
1630 | - |
|
1631 | - public $module_forward_map; |
|
1632 | - |
|
1633 | - public $module_view_map; |
|
1634 | - |
|
1635 | - /** |
|
1636 | - * The next 4 vars are the IDs of critical EE pages. |
|
1637 | - * |
|
1638 | - * @var int |
|
1639 | - */ |
|
1640 | - public $reg_page_id; |
|
1641 | - |
|
1642 | - public $txn_page_id; |
|
1643 | - |
|
1644 | - public $thank_you_page_id; |
|
1645 | - |
|
1646 | - public $cancel_page_id; |
|
1647 | - |
|
1648 | - /** |
|
1649 | - * The next 4 vars are the URLs of critical EE pages. |
|
1650 | - * |
|
1651 | - * @var int |
|
1652 | - */ |
|
1653 | - public $reg_page_url; |
|
1654 | - |
|
1655 | - public $txn_page_url; |
|
1656 | - |
|
1657 | - public $thank_you_page_url; |
|
1658 | - |
|
1659 | - public $cancel_page_url; |
|
1660 | - |
|
1661 | - /** |
|
1662 | - * The next vars relate to the custom slugs for EE CPT routes |
|
1663 | - */ |
|
1664 | - public $event_cpt_slug; |
|
1665 | - |
|
1666 | - /** |
|
1667 | - * This caches the _ee_ueip_option in case this config is reset in the same |
|
1668 | - * request across blog switches in a multisite context. |
|
1669 | - * Avoids extra queries to the db for this option. |
|
1670 | - * |
|
1671 | - * @var bool |
|
1672 | - */ |
|
1673 | - public static $ee_ueip_option; |
|
1674 | - |
|
1675 | - |
|
1676 | - /** |
|
1677 | - * class constructor |
|
1678 | - * |
|
1679 | - * @access public |
|
1680 | - */ |
|
1681 | - public function __construct() |
|
1682 | - { |
|
1683 | - // set default organization settings |
|
1684 | - $this->current_blog_id = get_current_blog_id(); |
|
1685 | - $this->current_blog_id = $this->current_blog_id === null ? 1 : $this->current_blog_id; |
|
1686 | - $this->ee_ueip_optin = $this->_get_main_ee_ueip_optin(); |
|
1687 | - $this->ee_ueip_has_notified = is_main_site() ? get_option('ee_ueip_has_notified', false) : true; |
|
1688 | - $this->post_shortcodes = array(); |
|
1689 | - $this->module_route_map = array(); |
|
1690 | - $this->module_forward_map = array(); |
|
1691 | - $this->module_view_map = array(); |
|
1692 | - // critical EE page IDs |
|
1693 | - $this->reg_page_id = 0; |
|
1694 | - $this->txn_page_id = 0; |
|
1695 | - $this->thank_you_page_id = 0; |
|
1696 | - $this->cancel_page_id = 0; |
|
1697 | - // critical EE page URLs |
|
1698 | - $this->reg_page_url = ''; |
|
1699 | - $this->txn_page_url = ''; |
|
1700 | - $this->thank_you_page_url = ''; |
|
1701 | - $this->cancel_page_url = ''; |
|
1702 | - // cpt slugs |
|
1703 | - $this->event_cpt_slug = __('events', 'event_espresso'); |
|
1704 | - // ueip constant check |
|
1705 | - if (defined('EE_DISABLE_UXIP') && EE_DISABLE_UXIP) { |
|
1706 | - $this->ee_ueip_optin = false; |
|
1707 | - $this->ee_ueip_has_notified = true; |
|
1708 | - } |
|
1709 | - } |
|
1710 | - |
|
1711 | - |
|
1712 | - /** |
|
1713 | - * @return array |
|
1714 | - */ |
|
1715 | - public function get_critical_pages_array() |
|
1716 | - { |
|
1717 | - return array( |
|
1718 | - $this->reg_page_id, |
|
1719 | - $this->txn_page_id, |
|
1720 | - $this->thank_you_page_id, |
|
1721 | - $this->cancel_page_id, |
|
1722 | - ); |
|
1723 | - } |
|
1724 | - |
|
1725 | - |
|
1726 | - /** |
|
1727 | - * @return array |
|
1728 | - */ |
|
1729 | - public function get_critical_pages_shortcodes_array() |
|
1730 | - { |
|
1731 | - return array( |
|
1732 | - $this->reg_page_id => 'ESPRESSO_CHECKOUT', |
|
1733 | - $this->txn_page_id => 'ESPRESSO_TXN_PAGE', |
|
1734 | - $this->thank_you_page_id => 'ESPRESSO_THANK_YOU', |
|
1735 | - $this->cancel_page_id => 'ESPRESSO_CANCELLED', |
|
1736 | - ); |
|
1737 | - } |
|
1738 | - |
|
1739 | - |
|
1740 | - /** |
|
1741 | - * gets/returns URL for EE reg_page |
|
1742 | - * |
|
1743 | - * @access public |
|
1744 | - * @return string |
|
1745 | - */ |
|
1746 | - public function reg_page_url() |
|
1747 | - { |
|
1748 | - if (! $this->reg_page_url) { |
|
1749 | - $this->reg_page_url = add_query_arg( |
|
1750 | - array('uts' => time()), |
|
1751 | - get_permalink($this->reg_page_id) |
|
1752 | - ) . '#checkout'; |
|
1753 | - } |
|
1754 | - return $this->reg_page_url; |
|
1755 | - } |
|
1756 | - |
|
1757 | - |
|
1758 | - /** |
|
1759 | - * gets/returns URL for EE txn_page |
|
1760 | - * |
|
1761 | - * @param array $query_args like what gets passed to |
|
1762 | - * add_query_arg() as the first argument |
|
1763 | - * @access public |
|
1764 | - * @return string |
|
1765 | - */ |
|
1766 | - public function txn_page_url($query_args = array()) |
|
1767 | - { |
|
1768 | - if (! $this->txn_page_url) { |
|
1769 | - $this->txn_page_url = get_permalink($this->txn_page_id); |
|
1770 | - } |
|
1771 | - if ($query_args) { |
|
1772 | - return add_query_arg($query_args, $this->txn_page_url); |
|
1773 | - } else { |
|
1774 | - return $this->txn_page_url; |
|
1775 | - } |
|
1776 | - } |
|
1777 | - |
|
1778 | - |
|
1779 | - /** |
|
1780 | - * gets/returns URL for EE thank_you_page |
|
1781 | - * |
|
1782 | - * @param array $query_args like what gets passed to |
|
1783 | - * add_query_arg() as the first argument |
|
1784 | - * @access public |
|
1785 | - * @return string |
|
1786 | - */ |
|
1787 | - public function thank_you_page_url($query_args = array()) |
|
1788 | - { |
|
1789 | - if (! $this->thank_you_page_url) { |
|
1790 | - $this->thank_you_page_url = get_permalink($this->thank_you_page_id); |
|
1791 | - } |
|
1792 | - if ($query_args) { |
|
1793 | - return add_query_arg($query_args, $this->thank_you_page_url); |
|
1794 | - } else { |
|
1795 | - return $this->thank_you_page_url; |
|
1796 | - } |
|
1797 | - } |
|
1798 | - |
|
1799 | - |
|
1800 | - /** |
|
1801 | - * gets/returns URL for EE cancel_page |
|
1802 | - * |
|
1803 | - * @access public |
|
1804 | - * @return string |
|
1805 | - */ |
|
1806 | - public function cancel_page_url() |
|
1807 | - { |
|
1808 | - if (! $this->cancel_page_url) { |
|
1809 | - $this->cancel_page_url = get_permalink($this->cancel_page_id); |
|
1810 | - } |
|
1811 | - return $this->cancel_page_url; |
|
1812 | - } |
|
1813 | - |
|
1814 | - |
|
1815 | - /** |
|
1816 | - * Resets all critical page urls to their original state. Used primarily by the __sleep() magic method currently. |
|
1817 | - * |
|
1818 | - * @since 4.7.5 |
|
1819 | - */ |
|
1820 | - protected function _reset_urls() |
|
1821 | - { |
|
1822 | - $this->reg_page_url = ''; |
|
1823 | - $this->txn_page_url = ''; |
|
1824 | - $this->cancel_page_url = ''; |
|
1825 | - $this->thank_you_page_url = ''; |
|
1826 | - } |
|
1827 | - |
|
1828 | - |
|
1829 | - /** |
|
1830 | - * Used to return what the optin value is set for the EE User Experience Program. |
|
1831 | - * This accounts for multisite and this value being requested for a subsite. In multisite, the value is set |
|
1832 | - * on the main site only. |
|
1833 | - * |
|
1834 | - * @return bool |
|
1835 | - */ |
|
1836 | - protected function _get_main_ee_ueip_optin() |
|
1837 | - { |
|
1838 | - // if this is the main site then we can just bypass our direct query. |
|
1839 | - if (is_main_site()) { |
|
1840 | - return get_option(self::OPTION_NAME_UXIP, false); |
|
1841 | - } |
|
1842 | - // is this already cached for this request? If so use it. |
|
1843 | - if (EE_Core_Config::$ee_ueip_option !== null) { |
|
1844 | - return EE_Core_Config::$ee_ueip_option; |
|
1845 | - } |
|
1846 | - global $wpdb; |
|
1847 | - $current_network_main_site = is_multisite() ? get_current_site() : null; |
|
1848 | - $current_main_site_id = ! empty($current_network_main_site) ? $current_network_main_site->blog_id : 1; |
|
1849 | - $option = self::OPTION_NAME_UXIP; |
|
1850 | - // set correct table for query |
|
1851 | - $table_name = $wpdb->get_blog_prefix($current_main_site_id) . 'options'; |
|
1852 | - // rather than getting blog option for the $current_main_site_id, we do a direct $wpdb query because |
|
1853 | - // get_blog_option() does a switch_to_blog an that could cause infinite recursion because EE_Core_Config might be |
|
1854 | - // re-constructed on the blog switch. Note, we are still executing any core wp filters on this option retrieval. |
|
1855 | - // this bit of code is basically a direct copy of get_option without any caching because we are NOT switched to the blog |
|
1856 | - // for the purpose of caching. |
|
1857 | - $pre = apply_filters('pre_option_' . $option, false, $option); |
|
1858 | - if (false !== $pre) { |
|
1859 | - EE_Core_Config::$ee_ueip_option = $pre; |
|
1860 | - return EE_Core_Config::$ee_ueip_option; |
|
1861 | - } |
|
1862 | - $row = $wpdb->get_row( |
|
1863 | - $wpdb->prepare( |
|
1864 | - "SELECT option_value FROM $table_name WHERE option_name = %s LIMIT 1", |
|
1865 | - $option |
|
1866 | - ) |
|
1867 | - ); |
|
1868 | - if (is_object($row)) { |
|
1869 | - $value = $row->option_value; |
|
1870 | - } else { // option does not exist so use default. |
|
1871 | - EE_Core_Config::$ee_ueip_option = apply_filters('default_option_' . $option, false, $option); |
|
1872 | - return EE_Core_Config::$ee_ueip_option; |
|
1873 | - } |
|
1874 | - EE_Core_Config::$ee_ueip_option = apply_filters('option_' . $option, maybe_unserialize($value), $option); |
|
1875 | - return EE_Core_Config::$ee_ueip_option; |
|
1876 | - } |
|
1877 | - |
|
1878 | - |
|
1879 | - /** |
|
1880 | - * Utility function for escaping the value of a property and returning. |
|
1881 | - * |
|
1882 | - * @param string $property property name (checks to see if exists). |
|
1883 | - * @return mixed if a detected type found return the escaped value, otherwise just the raw value is returned. |
|
1884 | - * @throws \EE_Error |
|
1885 | - */ |
|
1886 | - public function get_pretty($property) |
|
1887 | - { |
|
1888 | - if ($property === self::OPTION_NAME_UXIP) { |
|
1889 | - return $this->ee_ueip_optin ? 'yes' : 'no'; |
|
1890 | - } |
|
1891 | - return parent::get_pretty($property); |
|
1892 | - } |
|
1893 | - |
|
1894 | - |
|
1895 | - /** |
|
1896 | - * Currently used to ensure critical page urls have initial values saved to the db instead of any current set values |
|
1897 | - * on the object. |
|
1898 | - * |
|
1899 | - * @return array |
|
1900 | - */ |
|
1901 | - public function __sleep() |
|
1902 | - { |
|
1903 | - // reset all url properties |
|
1904 | - $this->_reset_urls(); |
|
1905 | - // return what to save to db |
|
1906 | - return array_keys(get_object_vars($this)); |
|
1907 | - } |
|
1908 | -} |
|
1909 | - |
|
1910 | -/** |
|
1911 | - * Config class for storing info on the Organization |
|
1912 | - */ |
|
1913 | -class EE_Organization_Config extends EE_Config_Base |
|
1914 | -{ |
|
1915 | - |
|
1916 | - /** |
|
1917 | - * @var string $name |
|
1918 | - * eg EE4.1 |
|
1919 | - */ |
|
1920 | - public $name; |
|
1921 | - |
|
1922 | - /** |
|
1923 | - * @var string $address_1 |
|
1924 | - * eg 123 Onna Road |
|
1925 | - */ |
|
1926 | - public $address_1; |
|
1927 | - |
|
1928 | - /** |
|
1929 | - * @var string $address_2 |
|
1930 | - * eg PO Box 123 |
|
1931 | - */ |
|
1932 | - public $address_2; |
|
1933 | - |
|
1934 | - /** |
|
1935 | - * @var string $city |
|
1936 | - * eg Inna City |
|
1937 | - */ |
|
1938 | - public $city; |
|
1939 | - |
|
1940 | - /** |
|
1941 | - * @var int $STA_ID |
|
1942 | - * eg 4 |
|
1943 | - */ |
|
1944 | - public $STA_ID; |
|
1945 | - |
|
1946 | - /** |
|
1947 | - * @var string $CNT_ISO |
|
1948 | - * eg US |
|
1949 | - */ |
|
1950 | - public $CNT_ISO; |
|
1951 | - |
|
1952 | - /** |
|
1953 | - * @var string $zip |
|
1954 | - * eg 12345 or V1A 2B3 |
|
1955 | - */ |
|
1956 | - public $zip; |
|
1957 | - |
|
1958 | - /** |
|
1959 | - * @var string $email |
|
1960 | - * eg [email protected] |
|
1961 | - */ |
|
1962 | - public $email; |
|
1963 | - |
|
1964 | - /** |
|
1965 | - * @var string $phone |
|
1966 | - * eg. 111-111-1111 |
|
1967 | - */ |
|
1968 | - public $phone; |
|
1969 | - |
|
1970 | - /** |
|
1971 | - * @var string $vat |
|
1972 | - * VAT/Tax Number |
|
1973 | - */ |
|
1974 | - public $vat; |
|
1975 | - |
|
1976 | - /** |
|
1977 | - * @var string $logo_url |
|
1978 | - * eg http://www.somedomain.com/wp-content/uploads/kittehs.jpg |
|
1979 | - */ |
|
1980 | - public $logo_url; |
|
1981 | - |
|
1982 | - /** |
|
1983 | - * The below are all various properties for holding links to organization social network profiles |
|
1984 | - * |
|
1985 | - * @var string |
|
1986 | - */ |
|
1987 | - /** |
|
1988 | - * facebook (facebook.com/profile.name) |
|
1989 | - * |
|
1990 | - * @var string |
|
1991 | - */ |
|
1992 | - public $facebook; |
|
1993 | - |
|
1994 | - /** |
|
1995 | - * twitter (twitter.com/twitter_handle) |
|
1996 | - * |
|
1997 | - * @var string |
|
1998 | - */ |
|
1999 | - public $twitter; |
|
2000 | - |
|
2001 | - /** |
|
2002 | - * linkedin (linkedin.com/in/profile_name) |
|
2003 | - * |
|
2004 | - * @var string |
|
2005 | - */ |
|
2006 | - public $linkedin; |
|
2007 | - |
|
2008 | - /** |
|
2009 | - * pinterest (www.pinterest.com/profile_name) |
|
2010 | - * |
|
2011 | - * @var string |
|
2012 | - */ |
|
2013 | - public $pinterest; |
|
2014 | - |
|
2015 | - /** |
|
2016 | - * google+ (google.com/+profileName) |
|
2017 | - * |
|
2018 | - * @var string |
|
2019 | - */ |
|
2020 | - public $google; |
|
2021 | - |
|
2022 | - /** |
|
2023 | - * instagram (instagram.com/handle) |
|
2024 | - * |
|
2025 | - * @var string |
|
2026 | - */ |
|
2027 | - public $instagram; |
|
2028 | - |
|
2029 | - |
|
2030 | - /** |
|
2031 | - * class constructor |
|
2032 | - * |
|
2033 | - * @access public |
|
2034 | - */ |
|
2035 | - public function __construct() |
|
2036 | - { |
|
2037 | - // set default organization settings |
|
2038 | - // decode HTML entities from the WP blogname, because it's stored in the DB with HTML entities encoded |
|
2039 | - $this->name = wp_specialchars_decode(get_bloginfo('name'), ENT_QUOTES); |
|
2040 | - $this->address_1 = '123 Onna Road'; |
|
2041 | - $this->address_2 = 'PO Box 123'; |
|
2042 | - $this->city = 'Inna City'; |
|
2043 | - $this->STA_ID = 4; |
|
2044 | - $this->CNT_ISO = 'US'; |
|
2045 | - $this->zip = '12345'; |
|
2046 | - $this->email = get_bloginfo('admin_email'); |
|
2047 | - $this->phone = ''; |
|
2048 | - $this->vat = '123456789'; |
|
2049 | - $this->logo_url = ''; |
|
2050 | - $this->facebook = ''; |
|
2051 | - $this->twitter = ''; |
|
2052 | - $this->linkedin = ''; |
|
2053 | - $this->pinterest = ''; |
|
2054 | - $this->google = ''; |
|
2055 | - $this->instagram = ''; |
|
2056 | - } |
|
2057 | -} |
|
2058 | - |
|
2059 | -/** |
|
2060 | - * Class for defining what's in the EE_Config relating to currency |
|
2061 | - */ |
|
2062 | -class EE_Currency_Config extends EE_Config_Base |
|
2063 | -{ |
|
2064 | - |
|
2065 | - /** |
|
2066 | - * @var string $code |
|
2067 | - * eg 'US' |
|
2068 | - */ |
|
2069 | - public $code; |
|
2070 | - |
|
2071 | - /** |
|
2072 | - * @var string $name |
|
2073 | - * eg 'Dollar' |
|
2074 | - */ |
|
2075 | - public $name; |
|
2076 | - |
|
2077 | - /** |
|
2078 | - * plural name |
|
2079 | - * |
|
2080 | - * @var string $plural |
|
2081 | - * eg 'Dollars' |
|
2082 | - */ |
|
2083 | - public $plural; |
|
2084 | - |
|
2085 | - /** |
|
2086 | - * currency sign |
|
2087 | - * |
|
2088 | - * @var string $sign |
|
2089 | - * eg '$' |
|
2090 | - */ |
|
2091 | - public $sign; |
|
2092 | - |
|
2093 | - /** |
|
2094 | - * Whether the currency sign should come before the number or not |
|
2095 | - * |
|
2096 | - * @var boolean $sign_b4 |
|
2097 | - */ |
|
2098 | - public $sign_b4; |
|
2099 | - |
|
2100 | - /** |
|
2101 | - * How many digits should come after the decimal place |
|
2102 | - * |
|
2103 | - * @var int $dec_plc |
|
2104 | - */ |
|
2105 | - public $dec_plc; |
|
2106 | - |
|
2107 | - /** |
|
2108 | - * Symbol to use for decimal mark |
|
2109 | - * |
|
2110 | - * @var string $dec_mrk |
|
2111 | - * eg '.' |
|
2112 | - */ |
|
2113 | - public $dec_mrk; |
|
2114 | - |
|
2115 | - /** |
|
2116 | - * Symbol to use for thousands |
|
2117 | - * |
|
2118 | - * @var string $thsnds |
|
2119 | - * eg ',' |
|
2120 | - */ |
|
2121 | - public $thsnds; |
|
2122 | - |
|
2123 | - |
|
2124 | - /** |
|
2125 | - * class constructor |
|
2126 | - * |
|
2127 | - * @access public |
|
2128 | - * @param string $CNT_ISO |
|
2129 | - * @throws \EE_Error |
|
2130 | - */ |
|
2131 | - public function __construct($CNT_ISO = '') |
|
2132 | - { |
|
2133 | - /** @var \EventEspresso\core\services\database\TableAnalysis $table_analysis */ |
|
2134 | - $table_analysis = EE_Registry::instance()->create('TableAnalysis', array(), true); |
|
2135 | - // get country code from organization settings or use default |
|
2136 | - $ORG_CNT = isset(EE_Registry::instance()->CFG->organization) |
|
2137 | - && EE_Registry::instance()->CFG->organization instanceof EE_Organization_Config |
|
2138 | - ? EE_Registry::instance()->CFG->organization->CNT_ISO |
|
2139 | - : ''; |
|
2140 | - // but override if requested |
|
2141 | - $CNT_ISO = ! empty($CNT_ISO) ? $CNT_ISO : $ORG_CNT; |
|
2142 | - // so if that all went well, and we are not in M-Mode (cuz you can't query the db in M-Mode) and double-check the countries table exists |
|
2143 | - if (! empty($CNT_ISO) |
|
2144 | - && EE_Maintenance_Mode::instance()->models_can_query() |
|
2145 | - && $table_analysis->tableExists(EE_Registry::instance()->load_model('Country')->table()) |
|
2146 | - ) { |
|
2147 | - // retrieve the country settings from the db, just in case they have been customized |
|
2148 | - $country = EE_Registry::instance()->load_model('Country')->get_one_by_ID($CNT_ISO); |
|
2149 | - if ($country instanceof EE_Country) { |
|
2150 | - $this->code = $country->currency_code(); // currency code: USD, CAD, EUR |
|
2151 | - $this->name = $country->currency_name_single(); // Dollar |
|
2152 | - $this->plural = $country->currency_name_plural(); // Dollars |
|
2153 | - $this->sign = $country->currency_sign(); // currency sign: $ |
|
2154 | - $this->sign_b4 = $country->currency_sign_before( |
|
2155 | - ); // currency sign before or after: $TRUE or FALSE$ |
|
2156 | - $this->dec_plc = $country->currency_decimal_places(); // decimal places: 2 = 0.00 3 = 0.000 |
|
2157 | - $this->dec_mrk = $country->currency_decimal_mark( |
|
2158 | - ); // decimal mark: (comma) ',' = 0,01 or (decimal) '.' = 0.01 |
|
2159 | - $this->thsnds = $country->currency_thousands_separator( |
|
2160 | - ); // thousands separator: (comma) ',' = 1,000 or (decimal) '.' = 1.000 |
|
2161 | - } |
|
2162 | - } |
|
2163 | - // fallback to hardcoded defaults, in case the above failed |
|
2164 | - if (empty($this->code)) { |
|
2165 | - // set default currency settings |
|
2166 | - $this->code = 'USD'; // currency code: USD, CAD, EUR |
|
2167 | - $this->name = __('Dollar', 'event_espresso'); // Dollar |
|
2168 | - $this->plural = __('Dollars', 'event_espresso'); // Dollars |
|
2169 | - $this->sign = '$'; // currency sign: $ |
|
2170 | - $this->sign_b4 = true; // currency sign before or after: $TRUE or FALSE$ |
|
2171 | - $this->dec_plc = 2; // decimal places: 2 = 0.00 3 = 0.000 |
|
2172 | - $this->dec_mrk = '.'; // decimal mark: (comma) ',' = 0,01 or (decimal) '.' = 0.01 |
|
2173 | - $this->thsnds = ','; // thousands separator: (comma) ',' = 1,000 or (decimal) '.' = 1.000 |
|
2174 | - } |
|
2175 | - } |
|
2176 | -} |
|
2177 | - |
|
2178 | -/** |
|
2179 | - * Class for defining what's in the EE_Config relating to registration settings |
|
2180 | - */ |
|
2181 | -class EE_Registration_Config extends EE_Config_Base |
|
2182 | -{ |
|
2183 | - |
|
2184 | - /** |
|
2185 | - * Default registration status |
|
2186 | - * |
|
2187 | - * @var string $default_STS_ID |
|
2188 | - * eg 'RPP' |
|
2189 | - */ |
|
2190 | - public $default_STS_ID; |
|
2191 | - |
|
2192 | - /** |
|
2193 | - * For new events, this will be the default value for the maximum number of tickets (equivalent to maximum number of |
|
2194 | - * registrations) |
|
2195 | - * |
|
2196 | - * @var int |
|
2197 | - */ |
|
2198 | - public $default_maximum_number_of_tickets; |
|
2199 | - |
|
2200 | - /** |
|
2201 | - * level of validation to apply to email addresses |
|
2202 | - * |
|
2203 | - * @var string $email_validation_level |
|
2204 | - * options: 'basic', 'wp_default', 'i18n', 'i18n_dns' |
|
2205 | - */ |
|
2206 | - public $email_validation_level; |
|
2207 | - |
|
2208 | - /** |
|
2209 | - * whether or not to show alternate payment options during the reg process if payment status is pending |
|
2210 | - * |
|
2211 | - * @var boolean $show_pending_payment_options |
|
2212 | - */ |
|
2213 | - public $show_pending_payment_options; |
|
2214 | - |
|
2215 | - /** |
|
2216 | - * Whether to skip the registration confirmation page |
|
2217 | - * |
|
2218 | - * @var boolean $skip_reg_confirmation |
|
2219 | - */ |
|
2220 | - public $skip_reg_confirmation; |
|
2221 | - |
|
2222 | - /** |
|
2223 | - * an array of SPCO reg steps where: |
|
2224 | - * the keys denotes the reg step order |
|
2225 | - * each element consists of an array with the following elements: |
|
2226 | - * "file_path" => the file path to the EE_SPCO_Reg_Step class |
|
2227 | - * "class_name" => the specific EE_SPCO_Reg_Step child class name |
|
2228 | - * "slug" => the URL param used to trigger the reg step |
|
2229 | - * |
|
2230 | - * @var array $reg_steps |
|
2231 | - */ |
|
2232 | - public $reg_steps; |
|
2233 | - |
|
2234 | - /** |
|
2235 | - * Whether registration confirmation should be the last page of SPCO |
|
2236 | - * |
|
2237 | - * @var boolean $reg_confirmation_last |
|
2238 | - */ |
|
2239 | - public $reg_confirmation_last; |
|
2240 | - |
|
2241 | - /** |
|
2242 | - * Whether or not to enable the EE Bot Trap |
|
2243 | - * |
|
2244 | - * @var boolean $use_bot_trap |
|
2245 | - */ |
|
2246 | - public $use_bot_trap; |
|
2247 | - |
|
2248 | - /** |
|
2249 | - * Whether or not to encrypt some data sent by the EE Bot Trap |
|
2250 | - * |
|
2251 | - * @var boolean $use_encryption |
|
2252 | - */ |
|
2253 | - public $use_encryption; |
|
2254 | - |
|
2255 | - /** |
|
2256 | - * Whether or not to use ReCaptcha |
|
2257 | - * |
|
2258 | - * @var boolean $use_captcha |
|
2259 | - */ |
|
2260 | - public $use_captcha; |
|
2261 | - |
|
2262 | - /** |
|
2263 | - * ReCaptcha Theme |
|
2264 | - * |
|
2265 | - * @var string $recaptcha_theme |
|
2266 | - * options: 'dark', 'light', 'invisible' |
|
2267 | - */ |
|
2268 | - public $recaptcha_theme; |
|
2269 | - |
|
2270 | - /** |
|
2271 | - * ReCaptcha Badge - determines the position of the reCAPTCHA badge if using Invisible ReCaptcha. |
|
2272 | - * |
|
2273 | - * @var string $recaptcha_badge |
|
2274 | - * options: 'bottomright', 'bottomleft', 'inline' |
|
2275 | - */ |
|
2276 | - public $recaptcha_badge; |
|
17 | + const OPTION_NAME = 'ee_config'; |
|
18 | + |
|
19 | + const LOG_NAME = 'ee_config_log'; |
|
20 | + |
|
21 | + const LOG_LENGTH = 100; |
|
22 | + |
|
23 | + const ADDON_OPTION_NAMES = 'ee_config_option_names'; |
|
24 | + |
|
25 | + /** |
|
26 | + * instance of the EE_Config object |
|
27 | + * |
|
28 | + * @var EE_Config $_instance |
|
29 | + * @access private |
|
30 | + */ |
|
31 | + private static $_instance; |
|
32 | + |
|
33 | + /** |
|
34 | + * @var boolean $_logging_enabled |
|
35 | + */ |
|
36 | + private static $_logging_enabled = false; |
|
37 | + |
|
38 | + /** |
|
39 | + * @var LegacyShortcodesManager $legacy_shortcodes_manager |
|
40 | + */ |
|
41 | + private $legacy_shortcodes_manager; |
|
42 | + |
|
43 | + /** |
|
44 | + * An StdClass whose property names are addon slugs, |
|
45 | + * and values are their config classes |
|
46 | + * |
|
47 | + * @var StdClass |
|
48 | + */ |
|
49 | + public $addons; |
|
50 | + |
|
51 | + /** |
|
52 | + * @var EE_Admin_Config |
|
53 | + */ |
|
54 | + public $admin; |
|
55 | + |
|
56 | + /** |
|
57 | + * @var EE_Core_Config |
|
58 | + */ |
|
59 | + public $core; |
|
60 | + |
|
61 | + /** |
|
62 | + * @var EE_Currency_Config |
|
63 | + */ |
|
64 | + public $currency; |
|
65 | + |
|
66 | + /** |
|
67 | + * @var EE_Organization_Config |
|
68 | + */ |
|
69 | + public $organization; |
|
70 | + |
|
71 | + /** |
|
72 | + * @var EE_Registration_Config |
|
73 | + */ |
|
74 | + public $registration; |
|
75 | + |
|
76 | + /** |
|
77 | + * @var EE_Template_Config |
|
78 | + */ |
|
79 | + public $template_settings; |
|
80 | + |
|
81 | + /** |
|
82 | + * Holds EE environment values. |
|
83 | + * |
|
84 | + * @var EE_Environment_Config |
|
85 | + */ |
|
86 | + public $environment; |
|
87 | + |
|
88 | + /** |
|
89 | + * settings pertaining to Google maps |
|
90 | + * |
|
91 | + * @var EE_Map_Config |
|
92 | + */ |
|
93 | + public $map_settings; |
|
94 | + |
|
95 | + /** |
|
96 | + * settings pertaining to Taxes |
|
97 | + * |
|
98 | + * @var EE_Tax_Config |
|
99 | + */ |
|
100 | + public $tax_settings; |
|
101 | + |
|
102 | + /** |
|
103 | + * Settings pertaining to global messages settings. |
|
104 | + * |
|
105 | + * @var EE_Messages_Config |
|
106 | + */ |
|
107 | + public $messages; |
|
108 | + |
|
109 | + /** |
|
110 | + * @deprecated |
|
111 | + * @var EE_Gateway_Config |
|
112 | + */ |
|
113 | + public $gateway; |
|
114 | + |
|
115 | + /** |
|
116 | + * @var array $_addon_option_names |
|
117 | + * @access private |
|
118 | + */ |
|
119 | + private $_addon_option_names = array(); |
|
120 | + |
|
121 | + /** |
|
122 | + * @var array $_module_route_map |
|
123 | + * @access private |
|
124 | + */ |
|
125 | + private static $_module_route_map = array(); |
|
126 | + |
|
127 | + /** |
|
128 | + * @var array $_module_forward_map |
|
129 | + * @access private |
|
130 | + */ |
|
131 | + private static $_module_forward_map = array(); |
|
132 | + |
|
133 | + /** |
|
134 | + * @var array $_module_view_map |
|
135 | + * @access private |
|
136 | + */ |
|
137 | + private static $_module_view_map = array(); |
|
138 | + |
|
139 | + |
|
140 | + /** |
|
141 | + * @singleton method used to instantiate class object |
|
142 | + * @access public |
|
143 | + * @return EE_Config instance |
|
144 | + */ |
|
145 | + public static function instance() |
|
146 | + { |
|
147 | + // check if class object is instantiated, and instantiated properly |
|
148 | + if (! self::$_instance instanceof EE_Config) { |
|
149 | + self::$_instance = new self(); |
|
150 | + } |
|
151 | + return self::$_instance; |
|
152 | + } |
|
153 | + |
|
154 | + |
|
155 | + /** |
|
156 | + * Resets the config |
|
157 | + * |
|
158 | + * @param bool $hard_reset if TRUE, sets EE_CONFig back to its original settings in the database. If FALSE |
|
159 | + * (default) leaves the database alone, and merely resets the EE_Config object to |
|
160 | + * reflect its state in the database |
|
161 | + * @param boolean $reinstantiate if TRUE (default) call instance() and return it. Otherwise, just leave |
|
162 | + * $_instance as NULL. Useful in case you want to forget about the old instance on |
|
163 | + * EE_Config, but might not be ready to instantiate EE_Config currently (eg if the |
|
164 | + * site was put into maintenance mode) |
|
165 | + * @return EE_Config |
|
166 | + */ |
|
167 | + public static function reset($hard_reset = false, $reinstantiate = true) |
|
168 | + { |
|
169 | + if (self::$_instance instanceof EE_Config) { |
|
170 | + if ($hard_reset) { |
|
171 | + self::$_instance->legacy_shortcodes_manager = null; |
|
172 | + self::$_instance->_addon_option_names = array(); |
|
173 | + self::$_instance->_initialize_config(); |
|
174 | + self::$_instance->update_espresso_config(); |
|
175 | + } |
|
176 | + self::$_instance->update_addon_option_names(); |
|
177 | + } |
|
178 | + self::$_instance = null; |
|
179 | + // we don't need to reset the static properties imo because those should |
|
180 | + // only change when a module is added or removed. Currently we don't |
|
181 | + // support removing a module during a request when it previously existed |
|
182 | + if ($reinstantiate) { |
|
183 | + return self::instance(); |
|
184 | + } else { |
|
185 | + return null; |
|
186 | + } |
|
187 | + } |
|
188 | + |
|
189 | + |
|
190 | + /** |
|
191 | + * class constructor |
|
192 | + * |
|
193 | + * @access private |
|
194 | + */ |
|
195 | + private function __construct() |
|
196 | + { |
|
197 | + do_action('AHEE__EE_Config__construct__begin', $this); |
|
198 | + EE_Config::$_logging_enabled = apply_filters('FHEE__EE_Config___construct__logging_enabled', false); |
|
199 | + // setup empty config classes |
|
200 | + $this->_initialize_config(); |
|
201 | + // load existing EE site settings |
|
202 | + $this->_load_core_config(); |
|
203 | + // confirm everything loaded correctly and set filtered defaults if not |
|
204 | + $this->_verify_config(); |
|
205 | + // register shortcodes and modules |
|
206 | + add_action( |
|
207 | + 'AHEE__EE_System__register_shortcodes_modules_and_widgets', |
|
208 | + array($this, 'register_shortcodes_and_modules'), |
|
209 | + 999 |
|
210 | + ); |
|
211 | + // initialize shortcodes and modules |
|
212 | + add_action('AHEE__EE_System__core_loaded_and_ready', array($this, 'initialize_shortcodes_and_modules')); |
|
213 | + // register widgets |
|
214 | + add_action('widgets_init', array($this, 'widgets_init'), 10); |
|
215 | + // shutdown |
|
216 | + add_action('shutdown', array($this, 'shutdown'), 10); |
|
217 | + // construct__end hook |
|
218 | + do_action('AHEE__EE_Config__construct__end', $this); |
|
219 | + // hardcoded hack |
|
220 | + $this->template_settings->current_espresso_theme = 'Espresso_Arabica_2014'; |
|
221 | + } |
|
222 | + |
|
223 | + |
|
224 | + /** |
|
225 | + * @return boolean |
|
226 | + */ |
|
227 | + public static function logging_enabled() |
|
228 | + { |
|
229 | + return self::$_logging_enabled; |
|
230 | + } |
|
231 | + |
|
232 | + |
|
233 | + /** |
|
234 | + * use to get the current theme if needed from static context |
|
235 | + * |
|
236 | + * @return string current theme set. |
|
237 | + */ |
|
238 | + public static function get_current_theme() |
|
239 | + { |
|
240 | + return isset(self::$_instance->template_settings->current_espresso_theme) |
|
241 | + ? self::$_instance->template_settings->current_espresso_theme : 'Espresso_Arabica_2014'; |
|
242 | + } |
|
243 | + |
|
244 | + |
|
245 | + /** |
|
246 | + * _initialize_config |
|
247 | + * |
|
248 | + * @access private |
|
249 | + * @return void |
|
250 | + */ |
|
251 | + private function _initialize_config() |
|
252 | + { |
|
253 | + EE_Config::trim_log(); |
|
254 | + // set defaults |
|
255 | + $this->_addon_option_names = get_option(EE_Config::ADDON_OPTION_NAMES, array()); |
|
256 | + $this->addons = new stdClass(); |
|
257 | + // set _module_route_map |
|
258 | + EE_Config::$_module_route_map = array(); |
|
259 | + // set _module_forward_map |
|
260 | + EE_Config::$_module_forward_map = array(); |
|
261 | + // set _module_view_map |
|
262 | + EE_Config::$_module_view_map = array(); |
|
263 | + } |
|
264 | + |
|
265 | + |
|
266 | + /** |
|
267 | + * load core plugin configuration |
|
268 | + * |
|
269 | + * @access private |
|
270 | + * @return void |
|
271 | + */ |
|
272 | + private function _load_core_config() |
|
273 | + { |
|
274 | + // load_core_config__start hook |
|
275 | + do_action('AHEE__EE_Config___load_core_config__start', $this); |
|
276 | + $espresso_config = $this->get_espresso_config(); |
|
277 | + foreach ($espresso_config as $config => $settings) { |
|
278 | + // load_core_config__start hook |
|
279 | + $settings = apply_filters( |
|
280 | + 'FHEE__EE_Config___load_core_config__config_settings', |
|
281 | + $settings, |
|
282 | + $config, |
|
283 | + $this |
|
284 | + ); |
|
285 | + if (is_object($settings) && property_exists($this, $config)) { |
|
286 | + $this->{$config} = apply_filters('FHEE__EE_Config___load_core_config__' . $config, $settings); |
|
287 | + // call configs populate method to ensure any defaults are set for empty values. |
|
288 | + if (method_exists($settings, 'populate')) { |
|
289 | + $this->{$config}->populate(); |
|
290 | + } |
|
291 | + if (method_exists($settings, 'do_hooks')) { |
|
292 | + $this->{$config}->do_hooks(); |
|
293 | + } |
|
294 | + } |
|
295 | + } |
|
296 | + if (apply_filters('FHEE__EE_Config___load_core_config__update_espresso_config', false)) { |
|
297 | + $this->update_espresso_config(); |
|
298 | + } |
|
299 | + // load_core_config__end hook |
|
300 | + do_action('AHEE__EE_Config___load_core_config__end', $this); |
|
301 | + } |
|
302 | + |
|
303 | + |
|
304 | + /** |
|
305 | + * _verify_config |
|
306 | + * |
|
307 | + * @access protected |
|
308 | + * @return void |
|
309 | + */ |
|
310 | + protected function _verify_config() |
|
311 | + { |
|
312 | + $this->core = $this->core instanceof EE_Core_Config |
|
313 | + ? $this->core |
|
314 | + : new EE_Core_Config(); |
|
315 | + $this->core = apply_filters('FHEE__EE_Config___initialize_config__core', $this->core); |
|
316 | + $this->organization = $this->organization instanceof EE_Organization_Config |
|
317 | + ? $this->organization |
|
318 | + : new EE_Organization_Config(); |
|
319 | + $this->organization = apply_filters( |
|
320 | + 'FHEE__EE_Config___initialize_config__organization', |
|
321 | + $this->organization |
|
322 | + ); |
|
323 | + $this->currency = $this->currency instanceof EE_Currency_Config |
|
324 | + ? $this->currency |
|
325 | + : new EE_Currency_Config(); |
|
326 | + $this->currency = apply_filters('FHEE__EE_Config___initialize_config__currency', $this->currency); |
|
327 | + $this->registration = $this->registration instanceof EE_Registration_Config |
|
328 | + ? $this->registration |
|
329 | + : new EE_Registration_Config(); |
|
330 | + $this->registration = apply_filters( |
|
331 | + 'FHEE__EE_Config___initialize_config__registration', |
|
332 | + $this->registration |
|
333 | + ); |
|
334 | + $this->admin = $this->admin instanceof EE_Admin_Config |
|
335 | + ? $this->admin |
|
336 | + : new EE_Admin_Config(); |
|
337 | + $this->admin = apply_filters('FHEE__EE_Config___initialize_config__admin', $this->admin); |
|
338 | + $this->template_settings = $this->template_settings instanceof EE_Template_Config |
|
339 | + ? $this->template_settings |
|
340 | + : new EE_Template_Config(); |
|
341 | + $this->template_settings = apply_filters( |
|
342 | + 'FHEE__EE_Config___initialize_config__template_settings', |
|
343 | + $this->template_settings |
|
344 | + ); |
|
345 | + $this->map_settings = $this->map_settings instanceof EE_Map_Config |
|
346 | + ? $this->map_settings |
|
347 | + : new EE_Map_Config(); |
|
348 | + $this->map_settings = apply_filters( |
|
349 | + 'FHEE__EE_Config___initialize_config__map_settings', |
|
350 | + $this->map_settings |
|
351 | + ); |
|
352 | + $this->environment = $this->environment instanceof EE_Environment_Config |
|
353 | + ? $this->environment |
|
354 | + : new EE_Environment_Config(); |
|
355 | + $this->environment = apply_filters( |
|
356 | + 'FHEE__EE_Config___initialize_config__environment', |
|
357 | + $this->environment |
|
358 | + ); |
|
359 | + $this->tax_settings = $this->tax_settings instanceof EE_Tax_Config |
|
360 | + ? $this->tax_settings |
|
361 | + : new EE_Tax_Config(); |
|
362 | + $this->tax_settings = apply_filters( |
|
363 | + 'FHEE__EE_Config___initialize_config__tax_settings', |
|
364 | + $this->tax_settings |
|
365 | + ); |
|
366 | + $this->messages = apply_filters('FHEE__EE_Config__initialize_config__messages', $this->messages); |
|
367 | + $this->messages = $this->messages instanceof EE_Messages_Config |
|
368 | + ? $this->messages |
|
369 | + : new EE_Messages_Config(); |
|
370 | + $this->gateway = $this->gateway instanceof EE_Gateway_Config |
|
371 | + ? $this->gateway |
|
372 | + : new EE_Gateway_Config(); |
|
373 | + $this->gateway = apply_filters('FHEE__EE_Config___initialize_config__gateway', $this->gateway); |
|
374 | + $this->legacy_shortcodes_manager = null; |
|
375 | + } |
|
376 | + |
|
377 | + |
|
378 | + /** |
|
379 | + * get_espresso_config |
|
380 | + * |
|
381 | + * @access public |
|
382 | + * @return array of espresso config stuff |
|
383 | + */ |
|
384 | + public function get_espresso_config() |
|
385 | + { |
|
386 | + // grab espresso configuration |
|
387 | + return apply_filters( |
|
388 | + 'FHEE__EE_Config__get_espresso_config__CFG', |
|
389 | + get_option(EE_Config::OPTION_NAME, array()) |
|
390 | + ); |
|
391 | + } |
|
392 | + |
|
393 | + |
|
394 | + /** |
|
395 | + * double_check_config_comparison |
|
396 | + * |
|
397 | + * @access public |
|
398 | + * @param string $option |
|
399 | + * @param $old_value |
|
400 | + * @param $value |
|
401 | + */ |
|
402 | + public function double_check_config_comparison($option = '', $old_value, $value) |
|
403 | + { |
|
404 | + // make sure we're checking the ee config |
|
405 | + if ($option === EE_Config::OPTION_NAME) { |
|
406 | + // run a loose comparison of the old value against the new value for type and properties, |
|
407 | + // but NOT exact instance like WP update_option does (ie: NOT type safe comparison) |
|
408 | + if ($value != $old_value) { |
|
409 | + // if they are NOT the same, then remove the hook, |
|
410 | + // which means the subsequent update results will be based solely on the update query results |
|
411 | + // the reason we do this is because, as stated above, |
|
412 | + // WP update_option performs an exact instance comparison (===) on any update values passed to it |
|
413 | + // this happens PRIOR to serialization and any subsequent update. |
|
414 | + // If values are found to match their previous old value, |
|
415 | + // then WP bails before performing any update. |
|
416 | + // Since we are passing the EE_Config object, it is comparing the EXACT instance of the saved version |
|
417 | + // it just pulled from the db, with the one being passed to it (which will not match). |
|
418 | + // HOWEVER, once the object is serialized and passed off to MySQL to update, |
|
419 | + // MySQL MAY ALSO NOT perform the update because |
|
420 | + // the string it sees in the db looks the same as the new one it has been passed!!! |
|
421 | + // This results in the query returning an "affected rows" value of ZERO, |
|
422 | + // which gets returned immediately by WP update_option and looks like an error. |
|
423 | + remove_action('update_option', array($this, 'check_config_updated')); |
|
424 | + } |
|
425 | + } |
|
426 | + } |
|
427 | + |
|
428 | + |
|
429 | + /** |
|
430 | + * update_espresso_config |
|
431 | + * |
|
432 | + * @access public |
|
433 | + */ |
|
434 | + protected function _reset_espresso_addon_config() |
|
435 | + { |
|
436 | + $this->_addon_option_names = array(); |
|
437 | + foreach ($this->addons as $addon_name => $addon_config_obj) { |
|
438 | + $addon_config_obj = maybe_unserialize($addon_config_obj); |
|
439 | + if ($addon_config_obj instanceof EE_Config_Base) { |
|
440 | + $this->update_config('addons', $addon_name, $addon_config_obj, false); |
|
441 | + } |
|
442 | + $this->addons->{$addon_name} = null; |
|
443 | + } |
|
444 | + } |
|
445 | + |
|
446 | + |
|
447 | + /** |
|
448 | + * update_espresso_config |
|
449 | + * |
|
450 | + * @access public |
|
451 | + * @param bool $add_success |
|
452 | + * @param bool $add_error |
|
453 | + * @return bool |
|
454 | + */ |
|
455 | + public function update_espresso_config($add_success = false, $add_error = true) |
|
456 | + { |
|
457 | + // don't allow config updates during WP heartbeats |
|
458 | + if (\EE_Registry::instance()->REQ->get('action', '') === 'heartbeat') { |
|
459 | + return false; |
|
460 | + } |
|
461 | + // commented out the following re: https://events.codebasehq.com/projects/event-espresso/tickets/8197 |
|
462 | + // $clone = clone( self::$_instance ); |
|
463 | + // self::$_instance = NULL; |
|
464 | + do_action('AHEE__EE_Config__update_espresso_config__begin', $this); |
|
465 | + $this->_reset_espresso_addon_config(); |
|
466 | + // hook into update_option because that happens AFTER the ( $value === $old_value ) conditional |
|
467 | + // but BEFORE the actual update occurs |
|
468 | + add_action('update_option', array($this, 'double_check_config_comparison'), 1, 3); |
|
469 | + // don't want to persist legacy_shortcodes_manager, but don't want to lose it either |
|
470 | + $legacy_shortcodes_manager = $this->legacy_shortcodes_manager; |
|
471 | + $this->legacy_shortcodes_manager = null; |
|
472 | + // now update "ee_config" |
|
473 | + $saved = update_option(EE_Config::OPTION_NAME, $this); |
|
474 | + $this->legacy_shortcodes_manager = $legacy_shortcodes_manager; |
|
475 | + EE_Config::log(EE_Config::OPTION_NAME); |
|
476 | + // if not saved... check if the hook we just added still exists; |
|
477 | + // if it does, it means one of two things: |
|
478 | + // that update_option bailed at the($value === $old_value) conditional, |
|
479 | + // or... |
|
480 | + // the db update query returned 0 rows affected |
|
481 | + // (probably because the data value was the same from it's perspective) |
|
482 | + // so the existence of the hook means that a negative result from update_option is NOT an error, |
|
483 | + // but just means no update occurred, so don't display an error to the user. |
|
484 | + // BUT... if update_option returns FALSE, AND the hook is missing, |
|
485 | + // then it means that something truly went wrong |
|
486 | + $saved = ! $saved ? has_action('update_option', array($this, 'double_check_config_comparison')) : $saved; |
|
487 | + // remove our action since we don't want it in the system anymore |
|
488 | + remove_action('update_option', array($this, 'double_check_config_comparison'), 1); |
|
489 | + do_action('AHEE__EE_Config__update_espresso_config__end', $this, $saved); |
|
490 | + // self::$_instance = $clone; |
|
491 | + // unset( $clone ); |
|
492 | + // if config remains the same or was updated successfully |
|
493 | + if ($saved) { |
|
494 | + if ($add_success) { |
|
495 | + EE_Error::add_success( |
|
496 | + __('The Event Espresso Configuration Settings have been successfully updated.', 'event_espresso'), |
|
497 | + __FILE__, |
|
498 | + __FUNCTION__, |
|
499 | + __LINE__ |
|
500 | + ); |
|
501 | + } |
|
502 | + return true; |
|
503 | + } else { |
|
504 | + if ($add_error) { |
|
505 | + EE_Error::add_error( |
|
506 | + __('The Event Espresso Configuration Settings were not updated.', 'event_espresso'), |
|
507 | + __FILE__, |
|
508 | + __FUNCTION__, |
|
509 | + __LINE__ |
|
510 | + ); |
|
511 | + } |
|
512 | + return false; |
|
513 | + } |
|
514 | + } |
|
515 | + |
|
516 | + |
|
517 | + /** |
|
518 | + * _verify_config_params |
|
519 | + * |
|
520 | + * @access private |
|
521 | + * @param string $section |
|
522 | + * @param string $name |
|
523 | + * @param string $config_class |
|
524 | + * @param EE_Config_Base $config_obj |
|
525 | + * @param array $tests_to_run |
|
526 | + * @param bool $display_errors |
|
527 | + * @return bool TRUE on success, FALSE on fail |
|
528 | + */ |
|
529 | + private function _verify_config_params( |
|
530 | + $section = '', |
|
531 | + $name = '', |
|
532 | + $config_class = '', |
|
533 | + $config_obj = null, |
|
534 | + $tests_to_run = array(1, 2, 3, 4, 5, 6, 7, 8), |
|
535 | + $display_errors = true |
|
536 | + ) { |
|
537 | + try { |
|
538 | + foreach ($tests_to_run as $test) { |
|
539 | + switch ($test) { |
|
540 | + // TEST #1 : check that section was set |
|
541 | + case 1: |
|
542 | + if (empty($section)) { |
|
543 | + if ($display_errors) { |
|
544 | + throw new EE_Error( |
|
545 | + sprintf( |
|
546 | + __( |
|
547 | + 'No configuration section has been provided while attempting to save "%s".', |
|
548 | + 'event_espresso' |
|
549 | + ), |
|
550 | + $config_class |
|
551 | + ) |
|
552 | + ); |
|
553 | + } |
|
554 | + return false; |
|
555 | + } |
|
556 | + break; |
|
557 | + // TEST #2 : check that settings section exists |
|
558 | + case 2: |
|
559 | + if (! isset($this->{$section})) { |
|
560 | + if ($display_errors) { |
|
561 | + throw new EE_Error( |
|
562 | + sprintf( |
|
563 | + __('The "%s" configuration section does not exist.', 'event_espresso'), |
|
564 | + $section |
|
565 | + ) |
|
566 | + ); |
|
567 | + } |
|
568 | + return false; |
|
569 | + } |
|
570 | + break; |
|
571 | + // TEST #3 : check that section is the proper format |
|
572 | + case 3: |
|
573 | + if (! ($this->{$section} instanceof EE_Config_Base || $this->{$section} instanceof stdClass) |
|
574 | + ) { |
|
575 | + if ($display_errors) { |
|
576 | + throw new EE_Error( |
|
577 | + sprintf( |
|
578 | + __( |
|
579 | + 'The "%s" configuration settings have not been formatted correctly.', |
|
580 | + 'event_espresso' |
|
581 | + ), |
|
582 | + $section |
|
583 | + ) |
|
584 | + ); |
|
585 | + } |
|
586 | + return false; |
|
587 | + } |
|
588 | + break; |
|
589 | + // TEST #4 : check that config section name has been set |
|
590 | + case 4: |
|
591 | + if (empty($name)) { |
|
592 | + if ($display_errors) { |
|
593 | + throw new EE_Error( |
|
594 | + __( |
|
595 | + 'No name has been provided for the specific configuration section.', |
|
596 | + 'event_espresso' |
|
597 | + ) |
|
598 | + ); |
|
599 | + } |
|
600 | + return false; |
|
601 | + } |
|
602 | + break; |
|
603 | + // TEST #5 : check that a config class name has been set |
|
604 | + case 5: |
|
605 | + if (empty($config_class)) { |
|
606 | + if ($display_errors) { |
|
607 | + throw new EE_Error( |
|
608 | + __( |
|
609 | + 'No class name has been provided for the specific configuration section.', |
|
610 | + 'event_espresso' |
|
611 | + ) |
|
612 | + ); |
|
613 | + } |
|
614 | + return false; |
|
615 | + } |
|
616 | + break; |
|
617 | + // TEST #6 : verify config class is accessible |
|
618 | + case 6: |
|
619 | + if (! class_exists($config_class)) { |
|
620 | + if ($display_errors) { |
|
621 | + throw new EE_Error( |
|
622 | + sprintf( |
|
623 | + __( |
|
624 | + 'The "%s" class does not exist. Please ensure that an autoloader has been set for it.', |
|
625 | + 'event_espresso' |
|
626 | + ), |
|
627 | + $config_class |
|
628 | + ) |
|
629 | + ); |
|
630 | + } |
|
631 | + return false; |
|
632 | + } |
|
633 | + break; |
|
634 | + // TEST #7 : check that config has even been set |
|
635 | + case 7: |
|
636 | + if (! isset($this->{$section}->{$name})) { |
|
637 | + if ($display_errors) { |
|
638 | + throw new EE_Error( |
|
639 | + sprintf( |
|
640 | + __('No configuration has been set for "%1$s->%2$s".', 'event_espresso'), |
|
641 | + $section, |
|
642 | + $name |
|
643 | + ) |
|
644 | + ); |
|
645 | + } |
|
646 | + return false; |
|
647 | + } else { |
|
648 | + // and make sure it's not serialized |
|
649 | + $this->{$section}->{$name} = maybe_unserialize($this->{$section}->{$name}); |
|
650 | + } |
|
651 | + break; |
|
652 | + // TEST #8 : check that config is the requested type |
|
653 | + case 8: |
|
654 | + if (! $this->{$section}->{$name} instanceof $config_class) { |
|
655 | + if ($display_errors) { |
|
656 | + throw new EE_Error( |
|
657 | + sprintf( |
|
658 | + __( |
|
659 | + 'The configuration for "%1$s->%2$s" is not of the "%3$s" class.', |
|
660 | + 'event_espresso' |
|
661 | + ), |
|
662 | + $section, |
|
663 | + $name, |
|
664 | + $config_class |
|
665 | + ) |
|
666 | + ); |
|
667 | + } |
|
668 | + return false; |
|
669 | + } |
|
670 | + break; |
|
671 | + // TEST #9 : verify config object |
|
672 | + case 9: |
|
673 | + if (! $config_obj instanceof EE_Config_Base) { |
|
674 | + if ($display_errors) { |
|
675 | + throw new EE_Error( |
|
676 | + sprintf( |
|
677 | + __('The "%s" class is not an instance of EE_Config_Base.', 'event_espresso'), |
|
678 | + print_r($config_obj, true) |
|
679 | + ) |
|
680 | + ); |
|
681 | + } |
|
682 | + return false; |
|
683 | + } |
|
684 | + break; |
|
685 | + } |
|
686 | + } |
|
687 | + } catch (EE_Error $e) { |
|
688 | + $e->get_error(); |
|
689 | + } |
|
690 | + // you have successfully run the gauntlet |
|
691 | + return true; |
|
692 | + } |
|
693 | + |
|
694 | + |
|
695 | + /** |
|
696 | + * _generate_config_option_name |
|
697 | + * |
|
698 | + * @access protected |
|
699 | + * @param string $section |
|
700 | + * @param string $name |
|
701 | + * @return string |
|
702 | + */ |
|
703 | + private function _generate_config_option_name($section = '', $name = '') |
|
704 | + { |
|
705 | + return 'ee_config-' . strtolower($section . '-' . str_replace(array('EE_', 'EED_'), '', $name)); |
|
706 | + } |
|
707 | + |
|
708 | + |
|
709 | + /** |
|
710 | + * _set_config_class |
|
711 | + * ensures that a config class is set, either from a passed config class or one generated from the config name |
|
712 | + * |
|
713 | + * @access private |
|
714 | + * @param string $config_class |
|
715 | + * @param string $name |
|
716 | + * @return string |
|
717 | + */ |
|
718 | + private function _set_config_class($config_class = '', $name = '') |
|
719 | + { |
|
720 | + return ! empty($config_class) |
|
721 | + ? $config_class |
|
722 | + : str_replace(' ', '_', ucwords(str_replace('_', ' ', $name))) . '_Config'; |
|
723 | + } |
|
724 | + |
|
725 | + |
|
726 | + /** |
|
727 | + * set_config |
|
728 | + * |
|
729 | + * @access protected |
|
730 | + * @param string $section |
|
731 | + * @param string $name |
|
732 | + * @param string $config_class |
|
733 | + * @param EE_Config_Base $config_obj |
|
734 | + * @return EE_Config_Base |
|
735 | + */ |
|
736 | + public function set_config($section = '', $name = '', $config_class = '', EE_Config_Base $config_obj = null) |
|
737 | + { |
|
738 | + // ensure config class is set to something |
|
739 | + $config_class = $this->_set_config_class($config_class, $name); |
|
740 | + // run tests 1-4, 6, and 7 to verify all config params are set and valid |
|
741 | + if (! $this->_verify_config_params($section, $name, $config_class, null, array(1, 2, 3, 4, 5, 6))) { |
|
742 | + return null; |
|
743 | + } |
|
744 | + $config_option_name = $this->_generate_config_option_name($section, $name); |
|
745 | + // if the config option name hasn't been added yet to the list of option names we're tracking, then do so now |
|
746 | + if (! isset($this->_addon_option_names[ $config_option_name ])) { |
|
747 | + $this->_addon_option_names[ $config_option_name ] = $config_class; |
|
748 | + $this->update_addon_option_names(); |
|
749 | + } |
|
750 | + // verify the incoming config object but suppress errors |
|
751 | + if (! $this->_verify_config_params($section, $name, $config_class, $config_obj, array(9), false)) { |
|
752 | + $config_obj = new $config_class(); |
|
753 | + } |
|
754 | + if (get_option($config_option_name)) { |
|
755 | + EE_Config::log($config_option_name); |
|
756 | + update_option($config_option_name, $config_obj); |
|
757 | + $this->{$section}->{$name} = $config_obj; |
|
758 | + return $this->{$section}->{$name}; |
|
759 | + } else { |
|
760 | + // create a wp-option for this config |
|
761 | + if (add_option($config_option_name, $config_obj, '', 'no')) { |
|
762 | + $this->{$section}->{$name} = maybe_unserialize($config_obj); |
|
763 | + return $this->{$section}->{$name}; |
|
764 | + } else { |
|
765 | + EE_Error::add_error( |
|
766 | + sprintf(__('The "%s" could not be saved to the database.', 'event_espresso'), $config_class), |
|
767 | + __FILE__, |
|
768 | + __FUNCTION__, |
|
769 | + __LINE__ |
|
770 | + ); |
|
771 | + return null; |
|
772 | + } |
|
773 | + } |
|
774 | + } |
|
775 | + |
|
776 | + |
|
777 | + /** |
|
778 | + * update_config |
|
779 | + * Important: the config object must ALREADY be set, otherwise this will produce an error. |
|
780 | + * |
|
781 | + * @access public |
|
782 | + * @param string $section |
|
783 | + * @param string $name |
|
784 | + * @param EE_Config_Base|string $config_obj |
|
785 | + * @param bool $throw_errors |
|
786 | + * @return bool |
|
787 | + */ |
|
788 | + public function update_config($section = '', $name = '', $config_obj = '', $throw_errors = true) |
|
789 | + { |
|
790 | + // don't allow config updates during WP heartbeats |
|
791 | + if (\EE_Registry::instance()->REQ->get('action', '') === 'heartbeat') { |
|
792 | + return false; |
|
793 | + } |
|
794 | + $config_obj = maybe_unserialize($config_obj); |
|
795 | + // get class name of the incoming object |
|
796 | + $config_class = get_class($config_obj); |
|
797 | + // run tests 1-5 and 9 to verify config |
|
798 | + if (! $this->_verify_config_params( |
|
799 | + $section, |
|
800 | + $name, |
|
801 | + $config_class, |
|
802 | + $config_obj, |
|
803 | + array(1, 2, 3, 4, 7, 9) |
|
804 | + ) |
|
805 | + ) { |
|
806 | + return false; |
|
807 | + } |
|
808 | + $config_option_name = $this->_generate_config_option_name($section, $name); |
|
809 | + // check if config object has been added to db by seeing if config option name is in $this->_addon_option_names array |
|
810 | + if (! isset($this->_addon_option_names[ $config_option_name ])) { |
|
811 | + // save new config to db |
|
812 | + if ($this->set_config($section, $name, $config_class, $config_obj)) { |
|
813 | + return true; |
|
814 | + } |
|
815 | + } else { |
|
816 | + // first check if the record already exists |
|
817 | + $existing_config = get_option($config_option_name); |
|
818 | + $config_obj = serialize($config_obj); |
|
819 | + // just return if db record is already up to date (NOT type safe comparison) |
|
820 | + if ($existing_config == $config_obj) { |
|
821 | + $this->{$section}->{$name} = $config_obj; |
|
822 | + return true; |
|
823 | + } elseif (update_option($config_option_name, $config_obj)) { |
|
824 | + EE_Config::log($config_option_name); |
|
825 | + // update wp-option for this config class |
|
826 | + $this->{$section}->{$name} = $config_obj; |
|
827 | + return true; |
|
828 | + } elseif ($throw_errors) { |
|
829 | + EE_Error::add_error( |
|
830 | + sprintf( |
|
831 | + __( |
|
832 | + 'The "%1$s" object stored at"%2$s" was not successfully updated in the database.', |
|
833 | + 'event_espresso' |
|
834 | + ), |
|
835 | + $config_class, |
|
836 | + 'EE_Config->' . $section . '->' . $name |
|
837 | + ), |
|
838 | + __FILE__, |
|
839 | + __FUNCTION__, |
|
840 | + __LINE__ |
|
841 | + ); |
|
842 | + } |
|
843 | + } |
|
844 | + return false; |
|
845 | + } |
|
846 | + |
|
847 | + |
|
848 | + /** |
|
849 | + * get_config |
|
850 | + * |
|
851 | + * @access public |
|
852 | + * @param string $section |
|
853 | + * @param string $name |
|
854 | + * @param string $config_class |
|
855 | + * @return mixed EE_Config_Base | NULL |
|
856 | + */ |
|
857 | + public function get_config($section = '', $name = '', $config_class = '') |
|
858 | + { |
|
859 | + // ensure config class is set to something |
|
860 | + $config_class = $this->_set_config_class($config_class, $name); |
|
861 | + // run tests 1-4, 6 and 7 to verify that all params have been set |
|
862 | + if (! $this->_verify_config_params($section, $name, $config_class, null, array(1, 2, 3, 4, 5, 6))) { |
|
863 | + return null; |
|
864 | + } |
|
865 | + // now test if the requested config object exists, but suppress errors |
|
866 | + if ($this->_verify_config_params($section, $name, $config_class, null, array(7, 8), false)) { |
|
867 | + // config already exists, so pass it back |
|
868 | + return $this->{$section}->{$name}; |
|
869 | + } |
|
870 | + // load config option from db if it exists |
|
871 | + $config_obj = $this->get_config_option($this->_generate_config_option_name($section, $name)); |
|
872 | + // verify the newly retrieved config object, but suppress errors |
|
873 | + if ($this->_verify_config_params($section, $name, $config_class, $config_obj, array(9), false)) { |
|
874 | + // config is good, so set it and pass it back |
|
875 | + $this->{$section}->{$name} = $config_obj; |
|
876 | + return $this->{$section}->{$name}; |
|
877 | + } |
|
878 | + // oops! $config_obj is not already set and does not exist in the db, so create a new one |
|
879 | + $config_obj = $this->set_config($section, $name, $config_class); |
|
880 | + // verify the newly created config object |
|
881 | + if ($this->_verify_config_params($section, $name, $config_class, $config_obj, array(9))) { |
|
882 | + return $this->{$section}->{$name}; |
|
883 | + } else { |
|
884 | + EE_Error::add_error( |
|
885 | + sprintf(__('The "%s" could not be retrieved from the database.', 'event_espresso'), $config_class), |
|
886 | + __FILE__, |
|
887 | + __FUNCTION__, |
|
888 | + __LINE__ |
|
889 | + ); |
|
890 | + } |
|
891 | + return null; |
|
892 | + } |
|
893 | + |
|
894 | + |
|
895 | + /** |
|
896 | + * get_config_option |
|
897 | + * |
|
898 | + * @access public |
|
899 | + * @param string $config_option_name |
|
900 | + * @return mixed EE_Config_Base | FALSE |
|
901 | + */ |
|
902 | + public function get_config_option($config_option_name = '') |
|
903 | + { |
|
904 | + // retrieve the wp-option for this config class. |
|
905 | + $config_option = maybe_unserialize(get_option($config_option_name, array())); |
|
906 | + if (empty($config_option)) { |
|
907 | + EE_Config::log($config_option_name . '-NOT-FOUND'); |
|
908 | + } |
|
909 | + return $config_option; |
|
910 | + } |
|
911 | + |
|
912 | + |
|
913 | + /** |
|
914 | + * log |
|
915 | + * |
|
916 | + * @param string $config_option_name |
|
917 | + */ |
|
918 | + public static function log($config_option_name = '') |
|
919 | + { |
|
920 | + if (EE_Config::logging_enabled() && ! empty($config_option_name)) { |
|
921 | + $config_log = get_option(EE_Config::LOG_NAME, array()); |
|
922 | + // copy incoming $_REQUEST and sanitize it so we can save it |
|
923 | + $_request = $_REQUEST; |
|
924 | + array_walk_recursive($_request, 'sanitize_text_field'); |
|
925 | + $config_log[ (string) microtime(true) ] = array( |
|
926 | + 'config_name' => $config_option_name, |
|
927 | + 'request' => $_request, |
|
928 | + ); |
|
929 | + update_option(EE_Config::LOG_NAME, $config_log); |
|
930 | + } |
|
931 | + } |
|
932 | + |
|
933 | + |
|
934 | + /** |
|
935 | + * trim_log |
|
936 | + * reduces the size of the config log to the length specified by EE_Config::LOG_LENGTH |
|
937 | + */ |
|
938 | + public static function trim_log() |
|
939 | + { |
|
940 | + if (! EE_Config::logging_enabled()) { |
|
941 | + return; |
|
942 | + } |
|
943 | + $config_log = maybe_unserialize(get_option(EE_Config::LOG_NAME, array())); |
|
944 | + $log_length = count($config_log); |
|
945 | + if ($log_length > EE_Config::LOG_LENGTH) { |
|
946 | + ksort($config_log); |
|
947 | + $config_log = array_slice($config_log, $log_length - EE_Config::LOG_LENGTH, null, true); |
|
948 | + update_option(EE_Config::LOG_NAME, $config_log); |
|
949 | + } |
|
950 | + } |
|
951 | + |
|
952 | + |
|
953 | + /** |
|
954 | + * get_page_for_posts |
|
955 | + * if the wp-option "show_on_front" is set to "page", then this is the post_name for the post set in the |
|
956 | + * wp-option "page_for_posts", or "posts" if no page is selected |
|
957 | + * |
|
958 | + * @access public |
|
959 | + * @return string |
|
960 | + */ |
|
961 | + public static function get_page_for_posts() |
|
962 | + { |
|
963 | + $page_for_posts = get_option('page_for_posts'); |
|
964 | + if (! $page_for_posts) { |
|
965 | + return 'posts'; |
|
966 | + } |
|
967 | + /** @type WPDB $wpdb */ |
|
968 | + global $wpdb; |
|
969 | + $SQL = "SELECT post_name from $wpdb->posts WHERE post_type='posts' OR post_type='page' AND post_status='publish' AND ID=%d"; |
|
970 | + return $wpdb->get_var($wpdb->prepare($SQL, $page_for_posts)); |
|
971 | + } |
|
972 | + |
|
973 | + |
|
974 | + /** |
|
975 | + * register_shortcodes_and_modules. |
|
976 | + * At this point, it's too early to tell if we're maintenance mode or not. |
|
977 | + * In fact, this is where we give modules a chance to let core know they exist |
|
978 | + * so they can help trigger maintenance mode if it's needed |
|
979 | + * |
|
980 | + * @access public |
|
981 | + * @return void |
|
982 | + */ |
|
983 | + public function register_shortcodes_and_modules() |
|
984 | + { |
|
985 | + // allow modules to set hooks for the rest of the system |
|
986 | + EE_Registry::instance()->modules = $this->_register_modules(); |
|
987 | + } |
|
988 | + |
|
989 | + |
|
990 | + /** |
|
991 | + * initialize_shortcodes_and_modules |
|
992 | + * meaning they can start adding their hooks to get stuff done |
|
993 | + * |
|
994 | + * @access public |
|
995 | + * @return void |
|
996 | + */ |
|
997 | + public function initialize_shortcodes_and_modules() |
|
998 | + { |
|
999 | + // allow modules to set hooks for the rest of the system |
|
1000 | + $this->_initialize_modules(); |
|
1001 | + } |
|
1002 | + |
|
1003 | + |
|
1004 | + /** |
|
1005 | + * widgets_init |
|
1006 | + * |
|
1007 | + * @access private |
|
1008 | + * @return void |
|
1009 | + */ |
|
1010 | + public function widgets_init() |
|
1011 | + { |
|
1012 | + // only init widgets on admin pages when not in complete maintenance, and |
|
1013 | + // on frontend when not in any maintenance mode |
|
1014 | + if (! EE_Maintenance_Mode::instance()->level() |
|
1015 | + || ( |
|
1016 | + is_admin() |
|
1017 | + && EE_Maintenance_Mode::instance()->level() !== EE_Maintenance_Mode::level_2_complete_maintenance |
|
1018 | + ) |
|
1019 | + ) { |
|
1020 | + // grab list of installed widgets |
|
1021 | + $widgets_to_register = glob(EE_WIDGETS . '*', GLOB_ONLYDIR); |
|
1022 | + // filter list of modules to register |
|
1023 | + $widgets_to_register = apply_filters( |
|
1024 | + 'FHEE__EE_Config__register_widgets__widgets_to_register', |
|
1025 | + $widgets_to_register |
|
1026 | + ); |
|
1027 | + if (! empty($widgets_to_register)) { |
|
1028 | + // cycle thru widget folders |
|
1029 | + foreach ($widgets_to_register as $widget_path) { |
|
1030 | + // add to list of installed widget modules |
|
1031 | + EE_Config::register_ee_widget($widget_path); |
|
1032 | + } |
|
1033 | + } |
|
1034 | + // filter list of installed modules |
|
1035 | + EE_Registry::instance()->widgets = apply_filters( |
|
1036 | + 'FHEE__EE_Config__register_widgets__installed_widgets', |
|
1037 | + EE_Registry::instance()->widgets |
|
1038 | + ); |
|
1039 | + } |
|
1040 | + } |
|
1041 | + |
|
1042 | + |
|
1043 | + /** |
|
1044 | + * register_ee_widget - makes core aware of this widget |
|
1045 | + * |
|
1046 | + * @access public |
|
1047 | + * @param string $widget_path - full path up to and including widget folder |
|
1048 | + * @return void |
|
1049 | + */ |
|
1050 | + public static function register_ee_widget($widget_path = null) |
|
1051 | + { |
|
1052 | + do_action('AHEE__EE_Config__register_widget__begin', $widget_path); |
|
1053 | + $widget_ext = '.widget.php'; |
|
1054 | + // make all separators match |
|
1055 | + $widget_path = rtrim(str_replace('\\', DS, $widget_path), DS); |
|
1056 | + // does the file path INCLUDE the actual file name as part of the path ? |
|
1057 | + if (strpos($widget_path, $widget_ext) !== false) { |
|
1058 | + // grab and shortcode file name from directory name and break apart at dots |
|
1059 | + $file_name = explode('.', basename($widget_path)); |
|
1060 | + // take first segment from file name pieces and remove class prefix if it exists |
|
1061 | + $widget = strpos($file_name[0], 'EEW_') === 0 ? substr($file_name[0], 4) : $file_name[0]; |
|
1062 | + // sanitize shortcode directory name |
|
1063 | + $widget = sanitize_key($widget); |
|
1064 | + // now we need to rebuild the shortcode path |
|
1065 | + $widget_path = explode(DS, $widget_path); |
|
1066 | + // remove last segment |
|
1067 | + array_pop($widget_path); |
|
1068 | + // glue it back together |
|
1069 | + $widget_path = implode(DS, $widget_path); |
|
1070 | + } else { |
|
1071 | + // grab and sanitize widget directory name |
|
1072 | + $widget = sanitize_key(basename($widget_path)); |
|
1073 | + } |
|
1074 | + // create classname from widget directory name |
|
1075 | + $widget = str_replace(' ', '_', ucwords(str_replace('_', ' ', $widget))); |
|
1076 | + // add class prefix |
|
1077 | + $widget_class = 'EEW_' . $widget; |
|
1078 | + // does the widget exist ? |
|
1079 | + if (! is_readable($widget_path . DS . $widget_class . $widget_ext)) { |
|
1080 | + $msg = sprintf( |
|
1081 | + __( |
|
1082 | + 'The requested %s widget file could not be found or is not readable due to file permissions. Please ensure the following path is correct: %s', |
|
1083 | + 'event_espresso' |
|
1084 | + ), |
|
1085 | + $widget_class, |
|
1086 | + $widget_path . DS . $widget_class . $widget_ext |
|
1087 | + ); |
|
1088 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1089 | + return; |
|
1090 | + } |
|
1091 | + // load the widget class file |
|
1092 | + require_once($widget_path . DS . $widget_class . $widget_ext); |
|
1093 | + // verify that class exists |
|
1094 | + if (! class_exists($widget_class)) { |
|
1095 | + $msg = sprintf(__('The requested %s widget class does not exist.', 'event_espresso'), $widget_class); |
|
1096 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1097 | + return; |
|
1098 | + } |
|
1099 | + register_widget($widget_class); |
|
1100 | + // add to array of registered widgets |
|
1101 | + EE_Registry::instance()->widgets->{$widget_class} = $widget_path . DS . $widget_class . $widget_ext; |
|
1102 | + } |
|
1103 | + |
|
1104 | + |
|
1105 | + /** |
|
1106 | + * _register_modules |
|
1107 | + * |
|
1108 | + * @access private |
|
1109 | + * @return array |
|
1110 | + */ |
|
1111 | + private function _register_modules() |
|
1112 | + { |
|
1113 | + // grab list of installed modules |
|
1114 | + $modules_to_register = glob(EE_MODULES . '*', GLOB_ONLYDIR); |
|
1115 | + // filter list of modules to register |
|
1116 | + $modules_to_register = apply_filters( |
|
1117 | + 'FHEE__EE_Config__register_modules__modules_to_register', |
|
1118 | + $modules_to_register |
|
1119 | + ); |
|
1120 | + if (! empty($modules_to_register)) { |
|
1121 | + // loop through folders |
|
1122 | + foreach ($modules_to_register as $module_path) { |
|
1123 | + /**TEMPORARILY EXCLUDE gateways from modules for time being**/ |
|
1124 | + if ($module_path !== EE_MODULES . 'zzz-copy-this-module-template' |
|
1125 | + && $module_path !== EE_MODULES . 'gateways' |
|
1126 | + ) { |
|
1127 | + // add to list of installed modules |
|
1128 | + EE_Config::register_module($module_path); |
|
1129 | + } |
|
1130 | + } |
|
1131 | + } |
|
1132 | + // filter list of installed modules |
|
1133 | + return apply_filters( |
|
1134 | + 'FHEE__EE_Config___register_modules__installed_modules', |
|
1135 | + EE_Registry::instance()->modules |
|
1136 | + ); |
|
1137 | + } |
|
1138 | + |
|
1139 | + |
|
1140 | + /** |
|
1141 | + * register_module - makes core aware of this module |
|
1142 | + * |
|
1143 | + * @access public |
|
1144 | + * @param string $module_path - full path up to and including module folder |
|
1145 | + * @return bool |
|
1146 | + */ |
|
1147 | + public static function register_module($module_path = null) |
|
1148 | + { |
|
1149 | + do_action('AHEE__EE_Config__register_module__begin', $module_path); |
|
1150 | + $module_ext = '.module.php'; |
|
1151 | + // make all separators match |
|
1152 | + $module_path = str_replace(array('\\', '/'), DS, $module_path); |
|
1153 | + // does the file path INCLUDE the actual file name as part of the path ? |
|
1154 | + if (strpos($module_path, $module_ext) !== false) { |
|
1155 | + // grab and shortcode file name from directory name and break apart at dots |
|
1156 | + $module_file = explode('.', basename($module_path)); |
|
1157 | + // now we need to rebuild the shortcode path |
|
1158 | + $module_path = explode(DS, $module_path); |
|
1159 | + // remove last segment |
|
1160 | + array_pop($module_path); |
|
1161 | + // glue it back together |
|
1162 | + $module_path = implode(DS, $module_path) . DS; |
|
1163 | + // take first segment from file name pieces and sanitize it |
|
1164 | + $module = preg_replace('/[^a-zA-Z0-9_\-]/', '', $module_file[0]); |
|
1165 | + // ensure class prefix is added |
|
1166 | + $module_class = strpos($module, 'EED_') !== 0 ? 'EED_' . $module : $module; |
|
1167 | + } else { |
|
1168 | + // we need to generate the filename based off of the folder name |
|
1169 | + // grab and sanitize module name |
|
1170 | + $module = strtolower(basename($module_path)); |
|
1171 | + $module = preg_replace('/[^a-z0-9_\-]/', '', $module); |
|
1172 | + // like trailingslashit() |
|
1173 | + $module_path = rtrim($module_path, DS) . DS; |
|
1174 | + // create classname from module directory name |
|
1175 | + $module = str_replace(' ', '_', ucwords(str_replace('_', ' ', $module))); |
|
1176 | + // add class prefix |
|
1177 | + $module_class = 'EED_' . $module; |
|
1178 | + } |
|
1179 | + // does the module exist ? |
|
1180 | + if (! is_readable($module_path . DS . $module_class . $module_ext)) { |
|
1181 | + $msg = sprintf( |
|
1182 | + __( |
|
1183 | + 'The requested %s module file could not be found or is not readable due to file permissions.', |
|
1184 | + 'event_espresso' |
|
1185 | + ), |
|
1186 | + $module |
|
1187 | + ); |
|
1188 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1189 | + return false; |
|
1190 | + } |
|
1191 | + // load the module class file |
|
1192 | + require_once($module_path . $module_class . $module_ext); |
|
1193 | + // verify that class exists |
|
1194 | + if (! class_exists($module_class)) { |
|
1195 | + $msg = sprintf(__('The requested %s module class does not exist.', 'event_espresso'), $module_class); |
|
1196 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1197 | + return false; |
|
1198 | + } |
|
1199 | + // add to array of registered modules |
|
1200 | + EE_Registry::instance()->modules->{$module_class} = $module_path . $module_class . $module_ext; |
|
1201 | + do_action( |
|
1202 | + 'AHEE__EE_Config__register_module__complete', |
|
1203 | + $module_class, |
|
1204 | + EE_Registry::instance()->modules->{$module_class} |
|
1205 | + ); |
|
1206 | + return true; |
|
1207 | + } |
|
1208 | + |
|
1209 | + |
|
1210 | + /** |
|
1211 | + * _initialize_modules |
|
1212 | + * allow modules to set hooks for the rest of the system |
|
1213 | + * |
|
1214 | + * @access private |
|
1215 | + * @return void |
|
1216 | + */ |
|
1217 | + private function _initialize_modules() |
|
1218 | + { |
|
1219 | + // cycle thru shortcode folders |
|
1220 | + foreach (EE_Registry::instance()->modules as $module_class => $module_path) { |
|
1221 | + // fire the shortcode class's set_hooks methods in case it needs to hook into other parts of the system |
|
1222 | + // which set hooks ? |
|
1223 | + if (is_admin()) { |
|
1224 | + // fire immediately |
|
1225 | + call_user_func(array($module_class, 'set_hooks_admin')); |
|
1226 | + } else { |
|
1227 | + // delay until other systems are online |
|
1228 | + add_action( |
|
1229 | + 'AHEE__EE_System__set_hooks_for_shortcodes_modules_and_addons', |
|
1230 | + array($module_class, 'set_hooks') |
|
1231 | + ); |
|
1232 | + } |
|
1233 | + } |
|
1234 | + } |
|
1235 | + |
|
1236 | + |
|
1237 | + /** |
|
1238 | + * register_route - adds module method routes to route_map |
|
1239 | + * |
|
1240 | + * @access public |
|
1241 | + * @param string $route - "pretty" public alias for module method |
|
1242 | + * @param string $module - module name (classname without EED_ prefix) |
|
1243 | + * @param string $method_name - the actual module method to be routed to |
|
1244 | + * @param string $key - url param key indicating a route is being called |
|
1245 | + * @return bool |
|
1246 | + */ |
|
1247 | + public static function register_route($route = null, $module = null, $method_name = null, $key = 'ee') |
|
1248 | + { |
|
1249 | + do_action('AHEE__EE_Config__register_route__begin', $route, $module, $method_name); |
|
1250 | + $module = str_replace('EED_', '', $module); |
|
1251 | + $module_class = 'EED_' . $module; |
|
1252 | + if (! isset(EE_Registry::instance()->modules->{$module_class})) { |
|
1253 | + $msg = sprintf(__('The module %s has not been registered.', 'event_espresso'), $module); |
|
1254 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1255 | + return false; |
|
1256 | + } |
|
1257 | + if (empty($route)) { |
|
1258 | + $msg = sprintf(__('No route has been supplied.', 'event_espresso'), $route); |
|
1259 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1260 | + return false; |
|
1261 | + } |
|
1262 | + if (! method_exists('EED_' . $module, $method_name)) { |
|
1263 | + $msg = sprintf( |
|
1264 | + __('A valid class method for the %s route has not been supplied.', 'event_espresso'), |
|
1265 | + $route |
|
1266 | + ); |
|
1267 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1268 | + return false; |
|
1269 | + } |
|
1270 | + EE_Config::$_module_route_map[ (string) $key ][ (string) $route ] = array('EED_' . $module, $method_name); |
|
1271 | + return true; |
|
1272 | + } |
|
1273 | + |
|
1274 | + |
|
1275 | + /** |
|
1276 | + * get_route - get module method route |
|
1277 | + * |
|
1278 | + * @access public |
|
1279 | + * @param string $route - "pretty" public alias for module method |
|
1280 | + * @param string $key - url param key indicating a route is being called |
|
1281 | + * @return string |
|
1282 | + */ |
|
1283 | + public static function get_route($route = null, $key = 'ee') |
|
1284 | + { |
|
1285 | + do_action('AHEE__EE_Config__get_route__begin', $route); |
|
1286 | + $route = (string) apply_filters('FHEE__EE_Config__get_route', $route); |
|
1287 | + if (isset(EE_Config::$_module_route_map[ $key ][ $route ])) { |
|
1288 | + return EE_Config::$_module_route_map[ $key ][ $route ]; |
|
1289 | + } |
|
1290 | + return null; |
|
1291 | + } |
|
1292 | + |
|
1293 | + |
|
1294 | + /** |
|
1295 | + * get_routes - get ALL module method routes |
|
1296 | + * |
|
1297 | + * @access public |
|
1298 | + * @return array |
|
1299 | + */ |
|
1300 | + public static function get_routes() |
|
1301 | + { |
|
1302 | + return EE_Config::$_module_route_map; |
|
1303 | + } |
|
1304 | + |
|
1305 | + |
|
1306 | + /** |
|
1307 | + * register_forward - allows modules to forward request to another module for further processing |
|
1308 | + * |
|
1309 | + * @access public |
|
1310 | + * @param string $route - "pretty" public alias for module method |
|
1311 | + * @param integer $status - integer value corresponding to status constant strings set in module parent |
|
1312 | + * class, allows different forwards to be served based on status |
|
1313 | + * @param array|string $forward - function name or array( class, method ) |
|
1314 | + * @param string $key - url param key indicating a route is being called |
|
1315 | + * @return bool |
|
1316 | + */ |
|
1317 | + public static function register_forward($route = null, $status = 0, $forward = null, $key = 'ee') |
|
1318 | + { |
|
1319 | + do_action('AHEE__EE_Config__register_forward', $route, $status, $forward); |
|
1320 | + if (! isset(EE_Config::$_module_route_map[ $key ][ $route ]) || empty($route)) { |
|
1321 | + $msg = sprintf( |
|
1322 | + __('The module route %s for this forward has not been registered.', 'event_espresso'), |
|
1323 | + $route |
|
1324 | + ); |
|
1325 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1326 | + return false; |
|
1327 | + } |
|
1328 | + if (empty($forward)) { |
|
1329 | + $msg = sprintf(__('No forwarding route has been supplied.', 'event_espresso'), $route); |
|
1330 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1331 | + return false; |
|
1332 | + } |
|
1333 | + if (is_array($forward)) { |
|
1334 | + if (! isset($forward[1])) { |
|
1335 | + $msg = sprintf( |
|
1336 | + __('A class method for the %s forwarding route has not been supplied.', 'event_espresso'), |
|
1337 | + $route |
|
1338 | + ); |
|
1339 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1340 | + return false; |
|
1341 | + } |
|
1342 | + if (! method_exists($forward[0], $forward[1])) { |
|
1343 | + $msg = sprintf( |
|
1344 | + __('The class method %s for the %s forwarding route is in invalid.', 'event_espresso'), |
|
1345 | + $forward[1], |
|
1346 | + $route |
|
1347 | + ); |
|
1348 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1349 | + return false; |
|
1350 | + } |
|
1351 | + } elseif (! function_exists($forward)) { |
|
1352 | + $msg = sprintf( |
|
1353 | + __('The function %s for the %s forwarding route is in invalid.', 'event_espresso'), |
|
1354 | + $forward, |
|
1355 | + $route |
|
1356 | + ); |
|
1357 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1358 | + return false; |
|
1359 | + } |
|
1360 | + EE_Config::$_module_forward_map[ $key ][ $route ][ absint($status) ] = $forward; |
|
1361 | + return true; |
|
1362 | + } |
|
1363 | + |
|
1364 | + |
|
1365 | + /** |
|
1366 | + * get_forward - get forwarding route |
|
1367 | + * |
|
1368 | + * @access public |
|
1369 | + * @param string $route - "pretty" public alias for module method |
|
1370 | + * @param integer $status - integer value corresponding to status constant strings set in module parent class, |
|
1371 | + * allows different forwards to be served based on status |
|
1372 | + * @param string $key - url param key indicating a route is being called |
|
1373 | + * @return string |
|
1374 | + */ |
|
1375 | + public static function get_forward($route = null, $status = 0, $key = 'ee') |
|
1376 | + { |
|
1377 | + do_action('AHEE__EE_Config__get_forward__begin', $route, $status); |
|
1378 | + if (isset(EE_Config::$_module_forward_map[ $key ][ $route ][ $status ])) { |
|
1379 | + return apply_filters( |
|
1380 | + 'FHEE__EE_Config__get_forward', |
|
1381 | + EE_Config::$_module_forward_map[ $key ][ $route ][ $status ], |
|
1382 | + $route, |
|
1383 | + $status |
|
1384 | + ); |
|
1385 | + } |
|
1386 | + return null; |
|
1387 | + } |
|
1388 | + |
|
1389 | + |
|
1390 | + /** |
|
1391 | + * register_forward - allows modules to specify different view templates for different method routes and status |
|
1392 | + * results |
|
1393 | + * |
|
1394 | + * @access public |
|
1395 | + * @param string $route - "pretty" public alias for module method |
|
1396 | + * @param integer $status - integer value corresponding to status constant strings set in module parent class, |
|
1397 | + * allows different views to be served based on status |
|
1398 | + * @param string $view |
|
1399 | + * @param string $key - url param key indicating a route is being called |
|
1400 | + * @return bool |
|
1401 | + */ |
|
1402 | + public static function register_view($route = null, $status = 0, $view = null, $key = 'ee') |
|
1403 | + { |
|
1404 | + do_action('AHEE__EE_Config__register_view__begin', $route, $status, $view); |
|
1405 | + if (! isset(EE_Config::$_module_route_map[ $key ][ $route ]) || empty($route)) { |
|
1406 | + $msg = sprintf( |
|
1407 | + __('The module route %s for this view has not been registered.', 'event_espresso'), |
|
1408 | + $route |
|
1409 | + ); |
|
1410 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1411 | + return false; |
|
1412 | + } |
|
1413 | + if (! is_readable($view)) { |
|
1414 | + $msg = sprintf( |
|
1415 | + __( |
|
1416 | + 'The %s view file could not be found or is not readable due to file permissions.', |
|
1417 | + 'event_espresso' |
|
1418 | + ), |
|
1419 | + $view |
|
1420 | + ); |
|
1421 | + EE_Error::add_error($msg . '||' . $msg, __FILE__, __FUNCTION__, __LINE__); |
|
1422 | + return false; |
|
1423 | + } |
|
1424 | + EE_Config::$_module_view_map[ $key ][ $route ][ absint($status) ] = $view; |
|
1425 | + return true; |
|
1426 | + } |
|
1427 | + |
|
1428 | + |
|
1429 | + /** |
|
1430 | + * get_view - get view for route and status |
|
1431 | + * |
|
1432 | + * @access public |
|
1433 | + * @param string $route - "pretty" public alias for module method |
|
1434 | + * @param integer $status - integer value corresponding to status constant strings set in module parent class, |
|
1435 | + * allows different views to be served based on status |
|
1436 | + * @param string $key - url param key indicating a route is being called |
|
1437 | + * @return string |
|
1438 | + */ |
|
1439 | + public static function get_view($route = null, $status = 0, $key = 'ee') |
|
1440 | + { |
|
1441 | + do_action('AHEE__EE_Config__get_view__begin', $route, $status); |
|
1442 | + if (isset(EE_Config::$_module_view_map[ $key ][ $route ][ $status ])) { |
|
1443 | + return apply_filters( |
|
1444 | + 'FHEE__EE_Config__get_view', |
|
1445 | + EE_Config::$_module_view_map[ $key ][ $route ][ $status ], |
|
1446 | + $route, |
|
1447 | + $status |
|
1448 | + ); |
|
1449 | + } |
|
1450 | + return null; |
|
1451 | + } |
|
1452 | + |
|
1453 | + |
|
1454 | + public function update_addon_option_names() |
|
1455 | + { |
|
1456 | + update_option(EE_Config::ADDON_OPTION_NAMES, $this->_addon_option_names); |
|
1457 | + } |
|
1458 | + |
|
1459 | + |
|
1460 | + public function shutdown() |
|
1461 | + { |
|
1462 | + $this->update_addon_option_names(); |
|
1463 | + } |
|
1464 | + |
|
1465 | + |
|
1466 | + /** |
|
1467 | + * @return LegacyShortcodesManager |
|
1468 | + */ |
|
1469 | + public static function getLegacyShortcodesManager() |
|
1470 | + { |
|
1471 | + |
|
1472 | + if (! EE_Config::instance()->legacy_shortcodes_manager instanceof LegacyShortcodesManager) { |
|
1473 | + EE_Config::instance()->legacy_shortcodes_manager = new LegacyShortcodesManager( |
|
1474 | + EE_Registry::instance() |
|
1475 | + ); |
|
1476 | + } |
|
1477 | + return EE_Config::instance()->legacy_shortcodes_manager; |
|
1478 | + } |
|
1479 | + |
|
1480 | + |
|
1481 | + /** |
|
1482 | + * register_shortcode - makes core aware of this shortcode |
|
1483 | + * |
|
1484 | + * @deprecated 4.9.26 |
|
1485 | + * @param string $shortcode_path - full path up to and including shortcode folder |
|
1486 | + * @return bool |
|
1487 | + */ |
|
1488 | + public static function register_shortcode($shortcode_path = null) |
|
1489 | + { |
|
1490 | + EE_Error::doing_it_wrong( |
|
1491 | + __METHOD__, |
|
1492 | + __( |
|
1493 | + 'Usage is deprecated. Use \EventEspresso\core\services\shortcodes\LegacyShortcodesManager::registerShortcode() as direct replacement, or better yet, please see the new \EventEspresso\core\services\shortcodes\ShortcodesManager class.', |
|
1494 | + 'event_espresso' |
|
1495 | + ), |
|
1496 | + '4.9.26' |
|
1497 | + ); |
|
1498 | + return EE_Config::instance()->getLegacyShortcodesManager()->registerShortcode($shortcode_path); |
|
1499 | + } |
|
1500 | +} |
|
2277 | 1501 | |
2278 | - /** |
|
2279 | - * ReCaptcha Type |
|
2280 | - * |
|
2281 | - * @var string $recaptcha_type |
|
2282 | - * options: 'audio', 'image' |
|
2283 | - */ |
|
2284 | - public $recaptcha_type; |
|
1502 | +/** |
|
1503 | + * Base class used for config classes. These classes should generally not have |
|
1504 | + * magic functions in use, except we'll allow them to magically set and get stuff... |
|
1505 | + * basically, they should just be well-defined stdClasses |
|
1506 | + */ |
|
1507 | +class EE_Config_Base |
|
1508 | +{ |
|
2285 | 1509 | |
2286 | - /** |
|
2287 | - * ReCaptcha language |
|
2288 | - * |
|
2289 | - * @var string $recaptcha_language |
|
2290 | - * eg 'en' |
|
2291 | - */ |
|
2292 | - public $recaptcha_language; |
|
1510 | + /** |
|
1511 | + * Utility function for escaping the value of a property and returning. |
|
1512 | + * |
|
1513 | + * @param string $property property name (checks to see if exists). |
|
1514 | + * @return mixed if a detected type found return the escaped value, otherwise just the raw value is returned. |
|
1515 | + * @throws \EE_Error |
|
1516 | + */ |
|
1517 | + public function get_pretty($property) |
|
1518 | + { |
|
1519 | + if (! property_exists($this, $property)) { |
|
1520 | + throw new EE_Error( |
|
1521 | + sprintf( |
|
1522 | + __( |
|
1523 | + '%1$s::get_pretty() has been called with the property %2$s which does not exist on the %1$s config class.', |
|
1524 | + 'event_espresso' |
|
1525 | + ), |
|
1526 | + get_class($this), |
|
1527 | + $property |
|
1528 | + ) |
|
1529 | + ); |
|
1530 | + } |
|
1531 | + // just handling escaping of strings for now. |
|
1532 | + if (is_string($this->{$property})) { |
|
1533 | + return stripslashes($this->{$property}); |
|
1534 | + } |
|
1535 | + return $this->{$property}; |
|
1536 | + } |
|
1537 | + |
|
1538 | + |
|
1539 | + public function populate() |
|
1540 | + { |
|
1541 | + // grab defaults via a new instance of this class. |
|
1542 | + $class_name = get_class($this); |
|
1543 | + $defaults = new $class_name; |
|
1544 | + // loop through the properties for this class and see if they are set. If they are NOT, then grab the |
|
1545 | + // default from our $defaults object. |
|
1546 | + foreach (get_object_vars($defaults) as $property => $value) { |
|
1547 | + if ($this->{$property} === null) { |
|
1548 | + $this->{$property} = $value; |
|
1549 | + } |
|
1550 | + } |
|
1551 | + // cleanup |
|
1552 | + unset($defaults); |
|
1553 | + } |
|
1554 | + |
|
1555 | + |
|
1556 | + /** |
|
1557 | + * __isset |
|
1558 | + * |
|
1559 | + * @param $a |
|
1560 | + * @return bool |
|
1561 | + */ |
|
1562 | + public function __isset($a) |
|
1563 | + { |
|
1564 | + return false; |
|
1565 | + } |
|
1566 | + |
|
1567 | + |
|
1568 | + /** |
|
1569 | + * __unset |
|
1570 | + * |
|
1571 | + * @param $a |
|
1572 | + * @return bool |
|
1573 | + */ |
|
1574 | + public function __unset($a) |
|
1575 | + { |
|
1576 | + return false; |
|
1577 | + } |
|
1578 | + |
|
1579 | + |
|
1580 | + /** |
|
1581 | + * __clone |
|
1582 | + */ |
|
1583 | + public function __clone() |
|
1584 | + { |
|
1585 | + } |
|
1586 | + |
|
1587 | + |
|
1588 | + /** |
|
1589 | + * __wakeup |
|
1590 | + */ |
|
1591 | + public function __wakeup() |
|
1592 | + { |
|
1593 | + } |
|
1594 | + |
|
1595 | + |
|
1596 | + /** |
|
1597 | + * __destruct |
|
1598 | + */ |
|
1599 | + public function __destruct() |
|
1600 | + { |
|
1601 | + } |
|
1602 | +} |
|
2293 | 1603 | |
2294 | - /** |
|
2295 | - * ReCaptcha public key |
|
2296 | - * |
|
2297 | - * @var string $recaptcha_publickey |
|
2298 | - */ |
|
2299 | - public $recaptcha_publickey; |
|
1604 | +/** |
|
1605 | + * Class for defining what's in the EE_Config relating to registration settings |
|
1606 | + */ |
|
1607 | +class EE_Core_Config extends EE_Config_Base |
|
1608 | +{ |
|
2300 | 1609 | |
2301 | - /** |
|
2302 | - * ReCaptcha private key |
|
2303 | - * |
|
2304 | - * @var string $recaptcha_privatekey |
|
2305 | - */ |
|
2306 | - public $recaptcha_privatekey; |
|
1610 | + const OPTION_NAME_UXIP = 'ee_ueip_optin'; |
|
1611 | + |
|
1612 | + |
|
1613 | + public $current_blog_id; |
|
1614 | + |
|
1615 | + public $ee_ueip_optin; |
|
1616 | + |
|
1617 | + public $ee_ueip_has_notified; |
|
1618 | + |
|
1619 | + /** |
|
1620 | + * Not to be confused with the 4 critical page variables (See |
|
1621 | + * get_critical_pages_array()), this is just an array of wp posts that have EE |
|
1622 | + * shortcodes in them. Keys are slugs, values are arrays with only 1 element: where the key is the shortcode |
|
1623 | + * in the page, and the value is the page's ID. The key 'posts' is basically a duplicate of this same array. |
|
1624 | + * |
|
1625 | + * @var array |
|
1626 | + */ |
|
1627 | + public $post_shortcodes; |
|
1628 | + |
|
1629 | + public $module_route_map; |
|
1630 | + |
|
1631 | + public $module_forward_map; |
|
1632 | + |
|
1633 | + public $module_view_map; |
|
1634 | + |
|
1635 | + /** |
|
1636 | + * The next 4 vars are the IDs of critical EE pages. |
|
1637 | + * |
|
1638 | + * @var int |
|
1639 | + */ |
|
1640 | + public $reg_page_id; |
|
1641 | + |
|
1642 | + public $txn_page_id; |
|
1643 | + |
|
1644 | + public $thank_you_page_id; |
|
1645 | + |
|
1646 | + public $cancel_page_id; |
|
1647 | + |
|
1648 | + /** |
|
1649 | + * The next 4 vars are the URLs of critical EE pages. |
|
1650 | + * |
|
1651 | + * @var int |
|
1652 | + */ |
|
1653 | + public $reg_page_url; |
|
1654 | + |
|
1655 | + public $txn_page_url; |
|
1656 | + |
|
1657 | + public $thank_you_page_url; |
|
1658 | + |
|
1659 | + public $cancel_page_url; |
|
1660 | + |
|
1661 | + /** |
|
1662 | + * The next vars relate to the custom slugs for EE CPT routes |
|
1663 | + */ |
|
1664 | + public $event_cpt_slug; |
|
1665 | + |
|
1666 | + /** |
|
1667 | + * This caches the _ee_ueip_option in case this config is reset in the same |
|
1668 | + * request across blog switches in a multisite context. |
|
1669 | + * Avoids extra queries to the db for this option. |
|
1670 | + * |
|
1671 | + * @var bool |
|
1672 | + */ |
|
1673 | + public static $ee_ueip_option; |
|
1674 | + |
|
1675 | + |
|
1676 | + /** |
|
1677 | + * class constructor |
|
1678 | + * |
|
1679 | + * @access public |
|
1680 | + */ |
|
1681 | + public function __construct() |
|
1682 | + { |
|
1683 | + // set default organization settings |
|
1684 | + $this->current_blog_id = get_current_blog_id(); |
|
1685 | + $this->current_blog_id = $this->current_blog_id === null ? 1 : $this->current_blog_id; |
|
1686 | + $this->ee_ueip_optin = $this->_get_main_ee_ueip_optin(); |
|
1687 | + $this->ee_ueip_has_notified = is_main_site() ? get_option('ee_ueip_has_notified', false) : true; |
|
1688 | + $this->post_shortcodes = array(); |
|
1689 | + $this->module_route_map = array(); |
|
1690 | + $this->module_forward_map = array(); |
|
1691 | + $this->module_view_map = array(); |
|
1692 | + // critical EE page IDs |
|
1693 | + $this->reg_page_id = 0; |
|
1694 | + $this->txn_page_id = 0; |
|
1695 | + $this->thank_you_page_id = 0; |
|
1696 | + $this->cancel_page_id = 0; |
|
1697 | + // critical EE page URLs |
|
1698 | + $this->reg_page_url = ''; |
|
1699 | + $this->txn_page_url = ''; |
|
1700 | + $this->thank_you_page_url = ''; |
|
1701 | + $this->cancel_page_url = ''; |
|
1702 | + // cpt slugs |
|
1703 | + $this->event_cpt_slug = __('events', 'event_espresso'); |
|
1704 | + // ueip constant check |
|
1705 | + if (defined('EE_DISABLE_UXIP') && EE_DISABLE_UXIP) { |
|
1706 | + $this->ee_ueip_optin = false; |
|
1707 | + $this->ee_ueip_has_notified = true; |
|
1708 | + } |
|
1709 | + } |
|
1710 | + |
|
1711 | + |
|
1712 | + /** |
|
1713 | + * @return array |
|
1714 | + */ |
|
1715 | + public function get_critical_pages_array() |
|
1716 | + { |
|
1717 | + return array( |
|
1718 | + $this->reg_page_id, |
|
1719 | + $this->txn_page_id, |
|
1720 | + $this->thank_you_page_id, |
|
1721 | + $this->cancel_page_id, |
|
1722 | + ); |
|
1723 | + } |
|
1724 | + |
|
1725 | + |
|
1726 | + /** |
|
1727 | + * @return array |
|
1728 | + */ |
|
1729 | + public function get_critical_pages_shortcodes_array() |
|
1730 | + { |
|
1731 | + return array( |
|
1732 | + $this->reg_page_id => 'ESPRESSO_CHECKOUT', |
|
1733 | + $this->txn_page_id => 'ESPRESSO_TXN_PAGE', |
|
1734 | + $this->thank_you_page_id => 'ESPRESSO_THANK_YOU', |
|
1735 | + $this->cancel_page_id => 'ESPRESSO_CANCELLED', |
|
1736 | + ); |
|
1737 | + } |
|
1738 | + |
|
1739 | + |
|
1740 | + /** |
|
1741 | + * gets/returns URL for EE reg_page |
|
1742 | + * |
|
1743 | + * @access public |
|
1744 | + * @return string |
|
1745 | + */ |
|
1746 | + public function reg_page_url() |
|
1747 | + { |
|
1748 | + if (! $this->reg_page_url) { |
|
1749 | + $this->reg_page_url = add_query_arg( |
|
1750 | + array('uts' => time()), |
|
1751 | + get_permalink($this->reg_page_id) |
|
1752 | + ) . '#checkout'; |
|
1753 | + } |
|
1754 | + return $this->reg_page_url; |
|
1755 | + } |
|
1756 | + |
|
1757 | + |
|
1758 | + /** |
|
1759 | + * gets/returns URL for EE txn_page |
|
1760 | + * |
|
1761 | + * @param array $query_args like what gets passed to |
|
1762 | + * add_query_arg() as the first argument |
|
1763 | + * @access public |
|
1764 | + * @return string |
|
1765 | + */ |
|
1766 | + public function txn_page_url($query_args = array()) |
|
1767 | + { |
|
1768 | + if (! $this->txn_page_url) { |
|
1769 | + $this->txn_page_url = get_permalink($this->txn_page_id); |
|
1770 | + } |
|
1771 | + if ($query_args) { |
|
1772 | + return add_query_arg($query_args, $this->txn_page_url); |
|
1773 | + } else { |
|
1774 | + return $this->txn_page_url; |
|
1775 | + } |
|
1776 | + } |
|
1777 | + |
|
1778 | + |
|
1779 | + /** |
|
1780 | + * gets/returns URL for EE thank_you_page |
|
1781 | + * |
|
1782 | + * @param array $query_args like what gets passed to |
|
1783 | + * add_query_arg() as the first argument |
|
1784 | + * @access public |
|
1785 | + * @return string |
|
1786 | + */ |
|
1787 | + public function thank_you_page_url($query_args = array()) |
|
1788 | + { |
|
1789 | + if (! $this->thank_you_page_url) { |
|
1790 | + $this->thank_you_page_url = get_permalink($this->thank_you_page_id); |
|
1791 | + } |
|
1792 | + if ($query_args) { |
|
1793 | + return add_query_arg($query_args, $this->thank_you_page_url); |
|
1794 | + } else { |
|
1795 | + return $this->thank_you_page_url; |
|
1796 | + } |
|
1797 | + } |
|
1798 | + |
|
1799 | + |
|
1800 | + /** |
|
1801 | + * gets/returns URL for EE cancel_page |
|
1802 | + * |
|
1803 | + * @access public |
|
1804 | + * @return string |
|
1805 | + */ |
|
1806 | + public function cancel_page_url() |
|
1807 | + { |
|
1808 | + if (! $this->cancel_page_url) { |
|
1809 | + $this->cancel_page_url = get_permalink($this->cancel_page_id); |
|
1810 | + } |
|
1811 | + return $this->cancel_page_url; |
|
1812 | + } |
|
1813 | + |
|
1814 | + |
|
1815 | + /** |
|
1816 | + * Resets all critical page urls to their original state. Used primarily by the __sleep() magic method currently. |
|
1817 | + * |
|
1818 | + * @since 4.7.5 |
|
1819 | + */ |
|
1820 | + protected function _reset_urls() |
|
1821 | + { |
|
1822 | + $this->reg_page_url = ''; |
|
1823 | + $this->txn_page_url = ''; |
|
1824 | + $this->cancel_page_url = ''; |
|
1825 | + $this->thank_you_page_url = ''; |
|
1826 | + } |
|
1827 | + |
|
1828 | + |
|
1829 | + /** |
|
1830 | + * Used to return what the optin value is set for the EE User Experience Program. |
|
1831 | + * This accounts for multisite and this value being requested for a subsite. In multisite, the value is set |
|
1832 | + * on the main site only. |
|
1833 | + * |
|
1834 | + * @return bool |
|
1835 | + */ |
|
1836 | + protected function _get_main_ee_ueip_optin() |
|
1837 | + { |
|
1838 | + // if this is the main site then we can just bypass our direct query. |
|
1839 | + if (is_main_site()) { |
|
1840 | + return get_option(self::OPTION_NAME_UXIP, false); |
|
1841 | + } |
|
1842 | + // is this already cached for this request? If so use it. |
|
1843 | + if (EE_Core_Config::$ee_ueip_option !== null) { |
|
1844 | + return EE_Core_Config::$ee_ueip_option; |
|
1845 | + } |
|
1846 | + global $wpdb; |
|
1847 | + $current_network_main_site = is_multisite() ? get_current_site() : null; |
|
1848 | + $current_main_site_id = ! empty($current_network_main_site) ? $current_network_main_site->blog_id : 1; |
|
1849 | + $option = self::OPTION_NAME_UXIP; |
|
1850 | + // set correct table for query |
|
1851 | + $table_name = $wpdb->get_blog_prefix($current_main_site_id) . 'options'; |
|
1852 | + // rather than getting blog option for the $current_main_site_id, we do a direct $wpdb query because |
|
1853 | + // get_blog_option() does a switch_to_blog an that could cause infinite recursion because EE_Core_Config might be |
|
1854 | + // re-constructed on the blog switch. Note, we are still executing any core wp filters on this option retrieval. |
|
1855 | + // this bit of code is basically a direct copy of get_option without any caching because we are NOT switched to the blog |
|
1856 | + // for the purpose of caching. |
|
1857 | + $pre = apply_filters('pre_option_' . $option, false, $option); |
|
1858 | + if (false !== $pre) { |
|
1859 | + EE_Core_Config::$ee_ueip_option = $pre; |
|
1860 | + return EE_Core_Config::$ee_ueip_option; |
|
1861 | + } |
|
1862 | + $row = $wpdb->get_row( |
|
1863 | + $wpdb->prepare( |
|
1864 | + "SELECT option_value FROM $table_name WHERE option_name = %s LIMIT 1", |
|
1865 | + $option |
|
1866 | + ) |
|
1867 | + ); |
|
1868 | + if (is_object($row)) { |
|
1869 | + $value = $row->option_value; |
|
1870 | + } else { // option does not exist so use default. |
|
1871 | + EE_Core_Config::$ee_ueip_option = apply_filters('default_option_' . $option, false, $option); |
|
1872 | + return EE_Core_Config::$ee_ueip_option; |
|
1873 | + } |
|
1874 | + EE_Core_Config::$ee_ueip_option = apply_filters('option_' . $option, maybe_unserialize($value), $option); |
|
1875 | + return EE_Core_Config::$ee_ueip_option; |
|
1876 | + } |
|
1877 | + |
|
1878 | + |
|
1879 | + /** |
|
1880 | + * Utility function for escaping the value of a property and returning. |
|
1881 | + * |
|
1882 | + * @param string $property property name (checks to see if exists). |
|
1883 | + * @return mixed if a detected type found return the escaped value, otherwise just the raw value is returned. |
|
1884 | + * @throws \EE_Error |
|
1885 | + */ |
|
1886 | + public function get_pretty($property) |
|
1887 | + { |
|
1888 | + if ($property === self::OPTION_NAME_UXIP) { |
|
1889 | + return $this->ee_ueip_optin ? 'yes' : 'no'; |
|
1890 | + } |
|
1891 | + return parent::get_pretty($property); |
|
1892 | + } |
|
1893 | + |
|
1894 | + |
|
1895 | + /** |
|
1896 | + * Currently used to ensure critical page urls have initial values saved to the db instead of any current set values |
|
1897 | + * on the object. |
|
1898 | + * |
|
1899 | + * @return array |
|
1900 | + */ |
|
1901 | + public function __sleep() |
|
1902 | + { |
|
1903 | + // reset all url properties |
|
1904 | + $this->_reset_urls(); |
|
1905 | + // return what to save to db |
|
1906 | + return array_keys(get_object_vars($this)); |
|
1907 | + } |
|
1908 | +} |
|
2307 | 1909 | |
2308 | - /** |
|
2309 | - * array of form names protected by ReCaptcha |
|
2310 | - * |
|
2311 | - * @var array $recaptcha_protected_forms |
|
2312 | - */ |
|
2313 | - public $recaptcha_protected_forms; |
|
1910 | +/** |
|
1911 | + * Config class for storing info on the Organization |
|
1912 | + */ |
|
1913 | +class EE_Organization_Config extends EE_Config_Base |
|
1914 | +{ |
|
2314 | 1915 | |
2315 | - /** |
|
2316 | - * ReCaptcha width |
|
2317 | - * |
|
2318 | - * @var int $recaptcha_width |
|
2319 | - * @deprecated |
|
2320 | - */ |
|
2321 | - public $recaptcha_width; |
|
1916 | + /** |
|
1917 | + * @var string $name |
|
1918 | + * eg EE4.1 |
|
1919 | + */ |
|
1920 | + public $name; |
|
1921 | + |
|
1922 | + /** |
|
1923 | + * @var string $address_1 |
|
1924 | + * eg 123 Onna Road |
|
1925 | + */ |
|
1926 | + public $address_1; |
|
1927 | + |
|
1928 | + /** |
|
1929 | + * @var string $address_2 |
|
1930 | + * eg PO Box 123 |
|
1931 | + */ |
|
1932 | + public $address_2; |
|
1933 | + |
|
1934 | + /** |
|
1935 | + * @var string $city |
|
1936 | + * eg Inna City |
|
1937 | + */ |
|
1938 | + public $city; |
|
1939 | + |
|
1940 | + /** |
|
1941 | + * @var int $STA_ID |
|
1942 | + * eg 4 |
|
1943 | + */ |
|
1944 | + public $STA_ID; |
|
1945 | + |
|
1946 | + /** |
|
1947 | + * @var string $CNT_ISO |
|
1948 | + * eg US |
|
1949 | + */ |
|
1950 | + public $CNT_ISO; |
|
1951 | + |
|
1952 | + /** |
|
1953 | + * @var string $zip |
|
1954 | + * eg 12345 or V1A 2B3 |
|
1955 | + */ |
|
1956 | + public $zip; |
|
1957 | + |
|
1958 | + /** |
|
1959 | + * @var string $email |
|
1960 | + * eg [email protected] |
|
1961 | + */ |
|
1962 | + public $email; |
|
1963 | + |
|
1964 | + /** |
|
1965 | + * @var string $phone |
|
1966 | + * eg. 111-111-1111 |
|
1967 | + */ |
|
1968 | + public $phone; |
|
1969 | + |
|
1970 | + /** |
|
1971 | + * @var string $vat |
|
1972 | + * VAT/Tax Number |
|
1973 | + */ |
|
1974 | + public $vat; |
|
1975 | + |
|
1976 | + /** |
|
1977 | + * @var string $logo_url |
|
1978 | + * eg http://www.somedomain.com/wp-content/uploads/kittehs.jpg |
|
1979 | + */ |
|
1980 | + public $logo_url; |
|
1981 | + |
|
1982 | + /** |
|
1983 | + * The below are all various properties for holding links to organization social network profiles |
|
1984 | + * |
|
1985 | + * @var string |
|
1986 | + */ |
|
1987 | + /** |
|
1988 | + * facebook (facebook.com/profile.name) |
|
1989 | + * |
|
1990 | + * @var string |
|
1991 | + */ |
|
1992 | + public $facebook; |
|
1993 | + |
|
1994 | + /** |
|
1995 | + * twitter (twitter.com/twitter_handle) |
|
1996 | + * |
|
1997 | + * @var string |
|
1998 | + */ |
|
1999 | + public $twitter; |
|
2000 | + |
|
2001 | + /** |
|
2002 | + * linkedin (linkedin.com/in/profile_name) |
|
2003 | + * |
|
2004 | + * @var string |
|
2005 | + */ |
|
2006 | + public $linkedin; |
|
2007 | + |
|
2008 | + /** |
|
2009 | + * pinterest (www.pinterest.com/profile_name) |
|
2010 | + * |
|
2011 | + * @var string |
|
2012 | + */ |
|
2013 | + public $pinterest; |
|
2014 | + |
|
2015 | + /** |
|
2016 | + * google+ (google.com/+profileName) |
|
2017 | + * |
|
2018 | + * @var string |
|
2019 | + */ |
|
2020 | + public $google; |
|
2021 | + |
|
2022 | + /** |
|
2023 | + * instagram (instagram.com/handle) |
|
2024 | + * |
|
2025 | + * @var string |
|
2026 | + */ |
|
2027 | + public $instagram; |
|
2028 | + |
|
2029 | + |
|
2030 | + /** |
|
2031 | + * class constructor |
|
2032 | + * |
|
2033 | + * @access public |
|
2034 | + */ |
|
2035 | + public function __construct() |
|
2036 | + { |
|
2037 | + // set default organization settings |
|
2038 | + // decode HTML entities from the WP blogname, because it's stored in the DB with HTML entities encoded |
|
2039 | + $this->name = wp_specialchars_decode(get_bloginfo('name'), ENT_QUOTES); |
|
2040 | + $this->address_1 = '123 Onna Road'; |
|
2041 | + $this->address_2 = 'PO Box 123'; |
|
2042 | + $this->city = 'Inna City'; |
|
2043 | + $this->STA_ID = 4; |
|
2044 | + $this->CNT_ISO = 'US'; |
|
2045 | + $this->zip = '12345'; |
|
2046 | + $this->email = get_bloginfo('admin_email'); |
|
2047 | + $this->phone = ''; |
|
2048 | + $this->vat = '123456789'; |
|
2049 | + $this->logo_url = ''; |
|
2050 | + $this->facebook = ''; |
|
2051 | + $this->twitter = ''; |
|
2052 | + $this->linkedin = ''; |
|
2053 | + $this->pinterest = ''; |
|
2054 | + $this->google = ''; |
|
2055 | + $this->instagram = ''; |
|
2056 | + } |
|
2057 | +} |
|
2322 | 2058 | |
2323 | - /** |
|
2324 | - * Whether or not invalid attempts to directly access the registration checkout page should be tracked. |
|
2325 | - * |
|
2326 | - * @var boolean $track_invalid_checkout_access |
|
2327 | - */ |
|
2328 | - protected $track_invalid_checkout_access = true; |
|
2059 | +/** |
|
2060 | + * Class for defining what's in the EE_Config relating to currency |
|
2061 | + */ |
|
2062 | +class EE_Currency_Config extends EE_Config_Base |
|
2063 | +{ |
|
2329 | 2064 | |
2330 | - /** |
|
2331 | - * Whether or not to show the privacy policy consent checkbox |
|
2332 | - * |
|
2333 | - * @var bool |
|
2334 | - */ |
|
2335 | - public $consent_checkbox_enabled; |
|
2065 | + /** |
|
2066 | + * @var string $code |
|
2067 | + * eg 'US' |
|
2068 | + */ |
|
2069 | + public $code; |
|
2070 | + |
|
2071 | + /** |
|
2072 | + * @var string $name |
|
2073 | + * eg 'Dollar' |
|
2074 | + */ |
|
2075 | + public $name; |
|
2076 | + |
|
2077 | + /** |
|
2078 | + * plural name |
|
2079 | + * |
|
2080 | + * @var string $plural |
|
2081 | + * eg 'Dollars' |
|
2082 | + */ |
|
2083 | + public $plural; |
|
2084 | + |
|
2085 | + /** |
|
2086 | + * currency sign |
|
2087 | + * |
|
2088 | + * @var string $sign |
|
2089 | + * eg '$' |
|
2090 | + */ |
|
2091 | + public $sign; |
|
2092 | + |
|
2093 | + /** |
|
2094 | + * Whether the currency sign should come before the number or not |
|
2095 | + * |
|
2096 | + * @var boolean $sign_b4 |
|
2097 | + */ |
|
2098 | + public $sign_b4; |
|
2099 | + |
|
2100 | + /** |
|
2101 | + * How many digits should come after the decimal place |
|
2102 | + * |
|
2103 | + * @var int $dec_plc |
|
2104 | + */ |
|
2105 | + public $dec_plc; |
|
2106 | + |
|
2107 | + /** |
|
2108 | + * Symbol to use for decimal mark |
|
2109 | + * |
|
2110 | + * @var string $dec_mrk |
|
2111 | + * eg '.' |
|
2112 | + */ |
|
2113 | + public $dec_mrk; |
|
2114 | + |
|
2115 | + /** |
|
2116 | + * Symbol to use for thousands |
|
2117 | + * |
|
2118 | + * @var string $thsnds |
|
2119 | + * eg ',' |
|
2120 | + */ |
|
2121 | + public $thsnds; |
|
2122 | + |
|
2123 | + |
|
2124 | + /** |
|
2125 | + * class constructor |
|
2126 | + * |
|
2127 | + * @access public |
|
2128 | + * @param string $CNT_ISO |
|
2129 | + * @throws \EE_Error |
|
2130 | + */ |
|
2131 | + public function __construct($CNT_ISO = '') |
|
2132 | + { |
|
2133 | + /** @var \EventEspresso\core\services\database\TableAnalysis $table_analysis */ |
|
2134 | + $table_analysis = EE_Registry::instance()->create('TableAnalysis', array(), true); |
|
2135 | + // get country code from organization settings or use default |
|
2136 | + $ORG_CNT = isset(EE_Registry::instance()->CFG->organization) |
|
2137 | + && EE_Registry::instance()->CFG->organization instanceof EE_Organization_Config |
|
2138 | + ? EE_Registry::instance()->CFG->organization->CNT_ISO |
|
2139 | + : ''; |
|
2140 | + // but override if requested |
|
2141 | + $CNT_ISO = ! empty($CNT_ISO) ? $CNT_ISO : $ORG_CNT; |
|
2142 | + // so if that all went well, and we are not in M-Mode (cuz you can't query the db in M-Mode) and double-check the countries table exists |
|
2143 | + if (! empty($CNT_ISO) |
|
2144 | + && EE_Maintenance_Mode::instance()->models_can_query() |
|
2145 | + && $table_analysis->tableExists(EE_Registry::instance()->load_model('Country')->table()) |
|
2146 | + ) { |
|
2147 | + // retrieve the country settings from the db, just in case they have been customized |
|
2148 | + $country = EE_Registry::instance()->load_model('Country')->get_one_by_ID($CNT_ISO); |
|
2149 | + if ($country instanceof EE_Country) { |
|
2150 | + $this->code = $country->currency_code(); // currency code: USD, CAD, EUR |
|
2151 | + $this->name = $country->currency_name_single(); // Dollar |
|
2152 | + $this->plural = $country->currency_name_plural(); // Dollars |
|
2153 | + $this->sign = $country->currency_sign(); // currency sign: $ |
|
2154 | + $this->sign_b4 = $country->currency_sign_before( |
|
2155 | + ); // currency sign before or after: $TRUE or FALSE$ |
|
2156 | + $this->dec_plc = $country->currency_decimal_places(); // decimal places: 2 = 0.00 3 = 0.000 |
|
2157 | + $this->dec_mrk = $country->currency_decimal_mark( |
|
2158 | + ); // decimal mark: (comma) ',' = 0,01 or (decimal) '.' = 0.01 |
|
2159 | + $this->thsnds = $country->currency_thousands_separator( |
|
2160 | + ); // thousands separator: (comma) ',' = 1,000 or (decimal) '.' = 1.000 |
|
2161 | + } |
|
2162 | + } |
|
2163 | + // fallback to hardcoded defaults, in case the above failed |
|
2164 | + if (empty($this->code)) { |
|
2165 | + // set default currency settings |
|
2166 | + $this->code = 'USD'; // currency code: USD, CAD, EUR |
|
2167 | + $this->name = __('Dollar', 'event_espresso'); // Dollar |
|
2168 | + $this->plural = __('Dollars', 'event_espresso'); // Dollars |
|
2169 | + $this->sign = '$'; // currency sign: $ |
|
2170 | + $this->sign_b4 = true; // currency sign before or after: $TRUE or FALSE$ |
|
2171 | + $this->dec_plc = 2; // decimal places: 2 = 0.00 3 = 0.000 |
|
2172 | + $this->dec_mrk = '.'; // decimal mark: (comma) ',' = 0,01 or (decimal) '.' = 0.01 |
|
2173 | + $this->thsnds = ','; // thousands separator: (comma) ',' = 1,000 or (decimal) '.' = 1.000 |
|
2174 | + } |
|
2175 | + } |
|
2176 | +} |
|
2336 | 2177 | |
2337 | - /** |
|
2338 | - * Label text to show on the checkbox |
|
2339 | - * |
|
2340 | - * @var string |
|
2341 | - */ |
|
2342 | - public $consent_checkbox_label_text; |
|
2178 | +/** |
|
2179 | + * Class for defining what's in the EE_Config relating to registration settings |
|
2180 | + */ |
|
2181 | +class EE_Registration_Config extends EE_Config_Base |
|
2182 | +{ |
|
2343 | 2183 | |
2344 | - /* |
|
2184 | + /** |
|
2185 | + * Default registration status |
|
2186 | + * |
|
2187 | + * @var string $default_STS_ID |
|
2188 | + * eg 'RPP' |
|
2189 | + */ |
|
2190 | + public $default_STS_ID; |
|
2191 | + |
|
2192 | + /** |
|
2193 | + * For new events, this will be the default value for the maximum number of tickets (equivalent to maximum number of |
|
2194 | + * registrations) |
|
2195 | + * |
|
2196 | + * @var int |
|
2197 | + */ |
|
2198 | + public $default_maximum_number_of_tickets; |
|
2199 | + |
|
2200 | + /** |
|
2201 | + * level of validation to apply to email addresses |
|
2202 | + * |
|
2203 | + * @var string $email_validation_level |
|
2204 | + * options: 'basic', 'wp_default', 'i18n', 'i18n_dns' |
|
2205 | + */ |
|
2206 | + public $email_validation_level; |
|
2207 | + |
|
2208 | + /** |
|
2209 | + * whether or not to show alternate payment options during the reg process if payment status is pending |
|
2210 | + * |
|
2211 | + * @var boolean $show_pending_payment_options |
|
2212 | + */ |
|
2213 | + public $show_pending_payment_options; |
|
2214 | + |
|
2215 | + /** |
|
2216 | + * Whether to skip the registration confirmation page |
|
2217 | + * |
|
2218 | + * @var boolean $skip_reg_confirmation |
|
2219 | + */ |
|
2220 | + public $skip_reg_confirmation; |
|
2221 | + |
|
2222 | + /** |
|
2223 | + * an array of SPCO reg steps where: |
|
2224 | + * the keys denotes the reg step order |
|
2225 | + * each element consists of an array with the following elements: |
|
2226 | + * "file_path" => the file path to the EE_SPCO_Reg_Step class |
|
2227 | + * "class_name" => the specific EE_SPCO_Reg_Step child class name |
|
2228 | + * "slug" => the URL param used to trigger the reg step |
|
2229 | + * |
|
2230 | + * @var array $reg_steps |
|
2231 | + */ |
|
2232 | + public $reg_steps; |
|
2233 | + |
|
2234 | + /** |
|
2235 | + * Whether registration confirmation should be the last page of SPCO |
|
2236 | + * |
|
2237 | + * @var boolean $reg_confirmation_last |
|
2238 | + */ |
|
2239 | + public $reg_confirmation_last; |
|
2240 | + |
|
2241 | + /** |
|
2242 | + * Whether or not to enable the EE Bot Trap |
|
2243 | + * |
|
2244 | + * @var boolean $use_bot_trap |
|
2245 | + */ |
|
2246 | + public $use_bot_trap; |
|
2247 | + |
|
2248 | + /** |
|
2249 | + * Whether or not to encrypt some data sent by the EE Bot Trap |
|
2250 | + * |
|
2251 | + * @var boolean $use_encryption |
|
2252 | + */ |
|
2253 | + public $use_encryption; |
|
2254 | + |
|
2255 | + /** |
|
2256 | + * Whether or not to use ReCaptcha |
|
2257 | + * |
|
2258 | + * @var boolean $use_captcha |
|
2259 | + */ |
|
2260 | + public $use_captcha; |
|
2261 | + |
|
2262 | + /** |
|
2263 | + * ReCaptcha Theme |
|
2264 | + * |
|
2265 | + * @var string $recaptcha_theme |
|
2266 | + * options: 'dark', 'light', 'invisible' |
|
2267 | + */ |
|
2268 | + public $recaptcha_theme; |
|
2269 | + |
|
2270 | + /** |
|
2271 | + * ReCaptcha Badge - determines the position of the reCAPTCHA badge if using Invisible ReCaptcha. |
|
2272 | + * |
|
2273 | + * @var string $recaptcha_badge |
|
2274 | + * options: 'bottomright', 'bottomleft', 'inline' |
|
2275 | + */ |
|
2276 | + public $recaptcha_badge; |
|
2277 | + |
|
2278 | + /** |
|
2279 | + * ReCaptcha Type |
|
2280 | + * |
|
2281 | + * @var string $recaptcha_type |
|
2282 | + * options: 'audio', 'image' |
|
2283 | + */ |
|
2284 | + public $recaptcha_type; |
|
2285 | + |
|
2286 | + /** |
|
2287 | + * ReCaptcha language |
|
2288 | + * |
|
2289 | + * @var string $recaptcha_language |
|
2290 | + * eg 'en' |
|
2291 | + */ |
|
2292 | + public $recaptcha_language; |
|
2293 | + |
|
2294 | + /** |
|
2295 | + * ReCaptcha public key |
|
2296 | + * |
|
2297 | + * @var string $recaptcha_publickey |
|
2298 | + */ |
|
2299 | + public $recaptcha_publickey; |
|
2300 | + |
|
2301 | + /** |
|
2302 | + * ReCaptcha private key |
|
2303 | + * |
|
2304 | + * @var string $recaptcha_privatekey |
|
2305 | + */ |
|
2306 | + public $recaptcha_privatekey; |
|
2307 | + |
|
2308 | + /** |
|
2309 | + * array of form names protected by ReCaptcha |
|
2310 | + * |
|
2311 | + * @var array $recaptcha_protected_forms |
|
2312 | + */ |
|
2313 | + public $recaptcha_protected_forms; |
|
2314 | + |
|
2315 | + /** |
|
2316 | + * ReCaptcha width |
|
2317 | + * |
|
2318 | + * @var int $recaptcha_width |
|
2319 | + * @deprecated |
|
2320 | + */ |
|
2321 | + public $recaptcha_width; |
|
2322 | + |
|
2323 | + /** |
|
2324 | + * Whether or not invalid attempts to directly access the registration checkout page should be tracked. |
|
2325 | + * |
|
2326 | + * @var boolean $track_invalid_checkout_access |
|
2327 | + */ |
|
2328 | + protected $track_invalid_checkout_access = true; |
|
2329 | + |
|
2330 | + /** |
|
2331 | + * Whether or not to show the privacy policy consent checkbox |
|
2332 | + * |
|
2333 | + * @var bool |
|
2334 | + */ |
|
2335 | + public $consent_checkbox_enabled; |
|
2336 | + |
|
2337 | + /** |
|
2338 | + * Label text to show on the checkbox |
|
2339 | + * |
|
2340 | + * @var string |
|
2341 | + */ |
|
2342 | + public $consent_checkbox_label_text; |
|
2343 | + |
|
2344 | + /* |
|
2345 | 2345 | * String describing how long to keep payment logs. Passed into DateTime constructor |
2346 | 2346 | * @var string |
2347 | 2347 | */ |
2348 | - public $gateway_log_lifespan = '1 week'; |
|
2349 | - |
|
2350 | - |
|
2351 | - /** |
|
2352 | - * class constructor |
|
2353 | - * |
|
2354 | - * @access public |
|
2355 | - */ |
|
2356 | - public function __construct() |
|
2357 | - { |
|
2358 | - // set default registration settings |
|
2359 | - $this->default_STS_ID = EEM_Registration::status_id_pending_payment; |
|
2360 | - $this->email_validation_level = 'wp_default'; |
|
2361 | - $this->show_pending_payment_options = true; |
|
2362 | - $this->skip_reg_confirmation = true; |
|
2363 | - $this->reg_steps = array(); |
|
2364 | - $this->reg_confirmation_last = false; |
|
2365 | - $this->use_bot_trap = true; |
|
2366 | - $this->use_encryption = true; |
|
2367 | - $this->use_captcha = false; |
|
2368 | - $this->recaptcha_theme = 'light'; |
|
2369 | - $this->recaptcha_badge = 'bottomleft'; |
|
2370 | - $this->recaptcha_type = 'image'; |
|
2371 | - $this->recaptcha_language = 'en'; |
|
2372 | - $this->recaptcha_publickey = null; |
|
2373 | - $this->recaptcha_privatekey = null; |
|
2374 | - $this->recaptcha_protected_forms = array(); |
|
2375 | - $this->recaptcha_width = 500; |
|
2376 | - $this->default_maximum_number_of_tickets = 10; |
|
2377 | - $this->consent_checkbox_enabled = false; |
|
2378 | - $this->consent_checkbox_label_text = ''; |
|
2379 | - $this->gateway_log_lifespan = '7 days'; |
|
2380 | - } |
|
2381 | - |
|
2382 | - |
|
2383 | - /** |
|
2384 | - * This is called by the config loader and hooks are initialized AFTER the config has been populated. |
|
2385 | - * |
|
2386 | - * @since 4.8.8.rc.019 |
|
2387 | - */ |
|
2388 | - public function do_hooks() |
|
2389 | - { |
|
2390 | - add_action('AHEE__EE_Config___load_core_config__end', array($this, 'set_default_reg_status_on_EEM_Event')); |
|
2391 | - add_action('AHEE__EE_Config___load_core_config__end', array($this, 'set_default_max_ticket_on_EEM_Event')); |
|
2392 | - add_action('setup_theme', array($this, 'setDefaultCheckboxLabelText')); |
|
2393 | - } |
|
2394 | - |
|
2395 | - |
|
2396 | - /** |
|
2397 | - * Hooked into `AHEE__EE_Config___load_core_config__end` to ensure the default for the |
|
2398 | - * EVT_default_registration_status field matches the config setting for default_STS_ID. |
|
2399 | - */ |
|
2400 | - public function set_default_reg_status_on_EEM_Event() |
|
2401 | - { |
|
2402 | - EEM_Event::set_default_reg_status($this->default_STS_ID); |
|
2403 | - } |
|
2404 | - |
|
2405 | - |
|
2406 | - /** |
|
2407 | - * Hooked into `AHEE__EE_Config___load_core_config__end` to ensure the default for the EVT_additional_limit field |
|
2408 | - * for Events matches the config setting for default_maximum_number_of_tickets |
|
2409 | - */ |
|
2410 | - public function set_default_max_ticket_on_EEM_Event() |
|
2411 | - { |
|
2412 | - EEM_Event::set_default_additional_limit($this->default_maximum_number_of_tickets); |
|
2413 | - } |
|
2414 | - |
|
2415 | - |
|
2416 | - /** |
|
2417 | - * Sets the default consent checkbox text. This needs to be done a bit later than when EE_Registration_Config is |
|
2418 | - * constructed because that happens before we can get the privacy policy page's permalink. |
|
2419 | - * |
|
2420 | - * @throws InvalidArgumentException |
|
2421 | - * @throws \EventEspresso\core\exceptions\InvalidDataTypeException |
|
2422 | - * @throws \EventEspresso\core\exceptions\InvalidInterfaceException |
|
2423 | - */ |
|
2424 | - public function setDefaultCheckboxLabelText() |
|
2425 | - { |
|
2426 | - if ($this->getConsentCheckboxLabelText() === null |
|
2427 | - || $this->getConsentCheckboxLabelText() === '') { |
|
2428 | - $opening_a_tag = ''; |
|
2429 | - $closing_a_tag = ''; |
|
2430 | - if (function_exists('get_privacy_policy_url')) { |
|
2431 | - $privacy_page_url = get_privacy_policy_url(); |
|
2432 | - if (! empty($privacy_page_url)) { |
|
2433 | - $opening_a_tag = '<a href="' . $privacy_page_url . '" target="_blank">'; |
|
2434 | - $closing_a_tag = '</a>'; |
|
2435 | - } |
|
2436 | - } |
|
2437 | - $loader = LoaderFactory::getLoader(); |
|
2438 | - $org_config = $loader->getShared('EE_Organization_Config'); |
|
2439 | - /** |
|
2440 | - * @var $org_config EE_Organization_Config |
|
2441 | - */ |
|
2442 | - |
|
2443 | - $this->setConsentCheckboxLabelText( |
|
2444 | - sprintf( |
|
2445 | - esc_html__( |
|
2446 | - 'I consent to %1$s storing and using my personal information, according to their %2$sprivacy policy%3$s.', |
|
2447 | - 'event_espresso' |
|
2448 | - ), |
|
2449 | - $org_config->name, |
|
2450 | - $opening_a_tag, |
|
2451 | - $closing_a_tag |
|
2452 | - ) |
|
2453 | - ); |
|
2454 | - } |
|
2455 | - } |
|
2456 | - |
|
2457 | - |
|
2458 | - /** |
|
2459 | - * @return boolean |
|
2460 | - */ |
|
2461 | - public function track_invalid_checkout_access() |
|
2462 | - { |
|
2463 | - return $this->track_invalid_checkout_access; |
|
2464 | - } |
|
2465 | - |
|
2466 | - |
|
2467 | - /** |
|
2468 | - * @param boolean $track_invalid_checkout_access |
|
2469 | - */ |
|
2470 | - public function set_track_invalid_checkout_access($track_invalid_checkout_access) |
|
2471 | - { |
|
2472 | - $this->track_invalid_checkout_access = filter_var( |
|
2473 | - $track_invalid_checkout_access, |
|
2474 | - FILTER_VALIDATE_BOOLEAN |
|
2475 | - ); |
|
2476 | - } |
|
2477 | - |
|
2478 | - |
|
2479 | - /** |
|
2480 | - * Gets the options to make availalbe for the gateway log lifespan |
|
2481 | - * @return array |
|
2482 | - */ |
|
2483 | - public function gatewayLogLifespanOptions() |
|
2484 | - { |
|
2485 | - return (array) apply_filters( |
|
2486 | - 'FHEE_EE_Admin_Config__gatewayLogLifespanOptions', |
|
2487 | - array( |
|
2488 | - '1 second' => esc_html__('Don\'t Log At All', 'event_espresso'), |
|
2489 | - '1 day' => esc_html__('1 Day', 'event_espresso'), |
|
2490 | - '7 days' => esc_html__('7 Days', 'event_espresso'), |
|
2491 | - '14 days' => esc_html__('14 Days', 'event_espresso'), |
|
2492 | - '30 days' => esc_html__('30 Days', 'event_espresso') |
|
2493 | - ) |
|
2494 | - ); |
|
2495 | - } |
|
2496 | - |
|
2497 | - |
|
2498 | - /** |
|
2499 | - * @return bool |
|
2500 | - */ |
|
2501 | - public function isConsentCheckboxEnabled() |
|
2502 | - { |
|
2503 | - return $this->consent_checkbox_enabled; |
|
2504 | - } |
|
2505 | - |
|
2506 | - |
|
2507 | - /** |
|
2508 | - * @param bool $consent_checkbox_enabled |
|
2509 | - */ |
|
2510 | - public function setConsentCheckboxEnabled($consent_checkbox_enabled) |
|
2511 | - { |
|
2512 | - $this->consent_checkbox_enabled = filter_var( |
|
2513 | - $consent_checkbox_enabled, |
|
2514 | - FILTER_VALIDATE_BOOLEAN |
|
2515 | - ); |
|
2516 | - } |
|
2517 | - |
|
2518 | - |
|
2519 | - /** |
|
2520 | - * @return string |
|
2521 | - */ |
|
2522 | - public function getConsentCheckboxLabelText() |
|
2523 | - { |
|
2524 | - return $this->consent_checkbox_label_text; |
|
2525 | - } |
|
2526 | - |
|
2527 | - |
|
2528 | - /** |
|
2529 | - * @param string $consent_checkbox_label_text |
|
2530 | - */ |
|
2531 | - public function setConsentCheckboxLabelText($consent_checkbox_label_text) |
|
2532 | - { |
|
2533 | - $this->consent_checkbox_label_text = (string) $consent_checkbox_label_text; |
|
2534 | - } |
|
2348 | + public $gateway_log_lifespan = '1 week'; |
|
2349 | + |
|
2350 | + |
|
2351 | + /** |
|
2352 | + * class constructor |
|
2353 | + * |
|
2354 | + * @access public |
|
2355 | + */ |
|
2356 | + public function __construct() |
|
2357 | + { |
|
2358 | + // set default registration settings |
|
2359 | + $this->default_STS_ID = EEM_Registration::status_id_pending_payment; |
|
2360 | + $this->email_validation_level = 'wp_default'; |
|
2361 | + $this->show_pending_payment_options = true; |
|
2362 | + $this->skip_reg_confirmation = true; |
|
2363 | + $this->reg_steps = array(); |
|
2364 | + $this->reg_confirmation_last = false; |
|
2365 | + $this->use_bot_trap = true; |
|
2366 | + $this->use_encryption = true; |
|
2367 | + $this->use_captcha = false; |
|
2368 | + $this->recaptcha_theme = 'light'; |
|
2369 | + $this->recaptcha_badge = 'bottomleft'; |
|
2370 | + $this->recaptcha_type = 'image'; |
|
2371 | + $this->recaptcha_language = 'en'; |
|
2372 | + $this->recaptcha_publickey = null; |
|
2373 | + $this->recaptcha_privatekey = null; |
|
2374 | + $this->recaptcha_protected_forms = array(); |
|
2375 | + $this->recaptcha_width = 500; |
|
2376 | + $this->default_maximum_number_of_tickets = 10; |
|
2377 | + $this->consent_checkbox_enabled = false; |
|
2378 | + $this->consent_checkbox_label_text = ''; |
|
2379 | + $this->gateway_log_lifespan = '7 days'; |
|
2380 | + } |
|
2381 | + |
|
2382 | + |
|
2383 | + /** |
|
2384 | + * This is called by the config loader and hooks are initialized AFTER the config has been populated. |
|
2385 | + * |
|
2386 | + * @since 4.8.8.rc.019 |
|
2387 | + */ |
|
2388 | + public function do_hooks() |
|
2389 | + { |
|
2390 | + add_action('AHEE__EE_Config___load_core_config__end', array($this, 'set_default_reg_status_on_EEM_Event')); |
|
2391 | + add_action('AHEE__EE_Config___load_core_config__end', array($this, 'set_default_max_ticket_on_EEM_Event')); |
|
2392 | + add_action('setup_theme', array($this, 'setDefaultCheckboxLabelText')); |
|
2393 | + } |
|
2394 | + |
|
2395 | + |
|
2396 | + /** |
|
2397 | + * Hooked into `AHEE__EE_Config___load_core_config__end` to ensure the default for the |
|
2398 | + * EVT_default_registration_status field matches the config setting for default_STS_ID. |
|
2399 | + */ |
|
2400 | + public function set_default_reg_status_on_EEM_Event() |
|
2401 | + { |
|
2402 | + EEM_Event::set_default_reg_status($this->default_STS_ID); |
|
2403 | + } |
|
2404 | + |
|
2405 | + |
|
2406 | + /** |
|
2407 | + * Hooked into `AHEE__EE_Config___load_core_config__end` to ensure the default for the EVT_additional_limit field |
|
2408 | + * for Events matches the config setting for default_maximum_number_of_tickets |
|
2409 | + */ |
|
2410 | + public function set_default_max_ticket_on_EEM_Event() |
|
2411 | + { |
|
2412 | + EEM_Event::set_default_additional_limit($this->default_maximum_number_of_tickets); |
|
2413 | + } |
|
2414 | + |
|
2415 | + |
|
2416 | + /** |
|
2417 | + * Sets the default consent checkbox text. This needs to be done a bit later than when EE_Registration_Config is |
|
2418 | + * constructed because that happens before we can get the privacy policy page's permalink. |
|
2419 | + * |
|
2420 | + * @throws InvalidArgumentException |
|
2421 | + * @throws \EventEspresso\core\exceptions\InvalidDataTypeException |
|
2422 | + * @throws \EventEspresso\core\exceptions\InvalidInterfaceException |
|
2423 | + */ |
|
2424 | + public function setDefaultCheckboxLabelText() |
|
2425 | + { |
|
2426 | + if ($this->getConsentCheckboxLabelText() === null |
|
2427 | + || $this->getConsentCheckboxLabelText() === '') { |
|
2428 | + $opening_a_tag = ''; |
|
2429 | + $closing_a_tag = ''; |
|
2430 | + if (function_exists('get_privacy_policy_url')) { |
|
2431 | + $privacy_page_url = get_privacy_policy_url(); |
|
2432 | + if (! empty($privacy_page_url)) { |
|
2433 | + $opening_a_tag = '<a href="' . $privacy_page_url . '" target="_blank">'; |
|
2434 | + $closing_a_tag = '</a>'; |
|
2435 | + } |
|
2436 | + } |
|
2437 | + $loader = LoaderFactory::getLoader(); |
|
2438 | + $org_config = $loader->getShared('EE_Organization_Config'); |
|
2439 | + /** |
|
2440 | + * @var $org_config EE_Organization_Config |
|
2441 | + */ |
|
2442 | + |
|
2443 | + $this->setConsentCheckboxLabelText( |
|
2444 | + sprintf( |
|
2445 | + esc_html__( |
|
2446 | + 'I consent to %1$s storing and using my personal information, according to their %2$sprivacy policy%3$s.', |
|
2447 | + 'event_espresso' |
|
2448 | + ), |
|
2449 | + $org_config->name, |
|
2450 | + $opening_a_tag, |
|
2451 | + $closing_a_tag |
|
2452 | + ) |
|
2453 | + ); |
|
2454 | + } |
|
2455 | + } |
|
2456 | + |
|
2457 | + |
|
2458 | + /** |
|
2459 | + * @return boolean |
|
2460 | + */ |
|
2461 | + public function track_invalid_checkout_access() |
|
2462 | + { |
|
2463 | + return $this->track_invalid_checkout_access; |
|
2464 | + } |
|
2465 | + |
|
2466 | + |
|
2467 | + /** |
|
2468 | + * @param boolean $track_invalid_checkout_access |
|
2469 | + */ |
|
2470 | + public function set_track_invalid_checkout_access($track_invalid_checkout_access) |
|
2471 | + { |
|
2472 | + $this->track_invalid_checkout_access = filter_var( |
|
2473 | + $track_invalid_checkout_access, |
|
2474 | + FILTER_VALIDATE_BOOLEAN |
|
2475 | + ); |
|
2476 | + } |
|
2477 | + |
|
2478 | + |
|
2479 | + /** |
|
2480 | + * Gets the options to make availalbe for the gateway log lifespan |
|
2481 | + * @return array |
|
2482 | + */ |
|
2483 | + public function gatewayLogLifespanOptions() |
|
2484 | + { |
|
2485 | + return (array) apply_filters( |
|
2486 | + 'FHEE_EE_Admin_Config__gatewayLogLifespanOptions', |
|
2487 | + array( |
|
2488 | + '1 second' => esc_html__('Don\'t Log At All', 'event_espresso'), |
|
2489 | + '1 day' => esc_html__('1 Day', 'event_espresso'), |
|
2490 | + '7 days' => esc_html__('7 Days', 'event_espresso'), |
|
2491 | + '14 days' => esc_html__('14 Days', 'event_espresso'), |
|
2492 | + '30 days' => esc_html__('30 Days', 'event_espresso') |
|
2493 | + ) |
|
2494 | + ); |
|
2495 | + } |
|
2496 | + |
|
2497 | + |
|
2498 | + /** |
|
2499 | + * @return bool |
|
2500 | + */ |
|
2501 | + public function isConsentCheckboxEnabled() |
|
2502 | + { |
|
2503 | + return $this->consent_checkbox_enabled; |
|
2504 | + } |
|
2505 | + |
|
2506 | + |
|
2507 | + /** |
|
2508 | + * @param bool $consent_checkbox_enabled |
|
2509 | + */ |
|
2510 | + public function setConsentCheckboxEnabled($consent_checkbox_enabled) |
|
2511 | + { |
|
2512 | + $this->consent_checkbox_enabled = filter_var( |
|
2513 | + $consent_checkbox_enabled, |
|
2514 | + FILTER_VALIDATE_BOOLEAN |
|
2515 | + ); |
|
2516 | + } |
|
2517 | + |
|
2518 | + |
|
2519 | + /** |
|
2520 | + * @return string |
|
2521 | + */ |
|
2522 | + public function getConsentCheckboxLabelText() |
|
2523 | + { |
|
2524 | + return $this->consent_checkbox_label_text; |
|
2525 | + } |
|
2526 | + |
|
2527 | + |
|
2528 | + /** |
|
2529 | + * @param string $consent_checkbox_label_text |
|
2530 | + */ |
|
2531 | + public function setConsentCheckboxLabelText($consent_checkbox_label_text) |
|
2532 | + { |
|
2533 | + $this->consent_checkbox_label_text = (string) $consent_checkbox_label_text; |
|
2534 | + } |
|
2535 | 2535 | } |
2536 | 2536 | |
2537 | 2537 | /** |
@@ -2540,154 +2540,154 @@ discard block |
||
2540 | 2540 | class EE_Admin_Config extends EE_Config_Base |
2541 | 2541 | { |
2542 | 2542 | |
2543 | - /** |
|
2544 | - * @var boolean $use_personnel_manager |
|
2545 | - */ |
|
2546 | - public $use_personnel_manager; |
|
2547 | - |
|
2548 | - /** |
|
2549 | - * @var boolean $use_dashboard_widget |
|
2550 | - */ |
|
2551 | - public $use_dashboard_widget; |
|
2552 | - |
|
2553 | - /** |
|
2554 | - * @var int $events_in_dashboard |
|
2555 | - */ |
|
2556 | - public $events_in_dashboard; |
|
2557 | - |
|
2558 | - /** |
|
2559 | - * @var boolean $use_event_timezones |
|
2560 | - */ |
|
2561 | - public $use_event_timezones; |
|
2562 | - |
|
2563 | - /** |
|
2564 | - * @var boolean $use_full_logging |
|
2565 | - */ |
|
2566 | - public $use_full_logging; |
|
2567 | - |
|
2568 | - /** |
|
2569 | - * @var string $log_file_name |
|
2570 | - */ |
|
2571 | - public $log_file_name; |
|
2572 | - |
|
2573 | - /** |
|
2574 | - * @var string $debug_file_name |
|
2575 | - */ |
|
2576 | - public $debug_file_name; |
|
2577 | - |
|
2578 | - /** |
|
2579 | - * @var boolean $use_remote_logging |
|
2580 | - */ |
|
2581 | - public $use_remote_logging; |
|
2582 | - |
|
2583 | - /** |
|
2584 | - * @var string $remote_logging_url |
|
2585 | - */ |
|
2586 | - public $remote_logging_url; |
|
2587 | - |
|
2588 | - /** |
|
2589 | - * @var boolean $show_reg_footer |
|
2590 | - */ |
|
2591 | - public $show_reg_footer; |
|
2592 | - |
|
2593 | - /** |
|
2594 | - * @var string $affiliate_id |
|
2595 | - */ |
|
2596 | - public $affiliate_id; |
|
2597 | - |
|
2598 | - /** |
|
2599 | - * help tours on or off (global setting) |
|
2600 | - * |
|
2601 | - * @var boolean |
|
2602 | - */ |
|
2603 | - public $help_tour_activation; |
|
2604 | - |
|
2605 | - /** |
|
2606 | - * adds extra layer of encoding to session data to prevent serialization errors |
|
2607 | - * but is incompatible with some server configuration errors |
|
2608 | - * if you get "500 internal server errors" during registration, try turning this on |
|
2609 | - * if you get PHP fatal errors regarding base 64 methods not defined, then turn this off |
|
2610 | - * |
|
2611 | - * @var boolean $encode_session_data |
|
2612 | - */ |
|
2613 | - private $encode_session_data = false; |
|
2614 | - |
|
2615 | - |
|
2616 | - /** |
|
2617 | - * class constructor |
|
2618 | - * |
|
2619 | - * @access public |
|
2620 | - */ |
|
2621 | - public function __construct() |
|
2622 | - { |
|
2623 | - // set default general admin settings |
|
2624 | - $this->use_personnel_manager = true; |
|
2625 | - $this->use_dashboard_widget = true; |
|
2626 | - $this->events_in_dashboard = 30; |
|
2627 | - $this->use_event_timezones = false; |
|
2628 | - $this->use_full_logging = false; |
|
2629 | - $this->use_remote_logging = false; |
|
2630 | - $this->remote_logging_url = null; |
|
2631 | - $this->show_reg_footer = true; |
|
2632 | - $this->affiliate_id = 'default'; |
|
2633 | - $this->help_tour_activation = true; |
|
2634 | - $this->encode_session_data = false; |
|
2635 | - } |
|
2636 | - |
|
2637 | - |
|
2638 | - /** |
|
2639 | - * @param bool $reset |
|
2640 | - * @return string |
|
2641 | - */ |
|
2642 | - public function log_file_name($reset = false) |
|
2643 | - { |
|
2644 | - if (empty($this->log_file_name) || $reset) { |
|
2645 | - $this->log_file_name = sanitize_key('espresso_log_' . md5(uniqid('', true))) . '.txt'; |
|
2646 | - EE_Config::instance()->update_espresso_config(false, false); |
|
2647 | - } |
|
2648 | - return $this->log_file_name; |
|
2649 | - } |
|
2650 | - |
|
2651 | - |
|
2652 | - /** |
|
2653 | - * @param bool $reset |
|
2654 | - * @return string |
|
2655 | - */ |
|
2656 | - public function debug_file_name($reset = false) |
|
2657 | - { |
|
2658 | - if (empty($this->debug_file_name) || $reset) { |
|
2659 | - $this->debug_file_name = sanitize_key('espresso_debug_' . md5(uniqid('', true))) . '.txt'; |
|
2660 | - EE_Config::instance()->update_espresso_config(false, false); |
|
2661 | - } |
|
2662 | - return $this->debug_file_name; |
|
2663 | - } |
|
2664 | - |
|
2665 | - |
|
2666 | - /** |
|
2667 | - * @return string |
|
2668 | - */ |
|
2669 | - public function affiliate_id() |
|
2670 | - { |
|
2671 | - return ! empty($this->affiliate_id) ? $this->affiliate_id : 'default'; |
|
2672 | - } |
|
2673 | - |
|
2674 | - |
|
2675 | - /** |
|
2676 | - * @return boolean |
|
2677 | - */ |
|
2678 | - public function encode_session_data() |
|
2679 | - { |
|
2680 | - return filter_var($this->encode_session_data, FILTER_VALIDATE_BOOLEAN); |
|
2681 | - } |
|
2682 | - |
|
2683 | - |
|
2684 | - /** |
|
2685 | - * @param boolean $encode_session_data |
|
2686 | - */ |
|
2687 | - public function set_encode_session_data($encode_session_data) |
|
2688 | - { |
|
2689 | - $this->encode_session_data = filter_var($encode_session_data, FILTER_VALIDATE_BOOLEAN); |
|
2690 | - } |
|
2543 | + /** |
|
2544 | + * @var boolean $use_personnel_manager |
|
2545 | + */ |
|
2546 | + public $use_personnel_manager; |
|
2547 | + |
|
2548 | + /** |
|
2549 | + * @var boolean $use_dashboard_widget |
|
2550 | + */ |
|
2551 | + public $use_dashboard_widget; |
|
2552 | + |
|
2553 | + /** |
|
2554 | + * @var int $events_in_dashboard |
|
2555 | + */ |
|
2556 | + public $events_in_dashboard; |
|
2557 | + |
|
2558 | + /** |
|
2559 | + * @var boolean $use_event_timezones |
|
2560 | + */ |
|
2561 | + public $use_event_timezones; |
|
2562 | + |
|
2563 | + /** |
|
2564 | + * @var boolean $use_full_logging |
|
2565 | + */ |
|
2566 | + public $use_full_logging; |
|
2567 | + |
|
2568 | + /** |
|
2569 | + * @var string $log_file_name |
|
2570 | + */ |
|
2571 | + public $log_file_name; |
|
2572 | + |
|
2573 | + /** |
|
2574 | + * @var string $debug_file_name |
|
2575 | + */ |
|
2576 | + public $debug_file_name; |
|
2577 | + |
|
2578 | + /** |
|
2579 | + * @var boolean $use_remote_logging |
|
2580 | + */ |
|
2581 | + public $use_remote_logging; |
|
2582 | + |
|
2583 | + /** |
|
2584 | + * @var string $remote_logging_url |
|
2585 | + */ |
|
2586 | + public $remote_logging_url; |
|
2587 | + |
|
2588 | + /** |
|
2589 | + * @var boolean $show_reg_footer |
|
2590 | + */ |
|
2591 | + public $show_reg_footer; |
|
2592 | + |
|
2593 | + /** |
|
2594 | + * @var string $affiliate_id |
|
2595 | + */ |
|
2596 | + public $affiliate_id; |
|
2597 | + |
|
2598 | + /** |
|
2599 | + * help tours on or off (global setting) |
|
2600 | + * |
|
2601 | + * @var boolean |
|
2602 | + */ |
|
2603 | + public $help_tour_activation; |
|
2604 | + |
|
2605 | + /** |
|
2606 | + * adds extra layer of encoding to session data to prevent serialization errors |
|
2607 | + * but is incompatible with some server configuration errors |
|
2608 | + * if you get "500 internal server errors" during registration, try turning this on |
|
2609 | + * if you get PHP fatal errors regarding base 64 methods not defined, then turn this off |
|
2610 | + * |
|
2611 | + * @var boolean $encode_session_data |
|
2612 | + */ |
|
2613 | + private $encode_session_data = false; |
|
2614 | + |
|
2615 | + |
|
2616 | + /** |
|
2617 | + * class constructor |
|
2618 | + * |
|
2619 | + * @access public |
|
2620 | + */ |
|
2621 | + public function __construct() |
|
2622 | + { |
|
2623 | + // set default general admin settings |
|
2624 | + $this->use_personnel_manager = true; |
|
2625 | + $this->use_dashboard_widget = true; |
|
2626 | + $this->events_in_dashboard = 30; |
|
2627 | + $this->use_event_timezones = false; |
|
2628 | + $this->use_full_logging = false; |
|
2629 | + $this->use_remote_logging = false; |
|
2630 | + $this->remote_logging_url = null; |
|
2631 | + $this->show_reg_footer = true; |
|
2632 | + $this->affiliate_id = 'default'; |
|
2633 | + $this->help_tour_activation = true; |
|
2634 | + $this->encode_session_data = false; |
|
2635 | + } |
|
2636 | + |
|
2637 | + |
|
2638 | + /** |
|
2639 | + * @param bool $reset |
|
2640 | + * @return string |
|
2641 | + */ |
|
2642 | + public function log_file_name($reset = false) |
|
2643 | + { |
|
2644 | + if (empty($this->log_file_name) || $reset) { |
|
2645 | + $this->log_file_name = sanitize_key('espresso_log_' . md5(uniqid('', true))) . '.txt'; |
|
2646 | + EE_Config::instance()->update_espresso_config(false, false); |
|
2647 | + } |
|
2648 | + return $this->log_file_name; |
|
2649 | + } |
|
2650 | + |
|
2651 | + |
|
2652 | + /** |
|
2653 | + * @param bool $reset |
|
2654 | + * @return string |
|
2655 | + */ |
|
2656 | + public function debug_file_name($reset = false) |
|
2657 | + { |
|
2658 | + if (empty($this->debug_file_name) || $reset) { |
|
2659 | + $this->debug_file_name = sanitize_key('espresso_debug_' . md5(uniqid('', true))) . '.txt'; |
|
2660 | + EE_Config::instance()->update_espresso_config(false, false); |
|
2661 | + } |
|
2662 | + return $this->debug_file_name; |
|
2663 | + } |
|
2664 | + |
|
2665 | + |
|
2666 | + /** |
|
2667 | + * @return string |
|
2668 | + */ |
|
2669 | + public function affiliate_id() |
|
2670 | + { |
|
2671 | + return ! empty($this->affiliate_id) ? $this->affiliate_id : 'default'; |
|
2672 | + } |
|
2673 | + |
|
2674 | + |
|
2675 | + /** |
|
2676 | + * @return boolean |
|
2677 | + */ |
|
2678 | + public function encode_session_data() |
|
2679 | + { |
|
2680 | + return filter_var($this->encode_session_data, FILTER_VALIDATE_BOOLEAN); |
|
2681 | + } |
|
2682 | + |
|
2683 | + |
|
2684 | + /** |
|
2685 | + * @param boolean $encode_session_data |
|
2686 | + */ |
|
2687 | + public function set_encode_session_data($encode_session_data) |
|
2688 | + { |
|
2689 | + $this->encode_session_data = filter_var($encode_session_data, FILTER_VALIDATE_BOOLEAN); |
|
2690 | + } |
|
2691 | 2691 | } |
2692 | 2692 | |
2693 | 2693 | /** |
@@ -2696,70 +2696,70 @@ discard block |
||
2696 | 2696 | class EE_Template_Config extends EE_Config_Base |
2697 | 2697 | { |
2698 | 2698 | |
2699 | - /** |
|
2700 | - * @var boolean $enable_default_style |
|
2701 | - */ |
|
2702 | - public $enable_default_style; |
|
2703 | - |
|
2704 | - /** |
|
2705 | - * @var string $custom_style_sheet |
|
2706 | - */ |
|
2707 | - public $custom_style_sheet; |
|
2708 | - |
|
2709 | - /** |
|
2710 | - * @var boolean $display_address_in_regform |
|
2711 | - */ |
|
2712 | - public $display_address_in_regform; |
|
2713 | - |
|
2714 | - /** |
|
2715 | - * @var int $display_description_on_multi_reg_page |
|
2716 | - */ |
|
2717 | - public $display_description_on_multi_reg_page; |
|
2718 | - |
|
2719 | - /** |
|
2720 | - * @var boolean $use_custom_templates |
|
2721 | - */ |
|
2722 | - public $use_custom_templates; |
|
2723 | - |
|
2724 | - /** |
|
2725 | - * @var string $current_espresso_theme |
|
2726 | - */ |
|
2727 | - public $current_espresso_theme; |
|
2728 | - |
|
2729 | - /** |
|
2730 | - * @var EE_Ticket_Selector_Config $EED_Ticket_Selector |
|
2731 | - */ |
|
2732 | - public $EED_Ticket_Selector; |
|
2733 | - |
|
2734 | - /** |
|
2735 | - * @var EE_Event_Single_Config $EED_Event_Single |
|
2736 | - */ |
|
2737 | - public $EED_Event_Single; |
|
2738 | - |
|
2739 | - /** |
|
2740 | - * @var EE_Events_Archive_Config $EED_Events_Archive |
|
2741 | - */ |
|
2742 | - public $EED_Events_Archive; |
|
2743 | - |
|
2744 | - |
|
2745 | - /** |
|
2746 | - * class constructor |
|
2747 | - * |
|
2748 | - * @access public |
|
2749 | - */ |
|
2750 | - public function __construct() |
|
2751 | - { |
|
2752 | - // set default template settings |
|
2753 | - $this->enable_default_style = true; |
|
2754 | - $this->custom_style_sheet = null; |
|
2755 | - $this->display_address_in_regform = true; |
|
2756 | - $this->display_description_on_multi_reg_page = false; |
|
2757 | - $this->use_custom_templates = false; |
|
2758 | - $this->current_espresso_theme = 'Espresso_Arabica_2014'; |
|
2759 | - $this->EED_Event_Single = null; |
|
2760 | - $this->EED_Events_Archive = null; |
|
2761 | - $this->EED_Ticket_Selector = null; |
|
2762 | - } |
|
2699 | + /** |
|
2700 | + * @var boolean $enable_default_style |
|
2701 | + */ |
|
2702 | + public $enable_default_style; |
|
2703 | + |
|
2704 | + /** |
|
2705 | + * @var string $custom_style_sheet |
|
2706 | + */ |
|
2707 | + public $custom_style_sheet; |
|
2708 | + |
|
2709 | + /** |
|
2710 | + * @var boolean $display_address_in_regform |
|
2711 | + */ |
|
2712 | + public $display_address_in_regform; |
|
2713 | + |
|
2714 | + /** |
|
2715 | + * @var int $display_description_on_multi_reg_page |
|
2716 | + */ |
|
2717 | + public $display_description_on_multi_reg_page; |
|
2718 | + |
|
2719 | + /** |
|
2720 | + * @var boolean $use_custom_templates |
|
2721 | + */ |
|
2722 | + public $use_custom_templates; |
|
2723 | + |
|
2724 | + /** |
|
2725 | + * @var string $current_espresso_theme |
|
2726 | + */ |
|
2727 | + public $current_espresso_theme; |
|
2728 | + |
|
2729 | + /** |
|
2730 | + * @var EE_Ticket_Selector_Config $EED_Ticket_Selector |
|
2731 | + */ |
|
2732 | + public $EED_Ticket_Selector; |
|
2733 | + |
|
2734 | + /** |
|
2735 | + * @var EE_Event_Single_Config $EED_Event_Single |
|
2736 | + */ |
|
2737 | + public $EED_Event_Single; |
|
2738 | + |
|
2739 | + /** |
|
2740 | + * @var EE_Events_Archive_Config $EED_Events_Archive |
|
2741 | + */ |
|
2742 | + public $EED_Events_Archive; |
|
2743 | + |
|
2744 | + |
|
2745 | + /** |
|
2746 | + * class constructor |
|
2747 | + * |
|
2748 | + * @access public |
|
2749 | + */ |
|
2750 | + public function __construct() |
|
2751 | + { |
|
2752 | + // set default template settings |
|
2753 | + $this->enable_default_style = true; |
|
2754 | + $this->custom_style_sheet = null; |
|
2755 | + $this->display_address_in_regform = true; |
|
2756 | + $this->display_description_on_multi_reg_page = false; |
|
2757 | + $this->use_custom_templates = false; |
|
2758 | + $this->current_espresso_theme = 'Espresso_Arabica_2014'; |
|
2759 | + $this->EED_Event_Single = null; |
|
2760 | + $this->EED_Events_Archive = null; |
|
2761 | + $this->EED_Ticket_Selector = null; |
|
2762 | + } |
|
2763 | 2763 | } |
2764 | 2764 | |
2765 | 2765 | /** |
@@ -2768,114 +2768,114 @@ discard block |
||
2768 | 2768 | class EE_Map_Config extends EE_Config_Base |
2769 | 2769 | { |
2770 | 2770 | |
2771 | - /** |
|
2772 | - * @var boolean $use_google_maps |
|
2773 | - */ |
|
2774 | - public $use_google_maps; |
|
2775 | - |
|
2776 | - /** |
|
2777 | - * @var string $api_key |
|
2778 | - */ |
|
2779 | - public $google_map_api_key; |
|
2780 | - |
|
2781 | - /** |
|
2782 | - * @var int $event_details_map_width |
|
2783 | - */ |
|
2784 | - public $event_details_map_width; |
|
2785 | - |
|
2786 | - /** |
|
2787 | - * @var int $event_details_map_height |
|
2788 | - */ |
|
2789 | - public $event_details_map_height; |
|
2790 | - |
|
2791 | - /** |
|
2792 | - * @var int $event_details_map_zoom |
|
2793 | - */ |
|
2794 | - public $event_details_map_zoom; |
|
2795 | - |
|
2796 | - /** |
|
2797 | - * @var boolean $event_details_display_nav |
|
2798 | - */ |
|
2799 | - public $event_details_display_nav; |
|
2800 | - |
|
2801 | - /** |
|
2802 | - * @var boolean $event_details_nav_size |
|
2803 | - */ |
|
2804 | - public $event_details_nav_size; |
|
2805 | - |
|
2806 | - /** |
|
2807 | - * @var string $event_details_control_type |
|
2808 | - */ |
|
2809 | - public $event_details_control_type; |
|
2810 | - |
|
2811 | - /** |
|
2812 | - * @var string $event_details_map_align |
|
2813 | - */ |
|
2814 | - public $event_details_map_align; |
|
2815 | - |
|
2816 | - /** |
|
2817 | - * @var int $event_list_map_width |
|
2818 | - */ |
|
2819 | - public $event_list_map_width; |
|
2820 | - |
|
2821 | - /** |
|
2822 | - * @var int $event_list_map_height |
|
2823 | - */ |
|
2824 | - public $event_list_map_height; |
|
2825 | - |
|
2826 | - /** |
|
2827 | - * @var int $event_list_map_zoom |
|
2828 | - */ |
|
2829 | - public $event_list_map_zoom; |
|
2830 | - |
|
2831 | - /** |
|
2832 | - * @var boolean $event_list_display_nav |
|
2833 | - */ |
|
2834 | - public $event_list_display_nav; |
|
2835 | - |
|
2836 | - /** |
|
2837 | - * @var boolean $event_list_nav_size |
|
2838 | - */ |
|
2839 | - public $event_list_nav_size; |
|
2840 | - |
|
2841 | - /** |
|
2842 | - * @var string $event_list_control_type |
|
2843 | - */ |
|
2844 | - public $event_list_control_type; |
|
2845 | - |
|
2846 | - /** |
|
2847 | - * @var string $event_list_map_align |
|
2848 | - */ |
|
2849 | - public $event_list_map_align; |
|
2850 | - |
|
2851 | - |
|
2852 | - /** |
|
2853 | - * class constructor |
|
2854 | - * |
|
2855 | - * @access public |
|
2856 | - */ |
|
2857 | - public function __construct() |
|
2858 | - { |
|
2859 | - // set default map settings |
|
2860 | - $this->use_google_maps = true; |
|
2861 | - $this->google_map_api_key = ''; |
|
2862 | - // for event details pages (reg page) |
|
2863 | - $this->event_details_map_width = 585; // ee_map_width_single |
|
2864 | - $this->event_details_map_height = 362; // ee_map_height_single |
|
2865 | - $this->event_details_map_zoom = 14; // ee_map_zoom_single |
|
2866 | - $this->event_details_display_nav = true; // ee_map_nav_display_single |
|
2867 | - $this->event_details_nav_size = false; // ee_map_nav_size_single |
|
2868 | - $this->event_details_control_type = 'default'; // ee_map_type_control_single |
|
2869 | - $this->event_details_map_align = 'center'; // ee_map_align_single |
|
2870 | - // for event list pages |
|
2871 | - $this->event_list_map_width = 300; // ee_map_width |
|
2872 | - $this->event_list_map_height = 185; // ee_map_height |
|
2873 | - $this->event_list_map_zoom = 12; // ee_map_zoom |
|
2874 | - $this->event_list_display_nav = false; // ee_map_nav_display |
|
2875 | - $this->event_list_nav_size = true; // ee_map_nav_size |
|
2876 | - $this->event_list_control_type = 'dropdown'; // ee_map_type_control |
|
2877 | - $this->event_list_map_align = 'center'; // ee_map_align |
|
2878 | - } |
|
2771 | + /** |
|
2772 | + * @var boolean $use_google_maps |
|
2773 | + */ |
|
2774 | + public $use_google_maps; |
|
2775 | + |
|
2776 | + /** |
|
2777 | + * @var string $api_key |
|
2778 | + */ |
|
2779 | + public $google_map_api_key; |
|
2780 | + |
|
2781 | + /** |
|
2782 | + * @var int $event_details_map_width |
|
2783 | + */ |
|
2784 | + public $event_details_map_width; |
|
2785 | + |
|
2786 | + /** |
|
2787 | + * @var int $event_details_map_height |
|
2788 | + */ |
|
2789 | + public $event_details_map_height; |
|
2790 | + |
|
2791 | + /** |
|
2792 | + * @var int $event_details_map_zoom |
|
2793 | + */ |
|
2794 | + public $event_details_map_zoom; |
|
2795 | + |
|
2796 | + /** |
|
2797 | + * @var boolean $event_details_display_nav |
|
2798 | + */ |
|
2799 | + public $event_details_display_nav; |
|
2800 | + |
|
2801 | + /** |
|
2802 | + * @var boolean $event_details_nav_size |
|
2803 | + */ |
|
2804 | + public $event_details_nav_size; |
|
2805 | + |
|
2806 | + /** |
|
2807 | + * @var string $event_details_control_type |
|
2808 | + */ |
|
2809 | + public $event_details_control_type; |
|
2810 | + |
|
2811 | + /** |
|
2812 | + * @var string $event_details_map_align |
|
2813 | + */ |
|
2814 | + public $event_details_map_align; |
|
2815 | + |
|
2816 | + /** |
|
2817 | + * @var int $event_list_map_width |
|
2818 | + */ |
|
2819 | + public $event_list_map_width; |
|
2820 | + |
|
2821 | + /** |
|
2822 | + * @var int $event_list_map_height |
|
2823 | + */ |
|
2824 | + public $event_list_map_height; |
|
2825 | + |
|
2826 | + /** |
|
2827 | + * @var int $event_list_map_zoom |
|
2828 | + */ |
|
2829 | + public $event_list_map_zoom; |
|
2830 | + |
|
2831 | + /** |
|
2832 | + * @var boolean $event_list_display_nav |
|
2833 | + */ |
|
2834 | + public $event_list_display_nav; |
|
2835 | + |
|
2836 | + /** |
|
2837 | + * @var boolean $event_list_nav_size |
|
2838 | + */ |
|
2839 | + public $event_list_nav_size; |
|
2840 | + |
|
2841 | + /** |
|
2842 | + * @var string $event_list_control_type |
|
2843 | + */ |
|
2844 | + public $event_list_control_type; |
|
2845 | + |
|
2846 | + /** |
|
2847 | + * @var string $event_list_map_align |
|
2848 | + */ |
|
2849 | + public $event_list_map_align; |
|
2850 | + |
|
2851 | + |
|
2852 | + /** |
|
2853 | + * class constructor |
|
2854 | + * |
|
2855 | + * @access public |
|
2856 | + */ |
|
2857 | + public function __construct() |
|
2858 | + { |
|
2859 | + // set default map settings |
|
2860 | + $this->use_google_maps = true; |
|
2861 | + $this->google_map_api_key = ''; |
|
2862 | + // for event details pages (reg page) |
|
2863 | + $this->event_details_map_width = 585; // ee_map_width_single |
|
2864 | + $this->event_details_map_height = 362; // ee_map_height_single |
|
2865 | + $this->event_details_map_zoom = 14; // ee_map_zoom_single |
|
2866 | + $this->event_details_display_nav = true; // ee_map_nav_display_single |
|
2867 | + $this->event_details_nav_size = false; // ee_map_nav_size_single |
|
2868 | + $this->event_details_control_type = 'default'; // ee_map_type_control_single |
|
2869 | + $this->event_details_map_align = 'center'; // ee_map_align_single |
|
2870 | + // for event list pages |
|
2871 | + $this->event_list_map_width = 300; // ee_map_width |
|
2872 | + $this->event_list_map_height = 185; // ee_map_height |
|
2873 | + $this->event_list_map_zoom = 12; // ee_map_zoom |
|
2874 | + $this->event_list_display_nav = false; // ee_map_nav_display |
|
2875 | + $this->event_list_nav_size = true; // ee_map_nav_size |
|
2876 | + $this->event_list_control_type = 'dropdown'; // ee_map_type_control |
|
2877 | + $this->event_list_map_align = 'center'; // ee_map_align |
|
2878 | + } |
|
2879 | 2879 | } |
2880 | 2880 | |
2881 | 2881 | /** |
@@ -2884,46 +2884,46 @@ discard block |
||
2884 | 2884 | class EE_Events_Archive_Config extends EE_Config_Base |
2885 | 2885 | { |
2886 | 2886 | |
2887 | - public $display_status_banner; |
|
2887 | + public $display_status_banner; |
|
2888 | 2888 | |
2889 | - public $display_description; |
|
2889 | + public $display_description; |
|
2890 | 2890 | |
2891 | - public $display_ticket_selector; |
|
2891 | + public $display_ticket_selector; |
|
2892 | 2892 | |
2893 | - public $display_datetimes; |
|
2893 | + public $display_datetimes; |
|
2894 | 2894 | |
2895 | - public $display_venue; |
|
2895 | + public $display_venue; |
|
2896 | 2896 | |
2897 | - public $display_expired_events; |
|
2897 | + public $display_expired_events; |
|
2898 | 2898 | |
2899 | - public $use_sortable_display_order; |
|
2899 | + public $use_sortable_display_order; |
|
2900 | 2900 | |
2901 | - public $display_order_tickets; |
|
2901 | + public $display_order_tickets; |
|
2902 | 2902 | |
2903 | - public $display_order_datetimes; |
|
2903 | + public $display_order_datetimes; |
|
2904 | 2904 | |
2905 | - public $display_order_event; |
|
2905 | + public $display_order_event; |
|
2906 | 2906 | |
2907 | - public $display_order_venue; |
|
2907 | + public $display_order_venue; |
|
2908 | 2908 | |
2909 | 2909 | |
2910 | - /** |
|
2911 | - * class constructor |
|
2912 | - */ |
|
2913 | - public function __construct() |
|
2914 | - { |
|
2915 | - $this->display_status_banner = 0; |
|
2916 | - $this->display_description = 1; |
|
2917 | - $this->display_ticket_selector = 0; |
|
2918 | - $this->display_datetimes = 1; |
|
2919 | - $this->display_venue = 0; |
|
2920 | - $this->display_expired_events = 0; |
|
2921 | - $this->use_sortable_display_order = false; |
|
2922 | - $this->display_order_tickets = 100; |
|
2923 | - $this->display_order_datetimes = 110; |
|
2924 | - $this->display_order_event = 120; |
|
2925 | - $this->display_order_venue = 130; |
|
2926 | - } |
|
2910 | + /** |
|
2911 | + * class constructor |
|
2912 | + */ |
|
2913 | + public function __construct() |
|
2914 | + { |
|
2915 | + $this->display_status_banner = 0; |
|
2916 | + $this->display_description = 1; |
|
2917 | + $this->display_ticket_selector = 0; |
|
2918 | + $this->display_datetimes = 1; |
|
2919 | + $this->display_venue = 0; |
|
2920 | + $this->display_expired_events = 0; |
|
2921 | + $this->use_sortable_display_order = false; |
|
2922 | + $this->display_order_tickets = 100; |
|
2923 | + $this->display_order_datetimes = 110; |
|
2924 | + $this->display_order_event = 120; |
|
2925 | + $this->display_order_venue = 130; |
|
2926 | + } |
|
2927 | 2927 | } |
2928 | 2928 | |
2929 | 2929 | /** |
@@ -2932,34 +2932,34 @@ discard block |
||
2932 | 2932 | class EE_Event_Single_Config extends EE_Config_Base |
2933 | 2933 | { |
2934 | 2934 | |
2935 | - public $display_status_banner_single; |
|
2935 | + public $display_status_banner_single; |
|
2936 | 2936 | |
2937 | - public $display_venue; |
|
2937 | + public $display_venue; |
|
2938 | 2938 | |
2939 | - public $use_sortable_display_order; |
|
2939 | + public $use_sortable_display_order; |
|
2940 | 2940 | |
2941 | - public $display_order_tickets; |
|
2941 | + public $display_order_tickets; |
|
2942 | 2942 | |
2943 | - public $display_order_datetimes; |
|
2943 | + public $display_order_datetimes; |
|
2944 | 2944 | |
2945 | - public $display_order_event; |
|
2945 | + public $display_order_event; |
|
2946 | 2946 | |
2947 | - public $display_order_venue; |
|
2947 | + public $display_order_venue; |
|
2948 | 2948 | |
2949 | 2949 | |
2950 | - /** |
|
2951 | - * class constructor |
|
2952 | - */ |
|
2953 | - public function __construct() |
|
2954 | - { |
|
2955 | - $this->display_status_banner_single = 0; |
|
2956 | - $this->display_venue = 1; |
|
2957 | - $this->use_sortable_display_order = false; |
|
2958 | - $this->display_order_tickets = 100; |
|
2959 | - $this->display_order_datetimes = 110; |
|
2960 | - $this->display_order_event = 120; |
|
2961 | - $this->display_order_venue = 130; |
|
2962 | - } |
|
2950 | + /** |
|
2951 | + * class constructor |
|
2952 | + */ |
|
2953 | + public function __construct() |
|
2954 | + { |
|
2955 | + $this->display_status_banner_single = 0; |
|
2956 | + $this->display_venue = 1; |
|
2957 | + $this->use_sortable_display_order = false; |
|
2958 | + $this->display_order_tickets = 100; |
|
2959 | + $this->display_order_datetimes = 110; |
|
2960 | + $this->display_order_event = 120; |
|
2961 | + $this->display_order_venue = 130; |
|
2962 | + } |
|
2963 | 2963 | } |
2964 | 2964 | |
2965 | 2965 | /** |
@@ -2968,172 +2968,172 @@ discard block |
||
2968 | 2968 | class EE_Ticket_Selector_Config extends EE_Config_Base |
2969 | 2969 | { |
2970 | 2970 | |
2971 | - /** |
|
2972 | - * constant to indicate that a datetime selector should NEVER be shown for ticket selectors |
|
2973 | - */ |
|
2974 | - const DO_NOT_SHOW_DATETIME_SELECTOR = 'no_datetime_selector'; |
|
2975 | - |
|
2976 | - /** |
|
2977 | - * constant to indicate that a datetime selector should only be shown for ticket selectors |
|
2978 | - * when the number of datetimes for the event matches the value set for $datetime_selector_threshold |
|
2979 | - */ |
|
2980 | - const MAYBE_SHOW_DATETIME_SELECTOR = 'maybe_datetime_selector'; |
|
2981 | - |
|
2982 | - /** |
|
2983 | - * @var boolean $show_ticket_sale_columns |
|
2984 | - */ |
|
2985 | - public $show_ticket_sale_columns; |
|
2986 | - |
|
2987 | - /** |
|
2988 | - * @var boolean $show_ticket_details |
|
2989 | - */ |
|
2990 | - public $show_ticket_details; |
|
2991 | - |
|
2992 | - /** |
|
2993 | - * @var boolean $show_expired_tickets |
|
2994 | - */ |
|
2995 | - public $show_expired_tickets; |
|
2996 | - |
|
2997 | - /** |
|
2998 | - * whether or not to display a dropdown box populated with event datetimes |
|
2999 | - * that toggles which tickets are displayed for a ticket selector. |
|
3000 | - * uses one of the *_DATETIME_SELECTOR constants defined above |
|
3001 | - * |
|
3002 | - * @var string $show_datetime_selector |
|
3003 | - */ |
|
3004 | - private $show_datetime_selector = 'no_datetime_selector'; |
|
3005 | - |
|
3006 | - /** |
|
3007 | - * the number of datetimes an event has to have before conditionally displaying a datetime selector |
|
3008 | - * |
|
3009 | - * @var int $datetime_selector_threshold |
|
3010 | - */ |
|
3011 | - private $datetime_selector_threshold = 3; |
|
3012 | - |
|
3013 | - /** |
|
3014 | - * determines the maximum number of "checked" dates in the date and time filter |
|
3015 | - * |
|
3016 | - * @var int $datetime_selector_checked |
|
3017 | - */ |
|
3018 | - private $datetime_selector_max_checked = 10; |
|
3019 | - |
|
3020 | - |
|
3021 | - /** |
|
3022 | - * class constructor |
|
3023 | - */ |
|
3024 | - public function __construct() |
|
3025 | - { |
|
3026 | - $this->show_ticket_sale_columns = true; |
|
3027 | - $this->show_ticket_details = true; |
|
3028 | - $this->show_expired_tickets = true; |
|
3029 | - $this->show_datetime_selector = \EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR; |
|
3030 | - $this->datetime_selector_threshold = 3; |
|
3031 | - $this->datetime_selector_max_checked = 10; |
|
3032 | - } |
|
3033 | - |
|
3034 | - |
|
3035 | - /** |
|
3036 | - * returns true if a datetime selector should be displayed |
|
3037 | - * |
|
3038 | - * @param array $datetimes |
|
3039 | - * @return bool |
|
3040 | - */ |
|
3041 | - public function showDatetimeSelector(array $datetimes) |
|
3042 | - { |
|
3043 | - // if the settings are NOT: don't show OR below threshold, THEN active = true |
|
3044 | - return ! ( |
|
3045 | - $this->getShowDatetimeSelector() === \EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR |
|
3046 | - || ( |
|
3047 | - $this->getShowDatetimeSelector() === \EE_Ticket_Selector_Config::MAYBE_SHOW_DATETIME_SELECTOR |
|
3048 | - && count($datetimes) < $this->getDatetimeSelectorThreshold() |
|
3049 | - ) |
|
3050 | - ); |
|
3051 | - } |
|
3052 | - |
|
3053 | - |
|
3054 | - /** |
|
3055 | - * @return string |
|
3056 | - */ |
|
3057 | - public function getShowDatetimeSelector() |
|
3058 | - { |
|
3059 | - return $this->show_datetime_selector; |
|
3060 | - } |
|
3061 | - |
|
3062 | - |
|
3063 | - /** |
|
3064 | - * @param bool $keys_only |
|
3065 | - * @return array |
|
3066 | - */ |
|
3067 | - public function getShowDatetimeSelectorOptions($keys_only = true) |
|
3068 | - { |
|
3069 | - return $keys_only |
|
3070 | - ? array( |
|
3071 | - \EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR, |
|
3072 | - \EE_Ticket_Selector_Config::MAYBE_SHOW_DATETIME_SELECTOR, |
|
3073 | - ) |
|
3074 | - : array( |
|
3075 | - \EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR => esc_html__( |
|
3076 | - 'Do not show date & time filter', |
|
3077 | - 'event_espresso' |
|
3078 | - ), |
|
3079 | - \EE_Ticket_Selector_Config::MAYBE_SHOW_DATETIME_SELECTOR => esc_html__( |
|
3080 | - 'Maybe show date & time filter', |
|
3081 | - 'event_espresso' |
|
3082 | - ), |
|
3083 | - ); |
|
3084 | - } |
|
3085 | - |
|
3086 | - |
|
3087 | - /** |
|
3088 | - * @param string $show_datetime_selector |
|
3089 | - */ |
|
3090 | - public function setShowDatetimeSelector($show_datetime_selector) |
|
3091 | - { |
|
3092 | - $this->show_datetime_selector = in_array( |
|
3093 | - $show_datetime_selector, |
|
3094 | - $this->getShowDatetimeSelectorOptions(), |
|
3095 | - true |
|
3096 | - ) |
|
3097 | - ? $show_datetime_selector |
|
3098 | - : \EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR; |
|
3099 | - } |
|
3100 | - |
|
3101 | - |
|
3102 | - /** |
|
3103 | - * @return int |
|
3104 | - */ |
|
3105 | - public function getDatetimeSelectorThreshold() |
|
3106 | - { |
|
3107 | - return $this->datetime_selector_threshold; |
|
3108 | - } |
|
3109 | - |
|
3110 | - |
|
3111 | - /** |
|
3112 | - * @param int $datetime_selector_threshold |
|
3113 | - */ |
|
3114 | - public function setDatetimeSelectorThreshold($datetime_selector_threshold) |
|
3115 | - { |
|
3116 | - $datetime_selector_threshold = absint($datetime_selector_threshold); |
|
3117 | - $this->datetime_selector_threshold = $datetime_selector_threshold ? $datetime_selector_threshold : 3; |
|
3118 | - } |
|
3119 | - |
|
3120 | - |
|
3121 | - /** |
|
3122 | - * @return int |
|
3123 | - */ |
|
3124 | - public function getDatetimeSelectorMaxChecked() |
|
3125 | - { |
|
3126 | - return $this->datetime_selector_max_checked; |
|
3127 | - } |
|
3128 | - |
|
3129 | - |
|
3130 | - /** |
|
3131 | - * @param int $datetime_selector_max_checked |
|
3132 | - */ |
|
3133 | - public function setDatetimeSelectorMaxChecked($datetime_selector_max_checked) |
|
3134 | - { |
|
3135 | - $this->datetime_selector_max_checked = absint($datetime_selector_max_checked); |
|
3136 | - } |
|
2971 | + /** |
|
2972 | + * constant to indicate that a datetime selector should NEVER be shown for ticket selectors |
|
2973 | + */ |
|
2974 | + const DO_NOT_SHOW_DATETIME_SELECTOR = 'no_datetime_selector'; |
|
2975 | + |
|
2976 | + /** |
|
2977 | + * constant to indicate that a datetime selector should only be shown for ticket selectors |
|
2978 | + * when the number of datetimes for the event matches the value set for $datetime_selector_threshold |
|
2979 | + */ |
|
2980 | + const MAYBE_SHOW_DATETIME_SELECTOR = 'maybe_datetime_selector'; |
|
2981 | + |
|
2982 | + /** |
|
2983 | + * @var boolean $show_ticket_sale_columns |
|
2984 | + */ |
|
2985 | + public $show_ticket_sale_columns; |
|
2986 | + |
|
2987 | + /** |
|
2988 | + * @var boolean $show_ticket_details |
|
2989 | + */ |
|
2990 | + public $show_ticket_details; |
|
2991 | + |
|
2992 | + /** |
|
2993 | + * @var boolean $show_expired_tickets |
|
2994 | + */ |
|
2995 | + public $show_expired_tickets; |
|
2996 | + |
|
2997 | + /** |
|
2998 | + * whether or not to display a dropdown box populated with event datetimes |
|
2999 | + * that toggles which tickets are displayed for a ticket selector. |
|
3000 | + * uses one of the *_DATETIME_SELECTOR constants defined above |
|
3001 | + * |
|
3002 | + * @var string $show_datetime_selector |
|
3003 | + */ |
|
3004 | + private $show_datetime_selector = 'no_datetime_selector'; |
|
3005 | + |
|
3006 | + /** |
|
3007 | + * the number of datetimes an event has to have before conditionally displaying a datetime selector |
|
3008 | + * |
|
3009 | + * @var int $datetime_selector_threshold |
|
3010 | + */ |
|
3011 | + private $datetime_selector_threshold = 3; |
|
3012 | + |
|
3013 | + /** |
|
3014 | + * determines the maximum number of "checked" dates in the date and time filter |
|
3015 | + * |
|
3016 | + * @var int $datetime_selector_checked |
|
3017 | + */ |
|
3018 | + private $datetime_selector_max_checked = 10; |
|
3019 | + |
|
3020 | + |
|
3021 | + /** |
|
3022 | + * class constructor |
|
3023 | + */ |
|
3024 | + public function __construct() |
|
3025 | + { |
|
3026 | + $this->show_ticket_sale_columns = true; |
|
3027 | + $this->show_ticket_details = true; |
|
3028 | + $this->show_expired_tickets = true; |
|
3029 | + $this->show_datetime_selector = \EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR; |
|
3030 | + $this->datetime_selector_threshold = 3; |
|
3031 | + $this->datetime_selector_max_checked = 10; |
|
3032 | + } |
|
3033 | + |
|
3034 | + |
|
3035 | + /** |
|
3036 | + * returns true if a datetime selector should be displayed |
|
3037 | + * |
|
3038 | + * @param array $datetimes |
|
3039 | + * @return bool |
|
3040 | + */ |
|
3041 | + public function showDatetimeSelector(array $datetimes) |
|
3042 | + { |
|
3043 | + // if the settings are NOT: don't show OR below threshold, THEN active = true |
|
3044 | + return ! ( |
|
3045 | + $this->getShowDatetimeSelector() === \EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR |
|
3046 | + || ( |
|
3047 | + $this->getShowDatetimeSelector() === \EE_Ticket_Selector_Config::MAYBE_SHOW_DATETIME_SELECTOR |
|
3048 | + && count($datetimes) < $this->getDatetimeSelectorThreshold() |
|
3049 | + ) |
|
3050 | + ); |
|
3051 | + } |
|
3052 | + |
|
3053 | + |
|
3054 | + /** |
|
3055 | + * @return string |
|
3056 | + */ |
|
3057 | + public function getShowDatetimeSelector() |
|
3058 | + { |
|
3059 | + return $this->show_datetime_selector; |
|
3060 | + } |
|
3061 | + |
|
3062 | + |
|
3063 | + /** |
|
3064 | + * @param bool $keys_only |
|
3065 | + * @return array |
|
3066 | + */ |
|
3067 | + public function getShowDatetimeSelectorOptions($keys_only = true) |
|
3068 | + { |
|
3069 | + return $keys_only |
|
3070 | + ? array( |
|
3071 | + \EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR, |
|
3072 | + \EE_Ticket_Selector_Config::MAYBE_SHOW_DATETIME_SELECTOR, |
|
3073 | + ) |
|
3074 | + : array( |
|
3075 | + \EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR => esc_html__( |
|
3076 | + 'Do not show date & time filter', |
|
3077 | + 'event_espresso' |
|
3078 | + ), |
|
3079 | + \EE_Ticket_Selector_Config::MAYBE_SHOW_DATETIME_SELECTOR => esc_html__( |
|
3080 | + 'Maybe show date & time filter', |
|
3081 | + 'event_espresso' |
|
3082 | + ), |
|
3083 | + ); |
|
3084 | + } |
|
3085 | + |
|
3086 | + |
|
3087 | + /** |
|
3088 | + * @param string $show_datetime_selector |
|
3089 | + */ |
|
3090 | + public function setShowDatetimeSelector($show_datetime_selector) |
|
3091 | + { |
|
3092 | + $this->show_datetime_selector = in_array( |
|
3093 | + $show_datetime_selector, |
|
3094 | + $this->getShowDatetimeSelectorOptions(), |
|
3095 | + true |
|
3096 | + ) |
|
3097 | + ? $show_datetime_selector |
|
3098 | + : \EE_Ticket_Selector_Config::DO_NOT_SHOW_DATETIME_SELECTOR; |
|
3099 | + } |
|
3100 | + |
|
3101 | + |
|
3102 | + /** |
|
3103 | + * @return int |
|
3104 | + */ |
|
3105 | + public function getDatetimeSelectorThreshold() |
|
3106 | + { |
|
3107 | + return $this->datetime_selector_threshold; |
|
3108 | + } |
|
3109 | + |
|
3110 | + |
|
3111 | + /** |
|
3112 | + * @param int $datetime_selector_threshold |
|
3113 | + */ |
|
3114 | + public function setDatetimeSelectorThreshold($datetime_selector_threshold) |
|
3115 | + { |
|
3116 | + $datetime_selector_threshold = absint($datetime_selector_threshold); |
|
3117 | + $this->datetime_selector_threshold = $datetime_selector_threshold ? $datetime_selector_threshold : 3; |
|
3118 | + } |
|
3119 | + |
|
3120 | + |
|
3121 | + /** |
|
3122 | + * @return int |
|
3123 | + */ |
|
3124 | + public function getDatetimeSelectorMaxChecked() |
|
3125 | + { |
|
3126 | + return $this->datetime_selector_max_checked; |
|
3127 | + } |
|
3128 | + |
|
3129 | + |
|
3130 | + /** |
|
3131 | + * @param int $datetime_selector_max_checked |
|
3132 | + */ |
|
3133 | + public function setDatetimeSelectorMaxChecked($datetime_selector_max_checked) |
|
3134 | + { |
|
3135 | + $this->datetime_selector_max_checked = absint($datetime_selector_max_checked); |
|
3136 | + } |
|
3137 | 3137 | } |
3138 | 3138 | |
3139 | 3139 | /** |
@@ -3146,81 +3146,81 @@ discard block |
||
3146 | 3146 | class EE_Environment_Config extends EE_Config_Base |
3147 | 3147 | { |
3148 | 3148 | |
3149 | - /** |
|
3150 | - * Hold any php environment variables that we want to track. |
|
3151 | - * |
|
3152 | - * @var stdClass; |
|
3153 | - */ |
|
3154 | - public $php; |
|
3155 | - |
|
3156 | - |
|
3157 | - /** |
|
3158 | - * constructor |
|
3159 | - */ |
|
3160 | - public function __construct() |
|
3161 | - { |
|
3162 | - $this->php = new stdClass(); |
|
3163 | - $this->_set_php_values(); |
|
3164 | - } |
|
3165 | - |
|
3166 | - |
|
3167 | - /** |
|
3168 | - * This sets the php environment variables. |
|
3169 | - * |
|
3170 | - * @since 4.4.0 |
|
3171 | - * @return void |
|
3172 | - */ |
|
3173 | - protected function _set_php_values() |
|
3174 | - { |
|
3175 | - $this->php->max_input_vars = ini_get('max_input_vars'); |
|
3176 | - $this->php->version = phpversion(); |
|
3177 | - } |
|
3178 | - |
|
3179 | - |
|
3180 | - /** |
|
3181 | - * helper method for determining whether input_count is |
|
3182 | - * reaching the potential maximum the server can handle |
|
3183 | - * according to max_input_vars |
|
3184 | - * |
|
3185 | - * @param int $input_count the count of input vars. |
|
3186 | - * @return array { |
|
3187 | - * An array that represents whether available space and if no available space the error |
|
3188 | - * message. |
|
3189 | - * @type bool $has_space whether more inputs can be added. |
|
3190 | - * @type string $msg Any message to be displayed. |
|
3191 | - * } |
|
3192 | - */ |
|
3193 | - public function max_input_vars_limit_check($input_count = 0) |
|
3194 | - { |
|
3195 | - if (! empty($this->php->max_input_vars) |
|
3196 | - && ($input_count >= $this->php->max_input_vars) |
|
3197 | - && (PHP_MAJOR_VERSION >= 5 && PHP_MINOR_VERSION >= 3 && PHP_RELEASE_VERSION >= 9) |
|
3198 | - ) { |
|
3199 | - return sprintf( |
|
3200 | - __( |
|
3201 | - 'The maximum number of inputs on this page has been exceeded. You cannot add anymore items (i.e. tickets, datetimes, custom fields) on this page because of your servers PHP "max_input_vars" setting.%1$sThere are %2$d inputs and the maximum amount currently allowed by your server is %3$d.', |
|
3202 | - 'event_espresso' |
|
3203 | - ), |
|
3204 | - '<br>', |
|
3205 | - $input_count, |
|
3206 | - $this->php->max_input_vars |
|
3207 | - ); |
|
3208 | - } else { |
|
3209 | - return ''; |
|
3210 | - } |
|
3211 | - } |
|
3212 | - |
|
3213 | - |
|
3214 | - /** |
|
3215 | - * The purpose of this method is just to force rechecking php values so if they've changed, they get updated. |
|
3216 | - * |
|
3217 | - * @since 4.4.1 |
|
3218 | - * @return void |
|
3219 | - */ |
|
3220 | - public function recheck_values() |
|
3221 | - { |
|
3222 | - $this->_set_php_values(); |
|
3223 | - } |
|
3149 | + /** |
|
3150 | + * Hold any php environment variables that we want to track. |
|
3151 | + * |
|
3152 | + * @var stdClass; |
|
3153 | + */ |
|
3154 | + public $php; |
|
3155 | + |
|
3156 | + |
|
3157 | + /** |
|
3158 | + * constructor |
|
3159 | + */ |
|
3160 | + public function __construct() |
|
3161 | + { |
|
3162 | + $this->php = new stdClass(); |
|
3163 | + $this->_set_php_values(); |
|
3164 | + } |
|
3165 | + |
|
3166 | + |
|
3167 | + /** |
|
3168 | + * This sets the php environment variables. |
|
3169 | + * |
|
3170 | + * @since 4.4.0 |
|
3171 | + * @return void |
|
3172 | + */ |
|
3173 | + protected function _set_php_values() |
|
3174 | + { |
|
3175 | + $this->php->max_input_vars = ini_get('max_input_vars'); |
|
3176 | + $this->php->version = phpversion(); |
|
3177 | + } |
|
3178 | + |
|
3179 | + |
|
3180 | + /** |
|
3181 | + * helper method for determining whether input_count is |
|
3182 | + * reaching the potential maximum the server can handle |
|
3183 | + * according to max_input_vars |
|
3184 | + * |
|
3185 | + * @param int $input_count the count of input vars. |
|
3186 | + * @return array { |
|
3187 | + * An array that represents whether available space and if no available space the error |
|
3188 | + * message. |
|
3189 | + * @type bool $has_space whether more inputs can be added. |
|
3190 | + * @type string $msg Any message to be displayed. |
|
3191 | + * } |
|
3192 | + */ |
|
3193 | + public function max_input_vars_limit_check($input_count = 0) |
|
3194 | + { |
|
3195 | + if (! empty($this->php->max_input_vars) |
|
3196 | + && ($input_count >= $this->php->max_input_vars) |
|
3197 | + && (PHP_MAJOR_VERSION >= 5 && PHP_MINOR_VERSION >= 3 && PHP_RELEASE_VERSION >= 9) |
|
3198 | + ) { |
|
3199 | + return sprintf( |
|
3200 | + __( |
|
3201 | + 'The maximum number of inputs on this page has been exceeded. You cannot add anymore items (i.e. tickets, datetimes, custom fields) on this page because of your servers PHP "max_input_vars" setting.%1$sThere are %2$d inputs and the maximum amount currently allowed by your server is %3$d.', |
|
3202 | + 'event_espresso' |
|
3203 | + ), |
|
3204 | + '<br>', |
|
3205 | + $input_count, |
|
3206 | + $this->php->max_input_vars |
|
3207 | + ); |
|
3208 | + } else { |
|
3209 | + return ''; |
|
3210 | + } |
|
3211 | + } |
|
3212 | + |
|
3213 | + |
|
3214 | + /** |
|
3215 | + * The purpose of this method is just to force rechecking php values so if they've changed, they get updated. |
|
3216 | + * |
|
3217 | + * @since 4.4.1 |
|
3218 | + * @return void |
|
3219 | + */ |
|
3220 | + public function recheck_values() |
|
3221 | + { |
|
3222 | + $this->_set_php_values(); |
|
3223 | + } |
|
3224 | 3224 | } |
3225 | 3225 | |
3226 | 3226 | /** |
@@ -3233,21 +3233,21 @@ discard block |
||
3233 | 3233 | class EE_Tax_Config extends EE_Config_Base |
3234 | 3234 | { |
3235 | 3235 | |
3236 | - /* |
|
3236 | + /* |
|
3237 | 3237 | * flag to indicate whether or not to display ticket prices with the taxes included |
3238 | 3238 | * |
3239 | 3239 | * @var boolean $prices_displayed_including_taxes |
3240 | 3240 | */ |
3241 | - public $prices_displayed_including_taxes; |
|
3241 | + public $prices_displayed_including_taxes; |
|
3242 | 3242 | |
3243 | 3243 | |
3244 | - /** |
|
3245 | - * class constructor |
|
3246 | - */ |
|
3247 | - public function __construct() |
|
3248 | - { |
|
3249 | - $this->prices_displayed_including_taxes = true; |
|
3250 | - } |
|
3244 | + /** |
|
3245 | + * class constructor |
|
3246 | + */ |
|
3247 | + public function __construct() |
|
3248 | + { |
|
3249 | + $this->prices_displayed_including_taxes = true; |
|
3250 | + } |
|
3251 | 3251 | } |
3252 | 3252 | |
3253 | 3253 | /** |
@@ -3261,19 +3261,19 @@ discard block |
||
3261 | 3261 | class EE_Messages_Config extends EE_Config_Base |
3262 | 3262 | { |
3263 | 3263 | |
3264 | - /** |
|
3265 | - * This is an integer representing the deletion threshold in months for when old messages will get deleted. |
|
3266 | - * A value of 0 represents never deleting. Default is 0. |
|
3267 | - * |
|
3268 | - * @var integer |
|
3269 | - */ |
|
3270 | - public $delete_threshold; |
|
3264 | + /** |
|
3265 | + * This is an integer representing the deletion threshold in months for when old messages will get deleted. |
|
3266 | + * A value of 0 represents never deleting. Default is 0. |
|
3267 | + * |
|
3268 | + * @var integer |
|
3269 | + */ |
|
3270 | + public $delete_threshold; |
|
3271 | 3271 | |
3272 | 3272 | |
3273 | - public function __construct() |
|
3274 | - { |
|
3275 | - $this->delete_threshold = 0; |
|
3276 | - } |
|
3273 | + public function __construct() |
|
3274 | + { |
|
3275 | + $this->delete_threshold = 0; |
|
3276 | + } |
|
3277 | 3277 | } |
3278 | 3278 | |
3279 | 3279 | /** |
@@ -3284,31 +3284,31 @@ discard block |
||
3284 | 3284 | class EE_Gateway_Config extends EE_Config_Base |
3285 | 3285 | { |
3286 | 3286 | |
3287 | - /** |
|
3288 | - * Array with keys that are payment gateways slugs, and values are arrays |
|
3289 | - * with any config info the gateway wants to store |
|
3290 | - * |
|
3291 | - * @var array |
|
3292 | - */ |
|
3293 | - public $payment_settings; |
|
3294 | - |
|
3295 | - /** |
|
3296 | - * Where keys are gateway slugs, and values are booleans indicating whether or not |
|
3297 | - * the gateway is stored in the uploads directory |
|
3298 | - * |
|
3299 | - * @var array |
|
3300 | - */ |
|
3301 | - public $active_gateways; |
|
3302 | - |
|
3303 | - |
|
3304 | - /** |
|
3305 | - * class constructor |
|
3306 | - * |
|
3307 | - * @deprecated |
|
3308 | - */ |
|
3309 | - public function __construct() |
|
3310 | - { |
|
3311 | - $this->payment_settings = array(); |
|
3312 | - $this->active_gateways = array('Invoice' => false); |
|
3313 | - } |
|
3287 | + /** |
|
3288 | + * Array with keys that are payment gateways slugs, and values are arrays |
|
3289 | + * with any config info the gateway wants to store |
|
3290 | + * |
|
3291 | + * @var array |
|
3292 | + */ |
|
3293 | + public $payment_settings; |
|
3294 | + |
|
3295 | + /** |
|
3296 | + * Where keys are gateway slugs, and values are booleans indicating whether or not |
|
3297 | + * the gateway is stored in the uploads directory |
|
3298 | + * |
|
3299 | + * @var array |
|
3300 | + */ |
|
3301 | + public $active_gateways; |
|
3302 | + |
|
3303 | + |
|
3304 | + /** |
|
3305 | + * class constructor |
|
3306 | + * |
|
3307 | + * @deprecated |
|
3308 | + */ |
|
3309 | + public function __construct() |
|
3310 | + { |
|
3311 | + $this->payment_settings = array(); |
|
3312 | + $this->active_gateways = array('Invoice' => false); |
|
3313 | + } |
|
3314 | 3314 | } |
@@ -38,103 +38,103 @@ |
||
38 | 38 | * @since 4.0 |
39 | 39 | */ |
40 | 40 | if (function_exists('espresso_version')) { |
41 | - if (! function_exists('espresso_duplicate_plugin_error')) { |
|
42 | - /** |
|
43 | - * espresso_duplicate_plugin_error |
|
44 | - * displays if more than one version of EE is activated at the same time |
|
45 | - */ |
|
46 | - function espresso_duplicate_plugin_error() |
|
47 | - { |
|
48 | - ?> |
|
41 | + if (! function_exists('espresso_duplicate_plugin_error')) { |
|
42 | + /** |
|
43 | + * espresso_duplicate_plugin_error |
|
44 | + * displays if more than one version of EE is activated at the same time |
|
45 | + */ |
|
46 | + function espresso_duplicate_plugin_error() |
|
47 | + { |
|
48 | + ?> |
|
49 | 49 | <div class="error"> |
50 | 50 | <p> |
51 | 51 | <?php |
52 | - echo esc_html__( |
|
53 | - 'Can not run multiple versions of Event Espresso! One version has been automatically deactivated. Please verify that you have the correct version you want still active.', |
|
54 | - 'event_espresso' |
|
55 | - ); ?> |
|
52 | + echo esc_html__( |
|
53 | + 'Can not run multiple versions of Event Espresso! One version has been automatically deactivated. Please verify that you have the correct version you want still active.', |
|
54 | + 'event_espresso' |
|
55 | + ); ?> |
|
56 | 56 | </p> |
57 | 57 | </div> |
58 | 58 | <?php |
59 | - espresso_deactivate_plugin(plugin_basename(__FILE__)); |
|
60 | - } |
|
61 | - } |
|
62 | - add_action('admin_notices', 'espresso_duplicate_plugin_error', 1); |
|
59 | + espresso_deactivate_plugin(plugin_basename(__FILE__)); |
|
60 | + } |
|
61 | + } |
|
62 | + add_action('admin_notices', 'espresso_duplicate_plugin_error', 1); |
|
63 | 63 | } else { |
64 | - define('EE_MIN_PHP_VER_REQUIRED', '5.4.0'); |
|
65 | - if (! version_compare(PHP_VERSION, EE_MIN_PHP_VER_REQUIRED, '>=')) { |
|
66 | - /** |
|
67 | - * espresso_minimum_php_version_error |
|
68 | - * |
|
69 | - * @return void |
|
70 | - */ |
|
71 | - function espresso_minimum_php_version_error() |
|
72 | - { |
|
73 | - ?> |
|
64 | + define('EE_MIN_PHP_VER_REQUIRED', '5.4.0'); |
|
65 | + if (! version_compare(PHP_VERSION, EE_MIN_PHP_VER_REQUIRED, '>=')) { |
|
66 | + /** |
|
67 | + * espresso_minimum_php_version_error |
|
68 | + * |
|
69 | + * @return void |
|
70 | + */ |
|
71 | + function espresso_minimum_php_version_error() |
|
72 | + { |
|
73 | + ?> |
|
74 | 74 | <div class="error"> |
75 | 75 | <p> |
76 | 76 | <?php |
77 | - printf( |
|
78 | - esc_html__( |
|
79 | - 'We\'re sorry, but Event Espresso requires PHP version %1$s or greater in order to operate. You are currently running version %2$s.%3$sIn order to update your version of PHP, you will need to contact your current hosting provider.%3$sFor information on stable PHP versions, please go to %4$s.', |
|
80 | - 'event_espresso' |
|
81 | - ), |
|
82 | - EE_MIN_PHP_VER_REQUIRED, |
|
83 | - PHP_VERSION, |
|
84 | - '<br/>', |
|
85 | - '<a href="http://php.net/downloads.php">http://php.net/downloads.php</a>' |
|
86 | - ); |
|
87 | - ?> |
|
77 | + printf( |
|
78 | + esc_html__( |
|
79 | + 'We\'re sorry, but Event Espresso requires PHP version %1$s or greater in order to operate. You are currently running version %2$s.%3$sIn order to update your version of PHP, you will need to contact your current hosting provider.%3$sFor information on stable PHP versions, please go to %4$s.', |
|
80 | + 'event_espresso' |
|
81 | + ), |
|
82 | + EE_MIN_PHP_VER_REQUIRED, |
|
83 | + PHP_VERSION, |
|
84 | + '<br/>', |
|
85 | + '<a href="http://php.net/downloads.php">http://php.net/downloads.php</a>' |
|
86 | + ); |
|
87 | + ?> |
|
88 | 88 | </p> |
89 | 89 | </div> |
90 | 90 | <?php |
91 | - espresso_deactivate_plugin(plugin_basename(__FILE__)); |
|
92 | - } |
|
91 | + espresso_deactivate_plugin(plugin_basename(__FILE__)); |
|
92 | + } |
|
93 | 93 | |
94 | - add_action('admin_notices', 'espresso_minimum_php_version_error', 1); |
|
95 | - } else { |
|
96 | - define('EVENT_ESPRESSO_MAIN_FILE', __FILE__); |
|
97 | - /** |
|
98 | - * espresso_version |
|
99 | - * Returns the plugin version |
|
100 | - * |
|
101 | - * @return string |
|
102 | - */ |
|
103 | - function espresso_version() |
|
104 | - { |
|
105 | - return apply_filters('FHEE__espresso__espresso_version', '4.9.70.rc.000'); |
|
106 | - } |
|
94 | + add_action('admin_notices', 'espresso_minimum_php_version_error', 1); |
|
95 | + } else { |
|
96 | + define('EVENT_ESPRESSO_MAIN_FILE', __FILE__); |
|
97 | + /** |
|
98 | + * espresso_version |
|
99 | + * Returns the plugin version |
|
100 | + * |
|
101 | + * @return string |
|
102 | + */ |
|
103 | + function espresso_version() |
|
104 | + { |
|
105 | + return apply_filters('FHEE__espresso__espresso_version', '4.9.70.rc.000'); |
|
106 | + } |
|
107 | 107 | |
108 | - /** |
|
109 | - * espresso_plugin_activation |
|
110 | - * adds a wp-option to indicate that EE has been activated via the WP admin plugins page |
|
111 | - */ |
|
112 | - function espresso_plugin_activation() |
|
113 | - { |
|
114 | - update_option('ee_espresso_activation', true); |
|
115 | - } |
|
108 | + /** |
|
109 | + * espresso_plugin_activation |
|
110 | + * adds a wp-option to indicate that EE has been activated via the WP admin plugins page |
|
111 | + */ |
|
112 | + function espresso_plugin_activation() |
|
113 | + { |
|
114 | + update_option('ee_espresso_activation', true); |
|
115 | + } |
|
116 | 116 | |
117 | - register_activation_hook(EVENT_ESPRESSO_MAIN_FILE, 'espresso_plugin_activation'); |
|
117 | + register_activation_hook(EVENT_ESPRESSO_MAIN_FILE, 'espresso_plugin_activation'); |
|
118 | 118 | |
119 | - require_once __DIR__ . '/core/bootstrap_espresso.php'; |
|
120 | - bootstrap_espresso(); |
|
121 | - } |
|
119 | + require_once __DIR__ . '/core/bootstrap_espresso.php'; |
|
120 | + bootstrap_espresso(); |
|
121 | + } |
|
122 | 122 | } |
123 | 123 | if (! function_exists('espresso_deactivate_plugin')) { |
124 | - /** |
|
125 | - * deactivate_plugin |
|
126 | - * usage: espresso_deactivate_plugin( plugin_basename( __FILE__ )); |
|
127 | - * |
|
128 | - * @access public |
|
129 | - * @param string $plugin_basename - the results of plugin_basename( __FILE__ ) for the plugin's main file |
|
130 | - * @return void |
|
131 | - */ |
|
132 | - function espresso_deactivate_plugin($plugin_basename = '') |
|
133 | - { |
|
134 | - if (! function_exists('deactivate_plugins')) { |
|
135 | - require_once ABSPATH . 'wp-admin/includes/plugin.php'; |
|
136 | - } |
|
137 | - unset($_GET['activate'], $_REQUEST['activate']); |
|
138 | - deactivate_plugins($plugin_basename); |
|
139 | - } |
|
124 | + /** |
|
125 | + * deactivate_plugin |
|
126 | + * usage: espresso_deactivate_plugin( plugin_basename( __FILE__ )); |
|
127 | + * |
|
128 | + * @access public |
|
129 | + * @param string $plugin_basename - the results of plugin_basename( __FILE__ ) for the plugin's main file |
|
130 | + * @return void |
|
131 | + */ |
|
132 | + function espresso_deactivate_plugin($plugin_basename = '') |
|
133 | + { |
|
134 | + if (! function_exists('deactivate_plugins')) { |
|
135 | + require_once ABSPATH . 'wp-admin/includes/plugin.php'; |
|
136 | + } |
|
137 | + unset($_GET['activate'], $_REQUEST['activate']); |
|
138 | + deactivate_plugins($plugin_basename); |
|
139 | + } |
|
140 | 140 | } |
@@ -39,31 +39,31 @@ discard block |
||
39 | 39 | * @param string $action_or_filter |
40 | 40 | */ |
41 | 41 | function deprecated_espresso_action_or_filter_doing_it_wrong( |
42 | - $deprecated_filter, |
|
43 | - $replacement, |
|
44 | - $replacement_location, |
|
45 | - $version_deprecated, |
|
46 | - $version_applies, |
|
47 | - $action_or_filter = 'action' |
|
42 | + $deprecated_filter, |
|
43 | + $replacement, |
|
44 | + $replacement_location, |
|
45 | + $version_deprecated, |
|
46 | + $version_applies, |
|
47 | + $action_or_filter = 'action' |
|
48 | 48 | ) { |
49 | - $action_or_filter = $action_or_filter === 'action' |
|
50 | - ? esc_html__('action', 'event_espresso') |
|
51 | - : esc_html__('filter', 'event_espresso'); |
|
52 | - EE_Error::doing_it_wrong( |
|
53 | - $deprecated_filter, |
|
54 | - sprintf( |
|
55 | - __( |
|
56 | - 'This %1$s is deprecated. It *may* work as an attempt to build in backwards compatibility. However, it is recommended to use the following new %1$s: %4$s"%2$s" found in "%3$s"', |
|
57 | - 'event_espresso' |
|
58 | - ), |
|
59 | - $action_or_filter, |
|
60 | - $replacement, |
|
61 | - $replacement_location, |
|
62 | - '<br />' |
|
63 | - ), |
|
64 | - $version_deprecated, |
|
65 | - $version_applies |
|
66 | - ); |
|
49 | + $action_or_filter = $action_or_filter === 'action' |
|
50 | + ? esc_html__('action', 'event_espresso') |
|
51 | + : esc_html__('filter', 'event_espresso'); |
|
52 | + EE_Error::doing_it_wrong( |
|
53 | + $deprecated_filter, |
|
54 | + sprintf( |
|
55 | + __( |
|
56 | + 'This %1$s is deprecated. It *may* work as an attempt to build in backwards compatibility. However, it is recommended to use the following new %1$s: %4$s"%2$s" found in "%3$s"', |
|
57 | + 'event_espresso' |
|
58 | + ), |
|
59 | + $action_or_filter, |
|
60 | + $replacement, |
|
61 | + $replacement_location, |
|
62 | + '<br />' |
|
63 | + ), |
|
64 | + $version_deprecated, |
|
65 | + $version_applies |
|
66 | + ); |
|
67 | 67 | } |
68 | 68 | |
69 | 69 | /** |
@@ -75,90 +75,90 @@ discard block |
||
75 | 75 | */ |
76 | 76 | function ee_deprecated__registration_checkout__button_text($submit_button_text, EE_Checkout $checkout) |
77 | 77 | { |
78 | - // list of old filters |
|
79 | - $deprecated_filters = array( |
|
80 | - 'update_registration_details' => true, |
|
81 | - 'process_payment' => true, |
|
82 | - 'finalize_registration' => true, |
|
83 | - 'and_proceed_to_payment' => true, |
|
84 | - 'proceed_to' => true, |
|
85 | - ); |
|
86 | - // loop thru and call doing_it_wrong() or remove any that aren't being used |
|
87 | - foreach ($deprecated_filters as $deprecated_filter => $on) { |
|
88 | - // was this filter called ? |
|
89 | - if (has_action('FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__' . $deprecated_filter)) { |
|
90 | - // only display doing_it_wrong() notice to Event Admins during non-AJAX requests |
|
91 | - if (EE_Registry::instance()->CAP->current_user_can( |
|
92 | - 'ee_read_ee', |
|
93 | - 'hide_doing_it_wrong_for_deprecated_SPCO_filter' |
|
94 | - ) && ! defined('DOING_AJAX')) { |
|
95 | - EE_Error::doing_it_wrong( |
|
96 | - 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__' . $deprecated_filter, |
|
97 | - sprintf( |
|
98 | - __( |
|
99 | - 'The %1$s filter is deprecated. It *may* work as an attempt to build in backwards compatibility. However, it is recommended to use the following new filter: %2$s"%3$s" found in "%4$s"', |
|
100 | - 'event_espresso' |
|
101 | - ), |
|
102 | - 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__' . $deprecated_filter, |
|
103 | - '<br />', |
|
104 | - 'FHEE__EE_SPCO_Reg_Step__set_submit_button_text___submit_button_text', |
|
105 | - '/modules/single_page_checkout/inc/EE_SPCO_Reg_Step.class.php' |
|
106 | - ), |
|
107 | - '4.6.10' |
|
108 | - ); |
|
109 | - } |
|
110 | - } else { |
|
111 | - unset($deprecated_filters[ $deprecated_filter ]); |
|
112 | - } |
|
113 | - } |
|
114 | - if (! empty($deprecated_filters)) { |
|
115 | - |
|
116 | - if ($checkout->current_step->slug( |
|
117 | - ) == 'attendee_information' && $checkout->revisit && isset($deprecated_filters['update_registration_details'])) { |
|
118 | - $submit_button_text = apply_filters( |
|
119 | - 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__update_registration_details', |
|
120 | - $submit_button_text |
|
121 | - ); |
|
122 | - } elseif ($checkout->current_step->slug( |
|
123 | - ) == 'payment_options' && $checkout->revisit && isset($deprecated_filters['process_payment'])) { |
|
124 | - $submit_button_text = apply_filters( |
|
125 | - 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__process_payment', |
|
126 | - $submit_button_text |
|
127 | - ); |
|
128 | - } elseif ($checkout->next_step instanceof EE_SPCO_Reg_Step && $checkout->next_step->slug( |
|
129 | - ) == 'finalize_registration' && isset($deprecated_filters['finalize_registration'])) { |
|
130 | - $submit_button_text = apply_filters( |
|
131 | - 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__finalize_registration', |
|
132 | - $submit_button_text |
|
133 | - ); |
|
134 | - } |
|
135 | - if ($checkout->next_step instanceof EE_SPCO_Reg_Step) { |
|
136 | - if ($checkout->payment_required() && $checkout->next_step->slug( |
|
137 | - ) == 'payment_options' && isset($deprecated_filters['and_proceed_to_payment'])) { |
|
138 | - $submit_button_text .= apply_filters( |
|
139 | - 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__and_proceed_to_payment', |
|
140 | - $submit_button_text |
|
141 | - ); |
|
142 | - } |
|
143 | - if ($checkout->next_step->slug( |
|
144 | - ) != 'finalize_registration' && ! $checkout->revisit && isset($deprecated_filters['proceed_to'])) { |
|
145 | - $submit_button_text = apply_filters( |
|
146 | - 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__proceed_to', |
|
147 | - $submit_button_text |
|
148 | - ) . $checkout->next_step->name(); |
|
149 | - } |
|
150 | - } |
|
151 | - |
|
152 | - } |
|
153 | - return $submit_button_text; |
|
78 | + // list of old filters |
|
79 | + $deprecated_filters = array( |
|
80 | + 'update_registration_details' => true, |
|
81 | + 'process_payment' => true, |
|
82 | + 'finalize_registration' => true, |
|
83 | + 'and_proceed_to_payment' => true, |
|
84 | + 'proceed_to' => true, |
|
85 | + ); |
|
86 | + // loop thru and call doing_it_wrong() or remove any that aren't being used |
|
87 | + foreach ($deprecated_filters as $deprecated_filter => $on) { |
|
88 | + // was this filter called ? |
|
89 | + if (has_action('FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__' . $deprecated_filter)) { |
|
90 | + // only display doing_it_wrong() notice to Event Admins during non-AJAX requests |
|
91 | + if (EE_Registry::instance()->CAP->current_user_can( |
|
92 | + 'ee_read_ee', |
|
93 | + 'hide_doing_it_wrong_for_deprecated_SPCO_filter' |
|
94 | + ) && ! defined('DOING_AJAX')) { |
|
95 | + EE_Error::doing_it_wrong( |
|
96 | + 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__' . $deprecated_filter, |
|
97 | + sprintf( |
|
98 | + __( |
|
99 | + 'The %1$s filter is deprecated. It *may* work as an attempt to build in backwards compatibility. However, it is recommended to use the following new filter: %2$s"%3$s" found in "%4$s"', |
|
100 | + 'event_espresso' |
|
101 | + ), |
|
102 | + 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__' . $deprecated_filter, |
|
103 | + '<br />', |
|
104 | + 'FHEE__EE_SPCO_Reg_Step__set_submit_button_text___submit_button_text', |
|
105 | + '/modules/single_page_checkout/inc/EE_SPCO_Reg_Step.class.php' |
|
106 | + ), |
|
107 | + '4.6.10' |
|
108 | + ); |
|
109 | + } |
|
110 | + } else { |
|
111 | + unset($deprecated_filters[ $deprecated_filter ]); |
|
112 | + } |
|
113 | + } |
|
114 | + if (! empty($deprecated_filters)) { |
|
115 | + |
|
116 | + if ($checkout->current_step->slug( |
|
117 | + ) == 'attendee_information' && $checkout->revisit && isset($deprecated_filters['update_registration_details'])) { |
|
118 | + $submit_button_text = apply_filters( |
|
119 | + 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__update_registration_details', |
|
120 | + $submit_button_text |
|
121 | + ); |
|
122 | + } elseif ($checkout->current_step->slug( |
|
123 | + ) == 'payment_options' && $checkout->revisit && isset($deprecated_filters['process_payment'])) { |
|
124 | + $submit_button_text = apply_filters( |
|
125 | + 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__process_payment', |
|
126 | + $submit_button_text |
|
127 | + ); |
|
128 | + } elseif ($checkout->next_step instanceof EE_SPCO_Reg_Step && $checkout->next_step->slug( |
|
129 | + ) == 'finalize_registration' && isset($deprecated_filters['finalize_registration'])) { |
|
130 | + $submit_button_text = apply_filters( |
|
131 | + 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__finalize_registration', |
|
132 | + $submit_button_text |
|
133 | + ); |
|
134 | + } |
|
135 | + if ($checkout->next_step instanceof EE_SPCO_Reg_Step) { |
|
136 | + if ($checkout->payment_required() && $checkout->next_step->slug( |
|
137 | + ) == 'payment_options' && isset($deprecated_filters['and_proceed_to_payment'])) { |
|
138 | + $submit_button_text .= apply_filters( |
|
139 | + 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__and_proceed_to_payment', |
|
140 | + $submit_button_text |
|
141 | + ); |
|
142 | + } |
|
143 | + if ($checkout->next_step->slug( |
|
144 | + ) != 'finalize_registration' && ! $checkout->revisit && isset($deprecated_filters['proceed_to'])) { |
|
145 | + $submit_button_text = apply_filters( |
|
146 | + 'FHEE__EED_Single_Page_Checkout__registration_checkout__button_text__proceed_to', |
|
147 | + $submit_button_text |
|
148 | + ) . $checkout->next_step->name(); |
|
149 | + } |
|
150 | + } |
|
151 | + |
|
152 | + } |
|
153 | + return $submit_button_text; |
|
154 | 154 | |
155 | 155 | } |
156 | 156 | |
157 | 157 | add_filter( |
158 | - 'FHEE__EE_SPCO_Reg_Step__set_submit_button_text___submit_button_text', |
|
159 | - 'ee_deprecated__registration_checkout__button_text', |
|
160 | - 10, |
|
161 | - 2 |
|
158 | + 'FHEE__EE_SPCO_Reg_Step__set_submit_button_text___submit_button_text', |
|
159 | + 'ee_deprecated__registration_checkout__button_text', |
|
160 | + 10, |
|
161 | + 2 |
|
162 | 162 | ); |
163 | 163 | |
164 | 164 | |
@@ -170,54 +170,54 @@ discard block |
||
170 | 170 | */ |
171 | 171 | function ee_deprecated_finalize_transaction(EE_Checkout $checkout, $status_updates) |
172 | 172 | { |
173 | - $action_ref = null; |
|
174 | - $action_ref = has_action('AHEE__EE_Transaction__finalize__new_transaction') |
|
175 | - ? 'AHEE__EE_Transaction__finalize__new_transaction' : $action_ref; |
|
176 | - $action_ref = has_action('AHEE__EE_Transaction__finalize__all_transaction') |
|
177 | - ? 'AHEE__EE_Transaction__finalize__all_transaction' : $action_ref; |
|
178 | - if ($action_ref) { |
|
179 | - |
|
180 | - EE_Error::doing_it_wrong( |
|
181 | - $action_ref, |
|
182 | - sprintf( |
|
183 | - __( |
|
184 | - 'This action is deprecated. It *may* work as an attempt to build in backwards compatibility. However, it is recommended to use one of the following new actions: %1$s"%3$s" found in "%2$s" %1$s"%4$s" found in "%2$s" %1$s"%5$s" found in "%2$s" %1$s"%6$s" found in "%2$s"', |
|
185 | - 'event_espresso' |
|
186 | - ), |
|
187 | - '<br />', |
|
188 | - '/core/business/EE_Transaction_Processor.class.php', |
|
189 | - 'AHEE__EE_Transaction_Processor__finalize', |
|
190 | - 'AHEE__EE_Transaction_Processor__manually_update_registration_statuses', |
|
191 | - 'AHEE__EE_Transaction_Processor__toggle_registration_statuses_for_default_approved_events', |
|
192 | - 'AHEE__EE_Transaction_Processor__toggle_registration_statuses_if_no_monies_owing' |
|
193 | - ), |
|
194 | - '4.6.0' |
|
195 | - ); |
|
196 | - switch ($action_ref) { |
|
197 | - case 'AHEE__EE_Transaction__finalize__new_transaction' : |
|
198 | - do_action( |
|
199 | - 'AHEE__EE_Transaction__finalize__new_transaction', |
|
200 | - $checkout->transaction, |
|
201 | - $checkout->admin_request |
|
202 | - ); |
|
203 | - break; |
|
204 | - case 'AHEE__EE_Transaction__finalize__all_transaction' : |
|
205 | - do_action( |
|
206 | - 'AHEE__EE_Transaction__finalize__new_transaction', |
|
207 | - $checkout->transaction, |
|
208 | - array('new_reg' => ! $checkout->revisit, 'to_approved' => $status_updates), |
|
209 | - $checkout->admin_request |
|
210 | - ); |
|
211 | - break; |
|
212 | - } |
|
213 | - } |
|
173 | + $action_ref = null; |
|
174 | + $action_ref = has_action('AHEE__EE_Transaction__finalize__new_transaction') |
|
175 | + ? 'AHEE__EE_Transaction__finalize__new_transaction' : $action_ref; |
|
176 | + $action_ref = has_action('AHEE__EE_Transaction__finalize__all_transaction') |
|
177 | + ? 'AHEE__EE_Transaction__finalize__all_transaction' : $action_ref; |
|
178 | + if ($action_ref) { |
|
179 | + |
|
180 | + EE_Error::doing_it_wrong( |
|
181 | + $action_ref, |
|
182 | + sprintf( |
|
183 | + __( |
|
184 | + 'This action is deprecated. It *may* work as an attempt to build in backwards compatibility. However, it is recommended to use one of the following new actions: %1$s"%3$s" found in "%2$s" %1$s"%4$s" found in "%2$s" %1$s"%5$s" found in "%2$s" %1$s"%6$s" found in "%2$s"', |
|
185 | + 'event_espresso' |
|
186 | + ), |
|
187 | + '<br />', |
|
188 | + '/core/business/EE_Transaction_Processor.class.php', |
|
189 | + 'AHEE__EE_Transaction_Processor__finalize', |
|
190 | + 'AHEE__EE_Transaction_Processor__manually_update_registration_statuses', |
|
191 | + 'AHEE__EE_Transaction_Processor__toggle_registration_statuses_for_default_approved_events', |
|
192 | + 'AHEE__EE_Transaction_Processor__toggle_registration_statuses_if_no_monies_owing' |
|
193 | + ), |
|
194 | + '4.6.0' |
|
195 | + ); |
|
196 | + switch ($action_ref) { |
|
197 | + case 'AHEE__EE_Transaction__finalize__new_transaction' : |
|
198 | + do_action( |
|
199 | + 'AHEE__EE_Transaction__finalize__new_transaction', |
|
200 | + $checkout->transaction, |
|
201 | + $checkout->admin_request |
|
202 | + ); |
|
203 | + break; |
|
204 | + case 'AHEE__EE_Transaction__finalize__all_transaction' : |
|
205 | + do_action( |
|
206 | + 'AHEE__EE_Transaction__finalize__new_transaction', |
|
207 | + $checkout->transaction, |
|
208 | + array('new_reg' => ! $checkout->revisit, 'to_approved' => $status_updates), |
|
209 | + $checkout->admin_request |
|
210 | + ); |
|
211 | + break; |
|
212 | + } |
|
213 | + } |
|
214 | 214 | } |
215 | 215 | |
216 | 216 | add_action( |
217 | - 'AHEE__EE_SPCO_Reg_Step_Finalize_Registration__process_reg_step__completed', |
|
218 | - 'ee_deprecated_finalize_transaction', |
|
219 | - 10, |
|
220 | - 2 |
|
217 | + 'AHEE__EE_SPCO_Reg_Step_Finalize_Registration__process_reg_step__completed', |
|
218 | + 'ee_deprecated_finalize_transaction', |
|
219 | + 10, |
|
220 | + 2 |
|
221 | 221 | ); |
222 | 222 | /** |
223 | 223 | * ee_deprecated_finalize_registration |
@@ -226,35 +226,35 @@ discard block |
||
226 | 226 | */ |
227 | 227 | function ee_deprecated_finalize_registration(EE_Registration $registration) |
228 | 228 | { |
229 | - $action_ref = has_action('AHEE__EE_Registration__finalize__update_and_new_reg') |
|
230 | - ? 'AHEE__EE_Registration__finalize__update_and_new_reg' : null; |
|
231 | - if ($action_ref) { |
|
232 | - EE_Error::doing_it_wrong( |
|
233 | - $action_ref, |
|
234 | - sprintf( |
|
235 | - __( |
|
236 | - 'This action is deprecated. It *may* work as an attempt to build in backwards compatibility. However, it is recommended to use the following new action: %1$s"%3$s" found in "%2$s"', |
|
237 | - 'event_espresso' |
|
238 | - ), |
|
239 | - '<br />', |
|
240 | - '/core/business/EE_Registration_Processor.class.php', |
|
241 | - 'AHEE__EE_Registration_Processor__trigger_registration_update_notifications' |
|
242 | - ), |
|
243 | - '4.6.0' |
|
244 | - ); |
|
245 | - do_action( |
|
246 | - 'AHEE__EE_Registration__finalize__update_and_new_reg', |
|
247 | - $registration, |
|
248 | - (is_admin() && ! (defined('DOING_AJAX') && DOING_AJAX)) |
|
249 | - ); |
|
250 | - } |
|
229 | + $action_ref = has_action('AHEE__EE_Registration__finalize__update_and_new_reg') |
|
230 | + ? 'AHEE__EE_Registration__finalize__update_and_new_reg' : null; |
|
231 | + if ($action_ref) { |
|
232 | + EE_Error::doing_it_wrong( |
|
233 | + $action_ref, |
|
234 | + sprintf( |
|
235 | + __( |
|
236 | + 'This action is deprecated. It *may* work as an attempt to build in backwards compatibility. However, it is recommended to use the following new action: %1$s"%3$s" found in "%2$s"', |
|
237 | + 'event_espresso' |
|
238 | + ), |
|
239 | + '<br />', |
|
240 | + '/core/business/EE_Registration_Processor.class.php', |
|
241 | + 'AHEE__EE_Registration_Processor__trigger_registration_update_notifications' |
|
242 | + ), |
|
243 | + '4.6.0' |
|
244 | + ); |
|
245 | + do_action( |
|
246 | + 'AHEE__EE_Registration__finalize__update_and_new_reg', |
|
247 | + $registration, |
|
248 | + (is_admin() && ! (defined('DOING_AJAX') && DOING_AJAX)) |
|
249 | + ); |
|
250 | + } |
|
251 | 251 | } |
252 | 252 | |
253 | 253 | add_action( |
254 | - 'AHEE__EE_Registration_Processor__trigger_registration_update_notifications', |
|
255 | - 'ee_deprecated_finalize_registration', |
|
256 | - 10, |
|
257 | - 1 |
|
254 | + 'AHEE__EE_Registration_Processor__trigger_registration_update_notifications', |
|
255 | + 'ee_deprecated_finalize_registration', |
|
256 | + 10, |
|
257 | + 1 |
|
258 | 258 | ); |
259 | 259 | |
260 | 260 | |
@@ -264,44 +264,44 @@ discard block |
||
264 | 264 | */ |
265 | 265 | function ee_deprecated_hooks() |
266 | 266 | { |
267 | - /** |
|
268 | - * @var $hooks array where keys are hook names, and their values are array{ |
|
269 | - * @type string $version when deprecated |
|
270 | - * @type string $alternative saying what to use instead |
|
271 | - * @type boolean $still_works whether or not the hook still works |
|
272 | - * } |
|
273 | - */ |
|
274 | - $hooks = array( |
|
275 | - 'AHEE__EE_System___do_setup_validations' => array( |
|
276 | - 'version' => '4.6.0', |
|
277 | - 'alternative' => __( |
|
278 | - 'Instead use "AHEE__EEH_Activation__validate_messages_system" which is called after validating messages (done on every new install, upgrade, reactivation, and downgrade)', |
|
279 | - 'event_espresso' |
|
280 | - ), |
|
281 | - 'still_works' => false, |
|
282 | - ), |
|
283 | - ); |
|
284 | - foreach ($hooks as $name => $deprecation_info) { |
|
285 | - if (has_action($name)) { |
|
286 | - EE_Error::doing_it_wrong( |
|
287 | - $name, |
|
288 | - sprintf( |
|
289 | - __('This filter is deprecated. %1$s%2$s', 'event_espresso'), |
|
290 | - $deprecation_info['still_works'] ? __( |
|
291 | - 'It *may* work as an attempt to build in backwards compatibility.', |
|
292 | - 'event_espresso' |
|
293 | - ) : __('It has been completely removed.', 'event_espresso'), |
|
294 | - isset($deprecation_info['alternative']) |
|
295 | - ? $deprecation_info['alternative'] |
|
296 | - : __( |
|
297 | - 'Please read the current EE4 documentation further or contact Support.', |
|
298 | - 'event_espresso' |
|
299 | - ) |
|
300 | - ), |
|
301 | - isset($deprecation_info['version']) ? $deprecation_info['version'] : __('recently', 'event_espresso') |
|
302 | - ); |
|
303 | - } |
|
304 | - } |
|
267 | + /** |
|
268 | + * @var $hooks array where keys are hook names, and their values are array{ |
|
269 | + * @type string $version when deprecated |
|
270 | + * @type string $alternative saying what to use instead |
|
271 | + * @type boolean $still_works whether or not the hook still works |
|
272 | + * } |
|
273 | + */ |
|
274 | + $hooks = array( |
|
275 | + 'AHEE__EE_System___do_setup_validations' => array( |
|
276 | + 'version' => '4.6.0', |
|
277 | + 'alternative' => __( |
|
278 | + 'Instead use "AHEE__EEH_Activation__validate_messages_system" which is called after validating messages (done on every new install, upgrade, reactivation, and downgrade)', |
|
279 | + 'event_espresso' |
|
280 | + ), |
|
281 | + 'still_works' => false, |
|
282 | + ), |
|
283 | + ); |
|
284 | + foreach ($hooks as $name => $deprecation_info) { |
|
285 | + if (has_action($name)) { |
|
286 | + EE_Error::doing_it_wrong( |
|
287 | + $name, |
|
288 | + sprintf( |
|
289 | + __('This filter is deprecated. %1$s%2$s', 'event_espresso'), |
|
290 | + $deprecation_info['still_works'] ? __( |
|
291 | + 'It *may* work as an attempt to build in backwards compatibility.', |
|
292 | + 'event_espresso' |
|
293 | + ) : __('It has been completely removed.', 'event_espresso'), |
|
294 | + isset($deprecation_info['alternative']) |
|
295 | + ? $deprecation_info['alternative'] |
|
296 | + : __( |
|
297 | + 'Please read the current EE4 documentation further or contact Support.', |
|
298 | + 'event_espresso' |
|
299 | + ) |
|
300 | + ), |
|
301 | + isset($deprecation_info['version']) ? $deprecation_info['version'] : __('recently', 'event_espresso') |
|
302 | + ); |
|
303 | + } |
|
304 | + } |
|
305 | 305 | } |
306 | 306 | |
307 | 307 | add_action('AHEE__EE_System__set_hooks_for_shortcodes_modules_and_addons', 'ee_deprecated_hooks'); |
@@ -316,34 +316,34 @@ discard block |
||
316 | 316 | */ |
317 | 317 | function ee_deprecated_using_old_registration_admin_custom_questions_form_hooks() |
318 | 318 | { |
319 | - $in_use = has_filter('FHEE__Registrations_Admin_Page___update_attendee_registration_form__qstns') |
|
320 | - || has_action( |
|
321 | - 'AHEE__Registrations_Admin_Page___save_attendee_registration_form__after_reg_and_attendee_save' |
|
322 | - ); |
|
323 | - if ($in_use) { |
|
324 | - $msg = __( |
|
325 | - 'We detected you are using the filter FHEE__Registrations_Admin_Page___update_attendee_registration_form__qstns or AHEE__Registrations_Admin_Page___save_attendee_registration_form__after_reg_and_attendee_save.' |
|
326 | - . 'Both of these have been deprecated and should not be used anymore. You should instead use FHEE__EE_Form_Section_Proper___construct__options_array to customize the contents of the form,' |
|
327 | - . 'use FHEE__EE_Form_Section_Proper__receive_form_submission__req_data to customize the submission data, or AHEE__EE_Form_Section_Proper__receive_form_submission__end ' |
|
328 | - . 'to add other actions after a form submission has been received.', |
|
329 | - 'event_espresso' |
|
330 | - ); |
|
331 | - EE_Error::doing_it_wrong( |
|
332 | - __CLASS__ . '::' . __FUNCTION__, |
|
333 | - $msg, |
|
334 | - '4.8.32.rc.000' |
|
335 | - ); |
|
336 | - // it seems the doing_it_wrong messages get output during some hidden html tags, so add an error to make sure this gets noticed |
|
337 | - if (is_admin() && ! defined('DOING_AJAX')) { |
|
338 | - EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__); |
|
339 | - } |
|
340 | - } |
|
341 | - return $in_use; |
|
319 | + $in_use = has_filter('FHEE__Registrations_Admin_Page___update_attendee_registration_form__qstns') |
|
320 | + || has_action( |
|
321 | + 'AHEE__Registrations_Admin_Page___save_attendee_registration_form__after_reg_and_attendee_save' |
|
322 | + ); |
|
323 | + if ($in_use) { |
|
324 | + $msg = __( |
|
325 | + 'We detected you are using the filter FHEE__Registrations_Admin_Page___update_attendee_registration_form__qstns or AHEE__Registrations_Admin_Page___save_attendee_registration_form__after_reg_and_attendee_save.' |
|
326 | + . 'Both of these have been deprecated and should not be used anymore. You should instead use FHEE__EE_Form_Section_Proper___construct__options_array to customize the contents of the form,' |
|
327 | + . 'use FHEE__EE_Form_Section_Proper__receive_form_submission__req_data to customize the submission data, or AHEE__EE_Form_Section_Proper__receive_form_submission__end ' |
|
328 | + . 'to add other actions after a form submission has been received.', |
|
329 | + 'event_espresso' |
|
330 | + ); |
|
331 | + EE_Error::doing_it_wrong( |
|
332 | + __CLASS__ . '::' . __FUNCTION__, |
|
333 | + $msg, |
|
334 | + '4.8.32.rc.000' |
|
335 | + ); |
|
336 | + // it seems the doing_it_wrong messages get output during some hidden html tags, so add an error to make sure this gets noticed |
|
337 | + if (is_admin() && ! defined('DOING_AJAX')) { |
|
338 | + EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__); |
|
339 | + } |
|
340 | + } |
|
341 | + return $in_use; |
|
342 | 342 | } |
343 | 343 | |
344 | 344 | add_action( |
345 | - 'AHEE__Registrations_Admin_Page___registration_details_metabox__start', |
|
346 | - 'ee_deprecated_using_old_registration_admin_custom_questions_form_hooks' |
|
345 | + 'AHEE__Registrations_Admin_Page___registration_details_metabox__start', |
|
346 | + 'ee_deprecated_using_old_registration_admin_custom_questions_form_hooks' |
|
347 | 347 | ); |
348 | 348 | |
349 | 349 | /** |
@@ -355,77 +355,77 @@ discard block |
||
355 | 355 | */ |
356 | 356 | function ee_deprecated_update_attendee_registration_form_old($admin_page) |
357 | 357 | { |
358 | - // check if the old hooks are in use. If not, do the default |
|
359 | - if (! ee_deprecated_using_old_registration_admin_custom_questions_form_hooks() |
|
360 | - || ! $admin_page instanceof EE_Admin_Page) { |
|
361 | - return; |
|
362 | - } |
|
363 | - $req_data = $admin_page->get_request_data(); |
|
364 | - $qstns = isset($req_data['qstn']) ? $req_data['qstn'] : false; |
|
365 | - $REG_ID = isset($req_data['_REG_ID']) ? absint($req_data['_REG_ID']) : false; |
|
366 | - $qstns = apply_filters('FHEE__Registrations_Admin_Page___update_attendee_registration_form__qstns', $qstns); |
|
367 | - if (! $REG_ID || ! $qstns) { |
|
368 | - EE_Error::add_error( |
|
369 | - __('An error occurred. No registration ID and/or registration questions were received.', 'event_espresso'), |
|
370 | - __FILE__, |
|
371 | - __FUNCTION__, |
|
372 | - __LINE__ |
|
373 | - ); |
|
374 | - } |
|
375 | - $success = true; |
|
376 | - |
|
377 | - // allow others to get in on this awesome fun :D |
|
378 | - do_action( |
|
379 | - 'AHEE__Registrations_Admin_Page___save_attendee_registration_form__after_reg_and_attendee_save', |
|
380 | - $REG_ID, |
|
381 | - $qstns |
|
382 | - ); |
|
383 | - // loop thru questions... FINALLY!!! |
|
384 | - |
|
385 | - foreach ($qstns as $QST_ID => $qstn) { |
|
386 | - // if $qstn isn't an array then it doesn't already have an answer, so let's create the answer |
|
387 | - if (! is_array($qstn)) { |
|
388 | - $success = $this->_save_new_answer($REG_ID, $QST_ID, $qstn); |
|
389 | - continue; |
|
390 | - } |
|
391 | - |
|
392 | - |
|
393 | - foreach ($qstn as $ANS_ID => $ANS_value) { |
|
394 | - // get answer |
|
395 | - $query_params = array( |
|
396 | - 0 => array( |
|
397 | - 'ANS_ID' => $ANS_ID, |
|
398 | - 'REG_ID' => $REG_ID, |
|
399 | - 'QST_ID' => $QST_ID, |
|
400 | - ), |
|
401 | - ); |
|
402 | - $answer = EEM_Answer::instance()->get_one($query_params); |
|
403 | - // this MAY be an array but NOT have an answer because its multi select. If so then we need to create the answer |
|
404 | - if (! $answer instanceof EE_Answer) { |
|
405 | - $set_values = array( |
|
406 | - 'QST_ID' => $QST_ID, |
|
407 | - 'REG_ID' => $REG_ID, |
|
408 | - 'ANS_value' => $qstn, |
|
409 | - ); |
|
410 | - $success = EEM_Answer::instance()->insert($set_values); |
|
411 | - continue 2; |
|
412 | - } |
|
413 | - |
|
414 | - $answer->set('ANS_value', $ANS_value); |
|
415 | - $success = $answer->save(); |
|
416 | - } |
|
417 | - } |
|
418 | - $what = __('Registration Form', 'event_espresso'); |
|
419 | - $route = $REG_ID ? array('action' => 'view_registration', '_REG_ID' => $REG_ID) : array('action' => 'default'); |
|
420 | - $admin_page->redirect_after_action($success, $what, __('updated', 'event_espresso'), $route); |
|
421 | - exit; |
|
358 | + // check if the old hooks are in use. If not, do the default |
|
359 | + if (! ee_deprecated_using_old_registration_admin_custom_questions_form_hooks() |
|
360 | + || ! $admin_page instanceof EE_Admin_Page) { |
|
361 | + return; |
|
362 | + } |
|
363 | + $req_data = $admin_page->get_request_data(); |
|
364 | + $qstns = isset($req_data['qstn']) ? $req_data['qstn'] : false; |
|
365 | + $REG_ID = isset($req_data['_REG_ID']) ? absint($req_data['_REG_ID']) : false; |
|
366 | + $qstns = apply_filters('FHEE__Registrations_Admin_Page___update_attendee_registration_form__qstns', $qstns); |
|
367 | + if (! $REG_ID || ! $qstns) { |
|
368 | + EE_Error::add_error( |
|
369 | + __('An error occurred. No registration ID and/or registration questions were received.', 'event_espresso'), |
|
370 | + __FILE__, |
|
371 | + __FUNCTION__, |
|
372 | + __LINE__ |
|
373 | + ); |
|
374 | + } |
|
375 | + $success = true; |
|
376 | + |
|
377 | + // allow others to get in on this awesome fun :D |
|
378 | + do_action( |
|
379 | + 'AHEE__Registrations_Admin_Page___save_attendee_registration_form__after_reg_and_attendee_save', |
|
380 | + $REG_ID, |
|
381 | + $qstns |
|
382 | + ); |
|
383 | + // loop thru questions... FINALLY!!! |
|
384 | + |
|
385 | + foreach ($qstns as $QST_ID => $qstn) { |
|
386 | + // if $qstn isn't an array then it doesn't already have an answer, so let's create the answer |
|
387 | + if (! is_array($qstn)) { |
|
388 | + $success = $this->_save_new_answer($REG_ID, $QST_ID, $qstn); |
|
389 | + continue; |
|
390 | + } |
|
391 | + |
|
392 | + |
|
393 | + foreach ($qstn as $ANS_ID => $ANS_value) { |
|
394 | + // get answer |
|
395 | + $query_params = array( |
|
396 | + 0 => array( |
|
397 | + 'ANS_ID' => $ANS_ID, |
|
398 | + 'REG_ID' => $REG_ID, |
|
399 | + 'QST_ID' => $QST_ID, |
|
400 | + ), |
|
401 | + ); |
|
402 | + $answer = EEM_Answer::instance()->get_one($query_params); |
|
403 | + // this MAY be an array but NOT have an answer because its multi select. If so then we need to create the answer |
|
404 | + if (! $answer instanceof EE_Answer) { |
|
405 | + $set_values = array( |
|
406 | + 'QST_ID' => $QST_ID, |
|
407 | + 'REG_ID' => $REG_ID, |
|
408 | + 'ANS_value' => $qstn, |
|
409 | + ); |
|
410 | + $success = EEM_Answer::instance()->insert($set_values); |
|
411 | + continue 2; |
|
412 | + } |
|
413 | + |
|
414 | + $answer->set('ANS_value', $ANS_value); |
|
415 | + $success = $answer->save(); |
|
416 | + } |
|
417 | + } |
|
418 | + $what = __('Registration Form', 'event_espresso'); |
|
419 | + $route = $REG_ID ? array('action' => 'view_registration', '_REG_ID' => $REG_ID) : array('action' => 'default'); |
|
420 | + $admin_page->redirect_after_action($success, $what, __('updated', 'event_espresso'), $route); |
|
421 | + exit; |
|
422 | 422 | } |
423 | 423 | |
424 | 424 | add_action( |
425 | - 'AHEE__Registrations_Admin_Page___update_attendee_registration_form__start', |
|
426 | - 'ee_deprecated_update_attendee_registration_form_old', |
|
427 | - 10, |
|
428 | - 1 |
|
425 | + 'AHEE__Registrations_Admin_Page___update_attendee_registration_form__start', |
|
426 | + 'ee_deprecated_update_attendee_registration_form_old', |
|
427 | + 10, |
|
428 | + 1 |
|
429 | 429 | ); |
430 | 430 | /** |
431 | 431 | * Render the registration admin page's custom questions area in the old fashion |
@@ -441,50 +441,50 @@ discard block |
||
441 | 441 | */ |
442 | 442 | function ee_deprecated_reg_questions_meta_box_old($do_default_action, $admin_page, $registration) |
443 | 443 | { |
444 | - // check if the old hooks are in use. If not, do the default |
|
445 | - if (! ee_deprecated_using_old_registration_admin_custom_questions_form_hooks() |
|
446 | - || ! $admin_page instanceof EE_Admin_Page) { |
|
447 | - return $do_default_action; |
|
448 | - } |
|
449 | - add_filter( |
|
450 | - 'FHEE__EEH_Form_Fields__generate_question_groups_html__before_question_group_questions', |
|
451 | - array($admin_page, 'form_before_question_group'), |
|
452 | - 10, |
|
453 | - 1 |
|
454 | - ); |
|
455 | - add_filter( |
|
456 | - 'FHEE__EEH_Form_Fields__generate_question_groups_html__after_question_group_questions', |
|
457 | - array($admin_page, 'form_after_question_group'), |
|
458 | - 10, |
|
459 | - 1 |
|
460 | - ); |
|
461 | - add_filter('FHEE__EEH_Form_Fields__label_html', array($admin_page, 'form_form_field_label_wrap'), 10, 1); |
|
462 | - add_filter('FHEE__EEH_Form_Fields__input_html', array($admin_page, 'form_form_field_input__wrap'), 10, 1); |
|
463 | - |
|
464 | - $question_groups = EEM_Event::instance()->assemble_array_of_groups_questions_and_options( |
|
465 | - $registration, |
|
466 | - $registration->get( |
|
467 | - 'EVT_ID' |
|
468 | - ) |
|
469 | - ); |
|
470 | - |
|
471 | - EE_Registry::instance()->load_helper('Form_Fields'); |
|
472 | - $template_args = array( |
|
473 | - 'att_questions' => EEH_Form_Fields::generate_question_groups_html($question_groups), |
|
474 | - 'reg_questions_form_action' => 'edit_registration', |
|
475 | - 'REG_ID' => $registration->ID(), |
|
476 | - ); |
|
477 | - $template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_questions.template.php'; |
|
478 | - echo EEH_Template::display_template($template_path, $template_args, true); |
|
479 | - // indicate that we should not do the default admin page code |
|
480 | - return false; |
|
444 | + // check if the old hooks are in use. If not, do the default |
|
445 | + if (! ee_deprecated_using_old_registration_admin_custom_questions_form_hooks() |
|
446 | + || ! $admin_page instanceof EE_Admin_Page) { |
|
447 | + return $do_default_action; |
|
448 | + } |
|
449 | + add_filter( |
|
450 | + 'FHEE__EEH_Form_Fields__generate_question_groups_html__before_question_group_questions', |
|
451 | + array($admin_page, 'form_before_question_group'), |
|
452 | + 10, |
|
453 | + 1 |
|
454 | + ); |
|
455 | + add_filter( |
|
456 | + 'FHEE__EEH_Form_Fields__generate_question_groups_html__after_question_group_questions', |
|
457 | + array($admin_page, 'form_after_question_group'), |
|
458 | + 10, |
|
459 | + 1 |
|
460 | + ); |
|
461 | + add_filter('FHEE__EEH_Form_Fields__label_html', array($admin_page, 'form_form_field_label_wrap'), 10, 1); |
|
462 | + add_filter('FHEE__EEH_Form_Fields__input_html', array($admin_page, 'form_form_field_input__wrap'), 10, 1); |
|
463 | + |
|
464 | + $question_groups = EEM_Event::instance()->assemble_array_of_groups_questions_and_options( |
|
465 | + $registration, |
|
466 | + $registration->get( |
|
467 | + 'EVT_ID' |
|
468 | + ) |
|
469 | + ); |
|
470 | + |
|
471 | + EE_Registry::instance()->load_helper('Form_Fields'); |
|
472 | + $template_args = array( |
|
473 | + 'att_questions' => EEH_Form_Fields::generate_question_groups_html($question_groups), |
|
474 | + 'reg_questions_form_action' => 'edit_registration', |
|
475 | + 'REG_ID' => $registration->ID(), |
|
476 | + ); |
|
477 | + $template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_questions.template.php'; |
|
478 | + echo EEH_Template::display_template($template_path, $template_args, true); |
|
479 | + // indicate that we should not do the default admin page code |
|
480 | + return false; |
|
481 | 481 | } |
482 | 482 | |
483 | 483 | add_action( |
484 | - 'FHEE__Registrations_Admin_Page___reg_questions_meta_box__do_default', |
|
485 | - 'ee_deprecated_reg_questions_meta_box_old', |
|
486 | - 10, |
|
487 | - 3 |
|
484 | + 'FHEE__Registrations_Admin_Page___reg_questions_meta_box__do_default', |
|
485 | + 'ee_deprecated_reg_questions_meta_box_old', |
|
486 | + 10, |
|
487 | + 3 |
|
488 | 488 | ); |
489 | 489 | |
490 | 490 | |
@@ -501,42 +501,42 @@ discard block |
||
501 | 501 | class EE_Message_Template_Defaults extends EE_Base |
502 | 502 | { |
503 | 503 | |
504 | - /** |
|
505 | - * EE_Message_Template_Defaults constructor. |
|
506 | - * |
|
507 | - * @param EE_messages $messages |
|
508 | - * @param $messenger_name |
|
509 | - * @param $message_type_name |
|
510 | - * @param int $GRP_ID |
|
511 | - * @return EE_Messages_Template_Defaults |
|
512 | - */ |
|
513 | - public function __construct( |
|
514 | - EE_messages $messages, |
|
515 | - $messenger_name, |
|
516 | - $message_type_name, |
|
517 | - $GRP_ID = 0 |
|
518 | - ) { |
|
519 | - EE_Error::doing_it_wrong( |
|
520 | - __FUNCTION__, |
|
521 | - __( |
|
522 | - 'The class EE_Message_Template_Defaults has been deprecated and replaced by EE_Messages_Template_Defaults.', |
|
523 | - 'event_espresso' |
|
524 | - ), |
|
525 | - '4.9.0' |
|
526 | - ); |
|
527 | - /** @var EE_Message_Resource_Manager $message_resource_manager */ |
|
528 | - $message_resource_manager = EE_Registry::instance()->load_lib('Message_Resource_Manager'); |
|
529 | - $messenger = $message_resource_manager->get_messenger($messenger_name); |
|
530 | - $message_type = $message_resource_manager->get_message_type($message_type_name); |
|
531 | - return EE_Registry::instance()->load_lib( |
|
532 | - 'Messages_Template_Defaults', |
|
533 | - array( |
|
534 | - $GRP_ID, |
|
535 | - $messenger, |
|
536 | - $message_type, |
|
537 | - ) |
|
538 | - ); |
|
539 | - } |
|
504 | + /** |
|
505 | + * EE_Message_Template_Defaults constructor. |
|
506 | + * |
|
507 | + * @param EE_messages $messages |
|
508 | + * @param $messenger_name |
|
509 | + * @param $message_type_name |
|
510 | + * @param int $GRP_ID |
|
511 | + * @return EE_Messages_Template_Defaults |
|
512 | + */ |
|
513 | + public function __construct( |
|
514 | + EE_messages $messages, |
|
515 | + $messenger_name, |
|
516 | + $message_type_name, |
|
517 | + $GRP_ID = 0 |
|
518 | + ) { |
|
519 | + EE_Error::doing_it_wrong( |
|
520 | + __FUNCTION__, |
|
521 | + __( |
|
522 | + 'The class EE_Message_Template_Defaults has been deprecated and replaced by EE_Messages_Template_Defaults.', |
|
523 | + 'event_espresso' |
|
524 | + ), |
|
525 | + '4.9.0' |
|
526 | + ); |
|
527 | + /** @var EE_Message_Resource_Manager $message_resource_manager */ |
|
528 | + $message_resource_manager = EE_Registry::instance()->load_lib('Message_Resource_Manager'); |
|
529 | + $messenger = $message_resource_manager->get_messenger($messenger_name); |
|
530 | + $message_type = $message_resource_manager->get_message_type($message_type_name); |
|
531 | + return EE_Registry::instance()->load_lib( |
|
532 | + 'Messages_Template_Defaults', |
|
533 | + array( |
|
534 | + $GRP_ID, |
|
535 | + $messenger, |
|
536 | + $message_type, |
|
537 | + ) |
|
538 | + ); |
|
539 | + } |
|
540 | 540 | } |
541 | 541 | |
542 | 542 | |
@@ -554,525 +554,525 @@ discard block |
||
554 | 554 | class EE_messages |
555 | 555 | { |
556 | 556 | |
557 | - /** @type EE_messenger[] */ |
|
558 | - protected $_active_messengers = array(); |
|
559 | - |
|
560 | - /** @type array */ |
|
561 | - protected $_active_message_types = array(); |
|
562 | - |
|
563 | - /** @type EE_message_type[] */ |
|
564 | - protected $_installed_message_types = array(); |
|
565 | - |
|
566 | - /** @type EE_messenger */ |
|
567 | - protected $_messenger; |
|
568 | - |
|
569 | - /** @type EE_message_type */ |
|
570 | - protected $_message_type; |
|
571 | - |
|
572 | - /** @type array */ |
|
573 | - protected $_contexts = array(); |
|
574 | - |
|
575 | - /** @type EE_Message_Resource_Manager $_message_resource_manager */ |
|
576 | - protected $_message_resource_manager; |
|
577 | - |
|
578 | - |
|
579 | - /** |
|
580 | - * EE_messages constructor. |
|
581 | - * |
|
582 | - * @deprecated 4.9.0 |
|
583 | - */ |
|
584 | - public function __construct() |
|
585 | - { |
|
586 | - } |
|
587 | - |
|
588 | - |
|
589 | - /** |
|
590 | - * @param string $method |
|
591 | - */ |
|
592 | - public function _class_is_deprecated($method) |
|
593 | - { |
|
594 | - EE_Error::doing_it_wrong( |
|
595 | - 'EE_messages::' . $method, |
|
596 | - __('EE_messages has been deprecated. Please use EE_Message_Resource_Manager instead.'), |
|
597 | - '4.9.0', |
|
598 | - '4.10.0.p' |
|
599 | - ); |
|
600 | - // Please use EE_Message_Resource_Manager instead |
|
601 | - $this->_message_resource_manager = EE_Registry::instance()->load_lib('Message_Resource_Manager'); |
|
602 | - } |
|
603 | - |
|
604 | - |
|
605 | - /** |
|
606 | - * @deprecated 4.9.0 |
|
607 | - * @param string $messenger_name |
|
608 | - * @return boolean TRUE if it was PREVIOUSLY active, and FALSE if it was previously inactive |
|
609 | - */ |
|
610 | - public function ensure_messenger_is_active($messenger_name) |
|
611 | - { |
|
612 | - // EE_messages has been deprecated |
|
613 | - $this->_class_is_deprecated(__FUNCTION__); |
|
614 | - return $this->_message_resource_manager->ensure_messenger_is_active($messenger_name); |
|
615 | - } |
|
616 | - |
|
617 | - |
|
618 | - /** |
|
619 | - * @deprecated 4.9.0 |
|
620 | - * @param string $message_type message type name |
|
621 | - * @param $messenger |
|
622 | - * @return bool true if it got activated (or was active) and false if not. |
|
623 | - * @throws \EE_Error |
|
624 | - */ |
|
625 | - public function ensure_message_type_is_active($message_type, $messenger) |
|
626 | - { |
|
627 | - // EE_messages has been deprecated |
|
628 | - $this->_class_is_deprecated(__FUNCTION__); |
|
629 | - return $this->_message_resource_manager->ensure_message_type_is_active($message_type, $messenger); |
|
630 | - } |
|
631 | - |
|
632 | - |
|
633 | - /** |
|
634 | - * @deprecated 4.9.0 |
|
635 | - * @param string $messenger_name |
|
636 | - * @param array $mts_to_activate (optional) An array of message types to activate with this messenger. |
|
637 | - * If included we do NOT setup the default message types (assuming they |
|
638 | - * are already setup.) |
|
639 | - * @return boolean an array of generated templates or false if nothing generated/activated. |
|
640 | - */ |
|
641 | - public function activate_messenger($messenger_name, $mts_to_activate = array()) |
|
642 | - { |
|
643 | - // EE_messages has been deprecated |
|
644 | - $this->_class_is_deprecated(__FUNCTION__); |
|
645 | - return $this->_message_resource_manager->activate_messenger($messenger_name, $mts_to_activate); |
|
646 | - } |
|
647 | - |
|
648 | - |
|
649 | - /** |
|
650 | - * @deprecated 4.9.0 |
|
651 | - * @param EE_messenger $messenger messenger used in trigger |
|
652 | - * @param EE_message_type $message_type message type used in trigger |
|
653 | - * |
|
654 | - * @return bool true is a generating messenger and can be sent OR FALSE meaning cannot send. |
|
655 | - */ |
|
656 | - public function is_generating_messenger_and_active(EE_messenger $messenger, EE_message_type $message_type) |
|
657 | - { |
|
658 | - // EE_messages has been deprecated |
|
659 | - $this->_class_is_deprecated(__FUNCTION__); |
|
660 | - return $this->_message_resource_manager->is_generating_messenger_and_active($messenger, $message_type); |
|
661 | - } |
|
662 | - |
|
663 | - |
|
664 | - /** |
|
665 | - * @deprecated 4.9.0 |
|
666 | - * @param string $messenger |
|
667 | - * @return EE_messenger | null |
|
668 | - */ |
|
669 | - public function get_messenger_if_active($messenger) |
|
670 | - { |
|
671 | - // EE_messages has been deprecated |
|
672 | - $this->_class_is_deprecated(__FUNCTION__); |
|
673 | - return $this->_message_resource_manager->get_active_messenger($messenger); |
|
674 | - } |
|
675 | - |
|
676 | - |
|
677 | - /** |
|
678 | - * @deprecated 4.9.0 |
|
679 | - * @param EE_Message $message |
|
680 | - * @return array An array with 'messenger' and 'message_type' as the index and the corresponding valid object if |
|
681 | - * available. |
|
682 | - * Eg. Valid Messenger and Message Type: |
|
683 | - * array( |
|
684 | - * 'messenger' => new EE_Email_messenger(), |
|
685 | - * 'message_type' => new EE_Registration_Approved_message_type() |
|
686 | - * ) |
|
687 | - * Valid Messenger and Invalid Message Type: |
|
688 | - * array( |
|
689 | - * 'messenger' => new EE_Email_messenger(), |
|
690 | - * 'message_type' => null |
|
691 | - * ) |
|
692 | - */ |
|
693 | - public function validate_for_use(EE_Message $message) |
|
694 | - { |
|
695 | - // EE_messages has been deprecated |
|
696 | - $this->_class_is_deprecated(__FUNCTION__); |
|
697 | - return array( |
|
698 | - 'messenger' => $message->messenger_object(), |
|
699 | - 'message_type' => $message->message_type_object(), |
|
700 | - ); |
|
701 | - } |
|
702 | - |
|
703 | - |
|
704 | - /** |
|
705 | - * @deprecated 4.9.0 |
|
706 | - * @param string $type What type of message are we sending (corresponds to message types) |
|
707 | - * @param mixed $vars Data being sent for parsing in the message |
|
708 | - * @param string $sending_messenger if included then we ONLY use the specified messenger for delivery. |
|
709 | - * Otherwise we cycle through all active messengers. |
|
710 | - * @param string $generating_messenger if included then this messenger is used for generating the message |
|
711 | - * templates (but not for sending). |
|
712 | - * @param string $context If included then only a message type for a specific context will be |
|
713 | - * generated. |
|
714 | - * @param bool $send Default TRUE. If false, then this will just return the generated |
|
715 | - * EE_messages objects which might be used by the trigger to setup a batch |
|
716 | - * message (typically html messenger uses it). |
|
717 | - * @return bool |
|
718 | - */ |
|
719 | - public function send_message( |
|
720 | - $type, |
|
721 | - $vars, |
|
722 | - $sending_messenger = '', |
|
723 | - $generating_messenger = '', |
|
724 | - $context = '', |
|
725 | - $send = true |
|
726 | - ) { |
|
727 | - // EE_messages has been deprecated |
|
728 | - $this->_class_is_deprecated(__FUNCTION__); |
|
729 | - /** @type EE_Messages_Processor $processor */ |
|
730 | - $processor = EE_Registry::instance()->load_lib('Messages_Processor'); |
|
731 | - $error = false; |
|
732 | - // try to intelligently determine what method we'll call based on the incoming data. |
|
733 | - // if generating and sending are different then generate and send immediately. |
|
734 | - if (! empty($sending_messenger) && $sending_messenger != $generating_messenger && $send) { |
|
735 | - // in the legacy system, when generating and sending were different, that means all the |
|
736 | - // vars are already in the request object. So let's just use that. |
|
737 | - try { |
|
738 | - /** @type EE_Message_To_Generate_From_Request $mtg */ |
|
739 | - $mtg = EE_Registry::instance()->load_lib('Message_To_Generate_From_Request'); |
|
740 | - $processor->generate_and_send_now($mtg); |
|
741 | - } catch (EE_Error $e) { |
|
742 | - $error_msg = __( |
|
743 | - 'Please note that a system message failed to send due to a technical issue.', |
|
744 | - 'event_espresso' |
|
745 | - ); |
|
746 | - // add specific message for developers if WP_DEBUG in on |
|
747 | - $error_msg .= '||' . $e->getMessage(); |
|
748 | - EE_Error::add_error($error_msg, __FILE__, __FUNCTION__, __LINE__); |
|
749 | - $error = true; |
|
750 | - } |
|
751 | - } else { |
|
752 | - $processor->generate_for_all_active_messengers($type, $vars, $send); |
|
753 | - // let's find out if there were any errors and how many successfully were queued. |
|
754 | - $count_errors = $processor->get_queue()->count_STS_in_queue( |
|
755 | - array(EEM_Message::status_failed, EEM_Message::status_debug_only) |
|
756 | - ); |
|
757 | - $count_queued = $processor->get_queue()->count_STS_in_queue(EEM_Message::status_incomplete); |
|
758 | - $count_retry = $processor->get_queue()->count_STS_in_queue(EEM_Message::status_retry); |
|
759 | - $count_errors = $count_errors + $count_retry; |
|
760 | - if ($count_errors > 0) { |
|
761 | - $error = true; |
|
762 | - if ($count_errors > 1 && $count_retry > 1 && $count_queued > 1) { |
|
763 | - $message = sprintf( |
|
764 | - __( |
|
765 | - 'There were %d errors and %d messages successfully queued for generation and sending', |
|
766 | - 'event_espresso' |
|
767 | - ), |
|
768 | - $count_errors, |
|
769 | - $count_queued |
|
770 | - ); |
|
771 | - } elseif ($count_errors > 1 && $count_queued === 1) { |
|
772 | - $message = sprintf( |
|
773 | - __( |
|
774 | - 'There were %d errors and %d message successfully queued for generation.', |
|
775 | - 'event_espresso' |
|
776 | - ), |
|
777 | - $count_errors, |
|
778 | - $count_queued |
|
779 | - ); |
|
780 | - } elseif ($count_errors === 1 && $count_queued > 1) { |
|
781 | - $message = sprintf( |
|
782 | - __( |
|
783 | - 'There was %d error and %d messages successfully queued for generation.', |
|
784 | - 'event_espresso' |
|
785 | - ), |
|
786 | - $count_errors, |
|
787 | - $count_queued |
|
788 | - ); |
|
789 | - } else { |
|
790 | - $message = sprintf( |
|
791 | - __( |
|
792 | - 'There was %d message that failed to be queued for generation.', |
|
793 | - 'event_espresso' |
|
794 | - ), |
|
795 | - $count_errors |
|
796 | - ); |
|
797 | - } |
|
798 | - EE_Error::add_error($message, __FILE__, __FUNCTION__, __LINE__); |
|
799 | - } else { |
|
800 | - if ($count_queued === 1) { |
|
801 | - $message = sprintf( |
|
802 | - __( |
|
803 | - '%d message successfully queued for generation.', |
|
804 | - 'event_espresso' |
|
805 | - ), |
|
806 | - $count_queued |
|
807 | - ); |
|
808 | - } else { |
|
809 | - $message = sprintf( |
|
810 | - __( |
|
811 | - '%d messages were successfully queued for generation.', |
|
812 | - 'event_espresso' |
|
813 | - ), |
|
814 | - $count_queued |
|
815 | - ); |
|
816 | - } |
|
817 | - EE_Error::add_success($message); |
|
818 | - } |
|
819 | - } |
|
820 | - // if no error then return the generated message(s). |
|
821 | - if (! $error && ! $send) { |
|
822 | - $generated_queue = $processor->generate_queue(false); |
|
823 | - // get message and return. |
|
824 | - $generated_queue->get_message_repository()->rewind(); |
|
825 | - $messages = array(); |
|
826 | - while ($generated_queue->get_message_repository()->valid()) { |
|
827 | - $message = $generated_queue->get_message_repository()->current(); |
|
828 | - if ($message instanceof EE_Message) { |
|
829 | - // set properties that might be expected by add-ons (backward compat) |
|
830 | - $message->content = $message->content(); |
|
831 | - $message->template_pack = $message->get_template_pack(); |
|
832 | - $message->template_variation = $message->get_template_pack_variation(); |
|
833 | - $messages[] = $message; |
|
834 | - } |
|
835 | - $generated_queue->get_message_repository()->next(); |
|
836 | - } |
|
837 | - return $messages; |
|
838 | - } |
|
839 | - return $error ? false |
|
840 | - : true; // yeah backwards eh? Really what we're returning is if there is a total success for all the messages or not. We'll modify this once we get message recording in place. |
|
841 | - } |
|
842 | - |
|
843 | - |
|
844 | - /** |
|
845 | - * @deprecated 4.9.0 |
|
846 | - * @param string $type This should correspond with a valid message type |
|
847 | - * @param string $context This should correspond with a valid context for the message type |
|
848 | - * @param string $messenger This should correspond with a valid messenger. |
|
849 | - * @param bool $send true we will do a test send using the messenger delivery, false we just do a regular |
|
850 | - * preview |
|
851 | - * @return string The body of the message. |
|
852 | - */ |
|
853 | - public function preview_message($type, $context, $messenger, $send = false) |
|
854 | - { |
|
855 | - // EE_messages has been deprecated |
|
856 | - $this->_class_is_deprecated(__FUNCTION__); |
|
857 | - return EED_Messages::preview_message($type, $context, $messenger, $send); |
|
858 | - } |
|
859 | - |
|
860 | - |
|
861 | - /** |
|
862 | - * @since 4.5.0 |
|
863 | - * @deprecated 4.9.0 Moved to EED_Messages Module |
|
864 | - * @param string $messenger a string matching a valid active messenger in the system |
|
865 | - * @param string $message_type Although it seems contrary to the name of the method, a message type name is still |
|
866 | - * required to send along the message type to the messenger because this is used for |
|
867 | - * determining what specific variations might be loaded for the generated message. |
|
868 | - * @param stdClass $message a stdClass object in the format expected by the messenger. |
|
869 | - * |
|
870 | - * @return bool success or fail. |
|
871 | - */ |
|
872 | - public function send_message_with_messenger_only($messenger, $message_type, $message) |
|
873 | - { |
|
874 | - // EE_messages has been deprecated |
|
875 | - $this->_class_is_deprecated(__FUNCTION__); |
|
876 | - // setup for sending to new method. |
|
877 | - /** @type EE_Messages_Queue $queue */ |
|
878 | - $queue = EE_Registry::instance()->load_lib('Messages_Queue'); |
|
879 | - // make sure we have a proper message object |
|
880 | - if (! $message instanceof EE_Message && is_object($message) && isset($message->content)) { |
|
881 | - $msg = EE_Message_Factory::create( |
|
882 | - array( |
|
883 | - 'MSG_messenger' => $messenger, |
|
884 | - 'MSG_message_type' => $message_type, |
|
885 | - 'MSG_content' => $message->content, |
|
886 | - 'MSG_subject' => $message->subject, |
|
887 | - ) |
|
888 | - ); |
|
889 | - } else { |
|
890 | - $msg = $message; |
|
891 | - } |
|
892 | - if (! $msg instanceof EE_Message) { |
|
893 | - return false; |
|
894 | - } |
|
895 | - // make sure any content in a content property (if not empty) is set on the MSG_content. |
|
896 | - if (! empty($msg->content)) { |
|
897 | - $msg->set('MSG_content', $msg->content); |
|
898 | - } |
|
899 | - $queue->add($msg); |
|
900 | - return EED_Messages::send_message_with_messenger_only($messenger, $message_type, $queue); |
|
901 | - } |
|
902 | - |
|
903 | - |
|
904 | - /** |
|
905 | - * @deprecated 4.9.0 |
|
906 | - * @param $messenger |
|
907 | - * @param string $message_type message type that the templates are being created for |
|
908 | - * @param int $GRP_ID |
|
909 | - * @param bool $is_global |
|
910 | - * @return array|object if creation is successful then we return an array of info, otherwise an error_object is |
|
911 | - * returned. |
|
912 | - * @throws \EE_Error |
|
913 | - */ |
|
914 | - public function create_new_templates($messenger, $message_type, $GRP_ID = 0, $is_global = false) |
|
915 | - { |
|
916 | - // EE_messages has been deprecated |
|
917 | - $this->_class_is_deprecated(__FUNCTION__); |
|
918 | - EE_Registry::instance()->load_helper('MSG_Template'); |
|
919 | - return EEH_MSG_Template::create_new_templates($messenger, $message_type, $GRP_ID, $is_global); |
|
920 | - } |
|
921 | - |
|
922 | - |
|
923 | - /** |
|
924 | - * @deprecated 4.9.0 |
|
925 | - * @param string $messenger_name name of EE_messenger |
|
926 | - * @param string $message_type_name name of EE_message_type |
|
927 | - * @return array |
|
928 | - */ |
|
929 | - public function get_fields($messenger_name, $message_type_name) |
|
930 | - { |
|
931 | - // EE_messages has been deprecated |
|
932 | - $this->_class_is_deprecated(__FUNCTION__); |
|
933 | - EE_Registry::instance()->load_helper('MSG_Template'); |
|
934 | - return EEH_MSG_Template::get_fields($messenger_name, $message_type_name); |
|
935 | - } |
|
936 | - |
|
937 | - |
|
938 | - /** |
|
939 | - * @deprecated 4.9.0 |
|
940 | - * @access public |
|
941 | - * @param string $type we can indicate just returning installed message types |
|
942 | - * or messengers (or both) via this parameter. |
|
943 | - * @param bool $skip_cache if true then we skip the cache and retrieve via files. |
|
944 | - * @return array multidimensional array of messenger and message_type objects |
|
945 | - * (messengers index, and message_type index); |
|
946 | - */ |
|
947 | - public function get_installed($type = 'all', $skip_cache = false) |
|
948 | - { |
|
949 | - // EE_messages has been deprecated |
|
950 | - $this->_class_is_deprecated(__FUNCTION__); |
|
951 | - if ($skip_cache) { |
|
952 | - $this->_message_resource_manager->reset_active_messengers_and_message_types(); |
|
953 | - } |
|
954 | - switch ($type) { |
|
955 | - case 'messengers' : |
|
956 | - return array( |
|
957 | - 'messenger' => $this->_message_resource_manager->installed_messengers(), |
|
958 | - ); |
|
959 | - break; |
|
960 | - case 'message_types' : |
|
961 | - return array( |
|
962 | - 'message_type' => $this->_message_resource_manager->installed_message_types(), |
|
963 | - ); |
|
964 | - break; |
|
965 | - case 'all' : |
|
966 | - default : |
|
967 | - return array( |
|
968 | - 'messenger' => $this->_message_resource_manager->installed_messengers(), |
|
969 | - 'message_type' => $this->_message_resource_manager->installed_message_types(), |
|
970 | - ); |
|
971 | - break; |
|
972 | - } |
|
973 | - } |
|
974 | - |
|
975 | - |
|
976 | - /** |
|
977 | - * @deprecated 4.9.0 |
|
978 | - * @return \EE_messenger[] |
|
979 | - */ |
|
980 | - public function get_active_messengers() |
|
981 | - { |
|
982 | - // EE_messages has been deprecated |
|
983 | - $this->_class_is_deprecated(__FUNCTION__); |
|
984 | - return $this->_message_resource_manager->active_messengers(); |
|
985 | - } |
|
986 | - |
|
987 | - |
|
988 | - /** |
|
989 | - * @deprecated 4.9.0 |
|
990 | - * @return array array of message_type references (string) |
|
991 | - */ |
|
992 | - public function get_active_message_types() |
|
993 | - { |
|
994 | - // EE_messages has been deprecated |
|
995 | - $this->_class_is_deprecated(__FUNCTION__); |
|
996 | - return $this->_message_resource_manager->list_of_active_message_types(); |
|
997 | - } |
|
998 | - |
|
999 | - |
|
1000 | - /** |
|
1001 | - * @deprecated 4.9.0 |
|
1002 | - * @return EE_message_type[] |
|
1003 | - */ |
|
1004 | - public function get_active_message_type_objects() |
|
1005 | - { |
|
1006 | - // EE_messages has been deprecated |
|
1007 | - $this->_class_is_deprecated(__FUNCTION__); |
|
1008 | - return $this->_message_resource_manager->get_active_message_type_objects(); |
|
1009 | - } |
|
1010 | - |
|
1011 | - |
|
1012 | - /** |
|
1013 | - * @deprecated 4.9.0 |
|
1014 | - * @since 4.5.0 |
|
1015 | - * @param string $messenger The messenger being checked |
|
1016 | - * @return EE_message_type[] (or empty array if none present) |
|
1017 | - */ |
|
1018 | - public function get_active_message_types_per_messenger($messenger) |
|
1019 | - { |
|
1020 | - // EE_messages has been deprecated |
|
1021 | - $this->_class_is_deprecated(__FUNCTION__); |
|
1022 | - return $this->_message_resource_manager->get_active_message_types_for_messenger($messenger); |
|
1023 | - } |
|
1024 | - |
|
1025 | - |
|
1026 | - /** |
|
1027 | - * @deprecated 4.9.0 |
|
1028 | - * @param string $messenger The string should correspond to the messenger (message types are |
|
1029 | - * @param string $message_type The string should correspond to a message type. |
|
1030 | - * @return EE_message_type|null |
|
1031 | - */ |
|
1032 | - public function get_active_message_type($messenger, $message_type) |
|
1033 | - { |
|
1034 | - // EE_messages has been deprecated |
|
1035 | - $this->_class_is_deprecated(__FUNCTION__); |
|
1036 | - return $this->_message_resource_manager->get_active_message_type_for_messenger($messenger, $message_type); |
|
1037 | - } |
|
1038 | - |
|
1039 | - |
|
1040 | - /** |
|
1041 | - * @deprecated 4.9.0 |
|
1042 | - * @return array|\EE_message_type[] |
|
1043 | - */ |
|
1044 | - public function get_installed_message_types() |
|
1045 | - { |
|
1046 | - // EE_messages has been deprecated |
|
1047 | - $this->_class_is_deprecated(__FUNCTION__); |
|
1048 | - return $this->_message_resource_manager->installed_message_types(); |
|
1049 | - } |
|
1050 | - |
|
1051 | - |
|
1052 | - /** |
|
1053 | - * @deprecated 4.9.0 |
|
1054 | - * @return array |
|
1055 | - */ |
|
1056 | - public function get_installed_messengers() |
|
1057 | - { |
|
1058 | - // EE_messages has been deprecated |
|
1059 | - $this->_class_is_deprecated(__FUNCTION__); |
|
1060 | - return $this->_message_resource_manager->installed_messengers(); |
|
1061 | - } |
|
1062 | - |
|
1063 | - |
|
1064 | - /** |
|
1065 | - * @deprecated 4.9.0 |
|
1066 | - * @param bool $slugs_only Whether to return an array of just slugs and labels (true) or all contexts indexed by |
|
1067 | - * message type. |
|
1068 | - * @return array |
|
1069 | - */ |
|
1070 | - public function get_all_contexts($slugs_only = true) |
|
1071 | - { |
|
1072 | - // EE_messages has been deprecated |
|
1073 | - $this->_class_is_deprecated(__FUNCTION__); |
|
1074 | - return $this->_message_resource_manager->get_all_contexts($slugs_only); |
|
1075 | - } |
|
557 | + /** @type EE_messenger[] */ |
|
558 | + protected $_active_messengers = array(); |
|
559 | + |
|
560 | + /** @type array */ |
|
561 | + protected $_active_message_types = array(); |
|
562 | + |
|
563 | + /** @type EE_message_type[] */ |
|
564 | + protected $_installed_message_types = array(); |
|
565 | + |
|
566 | + /** @type EE_messenger */ |
|
567 | + protected $_messenger; |
|
568 | + |
|
569 | + /** @type EE_message_type */ |
|
570 | + protected $_message_type; |
|
571 | + |
|
572 | + /** @type array */ |
|
573 | + protected $_contexts = array(); |
|
574 | + |
|
575 | + /** @type EE_Message_Resource_Manager $_message_resource_manager */ |
|
576 | + protected $_message_resource_manager; |
|
577 | + |
|
578 | + |
|
579 | + /** |
|
580 | + * EE_messages constructor. |
|
581 | + * |
|
582 | + * @deprecated 4.9.0 |
|
583 | + */ |
|
584 | + public function __construct() |
|
585 | + { |
|
586 | + } |
|
587 | + |
|
588 | + |
|
589 | + /** |
|
590 | + * @param string $method |
|
591 | + */ |
|
592 | + public function _class_is_deprecated($method) |
|
593 | + { |
|
594 | + EE_Error::doing_it_wrong( |
|
595 | + 'EE_messages::' . $method, |
|
596 | + __('EE_messages has been deprecated. Please use EE_Message_Resource_Manager instead.'), |
|
597 | + '4.9.0', |
|
598 | + '4.10.0.p' |
|
599 | + ); |
|
600 | + // Please use EE_Message_Resource_Manager instead |
|
601 | + $this->_message_resource_manager = EE_Registry::instance()->load_lib('Message_Resource_Manager'); |
|
602 | + } |
|
603 | + |
|
604 | + |
|
605 | + /** |
|
606 | + * @deprecated 4.9.0 |
|
607 | + * @param string $messenger_name |
|
608 | + * @return boolean TRUE if it was PREVIOUSLY active, and FALSE if it was previously inactive |
|
609 | + */ |
|
610 | + public function ensure_messenger_is_active($messenger_name) |
|
611 | + { |
|
612 | + // EE_messages has been deprecated |
|
613 | + $this->_class_is_deprecated(__FUNCTION__); |
|
614 | + return $this->_message_resource_manager->ensure_messenger_is_active($messenger_name); |
|
615 | + } |
|
616 | + |
|
617 | + |
|
618 | + /** |
|
619 | + * @deprecated 4.9.0 |
|
620 | + * @param string $message_type message type name |
|
621 | + * @param $messenger |
|
622 | + * @return bool true if it got activated (or was active) and false if not. |
|
623 | + * @throws \EE_Error |
|
624 | + */ |
|
625 | + public function ensure_message_type_is_active($message_type, $messenger) |
|
626 | + { |
|
627 | + // EE_messages has been deprecated |
|
628 | + $this->_class_is_deprecated(__FUNCTION__); |
|
629 | + return $this->_message_resource_manager->ensure_message_type_is_active($message_type, $messenger); |
|
630 | + } |
|
631 | + |
|
632 | + |
|
633 | + /** |
|
634 | + * @deprecated 4.9.0 |
|
635 | + * @param string $messenger_name |
|
636 | + * @param array $mts_to_activate (optional) An array of message types to activate with this messenger. |
|
637 | + * If included we do NOT setup the default message types (assuming they |
|
638 | + * are already setup.) |
|
639 | + * @return boolean an array of generated templates or false if nothing generated/activated. |
|
640 | + */ |
|
641 | + public function activate_messenger($messenger_name, $mts_to_activate = array()) |
|
642 | + { |
|
643 | + // EE_messages has been deprecated |
|
644 | + $this->_class_is_deprecated(__FUNCTION__); |
|
645 | + return $this->_message_resource_manager->activate_messenger($messenger_name, $mts_to_activate); |
|
646 | + } |
|
647 | + |
|
648 | + |
|
649 | + /** |
|
650 | + * @deprecated 4.9.0 |
|
651 | + * @param EE_messenger $messenger messenger used in trigger |
|
652 | + * @param EE_message_type $message_type message type used in trigger |
|
653 | + * |
|
654 | + * @return bool true is a generating messenger and can be sent OR FALSE meaning cannot send. |
|
655 | + */ |
|
656 | + public function is_generating_messenger_and_active(EE_messenger $messenger, EE_message_type $message_type) |
|
657 | + { |
|
658 | + // EE_messages has been deprecated |
|
659 | + $this->_class_is_deprecated(__FUNCTION__); |
|
660 | + return $this->_message_resource_manager->is_generating_messenger_and_active($messenger, $message_type); |
|
661 | + } |
|
662 | + |
|
663 | + |
|
664 | + /** |
|
665 | + * @deprecated 4.9.0 |
|
666 | + * @param string $messenger |
|
667 | + * @return EE_messenger | null |
|
668 | + */ |
|
669 | + public function get_messenger_if_active($messenger) |
|
670 | + { |
|
671 | + // EE_messages has been deprecated |
|
672 | + $this->_class_is_deprecated(__FUNCTION__); |
|
673 | + return $this->_message_resource_manager->get_active_messenger($messenger); |
|
674 | + } |
|
675 | + |
|
676 | + |
|
677 | + /** |
|
678 | + * @deprecated 4.9.0 |
|
679 | + * @param EE_Message $message |
|
680 | + * @return array An array with 'messenger' and 'message_type' as the index and the corresponding valid object if |
|
681 | + * available. |
|
682 | + * Eg. Valid Messenger and Message Type: |
|
683 | + * array( |
|
684 | + * 'messenger' => new EE_Email_messenger(), |
|
685 | + * 'message_type' => new EE_Registration_Approved_message_type() |
|
686 | + * ) |
|
687 | + * Valid Messenger and Invalid Message Type: |
|
688 | + * array( |
|
689 | + * 'messenger' => new EE_Email_messenger(), |
|
690 | + * 'message_type' => null |
|
691 | + * ) |
|
692 | + */ |
|
693 | + public function validate_for_use(EE_Message $message) |
|
694 | + { |
|
695 | + // EE_messages has been deprecated |
|
696 | + $this->_class_is_deprecated(__FUNCTION__); |
|
697 | + return array( |
|
698 | + 'messenger' => $message->messenger_object(), |
|
699 | + 'message_type' => $message->message_type_object(), |
|
700 | + ); |
|
701 | + } |
|
702 | + |
|
703 | + |
|
704 | + /** |
|
705 | + * @deprecated 4.9.0 |
|
706 | + * @param string $type What type of message are we sending (corresponds to message types) |
|
707 | + * @param mixed $vars Data being sent for parsing in the message |
|
708 | + * @param string $sending_messenger if included then we ONLY use the specified messenger for delivery. |
|
709 | + * Otherwise we cycle through all active messengers. |
|
710 | + * @param string $generating_messenger if included then this messenger is used for generating the message |
|
711 | + * templates (but not for sending). |
|
712 | + * @param string $context If included then only a message type for a specific context will be |
|
713 | + * generated. |
|
714 | + * @param bool $send Default TRUE. If false, then this will just return the generated |
|
715 | + * EE_messages objects which might be used by the trigger to setup a batch |
|
716 | + * message (typically html messenger uses it). |
|
717 | + * @return bool |
|
718 | + */ |
|
719 | + public function send_message( |
|
720 | + $type, |
|
721 | + $vars, |
|
722 | + $sending_messenger = '', |
|
723 | + $generating_messenger = '', |
|
724 | + $context = '', |
|
725 | + $send = true |
|
726 | + ) { |
|
727 | + // EE_messages has been deprecated |
|
728 | + $this->_class_is_deprecated(__FUNCTION__); |
|
729 | + /** @type EE_Messages_Processor $processor */ |
|
730 | + $processor = EE_Registry::instance()->load_lib('Messages_Processor'); |
|
731 | + $error = false; |
|
732 | + // try to intelligently determine what method we'll call based on the incoming data. |
|
733 | + // if generating and sending are different then generate and send immediately. |
|
734 | + if (! empty($sending_messenger) && $sending_messenger != $generating_messenger && $send) { |
|
735 | + // in the legacy system, when generating and sending were different, that means all the |
|
736 | + // vars are already in the request object. So let's just use that. |
|
737 | + try { |
|
738 | + /** @type EE_Message_To_Generate_From_Request $mtg */ |
|
739 | + $mtg = EE_Registry::instance()->load_lib('Message_To_Generate_From_Request'); |
|
740 | + $processor->generate_and_send_now($mtg); |
|
741 | + } catch (EE_Error $e) { |
|
742 | + $error_msg = __( |
|
743 | + 'Please note that a system message failed to send due to a technical issue.', |
|
744 | + 'event_espresso' |
|
745 | + ); |
|
746 | + // add specific message for developers if WP_DEBUG in on |
|
747 | + $error_msg .= '||' . $e->getMessage(); |
|
748 | + EE_Error::add_error($error_msg, __FILE__, __FUNCTION__, __LINE__); |
|
749 | + $error = true; |
|
750 | + } |
|
751 | + } else { |
|
752 | + $processor->generate_for_all_active_messengers($type, $vars, $send); |
|
753 | + // let's find out if there were any errors and how many successfully were queued. |
|
754 | + $count_errors = $processor->get_queue()->count_STS_in_queue( |
|
755 | + array(EEM_Message::status_failed, EEM_Message::status_debug_only) |
|
756 | + ); |
|
757 | + $count_queued = $processor->get_queue()->count_STS_in_queue(EEM_Message::status_incomplete); |
|
758 | + $count_retry = $processor->get_queue()->count_STS_in_queue(EEM_Message::status_retry); |
|
759 | + $count_errors = $count_errors + $count_retry; |
|
760 | + if ($count_errors > 0) { |
|
761 | + $error = true; |
|
762 | + if ($count_errors > 1 && $count_retry > 1 && $count_queued > 1) { |
|
763 | + $message = sprintf( |
|
764 | + __( |
|
765 | + 'There were %d errors and %d messages successfully queued for generation and sending', |
|
766 | + 'event_espresso' |
|
767 | + ), |
|
768 | + $count_errors, |
|
769 | + $count_queued |
|
770 | + ); |
|
771 | + } elseif ($count_errors > 1 && $count_queued === 1) { |
|
772 | + $message = sprintf( |
|
773 | + __( |
|
774 | + 'There were %d errors and %d message successfully queued for generation.', |
|
775 | + 'event_espresso' |
|
776 | + ), |
|
777 | + $count_errors, |
|
778 | + $count_queued |
|
779 | + ); |
|
780 | + } elseif ($count_errors === 1 && $count_queued > 1) { |
|
781 | + $message = sprintf( |
|
782 | + __( |
|
783 | + 'There was %d error and %d messages successfully queued for generation.', |
|
784 | + 'event_espresso' |
|
785 | + ), |
|
786 | + $count_errors, |
|
787 | + $count_queued |
|
788 | + ); |
|
789 | + } else { |
|
790 | + $message = sprintf( |
|
791 | + __( |
|
792 | + 'There was %d message that failed to be queued for generation.', |
|
793 | + 'event_espresso' |
|
794 | + ), |
|
795 | + $count_errors |
|
796 | + ); |
|
797 | + } |
|
798 | + EE_Error::add_error($message, __FILE__, __FUNCTION__, __LINE__); |
|
799 | + } else { |
|
800 | + if ($count_queued === 1) { |
|
801 | + $message = sprintf( |
|
802 | + __( |
|
803 | + '%d message successfully queued for generation.', |
|
804 | + 'event_espresso' |
|
805 | + ), |
|
806 | + $count_queued |
|
807 | + ); |
|
808 | + } else { |
|
809 | + $message = sprintf( |
|
810 | + __( |
|
811 | + '%d messages were successfully queued for generation.', |
|
812 | + 'event_espresso' |
|
813 | + ), |
|
814 | + $count_queued |
|
815 | + ); |
|
816 | + } |
|
817 | + EE_Error::add_success($message); |
|
818 | + } |
|
819 | + } |
|
820 | + // if no error then return the generated message(s). |
|
821 | + if (! $error && ! $send) { |
|
822 | + $generated_queue = $processor->generate_queue(false); |
|
823 | + // get message and return. |
|
824 | + $generated_queue->get_message_repository()->rewind(); |
|
825 | + $messages = array(); |
|
826 | + while ($generated_queue->get_message_repository()->valid()) { |
|
827 | + $message = $generated_queue->get_message_repository()->current(); |
|
828 | + if ($message instanceof EE_Message) { |
|
829 | + // set properties that might be expected by add-ons (backward compat) |
|
830 | + $message->content = $message->content(); |
|
831 | + $message->template_pack = $message->get_template_pack(); |
|
832 | + $message->template_variation = $message->get_template_pack_variation(); |
|
833 | + $messages[] = $message; |
|
834 | + } |
|
835 | + $generated_queue->get_message_repository()->next(); |
|
836 | + } |
|
837 | + return $messages; |
|
838 | + } |
|
839 | + return $error ? false |
|
840 | + : true; // yeah backwards eh? Really what we're returning is if there is a total success for all the messages or not. We'll modify this once we get message recording in place. |
|
841 | + } |
|
842 | + |
|
843 | + |
|
844 | + /** |
|
845 | + * @deprecated 4.9.0 |
|
846 | + * @param string $type This should correspond with a valid message type |
|
847 | + * @param string $context This should correspond with a valid context for the message type |
|
848 | + * @param string $messenger This should correspond with a valid messenger. |
|
849 | + * @param bool $send true we will do a test send using the messenger delivery, false we just do a regular |
|
850 | + * preview |
|
851 | + * @return string The body of the message. |
|
852 | + */ |
|
853 | + public function preview_message($type, $context, $messenger, $send = false) |
|
854 | + { |
|
855 | + // EE_messages has been deprecated |
|
856 | + $this->_class_is_deprecated(__FUNCTION__); |
|
857 | + return EED_Messages::preview_message($type, $context, $messenger, $send); |
|
858 | + } |
|
859 | + |
|
860 | + |
|
861 | + /** |
|
862 | + * @since 4.5.0 |
|
863 | + * @deprecated 4.9.0 Moved to EED_Messages Module |
|
864 | + * @param string $messenger a string matching a valid active messenger in the system |
|
865 | + * @param string $message_type Although it seems contrary to the name of the method, a message type name is still |
|
866 | + * required to send along the message type to the messenger because this is used for |
|
867 | + * determining what specific variations might be loaded for the generated message. |
|
868 | + * @param stdClass $message a stdClass object in the format expected by the messenger. |
|
869 | + * |
|
870 | + * @return bool success or fail. |
|
871 | + */ |
|
872 | + public function send_message_with_messenger_only($messenger, $message_type, $message) |
|
873 | + { |
|
874 | + // EE_messages has been deprecated |
|
875 | + $this->_class_is_deprecated(__FUNCTION__); |
|
876 | + // setup for sending to new method. |
|
877 | + /** @type EE_Messages_Queue $queue */ |
|
878 | + $queue = EE_Registry::instance()->load_lib('Messages_Queue'); |
|
879 | + // make sure we have a proper message object |
|
880 | + if (! $message instanceof EE_Message && is_object($message) && isset($message->content)) { |
|
881 | + $msg = EE_Message_Factory::create( |
|
882 | + array( |
|
883 | + 'MSG_messenger' => $messenger, |
|
884 | + 'MSG_message_type' => $message_type, |
|
885 | + 'MSG_content' => $message->content, |
|
886 | + 'MSG_subject' => $message->subject, |
|
887 | + ) |
|
888 | + ); |
|
889 | + } else { |
|
890 | + $msg = $message; |
|
891 | + } |
|
892 | + if (! $msg instanceof EE_Message) { |
|
893 | + return false; |
|
894 | + } |
|
895 | + // make sure any content in a content property (if not empty) is set on the MSG_content. |
|
896 | + if (! empty($msg->content)) { |
|
897 | + $msg->set('MSG_content', $msg->content); |
|
898 | + } |
|
899 | + $queue->add($msg); |
|
900 | + return EED_Messages::send_message_with_messenger_only($messenger, $message_type, $queue); |
|
901 | + } |
|
902 | + |
|
903 | + |
|
904 | + /** |
|
905 | + * @deprecated 4.9.0 |
|
906 | + * @param $messenger |
|
907 | + * @param string $message_type message type that the templates are being created for |
|
908 | + * @param int $GRP_ID |
|
909 | + * @param bool $is_global |
|
910 | + * @return array|object if creation is successful then we return an array of info, otherwise an error_object is |
|
911 | + * returned. |
|
912 | + * @throws \EE_Error |
|
913 | + */ |
|
914 | + public function create_new_templates($messenger, $message_type, $GRP_ID = 0, $is_global = false) |
|
915 | + { |
|
916 | + // EE_messages has been deprecated |
|
917 | + $this->_class_is_deprecated(__FUNCTION__); |
|
918 | + EE_Registry::instance()->load_helper('MSG_Template'); |
|
919 | + return EEH_MSG_Template::create_new_templates($messenger, $message_type, $GRP_ID, $is_global); |
|
920 | + } |
|
921 | + |
|
922 | + |
|
923 | + /** |
|
924 | + * @deprecated 4.9.0 |
|
925 | + * @param string $messenger_name name of EE_messenger |
|
926 | + * @param string $message_type_name name of EE_message_type |
|
927 | + * @return array |
|
928 | + */ |
|
929 | + public function get_fields($messenger_name, $message_type_name) |
|
930 | + { |
|
931 | + // EE_messages has been deprecated |
|
932 | + $this->_class_is_deprecated(__FUNCTION__); |
|
933 | + EE_Registry::instance()->load_helper('MSG_Template'); |
|
934 | + return EEH_MSG_Template::get_fields($messenger_name, $message_type_name); |
|
935 | + } |
|
936 | + |
|
937 | + |
|
938 | + /** |
|
939 | + * @deprecated 4.9.0 |
|
940 | + * @access public |
|
941 | + * @param string $type we can indicate just returning installed message types |
|
942 | + * or messengers (or both) via this parameter. |
|
943 | + * @param bool $skip_cache if true then we skip the cache and retrieve via files. |
|
944 | + * @return array multidimensional array of messenger and message_type objects |
|
945 | + * (messengers index, and message_type index); |
|
946 | + */ |
|
947 | + public function get_installed($type = 'all', $skip_cache = false) |
|
948 | + { |
|
949 | + // EE_messages has been deprecated |
|
950 | + $this->_class_is_deprecated(__FUNCTION__); |
|
951 | + if ($skip_cache) { |
|
952 | + $this->_message_resource_manager->reset_active_messengers_and_message_types(); |
|
953 | + } |
|
954 | + switch ($type) { |
|
955 | + case 'messengers' : |
|
956 | + return array( |
|
957 | + 'messenger' => $this->_message_resource_manager->installed_messengers(), |
|
958 | + ); |
|
959 | + break; |
|
960 | + case 'message_types' : |
|
961 | + return array( |
|
962 | + 'message_type' => $this->_message_resource_manager->installed_message_types(), |
|
963 | + ); |
|
964 | + break; |
|
965 | + case 'all' : |
|
966 | + default : |
|
967 | + return array( |
|
968 | + 'messenger' => $this->_message_resource_manager->installed_messengers(), |
|
969 | + 'message_type' => $this->_message_resource_manager->installed_message_types(), |
|
970 | + ); |
|
971 | + break; |
|
972 | + } |
|
973 | + } |
|
974 | + |
|
975 | + |
|
976 | + /** |
|
977 | + * @deprecated 4.9.0 |
|
978 | + * @return \EE_messenger[] |
|
979 | + */ |
|
980 | + public function get_active_messengers() |
|
981 | + { |
|
982 | + // EE_messages has been deprecated |
|
983 | + $this->_class_is_deprecated(__FUNCTION__); |
|
984 | + return $this->_message_resource_manager->active_messengers(); |
|
985 | + } |
|
986 | + |
|
987 | + |
|
988 | + /** |
|
989 | + * @deprecated 4.9.0 |
|
990 | + * @return array array of message_type references (string) |
|
991 | + */ |
|
992 | + public function get_active_message_types() |
|
993 | + { |
|
994 | + // EE_messages has been deprecated |
|
995 | + $this->_class_is_deprecated(__FUNCTION__); |
|
996 | + return $this->_message_resource_manager->list_of_active_message_types(); |
|
997 | + } |
|
998 | + |
|
999 | + |
|
1000 | + /** |
|
1001 | + * @deprecated 4.9.0 |
|
1002 | + * @return EE_message_type[] |
|
1003 | + */ |
|
1004 | + public function get_active_message_type_objects() |
|
1005 | + { |
|
1006 | + // EE_messages has been deprecated |
|
1007 | + $this->_class_is_deprecated(__FUNCTION__); |
|
1008 | + return $this->_message_resource_manager->get_active_message_type_objects(); |
|
1009 | + } |
|
1010 | + |
|
1011 | + |
|
1012 | + /** |
|
1013 | + * @deprecated 4.9.0 |
|
1014 | + * @since 4.5.0 |
|
1015 | + * @param string $messenger The messenger being checked |
|
1016 | + * @return EE_message_type[] (or empty array if none present) |
|
1017 | + */ |
|
1018 | + public function get_active_message_types_per_messenger($messenger) |
|
1019 | + { |
|
1020 | + // EE_messages has been deprecated |
|
1021 | + $this->_class_is_deprecated(__FUNCTION__); |
|
1022 | + return $this->_message_resource_manager->get_active_message_types_for_messenger($messenger); |
|
1023 | + } |
|
1024 | + |
|
1025 | + |
|
1026 | + /** |
|
1027 | + * @deprecated 4.9.0 |
|
1028 | + * @param string $messenger The string should correspond to the messenger (message types are |
|
1029 | + * @param string $message_type The string should correspond to a message type. |
|
1030 | + * @return EE_message_type|null |
|
1031 | + */ |
|
1032 | + public function get_active_message_type($messenger, $message_type) |
|
1033 | + { |
|
1034 | + // EE_messages has been deprecated |
|
1035 | + $this->_class_is_deprecated(__FUNCTION__); |
|
1036 | + return $this->_message_resource_manager->get_active_message_type_for_messenger($messenger, $message_type); |
|
1037 | + } |
|
1038 | + |
|
1039 | + |
|
1040 | + /** |
|
1041 | + * @deprecated 4.9.0 |
|
1042 | + * @return array|\EE_message_type[] |
|
1043 | + */ |
|
1044 | + public function get_installed_message_types() |
|
1045 | + { |
|
1046 | + // EE_messages has been deprecated |
|
1047 | + $this->_class_is_deprecated(__FUNCTION__); |
|
1048 | + return $this->_message_resource_manager->installed_message_types(); |
|
1049 | + } |
|
1050 | + |
|
1051 | + |
|
1052 | + /** |
|
1053 | + * @deprecated 4.9.0 |
|
1054 | + * @return array |
|
1055 | + */ |
|
1056 | + public function get_installed_messengers() |
|
1057 | + { |
|
1058 | + // EE_messages has been deprecated |
|
1059 | + $this->_class_is_deprecated(__FUNCTION__); |
|
1060 | + return $this->_message_resource_manager->installed_messengers(); |
|
1061 | + } |
|
1062 | + |
|
1063 | + |
|
1064 | + /** |
|
1065 | + * @deprecated 4.9.0 |
|
1066 | + * @param bool $slugs_only Whether to return an array of just slugs and labels (true) or all contexts indexed by |
|
1067 | + * message type. |
|
1068 | + * @return array |
|
1069 | + */ |
|
1070 | + public function get_all_contexts($slugs_only = true) |
|
1071 | + { |
|
1072 | + // EE_messages has been deprecated |
|
1073 | + $this->_class_is_deprecated(__FUNCTION__); |
|
1074 | + return $this->_message_resource_manager->get_all_contexts($slugs_only); |
|
1075 | + } |
|
1076 | 1076 | |
1077 | 1077 | |
1078 | 1078 | } |
@@ -1131,88 +1131,88 @@ discard block |
||
1131 | 1131 | |
1132 | 1132 | |
1133 | 1133 | add_filter( |
1134 | - 'FHEE__EventEspresso_modules_events_archive_EventsArchiveIframe__display__css', |
|
1135 | - function ($event_list_iframe_css) { |
|
1136 | - if (! has_filter('FHEE__EventsArchiveIframe__event_list_iframe__css')) { |
|
1137 | - return $event_list_iframe_css; |
|
1138 | - } |
|
1139 | - deprecated_espresso_action_or_filter_doing_it_wrong( |
|
1140 | - 'FHEE__EventsArchiveIframe__event_list_iframe__css', |
|
1141 | - 'FHEE__EventEspresso_modules_events_archive_EventsArchiveIframe__display__css', |
|
1142 | - '\EventEspresso\modules\events_archive\EventsArchiveIframe::display()', |
|
1143 | - '4.9.14', |
|
1144 | - '5.0.0', |
|
1145 | - 'filter' |
|
1146 | - ); |
|
1147 | - return apply_filters( |
|
1148 | - 'FHEE__EventsArchiveIframe__event_list_iframe__css', |
|
1149 | - $event_list_iframe_css |
|
1150 | - ); |
|
1151 | - } |
|
1134 | + 'FHEE__EventEspresso_modules_events_archive_EventsArchiveIframe__display__css', |
|
1135 | + function ($event_list_iframe_css) { |
|
1136 | + if (! has_filter('FHEE__EventsArchiveIframe__event_list_iframe__css')) { |
|
1137 | + return $event_list_iframe_css; |
|
1138 | + } |
|
1139 | + deprecated_espresso_action_or_filter_doing_it_wrong( |
|
1140 | + 'FHEE__EventsArchiveIframe__event_list_iframe__css', |
|
1141 | + 'FHEE__EventEspresso_modules_events_archive_EventsArchiveIframe__display__css', |
|
1142 | + '\EventEspresso\modules\events_archive\EventsArchiveIframe::display()', |
|
1143 | + '4.9.14', |
|
1144 | + '5.0.0', |
|
1145 | + 'filter' |
|
1146 | + ); |
|
1147 | + return apply_filters( |
|
1148 | + 'FHEE__EventsArchiveIframe__event_list_iframe__css', |
|
1149 | + $event_list_iframe_css |
|
1150 | + ); |
|
1151 | + } |
|
1152 | 1152 | ); |
1153 | 1153 | add_filter( |
1154 | - 'FHEE__EventEspresso_modules_events_archive_EventsArchiveIframe__display__js', |
|
1155 | - function ($event_list_iframe_js) { |
|
1156 | - if (! has_filter('FHEE__EED_Ticket_Selector__ticket_selector_iframe__js')) { |
|
1157 | - return $event_list_iframe_js; |
|
1158 | - } |
|
1159 | - deprecated_espresso_action_or_filter_doing_it_wrong( |
|
1160 | - 'FHEE__EED_Ticket_Selector__ticket_selector_iframe__js', |
|
1161 | - 'FHEE__EventEspresso_modules_events_archive_EventsArchiveIframe__display__js', |
|
1162 | - '\EventEspresso\modules\events_archive\EventsArchiveIframe::display()', |
|
1163 | - '4.9.14', |
|
1164 | - '5.0.0', |
|
1165 | - 'filter' |
|
1166 | - ); |
|
1167 | - return apply_filters( |
|
1168 | - 'FHEE__EED_Ticket_Selector__ticket_selector_iframe__js', |
|
1169 | - $event_list_iframe_js |
|
1170 | - ); |
|
1171 | - } |
|
1154 | + 'FHEE__EventEspresso_modules_events_archive_EventsArchiveIframe__display__js', |
|
1155 | + function ($event_list_iframe_js) { |
|
1156 | + if (! has_filter('FHEE__EED_Ticket_Selector__ticket_selector_iframe__js')) { |
|
1157 | + return $event_list_iframe_js; |
|
1158 | + } |
|
1159 | + deprecated_espresso_action_or_filter_doing_it_wrong( |
|
1160 | + 'FHEE__EED_Ticket_Selector__ticket_selector_iframe__js', |
|
1161 | + 'FHEE__EventEspresso_modules_events_archive_EventsArchiveIframe__display__js', |
|
1162 | + '\EventEspresso\modules\events_archive\EventsArchiveIframe::display()', |
|
1163 | + '4.9.14', |
|
1164 | + '5.0.0', |
|
1165 | + 'filter' |
|
1166 | + ); |
|
1167 | + return apply_filters( |
|
1168 | + 'FHEE__EED_Ticket_Selector__ticket_selector_iframe__js', |
|
1169 | + $event_list_iframe_js |
|
1170 | + ); |
|
1171 | + } |
|
1172 | 1172 | ); |
1173 | 1173 | add_action( |
1174 | - 'AHEE__EE_Capabilities__addCaps__complete', |
|
1175 | - function ($capabilities_map) { |
|
1176 | - if (! has_action('AHEE__EE_Capabilities__init_role_caps__complete')) { |
|
1177 | - return; |
|
1178 | - } |
|
1179 | - deprecated_espresso_action_or_filter_doing_it_wrong( |
|
1180 | - 'AHEE__EE_Capabilities__init_role_caps__complete', |
|
1181 | - 'AHEE__EE_Capabilities__addCaps__complete', |
|
1182 | - '\EE_Capabilities::addCaps()', |
|
1183 | - '4.9.42', |
|
1184 | - '5.0.0' |
|
1185 | - ); |
|
1186 | - do_action( |
|
1187 | - 'AHEE__EE_Capabilities__init_role_caps__complete', |
|
1188 | - $capabilities_map |
|
1189 | - ); |
|
1190 | - } |
|
1174 | + 'AHEE__EE_Capabilities__addCaps__complete', |
|
1175 | + function ($capabilities_map) { |
|
1176 | + if (! has_action('AHEE__EE_Capabilities__init_role_caps__complete')) { |
|
1177 | + return; |
|
1178 | + } |
|
1179 | + deprecated_espresso_action_or_filter_doing_it_wrong( |
|
1180 | + 'AHEE__EE_Capabilities__init_role_caps__complete', |
|
1181 | + 'AHEE__EE_Capabilities__addCaps__complete', |
|
1182 | + '\EE_Capabilities::addCaps()', |
|
1183 | + '4.9.42', |
|
1184 | + '5.0.0' |
|
1185 | + ); |
|
1186 | + do_action( |
|
1187 | + 'AHEE__EE_Capabilities__init_role_caps__complete', |
|
1188 | + $capabilities_map |
|
1189 | + ); |
|
1190 | + } |
|
1191 | 1191 | ); |
1192 | 1192 | |
1193 | 1193 | add_filter( |
1194 | - 'FHEE_EventEspresso_core_services_commands_attendee_CreateAttendeeCommandHandler__findExistingAttendee__existing_attendee', |
|
1195 | - function ($existing_attendee, $registration, $attendee_data) { |
|
1196 | - if (! has_filter('FHEE_EE_Single_Page_Checkout__save_registration_items__find_existing_attendee')) { |
|
1197 | - return $existing_attendee; |
|
1198 | - } |
|
1199 | - deprecated_espresso_action_or_filter_doing_it_wrong( |
|
1200 | - 'FHEE_EE_Single_Page_Checkout__save_registration_items__find_existing_attendee', |
|
1201 | - 'FHEE_EventEspresso_core_services_commands_attendee_CreateAttendeeCommandHandler__findExistingAttendee__existing_attendee', |
|
1202 | - '\EventEspresso\core\services\commands\attendee\CreateAttendeeCommandHandler::findExistingAttendee()', |
|
1203 | - '4.9.34', |
|
1204 | - '5.0.0', |
|
1205 | - 'filter' |
|
1206 | - ); |
|
1207 | - return apply_filters( |
|
1208 | - 'FHEE_EE_Single_Page_Checkout__save_registration_items__find_existing_attendee', |
|
1209 | - $existing_attendee, |
|
1210 | - $registration, |
|
1211 | - $attendee_data |
|
1212 | - ); |
|
1213 | - }, |
|
1214 | - 10, |
|
1215 | - 3 |
|
1194 | + 'FHEE_EventEspresso_core_services_commands_attendee_CreateAttendeeCommandHandler__findExistingAttendee__existing_attendee', |
|
1195 | + function ($existing_attendee, $registration, $attendee_data) { |
|
1196 | + if (! has_filter('FHEE_EE_Single_Page_Checkout__save_registration_items__find_existing_attendee')) { |
|
1197 | + return $existing_attendee; |
|
1198 | + } |
|
1199 | + deprecated_espresso_action_or_filter_doing_it_wrong( |
|
1200 | + 'FHEE_EE_Single_Page_Checkout__save_registration_items__find_existing_attendee', |
|
1201 | + 'FHEE_EventEspresso_core_services_commands_attendee_CreateAttendeeCommandHandler__findExistingAttendee__existing_attendee', |
|
1202 | + '\EventEspresso\core\services\commands\attendee\CreateAttendeeCommandHandler::findExistingAttendee()', |
|
1203 | + '4.9.34', |
|
1204 | + '5.0.0', |
|
1205 | + 'filter' |
|
1206 | + ); |
|
1207 | + return apply_filters( |
|
1208 | + 'FHEE_EE_Single_Page_Checkout__save_registration_items__find_existing_attendee', |
|
1209 | + $existing_attendee, |
|
1210 | + $registration, |
|
1211 | + $attendee_data |
|
1212 | + ); |
|
1213 | + }, |
|
1214 | + 10, |
|
1215 | + 3 |
|
1216 | 1216 | ); |
1217 | 1217 | |
1218 | 1218 | /** |
@@ -1223,88 +1223,88 @@ discard block |
||
1223 | 1223 | class EE_Event_List_Query extends WP_Query |
1224 | 1224 | { |
1225 | 1225 | |
1226 | - private $title; |
|
1227 | - |
|
1228 | - private $css_class; |
|
1229 | - |
|
1230 | - private $category_slug; |
|
1231 | - |
|
1232 | - /** |
|
1233 | - * EE_Event_List_Query constructor. |
|
1234 | - * |
|
1235 | - * @param array $args |
|
1236 | - */ |
|
1237 | - public function __construct($args = array()) |
|
1238 | - { |
|
1239 | - \EE_Error::doing_it_wrong( |
|
1240 | - __METHOD__, |
|
1241 | - __( |
|
1242 | - 'Usage is deprecated. Please use \EventEspresso\core\domain\services\wp_queries\EventListQuery instead.', |
|
1243 | - 'event_espresso' |
|
1244 | - ), |
|
1245 | - '4.9.27', |
|
1246 | - '5.0.0' |
|
1247 | - ); |
|
1248 | - $this->title = isset($args['title']) ? $args['title'] : ''; |
|
1249 | - $this->css_class = isset($args['css_class']) ? $args['css_class'] : ''; |
|
1250 | - $this->category_slug = isset($args['category_slug']) ? $args['category_slug'] : ''; |
|
1251 | - $limit = isset($args['limit']) && absint($args['limit']) ? $args['limit'] : 10; |
|
1252 | - // the current "page" we are viewing |
|
1253 | - $paged = max(1, get_query_var('paged')); |
|
1254 | - // Force these args |
|
1255 | - $args = array_merge( |
|
1256 | - $args, |
|
1257 | - array( |
|
1258 | - 'post_type' => 'espresso_events', |
|
1259 | - 'posts_per_page' => $limit, |
|
1260 | - 'update_post_term_cache' => false, |
|
1261 | - 'update_post_meta_cache' => false, |
|
1262 | - 'paged' => $paged, |
|
1263 | - 'offset' => ($paged - 1) * $limit, |
|
1264 | - ) |
|
1265 | - ); |
|
1266 | - // run the query |
|
1267 | - parent::__construct($args); |
|
1268 | - } |
|
1269 | - |
|
1270 | - |
|
1271 | - /** |
|
1272 | - * event_list_title |
|
1273 | - * |
|
1274 | - * @param string $event_list_title |
|
1275 | - * @return string |
|
1276 | - */ |
|
1277 | - public function event_list_title($event_list_title = '') |
|
1278 | - { |
|
1279 | - if (! empty($this->title)) { |
|
1280 | - return $this->title; |
|
1281 | - } |
|
1282 | - return $event_list_title; |
|
1283 | - } |
|
1284 | - |
|
1285 | - |
|
1286 | - /** |
|
1287 | - * event_list_css |
|
1288 | - * |
|
1289 | - * @param string $event_list_css |
|
1290 | - * @return string |
|
1291 | - */ |
|
1292 | - public function event_list_css($event_list_css = '') |
|
1293 | - { |
|
1294 | - $event_list_css .= ! empty($event_list_css) |
|
1295 | - ? ' ' |
|
1296 | - : ''; |
|
1297 | - $event_list_css .= ! empty($this->css_class) |
|
1298 | - ? $this->css_class |
|
1299 | - : ''; |
|
1300 | - $event_list_css .= ! empty($event_list_css) |
|
1301 | - ? ' ' |
|
1302 | - : ''; |
|
1303 | - $event_list_css .= ! empty($this->category_slug) |
|
1304 | - ? $this->category_slug |
|
1305 | - : ''; |
|
1306 | - return $event_list_css; |
|
1307 | - } |
|
1226 | + private $title; |
|
1227 | + |
|
1228 | + private $css_class; |
|
1229 | + |
|
1230 | + private $category_slug; |
|
1231 | + |
|
1232 | + /** |
|
1233 | + * EE_Event_List_Query constructor. |
|
1234 | + * |
|
1235 | + * @param array $args |
|
1236 | + */ |
|
1237 | + public function __construct($args = array()) |
|
1238 | + { |
|
1239 | + \EE_Error::doing_it_wrong( |
|
1240 | + __METHOD__, |
|
1241 | + __( |
|
1242 | + 'Usage is deprecated. Please use \EventEspresso\core\domain\services\wp_queries\EventListQuery instead.', |
|
1243 | + 'event_espresso' |
|
1244 | + ), |
|
1245 | + '4.9.27', |
|
1246 | + '5.0.0' |
|
1247 | + ); |
|
1248 | + $this->title = isset($args['title']) ? $args['title'] : ''; |
|
1249 | + $this->css_class = isset($args['css_class']) ? $args['css_class'] : ''; |
|
1250 | + $this->category_slug = isset($args['category_slug']) ? $args['category_slug'] : ''; |
|
1251 | + $limit = isset($args['limit']) && absint($args['limit']) ? $args['limit'] : 10; |
|
1252 | + // the current "page" we are viewing |
|
1253 | + $paged = max(1, get_query_var('paged')); |
|
1254 | + // Force these args |
|
1255 | + $args = array_merge( |
|
1256 | + $args, |
|
1257 | + array( |
|
1258 | + 'post_type' => 'espresso_events', |
|
1259 | + 'posts_per_page' => $limit, |
|
1260 | + 'update_post_term_cache' => false, |
|
1261 | + 'update_post_meta_cache' => false, |
|
1262 | + 'paged' => $paged, |
|
1263 | + 'offset' => ($paged - 1) * $limit, |
|
1264 | + ) |
|
1265 | + ); |
|
1266 | + // run the query |
|
1267 | + parent::__construct($args); |
|
1268 | + } |
|
1269 | + |
|
1270 | + |
|
1271 | + /** |
|
1272 | + * event_list_title |
|
1273 | + * |
|
1274 | + * @param string $event_list_title |
|
1275 | + * @return string |
|
1276 | + */ |
|
1277 | + public function event_list_title($event_list_title = '') |
|
1278 | + { |
|
1279 | + if (! empty($this->title)) { |
|
1280 | + return $this->title; |
|
1281 | + } |
|
1282 | + return $event_list_title; |
|
1283 | + } |
|
1284 | + |
|
1285 | + |
|
1286 | + /** |
|
1287 | + * event_list_css |
|
1288 | + * |
|
1289 | + * @param string $event_list_css |
|
1290 | + * @return string |
|
1291 | + */ |
|
1292 | + public function event_list_css($event_list_css = '') |
|
1293 | + { |
|
1294 | + $event_list_css .= ! empty($event_list_css) |
|
1295 | + ? ' ' |
|
1296 | + : ''; |
|
1297 | + $event_list_css .= ! empty($this->css_class) |
|
1298 | + ? $this->css_class |
|
1299 | + : ''; |
|
1300 | + $event_list_css .= ! empty($event_list_css) |
|
1301 | + ? ' ' |
|
1302 | + : ''; |
|
1303 | + $event_list_css .= ! empty($this->category_slug) |
|
1304 | + ? $this->category_slug |
|
1305 | + : ''; |
|
1306 | + return $event_list_css; |
|
1307 | + } |
|
1308 | 1308 | |
1309 | 1309 | } |
1310 | 1310 | |
@@ -1321,75 +1321,75 @@ discard block |
||
1321 | 1321 | { |
1322 | 1322 | |
1323 | 1323 | |
1324 | - /** |
|
1325 | - * class constructor |
|
1326 | - * |
|
1327 | - * @deprecated 4.9.59.p |
|
1328 | - */ |
|
1329 | - public function __construct() |
|
1330 | - { |
|
1331 | - EE_Error::doing_it_wrong( |
|
1332 | - __METHOD__, |
|
1333 | - sprintf( |
|
1334 | - esc_html__('%1$s has been replaced by %2$s.', 'event_espresso'), |
|
1335 | - __CLASS__, |
|
1336 | - 'EventEspresso\core\services\licensing\LicenseServices' |
|
1337 | - ), |
|
1338 | - '4.9.59.p' |
|
1339 | - ); |
|
1340 | - } |
|
1341 | - |
|
1342 | - |
|
1343 | - /** |
|
1344 | - * The purpose of this function is to display information about Event Espresso data collection |
|
1345 | - * and a optin selection for extra data collecting by users. |
|
1346 | - * |
|
1347 | - * @param bool $extra |
|
1348 | - * @return string html. |
|
1349 | - * @deprecated 4.9.59.p |
|
1350 | - */ |
|
1351 | - public static function espresso_data_collection_optin_text($extra = true) |
|
1352 | - { |
|
1353 | - EE_Error::doing_it_wrong( |
|
1354 | - __METHOD__, |
|
1355 | - sprintf( |
|
1356 | - esc_html__('%1$s has been replaced by %2$s.', 'event_espresso'), |
|
1357 | - __METHOD__, |
|
1358 | - 'EventEspresso\core\domain\services\Stats::optinText' |
|
1359 | - ), |
|
1360 | - '4.9.59.p' |
|
1361 | - ); |
|
1362 | - Stats::optinText($extra); |
|
1363 | - } |
|
1364 | - |
|
1365 | - /** |
|
1366 | - * This is a handy helper method for retrieving whether there is an update available for the given plugin. |
|
1367 | - * |
|
1368 | - * @param string $basename Use the equivalent result from plugin_basename() for this param as WP uses that to |
|
1369 | - * identify plugins. Defaults to core update |
|
1370 | - * @return boolean True if update available, false if not. |
|
1371 | - * @deprecated 4.9.59.p |
|
1372 | - */ |
|
1373 | - public static function is_update_available($basename = '') |
|
1374 | - { |
|
1375 | - EE_Error::doing_it_wrong( |
|
1376 | - __METHOD__, |
|
1377 | - sprintf( |
|
1378 | - esc_html__('%1$s has been replaced by %2$s.', 'event_espresso'), |
|
1379 | - __METHOD__, |
|
1380 | - 'EventEspresso\core\services\licensing\LicenseService::isUpdateAvailable' |
|
1381 | - ), |
|
1382 | - '4.9.59.p' |
|
1383 | - ); |
|
1384 | - return LicenseService::isUpdateAvailable($basename); |
|
1385 | - } |
|
1324 | + /** |
|
1325 | + * class constructor |
|
1326 | + * |
|
1327 | + * @deprecated 4.9.59.p |
|
1328 | + */ |
|
1329 | + public function __construct() |
|
1330 | + { |
|
1331 | + EE_Error::doing_it_wrong( |
|
1332 | + __METHOD__, |
|
1333 | + sprintf( |
|
1334 | + esc_html__('%1$s has been replaced by %2$s.', 'event_espresso'), |
|
1335 | + __CLASS__, |
|
1336 | + 'EventEspresso\core\services\licensing\LicenseServices' |
|
1337 | + ), |
|
1338 | + '4.9.59.p' |
|
1339 | + ); |
|
1340 | + } |
|
1341 | + |
|
1342 | + |
|
1343 | + /** |
|
1344 | + * The purpose of this function is to display information about Event Espresso data collection |
|
1345 | + * and a optin selection for extra data collecting by users. |
|
1346 | + * |
|
1347 | + * @param bool $extra |
|
1348 | + * @return string html. |
|
1349 | + * @deprecated 4.9.59.p |
|
1350 | + */ |
|
1351 | + public static function espresso_data_collection_optin_text($extra = true) |
|
1352 | + { |
|
1353 | + EE_Error::doing_it_wrong( |
|
1354 | + __METHOD__, |
|
1355 | + sprintf( |
|
1356 | + esc_html__('%1$s has been replaced by %2$s.', 'event_espresso'), |
|
1357 | + __METHOD__, |
|
1358 | + 'EventEspresso\core\domain\services\Stats::optinText' |
|
1359 | + ), |
|
1360 | + '4.9.59.p' |
|
1361 | + ); |
|
1362 | + Stats::optinText($extra); |
|
1363 | + } |
|
1364 | + |
|
1365 | + /** |
|
1366 | + * This is a handy helper method for retrieving whether there is an update available for the given plugin. |
|
1367 | + * |
|
1368 | + * @param string $basename Use the equivalent result from plugin_basename() for this param as WP uses that to |
|
1369 | + * identify plugins. Defaults to core update |
|
1370 | + * @return boolean True if update available, false if not. |
|
1371 | + * @deprecated 4.9.59.p |
|
1372 | + */ |
|
1373 | + public static function is_update_available($basename = '') |
|
1374 | + { |
|
1375 | + EE_Error::doing_it_wrong( |
|
1376 | + __METHOD__, |
|
1377 | + sprintf( |
|
1378 | + esc_html__('%1$s has been replaced by %2$s.', 'event_espresso'), |
|
1379 | + __METHOD__, |
|
1380 | + 'EventEspresso\core\services\licensing\LicenseService::isUpdateAvailable' |
|
1381 | + ), |
|
1382 | + '4.9.59.p' |
|
1383 | + ); |
|
1384 | + return LicenseService::isUpdateAvailable($basename); |
|
1385 | + } |
|
1386 | 1386 | } |
1387 | 1387 | |
1388 | 1388 | add_filter( |
1389 | - 'FHEE__EventEspressoBatchRequest__JobHandlers__RegistrationsReport__reg_csv_array', |
|
1390 | - 'ee_deprecated_registrations_report_csv_legacy_fields', |
|
1391 | - 10, |
|
1392 | - 2 |
|
1389 | + 'FHEE__EventEspressoBatchRequest__JobHandlers__RegistrationsReport__reg_csv_array', |
|
1390 | + 'ee_deprecated_registrations_report_csv_legacy_fields', |
|
1391 | + 10, |
|
1392 | + 2 |
|
1393 | 1393 | ); |
1394 | 1394 | /** |
1395 | 1395 | * Filters the CSV row to make it appear like the old labels (which were "$pretty_name[$field_name]"). |
@@ -1406,96 +1406,96 @@ discard block |
||
1406 | 1406 | */ |
1407 | 1407 | function ee_deprecated_registrations_report_csv_legacy_fields($csv_row_data, $reg_row) |
1408 | 1408 | { |
1409 | - // no need for all this if nobody is using the deprecated filter |
|
1410 | - if (has_filter('FHEE__EE_Export__report_registrations__reg_csv_array')) { |
|
1411 | - EE_Error::doing_it_wrong( |
|
1412 | - __FUNCTION__, |
|
1413 | - sprintf( |
|
1414 | - // EE_Error::doing_it_wrong with escape HTML, so don't escape it twice by doing it here too. |
|
1415 | - _x( |
|
1416 | - 'The filter "%1$s" has been deprecated. Please use "%2$s" instead.', |
|
1417 | - 'The filter "FHEE__EE_Export__report_registrations__reg_csv_array" has been deprecated. Please use "FHEE__EventEspressoBatchRequest__JobHandlers__RegistrationsReport__reg_csv_array" instead.', |
|
1418 | - 'event_espresso' |
|
1419 | - ), |
|
1420 | - 'FHEE__EE_Export__report_registrations__reg_csv_array', |
|
1421 | - 'FHEE__EventEspressoBatchRequest__JobHandlers__RegistrationsReport__reg_csv_array' |
|
1422 | - ), |
|
1423 | - '4.9.69.p', |
|
1424 | - '4.9.75.p' |
|
1425 | - ); |
|
1426 | - // there's code that expected the old csv column headers/labels. Let's oblige. Put it back in the old format! |
|
1427 | - // first: what model fields might be used as column headers? (whose format we need to change) |
|
1428 | - $model_fields = array_merge( |
|
1429 | - EEM_Registration::instance()->field_settings(), |
|
1430 | - EEM_Attendee::instance()->field_settings() |
|
1431 | - ); |
|
1432 | - // create an array that uses the legacy column headers/labels. |
|
1433 | - $new_csv_row = array(); |
|
1434 | - foreach ($csv_row_data as $label => $value) { |
|
1435 | - $new_label = $label; |
|
1436 | - foreach ($model_fields as $field) { |
|
1437 | - if ($label === EEH_Export::get_column_name_for_field($field)) { |
|
1438 | - // re-add the old field name |
|
1439 | - $new_label = $label . '[' . $field->get_name() . ']'; |
|
1440 | - break; |
|
1441 | - } |
|
1442 | - } |
|
1443 | - $new_csv_row[$new_label] = $value; |
|
1444 | - } |
|
1445 | - // before we run it through the deprecated filter, set the method `EEH_Export::get_column_name_for_field()` |
|
1446 | - // to create the old column names, because that's what's in the row temporarily |
|
1447 | - add_filter( |
|
1448 | - 'FHEE__EEH_Export__get_column_name_for_field__add_field_name', |
|
1449 | - '__return_true', |
|
1450 | - 777 |
|
1451 | - ); |
|
1452 | - // now, those old filters can be run on this data. Have fun! |
|
1453 | - /** |
|
1454 | - * Deprecated. Use FHEE__EventEspressoBatchRequest__JobHandlers__RegistrationsReport__reg_csv_array instead. |
|
1455 | - * |
|
1456 | - * Filter to change the contents of each row of the registrations report CSV file. |
|
1457 | - * This can be used to add or remote columns from the CSV file, or change their values. * |
|
1458 | - * Note: it has this name because originally that's where this filter resided, |
|
1459 | - * and we've left its name as-is for backward compatibility. |
|
1460 | - * Note when using: all rows in the CSV should have the same columns. |
|
1461 | - * |
|
1462 | - * @param array $reg_csv_array keys are column-header names, and values are that columns' value |
|
1463 | - * in this row |
|
1464 | - * @param array $reg_row is the row from the database's wp_esp_registration table |
|
1465 | - */ |
|
1466 | - $updated_row = apply_filters( |
|
1467 | - 'FHEE__EE_Export__report_registrations__reg_csv_array', |
|
1468 | - $new_csv_row, |
|
1469 | - $reg_row |
|
1470 | - ); |
|
1471 | - |
|
1472 | - // ok now we can revert to normal for EEH_Export::get_column_name_for_field(). |
|
1473 | - remove_filter( |
|
1474 | - 'FHEE__EEH_Export__get_column_name_for_field__add_field_name', |
|
1475 | - '__return_true', |
|
1476 | - 777 |
|
1477 | - ); |
|
1478 | - |
|
1479 | - // great. Now that the old filters are done, we can remove the ugly square brackets from column headers/labels. |
|
1480 | - $updated_and_restored_row = array(); |
|
1481 | - foreach ($updated_row as $label => $value) { |
|
1482 | - $matches = array(); |
|
1483 | - if (preg_match( |
|
1484 | - '~([^\[]*)\[(.*)\]~', |
|
1485 | - $label, |
|
1486 | - $matches |
|
1487 | - ) |
|
1488 | - && isset( |
|
1489 | - $matches[0], |
|
1490 | - $matches[1], |
|
1491 | - $matches[2] |
|
1492 | - ) |
|
1493 | - ) { |
|
1494 | - $label = $matches[1]; |
|
1495 | - } |
|
1496 | - $updated_and_restored_row[$label] = $value; |
|
1497 | - } |
|
1498 | - $csv_row_data = $updated_and_restored_row; |
|
1499 | - } |
|
1500 | - return $csv_row_data; |
|
1409 | + // no need for all this if nobody is using the deprecated filter |
|
1410 | + if (has_filter('FHEE__EE_Export__report_registrations__reg_csv_array')) { |
|
1411 | + EE_Error::doing_it_wrong( |
|
1412 | + __FUNCTION__, |
|
1413 | + sprintf( |
|
1414 | + // EE_Error::doing_it_wrong with escape HTML, so don't escape it twice by doing it here too. |
|
1415 | + _x( |
|
1416 | + 'The filter "%1$s" has been deprecated. Please use "%2$s" instead.', |
|
1417 | + 'The filter "FHEE__EE_Export__report_registrations__reg_csv_array" has been deprecated. Please use "FHEE__EventEspressoBatchRequest__JobHandlers__RegistrationsReport__reg_csv_array" instead.', |
|
1418 | + 'event_espresso' |
|
1419 | + ), |
|
1420 | + 'FHEE__EE_Export__report_registrations__reg_csv_array', |
|
1421 | + 'FHEE__EventEspressoBatchRequest__JobHandlers__RegistrationsReport__reg_csv_array' |
|
1422 | + ), |
|
1423 | + '4.9.69.p', |
|
1424 | + '4.9.75.p' |
|
1425 | + ); |
|
1426 | + // there's code that expected the old csv column headers/labels. Let's oblige. Put it back in the old format! |
|
1427 | + // first: what model fields might be used as column headers? (whose format we need to change) |
|
1428 | + $model_fields = array_merge( |
|
1429 | + EEM_Registration::instance()->field_settings(), |
|
1430 | + EEM_Attendee::instance()->field_settings() |
|
1431 | + ); |
|
1432 | + // create an array that uses the legacy column headers/labels. |
|
1433 | + $new_csv_row = array(); |
|
1434 | + foreach ($csv_row_data as $label => $value) { |
|
1435 | + $new_label = $label; |
|
1436 | + foreach ($model_fields as $field) { |
|
1437 | + if ($label === EEH_Export::get_column_name_for_field($field)) { |
|
1438 | + // re-add the old field name |
|
1439 | + $new_label = $label . '[' . $field->get_name() . ']'; |
|
1440 | + break; |
|
1441 | + } |
|
1442 | + } |
|
1443 | + $new_csv_row[$new_label] = $value; |
|
1444 | + } |
|
1445 | + // before we run it through the deprecated filter, set the method `EEH_Export::get_column_name_for_field()` |
|
1446 | + // to create the old column names, because that's what's in the row temporarily |
|
1447 | + add_filter( |
|
1448 | + 'FHEE__EEH_Export__get_column_name_for_field__add_field_name', |
|
1449 | + '__return_true', |
|
1450 | + 777 |
|
1451 | + ); |
|
1452 | + // now, those old filters can be run on this data. Have fun! |
|
1453 | + /** |
|
1454 | + * Deprecated. Use FHEE__EventEspressoBatchRequest__JobHandlers__RegistrationsReport__reg_csv_array instead. |
|
1455 | + * |
|
1456 | + * Filter to change the contents of each row of the registrations report CSV file. |
|
1457 | + * This can be used to add or remote columns from the CSV file, or change their values. * |
|
1458 | + * Note: it has this name because originally that's where this filter resided, |
|
1459 | + * and we've left its name as-is for backward compatibility. |
|
1460 | + * Note when using: all rows in the CSV should have the same columns. |
|
1461 | + * |
|
1462 | + * @param array $reg_csv_array keys are column-header names, and values are that columns' value |
|
1463 | + * in this row |
|
1464 | + * @param array $reg_row is the row from the database's wp_esp_registration table |
|
1465 | + */ |
|
1466 | + $updated_row = apply_filters( |
|
1467 | + 'FHEE__EE_Export__report_registrations__reg_csv_array', |
|
1468 | + $new_csv_row, |
|
1469 | + $reg_row |
|
1470 | + ); |
|
1471 | + |
|
1472 | + // ok now we can revert to normal for EEH_Export::get_column_name_for_field(). |
|
1473 | + remove_filter( |
|
1474 | + 'FHEE__EEH_Export__get_column_name_for_field__add_field_name', |
|
1475 | + '__return_true', |
|
1476 | + 777 |
|
1477 | + ); |
|
1478 | + |
|
1479 | + // great. Now that the old filters are done, we can remove the ugly square brackets from column headers/labels. |
|
1480 | + $updated_and_restored_row = array(); |
|
1481 | + foreach ($updated_row as $label => $value) { |
|
1482 | + $matches = array(); |
|
1483 | + if (preg_match( |
|
1484 | + '~([^\[]*)\[(.*)\]~', |
|
1485 | + $label, |
|
1486 | + $matches |
|
1487 | + ) |
|
1488 | + && isset( |
|
1489 | + $matches[0], |
|
1490 | + $matches[1], |
|
1491 | + $matches[2] |
|
1492 | + ) |
|
1493 | + ) { |
|
1494 | + $label = $matches[1]; |
|
1495 | + } |
|
1496 | + $updated_and_restored_row[$label] = $value; |
|
1497 | + } |
|
1498 | + $csv_row_data = $updated_and_restored_row; |
|
1499 | + } |
|
1500 | + return $csv_row_data; |
|
1501 | 1501 | } |
1502 | 1502 | \ No newline at end of file |