@@ -196,11 +196,11 @@ discard block |
||
196 | 196 | ! empty($messenger) |
197 | 197 | && $Message_Resource_Manager->is_message_type_active_for_messenger($messenger, $this->name) |
198 | 198 | ) { |
199 | - $settings_to_use = $active_messengers[ $messenger ]['settings'][ $messenger . '-message_types' ]; |
|
199 | + $settings_to_use = $active_messengers[$messenger]['settings'][$messenger.'-message_types']; |
|
200 | 200 | } |
201 | 201 | |
202 | - $this->_existing_admin_settings = isset($settings_to_use[ $this->name ]['settings']) |
|
203 | - ? $settings_to_use[ $this->name ]['settings'] |
|
202 | + $this->_existing_admin_settings = isset($settings_to_use[$this->name]['settings']) |
|
203 | + ? $settings_to_use[$this->name]['settings'] |
|
204 | 204 | : null; |
205 | 205 | } |
206 | 206 | |
@@ -240,7 +240,7 @@ discard block |
||
240 | 240 | public function get_valid_shortcodes() |
241 | 241 | { |
242 | 242 | $valid_shortcodes = apply_filters( |
243 | - 'FHEE__' . get_class($this) . '__get_valid_shortcodes', |
|
243 | + 'FHEE__'.get_class($this).'__get_valid_shortcodes', |
|
244 | 244 | $this->_valid_shortcodes, |
245 | 245 | $this |
246 | 246 | ); |
@@ -283,19 +283,19 @@ discard block |
||
283 | 283 | protected function _get_admin_page_content($page, $action, $extra, $actives) |
284 | 284 | { |
285 | 285 | // we can also further refine the context by action (if present). |
286 | - if (!empty($action)) { |
|
287 | - $page = $page . '_' . $action; |
|
286 | + if ( ! empty($action)) { |
|
287 | + $page = $page.'_'.$action; |
|
288 | 288 | } |
289 | 289 | |
290 | - if (!isset($this->admin_registered_pages[ $page ])) { |
|
290 | + if ( ! isset($this->admin_registered_pages[$page])) { |
|
291 | 291 | // todo: a place to throw an exception? |
292 | 292 | // We need to indicate there is no registered page so this function is not being called correctly. |
293 | 293 | return false; |
294 | 294 | } |
295 | 295 | // k made it here so let's call the method |
296 | 296 | $content = call_user_func_array( |
297 | - array( $this, '_get_admin_content_' . $page ), |
|
298 | - array( $actives, $extra ) |
|
297 | + array($this, '_get_admin_content_'.$page), |
|
298 | + array($actives, $extra) |
|
299 | 299 | ); |
300 | 300 | if ($content === false) { |
301 | 301 | // todo this needs to be an exception once we've got exceptions in place. |
@@ -13,44 +13,44 @@ discard block |
||
13 | 13 | */ |
14 | 14 | abstract class EE_Messages_Base extends EE_Base |
15 | 15 | { |
16 | - /** DETAILS PROPERTIES **/ |
|
17 | - /** |
|
18 | - * The following are used to hold details on the type for reference (i.e. on admin screens) |
|
19 | - * and also used by the EE_message_type object to figure out where to get template data. |
|
20 | - */ |
|
21 | - public $name; |
|
22 | - public $description; |
|
23 | - protected $_messages_item_type; // messenger OR message_type? |
|
24 | - |
|
25 | - |
|
26 | - /** |
|
27 | - * This is an array describing the ui facing labels |
|
28 | - * that will be used whenever the messenger is referenced in the ui |
|
29 | - * |
|
30 | - * array( |
|
31 | - * 'singular' => esc_html__('something'), |
|
32 | - * 'plural' => esc_html__('somethings') |
|
33 | - * ) |
|
34 | - * |
|
35 | - * @var array |
|
36 | - */ |
|
37 | - public $label; |
|
38 | - |
|
39 | - |
|
40 | - |
|
41 | - |
|
42 | - /** |
|
43 | - * This property when set will hold the slugs of all EE admin pages that we will need to retrieve fields for |
|
44 | - * (and used to determine which callback method to call from the child class) |
|
45 | - * |
|
46 | - * structure should be |
|
47 | - * array( |
|
48 | - * 'page_action' => true |
|
49 | - * ) |
|
50 | - * |
|
16 | + /** DETAILS PROPERTIES **/ |
|
17 | + /** |
|
18 | + * The following are used to hold details on the type for reference (i.e. on admin screens) |
|
19 | + * and also used by the EE_message_type object to figure out where to get template data. |
|
20 | + */ |
|
21 | + public $name; |
|
22 | + public $description; |
|
23 | + protected $_messages_item_type; // messenger OR message_type? |
|
24 | + |
|
25 | + |
|
26 | + /** |
|
27 | + * This is an array describing the ui facing labels |
|
28 | + * that will be used whenever the messenger is referenced in the ui |
|
29 | + * |
|
30 | + * array( |
|
31 | + * 'singular' => esc_html__('something'), |
|
32 | + * 'plural' => esc_html__('somethings') |
|
33 | + * ) |
|
34 | + * |
|
35 | + * @var array |
|
36 | + */ |
|
37 | + public $label; |
|
38 | + |
|
39 | + |
|
40 | + |
|
41 | + |
|
42 | + /** |
|
43 | + * This property when set will hold the slugs of all EE admin pages that we will need to retrieve fields for |
|
44 | + * (and used to determine which callback method to call from the child class) |
|
45 | + * |
|
46 | + * structure should be |
|
47 | + * array( |
|
48 | + * 'page_action' => true |
|
49 | + * ) |
|
50 | + * |
|
51 | 51 | *@var array |
52 | - */ |
|
53 | - public $admin_registered_pages = array(); |
|
52 | + */ |
|
53 | + public $admin_registered_pages = array(); |
|
54 | 54 | |
55 | 55 | |
56 | 56 | |
@@ -59,265 +59,265 @@ discard block |
||
59 | 59 | |
60 | 60 | |
61 | 61 | |
62 | - /** |
|
63 | - * this property holds any specific fields for holding any settings related to a messenger (if any needed) |
|
64 | - * @var array |
|
65 | - */ |
|
66 | - protected $_admin_settings_fields = array(); |
|
62 | + /** |
|
63 | + * this property holds any specific fields for holding any settings related to a messenger (if any needed) |
|
64 | + * @var array |
|
65 | + */ |
|
66 | + protected $_admin_settings_fields = array(); |
|
67 | 67 | |
68 | 68 | |
69 | 69 | |
70 | 70 | |
71 | 71 | |
72 | - /** |
|
73 | - * this property will hold any existing settings that may have been set in the admin. |
|
74 | - * @var array |
|
75 | - */ |
|
76 | - protected $_existing_admin_settings = array(); |
|
72 | + /** |
|
73 | + * this property will hold any existing settings that may have been set in the admin. |
|
74 | + * @var array |
|
75 | + */ |
|
76 | + protected $_existing_admin_settings = array(); |
|
77 | 77 | |
78 | 78 | |
79 | 79 | |
80 | 80 | |
81 | 81 | |
82 | - /** |
|
83 | - * this property will hold an array of valid shortcodes for this message type and messengers. |
|
84 | - * #For Message Types: |
|
85 | - * This is an array of strings that correspond to defined EE_Shortcode libraries and per context. |
|
86 | - * For example: |
|
87 | - * array( 'admin' => array('transaction', 'event', 'attendee') ) |
|
88 | - * corresponds to 'EE_Transaction_Shortcodes.lib.php, EE_Event_Shortcodes.lib.php, EE_Attendee_Shortcodes.lib.php' |
|
89 | - * for the admin context; |
|
90 | - * |
|
91 | - * |
|
92 | - * #For Messengers: |
|
93 | - * For example: |
|
94 | - * array('subject' => array('transaction', 'event', 'attendee')) |
|
95 | - * corresponds to 'EE_Transaction_Shortcodes.lib.php, EE_Event_Shortcodes.lib.php, EE_Attendee_Shortcodes.lib.php' |
|
96 | - * for the 'subject' field; |
|
97 | - * NOTE: by default, with messengers, if the valid shortcodes for a field is left blank, |
|
98 | - * that field will inherit whatever are set as valid shortcodes by message_type. |
|
99 | - * This is so messenger can set specific valid codes for fields and leave other |
|
100 | - * valid shortcodes up to the message type matched with the messenger. |
|
101 | - * |
|
102 | - * @access protected |
|
103 | - * @var array |
|
104 | - */ |
|
105 | - protected $_valid_shortcodes = array(); |
|
82 | + /** |
|
83 | + * this property will hold an array of valid shortcodes for this message type and messengers. |
|
84 | + * #For Message Types: |
|
85 | + * This is an array of strings that correspond to defined EE_Shortcode libraries and per context. |
|
86 | + * For example: |
|
87 | + * array( 'admin' => array('transaction', 'event', 'attendee') ) |
|
88 | + * corresponds to 'EE_Transaction_Shortcodes.lib.php, EE_Event_Shortcodes.lib.php, EE_Attendee_Shortcodes.lib.php' |
|
89 | + * for the admin context; |
|
90 | + * |
|
91 | + * |
|
92 | + * #For Messengers: |
|
93 | + * For example: |
|
94 | + * array('subject' => array('transaction', 'event', 'attendee')) |
|
95 | + * corresponds to 'EE_Transaction_Shortcodes.lib.php, EE_Event_Shortcodes.lib.php, EE_Attendee_Shortcodes.lib.php' |
|
96 | + * for the 'subject' field; |
|
97 | + * NOTE: by default, with messengers, if the valid shortcodes for a field is left blank, |
|
98 | + * that field will inherit whatever are set as valid shortcodes by message_type. |
|
99 | + * This is so messenger can set specific valid codes for fields and leave other |
|
100 | + * valid shortcodes up to the message type matched with the messenger. |
|
101 | + * |
|
102 | + * @access protected |
|
103 | + * @var array |
|
104 | + */ |
|
105 | + protected $_valid_shortcodes = array(); |
|
106 | 106 | |
107 | 107 | |
108 | 108 | |
109 | 109 | |
110 | 110 | |
111 | - public function __construct() |
|
112 | - { |
|
113 | - $this->_set_admin_settings_fields(); |
|
114 | - $this->_set_valid_shortcodes(); |
|
115 | - $this->_set_admin_pages(); |
|
116 | - } |
|
111 | + public function __construct() |
|
112 | + { |
|
113 | + $this->_set_admin_settings_fields(); |
|
114 | + $this->_set_valid_shortcodes(); |
|
115 | + $this->_set_admin_pages(); |
|
116 | + } |
|
117 | 117 | |
118 | 118 | |
119 | 119 | |
120 | 120 | |
121 | 121 | |
122 | - /** |
|
123 | - * sets the _admin_settings_fields property which needs to be defined by child classes. |
|
124 | - * You will want to set the _admin_settings_fields properties as a multi-dimensional array with the following format |
|
125 | - * array( |
|
126 | - * {field_name - also used for setting index} => array( |
|
127 | - * 'field_type' => {type of field: 'text', 'textarea', 'checkbox'}, |
|
128 | - * 'value_type' => {type of value: 'string', 'int', 'array', 'bool'}, |
|
129 | - * 'required' => {bool, required or not}, |
|
130 | - * 'validation' => {bool, true if we want validation, false if not}, |
|
131 | - * 'format' => {%d, or %s}, |
|
132 | - * 'label' => {label for the field, make sure it's localized}, |
|
133 | - * 'default' => {default value for the setting} |
|
134 | - * ), |
|
135 | - * ); |
|
136 | - * |
|
137 | - * @abstract |
|
138 | - * @access protected |
|
139 | - * @return void |
|
140 | - */ |
|
141 | - abstract protected function _set_admin_settings_fields(); |
|
122 | + /** |
|
123 | + * sets the _admin_settings_fields property which needs to be defined by child classes. |
|
124 | + * You will want to set the _admin_settings_fields properties as a multi-dimensional array with the following format |
|
125 | + * array( |
|
126 | + * {field_name - also used for setting index} => array( |
|
127 | + * 'field_type' => {type of field: 'text', 'textarea', 'checkbox'}, |
|
128 | + * 'value_type' => {type of value: 'string', 'int', 'array', 'bool'}, |
|
129 | + * 'required' => {bool, required or not}, |
|
130 | + * 'validation' => {bool, true if we want validation, false if not}, |
|
131 | + * 'format' => {%d, or %s}, |
|
132 | + * 'label' => {label for the field, make sure it's localized}, |
|
133 | + * 'default' => {default value for the setting} |
|
134 | + * ), |
|
135 | + * ); |
|
136 | + * |
|
137 | + * @abstract |
|
138 | + * @access protected |
|
139 | + * @return void |
|
140 | + */ |
|
141 | + abstract protected function _set_admin_settings_fields(); |
|
142 | 142 | |
143 | 143 | |
144 | 144 | |
145 | 145 | |
146 | 146 | |
147 | - /** |
|
148 | - * sets any properties on whether a message type or messenger interface shows up on a ee administration page. |
|
149 | - * Child classes have to define this method but don't necessarily have to set the flags |
|
150 | - * as they will be set to false by default. |
|
151 | - * |
|
152 | - * Child classes use this method to set the `_admin_registered_page` property. |
|
153 | - * That property is to indicate what EE admin pages we have a corresponding callback for in the child class |
|
154 | - * so Message Type/messenger fields/content is included on that admin page. |
|
155 | - * |
|
156 | - * @abstract |
|
157 | - * @access protected |
|
158 | - * @return void |
|
159 | - */ |
|
160 | - abstract protected function _set_admin_pages(); |
|
147 | + /** |
|
148 | + * sets any properties on whether a message type or messenger interface shows up on a ee administration page. |
|
149 | + * Child classes have to define this method but don't necessarily have to set the flags |
|
150 | + * as they will be set to false by default. |
|
151 | + * |
|
152 | + * Child classes use this method to set the `_admin_registered_page` property. |
|
153 | + * That property is to indicate what EE admin pages we have a corresponding callback for in the child class |
|
154 | + * so Message Type/messenger fields/content is included on that admin page. |
|
155 | + * |
|
156 | + * @abstract |
|
157 | + * @access protected |
|
158 | + * @return void |
|
159 | + */ |
|
160 | + abstract protected function _set_admin_pages(); |
|
161 | 161 | |
162 | 162 | |
163 | 163 | |
164 | 164 | |
165 | 165 | |
166 | - /** |
|
167 | - * Child classes must declare the $_valid_shortcodes property using this method. |
|
168 | - * See comments for $_valid_shortcodes property for details on what it is used for. |
|
169 | - * |
|
170 | - * @access protected |
|
171 | - * @return void |
|
172 | - */ |
|
173 | - abstract protected function _set_valid_shortcodes(); |
|
166 | + /** |
|
167 | + * Child classes must declare the $_valid_shortcodes property using this method. |
|
168 | + * See comments for $_valid_shortcodes property for details on what it is used for. |
|
169 | + * |
|
170 | + * @access protected |
|
171 | + * @return void |
|
172 | + */ |
|
173 | + abstract protected function _set_valid_shortcodes(); |
|
174 | 174 | |
175 | 175 | |
176 | 176 | |
177 | - /** |
|
178 | - * sets the _existing_admin_settings property can be overridden by child classes. |
|
179 | - * We do this so we only do database calls if needed. |
|
180 | - * |
|
181 | - * @access protected |
|
182 | - * @param string $messenger |
|
183 | - */ |
|
184 | - protected function _set_existing_admin_settings($messenger = '') |
|
185 | - { |
|
186 | - /** @var EE_Message_Resource_Manager $Message_Resource_Manager */ |
|
187 | - $Message_Resource_Manager = EE_Registry::instance()->load_lib('Message_Resource_Manager'); |
|
188 | - $active_messengers = $Message_Resource_Manager->get_active_messengers_option(); |
|
189 | - $settings_to_use = $active_messengers; |
|
190 | - |
|
191 | - /** |
|
192 | - * This determines what will be used for the getting the settings. |
|
193 | - */ |
|
194 | - if ( |
|
195 | - ! empty($messenger) |
|
196 | - && $Message_Resource_Manager->is_message_type_active_for_messenger($messenger, $this->name) |
|
197 | - ) { |
|
198 | - $settings_to_use = $active_messengers[ $messenger ]['settings'][ $messenger . '-message_types' ]; |
|
199 | - } |
|
200 | - |
|
201 | - $this->_existing_admin_settings = isset($settings_to_use[ $this->name ]['settings']) |
|
202 | - ? $settings_to_use[ $this->name ]['settings'] |
|
203 | - : null; |
|
204 | - } |
|
205 | - |
|
206 | - |
|
207 | - |
|
208 | - |
|
209 | - |
|
210 | - |
|
211 | - /** |
|
212 | - * get_existing_admin_settings |
|
213 | - * (if needed) sets and returns the _existing_admin_settings property. |
|
214 | - * |
|
215 | - * @access public |
|
216 | - * @param string $messenger |
|
217 | - * @return array settings |
|
218 | - */ |
|
219 | - public function get_existing_admin_settings($messenger = '') |
|
220 | - { |
|
221 | - // if admin_settings property empty lets try setting it. |
|
222 | - if (method_exists($this, '_set_existing_admin_settings') && empty($this->_existing_admin_settings)) { |
|
223 | - $this->_set_existing_admin_settings($messenger); |
|
224 | - } |
|
225 | - return property_exists($this, '_existing_admin_settings') |
|
226 | - ? $this->_existing_admin_settings |
|
227 | - : null; |
|
228 | - } |
|
229 | - |
|
230 | - |
|
231 | - |
|
232 | - |
|
233 | - |
|
234 | - |
|
235 | - /** |
|
236 | - * This returns the array of valid shortcodes for a message type or messenger as set by the child in the $_valid_shortcode property. |
|
237 | - * @return array an array of valid shortcodes. |
|
238 | - */ |
|
239 | - public function get_valid_shortcodes() |
|
240 | - { |
|
241 | - $valid_shortcodes = apply_filters( |
|
242 | - 'FHEE__' . get_class($this) . '__get_valid_shortcodes', |
|
243 | - $this->_valid_shortcodes, |
|
244 | - $this |
|
245 | - ); |
|
246 | - // The below filter applies to ALL messengers and message types so use with care! |
|
247 | - $valid_shortcodes = apply_filters('FHEE__EE_Messages_Base__get_valid_shortcodes', $valid_shortcodes, $this); |
|
248 | - return $valid_shortcodes; |
|
249 | - } |
|
250 | - |
|
251 | - |
|
252 | - |
|
253 | - |
|
254 | - /** |
|
255 | - * getter that returns the protected admin_settings_fields property |
|
256 | - * |
|
257 | - * @access public |
|
258 | - * @return array admin settings fields |
|
259 | - */ |
|
260 | - public function get_admin_settings_fields() |
|
261 | - { |
|
262 | - return $this->_admin_settings_fields; |
|
263 | - } |
|
264 | - |
|
265 | - |
|
266 | - |
|
267 | - |
|
268 | - |
|
269 | - /** |
|
270 | - * this public method accepts a page slug (for an EE_admin page) |
|
271 | - * and will return the response from the child class callback function |
|
272 | - * if that page is registered via the `_admin_registered_page` property set by the child class. |
|
273 | - * |
|
274 | - * @param string $page the slug of the EE admin page |
|
275 | - * @param array $actives an array of active message type (or messenger) objects. |
|
276 | - * @param string $action the page action (to allow for more specific handling - i.e. edit vs. add pages) |
|
277 | - * @param array $extra This is just an extra argument that can be used |
|
278 | - * to pass additional data for setting up page content. |
|
279 | - * @access protected |
|
280 | - * @return string $content for page. |
|
281 | - */ |
|
282 | - protected function _get_admin_page_content($page, $action, $extra, $actives) |
|
283 | - { |
|
284 | - // we can also further refine the context by action (if present). |
|
285 | - if (!empty($action)) { |
|
286 | - $page = $page . '_' . $action; |
|
287 | - } |
|
288 | - |
|
289 | - if (!isset($this->admin_registered_pages[ $page ])) { |
|
290 | - // todo: a place to throw an exception? |
|
291 | - // We need to indicate there is no registered page so this function is not being called correctly. |
|
292 | - return false; |
|
293 | - } |
|
294 | - // k made it here so let's call the method |
|
295 | - $content = call_user_func_array( |
|
296 | - array( $this, '_get_admin_content_' . $page ), |
|
297 | - array( $actives, $extra ) |
|
298 | - ); |
|
299 | - if ($content === false) { |
|
300 | - // todo this needs to be an exception once we've got exceptions in place. |
|
301 | - return false; |
|
302 | - } |
|
303 | - return $content; |
|
304 | - } |
|
305 | - |
|
306 | - |
|
307 | - /** |
|
308 | - * Allows a message type to specifically exclude template fields for the provided messenger. |
|
309 | - * Filtered so this can be programmatically altered as well. |
|
310 | - * @param string $messenger_name name of messenger |
|
311 | - * @return array |
|
312 | - */ |
|
313 | - public function excludedFieldsForMessenger($messenger_name) |
|
314 | - { |
|
315 | - return apply_filters( |
|
316 | - 'FHEE__EE_Messages_Base__excludedFieldForMessenger', |
|
317 | - array(), |
|
318 | - $messenger_name, |
|
319 | - $this->name, |
|
320 | - $this |
|
321 | - ); |
|
322 | - } |
|
177 | + /** |
|
178 | + * sets the _existing_admin_settings property can be overridden by child classes. |
|
179 | + * We do this so we only do database calls if needed. |
|
180 | + * |
|
181 | + * @access protected |
|
182 | + * @param string $messenger |
|
183 | + */ |
|
184 | + protected function _set_existing_admin_settings($messenger = '') |
|
185 | + { |
|
186 | + /** @var EE_Message_Resource_Manager $Message_Resource_Manager */ |
|
187 | + $Message_Resource_Manager = EE_Registry::instance()->load_lib('Message_Resource_Manager'); |
|
188 | + $active_messengers = $Message_Resource_Manager->get_active_messengers_option(); |
|
189 | + $settings_to_use = $active_messengers; |
|
190 | + |
|
191 | + /** |
|
192 | + * This determines what will be used for the getting the settings. |
|
193 | + */ |
|
194 | + if ( |
|
195 | + ! empty($messenger) |
|
196 | + && $Message_Resource_Manager->is_message_type_active_for_messenger($messenger, $this->name) |
|
197 | + ) { |
|
198 | + $settings_to_use = $active_messengers[ $messenger ]['settings'][ $messenger . '-message_types' ]; |
|
199 | + } |
|
200 | + |
|
201 | + $this->_existing_admin_settings = isset($settings_to_use[ $this->name ]['settings']) |
|
202 | + ? $settings_to_use[ $this->name ]['settings'] |
|
203 | + : null; |
|
204 | + } |
|
205 | + |
|
206 | + |
|
207 | + |
|
208 | + |
|
209 | + |
|
210 | + |
|
211 | + /** |
|
212 | + * get_existing_admin_settings |
|
213 | + * (if needed) sets and returns the _existing_admin_settings property. |
|
214 | + * |
|
215 | + * @access public |
|
216 | + * @param string $messenger |
|
217 | + * @return array settings |
|
218 | + */ |
|
219 | + public function get_existing_admin_settings($messenger = '') |
|
220 | + { |
|
221 | + // if admin_settings property empty lets try setting it. |
|
222 | + if (method_exists($this, '_set_existing_admin_settings') && empty($this->_existing_admin_settings)) { |
|
223 | + $this->_set_existing_admin_settings($messenger); |
|
224 | + } |
|
225 | + return property_exists($this, '_existing_admin_settings') |
|
226 | + ? $this->_existing_admin_settings |
|
227 | + : null; |
|
228 | + } |
|
229 | + |
|
230 | + |
|
231 | + |
|
232 | + |
|
233 | + |
|
234 | + |
|
235 | + /** |
|
236 | + * This returns the array of valid shortcodes for a message type or messenger as set by the child in the $_valid_shortcode property. |
|
237 | + * @return array an array of valid shortcodes. |
|
238 | + */ |
|
239 | + public function get_valid_shortcodes() |
|
240 | + { |
|
241 | + $valid_shortcodes = apply_filters( |
|
242 | + 'FHEE__' . get_class($this) . '__get_valid_shortcodes', |
|
243 | + $this->_valid_shortcodes, |
|
244 | + $this |
|
245 | + ); |
|
246 | + // The below filter applies to ALL messengers and message types so use with care! |
|
247 | + $valid_shortcodes = apply_filters('FHEE__EE_Messages_Base__get_valid_shortcodes', $valid_shortcodes, $this); |
|
248 | + return $valid_shortcodes; |
|
249 | + } |
|
250 | + |
|
251 | + |
|
252 | + |
|
253 | + |
|
254 | + /** |
|
255 | + * getter that returns the protected admin_settings_fields property |
|
256 | + * |
|
257 | + * @access public |
|
258 | + * @return array admin settings fields |
|
259 | + */ |
|
260 | + public function get_admin_settings_fields() |
|
261 | + { |
|
262 | + return $this->_admin_settings_fields; |
|
263 | + } |
|
264 | + |
|
265 | + |
|
266 | + |
|
267 | + |
|
268 | + |
|
269 | + /** |
|
270 | + * this public method accepts a page slug (for an EE_admin page) |
|
271 | + * and will return the response from the child class callback function |
|
272 | + * if that page is registered via the `_admin_registered_page` property set by the child class. |
|
273 | + * |
|
274 | + * @param string $page the slug of the EE admin page |
|
275 | + * @param array $actives an array of active message type (or messenger) objects. |
|
276 | + * @param string $action the page action (to allow for more specific handling - i.e. edit vs. add pages) |
|
277 | + * @param array $extra This is just an extra argument that can be used |
|
278 | + * to pass additional data for setting up page content. |
|
279 | + * @access protected |
|
280 | + * @return string $content for page. |
|
281 | + */ |
|
282 | + protected function _get_admin_page_content($page, $action, $extra, $actives) |
|
283 | + { |
|
284 | + // we can also further refine the context by action (if present). |
|
285 | + if (!empty($action)) { |
|
286 | + $page = $page . '_' . $action; |
|
287 | + } |
|
288 | + |
|
289 | + if (!isset($this->admin_registered_pages[ $page ])) { |
|
290 | + // todo: a place to throw an exception? |
|
291 | + // We need to indicate there is no registered page so this function is not being called correctly. |
|
292 | + return false; |
|
293 | + } |
|
294 | + // k made it here so let's call the method |
|
295 | + $content = call_user_func_array( |
|
296 | + array( $this, '_get_admin_content_' . $page ), |
|
297 | + array( $actives, $extra ) |
|
298 | + ); |
|
299 | + if ($content === false) { |
|
300 | + // todo this needs to be an exception once we've got exceptions in place. |
|
301 | + return false; |
|
302 | + } |
|
303 | + return $content; |
|
304 | + } |
|
305 | + |
|
306 | + |
|
307 | + /** |
|
308 | + * Allows a message type to specifically exclude template fields for the provided messenger. |
|
309 | + * Filtered so this can be programmatically altered as well. |
|
310 | + * @param string $messenger_name name of messenger |
|
311 | + * @return array |
|
312 | + */ |
|
313 | + public function excludedFieldsForMessenger($messenger_name) |
|
314 | + { |
|
315 | + return apply_filters( |
|
316 | + 'FHEE__EE_Messages_Base__excludedFieldForMessenger', |
|
317 | + array(), |
|
318 | + $messenger_name, |
|
319 | + $this->name, |
|
320 | + $this |
|
321 | + ); |
|
322 | + } |
|
323 | 323 | } |
@@ -332,7 +332,7 @@ discard block |
||
332 | 332 | $answers = $questions = $attendees = $line_items = $registrations = array(); |
333 | 333 | $total_ticket_count = 0; |
334 | 334 | |
335 | - if (! empty($this->reg_objs)) { |
|
335 | + if ( ! empty($this->reg_objs)) { |
|
336 | 336 | $event_attendee_count = array(); |
337 | 337 | /** @var EE_Registration $reg */ |
338 | 338 | foreach ($this->reg_objs as $reg) { |
@@ -344,7 +344,7 @@ discard block |
||
344 | 344 | |
345 | 345 | $evt_id = $reg->event_ID(); |
346 | 346 | /** @type EE_Ticket $ticket */ |
347 | - $ticket = $reg->get_first_related('Ticket'); |
|
347 | + $ticket = $reg->get_first_related('Ticket'); |
|
348 | 348 | $attendee = $reg->attendee(); |
349 | 349 | $event = $reg->event(); |
350 | 350 | // if none of the following entities are available, then we can't setup other data reliably, |
@@ -358,67 +358,67 @@ discard block |
||
358 | 358 | } |
359 | 359 | $relateddatetime = $ticket->datetimes(); |
360 | 360 | $total_ticket_count++; |
361 | - $tickets[ $ticket->ID() ]['ticket'] = $ticket; |
|
362 | - $tickets[ $ticket->ID() ]['count'] = is_array($tickets[ $ticket->ID() ]) |
|
363 | - && isset($tickets[ $ticket->ID() ]['count']) |
|
364 | - ? $tickets[ $ticket->ID() ]['count'] + 1 |
|
361 | + $tickets[$ticket->ID()]['ticket'] = $ticket; |
|
362 | + $tickets[$ticket->ID()]['count'] = is_array($tickets[$ticket->ID()]) |
|
363 | + && isset($tickets[$ticket->ID()]['count']) |
|
364 | + ? $tickets[$ticket->ID()]['count'] + 1 |
|
365 | 365 | : 1; |
366 | - $tickets[ $ticket->ID() ]['att_objs'][ $attendee->ID() ] = $attendee; |
|
367 | - $tickets[ $ticket->ID() ]['dtt_objs'] = $relateddatetime; |
|
368 | - $tickets[ $ticket->ID() ]['reg_objs'][ $reg->ID() ] = $reg; |
|
369 | - $tickets[ $ticket->ID() ]['EE_Event'] = $event; |
|
370 | - $evtcache[ $evt_id ] = $event; |
|
371 | - $eventsetup[ $evt_id ]['reg_objs'][ $reg->ID() ] = $reg; |
|
372 | - $eventsetup[ $evt_id ]['tkt_objs'][ $ticket->ID() ] = $ticket; |
|
373 | - $eventsetup[ $evt_id ]['att_objs'][ $attendee->ID() ] = $attendee; |
|
374 | - $event_attendee_count[ $evt_id ] = isset($event_attendee_count[ $evt_id ]) |
|
375 | - ? $event_attendee_count[ $evt_id ] + 1 |
|
366 | + $tickets[$ticket->ID()]['att_objs'][$attendee->ID()] = $attendee; |
|
367 | + $tickets[$ticket->ID()]['dtt_objs'] = $relateddatetime; |
|
368 | + $tickets[$ticket->ID()]['reg_objs'][$reg->ID()] = $reg; |
|
369 | + $tickets[$ticket->ID()]['EE_Event'] = $event; |
|
370 | + $evtcache[$evt_id] = $event; |
|
371 | + $eventsetup[$evt_id]['reg_objs'][$reg->ID()] = $reg; |
|
372 | + $eventsetup[$evt_id]['tkt_objs'][$ticket->ID()] = $ticket; |
|
373 | + $eventsetup[$evt_id]['att_objs'][$attendee->ID()] = $attendee; |
|
374 | + $event_attendee_count[$evt_id] = isset($event_attendee_count[$evt_id]) |
|
375 | + ? $event_attendee_count[$evt_id] + 1 |
|
376 | 376 | : 0; |
377 | - $attendees[ $reg->attendee_ID() ]['line_ref'][] = $evt_id; |
|
378 | - $attendees[ $reg->attendee_ID() ]['att_obj'] = $attendee; |
|
379 | - $attendees[ $reg->attendee_ID() ]['reg_objs'][ $reg->ID() ] = $reg; |
|
377 | + $attendees[$reg->attendee_ID()]['line_ref'][] = $evt_id; |
|
378 | + $attendees[$reg->attendee_ID()]['att_obj'] = $attendee; |
|
379 | + $attendees[$reg->attendee_ID()]['reg_objs'][$reg->ID()] = $reg; |
|
380 | 380 | // $attendees[ $reg->attendee_ID() ]['registration_id'] = $reg->ID(); |
381 | - $attendees[ $reg->attendee_ID() ]['attendee_email'] = $attendee->email(); |
|
382 | - $attendees[ $reg->attendee_ID() ]['tkt_objs'][ $ticket->ID() ] = $ticket; |
|
383 | - $attendees[ $reg->attendee_ID() ]['evt_objs'][ $evt_id ] = $event; |
|
381 | + $attendees[$reg->attendee_ID()]['attendee_email'] = $attendee->email(); |
|
382 | + $attendees[$reg->attendee_ID()]['tkt_objs'][$ticket->ID()] = $ticket; |
|
383 | + $attendees[$reg->attendee_ID()]['evt_objs'][$evt_id] = $event; |
|
384 | 384 | |
385 | 385 | // registrations |
386 | - $registrations[ $reg->ID() ]['tkt_obj'] = $ticket; |
|
387 | - $registrations[ $reg->ID() ]['evt_obj'] = $event; |
|
388 | - $registrations[ $reg->ID() ]['reg_obj'] = $reg; |
|
389 | - $registrations[ $reg->ID() ]['att_obj'] = $attendee; |
|
386 | + $registrations[$reg->ID()]['tkt_obj'] = $ticket; |
|
387 | + $registrations[$reg->ID()]['evt_obj'] = $event; |
|
388 | + $registrations[$reg->ID()]['reg_obj'] = $reg; |
|
389 | + $registrations[$reg->ID()]['att_obj'] = $attendee; |
|
390 | 390 | |
391 | 391 | // set up answer objects |
392 | 392 | $rel_ans = $reg->get_many_related('Answer'); |
393 | 393 | foreach ($rel_ans as $ansid => $answer) { |
394 | - if (! isset($questions[ $ansid ])) { |
|
395 | - $questions[ $ansid ] = $answer->get_first_related('Question'); |
|
394 | + if ( ! isset($questions[$ansid])) { |
|
395 | + $questions[$ansid] = $answer->get_first_related('Question'); |
|
396 | 396 | } |
397 | - $answers[ $ansid ] = $answer; |
|
398 | - $registrations[ $reg->ID() ]['ans_objs'][ $ansid ] = $answer; |
|
397 | + $answers[$ansid] = $answer; |
|
398 | + $registrations[$reg->ID()]['ans_objs'][$ansid] = $answer; |
|
399 | 399 | } |
400 | 400 | /** |
401 | 401 | * @var int $dtt_id |
402 | 402 | * @var EE_Datetime $datetime |
403 | 403 | */ |
404 | 404 | foreach ($relateddatetime as $dtt_id => $datetime) { |
405 | - $eventsetup[ $evt_id ]['dtt_objs'][ $dtt_id ] = $datetime; |
|
406 | - $registrations[ $reg->ID() ]['dtt_objs'][ $dtt_id ] = $datetime; |
|
405 | + $eventsetup[$evt_id]['dtt_objs'][$dtt_id] = $datetime; |
|
406 | + $registrations[$reg->ID()]['dtt_objs'][$dtt_id] = $datetime; |
|
407 | 407 | |
408 | - if (isset($datetimes[ $dtt_id ])) { |
|
408 | + if (isset($datetimes[$dtt_id])) { |
|
409 | 409 | continue; // already have this info in the datetimes array. |
410 | 410 | } |
411 | 411 | |
412 | - $datetimes[ $dtt_id ]['tkt_objs'][] = $ticket; |
|
413 | - $datetimes[ $dtt_id ]['datetime'] = $datetime; |
|
414 | - $datetimes[ $dtt_id ]['evt_objs'][ $evt_id ] = $event; |
|
415 | - $datetimes[ $dtt_id ]['reg_objs'][ $reg->ID() ] = $reg; |
|
412 | + $datetimes[$dtt_id]['tkt_objs'][] = $ticket; |
|
413 | + $datetimes[$dtt_id]['datetime'] = $datetime; |
|
414 | + $datetimes[$dtt_id]['evt_objs'][$evt_id] = $event; |
|
415 | + $datetimes[$dtt_id]['reg_objs'][$reg->ID()] = $reg; |
|
416 | 416 | } |
417 | 417 | } |
418 | 418 | |
419 | 419 | // let's loop through the unique event=>reg items and setup data on them |
420 | 420 | |
421 | - if (! empty($eventsetup)) { |
|
421 | + if ( ! empty($eventsetup)) { |
|
422 | 422 | foreach ($eventsetup as $evt_id => $items) { |
423 | 423 | $ticket_line_items_for_event = array(); |
424 | 424 | if ($this->txn instanceof EE_Transaction) { |
@@ -432,11 +432,11 @@ discard block |
||
432 | 432 | ) |
433 | 433 | ); |
434 | 434 | } |
435 | - $events[ $evt_id ] = array( |
|
435 | + $events[$evt_id] = array( |
|
436 | 436 | 'ID' => $evt_id, |
437 | - 'event' => $evtcache[ $evt_id ], |
|
438 | - 'name' => $evtcache[ $evt_id ] instanceof EE_Event ? $evtcache[ $evt_id ]->name() : '', |
|
439 | - 'total_attendees' => $event_attendee_count[ $evt_id ], |
|
437 | + 'event' => $evtcache[$evt_id], |
|
438 | + 'name' => $evtcache[$evt_id] instanceof EE_Event ? $evtcache[$evt_id]->name() : '', |
|
439 | + 'total_attendees' => $event_attendee_count[$evt_id], |
|
440 | 440 | 'reg_objs' => $items['reg_objs'], |
441 | 441 | 'tkt_objs' => $items['tkt_objs'], |
442 | 442 | 'att_objs' => $items['att_objs'], |
@@ -447,11 +447,11 @@ discard block |
||
447 | 447 | // make sure the tickets have the line items setup for them. |
448 | 448 | foreach ($ticket_line_items_for_event as $line_id => $line_item) { |
449 | 449 | // only add the ticket line items if we already have this ticket in the $tickets array. |
450 | - if ($line_item instanceof EE_Line_Item && isset($tickets[ $line_item->ticket()->ID() ])) { |
|
451 | - $tickets[ $line_item->ticket()->ID() ]['line_item'] = $line_item; |
|
452 | - $tickets[ $line_item->ticket()->ID() ]['sub_line_items'] = $line_item->children(); |
|
453 | - $line_items[ $line_item->ID() ]['children'] = $line_item->children(); |
|
454 | - $line_items[ $line_item->ID() ]['EE_Ticket'] = $line_item->ticket(); |
|
450 | + if ($line_item instanceof EE_Line_Item && isset($tickets[$line_item->ticket()->ID()])) { |
|
451 | + $tickets[$line_item->ticket()->ID()]['line_item'] = $line_item; |
|
452 | + $tickets[$line_item->ticket()->ID()]['sub_line_items'] = $line_item->children(); |
|
453 | + $line_items[$line_item->ID()]['children'] = $line_item->children(); |
|
454 | + $line_items[$line_item->ID()]['EE_Ticket'] = $line_item->ticket(); |
|
455 | 455 | } |
456 | 456 | } |
457 | 457 | } |
@@ -16,522 +16,522 @@ |
||
16 | 16 | */ |
17 | 17 | abstract class EE_Messages_incoming_data |
18 | 18 | { |
19 | - /** |
|
20 | - * user id for logged in user when data collected |
|
21 | - * |
|
22 | - * @var string $user_id |
|
23 | - */ |
|
24 | - public $user_id; |
|
25 | - |
|
26 | - /** |
|
27 | - * IP Address of browser used |
|
28 | - * |
|
29 | - * @var string $ip_address |
|
30 | - */ |
|
31 | - public $ip_address; |
|
32 | - |
|
33 | - /** |
|
34 | - * browser |
|
35 | - * |
|
36 | - * @var string $user_agent |
|
37 | - */ |
|
38 | - public $user_agent; |
|
39 | - |
|
40 | - /** |
|
41 | - * Unix timestamp |
|
42 | - * |
|
43 | - * @var string $init_access |
|
44 | - */ |
|
45 | - public $init_access; |
|
46 | - |
|
47 | - /** |
|
48 | - * Unix timestamp |
|
49 | - * |
|
50 | - * @var string $last_access |
|
51 | - */ |
|
52 | - public $last_access; |
|
53 | - |
|
54 | - /** |
|
55 | - * The registrations details from the cart |
|
56 | - * |
|
57 | - * @var array $reg_info |
|
58 | - */ |
|
59 | - public $reg_info; |
|
60 | - |
|
61 | - /** |
|
62 | - * Some data handlers can set what reg status all the registrations are filtered by. |
|
63 | - * The status should match a EEM_Registration status constant. |
|
64 | - * |
|
65 | - * @var string $filtered_reg_status |
|
66 | - */ |
|
67 | - public $filtered_reg_status; |
|
68 | - |
|
69 | - /** |
|
70 | - * will hold an array of events assembled from $reg_info |
|
71 | - * |
|
72 | - * @var EE_Event[] $events |
|
73 | - */ |
|
74 | - public $events; |
|
75 | - |
|
76 | - /** |
|
77 | - * holds an array of datetimes assembled from the incoming data. |
|
78 | - * |
|
79 | - * @var EE_Datetime[] $datetimes |
|
80 | - */ |
|
81 | - public $datetimes; |
|
82 | - |
|
83 | - /** |
|
84 | - * holds an array of tickets assembled from the incoming data. |
|
85 | - * |
|
86 | - * @var EE_Ticket[] $tickets |
|
87 | - */ |
|
88 | - public $tickets; |
|
89 | - |
|
90 | - /** |
|
91 | - * holds an array with a key of parent line item and values are an array of children of that line item. |
|
92 | - * |
|
93 | - * @since 4.5.0 |
|
94 | - * @var EE_Line_Item[] $line_items_with_children |
|
95 | - */ |
|
96 | - public $line_items_with_children; |
|
97 | - |
|
98 | - /** |
|
99 | - * will hold an array of attendees assembled from the $reg_info |
|
100 | - * |
|
101 | - * @var EE_Attendee[] $attendees |
|
102 | - */ |
|
103 | - public $attendees; |
|
104 | - |
|
105 | - /** |
|
106 | - * will hold an array of cached registration objects and info assembled from reg_info |
|
107 | - * |
|
108 | - * @var array $registrations |
|
109 | - */ |
|
110 | - public $registrations; |
|
111 | - |
|
112 | - /** |
|
113 | - * will hold an array of answers assembled from the $reg_info |
|
114 | - * |
|
115 | - * @var EE_Answer[] $answers |
|
116 | - */ |
|
117 | - public $answers; |
|
118 | - |
|
119 | - /** |
|
120 | - * will hold an array of questions assembled from the $reg_info (indexed by Answer ID); |
|
121 | - * |
|
122 | - * @var EE_Question[] $questions |
|
123 | - */ |
|
124 | - public $questions; |
|
125 | - |
|
126 | - /** |
|
127 | - * Will hold billing data assembled from $billing_info (if present) |
|
128 | - * |
|
129 | - * @var mixed (array|null) $billing |
|
130 | - */ |
|
131 | - public $billing; |
|
132 | - |
|
133 | - /** |
|
134 | - * The total amount of tax for the transaction |
|
135 | - * |
|
136 | - * @var float $taxes |
|
137 | - */ |
|
138 | - public $taxes; |
|
139 | - |
|
140 | - /** |
|
141 | - * Holds the line items related to taxes |
|
142 | - * |
|
143 | - * @since 4.5.0 |
|
144 | - * @var EE_Line_Item[] $tax_line_items |
|
145 | - */ |
|
146 | - public $tax_line_items; |
|
147 | - |
|
148 | - /** |
|
149 | - * Hold the line items which aren't taxes and don't relate |
|
150 | - * to tickets. So: promotions and miscellaneous charges |
|
151 | - * |
|
152 | - * @since 4.5 |
|
153 | - * @var EE_Line_Item[] $additional_line_items |
|
154 | - */ |
|
155 | - public $additional_line_items; |
|
156 | - |
|
157 | - /** |
|
158 | - * Holds the grand total EE_Line_Item |
|
159 | - * |
|
160 | - * @var EE_Line_Item $grand_total_line_item |
|
161 | - */ |
|
162 | - public $grand_total_line_item; |
|
163 | - |
|
164 | - /** |
|
165 | - * holds the grand total price object |
|
166 | - * currently not used. |
|
167 | - * |
|
168 | - * @var null $grand_total_price_object |
|
169 | - */ |
|
170 | - public $grand_total_price_object; |
|
171 | - |
|
172 | - /** |
|
173 | - * total number of tickets |
|
174 | - * |
|
175 | - * @var int $total_ticket_count |
|
176 | - */ |
|
177 | - public $total_ticket_count; |
|
178 | - |
|
179 | - /** |
|
180 | - * Will hold the final transaction object (EE_Transaction) |
|
181 | - * |
|
182 | - * @var EE_Transaction $txn |
|
183 | - */ |
|
184 | - public $txn; |
|
185 | - |
|
186 | - /** |
|
187 | - * Holds the payments related to a transaction |
|
188 | - * |
|
189 | - * @since 4.5.0 |
|
190 | - * @var EE_Payment[] $payments |
|
191 | - */ |
|
192 | - public $payments; |
|
193 | - |
|
194 | - /** |
|
195 | - * Holds the first related payment related for a transaction |
|
196 | - * |
|
197 | - * @since 4.5.0 |
|
198 | - * @var EE_Payment $payment |
|
199 | - */ |
|
200 | - public $payment; |
|
201 | - |
|
202 | - /** |
|
203 | - * Will hold the label for the txn status |
|
204 | - * |
|
205 | - * @var string $txn_status |
|
206 | - */ |
|
207 | - public $txn_status; |
|
208 | - |
|
209 | - /** |
|
210 | - * Will hold the final registration object (EE_Registration) |
|
211 | - * |
|
212 | - * @var EE_Registration[] $reg_objs |
|
213 | - */ |
|
214 | - public $reg_objs; |
|
215 | - |
|
216 | - /** |
|
217 | - * Will hold an array of primary attendee data (if present) |
|
218 | - * |
|
219 | - * @var array $primary_attendee_data |
|
220 | - */ |
|
221 | - public $primary_attendee_data; |
|
222 | - |
|
223 | - /** |
|
224 | - * This is just an internal object used for passing around the incoming data. |
|
225 | - * |
|
226 | - * @var mixed $_data |
|
227 | - */ |
|
228 | - protected $_data; |
|
229 | - |
|
230 | - /** |
|
231 | - * This is just an internal object used for passing around the incoming data. |
|
232 | - * |
|
233 | - * @var mixed $incoming_data |
|
234 | - */ |
|
235 | - public $incoming_data; |
|
236 | - |
|
237 | - /** |
|
238 | - * hold objects that might be created |
|
239 | - * |
|
240 | - * @type EE_Registration $reg_obj |
|
241 | - */ |
|
242 | - public $reg_obj; |
|
243 | - |
|
244 | - |
|
245 | - /** |
|
246 | - * constructor |
|
247 | - * |
|
248 | - * @param mixed $data incoming data object|array. Suggested that child classes use type hinting for expected |
|
249 | - * data object. But here parent will be generic because we don't know what's coming in. |
|
250 | - */ |
|
251 | - public function __construct($data) |
|
252 | - { |
|
253 | - $this->_data = $data; |
|
254 | - $this->_setup_data(); |
|
255 | - } |
|
256 | - |
|
257 | - |
|
258 | - /** |
|
259 | - * Every child class has to setup the data object ! |
|
260 | - * |
|
261 | - * @return void |
|
262 | - */ |
|
263 | - abstract protected function _setup_data(); |
|
264 | - |
|
265 | - |
|
266 | - /** |
|
267 | - * Returns database safe representation of the data later used to when instantiating this object. |
|
268 | - * |
|
269 | - * @param mixed $data The incoming data to be prepped. |
|
270 | - * @return mixed The prepped data for db |
|
271 | - */ |
|
272 | - public static function convert_data_for_persistent_storage($data) |
|
273 | - { |
|
274 | - return $data; |
|
275 | - } |
|
276 | - |
|
277 | - |
|
278 | - /** |
|
279 | - * Data that has been stored in persistent storage that was prepped by _convert_data_for_persistent_storage |
|
280 | - * can be sent into this method and converted back into the format used for instantiating with this data handler. |
|
281 | - * |
|
282 | - * @param $data |
|
283 | - * @return mixed |
|
284 | - */ |
|
285 | - public static function convert_data_from_persistent_storage($data) |
|
286 | - { |
|
287 | - return $data; |
|
288 | - } |
|
289 | - |
|
290 | - |
|
291 | - /** |
|
292 | - * only purpose is to return the data |
|
293 | - * |
|
294 | - * @access public |
|
295 | - * @return mixed the formatted data object! |
|
296 | - */ |
|
297 | - public function data() |
|
298 | - { |
|
299 | - return $this->_data; |
|
300 | - } |
|
301 | - |
|
302 | - |
|
303 | - /** |
|
304 | - * This helper method can be used by any incoming data handlers to setup the data correctly. All that is required |
|
305 | - * is that $this->reg_objs be set. |
|
306 | - * |
|
307 | - * @throws EE_Error |
|
308 | - * @throws InvalidDataTypeException |
|
309 | - * @throws InvalidInterfaceException |
|
310 | - * @throws InvalidArgumentException |
|
311 | - * @throws EntityNotFoundException |
|
312 | - */ |
|
313 | - protected function _assemble_data() |
|
314 | - { |
|
315 | - // verify that reg_objs is set |
|
316 | - if ( |
|
317 | - ! is_array($this->reg_objs) |
|
318 | - && ! reset($this->reg_objs) instanceof EE_Registration |
|
319 | - ) { |
|
320 | - throw new EE_Error( |
|
321 | - esc_html__( |
|
322 | - 'In order to assemble the data correctly, the "reg_objs" property must be an array of EE_Registration objects', |
|
323 | - 'event_espresso' |
|
324 | - ) |
|
325 | - ); |
|
326 | - } |
|
327 | - |
|
328 | - // get all attendee and events associated with the registrations in this transaction |
|
329 | - $events = $event_setup = $evtcache = $tickets = $datetimes = array(); |
|
330 | - $answers = $questions = $attendees = $line_items = $registrations = array(); |
|
331 | - $total_ticket_count = 0; |
|
332 | - |
|
333 | - if (! empty($this->reg_objs)) { |
|
334 | - $event_attendee_count = array(); |
|
335 | - /** @var EE_Registration $reg */ |
|
336 | - foreach ($this->reg_objs as $reg) { |
|
337 | - if ( |
|
338 | - $this->_skip_registration_for_processing($reg) |
|
339 | - ) { |
|
340 | - continue; |
|
341 | - } |
|
342 | - |
|
343 | - $evt_id = $reg->event_ID(); |
|
344 | - /** @type EE_Ticket $ticket */ |
|
345 | - $ticket = $reg->get_first_related('Ticket'); |
|
346 | - $attendee = $reg->attendee(); |
|
347 | - $event = $reg->event(); |
|
348 | - // if none of the following entities are available, then we can't setup other data reliably, |
|
349 | - // so let's just skip. |
|
350 | - if ( |
|
351 | - ! $ticket instanceof EE_Ticket |
|
352 | - || ! $attendee instanceof EE_Attendee |
|
353 | - || ! $event instanceof EE_Event |
|
354 | - ) { |
|
355 | - continue; |
|
356 | - } |
|
357 | - $relateddatetime = $ticket->datetimes(); |
|
358 | - $total_ticket_count++; |
|
359 | - $tickets[ $ticket->ID() ]['ticket'] = $ticket; |
|
360 | - $tickets[ $ticket->ID() ]['count'] = is_array($tickets[ $ticket->ID() ]) |
|
361 | - && isset($tickets[ $ticket->ID() ]['count']) |
|
362 | - ? $tickets[ $ticket->ID() ]['count'] + 1 |
|
363 | - : 1; |
|
364 | - $tickets[ $ticket->ID() ]['att_objs'][ $attendee->ID() ] = $attendee; |
|
365 | - $tickets[ $ticket->ID() ]['dtt_objs'] = $relateddatetime; |
|
366 | - $tickets[ $ticket->ID() ]['reg_objs'][ $reg->ID() ] = $reg; |
|
367 | - $tickets[ $ticket->ID() ]['EE_Event'] = $event; |
|
368 | - $evtcache[ $evt_id ] = $event; |
|
369 | - $eventsetup[ $evt_id ]['reg_objs'][ $reg->ID() ] = $reg; |
|
370 | - $eventsetup[ $evt_id ]['tkt_objs'][ $ticket->ID() ] = $ticket; |
|
371 | - $eventsetup[ $evt_id ]['att_objs'][ $attendee->ID() ] = $attendee; |
|
372 | - $event_attendee_count[ $evt_id ] = isset($event_attendee_count[ $evt_id ]) |
|
373 | - ? $event_attendee_count[ $evt_id ] + 1 |
|
374 | - : 0; |
|
375 | - $attendees[ $reg->attendee_ID() ]['line_ref'][] = $evt_id; |
|
376 | - $attendees[ $reg->attendee_ID() ]['att_obj'] = $attendee; |
|
377 | - $attendees[ $reg->attendee_ID() ]['reg_objs'][ $reg->ID() ] = $reg; |
|
378 | - // $attendees[ $reg->attendee_ID() ]['registration_id'] = $reg->ID(); |
|
379 | - $attendees[ $reg->attendee_ID() ]['attendee_email'] = $attendee->email(); |
|
380 | - $attendees[ $reg->attendee_ID() ]['tkt_objs'][ $ticket->ID() ] = $ticket; |
|
381 | - $attendees[ $reg->attendee_ID() ]['evt_objs'][ $evt_id ] = $event; |
|
382 | - |
|
383 | - // registrations |
|
384 | - $registrations[ $reg->ID() ]['tkt_obj'] = $ticket; |
|
385 | - $registrations[ $reg->ID() ]['evt_obj'] = $event; |
|
386 | - $registrations[ $reg->ID() ]['reg_obj'] = $reg; |
|
387 | - $registrations[ $reg->ID() ]['att_obj'] = $attendee; |
|
388 | - |
|
389 | - // set up answer objects |
|
390 | - $rel_ans = $reg->get_many_related('Answer'); |
|
391 | - foreach ($rel_ans as $ansid => $answer) { |
|
392 | - if (! isset($questions[ $ansid ])) { |
|
393 | - $questions[ $ansid ] = $answer->get_first_related('Question'); |
|
394 | - } |
|
395 | - $answers[ $ansid ] = $answer; |
|
396 | - $registrations[ $reg->ID() ]['ans_objs'][ $ansid ] = $answer; |
|
397 | - } |
|
398 | - /** |
|
399 | - * @var int $dtt_id |
|
400 | - * @var EE_Datetime $datetime |
|
401 | - */ |
|
402 | - foreach ($relateddatetime as $dtt_id => $datetime) { |
|
403 | - $eventsetup[ $evt_id ]['dtt_objs'][ $dtt_id ] = $datetime; |
|
404 | - $registrations[ $reg->ID() ]['dtt_objs'][ $dtt_id ] = $datetime; |
|
405 | - |
|
406 | - if (isset($datetimes[ $dtt_id ])) { |
|
407 | - continue; // already have this info in the datetimes array. |
|
408 | - } |
|
409 | - |
|
410 | - $datetimes[ $dtt_id ]['tkt_objs'][] = $ticket; |
|
411 | - $datetimes[ $dtt_id ]['datetime'] = $datetime; |
|
412 | - $datetimes[ $dtt_id ]['evt_objs'][ $evt_id ] = $event; |
|
413 | - $datetimes[ $dtt_id ]['reg_objs'][ $reg->ID() ] = $reg; |
|
414 | - } |
|
415 | - } |
|
416 | - |
|
417 | - // let's loop through the unique event=>reg items and setup data on them |
|
418 | - |
|
419 | - if (! empty($eventsetup)) { |
|
420 | - foreach ($eventsetup as $evt_id => $items) { |
|
421 | - $ticket_line_items_for_event = array(); |
|
422 | - if ($this->txn instanceof EE_Transaction) { |
|
423 | - $ticket_line_items_for_event = EEM_Line_Item::instance()->get_all( |
|
424 | - array( |
|
425 | - array( |
|
426 | - 'Ticket.Datetime.EVT_ID' => $evt_id, |
|
427 | - 'TXN_ID' => $this->txn->ID(), |
|
428 | - ), |
|
429 | - 'default_where_conditions' => 'none', |
|
430 | - ) |
|
431 | - ); |
|
432 | - } |
|
433 | - $events[ $evt_id ] = array( |
|
434 | - 'ID' => $evt_id, |
|
435 | - 'event' => $evtcache[ $evt_id ], |
|
436 | - 'name' => $evtcache[ $evt_id ] instanceof EE_Event ? $evtcache[ $evt_id ]->name() : '', |
|
437 | - 'total_attendees' => $event_attendee_count[ $evt_id ], |
|
438 | - 'reg_objs' => $items['reg_objs'], |
|
439 | - 'tkt_objs' => $items['tkt_objs'], |
|
440 | - 'att_objs' => $items['att_objs'], |
|
441 | - 'dtt_objs' => isset($items['dtt_objs']) ? $items['dtt_objs'] : array(), |
|
442 | - 'line_items' => $ticket_line_items_for_event, |
|
443 | - ); |
|
444 | - |
|
445 | - // make sure the tickets have the line items setup for them. |
|
446 | - foreach ($ticket_line_items_for_event as $line_id => $line_item) { |
|
447 | - // only add the ticket line items if we already have this ticket in the $tickets array. |
|
448 | - if ($line_item instanceof EE_Line_Item && isset($tickets[ $line_item->ticket()->ID() ])) { |
|
449 | - $tickets[ $line_item->ticket()->ID() ]['line_item'] = $line_item; |
|
450 | - $tickets[ $line_item->ticket()->ID() ]['sub_line_items'] = $line_item->children(); |
|
451 | - $line_items[ $line_item->ID() ]['children'] = $line_item->children(); |
|
452 | - $line_items[ $line_item->ID() ]['EE_Ticket'] = $line_item->ticket(); |
|
453 | - } |
|
454 | - } |
|
455 | - } |
|
456 | - } |
|
457 | - |
|
458 | - $this->grand_total_line_item = $this->txn instanceof EE_Transaction |
|
459 | - ? $this->txn->total_line_item() |
|
460 | - : null; |
|
461 | - } |
|
462 | - |
|
463 | - // lets set the attendees and events properties |
|
464 | - $this->attendees = $attendees; |
|
465 | - $this->events = $events; |
|
466 | - $this->tickets = $tickets; |
|
467 | - $this->line_items_with_children = $line_items; |
|
468 | - $this->datetimes = $datetimes; |
|
469 | - $this->questions = $questions; |
|
470 | - $this->answers = $answers; |
|
471 | - $this->total_ticket_count = $total_ticket_count; |
|
472 | - $this->registrations = $registrations; |
|
473 | - |
|
474 | - if ($this->txn instanceof EE_Transaction) { |
|
475 | - $this->tax_line_items = $this->txn->tax_items(); |
|
476 | - $this->additional_line_items = $this->txn->non_ticket_line_items(); |
|
477 | - $this->payments = $this->txn->payments(); |
|
478 | - |
|
479 | - // setup primary registration if we have a single transaction object to work with |
|
480 | - |
|
481 | - // let's get just the primary_attendee_data! First we get the primary registration object. |
|
482 | - $primary_reg = $this->txn->primary_registration(); |
|
483 | - // verify |
|
484 | - if ($primary_reg instanceof EE_Registration) { |
|
485 | - // get attendee object |
|
486 | - if ($primary_reg->attendee() instanceof EE_Attendee) { |
|
487 | - // now we can setup the primary_attendee_data array |
|
488 | - $this->primary_attendee_data = array( |
|
489 | - 'registration_id' => $primary_reg->ID(), |
|
490 | - 'att_obj' => $primary_reg->attendee(), |
|
491 | - 'reg_obj' => $primary_reg, |
|
492 | - 'primary_att_obj' => $primary_reg->attendee(), |
|
493 | - 'primary_reg_obj' => $primary_reg, |
|
494 | - ); |
|
495 | - } else { |
|
496 | - EE_Error::add_error( |
|
497 | - esc_html__( |
|
498 | - 'Incoming data does not have a valid Attendee object for the primary registrant.', |
|
499 | - 'event_espresso' |
|
500 | - ), |
|
501 | - __FILE__, |
|
502 | - __FUNCTION__, |
|
503 | - __LINE__ |
|
504 | - ); |
|
505 | - } |
|
506 | - } else { |
|
507 | - EE_Error::add_error( |
|
508 | - esc_html__( |
|
509 | - 'Incoming data does not have a valid Registration object for the primary registrant.', |
|
510 | - 'event_espresso' |
|
511 | - ), |
|
512 | - __FILE__, |
|
513 | - __FUNCTION__, |
|
514 | - __LINE__ |
|
515 | - ); |
|
516 | - } |
|
517 | - } |
|
518 | - } |
|
519 | - |
|
520 | - /** |
|
521 | - * This simply considers whether the given registration should be processed or not based on comparison with the |
|
522 | - * filtered_reg_status property. |
|
523 | - * |
|
524 | - * @param EE_Registration $registration |
|
525 | - * @return bool returning true means we DO want to skip processing. returning false means we DON'T want to skip |
|
526 | - * processing |
|
527 | - */ |
|
528 | - protected function _skip_registration_for_processing(EE_Registration $registration) |
|
529 | - { |
|
530 | - if (empty($this->filtered_reg_status)) { |
|
531 | - return false; |
|
532 | - } |
|
533 | - |
|
534 | - // if we made it here then we just compare the filtered_reg_status with the registration status and return that |
|
535 | - return $this->filtered_reg_status !== $registration->status_ID(); |
|
536 | - } |
|
19 | + /** |
|
20 | + * user id for logged in user when data collected |
|
21 | + * |
|
22 | + * @var string $user_id |
|
23 | + */ |
|
24 | + public $user_id; |
|
25 | + |
|
26 | + /** |
|
27 | + * IP Address of browser used |
|
28 | + * |
|
29 | + * @var string $ip_address |
|
30 | + */ |
|
31 | + public $ip_address; |
|
32 | + |
|
33 | + /** |
|
34 | + * browser |
|
35 | + * |
|
36 | + * @var string $user_agent |
|
37 | + */ |
|
38 | + public $user_agent; |
|
39 | + |
|
40 | + /** |
|
41 | + * Unix timestamp |
|
42 | + * |
|
43 | + * @var string $init_access |
|
44 | + */ |
|
45 | + public $init_access; |
|
46 | + |
|
47 | + /** |
|
48 | + * Unix timestamp |
|
49 | + * |
|
50 | + * @var string $last_access |
|
51 | + */ |
|
52 | + public $last_access; |
|
53 | + |
|
54 | + /** |
|
55 | + * The registrations details from the cart |
|
56 | + * |
|
57 | + * @var array $reg_info |
|
58 | + */ |
|
59 | + public $reg_info; |
|
60 | + |
|
61 | + /** |
|
62 | + * Some data handlers can set what reg status all the registrations are filtered by. |
|
63 | + * The status should match a EEM_Registration status constant. |
|
64 | + * |
|
65 | + * @var string $filtered_reg_status |
|
66 | + */ |
|
67 | + public $filtered_reg_status; |
|
68 | + |
|
69 | + /** |
|
70 | + * will hold an array of events assembled from $reg_info |
|
71 | + * |
|
72 | + * @var EE_Event[] $events |
|
73 | + */ |
|
74 | + public $events; |
|
75 | + |
|
76 | + /** |
|
77 | + * holds an array of datetimes assembled from the incoming data. |
|
78 | + * |
|
79 | + * @var EE_Datetime[] $datetimes |
|
80 | + */ |
|
81 | + public $datetimes; |
|
82 | + |
|
83 | + /** |
|
84 | + * holds an array of tickets assembled from the incoming data. |
|
85 | + * |
|
86 | + * @var EE_Ticket[] $tickets |
|
87 | + */ |
|
88 | + public $tickets; |
|
89 | + |
|
90 | + /** |
|
91 | + * holds an array with a key of parent line item and values are an array of children of that line item. |
|
92 | + * |
|
93 | + * @since 4.5.0 |
|
94 | + * @var EE_Line_Item[] $line_items_with_children |
|
95 | + */ |
|
96 | + public $line_items_with_children; |
|
97 | + |
|
98 | + /** |
|
99 | + * will hold an array of attendees assembled from the $reg_info |
|
100 | + * |
|
101 | + * @var EE_Attendee[] $attendees |
|
102 | + */ |
|
103 | + public $attendees; |
|
104 | + |
|
105 | + /** |
|
106 | + * will hold an array of cached registration objects and info assembled from reg_info |
|
107 | + * |
|
108 | + * @var array $registrations |
|
109 | + */ |
|
110 | + public $registrations; |
|
111 | + |
|
112 | + /** |
|
113 | + * will hold an array of answers assembled from the $reg_info |
|
114 | + * |
|
115 | + * @var EE_Answer[] $answers |
|
116 | + */ |
|
117 | + public $answers; |
|
118 | + |
|
119 | + /** |
|
120 | + * will hold an array of questions assembled from the $reg_info (indexed by Answer ID); |
|
121 | + * |
|
122 | + * @var EE_Question[] $questions |
|
123 | + */ |
|
124 | + public $questions; |
|
125 | + |
|
126 | + /** |
|
127 | + * Will hold billing data assembled from $billing_info (if present) |
|
128 | + * |
|
129 | + * @var mixed (array|null) $billing |
|
130 | + */ |
|
131 | + public $billing; |
|
132 | + |
|
133 | + /** |
|
134 | + * The total amount of tax for the transaction |
|
135 | + * |
|
136 | + * @var float $taxes |
|
137 | + */ |
|
138 | + public $taxes; |
|
139 | + |
|
140 | + /** |
|
141 | + * Holds the line items related to taxes |
|
142 | + * |
|
143 | + * @since 4.5.0 |
|
144 | + * @var EE_Line_Item[] $tax_line_items |
|
145 | + */ |
|
146 | + public $tax_line_items; |
|
147 | + |
|
148 | + /** |
|
149 | + * Hold the line items which aren't taxes and don't relate |
|
150 | + * to tickets. So: promotions and miscellaneous charges |
|
151 | + * |
|
152 | + * @since 4.5 |
|
153 | + * @var EE_Line_Item[] $additional_line_items |
|
154 | + */ |
|
155 | + public $additional_line_items; |
|
156 | + |
|
157 | + /** |
|
158 | + * Holds the grand total EE_Line_Item |
|
159 | + * |
|
160 | + * @var EE_Line_Item $grand_total_line_item |
|
161 | + */ |
|
162 | + public $grand_total_line_item; |
|
163 | + |
|
164 | + /** |
|
165 | + * holds the grand total price object |
|
166 | + * currently not used. |
|
167 | + * |
|
168 | + * @var null $grand_total_price_object |
|
169 | + */ |
|
170 | + public $grand_total_price_object; |
|
171 | + |
|
172 | + /** |
|
173 | + * total number of tickets |
|
174 | + * |
|
175 | + * @var int $total_ticket_count |
|
176 | + */ |
|
177 | + public $total_ticket_count; |
|
178 | + |
|
179 | + /** |
|
180 | + * Will hold the final transaction object (EE_Transaction) |
|
181 | + * |
|
182 | + * @var EE_Transaction $txn |
|
183 | + */ |
|
184 | + public $txn; |
|
185 | + |
|
186 | + /** |
|
187 | + * Holds the payments related to a transaction |
|
188 | + * |
|
189 | + * @since 4.5.0 |
|
190 | + * @var EE_Payment[] $payments |
|
191 | + */ |
|
192 | + public $payments; |
|
193 | + |
|
194 | + /** |
|
195 | + * Holds the first related payment related for a transaction |
|
196 | + * |
|
197 | + * @since 4.5.0 |
|
198 | + * @var EE_Payment $payment |
|
199 | + */ |
|
200 | + public $payment; |
|
201 | + |
|
202 | + /** |
|
203 | + * Will hold the label for the txn status |
|
204 | + * |
|
205 | + * @var string $txn_status |
|
206 | + */ |
|
207 | + public $txn_status; |
|
208 | + |
|
209 | + /** |
|
210 | + * Will hold the final registration object (EE_Registration) |
|
211 | + * |
|
212 | + * @var EE_Registration[] $reg_objs |
|
213 | + */ |
|
214 | + public $reg_objs; |
|
215 | + |
|
216 | + /** |
|
217 | + * Will hold an array of primary attendee data (if present) |
|
218 | + * |
|
219 | + * @var array $primary_attendee_data |
|
220 | + */ |
|
221 | + public $primary_attendee_data; |
|
222 | + |
|
223 | + /** |
|
224 | + * This is just an internal object used for passing around the incoming data. |
|
225 | + * |
|
226 | + * @var mixed $_data |
|
227 | + */ |
|
228 | + protected $_data; |
|
229 | + |
|
230 | + /** |
|
231 | + * This is just an internal object used for passing around the incoming data. |
|
232 | + * |
|
233 | + * @var mixed $incoming_data |
|
234 | + */ |
|
235 | + public $incoming_data; |
|
236 | + |
|
237 | + /** |
|
238 | + * hold objects that might be created |
|
239 | + * |
|
240 | + * @type EE_Registration $reg_obj |
|
241 | + */ |
|
242 | + public $reg_obj; |
|
243 | + |
|
244 | + |
|
245 | + /** |
|
246 | + * constructor |
|
247 | + * |
|
248 | + * @param mixed $data incoming data object|array. Suggested that child classes use type hinting for expected |
|
249 | + * data object. But here parent will be generic because we don't know what's coming in. |
|
250 | + */ |
|
251 | + public function __construct($data) |
|
252 | + { |
|
253 | + $this->_data = $data; |
|
254 | + $this->_setup_data(); |
|
255 | + } |
|
256 | + |
|
257 | + |
|
258 | + /** |
|
259 | + * Every child class has to setup the data object ! |
|
260 | + * |
|
261 | + * @return void |
|
262 | + */ |
|
263 | + abstract protected function _setup_data(); |
|
264 | + |
|
265 | + |
|
266 | + /** |
|
267 | + * Returns database safe representation of the data later used to when instantiating this object. |
|
268 | + * |
|
269 | + * @param mixed $data The incoming data to be prepped. |
|
270 | + * @return mixed The prepped data for db |
|
271 | + */ |
|
272 | + public static function convert_data_for_persistent_storage($data) |
|
273 | + { |
|
274 | + return $data; |
|
275 | + } |
|
276 | + |
|
277 | + |
|
278 | + /** |
|
279 | + * Data that has been stored in persistent storage that was prepped by _convert_data_for_persistent_storage |
|
280 | + * can be sent into this method and converted back into the format used for instantiating with this data handler. |
|
281 | + * |
|
282 | + * @param $data |
|
283 | + * @return mixed |
|
284 | + */ |
|
285 | + public static function convert_data_from_persistent_storage($data) |
|
286 | + { |
|
287 | + return $data; |
|
288 | + } |
|
289 | + |
|
290 | + |
|
291 | + /** |
|
292 | + * only purpose is to return the data |
|
293 | + * |
|
294 | + * @access public |
|
295 | + * @return mixed the formatted data object! |
|
296 | + */ |
|
297 | + public function data() |
|
298 | + { |
|
299 | + return $this->_data; |
|
300 | + } |
|
301 | + |
|
302 | + |
|
303 | + /** |
|
304 | + * This helper method can be used by any incoming data handlers to setup the data correctly. All that is required |
|
305 | + * is that $this->reg_objs be set. |
|
306 | + * |
|
307 | + * @throws EE_Error |
|
308 | + * @throws InvalidDataTypeException |
|
309 | + * @throws InvalidInterfaceException |
|
310 | + * @throws InvalidArgumentException |
|
311 | + * @throws EntityNotFoundException |
|
312 | + */ |
|
313 | + protected function _assemble_data() |
|
314 | + { |
|
315 | + // verify that reg_objs is set |
|
316 | + if ( |
|
317 | + ! is_array($this->reg_objs) |
|
318 | + && ! reset($this->reg_objs) instanceof EE_Registration |
|
319 | + ) { |
|
320 | + throw new EE_Error( |
|
321 | + esc_html__( |
|
322 | + 'In order to assemble the data correctly, the "reg_objs" property must be an array of EE_Registration objects', |
|
323 | + 'event_espresso' |
|
324 | + ) |
|
325 | + ); |
|
326 | + } |
|
327 | + |
|
328 | + // get all attendee and events associated with the registrations in this transaction |
|
329 | + $events = $event_setup = $evtcache = $tickets = $datetimes = array(); |
|
330 | + $answers = $questions = $attendees = $line_items = $registrations = array(); |
|
331 | + $total_ticket_count = 0; |
|
332 | + |
|
333 | + if (! empty($this->reg_objs)) { |
|
334 | + $event_attendee_count = array(); |
|
335 | + /** @var EE_Registration $reg */ |
|
336 | + foreach ($this->reg_objs as $reg) { |
|
337 | + if ( |
|
338 | + $this->_skip_registration_for_processing($reg) |
|
339 | + ) { |
|
340 | + continue; |
|
341 | + } |
|
342 | + |
|
343 | + $evt_id = $reg->event_ID(); |
|
344 | + /** @type EE_Ticket $ticket */ |
|
345 | + $ticket = $reg->get_first_related('Ticket'); |
|
346 | + $attendee = $reg->attendee(); |
|
347 | + $event = $reg->event(); |
|
348 | + // if none of the following entities are available, then we can't setup other data reliably, |
|
349 | + // so let's just skip. |
|
350 | + if ( |
|
351 | + ! $ticket instanceof EE_Ticket |
|
352 | + || ! $attendee instanceof EE_Attendee |
|
353 | + || ! $event instanceof EE_Event |
|
354 | + ) { |
|
355 | + continue; |
|
356 | + } |
|
357 | + $relateddatetime = $ticket->datetimes(); |
|
358 | + $total_ticket_count++; |
|
359 | + $tickets[ $ticket->ID() ]['ticket'] = $ticket; |
|
360 | + $tickets[ $ticket->ID() ]['count'] = is_array($tickets[ $ticket->ID() ]) |
|
361 | + && isset($tickets[ $ticket->ID() ]['count']) |
|
362 | + ? $tickets[ $ticket->ID() ]['count'] + 1 |
|
363 | + : 1; |
|
364 | + $tickets[ $ticket->ID() ]['att_objs'][ $attendee->ID() ] = $attendee; |
|
365 | + $tickets[ $ticket->ID() ]['dtt_objs'] = $relateddatetime; |
|
366 | + $tickets[ $ticket->ID() ]['reg_objs'][ $reg->ID() ] = $reg; |
|
367 | + $tickets[ $ticket->ID() ]['EE_Event'] = $event; |
|
368 | + $evtcache[ $evt_id ] = $event; |
|
369 | + $eventsetup[ $evt_id ]['reg_objs'][ $reg->ID() ] = $reg; |
|
370 | + $eventsetup[ $evt_id ]['tkt_objs'][ $ticket->ID() ] = $ticket; |
|
371 | + $eventsetup[ $evt_id ]['att_objs'][ $attendee->ID() ] = $attendee; |
|
372 | + $event_attendee_count[ $evt_id ] = isset($event_attendee_count[ $evt_id ]) |
|
373 | + ? $event_attendee_count[ $evt_id ] + 1 |
|
374 | + : 0; |
|
375 | + $attendees[ $reg->attendee_ID() ]['line_ref'][] = $evt_id; |
|
376 | + $attendees[ $reg->attendee_ID() ]['att_obj'] = $attendee; |
|
377 | + $attendees[ $reg->attendee_ID() ]['reg_objs'][ $reg->ID() ] = $reg; |
|
378 | + // $attendees[ $reg->attendee_ID() ]['registration_id'] = $reg->ID(); |
|
379 | + $attendees[ $reg->attendee_ID() ]['attendee_email'] = $attendee->email(); |
|
380 | + $attendees[ $reg->attendee_ID() ]['tkt_objs'][ $ticket->ID() ] = $ticket; |
|
381 | + $attendees[ $reg->attendee_ID() ]['evt_objs'][ $evt_id ] = $event; |
|
382 | + |
|
383 | + // registrations |
|
384 | + $registrations[ $reg->ID() ]['tkt_obj'] = $ticket; |
|
385 | + $registrations[ $reg->ID() ]['evt_obj'] = $event; |
|
386 | + $registrations[ $reg->ID() ]['reg_obj'] = $reg; |
|
387 | + $registrations[ $reg->ID() ]['att_obj'] = $attendee; |
|
388 | + |
|
389 | + // set up answer objects |
|
390 | + $rel_ans = $reg->get_many_related('Answer'); |
|
391 | + foreach ($rel_ans as $ansid => $answer) { |
|
392 | + if (! isset($questions[ $ansid ])) { |
|
393 | + $questions[ $ansid ] = $answer->get_first_related('Question'); |
|
394 | + } |
|
395 | + $answers[ $ansid ] = $answer; |
|
396 | + $registrations[ $reg->ID() ]['ans_objs'][ $ansid ] = $answer; |
|
397 | + } |
|
398 | + /** |
|
399 | + * @var int $dtt_id |
|
400 | + * @var EE_Datetime $datetime |
|
401 | + */ |
|
402 | + foreach ($relateddatetime as $dtt_id => $datetime) { |
|
403 | + $eventsetup[ $evt_id ]['dtt_objs'][ $dtt_id ] = $datetime; |
|
404 | + $registrations[ $reg->ID() ]['dtt_objs'][ $dtt_id ] = $datetime; |
|
405 | + |
|
406 | + if (isset($datetimes[ $dtt_id ])) { |
|
407 | + continue; // already have this info in the datetimes array. |
|
408 | + } |
|
409 | + |
|
410 | + $datetimes[ $dtt_id ]['tkt_objs'][] = $ticket; |
|
411 | + $datetimes[ $dtt_id ]['datetime'] = $datetime; |
|
412 | + $datetimes[ $dtt_id ]['evt_objs'][ $evt_id ] = $event; |
|
413 | + $datetimes[ $dtt_id ]['reg_objs'][ $reg->ID() ] = $reg; |
|
414 | + } |
|
415 | + } |
|
416 | + |
|
417 | + // let's loop through the unique event=>reg items and setup data on them |
|
418 | + |
|
419 | + if (! empty($eventsetup)) { |
|
420 | + foreach ($eventsetup as $evt_id => $items) { |
|
421 | + $ticket_line_items_for_event = array(); |
|
422 | + if ($this->txn instanceof EE_Transaction) { |
|
423 | + $ticket_line_items_for_event = EEM_Line_Item::instance()->get_all( |
|
424 | + array( |
|
425 | + array( |
|
426 | + 'Ticket.Datetime.EVT_ID' => $evt_id, |
|
427 | + 'TXN_ID' => $this->txn->ID(), |
|
428 | + ), |
|
429 | + 'default_where_conditions' => 'none', |
|
430 | + ) |
|
431 | + ); |
|
432 | + } |
|
433 | + $events[ $evt_id ] = array( |
|
434 | + 'ID' => $evt_id, |
|
435 | + 'event' => $evtcache[ $evt_id ], |
|
436 | + 'name' => $evtcache[ $evt_id ] instanceof EE_Event ? $evtcache[ $evt_id ]->name() : '', |
|
437 | + 'total_attendees' => $event_attendee_count[ $evt_id ], |
|
438 | + 'reg_objs' => $items['reg_objs'], |
|
439 | + 'tkt_objs' => $items['tkt_objs'], |
|
440 | + 'att_objs' => $items['att_objs'], |
|
441 | + 'dtt_objs' => isset($items['dtt_objs']) ? $items['dtt_objs'] : array(), |
|
442 | + 'line_items' => $ticket_line_items_for_event, |
|
443 | + ); |
|
444 | + |
|
445 | + // make sure the tickets have the line items setup for them. |
|
446 | + foreach ($ticket_line_items_for_event as $line_id => $line_item) { |
|
447 | + // only add the ticket line items if we already have this ticket in the $tickets array. |
|
448 | + if ($line_item instanceof EE_Line_Item && isset($tickets[ $line_item->ticket()->ID() ])) { |
|
449 | + $tickets[ $line_item->ticket()->ID() ]['line_item'] = $line_item; |
|
450 | + $tickets[ $line_item->ticket()->ID() ]['sub_line_items'] = $line_item->children(); |
|
451 | + $line_items[ $line_item->ID() ]['children'] = $line_item->children(); |
|
452 | + $line_items[ $line_item->ID() ]['EE_Ticket'] = $line_item->ticket(); |
|
453 | + } |
|
454 | + } |
|
455 | + } |
|
456 | + } |
|
457 | + |
|
458 | + $this->grand_total_line_item = $this->txn instanceof EE_Transaction |
|
459 | + ? $this->txn->total_line_item() |
|
460 | + : null; |
|
461 | + } |
|
462 | + |
|
463 | + // lets set the attendees and events properties |
|
464 | + $this->attendees = $attendees; |
|
465 | + $this->events = $events; |
|
466 | + $this->tickets = $tickets; |
|
467 | + $this->line_items_with_children = $line_items; |
|
468 | + $this->datetimes = $datetimes; |
|
469 | + $this->questions = $questions; |
|
470 | + $this->answers = $answers; |
|
471 | + $this->total_ticket_count = $total_ticket_count; |
|
472 | + $this->registrations = $registrations; |
|
473 | + |
|
474 | + if ($this->txn instanceof EE_Transaction) { |
|
475 | + $this->tax_line_items = $this->txn->tax_items(); |
|
476 | + $this->additional_line_items = $this->txn->non_ticket_line_items(); |
|
477 | + $this->payments = $this->txn->payments(); |
|
478 | + |
|
479 | + // setup primary registration if we have a single transaction object to work with |
|
480 | + |
|
481 | + // let's get just the primary_attendee_data! First we get the primary registration object. |
|
482 | + $primary_reg = $this->txn->primary_registration(); |
|
483 | + // verify |
|
484 | + if ($primary_reg instanceof EE_Registration) { |
|
485 | + // get attendee object |
|
486 | + if ($primary_reg->attendee() instanceof EE_Attendee) { |
|
487 | + // now we can setup the primary_attendee_data array |
|
488 | + $this->primary_attendee_data = array( |
|
489 | + 'registration_id' => $primary_reg->ID(), |
|
490 | + 'att_obj' => $primary_reg->attendee(), |
|
491 | + 'reg_obj' => $primary_reg, |
|
492 | + 'primary_att_obj' => $primary_reg->attendee(), |
|
493 | + 'primary_reg_obj' => $primary_reg, |
|
494 | + ); |
|
495 | + } else { |
|
496 | + EE_Error::add_error( |
|
497 | + esc_html__( |
|
498 | + 'Incoming data does not have a valid Attendee object for the primary registrant.', |
|
499 | + 'event_espresso' |
|
500 | + ), |
|
501 | + __FILE__, |
|
502 | + __FUNCTION__, |
|
503 | + __LINE__ |
|
504 | + ); |
|
505 | + } |
|
506 | + } else { |
|
507 | + EE_Error::add_error( |
|
508 | + esc_html__( |
|
509 | + 'Incoming data does not have a valid Registration object for the primary registrant.', |
|
510 | + 'event_espresso' |
|
511 | + ), |
|
512 | + __FILE__, |
|
513 | + __FUNCTION__, |
|
514 | + __LINE__ |
|
515 | + ); |
|
516 | + } |
|
517 | + } |
|
518 | + } |
|
519 | + |
|
520 | + /** |
|
521 | + * This simply considers whether the given registration should be processed or not based on comparison with the |
|
522 | + * filtered_reg_status property. |
|
523 | + * |
|
524 | + * @param EE_Registration $registration |
|
525 | + * @return bool returning true means we DO want to skip processing. returning false means we DON'T want to skip |
|
526 | + * processing |
|
527 | + */ |
|
528 | + protected function _skip_registration_for_processing(EE_Registration $registration) |
|
529 | + { |
|
530 | + if (empty($this->filtered_reg_status)) { |
|
531 | + return false; |
|
532 | + } |
|
533 | + |
|
534 | + // if we made it here then we just compare the filtered_reg_status with the registration status and return that |
|
535 | + return $this->filtered_reg_status !== $registration->status_ID(); |
|
536 | + } |
|
537 | 537 | } |
@@ -83,7 +83,7 @@ discard block |
||
83 | 83 | private function _get_recipient_ticket_list_parsed(EE_Messages_Addressee $data, $primary = false) |
84 | 84 | { |
85 | 85 | $registration = $primary ? $data->primary_reg_obj : $data->reg_obj; |
86 | - if (! $registration instanceof EE_Registration) { |
|
86 | + if ( ! $registration instanceof EE_Registration) { |
|
87 | 87 | return ''; |
88 | 88 | } |
89 | 89 | // setup valid shortcodes depending on what the status of the $this->_data property is |
@@ -97,7 +97,7 @@ discard block |
||
97 | 97 | 'attendee', |
98 | 98 | ); |
99 | 99 | $template = $this->_data['template']; |
100 | - $tkts = array($data->registrations[ $registration->ID() ]['tkt_obj']); |
|
100 | + $tkts = array($data->registrations[$registration->ID()]['tkt_obj']); |
|
101 | 101 | $data = $this->_data; |
102 | 102 | } elseif ($this->_data['data'] instanceof EE_Event) { |
103 | 103 | $valid_shortcodes = array('ticket', 'attendee_list', 'datetime_list', 'attendee'); |
@@ -127,16 +127,16 @@ discard block |
||
127 | 127 | |
128 | 128 | private function _get_tickets_from_event(EE_Event $event, $reg = null) |
129 | 129 | { |
130 | - $evt_tkts = isset($this->_extra_data['data']->events) ? $this->_extra_data['data']->events[ $event->ID( |
|
131 | - ) ]['tkt_objs'] : array(); |
|
130 | + $evt_tkts = isset($this->_extra_data['data']->events) ? $this->_extra_data['data']->events[$event->ID( |
|
131 | + )]['tkt_objs'] : array(); |
|
132 | 132 | |
133 | 133 | if ($reg instanceof EE_Registration && $this->_extra_data['data'] instanceof EE_Messages_Addressee) { |
134 | 134 | $adj_tkts = array(); |
135 | 135 | // return only tickets for the given attendee |
136 | 136 | foreach ($evt_tkts as $tkt) { |
137 | 137 | if ( |
138 | - isset($this->_extra_data['data']->registrations[ $reg->ID() ]['tkt_obj']) |
|
139 | - && $this->_extra_data['data']->registrations[ $reg->ID() ]['tkt_obj']->ID() == $tkt->ID() |
|
138 | + isset($this->_extra_data['data']->registrations[$reg->ID()]['tkt_obj']) |
|
139 | + && $this->_extra_data['data']->registrations[$reg->ID()]['tkt_obj']->ID() == $tkt->ID() |
|
140 | 140 | ) { |
141 | 141 | $adj_tkts[] = $tkt; |
142 | 142 | } |
@@ -172,14 +172,14 @@ discard block |
||
172 | 172 | private function _get_recipient_datetime_list_parsed(EE_Messages_Addressee $data, $primary = false) |
173 | 173 | { |
174 | 174 | $registration = $primary ? $data->primary_reg_obj : $data->reg_obj; |
175 | - if (! $registration instanceof EE_Registration) { |
|
175 | + if ( ! $registration instanceof EE_Registration) { |
|
176 | 176 | return ''; |
177 | 177 | } |
178 | 178 | // setup valid shortcodes depending on what the status of the $this->_data property is |
179 | 179 | if ($this->_data['data'] instanceof EE_Messages_Addressee) { |
180 | 180 | $valid_shortcodes = array('datetime', 'attendee'); |
181 | 181 | $template = $this->_data['template']; |
182 | - $dtts = $data->registrations[ $registration->ID() ]['dtt_objs']; |
|
182 | + $dtts = $data->registrations[$registration->ID()]['dtt_objs']; |
|
183 | 183 | $data = $this->_data; |
184 | 184 | } elseif ($this->_data['data'] instanceof EE_Event) { |
185 | 185 | $valid_shortcodes = array('datetime', 'attendee'); |
@@ -206,14 +206,14 @@ discard block |
||
206 | 206 | |
207 | 207 | private function _get_datetimes_from_event(EE_Event $event, $reg = null) |
208 | 208 | { |
209 | - $evt_dtts = isset($this->_extra_data['data']->events) ? $this->_extra_data['data']->events[ $event->ID( |
|
210 | - ) ]['dtt_objs'] : array(); |
|
209 | + $evt_dtts = isset($this->_extra_data['data']->events) ? $this->_extra_data['data']->events[$event->ID( |
|
210 | + )]['dtt_objs'] : array(); |
|
211 | 211 | |
212 | 212 | if ($reg instanceof EE_Registration && $this->_extra_data['data'] instanceof EE_Messages_Addressee) { |
213 | 213 | $adj_dtts = array(); |
214 | 214 | // return only dtts for the given attendee |
215 | 215 | foreach ($evt_dtts as $dtt) { |
216 | - if (isset($this->_extra_data['data']->registrations[ $reg->ID() ]['dtt_objs'][ $dtt->ID() ])) { |
|
216 | + if (isset($this->_extra_data['data']->registrations[$reg->ID()]['dtt_objs'][$dtt->ID()])) { |
|
217 | 217 | $adj_dtts[] = $dtt; |
218 | 218 | } |
219 | 219 | } |
@@ -18,204 +18,204 @@ |
||
18 | 18 | */ |
19 | 19 | class EE_Primary_Registration_List_Shortcodes extends EE_Shortcodes |
20 | 20 | { |
21 | - public function __construct() |
|
22 | - { |
|
23 | - parent::__construct(); |
|
24 | - } |
|
25 | - |
|
26 | - |
|
27 | - protected function _init_props() |
|
28 | - { |
|
29 | - $this->label = esc_html__('Primary Registrant List Shortcodes', 'event_espresso'); |
|
30 | - $this->description = esc_html__( |
|
31 | - 'All shortcodes specific primary registrant recipients list type data.', |
|
32 | - 'event_espresso' |
|
33 | - ); |
|
34 | - $this->_shortcodes = array( |
|
35 | - '[PRIMARY_REGISTRANT_TICKET_LIST]' => esc_html__( |
|
36 | - 'Will output a list of tickets that the primary registration received.', |
|
37 | - 'event_espresso' |
|
38 | - ), |
|
39 | - '[PRIMARY_REGISTRANT_DATETIME_LIST]' => esc_html__( |
|
40 | - 'Will output a list of datetimes that the primary registrant for the transaction has been registered for.', |
|
41 | - 'event_espresso' |
|
42 | - ), |
|
43 | - ); |
|
44 | - } |
|
45 | - |
|
46 | - |
|
47 | - protected function _parser($shortcode) |
|
48 | - { |
|
49 | - switch ($shortcode) { |
|
50 | - case '[PRIMARY_REGISTRANT_TICKET_LIST]': |
|
51 | - return $this->_get_recipient_ticket_list(true); |
|
52 | - |
|
53 | - case '[PRIMARY_REGISTRANT_DATETIME_LIST]': |
|
54 | - return $this->_get_recipient_datetime_list(true); |
|
55 | - } |
|
56 | - return ''; |
|
57 | - } |
|
58 | - |
|
59 | - |
|
60 | - /** |
|
61 | - * figure out what the incoming data is and then return the appropriate parsed value |
|
62 | - * |
|
63 | - * @param boolean $primary whether we're getting the primary registrant ticket_list. |
|
64 | - * @return string |
|
65 | - */ |
|
66 | - private function _get_recipient_ticket_list($primary = false) |
|
67 | - { |
|
68 | - $this->_validate_list_requirements(); |
|
69 | - |
|
70 | - if ($this->_data['data'] instanceof EE_Messages_Addressee) { |
|
71 | - return $this->_get_recipient_ticket_list_parsed($this->_data['data'], $primary); |
|
72 | - } elseif ($this->_extra_data['data'] instanceof EE_Messages_Addressee) { |
|
73 | - return $this->_get_recipient_ticket_list_parsed($this->_extra_data['data'], $primary); |
|
74 | - } else { |
|
75 | - return ''; |
|
76 | - } |
|
77 | - } |
|
78 | - |
|
79 | - |
|
80 | - private function _get_recipient_ticket_list_parsed(EE_Messages_Addressee $data, $primary = false) |
|
81 | - { |
|
82 | - $registration = $primary ? $data->primary_reg_obj : $data->reg_obj; |
|
83 | - if (! $registration instanceof EE_Registration) { |
|
84 | - return ''; |
|
85 | - } |
|
86 | - // setup valid shortcodes depending on what the status of the $this->_data property is |
|
87 | - if ($this->_data['data'] instanceof EE_Messages_Addressee) { |
|
88 | - $valid_shortcodes = array( |
|
89 | - 'ticket', |
|
90 | - 'event_list', |
|
91 | - 'attendee_list', |
|
92 | - 'datetime_list', |
|
93 | - 'registration_details', |
|
94 | - 'attendee', |
|
95 | - ); |
|
96 | - $template = $this->_data['template']; |
|
97 | - $tkts = array($data->registrations[ $registration->ID() ]['tkt_obj']); |
|
98 | - $data = $this->_data; |
|
99 | - } elseif ($this->_data['data'] instanceof EE_Event) { |
|
100 | - $valid_shortcodes = array('ticket', 'attendee_list', 'datetime_list', 'attendee'); |
|
101 | - $template = is_array($this->_data['template']) && isset($this->_data['template']['ticket_list']) |
|
102 | - ? $this->_data['template']['ticket_list'] : $this->_extra_data['template']['ticket_list']; |
|
103 | - // let's remove any existing [EVENT_LIST] shortcode from the ticket list template so that we don't get recursion. |
|
104 | - $template = str_replace('[EVENT_LIST]', '', $template); |
|
105 | - // data will be tickets for this event for this recipient. |
|
106 | - $tkts = $this->_get_tickets_from_event($this->_data['data'], $registration); |
|
107 | - $data = $this->_extra_data; |
|
108 | - } else { |
|
109 | - return ''; |
|
110 | - } |
|
111 | - |
|
112 | - $tktparsed = ''; |
|
113 | - foreach ($tkts as $ticket) { |
|
114 | - $tktparsed .= $this->_shortcode_helper->parse_ticket_list_template( |
|
115 | - $template, |
|
116 | - $ticket, |
|
117 | - $valid_shortcodes, |
|
118 | - $data |
|
119 | - ); |
|
120 | - } |
|
121 | - return $tktparsed; |
|
122 | - } |
|
123 | - |
|
124 | - |
|
125 | - private function _get_tickets_from_event(EE_Event $event, $reg = null) |
|
126 | - { |
|
127 | - $evt_tkts = isset($this->_extra_data['data']->events) ? $this->_extra_data['data']->events[ $event->ID( |
|
128 | - ) ]['tkt_objs'] : array(); |
|
129 | - |
|
130 | - if ($reg instanceof EE_Registration && $this->_extra_data['data'] instanceof EE_Messages_Addressee) { |
|
131 | - $adj_tkts = array(); |
|
132 | - // return only tickets for the given attendee |
|
133 | - foreach ($evt_tkts as $tkt) { |
|
134 | - if ( |
|
135 | - isset($this->_extra_data['data']->registrations[ $reg->ID() ]['tkt_obj']) |
|
136 | - && $this->_extra_data['data']->registrations[ $reg->ID() ]['tkt_obj']->ID() == $tkt->ID() |
|
137 | - ) { |
|
138 | - $adj_tkts[] = $tkt; |
|
139 | - } |
|
140 | - } |
|
141 | - $evt_tkts = $adj_tkts; |
|
142 | - } |
|
143 | - return $evt_tkts; |
|
144 | - } |
|
145 | - |
|
146 | - |
|
147 | - /** |
|
148 | - * figure out what the incoming data is and then return the appropriate parsed value |
|
149 | - * |
|
150 | - * @param boolean $primary whether we're getting the primary registrant ticket_list. |
|
151 | - * @return string |
|
152 | - */ |
|
153 | - private function _get_recipient_datetime_list($primary = false) |
|
154 | - { |
|
155 | - $this->_validate_list_requirements(); |
|
156 | - |
|
157 | - if ($this->_data['data'] instanceof EE_Messages_Addressee) { |
|
158 | - return $this->_get_recipient_datetime_list_parsed($this->_data['data'], $primary); |
|
159 | - } elseif ($this->_extra_data['data'] instanceof EE_Messages_Addressee) { |
|
160 | - return $this->_get_recipient_datetime_list_parsed($this->_extra_data['data'], $primary); |
|
161 | - } else { |
|
162 | - return ''; |
|
163 | - } |
|
164 | - |
|
165 | - return $this->_get_recipient_datetime_list_parsed($this->_data['data'], $primary); |
|
166 | - } |
|
167 | - |
|
168 | - |
|
169 | - private function _get_recipient_datetime_list_parsed(EE_Messages_Addressee $data, $primary = false) |
|
170 | - { |
|
171 | - $registration = $primary ? $data->primary_reg_obj : $data->reg_obj; |
|
172 | - if (! $registration instanceof EE_Registration) { |
|
173 | - return ''; |
|
174 | - } |
|
175 | - // setup valid shortcodes depending on what the status of the $this->_data property is |
|
176 | - if ($this->_data['data'] instanceof EE_Messages_Addressee) { |
|
177 | - $valid_shortcodes = array('datetime', 'attendee'); |
|
178 | - $template = $this->_data['template']; |
|
179 | - $dtts = $data->registrations[ $registration->ID() ]['dtt_objs']; |
|
180 | - $data = $this->_data; |
|
181 | - } elseif ($this->_data['data'] instanceof EE_Event) { |
|
182 | - $valid_shortcodes = array('datetime', 'attendee'); |
|
183 | - $template = is_array($this->_data['template']) && isset($this->_data['template']['datetime_list']) |
|
184 | - ? $this->_data['template']['datetime_list'] : $this->_extra_data['template']['datetime_list']; |
|
185 | - $dtts = $this->_get_datetimes_from_event($this->_data['data'], $registration); |
|
186 | - $data = $this->_extra_data; |
|
187 | - } else { |
|
188 | - return ''; |
|
189 | - } |
|
190 | - |
|
191 | - $dtt_parsed = ''; |
|
192 | - foreach ($dtts as $datetime) { |
|
193 | - $dtt_parsed .= $this->_shortcode_helper->parse_datetime_list_template( |
|
194 | - $template, |
|
195 | - $datetime, |
|
196 | - $valid_shortcodes, |
|
197 | - $this->_extra_data |
|
198 | - ); |
|
199 | - } |
|
200 | - return $dtt_parsed; |
|
201 | - } |
|
202 | - |
|
203 | - |
|
204 | - private function _get_datetimes_from_event(EE_Event $event, $reg = null) |
|
205 | - { |
|
206 | - $evt_dtts = isset($this->_extra_data['data']->events) ? $this->_extra_data['data']->events[ $event->ID( |
|
207 | - ) ]['dtt_objs'] : array(); |
|
208 | - |
|
209 | - if ($reg instanceof EE_Registration && $this->_extra_data['data'] instanceof EE_Messages_Addressee) { |
|
210 | - $adj_dtts = array(); |
|
211 | - // return only dtts for the given attendee |
|
212 | - foreach ($evt_dtts as $dtt) { |
|
213 | - if (isset($this->_extra_data['data']->registrations[ $reg->ID() ]['dtt_objs'][ $dtt->ID() ])) { |
|
214 | - $adj_dtts[] = $dtt; |
|
215 | - } |
|
216 | - } |
|
217 | - $evt_dtts = $adj_dtts; |
|
218 | - } |
|
219 | - return $evt_dtts; |
|
220 | - } |
|
21 | + public function __construct() |
|
22 | + { |
|
23 | + parent::__construct(); |
|
24 | + } |
|
25 | + |
|
26 | + |
|
27 | + protected function _init_props() |
|
28 | + { |
|
29 | + $this->label = esc_html__('Primary Registrant List Shortcodes', 'event_espresso'); |
|
30 | + $this->description = esc_html__( |
|
31 | + 'All shortcodes specific primary registrant recipients list type data.', |
|
32 | + 'event_espresso' |
|
33 | + ); |
|
34 | + $this->_shortcodes = array( |
|
35 | + '[PRIMARY_REGISTRANT_TICKET_LIST]' => esc_html__( |
|
36 | + 'Will output a list of tickets that the primary registration received.', |
|
37 | + 'event_espresso' |
|
38 | + ), |
|
39 | + '[PRIMARY_REGISTRANT_DATETIME_LIST]' => esc_html__( |
|
40 | + 'Will output a list of datetimes that the primary registrant for the transaction has been registered for.', |
|
41 | + 'event_espresso' |
|
42 | + ), |
|
43 | + ); |
|
44 | + } |
|
45 | + |
|
46 | + |
|
47 | + protected function _parser($shortcode) |
|
48 | + { |
|
49 | + switch ($shortcode) { |
|
50 | + case '[PRIMARY_REGISTRANT_TICKET_LIST]': |
|
51 | + return $this->_get_recipient_ticket_list(true); |
|
52 | + |
|
53 | + case '[PRIMARY_REGISTRANT_DATETIME_LIST]': |
|
54 | + return $this->_get_recipient_datetime_list(true); |
|
55 | + } |
|
56 | + return ''; |
|
57 | + } |
|
58 | + |
|
59 | + |
|
60 | + /** |
|
61 | + * figure out what the incoming data is and then return the appropriate parsed value |
|
62 | + * |
|
63 | + * @param boolean $primary whether we're getting the primary registrant ticket_list. |
|
64 | + * @return string |
|
65 | + */ |
|
66 | + private function _get_recipient_ticket_list($primary = false) |
|
67 | + { |
|
68 | + $this->_validate_list_requirements(); |
|
69 | + |
|
70 | + if ($this->_data['data'] instanceof EE_Messages_Addressee) { |
|
71 | + return $this->_get_recipient_ticket_list_parsed($this->_data['data'], $primary); |
|
72 | + } elseif ($this->_extra_data['data'] instanceof EE_Messages_Addressee) { |
|
73 | + return $this->_get_recipient_ticket_list_parsed($this->_extra_data['data'], $primary); |
|
74 | + } else { |
|
75 | + return ''; |
|
76 | + } |
|
77 | + } |
|
78 | + |
|
79 | + |
|
80 | + private function _get_recipient_ticket_list_parsed(EE_Messages_Addressee $data, $primary = false) |
|
81 | + { |
|
82 | + $registration = $primary ? $data->primary_reg_obj : $data->reg_obj; |
|
83 | + if (! $registration instanceof EE_Registration) { |
|
84 | + return ''; |
|
85 | + } |
|
86 | + // setup valid shortcodes depending on what the status of the $this->_data property is |
|
87 | + if ($this->_data['data'] instanceof EE_Messages_Addressee) { |
|
88 | + $valid_shortcodes = array( |
|
89 | + 'ticket', |
|
90 | + 'event_list', |
|
91 | + 'attendee_list', |
|
92 | + 'datetime_list', |
|
93 | + 'registration_details', |
|
94 | + 'attendee', |
|
95 | + ); |
|
96 | + $template = $this->_data['template']; |
|
97 | + $tkts = array($data->registrations[ $registration->ID() ]['tkt_obj']); |
|
98 | + $data = $this->_data; |
|
99 | + } elseif ($this->_data['data'] instanceof EE_Event) { |
|
100 | + $valid_shortcodes = array('ticket', 'attendee_list', 'datetime_list', 'attendee'); |
|
101 | + $template = is_array($this->_data['template']) && isset($this->_data['template']['ticket_list']) |
|
102 | + ? $this->_data['template']['ticket_list'] : $this->_extra_data['template']['ticket_list']; |
|
103 | + // let's remove any existing [EVENT_LIST] shortcode from the ticket list template so that we don't get recursion. |
|
104 | + $template = str_replace('[EVENT_LIST]', '', $template); |
|
105 | + // data will be tickets for this event for this recipient. |
|
106 | + $tkts = $this->_get_tickets_from_event($this->_data['data'], $registration); |
|
107 | + $data = $this->_extra_data; |
|
108 | + } else { |
|
109 | + return ''; |
|
110 | + } |
|
111 | + |
|
112 | + $tktparsed = ''; |
|
113 | + foreach ($tkts as $ticket) { |
|
114 | + $tktparsed .= $this->_shortcode_helper->parse_ticket_list_template( |
|
115 | + $template, |
|
116 | + $ticket, |
|
117 | + $valid_shortcodes, |
|
118 | + $data |
|
119 | + ); |
|
120 | + } |
|
121 | + return $tktparsed; |
|
122 | + } |
|
123 | + |
|
124 | + |
|
125 | + private function _get_tickets_from_event(EE_Event $event, $reg = null) |
|
126 | + { |
|
127 | + $evt_tkts = isset($this->_extra_data['data']->events) ? $this->_extra_data['data']->events[ $event->ID( |
|
128 | + ) ]['tkt_objs'] : array(); |
|
129 | + |
|
130 | + if ($reg instanceof EE_Registration && $this->_extra_data['data'] instanceof EE_Messages_Addressee) { |
|
131 | + $adj_tkts = array(); |
|
132 | + // return only tickets for the given attendee |
|
133 | + foreach ($evt_tkts as $tkt) { |
|
134 | + if ( |
|
135 | + isset($this->_extra_data['data']->registrations[ $reg->ID() ]['tkt_obj']) |
|
136 | + && $this->_extra_data['data']->registrations[ $reg->ID() ]['tkt_obj']->ID() == $tkt->ID() |
|
137 | + ) { |
|
138 | + $adj_tkts[] = $tkt; |
|
139 | + } |
|
140 | + } |
|
141 | + $evt_tkts = $adj_tkts; |
|
142 | + } |
|
143 | + return $evt_tkts; |
|
144 | + } |
|
145 | + |
|
146 | + |
|
147 | + /** |
|
148 | + * figure out what the incoming data is and then return the appropriate parsed value |
|
149 | + * |
|
150 | + * @param boolean $primary whether we're getting the primary registrant ticket_list. |
|
151 | + * @return string |
|
152 | + */ |
|
153 | + private function _get_recipient_datetime_list($primary = false) |
|
154 | + { |
|
155 | + $this->_validate_list_requirements(); |
|
156 | + |
|
157 | + if ($this->_data['data'] instanceof EE_Messages_Addressee) { |
|
158 | + return $this->_get_recipient_datetime_list_parsed($this->_data['data'], $primary); |
|
159 | + } elseif ($this->_extra_data['data'] instanceof EE_Messages_Addressee) { |
|
160 | + return $this->_get_recipient_datetime_list_parsed($this->_extra_data['data'], $primary); |
|
161 | + } else { |
|
162 | + return ''; |
|
163 | + } |
|
164 | + |
|
165 | + return $this->_get_recipient_datetime_list_parsed($this->_data['data'], $primary); |
|
166 | + } |
|
167 | + |
|
168 | + |
|
169 | + private function _get_recipient_datetime_list_parsed(EE_Messages_Addressee $data, $primary = false) |
|
170 | + { |
|
171 | + $registration = $primary ? $data->primary_reg_obj : $data->reg_obj; |
|
172 | + if (! $registration instanceof EE_Registration) { |
|
173 | + return ''; |
|
174 | + } |
|
175 | + // setup valid shortcodes depending on what the status of the $this->_data property is |
|
176 | + if ($this->_data['data'] instanceof EE_Messages_Addressee) { |
|
177 | + $valid_shortcodes = array('datetime', 'attendee'); |
|
178 | + $template = $this->_data['template']; |
|
179 | + $dtts = $data->registrations[ $registration->ID() ]['dtt_objs']; |
|
180 | + $data = $this->_data; |
|
181 | + } elseif ($this->_data['data'] instanceof EE_Event) { |
|
182 | + $valid_shortcodes = array('datetime', 'attendee'); |
|
183 | + $template = is_array($this->_data['template']) && isset($this->_data['template']['datetime_list']) |
|
184 | + ? $this->_data['template']['datetime_list'] : $this->_extra_data['template']['datetime_list']; |
|
185 | + $dtts = $this->_get_datetimes_from_event($this->_data['data'], $registration); |
|
186 | + $data = $this->_extra_data; |
|
187 | + } else { |
|
188 | + return ''; |
|
189 | + } |
|
190 | + |
|
191 | + $dtt_parsed = ''; |
|
192 | + foreach ($dtts as $datetime) { |
|
193 | + $dtt_parsed .= $this->_shortcode_helper->parse_datetime_list_template( |
|
194 | + $template, |
|
195 | + $datetime, |
|
196 | + $valid_shortcodes, |
|
197 | + $this->_extra_data |
|
198 | + ); |
|
199 | + } |
|
200 | + return $dtt_parsed; |
|
201 | + } |
|
202 | + |
|
203 | + |
|
204 | + private function _get_datetimes_from_event(EE_Event $event, $reg = null) |
|
205 | + { |
|
206 | + $evt_dtts = isset($this->_extra_data['data']->events) ? $this->_extra_data['data']->events[ $event->ID( |
|
207 | + ) ]['dtt_objs'] : array(); |
|
208 | + |
|
209 | + if ($reg instanceof EE_Registration && $this->_extra_data['data'] instanceof EE_Messages_Addressee) { |
|
210 | + $adj_dtts = array(); |
|
211 | + // return only dtts for the given attendee |
|
212 | + foreach ($evt_dtts as $dtt) { |
|
213 | + if (isset($this->_extra_data['data']->registrations[ $reg->ID() ]['dtt_objs'][ $dtt->ID() ])) { |
|
214 | + $adj_dtts[] = $dtt; |
|
215 | + } |
|
216 | + } |
|
217 | + $evt_dtts = $adj_dtts; |
|
218 | + } |
|
219 | + return $evt_dtts; |
|
220 | + } |
|
221 | 221 | } |
@@ -45,12 +45,12 @@ discard block |
||
45 | 45 | if (empty($sibling_section_name)) { |
46 | 46 | continue; |
47 | 47 | } |
48 | - $sibling_section = $this->find_section_from_path('../' . $sibling_section_name); |
|
48 | + $sibling_section = $this->find_section_from_path('../'.$sibling_section_name); |
|
49 | 49 | if ( |
50 | 50 | $sibling_section instanceof EE_Form_Section_Base |
51 | 51 | && ! empty($sibling_section_name) |
52 | 52 | ) { |
53 | - $sibling_sections[ $sibling_section_name ] = $sibling_section; |
|
53 | + $sibling_sections[$sibling_section_name] = $sibling_section; |
|
54 | 54 | } |
55 | 55 | } |
56 | 56 | return $sibling_sections; |
@@ -66,14 +66,14 @@ discard block |
||
66 | 66 | public function get_other_js_data($form_other_js_data = array()) |
67 | 67 | { |
68 | 68 | $form_other_js_data = parent::get_other_js_data($form_other_js_data); |
69 | - if (! isset($form_other_js_data['select_reveal_inputs'])) { |
|
69 | + if ( ! isset($form_other_js_data['select_reveal_inputs'])) { |
|
70 | 70 | $form_other_js_data['select_reveal_inputs'] = array(); |
71 | 71 | } |
72 | 72 | $sibling_input_to_html_id_map = array(); |
73 | 73 | foreach ($this->sibling_sections_controlled() as $sibling_section_path => $sibling_section) { |
74 | - $sibling_input_to_html_id_map[ $sibling_section_path ] = $sibling_section->html_id(); |
|
74 | + $sibling_input_to_html_id_map[$sibling_section_path] = $sibling_section->html_id(); |
|
75 | 75 | } |
76 | - $form_other_js_data['select_reveal_inputs'][ $this->html_id() ] = $sibling_input_to_html_id_map; |
|
76 | + $form_other_js_data['select_reveal_inputs'][$this->html_id()] = $sibling_input_to_html_id_map; |
|
77 | 77 | return $form_other_js_data; |
78 | 78 | } |
79 | 79 | } |
@@ -14,65 +14,65 @@ |
||
14 | 14 | */ |
15 | 15 | class EE_Select_Reveal_Input extends EE_Select_Input |
16 | 16 | { |
17 | - /** |
|
18 | - * @param array $answer_options Array keys which match a sibling section's name |
|
19 | - * will show/unhide that sibling subsection. Otherwise, siblings whose names |
|
20 | - * match array keys of $answer_options are hidden. |
|
21 | - * Note: internally each array key is considered a relative form input path |
|
22 | - * (see EE_Form_Section_Base::find_section_from_path) but relative |
|
23 | - * to THIS INPUT's PARENT section, not this input itself. ie, |
|
24 | - * a '../' is automatically added onto each each array key, to produce |
|
25 | - * the relative form input path. |
|
26 | - * Note however: array keys which are an EMPTY STRING are left as-is |
|
27 | - * |
|
28 | - * @param array $input_settings |
|
29 | - */ |
|
30 | - public function __construct($answer_options, $input_settings = array()) |
|
31 | - { |
|
32 | - parent::__construct($answer_options, $input_settings); |
|
33 | - } |
|
17 | + /** |
|
18 | + * @param array $answer_options Array keys which match a sibling section's name |
|
19 | + * will show/unhide that sibling subsection. Otherwise, siblings whose names |
|
20 | + * match array keys of $answer_options are hidden. |
|
21 | + * Note: internally each array key is considered a relative form input path |
|
22 | + * (see EE_Form_Section_Base::find_section_from_path) but relative |
|
23 | + * to THIS INPUT's PARENT section, not this input itself. ie, |
|
24 | + * a '../' is automatically added onto each each array key, to produce |
|
25 | + * the relative form input path. |
|
26 | + * Note however: array keys which are an EMPTY STRING are left as-is |
|
27 | + * |
|
28 | + * @param array $input_settings |
|
29 | + */ |
|
30 | + public function __construct($answer_options, $input_settings = array()) |
|
31 | + { |
|
32 | + parent::__construct($answer_options, $input_settings); |
|
33 | + } |
|
34 | 34 | |
35 | - /** |
|
36 | - * Gets all the sibling sections controlled by this reveal select input |
|
37 | - * @return \EE_Form_Section_Base[] keys are their form section paths |
|
38 | - */ |
|
39 | - public function sibling_sections_controlled() |
|
40 | - { |
|
41 | - $sibling_sections = array(); |
|
42 | - foreach ($this->options() as $sibling_section_name => $sibling_section) { |
|
43 | - // if it's an empty string just leave it alone |
|
44 | - if (empty($sibling_section_name)) { |
|
45 | - continue; |
|
46 | - } |
|
47 | - $sibling_section = $this->find_section_from_path('../' . $sibling_section_name); |
|
48 | - if ( |
|
49 | - $sibling_section instanceof EE_Form_Section_Base |
|
50 | - && ! empty($sibling_section_name) |
|
51 | - ) { |
|
52 | - $sibling_sections[ $sibling_section_name ] = $sibling_section; |
|
53 | - } |
|
54 | - } |
|
55 | - return $sibling_sections; |
|
56 | - } |
|
35 | + /** |
|
36 | + * Gets all the sibling sections controlled by this reveal select input |
|
37 | + * @return \EE_Form_Section_Base[] keys are their form section paths |
|
38 | + */ |
|
39 | + public function sibling_sections_controlled() |
|
40 | + { |
|
41 | + $sibling_sections = array(); |
|
42 | + foreach ($this->options() as $sibling_section_name => $sibling_section) { |
|
43 | + // if it's an empty string just leave it alone |
|
44 | + if (empty($sibling_section_name)) { |
|
45 | + continue; |
|
46 | + } |
|
47 | + $sibling_section = $this->find_section_from_path('../' . $sibling_section_name); |
|
48 | + if ( |
|
49 | + $sibling_section instanceof EE_Form_Section_Base |
|
50 | + && ! empty($sibling_section_name) |
|
51 | + ) { |
|
52 | + $sibling_sections[ $sibling_section_name ] = $sibling_section; |
|
53 | + } |
|
54 | + } |
|
55 | + return $sibling_sections; |
|
56 | + } |
|
57 | 57 | |
58 | - /** |
|
59 | - * Adds an entry of 'select_reveal_inputs' to the js data, which is an array |
|
60 | - * whose top-level keys are select reveal input html ids; values are arrays |
|
61 | - * whose keys are select option values and values are the sections they reveal |
|
62 | - * @param array $form_other_js_data |
|
63 | - * @return array |
|
64 | - */ |
|
65 | - public function get_other_js_data($form_other_js_data = array()) |
|
66 | - { |
|
67 | - $form_other_js_data = parent::get_other_js_data($form_other_js_data); |
|
68 | - if (! isset($form_other_js_data['select_reveal_inputs'])) { |
|
69 | - $form_other_js_data['select_reveal_inputs'] = array(); |
|
70 | - } |
|
71 | - $sibling_input_to_html_id_map = array(); |
|
72 | - foreach ($this->sibling_sections_controlled() as $sibling_section_path => $sibling_section) { |
|
73 | - $sibling_input_to_html_id_map[ $sibling_section_path ] = $sibling_section->html_id(); |
|
74 | - } |
|
75 | - $form_other_js_data['select_reveal_inputs'][ $this->html_id() ] = $sibling_input_to_html_id_map; |
|
76 | - return $form_other_js_data; |
|
77 | - } |
|
58 | + /** |
|
59 | + * Adds an entry of 'select_reveal_inputs' to the js data, which is an array |
|
60 | + * whose top-level keys are select reveal input html ids; values are arrays |
|
61 | + * whose keys are select option values and values are the sections they reveal |
|
62 | + * @param array $form_other_js_data |
|
63 | + * @return array |
|
64 | + */ |
|
65 | + public function get_other_js_data($form_other_js_data = array()) |
|
66 | + { |
|
67 | + $form_other_js_data = parent::get_other_js_data($form_other_js_data); |
|
68 | + if (! isset($form_other_js_data['select_reveal_inputs'])) { |
|
69 | + $form_other_js_data['select_reveal_inputs'] = array(); |
|
70 | + } |
|
71 | + $sibling_input_to_html_id_map = array(); |
|
72 | + foreach ($this->sibling_sections_controlled() as $sibling_section_path => $sibling_section) { |
|
73 | + $sibling_input_to_html_id_map[ $sibling_section_path ] = $sibling_section->html_id(); |
|
74 | + } |
|
75 | + $form_other_js_data['select_reveal_inputs'][ $this->html_id() ] = $sibling_input_to_html_id_map; |
|
76 | + return $form_other_js_data; |
|
77 | + } |
|
78 | 78 | } |
@@ -11,18 +11,18 @@ |
||
11 | 11 | */ |
12 | 12 | class EE_CCV_Sensitive_Data_Removal extends EE_Sensitive_Data_Removal_Base |
13 | 13 | { |
14 | - public function remove_sensitive_data($normalized_value) |
|
15 | - { |
|
16 | - // Get the ccv Length |
|
17 | - $ccv_lenght = strlen($normalized_value); |
|
18 | - // Replace all characters of credit card except the last four and dashes |
|
19 | - for ($i = 0; $i < $ccv_lenght; $i++) { |
|
20 | - if ($normalized_value[ $i ] == '-') { |
|
21 | - continue; |
|
22 | - } |
|
23 | - $normalized_value[ $i ] = 'X'; |
|
24 | - } |
|
25 | - // Return the masked Credit Card # |
|
26 | - return $normalized_value; |
|
27 | - } |
|
14 | + public function remove_sensitive_data($normalized_value) |
|
15 | + { |
|
16 | + // Get the ccv Length |
|
17 | + $ccv_lenght = strlen($normalized_value); |
|
18 | + // Replace all characters of credit card except the last four and dashes |
|
19 | + for ($i = 0; $i < $ccv_lenght; $i++) { |
|
20 | + if ($normalized_value[ $i ] == '-') { |
|
21 | + continue; |
|
22 | + } |
|
23 | + $normalized_value[ $i ] = 'X'; |
|
24 | + } |
|
25 | + // Return the masked Credit Card # |
|
26 | + return $normalized_value; |
|
27 | + } |
|
28 | 28 | } |
@@ -17,10 +17,10 @@ |
||
17 | 17 | $ccv_lenght = strlen($normalized_value); |
18 | 18 | // Replace all characters of credit card except the last four and dashes |
19 | 19 | for ($i = 0; $i < $ccv_lenght; $i++) { |
20 | - if ($normalized_value[ $i ] == '-') { |
|
20 | + if ($normalized_value[$i] == '-') { |
|
21 | 21 | continue; |
22 | 22 | } |
23 | - $normalized_value[ $i ] = 'X'; |
|
23 | + $normalized_value[$i] = 'X'; |
|
24 | 24 | } |
25 | 25 | // Return the masked Credit Card # |
26 | 26 | return $normalized_value; |
@@ -11,18 +11,18 @@ |
||
11 | 11 | */ |
12 | 12 | class EE_Credit_Card_Sensitive_Data_Removal extends EE_Sensitive_Data_Removal_Base |
13 | 13 | { |
14 | - public function remove_sensitive_data($normalized_value) |
|
15 | - { |
|
16 | - // Get the cc Length |
|
17 | - $cc_length = strlen($normalized_value); |
|
18 | - // Replace all characters of credit card except the last four and dashes |
|
19 | - for ($i = 0; $i < $cc_length - 4; $i++) { |
|
20 | - if ($normalized_value[ $i ] == '-') { |
|
21 | - continue; |
|
22 | - } |
|
23 | - $normalized_value[ $i ] = 'X'; |
|
24 | - } |
|
25 | - // Return the masked Credit Card # |
|
26 | - return $normalized_value; |
|
27 | - } |
|
14 | + public function remove_sensitive_data($normalized_value) |
|
15 | + { |
|
16 | + // Get the cc Length |
|
17 | + $cc_length = strlen($normalized_value); |
|
18 | + // Replace all characters of credit card except the last four and dashes |
|
19 | + for ($i = 0; $i < $cc_length - 4; $i++) { |
|
20 | + if ($normalized_value[ $i ] == '-') { |
|
21 | + continue; |
|
22 | + } |
|
23 | + $normalized_value[ $i ] = 'X'; |
|
24 | + } |
|
25 | + // Return the masked Credit Card # |
|
26 | + return $normalized_value; |
|
27 | + } |
|
28 | 28 | } |
@@ -17,10 +17,10 @@ |
||
17 | 17 | $cc_length = strlen($normalized_value); |
18 | 18 | // Replace all characters of credit card except the last four and dashes |
19 | 19 | for ($i = 0; $i < $cc_length - 4; $i++) { |
20 | - if ($normalized_value[ $i ] == '-') { |
|
20 | + if ($normalized_value[$i] == '-') { |
|
21 | 21 | continue; |
22 | 22 | } |
23 | - $normalized_value[ $i ] = 'X'; |
|
23 | + $normalized_value[$i] = 'X'; |
|
24 | 24 | } |
25 | 25 | // Return the masked Credit Card # |
26 | 26 | return $normalized_value; |
@@ -44,7 +44,7 @@ |
||
44 | 44 | public function get_jquery_validation_rule_array() |
45 | 45 | { |
46 | 46 | if ($this->_max_length !== EE_INF) { |
47 | - return array( 'maxlength' => $this->_max_length, 'messages' => array( 'maxlength' => $this->get_validation_error_message() ) ); |
|
47 | + return array('maxlength' => $this->_max_length, 'messages' => array('maxlength' => $this->get_validation_error_message())); |
|
48 | 48 | } else { |
49 | 49 | return array(); |
50 | 50 | } |
@@ -11,41 +11,41 @@ |
||
11 | 11 | */ |
12 | 12 | class EE_Max_Length_Validation_Strategy extends EE_Validation_Strategy_Base |
13 | 13 | { |
14 | - protected $_max_length; |
|
14 | + protected $_max_length; |
|
15 | 15 | |
16 | - public function __construct($validation_error_message = null, $max_length = EE_INF) |
|
17 | - { |
|
18 | - $this->_max_length = $max_length; |
|
19 | - if ($validation_error_message === null) { |
|
20 | - $validation_error_message = sprintf(esc_html__('Input is too long. Maximum number of characters is %1$s', 'event_espresso'), $max_length); |
|
21 | - } |
|
22 | - parent::__construct($validation_error_message); |
|
23 | - } |
|
16 | + public function __construct($validation_error_message = null, $max_length = EE_INF) |
|
17 | + { |
|
18 | + $this->_max_length = $max_length; |
|
19 | + if ($validation_error_message === null) { |
|
20 | + $validation_error_message = sprintf(esc_html__('Input is too long. Maximum number of characters is %1$s', 'event_espresso'), $max_length); |
|
21 | + } |
|
22 | + parent::__construct($validation_error_message); |
|
23 | + } |
|
24 | 24 | |
25 | - /** |
|
26 | - * @param $normalized_value |
|
27 | - */ |
|
28 | - public function validate($normalized_value) |
|
29 | - { |
|
30 | - if ( |
|
31 | - $this->_max_length !== EE_INF && |
|
32 | - $normalized_value && |
|
33 | - is_string($normalized_value) && |
|
34 | - strlen($normalized_value) > $this->_max_length |
|
35 | - ) { |
|
36 | - throw new EE_Validation_Error($this->get_validation_error_message(), 'maxlength'); |
|
37 | - } |
|
38 | - } |
|
25 | + /** |
|
26 | + * @param $normalized_value |
|
27 | + */ |
|
28 | + public function validate($normalized_value) |
|
29 | + { |
|
30 | + if ( |
|
31 | + $this->_max_length !== EE_INF && |
|
32 | + $normalized_value && |
|
33 | + is_string($normalized_value) && |
|
34 | + strlen($normalized_value) > $this->_max_length |
|
35 | + ) { |
|
36 | + throw new EE_Validation_Error($this->get_validation_error_message(), 'maxlength'); |
|
37 | + } |
|
38 | + } |
|
39 | 39 | |
40 | - /** |
|
41 | - * @return array |
|
42 | - */ |
|
43 | - public function get_jquery_validation_rule_array() |
|
44 | - { |
|
45 | - if ($this->_max_length !== EE_INF) { |
|
46 | - return array( 'maxlength' => $this->_max_length, 'messages' => array( 'maxlength' => $this->get_validation_error_message() ) ); |
|
47 | - } else { |
|
48 | - return array(); |
|
49 | - } |
|
50 | - } |
|
40 | + /** |
|
41 | + * @return array |
|
42 | + */ |
|
43 | + public function get_jquery_validation_rule_array() |
|
44 | + { |
|
45 | + if ($this->_max_length !== EE_INF) { |
|
46 | + return array( 'maxlength' => $this->_max_length, 'messages' => array( 'maxlength' => $this->get_validation_error_message() ) ); |
|
47 | + } else { |
|
48 | + return array(); |
|
49 | + } |
|
50 | + } |
|
51 | 51 | } |
@@ -40,6 +40,6 @@ |
||
40 | 40 | */ |
41 | 41 | public function get_jquery_validation_rule_array() |
42 | 42 | { |
43 | - return array( 'minlength' => $this->_min_length, 'messages' => array( 'minlength' => $this->get_validation_error_message() ) ); |
|
43 | + return array('minlength' => $this->_min_length, 'messages' => array('minlength' => $this->get_validation_error_message())); |
|
44 | 44 | } |
45 | 45 | } |
@@ -11,34 +11,34 @@ |
||
11 | 11 | */ |
12 | 12 | class EE_Min_Length_Validation_Strategy extends EE_Validation_Strategy_Base |
13 | 13 | { |
14 | - protected $_min_length; |
|
14 | + protected $_min_length; |
|
15 | 15 | |
16 | - public function __construct($validation_error_message = null, $min_length = 0) |
|
17 | - { |
|
18 | - $this->_min_length = $min_length; |
|
19 | - parent::__construct($validation_error_message); |
|
20 | - } |
|
16 | + public function __construct($validation_error_message = null, $min_length = 0) |
|
17 | + { |
|
18 | + $this->_min_length = $min_length; |
|
19 | + parent::__construct($validation_error_message); |
|
20 | + } |
|
21 | 21 | |
22 | - /** |
|
23 | - * @param $normalized_value |
|
24 | - */ |
|
25 | - public function validate($normalized_value) |
|
26 | - { |
|
27 | - if ( |
|
28 | - $this->_min_length > 0 && |
|
29 | - $normalized_value && |
|
30 | - is_string($normalized_value) && |
|
31 | - strlen($normalized_value) < $this->_min_length |
|
32 | - ) { |
|
33 | - throw new EE_Validation_Error($this->get_validation_error_message(), 'minlength'); |
|
34 | - } |
|
35 | - } |
|
22 | + /** |
|
23 | + * @param $normalized_value |
|
24 | + */ |
|
25 | + public function validate($normalized_value) |
|
26 | + { |
|
27 | + if ( |
|
28 | + $this->_min_length > 0 && |
|
29 | + $normalized_value && |
|
30 | + is_string($normalized_value) && |
|
31 | + strlen($normalized_value) < $this->_min_length |
|
32 | + ) { |
|
33 | + throw new EE_Validation_Error($this->get_validation_error_message(), 'minlength'); |
|
34 | + } |
|
35 | + } |
|
36 | 36 | |
37 | - /** |
|
38 | - * @return array |
|
39 | - */ |
|
40 | - public function get_jquery_validation_rule_array() |
|
41 | - { |
|
42 | - return array( 'minlength' => $this->_min_length, 'messages' => array( 'minlength' => $this->get_validation_error_message() ) ); |
|
43 | - } |
|
37 | + /** |
|
38 | + * @return array |
|
39 | + */ |
|
40 | + public function get_jquery_validation_rule_array() |
|
41 | + { |
|
42 | + return array( 'minlength' => $this->_min_length, 'messages' => array( 'minlength' => $this->get_validation_error_message() ) ); |
|
43 | + } |
|
44 | 44 | } |
@@ -29,8 +29,8 @@ discard block |
||
29 | 29 | public function validate($normalized_value) |
30 | 30 | { |
31 | 31 | $string_normalized_value = (string) $normalized_value; |
32 | - if ($this->_regex && $string_normalized_value) { |
|
33 | - if (! preg_match($this->_regex, $string_normalized_value)) { |
|
32 | + if ($this->_regex && $string_normalized_value) { |
|
33 | + if ( ! preg_match($this->_regex, $string_normalized_value)) { |
|
34 | 34 | throw new EE_Validation_Error($this->get_validation_error_message(), 'regex'); |
35 | 35 | } |
36 | 36 | } |
@@ -42,7 +42,7 @@ discard block |
||
42 | 42 | public function get_jquery_validation_rule_array() |
43 | 43 | { |
44 | 44 | if ($this->_regex !== null) { |
45 | - return array( 'regex' => $this->regex_js(), 'messages' => array( 'regex' => $this->get_validation_error_message() ) ); |
|
45 | + return array('regex' => $this->regex_js(), 'messages' => array('regex' => $this->get_validation_error_message())); |
|
46 | 46 | } else { |
47 | 47 | return array(); |
48 | 48 | } |
@@ -10,53 +10,53 @@ |
||
10 | 10 | */ |
11 | 11 | class EE_Text_Validation_Strategy extends EE_Validation_Strategy_Base |
12 | 12 | { |
13 | - protected $_regex = null; |
|
14 | - /** |
|
15 | - * |
|
16 | - * @param string $validation_error_message |
|
17 | - * @param string $regex a PHP regex; the javascript regex will be derived from this |
|
18 | - */ |
|
19 | - public function __construct($validation_error_message = null, $regex = null) |
|
20 | - { |
|
21 | - $this->_regex = $regex; |
|
22 | - parent::__construct($validation_error_message); |
|
23 | - } |
|
13 | + protected $_regex = null; |
|
14 | + /** |
|
15 | + * |
|
16 | + * @param string $validation_error_message |
|
17 | + * @param string $regex a PHP regex; the javascript regex will be derived from this |
|
18 | + */ |
|
19 | + public function __construct($validation_error_message = null, $regex = null) |
|
20 | + { |
|
21 | + $this->_regex = $regex; |
|
22 | + parent::__construct($validation_error_message); |
|
23 | + } |
|
24 | 24 | |
25 | - /** |
|
26 | - * @param $normalized_value |
|
27 | - */ |
|
28 | - public function validate($normalized_value) |
|
29 | - { |
|
30 | - $string_normalized_value = (string) $normalized_value; |
|
31 | - if ($this->_regex && $string_normalized_value) { |
|
32 | - if (! preg_match($this->_regex, $string_normalized_value)) { |
|
33 | - throw new EE_Validation_Error($this->get_validation_error_message(), 'regex'); |
|
34 | - } |
|
35 | - } |
|
36 | - } |
|
25 | + /** |
|
26 | + * @param $normalized_value |
|
27 | + */ |
|
28 | + public function validate($normalized_value) |
|
29 | + { |
|
30 | + $string_normalized_value = (string) $normalized_value; |
|
31 | + if ($this->_regex && $string_normalized_value) { |
|
32 | + if (! preg_match($this->_regex, $string_normalized_value)) { |
|
33 | + throw new EE_Validation_Error($this->get_validation_error_message(), 'regex'); |
|
34 | + } |
|
35 | + } |
|
36 | + } |
|
37 | 37 | |
38 | - /** |
|
39 | - * @return array |
|
40 | - */ |
|
41 | - public function get_jquery_validation_rule_array() |
|
42 | - { |
|
43 | - if ($this->_regex !== null) { |
|
44 | - return array( 'regex' => $this->regex_js(), 'messages' => array( 'regex' => $this->get_validation_error_message() ) ); |
|
45 | - } else { |
|
46 | - return array(); |
|
47 | - } |
|
48 | - } |
|
38 | + /** |
|
39 | + * @return array |
|
40 | + */ |
|
41 | + public function get_jquery_validation_rule_array() |
|
42 | + { |
|
43 | + if ($this->_regex !== null) { |
|
44 | + return array( 'regex' => $this->regex_js(), 'messages' => array( 'regex' => $this->get_validation_error_message() ) ); |
|
45 | + } else { |
|
46 | + return array(); |
|
47 | + } |
|
48 | + } |
|
49 | 49 | |
50 | 50 | /** |
51 | 51 | * Translates a PHP regex into a javscript regex (eg, PHP needs separate delimieters, whereas |
52 | 52 | * javscript does not |
53 | 53 | * @return string |
54 | 54 | */ |
55 | - public function regex_js() |
|
56 | - { |
|
57 | - // first character must be the delimiter |
|
58 | - $delimeter = $this->_regex[0]; |
|
59 | - $last_occurence_of_delimieter = strrpos($this->_regex, $delimeter); |
|
60 | - return substr($this->_regex, 1, $last_occurence_of_delimieter - 1); |
|
61 | - } |
|
55 | + public function regex_js() |
|
56 | + { |
|
57 | + // first character must be the delimiter |
|
58 | + $delimeter = $this->_regex[0]; |
|
59 | + $last_occurence_of_delimieter = strrpos($this->_regex, $delimeter); |
|
60 | + return substr($this->_regex, 1, $last_occurence_of_delimieter - 1); |
|
61 | + } |
|
62 | 62 | } |