Completed
Branch master (6d1405)
by
unknown
13:57 queued 12:03
created
admin_pages/venues/Venues_Admin_Page.core.php 1 patch
Indentation   +1556 added lines, -1556 removed lines patch added patch discarded remove patch
@@ -14,1566 +14,1566 @@
 block discarded – undo
14 14
 class Venues_Admin_Page extends EE_Admin_Page_CPT
15 15
 {
16 16
 
17
-    /**
18
-     * _venue
19
-     * This will hold the venue object for venue_details screen.
20
-     *
21
-     * @access protected
22
-     * @var object
23
-     */
24
-    protected $_venue;
25
-
26
-
27
-    /**
28
-     * This will hold the category object for category_details screen.
29
-     *
30
-     * @var object
31
-     */
32
-    protected $_category;
33
-
34
-
35
-    /**
36
-     * This property will hold the venue model instance
37
-     *
38
-     * @var object
39
-     */
40
-    protected $_venue_model;
41
-
42
-
43
-    /**
44
-     * @throws EE_Error
45
-     */
46
-    protected function _init_page_props()
47
-    {
48
-        require_once(EE_MODELS . 'EEM_Venue.model.php');
49
-        $this->page_slug        = EE_VENUES_PG_SLUG;
50
-        $this->_admin_base_url  = EE_VENUES_ADMIN_URL;
51
-        $this->_admin_base_path = EE_ADMIN_PAGES . 'venues';
52
-        $this->page_label       = esc_html__('Event Venues', 'event_espresso');
53
-        $this->_cpt_model_names = [
54
-            'create_new' => 'EEM_Venue',
55
-            'edit'       => 'EEM_Venue',
56
-        ];
57
-        $this->_cpt_edit_routes = [
58
-            'espresso_venues' => 'edit',
59
-        ];
60
-        $this->_venue_model     = EEM_Venue::instance();
61
-    }
62
-
63
-
64
-    protected function _ajax_hooks()
65
-    {
66
-        // todo: all hooks for ee_venues ajax goes in here.
67
-    }
68
-
69
-
70
-    protected function _define_page_props()
71
-    {
72
-        $this->_admin_page_title = $this->page_label;
73
-        $this->_labels           = [
74
-            'buttons'      => [
75
-                'add'             => esc_html__('Add New Venue', 'event_espresso'),
76
-                'edit'            => esc_html__('Edit Venue', 'event_espresso'),
77
-                'delete'          => esc_html__('Delete Venue', 'event_espresso'),
78
-                'add_category'    => esc_html__('Add New Category', 'event_espresso'),
79
-                'edit_category'   => esc_html__('Edit Category', 'event_espresso'),
80
-                'delete_category' => esc_html__('Delete Category', 'event_espresso'),
81
-            ],
82
-            'editor_title' => [
83
-                'espresso_venues' => esc_html__('Enter Venue name here', 'event_espresso'),
84
-            ],
85
-            'publishbox'   => [
86
-                'create_new'          => esc_html__('Save New Venue', 'event_espresso'),
87
-                'edit'                => esc_html__('Update Venue', 'event_espresso'),
88
-                'add_category'        => esc_html__('Save New Category', 'event_espresso'),
89
-                'edit_category'       => esc_html__('Update Category', 'event_espresso'),
90
-                'google_map_settings' => esc_html__('Update Settings', 'event_espresso'),
91
-            ],
92
-        ];
93
-    }
94
-
95
-
96
-    protected function _set_page_routes()
97
-    {
98
-
99
-        // load formatter helper
100
-        // load field generator helper
101
-
102
-        // is there a vnu_id in the request?
103
-        $VNU_ID = $this->request->getRequestParam('VNU_ID', 0, 'int');
104
-        $VNU_ID = $this->request->getRequestParam('post', $VNU_ID, 'int');
105
-
106
-        $this->_page_routes = [
107
-            'default'                    => [
108
-                'func'       => '_overview_list_table',
109
-                'capability' => 'ee_read_venues',
110
-            ],
111
-            'create_new'                 => [
112
-                'func'       => '_create_new_cpt_item',
113
-                'capability' => 'ee_edit_venues',
114
-            ],
115
-            'edit'                       => [
116
-                'func'       => '_edit_cpt_item',
117
-                'capability' => 'ee_edit_venue',
118
-                'obj_id'     => $VNU_ID,
119
-            ],
120
-            'trash_venue'                => [
121
-                'func'       => '_trash_or_restore_venue',
122
-                'args'       => ['venue_status' => 'trash'],
123
-                'noheader'   => true,
124
-                'capability' => 'ee_delete_venue',
125
-                'obj_id'     => $VNU_ID,
126
-            ],
127
-            'trash_venues'               => [
128
-                'func'       => '_trash_or_restore_venues',
129
-                'args'       => ['venue_status' => 'trash'],
130
-                'noheader'   => true,
131
-                'capability' => 'ee_delete_venues',
132
-            ],
133
-            'restore_venue'              => [
134
-                'func'       => '_trash_or_restore_venue',
135
-                'args'       => ['venue_status' => 'draft'],
136
-                'noheader'   => true,
137
-                'capability' => 'ee_delete_venue',
138
-                'obj_id'     => $VNU_ID,
139
-            ],
140
-            'restore_venues'             => [
141
-                'func'       => '_trash_or_restore_venues',
142
-                'args'       => ['venue_status' => 'draft'],
143
-                'noheader'   => true,
144
-                'capability' => 'ee_delete_venues',
145
-            ],
146
-            'delete_venues'              => [
147
-                'func'       => '_delete_venues',
148
-                'noheader'   => true,
149
-                'capability' => 'ee_delete_venues',
150
-            ],
151
-            'delete_venue'               => [
152
-                'func'       => '_delete_venue',
153
-                'noheader'   => true,
154
-                'capability' => 'ee_delete_venue',
155
-                'obj_id'     => $VNU_ID,
156
-            ],
157
-            // settings related
158
-            'google_map_settings'        => [
159
-                'func'       => '_google_map_settings',
160
-                'capability' => 'manage_options',
161
-            ],
162
-            'update_google_map_settings' => [
163
-                'func'       => '_update_google_map_settings',
164
-                'capability' => 'manage_options',
165
-                'noheader'   => true,
166
-            ],
167
-            // venue category tab related
168
-            'add_category'               => [
169
-                'func'       => '_category_details',
170
-                'args'       => ['add'],
171
-                'capability' => 'ee_edit_venue_category',
172
-            ],
173
-            'edit_category'              => [
174
-                'func'       => '_category_details',
175
-                'args'       => ['edit'],
176
-                'capability' => 'ee_edit_venue_category',
177
-            ],
178
-            'delete_categories'          => [
179
-                'func'       => '_delete_categories',
180
-                'noheader'   => true,
181
-                'capability' => 'ee_delete_venue_category',
182
-            ],
183
-
184
-            'delete_category' => [
185
-                'func'       => '_delete_categories',
186
-                'noheader'   => true,
187
-                'capability' => 'ee_delete_venue_category',
188
-            ],
189
-
190
-            'insert_category' => [
191
-                'func'       => '_insert_or_update_category',
192
-                'args'       => ['new_category' => true],
193
-                'noheader'   => true,
194
-                'capability' => 'ee_edit_venue_category',
195
-            ],
196
-
197
-            'update_category'   => [
198
-                'func'       => '_insert_or_update_category',
199
-                'args'       => ['new_category' => false],
200
-                'noheader'   => true,
201
-                'capability' => 'ee_edit_venue_category',
202
-            ],
203
-            'export_categories' => [
204
-                'func'       => '_categories_export',
205
-                'noheader'   => true,
206
-                'capability' => 'export',
207
-            ],
208
-            'import_categories' => [
209
-                'func'       => '_import_categories',
210
-                'capability' => 'import',
211
-            ],
212
-            'category_list'     => [
213
-                'func'       => '_category_list_table',
214
-                'capability' => 'ee_manage_venue_categories',
215
-            ],
216
-        ];
217
-    }
218
-
219
-
220
-    protected function _set_page_config()
221
-    {
222
-        $VNU_ID     = $this->request->getRequestParam('post', 0, 'int');
223
-        $EVT_CAT_ID = $this->request->getRequestParam('EVT_CAT_ID', 0, 'int');
224
-
225
-        $this->_page_config = [
226
-            'default'             => [
227
-                'nav'           => [
228
-                    'label' => esc_html__('Overview', 'event_espresso'),
229
-                    'order' => 10,
230
-                ],
231
-                'list_table'    => 'Venues_Admin_List_Table',
232
-                'help_tabs'     => [
233
-                    'venues_overview_help_tab'                           => [
234
-                        'title'    => esc_html__('Venues Overview', 'event_espresso'),
235
-                        'filename' => 'venues_overview',
236
-                    ],
237
-                    'venues_overview_table_column_headings_help_tab'     => [
238
-                        'title'    => esc_html__('Venues Overview Table Column Headings', 'event_espresso'),
239
-                        'filename' => 'venues_overview_table_column_headings',
240
-                    ],
241
-                    'venues_overview_views_bulk_actions_search_help_tab' => [
242
-                        'title'    => esc_html__('Venues Overview Views & Bulk Actions & Search', 'event_espresso'),
243
-                        'filename' => 'venues_overview_views_bulk_actions_search',
244
-                    ],
245
-                ],
246
-                'metaboxes'     => ['_espresso_news_post_box', '_espresso_links_post_box'],
247
-                'require_nonce' => false,
248
-            ],
249
-            'create_new'          => [
250
-                'nav'           => [
251
-                    'label'      => esc_html__('Add Venue', 'event_espresso'),
252
-                    'order'      => 5,
253
-                    'persistent' => false,
254
-                ],
255
-                'help_tabs'     => [
256
-                    'venues_editor_help_tab'                                               => [
257
-                        'title'    => esc_html__('Venue Editor', 'event_espresso'),
258
-                        'filename' => 'venues_editor',
259
-                    ],
260
-                    'venues_editor_title_richtexteditor_help_tab'                          => [
261
-                        'title'    => esc_html__('Venue Title & Rich Text Editor', 'event_espresso'),
262
-                        'filename' => 'venues_editor_title_richtexteditor',
263
-                    ],
264
-                    'venues_editor_tags_categories_help_tab'                               => [
265
-                        'title'    => esc_html__('Venue Tags & Categories', 'event_espresso'),
266
-                        'filename' => 'venues_editor_tags_categories',
267
-                    ],
268
-                    'venues_editor_physical_location_google_map_virtual_location_help_tab' => [
269
-                        'title'    => esc_html__(
270
-                            'Venue Editor Physical Location & Google Map & Virtual Location',
271
-                            'event_espresso'
272
-                        ),
273
-                        'filename' => 'venues_editor_physical_location_google_map_virtual_location',
274
-                    ],
275
-                    'venues_editor_save_new_venue_help_tab'                                => [
276
-                        'title'    => esc_html__('Save New Venue', 'event_espresso'),
277
-                        'filename' => 'venues_editor_save_new_venue',
278
-                    ],
279
-                    'venues_editor_other_help_tab'                                         => [
280
-                        'title'    => esc_html__('Venue Editor Other', 'event_espresso'),
281
-                        'filename' => 'venues_editor_other',
282
-                    ],
283
-                ],
284
-                'metaboxes'     => ['_venue_editor_metaboxes'],
285
-                'require_nonce' => false,
286
-            ],
287
-            'edit'                => [
288
-                'nav'           => [
289
-                    'label'      => esc_html__('Edit Venue', 'event_espresso'),
290
-                    'order'      => 5,
291
-                    'persistent' => false,
292
-                    'url'        => $VNU_ID
293
-                        ? add_query_arg(['post' => $VNU_ID], $this->_current_page_view_url)
294
-                        : $this->_admin_base_url,
295
-                ],
296
-                'help_tabs'     => [
297
-                    'venues_editor_help_tab'                                               => [
298
-                        'title'    => esc_html__('Venue Editor', 'event_espresso'),
299
-                        'filename' => 'venues_editor',
300
-                    ],
301
-                    'venues_editor_title_richtexteditor_help_tab'                          => [
302
-                        'title'    => esc_html__('Venue Title & Rich Text Editor', 'event_espresso'),
303
-                        'filename' => 'venues_editor_title_richtexteditor',
304
-                    ],
305
-                    'venues_editor_tags_categories_help_tab'                               => [
306
-                        'title'    => esc_html__('Venue Tags & Categories', 'event_espresso'),
307
-                        'filename' => 'venues_editor_tags_categories',
308
-                    ],
309
-                    'venues_editor_physical_location_google_map_virtual_location_help_tab' => [
310
-                        'title'    => esc_html__(
311
-                            'Venue Editor Physical Location & Google Map & Virtual Location',
312
-                            'event_espresso'
313
-                        ),
314
-                        'filename' => 'venues_editor_physical_location_google_map_virtual_location',
315
-                    ],
316
-                    'venues_editor_save_new_venue_help_tab'                                => [
317
-                        'title'    => esc_html__('Save New Venue', 'event_espresso'),
318
-                        'filename' => 'venues_editor_save_new_venue',
319
-                    ],
320
-                    'venues_editor_other_help_tab'                                         => [
321
-                        'title'    => esc_html__('Venue Editor Other', 'event_espresso'),
322
-                        'filename' => 'venues_editor_other',
323
-                    ],
324
-                ],
325
-                'metaboxes'     => ['_venue_editor_metaboxes'],
326
-                'require_nonce' => false,
327
-            ],
328
-            'google_map_settings' => [
329
-                'nav'           => [
330
-                    'label' => esc_html__('Google Maps', 'event_espresso'),
331
-                    'order' => 40,
332
-                ],
333
-                'metaboxes'     => array_merge($this->_default_espresso_metaboxes, ['_publish_post_box']),
334
-                'help_tabs'     => [
335
-                    'general_settings_google_maps_help_tab' => [
336
-                        'title'    => esc_html__('Google Maps', 'event_espresso'),
337
-                        'filename' => 'general_settings_google_maps',
338
-                    ],
339
-                ],
340
-                'require_nonce' => false,
341
-            ],
342
-            // venue category stuff
343
-            'add_category'        => [
344
-                'nav'           => [
345
-                    'label'      => esc_html__('Add Category', 'event_espresso'),
346
-                    'order'      => 15,
347
-                    'persistent' => false,
348
-                ],
349
-                'metaboxes'     => ['_publish_post_box'],
350
-                'help_tabs'     => [
351
-                    'venues_add_category_help_tab' => [
352
-                        'title'    => esc_html__('Add New Venue Category', 'event_espresso'),
353
-                        'filename' => 'venues_add_category',
354
-                    ],
355
-                ],
356
-                'require_nonce' => false,
357
-            ],
358
-            'edit_category'       => [
359
-                'nav'           => [
360
-                    'label'      => esc_html__('Edit Category', 'event_espresso'),
361
-                    'order'      => 15,
362
-                    'persistent' => false,
363
-                    'url'        => $EVT_CAT_ID
364
-                        ? add_query_arg(['EVT_CAT_ID' => $EVT_CAT_ID], $this->_current_page_view_url)
365
-                        : $this->_admin_base_url,
366
-                ],
367
-                'metaboxes'     => ['_publish_post_box'],
368
-                'help_tabs'     => [
369
-                    'venues_edit_category_help_tab' => [
370
-                        'title'    => esc_html__('Edit Venue Category', 'event_espresso'),
371
-                        'filename' => 'venues_edit_category',
372
-                    ],
373
-                ],
374
-                'require_nonce' => false,
375
-            ],
376
-            'category_list'       => [
377
-                'nav'           => [
378
-                    'label' => esc_html__('Categories', 'event_espresso'),
379
-                    'order' => 20,
380
-                ],
381
-                'list_table'    => 'Venue_Categories_Admin_List_Table',
382
-                'help_tabs'     => [
383
-                    'venues_categories_help_tab'                       => [
384
-                        'title'    => esc_html__('Venue Categories', 'event_espresso'),
385
-                        'filename' => 'venues_categories',
386
-                    ],
387
-                    'venues_categories_table_column_headings_help_tab' => [
388
-                        'title'    => esc_html__('Venue Categories Table Column Headings', 'event_espresso'),
389
-                        'filename' => 'venues_categories_table_column_headings',
390
-                    ],
391
-                    'venues_categories_views_help_tab'                 => [
392
-                        'title'    => esc_html__('Venue Categories Views', 'event_espresso'),
393
-                        'filename' => 'venues_categories_views',
394
-                    ],
395
-                    'venues_categories_other_help_tab'                 => [
396
-                        'title'    => esc_html__('Venue Categories Other', 'event_espresso'),
397
-                        'filename' => 'venues_categories_other',
398
-                    ],
399
-                ],
400
-                'metaboxes'     => $this->_default_espresso_metaboxes,
401
-                'require_nonce' => false,
402
-            ],
403
-        ];
404
-    }
405
-
406
-
407
-    protected function _add_screen_options()
408
-    {
409
-        // todo
410
-    }
411
-
412
-
413
-    protected function _add_screen_options_default()
414
-    {
415
-        $this->_per_page_screen_option();
416
-    }
417
-
418
-
419
-    protected function _add_screen_options_category_list()
420
-    {
421
-        $page_title              = $this->_admin_page_title;
422
-        $this->_admin_page_title = esc_html__('Venue Categories', 'event_espresso');
423
-        $this->_per_page_screen_option();
424
-        $this->_admin_page_title = $page_title;
425
-    }
426
-
427
-
428
-    // none of the below group are currently used for Event Venues
429
-    protected function _add_feature_pointers()
430
-    {
431
-    }
432
-
433
-
434
-    public function admin_init()
435
-    {
436
-    }
437
-
438
-
439
-    public function admin_notices()
440
-    {
441
-    }
442
-
443
-
444
-    public function admin_footer_scripts()
445
-    {
446
-    }
447
-
448
-
449
-    public function load_scripts_styles_create_new()
450
-    {
451
-        $this->load_scripts_styles_edit();
452
-    }
453
-
454
-
455
-    public function load_scripts_styles()
456
-    {
457
-        wp_register_style('ee-cat-admin', EVENTS_ASSETS_URL . 'ee-cat-admin.css', [], EVENT_ESPRESSO_VERSION);
458
-        wp_enqueue_style('ee-cat-admin');
459
-    }
460
-
461
-
462
-    public function load_scripts_styles_add_category()
463
-    {
464
-        $this->load_scripts_styles_edit_category();
465
-    }
466
-
467
-
468
-    public function load_scripts_styles_edit_category()
469
-    {
470
-    }
471
-
472
-
473
-    public function load_scripts_styles_edit()
474
-    {
475
-        // styles
476
-        wp_enqueue_style('espresso-ui-theme');
477
-        wp_register_style(
478
-            'espresso_venues',
479
-            EE_VENUES_ASSETS_URL . 'ee-venues-admin.css',
480
-            [],
481
-            EVENT_ESPRESSO_VERSION
482
-        );
483
-        wp_enqueue_style('espresso_venues');
484
-    }
485
-
486
-
487
-    protected function _set_list_table_views_default()
488
-    {
489
-        $this->_views = [
490
-            'all' => [
491
-                'slug'        => 'all',
492
-                'label'       => esc_html__('View All Venues', 'event_espresso'),
493
-                'count'       => 0,
494
-                'bulk_action' => [],
495
-            ],
496
-        ];
497
-
498
-        if (EE_Registry::instance()->CAP->current_user_can('ee_delete_venues', 'espresso_venues_trash_venues')) {
499
-            $this->_views['all']['bulk_action'] = [
500
-                'trash_venues' => esc_html__('Move to Trash', 'event_espresso'),
501
-            ];
502
-            $this->_views['trash']              = [
503
-                'slug'        => 'trash',
504
-                'label'       => esc_html__('Trash', 'event_espresso'),
505
-                'count'       => 0,
506
-                'bulk_action' => [
507
-                    'restore_venues' => esc_html__('Restore from Trash', 'event_espresso'),
508
-                    'delete_venues'  => esc_html__('Delete', 'event_espresso'),
509
-                ],
510
-            ];
511
-        }
512
-    }
513
-
514
-
515
-    protected function _set_list_table_views_category_list()
516
-    {
517
-        $this->_views = [
518
-            'all' => [
519
-                'slug'        => 'all',
520
-                'label'       => esc_html__('All', 'event_espresso'),
521
-                'count'       => 0,
522
-                'bulk_action' => [
523
-                    'delete_categories' => esc_html__('Delete Permanently', 'event_espresso'),
524
-                ],
525
-            ],
526
-        ];
527
-    }
528
-
529
-
530
-    /**
531
-     * @throws EE_Error
532
-     */
533
-    protected function _overview_list_table()
534
-    {
535
-        do_action('AHEE_log', __FILE__, __FUNCTION__, '');
536
-        $this->_template_args['after_list_table'] = EEH_Template::get_button_or_link(
537
-            get_post_type_archive_link('espresso_venues'),
538
-            esc_html__("View Venue Archive Page", "event_espresso"),
539
-            'button'
540
-        );
541
-
542
-        $this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
543
-            'create_new',
544
-            'add',
545
-            [],
546
-            'add-new-h2'
547
-        );
548
-
549
-        $this->_search_btn_label  = esc_html__('Venues', 'event_espresso');
550
-        $this->display_admin_list_table_page_with_sidebar();
551
-    }
552
-
553
-
554
-    /**
555
-     * @throws EE_Error
556
-     * @throws ReflectionException
557
-     */
558
-    public function extra_misc_actions_publish_box()
559
-    {
560
-        $extra_rows = [
561
-            'vnu_capacity' => $this->_cpt_model_obj->get_f('VNU_capacity'),
562
-            'vnu_url'      => $this->_cpt_model_obj->get_f('VNU_url'),
563
-            'vnu_phone'    => $this->_cpt_model_obj->get_f('VNU_phone'),
564
-        ];
565
-        $template   = EE_VENUES_TEMPLATE_PATH . 'venue_publish_box_extras.template.php';
566
-        EEH_Template::display_template($template, $extra_rows);
567
-    }
568
-
569
-
570
-    /*************        Google Maps        *************
17
+	/**
18
+	 * _venue
19
+	 * This will hold the venue object for venue_details screen.
20
+	 *
21
+	 * @access protected
22
+	 * @var object
23
+	 */
24
+	protected $_venue;
25
+
26
+
27
+	/**
28
+	 * This will hold the category object for category_details screen.
29
+	 *
30
+	 * @var object
31
+	 */
32
+	protected $_category;
33
+
34
+
35
+	/**
36
+	 * This property will hold the venue model instance
37
+	 *
38
+	 * @var object
39
+	 */
40
+	protected $_venue_model;
41
+
42
+
43
+	/**
44
+	 * @throws EE_Error
45
+	 */
46
+	protected function _init_page_props()
47
+	{
48
+		require_once(EE_MODELS . 'EEM_Venue.model.php');
49
+		$this->page_slug        = EE_VENUES_PG_SLUG;
50
+		$this->_admin_base_url  = EE_VENUES_ADMIN_URL;
51
+		$this->_admin_base_path = EE_ADMIN_PAGES . 'venues';
52
+		$this->page_label       = esc_html__('Event Venues', 'event_espresso');
53
+		$this->_cpt_model_names = [
54
+			'create_new' => 'EEM_Venue',
55
+			'edit'       => 'EEM_Venue',
56
+		];
57
+		$this->_cpt_edit_routes = [
58
+			'espresso_venues' => 'edit',
59
+		];
60
+		$this->_venue_model     = EEM_Venue::instance();
61
+	}
62
+
63
+
64
+	protected function _ajax_hooks()
65
+	{
66
+		// todo: all hooks for ee_venues ajax goes in here.
67
+	}
68
+
69
+
70
+	protected function _define_page_props()
71
+	{
72
+		$this->_admin_page_title = $this->page_label;
73
+		$this->_labels           = [
74
+			'buttons'      => [
75
+				'add'             => esc_html__('Add New Venue', 'event_espresso'),
76
+				'edit'            => esc_html__('Edit Venue', 'event_espresso'),
77
+				'delete'          => esc_html__('Delete Venue', 'event_espresso'),
78
+				'add_category'    => esc_html__('Add New Category', 'event_espresso'),
79
+				'edit_category'   => esc_html__('Edit Category', 'event_espresso'),
80
+				'delete_category' => esc_html__('Delete Category', 'event_espresso'),
81
+			],
82
+			'editor_title' => [
83
+				'espresso_venues' => esc_html__('Enter Venue name here', 'event_espresso'),
84
+			],
85
+			'publishbox'   => [
86
+				'create_new'          => esc_html__('Save New Venue', 'event_espresso'),
87
+				'edit'                => esc_html__('Update Venue', 'event_espresso'),
88
+				'add_category'        => esc_html__('Save New Category', 'event_espresso'),
89
+				'edit_category'       => esc_html__('Update Category', 'event_espresso'),
90
+				'google_map_settings' => esc_html__('Update Settings', 'event_espresso'),
91
+			],
92
+		];
93
+	}
94
+
95
+
96
+	protected function _set_page_routes()
97
+	{
98
+
99
+		// load formatter helper
100
+		// load field generator helper
101
+
102
+		// is there a vnu_id in the request?
103
+		$VNU_ID = $this->request->getRequestParam('VNU_ID', 0, 'int');
104
+		$VNU_ID = $this->request->getRequestParam('post', $VNU_ID, 'int');
105
+
106
+		$this->_page_routes = [
107
+			'default'                    => [
108
+				'func'       => '_overview_list_table',
109
+				'capability' => 'ee_read_venues',
110
+			],
111
+			'create_new'                 => [
112
+				'func'       => '_create_new_cpt_item',
113
+				'capability' => 'ee_edit_venues',
114
+			],
115
+			'edit'                       => [
116
+				'func'       => '_edit_cpt_item',
117
+				'capability' => 'ee_edit_venue',
118
+				'obj_id'     => $VNU_ID,
119
+			],
120
+			'trash_venue'                => [
121
+				'func'       => '_trash_or_restore_venue',
122
+				'args'       => ['venue_status' => 'trash'],
123
+				'noheader'   => true,
124
+				'capability' => 'ee_delete_venue',
125
+				'obj_id'     => $VNU_ID,
126
+			],
127
+			'trash_venues'               => [
128
+				'func'       => '_trash_or_restore_venues',
129
+				'args'       => ['venue_status' => 'trash'],
130
+				'noheader'   => true,
131
+				'capability' => 'ee_delete_venues',
132
+			],
133
+			'restore_venue'              => [
134
+				'func'       => '_trash_or_restore_venue',
135
+				'args'       => ['venue_status' => 'draft'],
136
+				'noheader'   => true,
137
+				'capability' => 'ee_delete_venue',
138
+				'obj_id'     => $VNU_ID,
139
+			],
140
+			'restore_venues'             => [
141
+				'func'       => '_trash_or_restore_venues',
142
+				'args'       => ['venue_status' => 'draft'],
143
+				'noheader'   => true,
144
+				'capability' => 'ee_delete_venues',
145
+			],
146
+			'delete_venues'              => [
147
+				'func'       => '_delete_venues',
148
+				'noheader'   => true,
149
+				'capability' => 'ee_delete_venues',
150
+			],
151
+			'delete_venue'               => [
152
+				'func'       => '_delete_venue',
153
+				'noheader'   => true,
154
+				'capability' => 'ee_delete_venue',
155
+				'obj_id'     => $VNU_ID,
156
+			],
157
+			// settings related
158
+			'google_map_settings'        => [
159
+				'func'       => '_google_map_settings',
160
+				'capability' => 'manage_options',
161
+			],
162
+			'update_google_map_settings' => [
163
+				'func'       => '_update_google_map_settings',
164
+				'capability' => 'manage_options',
165
+				'noheader'   => true,
166
+			],
167
+			// venue category tab related
168
+			'add_category'               => [
169
+				'func'       => '_category_details',
170
+				'args'       => ['add'],
171
+				'capability' => 'ee_edit_venue_category',
172
+			],
173
+			'edit_category'              => [
174
+				'func'       => '_category_details',
175
+				'args'       => ['edit'],
176
+				'capability' => 'ee_edit_venue_category',
177
+			],
178
+			'delete_categories'          => [
179
+				'func'       => '_delete_categories',
180
+				'noheader'   => true,
181
+				'capability' => 'ee_delete_venue_category',
182
+			],
183
+
184
+			'delete_category' => [
185
+				'func'       => '_delete_categories',
186
+				'noheader'   => true,
187
+				'capability' => 'ee_delete_venue_category',
188
+			],
189
+
190
+			'insert_category' => [
191
+				'func'       => '_insert_or_update_category',
192
+				'args'       => ['new_category' => true],
193
+				'noheader'   => true,
194
+				'capability' => 'ee_edit_venue_category',
195
+			],
196
+
197
+			'update_category'   => [
198
+				'func'       => '_insert_or_update_category',
199
+				'args'       => ['new_category' => false],
200
+				'noheader'   => true,
201
+				'capability' => 'ee_edit_venue_category',
202
+			],
203
+			'export_categories' => [
204
+				'func'       => '_categories_export',
205
+				'noheader'   => true,
206
+				'capability' => 'export',
207
+			],
208
+			'import_categories' => [
209
+				'func'       => '_import_categories',
210
+				'capability' => 'import',
211
+			],
212
+			'category_list'     => [
213
+				'func'       => '_category_list_table',
214
+				'capability' => 'ee_manage_venue_categories',
215
+			],
216
+		];
217
+	}
218
+
219
+
220
+	protected function _set_page_config()
221
+	{
222
+		$VNU_ID     = $this->request->getRequestParam('post', 0, 'int');
223
+		$EVT_CAT_ID = $this->request->getRequestParam('EVT_CAT_ID', 0, 'int');
224
+
225
+		$this->_page_config = [
226
+			'default'             => [
227
+				'nav'           => [
228
+					'label' => esc_html__('Overview', 'event_espresso'),
229
+					'order' => 10,
230
+				],
231
+				'list_table'    => 'Venues_Admin_List_Table',
232
+				'help_tabs'     => [
233
+					'venues_overview_help_tab'                           => [
234
+						'title'    => esc_html__('Venues Overview', 'event_espresso'),
235
+						'filename' => 'venues_overview',
236
+					],
237
+					'venues_overview_table_column_headings_help_tab'     => [
238
+						'title'    => esc_html__('Venues Overview Table Column Headings', 'event_espresso'),
239
+						'filename' => 'venues_overview_table_column_headings',
240
+					],
241
+					'venues_overview_views_bulk_actions_search_help_tab' => [
242
+						'title'    => esc_html__('Venues Overview Views & Bulk Actions & Search', 'event_espresso'),
243
+						'filename' => 'venues_overview_views_bulk_actions_search',
244
+					],
245
+				],
246
+				'metaboxes'     => ['_espresso_news_post_box', '_espresso_links_post_box'],
247
+				'require_nonce' => false,
248
+			],
249
+			'create_new'          => [
250
+				'nav'           => [
251
+					'label'      => esc_html__('Add Venue', 'event_espresso'),
252
+					'order'      => 5,
253
+					'persistent' => false,
254
+				],
255
+				'help_tabs'     => [
256
+					'venues_editor_help_tab'                                               => [
257
+						'title'    => esc_html__('Venue Editor', 'event_espresso'),
258
+						'filename' => 'venues_editor',
259
+					],
260
+					'venues_editor_title_richtexteditor_help_tab'                          => [
261
+						'title'    => esc_html__('Venue Title & Rich Text Editor', 'event_espresso'),
262
+						'filename' => 'venues_editor_title_richtexteditor',
263
+					],
264
+					'venues_editor_tags_categories_help_tab'                               => [
265
+						'title'    => esc_html__('Venue Tags & Categories', 'event_espresso'),
266
+						'filename' => 'venues_editor_tags_categories',
267
+					],
268
+					'venues_editor_physical_location_google_map_virtual_location_help_tab' => [
269
+						'title'    => esc_html__(
270
+							'Venue Editor Physical Location & Google Map & Virtual Location',
271
+							'event_espresso'
272
+						),
273
+						'filename' => 'venues_editor_physical_location_google_map_virtual_location',
274
+					],
275
+					'venues_editor_save_new_venue_help_tab'                                => [
276
+						'title'    => esc_html__('Save New Venue', 'event_espresso'),
277
+						'filename' => 'venues_editor_save_new_venue',
278
+					],
279
+					'venues_editor_other_help_tab'                                         => [
280
+						'title'    => esc_html__('Venue Editor Other', 'event_espresso'),
281
+						'filename' => 'venues_editor_other',
282
+					],
283
+				],
284
+				'metaboxes'     => ['_venue_editor_metaboxes'],
285
+				'require_nonce' => false,
286
+			],
287
+			'edit'                => [
288
+				'nav'           => [
289
+					'label'      => esc_html__('Edit Venue', 'event_espresso'),
290
+					'order'      => 5,
291
+					'persistent' => false,
292
+					'url'        => $VNU_ID
293
+						? add_query_arg(['post' => $VNU_ID], $this->_current_page_view_url)
294
+						: $this->_admin_base_url,
295
+				],
296
+				'help_tabs'     => [
297
+					'venues_editor_help_tab'                                               => [
298
+						'title'    => esc_html__('Venue Editor', 'event_espresso'),
299
+						'filename' => 'venues_editor',
300
+					],
301
+					'venues_editor_title_richtexteditor_help_tab'                          => [
302
+						'title'    => esc_html__('Venue Title & Rich Text Editor', 'event_espresso'),
303
+						'filename' => 'venues_editor_title_richtexteditor',
304
+					],
305
+					'venues_editor_tags_categories_help_tab'                               => [
306
+						'title'    => esc_html__('Venue Tags & Categories', 'event_espresso'),
307
+						'filename' => 'venues_editor_tags_categories',
308
+					],
309
+					'venues_editor_physical_location_google_map_virtual_location_help_tab' => [
310
+						'title'    => esc_html__(
311
+							'Venue Editor Physical Location & Google Map & Virtual Location',
312
+							'event_espresso'
313
+						),
314
+						'filename' => 'venues_editor_physical_location_google_map_virtual_location',
315
+					],
316
+					'venues_editor_save_new_venue_help_tab'                                => [
317
+						'title'    => esc_html__('Save New Venue', 'event_espresso'),
318
+						'filename' => 'venues_editor_save_new_venue',
319
+					],
320
+					'venues_editor_other_help_tab'                                         => [
321
+						'title'    => esc_html__('Venue Editor Other', 'event_espresso'),
322
+						'filename' => 'venues_editor_other',
323
+					],
324
+				],
325
+				'metaboxes'     => ['_venue_editor_metaboxes'],
326
+				'require_nonce' => false,
327
+			],
328
+			'google_map_settings' => [
329
+				'nav'           => [
330
+					'label' => esc_html__('Google Maps', 'event_espresso'),
331
+					'order' => 40,
332
+				],
333
+				'metaboxes'     => array_merge($this->_default_espresso_metaboxes, ['_publish_post_box']),
334
+				'help_tabs'     => [
335
+					'general_settings_google_maps_help_tab' => [
336
+						'title'    => esc_html__('Google Maps', 'event_espresso'),
337
+						'filename' => 'general_settings_google_maps',
338
+					],
339
+				],
340
+				'require_nonce' => false,
341
+			],
342
+			// venue category stuff
343
+			'add_category'        => [
344
+				'nav'           => [
345
+					'label'      => esc_html__('Add Category', 'event_espresso'),
346
+					'order'      => 15,
347
+					'persistent' => false,
348
+				],
349
+				'metaboxes'     => ['_publish_post_box'],
350
+				'help_tabs'     => [
351
+					'venues_add_category_help_tab' => [
352
+						'title'    => esc_html__('Add New Venue Category', 'event_espresso'),
353
+						'filename' => 'venues_add_category',
354
+					],
355
+				],
356
+				'require_nonce' => false,
357
+			],
358
+			'edit_category'       => [
359
+				'nav'           => [
360
+					'label'      => esc_html__('Edit Category', 'event_espresso'),
361
+					'order'      => 15,
362
+					'persistent' => false,
363
+					'url'        => $EVT_CAT_ID
364
+						? add_query_arg(['EVT_CAT_ID' => $EVT_CAT_ID], $this->_current_page_view_url)
365
+						: $this->_admin_base_url,
366
+				],
367
+				'metaboxes'     => ['_publish_post_box'],
368
+				'help_tabs'     => [
369
+					'venues_edit_category_help_tab' => [
370
+						'title'    => esc_html__('Edit Venue Category', 'event_espresso'),
371
+						'filename' => 'venues_edit_category',
372
+					],
373
+				],
374
+				'require_nonce' => false,
375
+			],
376
+			'category_list'       => [
377
+				'nav'           => [
378
+					'label' => esc_html__('Categories', 'event_espresso'),
379
+					'order' => 20,
380
+				],
381
+				'list_table'    => 'Venue_Categories_Admin_List_Table',
382
+				'help_tabs'     => [
383
+					'venues_categories_help_tab'                       => [
384
+						'title'    => esc_html__('Venue Categories', 'event_espresso'),
385
+						'filename' => 'venues_categories',
386
+					],
387
+					'venues_categories_table_column_headings_help_tab' => [
388
+						'title'    => esc_html__('Venue Categories Table Column Headings', 'event_espresso'),
389
+						'filename' => 'venues_categories_table_column_headings',
390
+					],
391
+					'venues_categories_views_help_tab'                 => [
392
+						'title'    => esc_html__('Venue Categories Views', 'event_espresso'),
393
+						'filename' => 'venues_categories_views',
394
+					],
395
+					'venues_categories_other_help_tab'                 => [
396
+						'title'    => esc_html__('Venue Categories Other', 'event_espresso'),
397
+						'filename' => 'venues_categories_other',
398
+					],
399
+				],
400
+				'metaboxes'     => $this->_default_espresso_metaboxes,
401
+				'require_nonce' => false,
402
+			],
403
+		];
404
+	}
405
+
406
+
407
+	protected function _add_screen_options()
408
+	{
409
+		// todo
410
+	}
411
+
412
+
413
+	protected function _add_screen_options_default()
414
+	{
415
+		$this->_per_page_screen_option();
416
+	}
417
+
418
+
419
+	protected function _add_screen_options_category_list()
420
+	{
421
+		$page_title              = $this->_admin_page_title;
422
+		$this->_admin_page_title = esc_html__('Venue Categories', 'event_espresso');
423
+		$this->_per_page_screen_option();
424
+		$this->_admin_page_title = $page_title;
425
+	}
426
+
427
+
428
+	// none of the below group are currently used for Event Venues
429
+	protected function _add_feature_pointers()
430
+	{
431
+	}
432
+
433
+
434
+	public function admin_init()
435
+	{
436
+	}
437
+
438
+
439
+	public function admin_notices()
440
+	{
441
+	}
442
+
443
+
444
+	public function admin_footer_scripts()
445
+	{
446
+	}
447
+
448
+
449
+	public function load_scripts_styles_create_new()
450
+	{
451
+		$this->load_scripts_styles_edit();
452
+	}
453
+
454
+
455
+	public function load_scripts_styles()
456
+	{
457
+		wp_register_style('ee-cat-admin', EVENTS_ASSETS_URL . 'ee-cat-admin.css', [], EVENT_ESPRESSO_VERSION);
458
+		wp_enqueue_style('ee-cat-admin');
459
+	}
460
+
461
+
462
+	public function load_scripts_styles_add_category()
463
+	{
464
+		$this->load_scripts_styles_edit_category();
465
+	}
466
+
467
+
468
+	public function load_scripts_styles_edit_category()
469
+	{
470
+	}
471
+
472
+
473
+	public function load_scripts_styles_edit()
474
+	{
475
+		// styles
476
+		wp_enqueue_style('espresso-ui-theme');
477
+		wp_register_style(
478
+			'espresso_venues',
479
+			EE_VENUES_ASSETS_URL . 'ee-venues-admin.css',
480
+			[],
481
+			EVENT_ESPRESSO_VERSION
482
+		);
483
+		wp_enqueue_style('espresso_venues');
484
+	}
485
+
486
+
487
+	protected function _set_list_table_views_default()
488
+	{
489
+		$this->_views = [
490
+			'all' => [
491
+				'slug'        => 'all',
492
+				'label'       => esc_html__('View All Venues', 'event_espresso'),
493
+				'count'       => 0,
494
+				'bulk_action' => [],
495
+			],
496
+		];
497
+
498
+		if (EE_Registry::instance()->CAP->current_user_can('ee_delete_venues', 'espresso_venues_trash_venues')) {
499
+			$this->_views['all']['bulk_action'] = [
500
+				'trash_venues' => esc_html__('Move to Trash', 'event_espresso'),
501
+			];
502
+			$this->_views['trash']              = [
503
+				'slug'        => 'trash',
504
+				'label'       => esc_html__('Trash', 'event_espresso'),
505
+				'count'       => 0,
506
+				'bulk_action' => [
507
+					'restore_venues' => esc_html__('Restore from Trash', 'event_espresso'),
508
+					'delete_venues'  => esc_html__('Delete', 'event_espresso'),
509
+				],
510
+			];
511
+		}
512
+	}
513
+
514
+
515
+	protected function _set_list_table_views_category_list()
516
+	{
517
+		$this->_views = [
518
+			'all' => [
519
+				'slug'        => 'all',
520
+				'label'       => esc_html__('All', 'event_espresso'),
521
+				'count'       => 0,
522
+				'bulk_action' => [
523
+					'delete_categories' => esc_html__('Delete Permanently', 'event_espresso'),
524
+				],
525
+			],
526
+		];
527
+	}
528
+
529
+
530
+	/**
531
+	 * @throws EE_Error
532
+	 */
533
+	protected function _overview_list_table()
534
+	{
535
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
536
+		$this->_template_args['after_list_table'] = EEH_Template::get_button_or_link(
537
+			get_post_type_archive_link('espresso_venues'),
538
+			esc_html__("View Venue Archive Page", "event_espresso"),
539
+			'button'
540
+		);
541
+
542
+		$this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
543
+			'create_new',
544
+			'add',
545
+			[],
546
+			'add-new-h2'
547
+		);
548
+
549
+		$this->_search_btn_label  = esc_html__('Venues', 'event_espresso');
550
+		$this->display_admin_list_table_page_with_sidebar();
551
+	}
552
+
553
+
554
+	/**
555
+	 * @throws EE_Error
556
+	 * @throws ReflectionException
557
+	 */
558
+	public function extra_misc_actions_publish_box()
559
+	{
560
+		$extra_rows = [
561
+			'vnu_capacity' => $this->_cpt_model_obj->get_f('VNU_capacity'),
562
+			'vnu_url'      => $this->_cpt_model_obj->get_f('VNU_url'),
563
+			'vnu_phone'    => $this->_cpt_model_obj->get_f('VNU_phone'),
564
+		];
565
+		$template   = EE_VENUES_TEMPLATE_PATH . 'venue_publish_box_extras.template.php';
566
+		EEH_Template::display_template($template, $extra_rows);
567
+	}
568
+
569
+
570
+	/*************        Google Maps        *************
571 571
      *
572 572
      * @throws EE_Error
573 573
      * @throws EE_Error
574 574
      */
575 575
 
576 576
 
577
-    protected function _google_map_settings()
578
-    {
579
-
580
-
581
-        $this->_template_args['values']           = $this->_yes_no_values;
582
-        $default_map_settings                     = new stdClass();
583
-        $default_map_settings->use_google_maps    = true;
584
-        $default_map_settings->google_map_api_key = '';
585
-        // for event details pages (reg page)
586
-        $default_map_settings->event_details_map_width    = 585;
587
-        // ee_map_width_single
588
-        $default_map_settings->event_details_map_height   = 362;
589
-        // ee_map_height_single
590
-        $default_map_settings->event_details_map_zoom     = 14;
591
-        // ee_map_zoom_single
592
-        $default_map_settings->event_details_display_nav  = true;
593
-        // ee_map_nav_display_single
594
-        $default_map_settings->event_details_nav_size     = false;
595
-        // ee_map_nav_size_single
596
-        $default_map_settings->event_details_control_type = 'default';
597
-        // ee_map_type_control_single
598
-        $default_map_settings->event_details_map_align    = 'center';
599
-        // ee_map_align_single
600
-
601
-        // for event list pages
602
-        $default_map_settings->event_list_map_width    = 300;
603
-        // ee_map_width
604
-        $default_map_settings->event_list_map_height   = 185;
605
-        // ee_map_height
606
-        $default_map_settings->event_list_map_zoom     = 12;
607
-        // ee_map_zoom
608
-        $default_map_settings->event_list_display_nav  = false;
609
-        // ee_map_nav_display
610
-        $default_map_settings->event_list_nav_size     = true;
611
-        // ee_map_nav_size
612
-        $default_map_settings->event_list_control_type = 'dropdown';
613
-        // ee_map_type_control
614
-        $default_map_settings->event_list_map_align    = 'center';
615
-        // ee_map_align
616
-
617
-        $this->_template_args['map_settings'] =
618
-            isset(EE_Registry::instance()->CFG->map_settings)
619
-            && ! empty(EE_Registry::instance()->CFG->map_settings)
620
-                ? (object) array_merge(
621
-                    (array) $default_map_settings,
622
-                    (array) EE_Registry::instance()->CFG->map_settings
623
-                )
624
-                : $default_map_settings;
625
-
626
-        $this->_set_add_edit_form_tags('update_google_map_settings');
627
-        $this->_set_publish_post_box_vars(null, false, false, null, false);
628
-        $this->_template_args['admin_page_content'] = EEH_Template::display_template(
629
-            EE_VENUES_TEMPLATE_PATH . 'google_map.template.php',
630
-            $this->_template_args,
631
-            true
632
-        );
633
-        $this->display_admin_page_with_sidebar();
634
-    }
635
-
636
-
637
-    /**
638
-     * @throws EE_Error
639
-     */
640
-    protected function _update_google_map_settings()
641
-    {
642
-        $map_settings = EE_Registry::instance()->CFG->map_settings;
643
-
644
-        $settings = [
645
-            'use_google_maps'            => 'int',
646
-            'google_map_api_key'         => 'string',
647
-            'event_details_map_width'    => 'int',
648
-            'event_details_map_zoom'     => 'int',
649
-            'event_details_display_nav'  => 'int',
650
-            'event_details_nav_size'     => 'int',
651
-            'event_details_control_type' => 'string',
652
-            'event_details_map_align'    => 'string',
653
-            'event_list_map_width'       => 'int',
654
-            'event_list_map_height'      => 'int',
655
-            'event_list_map_zoom'        => 'int',
656
-            'event_list_display_nav'     => 'int',
657
-            'event_list_nav_size'        => 'int',
658
-            'event_list_control_type'    => 'string',
659
-            'event_list_map_align'       => 'string',
660
-        ];
661
-
662
-        foreach ($settings as $setting => $type) {
663
-            $map_settings->{$setting} = $this->request->getRequestParam($setting, $map_settings->{$setting}, $type);
664
-        }
665
-
666
-        EE_Registry::instance()->CFG->map_settings = apply_filters(
667
-            'FHEE__Extend_General_Settings_Admin_Page___update_google_map_settings__CFG_map_settings',
668
-            $map_settings
669
-        );
670
-
671
-        $what    = 'Google Map Settings';
672
-        $success = $this->_update_espresso_configuration(
673
-            $what,
674
-            EE_Registry::instance()->CFG->map_settings,
675
-            __FILE__,
676
-            __FUNCTION__,
677
-            __LINE__
678
-        );
679
-        $this->_redirect_after_action($success, $what, 'updated', ['action' => 'google_map_settings']);
680
-    }
681
-
682
-
683
-    /**
684
-     * @throws EE_Error
685
-     * @throws ReflectionException
686
-     */
687
-    protected function _venue_editor_metaboxes()
688
-    {
689
-        $this->verify_cpt_object();
690
-
691
-        add_meta_box(
692
-            'espresso_venue_address_options',
693
-            esc_html__('Physical Location', 'event_espresso'),
694
-            [$this, 'venue_address_metabox'],
695
-            $this->page_slug,
696
-            'side'
697
-        );
698
-        add_meta_box(
699
-            'espresso_venue_gmap_options',
700
-            esc_html__('Google Map', 'event_espresso'),
701
-            [$this, 'venue_gmap_metabox'],
702
-            $this->page_slug,
703
-            'side'
704
-        );
705
-        add_meta_box(
706
-            'espresso_venue_virtual_loc_options',
707
-            esc_html__('Virtual Location', 'event_espresso'),
708
-            [$this, 'venue_virtual_loc_metabox'],
709
-            $this->page_slug,
710
-            'side'
711
-        );
712
-    }
713
-
714
-
715
-    public function venue_gmap_metabox()
716
-    {
717
-        $template_args = [
718
-            'vnu_enable_for_gmap' => EEH_Form_Fields::select_input(
719
-                'vnu_enable_for_gmap',
720
-                $this->get_yes_no_values(),
721
-                $this->_cpt_model_obj instanceof EE_Venue ? $this->_cpt_model_obj->enable_for_gmap() : false
722
-            ),
723
-            'vnu_google_map_link' => $this->_cpt_model_obj->google_map_link(),
724
-        ];
725
-        $template      = EE_VENUES_TEMPLATE_PATH . 'venue_gmap_metabox_content.template.php';
726
-        EEH_Template::display_template($template, $template_args);
727
-    }
728
-
729
-
730
-    /**
731
-     * @throws EE_Error
732
-     * @throws ReflectionException
733
-     */
734
-    public function venue_address_metabox()
735
-    {
736
-        $template_args['_venue'] = $this->_cpt_model_obj;
737
-
738
-        $template_args['states_dropdown']    = EEH_Form_Fields::generate_form_input(
739
-            new EE_Question_Form_Input(
740
-                EE_Question::new_instance(
741
-                    ['QST_display_text' => esc_html__('State', 'event_espresso'), 'QST_system' => 'state']
742
-                ),
743
-                EE_Answer::new_instance(
744
-                    [
745
-                        'ANS_value' => $this->_cpt_model_obj instanceof EE_Venue
746
-                            ? $this->_cpt_model_obj->state_ID()
747
-                            : 0,
748
-                    ]
749
-                ),
750
-                [
751
-                    'input_name'     => 'sta_id',
752
-                    'input_id'       => 'sta_id',
753
-                    'input_class'    => '',
754
-                    'input_prefix'   => '',
755
-                    'append_qstn_id' => false,
756
-                ]
757
-            )
758
-        );
759
-        $template_args['countries_dropdown'] = EEH_Form_Fields::generate_form_input(
760
-            new EE_Question_Form_Input(
761
-                EE_Question::new_instance(
762
-                    ['QST_display_text' => esc_html__('Country', 'event_espresso'), 'QST_system' => 'country']
763
-                ),
764
-                EE_Answer::new_instance(
765
-                    [
766
-                        'ANS_value' => $this->_cpt_model_obj instanceof EE_Venue
767
-                            ? $this->_cpt_model_obj->country_ID()
768
-                            : 0,
769
-                    ]
770
-                ),
771
-                [
772
-                    'input_name'     => 'cnt_iso',
773
-                    'input_id'       => 'cnt_iso',
774
-                    'input_class'    => '',
775
-                    'input_prefix'   => '',
776
-                    'append_qstn_id' => false,
777
-                ]
778
-            )
779
-        );
780
-
781
-        $template = EE_VENUES_TEMPLATE_PATH . 'venue_address_metabox_content.template.php';
782
-        EEH_Template::display_template($template, $template_args);
783
-    }
784
-
785
-
786
-    public function venue_virtual_loc_metabox()
787
-    {
788
-        $template_args = [
789
-            '_venue' => $this->_cpt_model_obj,
790
-        ];
791
-        $template      = EE_VENUES_TEMPLATE_PATH . 'venue_virtual_location_metabox_content.template.php';
792
-        EEH_Template::display_template($template, $template_args);
793
-    }
794
-
795
-
796
-    protected function _restore_cpt_item($post_id, $revision_id)
797
-    {
798
-        $venue_obj = $this->_venue_model->get_one_by_ID($post_id);
799
-
800
-        // meta revision restore
801
-        $venue_obj->restore_revision($revision_id);
802
-    }
803
-
804
-
805
-    /**
806
-     * Handles updates for venue cpts
807
-     *
808
-     * @param int    $post_id ID of Venue CPT
809
-     * @param WP_Post $post    Post object (with "blessed" WP properties)
810
-     * @return void
811
-     */
812
-    protected function _insert_update_cpt_item($post_id, $post)
813
-    {
814
-
815
-        if ($post instanceof WP_Post && $post->post_type !== 'espresso_venues') {
816
-            return;// get out we're not processing the saving of venues.
817
-        }
818
-
819
-        $wheres = [$this->_venue_model->primary_key_name() => $post_id];
820
-
821
-        $venue_values = [
822
-            'VNU_address'         => $this->request->getRequestParam('vnu_address'),
823
-            'VNU_address2'        => $this->request->getRequestParam('vnu_address2'),
824
-            'VNU_city'            => $this->request->getRequestParam('vnu_city'),
825
-            'STA_ID'              => $this->request->getRequestParam('sta_id'),
826
-            'CNT_ISO'             => $this->request->getRequestParam('cnt_iso'),
827
-            'VNU_zip'             => $this->request->getRequestParam('vnu_zip'),
828
-            'VNU_phone'           => $this->request->getRequestParam('vnu_phone'),
829
-            'VNU_capacity'        => $this->request->requestParamIsSet('vnu_capacity')
830
-                ? str_replace(',', '', $this->request->getRequestParam('vnu_capacity'))
831
-                : EE_INF,
832
-            'VNU_url'             => $this->request->getRequestParam('vnu_url'),
833
-            'VNU_virtual_phone'   => $this->request->getRequestParam('vnu_virtual_phone'),
834
-            'VNU_virtual_url'     => $this->request->getRequestParam('vnu_virtual_url'),
835
-            'VNU_enable_for_gmap' => $this->request->getRequestParam('vnu_enable_for_gmap', false, 'bool'),
836
-            'VNU_google_map_link' => $this->request->getRequestParam('vnu_google_map_link'),
837
-        ];
838
-
839
-        // update venue
840
-        $success = $this->_venue_model->update($venue_values, [$wheres]);
841
-
842
-        // get venue_object for other metaboxes that might be added via the filter... though it would seem to make sense to just use $this->_venue_model->get_one_by_ID( $post_id ).. i have to setup where conditions to override the filters in the model that filter out autodraft and inherit statuses so we GET the inherit id!
843
-        $get_one_where = [$this->_venue_model->primary_key_name() => $post_id, 'status' => $post->post_status];
844
-        $venue         = $this->_venue_model->get_one([$get_one_where]);
845
-
846
-        // notice we've applied a filter for venue metabox callbacks but we don't actually have any default venue metaboxes in use.  So this is just here for addons to more easily hook into venue saves.
847
-        $venue_update_callbacks = apply_filters(
848
-            'FHEE__Venues_Admin_Page___insert_update_cpt_item__venue_update_callbacks',
849
-            []
850
-        );
851
-        $att_success            = true;
852
-        foreach ($venue_update_callbacks as $v_callback) {
853
-            // if ANY of these updates fail then we want the appropriate global error message
854
-            $att_success = call_user_func_array($v_callback, [$venue, $this->request->requestParams()])
855
-                ? $att_success
856
-                : false;
857
-        }
858
-
859
-        // any errors?
860
-        if ($success && ! $att_success) {
861
-            EE_Error::add_error(
862
-                esc_html__(
863
-                    'Venue Details saved successfully but something went wrong with saving attachments.',
864
-                    'event_espresso'
865
-                ),
866
-                __FILE__,
867
-                __FUNCTION__,
868
-                __LINE__
869
-            );
870
-        } elseif ($success === false) {
871
-            EE_Error::add_error(
872
-                esc_html__('Venue Details did not save successfully.', 'event_espresso'),
873
-                __FILE__,
874
-                __FUNCTION__,
875
-                __LINE__
876
-            );
877
-        }
878
-    }
879
-
880
-
881
-    /**
882
-     * @param int $post_id
883
-     * @throws EE_Error
884
-     * @throws ReflectionException
885
-     */
886
-    public function trash_cpt_item($post_id)
887
-    {
888
-        $this->request->setRequestParam('VNU_ID', $post_id);
889
-        $this->_trash_or_restore_venue('trash', false);
890
-    }
891
-
892
-
893
-    /**
894
-     * @param int $post_id
895
-     * @throws EE_Error
896
-     * @throws ReflectionException
897
-     */
898
-    public function restore_cpt_item($post_id)
899
-    {
900
-        $this->request->setRequestParam('VNU_ID', $post_id);
901
-        $this->_trash_or_restore_venue('draft', false);
902
-    }
903
-
904
-
905
-    /**
906
-     * @param int $post_id
907
-     * @throws EE_Error
908
-     * @throws ReflectionException
909
-     */
910
-    public function delete_cpt_item($post_id)
911
-    {
912
-        $this->request->setRequestParam('VNU_ID', $post_id);
913
-        $this->_delete_venue(false);
914
-    }
915
-
916
-
917
-    public function get_venue_object()
918
-    {
919
-        return $this->_cpt_model_obj;
920
-    }
921
-
922
-
923
-    /**
924
-     * @throws EE_Error
925
-     * @throws ReflectionException
926
-     */
927
-    protected function _trash_or_restore_venue($venue_status = 'trash', $redirect_after = true)
928
-    {
929
-        $VNU_ID = $this->request->getRequestParam('VNU_ID', 0, 'int');
930
-
931
-        // loop thru venues
932
-        if ($VNU_ID) {
933
-            // clean status
934
-            $venue_status = sanitize_key($venue_status);
935
-            // grab status
936
-            if (! empty($venue_status)) {
937
-                $success = $this->_change_venue_status($VNU_ID, $venue_status);
938
-            } else {
939
-                $success = false;
940
-                $msg     = esc_html__(
941
-                    'An error occurred. The venue could not be moved to the trash because a valid venue status was not not supplied.',
942
-                    'event_espresso'
943
-                );
944
-                EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
945
-            }
946
-        } else {
947
-            $success = false;
948
-            $msg     = esc_html__(
949
-                'An error occurred. The venue could not be moved to the trash because a valid venue ID was not not supplied.',
950
-                'event_espresso'
951
-            );
952
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
953
-        }
954
-        $action = $venue_status == 'trash' ? 'moved to the trash' : 'restored from the trash';
955
-
956
-        if ($redirect_after) {
957
-            $this->_redirect_after_action($success, 'Venue', $action, ['action' => 'default']);
958
-        }
959
-    }
960
-
961
-
962
-    /**
963
-     * @throws EE_Error
964
-     * @throws ReflectionException
965
-     */
966
-    protected function _trash_or_restore_venues($venue_status = 'trash')
967
-    {
968
-        // clean status
969
-        $venue_status = sanitize_key($venue_status);
970
-        // grab status
971
-        if (! empty($venue_status)) {
972
-            $success = true;
973
-            // determine the event id and set to array.
974
-            $VNU_IDs = $this->request->getRequestParam('venue_id', [], 'int', true);
975
-            // loop thru events
976
-            foreach ($VNU_IDs as $VNU_ID) {
977
-                if ($VNU_ID = absint($VNU_ID)) {
978
-                    $results = $this->_change_venue_status($VNU_ID, $venue_status);
979
-                    $success = $results !== false ? $success : false;
980
-                } else {
981
-                    $msg = sprintf(
982
-                        esc_html__(
983
-                            'An error occurred. Venue #%d could not be moved to the trash because a valid venue ID was not not supplied.',
984
-                            'event_espresso'
985
-                        ),
986
-                        $VNU_ID
987
-                    );
988
-                    EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
989
-                    $success = false;
990
-                }
991
-            }
992
-        } else {
993
-            $success = false;
994
-            $msg     = esc_html__(
995
-                'An error occurred. The venue could not be moved to the trash because a valid venue status was not not supplied.',
996
-                'event_espresso'
997
-            );
998
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
999
-        }
1000
-        // in order to force a pluralized result message we need to send back a success status greater than 1
1001
-        $success = $success ? 2 : false;
1002
-        $action  = $venue_status == 'trash' ? 'moved to the trash' : 'restored from the trash';
1003
-        $this->_redirect_after_action($success, 'Venues', $action, ['action' => 'default']);
1004
-    }
1005
-
1006
-
1007
-    /**
1008
-     * _trash_or_restore_venues
1009
-     *
1010
-     * //todo this is pretty much the same as the corresponding change_event_status method in Events_Admin_Page.  We
1011
-     * should probably abstract this up to the EE_Admin_Page_CPT (or even EE_Admin_Page) and make this a common method
1012
-     * accepting a certain number of params.
1013
-     *
1014
-     * @access  private
1015
-     * @param int    $VNU_ID
1016
-     * @param string $venue_status
1017
-     * @return bool
1018
-     * @throws EE_Error
1019
-     * @throws ReflectionException
1020
-     */
1021
-    private function _change_venue_status($VNU_ID = 0, $venue_status = '')
1022
-    {
1023
-        // grab venue id
1024
-        if (! $VNU_ID) {
1025
-            $msg = esc_html__('An error occurred. No Venue ID or an invalid Venue ID was received.', 'event_espresso');
1026
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1027
-            return false;
1028
-        }
1029
-
1030
-        $this->_cpt_model_obj = EEM_Venue::instance()->get_one_by_ID($VNU_ID);
1031
-
1032
-        // clean status
1033
-        $venue_status = sanitize_key($venue_status);
1034
-        // grab status
1035
-        if (! $venue_status) {
1036
-            $msg = esc_html__(
1037
-                'An error occurred. No Venue Status or an invalid Venue Status was received.',
1038
-                'event_espresso'
1039
-            );
1040
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1041
-            return false;
1042
-        }
1043
-
1044
-        // was event trashed or restored ?
1045
-        switch ($venue_status) {
1046
-            case 'draft':
1047
-                $action = 'restored from the trash';
1048
-                $hook   = 'AHEE_venue_restored_from_trash';
1049
-                break;
1050
-            case 'trash':
1051
-                $action = 'moved to the trash';
1052
-                $hook   = 'AHEE_venue_moved_to_trash';
1053
-                break;
1054
-            default:
1055
-                $action = 'updated';
1056
-                $hook   = false;
1057
-        }
1058
-        // use class to change status
1059
-        $this->_cpt_model_obj->set_status($venue_status);
1060
-        $success = $this->_cpt_model_obj->save();
1061
-
1062
-        if ($success === false) {
1063
-            $msg = sprintf(esc_html__('An error occurred. The venue could not be %s.', 'event_espresso'), $action);
1064
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1065
-            return false;
1066
-        }
1067
-        if ($hook) {
1068
-            do_action($hook);
1069
-        }
1070
-        return true;
1071
-    }
1072
-
1073
-
1074
-    /**
1075
-     * @param bool $redirect_after
1076
-     * @return void
1077
-     * @throws EE_Error
1078
-     * @throws ReflectionException
1079
-     */
1080
-    protected function _delete_venue($redirect_after = true)
1081
-    {
1082
-        // determine the venue id and set to array.
1083
-        $VNU_ID = $this->request->getRequestParam('VNU_ID', 0, 'int');
1084
-        $VNU_ID = $this->request->getRequestParam('post', $VNU_ID, 'int');
1085
-
1086
-        // loop thru venues
1087
-        if ($VNU_ID) {
1088
-            $success = $this->_delete_or_trash_venue($VNU_ID);
1089
-        } else {
1090
-            $success = false;
1091
-            $msg     = esc_html__(
1092
-                'An error occurred. An venue could not be deleted because a valid venue ID was not not supplied.',
1093
-                'event_espresso'
1094
-            );
1095
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1096
-        }
1097
-        if ($redirect_after) {
1098
-            $this->_redirect_after_action($success, 'Venue', 'deleted', ['action' => 'default']);
1099
-        }
1100
-    }
1101
-
1102
-
1103
-    /**
1104
-     * @throws EE_Error
1105
-     * @throws ReflectionException
1106
-     */
1107
-    protected function _delete_venues()
1108
-    {
1109
-        $success = true;
1110
-        // determine the event id and set to array.
1111
-        $VNU_IDs = $this->request->getRequestParam('venue_id', [], 'int', true);
1112
-        // loop thru events
1113
-        foreach ($VNU_IDs as $VNU_ID) {
1114
-            if ($VNU_ID = absint($VNU_ID)) {
1115
-                $results = $this->_delete_or_trash_venue($VNU_ID);
1116
-                $success = $results !== false ? $success : false;
1117
-            } else {
1118
-                $success = false;
1119
-                $msg     = esc_html__(
1120
-                    'An error occurred. An venue could not be deleted because a valid venue ID was not not supplied.',
1121
-                    'event_espresso'
1122
-                );
1123
-                EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1124
-            }
1125
-        }
1126
-        // in order to force a pluralized result message we need to send back a success status greater than 1
1127
-        $success = $success ? 2 : false;
1128
-        $this->_redirect_after_action(
1129
-            $success,
1130
-            esc_html__('Venues', 'event_espresso'),
1131
-            esc_html__('deleted', 'event_espresso'),
1132
-            ['action' => 'default']
1133
-        );
1134
-    }
1135
-
1136
-
1137
-    // todo: put in parent
1138
-
1139
-
1140
-    /**
1141
-     * @throws EE_Error
1142
-     * @throws ReflectionException
1143
-     */
1144
-    private function _delete_or_trash_venue($VNU_ID = false)
1145
-    {
1146
-        // grab event id
1147
-        if (! $VNU_ID = absint($VNU_ID)) {
1148
-            $msg = esc_html__('An error occurred. No Venue ID or an invalid Venue ID was received.', 'event_espresso');
1149
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1150
-            return false;
1151
-        }
1152
-
1153
-
1154
-        $venue = EEM_Venue::instance()->get_one_by_ID($VNU_ID);
1155
-        // first need to remove all term relationships
1156
-        $venue->_remove_relations('Term_Taxonomy');
1157
-        $success = $venue->delete_permanently();
1158
-        // did it all go as planned ?
1159
-        if ($success) {
1160
-            $msg = sprintf(esc_html__('Venue ID # %d has been deleted.', 'event_espresso'), $VNU_ID);
1161
-            EE_Error::add_success($msg);
1162
-        } else {
1163
-            $msg =
1164
-                sprintf(
1165
-                    esc_html__('An error occurred. Venue ID # %d could not be deleted.', 'event_espresso'),
1166
-                    $VNU_ID
1167
-                );
1168
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1169
-            return false;
1170
-        }
1171
-        do_action('AHEE__Venues_Admin_Page___delete_or_trash_venue__after_venue_deleted');
1172
-        return true;
1173
-    }
1174
-
1175
-
1176
-
1177
-
1178
-    /***********/
1179
-    /* QUERIES */
1180
-
1181
-
1182
-    public function get_venues($per_page = 10, $count = false)
1183
-    {
1184
-
1185
-        $orderby = $this->request->getRequestParam('orderby', '');
1186
-
1187
-        switch ($orderby) {
1188
-            case 'id':
1189
-                $orderby = 'VNU_ID';
1190
-                break;
1191
-
1192
-            case 'capacity':
1193
-                $orderby = 'VNU_capacity';
1194
-                break;
1195
-
1196
-            case 'city':
1197
-                $orderby = 'VNU_city';
1198
-                break;
1199
-
1200
-            default:
1201
-                $orderby = 'VNU_name';
1202
-        }
1203
-
1204
-        $sort         = $this->request->getRequestParam('order', 'ASC');
1205
-        $current_page = $this->request->getRequestParam('paged', 1, 'int');
1206
-        $per_page     = ! empty($per_page) ? $per_page : 10;
1207
-        $per_page     = $this->request->getRequestParam('perpage', $per_page, 'int');
1208
-
1209
-        $offset = ($current_page - 1) * $per_page;
1210
-        $limit  = [$offset, $per_page];
1211
-
1212
-        $category = $this->request->getRequestParam('category');
1213
-        $category = $category > 0 ? $category : null;
1214
-
1215
-        $where = [];
1216
-
1217
-        // only set initial status if it is in the incoming request.  Otherwise the "all" view display's all statuses.
1218
-        $status = $this->request->getRequestParam('status');
1219
-        if ($status && $status !== 'all') {
1220
-            $where['status'] = $status;
1221
-        }
1222
-
1223
-        $venue_status = $this->request->getRequestParam('venue_status');
1224
-        if ($venue_status) {
1225
-            $where['status'] = $venue_status;
1226
-        }
1227
-
1228
-
1229
-        if ($category) {
1230
-            $where['Term_Taxonomy.taxonomy'] = 'espresso_venue_categories';
1231
-            $where['Term_Taxonomy.term_id']  = $category;
1232
-        }
1233
-
1234
-
1235
-        if (! EE_Registry::instance()->CAP->current_user_can('ee_read_others_venues', 'get_venues')) {
1236
-            $where['VNU_wp_user'] = get_current_user_id();
1237
-        } else {
1238
-            if (! EE_Registry::instance()->CAP->current_user_can('ee_read_private_venues', 'get_venues')) {
1239
-                $where['OR'] = [
1240
-                    'status*restrict_private' => ['!=', 'private'],
1241
-                    'AND'                     => [
1242
-                        'status*inclusive' => ['=', 'private'],
1243
-                        'VNU_wp_user'      => get_current_user_id(),
1244
-                    ],
1245
-                ];
1246
-            }
1247
-        }
1248
-
1249
-        $search_term = $this->request->getRequestParam('s');
1250
-        if ($search_term) {
1251
-            $search_term = '%' . $search_term . '%';
1252
-            $where['OR'] = [
1253
-                'VNU_name'               => ['LIKE', $search_term],
1254
-                'VNU_desc'               => ['LIKE', $search_term],
1255
-                'VNU_short_desc'         => ['LIKE', $search_term],
1256
-                'VNU_address'            => ['LIKE', $search_term],
1257
-                'VNU_address2'           => ['LIKE', $search_term],
1258
-                'VNU_city'               => ['LIKE', $search_term],
1259
-                'VNU_zip'                => ['LIKE', $search_term],
1260
-                'VNU_phone'              => ['LIKE', $search_term],
1261
-                'VNU_url'                => ['LIKE', $search_term],
1262
-                'VNU_virtual_phone'      => ['LIKE', $search_term],
1263
-                'VNU_virtual_url'        => ['LIKE', $search_term],
1264
-                'VNU_google_map_link'    => ['LIKE', $search_term],
1265
-                'Event.EVT_name'         => ['LIKE', $search_term],
1266
-                'Event.EVT_desc'         => ['LIKE', $search_term],
1267
-                'Event.EVT_phone'        => ['LIKE', $search_term],
1268
-                'Event.EVT_external_URL' => ['LIKE', $search_term],
1269
-            ];
1270
-        }
1271
-
1272
-
1273
-        return $count
1274
-            ? $this->_venue_model->count([$where], 'VNU_ID')
1275
-            : $this->_venue_model->get_all(
1276
-                [$where, 'limit' => $limit, 'order_by' => $orderby, 'order' => $sort]
1277
-            );
1278
-    }
1279
-
1280
-
1281
-
1282
-
1283
-    /** Venue Category Stuff **/
1284
-
1285
-    /**
1286
-     * set the _category property with the category object for the loaded page.
1287
-     *
1288
-     * @access private
1289
-     * @return void
1290
-     */
1291
-    private function _set_category_object()
1292
-    {
1293
-        if (isset($this->_category->id) && ! empty($this->_category->id)) {
1294
-            return;
1295
-        } // already have the category object so get out.
1296
-
1297
-        // set default category object
1298
-        $this->_set_empty_category_object();
1299
-
1300
-        // only set if we've got an id
1301
-        $category_ID = $this->request->getRequestParam('VEN_CAT_ID', 0, 'int');
1302
-        if (! $category_ID) {
1303
-            return;
1304
-        }
1305
-
1306
-        $term = get_term($category_ID, 'espresso_venue_categories');
1307
-
1308
-
1309
-        if (! empty($term)) {
1310
-            $this->_category->category_name       = $term->name;
1311
-            $this->_category->category_identifier = $term->slug;
1312
-            $this->_category->category_desc       = $term->description;
1313
-            $this->_category->id                  = $term->term_id;
1314
-            $this->_category->parent              = $term->parent;
1315
-        }
1316
-    }
1317
-
1318
-
1319
-    private function _set_empty_category_object()
1320
-    {
1321
-        $this->_category                = new stdClass();
1322
-        $this->_category->category_name = $this->_category->category_identifier = $this->_category->category_desc = '';
1323
-        $this->_category->id            = $this->_category->parent = 0;
1324
-    }
1325
-
1326
-
1327
-    /**
1328
-     * @throws EE_Error
1329
-     */
1330
-    protected function _category_list_table()
1331
-    {
1332
-        do_action('AHEE_log', __FILE__, __FUNCTION__, '');
1333
-        $this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
1334
-            'add_category',
1335
-            'add_category',
1336
-            [],
1337
-            'add-new-h2'
1338
-        );
1339
-        $this->_search_btn_label = esc_html__('Venue Categories', 'event_espresso');
1340
-        $this->display_admin_list_table_page_with_sidebar();
1341
-    }
1342
-
1343
-
1344
-    /**
1345
-     * @throws EE_Error
1346
-     */
1347
-    protected function _category_details($view)
1348
-    {
1349
-
1350
-        // load formatter helper
1351
-        // load field generator helper
1352
-
1353
-        $route = $view == 'edit' ? 'update_category' : 'insert_category';
1354
-        $this->_set_add_edit_form_tags($route);
1355
-
1356
-        $this->_set_category_object();
1357
-        $id = ! empty($this->_category->id) ? $this->_category->id : '';
1358
-
1359
-        $delete_action = 'delete_category';
1360
-
1361
-        $redirect = EE_Admin_Page::add_query_args_and_nonce(['action' => 'category_list'], $this->_admin_base_url);
1362
-
1363
-        $this->_set_publish_post_box_vars('VEN_CAT_ID', $id, $delete_action, $redirect);
1364
-
1365
-        // take care of contents
1366
-        $this->_template_args['admin_page_content'] = $this->_category_details_content();
1367
-        $this->display_admin_page_with_sidebar();
1368
-    }
1369
-
1370
-
1371
-    protected function _category_details_content()
1372
-    {
1373
-        $editor_args['category_desc'] = [
1374
-            'type'          => 'wp_editor',
1375
-            'value'         => EEH_Formatter::admin_format_content($this->_category->category_desc),
1376
-            'class'         => 'my_editor_custom',
1377
-            'wpeditor_args' => ['media_buttons' => false],
1378
-        ];
1379
-        $_wp_editor                   = $this->_generate_admin_form_fields($editor_args, 'array');
1380
-
1381
-        $all_terms = get_terms(
1382
-            ['espresso_venue_categories'],
1383
-            ['hide_empty' => 0, 'exclude' => [$this->_category->id]]
1384
-        );
1385
-
1386
-        // setup category select for term parents.
1387
-        $category_select_values[] = [
1388
-            'text' => esc_html__('No Parent', 'event_espresso'),
1389
-            'id'   => 0,
1390
-        ];
1391
-        foreach ($all_terms as $term) {
1392
-            $category_select_values[] = [
1393
-                'text' => $term->name,
1394
-                'id'   => $term->term_id,
1395
-            ];
1396
-        }
1397
-
1398
-        $category_select = EEH_Form_Fields::select_input(
1399
-            'category_parent',
1400
-            $category_select_values,
1401
-            $this->_category->parent
1402
-        );
1403
-        $template_args   = [
1404
-            'category'                 => $this->_category,
1405
-            'category_select'          => $category_select,
1406
-            'unique_id_info_help_link' => $this->_get_help_tab_link('unique_id_info'),
1407
-            'category_desc_editor'     => $_wp_editor['category_desc']['field'],
1408
-            'disable'                  => '',
1409
-            'disabled_message'         => false,
1410
-        ];
1411
-        $template        = EVENTS_TEMPLATE_PATH . 'event_category_details.template.php';
1412
-        return EEH_Template::display_template($template, $template_args, true);
1413
-    }
1414
-
1415
-
1416
-    /**
1417
-     * @throws EE_Error
1418
-     */
1419
-    protected function _delete_categories()
1420
-    {
1421
-        $category_ID  = $this->request->getRequestParam('category_id', 0, 'int');
1422
-        $category_IDs = $this->request->getRequestParam('VEN_CAT_ID', [$category_ID], 'int', true);
1423
-
1424
-        foreach ($category_IDs as $cat_id) {
1425
-            $this->_delete_category($cat_id);
1426
-        }
1427
-
1428
-        // doesn't matter what page we're coming from... we're going to the same place after delete.
1429
-        $query_args = [
1430
-            'action' => 'category_list',
1431
-        ];
1432
-        $this->_redirect_after_action(0, '', '', $query_args);
1433
-    }
1434
-
1435
-
1436
-    protected function _delete_category($cat_id)
1437
-    {
1438
-        $cat_id = absint($cat_id);
1439
-        wp_delete_term($cat_id, 'espresso_venue_categories');
1440
-    }
1441
-
1442
-
1443
-    /**
1444
-     * @throws EE_Error
1445
-     */
1446
-    protected function _insert_or_update_category($new_category)
1447
-    {
1448
-
1449
-        $cat_id  = $new_category ? $this->_insert_category() : $this->_insert_category(true);
1450
-        $success = 0; // we already have a success message so lets not send another.
1451
-        if ($cat_id) {
1452
-            $query_args = [
1453
-                'action'     => 'edit_category',
1454
-                'VEN_CAT_ID' => $cat_id,
1455
-            ];
1456
-        } else {
1457
-            $query_args = ['action' => 'add_category'];
1458
-        }
1459
-        $this->_redirect_after_action($success, '', '', $query_args, true);
1460
-    }
1461
-
1462
-
1463
-    private function _insert_category($update = false)
1464
-    {
1465
-        $category_ID     = $update ? $this->request->getRequestParam('VEN_CAT_ID', '', 'int') : '';
1466
-        $category_name   = $this->request->getRequestParam('category_name', '');
1467
-        $category_desc   = $this->request->getRequestParam('category_desc', '', 'html');
1468
-        $category_parent = $this->request->getRequestParam('category_parent', 0, 'int');
1469
-
1470
-        if (empty($category_name)) {
1471
-            $msg = esc_html__('You must add a name for the category.', 'event_espresso');
1472
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1473
-            return false;
1474
-        }
1475
-
1476
-
1477
-        $term_args = [
1478
-            'name'        => $category_name,
1479
-            'description' => $category_desc,
1480
-            'parent'      => $category_parent,
1481
-        ];
1482
-
1483
-        $insert_ids = $update
1484
-            ? wp_update_term($category_ID, 'espresso_venue_categories', $term_args)
1485
-            : wp_insert_term(
1486
-                $category_name,
1487
-                'espresso_venue_categories',
1488
-                $term_args
1489
-            );
1490
-
1491
-        if (! is_array($insert_ids)) {
1492
-            EE_Error::add_error(
1493
-                esc_html__('An error occurred and the category has not been saved to the database.', 'event_espresso'),
1494
-                __FILE__,
1495
-                __FUNCTION__,
1496
-                __LINE__
1497
-            );
1498
-        } else {
1499
-            $category_ID = $insert_ids['term_id'];
1500
-            EE_Error::add_success(
1501
-                sprintf(
1502
-                    esc_html__('The category %s was successfully created', 'event_espresso'),
1503
-                    $category_name
1504
-                )
1505
-            );
1506
-        }
1507
-
1508
-        return $category_ID;
1509
-    }
1510
-
1511
-
1512
-    /**
1513
-     * TODO handle category exports()
1514
-     *
1515
-     * @return void
1516
-     */
1517
-    protected function _categories_export()
1518
-    {
1519
-        // todo: I don't like doing this but it'll do until we modify EE_Export Class.
1520
-        $this->request->mergeRequestParams(
1521
-            [
1522
-                'export'       => 'report',
1523
-                'action'       => 'categories',
1524
-                'category_ids' => $this->request->getRequestParam('VEN_CAT_ID', 0, 'int'),
1525
-            ]
1526
-        );
1527
-
1528
-        if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
1529
-            require_once(EE_CLASSES . 'EE_Export.class.php');
1530
-            $EE_Export = EE_Export::instance($this->request->requestParams());
1531
-            $EE_Export->export();
1532
-        }
1533
-    }
1534
-
1535
-
1536
-    protected function _import_categories()
1537
-    {
1538
-
1539
-        require_once(EE_CLASSES . 'EE_Import.class.php');
1540
-        EE_Import::instance()->import();
1541
-    }
1542
-
1543
-
1544
-    /**
1545
-     * @throws EE_Error
1546
-     */
1547
-    public function get_categories($per_page = 10, $current_page = 1, $count = false)
1548
-    {
1549
-
1550
-        // testing term stuff
1551
-        $orderby     = $this->request->getRequestParam('orderby', 'Term.term_id');
1552
-        $order       = $this->request->getRequestParam('order', 'DESC');
1553
-        $limit       = ($current_page - 1) * $per_page;
1554
-        $where       = ['taxonomy' => 'espresso_venue_categories'];
1555
-        $search_term = $this->request->getRequestParam('s');
1556
-        if ($search_term) {
1557
-            $search_term = '%' . $search_term . '%';
1558
-            $where['OR'] = [
1559
-                'Term.name'   => ['LIKE', $search_term],
1560
-                'description' => ['LIKE', $search_term],
1561
-            ];
1562
-        }
1563
-
1564
-        $query_params = [
1565
-            $where,
1566
-            'order_by'   => [$orderby => $order],
1567
-            'limit'      => $limit . ',' . $per_page,
1568
-            'force_join' => ['Term'],
1569
-        ];
1570
-
1571
-        return $count
1572
-            ? EEM_Term_Taxonomy::instance()->count($query_params, 'term_id')
1573
-            : EEM_Term_Taxonomy::instance()->get_all($query_params);
1574
-    }
1575
-
1576
-
1577
-    /* end category stuff */
1578
-    /**************/
577
+	protected function _google_map_settings()
578
+	{
579
+
580
+
581
+		$this->_template_args['values']           = $this->_yes_no_values;
582
+		$default_map_settings                     = new stdClass();
583
+		$default_map_settings->use_google_maps    = true;
584
+		$default_map_settings->google_map_api_key = '';
585
+		// for event details pages (reg page)
586
+		$default_map_settings->event_details_map_width    = 585;
587
+		// ee_map_width_single
588
+		$default_map_settings->event_details_map_height   = 362;
589
+		// ee_map_height_single
590
+		$default_map_settings->event_details_map_zoom     = 14;
591
+		// ee_map_zoom_single
592
+		$default_map_settings->event_details_display_nav  = true;
593
+		// ee_map_nav_display_single
594
+		$default_map_settings->event_details_nav_size     = false;
595
+		// ee_map_nav_size_single
596
+		$default_map_settings->event_details_control_type = 'default';
597
+		// ee_map_type_control_single
598
+		$default_map_settings->event_details_map_align    = 'center';
599
+		// ee_map_align_single
600
+
601
+		// for event list pages
602
+		$default_map_settings->event_list_map_width    = 300;
603
+		// ee_map_width
604
+		$default_map_settings->event_list_map_height   = 185;
605
+		// ee_map_height
606
+		$default_map_settings->event_list_map_zoom     = 12;
607
+		// ee_map_zoom
608
+		$default_map_settings->event_list_display_nav  = false;
609
+		// ee_map_nav_display
610
+		$default_map_settings->event_list_nav_size     = true;
611
+		// ee_map_nav_size
612
+		$default_map_settings->event_list_control_type = 'dropdown';
613
+		// ee_map_type_control
614
+		$default_map_settings->event_list_map_align    = 'center';
615
+		// ee_map_align
616
+
617
+		$this->_template_args['map_settings'] =
618
+			isset(EE_Registry::instance()->CFG->map_settings)
619
+			&& ! empty(EE_Registry::instance()->CFG->map_settings)
620
+				? (object) array_merge(
621
+					(array) $default_map_settings,
622
+					(array) EE_Registry::instance()->CFG->map_settings
623
+				)
624
+				: $default_map_settings;
625
+
626
+		$this->_set_add_edit_form_tags('update_google_map_settings');
627
+		$this->_set_publish_post_box_vars(null, false, false, null, false);
628
+		$this->_template_args['admin_page_content'] = EEH_Template::display_template(
629
+			EE_VENUES_TEMPLATE_PATH . 'google_map.template.php',
630
+			$this->_template_args,
631
+			true
632
+		);
633
+		$this->display_admin_page_with_sidebar();
634
+	}
635
+
636
+
637
+	/**
638
+	 * @throws EE_Error
639
+	 */
640
+	protected function _update_google_map_settings()
641
+	{
642
+		$map_settings = EE_Registry::instance()->CFG->map_settings;
643
+
644
+		$settings = [
645
+			'use_google_maps'            => 'int',
646
+			'google_map_api_key'         => 'string',
647
+			'event_details_map_width'    => 'int',
648
+			'event_details_map_zoom'     => 'int',
649
+			'event_details_display_nav'  => 'int',
650
+			'event_details_nav_size'     => 'int',
651
+			'event_details_control_type' => 'string',
652
+			'event_details_map_align'    => 'string',
653
+			'event_list_map_width'       => 'int',
654
+			'event_list_map_height'      => 'int',
655
+			'event_list_map_zoom'        => 'int',
656
+			'event_list_display_nav'     => 'int',
657
+			'event_list_nav_size'        => 'int',
658
+			'event_list_control_type'    => 'string',
659
+			'event_list_map_align'       => 'string',
660
+		];
661
+
662
+		foreach ($settings as $setting => $type) {
663
+			$map_settings->{$setting} = $this->request->getRequestParam($setting, $map_settings->{$setting}, $type);
664
+		}
665
+
666
+		EE_Registry::instance()->CFG->map_settings = apply_filters(
667
+			'FHEE__Extend_General_Settings_Admin_Page___update_google_map_settings__CFG_map_settings',
668
+			$map_settings
669
+		);
670
+
671
+		$what    = 'Google Map Settings';
672
+		$success = $this->_update_espresso_configuration(
673
+			$what,
674
+			EE_Registry::instance()->CFG->map_settings,
675
+			__FILE__,
676
+			__FUNCTION__,
677
+			__LINE__
678
+		);
679
+		$this->_redirect_after_action($success, $what, 'updated', ['action' => 'google_map_settings']);
680
+	}
681
+
682
+
683
+	/**
684
+	 * @throws EE_Error
685
+	 * @throws ReflectionException
686
+	 */
687
+	protected function _venue_editor_metaboxes()
688
+	{
689
+		$this->verify_cpt_object();
690
+
691
+		add_meta_box(
692
+			'espresso_venue_address_options',
693
+			esc_html__('Physical Location', 'event_espresso'),
694
+			[$this, 'venue_address_metabox'],
695
+			$this->page_slug,
696
+			'side'
697
+		);
698
+		add_meta_box(
699
+			'espresso_venue_gmap_options',
700
+			esc_html__('Google Map', 'event_espresso'),
701
+			[$this, 'venue_gmap_metabox'],
702
+			$this->page_slug,
703
+			'side'
704
+		);
705
+		add_meta_box(
706
+			'espresso_venue_virtual_loc_options',
707
+			esc_html__('Virtual Location', 'event_espresso'),
708
+			[$this, 'venue_virtual_loc_metabox'],
709
+			$this->page_slug,
710
+			'side'
711
+		);
712
+	}
713
+
714
+
715
+	public function venue_gmap_metabox()
716
+	{
717
+		$template_args = [
718
+			'vnu_enable_for_gmap' => EEH_Form_Fields::select_input(
719
+				'vnu_enable_for_gmap',
720
+				$this->get_yes_no_values(),
721
+				$this->_cpt_model_obj instanceof EE_Venue ? $this->_cpt_model_obj->enable_for_gmap() : false
722
+			),
723
+			'vnu_google_map_link' => $this->_cpt_model_obj->google_map_link(),
724
+		];
725
+		$template      = EE_VENUES_TEMPLATE_PATH . 'venue_gmap_metabox_content.template.php';
726
+		EEH_Template::display_template($template, $template_args);
727
+	}
728
+
729
+
730
+	/**
731
+	 * @throws EE_Error
732
+	 * @throws ReflectionException
733
+	 */
734
+	public function venue_address_metabox()
735
+	{
736
+		$template_args['_venue'] = $this->_cpt_model_obj;
737
+
738
+		$template_args['states_dropdown']    = EEH_Form_Fields::generate_form_input(
739
+			new EE_Question_Form_Input(
740
+				EE_Question::new_instance(
741
+					['QST_display_text' => esc_html__('State', 'event_espresso'), 'QST_system' => 'state']
742
+				),
743
+				EE_Answer::new_instance(
744
+					[
745
+						'ANS_value' => $this->_cpt_model_obj instanceof EE_Venue
746
+							? $this->_cpt_model_obj->state_ID()
747
+							: 0,
748
+					]
749
+				),
750
+				[
751
+					'input_name'     => 'sta_id',
752
+					'input_id'       => 'sta_id',
753
+					'input_class'    => '',
754
+					'input_prefix'   => '',
755
+					'append_qstn_id' => false,
756
+				]
757
+			)
758
+		);
759
+		$template_args['countries_dropdown'] = EEH_Form_Fields::generate_form_input(
760
+			new EE_Question_Form_Input(
761
+				EE_Question::new_instance(
762
+					['QST_display_text' => esc_html__('Country', 'event_espresso'), 'QST_system' => 'country']
763
+				),
764
+				EE_Answer::new_instance(
765
+					[
766
+						'ANS_value' => $this->_cpt_model_obj instanceof EE_Venue
767
+							? $this->_cpt_model_obj->country_ID()
768
+							: 0,
769
+					]
770
+				),
771
+				[
772
+					'input_name'     => 'cnt_iso',
773
+					'input_id'       => 'cnt_iso',
774
+					'input_class'    => '',
775
+					'input_prefix'   => '',
776
+					'append_qstn_id' => false,
777
+				]
778
+			)
779
+		);
780
+
781
+		$template = EE_VENUES_TEMPLATE_PATH . 'venue_address_metabox_content.template.php';
782
+		EEH_Template::display_template($template, $template_args);
783
+	}
784
+
785
+
786
+	public function venue_virtual_loc_metabox()
787
+	{
788
+		$template_args = [
789
+			'_venue' => $this->_cpt_model_obj,
790
+		];
791
+		$template      = EE_VENUES_TEMPLATE_PATH . 'venue_virtual_location_metabox_content.template.php';
792
+		EEH_Template::display_template($template, $template_args);
793
+	}
794
+
795
+
796
+	protected function _restore_cpt_item($post_id, $revision_id)
797
+	{
798
+		$venue_obj = $this->_venue_model->get_one_by_ID($post_id);
799
+
800
+		// meta revision restore
801
+		$venue_obj->restore_revision($revision_id);
802
+	}
803
+
804
+
805
+	/**
806
+	 * Handles updates for venue cpts
807
+	 *
808
+	 * @param int    $post_id ID of Venue CPT
809
+	 * @param WP_Post $post    Post object (with "blessed" WP properties)
810
+	 * @return void
811
+	 */
812
+	protected function _insert_update_cpt_item($post_id, $post)
813
+	{
814
+
815
+		if ($post instanceof WP_Post && $post->post_type !== 'espresso_venues') {
816
+			return;// get out we're not processing the saving of venues.
817
+		}
818
+
819
+		$wheres = [$this->_venue_model->primary_key_name() => $post_id];
820
+
821
+		$venue_values = [
822
+			'VNU_address'         => $this->request->getRequestParam('vnu_address'),
823
+			'VNU_address2'        => $this->request->getRequestParam('vnu_address2'),
824
+			'VNU_city'            => $this->request->getRequestParam('vnu_city'),
825
+			'STA_ID'              => $this->request->getRequestParam('sta_id'),
826
+			'CNT_ISO'             => $this->request->getRequestParam('cnt_iso'),
827
+			'VNU_zip'             => $this->request->getRequestParam('vnu_zip'),
828
+			'VNU_phone'           => $this->request->getRequestParam('vnu_phone'),
829
+			'VNU_capacity'        => $this->request->requestParamIsSet('vnu_capacity')
830
+				? str_replace(',', '', $this->request->getRequestParam('vnu_capacity'))
831
+				: EE_INF,
832
+			'VNU_url'             => $this->request->getRequestParam('vnu_url'),
833
+			'VNU_virtual_phone'   => $this->request->getRequestParam('vnu_virtual_phone'),
834
+			'VNU_virtual_url'     => $this->request->getRequestParam('vnu_virtual_url'),
835
+			'VNU_enable_for_gmap' => $this->request->getRequestParam('vnu_enable_for_gmap', false, 'bool'),
836
+			'VNU_google_map_link' => $this->request->getRequestParam('vnu_google_map_link'),
837
+		];
838
+
839
+		// update venue
840
+		$success = $this->_venue_model->update($venue_values, [$wheres]);
841
+
842
+		// get venue_object for other metaboxes that might be added via the filter... though it would seem to make sense to just use $this->_venue_model->get_one_by_ID( $post_id ).. i have to setup where conditions to override the filters in the model that filter out autodraft and inherit statuses so we GET the inherit id!
843
+		$get_one_where = [$this->_venue_model->primary_key_name() => $post_id, 'status' => $post->post_status];
844
+		$venue         = $this->_venue_model->get_one([$get_one_where]);
845
+
846
+		// notice we've applied a filter for venue metabox callbacks but we don't actually have any default venue metaboxes in use.  So this is just here for addons to more easily hook into venue saves.
847
+		$venue_update_callbacks = apply_filters(
848
+			'FHEE__Venues_Admin_Page___insert_update_cpt_item__venue_update_callbacks',
849
+			[]
850
+		);
851
+		$att_success            = true;
852
+		foreach ($venue_update_callbacks as $v_callback) {
853
+			// if ANY of these updates fail then we want the appropriate global error message
854
+			$att_success = call_user_func_array($v_callback, [$venue, $this->request->requestParams()])
855
+				? $att_success
856
+				: false;
857
+		}
858
+
859
+		// any errors?
860
+		if ($success && ! $att_success) {
861
+			EE_Error::add_error(
862
+				esc_html__(
863
+					'Venue Details saved successfully but something went wrong with saving attachments.',
864
+					'event_espresso'
865
+				),
866
+				__FILE__,
867
+				__FUNCTION__,
868
+				__LINE__
869
+			);
870
+		} elseif ($success === false) {
871
+			EE_Error::add_error(
872
+				esc_html__('Venue Details did not save successfully.', 'event_espresso'),
873
+				__FILE__,
874
+				__FUNCTION__,
875
+				__LINE__
876
+			);
877
+		}
878
+	}
879
+
880
+
881
+	/**
882
+	 * @param int $post_id
883
+	 * @throws EE_Error
884
+	 * @throws ReflectionException
885
+	 */
886
+	public function trash_cpt_item($post_id)
887
+	{
888
+		$this->request->setRequestParam('VNU_ID', $post_id);
889
+		$this->_trash_or_restore_venue('trash', false);
890
+	}
891
+
892
+
893
+	/**
894
+	 * @param int $post_id
895
+	 * @throws EE_Error
896
+	 * @throws ReflectionException
897
+	 */
898
+	public function restore_cpt_item($post_id)
899
+	{
900
+		$this->request->setRequestParam('VNU_ID', $post_id);
901
+		$this->_trash_or_restore_venue('draft', false);
902
+	}
903
+
904
+
905
+	/**
906
+	 * @param int $post_id
907
+	 * @throws EE_Error
908
+	 * @throws ReflectionException
909
+	 */
910
+	public function delete_cpt_item($post_id)
911
+	{
912
+		$this->request->setRequestParam('VNU_ID', $post_id);
913
+		$this->_delete_venue(false);
914
+	}
915
+
916
+
917
+	public function get_venue_object()
918
+	{
919
+		return $this->_cpt_model_obj;
920
+	}
921
+
922
+
923
+	/**
924
+	 * @throws EE_Error
925
+	 * @throws ReflectionException
926
+	 */
927
+	protected function _trash_or_restore_venue($venue_status = 'trash', $redirect_after = true)
928
+	{
929
+		$VNU_ID = $this->request->getRequestParam('VNU_ID', 0, 'int');
930
+
931
+		// loop thru venues
932
+		if ($VNU_ID) {
933
+			// clean status
934
+			$venue_status = sanitize_key($venue_status);
935
+			// grab status
936
+			if (! empty($venue_status)) {
937
+				$success = $this->_change_venue_status($VNU_ID, $venue_status);
938
+			} else {
939
+				$success = false;
940
+				$msg     = esc_html__(
941
+					'An error occurred. The venue could not be moved to the trash because a valid venue status was not not supplied.',
942
+					'event_espresso'
943
+				);
944
+				EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
945
+			}
946
+		} else {
947
+			$success = false;
948
+			$msg     = esc_html__(
949
+				'An error occurred. The venue could not be moved to the trash because a valid venue ID was not not supplied.',
950
+				'event_espresso'
951
+			);
952
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
953
+		}
954
+		$action = $venue_status == 'trash' ? 'moved to the trash' : 'restored from the trash';
955
+
956
+		if ($redirect_after) {
957
+			$this->_redirect_after_action($success, 'Venue', $action, ['action' => 'default']);
958
+		}
959
+	}
960
+
961
+
962
+	/**
963
+	 * @throws EE_Error
964
+	 * @throws ReflectionException
965
+	 */
966
+	protected function _trash_or_restore_venues($venue_status = 'trash')
967
+	{
968
+		// clean status
969
+		$venue_status = sanitize_key($venue_status);
970
+		// grab status
971
+		if (! empty($venue_status)) {
972
+			$success = true;
973
+			// determine the event id and set to array.
974
+			$VNU_IDs = $this->request->getRequestParam('venue_id', [], 'int', true);
975
+			// loop thru events
976
+			foreach ($VNU_IDs as $VNU_ID) {
977
+				if ($VNU_ID = absint($VNU_ID)) {
978
+					$results = $this->_change_venue_status($VNU_ID, $venue_status);
979
+					$success = $results !== false ? $success : false;
980
+				} else {
981
+					$msg = sprintf(
982
+						esc_html__(
983
+							'An error occurred. Venue #%d could not be moved to the trash because a valid venue ID was not not supplied.',
984
+							'event_espresso'
985
+						),
986
+						$VNU_ID
987
+					);
988
+					EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
989
+					$success = false;
990
+				}
991
+			}
992
+		} else {
993
+			$success = false;
994
+			$msg     = esc_html__(
995
+				'An error occurred. The venue could not be moved to the trash because a valid venue status was not not supplied.',
996
+				'event_espresso'
997
+			);
998
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
999
+		}
1000
+		// in order to force a pluralized result message we need to send back a success status greater than 1
1001
+		$success = $success ? 2 : false;
1002
+		$action  = $venue_status == 'trash' ? 'moved to the trash' : 'restored from the trash';
1003
+		$this->_redirect_after_action($success, 'Venues', $action, ['action' => 'default']);
1004
+	}
1005
+
1006
+
1007
+	/**
1008
+	 * _trash_or_restore_venues
1009
+	 *
1010
+	 * //todo this is pretty much the same as the corresponding change_event_status method in Events_Admin_Page.  We
1011
+	 * should probably abstract this up to the EE_Admin_Page_CPT (or even EE_Admin_Page) and make this a common method
1012
+	 * accepting a certain number of params.
1013
+	 *
1014
+	 * @access  private
1015
+	 * @param int    $VNU_ID
1016
+	 * @param string $venue_status
1017
+	 * @return bool
1018
+	 * @throws EE_Error
1019
+	 * @throws ReflectionException
1020
+	 */
1021
+	private function _change_venue_status($VNU_ID = 0, $venue_status = '')
1022
+	{
1023
+		// grab venue id
1024
+		if (! $VNU_ID) {
1025
+			$msg = esc_html__('An error occurred. No Venue ID or an invalid Venue ID was received.', 'event_espresso');
1026
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1027
+			return false;
1028
+		}
1029
+
1030
+		$this->_cpt_model_obj = EEM_Venue::instance()->get_one_by_ID($VNU_ID);
1031
+
1032
+		// clean status
1033
+		$venue_status = sanitize_key($venue_status);
1034
+		// grab status
1035
+		if (! $venue_status) {
1036
+			$msg = esc_html__(
1037
+				'An error occurred. No Venue Status or an invalid Venue Status was received.',
1038
+				'event_espresso'
1039
+			);
1040
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1041
+			return false;
1042
+		}
1043
+
1044
+		// was event trashed or restored ?
1045
+		switch ($venue_status) {
1046
+			case 'draft':
1047
+				$action = 'restored from the trash';
1048
+				$hook   = 'AHEE_venue_restored_from_trash';
1049
+				break;
1050
+			case 'trash':
1051
+				$action = 'moved to the trash';
1052
+				$hook   = 'AHEE_venue_moved_to_trash';
1053
+				break;
1054
+			default:
1055
+				$action = 'updated';
1056
+				$hook   = false;
1057
+		}
1058
+		// use class to change status
1059
+		$this->_cpt_model_obj->set_status($venue_status);
1060
+		$success = $this->_cpt_model_obj->save();
1061
+
1062
+		if ($success === false) {
1063
+			$msg = sprintf(esc_html__('An error occurred. The venue could not be %s.', 'event_espresso'), $action);
1064
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1065
+			return false;
1066
+		}
1067
+		if ($hook) {
1068
+			do_action($hook);
1069
+		}
1070
+		return true;
1071
+	}
1072
+
1073
+
1074
+	/**
1075
+	 * @param bool $redirect_after
1076
+	 * @return void
1077
+	 * @throws EE_Error
1078
+	 * @throws ReflectionException
1079
+	 */
1080
+	protected function _delete_venue($redirect_after = true)
1081
+	{
1082
+		// determine the venue id and set to array.
1083
+		$VNU_ID = $this->request->getRequestParam('VNU_ID', 0, 'int');
1084
+		$VNU_ID = $this->request->getRequestParam('post', $VNU_ID, 'int');
1085
+
1086
+		// loop thru venues
1087
+		if ($VNU_ID) {
1088
+			$success = $this->_delete_or_trash_venue($VNU_ID);
1089
+		} else {
1090
+			$success = false;
1091
+			$msg     = esc_html__(
1092
+				'An error occurred. An venue could not be deleted because a valid venue ID was not not supplied.',
1093
+				'event_espresso'
1094
+			);
1095
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1096
+		}
1097
+		if ($redirect_after) {
1098
+			$this->_redirect_after_action($success, 'Venue', 'deleted', ['action' => 'default']);
1099
+		}
1100
+	}
1101
+
1102
+
1103
+	/**
1104
+	 * @throws EE_Error
1105
+	 * @throws ReflectionException
1106
+	 */
1107
+	protected function _delete_venues()
1108
+	{
1109
+		$success = true;
1110
+		// determine the event id and set to array.
1111
+		$VNU_IDs = $this->request->getRequestParam('venue_id', [], 'int', true);
1112
+		// loop thru events
1113
+		foreach ($VNU_IDs as $VNU_ID) {
1114
+			if ($VNU_ID = absint($VNU_ID)) {
1115
+				$results = $this->_delete_or_trash_venue($VNU_ID);
1116
+				$success = $results !== false ? $success : false;
1117
+			} else {
1118
+				$success = false;
1119
+				$msg     = esc_html__(
1120
+					'An error occurred. An venue could not be deleted because a valid venue ID was not not supplied.',
1121
+					'event_espresso'
1122
+				);
1123
+				EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1124
+			}
1125
+		}
1126
+		// in order to force a pluralized result message we need to send back a success status greater than 1
1127
+		$success = $success ? 2 : false;
1128
+		$this->_redirect_after_action(
1129
+			$success,
1130
+			esc_html__('Venues', 'event_espresso'),
1131
+			esc_html__('deleted', 'event_espresso'),
1132
+			['action' => 'default']
1133
+		);
1134
+	}
1135
+
1136
+
1137
+	// todo: put in parent
1138
+
1139
+
1140
+	/**
1141
+	 * @throws EE_Error
1142
+	 * @throws ReflectionException
1143
+	 */
1144
+	private function _delete_or_trash_venue($VNU_ID = false)
1145
+	{
1146
+		// grab event id
1147
+		if (! $VNU_ID = absint($VNU_ID)) {
1148
+			$msg = esc_html__('An error occurred. No Venue ID or an invalid Venue ID was received.', 'event_espresso');
1149
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1150
+			return false;
1151
+		}
1152
+
1153
+
1154
+		$venue = EEM_Venue::instance()->get_one_by_ID($VNU_ID);
1155
+		// first need to remove all term relationships
1156
+		$venue->_remove_relations('Term_Taxonomy');
1157
+		$success = $venue->delete_permanently();
1158
+		// did it all go as planned ?
1159
+		if ($success) {
1160
+			$msg = sprintf(esc_html__('Venue ID # %d has been deleted.', 'event_espresso'), $VNU_ID);
1161
+			EE_Error::add_success($msg);
1162
+		} else {
1163
+			$msg =
1164
+				sprintf(
1165
+					esc_html__('An error occurred. Venue ID # %d could not be deleted.', 'event_espresso'),
1166
+					$VNU_ID
1167
+				);
1168
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1169
+			return false;
1170
+		}
1171
+		do_action('AHEE__Venues_Admin_Page___delete_or_trash_venue__after_venue_deleted');
1172
+		return true;
1173
+	}
1174
+
1175
+
1176
+
1177
+
1178
+	/***********/
1179
+	/* QUERIES */
1180
+
1181
+
1182
+	public function get_venues($per_page = 10, $count = false)
1183
+	{
1184
+
1185
+		$orderby = $this->request->getRequestParam('orderby', '');
1186
+
1187
+		switch ($orderby) {
1188
+			case 'id':
1189
+				$orderby = 'VNU_ID';
1190
+				break;
1191
+
1192
+			case 'capacity':
1193
+				$orderby = 'VNU_capacity';
1194
+				break;
1195
+
1196
+			case 'city':
1197
+				$orderby = 'VNU_city';
1198
+				break;
1199
+
1200
+			default:
1201
+				$orderby = 'VNU_name';
1202
+		}
1203
+
1204
+		$sort         = $this->request->getRequestParam('order', 'ASC');
1205
+		$current_page = $this->request->getRequestParam('paged', 1, 'int');
1206
+		$per_page     = ! empty($per_page) ? $per_page : 10;
1207
+		$per_page     = $this->request->getRequestParam('perpage', $per_page, 'int');
1208
+
1209
+		$offset = ($current_page - 1) * $per_page;
1210
+		$limit  = [$offset, $per_page];
1211
+
1212
+		$category = $this->request->getRequestParam('category');
1213
+		$category = $category > 0 ? $category : null;
1214
+
1215
+		$where = [];
1216
+
1217
+		// only set initial status if it is in the incoming request.  Otherwise the "all" view display's all statuses.
1218
+		$status = $this->request->getRequestParam('status');
1219
+		if ($status && $status !== 'all') {
1220
+			$where['status'] = $status;
1221
+		}
1222
+
1223
+		$venue_status = $this->request->getRequestParam('venue_status');
1224
+		if ($venue_status) {
1225
+			$where['status'] = $venue_status;
1226
+		}
1227
+
1228
+
1229
+		if ($category) {
1230
+			$where['Term_Taxonomy.taxonomy'] = 'espresso_venue_categories';
1231
+			$where['Term_Taxonomy.term_id']  = $category;
1232
+		}
1233
+
1234
+
1235
+		if (! EE_Registry::instance()->CAP->current_user_can('ee_read_others_venues', 'get_venues')) {
1236
+			$where['VNU_wp_user'] = get_current_user_id();
1237
+		} else {
1238
+			if (! EE_Registry::instance()->CAP->current_user_can('ee_read_private_venues', 'get_venues')) {
1239
+				$where['OR'] = [
1240
+					'status*restrict_private' => ['!=', 'private'],
1241
+					'AND'                     => [
1242
+						'status*inclusive' => ['=', 'private'],
1243
+						'VNU_wp_user'      => get_current_user_id(),
1244
+					],
1245
+				];
1246
+			}
1247
+		}
1248
+
1249
+		$search_term = $this->request->getRequestParam('s');
1250
+		if ($search_term) {
1251
+			$search_term = '%' . $search_term . '%';
1252
+			$where['OR'] = [
1253
+				'VNU_name'               => ['LIKE', $search_term],
1254
+				'VNU_desc'               => ['LIKE', $search_term],
1255
+				'VNU_short_desc'         => ['LIKE', $search_term],
1256
+				'VNU_address'            => ['LIKE', $search_term],
1257
+				'VNU_address2'           => ['LIKE', $search_term],
1258
+				'VNU_city'               => ['LIKE', $search_term],
1259
+				'VNU_zip'                => ['LIKE', $search_term],
1260
+				'VNU_phone'              => ['LIKE', $search_term],
1261
+				'VNU_url'                => ['LIKE', $search_term],
1262
+				'VNU_virtual_phone'      => ['LIKE', $search_term],
1263
+				'VNU_virtual_url'        => ['LIKE', $search_term],
1264
+				'VNU_google_map_link'    => ['LIKE', $search_term],
1265
+				'Event.EVT_name'         => ['LIKE', $search_term],
1266
+				'Event.EVT_desc'         => ['LIKE', $search_term],
1267
+				'Event.EVT_phone'        => ['LIKE', $search_term],
1268
+				'Event.EVT_external_URL' => ['LIKE', $search_term],
1269
+			];
1270
+		}
1271
+
1272
+
1273
+		return $count
1274
+			? $this->_venue_model->count([$where], 'VNU_ID')
1275
+			: $this->_venue_model->get_all(
1276
+				[$where, 'limit' => $limit, 'order_by' => $orderby, 'order' => $sort]
1277
+			);
1278
+	}
1279
+
1280
+
1281
+
1282
+
1283
+	/** Venue Category Stuff **/
1284
+
1285
+	/**
1286
+	 * set the _category property with the category object for the loaded page.
1287
+	 *
1288
+	 * @access private
1289
+	 * @return void
1290
+	 */
1291
+	private function _set_category_object()
1292
+	{
1293
+		if (isset($this->_category->id) && ! empty($this->_category->id)) {
1294
+			return;
1295
+		} // already have the category object so get out.
1296
+
1297
+		// set default category object
1298
+		$this->_set_empty_category_object();
1299
+
1300
+		// only set if we've got an id
1301
+		$category_ID = $this->request->getRequestParam('VEN_CAT_ID', 0, 'int');
1302
+		if (! $category_ID) {
1303
+			return;
1304
+		}
1305
+
1306
+		$term = get_term($category_ID, 'espresso_venue_categories');
1307
+
1308
+
1309
+		if (! empty($term)) {
1310
+			$this->_category->category_name       = $term->name;
1311
+			$this->_category->category_identifier = $term->slug;
1312
+			$this->_category->category_desc       = $term->description;
1313
+			$this->_category->id                  = $term->term_id;
1314
+			$this->_category->parent              = $term->parent;
1315
+		}
1316
+	}
1317
+
1318
+
1319
+	private function _set_empty_category_object()
1320
+	{
1321
+		$this->_category                = new stdClass();
1322
+		$this->_category->category_name = $this->_category->category_identifier = $this->_category->category_desc = '';
1323
+		$this->_category->id            = $this->_category->parent = 0;
1324
+	}
1325
+
1326
+
1327
+	/**
1328
+	 * @throws EE_Error
1329
+	 */
1330
+	protected function _category_list_table()
1331
+	{
1332
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
1333
+		$this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
1334
+			'add_category',
1335
+			'add_category',
1336
+			[],
1337
+			'add-new-h2'
1338
+		);
1339
+		$this->_search_btn_label = esc_html__('Venue Categories', 'event_espresso');
1340
+		$this->display_admin_list_table_page_with_sidebar();
1341
+	}
1342
+
1343
+
1344
+	/**
1345
+	 * @throws EE_Error
1346
+	 */
1347
+	protected function _category_details($view)
1348
+	{
1349
+
1350
+		// load formatter helper
1351
+		// load field generator helper
1352
+
1353
+		$route = $view == 'edit' ? 'update_category' : 'insert_category';
1354
+		$this->_set_add_edit_form_tags($route);
1355
+
1356
+		$this->_set_category_object();
1357
+		$id = ! empty($this->_category->id) ? $this->_category->id : '';
1358
+
1359
+		$delete_action = 'delete_category';
1360
+
1361
+		$redirect = EE_Admin_Page::add_query_args_and_nonce(['action' => 'category_list'], $this->_admin_base_url);
1362
+
1363
+		$this->_set_publish_post_box_vars('VEN_CAT_ID', $id, $delete_action, $redirect);
1364
+
1365
+		// take care of contents
1366
+		$this->_template_args['admin_page_content'] = $this->_category_details_content();
1367
+		$this->display_admin_page_with_sidebar();
1368
+	}
1369
+
1370
+
1371
+	protected function _category_details_content()
1372
+	{
1373
+		$editor_args['category_desc'] = [
1374
+			'type'          => 'wp_editor',
1375
+			'value'         => EEH_Formatter::admin_format_content($this->_category->category_desc),
1376
+			'class'         => 'my_editor_custom',
1377
+			'wpeditor_args' => ['media_buttons' => false],
1378
+		];
1379
+		$_wp_editor                   = $this->_generate_admin_form_fields($editor_args, 'array');
1380
+
1381
+		$all_terms = get_terms(
1382
+			['espresso_venue_categories'],
1383
+			['hide_empty' => 0, 'exclude' => [$this->_category->id]]
1384
+		);
1385
+
1386
+		// setup category select for term parents.
1387
+		$category_select_values[] = [
1388
+			'text' => esc_html__('No Parent', 'event_espresso'),
1389
+			'id'   => 0,
1390
+		];
1391
+		foreach ($all_terms as $term) {
1392
+			$category_select_values[] = [
1393
+				'text' => $term->name,
1394
+				'id'   => $term->term_id,
1395
+			];
1396
+		}
1397
+
1398
+		$category_select = EEH_Form_Fields::select_input(
1399
+			'category_parent',
1400
+			$category_select_values,
1401
+			$this->_category->parent
1402
+		);
1403
+		$template_args   = [
1404
+			'category'                 => $this->_category,
1405
+			'category_select'          => $category_select,
1406
+			'unique_id_info_help_link' => $this->_get_help_tab_link('unique_id_info'),
1407
+			'category_desc_editor'     => $_wp_editor['category_desc']['field'],
1408
+			'disable'                  => '',
1409
+			'disabled_message'         => false,
1410
+		];
1411
+		$template        = EVENTS_TEMPLATE_PATH . 'event_category_details.template.php';
1412
+		return EEH_Template::display_template($template, $template_args, true);
1413
+	}
1414
+
1415
+
1416
+	/**
1417
+	 * @throws EE_Error
1418
+	 */
1419
+	protected function _delete_categories()
1420
+	{
1421
+		$category_ID  = $this->request->getRequestParam('category_id', 0, 'int');
1422
+		$category_IDs = $this->request->getRequestParam('VEN_CAT_ID', [$category_ID], 'int', true);
1423
+
1424
+		foreach ($category_IDs as $cat_id) {
1425
+			$this->_delete_category($cat_id);
1426
+		}
1427
+
1428
+		// doesn't matter what page we're coming from... we're going to the same place after delete.
1429
+		$query_args = [
1430
+			'action' => 'category_list',
1431
+		];
1432
+		$this->_redirect_after_action(0, '', '', $query_args);
1433
+	}
1434
+
1435
+
1436
+	protected function _delete_category($cat_id)
1437
+	{
1438
+		$cat_id = absint($cat_id);
1439
+		wp_delete_term($cat_id, 'espresso_venue_categories');
1440
+	}
1441
+
1442
+
1443
+	/**
1444
+	 * @throws EE_Error
1445
+	 */
1446
+	protected function _insert_or_update_category($new_category)
1447
+	{
1448
+
1449
+		$cat_id  = $new_category ? $this->_insert_category() : $this->_insert_category(true);
1450
+		$success = 0; // we already have a success message so lets not send another.
1451
+		if ($cat_id) {
1452
+			$query_args = [
1453
+				'action'     => 'edit_category',
1454
+				'VEN_CAT_ID' => $cat_id,
1455
+			];
1456
+		} else {
1457
+			$query_args = ['action' => 'add_category'];
1458
+		}
1459
+		$this->_redirect_after_action($success, '', '', $query_args, true);
1460
+	}
1461
+
1462
+
1463
+	private function _insert_category($update = false)
1464
+	{
1465
+		$category_ID     = $update ? $this->request->getRequestParam('VEN_CAT_ID', '', 'int') : '';
1466
+		$category_name   = $this->request->getRequestParam('category_name', '');
1467
+		$category_desc   = $this->request->getRequestParam('category_desc', '', 'html');
1468
+		$category_parent = $this->request->getRequestParam('category_parent', 0, 'int');
1469
+
1470
+		if (empty($category_name)) {
1471
+			$msg = esc_html__('You must add a name for the category.', 'event_espresso');
1472
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
1473
+			return false;
1474
+		}
1475
+
1476
+
1477
+		$term_args = [
1478
+			'name'        => $category_name,
1479
+			'description' => $category_desc,
1480
+			'parent'      => $category_parent,
1481
+		];
1482
+
1483
+		$insert_ids = $update
1484
+			? wp_update_term($category_ID, 'espresso_venue_categories', $term_args)
1485
+			: wp_insert_term(
1486
+				$category_name,
1487
+				'espresso_venue_categories',
1488
+				$term_args
1489
+			);
1490
+
1491
+		if (! is_array($insert_ids)) {
1492
+			EE_Error::add_error(
1493
+				esc_html__('An error occurred and the category has not been saved to the database.', 'event_espresso'),
1494
+				__FILE__,
1495
+				__FUNCTION__,
1496
+				__LINE__
1497
+			);
1498
+		} else {
1499
+			$category_ID = $insert_ids['term_id'];
1500
+			EE_Error::add_success(
1501
+				sprintf(
1502
+					esc_html__('The category %s was successfully created', 'event_espresso'),
1503
+					$category_name
1504
+				)
1505
+			);
1506
+		}
1507
+
1508
+		return $category_ID;
1509
+	}
1510
+
1511
+
1512
+	/**
1513
+	 * TODO handle category exports()
1514
+	 *
1515
+	 * @return void
1516
+	 */
1517
+	protected function _categories_export()
1518
+	{
1519
+		// todo: I don't like doing this but it'll do until we modify EE_Export Class.
1520
+		$this->request->mergeRequestParams(
1521
+			[
1522
+				'export'       => 'report',
1523
+				'action'       => 'categories',
1524
+				'category_ids' => $this->request->getRequestParam('VEN_CAT_ID', 0, 'int'),
1525
+			]
1526
+		);
1527
+
1528
+		if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
1529
+			require_once(EE_CLASSES . 'EE_Export.class.php');
1530
+			$EE_Export = EE_Export::instance($this->request->requestParams());
1531
+			$EE_Export->export();
1532
+		}
1533
+	}
1534
+
1535
+
1536
+	protected function _import_categories()
1537
+	{
1538
+
1539
+		require_once(EE_CLASSES . 'EE_Import.class.php');
1540
+		EE_Import::instance()->import();
1541
+	}
1542
+
1543
+
1544
+	/**
1545
+	 * @throws EE_Error
1546
+	 */
1547
+	public function get_categories($per_page = 10, $current_page = 1, $count = false)
1548
+	{
1549
+
1550
+		// testing term stuff
1551
+		$orderby     = $this->request->getRequestParam('orderby', 'Term.term_id');
1552
+		$order       = $this->request->getRequestParam('order', 'DESC');
1553
+		$limit       = ($current_page - 1) * $per_page;
1554
+		$where       = ['taxonomy' => 'espresso_venue_categories'];
1555
+		$search_term = $this->request->getRequestParam('s');
1556
+		if ($search_term) {
1557
+			$search_term = '%' . $search_term . '%';
1558
+			$where['OR'] = [
1559
+				'Term.name'   => ['LIKE', $search_term],
1560
+				'description' => ['LIKE', $search_term],
1561
+			];
1562
+		}
1563
+
1564
+		$query_params = [
1565
+			$where,
1566
+			'order_by'   => [$orderby => $order],
1567
+			'limit'      => $limit . ',' . $per_page,
1568
+			'force_join' => ['Term'],
1569
+		];
1570
+
1571
+		return $count
1572
+			? EEM_Term_Taxonomy::instance()->count($query_params, 'term_id')
1573
+			: EEM_Term_Taxonomy::instance()->get_all($query_params);
1574
+	}
1575
+
1576
+
1577
+	/* end category stuff */
1578
+	/**************/
1579 1579
 }
Please login to merge, or discard this patch.
admin_pages/registrations/Registrations_Admin_Page.core.php 1 patch
Indentation   +3683 added lines, -3683 removed lines patch added patch discarded remove patch
@@ -19,2227 +19,2227 @@  discard block
 block discarded – undo
19 19
 class Registrations_Admin_Page extends EE_Admin_Page_CPT
20 20
 {
21 21
 
22
-    /**
23
-     * @var EE_Registration
24
-     */
25
-    private $_registration;
26
-
27
-    /**
28
-     * @var EE_Event
29
-     */
30
-    private $_reg_event;
31
-
32
-    /**
33
-     * @var EE_Session
34
-     */
35
-    private $_session;
36
-
37
-    /**
38
-     * @var array
39
-     */
40
-    private static $_reg_status;
41
-
42
-    /**
43
-     * Form for displaying the custom questions for this registration.
44
-     * This gets used a few times throughout the request so its best to cache it
45
-     *
46
-     * @var EE_Registration_Custom_Questions_Form
47
-     */
48
-    protected $_reg_custom_questions_form = null;
49
-
50
-    /**
51
-     * @var EEM_Registration $registration_model
52
-     */
53
-    private $registration_model;
54
-
55
-    /**
56
-     * @var EEM_Attendee $attendee_model
57
-     */
58
-    private $attendee_model;
59
-
60
-    /**
61
-     * @var EEM_Event $event_model
62
-     */
63
-    private $event_model;
64
-
65
-    /**
66
-     * @var EEM_Status $status_model
67
-     */
68
-    private $status_model;
69
-
70
-
71
-    /**
72
-     * @param bool $routing
73
-     * @throws EE_Error
74
-     * @throws InvalidArgumentException
75
-     * @throws InvalidDataTypeException
76
-     * @throws InvalidInterfaceException
77
-     * @throws ReflectionException
78
-     */
79
-    public function __construct($routing = true)
80
-    {
81
-        parent::__construct($routing);
82
-        add_action('wp_loaded', [$this, 'wp_loaded']);
83
-    }
84
-
85
-
86
-    /**
87
-     * @return EEM_Registration
88
-     * @throws InvalidArgumentException
89
-     * @throws InvalidDataTypeException
90
-     * @throws InvalidInterfaceException
91
-     * @since 4.10.2.p
92
-     */
93
-    protected function getRegistrationModel()
94
-    {
95
-        if (! $this->registration_model instanceof EEM_Registration) {
96
-            $this->registration_model = $this->getLoader()->getShared('EEM_Registration');
97
-        }
98
-        return $this->registration_model;
99
-    }
100
-
101
-
102
-    /**
103
-     * @return EEM_Attendee
104
-     * @throws InvalidArgumentException
105
-     * @throws InvalidDataTypeException
106
-     * @throws InvalidInterfaceException
107
-     * @since 4.10.2.p
108
-     */
109
-    protected function getAttendeeModel()
110
-    {
111
-        if (! $this->attendee_model instanceof EEM_Attendee) {
112
-            $this->attendee_model = $this->getLoader()->getShared('EEM_Attendee');
113
-        }
114
-        return $this->attendee_model;
115
-    }
116
-
117
-
118
-    /**
119
-     * @return EEM_Event
120
-     * @throws InvalidArgumentException
121
-     * @throws InvalidDataTypeException
122
-     * @throws InvalidInterfaceException
123
-     * @since 4.10.2.p
124
-     */
125
-    protected function getEventModel()
126
-    {
127
-        if (! $this->event_model instanceof EEM_Event) {
128
-            $this->event_model = $this->getLoader()->getShared('EEM_Event');
129
-        }
130
-        return $this->event_model;
131
-    }
132
-
133
-
134
-    /**
135
-     * @return EEM_Status
136
-     * @throws InvalidArgumentException
137
-     * @throws InvalidDataTypeException
138
-     * @throws InvalidInterfaceException
139
-     * @since 4.10.2.p
140
-     */
141
-    protected function getStatusModel()
142
-    {
143
-        if (! $this->status_model instanceof EEM_Status) {
144
-            $this->status_model = $this->getLoader()->getShared('EEM_Status');
145
-        }
146
-        return $this->status_model;
147
-    }
148
-
149
-
150
-    public function wp_loaded()
151
-    {
152
-        // when adding a new registration...
153
-        $action = $this->request->getRequestParam('action');
154
-        if ($action === 'new_registration') {
155
-            EE_System::do_not_cache();
156
-            if ($this->request->getRequestParam('processing_registration', 0, 'int') !== 1) {
157
-                // and it's NOT the attendee information reg step
158
-                // force cookie expiration by setting time to last week
159
-                setcookie('ee_registration_added', 0, time() - WEEK_IN_SECONDS, '/');
160
-                // and update the global
161
-                $_COOKIE['ee_registration_added'] = 0;
162
-            }
163
-        }
164
-    }
165
-
166
-
167
-    protected function _init_page_props()
168
-    {
169
-        $this->page_slug        = REG_PG_SLUG;
170
-        $this->_admin_base_url  = REG_ADMIN_URL;
171
-        $this->_admin_base_path = REG_ADMIN;
172
-        $this->page_label       = esc_html__('Registrations', 'event_espresso');
173
-        $this->_cpt_routes      = [
174
-            'add_new_attendee' => 'espresso_attendees',
175
-            'edit_attendee'    => 'espresso_attendees',
176
-            'insert_attendee'  => 'espresso_attendees',
177
-            'update_attendee'  => 'espresso_attendees',
178
-        ];
179
-        $this->_cpt_model_names = [
180
-            'add_new_attendee' => 'EEM_Attendee',
181
-            'edit_attendee'    => 'EEM_Attendee',
182
-        ];
183
-        $this->_cpt_edit_routes = [
184
-            'espresso_attendees' => 'edit_attendee',
185
-        ];
186
-        $this->_pagenow_map     = [
187
-            'add_new_attendee' => 'post-new.php',
188
-            'edit_attendee'    => 'post.php',
189
-            'trash'            => 'post.php',
190
-        ];
191
-        add_action('edit_form_after_title', [$this, 'after_title_form_fields'], 10);
192
-        // add filters so that the comment urls don't take users to a confusing 404 page
193
-        add_filter('get_comment_link', [$this, 'clear_comment_link'], 10, 2);
194
-    }
195
-
196
-
197
-    /**
198
-     * @param string     $link    The comment permalink with '#comment-$id' appended.
199
-     * @param WP_Comment $comment The current comment object.
200
-     * @return string
201
-     */
202
-    public function clear_comment_link($link, WP_Comment $comment)
203
-    {
204
-        // gotta make sure this only happens on this route
205
-        $post_type = get_post_type($comment->comment_post_ID);
206
-        if ($post_type === 'espresso_attendees') {
207
-            return '#commentsdiv';
208
-        }
209
-        return $link;
210
-    }
211
-
212
-
213
-    protected function _ajax_hooks()
214
-    {
215
-        // todo: all hooks for registrations ajax goes in here
216
-        add_action('wp_ajax_toggle_checkin_status', [$this, 'toggle_checkin_status']);
217
-    }
218
-
219
-
220
-    protected function _define_page_props()
221
-    {
222
-        $this->_admin_page_title = $this->page_label;
223
-        $this->_labels           = [
224
-            'buttons'                      => [
225
-                'add-registrant'      => esc_html__('Add New Registration', 'event_espresso'),
226
-                'add-attendee'        => esc_html__('Add Contact', 'event_espresso'),
227
-                'edit'                => esc_html__('Edit Contact', 'event_espresso'),
228
-                'report'              => esc_html__('Event Registrations CSV Report', 'event_espresso'),
229
-                'report_all'          => esc_html__('All Registrations CSV Report', 'event_espresso'),
230
-                'report_filtered'     => esc_html__('Filtered CSV Report', 'event_espresso'),
231
-                'contact_list_report' => esc_html__('Contact List Report', 'event_espresso'),
232
-                'contact_list_export' => esc_html__('Export Data', 'event_espresso'),
233
-            ],
234
-            'publishbox'                   => [
235
-                'add_new_attendee' => esc_html__('Add Contact Record', 'event_espresso'),
236
-                'edit_attendee'    => esc_html__('Update Contact Record', 'event_espresso'),
237
-            ],
238
-            'hide_add_button_on_cpt_route' => [
239
-                'edit_attendee' => true,
240
-            ],
241
-        ];
242
-    }
243
-
244
-
245
-    /**
246
-     * grab url requests and route them
247
-     *
248
-     * @return void
249
-     * @throws EE_Error
250
-     */
251
-    public function _set_page_routes()
252
-    {
253
-        $this->_get_registration_status_array();
254
-        $REG_ID             = $this->request->getRequestParam('_REG_ID', 0, 'int');
255
-        $REG_ID             = $this->request->getRequestParam('reg_status_change_form[REG_ID]', $REG_ID, 'int');
256
-        $ATT_ID             = $this->request->getRequestParam('ATT_ID', 0, 'int');
257
-        $ATT_ID             = $this->request->getRequestParam('post', $ATT_ID, 'int');
258
-        $this->_page_routes = [
259
-            'default'                             => [
260
-                'func'       => '_registrations_overview_list_table',
261
-                'capability' => 'ee_read_registrations',
262
-            ],
263
-            'view_registration'                   => [
264
-                'func'       => '_registration_details',
265
-                'capability' => 'ee_read_registration',
266
-                'obj_id'     => $REG_ID,
267
-            ],
268
-            'edit_registration'                   => [
269
-                'func'               => '_update_attendee_registration_form',
270
-                'noheader'           => true,
271
-                'headers_sent_route' => 'view_registration',
272
-                'capability'         => 'ee_edit_registration',
273
-                'obj_id'             => $REG_ID,
274
-                '_REG_ID'            => $REG_ID,
275
-            ],
276
-            'trash_registrations'                 => [
277
-                'func'       => '_trash_or_restore_registrations',
278
-                'args'       => ['trash' => true],
279
-                'noheader'   => true,
280
-                'capability' => 'ee_delete_registrations',
281
-            ],
282
-            'restore_registrations'               => [
283
-                'func'       => '_trash_or_restore_registrations',
284
-                'args'       => ['trash' => false],
285
-                'noheader'   => true,
286
-                'capability' => 'ee_delete_registrations',
287
-            ],
288
-            'delete_registrations'                => [
289
-                'func'       => '_delete_registrations',
290
-                'noheader'   => true,
291
-                'capability' => 'ee_delete_registrations',
292
-            ],
293
-            'new_registration'                    => [
294
-                'func'       => 'new_registration',
295
-                'capability' => 'ee_edit_registrations',
296
-            ],
297
-            'process_reg_step'                    => [
298
-                'func'       => 'process_reg_step',
299
-                'noheader'   => true,
300
-                'capability' => 'ee_edit_registrations',
301
-            ],
302
-            'redirect_to_txn'                     => [
303
-                'func'       => 'redirect_to_txn',
304
-                'noheader'   => true,
305
-                'capability' => 'ee_edit_registrations',
306
-            ],
307
-            'change_reg_status'                   => [
308
-                'func'       => '_change_reg_status',
309
-                'noheader'   => true,
310
-                'capability' => 'ee_edit_registration',
311
-                'obj_id'     => $REG_ID,
312
-            ],
313
-            'approve_registration'                => [
314
-                'func'       => 'approve_registration',
315
-                'noheader'   => true,
316
-                'capability' => 'ee_edit_registration',
317
-                'obj_id'     => $REG_ID,
318
-            ],
319
-            'approve_and_notify_registration'     => [
320
-                'func'       => 'approve_registration',
321
-                'noheader'   => true,
322
-                'args'       => [true],
323
-                'capability' => 'ee_edit_registration',
324
-                'obj_id'     => $REG_ID,
325
-            ],
326
-            'approve_registrations'               => [
327
-                'func'       => 'bulk_action_on_registrations',
328
-                'noheader'   => true,
329
-                'capability' => 'ee_edit_registrations',
330
-                'args'       => ['approve'],
331
-            ],
332
-            'approve_and_notify_registrations'    => [
333
-                'func'       => 'bulk_action_on_registrations',
334
-                'noheader'   => true,
335
-                'capability' => 'ee_edit_registrations',
336
-                'args'       => ['approve', true],
337
-            ],
338
-            'decline_registration'                => [
339
-                'func'       => 'decline_registration',
340
-                'noheader'   => true,
341
-                'capability' => 'ee_edit_registration',
342
-                'obj_id'     => $REG_ID,
343
-            ],
344
-            'decline_and_notify_registration'     => [
345
-                'func'       => 'decline_registration',
346
-                'noheader'   => true,
347
-                'args'       => [true],
348
-                'capability' => 'ee_edit_registration',
349
-                'obj_id'     => $REG_ID,
350
-            ],
351
-            'decline_registrations'               => [
352
-                'func'       => 'bulk_action_on_registrations',
353
-                'noheader'   => true,
354
-                'capability' => 'ee_edit_registrations',
355
-                'args'       => ['decline'],
356
-            ],
357
-            'decline_and_notify_registrations'    => [
358
-                'func'       => 'bulk_action_on_registrations',
359
-                'noheader'   => true,
360
-                'capability' => 'ee_edit_registrations',
361
-                'args'       => ['decline', true],
362
-            ],
363
-            'pending_registration'                => [
364
-                'func'       => 'pending_registration',
365
-                'noheader'   => true,
366
-                'capability' => 'ee_edit_registration',
367
-                'obj_id'     => $REG_ID,
368
-            ],
369
-            'pending_and_notify_registration'     => [
370
-                'func'       => 'pending_registration',
371
-                'noheader'   => true,
372
-                'args'       => [true],
373
-                'capability' => 'ee_edit_registration',
374
-                'obj_id'     => $REG_ID,
375
-            ],
376
-            'pending_registrations'               => [
377
-                'func'       => 'bulk_action_on_registrations',
378
-                'noheader'   => true,
379
-                'capability' => 'ee_edit_registrations',
380
-                'args'       => ['pending'],
381
-            ],
382
-            'pending_and_notify_registrations'    => [
383
-                'func'       => 'bulk_action_on_registrations',
384
-                'noheader'   => true,
385
-                'capability' => 'ee_edit_registrations',
386
-                'args'       => ['pending', true],
387
-            ],
388
-            'no_approve_registration'             => [
389
-                'func'       => 'not_approve_registration',
390
-                'noheader'   => true,
391
-                'capability' => 'ee_edit_registration',
392
-                'obj_id'     => $REG_ID,
393
-            ],
394
-            'no_approve_and_notify_registration'  => [
395
-                'func'       => 'not_approve_registration',
396
-                'noheader'   => true,
397
-                'args'       => [true],
398
-                'capability' => 'ee_edit_registration',
399
-                'obj_id'     => $REG_ID,
400
-            ],
401
-            'no_approve_registrations'            => [
402
-                'func'       => 'bulk_action_on_registrations',
403
-                'noheader'   => true,
404
-                'capability' => 'ee_edit_registrations',
405
-                'args'       => ['not_approve'],
406
-            ],
407
-            'no_approve_and_notify_registrations' => [
408
-                'func'       => 'bulk_action_on_registrations',
409
-                'noheader'   => true,
410
-                'capability' => 'ee_edit_registrations',
411
-                'args'       => ['not_approve', true],
412
-            ],
413
-            'cancel_registration'                 => [
414
-                'func'       => 'cancel_registration',
415
-                'noheader'   => true,
416
-                'capability' => 'ee_edit_registration',
417
-                'obj_id'     => $REG_ID,
418
-            ],
419
-            'cancel_and_notify_registration'      => [
420
-                'func'       => 'cancel_registration',
421
-                'noheader'   => true,
422
-                'args'       => [true],
423
-                'capability' => 'ee_edit_registration',
424
-                'obj_id'     => $REG_ID,
425
-            ],
426
-            'cancel_registrations'                => [
427
-                'func'       => 'bulk_action_on_registrations',
428
-                'noheader'   => true,
429
-                'capability' => 'ee_edit_registrations',
430
-                'args'       => ['cancel'],
431
-            ],
432
-            'cancel_and_notify_registrations'     => [
433
-                'func'       => 'bulk_action_on_registrations',
434
-                'noheader'   => true,
435
-                'capability' => 'ee_edit_registrations',
436
-                'args'       => ['cancel', true],
437
-            ],
438
-            'wait_list_registration'              => [
439
-                'func'       => 'wait_list_registration',
440
-                'noheader'   => true,
441
-                'capability' => 'ee_edit_registration',
442
-                'obj_id'     => $REG_ID,
443
-            ],
444
-            'wait_list_and_notify_registration'   => [
445
-                'func'       => 'wait_list_registration',
446
-                'noheader'   => true,
447
-                'args'       => [true],
448
-                'capability' => 'ee_edit_registration',
449
-                'obj_id'     => $REG_ID,
450
-            ],
451
-            'contact_list'                        => [
452
-                'func'       => '_attendee_contact_list_table',
453
-                'capability' => 'ee_read_contacts',
454
-            ],
455
-            'add_new_attendee'                    => [
456
-                'func' => '_create_new_cpt_item',
457
-                'args' => [
458
-                    'new_attendee' => true,
459
-                    'capability'   => 'ee_edit_contacts',
460
-                ],
461
-            ],
462
-            'edit_attendee'                       => [
463
-                'func'       => '_edit_cpt_item',
464
-                'capability' => 'ee_edit_contacts',
465
-                'obj_id'     => $ATT_ID,
466
-            ],
467
-            'duplicate_attendee'                  => [
468
-                'func'       => '_duplicate_attendee',
469
-                'noheader'   => true,
470
-                'capability' => 'ee_edit_contacts',
471
-                'obj_id'     => $ATT_ID,
472
-            ],
473
-            'insert_attendee'                     => [
474
-                'func'       => '_insert_or_update_attendee',
475
-                'args'       => [
476
-                    'new_attendee' => true,
477
-                ],
478
-                'noheader'   => true,
479
-                'capability' => 'ee_edit_contacts',
480
-            ],
481
-            'update_attendee'                     => [
482
-                'func'       => '_insert_or_update_attendee',
483
-                'args'       => [
484
-                    'new_attendee' => false,
485
-                ],
486
-                'noheader'   => true,
487
-                'capability' => 'ee_edit_contacts',
488
-                'obj_id'     => $ATT_ID,
489
-            ],
490
-            'trash_attendees'                     => [
491
-                'func'       => '_trash_or_restore_attendees',
492
-                'args'       => [
493
-                    'trash' => 'true',
494
-                ],
495
-                'noheader'   => true,
496
-                'capability' => 'ee_delete_contacts',
497
-            ],
498
-            'trash_attendee'                      => [
499
-                'func'       => '_trash_or_restore_attendees',
500
-                'args'       => [
501
-                    'trash' => true,
502
-                ],
503
-                'noheader'   => true,
504
-                'capability' => 'ee_delete_contacts',
505
-                'obj_id'     => $ATT_ID,
506
-            ],
507
-            'restore_attendees'                   => [
508
-                'func'       => '_trash_or_restore_attendees',
509
-                'args'       => [
510
-                    'trash' => false,
511
-                ],
512
-                'noheader'   => true,
513
-                'capability' => 'ee_delete_contacts',
514
-                'obj_id'     => $ATT_ID,
515
-            ],
516
-            'resend_registration'                 => [
517
-                'func'       => '_resend_registration',
518
-                'noheader'   => true,
519
-                'capability' => 'ee_send_message',
520
-            ],
521
-            'registrations_report'                => [
522
-                'func'       => '_registrations_report',
523
-                'noheader'   => true,
524
-                'capability' => 'ee_read_registrations',
525
-            ],
526
-            'contact_list_export'                 => [
527
-                'func'       => '_contact_list_export',
528
-                'noheader'   => true,
529
-                'capability' => 'export',
530
-            ],
531
-            'contact_list_report'                 => [
532
-                'func'       => '_contact_list_report',
533
-                'noheader'   => true,
534
-                'capability' => 'ee_read_contacts',
535
-            ],
536
-        ];
537
-    }
538
-
539
-
540
-    protected function _set_page_config()
541
-    {
542
-        $REG_ID             = $this->request->getRequestParam('_REG_ID', 0, 'int');
543
-        $ATT_ID             = $this->request->getRequestParam('ATT_ID', 0, 'int');
544
-        $this->_page_config = [
545
-            'default'           => [
546
-                'nav'           => [
547
-                    'label' => esc_html__('Overview', 'event_espresso'),
548
-                    'order' => 5,
549
-                ],
550
-                'help_tabs'     => [
551
-                    'registrations_overview_help_tab'                       => [
552
-                        'title'    => esc_html__('Registrations Overview', 'event_espresso'),
553
-                        'filename' => 'registrations_overview',
554
-                    ],
555
-                    'registrations_overview_table_column_headings_help_tab' => [
556
-                        'title'    => esc_html__('Registrations Table Column Headings', 'event_espresso'),
557
-                        'filename' => 'registrations_overview_table_column_headings',
558
-                    ],
559
-                    'registrations_overview_filters_help_tab'               => [
560
-                        'title'    => esc_html__('Registration Filters', 'event_espresso'),
561
-                        'filename' => 'registrations_overview_filters',
562
-                    ],
563
-                    'registrations_overview_views_help_tab'                 => [
564
-                        'title'    => esc_html__('Registration Views', 'event_espresso'),
565
-                        'filename' => 'registrations_overview_views',
566
-                    ],
567
-                    'registrations_regoverview_other_help_tab'              => [
568
-                        'title'    => esc_html__('Registrations Other', 'event_espresso'),
569
-                        'filename' => 'registrations_overview_other',
570
-                    ],
571
-                ],
572
-                'qtips'         => ['Registration_List_Table_Tips'],
573
-                'list_table'    => 'EE_Registrations_List_Table',
574
-                'require_nonce' => false,
575
-            ],
576
-            'view_registration' => [
577
-                'nav'           => [
578
-                    'label'      => esc_html__('REG Details', 'event_espresso'),
579
-                    'order'      => 15,
580
-                    'url'        => $REG_ID
581
-                        ? add_query_arg(['_REG_ID' => $REG_ID], $this->_current_page_view_url)
582
-                        : $this->_admin_base_url,
583
-                    'persistent' => false,
584
-                ],
585
-                'help_tabs'     => [
586
-                    'registrations_details_help_tab'                    => [
587
-                        'title'    => esc_html__('Registration Details', 'event_espresso'),
588
-                        'filename' => 'registrations_details',
589
-                    ],
590
-                    'registrations_details_table_help_tab'              => [
591
-                        'title'    => esc_html__('Registration Details Table', 'event_espresso'),
592
-                        'filename' => 'registrations_details_table',
593
-                    ],
594
-                    'registrations_details_form_answers_help_tab'       => [
595
-                        'title'    => esc_html__('Registration Form Answers', 'event_espresso'),
596
-                        'filename' => 'registrations_details_form_answers',
597
-                    ],
598
-                    'registrations_details_registrant_details_help_tab' => [
599
-                        'title'    => esc_html__('Contact Details', 'event_espresso'),
600
-                        'filename' => 'registrations_details_registrant_details',
601
-                    ],
602
-                ],
603
-                'metaboxes'     => array_merge(
604
-                    $this->_default_espresso_metaboxes,
605
-                    ['_registration_details_metaboxes']
606
-                ),
607
-                'require_nonce' => false,
608
-            ],
609
-            'new_registration'  => [
610
-                'nav'           => [
611
-                    'label'      => esc_html__('Add New Registration', 'event_espresso'),
612
-                    'url'        => '#',
613
-                    'order'      => 15,
614
-                    'persistent' => false,
615
-                ],
616
-                'metaboxes'     => $this->_default_espresso_metaboxes,
617
-                'labels'        => [
618
-                    'publishbox' => esc_html__('Save Registration', 'event_espresso'),
619
-                ],
620
-                'require_nonce' => false,
621
-            ],
622
-            'add_new_attendee'  => [
623
-                'nav'           => [
624
-                    'label'      => esc_html__('Add Contact', 'event_espresso'),
625
-                    'order'      => 15,
626
-                    'persistent' => false,
627
-                ],
628
-                'metaboxes'     => array_merge(
629
-                    $this->_default_espresso_metaboxes,
630
-                    ['_publish_post_box', 'attendee_editor_metaboxes']
631
-                ),
632
-                'require_nonce' => false,
633
-            ],
634
-            'edit_attendee'     => [
635
-                'nav'           => [
636
-                    'label'      => esc_html__('Edit Contact', 'event_espresso'),
637
-                    'order'      => 15,
638
-                    'persistent' => false,
639
-                    'url'        => $ATT_ID
640
-                        ? add_query_arg(['ATT_ID' => $ATT_ID], $this->_current_page_view_url)
641
-                        : $this->_admin_base_url,
642
-                ],
643
-                'metaboxes'     => ['attendee_editor_metaboxes'],
644
-                'require_nonce' => false,
645
-            ],
646
-            'contact_list'      => [
647
-                'nav'           => [
648
-                    'label' => esc_html__('Contact List', 'event_espresso'),
649
-                    'order' => 20,
650
-                ],
651
-                'list_table'    => 'EE_Attendee_Contact_List_Table',
652
-                'help_tabs'     => [
653
-                    'registrations_contact_list_help_tab'                       => [
654
-                        'title'    => esc_html__('Registrations Contact List', 'event_espresso'),
655
-                        'filename' => 'registrations_contact_list',
656
-                    ],
657
-                    'registrations_contact-list_table_column_headings_help_tab' => [
658
-                        'title'    => esc_html__('Contact List Table Column Headings', 'event_espresso'),
659
-                        'filename' => 'registrations_contact_list_table_column_headings',
660
-                    ],
661
-                    'registrations_contact_list_views_help_tab'                 => [
662
-                        'title'    => esc_html__('Contact List Views', 'event_espresso'),
663
-                        'filename' => 'registrations_contact_list_views',
664
-                    ],
665
-                    'registrations_contact_list_other_help_tab'                 => [
666
-                        'title'    => esc_html__('Contact List Other', 'event_espresso'),
667
-                        'filename' => 'registrations_contact_list_other',
668
-                    ],
669
-                ],
670
-                'metaboxes'     => [],
671
-                'require_nonce' => false,
672
-            ],
673
-            // override default cpt routes
674
-            'create_new'        => '',
675
-            'edit'              => '',
676
-        ];
677
-    }
678
-
679
-
680
-    /**
681
-     * The below methods aren't used by this class currently
682
-     */
683
-    protected function _add_screen_options()
684
-    {
685
-    }
686
-
687
-
688
-    protected function _add_feature_pointers()
689
-    {
690
-    }
691
-
692
-
693
-    public function admin_init()
694
-    {
695
-        EE_Registry::$i18n_js_strings['update_att_qstns'] = esc_html__(
696
-            'click "Update Registration Questions" to save your changes',
697
-            'event_espresso'
698
-        );
699
-    }
700
-
701
-
702
-    public function admin_notices()
703
-    {
704
-    }
705
-
706
-
707
-    public function admin_footer_scripts()
708
-    {
709
-    }
710
-
711
-
712
-    /**
713
-     * get list of registration statuses
714
-     *
715
-     * @return void
716
-     * @throws EE_Error
717
-     */
718
-    private function _get_registration_status_array()
719
-    {
720
-        self::$_reg_status = EEM_Registration::reg_status_array([], true);
721
-    }
722
-
723
-
724
-    /**
725
-     * @throws InvalidArgumentException
726
-     * @throws InvalidDataTypeException
727
-     * @throws InvalidInterfaceException
728
-     * @since 4.10.2.p
729
-     */
730
-    protected function _add_screen_options_default()
731
-    {
732
-        $this->_per_page_screen_option();
733
-    }
734
-
735
-
736
-    /**
737
-     * @throws InvalidArgumentException
738
-     * @throws InvalidDataTypeException
739
-     * @throws InvalidInterfaceException
740
-     * @since 4.10.2.p
741
-     */
742
-    protected function _add_screen_options_contact_list()
743
-    {
744
-        $page_title              = $this->_admin_page_title;
745
-        $this->_admin_page_title = esc_html__('Contacts', 'event_espresso');
746
-        $this->_per_page_screen_option();
747
-        $this->_admin_page_title = $page_title;
748
-    }
749
-
750
-
751
-    public function load_scripts_styles()
752
-    {
753
-        // style
754
-        wp_register_style(
755
-            'espresso_reg',
756
-            REG_ASSETS_URL . 'espresso_registrations_admin.css',
757
-            ['ee-admin-css'],
758
-            EVENT_ESPRESSO_VERSION
759
-        );
760
-        wp_enqueue_style('espresso_reg');
761
-        // script
762
-        wp_register_script(
763
-            'espresso_reg',
764
-            REG_ASSETS_URL . 'espresso_registrations_admin.js',
765
-            ['jquery-ui-datepicker', 'jquery-ui-draggable', 'ee_admin_js'],
766
-            EVENT_ESPRESSO_VERSION,
767
-            true
768
-        );
769
-        wp_enqueue_script('espresso_reg');
770
-    }
771
-
772
-
773
-    /**
774
-     * @throws EE_Error
775
-     * @throws InvalidArgumentException
776
-     * @throws InvalidDataTypeException
777
-     * @throws InvalidInterfaceException
778
-     * @throws ReflectionException
779
-     * @since 4.10.2.p
780
-     */
781
-    public function load_scripts_styles_edit_attendee()
782
-    {
783
-        // stuff to only show up on our attendee edit details page.
784
-        $attendee_details_translations = [
785
-            'att_publish_text' => sprintf(
786
-            /* translators: The date and time */
787
-                wp_strip_all_tags(__('Created on: %s', 'event_espresso')),
788
-                '<b>' . $this->_cpt_model_obj->get_datetime('ATT_created') . '</b>'
789
-            ),
790
-        ];
791
-        wp_localize_script('espresso_reg', 'ATTENDEE_DETAILS', $attendee_details_translations);
792
-        wp_enqueue_script('jquery-validate');
793
-    }
794
-
795
-
796
-    /**
797
-     * @throws EE_Error
798
-     * @throws InvalidArgumentException
799
-     * @throws InvalidDataTypeException
800
-     * @throws InvalidInterfaceException
801
-     * @throws ReflectionException
802
-     * @since 4.10.2.p
803
-     */
804
-    public function load_scripts_styles_view_registration()
805
-    {
806
-        // styles
807
-        wp_enqueue_style('espresso-ui-theme');
808
-        // scripts
809
-        $this->_get_reg_custom_questions_form($this->_registration->ID());
810
-        $this->_reg_custom_questions_form->wp_enqueue_scripts();
811
-    }
812
-
813
-
814
-    public function load_scripts_styles_contact_list()
815
-    {
816
-        wp_dequeue_style('espresso_reg');
817
-        wp_register_style(
818
-            'espresso_att',
819
-            REG_ASSETS_URL . 'espresso_attendees_admin.css',
820
-            ['ee-admin-css'],
821
-            EVENT_ESPRESSO_VERSION
822
-        );
823
-        wp_enqueue_style('espresso_att');
824
-    }
825
-
826
-
827
-    public function load_scripts_styles_new_registration()
828
-    {
829
-        wp_register_script(
830
-            'ee-spco-for-admin',
831
-            REG_ASSETS_URL . 'spco_for_admin.js',
832
-            ['underscore', 'jquery'],
833
-            EVENT_ESPRESSO_VERSION,
834
-            true
835
-        );
836
-        wp_enqueue_script('ee-spco-for-admin');
837
-        add_filter('FHEE__EED_Ticket_Selector__load_tckt_slctr_assets', '__return_true');
838
-        EE_Form_Section_Proper::wp_enqueue_scripts();
839
-        EED_Ticket_Selector::load_tckt_slctr_assets();
840
-        EE_Datepicker_Input::enqueue_styles_and_scripts();
841
-    }
842
-
843
-
844
-    public function AHEE__EE_Admin_Page__route_admin_request_resend_registration()
845
-    {
846
-        add_filter('FHEE_load_EE_messages', '__return_true');
847
-    }
848
-
849
-
850
-    public function AHEE__EE_Admin_Page__route_admin_request_approve_registration()
851
-    {
852
-        add_filter('FHEE_load_EE_messages', '__return_true');
853
-    }
854
-
855
-
856
-    /**
857
-     * @throws EE_Error
858
-     * @throws InvalidArgumentException
859
-     * @throws InvalidDataTypeException
860
-     * @throws InvalidInterfaceException
861
-     * @throws ReflectionException
862
-     * @since 4.10.2.p
863
-     */
864
-    protected function _set_list_table_views_default()
865
-    {
866
-        // for notification related bulk actions we need to make sure only active messengers have an option.
867
-        EED_Messages::set_autoloaders();
868
-        /** @type EE_Message_Resource_Manager $message_resource_manager */
869
-        $message_resource_manager = EE_Registry::instance()->load_lib('Message_Resource_Manager');
870
-        $active_mts               = $message_resource_manager->list_of_active_message_types();
871
-        // key= bulk_action_slug, value= message type.
872
-        $match_array = [
873
-            'approve_registrations'    => 'registration',
874
-            'decline_registrations'    => 'declined_registration',
875
-            'pending_registrations'    => 'pending_approval',
876
-            'no_approve_registrations' => 'not_approved_registration',
877
-            'cancel_registrations'     => 'cancelled_registration',
878
-        ];
879
-        $can_send    = EE_Registry::instance()->CAP->current_user_can(
880
-            'ee_send_message',
881
-            'batch_send_messages'
882
-        );
883
-        /** setup reg status bulk actions **/
884
-        $def_reg_status_actions['approve_registrations'] = esc_html__('Approve Registrations', 'event_espresso');
885
-        if ($can_send && in_array($match_array['approve_registrations'], $active_mts, true)) {
886
-            $def_reg_status_actions['approve_and_notify_registrations'] = esc_html__(
887
-                'Approve and Notify Registrations',
888
-                'event_espresso'
889
-            );
890
-        }
891
-        $def_reg_status_actions['decline_registrations'] = esc_html__('Decline Registrations', 'event_espresso');
892
-        if ($can_send && in_array($match_array['decline_registrations'], $active_mts, true)) {
893
-            $def_reg_status_actions['decline_and_notify_registrations'] = esc_html__(
894
-                'Decline and Notify Registrations',
895
-                'event_espresso'
896
-            );
897
-        }
898
-        $def_reg_status_actions['pending_registrations'] = esc_html__(
899
-            'Set Registrations to Pending Payment',
900
-            'event_espresso'
901
-        );
902
-        if ($can_send && in_array($match_array['pending_registrations'], $active_mts, true)) {
903
-            $def_reg_status_actions['pending_and_notify_registrations'] = esc_html__(
904
-                'Set Registrations to Pending Payment and Notify',
905
-                'event_espresso'
906
-            );
907
-        }
908
-        $def_reg_status_actions['no_approve_registrations'] = esc_html__(
909
-            'Set Registrations to Not Approved',
910
-            'event_espresso'
911
-        );
912
-        if ($can_send && in_array($match_array['no_approve_registrations'], $active_mts, true)) {
913
-            $def_reg_status_actions['no_approve_and_notify_registrations'] = esc_html__(
914
-                'Set Registrations to Not Approved and Notify',
915
-                'event_espresso'
916
-            );
917
-        }
918
-        $def_reg_status_actions['cancel_registrations'] = esc_html__('Cancel Registrations', 'event_espresso');
919
-        if ($can_send && in_array($match_array['cancel_registrations'], $active_mts, true)) {
920
-            $def_reg_status_actions['cancel_and_notify_registrations'] = esc_html__(
921
-                'Cancel Registrations and Notify',
922
-                'event_espresso'
923
-            );
924
-        }
925
-        $def_reg_status_actions = apply_filters(
926
-            'FHEE__Registrations_Admin_Page___set_list_table_views_default__def_reg_status_actions_array',
927
-            $def_reg_status_actions,
928
-            $active_mts,
929
-            $can_send
930
-        );
931
-
932
-        $this->_views = [
933
-            'all'   => [
934
-                'slug'        => 'all',
935
-                'label'       => esc_html__('View All Registrations', 'event_espresso'),
936
-                'count'       => 0,
937
-                'bulk_action' => array_merge(
938
-                    $def_reg_status_actions,
939
-                    [
940
-                        'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
941
-                    ]
942
-                ),
943
-            ],
944
-            'month' => [
945
-                'slug'        => 'month',
946
-                'label'       => esc_html__('This Month', 'event_espresso'),
947
-                'count'       => 0,
948
-                'bulk_action' => array_merge(
949
-                    $def_reg_status_actions,
950
-                    [
951
-                        'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
952
-                    ]
953
-                ),
954
-            ],
955
-            'today' => [
956
-                'slug'        => 'today',
957
-                'label'       => sprintf(
958
-                    esc_html__('Today - %s', 'event_espresso'),
959
-                    date('M d, Y', current_time('timestamp'))
960
-                ),
961
-                'count'       => 0,
962
-                'bulk_action' => array_merge(
963
-                    $def_reg_status_actions,
964
-                    [
965
-                        'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
966
-                    ]
967
-                ),
968
-            ],
969
-        ];
970
-        if (
971
-            EE_Registry::instance()->CAP->current_user_can(
972
-                'ee_delete_registrations',
973
-                'espresso_registrations_delete_registration'
974
-            )
975
-        ) {
976
-            $this->_views['incomplete'] = [
977
-                'slug'        => 'incomplete',
978
-                'label'       => esc_html__('Incomplete', 'event_espresso'),
979
-                'count'       => 0,
980
-                'bulk_action' => [
981
-                    'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
982
-                ],
983
-            ];
984
-            $this->_views['trash']      = [
985
-                'slug'        => 'trash',
986
-                'label'       => esc_html__('Trash', 'event_espresso'),
987
-                'count'       => 0,
988
-                'bulk_action' => [
989
-                    'restore_registrations' => esc_html__('Restore Registrations', 'event_espresso'),
990
-                    'delete_registrations'  => esc_html__('Delete Registrations Permanently', 'event_espresso'),
991
-                ],
992
-            ];
993
-        }
994
-    }
995
-
996
-
997
-    protected function _set_list_table_views_contact_list()
998
-    {
999
-        $this->_views = [
1000
-            'in_use' => [
1001
-                'slug'        => 'in_use',
1002
-                'label'       => esc_html__('In Use', 'event_espresso'),
1003
-                'count'       => 0,
1004
-                'bulk_action' => [
1005
-                    'trash_attendees' => esc_html__('Move to Trash', 'event_espresso'),
1006
-                ],
1007
-            ],
1008
-        ];
1009
-        if (
1010
-            EE_Registry::instance()->CAP->current_user_can(
1011
-                'ee_delete_contacts',
1012
-                'espresso_registrations_trash_attendees'
1013
-            )
1014
-        ) {
1015
-            $this->_views['trash'] = [
1016
-                'slug'        => 'trash',
1017
-                'label'       => esc_html__('Trash', 'event_espresso'),
1018
-                'count'       => 0,
1019
-                'bulk_action' => [
1020
-                    'restore_attendees' => esc_html__('Restore from Trash', 'event_espresso'),
1021
-                ],
1022
-            ];
1023
-        }
1024
-    }
1025
-
1026
-
1027
-    /**
1028
-     * @return array
1029
-     * @throws EE_Error
1030
-     */
1031
-    protected function _registration_legend_items()
1032
-    {
1033
-        $fc_items = [
1034
-            'star-icon'        => [
1035
-                'class' => 'dashicons dashicons-star-filled lt-blue-icon ee-icon-size-8',
1036
-                'desc'  => esc_html__('This is the Primary Registrant', 'event_espresso'),
1037
-            ],
1038
-            'view_details'     => [
1039
-                'class' => 'dashicons dashicons-clipboard',
1040
-                'desc'  => esc_html__('View Registration Details', 'event_espresso'),
1041
-            ],
1042
-            'edit_attendee'    => [
1043
-                'class' => 'ee-icon ee-icon-user-edit ee-icon-size-16',
1044
-                'desc'  => esc_html__('Edit Contact Details', 'event_espresso'),
1045
-            ],
1046
-            'view_transaction' => [
1047
-                'class' => 'dashicons dashicons-cart',
1048
-                'desc'  => esc_html__('View Transaction Details', 'event_espresso'),
1049
-            ],
1050
-            'view_invoice'     => [
1051
-                'class' => 'dashicons dashicons-media-spreadsheet',
1052
-                'desc'  => esc_html__('View Transaction Invoice', 'event_espresso'),
1053
-            ],
1054
-        ];
1055
-        if (
1056
-            EE_Registry::instance()->CAP->current_user_can(
1057
-                'ee_send_message',
1058
-                'espresso_registrations_resend_registration'
1059
-            )
1060
-        ) {
1061
-            $fc_items['resend_registration'] = [
1062
-                'class' => 'dashicons dashicons-email-alt',
1063
-                'desc'  => esc_html__('Resend Registration Details', 'event_espresso'),
1064
-            ];
1065
-        } else {
1066
-            $fc_items['blank'] = ['class' => 'blank', 'desc' => ''];
1067
-        }
1068
-        if (
1069
-            EE_Registry::instance()->CAP->current_user_can(
1070
-                'ee_read_global_messages',
1071
-                'view_filtered_messages'
1072
-            )
1073
-        ) {
1074
-            $related_for_icon = EEH_MSG_Template::get_message_action_icon('see_notifications_for');
1075
-            if (is_array($related_for_icon) && isset($related_for_icon['css_class'], $related_for_icon['label'])) {
1076
-                $fc_items['view_related_messages'] = [
1077
-                    'class' => $related_for_icon['css_class'],
1078
-                    'desc'  => $related_for_icon['label'],
1079
-                ];
1080
-            }
1081
-        }
1082
-        $sc_items = [
1083
-            'approved_status'   => [
1084
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_approved,
1085
-                'desc'  => EEH_Template::pretty_status(
1086
-                    EEM_Registration::status_id_approved,
1087
-                    false,
1088
-                    'sentence'
1089
-                ),
1090
-            ],
1091
-            'pending_status'    => [
1092
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_pending_payment,
1093
-                'desc'  => EEH_Template::pretty_status(
1094
-                    EEM_Registration::status_id_pending_payment,
1095
-                    false,
1096
-                    'sentence'
1097
-                ),
1098
-            ],
1099
-            'wait_list'         => [
1100
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_wait_list,
1101
-                'desc'  => EEH_Template::pretty_status(
1102
-                    EEM_Registration::status_id_wait_list,
1103
-                    false,
1104
-                    'sentence'
1105
-                ),
1106
-            ],
1107
-            'incomplete_status' => [
1108
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_incomplete,
1109
-                'desc'  => EEH_Template::pretty_status(
1110
-                    EEM_Registration::status_id_incomplete,
1111
-                    false,
1112
-                    'sentence'
1113
-                ),
1114
-            ],
1115
-            'not_approved'      => [
1116
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_not_approved,
1117
-                'desc'  => EEH_Template::pretty_status(
1118
-                    EEM_Registration::status_id_not_approved,
1119
-                    false,
1120
-                    'sentence'
1121
-                ),
1122
-            ],
1123
-            'declined_status'   => [
1124
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_declined,
1125
-                'desc'  => EEH_Template::pretty_status(
1126
-                    EEM_Registration::status_id_declined,
1127
-                    false,
1128
-                    'sentence'
1129
-                ),
1130
-            ],
1131
-            'cancelled_status'  => [
1132
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_cancelled,
1133
-                'desc'  => EEH_Template::pretty_status(
1134
-                    EEM_Registration::status_id_cancelled,
1135
-                    false,
1136
-                    'sentence'
1137
-                ),
1138
-            ],
1139
-        ];
1140
-        return array_merge($fc_items, $sc_items);
1141
-    }
1142
-
1143
-
1144
-
1145
-    /***************************************        REGISTRATION OVERVIEW        **************************************/
1146
-
1147
-
1148
-    /**
1149
-     * @throws DomainException
1150
-     * @throws EE_Error
1151
-     * @throws InvalidArgumentException
1152
-     * @throws InvalidDataTypeException
1153
-     * @throws InvalidInterfaceException
1154
-     */
1155
-    protected function _registrations_overview_list_table()
1156
-    {
1157
-        $this->appendAddNewRegistrationButtonToPageTitle();
1158
-        $header_text                  = '';
1159
-        $admin_page_header_decorators = [
1160
-            'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\AttendeeFilterHeader',
1161
-            'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\EventFilterHeader',
1162
-            'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\DateFilterHeader',
1163
-            'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\TicketFilterHeader',
1164
-        ];
1165
-        foreach ($admin_page_header_decorators as $admin_page_header_decorator) {
1166
-            $filter_header_decorator = $this->getLoader()->getNew($admin_page_header_decorator);
1167
-            $header_text             = $filter_header_decorator->getHeaderText($header_text);
1168
-        }
1169
-        $this->_template_args['admin_page_header'] = $header_text;
1170
-        $this->_template_args['after_list_table']  = $this->_display_legend($this->_registration_legend_items());
1171
-        $this->display_admin_list_table_page_with_no_sidebar();
1172
-    }
1173
-
1174
-
1175
-    /**
1176
-     * @throws EE_Error
1177
-     * @throws InvalidArgumentException
1178
-     * @throws InvalidDataTypeException
1179
-     * @throws InvalidInterfaceException
1180
-     */
1181
-    private function appendAddNewRegistrationButtonToPageTitle()
1182
-    {
1183
-        $EVT_ID = $this->request->getRequestParam('event_id', 0, 'int');
1184
-        if (
1185
-            $EVT_ID
1186
-            && EE_Registry::instance()->CAP->current_user_can(
1187
-                'ee_edit_registrations',
1188
-                'espresso_registrations_new_registration',
1189
-                $EVT_ID
1190
-            )
1191
-        ) {
1192
-            $this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
1193
-                'new_registration',
1194
-                'add-registrant',
1195
-                ['event_id' => $EVT_ID],
1196
-                'add-new-h2'
1197
-            );
1198
-        }
1199
-    }
1200
-
1201
-
1202
-    /**
1203
-     * This sets the _registration property for the registration details screen
1204
-     *
1205
-     * @return void
1206
-     * @throws EE_Error
1207
-     * @throws InvalidArgumentException
1208
-     * @throws InvalidDataTypeException
1209
-     * @throws InvalidInterfaceException
1210
-     */
1211
-    private function _set_registration_object()
1212
-    {
1213
-        // get out if we've already set the object
1214
-        if ($this->_registration instanceof EE_Registration) {
1215
-            return;
1216
-        }
1217
-        $REG_ID = $this->request->getRequestParam('_REG_ID', 0, 'int');
1218
-        if ($this->_registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID)) {
1219
-            return;
1220
-        }
1221
-        $error_msg = sprintf(
1222
-            esc_html__(
1223
-                'An error occurred and the details for Registration ID #%s could not be retrieved.',
1224
-                'event_espresso'
1225
-            ),
1226
-            $REG_ID
1227
-        );
1228
-        EE_Error::add_error($error_msg, __FILE__, __FUNCTION__, __LINE__);
1229
-        $this->_registration = null;
1230
-    }
1231
-
1232
-
1233
-    /**
1234
-     * Used to retrieve registrations for the list table.
1235
-     *
1236
-     * @param int  $per_page
1237
-     * @param bool $count
1238
-     * @param bool $this_month
1239
-     * @param bool $today
1240
-     * @return EE_Registration[]|int
1241
-     * @throws EE_Error
1242
-     * @throws InvalidArgumentException
1243
-     * @throws InvalidDataTypeException
1244
-     * @throws InvalidInterfaceException
1245
-     */
1246
-    public function get_registrations(
1247
-        $per_page = 10,
1248
-        $count = false,
1249
-        $this_month = false,
1250
-        $today = false
1251
-    ) {
1252
-        if ($this_month) {
1253
-            $this->request->setRequestParam('status', 'month');
1254
-        }
1255
-        if ($today) {
1256
-            $this->request->setRequestParam('status', 'today');
1257
-        }
1258
-        $query_params = $this->_get_registration_query_parameters($this->request->requestParams(), $per_page, $count);
1259
-        /**
1260
-         * Override the default groupby added by EEM_Base so that sorts with multiple order bys work as expected
1261
-         *
1262
-         * @link https://events.codebasehq.com/projects/event-espresso/tickets/10093
1263
-         * @see  https://github.com/eventespresso/event-espresso-core/tree/master/docs/G--Model-System/model-query-params.md
1264
-         *                      or if you have the development copy of EE you can view this at the path:
1265
-         *                      /docs/G--Model-System/model-query-params.md
1266
-         */
1267
-        $query_params['group_by'] = '';
1268
-
1269
-        return $count
1270
-            ? $this->getRegistrationModel()->count($query_params)
1271
-            /** @type EE_Registration[] */
1272
-            : $this->getRegistrationModel()->get_all($query_params);
1273
-    }
1274
-
1275
-
1276
-    /**
1277
-     * Retrieves the query parameters to be used by the Registration model for getting registrations.
1278
-     * Note: this listens to values on the request for some of the query parameters.
1279
-     *
1280
-     * @param array $request
1281
-     * @param int   $per_page
1282
-     * @param bool  $count
1283
-     * @return array
1284
-     * @throws EE_Error
1285
-     * @throws InvalidArgumentException
1286
-     * @throws InvalidDataTypeException
1287
-     * @throws InvalidInterfaceException
1288
-     */
1289
-    protected function _get_registration_query_parameters(
1290
-        $request = [],
1291
-        $per_page = 10,
1292
-        $count = false
1293
-    ) {
1294
-        /** @var EventEspresso\core\domain\services\admin\registrations\list_table\QueryBuilder $list_table_query_builder */
1295
-        $list_table_query_builder = $this->getLoader()->getNew(
1296
-            'EventEspresso\core\domain\services\admin\registrations\list_table\QueryBuilder',
1297
-            [null, null, $request]
1298
-        );
1299
-        return $list_table_query_builder->getQueryParams($per_page, $count);
1300
-    }
1301
-
1302
-
1303
-    public function get_registration_status_array()
1304
-    {
1305
-        return self::$_reg_status;
1306
-    }
1307
-
1308
-
1309
-
1310
-
1311
-    /***************************************        REGISTRATION DETAILS        ***************************************/
1312
-    /**
1313
-     * generates HTML for the View Registration Details Admin page
1314
-     *
1315
-     * @return void
1316
-     * @throws DomainException
1317
-     * @throws EE_Error
1318
-     * @throws InvalidArgumentException
1319
-     * @throws InvalidDataTypeException
1320
-     * @throws InvalidInterfaceException
1321
-     * @throws EntityNotFoundException
1322
-     * @throws ReflectionException
1323
-     */
1324
-    protected function _registration_details()
1325
-    {
1326
-        $this->_template_args = [];
1327
-        $this->_set_registration_object();
1328
-        if (is_object($this->_registration)) {
1329
-            $transaction                                   = $this->_registration->transaction()
1330
-                ? $this->_registration->transaction()
1331
-                : EE_Transaction::new_instance();
1332
-            $this->_session                                = $transaction->session_data();
1333
-            $event_id                                      = $this->_registration->event_ID();
1334
-            $this->_template_args['reg_nmbr']['value']     = $this->_registration->ID();
1335
-            $this->_template_args['reg_nmbr']['label']     = esc_html__('Registration Number', 'event_espresso');
1336
-            $this->_template_args['reg_datetime']['value'] = $this->_registration->get_i18n_datetime('REG_date');
1337
-            $this->_template_args['reg_datetime']['label'] = esc_html__('Date', 'event_espresso');
1338
-            $this->_template_args['grand_total']           = $transaction->total();
1339
-            $this->_template_args['currency_sign']         = EE_Registry::instance()->CFG->currency->sign;
1340
-            // link back to overview
1341
-            $this->_template_args['reg_overview_url']            = REG_ADMIN_URL;
1342
-            $this->_template_args['registration']                = $this->_registration;
1343
-            $this->_template_args['filtered_registrations_link'] = EE_Admin_Page::add_query_args_and_nonce(
1344
-                [
1345
-                    'action'   => 'default',
1346
-                    'event_id' => $event_id,
1347
-                ],
1348
-                REG_ADMIN_URL
1349
-            );
1350
-            $this->_template_args['filtered_transactions_link']  = EE_Admin_Page::add_query_args_and_nonce(
1351
-                [
1352
-                    'action' => 'default',
1353
-                    'EVT_ID' => $event_id,
1354
-                    'page'   => 'espresso_transactions',
1355
-                ],
1356
-                admin_url('admin.php')
1357
-            );
1358
-            $this->_template_args['event_link']                  = EE_Admin_Page::add_query_args_and_nonce(
1359
-                [
1360
-                    'page'   => 'espresso_events',
1361
-                    'action' => 'edit',
1362
-                    'post'   => $event_id,
1363
-                ],
1364
-                admin_url('admin.php')
1365
-            );
1366
-            // next and previous links
1367
-            $next_reg                                      = $this->_registration->next(
1368
-                null,
1369
-                [],
1370
-                'REG_ID'
1371
-            );
1372
-            $this->_template_args['next_registration']     = $next_reg
1373
-                ? $this->_next_link(
1374
-                    EE_Admin_Page::add_query_args_and_nonce(
1375
-                        [
1376
-                            'action'  => 'view_registration',
1377
-                            '_REG_ID' => $next_reg['REG_ID'],
1378
-                        ],
1379
-                        REG_ADMIN_URL
1380
-                    ),
1381
-                    'dashicons dashicons-arrow-right ee-icon-size-22'
1382
-                )
1383
-                : '';
1384
-            $previous_reg                                  = $this->_registration->previous(
1385
-                null,
1386
-                [],
1387
-                'REG_ID'
1388
-            );
1389
-            $this->_template_args['previous_registration'] = $previous_reg
1390
-                ? $this->_previous_link(
1391
-                    EE_Admin_Page::add_query_args_and_nonce(
1392
-                        [
1393
-                            'action'  => 'view_registration',
1394
-                            '_REG_ID' => $previous_reg['REG_ID'],
1395
-                        ],
1396
-                        REG_ADMIN_URL
1397
-                    ),
1398
-                    'dashicons dashicons-arrow-left ee-icon-size-22'
1399
-                )
1400
-                : '';
1401
-            // grab header
1402
-            $template_path                             = REG_TEMPLATE_PATH . 'reg_admin_details_header.template.php';
1403
-            $this->_template_args['REG_ID']            = $this->_registration->ID();
1404
-            $this->_template_args['admin_page_header'] = EEH_Template::display_template(
1405
-                $template_path,
1406
-                $this->_template_args,
1407
-                true
1408
-            );
1409
-        } else {
1410
-            $this->_template_args['admin_page_header'] = '';
1411
-            $this->_display_espresso_notices();
1412
-        }
1413
-        // the details template wrapper
1414
-        $this->display_admin_page_with_sidebar();
1415
-    }
1416
-
1417
-
1418
-    /**
1419
-     * @throws EE_Error
1420
-     * @throws InvalidArgumentException
1421
-     * @throws InvalidDataTypeException
1422
-     * @throws InvalidInterfaceException
1423
-     * @throws ReflectionException
1424
-     * @since 4.10.2.p
1425
-     */
1426
-    protected function _registration_details_metaboxes()
1427
-    {
1428
-        do_action('AHEE__Registrations_Admin_Page___registration_details_metabox__start', $this);
1429
-        $this->_set_registration_object();
1430
-        $attendee = $this->_registration instanceof EE_Registration ? $this->_registration->attendee() : null;
1431
-        add_meta_box(
1432
-            'edit-reg-status-mbox',
1433
-            esc_html__('Registration Status', 'event_espresso'),
1434
-            [$this, 'set_reg_status_buttons_metabox'],
1435
-            $this->_wp_page_slug,
1436
-            'normal',
1437
-            'high'
1438
-        );
1439
-        add_meta_box(
1440
-            'edit-reg-details-mbox',
1441
-            esc_html__('Registration Details', 'event_espresso'),
1442
-            [$this, '_reg_details_meta_box'],
1443
-            $this->_wp_page_slug,
1444
-            'normal',
1445
-            'high'
1446
-        );
1447
-        if (
1448
-            $attendee instanceof EE_Attendee
1449
-            && EE_Registry::instance()->CAP->current_user_can(
1450
-                'ee_read_registration',
1451
-                'edit-reg-questions-mbox',
1452
-                $this->_registration->ID()
1453
-            )
1454
-        ) {
1455
-            add_meta_box(
1456
-                'edit-reg-questions-mbox',
1457
-                esc_html__('Registration Form Answers', 'event_espresso'),
1458
-                [$this, '_reg_questions_meta_box'],
1459
-                $this->_wp_page_slug,
1460
-                'normal',
1461
-                'high'
1462
-            );
1463
-        }
1464
-        add_meta_box(
1465
-            'edit-reg-registrant-mbox',
1466
-            esc_html__('Contact Details', 'event_espresso'),
1467
-            [$this, '_reg_registrant_side_meta_box'],
1468
-            $this->_wp_page_slug,
1469
-            'side',
1470
-            'high'
1471
-        );
1472
-        if ($this->_registration->group_size() > 1) {
1473
-            add_meta_box(
1474
-                'edit-reg-attendees-mbox',
1475
-                esc_html__('Other Registrations in this Transaction', 'event_espresso'),
1476
-                [$this, '_reg_attendees_meta_box'],
1477
-                $this->_wp_page_slug,
1478
-                'normal',
1479
-                'high'
1480
-            );
1481
-        }
1482
-    }
1483
-
1484
-
1485
-    /**
1486
-     * set_reg_status_buttons_metabox
1487
-     *
1488
-     * @return void
1489
-     * @throws EE_Error
1490
-     * @throws EntityNotFoundException
1491
-     * @throws InvalidArgumentException
1492
-     * @throws InvalidDataTypeException
1493
-     * @throws InvalidInterfaceException
1494
-     * @throws ReflectionException
1495
-     */
1496
-    public function set_reg_status_buttons_metabox()
1497
-    {
1498
-        $this->_set_registration_object();
1499
-        $change_reg_status_form = $this->_generate_reg_status_change_form();
1500
-        $output                 = $change_reg_status_form->form_open(
1501
-            self::add_query_args_and_nonce(
1502
-                [
1503
-                    'action' => 'change_reg_status',
1504
-                ],
1505
-                REG_ADMIN_URL
1506
-            )
1507
-        );
1508
-        $output                 .= $change_reg_status_form->get_html();
1509
-        $output                 .= $change_reg_status_form->form_close();
1510
-        echo $output; // already escaped
1511
-    }
1512
-
1513
-
1514
-    /**
1515
-     * @return EE_Form_Section_Proper
1516
-     * @throws EE_Error
1517
-     * @throws InvalidArgumentException
1518
-     * @throws InvalidDataTypeException
1519
-     * @throws InvalidInterfaceException
1520
-     * @throws EntityNotFoundException
1521
-     * @throws ReflectionException
1522
-     */
1523
-    protected function _generate_reg_status_change_form()
1524
-    {
1525
-        $reg_status_change_form_array = [
1526
-            'name'            => 'reg_status_change_form',
1527
-            'html_id'         => 'reg-status-change-form',
1528
-            'layout_strategy' => new EE_Admin_Two_Column_Layout(),
1529
-            'subsections'     => [
1530
-                'return'         => new EE_Hidden_Input(
1531
-                    [
1532
-                        'name'    => 'return',
1533
-                        'default' => 'view_registration',
1534
-                    ]
1535
-                ),
1536
-                'REG_ID'         => new EE_Hidden_Input(
1537
-                    [
1538
-                        'name'    => 'REG_ID',
1539
-                        'default' => $this->_registration->ID(),
1540
-                    ]
1541
-                ),
1542
-                'current_status' => new EE_Form_Section_HTML(
1543
-                    EEH_HTML::table(
1544
-                        EEH_HTML::tr(
1545
-                            EEH_HTML::th(
1546
-                                EEH_HTML::label(
1547
-                                    EEH_HTML::strong(
1548
-                                        esc_html__('Current Registration Status', 'event_espresso')
1549
-                                    )
1550
-                                )
1551
-                            )
1552
-                            . EEH_HTML::td(
1553
-                                EEH_HTML::strong(
1554
-                                    $this->_registration->pretty_status(),
1555
-                                    '',
1556
-                                    'status-' . $this->_registration->status_ID(),
1557
-                                    'line-height: 1em; font-size: 1.5em; font-weight: bold;'
1558
-                                )
1559
-                            )
1560
-                        )
1561
-                    )
1562
-                ),
1563
-            ],
1564
-        ];
1565
-        if (
1566
-            EE_Registry::instance()->CAP->current_user_can(
1567
-                'ee_edit_registration',
1568
-                'toggle_registration_status',
1569
-                $this->_registration->ID()
1570
-            )
1571
-        ) {
1572
-            $reg_status_change_form_array['subsections']['reg_status']         = new EE_Select_Input(
1573
-                $this->_get_reg_statuses(),
1574
-                [
1575
-                    'html_label_text' => esc_html__('Change Registration Status to', 'event_espresso'),
1576
-                    'default'         => $this->_registration->status_ID(),
1577
-                ]
1578
-            );
1579
-            $reg_status_change_form_array['subsections']['send_notifications'] = new EE_Yes_No_Input(
1580
-                [
1581
-                    'html_label_text' => esc_html__('Send Related Messages', 'event_espresso'),
1582
-                    'default'         => false,
1583
-                    'html_help_text'  => esc_html__(
1584
-                        'If set to "Yes", then the related messages will be sent to the registrant.',
1585
-                        'event_espresso'
1586
-                    ),
1587
-                ]
1588
-            );
1589
-            $reg_status_change_form_array['subsections']['submit']             = new EE_Submit_Input(
1590
-                [
1591
-                    'html_class'      => 'button-primary',
1592
-                    'html_label_text' => '&nbsp;',
1593
-                    'default'         => esc_html__('Update Registration Status', 'event_espresso'),
1594
-                ]
1595
-            );
1596
-        }
1597
-        return new EE_Form_Section_Proper($reg_status_change_form_array);
1598
-    }
1599
-
1600
-
1601
-    /**
1602
-     * Returns an array of all the buttons for the various statuses and switch status actions
1603
-     *
1604
-     * @return array
1605
-     * @throws EE_Error
1606
-     * @throws InvalidArgumentException
1607
-     * @throws InvalidDataTypeException
1608
-     * @throws InvalidInterfaceException
1609
-     * @throws EntityNotFoundException
1610
-     */
1611
-    protected function _get_reg_statuses()
1612
-    {
1613
-        $reg_status_array = $this->getRegistrationModel()->reg_status_array();
1614
-        unset($reg_status_array[ EEM_Registration::status_id_incomplete ]);
1615
-        // get current reg status
1616
-        $current_status = $this->_registration->status_ID();
1617
-        // is registration for free event? This will determine whether to display the pending payment option
1618
-        if (
1619
-            $current_status !== EEM_Registration::status_id_pending_payment
1620
-            && EEH_Money::compare_floats($this->_registration->ticket()->price(), 0.00)
1621
-        ) {
1622
-            unset($reg_status_array[ EEM_Registration::status_id_pending_payment ]);
1623
-        }
1624
-        return $this->getStatusModel()->localized_status($reg_status_array, false, 'sentence');
1625
-    }
1626
-
1627
-
1628
-    /**
1629
-     * This method is used when using _REG_ID from request which may or may not be an array of reg_ids.
1630
-     *
1631
-     * @param bool $status REG status given for changing registrations to.
1632
-     * @param bool $notify Whether to send messages notifications or not.
1633
-     * @return array (array with reg_id(s) updated and whether update was successful.
1634
-     * @throws DomainException
1635
-     * @throws EE_Error
1636
-     * @throws EntityNotFoundException
1637
-     * @throws InvalidArgumentException
1638
-     * @throws InvalidDataTypeException
1639
-     * @throws InvalidInterfaceException
1640
-     * @throws ReflectionException
1641
-     * @throws RuntimeException
1642
-     */
1643
-    protected function _set_registration_status_from_request($status = false, $notify = false)
1644
-    {
1645
-        $REG_IDs = $this->request->requestParamIsSet('reg_status_change_form')
1646
-            ? $this->request->getRequestParam('reg_status_change_form[REG_ID]', [], 'int', true)
1647
-            : $this->request->getRequestParam('_REG_ID', [], 'int', true);
1648
-
1649
-        // sanitize $REG_IDs
1650
-        $REG_IDs = array_map('absint', $REG_IDs);
1651
-        // and remove empty entries
1652
-        $REG_IDs = array_filter($REG_IDs);
1653
-
1654
-        $result = $this->_set_registration_status($REG_IDs, $status, $notify);
1655
-
1656
-        /**
1657
-         * Set and filter $_req_data['_REG_ID'] for any potential future messages notifications.
1658
-         * Currently this value is used downstream by the _process_resend_registration method.
1659
-         *
1660
-         * @param int|array                $registration_ids The registration ids that have had their status changed successfully.
1661
-         * @param bool                     $status           The status registrations were changed to.
1662
-         * @param bool                     $success          If the status was changed successfully for all registrations.
1663
-         * @param Registrations_Admin_Page $admin_page_object
1664
-         */
1665
-        $REG_ID = apply_filters(
1666
-            'FHEE__Registrations_Admin_Page___set_registration_status_from_request__REG_IDs',
1667
-            $result['REG_ID'],
1668
-            $status,
1669
-            $result['success'],
1670
-            $this
1671
-        );
1672
-        $this->request->setRequestParam('_REG_ID', $REG_ID);
1673
-
1674
-        // notify?
1675
-        if (
1676
-            $notify
1677
-            && $result['success']
1678
-            && ! empty($REG_ID)
1679
-            && EE_Registry::instance()->CAP->current_user_can(
1680
-                'ee_send_message',
1681
-                'espresso_registrations_resend_registration'
1682
-            )
1683
-        ) {
1684
-            $this->_process_resend_registration();
1685
-        }
1686
-        return $result;
1687
-    }
1688
-
1689
-
1690
-    /**
1691
-     * Set the registration status for the given reg_id (which may or may not be an array, it gets typecast to an
1692
-     * array). Note, this method does NOT take care of possible notifications.  That is required by calling code.
1693
-     *
1694
-     * @param array  $REG_IDs
1695
-     * @param string $status
1696
-     * @param bool   $notify Used to indicate whether notification was requested or not.  This determines the context
1697
-     *                       slug sent with setting the registration status.
1698
-     * @return array (an array with 'success' key representing whether status change was successful, and 'REG_ID' as
1699
-     * @throws EE_Error
1700
-     * @throws InvalidArgumentException
1701
-     * @throws InvalidDataTypeException
1702
-     * @throws InvalidInterfaceException
1703
-     * @throws ReflectionException
1704
-     * @throws RuntimeException
1705
-     * @throws EntityNotFoundException
1706
-     * @throws DomainException
1707
-     */
1708
-    protected function _set_registration_status($REG_IDs = [], $status = '', $notify = false)
1709
-    {
1710
-        $success = false;
1711
-        // typecast $REG_IDs
1712
-        $REG_IDs = (array) $REG_IDs;
1713
-        if (! empty($REG_IDs)) {
1714
-            $success = true;
1715
-            // set default status if none is passed
1716
-            $status         = $status ?: EEM_Registration::status_id_pending_payment;
1717
-            $status_context = $notify
1718
-                ? Domain::CONTEXT_REGISTRATION_STATUS_CHANGE_REGISTRATION_ADMIN_NOTIFY
1719
-                : Domain::CONTEXT_REGISTRATION_STATUS_CHANGE_REGISTRATION_ADMIN;
1720
-            // loop through REG_ID's and change status
1721
-            foreach ($REG_IDs as $REG_ID) {
1722
-                $registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
1723
-                if ($registration instanceof EE_Registration) {
1724
-                    $registration->set_status(
1725
-                        $status,
1726
-                        false,
1727
-                        new Context(
1728
-                            $status_context,
1729
-                            esc_html__(
1730
-                                'Manually triggered status change on a Registration Admin Page route.',
1731
-                                'event_espresso'
1732
-                            )
1733
-                        )
1734
-                    );
1735
-                    $result = $registration->save();
1736
-                    // verifying explicit fails because update *may* just return 0 for 0 rows affected
1737
-                    $success = $result !== false ? $success : false;
1738
-                }
1739
-            }
1740
-        }
1741
-
1742
-        // return $success and processed registrations
1743
-        return ['REG_ID' => $REG_IDs, 'success' => $success];
1744
-    }
1745
-
1746
-
1747
-    /**
1748
-     * Common logic for setting up success message and redirecting to appropriate route
1749
-     *
1750
-     * @param string $STS_ID status id for the registration changed to
1751
-     * @param bool   $notify indicates whether the _set_registration_status_from_request does notifications or not.
1752
-     * @return void
1753
-     * @throws DomainException
1754
-     * @throws EE_Error
1755
-     * @throws EntityNotFoundException
1756
-     * @throws InvalidArgumentException
1757
-     * @throws InvalidDataTypeException
1758
-     * @throws InvalidInterfaceException
1759
-     * @throws ReflectionException
1760
-     * @throws RuntimeException
1761
-     */
1762
-    protected function _reg_status_change_return($STS_ID, $notify = false)
1763
-    {
1764
-        $result  = ! empty($STS_ID) ? $this->_set_registration_status_from_request($STS_ID, $notify)
1765
-            : ['success' => false];
1766
-        $success = isset($result['success']) && $result['success'];
1767
-        // setup success message
1768
-        if ($success) {
1769
-            if (is_array($result['REG_ID']) && count($result['REG_ID']) === 1) {
1770
-                $msg = sprintf(
1771
-                    esc_html__('Registration status has been set to %s', 'event_espresso'),
1772
-                    EEH_Template::pretty_status($STS_ID, false, 'lower')
1773
-                );
1774
-            } else {
1775
-                $msg = sprintf(
1776
-                    esc_html__('Registrations have been set to %s.', 'event_espresso'),
1777
-                    EEH_Template::pretty_status($STS_ID, false, 'lower')
1778
-                );
1779
-            }
1780
-            EE_Error::add_success($msg);
1781
-        } else {
1782
-            EE_Error::add_error(
1783
-                esc_html__(
1784
-                    'Something went wrong, and the status was not changed',
1785
-                    'event_espresso'
1786
-                ),
1787
-                __FILE__,
1788
-                __LINE__,
1789
-                __FUNCTION__
1790
-            );
1791
-        }
1792
-        $return = $this->request->getRequestParam('return');
1793
-        $route  = $return === 'view_registration'
1794
-            ? ['action' => 'view_registration', '_REG_ID' => reset($result['REG_ID'])]
1795
-            : ['action' => 'default'];
1796
-        $route  = $this->mergeExistingRequestParamsWithRedirectArgs($route);
1797
-        $this->_redirect_after_action($success, '', '', $route, true);
1798
-    }
1799
-
1800
-
1801
-    /**
1802
-     * incoming reg status change from reg details page.
1803
-     *
1804
-     * @return void
1805
-     * @throws EE_Error
1806
-     * @throws EntityNotFoundException
1807
-     * @throws InvalidArgumentException
1808
-     * @throws InvalidDataTypeException
1809
-     * @throws InvalidInterfaceException
1810
-     * @throws ReflectionException
1811
-     * @throws RuntimeException
1812
-     * @throws DomainException
1813
-     */
1814
-    protected function _change_reg_status()
1815
-    {
1816
-        $this->request->setRequestParam('return', 'view_registration');
1817
-        // set notify based on whether the send notifications toggle is set or not
1818
-        $notify     = $this->request->getRequestParam('reg_status_change_form[send_notifications]', false, 'bool');
1819
-        $reg_status = $this->request->getRequestParam('reg_status_change_form[reg_status]', '');
1820
-        $this->request->setRequestParam('reg_status_change_form[reg_status]', $reg_status);
1821
-        switch ($reg_status) {
1822
-            case EEM_Registration::status_id_approved:
1823
-            case EEH_Template::pretty_status(EEM_Registration::status_id_approved, false, 'sentence'):
1824
-                $this->approve_registration($notify);
1825
-                break;
1826
-            case EEM_Registration::status_id_pending_payment:
1827
-            case EEH_Template::pretty_status(EEM_Registration::status_id_pending_payment, false, 'sentence'):
1828
-                $this->pending_registration($notify);
1829
-                break;
1830
-            case EEM_Registration::status_id_not_approved:
1831
-            case EEH_Template::pretty_status(EEM_Registration::status_id_not_approved, false, 'sentence'):
1832
-                $this->not_approve_registration($notify);
1833
-                break;
1834
-            case EEM_Registration::status_id_declined:
1835
-            case EEH_Template::pretty_status(EEM_Registration::status_id_declined, false, 'sentence'):
1836
-                $this->decline_registration($notify);
1837
-                break;
1838
-            case EEM_Registration::status_id_cancelled:
1839
-            case EEH_Template::pretty_status(EEM_Registration::status_id_cancelled, false, 'sentence'):
1840
-                $this->cancel_registration($notify);
1841
-                break;
1842
-            case EEM_Registration::status_id_wait_list:
1843
-            case EEH_Template::pretty_status(EEM_Registration::status_id_wait_list, false, 'sentence'):
1844
-                $this->wait_list_registration($notify);
1845
-                break;
1846
-            case EEM_Registration::status_id_incomplete:
1847
-            default:
1848
-                $this->request->unSetRequestParam('return');
1849
-                $this->_reg_status_change_return('');
1850
-                break;
1851
-        }
1852
-    }
1853
-
1854
-
1855
-    /**
1856
-     * Callback for bulk action routes.
1857
-     * Note: although we could just register the singular route callbacks for each bulk action route as well, this
1858
-     * method was chosen so there is one central place all the registration status bulk actions are going through.
1859
-     * Potentially, this provides an easier place to locate logic that is specific to these bulk actions (as opposed to
1860
-     * when an action is happening on just a single registration).
1861
-     *
1862
-     * @param      $action
1863
-     * @param bool $notify
1864
-     */
1865
-    protected function bulk_action_on_registrations($action, $notify = false)
1866
-    {
1867
-        do_action(
1868
-            'AHEE__Registrations_Admin_Page__bulk_action_on_registrations__before_execution',
1869
-            $this,
1870
-            $action,
1871
-            $notify
1872
-        );
1873
-        $method = $action . '_registration';
1874
-        if (method_exists($this, $method)) {
1875
-            $this->$method($notify);
1876
-        }
1877
-    }
1878
-
1879
-
1880
-    /**
1881
-     * approve_registration
1882
-     *
1883
-     * @param bool $notify whether or not to notify the registrant about their approval.
1884
-     * @return void
1885
-     * @throws EE_Error
1886
-     * @throws EntityNotFoundException
1887
-     * @throws InvalidArgumentException
1888
-     * @throws InvalidDataTypeException
1889
-     * @throws InvalidInterfaceException
1890
-     * @throws ReflectionException
1891
-     * @throws RuntimeException
1892
-     * @throws DomainException
1893
-     */
1894
-    protected function approve_registration($notify = false)
1895
-    {
1896
-        $this->_reg_status_change_return(EEM_Registration::status_id_approved, $notify);
1897
-    }
1898
-
1899
-
1900
-    /**
1901
-     * decline_registration
1902
-     *
1903
-     * @param bool $notify whether or not to notify the registrant about their status change.
1904
-     * @return void
1905
-     * @throws EE_Error
1906
-     * @throws EntityNotFoundException
1907
-     * @throws InvalidArgumentException
1908
-     * @throws InvalidDataTypeException
1909
-     * @throws InvalidInterfaceException
1910
-     * @throws ReflectionException
1911
-     * @throws RuntimeException
1912
-     * @throws DomainException
1913
-     */
1914
-    protected function decline_registration($notify = false)
1915
-    {
1916
-        $this->_reg_status_change_return(EEM_Registration::status_id_declined, $notify);
1917
-    }
1918
-
1919
-
1920
-    /**
1921
-     * cancel_registration
1922
-     *
1923
-     * @param bool $notify whether or not to notify the registrant about their status change.
1924
-     * @return void
1925
-     * @throws EE_Error
1926
-     * @throws EntityNotFoundException
1927
-     * @throws InvalidArgumentException
1928
-     * @throws InvalidDataTypeException
1929
-     * @throws InvalidInterfaceException
1930
-     * @throws ReflectionException
1931
-     * @throws RuntimeException
1932
-     * @throws DomainException
1933
-     */
1934
-    protected function cancel_registration($notify = false)
1935
-    {
1936
-        $this->_reg_status_change_return(EEM_Registration::status_id_cancelled, $notify);
1937
-    }
1938
-
1939
-
1940
-    /**
1941
-     * not_approve_registration
1942
-     *
1943
-     * @param bool $notify whether or not to notify the registrant about their status change.
1944
-     * @return void
1945
-     * @throws EE_Error
1946
-     * @throws EntityNotFoundException
1947
-     * @throws InvalidArgumentException
1948
-     * @throws InvalidDataTypeException
1949
-     * @throws InvalidInterfaceException
1950
-     * @throws ReflectionException
1951
-     * @throws RuntimeException
1952
-     * @throws DomainException
1953
-     */
1954
-    protected function not_approve_registration($notify = false)
1955
-    {
1956
-        $this->_reg_status_change_return(EEM_Registration::status_id_not_approved, $notify);
1957
-    }
1958
-
1959
-
1960
-    /**
1961
-     * decline_registration
1962
-     *
1963
-     * @param bool $notify whether or not to notify the registrant about their status change.
1964
-     * @return void
1965
-     * @throws EE_Error
1966
-     * @throws EntityNotFoundException
1967
-     * @throws InvalidArgumentException
1968
-     * @throws InvalidDataTypeException
1969
-     * @throws InvalidInterfaceException
1970
-     * @throws ReflectionException
1971
-     * @throws RuntimeException
1972
-     * @throws DomainException
1973
-     */
1974
-    protected function pending_registration($notify = false)
1975
-    {
1976
-        $this->_reg_status_change_return(EEM_Registration::status_id_pending_payment, $notify);
1977
-    }
1978
-
1979
-
1980
-    /**
1981
-     * waitlist_registration
1982
-     *
1983
-     * @param bool $notify whether or not to notify the registrant about their status change.
1984
-     * @return void
1985
-     * @throws EE_Error
1986
-     * @throws EntityNotFoundException
1987
-     * @throws InvalidArgumentException
1988
-     * @throws InvalidDataTypeException
1989
-     * @throws InvalidInterfaceException
1990
-     * @throws ReflectionException
1991
-     * @throws RuntimeException
1992
-     * @throws DomainException
1993
-     */
1994
-    protected function wait_list_registration($notify = false)
1995
-    {
1996
-        $this->_reg_status_change_return(EEM_Registration::status_id_wait_list, $notify);
1997
-    }
1998
-
1999
-
2000
-    /**
2001
-     * generates HTML for the Registration main meta box
2002
-     *
2003
-     * @return void
2004
-     * @throws DomainException
2005
-     * @throws EE_Error
2006
-     * @throws InvalidArgumentException
2007
-     * @throws InvalidDataTypeException
2008
-     * @throws InvalidInterfaceException
2009
-     * @throws ReflectionException
2010
-     * @throws EntityNotFoundException
2011
-     */
2012
-    public function _reg_details_meta_box()
2013
-    {
2014
-        EEH_Autoloader::register_line_item_display_autoloaders();
2015
-        EEH_Autoloader::register_line_item_filter_autoloaders();
2016
-        EE_Registry::instance()->load_helper('Line_Item');
2017
-        $transaction    = $this->_registration->transaction() ? $this->_registration->transaction()
2018
-            : EE_Transaction::new_instance();
2019
-        $this->_session = $transaction->session_data();
2020
-        $filters        = new EE_Line_Item_Filter_Collection();
2021
-        $filters->add(new EE_Single_Registration_Line_Item_Filter($this->_registration));
2022
-        $filters->add(new EE_Non_Zero_Line_Item_Filter());
2023
-        $line_item_filter_processor              = new EE_Line_Item_Filter_Processor(
2024
-            $filters,
2025
-            $transaction->total_line_item()
2026
-        );
2027
-        $filtered_line_item_tree                 = $line_item_filter_processor->process();
2028
-        $line_item_display                       = new EE_Line_Item_Display(
2029
-            'reg_admin_table',
2030
-            'EE_Admin_Table_Registration_Line_Item_Display_Strategy'
2031
-        );
2032
-        $this->_template_args['line_item_table'] = $line_item_display->display_line_item(
2033
-            $filtered_line_item_tree,
2034
-            ['EE_Registration' => $this->_registration]
2035
-        );
2036
-        $attendee                                = $this->_registration->attendee();
2037
-        if (
2038
-            EE_Registry::instance()->CAP->current_user_can(
2039
-                'ee_read_transaction',
2040
-                'espresso_transactions_view_transaction'
2041
-            )
2042
-        ) {
2043
-            $this->_template_args['view_transaction_button'] = EEH_Template::get_button_or_link(
2044
-                EE_Admin_Page::add_query_args_and_nonce(
2045
-                    [
2046
-                        'action' => 'view_transaction',
2047
-                        'TXN_ID' => $transaction->ID(),
2048
-                    ],
2049
-                    TXN_ADMIN_URL
2050
-                ),
2051
-                esc_html__(' View Transaction', 'event_espresso'),
2052
-                'button secondary-button right',
2053
-                'dashicons dashicons-cart'
2054
-            );
2055
-        } else {
2056
-            $this->_template_args['view_transaction_button'] = '';
2057
-        }
2058
-        if (
2059
-            $attendee instanceof EE_Attendee
2060
-            && EE_Registry::instance()->CAP->current_user_can(
2061
-                'ee_send_message',
2062
-                'espresso_registrations_resend_registration'
2063
-            )
2064
-        ) {
2065
-            $this->_template_args['resend_registration_button'] = EEH_Template::get_button_or_link(
2066
-                EE_Admin_Page::add_query_args_and_nonce(
2067
-                    [
2068
-                        'action'      => 'resend_registration',
2069
-                        '_REG_ID'     => $this->_registration->ID(),
2070
-                        'redirect_to' => 'view_registration',
2071
-                    ],
2072
-                    REG_ADMIN_URL
2073
-                ),
2074
-                esc_html__(' Resend Registration', 'event_espresso'),
2075
-                'button secondary-button right',
2076
-                'dashicons dashicons-email-alt'
2077
-            );
2078
-        } else {
2079
-            $this->_template_args['resend_registration_button'] = '';
2080
-        }
2081
-        $this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
2082
-        $payment                               = $transaction->get_first_related('Payment');
2083
-        $payment                               = ! $payment instanceof EE_Payment
2084
-            ? EE_Payment::new_instance()
2085
-            : $payment;
2086
-        $payment_method                        = $payment->get_first_related('Payment_Method');
2087
-        $payment_method                        = ! $payment_method instanceof EE_Payment_Method
2088
-            ? EE_Payment_Method::new_instance()
2089
-            : $payment_method;
2090
-        $reg_details                           = [
2091
-            'payment_method'       => $payment_method->name(),
2092
-            'response_msg'         => $payment->gateway_response(),
2093
-            'registration_id'      => $this->_registration->get('REG_code'),
2094
-            'registration_session' => $this->_registration->session_ID(),
2095
-            'ip_address'           => isset($this->_session['ip_address']) ? $this->_session['ip_address'] : '',
2096
-            'user_agent'           => isset($this->_session['user_agent']) ? $this->_session['user_agent'] : '',
2097
-        ];
2098
-        if (isset($reg_details['registration_id'])) {
2099
-            $this->_template_args['reg_details']['registration_id']['value'] = $reg_details['registration_id'];
2100
-            $this->_template_args['reg_details']['registration_id']['label'] = esc_html__(
2101
-                'Registration ID',
2102
-                'event_espresso'
2103
-            );
2104
-            $this->_template_args['reg_details']['registration_id']['class'] = 'regular-text';
2105
-        }
2106
-        if (isset($reg_details['payment_method'])) {
2107
-            $this->_template_args['reg_details']['payment_method']['value'] = $reg_details['payment_method'];
2108
-            $this->_template_args['reg_details']['payment_method']['label'] = esc_html__(
2109
-                'Most Recent Payment Method',
2110
-                'event_espresso'
2111
-            );
2112
-            $this->_template_args['reg_details']['payment_method']['class'] = 'regular-text';
2113
-            $this->_template_args['reg_details']['response_msg']['value']   = $reg_details['response_msg'];
2114
-            $this->_template_args['reg_details']['response_msg']['label']   = esc_html__(
2115
-                'Payment method response',
2116
-                'event_espresso'
2117
-            );
2118
-            $this->_template_args['reg_details']['response_msg']['class']   = 'regular-text';
2119
-        }
2120
-        $this->_template_args['reg_details']['registration_session']['value'] = $reg_details['registration_session'];
2121
-        $this->_template_args['reg_details']['registration_session']['label'] = esc_html__(
2122
-            'Registration Session',
2123
-            'event_espresso'
2124
-        );
2125
-        $this->_template_args['reg_details']['registration_session']['class'] = 'regular-text';
2126
-        $this->_template_args['reg_details']['ip_address']['value']           = $reg_details['ip_address'];
2127
-        $this->_template_args['reg_details']['ip_address']['label']           = esc_html__(
2128
-            'Registration placed from IP',
2129
-            'event_espresso'
2130
-        );
2131
-        $this->_template_args['reg_details']['ip_address']['class']           = 'regular-text';
2132
-        $this->_template_args['reg_details']['user_agent']['value']           = $reg_details['user_agent'];
2133
-        $this->_template_args['reg_details']['user_agent']['label']           = esc_html__(
2134
-            'Registrant User Agent',
2135
-            'event_espresso'
2136
-        );
2137
-        $this->_template_args['reg_details']['user_agent']['class']           = 'large-text';
2138
-        $this->_template_args['event_link']                                   = EE_Admin_Page::add_query_args_and_nonce(
2139
-            [
2140
-                'action'   => 'default',
2141
-                'event_id' => $this->_registration->event_ID(),
2142
-            ],
2143
-            REG_ADMIN_URL
2144
-        );
2145
-        $this->_template_args['REG_ID']                                       = $this->_registration->ID();
2146
-        $this->_template_args['event_id']                                     = $this->_registration->event_ID();
2147
-        $template_path                                                        =
2148
-            REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_details.template.php';
2149
-        EEH_Template::display_template($template_path, $this->_template_args); // already escaped
2150
-    }
2151
-
2152
-
2153
-    /**
2154
-     * generates HTML for the Registration Questions meta box.
2155
-     * If pre-4.8.32.rc.000 hooks are used, uses old methods (with its filters),
2156
-     * otherwise uses new forms system
2157
-     *
2158
-     * @return void
2159
-     * @throws DomainException
2160
-     * @throws EE_Error
2161
-     * @throws InvalidArgumentException
2162
-     * @throws InvalidDataTypeException
2163
-     * @throws InvalidInterfaceException
2164
-     * @throws ReflectionException
2165
-     */
2166
-    public function _reg_questions_meta_box()
2167
-    {
2168
-        // allow someone to override this method entirely
2169
-        if (
2170
-            apply_filters(
2171
-                'FHEE__Registrations_Admin_Page___reg_questions_meta_box__do_default',
2172
-                true,
2173
-                $this,
2174
-                $this->_registration
2175
-            )
2176
-        ) {
2177
-            $form                                              = $this->_get_reg_custom_questions_form(
2178
-                $this->_registration->ID()
2179
-            );
2180
-            $this->_template_args['att_questions']             = count($form->subforms()) > 0
2181
-                ? $form->get_html_and_js()
2182
-                : '';
2183
-            $this->_template_args['reg_questions_form_action'] = 'edit_registration';
2184
-            $this->_template_args['REG_ID']                    = $this->_registration->ID();
2185
-            $template_path                                     =
2186
-                REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_questions.template.php';
2187
-            EEH_Template::display_template($template_path, $this->_template_args);
2188
-        }
2189
-    }
2190
-
2191
-
2192
-    /**
2193
-     * form_before_question_group
2194
-     *
2195
-     * @param string $output
2196
-     * @return        string
2197
-     * @deprecated    as of 4.8.32.rc.000
2198
-     */
2199
-    public function form_before_question_group($output)
2200
-    {
2201
-        EE_Error::doing_it_wrong(
2202
-            __CLASS__ . '::' . __FUNCTION__,
2203
-            esc_html__(
2204
-                'This method would have been protected but was used on a filter callback so needed to be public. Please discontinue usage as it will be removed soon.',
2205
-                'event_espresso'
2206
-            ),
2207
-            '4.8.32.rc.000'
2208
-        );
2209
-        return '
22
+	/**
23
+	 * @var EE_Registration
24
+	 */
25
+	private $_registration;
26
+
27
+	/**
28
+	 * @var EE_Event
29
+	 */
30
+	private $_reg_event;
31
+
32
+	/**
33
+	 * @var EE_Session
34
+	 */
35
+	private $_session;
36
+
37
+	/**
38
+	 * @var array
39
+	 */
40
+	private static $_reg_status;
41
+
42
+	/**
43
+	 * Form for displaying the custom questions for this registration.
44
+	 * This gets used a few times throughout the request so its best to cache it
45
+	 *
46
+	 * @var EE_Registration_Custom_Questions_Form
47
+	 */
48
+	protected $_reg_custom_questions_form = null;
49
+
50
+	/**
51
+	 * @var EEM_Registration $registration_model
52
+	 */
53
+	private $registration_model;
54
+
55
+	/**
56
+	 * @var EEM_Attendee $attendee_model
57
+	 */
58
+	private $attendee_model;
59
+
60
+	/**
61
+	 * @var EEM_Event $event_model
62
+	 */
63
+	private $event_model;
64
+
65
+	/**
66
+	 * @var EEM_Status $status_model
67
+	 */
68
+	private $status_model;
69
+
70
+
71
+	/**
72
+	 * @param bool $routing
73
+	 * @throws EE_Error
74
+	 * @throws InvalidArgumentException
75
+	 * @throws InvalidDataTypeException
76
+	 * @throws InvalidInterfaceException
77
+	 * @throws ReflectionException
78
+	 */
79
+	public function __construct($routing = true)
80
+	{
81
+		parent::__construct($routing);
82
+		add_action('wp_loaded', [$this, 'wp_loaded']);
83
+	}
84
+
85
+
86
+	/**
87
+	 * @return EEM_Registration
88
+	 * @throws InvalidArgumentException
89
+	 * @throws InvalidDataTypeException
90
+	 * @throws InvalidInterfaceException
91
+	 * @since 4.10.2.p
92
+	 */
93
+	protected function getRegistrationModel()
94
+	{
95
+		if (! $this->registration_model instanceof EEM_Registration) {
96
+			$this->registration_model = $this->getLoader()->getShared('EEM_Registration');
97
+		}
98
+		return $this->registration_model;
99
+	}
100
+
101
+
102
+	/**
103
+	 * @return EEM_Attendee
104
+	 * @throws InvalidArgumentException
105
+	 * @throws InvalidDataTypeException
106
+	 * @throws InvalidInterfaceException
107
+	 * @since 4.10.2.p
108
+	 */
109
+	protected function getAttendeeModel()
110
+	{
111
+		if (! $this->attendee_model instanceof EEM_Attendee) {
112
+			$this->attendee_model = $this->getLoader()->getShared('EEM_Attendee');
113
+		}
114
+		return $this->attendee_model;
115
+	}
116
+
117
+
118
+	/**
119
+	 * @return EEM_Event
120
+	 * @throws InvalidArgumentException
121
+	 * @throws InvalidDataTypeException
122
+	 * @throws InvalidInterfaceException
123
+	 * @since 4.10.2.p
124
+	 */
125
+	protected function getEventModel()
126
+	{
127
+		if (! $this->event_model instanceof EEM_Event) {
128
+			$this->event_model = $this->getLoader()->getShared('EEM_Event');
129
+		}
130
+		return $this->event_model;
131
+	}
132
+
133
+
134
+	/**
135
+	 * @return EEM_Status
136
+	 * @throws InvalidArgumentException
137
+	 * @throws InvalidDataTypeException
138
+	 * @throws InvalidInterfaceException
139
+	 * @since 4.10.2.p
140
+	 */
141
+	protected function getStatusModel()
142
+	{
143
+		if (! $this->status_model instanceof EEM_Status) {
144
+			$this->status_model = $this->getLoader()->getShared('EEM_Status');
145
+		}
146
+		return $this->status_model;
147
+	}
148
+
149
+
150
+	public function wp_loaded()
151
+	{
152
+		// when adding a new registration...
153
+		$action = $this->request->getRequestParam('action');
154
+		if ($action === 'new_registration') {
155
+			EE_System::do_not_cache();
156
+			if ($this->request->getRequestParam('processing_registration', 0, 'int') !== 1) {
157
+				// and it's NOT the attendee information reg step
158
+				// force cookie expiration by setting time to last week
159
+				setcookie('ee_registration_added', 0, time() - WEEK_IN_SECONDS, '/');
160
+				// and update the global
161
+				$_COOKIE['ee_registration_added'] = 0;
162
+			}
163
+		}
164
+	}
165
+
166
+
167
+	protected function _init_page_props()
168
+	{
169
+		$this->page_slug        = REG_PG_SLUG;
170
+		$this->_admin_base_url  = REG_ADMIN_URL;
171
+		$this->_admin_base_path = REG_ADMIN;
172
+		$this->page_label       = esc_html__('Registrations', 'event_espresso');
173
+		$this->_cpt_routes      = [
174
+			'add_new_attendee' => 'espresso_attendees',
175
+			'edit_attendee'    => 'espresso_attendees',
176
+			'insert_attendee'  => 'espresso_attendees',
177
+			'update_attendee'  => 'espresso_attendees',
178
+		];
179
+		$this->_cpt_model_names = [
180
+			'add_new_attendee' => 'EEM_Attendee',
181
+			'edit_attendee'    => 'EEM_Attendee',
182
+		];
183
+		$this->_cpt_edit_routes = [
184
+			'espresso_attendees' => 'edit_attendee',
185
+		];
186
+		$this->_pagenow_map     = [
187
+			'add_new_attendee' => 'post-new.php',
188
+			'edit_attendee'    => 'post.php',
189
+			'trash'            => 'post.php',
190
+		];
191
+		add_action('edit_form_after_title', [$this, 'after_title_form_fields'], 10);
192
+		// add filters so that the comment urls don't take users to a confusing 404 page
193
+		add_filter('get_comment_link', [$this, 'clear_comment_link'], 10, 2);
194
+	}
195
+
196
+
197
+	/**
198
+	 * @param string     $link    The comment permalink with '#comment-$id' appended.
199
+	 * @param WP_Comment $comment The current comment object.
200
+	 * @return string
201
+	 */
202
+	public function clear_comment_link($link, WP_Comment $comment)
203
+	{
204
+		// gotta make sure this only happens on this route
205
+		$post_type = get_post_type($comment->comment_post_ID);
206
+		if ($post_type === 'espresso_attendees') {
207
+			return '#commentsdiv';
208
+		}
209
+		return $link;
210
+	}
211
+
212
+
213
+	protected function _ajax_hooks()
214
+	{
215
+		// todo: all hooks for registrations ajax goes in here
216
+		add_action('wp_ajax_toggle_checkin_status', [$this, 'toggle_checkin_status']);
217
+	}
218
+
219
+
220
+	protected function _define_page_props()
221
+	{
222
+		$this->_admin_page_title = $this->page_label;
223
+		$this->_labels           = [
224
+			'buttons'                      => [
225
+				'add-registrant'      => esc_html__('Add New Registration', 'event_espresso'),
226
+				'add-attendee'        => esc_html__('Add Contact', 'event_espresso'),
227
+				'edit'                => esc_html__('Edit Contact', 'event_espresso'),
228
+				'report'              => esc_html__('Event Registrations CSV Report', 'event_espresso'),
229
+				'report_all'          => esc_html__('All Registrations CSV Report', 'event_espresso'),
230
+				'report_filtered'     => esc_html__('Filtered CSV Report', 'event_espresso'),
231
+				'contact_list_report' => esc_html__('Contact List Report', 'event_espresso'),
232
+				'contact_list_export' => esc_html__('Export Data', 'event_espresso'),
233
+			],
234
+			'publishbox'                   => [
235
+				'add_new_attendee' => esc_html__('Add Contact Record', 'event_espresso'),
236
+				'edit_attendee'    => esc_html__('Update Contact Record', 'event_espresso'),
237
+			],
238
+			'hide_add_button_on_cpt_route' => [
239
+				'edit_attendee' => true,
240
+			],
241
+		];
242
+	}
243
+
244
+
245
+	/**
246
+	 * grab url requests and route them
247
+	 *
248
+	 * @return void
249
+	 * @throws EE_Error
250
+	 */
251
+	public function _set_page_routes()
252
+	{
253
+		$this->_get_registration_status_array();
254
+		$REG_ID             = $this->request->getRequestParam('_REG_ID', 0, 'int');
255
+		$REG_ID             = $this->request->getRequestParam('reg_status_change_form[REG_ID]', $REG_ID, 'int');
256
+		$ATT_ID             = $this->request->getRequestParam('ATT_ID', 0, 'int');
257
+		$ATT_ID             = $this->request->getRequestParam('post', $ATT_ID, 'int');
258
+		$this->_page_routes = [
259
+			'default'                             => [
260
+				'func'       => '_registrations_overview_list_table',
261
+				'capability' => 'ee_read_registrations',
262
+			],
263
+			'view_registration'                   => [
264
+				'func'       => '_registration_details',
265
+				'capability' => 'ee_read_registration',
266
+				'obj_id'     => $REG_ID,
267
+			],
268
+			'edit_registration'                   => [
269
+				'func'               => '_update_attendee_registration_form',
270
+				'noheader'           => true,
271
+				'headers_sent_route' => 'view_registration',
272
+				'capability'         => 'ee_edit_registration',
273
+				'obj_id'             => $REG_ID,
274
+				'_REG_ID'            => $REG_ID,
275
+			],
276
+			'trash_registrations'                 => [
277
+				'func'       => '_trash_or_restore_registrations',
278
+				'args'       => ['trash' => true],
279
+				'noheader'   => true,
280
+				'capability' => 'ee_delete_registrations',
281
+			],
282
+			'restore_registrations'               => [
283
+				'func'       => '_trash_or_restore_registrations',
284
+				'args'       => ['trash' => false],
285
+				'noheader'   => true,
286
+				'capability' => 'ee_delete_registrations',
287
+			],
288
+			'delete_registrations'                => [
289
+				'func'       => '_delete_registrations',
290
+				'noheader'   => true,
291
+				'capability' => 'ee_delete_registrations',
292
+			],
293
+			'new_registration'                    => [
294
+				'func'       => 'new_registration',
295
+				'capability' => 'ee_edit_registrations',
296
+			],
297
+			'process_reg_step'                    => [
298
+				'func'       => 'process_reg_step',
299
+				'noheader'   => true,
300
+				'capability' => 'ee_edit_registrations',
301
+			],
302
+			'redirect_to_txn'                     => [
303
+				'func'       => 'redirect_to_txn',
304
+				'noheader'   => true,
305
+				'capability' => 'ee_edit_registrations',
306
+			],
307
+			'change_reg_status'                   => [
308
+				'func'       => '_change_reg_status',
309
+				'noheader'   => true,
310
+				'capability' => 'ee_edit_registration',
311
+				'obj_id'     => $REG_ID,
312
+			],
313
+			'approve_registration'                => [
314
+				'func'       => 'approve_registration',
315
+				'noheader'   => true,
316
+				'capability' => 'ee_edit_registration',
317
+				'obj_id'     => $REG_ID,
318
+			],
319
+			'approve_and_notify_registration'     => [
320
+				'func'       => 'approve_registration',
321
+				'noheader'   => true,
322
+				'args'       => [true],
323
+				'capability' => 'ee_edit_registration',
324
+				'obj_id'     => $REG_ID,
325
+			],
326
+			'approve_registrations'               => [
327
+				'func'       => 'bulk_action_on_registrations',
328
+				'noheader'   => true,
329
+				'capability' => 'ee_edit_registrations',
330
+				'args'       => ['approve'],
331
+			],
332
+			'approve_and_notify_registrations'    => [
333
+				'func'       => 'bulk_action_on_registrations',
334
+				'noheader'   => true,
335
+				'capability' => 'ee_edit_registrations',
336
+				'args'       => ['approve', true],
337
+			],
338
+			'decline_registration'                => [
339
+				'func'       => 'decline_registration',
340
+				'noheader'   => true,
341
+				'capability' => 'ee_edit_registration',
342
+				'obj_id'     => $REG_ID,
343
+			],
344
+			'decline_and_notify_registration'     => [
345
+				'func'       => 'decline_registration',
346
+				'noheader'   => true,
347
+				'args'       => [true],
348
+				'capability' => 'ee_edit_registration',
349
+				'obj_id'     => $REG_ID,
350
+			],
351
+			'decline_registrations'               => [
352
+				'func'       => 'bulk_action_on_registrations',
353
+				'noheader'   => true,
354
+				'capability' => 'ee_edit_registrations',
355
+				'args'       => ['decline'],
356
+			],
357
+			'decline_and_notify_registrations'    => [
358
+				'func'       => 'bulk_action_on_registrations',
359
+				'noheader'   => true,
360
+				'capability' => 'ee_edit_registrations',
361
+				'args'       => ['decline', true],
362
+			],
363
+			'pending_registration'                => [
364
+				'func'       => 'pending_registration',
365
+				'noheader'   => true,
366
+				'capability' => 'ee_edit_registration',
367
+				'obj_id'     => $REG_ID,
368
+			],
369
+			'pending_and_notify_registration'     => [
370
+				'func'       => 'pending_registration',
371
+				'noheader'   => true,
372
+				'args'       => [true],
373
+				'capability' => 'ee_edit_registration',
374
+				'obj_id'     => $REG_ID,
375
+			],
376
+			'pending_registrations'               => [
377
+				'func'       => 'bulk_action_on_registrations',
378
+				'noheader'   => true,
379
+				'capability' => 'ee_edit_registrations',
380
+				'args'       => ['pending'],
381
+			],
382
+			'pending_and_notify_registrations'    => [
383
+				'func'       => 'bulk_action_on_registrations',
384
+				'noheader'   => true,
385
+				'capability' => 'ee_edit_registrations',
386
+				'args'       => ['pending', true],
387
+			],
388
+			'no_approve_registration'             => [
389
+				'func'       => 'not_approve_registration',
390
+				'noheader'   => true,
391
+				'capability' => 'ee_edit_registration',
392
+				'obj_id'     => $REG_ID,
393
+			],
394
+			'no_approve_and_notify_registration'  => [
395
+				'func'       => 'not_approve_registration',
396
+				'noheader'   => true,
397
+				'args'       => [true],
398
+				'capability' => 'ee_edit_registration',
399
+				'obj_id'     => $REG_ID,
400
+			],
401
+			'no_approve_registrations'            => [
402
+				'func'       => 'bulk_action_on_registrations',
403
+				'noheader'   => true,
404
+				'capability' => 'ee_edit_registrations',
405
+				'args'       => ['not_approve'],
406
+			],
407
+			'no_approve_and_notify_registrations' => [
408
+				'func'       => 'bulk_action_on_registrations',
409
+				'noheader'   => true,
410
+				'capability' => 'ee_edit_registrations',
411
+				'args'       => ['not_approve', true],
412
+			],
413
+			'cancel_registration'                 => [
414
+				'func'       => 'cancel_registration',
415
+				'noheader'   => true,
416
+				'capability' => 'ee_edit_registration',
417
+				'obj_id'     => $REG_ID,
418
+			],
419
+			'cancel_and_notify_registration'      => [
420
+				'func'       => 'cancel_registration',
421
+				'noheader'   => true,
422
+				'args'       => [true],
423
+				'capability' => 'ee_edit_registration',
424
+				'obj_id'     => $REG_ID,
425
+			],
426
+			'cancel_registrations'                => [
427
+				'func'       => 'bulk_action_on_registrations',
428
+				'noheader'   => true,
429
+				'capability' => 'ee_edit_registrations',
430
+				'args'       => ['cancel'],
431
+			],
432
+			'cancel_and_notify_registrations'     => [
433
+				'func'       => 'bulk_action_on_registrations',
434
+				'noheader'   => true,
435
+				'capability' => 'ee_edit_registrations',
436
+				'args'       => ['cancel', true],
437
+			],
438
+			'wait_list_registration'              => [
439
+				'func'       => 'wait_list_registration',
440
+				'noheader'   => true,
441
+				'capability' => 'ee_edit_registration',
442
+				'obj_id'     => $REG_ID,
443
+			],
444
+			'wait_list_and_notify_registration'   => [
445
+				'func'       => 'wait_list_registration',
446
+				'noheader'   => true,
447
+				'args'       => [true],
448
+				'capability' => 'ee_edit_registration',
449
+				'obj_id'     => $REG_ID,
450
+			],
451
+			'contact_list'                        => [
452
+				'func'       => '_attendee_contact_list_table',
453
+				'capability' => 'ee_read_contacts',
454
+			],
455
+			'add_new_attendee'                    => [
456
+				'func' => '_create_new_cpt_item',
457
+				'args' => [
458
+					'new_attendee' => true,
459
+					'capability'   => 'ee_edit_contacts',
460
+				],
461
+			],
462
+			'edit_attendee'                       => [
463
+				'func'       => '_edit_cpt_item',
464
+				'capability' => 'ee_edit_contacts',
465
+				'obj_id'     => $ATT_ID,
466
+			],
467
+			'duplicate_attendee'                  => [
468
+				'func'       => '_duplicate_attendee',
469
+				'noheader'   => true,
470
+				'capability' => 'ee_edit_contacts',
471
+				'obj_id'     => $ATT_ID,
472
+			],
473
+			'insert_attendee'                     => [
474
+				'func'       => '_insert_or_update_attendee',
475
+				'args'       => [
476
+					'new_attendee' => true,
477
+				],
478
+				'noheader'   => true,
479
+				'capability' => 'ee_edit_contacts',
480
+			],
481
+			'update_attendee'                     => [
482
+				'func'       => '_insert_or_update_attendee',
483
+				'args'       => [
484
+					'new_attendee' => false,
485
+				],
486
+				'noheader'   => true,
487
+				'capability' => 'ee_edit_contacts',
488
+				'obj_id'     => $ATT_ID,
489
+			],
490
+			'trash_attendees'                     => [
491
+				'func'       => '_trash_or_restore_attendees',
492
+				'args'       => [
493
+					'trash' => 'true',
494
+				],
495
+				'noheader'   => true,
496
+				'capability' => 'ee_delete_contacts',
497
+			],
498
+			'trash_attendee'                      => [
499
+				'func'       => '_trash_or_restore_attendees',
500
+				'args'       => [
501
+					'trash' => true,
502
+				],
503
+				'noheader'   => true,
504
+				'capability' => 'ee_delete_contacts',
505
+				'obj_id'     => $ATT_ID,
506
+			],
507
+			'restore_attendees'                   => [
508
+				'func'       => '_trash_or_restore_attendees',
509
+				'args'       => [
510
+					'trash' => false,
511
+				],
512
+				'noheader'   => true,
513
+				'capability' => 'ee_delete_contacts',
514
+				'obj_id'     => $ATT_ID,
515
+			],
516
+			'resend_registration'                 => [
517
+				'func'       => '_resend_registration',
518
+				'noheader'   => true,
519
+				'capability' => 'ee_send_message',
520
+			],
521
+			'registrations_report'                => [
522
+				'func'       => '_registrations_report',
523
+				'noheader'   => true,
524
+				'capability' => 'ee_read_registrations',
525
+			],
526
+			'contact_list_export'                 => [
527
+				'func'       => '_contact_list_export',
528
+				'noheader'   => true,
529
+				'capability' => 'export',
530
+			],
531
+			'contact_list_report'                 => [
532
+				'func'       => '_contact_list_report',
533
+				'noheader'   => true,
534
+				'capability' => 'ee_read_contacts',
535
+			],
536
+		];
537
+	}
538
+
539
+
540
+	protected function _set_page_config()
541
+	{
542
+		$REG_ID             = $this->request->getRequestParam('_REG_ID', 0, 'int');
543
+		$ATT_ID             = $this->request->getRequestParam('ATT_ID', 0, 'int');
544
+		$this->_page_config = [
545
+			'default'           => [
546
+				'nav'           => [
547
+					'label' => esc_html__('Overview', 'event_espresso'),
548
+					'order' => 5,
549
+				],
550
+				'help_tabs'     => [
551
+					'registrations_overview_help_tab'                       => [
552
+						'title'    => esc_html__('Registrations Overview', 'event_espresso'),
553
+						'filename' => 'registrations_overview',
554
+					],
555
+					'registrations_overview_table_column_headings_help_tab' => [
556
+						'title'    => esc_html__('Registrations Table Column Headings', 'event_espresso'),
557
+						'filename' => 'registrations_overview_table_column_headings',
558
+					],
559
+					'registrations_overview_filters_help_tab'               => [
560
+						'title'    => esc_html__('Registration Filters', 'event_espresso'),
561
+						'filename' => 'registrations_overview_filters',
562
+					],
563
+					'registrations_overview_views_help_tab'                 => [
564
+						'title'    => esc_html__('Registration Views', 'event_espresso'),
565
+						'filename' => 'registrations_overview_views',
566
+					],
567
+					'registrations_regoverview_other_help_tab'              => [
568
+						'title'    => esc_html__('Registrations Other', 'event_espresso'),
569
+						'filename' => 'registrations_overview_other',
570
+					],
571
+				],
572
+				'qtips'         => ['Registration_List_Table_Tips'],
573
+				'list_table'    => 'EE_Registrations_List_Table',
574
+				'require_nonce' => false,
575
+			],
576
+			'view_registration' => [
577
+				'nav'           => [
578
+					'label'      => esc_html__('REG Details', 'event_espresso'),
579
+					'order'      => 15,
580
+					'url'        => $REG_ID
581
+						? add_query_arg(['_REG_ID' => $REG_ID], $this->_current_page_view_url)
582
+						: $this->_admin_base_url,
583
+					'persistent' => false,
584
+				],
585
+				'help_tabs'     => [
586
+					'registrations_details_help_tab'                    => [
587
+						'title'    => esc_html__('Registration Details', 'event_espresso'),
588
+						'filename' => 'registrations_details',
589
+					],
590
+					'registrations_details_table_help_tab'              => [
591
+						'title'    => esc_html__('Registration Details Table', 'event_espresso'),
592
+						'filename' => 'registrations_details_table',
593
+					],
594
+					'registrations_details_form_answers_help_tab'       => [
595
+						'title'    => esc_html__('Registration Form Answers', 'event_espresso'),
596
+						'filename' => 'registrations_details_form_answers',
597
+					],
598
+					'registrations_details_registrant_details_help_tab' => [
599
+						'title'    => esc_html__('Contact Details', 'event_espresso'),
600
+						'filename' => 'registrations_details_registrant_details',
601
+					],
602
+				],
603
+				'metaboxes'     => array_merge(
604
+					$this->_default_espresso_metaboxes,
605
+					['_registration_details_metaboxes']
606
+				),
607
+				'require_nonce' => false,
608
+			],
609
+			'new_registration'  => [
610
+				'nav'           => [
611
+					'label'      => esc_html__('Add New Registration', 'event_espresso'),
612
+					'url'        => '#',
613
+					'order'      => 15,
614
+					'persistent' => false,
615
+				],
616
+				'metaboxes'     => $this->_default_espresso_metaboxes,
617
+				'labels'        => [
618
+					'publishbox' => esc_html__('Save Registration', 'event_espresso'),
619
+				],
620
+				'require_nonce' => false,
621
+			],
622
+			'add_new_attendee'  => [
623
+				'nav'           => [
624
+					'label'      => esc_html__('Add Contact', 'event_espresso'),
625
+					'order'      => 15,
626
+					'persistent' => false,
627
+				],
628
+				'metaboxes'     => array_merge(
629
+					$this->_default_espresso_metaboxes,
630
+					['_publish_post_box', 'attendee_editor_metaboxes']
631
+				),
632
+				'require_nonce' => false,
633
+			],
634
+			'edit_attendee'     => [
635
+				'nav'           => [
636
+					'label'      => esc_html__('Edit Contact', 'event_espresso'),
637
+					'order'      => 15,
638
+					'persistent' => false,
639
+					'url'        => $ATT_ID
640
+						? add_query_arg(['ATT_ID' => $ATT_ID], $this->_current_page_view_url)
641
+						: $this->_admin_base_url,
642
+				],
643
+				'metaboxes'     => ['attendee_editor_metaboxes'],
644
+				'require_nonce' => false,
645
+			],
646
+			'contact_list'      => [
647
+				'nav'           => [
648
+					'label' => esc_html__('Contact List', 'event_espresso'),
649
+					'order' => 20,
650
+				],
651
+				'list_table'    => 'EE_Attendee_Contact_List_Table',
652
+				'help_tabs'     => [
653
+					'registrations_contact_list_help_tab'                       => [
654
+						'title'    => esc_html__('Registrations Contact List', 'event_espresso'),
655
+						'filename' => 'registrations_contact_list',
656
+					],
657
+					'registrations_contact-list_table_column_headings_help_tab' => [
658
+						'title'    => esc_html__('Contact List Table Column Headings', 'event_espresso'),
659
+						'filename' => 'registrations_contact_list_table_column_headings',
660
+					],
661
+					'registrations_contact_list_views_help_tab'                 => [
662
+						'title'    => esc_html__('Contact List Views', 'event_espresso'),
663
+						'filename' => 'registrations_contact_list_views',
664
+					],
665
+					'registrations_contact_list_other_help_tab'                 => [
666
+						'title'    => esc_html__('Contact List Other', 'event_espresso'),
667
+						'filename' => 'registrations_contact_list_other',
668
+					],
669
+				],
670
+				'metaboxes'     => [],
671
+				'require_nonce' => false,
672
+			],
673
+			// override default cpt routes
674
+			'create_new'        => '',
675
+			'edit'              => '',
676
+		];
677
+	}
678
+
679
+
680
+	/**
681
+	 * The below methods aren't used by this class currently
682
+	 */
683
+	protected function _add_screen_options()
684
+	{
685
+	}
686
+
687
+
688
+	protected function _add_feature_pointers()
689
+	{
690
+	}
691
+
692
+
693
+	public function admin_init()
694
+	{
695
+		EE_Registry::$i18n_js_strings['update_att_qstns'] = esc_html__(
696
+			'click "Update Registration Questions" to save your changes',
697
+			'event_espresso'
698
+		);
699
+	}
700
+
701
+
702
+	public function admin_notices()
703
+	{
704
+	}
705
+
706
+
707
+	public function admin_footer_scripts()
708
+	{
709
+	}
710
+
711
+
712
+	/**
713
+	 * get list of registration statuses
714
+	 *
715
+	 * @return void
716
+	 * @throws EE_Error
717
+	 */
718
+	private function _get_registration_status_array()
719
+	{
720
+		self::$_reg_status = EEM_Registration::reg_status_array([], true);
721
+	}
722
+
723
+
724
+	/**
725
+	 * @throws InvalidArgumentException
726
+	 * @throws InvalidDataTypeException
727
+	 * @throws InvalidInterfaceException
728
+	 * @since 4.10.2.p
729
+	 */
730
+	protected function _add_screen_options_default()
731
+	{
732
+		$this->_per_page_screen_option();
733
+	}
734
+
735
+
736
+	/**
737
+	 * @throws InvalidArgumentException
738
+	 * @throws InvalidDataTypeException
739
+	 * @throws InvalidInterfaceException
740
+	 * @since 4.10.2.p
741
+	 */
742
+	protected function _add_screen_options_contact_list()
743
+	{
744
+		$page_title              = $this->_admin_page_title;
745
+		$this->_admin_page_title = esc_html__('Contacts', 'event_espresso');
746
+		$this->_per_page_screen_option();
747
+		$this->_admin_page_title = $page_title;
748
+	}
749
+
750
+
751
+	public function load_scripts_styles()
752
+	{
753
+		// style
754
+		wp_register_style(
755
+			'espresso_reg',
756
+			REG_ASSETS_URL . 'espresso_registrations_admin.css',
757
+			['ee-admin-css'],
758
+			EVENT_ESPRESSO_VERSION
759
+		);
760
+		wp_enqueue_style('espresso_reg');
761
+		// script
762
+		wp_register_script(
763
+			'espresso_reg',
764
+			REG_ASSETS_URL . 'espresso_registrations_admin.js',
765
+			['jquery-ui-datepicker', 'jquery-ui-draggable', 'ee_admin_js'],
766
+			EVENT_ESPRESSO_VERSION,
767
+			true
768
+		);
769
+		wp_enqueue_script('espresso_reg');
770
+	}
771
+
772
+
773
+	/**
774
+	 * @throws EE_Error
775
+	 * @throws InvalidArgumentException
776
+	 * @throws InvalidDataTypeException
777
+	 * @throws InvalidInterfaceException
778
+	 * @throws ReflectionException
779
+	 * @since 4.10.2.p
780
+	 */
781
+	public function load_scripts_styles_edit_attendee()
782
+	{
783
+		// stuff to only show up on our attendee edit details page.
784
+		$attendee_details_translations = [
785
+			'att_publish_text' => sprintf(
786
+			/* translators: The date and time */
787
+				wp_strip_all_tags(__('Created on: %s', 'event_espresso')),
788
+				'<b>' . $this->_cpt_model_obj->get_datetime('ATT_created') . '</b>'
789
+			),
790
+		];
791
+		wp_localize_script('espresso_reg', 'ATTENDEE_DETAILS', $attendee_details_translations);
792
+		wp_enqueue_script('jquery-validate');
793
+	}
794
+
795
+
796
+	/**
797
+	 * @throws EE_Error
798
+	 * @throws InvalidArgumentException
799
+	 * @throws InvalidDataTypeException
800
+	 * @throws InvalidInterfaceException
801
+	 * @throws ReflectionException
802
+	 * @since 4.10.2.p
803
+	 */
804
+	public function load_scripts_styles_view_registration()
805
+	{
806
+		// styles
807
+		wp_enqueue_style('espresso-ui-theme');
808
+		// scripts
809
+		$this->_get_reg_custom_questions_form($this->_registration->ID());
810
+		$this->_reg_custom_questions_form->wp_enqueue_scripts();
811
+	}
812
+
813
+
814
+	public function load_scripts_styles_contact_list()
815
+	{
816
+		wp_dequeue_style('espresso_reg');
817
+		wp_register_style(
818
+			'espresso_att',
819
+			REG_ASSETS_URL . 'espresso_attendees_admin.css',
820
+			['ee-admin-css'],
821
+			EVENT_ESPRESSO_VERSION
822
+		);
823
+		wp_enqueue_style('espresso_att');
824
+	}
825
+
826
+
827
+	public function load_scripts_styles_new_registration()
828
+	{
829
+		wp_register_script(
830
+			'ee-spco-for-admin',
831
+			REG_ASSETS_URL . 'spco_for_admin.js',
832
+			['underscore', 'jquery'],
833
+			EVENT_ESPRESSO_VERSION,
834
+			true
835
+		);
836
+		wp_enqueue_script('ee-spco-for-admin');
837
+		add_filter('FHEE__EED_Ticket_Selector__load_tckt_slctr_assets', '__return_true');
838
+		EE_Form_Section_Proper::wp_enqueue_scripts();
839
+		EED_Ticket_Selector::load_tckt_slctr_assets();
840
+		EE_Datepicker_Input::enqueue_styles_and_scripts();
841
+	}
842
+
843
+
844
+	public function AHEE__EE_Admin_Page__route_admin_request_resend_registration()
845
+	{
846
+		add_filter('FHEE_load_EE_messages', '__return_true');
847
+	}
848
+
849
+
850
+	public function AHEE__EE_Admin_Page__route_admin_request_approve_registration()
851
+	{
852
+		add_filter('FHEE_load_EE_messages', '__return_true');
853
+	}
854
+
855
+
856
+	/**
857
+	 * @throws EE_Error
858
+	 * @throws InvalidArgumentException
859
+	 * @throws InvalidDataTypeException
860
+	 * @throws InvalidInterfaceException
861
+	 * @throws ReflectionException
862
+	 * @since 4.10.2.p
863
+	 */
864
+	protected function _set_list_table_views_default()
865
+	{
866
+		// for notification related bulk actions we need to make sure only active messengers have an option.
867
+		EED_Messages::set_autoloaders();
868
+		/** @type EE_Message_Resource_Manager $message_resource_manager */
869
+		$message_resource_manager = EE_Registry::instance()->load_lib('Message_Resource_Manager');
870
+		$active_mts               = $message_resource_manager->list_of_active_message_types();
871
+		// key= bulk_action_slug, value= message type.
872
+		$match_array = [
873
+			'approve_registrations'    => 'registration',
874
+			'decline_registrations'    => 'declined_registration',
875
+			'pending_registrations'    => 'pending_approval',
876
+			'no_approve_registrations' => 'not_approved_registration',
877
+			'cancel_registrations'     => 'cancelled_registration',
878
+		];
879
+		$can_send    = EE_Registry::instance()->CAP->current_user_can(
880
+			'ee_send_message',
881
+			'batch_send_messages'
882
+		);
883
+		/** setup reg status bulk actions **/
884
+		$def_reg_status_actions['approve_registrations'] = esc_html__('Approve Registrations', 'event_espresso');
885
+		if ($can_send && in_array($match_array['approve_registrations'], $active_mts, true)) {
886
+			$def_reg_status_actions['approve_and_notify_registrations'] = esc_html__(
887
+				'Approve and Notify Registrations',
888
+				'event_espresso'
889
+			);
890
+		}
891
+		$def_reg_status_actions['decline_registrations'] = esc_html__('Decline Registrations', 'event_espresso');
892
+		if ($can_send && in_array($match_array['decline_registrations'], $active_mts, true)) {
893
+			$def_reg_status_actions['decline_and_notify_registrations'] = esc_html__(
894
+				'Decline and Notify Registrations',
895
+				'event_espresso'
896
+			);
897
+		}
898
+		$def_reg_status_actions['pending_registrations'] = esc_html__(
899
+			'Set Registrations to Pending Payment',
900
+			'event_espresso'
901
+		);
902
+		if ($can_send && in_array($match_array['pending_registrations'], $active_mts, true)) {
903
+			$def_reg_status_actions['pending_and_notify_registrations'] = esc_html__(
904
+				'Set Registrations to Pending Payment and Notify',
905
+				'event_espresso'
906
+			);
907
+		}
908
+		$def_reg_status_actions['no_approve_registrations'] = esc_html__(
909
+			'Set Registrations to Not Approved',
910
+			'event_espresso'
911
+		);
912
+		if ($can_send && in_array($match_array['no_approve_registrations'], $active_mts, true)) {
913
+			$def_reg_status_actions['no_approve_and_notify_registrations'] = esc_html__(
914
+				'Set Registrations to Not Approved and Notify',
915
+				'event_espresso'
916
+			);
917
+		}
918
+		$def_reg_status_actions['cancel_registrations'] = esc_html__('Cancel Registrations', 'event_espresso');
919
+		if ($can_send && in_array($match_array['cancel_registrations'], $active_mts, true)) {
920
+			$def_reg_status_actions['cancel_and_notify_registrations'] = esc_html__(
921
+				'Cancel Registrations and Notify',
922
+				'event_espresso'
923
+			);
924
+		}
925
+		$def_reg_status_actions = apply_filters(
926
+			'FHEE__Registrations_Admin_Page___set_list_table_views_default__def_reg_status_actions_array',
927
+			$def_reg_status_actions,
928
+			$active_mts,
929
+			$can_send
930
+		);
931
+
932
+		$this->_views = [
933
+			'all'   => [
934
+				'slug'        => 'all',
935
+				'label'       => esc_html__('View All Registrations', 'event_espresso'),
936
+				'count'       => 0,
937
+				'bulk_action' => array_merge(
938
+					$def_reg_status_actions,
939
+					[
940
+						'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
941
+					]
942
+				),
943
+			],
944
+			'month' => [
945
+				'slug'        => 'month',
946
+				'label'       => esc_html__('This Month', 'event_espresso'),
947
+				'count'       => 0,
948
+				'bulk_action' => array_merge(
949
+					$def_reg_status_actions,
950
+					[
951
+						'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
952
+					]
953
+				),
954
+			],
955
+			'today' => [
956
+				'slug'        => 'today',
957
+				'label'       => sprintf(
958
+					esc_html__('Today - %s', 'event_espresso'),
959
+					date('M d, Y', current_time('timestamp'))
960
+				),
961
+				'count'       => 0,
962
+				'bulk_action' => array_merge(
963
+					$def_reg_status_actions,
964
+					[
965
+						'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
966
+					]
967
+				),
968
+			],
969
+		];
970
+		if (
971
+			EE_Registry::instance()->CAP->current_user_can(
972
+				'ee_delete_registrations',
973
+				'espresso_registrations_delete_registration'
974
+			)
975
+		) {
976
+			$this->_views['incomplete'] = [
977
+				'slug'        => 'incomplete',
978
+				'label'       => esc_html__('Incomplete', 'event_espresso'),
979
+				'count'       => 0,
980
+				'bulk_action' => [
981
+					'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
982
+				],
983
+			];
984
+			$this->_views['trash']      = [
985
+				'slug'        => 'trash',
986
+				'label'       => esc_html__('Trash', 'event_espresso'),
987
+				'count'       => 0,
988
+				'bulk_action' => [
989
+					'restore_registrations' => esc_html__('Restore Registrations', 'event_espresso'),
990
+					'delete_registrations'  => esc_html__('Delete Registrations Permanently', 'event_espresso'),
991
+				],
992
+			];
993
+		}
994
+	}
995
+
996
+
997
+	protected function _set_list_table_views_contact_list()
998
+	{
999
+		$this->_views = [
1000
+			'in_use' => [
1001
+				'slug'        => 'in_use',
1002
+				'label'       => esc_html__('In Use', 'event_espresso'),
1003
+				'count'       => 0,
1004
+				'bulk_action' => [
1005
+					'trash_attendees' => esc_html__('Move to Trash', 'event_espresso'),
1006
+				],
1007
+			],
1008
+		];
1009
+		if (
1010
+			EE_Registry::instance()->CAP->current_user_can(
1011
+				'ee_delete_contacts',
1012
+				'espresso_registrations_trash_attendees'
1013
+			)
1014
+		) {
1015
+			$this->_views['trash'] = [
1016
+				'slug'        => 'trash',
1017
+				'label'       => esc_html__('Trash', 'event_espresso'),
1018
+				'count'       => 0,
1019
+				'bulk_action' => [
1020
+					'restore_attendees' => esc_html__('Restore from Trash', 'event_espresso'),
1021
+				],
1022
+			];
1023
+		}
1024
+	}
1025
+
1026
+
1027
+	/**
1028
+	 * @return array
1029
+	 * @throws EE_Error
1030
+	 */
1031
+	protected function _registration_legend_items()
1032
+	{
1033
+		$fc_items = [
1034
+			'star-icon'        => [
1035
+				'class' => 'dashicons dashicons-star-filled lt-blue-icon ee-icon-size-8',
1036
+				'desc'  => esc_html__('This is the Primary Registrant', 'event_espresso'),
1037
+			],
1038
+			'view_details'     => [
1039
+				'class' => 'dashicons dashicons-clipboard',
1040
+				'desc'  => esc_html__('View Registration Details', 'event_espresso'),
1041
+			],
1042
+			'edit_attendee'    => [
1043
+				'class' => 'ee-icon ee-icon-user-edit ee-icon-size-16',
1044
+				'desc'  => esc_html__('Edit Contact Details', 'event_espresso'),
1045
+			],
1046
+			'view_transaction' => [
1047
+				'class' => 'dashicons dashicons-cart',
1048
+				'desc'  => esc_html__('View Transaction Details', 'event_espresso'),
1049
+			],
1050
+			'view_invoice'     => [
1051
+				'class' => 'dashicons dashicons-media-spreadsheet',
1052
+				'desc'  => esc_html__('View Transaction Invoice', 'event_espresso'),
1053
+			],
1054
+		];
1055
+		if (
1056
+			EE_Registry::instance()->CAP->current_user_can(
1057
+				'ee_send_message',
1058
+				'espresso_registrations_resend_registration'
1059
+			)
1060
+		) {
1061
+			$fc_items['resend_registration'] = [
1062
+				'class' => 'dashicons dashicons-email-alt',
1063
+				'desc'  => esc_html__('Resend Registration Details', 'event_espresso'),
1064
+			];
1065
+		} else {
1066
+			$fc_items['blank'] = ['class' => 'blank', 'desc' => ''];
1067
+		}
1068
+		if (
1069
+			EE_Registry::instance()->CAP->current_user_can(
1070
+				'ee_read_global_messages',
1071
+				'view_filtered_messages'
1072
+			)
1073
+		) {
1074
+			$related_for_icon = EEH_MSG_Template::get_message_action_icon('see_notifications_for');
1075
+			if (is_array($related_for_icon) && isset($related_for_icon['css_class'], $related_for_icon['label'])) {
1076
+				$fc_items['view_related_messages'] = [
1077
+					'class' => $related_for_icon['css_class'],
1078
+					'desc'  => $related_for_icon['label'],
1079
+				];
1080
+			}
1081
+		}
1082
+		$sc_items = [
1083
+			'approved_status'   => [
1084
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_approved,
1085
+				'desc'  => EEH_Template::pretty_status(
1086
+					EEM_Registration::status_id_approved,
1087
+					false,
1088
+					'sentence'
1089
+				),
1090
+			],
1091
+			'pending_status'    => [
1092
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_pending_payment,
1093
+				'desc'  => EEH_Template::pretty_status(
1094
+					EEM_Registration::status_id_pending_payment,
1095
+					false,
1096
+					'sentence'
1097
+				),
1098
+			],
1099
+			'wait_list'         => [
1100
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_wait_list,
1101
+				'desc'  => EEH_Template::pretty_status(
1102
+					EEM_Registration::status_id_wait_list,
1103
+					false,
1104
+					'sentence'
1105
+				),
1106
+			],
1107
+			'incomplete_status' => [
1108
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_incomplete,
1109
+				'desc'  => EEH_Template::pretty_status(
1110
+					EEM_Registration::status_id_incomplete,
1111
+					false,
1112
+					'sentence'
1113
+				),
1114
+			],
1115
+			'not_approved'      => [
1116
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_not_approved,
1117
+				'desc'  => EEH_Template::pretty_status(
1118
+					EEM_Registration::status_id_not_approved,
1119
+					false,
1120
+					'sentence'
1121
+				),
1122
+			],
1123
+			'declined_status'   => [
1124
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_declined,
1125
+				'desc'  => EEH_Template::pretty_status(
1126
+					EEM_Registration::status_id_declined,
1127
+					false,
1128
+					'sentence'
1129
+				),
1130
+			],
1131
+			'cancelled_status'  => [
1132
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_cancelled,
1133
+				'desc'  => EEH_Template::pretty_status(
1134
+					EEM_Registration::status_id_cancelled,
1135
+					false,
1136
+					'sentence'
1137
+				),
1138
+			],
1139
+		];
1140
+		return array_merge($fc_items, $sc_items);
1141
+	}
1142
+
1143
+
1144
+
1145
+	/***************************************        REGISTRATION OVERVIEW        **************************************/
1146
+
1147
+
1148
+	/**
1149
+	 * @throws DomainException
1150
+	 * @throws EE_Error
1151
+	 * @throws InvalidArgumentException
1152
+	 * @throws InvalidDataTypeException
1153
+	 * @throws InvalidInterfaceException
1154
+	 */
1155
+	protected function _registrations_overview_list_table()
1156
+	{
1157
+		$this->appendAddNewRegistrationButtonToPageTitle();
1158
+		$header_text                  = '';
1159
+		$admin_page_header_decorators = [
1160
+			'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\AttendeeFilterHeader',
1161
+			'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\EventFilterHeader',
1162
+			'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\DateFilterHeader',
1163
+			'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\TicketFilterHeader',
1164
+		];
1165
+		foreach ($admin_page_header_decorators as $admin_page_header_decorator) {
1166
+			$filter_header_decorator = $this->getLoader()->getNew($admin_page_header_decorator);
1167
+			$header_text             = $filter_header_decorator->getHeaderText($header_text);
1168
+		}
1169
+		$this->_template_args['admin_page_header'] = $header_text;
1170
+		$this->_template_args['after_list_table']  = $this->_display_legend($this->_registration_legend_items());
1171
+		$this->display_admin_list_table_page_with_no_sidebar();
1172
+	}
1173
+
1174
+
1175
+	/**
1176
+	 * @throws EE_Error
1177
+	 * @throws InvalidArgumentException
1178
+	 * @throws InvalidDataTypeException
1179
+	 * @throws InvalidInterfaceException
1180
+	 */
1181
+	private function appendAddNewRegistrationButtonToPageTitle()
1182
+	{
1183
+		$EVT_ID = $this->request->getRequestParam('event_id', 0, 'int');
1184
+		if (
1185
+			$EVT_ID
1186
+			&& EE_Registry::instance()->CAP->current_user_can(
1187
+				'ee_edit_registrations',
1188
+				'espresso_registrations_new_registration',
1189
+				$EVT_ID
1190
+			)
1191
+		) {
1192
+			$this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
1193
+				'new_registration',
1194
+				'add-registrant',
1195
+				['event_id' => $EVT_ID],
1196
+				'add-new-h2'
1197
+			);
1198
+		}
1199
+	}
1200
+
1201
+
1202
+	/**
1203
+	 * This sets the _registration property for the registration details screen
1204
+	 *
1205
+	 * @return void
1206
+	 * @throws EE_Error
1207
+	 * @throws InvalidArgumentException
1208
+	 * @throws InvalidDataTypeException
1209
+	 * @throws InvalidInterfaceException
1210
+	 */
1211
+	private function _set_registration_object()
1212
+	{
1213
+		// get out if we've already set the object
1214
+		if ($this->_registration instanceof EE_Registration) {
1215
+			return;
1216
+		}
1217
+		$REG_ID = $this->request->getRequestParam('_REG_ID', 0, 'int');
1218
+		if ($this->_registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID)) {
1219
+			return;
1220
+		}
1221
+		$error_msg = sprintf(
1222
+			esc_html__(
1223
+				'An error occurred and the details for Registration ID #%s could not be retrieved.',
1224
+				'event_espresso'
1225
+			),
1226
+			$REG_ID
1227
+		);
1228
+		EE_Error::add_error($error_msg, __FILE__, __FUNCTION__, __LINE__);
1229
+		$this->_registration = null;
1230
+	}
1231
+
1232
+
1233
+	/**
1234
+	 * Used to retrieve registrations for the list table.
1235
+	 *
1236
+	 * @param int  $per_page
1237
+	 * @param bool $count
1238
+	 * @param bool $this_month
1239
+	 * @param bool $today
1240
+	 * @return EE_Registration[]|int
1241
+	 * @throws EE_Error
1242
+	 * @throws InvalidArgumentException
1243
+	 * @throws InvalidDataTypeException
1244
+	 * @throws InvalidInterfaceException
1245
+	 */
1246
+	public function get_registrations(
1247
+		$per_page = 10,
1248
+		$count = false,
1249
+		$this_month = false,
1250
+		$today = false
1251
+	) {
1252
+		if ($this_month) {
1253
+			$this->request->setRequestParam('status', 'month');
1254
+		}
1255
+		if ($today) {
1256
+			$this->request->setRequestParam('status', 'today');
1257
+		}
1258
+		$query_params = $this->_get_registration_query_parameters($this->request->requestParams(), $per_page, $count);
1259
+		/**
1260
+		 * Override the default groupby added by EEM_Base so that sorts with multiple order bys work as expected
1261
+		 *
1262
+		 * @link https://events.codebasehq.com/projects/event-espresso/tickets/10093
1263
+		 * @see  https://github.com/eventespresso/event-espresso-core/tree/master/docs/G--Model-System/model-query-params.md
1264
+		 *                      or if you have the development copy of EE you can view this at the path:
1265
+		 *                      /docs/G--Model-System/model-query-params.md
1266
+		 */
1267
+		$query_params['group_by'] = '';
1268
+
1269
+		return $count
1270
+			? $this->getRegistrationModel()->count($query_params)
1271
+			/** @type EE_Registration[] */
1272
+			: $this->getRegistrationModel()->get_all($query_params);
1273
+	}
1274
+
1275
+
1276
+	/**
1277
+	 * Retrieves the query parameters to be used by the Registration model for getting registrations.
1278
+	 * Note: this listens to values on the request for some of the query parameters.
1279
+	 *
1280
+	 * @param array $request
1281
+	 * @param int   $per_page
1282
+	 * @param bool  $count
1283
+	 * @return array
1284
+	 * @throws EE_Error
1285
+	 * @throws InvalidArgumentException
1286
+	 * @throws InvalidDataTypeException
1287
+	 * @throws InvalidInterfaceException
1288
+	 */
1289
+	protected function _get_registration_query_parameters(
1290
+		$request = [],
1291
+		$per_page = 10,
1292
+		$count = false
1293
+	) {
1294
+		/** @var EventEspresso\core\domain\services\admin\registrations\list_table\QueryBuilder $list_table_query_builder */
1295
+		$list_table_query_builder = $this->getLoader()->getNew(
1296
+			'EventEspresso\core\domain\services\admin\registrations\list_table\QueryBuilder',
1297
+			[null, null, $request]
1298
+		);
1299
+		return $list_table_query_builder->getQueryParams($per_page, $count);
1300
+	}
1301
+
1302
+
1303
+	public function get_registration_status_array()
1304
+	{
1305
+		return self::$_reg_status;
1306
+	}
1307
+
1308
+
1309
+
1310
+
1311
+	/***************************************        REGISTRATION DETAILS        ***************************************/
1312
+	/**
1313
+	 * generates HTML for the View Registration Details Admin page
1314
+	 *
1315
+	 * @return void
1316
+	 * @throws DomainException
1317
+	 * @throws EE_Error
1318
+	 * @throws InvalidArgumentException
1319
+	 * @throws InvalidDataTypeException
1320
+	 * @throws InvalidInterfaceException
1321
+	 * @throws EntityNotFoundException
1322
+	 * @throws ReflectionException
1323
+	 */
1324
+	protected function _registration_details()
1325
+	{
1326
+		$this->_template_args = [];
1327
+		$this->_set_registration_object();
1328
+		if (is_object($this->_registration)) {
1329
+			$transaction                                   = $this->_registration->transaction()
1330
+				? $this->_registration->transaction()
1331
+				: EE_Transaction::new_instance();
1332
+			$this->_session                                = $transaction->session_data();
1333
+			$event_id                                      = $this->_registration->event_ID();
1334
+			$this->_template_args['reg_nmbr']['value']     = $this->_registration->ID();
1335
+			$this->_template_args['reg_nmbr']['label']     = esc_html__('Registration Number', 'event_espresso');
1336
+			$this->_template_args['reg_datetime']['value'] = $this->_registration->get_i18n_datetime('REG_date');
1337
+			$this->_template_args['reg_datetime']['label'] = esc_html__('Date', 'event_espresso');
1338
+			$this->_template_args['grand_total']           = $transaction->total();
1339
+			$this->_template_args['currency_sign']         = EE_Registry::instance()->CFG->currency->sign;
1340
+			// link back to overview
1341
+			$this->_template_args['reg_overview_url']            = REG_ADMIN_URL;
1342
+			$this->_template_args['registration']                = $this->_registration;
1343
+			$this->_template_args['filtered_registrations_link'] = EE_Admin_Page::add_query_args_and_nonce(
1344
+				[
1345
+					'action'   => 'default',
1346
+					'event_id' => $event_id,
1347
+				],
1348
+				REG_ADMIN_URL
1349
+			);
1350
+			$this->_template_args['filtered_transactions_link']  = EE_Admin_Page::add_query_args_and_nonce(
1351
+				[
1352
+					'action' => 'default',
1353
+					'EVT_ID' => $event_id,
1354
+					'page'   => 'espresso_transactions',
1355
+				],
1356
+				admin_url('admin.php')
1357
+			);
1358
+			$this->_template_args['event_link']                  = EE_Admin_Page::add_query_args_and_nonce(
1359
+				[
1360
+					'page'   => 'espresso_events',
1361
+					'action' => 'edit',
1362
+					'post'   => $event_id,
1363
+				],
1364
+				admin_url('admin.php')
1365
+			);
1366
+			// next and previous links
1367
+			$next_reg                                      = $this->_registration->next(
1368
+				null,
1369
+				[],
1370
+				'REG_ID'
1371
+			);
1372
+			$this->_template_args['next_registration']     = $next_reg
1373
+				? $this->_next_link(
1374
+					EE_Admin_Page::add_query_args_and_nonce(
1375
+						[
1376
+							'action'  => 'view_registration',
1377
+							'_REG_ID' => $next_reg['REG_ID'],
1378
+						],
1379
+						REG_ADMIN_URL
1380
+					),
1381
+					'dashicons dashicons-arrow-right ee-icon-size-22'
1382
+				)
1383
+				: '';
1384
+			$previous_reg                                  = $this->_registration->previous(
1385
+				null,
1386
+				[],
1387
+				'REG_ID'
1388
+			);
1389
+			$this->_template_args['previous_registration'] = $previous_reg
1390
+				? $this->_previous_link(
1391
+					EE_Admin_Page::add_query_args_and_nonce(
1392
+						[
1393
+							'action'  => 'view_registration',
1394
+							'_REG_ID' => $previous_reg['REG_ID'],
1395
+						],
1396
+						REG_ADMIN_URL
1397
+					),
1398
+					'dashicons dashicons-arrow-left ee-icon-size-22'
1399
+				)
1400
+				: '';
1401
+			// grab header
1402
+			$template_path                             = REG_TEMPLATE_PATH . 'reg_admin_details_header.template.php';
1403
+			$this->_template_args['REG_ID']            = $this->_registration->ID();
1404
+			$this->_template_args['admin_page_header'] = EEH_Template::display_template(
1405
+				$template_path,
1406
+				$this->_template_args,
1407
+				true
1408
+			);
1409
+		} else {
1410
+			$this->_template_args['admin_page_header'] = '';
1411
+			$this->_display_espresso_notices();
1412
+		}
1413
+		// the details template wrapper
1414
+		$this->display_admin_page_with_sidebar();
1415
+	}
1416
+
1417
+
1418
+	/**
1419
+	 * @throws EE_Error
1420
+	 * @throws InvalidArgumentException
1421
+	 * @throws InvalidDataTypeException
1422
+	 * @throws InvalidInterfaceException
1423
+	 * @throws ReflectionException
1424
+	 * @since 4.10.2.p
1425
+	 */
1426
+	protected function _registration_details_metaboxes()
1427
+	{
1428
+		do_action('AHEE__Registrations_Admin_Page___registration_details_metabox__start', $this);
1429
+		$this->_set_registration_object();
1430
+		$attendee = $this->_registration instanceof EE_Registration ? $this->_registration->attendee() : null;
1431
+		add_meta_box(
1432
+			'edit-reg-status-mbox',
1433
+			esc_html__('Registration Status', 'event_espresso'),
1434
+			[$this, 'set_reg_status_buttons_metabox'],
1435
+			$this->_wp_page_slug,
1436
+			'normal',
1437
+			'high'
1438
+		);
1439
+		add_meta_box(
1440
+			'edit-reg-details-mbox',
1441
+			esc_html__('Registration Details', 'event_espresso'),
1442
+			[$this, '_reg_details_meta_box'],
1443
+			$this->_wp_page_slug,
1444
+			'normal',
1445
+			'high'
1446
+		);
1447
+		if (
1448
+			$attendee instanceof EE_Attendee
1449
+			&& EE_Registry::instance()->CAP->current_user_can(
1450
+				'ee_read_registration',
1451
+				'edit-reg-questions-mbox',
1452
+				$this->_registration->ID()
1453
+			)
1454
+		) {
1455
+			add_meta_box(
1456
+				'edit-reg-questions-mbox',
1457
+				esc_html__('Registration Form Answers', 'event_espresso'),
1458
+				[$this, '_reg_questions_meta_box'],
1459
+				$this->_wp_page_slug,
1460
+				'normal',
1461
+				'high'
1462
+			);
1463
+		}
1464
+		add_meta_box(
1465
+			'edit-reg-registrant-mbox',
1466
+			esc_html__('Contact Details', 'event_espresso'),
1467
+			[$this, '_reg_registrant_side_meta_box'],
1468
+			$this->_wp_page_slug,
1469
+			'side',
1470
+			'high'
1471
+		);
1472
+		if ($this->_registration->group_size() > 1) {
1473
+			add_meta_box(
1474
+				'edit-reg-attendees-mbox',
1475
+				esc_html__('Other Registrations in this Transaction', 'event_espresso'),
1476
+				[$this, '_reg_attendees_meta_box'],
1477
+				$this->_wp_page_slug,
1478
+				'normal',
1479
+				'high'
1480
+			);
1481
+		}
1482
+	}
1483
+
1484
+
1485
+	/**
1486
+	 * set_reg_status_buttons_metabox
1487
+	 *
1488
+	 * @return void
1489
+	 * @throws EE_Error
1490
+	 * @throws EntityNotFoundException
1491
+	 * @throws InvalidArgumentException
1492
+	 * @throws InvalidDataTypeException
1493
+	 * @throws InvalidInterfaceException
1494
+	 * @throws ReflectionException
1495
+	 */
1496
+	public function set_reg_status_buttons_metabox()
1497
+	{
1498
+		$this->_set_registration_object();
1499
+		$change_reg_status_form = $this->_generate_reg_status_change_form();
1500
+		$output                 = $change_reg_status_form->form_open(
1501
+			self::add_query_args_and_nonce(
1502
+				[
1503
+					'action' => 'change_reg_status',
1504
+				],
1505
+				REG_ADMIN_URL
1506
+			)
1507
+		);
1508
+		$output                 .= $change_reg_status_form->get_html();
1509
+		$output                 .= $change_reg_status_form->form_close();
1510
+		echo $output; // already escaped
1511
+	}
1512
+
1513
+
1514
+	/**
1515
+	 * @return EE_Form_Section_Proper
1516
+	 * @throws EE_Error
1517
+	 * @throws InvalidArgumentException
1518
+	 * @throws InvalidDataTypeException
1519
+	 * @throws InvalidInterfaceException
1520
+	 * @throws EntityNotFoundException
1521
+	 * @throws ReflectionException
1522
+	 */
1523
+	protected function _generate_reg_status_change_form()
1524
+	{
1525
+		$reg_status_change_form_array = [
1526
+			'name'            => 'reg_status_change_form',
1527
+			'html_id'         => 'reg-status-change-form',
1528
+			'layout_strategy' => new EE_Admin_Two_Column_Layout(),
1529
+			'subsections'     => [
1530
+				'return'         => new EE_Hidden_Input(
1531
+					[
1532
+						'name'    => 'return',
1533
+						'default' => 'view_registration',
1534
+					]
1535
+				),
1536
+				'REG_ID'         => new EE_Hidden_Input(
1537
+					[
1538
+						'name'    => 'REG_ID',
1539
+						'default' => $this->_registration->ID(),
1540
+					]
1541
+				),
1542
+				'current_status' => new EE_Form_Section_HTML(
1543
+					EEH_HTML::table(
1544
+						EEH_HTML::tr(
1545
+							EEH_HTML::th(
1546
+								EEH_HTML::label(
1547
+									EEH_HTML::strong(
1548
+										esc_html__('Current Registration Status', 'event_espresso')
1549
+									)
1550
+								)
1551
+							)
1552
+							. EEH_HTML::td(
1553
+								EEH_HTML::strong(
1554
+									$this->_registration->pretty_status(),
1555
+									'',
1556
+									'status-' . $this->_registration->status_ID(),
1557
+									'line-height: 1em; font-size: 1.5em; font-weight: bold;'
1558
+								)
1559
+							)
1560
+						)
1561
+					)
1562
+				),
1563
+			],
1564
+		];
1565
+		if (
1566
+			EE_Registry::instance()->CAP->current_user_can(
1567
+				'ee_edit_registration',
1568
+				'toggle_registration_status',
1569
+				$this->_registration->ID()
1570
+			)
1571
+		) {
1572
+			$reg_status_change_form_array['subsections']['reg_status']         = new EE_Select_Input(
1573
+				$this->_get_reg_statuses(),
1574
+				[
1575
+					'html_label_text' => esc_html__('Change Registration Status to', 'event_espresso'),
1576
+					'default'         => $this->_registration->status_ID(),
1577
+				]
1578
+			);
1579
+			$reg_status_change_form_array['subsections']['send_notifications'] = new EE_Yes_No_Input(
1580
+				[
1581
+					'html_label_text' => esc_html__('Send Related Messages', 'event_espresso'),
1582
+					'default'         => false,
1583
+					'html_help_text'  => esc_html__(
1584
+						'If set to "Yes", then the related messages will be sent to the registrant.',
1585
+						'event_espresso'
1586
+					),
1587
+				]
1588
+			);
1589
+			$reg_status_change_form_array['subsections']['submit']             = new EE_Submit_Input(
1590
+				[
1591
+					'html_class'      => 'button-primary',
1592
+					'html_label_text' => '&nbsp;',
1593
+					'default'         => esc_html__('Update Registration Status', 'event_espresso'),
1594
+				]
1595
+			);
1596
+		}
1597
+		return new EE_Form_Section_Proper($reg_status_change_form_array);
1598
+	}
1599
+
1600
+
1601
+	/**
1602
+	 * Returns an array of all the buttons for the various statuses and switch status actions
1603
+	 *
1604
+	 * @return array
1605
+	 * @throws EE_Error
1606
+	 * @throws InvalidArgumentException
1607
+	 * @throws InvalidDataTypeException
1608
+	 * @throws InvalidInterfaceException
1609
+	 * @throws EntityNotFoundException
1610
+	 */
1611
+	protected function _get_reg_statuses()
1612
+	{
1613
+		$reg_status_array = $this->getRegistrationModel()->reg_status_array();
1614
+		unset($reg_status_array[ EEM_Registration::status_id_incomplete ]);
1615
+		// get current reg status
1616
+		$current_status = $this->_registration->status_ID();
1617
+		// is registration for free event? This will determine whether to display the pending payment option
1618
+		if (
1619
+			$current_status !== EEM_Registration::status_id_pending_payment
1620
+			&& EEH_Money::compare_floats($this->_registration->ticket()->price(), 0.00)
1621
+		) {
1622
+			unset($reg_status_array[ EEM_Registration::status_id_pending_payment ]);
1623
+		}
1624
+		return $this->getStatusModel()->localized_status($reg_status_array, false, 'sentence');
1625
+	}
1626
+
1627
+
1628
+	/**
1629
+	 * This method is used when using _REG_ID from request which may or may not be an array of reg_ids.
1630
+	 *
1631
+	 * @param bool $status REG status given for changing registrations to.
1632
+	 * @param bool $notify Whether to send messages notifications or not.
1633
+	 * @return array (array with reg_id(s) updated and whether update was successful.
1634
+	 * @throws DomainException
1635
+	 * @throws EE_Error
1636
+	 * @throws EntityNotFoundException
1637
+	 * @throws InvalidArgumentException
1638
+	 * @throws InvalidDataTypeException
1639
+	 * @throws InvalidInterfaceException
1640
+	 * @throws ReflectionException
1641
+	 * @throws RuntimeException
1642
+	 */
1643
+	protected function _set_registration_status_from_request($status = false, $notify = false)
1644
+	{
1645
+		$REG_IDs = $this->request->requestParamIsSet('reg_status_change_form')
1646
+			? $this->request->getRequestParam('reg_status_change_form[REG_ID]', [], 'int', true)
1647
+			: $this->request->getRequestParam('_REG_ID', [], 'int', true);
1648
+
1649
+		// sanitize $REG_IDs
1650
+		$REG_IDs = array_map('absint', $REG_IDs);
1651
+		// and remove empty entries
1652
+		$REG_IDs = array_filter($REG_IDs);
1653
+
1654
+		$result = $this->_set_registration_status($REG_IDs, $status, $notify);
1655
+
1656
+		/**
1657
+		 * Set and filter $_req_data['_REG_ID'] for any potential future messages notifications.
1658
+		 * Currently this value is used downstream by the _process_resend_registration method.
1659
+		 *
1660
+		 * @param int|array                $registration_ids The registration ids that have had their status changed successfully.
1661
+		 * @param bool                     $status           The status registrations were changed to.
1662
+		 * @param bool                     $success          If the status was changed successfully for all registrations.
1663
+		 * @param Registrations_Admin_Page $admin_page_object
1664
+		 */
1665
+		$REG_ID = apply_filters(
1666
+			'FHEE__Registrations_Admin_Page___set_registration_status_from_request__REG_IDs',
1667
+			$result['REG_ID'],
1668
+			$status,
1669
+			$result['success'],
1670
+			$this
1671
+		);
1672
+		$this->request->setRequestParam('_REG_ID', $REG_ID);
1673
+
1674
+		// notify?
1675
+		if (
1676
+			$notify
1677
+			&& $result['success']
1678
+			&& ! empty($REG_ID)
1679
+			&& EE_Registry::instance()->CAP->current_user_can(
1680
+				'ee_send_message',
1681
+				'espresso_registrations_resend_registration'
1682
+			)
1683
+		) {
1684
+			$this->_process_resend_registration();
1685
+		}
1686
+		return $result;
1687
+	}
1688
+
1689
+
1690
+	/**
1691
+	 * Set the registration status for the given reg_id (which may or may not be an array, it gets typecast to an
1692
+	 * array). Note, this method does NOT take care of possible notifications.  That is required by calling code.
1693
+	 *
1694
+	 * @param array  $REG_IDs
1695
+	 * @param string $status
1696
+	 * @param bool   $notify Used to indicate whether notification was requested or not.  This determines the context
1697
+	 *                       slug sent with setting the registration status.
1698
+	 * @return array (an array with 'success' key representing whether status change was successful, and 'REG_ID' as
1699
+	 * @throws EE_Error
1700
+	 * @throws InvalidArgumentException
1701
+	 * @throws InvalidDataTypeException
1702
+	 * @throws InvalidInterfaceException
1703
+	 * @throws ReflectionException
1704
+	 * @throws RuntimeException
1705
+	 * @throws EntityNotFoundException
1706
+	 * @throws DomainException
1707
+	 */
1708
+	protected function _set_registration_status($REG_IDs = [], $status = '', $notify = false)
1709
+	{
1710
+		$success = false;
1711
+		// typecast $REG_IDs
1712
+		$REG_IDs = (array) $REG_IDs;
1713
+		if (! empty($REG_IDs)) {
1714
+			$success = true;
1715
+			// set default status if none is passed
1716
+			$status         = $status ?: EEM_Registration::status_id_pending_payment;
1717
+			$status_context = $notify
1718
+				? Domain::CONTEXT_REGISTRATION_STATUS_CHANGE_REGISTRATION_ADMIN_NOTIFY
1719
+				: Domain::CONTEXT_REGISTRATION_STATUS_CHANGE_REGISTRATION_ADMIN;
1720
+			// loop through REG_ID's and change status
1721
+			foreach ($REG_IDs as $REG_ID) {
1722
+				$registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
1723
+				if ($registration instanceof EE_Registration) {
1724
+					$registration->set_status(
1725
+						$status,
1726
+						false,
1727
+						new Context(
1728
+							$status_context,
1729
+							esc_html__(
1730
+								'Manually triggered status change on a Registration Admin Page route.',
1731
+								'event_espresso'
1732
+							)
1733
+						)
1734
+					);
1735
+					$result = $registration->save();
1736
+					// verifying explicit fails because update *may* just return 0 for 0 rows affected
1737
+					$success = $result !== false ? $success : false;
1738
+				}
1739
+			}
1740
+		}
1741
+
1742
+		// return $success and processed registrations
1743
+		return ['REG_ID' => $REG_IDs, 'success' => $success];
1744
+	}
1745
+
1746
+
1747
+	/**
1748
+	 * Common logic for setting up success message and redirecting to appropriate route
1749
+	 *
1750
+	 * @param string $STS_ID status id for the registration changed to
1751
+	 * @param bool   $notify indicates whether the _set_registration_status_from_request does notifications or not.
1752
+	 * @return void
1753
+	 * @throws DomainException
1754
+	 * @throws EE_Error
1755
+	 * @throws EntityNotFoundException
1756
+	 * @throws InvalidArgumentException
1757
+	 * @throws InvalidDataTypeException
1758
+	 * @throws InvalidInterfaceException
1759
+	 * @throws ReflectionException
1760
+	 * @throws RuntimeException
1761
+	 */
1762
+	protected function _reg_status_change_return($STS_ID, $notify = false)
1763
+	{
1764
+		$result  = ! empty($STS_ID) ? $this->_set_registration_status_from_request($STS_ID, $notify)
1765
+			: ['success' => false];
1766
+		$success = isset($result['success']) && $result['success'];
1767
+		// setup success message
1768
+		if ($success) {
1769
+			if (is_array($result['REG_ID']) && count($result['REG_ID']) === 1) {
1770
+				$msg = sprintf(
1771
+					esc_html__('Registration status has been set to %s', 'event_espresso'),
1772
+					EEH_Template::pretty_status($STS_ID, false, 'lower')
1773
+				);
1774
+			} else {
1775
+				$msg = sprintf(
1776
+					esc_html__('Registrations have been set to %s.', 'event_espresso'),
1777
+					EEH_Template::pretty_status($STS_ID, false, 'lower')
1778
+				);
1779
+			}
1780
+			EE_Error::add_success($msg);
1781
+		} else {
1782
+			EE_Error::add_error(
1783
+				esc_html__(
1784
+					'Something went wrong, and the status was not changed',
1785
+					'event_espresso'
1786
+				),
1787
+				__FILE__,
1788
+				__LINE__,
1789
+				__FUNCTION__
1790
+			);
1791
+		}
1792
+		$return = $this->request->getRequestParam('return');
1793
+		$route  = $return === 'view_registration'
1794
+			? ['action' => 'view_registration', '_REG_ID' => reset($result['REG_ID'])]
1795
+			: ['action' => 'default'];
1796
+		$route  = $this->mergeExistingRequestParamsWithRedirectArgs($route);
1797
+		$this->_redirect_after_action($success, '', '', $route, true);
1798
+	}
1799
+
1800
+
1801
+	/**
1802
+	 * incoming reg status change from reg details page.
1803
+	 *
1804
+	 * @return void
1805
+	 * @throws EE_Error
1806
+	 * @throws EntityNotFoundException
1807
+	 * @throws InvalidArgumentException
1808
+	 * @throws InvalidDataTypeException
1809
+	 * @throws InvalidInterfaceException
1810
+	 * @throws ReflectionException
1811
+	 * @throws RuntimeException
1812
+	 * @throws DomainException
1813
+	 */
1814
+	protected function _change_reg_status()
1815
+	{
1816
+		$this->request->setRequestParam('return', 'view_registration');
1817
+		// set notify based on whether the send notifications toggle is set or not
1818
+		$notify     = $this->request->getRequestParam('reg_status_change_form[send_notifications]', false, 'bool');
1819
+		$reg_status = $this->request->getRequestParam('reg_status_change_form[reg_status]', '');
1820
+		$this->request->setRequestParam('reg_status_change_form[reg_status]', $reg_status);
1821
+		switch ($reg_status) {
1822
+			case EEM_Registration::status_id_approved:
1823
+			case EEH_Template::pretty_status(EEM_Registration::status_id_approved, false, 'sentence'):
1824
+				$this->approve_registration($notify);
1825
+				break;
1826
+			case EEM_Registration::status_id_pending_payment:
1827
+			case EEH_Template::pretty_status(EEM_Registration::status_id_pending_payment, false, 'sentence'):
1828
+				$this->pending_registration($notify);
1829
+				break;
1830
+			case EEM_Registration::status_id_not_approved:
1831
+			case EEH_Template::pretty_status(EEM_Registration::status_id_not_approved, false, 'sentence'):
1832
+				$this->not_approve_registration($notify);
1833
+				break;
1834
+			case EEM_Registration::status_id_declined:
1835
+			case EEH_Template::pretty_status(EEM_Registration::status_id_declined, false, 'sentence'):
1836
+				$this->decline_registration($notify);
1837
+				break;
1838
+			case EEM_Registration::status_id_cancelled:
1839
+			case EEH_Template::pretty_status(EEM_Registration::status_id_cancelled, false, 'sentence'):
1840
+				$this->cancel_registration($notify);
1841
+				break;
1842
+			case EEM_Registration::status_id_wait_list:
1843
+			case EEH_Template::pretty_status(EEM_Registration::status_id_wait_list, false, 'sentence'):
1844
+				$this->wait_list_registration($notify);
1845
+				break;
1846
+			case EEM_Registration::status_id_incomplete:
1847
+			default:
1848
+				$this->request->unSetRequestParam('return');
1849
+				$this->_reg_status_change_return('');
1850
+				break;
1851
+		}
1852
+	}
1853
+
1854
+
1855
+	/**
1856
+	 * Callback for bulk action routes.
1857
+	 * Note: although we could just register the singular route callbacks for each bulk action route as well, this
1858
+	 * method was chosen so there is one central place all the registration status bulk actions are going through.
1859
+	 * Potentially, this provides an easier place to locate logic that is specific to these bulk actions (as opposed to
1860
+	 * when an action is happening on just a single registration).
1861
+	 *
1862
+	 * @param      $action
1863
+	 * @param bool $notify
1864
+	 */
1865
+	protected function bulk_action_on_registrations($action, $notify = false)
1866
+	{
1867
+		do_action(
1868
+			'AHEE__Registrations_Admin_Page__bulk_action_on_registrations__before_execution',
1869
+			$this,
1870
+			$action,
1871
+			$notify
1872
+		);
1873
+		$method = $action . '_registration';
1874
+		if (method_exists($this, $method)) {
1875
+			$this->$method($notify);
1876
+		}
1877
+	}
1878
+
1879
+
1880
+	/**
1881
+	 * approve_registration
1882
+	 *
1883
+	 * @param bool $notify whether or not to notify the registrant about their approval.
1884
+	 * @return void
1885
+	 * @throws EE_Error
1886
+	 * @throws EntityNotFoundException
1887
+	 * @throws InvalidArgumentException
1888
+	 * @throws InvalidDataTypeException
1889
+	 * @throws InvalidInterfaceException
1890
+	 * @throws ReflectionException
1891
+	 * @throws RuntimeException
1892
+	 * @throws DomainException
1893
+	 */
1894
+	protected function approve_registration($notify = false)
1895
+	{
1896
+		$this->_reg_status_change_return(EEM_Registration::status_id_approved, $notify);
1897
+	}
1898
+
1899
+
1900
+	/**
1901
+	 * decline_registration
1902
+	 *
1903
+	 * @param bool $notify whether or not to notify the registrant about their status change.
1904
+	 * @return void
1905
+	 * @throws EE_Error
1906
+	 * @throws EntityNotFoundException
1907
+	 * @throws InvalidArgumentException
1908
+	 * @throws InvalidDataTypeException
1909
+	 * @throws InvalidInterfaceException
1910
+	 * @throws ReflectionException
1911
+	 * @throws RuntimeException
1912
+	 * @throws DomainException
1913
+	 */
1914
+	protected function decline_registration($notify = false)
1915
+	{
1916
+		$this->_reg_status_change_return(EEM_Registration::status_id_declined, $notify);
1917
+	}
1918
+
1919
+
1920
+	/**
1921
+	 * cancel_registration
1922
+	 *
1923
+	 * @param bool $notify whether or not to notify the registrant about their status change.
1924
+	 * @return void
1925
+	 * @throws EE_Error
1926
+	 * @throws EntityNotFoundException
1927
+	 * @throws InvalidArgumentException
1928
+	 * @throws InvalidDataTypeException
1929
+	 * @throws InvalidInterfaceException
1930
+	 * @throws ReflectionException
1931
+	 * @throws RuntimeException
1932
+	 * @throws DomainException
1933
+	 */
1934
+	protected function cancel_registration($notify = false)
1935
+	{
1936
+		$this->_reg_status_change_return(EEM_Registration::status_id_cancelled, $notify);
1937
+	}
1938
+
1939
+
1940
+	/**
1941
+	 * not_approve_registration
1942
+	 *
1943
+	 * @param bool $notify whether or not to notify the registrant about their status change.
1944
+	 * @return void
1945
+	 * @throws EE_Error
1946
+	 * @throws EntityNotFoundException
1947
+	 * @throws InvalidArgumentException
1948
+	 * @throws InvalidDataTypeException
1949
+	 * @throws InvalidInterfaceException
1950
+	 * @throws ReflectionException
1951
+	 * @throws RuntimeException
1952
+	 * @throws DomainException
1953
+	 */
1954
+	protected function not_approve_registration($notify = false)
1955
+	{
1956
+		$this->_reg_status_change_return(EEM_Registration::status_id_not_approved, $notify);
1957
+	}
1958
+
1959
+
1960
+	/**
1961
+	 * decline_registration
1962
+	 *
1963
+	 * @param bool $notify whether or not to notify the registrant about their status change.
1964
+	 * @return void
1965
+	 * @throws EE_Error
1966
+	 * @throws EntityNotFoundException
1967
+	 * @throws InvalidArgumentException
1968
+	 * @throws InvalidDataTypeException
1969
+	 * @throws InvalidInterfaceException
1970
+	 * @throws ReflectionException
1971
+	 * @throws RuntimeException
1972
+	 * @throws DomainException
1973
+	 */
1974
+	protected function pending_registration($notify = false)
1975
+	{
1976
+		$this->_reg_status_change_return(EEM_Registration::status_id_pending_payment, $notify);
1977
+	}
1978
+
1979
+
1980
+	/**
1981
+	 * waitlist_registration
1982
+	 *
1983
+	 * @param bool $notify whether or not to notify the registrant about their status change.
1984
+	 * @return void
1985
+	 * @throws EE_Error
1986
+	 * @throws EntityNotFoundException
1987
+	 * @throws InvalidArgumentException
1988
+	 * @throws InvalidDataTypeException
1989
+	 * @throws InvalidInterfaceException
1990
+	 * @throws ReflectionException
1991
+	 * @throws RuntimeException
1992
+	 * @throws DomainException
1993
+	 */
1994
+	protected function wait_list_registration($notify = false)
1995
+	{
1996
+		$this->_reg_status_change_return(EEM_Registration::status_id_wait_list, $notify);
1997
+	}
1998
+
1999
+
2000
+	/**
2001
+	 * generates HTML for the Registration main meta box
2002
+	 *
2003
+	 * @return void
2004
+	 * @throws DomainException
2005
+	 * @throws EE_Error
2006
+	 * @throws InvalidArgumentException
2007
+	 * @throws InvalidDataTypeException
2008
+	 * @throws InvalidInterfaceException
2009
+	 * @throws ReflectionException
2010
+	 * @throws EntityNotFoundException
2011
+	 */
2012
+	public function _reg_details_meta_box()
2013
+	{
2014
+		EEH_Autoloader::register_line_item_display_autoloaders();
2015
+		EEH_Autoloader::register_line_item_filter_autoloaders();
2016
+		EE_Registry::instance()->load_helper('Line_Item');
2017
+		$transaction    = $this->_registration->transaction() ? $this->_registration->transaction()
2018
+			: EE_Transaction::new_instance();
2019
+		$this->_session = $transaction->session_data();
2020
+		$filters        = new EE_Line_Item_Filter_Collection();
2021
+		$filters->add(new EE_Single_Registration_Line_Item_Filter($this->_registration));
2022
+		$filters->add(new EE_Non_Zero_Line_Item_Filter());
2023
+		$line_item_filter_processor              = new EE_Line_Item_Filter_Processor(
2024
+			$filters,
2025
+			$transaction->total_line_item()
2026
+		);
2027
+		$filtered_line_item_tree                 = $line_item_filter_processor->process();
2028
+		$line_item_display                       = new EE_Line_Item_Display(
2029
+			'reg_admin_table',
2030
+			'EE_Admin_Table_Registration_Line_Item_Display_Strategy'
2031
+		);
2032
+		$this->_template_args['line_item_table'] = $line_item_display->display_line_item(
2033
+			$filtered_line_item_tree,
2034
+			['EE_Registration' => $this->_registration]
2035
+		);
2036
+		$attendee                                = $this->_registration->attendee();
2037
+		if (
2038
+			EE_Registry::instance()->CAP->current_user_can(
2039
+				'ee_read_transaction',
2040
+				'espresso_transactions_view_transaction'
2041
+			)
2042
+		) {
2043
+			$this->_template_args['view_transaction_button'] = EEH_Template::get_button_or_link(
2044
+				EE_Admin_Page::add_query_args_and_nonce(
2045
+					[
2046
+						'action' => 'view_transaction',
2047
+						'TXN_ID' => $transaction->ID(),
2048
+					],
2049
+					TXN_ADMIN_URL
2050
+				),
2051
+				esc_html__(' View Transaction', 'event_espresso'),
2052
+				'button secondary-button right',
2053
+				'dashicons dashicons-cart'
2054
+			);
2055
+		} else {
2056
+			$this->_template_args['view_transaction_button'] = '';
2057
+		}
2058
+		if (
2059
+			$attendee instanceof EE_Attendee
2060
+			&& EE_Registry::instance()->CAP->current_user_can(
2061
+				'ee_send_message',
2062
+				'espresso_registrations_resend_registration'
2063
+			)
2064
+		) {
2065
+			$this->_template_args['resend_registration_button'] = EEH_Template::get_button_or_link(
2066
+				EE_Admin_Page::add_query_args_and_nonce(
2067
+					[
2068
+						'action'      => 'resend_registration',
2069
+						'_REG_ID'     => $this->_registration->ID(),
2070
+						'redirect_to' => 'view_registration',
2071
+					],
2072
+					REG_ADMIN_URL
2073
+				),
2074
+				esc_html__(' Resend Registration', 'event_espresso'),
2075
+				'button secondary-button right',
2076
+				'dashicons dashicons-email-alt'
2077
+			);
2078
+		} else {
2079
+			$this->_template_args['resend_registration_button'] = '';
2080
+		}
2081
+		$this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
2082
+		$payment                               = $transaction->get_first_related('Payment');
2083
+		$payment                               = ! $payment instanceof EE_Payment
2084
+			? EE_Payment::new_instance()
2085
+			: $payment;
2086
+		$payment_method                        = $payment->get_first_related('Payment_Method');
2087
+		$payment_method                        = ! $payment_method instanceof EE_Payment_Method
2088
+			? EE_Payment_Method::new_instance()
2089
+			: $payment_method;
2090
+		$reg_details                           = [
2091
+			'payment_method'       => $payment_method->name(),
2092
+			'response_msg'         => $payment->gateway_response(),
2093
+			'registration_id'      => $this->_registration->get('REG_code'),
2094
+			'registration_session' => $this->_registration->session_ID(),
2095
+			'ip_address'           => isset($this->_session['ip_address']) ? $this->_session['ip_address'] : '',
2096
+			'user_agent'           => isset($this->_session['user_agent']) ? $this->_session['user_agent'] : '',
2097
+		];
2098
+		if (isset($reg_details['registration_id'])) {
2099
+			$this->_template_args['reg_details']['registration_id']['value'] = $reg_details['registration_id'];
2100
+			$this->_template_args['reg_details']['registration_id']['label'] = esc_html__(
2101
+				'Registration ID',
2102
+				'event_espresso'
2103
+			);
2104
+			$this->_template_args['reg_details']['registration_id']['class'] = 'regular-text';
2105
+		}
2106
+		if (isset($reg_details['payment_method'])) {
2107
+			$this->_template_args['reg_details']['payment_method']['value'] = $reg_details['payment_method'];
2108
+			$this->_template_args['reg_details']['payment_method']['label'] = esc_html__(
2109
+				'Most Recent Payment Method',
2110
+				'event_espresso'
2111
+			);
2112
+			$this->_template_args['reg_details']['payment_method']['class'] = 'regular-text';
2113
+			$this->_template_args['reg_details']['response_msg']['value']   = $reg_details['response_msg'];
2114
+			$this->_template_args['reg_details']['response_msg']['label']   = esc_html__(
2115
+				'Payment method response',
2116
+				'event_espresso'
2117
+			);
2118
+			$this->_template_args['reg_details']['response_msg']['class']   = 'regular-text';
2119
+		}
2120
+		$this->_template_args['reg_details']['registration_session']['value'] = $reg_details['registration_session'];
2121
+		$this->_template_args['reg_details']['registration_session']['label'] = esc_html__(
2122
+			'Registration Session',
2123
+			'event_espresso'
2124
+		);
2125
+		$this->_template_args['reg_details']['registration_session']['class'] = 'regular-text';
2126
+		$this->_template_args['reg_details']['ip_address']['value']           = $reg_details['ip_address'];
2127
+		$this->_template_args['reg_details']['ip_address']['label']           = esc_html__(
2128
+			'Registration placed from IP',
2129
+			'event_espresso'
2130
+		);
2131
+		$this->_template_args['reg_details']['ip_address']['class']           = 'regular-text';
2132
+		$this->_template_args['reg_details']['user_agent']['value']           = $reg_details['user_agent'];
2133
+		$this->_template_args['reg_details']['user_agent']['label']           = esc_html__(
2134
+			'Registrant User Agent',
2135
+			'event_espresso'
2136
+		);
2137
+		$this->_template_args['reg_details']['user_agent']['class']           = 'large-text';
2138
+		$this->_template_args['event_link']                                   = EE_Admin_Page::add_query_args_and_nonce(
2139
+			[
2140
+				'action'   => 'default',
2141
+				'event_id' => $this->_registration->event_ID(),
2142
+			],
2143
+			REG_ADMIN_URL
2144
+		);
2145
+		$this->_template_args['REG_ID']                                       = $this->_registration->ID();
2146
+		$this->_template_args['event_id']                                     = $this->_registration->event_ID();
2147
+		$template_path                                                        =
2148
+			REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_details.template.php';
2149
+		EEH_Template::display_template($template_path, $this->_template_args); // already escaped
2150
+	}
2151
+
2152
+
2153
+	/**
2154
+	 * generates HTML for the Registration Questions meta box.
2155
+	 * If pre-4.8.32.rc.000 hooks are used, uses old methods (with its filters),
2156
+	 * otherwise uses new forms system
2157
+	 *
2158
+	 * @return void
2159
+	 * @throws DomainException
2160
+	 * @throws EE_Error
2161
+	 * @throws InvalidArgumentException
2162
+	 * @throws InvalidDataTypeException
2163
+	 * @throws InvalidInterfaceException
2164
+	 * @throws ReflectionException
2165
+	 */
2166
+	public function _reg_questions_meta_box()
2167
+	{
2168
+		// allow someone to override this method entirely
2169
+		if (
2170
+			apply_filters(
2171
+				'FHEE__Registrations_Admin_Page___reg_questions_meta_box__do_default',
2172
+				true,
2173
+				$this,
2174
+				$this->_registration
2175
+			)
2176
+		) {
2177
+			$form                                              = $this->_get_reg_custom_questions_form(
2178
+				$this->_registration->ID()
2179
+			);
2180
+			$this->_template_args['att_questions']             = count($form->subforms()) > 0
2181
+				? $form->get_html_and_js()
2182
+				: '';
2183
+			$this->_template_args['reg_questions_form_action'] = 'edit_registration';
2184
+			$this->_template_args['REG_ID']                    = $this->_registration->ID();
2185
+			$template_path                                     =
2186
+				REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_questions.template.php';
2187
+			EEH_Template::display_template($template_path, $this->_template_args);
2188
+		}
2189
+	}
2190
+
2191
+
2192
+	/**
2193
+	 * form_before_question_group
2194
+	 *
2195
+	 * @param string $output
2196
+	 * @return        string
2197
+	 * @deprecated    as of 4.8.32.rc.000
2198
+	 */
2199
+	public function form_before_question_group($output)
2200
+	{
2201
+		EE_Error::doing_it_wrong(
2202
+			__CLASS__ . '::' . __FUNCTION__,
2203
+			esc_html__(
2204
+				'This method would have been protected but was used on a filter callback so needed to be public. Please discontinue usage as it will be removed soon.',
2205
+				'event_espresso'
2206
+			),
2207
+			'4.8.32.rc.000'
2208
+		);
2209
+		return '
2210 2210
 	<table class="form-table ee-width-100">
2211 2211
 		<tbody>
2212 2212
 			';
2213
-    }
2214
-
2215
-
2216
-    /**
2217
-     * form_after_question_group
2218
-     *
2219
-     * @param string $output
2220
-     * @return        string
2221
-     * @deprecated    as of 4.8.32.rc.000
2222
-     */
2223
-    public function form_after_question_group($output)
2224
-    {
2225
-        EE_Error::doing_it_wrong(
2226
-            __CLASS__ . '::' . __FUNCTION__,
2227
-            esc_html__(
2228
-                'This method would have been protected but was used on a filter callback so needed to be public. Please discontinue usage as it will be removed soon.',
2229
-                'event_espresso'
2230
-            ),
2231
-            '4.8.32.rc.000'
2232
-        );
2233
-        return '
2213
+	}
2214
+
2215
+
2216
+	/**
2217
+	 * form_after_question_group
2218
+	 *
2219
+	 * @param string $output
2220
+	 * @return        string
2221
+	 * @deprecated    as of 4.8.32.rc.000
2222
+	 */
2223
+	public function form_after_question_group($output)
2224
+	{
2225
+		EE_Error::doing_it_wrong(
2226
+			__CLASS__ . '::' . __FUNCTION__,
2227
+			esc_html__(
2228
+				'This method would have been protected but was used on a filter callback so needed to be public. Please discontinue usage as it will be removed soon.',
2229
+				'event_espresso'
2230
+			),
2231
+			'4.8.32.rc.000'
2232
+		);
2233
+		return '
2234 2234
 			<tr class="hide-if-no-js">
2235 2235
 				<th> </th>
2236 2236
 				<td class="reg-admin-edit-attendee-question-td">
2237 2237
 					<a class="reg-admin-edit-attendee-question-lnk" href="#" title="'
2238
-               . esc_attr__('click to edit question', 'event_espresso')
2239
-               . '">
2238
+			   . esc_attr__('click to edit question', 'event_espresso')
2239
+			   . '">
2240 2240
 						<span class="reg-admin-edit-question-group-spn lt-grey-txt">'
2241
-               . esc_html__('edit the above question group', 'event_espresso')
2242
-               . '</span>
2241
+			   . esc_html__('edit the above question group', 'event_espresso')
2242
+			   . '</span>
2243 2243
 						<div class="dashicons dashicons-edit"></div>
2244 2244
 					</a>
2245 2245
 				</td>
@@ -2247,637 +2247,637 @@  discard block
 block discarded – undo
2247 2247
 		</tbody>
2248 2248
 	</table>
2249 2249
 ';
2250
-    }
2251
-
2252
-
2253
-    /**
2254
-     * form_form_field_label_wrap
2255
-     *
2256
-     * @param string $label
2257
-     * @return        string
2258
-     * @deprecated    as of 4.8.32.rc.000
2259
-     */
2260
-    public function form_form_field_label_wrap($label)
2261
-    {
2262
-        EE_Error::doing_it_wrong(
2263
-            __CLASS__ . '::' . __FUNCTION__,
2264
-            esc_html__(
2265
-                'This method would have been protected but was used on a filter callback so needed to be public. Please discontinue usage as it will be removed soon.',
2266
-                'event_espresso'
2267
-            ),
2268
-            '4.8.32.rc.000'
2269
-        );
2270
-        return '
2250
+	}
2251
+
2252
+
2253
+	/**
2254
+	 * form_form_field_label_wrap
2255
+	 *
2256
+	 * @param string $label
2257
+	 * @return        string
2258
+	 * @deprecated    as of 4.8.32.rc.000
2259
+	 */
2260
+	public function form_form_field_label_wrap($label)
2261
+	{
2262
+		EE_Error::doing_it_wrong(
2263
+			__CLASS__ . '::' . __FUNCTION__,
2264
+			esc_html__(
2265
+				'This method would have been protected but was used on a filter callback so needed to be public. Please discontinue usage as it will be removed soon.',
2266
+				'event_espresso'
2267
+			),
2268
+			'4.8.32.rc.000'
2269
+		);
2270
+		return '
2271 2271
 			<tr>
2272 2272
 				<th>
2273 2273
 					' . $label . '
2274 2274
 				</th>';
2275
-    }
2276
-
2277
-
2278
-    /**
2279
-     * form_form_field_input__wrap
2280
-     *
2281
-     * @param string $input
2282
-     * @return        string
2283
-     * @deprecated    as of 4.8.32.rc.000
2284
-     */
2285
-    public function form_form_field_input__wrap($input)
2286
-    {
2287
-        EE_Error::doing_it_wrong(
2288
-            __CLASS__ . '::' . __FUNCTION__,
2289
-            esc_html__(
2290
-                'This method would have been protected but was used on a filter callback so needed to be public. Please discontinue usage as it will be removed soon.',
2291
-                'event_espresso'
2292
-            ),
2293
-            '4.8.32.rc.000'
2294
-        );
2295
-        return '
2275
+	}
2276
+
2277
+
2278
+	/**
2279
+	 * form_form_field_input__wrap
2280
+	 *
2281
+	 * @param string $input
2282
+	 * @return        string
2283
+	 * @deprecated    as of 4.8.32.rc.000
2284
+	 */
2285
+	public function form_form_field_input__wrap($input)
2286
+	{
2287
+		EE_Error::doing_it_wrong(
2288
+			__CLASS__ . '::' . __FUNCTION__,
2289
+			esc_html__(
2290
+				'This method would have been protected but was used on a filter callback so needed to be public. Please discontinue usage as it will be removed soon.',
2291
+				'event_espresso'
2292
+			),
2293
+			'4.8.32.rc.000'
2294
+		);
2295
+		return '
2296 2296
 				<td class="reg-admin-attendee-questions-input-td disabled-input">
2297 2297
 					' . $input . '
2298 2298
 				</td>
2299 2299
 			</tr>';
2300
-    }
2301
-
2302
-
2303
-    /**
2304
-     * Updates the registration's custom questions according to the form info, if the form is submitted.
2305
-     * If it's not a post, the "view_registrations" route will be called next on the SAME request
2306
-     * to display the page
2307
-     *
2308
-     * @return void
2309
-     * @throws EE_Error
2310
-     * @throws InvalidArgumentException
2311
-     * @throws InvalidDataTypeException
2312
-     * @throws InvalidInterfaceException
2313
-     * @throws ReflectionException
2314
-     */
2315
-    protected function _update_attendee_registration_form()
2316
-    {
2317
-        do_action('AHEE__Registrations_Admin_Page___update_attendee_registration_form__start', $this);
2318
-        if ($_SERVER['REQUEST_METHOD'] === 'POST') {
2319
-            $REG_ID  = $this->request->getRequestParam('_REG_ID', 0, 'int');
2320
-            $success = $this->_save_reg_custom_questions_form($REG_ID);
2321
-            if ($success) {
2322
-                $what  = esc_html__('Registration Form', 'event_espresso');
2323
-                $route = $REG_ID
2324
-                    ? ['action' => 'view_registration', '_REG_ID' => $REG_ID]
2325
-                    : ['action' => 'default'];
2326
-                $this->_redirect_after_action(true, $what, esc_html__('updated', 'event_espresso'), $route);
2327
-            }
2328
-        }
2329
-    }
2330
-
2331
-
2332
-    /**
2333
-     * Gets the form for saving registrations custom questions (if done
2334
-     * previously retrieves the cached form object, which may have validation errors in it)
2335
-     *
2336
-     * @param int $REG_ID
2337
-     * @return EE_Registration_Custom_Questions_Form
2338
-     * @throws EE_Error
2339
-     * @throws InvalidArgumentException
2340
-     * @throws InvalidDataTypeException
2341
-     * @throws InvalidInterfaceException
2342
-     * @throws ReflectionException
2343
-     */
2344
-    protected function _get_reg_custom_questions_form($REG_ID)
2345
-    {
2346
-        if (! $this->_reg_custom_questions_form) {
2347
-            require_once(REG_ADMIN . 'form_sections/EE_Registration_Custom_Questions_Form.form.php');
2348
-            $this->_reg_custom_questions_form = new EE_Registration_Custom_Questions_Form(
2349
-                $this->getRegistrationModel()->get_one_by_ID($REG_ID)
2350
-            );
2351
-            $this->_reg_custom_questions_form->_construct_finalize(null, null);
2352
-        }
2353
-        return $this->_reg_custom_questions_form;
2354
-    }
2355
-
2356
-
2357
-    /**
2358
-     * Saves
2359
-     *
2360
-     * @param bool $REG_ID
2361
-     * @return bool
2362
-     * @throws EE_Error
2363
-     * @throws InvalidArgumentException
2364
-     * @throws InvalidDataTypeException
2365
-     * @throws InvalidInterfaceException
2366
-     * @throws ReflectionException
2367
-     */
2368
-    private function _save_reg_custom_questions_form($REG_ID = 0)
2369
-    {
2370
-        if (! $REG_ID) {
2371
-            EE_Error::add_error(
2372
-                esc_html__(
2373
-                    'An error occurred. No registration ID was received.',
2374
-                    'event_espresso'
2375
-                ),
2376
-                __FILE__,
2377
-                __FUNCTION__,
2378
-                __LINE__
2379
-            );
2380
-        }
2381
-        $form = $this->_get_reg_custom_questions_form($REG_ID);
2382
-        $form->receive_form_submission($this->request->requestParams());
2383
-        $success = false;
2384
-        if ($form->is_valid()) {
2385
-            foreach ($form->subforms() as $question_group_form) {
2386
-                foreach ($question_group_form->inputs() as $question_id => $input) {
2387
-                    $where_conditions    = [
2388
-                        'QST_ID' => $question_id,
2389
-                        'REG_ID' => $REG_ID,
2390
-                    ];
2391
-                    $possibly_new_values = [
2392
-                        'ANS_value' => $input->normalized_value(),
2393
-                    ];
2394
-                    $answer              = EEM_Answer::instance()->get_one([$where_conditions]);
2395
-                    if ($answer instanceof EE_Answer) {
2396
-                        $success = $answer->save($possibly_new_values);
2397
-                    } else {
2398
-                        // insert it then
2399
-                        $cols_n_vals = array_merge($where_conditions, $possibly_new_values);
2400
-                        $answer      = EE_Answer::new_instance($cols_n_vals);
2401
-                        $success     = $answer->save();
2402
-                    }
2403
-                }
2404
-            }
2405
-        } else {
2406
-            EE_Error::add_error($form->get_validation_error_string(), __FILE__, __FUNCTION__, __LINE__);
2407
-        }
2408
-        return $success;
2409
-    }
2410
-
2411
-
2412
-    /**
2413
-     * generates HTML for the Registration main meta box
2414
-     *
2415
-     * @return void
2416
-     * @throws DomainException
2417
-     * @throws EE_Error
2418
-     * @throws InvalidArgumentException
2419
-     * @throws InvalidDataTypeException
2420
-     * @throws InvalidInterfaceException
2421
-     * @throws ReflectionException
2422
-     */
2423
-    public function _reg_attendees_meta_box()
2424
-    {
2425
-        $REG = $this->getRegistrationModel();
2426
-        // get all other registrations on this transaction, and cache
2427
-        // the attendees for them so we don't have to run another query using force_join
2428
-        $registrations                           = $REG->get_all(
2429
-            [
2430
-                [
2431
-                    'TXN_ID' => $this->_registration->transaction_ID(),
2432
-                    'REG_ID' => ['!=', $this->_registration->ID()],
2433
-                ],
2434
-                'force_join'               => ['Attendee'],
2435
-                'default_where_conditions' => 'other_models_only',
2436
-            ]
2437
-        );
2438
-        $this->_template_args['attendees']       = [];
2439
-        $this->_template_args['attendee_notice'] = '';
2440
-        if (
2441
-            empty($registrations)
2442
-            || (is_array($registrations)
2443
-                && ! EEH_Array::get_one_item_from_array($registrations))
2444
-        ) {
2445
-            EE_Error::add_error(
2446
-                esc_html__(
2447
-                    'There are no records attached to this registration. Something may have gone wrong with the registration',
2448
-                    'event_espresso'
2449
-                ),
2450
-                __FILE__,
2451
-                __FUNCTION__,
2452
-                __LINE__
2453
-            );
2454
-            $this->_template_args['attendee_notice'] = EE_Error::get_notices();
2455
-        } else {
2456
-            $att_nmbr = 1;
2457
-            foreach ($registrations as $registration) {
2458
-                /* @var $registration EE_Registration */
2459
-                $attendee                                                      = $registration->attendee()
2460
-                    ? $registration->attendee()
2461
-                    : $this->getAttendeeModel()->create_default_object();
2462
-                $this->_template_args['attendees'][ $att_nmbr ]['STS_ID']      = $registration->status_ID();
2463
-                $this->_template_args['attendees'][ $att_nmbr ]['fname']       = $attendee->fname();
2464
-                $this->_template_args['attendees'][ $att_nmbr ]['lname']       = $attendee->lname();
2465
-                $this->_template_args['attendees'][ $att_nmbr ]['email']       = $attendee->email();
2466
-                $this->_template_args['attendees'][ $att_nmbr ]['final_price'] = $registration->final_price();
2467
-                $this->_template_args['attendees'][ $att_nmbr ]['address']     = implode(
2468
-                    ', ',
2469
-                    $attendee->full_address_as_array()
2470
-                );
2471
-                $this->_template_args['attendees'][ $att_nmbr ]['att_link']    = self::add_query_args_and_nonce(
2472
-                    [
2473
-                        'action' => 'edit_attendee',
2474
-                        'post'   => $attendee->ID(),
2475
-                    ],
2476
-                    REG_ADMIN_URL
2477
-                );
2478
-                $this->_template_args['attendees'][ $att_nmbr ]['event_name']  =
2479
-                    $registration->event_obj() instanceof EE_Event
2480
-                        ? $registration->event_obj()->name()
2481
-                        : '';
2482
-                $att_nmbr++;
2483
-            }
2484
-            $this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
2485
-        }
2486
-        $template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_attendees.template.php';
2487
-        EEH_Template::display_template($template_path, $this->_template_args);
2488
-    }
2489
-
2490
-
2491
-    /**
2492
-     * generates HTML for the Edit Registration side meta box
2493
-     *
2494
-     * @return void
2495
-     * @throws DomainException
2496
-     * @throws EE_Error
2497
-     * @throws InvalidArgumentException
2498
-     * @throws InvalidDataTypeException
2499
-     * @throws InvalidInterfaceException
2500
-     * @throws ReflectionException
2501
-     */
2502
-    public function _reg_registrant_side_meta_box()
2503
-    {
2504
-        /*@var $attendee EE_Attendee */
2505
-        $att_check = $this->_registration->attendee();
2506
-        $attendee  = $att_check instanceof EE_Attendee
2507
-            ? $att_check
2508
-            : $this->getAttendeeModel()->create_default_object();
2509
-        // now let's determine if this is not the primary registration.  If it isn't then we set the
2510
-        // primary_registration object for reference BUT ONLY if the Attendee object loaded is not the same as the
2511
-        // primary registration object (that way we know if we need to show create button or not)
2512
-        if (! $this->_registration->is_primary_registrant()) {
2513
-            $primary_registration = $this->_registration->get_primary_registration();
2514
-            $primary_attendee     = $primary_registration instanceof EE_Registration ? $primary_registration->attendee()
2515
-                : null;
2516
-            if (! $primary_attendee instanceof EE_Attendee || $attendee->ID() !== $primary_attendee->ID()) {
2517
-                // in here?  This means the displayed registration is not the primary registrant but ALREADY HAS its own
2518
-                // custom attendee object so let's not worry about the primary reg.
2519
-                $primary_registration = null;
2520
-            }
2521
-        } else {
2522
-            $primary_registration = null;
2523
-        }
2524
-        $this->_template_args['ATT_ID']            = $attendee->ID();
2525
-        $this->_template_args['fname']             = $attendee->fname();
2526
-        $this->_template_args['lname']             = $attendee->lname();
2527
-        $this->_template_args['email']             = $attendee->email();
2528
-        $this->_template_args['phone']             = $attendee->phone();
2529
-        $this->_template_args['formatted_address'] = EEH_Address::format($attendee);
2530
-        // edit link
2531
-        $this->_template_args['att_edit_link']  = EE_Admin_Page::add_query_args_and_nonce(
2532
-            [
2533
-                'action' => 'edit_attendee',
2534
-                'post'   => $attendee->ID(),
2535
-            ],
2536
-            REG_ADMIN_URL
2537
-        );
2538
-        $this->_template_args['att_edit_label'] = esc_html__('View/Edit Contact', 'event_espresso');
2539
-        // create link
2540
-        $this->_template_args['create_link']  = $primary_registration instanceof EE_Registration
2541
-            ? EE_Admin_Page::add_query_args_and_nonce(
2542
-                [
2543
-                    'action'  => 'duplicate_attendee',
2544
-                    '_REG_ID' => $this->_registration->ID(),
2545
-                ],
2546
-                REG_ADMIN_URL
2547
-            ) : '';
2548
-        $this->_template_args['create_label'] = esc_html__('Create Contact', 'event_espresso');
2549
-        $this->_template_args['att_check']    = $att_check;
2550
-        $template_path                        =
2551
-            REG_TEMPLATE_PATH . 'reg_admin_details_side_meta_box_registrant.template.php';
2552
-        EEH_Template::display_template($template_path, $this->_template_args);
2553
-    }
2554
-
2555
-
2556
-    /**
2557
-     * trash or restore registrations
2558
-     *
2559
-     * @param boolean $trash whether to archive or restore
2560
-     * @return void
2561
-     * @throws EE_Error
2562
-     * @throws InvalidArgumentException
2563
-     * @throws InvalidDataTypeException
2564
-     * @throws InvalidInterfaceException
2565
-     * @throws RuntimeException
2566
-     */
2567
-    protected function _trash_or_restore_registrations($trash = true)
2568
-    {
2569
-        // if empty _REG_ID then get out because there's nothing to do
2570
-        $REG_IDs = $this->request->getRequestParam('_REG_ID', [], 'int', true);
2571
-        if (empty($REG_IDs)) {
2572
-            EE_Error::add_error(
2573
-                sprintf(
2574
-                    esc_html__(
2575
-                        'In order to %1$s registrations you must select which ones you wish to %1$s by clicking the checkboxes.',
2576
-                        'event_espresso'
2577
-                    ),
2578
-                    $trash ? 'trash' : 'restore'
2579
-                ),
2580
-                __FILE__,
2581
-                __LINE__,
2582
-                __FUNCTION__
2583
-            );
2584
-            $this->_redirect_after_action(false, '', '', [], true);
2585
-        }
2586
-        $success        = 0;
2587
-        $overwrite_msgs = false;
2588
-        // Checkboxes
2589
-        $reg_count = count($REG_IDs);
2590
-        // cycle thru checkboxes
2591
-        foreach ($REG_IDs as $REG_ID) {
2592
-            /** @var EE_Registration $REG */
2593
-            $REG      = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
2594
-            $payments = $REG->registration_payments();
2595
-            if (! empty($payments)) {
2596
-                $name           = $REG->attendee() instanceof EE_Attendee
2597
-                    ? $REG->attendee()->full_name()
2598
-                    : esc_html__('Unknown Attendee', 'event_espresso');
2599
-                $overwrite_msgs = true;
2600
-                EE_Error::add_error(
2601
-                    sprintf(
2602
-                        esc_html__(
2603
-                            'The registration for %s could not be trashed because it has payments attached to the related transaction.  If you wish to trash this registration you must first delete the payments on the related transaction.',
2604
-                            'event_espresso'
2605
-                        ),
2606
-                        $name
2607
-                    ),
2608
-                    __FILE__,
2609
-                    __FUNCTION__,
2610
-                    __LINE__
2611
-                );
2612
-                // can't trash this registration because it has payments.
2613
-                continue;
2614
-            }
2615
-            $updated = $trash ? $REG->delete() : $REG->restore();
2616
-            if ($updated) {
2617
-                $success++;
2618
-            }
2619
-        }
2620
-        $this->_redirect_after_action(
2621
-            $success === $reg_count, // were ALL registrations affected?
2622
-            $success > 1
2623
-                ? esc_html__('Registrations', 'event_espresso')
2624
-                : esc_html__('Registration', 'event_espresso'),
2625
-            $trash
2626
-                ? esc_html__('moved to the trash', 'event_espresso')
2627
-                : esc_html__('restored', 'event_espresso'),
2628
-            $this->mergeExistingRequestParamsWithRedirectArgs(['action' => 'default']),
2629
-            $overwrite_msgs
2630
-        );
2631
-    }
2632
-
2633
-
2634
-    /**
2635
-     * This is used to permanently delete registrations.  Note, this will handle not only deleting permanently the
2636
-     * registration but also.
2637
-     * 1. Removing relations to EE_Attendee
2638
-     * 2. Deleting permanently the related transaction, but ONLY if all related registrations to the transaction are
2639
-     * ALSO trashed.
2640
-     * 3. Deleting permanently any related Line items but only if the above conditions are met.
2641
-     * 4. Removing relationships between all tickets and the related registrations
2642
-     * 5. Deleting permanently any related Answers (and the answers for other related registrations that were deleted.)
2643
-     * 6. Deleting permanently any related Checkins.
2644
-     *
2645
-     * @return void
2646
-     * @throws EE_Error
2647
-     * @throws InvalidArgumentException
2648
-     * @throws InvalidDataTypeException
2649
-     * @throws InvalidInterfaceException
2650
-     * @throws ReflectionException
2651
-     */
2652
-    protected function _delete_registrations()
2653
-    {
2654
-        $REG_MDL = $this->getRegistrationModel();
2655
-        $success = 0;
2656
-        // Checkboxes
2657
-        $REG_IDs = $this->request->getRequestParam('_REG_ID', [], 'int', true);
2658
-
2659
-        if (! empty($REG_IDs)) {
2660
-            // if array has more than one element than success message should be plural
2661
-            $success = count($REG_IDs) > 1 ? 2 : 1;
2662
-            // cycle thru checkboxes
2663
-            foreach ($REG_IDs as $REG_ID) {
2664
-                $REG = $REG_MDL->get_one_by_ID($REG_ID);
2665
-                if (! $REG instanceof EE_Registration) {
2666
-                    continue;
2667
-                }
2668
-                $deleted = $this->_delete_registration($REG);
2669
-                if (! $deleted) {
2670
-                    $success = 0;
2671
-                }
2672
-            }
2673
-        }
2674
-
2675
-        $what        = $success > 1
2676
-            ? esc_html__('Registrations', 'event_espresso')
2677
-            : esc_html__('Registration', 'event_espresso');
2678
-        $action_desc = esc_html__('permanently deleted.', 'event_espresso');
2679
-        $this->_redirect_after_action(
2680
-            $success,
2681
-            $what,
2682
-            $action_desc,
2683
-            $this->mergeExistingRequestParamsWithRedirectArgs(['action' => 'default']),
2684
-            true
2685
-        );
2686
-    }
2687
-
2688
-
2689
-    /**
2690
-     * handles the permanent deletion of a registration.  See comments with _delete_registrations() for details on what
2691
-     * models get affected.
2692
-     *
2693
-     * @param EE_Registration $REG registration to be deleted permanently
2694
-     * @return bool true = successful deletion, false = fail.
2695
-     * @throws EE_Error
2696
-     * @throws InvalidArgumentException
2697
-     * @throws InvalidDataTypeException
2698
-     * @throws InvalidInterfaceException
2699
-     * @throws ReflectionException
2700
-     */
2701
-    protected function _delete_registration(EE_Registration $REG)
2702
-    {
2703
-        // first we start with the transaction... ultimately, we WILL not delete permanently if there are any related
2704
-        // registrations on the transaction that are NOT trashed.
2705
-        $TXN = $REG->get_first_related('Transaction');
2706
-        if (! $TXN instanceof EE_Transaction) {
2707
-            EE_Error::add_error(
2708
-                sprintf(
2709
-                    esc_html__(
2710
-                        'Unable to permanently delete registration %d because its related transaction has already been deleted. If you can restore the related transaction to the database then this registration can be deleted.',
2711
-                        'event_espresso'
2712
-                    ),
2713
-                    $REG->id()
2714
-                ),
2715
-                __FILE__,
2716
-                __FUNCTION__,
2717
-                __LINE__
2718
-            );
2719
-            return false;
2720
-        }
2721
-        $REGS        = $TXN->get_many_related('Registration');
2722
-        $all_trashed = true;
2723
-        foreach ($REGS as $registration) {
2724
-            if (! $registration->get('REG_deleted')) {
2725
-                $all_trashed = false;
2726
-            }
2727
-        }
2728
-        if (! $all_trashed) {
2729
-            EE_Error::add_error(
2730
-                esc_html__(
2731
-                    'Unable to permanently delete this registration. Before this registration can be permanently deleted, all registrations made in the same transaction must be trashed as well.  These registrations will be permanently deleted in the same action.',
2732
-                    'event_espresso'
2733
-                ),
2734
-                __FILE__,
2735
-                __FUNCTION__,
2736
-                __LINE__
2737
-            );
2738
-            return false;
2739
-        }
2740
-        // k made it here so that means we can delete all the related transactions and their answers (but let's do them
2741
-        // separately from THIS one).
2742
-        foreach ($REGS as $registration) {
2743
-            // delete related answers
2744
-            $registration->delete_related_permanently('Answer');
2745
-            // remove relationship to EE_Attendee (but we ALWAYS leave the contact record intact)
2746
-            $attendee = $registration->get_first_related('Attendee');
2747
-            if ($attendee instanceof EE_Attendee) {
2748
-                $registration->_remove_relation_to($attendee, 'Attendee');
2749
-            }
2750
-            // now remove relationships to tickets on this registration.
2751
-            $registration->_remove_relations('Ticket');
2752
-            // now delete permanently the checkins related to this registration.
2753
-            $registration->delete_related_permanently('Checkin');
2754
-            if ($registration->ID() === $REG->ID()) {
2755
-                continue;
2756
-            } //we don't want to delete permanently the existing registration just yet.
2757
-            // remove relation to transaction for these registrations if NOT the existing registrations
2758
-            $registration->_remove_relations('Transaction');
2759
-            // delete permanently any related messages.
2760
-            $registration->delete_related_permanently('Message');
2761
-            // now delete this registration permanently
2762
-            $registration->delete_permanently();
2763
-        }
2764
-        // now all related registrations on the transaction are handled.  So let's just handle this registration itself
2765
-        // (the transaction and line items should be all that's left).
2766
-        // delete the line items related to the transaction for this registration.
2767
-        $TXN->delete_related_permanently('Line_Item');
2768
-        // we need to remove all the relationships on the transaction
2769
-        $TXN->delete_related_permanently('Payment');
2770
-        $TXN->delete_related_permanently('Extra_Meta');
2771
-        $TXN->delete_related_permanently('Message');
2772
-        // now we can delete this REG permanently (and the transaction of course)
2773
-        $REG->delete_related_permanently('Transaction');
2774
-        return $REG->delete_permanently();
2775
-    }
2776
-
2777
-
2778
-    /**
2779
-     *    generates HTML for the Register New Attendee Admin page
2780
-     *
2781
-     * @throws DomainException
2782
-     * @throws EE_Error
2783
-     * @throws InvalidArgumentException
2784
-     * @throws InvalidDataTypeException
2785
-     * @throws InvalidInterfaceException
2786
-     * @throws ReflectionException
2787
-     */
2788
-    public function new_registration()
2789
-    {
2790
-        if (! $this->_set_reg_event()) {
2791
-            throw new EE_Error(
2792
-                esc_html__(
2793
-                    'Unable to continue with registering because there is no Event ID in the request',
2794
-                    'event_espresso'
2795
-                )
2796
-            );
2797
-        }
2798
-        /** @var CurrentPage $current_page */
2799
-        $current_page = $this->loader->getShared(CurrentPage::class);
2800
-        $current_page->setEspressoPage(true);
2801
-        // gotta start with a clean slate if we're not coming here via ajax
2802
-        if (
2803
-            ! $this->request->isAjax()
2804
-            && (
2805
-                ! $this->request->requestParamIsSet('processing_registration')
2806
-                || $this->request->requestParamIsSet('step_error')
2807
-            )
2808
-        ) {
2809
-            EE_Registry::instance()->SSN->clear_session(__CLASS__, __FUNCTION__);
2810
-        }
2811
-        $this->_template_args['event_name'] = '';
2812
-        // event name
2813
-        if ($this->_reg_event) {
2814
-            $this->_template_args['event_name'] = $this->_reg_event->name();
2815
-            $edit_event_url                     = self::add_query_args_and_nonce(
2816
-                [
2817
-                    'action' => 'edit',
2818
-                    'post'   => $this->_reg_event->ID(),
2819
-                ],
2820
-                EVENTS_ADMIN_URL
2821
-            );
2822
-            $edit_event_lnk                     = '<a href="'
2823
-                                                  . $edit_event_url
2824
-                                                  . '" title="'
2825
-                                                  . esc_attr__('Edit ', 'event_espresso')
2826
-                                                  . $this->_reg_event->name()
2827
-                                                  . '">'
2828
-                                                  . esc_html__('Edit Event', 'event_espresso')
2829
-                                                  . '</a>';
2830
-            $this->_template_args['event_name'] .= ' <span class="admin-page-header-edit-lnk not-bold">'
2831
-                                                   . $edit_event_lnk
2832
-                                                   . '</span>';
2833
-        }
2834
-        $this->_template_args['step_content'] = $this->_get_registration_step_content();
2835
-        if ($this->request->isAjax()) {
2836
-            $this->_return_json();
2837
-        }
2838
-        // grab header
2839
-        $template_path                              =
2840
-            REG_TEMPLATE_PATH . 'reg_admin_register_new_attendee.template.php';
2841
-        $this->_template_args['admin_page_content'] = EEH_Template::display_template(
2842
-            $template_path,
2843
-            $this->_template_args,
2844
-            true
2845
-        );
2846
-        // $this->_set_publish_post_box_vars( NULL, FALSE, FALSE, NULL, FALSE );
2847
-        // the details template wrapper
2848
-        $this->display_admin_page_with_sidebar();
2849
-    }
2850
-
2851
-
2852
-    /**
2853
-     * This returns the content for a registration step
2854
-     *
2855
-     * @return string html
2856
-     * @throws DomainException
2857
-     * @throws EE_Error
2858
-     * @throws InvalidArgumentException
2859
-     * @throws InvalidDataTypeException
2860
-     * @throws InvalidInterfaceException
2861
-     * @throws ReflectionException
2862
-     */
2863
-    protected function _get_registration_step_content()
2864
-    {
2865
-        if (isset($_COOKIE['ee_registration_added']) && $_COOKIE['ee_registration_added']) {
2866
-            $warning_msg = sprintf(
2867
-                esc_html__(
2868
-                    '%2$sWARNING!!!%3$s%1$sPlease do not use the back button to return to this page for the purpose of adding another registration.%1$sThis can result in lost and/or corrupted data.%1$sIf you wish to add another registration, then please click the%1$s%7$s"Add Another New Registration to Event"%8$s button%1$son the Transaction details page, after you are redirected.%1$s%1$s%4$s redirecting in %5$s seconds %6$s',
2869
-                    'event_espresso'
2870
-                ),
2871
-                '<br />',
2872
-                '<h3 class="important-notice">',
2873
-                '</h3>',
2874
-                '<div class="float-right">',
2875
-                '<span id="redirect_timer" class="important-notice">30</span>',
2876
-                '</div>',
2877
-                '<b>',
2878
-                '</b>'
2879
-            );
2880
-            return '
2300
+	}
2301
+
2302
+
2303
+	/**
2304
+	 * Updates the registration's custom questions according to the form info, if the form is submitted.
2305
+	 * If it's not a post, the "view_registrations" route will be called next on the SAME request
2306
+	 * to display the page
2307
+	 *
2308
+	 * @return void
2309
+	 * @throws EE_Error
2310
+	 * @throws InvalidArgumentException
2311
+	 * @throws InvalidDataTypeException
2312
+	 * @throws InvalidInterfaceException
2313
+	 * @throws ReflectionException
2314
+	 */
2315
+	protected function _update_attendee_registration_form()
2316
+	{
2317
+		do_action('AHEE__Registrations_Admin_Page___update_attendee_registration_form__start', $this);
2318
+		if ($_SERVER['REQUEST_METHOD'] === 'POST') {
2319
+			$REG_ID  = $this->request->getRequestParam('_REG_ID', 0, 'int');
2320
+			$success = $this->_save_reg_custom_questions_form($REG_ID);
2321
+			if ($success) {
2322
+				$what  = esc_html__('Registration Form', 'event_espresso');
2323
+				$route = $REG_ID
2324
+					? ['action' => 'view_registration', '_REG_ID' => $REG_ID]
2325
+					: ['action' => 'default'];
2326
+				$this->_redirect_after_action(true, $what, esc_html__('updated', 'event_espresso'), $route);
2327
+			}
2328
+		}
2329
+	}
2330
+
2331
+
2332
+	/**
2333
+	 * Gets the form for saving registrations custom questions (if done
2334
+	 * previously retrieves the cached form object, which may have validation errors in it)
2335
+	 *
2336
+	 * @param int $REG_ID
2337
+	 * @return EE_Registration_Custom_Questions_Form
2338
+	 * @throws EE_Error
2339
+	 * @throws InvalidArgumentException
2340
+	 * @throws InvalidDataTypeException
2341
+	 * @throws InvalidInterfaceException
2342
+	 * @throws ReflectionException
2343
+	 */
2344
+	protected function _get_reg_custom_questions_form($REG_ID)
2345
+	{
2346
+		if (! $this->_reg_custom_questions_form) {
2347
+			require_once(REG_ADMIN . 'form_sections/EE_Registration_Custom_Questions_Form.form.php');
2348
+			$this->_reg_custom_questions_form = new EE_Registration_Custom_Questions_Form(
2349
+				$this->getRegistrationModel()->get_one_by_ID($REG_ID)
2350
+			);
2351
+			$this->_reg_custom_questions_form->_construct_finalize(null, null);
2352
+		}
2353
+		return $this->_reg_custom_questions_form;
2354
+	}
2355
+
2356
+
2357
+	/**
2358
+	 * Saves
2359
+	 *
2360
+	 * @param bool $REG_ID
2361
+	 * @return bool
2362
+	 * @throws EE_Error
2363
+	 * @throws InvalidArgumentException
2364
+	 * @throws InvalidDataTypeException
2365
+	 * @throws InvalidInterfaceException
2366
+	 * @throws ReflectionException
2367
+	 */
2368
+	private function _save_reg_custom_questions_form($REG_ID = 0)
2369
+	{
2370
+		if (! $REG_ID) {
2371
+			EE_Error::add_error(
2372
+				esc_html__(
2373
+					'An error occurred. No registration ID was received.',
2374
+					'event_espresso'
2375
+				),
2376
+				__FILE__,
2377
+				__FUNCTION__,
2378
+				__LINE__
2379
+			);
2380
+		}
2381
+		$form = $this->_get_reg_custom_questions_form($REG_ID);
2382
+		$form->receive_form_submission($this->request->requestParams());
2383
+		$success = false;
2384
+		if ($form->is_valid()) {
2385
+			foreach ($form->subforms() as $question_group_form) {
2386
+				foreach ($question_group_form->inputs() as $question_id => $input) {
2387
+					$where_conditions    = [
2388
+						'QST_ID' => $question_id,
2389
+						'REG_ID' => $REG_ID,
2390
+					];
2391
+					$possibly_new_values = [
2392
+						'ANS_value' => $input->normalized_value(),
2393
+					];
2394
+					$answer              = EEM_Answer::instance()->get_one([$where_conditions]);
2395
+					if ($answer instanceof EE_Answer) {
2396
+						$success = $answer->save($possibly_new_values);
2397
+					} else {
2398
+						// insert it then
2399
+						$cols_n_vals = array_merge($where_conditions, $possibly_new_values);
2400
+						$answer      = EE_Answer::new_instance($cols_n_vals);
2401
+						$success     = $answer->save();
2402
+					}
2403
+				}
2404
+			}
2405
+		} else {
2406
+			EE_Error::add_error($form->get_validation_error_string(), __FILE__, __FUNCTION__, __LINE__);
2407
+		}
2408
+		return $success;
2409
+	}
2410
+
2411
+
2412
+	/**
2413
+	 * generates HTML for the Registration main meta box
2414
+	 *
2415
+	 * @return void
2416
+	 * @throws DomainException
2417
+	 * @throws EE_Error
2418
+	 * @throws InvalidArgumentException
2419
+	 * @throws InvalidDataTypeException
2420
+	 * @throws InvalidInterfaceException
2421
+	 * @throws ReflectionException
2422
+	 */
2423
+	public function _reg_attendees_meta_box()
2424
+	{
2425
+		$REG = $this->getRegistrationModel();
2426
+		// get all other registrations on this transaction, and cache
2427
+		// the attendees for them so we don't have to run another query using force_join
2428
+		$registrations                           = $REG->get_all(
2429
+			[
2430
+				[
2431
+					'TXN_ID' => $this->_registration->transaction_ID(),
2432
+					'REG_ID' => ['!=', $this->_registration->ID()],
2433
+				],
2434
+				'force_join'               => ['Attendee'],
2435
+				'default_where_conditions' => 'other_models_only',
2436
+			]
2437
+		);
2438
+		$this->_template_args['attendees']       = [];
2439
+		$this->_template_args['attendee_notice'] = '';
2440
+		if (
2441
+			empty($registrations)
2442
+			|| (is_array($registrations)
2443
+				&& ! EEH_Array::get_one_item_from_array($registrations))
2444
+		) {
2445
+			EE_Error::add_error(
2446
+				esc_html__(
2447
+					'There are no records attached to this registration. Something may have gone wrong with the registration',
2448
+					'event_espresso'
2449
+				),
2450
+				__FILE__,
2451
+				__FUNCTION__,
2452
+				__LINE__
2453
+			);
2454
+			$this->_template_args['attendee_notice'] = EE_Error::get_notices();
2455
+		} else {
2456
+			$att_nmbr = 1;
2457
+			foreach ($registrations as $registration) {
2458
+				/* @var $registration EE_Registration */
2459
+				$attendee                                                      = $registration->attendee()
2460
+					? $registration->attendee()
2461
+					: $this->getAttendeeModel()->create_default_object();
2462
+				$this->_template_args['attendees'][ $att_nmbr ]['STS_ID']      = $registration->status_ID();
2463
+				$this->_template_args['attendees'][ $att_nmbr ]['fname']       = $attendee->fname();
2464
+				$this->_template_args['attendees'][ $att_nmbr ]['lname']       = $attendee->lname();
2465
+				$this->_template_args['attendees'][ $att_nmbr ]['email']       = $attendee->email();
2466
+				$this->_template_args['attendees'][ $att_nmbr ]['final_price'] = $registration->final_price();
2467
+				$this->_template_args['attendees'][ $att_nmbr ]['address']     = implode(
2468
+					', ',
2469
+					$attendee->full_address_as_array()
2470
+				);
2471
+				$this->_template_args['attendees'][ $att_nmbr ]['att_link']    = self::add_query_args_and_nonce(
2472
+					[
2473
+						'action' => 'edit_attendee',
2474
+						'post'   => $attendee->ID(),
2475
+					],
2476
+					REG_ADMIN_URL
2477
+				);
2478
+				$this->_template_args['attendees'][ $att_nmbr ]['event_name']  =
2479
+					$registration->event_obj() instanceof EE_Event
2480
+						? $registration->event_obj()->name()
2481
+						: '';
2482
+				$att_nmbr++;
2483
+			}
2484
+			$this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
2485
+		}
2486
+		$template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_attendees.template.php';
2487
+		EEH_Template::display_template($template_path, $this->_template_args);
2488
+	}
2489
+
2490
+
2491
+	/**
2492
+	 * generates HTML for the Edit Registration side meta box
2493
+	 *
2494
+	 * @return void
2495
+	 * @throws DomainException
2496
+	 * @throws EE_Error
2497
+	 * @throws InvalidArgumentException
2498
+	 * @throws InvalidDataTypeException
2499
+	 * @throws InvalidInterfaceException
2500
+	 * @throws ReflectionException
2501
+	 */
2502
+	public function _reg_registrant_side_meta_box()
2503
+	{
2504
+		/*@var $attendee EE_Attendee */
2505
+		$att_check = $this->_registration->attendee();
2506
+		$attendee  = $att_check instanceof EE_Attendee
2507
+			? $att_check
2508
+			: $this->getAttendeeModel()->create_default_object();
2509
+		// now let's determine if this is not the primary registration.  If it isn't then we set the
2510
+		// primary_registration object for reference BUT ONLY if the Attendee object loaded is not the same as the
2511
+		// primary registration object (that way we know if we need to show create button or not)
2512
+		if (! $this->_registration->is_primary_registrant()) {
2513
+			$primary_registration = $this->_registration->get_primary_registration();
2514
+			$primary_attendee     = $primary_registration instanceof EE_Registration ? $primary_registration->attendee()
2515
+				: null;
2516
+			if (! $primary_attendee instanceof EE_Attendee || $attendee->ID() !== $primary_attendee->ID()) {
2517
+				// in here?  This means the displayed registration is not the primary registrant but ALREADY HAS its own
2518
+				// custom attendee object so let's not worry about the primary reg.
2519
+				$primary_registration = null;
2520
+			}
2521
+		} else {
2522
+			$primary_registration = null;
2523
+		}
2524
+		$this->_template_args['ATT_ID']            = $attendee->ID();
2525
+		$this->_template_args['fname']             = $attendee->fname();
2526
+		$this->_template_args['lname']             = $attendee->lname();
2527
+		$this->_template_args['email']             = $attendee->email();
2528
+		$this->_template_args['phone']             = $attendee->phone();
2529
+		$this->_template_args['formatted_address'] = EEH_Address::format($attendee);
2530
+		// edit link
2531
+		$this->_template_args['att_edit_link']  = EE_Admin_Page::add_query_args_and_nonce(
2532
+			[
2533
+				'action' => 'edit_attendee',
2534
+				'post'   => $attendee->ID(),
2535
+			],
2536
+			REG_ADMIN_URL
2537
+		);
2538
+		$this->_template_args['att_edit_label'] = esc_html__('View/Edit Contact', 'event_espresso');
2539
+		// create link
2540
+		$this->_template_args['create_link']  = $primary_registration instanceof EE_Registration
2541
+			? EE_Admin_Page::add_query_args_and_nonce(
2542
+				[
2543
+					'action'  => 'duplicate_attendee',
2544
+					'_REG_ID' => $this->_registration->ID(),
2545
+				],
2546
+				REG_ADMIN_URL
2547
+			) : '';
2548
+		$this->_template_args['create_label'] = esc_html__('Create Contact', 'event_espresso');
2549
+		$this->_template_args['att_check']    = $att_check;
2550
+		$template_path                        =
2551
+			REG_TEMPLATE_PATH . 'reg_admin_details_side_meta_box_registrant.template.php';
2552
+		EEH_Template::display_template($template_path, $this->_template_args);
2553
+	}
2554
+
2555
+
2556
+	/**
2557
+	 * trash or restore registrations
2558
+	 *
2559
+	 * @param boolean $trash whether to archive or restore
2560
+	 * @return void
2561
+	 * @throws EE_Error
2562
+	 * @throws InvalidArgumentException
2563
+	 * @throws InvalidDataTypeException
2564
+	 * @throws InvalidInterfaceException
2565
+	 * @throws RuntimeException
2566
+	 */
2567
+	protected function _trash_or_restore_registrations($trash = true)
2568
+	{
2569
+		// if empty _REG_ID then get out because there's nothing to do
2570
+		$REG_IDs = $this->request->getRequestParam('_REG_ID', [], 'int', true);
2571
+		if (empty($REG_IDs)) {
2572
+			EE_Error::add_error(
2573
+				sprintf(
2574
+					esc_html__(
2575
+						'In order to %1$s registrations you must select which ones you wish to %1$s by clicking the checkboxes.',
2576
+						'event_espresso'
2577
+					),
2578
+					$trash ? 'trash' : 'restore'
2579
+				),
2580
+				__FILE__,
2581
+				__LINE__,
2582
+				__FUNCTION__
2583
+			);
2584
+			$this->_redirect_after_action(false, '', '', [], true);
2585
+		}
2586
+		$success        = 0;
2587
+		$overwrite_msgs = false;
2588
+		// Checkboxes
2589
+		$reg_count = count($REG_IDs);
2590
+		// cycle thru checkboxes
2591
+		foreach ($REG_IDs as $REG_ID) {
2592
+			/** @var EE_Registration $REG */
2593
+			$REG      = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
2594
+			$payments = $REG->registration_payments();
2595
+			if (! empty($payments)) {
2596
+				$name           = $REG->attendee() instanceof EE_Attendee
2597
+					? $REG->attendee()->full_name()
2598
+					: esc_html__('Unknown Attendee', 'event_espresso');
2599
+				$overwrite_msgs = true;
2600
+				EE_Error::add_error(
2601
+					sprintf(
2602
+						esc_html__(
2603
+							'The registration for %s could not be trashed because it has payments attached to the related transaction.  If you wish to trash this registration you must first delete the payments on the related transaction.',
2604
+							'event_espresso'
2605
+						),
2606
+						$name
2607
+					),
2608
+					__FILE__,
2609
+					__FUNCTION__,
2610
+					__LINE__
2611
+				);
2612
+				// can't trash this registration because it has payments.
2613
+				continue;
2614
+			}
2615
+			$updated = $trash ? $REG->delete() : $REG->restore();
2616
+			if ($updated) {
2617
+				$success++;
2618
+			}
2619
+		}
2620
+		$this->_redirect_after_action(
2621
+			$success === $reg_count, // were ALL registrations affected?
2622
+			$success > 1
2623
+				? esc_html__('Registrations', 'event_espresso')
2624
+				: esc_html__('Registration', 'event_espresso'),
2625
+			$trash
2626
+				? esc_html__('moved to the trash', 'event_espresso')
2627
+				: esc_html__('restored', 'event_espresso'),
2628
+			$this->mergeExistingRequestParamsWithRedirectArgs(['action' => 'default']),
2629
+			$overwrite_msgs
2630
+		);
2631
+	}
2632
+
2633
+
2634
+	/**
2635
+	 * This is used to permanently delete registrations.  Note, this will handle not only deleting permanently the
2636
+	 * registration but also.
2637
+	 * 1. Removing relations to EE_Attendee
2638
+	 * 2. Deleting permanently the related transaction, but ONLY if all related registrations to the transaction are
2639
+	 * ALSO trashed.
2640
+	 * 3. Deleting permanently any related Line items but only if the above conditions are met.
2641
+	 * 4. Removing relationships between all tickets and the related registrations
2642
+	 * 5. Deleting permanently any related Answers (and the answers for other related registrations that were deleted.)
2643
+	 * 6. Deleting permanently any related Checkins.
2644
+	 *
2645
+	 * @return void
2646
+	 * @throws EE_Error
2647
+	 * @throws InvalidArgumentException
2648
+	 * @throws InvalidDataTypeException
2649
+	 * @throws InvalidInterfaceException
2650
+	 * @throws ReflectionException
2651
+	 */
2652
+	protected function _delete_registrations()
2653
+	{
2654
+		$REG_MDL = $this->getRegistrationModel();
2655
+		$success = 0;
2656
+		// Checkboxes
2657
+		$REG_IDs = $this->request->getRequestParam('_REG_ID', [], 'int', true);
2658
+
2659
+		if (! empty($REG_IDs)) {
2660
+			// if array has more than one element than success message should be plural
2661
+			$success = count($REG_IDs) > 1 ? 2 : 1;
2662
+			// cycle thru checkboxes
2663
+			foreach ($REG_IDs as $REG_ID) {
2664
+				$REG = $REG_MDL->get_one_by_ID($REG_ID);
2665
+				if (! $REG instanceof EE_Registration) {
2666
+					continue;
2667
+				}
2668
+				$deleted = $this->_delete_registration($REG);
2669
+				if (! $deleted) {
2670
+					$success = 0;
2671
+				}
2672
+			}
2673
+		}
2674
+
2675
+		$what        = $success > 1
2676
+			? esc_html__('Registrations', 'event_espresso')
2677
+			: esc_html__('Registration', 'event_espresso');
2678
+		$action_desc = esc_html__('permanently deleted.', 'event_espresso');
2679
+		$this->_redirect_after_action(
2680
+			$success,
2681
+			$what,
2682
+			$action_desc,
2683
+			$this->mergeExistingRequestParamsWithRedirectArgs(['action' => 'default']),
2684
+			true
2685
+		);
2686
+	}
2687
+
2688
+
2689
+	/**
2690
+	 * handles the permanent deletion of a registration.  See comments with _delete_registrations() for details on what
2691
+	 * models get affected.
2692
+	 *
2693
+	 * @param EE_Registration $REG registration to be deleted permanently
2694
+	 * @return bool true = successful deletion, false = fail.
2695
+	 * @throws EE_Error
2696
+	 * @throws InvalidArgumentException
2697
+	 * @throws InvalidDataTypeException
2698
+	 * @throws InvalidInterfaceException
2699
+	 * @throws ReflectionException
2700
+	 */
2701
+	protected function _delete_registration(EE_Registration $REG)
2702
+	{
2703
+		// first we start with the transaction... ultimately, we WILL not delete permanently if there are any related
2704
+		// registrations on the transaction that are NOT trashed.
2705
+		$TXN = $REG->get_first_related('Transaction');
2706
+		if (! $TXN instanceof EE_Transaction) {
2707
+			EE_Error::add_error(
2708
+				sprintf(
2709
+					esc_html__(
2710
+						'Unable to permanently delete registration %d because its related transaction has already been deleted. If you can restore the related transaction to the database then this registration can be deleted.',
2711
+						'event_espresso'
2712
+					),
2713
+					$REG->id()
2714
+				),
2715
+				__FILE__,
2716
+				__FUNCTION__,
2717
+				__LINE__
2718
+			);
2719
+			return false;
2720
+		}
2721
+		$REGS        = $TXN->get_many_related('Registration');
2722
+		$all_trashed = true;
2723
+		foreach ($REGS as $registration) {
2724
+			if (! $registration->get('REG_deleted')) {
2725
+				$all_trashed = false;
2726
+			}
2727
+		}
2728
+		if (! $all_trashed) {
2729
+			EE_Error::add_error(
2730
+				esc_html__(
2731
+					'Unable to permanently delete this registration. Before this registration can be permanently deleted, all registrations made in the same transaction must be trashed as well.  These registrations will be permanently deleted in the same action.',
2732
+					'event_espresso'
2733
+				),
2734
+				__FILE__,
2735
+				__FUNCTION__,
2736
+				__LINE__
2737
+			);
2738
+			return false;
2739
+		}
2740
+		// k made it here so that means we can delete all the related transactions and their answers (but let's do them
2741
+		// separately from THIS one).
2742
+		foreach ($REGS as $registration) {
2743
+			// delete related answers
2744
+			$registration->delete_related_permanently('Answer');
2745
+			// remove relationship to EE_Attendee (but we ALWAYS leave the contact record intact)
2746
+			$attendee = $registration->get_first_related('Attendee');
2747
+			if ($attendee instanceof EE_Attendee) {
2748
+				$registration->_remove_relation_to($attendee, 'Attendee');
2749
+			}
2750
+			// now remove relationships to tickets on this registration.
2751
+			$registration->_remove_relations('Ticket');
2752
+			// now delete permanently the checkins related to this registration.
2753
+			$registration->delete_related_permanently('Checkin');
2754
+			if ($registration->ID() === $REG->ID()) {
2755
+				continue;
2756
+			} //we don't want to delete permanently the existing registration just yet.
2757
+			// remove relation to transaction for these registrations if NOT the existing registrations
2758
+			$registration->_remove_relations('Transaction');
2759
+			// delete permanently any related messages.
2760
+			$registration->delete_related_permanently('Message');
2761
+			// now delete this registration permanently
2762
+			$registration->delete_permanently();
2763
+		}
2764
+		// now all related registrations on the transaction are handled.  So let's just handle this registration itself
2765
+		// (the transaction and line items should be all that's left).
2766
+		// delete the line items related to the transaction for this registration.
2767
+		$TXN->delete_related_permanently('Line_Item');
2768
+		// we need to remove all the relationships on the transaction
2769
+		$TXN->delete_related_permanently('Payment');
2770
+		$TXN->delete_related_permanently('Extra_Meta');
2771
+		$TXN->delete_related_permanently('Message');
2772
+		// now we can delete this REG permanently (and the transaction of course)
2773
+		$REG->delete_related_permanently('Transaction');
2774
+		return $REG->delete_permanently();
2775
+	}
2776
+
2777
+
2778
+	/**
2779
+	 *    generates HTML for the Register New Attendee Admin page
2780
+	 *
2781
+	 * @throws DomainException
2782
+	 * @throws EE_Error
2783
+	 * @throws InvalidArgumentException
2784
+	 * @throws InvalidDataTypeException
2785
+	 * @throws InvalidInterfaceException
2786
+	 * @throws ReflectionException
2787
+	 */
2788
+	public function new_registration()
2789
+	{
2790
+		if (! $this->_set_reg_event()) {
2791
+			throw new EE_Error(
2792
+				esc_html__(
2793
+					'Unable to continue with registering because there is no Event ID in the request',
2794
+					'event_espresso'
2795
+				)
2796
+			);
2797
+		}
2798
+		/** @var CurrentPage $current_page */
2799
+		$current_page = $this->loader->getShared(CurrentPage::class);
2800
+		$current_page->setEspressoPage(true);
2801
+		// gotta start with a clean slate if we're not coming here via ajax
2802
+		if (
2803
+			! $this->request->isAjax()
2804
+			&& (
2805
+				! $this->request->requestParamIsSet('processing_registration')
2806
+				|| $this->request->requestParamIsSet('step_error')
2807
+			)
2808
+		) {
2809
+			EE_Registry::instance()->SSN->clear_session(__CLASS__, __FUNCTION__);
2810
+		}
2811
+		$this->_template_args['event_name'] = '';
2812
+		// event name
2813
+		if ($this->_reg_event) {
2814
+			$this->_template_args['event_name'] = $this->_reg_event->name();
2815
+			$edit_event_url                     = self::add_query_args_and_nonce(
2816
+				[
2817
+					'action' => 'edit',
2818
+					'post'   => $this->_reg_event->ID(),
2819
+				],
2820
+				EVENTS_ADMIN_URL
2821
+			);
2822
+			$edit_event_lnk                     = '<a href="'
2823
+												  . $edit_event_url
2824
+												  . '" title="'
2825
+												  . esc_attr__('Edit ', 'event_espresso')
2826
+												  . $this->_reg_event->name()
2827
+												  . '">'
2828
+												  . esc_html__('Edit Event', 'event_espresso')
2829
+												  . '</a>';
2830
+			$this->_template_args['event_name'] .= ' <span class="admin-page-header-edit-lnk not-bold">'
2831
+												   . $edit_event_lnk
2832
+												   . '</span>';
2833
+		}
2834
+		$this->_template_args['step_content'] = $this->_get_registration_step_content();
2835
+		if ($this->request->isAjax()) {
2836
+			$this->_return_json();
2837
+		}
2838
+		// grab header
2839
+		$template_path                              =
2840
+			REG_TEMPLATE_PATH . 'reg_admin_register_new_attendee.template.php';
2841
+		$this->_template_args['admin_page_content'] = EEH_Template::display_template(
2842
+			$template_path,
2843
+			$this->_template_args,
2844
+			true
2845
+		);
2846
+		// $this->_set_publish_post_box_vars( NULL, FALSE, FALSE, NULL, FALSE );
2847
+		// the details template wrapper
2848
+		$this->display_admin_page_with_sidebar();
2849
+	}
2850
+
2851
+
2852
+	/**
2853
+	 * This returns the content for a registration step
2854
+	 *
2855
+	 * @return string html
2856
+	 * @throws DomainException
2857
+	 * @throws EE_Error
2858
+	 * @throws InvalidArgumentException
2859
+	 * @throws InvalidDataTypeException
2860
+	 * @throws InvalidInterfaceException
2861
+	 * @throws ReflectionException
2862
+	 */
2863
+	protected function _get_registration_step_content()
2864
+	{
2865
+		if (isset($_COOKIE['ee_registration_added']) && $_COOKIE['ee_registration_added']) {
2866
+			$warning_msg = sprintf(
2867
+				esc_html__(
2868
+					'%2$sWARNING!!!%3$s%1$sPlease do not use the back button to return to this page for the purpose of adding another registration.%1$sThis can result in lost and/or corrupted data.%1$sIf you wish to add another registration, then please click the%1$s%7$s"Add Another New Registration to Event"%8$s button%1$son the Transaction details page, after you are redirected.%1$s%1$s%4$s redirecting in %5$s seconds %6$s',
2869
+					'event_espresso'
2870
+				),
2871
+				'<br />',
2872
+				'<h3 class="important-notice">',
2873
+				'</h3>',
2874
+				'<div class="float-right">',
2875
+				'<span id="redirect_timer" class="important-notice">30</span>',
2876
+				'</div>',
2877
+				'<b>',
2878
+				'</b>'
2879
+			);
2880
+			return '
2881 2881
 	<div id="ee-add-reg-back-button-dv"><p>' . $warning_msg . '</p></div>
2882 2882
 	<script >
2883 2883
 		// WHOAH !!! it appears that someone is using the back button from the Transaction admin page
@@ -2890,851 +2890,851 @@  discard block
 block discarded – undo
2890 2890
 	        }
2891 2891
 	    }, 800 );
2892 2892
 	</script >';
2893
-        }
2894
-        $template_args = [
2895
-            'title'                    => '',
2896
-            'content'                  => '',
2897
-            'step_button_text'         => '',
2898
-            'show_notification_toggle' => false,
2899
-        ];
2900
-        // to indicate we're processing a new registration
2901
-        $hidden_fields = [
2902
-            'processing_registration' => [
2903
-                'type'  => 'hidden',
2904
-                'value' => 0,
2905
-            ],
2906
-            'event_id'                => [
2907
-                'type'  => 'hidden',
2908
-                'value' => $this->_reg_event->ID(),
2909
-            ],
2910
-        ];
2911
-        // if the cart is empty then we know we're at step one, so we'll display the ticket selector
2912
-        $cart = EE_Registry::instance()->SSN->cart();
2913
-        $step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
2914
-        switch ($step) {
2915
-            case 'ticket':
2916
-                $hidden_fields['processing_registration']['value'] = 1;
2917
-                $template_args['title']                            = esc_html__(
2918
-                    'Step One: Select the Ticket for this registration',
2919
-                    'event_espresso'
2920
-                );
2921
-                $template_args['content']                          =
2922
-                    EED_Ticket_Selector::instance()->display_ticket_selector($this->_reg_event);
2923
-                $template_args['content']                          .= '</div>';
2924
-                $template_args['step_button_text']                 = esc_html__(
2925
-                    'Add Tickets and Continue to Registrant Details',
2926
-                    'event_espresso'
2927
-                );
2928
-                $template_args['show_notification_toggle']         = false;
2929
-                break;
2930
-            case 'questions':
2931
-                $hidden_fields['processing_registration']['value'] = 2;
2932
-                $template_args['title']                            = esc_html__(
2933
-                    'Step Two: Add Registrant Details for this Registration',
2934
-                    'event_espresso'
2935
-                );
2936
-                // in theory, we should be able to run EED_SPCO at this point
2937
-                // because the cart should have been set up properly by the first process_reg_step run.
2938
-                $template_args['content']                  =
2939
-                    EED_Single_Page_Checkout::registration_checkout_for_admin();
2940
-                $template_args['step_button_text']         = esc_html__(
2941
-                    'Save Registration and Continue to Details',
2942
-                    'event_espresso'
2943
-                );
2944
-                $template_args['show_notification_toggle'] = true;
2945
-                break;
2946
-        }
2947
-        // we come back to the process_registration_step route.
2948
-        $this->_set_add_edit_form_tags('process_reg_step', $hidden_fields);
2949
-        return EEH_Template::display_template(
2950
-            REG_TEMPLATE_PATH . 'reg_admin_register_new_attendee_step_content.template.php',
2951
-            $template_args,
2952
-            true
2953
-        );
2954
-    }
2955
-
2956
-
2957
-    /**
2958
-     * set_reg_event
2959
-     *
2960
-     * @return bool
2961
-     * @throws EE_Error
2962
-     * @throws InvalidArgumentException
2963
-     * @throws InvalidDataTypeException
2964
-     * @throws InvalidInterfaceException
2965
-     */
2966
-    private function _set_reg_event()
2967
-    {
2968
-        if (is_object($this->_reg_event)) {
2969
-            return true;
2970
-        }
2971
-
2972
-        $EVT_ID = $this->request->getRequestParam('event_id', 0, 'int');
2973
-        if (! $EVT_ID) {
2974
-            return false;
2975
-        }
2976
-        $this->_reg_event = $this->getEventModel()->get_one_by_ID($EVT_ID);
2977
-        return true;
2978
-    }
2979
-
2980
-
2981
-    /**
2982
-     * process_reg_step
2983
-     *
2984
-     * @return void
2985
-     * @throws DomainException
2986
-     * @throws EE_Error
2987
-     * @throws InvalidArgumentException
2988
-     * @throws InvalidDataTypeException
2989
-     * @throws InvalidInterfaceException
2990
-     * @throws ReflectionException
2991
-     * @throws RuntimeException
2992
-     */
2993
-    public function process_reg_step()
2994
-    {
2995
-        EE_System::do_not_cache();
2996
-        $this->_set_reg_event();
2997
-        /** @var CurrentPage $current_page */
2998
-        $current_page = $this->loader->getShared(CurrentPage::class);
2999
-        $current_page->setEspressoPage(true);
3000
-        $this->request->setRequestParam('uts', time());
3001
-        // what step are we on?
3002
-        $cart = EE_Registry::instance()->SSN->cart();
3003
-        $step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
3004
-        // if doing ajax then we need to verify the nonce
3005
-        if ($this->request->isAjax()) {
3006
-            $nonce = $this->request->getRequestParam($this->_req_nonce, '');
3007
-            $this->_verify_nonce($nonce, $this->_req_nonce);
3008
-        }
3009
-        switch ($step) {
3010
-            case 'ticket':
3011
-                // process ticket selection
3012
-                $success = EED_Ticket_Selector::instance()->process_ticket_selections();
3013
-                if ($success) {
3014
-                    EE_Error::add_success(
3015
-                        esc_html__(
3016
-                            'Tickets Selected. Now complete the registration.',
3017
-                            'event_espresso'
3018
-                        )
3019
-                    );
3020
-                } else {
3021
-                    $this->request->setRequestParam('step_error', true);
3022
-                    $query_args['step_error'] = $this->request->getRequestParam('step_error', true, 'bool');
3023
-                }
3024
-                if ($this->request->isAjax()) {
3025
-                    $this->new_registration(); // display next step
3026
-                } else {
3027
-                    $query_args = [
3028
-                        'action'                  => 'new_registration',
3029
-                        'processing_registration' => 1,
3030
-                        'event_id'                => $this->_reg_event->ID(),
3031
-                        'uts'                     => time(),
3032
-                    ];
3033
-                    $this->_redirect_after_action(
3034
-                        false,
3035
-                        '',
3036
-                        '',
3037
-                        $query_args,
3038
-                        true
3039
-                    );
3040
-                }
3041
-                break;
3042
-            case 'questions':
3043
-                if (! $this->request->requestParamIsSet('txn_reg_status_change[send_notifications]')) {
3044
-                    add_filter('FHEE__EED_Messages___maybe_registration__deliver_notifications', '__return_false', 15);
3045
-                }
3046
-                // process registration
3047
-                $transaction = EED_Single_Page_Checkout::instance()->process_registration_from_admin();
3048
-                if ($cart instanceof EE_Cart) {
3049
-                    $grand_total = $cart->get_grand_total();
3050
-                    if ($grand_total instanceof EE_Line_Item) {
3051
-                        $grand_total->save_this_and_descendants_to_txn();
3052
-                    }
3053
-                }
3054
-                if (! $transaction instanceof EE_Transaction) {
3055
-                    $query_args = [
3056
-                        'action'                  => 'new_registration',
3057
-                        'processing_registration' => 2,
3058
-                        'event_id'                => $this->_reg_event->ID(),
3059
-                        'uts'                     => time(),
3060
-                    ];
3061
-                    if ($this->request->isAjax()) {
3062
-                        // display registration form again because there are errors (maybe validation?)
3063
-                        $this->new_registration();
3064
-                        return;
3065
-                    }
3066
-                    $this->_redirect_after_action(
3067
-                        false,
3068
-                        '',
3069
-                        '',
3070
-                        $query_args,
3071
-                        true
3072
-                    );
3073
-                    return;
3074
-                }
3075
-                // maybe update status, and make sure to save transaction if not done already
3076
-                if (! $transaction->update_status_based_on_total_paid()) {
3077
-                    $transaction->save();
3078
-                }
3079
-                EE_Registry::instance()->SSN->clear_session(__CLASS__, __FUNCTION__);
3080
-                $query_args = [
3081
-                    'action'        => 'redirect_to_txn',
3082
-                    'TXN_ID'        => $transaction->ID(),
3083
-                    'EVT_ID'        => $this->_reg_event->ID(),
3084
-                    'event_name'    => urlencode($this->_reg_event->name()),
3085
-                    'redirect_from' => 'new_registration',
3086
-                ];
3087
-                $this->_redirect_after_action(false, '', '', $query_args, true);
3088
-                break;
3089
-        }
3090
-        // what are you looking here for?  Should be nothing to do at this point.
3091
-    }
3092
-
3093
-
3094
-    /**
3095
-     * redirect_to_txn
3096
-     *
3097
-     * @return void
3098
-     * @throws EE_Error
3099
-     * @throws InvalidArgumentException
3100
-     * @throws InvalidDataTypeException
3101
-     * @throws InvalidInterfaceException
3102
-     * @throws ReflectionException
3103
-     */
3104
-    public function redirect_to_txn()
3105
-    {
3106
-        EE_System::do_not_cache();
3107
-        EE_Registry::instance()->SSN->clear_session(__CLASS__, __FUNCTION__);
3108
-        $query_args = [
3109
-            'action' => 'view_transaction',
3110
-            'TXN_ID' => $this->request->getRequestParam('TXN_ID', 0, 'int'),
3111
-            'page'   => 'espresso_transactions',
3112
-        ];
3113
-        if ($this->request->requestParamIsSet('EVT_ID') && $this->request->requestParamIsSet('redirect_from')) {
3114
-            $query_args['EVT_ID']        = $this->request->getRequestParam('EVT_ID', 0, 'int');
3115
-            $query_args['event_name']    = urlencode($this->request->getRequestParam('event_name'));
3116
-            $query_args['redirect_from'] = $this->request->getRequestParam('redirect_from');
3117
-        }
3118
-        EE_Error::add_success(
3119
-            esc_html__(
3120
-                'Registration Created.  Please review the transaction and add any payments as necessary',
3121
-                'event_espresso'
3122
-            )
3123
-        );
3124
-        $this->_redirect_after_action(false, '', '', $query_args, true);
3125
-    }
3126
-
3127
-
3128
-    /**
3129
-     * generates HTML for the Attendee Contact List
3130
-     *
3131
-     * @return void
3132
-     * @throws DomainException
3133
-     * @throws EE_Error
3134
-     */
3135
-    protected function _attendee_contact_list_table()
3136
-    {
3137
-        do_action('AHEE_log', __FILE__, __FUNCTION__, '');
3138
-        $this->_search_btn_label = esc_html__('Contacts', 'event_espresso');
3139
-        $this->display_admin_list_table_page_with_no_sidebar();
3140
-    }
3141
-
3142
-
3143
-    /**
3144
-     * get_attendees
3145
-     *
3146
-     * @param      $per_page
3147
-     * @param bool $count whether to return count or data.
3148
-     * @param bool $trash
3149
-     * @return array|int
3150
-     * @throws EE_Error
3151
-     * @throws InvalidArgumentException
3152
-     * @throws InvalidDataTypeException
3153
-     * @throws InvalidInterfaceException
3154
-     */
3155
-    public function get_attendees($per_page, $count = false, $trash = false)
3156
-    {
3157
-        do_action('AHEE_log', __FILE__, __FUNCTION__, '');
3158
-        require_once(REG_ADMIN . 'EE_Attendee_Contact_List_Table.class.php');
3159
-        $orderby = $this->request->getRequestParam('orderby');
3160
-        switch ($orderby) {
3161
-            case 'ATT_ID':
3162
-            case 'ATT_fname':
3163
-            case 'ATT_email':
3164
-            case 'ATT_city':
3165
-            case 'STA_ID':
3166
-            case 'CNT_ID':
3167
-                break;
3168
-            case 'Registration_Count':
3169
-                $orderby = 'Registration_Count';
3170
-                break;
3171
-            default:
3172
-                $orderby = 'ATT_lname';
3173
-        }
3174
-        $sort         = $this->request->getRequestParam('order', 'ASC');
3175
-        $current_page = $this->request->getRequestParam('paged', 1, 'int');
3176
-        $per_page     = absint($per_page) ? $per_page : 10;
3177
-        $per_page     = $this->request->getRequestParam('perpage', $per_page, 'int');
3178
-        $_where       = [];
3179
-        $search_term  = $this->request->getRequestParam('s');
3180
-        if ($search_term) {
3181
-            $search_term  = '%' . $search_term . '%';
3182
-            $_where['OR'] = [
3183
-                'Registration.Event.EVT_name'       => ['LIKE', $search_term],
3184
-                'Registration.Event.EVT_desc'       => ['LIKE', $search_term],
3185
-                'Registration.Event.EVT_short_desc' => ['LIKE', $search_term],
3186
-                'ATT_fname'                         => ['LIKE', $search_term],
3187
-                'ATT_lname'                         => ['LIKE', $search_term],
3188
-                'ATT_short_bio'                     => ['LIKE', $search_term],
3189
-                'ATT_email'                         => ['LIKE', $search_term],
3190
-                'ATT_address'                       => ['LIKE', $search_term],
3191
-                'ATT_address2'                      => ['LIKE', $search_term],
3192
-                'ATT_city'                          => ['LIKE', $search_term],
3193
-                'Country.CNT_name'                  => ['LIKE', $search_term],
3194
-                'State.STA_name'                    => ['LIKE', $search_term],
3195
-                'ATT_phone'                         => ['LIKE', $search_term],
3196
-                'Registration.REG_final_price'      => ['LIKE', $search_term],
3197
-                'Registration.REG_code'             => ['LIKE', $search_term],
3198
-                'Registration.REG_group_size'       => ['LIKE', $search_term],
3199
-            ];
3200
-        }
3201
-        $offset     = ($current_page - 1) * $per_page;
3202
-        $limit      = $count ? null : [$offset, $per_page];
3203
-        $query_args = [
3204
-            $_where,
3205
-            'extra_selects' => ['Registration_Count' => ['Registration.REG_ID', 'count', '%d']],
3206
-            'limit'         => $limit,
3207
-        ];
3208
-        if (! $count) {
3209
-            $query_args['order_by'] = [$orderby => $sort];
3210
-        }
3211
-        $query_args[0]['status'] = $trash ? ['!=', 'publish'] : ['IN', ['publish']];
3212
-        return $count
3213
-            ? $this->getAttendeeModel()->count($query_args, 'ATT_ID', true)
3214
-            : $this->getAttendeeModel()->get_all($query_args);
3215
-    }
3216
-
3217
-
3218
-    /**
3219
-     * This is just taking care of resending the registration confirmation
3220
-     *
3221
-     * @return void
3222
-     * @throws EE_Error
3223
-     * @throws InvalidArgumentException
3224
-     * @throws InvalidDataTypeException
3225
-     * @throws InvalidInterfaceException
3226
-     * @throws ReflectionException
3227
-     */
3228
-    protected function _resend_registration()
3229
-    {
3230
-        $this->_process_resend_registration();
3231
-        $REG_ID      = $this->request->getRequestParam('_REG_ID', 0, 'int');
3232
-        $redirect_to = $this->request->getRequestParam('redirect_to');
3233
-        $query_args  = $redirect_to
3234
-            ? ['action' => $redirect_to, '_REG_ID' => $REG_ID]
3235
-            : ['action' => 'default'];
3236
-        $this->_redirect_after_action(false, '', '', $query_args, true);
3237
-    }
3238
-
3239
-
3240
-    /**
3241
-     * Creates a registration report, but accepts the name of a method to use for preparing the query parameters
3242
-     * to use when selecting registrations
3243
-     *
3244
-     * @param string $method_name_for_getting_query_params the name of the method (on this class) to use for preparing
3245
-     *                                                     the query parameters from the request
3246
-     * @return void ends the request with a redirect or download
3247
-     */
3248
-    public function _registrations_report_base($method_name_for_getting_query_params)
3249
-    {
3250
-        $EVT_ID = $this->request->requestParamIsSet('EVT_ID')
3251
-            ? $this->request->getRequestParam('EVT_ID', 0, 'int')
3252
-            : null;
3253
-        if (! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
3254
-            $request_params = $this->request->requestParams();
3255
-            wp_redirect(
3256
-                EE_Admin_Page::add_query_args_and_nonce(
3257
-                    [
3258
-                        'page'        => 'espresso_batch',
3259
-                        'batch'       => 'file',
3260
-                        'EVT_ID'      => $EVT_ID,
3261
-                        'filters'     => urlencode(
3262
-                            serialize(
3263
-                                $this->$method_name_for_getting_query_params(
3264
-                                    EEH_Array::is_set($request_params, 'filters', [])
3265
-                                )
3266
-                            )
3267
-                        ),
3268
-                        'use_filters' => EEH_Array::is_set($request_params, 'use_filters', false),
3269
-                        'job_handler' => urlencode('EventEspressoBatchRequest\JobHandlers\RegistrationsReport'),
3270
-                        'return_url'  => urlencode($this->request->getRequestParam('return_url', '', 'url')),
3271
-                    ]
3272
-                )
3273
-            );
3274
-        } else {
3275
-            // Pull the current request params
3276
-            $request_args = $this->request->requestParams();
3277
-            // Set the required request_args to be passed to the export
3278
-            $required_request_args = [
3279
-                'export' => 'report',
3280
-                'action' => 'registrations_report_for_event',
3281
-                'EVT_ID' => $EVT_ID,
3282
-            ];
3283
-            // Merge required request args, overriding any currently set
3284
-            $request_args = array_merge($request_args, $required_request_args);
3285
-            if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
3286
-                require_once(EE_CLASSES . 'EE_Export.class.php');
3287
-                $EE_Export = EE_Export::instance($request_args);
3288
-                $EE_Export->export();
3289
-            }
3290
-        }
3291
-    }
3292
-
3293
-
3294
-    /**
3295
-     * Creates a registration report using only query parameters in the request
3296
-     *
3297
-     * @return void
3298
-     */
3299
-    public function _registrations_report()
3300
-    {
3301
-        $this->_registrations_report_base('_get_registration_query_parameters');
3302
-    }
3303
-
3304
-
3305
-    public function _contact_list_export()
3306
-    {
3307
-        if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
3308
-            require_once(EE_CLASSES . 'EE_Export.class.php');
3309
-            $EE_Export = EE_Export::instance($this->request->requestParams());
3310
-            $EE_Export->export_attendees();
3311
-        }
3312
-    }
3313
-
3314
-
3315
-    public function _contact_list_report()
3316
-    {
3317
-        if (! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
3318
-            wp_redirect(
3319
-                EE_Admin_Page::add_query_args_and_nonce(
3320
-                    [
3321
-                        'page'        => 'espresso_batch',
3322
-                        'batch'       => 'file',
3323
-                        'job_handler' => urlencode('EventEspressoBatchRequest\JobHandlers\AttendeesReport'),
3324
-                        'return_url'  => urlencode($this->request->getRequestParam('return_url', '', 'url')),
3325
-                    ]
3326
-                )
3327
-            );
3328
-        } else {
3329
-            if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
3330
-                require_once(EE_CLASSES . 'EE_Export.class.php');
3331
-                $EE_Export = EE_Export::instance($this->request->requestParams());
3332
-                $EE_Export->report_attendees();
3333
-            }
3334
-        }
3335
-    }
3336
-
3337
-
3338
-
3339
-
3340
-
3341
-    /***************************************        ATTENDEE DETAILS        ***************************************/
3342
-    /**
3343
-     * This duplicates the attendee object for the given incoming registration id and attendee_id.
3344
-     *
3345
-     * @return void
3346
-     * @throws EE_Error
3347
-     * @throws InvalidArgumentException
3348
-     * @throws InvalidDataTypeException
3349
-     * @throws InvalidInterfaceException
3350
-     * @throws ReflectionException
3351
-     */
3352
-    protected function _duplicate_attendee()
3353
-    {
3354
-        $REG_ID = $this->request->getRequestParam('_REG_ID', 0, 'int');
3355
-        $action = $this->request->getRequestParam('return', 'default');
3356
-        // verify we have necessary info
3357
-        if (! $REG_ID) {
3358
-            EE_Error::add_error(
3359
-                esc_html__(
3360
-                    'Unable to create the contact for the registration because the required parameters are not present (_REG_ID )',
3361
-                    'event_espresso'
3362
-                ),
3363
-                __FILE__,
3364
-                __LINE__,
3365
-                __FUNCTION__
3366
-            );
3367
-            $query_args = ['action' => $action];
3368
-            $this->_redirect_after_action('', '', '', $query_args, true);
3369
-        }
3370
-        // okay necessary deets present... let's dupe the incoming attendee and attach to incoming registration.
3371
-        $registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
3372
-        if (! $registration instanceof EE_Registration) {
3373
-            throw new RuntimeException(
3374
-                sprintf(
3375
-                    esc_html__(
3376
-                        'Unable to create the contact because a valid registration could not be retrieved for REG ID: %1$d',
3377
-                        'event_espresso'
3378
-                    ),
3379
-                    $REG_ID
3380
-                )
3381
-            );
3382
-        }
3383
-        $attendee = $registration->attendee();
3384
-        // remove relation of existing attendee on registration
3385
-        $registration->_remove_relation_to($attendee, 'Attendee');
3386
-        // new attendee
3387
-        $new_attendee = clone $attendee;
3388
-        $new_attendee->set('ATT_ID', 0);
3389
-        $new_attendee->save();
3390
-        // add new attendee to reg
3391
-        $registration->_add_relation_to($new_attendee, 'Attendee');
3392
-        EE_Error::add_success(
3393
-            esc_html__(
3394
-                'New Contact record created.  Now make any edits you wish to make for this contact.',
3395
-                'event_espresso'
3396
-            )
3397
-        );
3398
-        // redirect to edit page for attendee
3399
-        $query_args = ['post' => $new_attendee->ID(), 'action' => 'edit_attendee'];
3400
-        $this->_redirect_after_action('', '', '', $query_args, true);
3401
-    }
3402
-
3403
-
3404
-    /**
3405
-     * Callback invoked by parent EE_Admin_CPT class hooked in on `save_post` wp hook.
3406
-     *
3407
-     * @param int     $post_id
3408
-     * @param WP_Post $post
3409
-     * @throws DomainException
3410
-     * @throws EE_Error
3411
-     * @throws InvalidArgumentException
3412
-     * @throws InvalidDataTypeException
3413
-     * @throws InvalidInterfaceException
3414
-     * @throws LogicException
3415
-     * @throws InvalidFormSubmissionException
3416
-     * @throws ReflectionException
3417
-     */
3418
-    protected function _insert_update_cpt_item($post_id, $post)
3419
-    {
3420
-        $success  = true;
3421
-        $attendee = $post instanceof WP_Post && $post->post_type === 'espresso_attendees'
3422
-            ? $this->getAttendeeModel()->get_one_by_ID($post_id)
3423
-            : null;
3424
-        // for attendee updates
3425
-        if ($attendee instanceof EE_Attendee) {
3426
-            // note we should only be UPDATING attendees at this point.
3427
-            $fname          = $this->request->getRequestParam('ATT_fname', '');
3428
-            $lname          = $this->request->getRequestParam('ATT_lname', '');
3429
-            $updated_fields = [
3430
-                'ATT_fname'     => $fname,
3431
-                'ATT_lname'     => $lname,
3432
-                'ATT_full_name' => "{$fname} {$lname}",
3433
-                'ATT_address'   => $this->request->getRequestParam('ATT_address', ''),
3434
-                'ATT_address2'  => $this->request->getRequestParam('ATT_address2', ''),
3435
-                'ATT_city'      => $this->request->getRequestParam('ATT_city', ''),
3436
-                'STA_ID'        => $this->request->getRequestParam('STA_ID', ''),
3437
-                'CNT_ISO'       => $this->request->getRequestParam('CNT_ISO', ''),
3438
-                'ATT_zip'       => $this->request->getRequestParam('ATT_zip', ''),
3439
-            ];
3440
-            foreach ($updated_fields as $field => $value) {
3441
-                $attendee->set($field, $value);
3442
-            }
3443
-
3444
-            // process contact details metabox form handler (which will also save the attendee)
3445
-            $contact_details_form = $this->getAttendeeContactDetailsMetaboxFormHandler($attendee);
3446
-            $success              = $contact_details_form->process($this->request->requestParams());
3447
-
3448
-            $attendee_update_callbacks = apply_filters(
3449
-                'FHEE__Registrations_Admin_Page__insert_update_cpt_item__attendee_update',
3450
-                []
3451
-            );
3452
-            foreach ($attendee_update_callbacks as $a_callback) {
3453
-                if (false === call_user_func_array($a_callback, [$attendee, $this->request->requestParams()])) {
3454
-                    throw new EE_Error(
3455
-                        sprintf(
3456
-                            esc_html__(
3457
-                                'The %s callback given for the "FHEE__Registrations_Admin_Page__insert_update_cpt_item__attendee_update" filter is not a valid callback.  Please check the spelling.',
3458
-                                'event_espresso'
3459
-                            ),
3460
-                            $a_callback
3461
-                        )
3462
-                    );
3463
-                }
3464
-            }
3465
-        }
3466
-
3467
-        if ($success === false) {
3468
-            EE_Error::add_error(
3469
-                esc_html__(
3470
-                    'Something went wrong with updating the meta table data for the registration.',
3471
-                    'event_espresso'
3472
-                ),
3473
-                __FILE__,
3474
-                __FUNCTION__,
3475
-                __LINE__
3476
-            );
3477
-        }
3478
-    }
3479
-
3480
-
3481
-    public function trash_cpt_item($post_id)
3482
-    {
3483
-    }
3484
-
3485
-
3486
-    public function delete_cpt_item($post_id)
3487
-    {
3488
-    }
3489
-
3490
-
3491
-    public function restore_cpt_item($post_id)
3492
-    {
3493
-    }
3494
-
3495
-
3496
-    protected function _restore_cpt_item($post_id, $revision_id)
3497
-    {
3498
-    }
3499
-
3500
-
3501
-    /**
3502
-     * @throws EE_Error
3503
-     * @throws ReflectionException
3504
-     * @since 4.10.2.p
3505
-     */
3506
-    public function attendee_editor_metaboxes()
3507
-    {
3508
-        $this->verify_cpt_object();
3509
-        remove_meta_box(
3510
-            'postexcerpt',
3511
-            $this->_cpt_routes[ $this->_req_action ],
3512
-            'normal'
3513
-        );
3514
-        remove_meta_box('commentstatusdiv', $this->_cpt_routes[ $this->_req_action ], 'normal');
3515
-        if (post_type_supports('espresso_attendees', 'excerpt')) {
3516
-            add_meta_box(
3517
-                'postexcerpt',
3518
-                esc_html__('Short Biography', 'event_espresso'),
3519
-                'post_excerpt_meta_box',
3520
-                $this->_cpt_routes[ $this->_req_action ],
3521
-                'normal'
3522
-            );
3523
-        }
3524
-        if (post_type_supports('espresso_attendees', 'comments')) {
3525
-            add_meta_box(
3526
-                'commentsdiv',
3527
-                esc_html__('Notes on the Contact', 'event_espresso'),
3528
-                'post_comment_meta_box',
3529
-                $this->_cpt_routes[ $this->_req_action ],
3530
-                'normal',
3531
-                'core'
3532
-            );
3533
-        }
3534
-        add_meta_box(
3535
-            'attendee_contact_info',
3536
-            esc_html__('Contact Info', 'event_espresso'),
3537
-            [$this, 'attendee_contact_info'],
3538
-            $this->_cpt_routes[ $this->_req_action ],
3539
-            'side',
3540
-            'core'
3541
-        );
3542
-        add_meta_box(
3543
-            'attendee_details_address',
3544
-            esc_html__('Address Details', 'event_espresso'),
3545
-            [$this, 'attendee_address_details'],
3546
-            $this->_cpt_routes[ $this->_req_action ],
3547
-            'normal',
3548
-            'core'
3549
-        );
3550
-        add_meta_box(
3551
-            'attendee_registrations',
3552
-            esc_html__('Registrations for this Contact', 'event_espresso'),
3553
-            [$this, 'attendee_registrations_meta_box'],
3554
-            $this->_cpt_routes[ $this->_req_action ],
3555
-            'normal',
3556
-            'high'
3557
-        );
3558
-    }
3559
-
3560
-
3561
-    /**
3562
-     * Metabox for attendee contact info
3563
-     *
3564
-     * @param WP_Post $post wp post object
3565
-     * @return void attendee contact info ( and form )
3566
-     * @throws EE_Error
3567
-     * @throws InvalidArgumentException
3568
-     * @throws InvalidDataTypeException
3569
-     * @throws InvalidInterfaceException
3570
-     * @throws LogicException
3571
-     * @throws DomainException
3572
-     */
3573
-    public function attendee_contact_info($post)
3574
-    {
3575
-        // get attendee object ( should already have it )
3576
-        $form = $this->getAttendeeContactDetailsMetaboxFormHandler($this->_cpt_model_obj);
3577
-        $form->enqueueStylesAndScripts();
3578
-        echo $form->display(); // already escaped
3579
-    }
3580
-
3581
-
3582
-    /**
3583
-     * Return form handler for the contact details metabox
3584
-     *
3585
-     * @param EE_Attendee $attendee
3586
-     * @return AttendeeContactDetailsMetaboxFormHandler
3587
-     * @throws DomainException
3588
-     * @throws InvalidArgumentException
3589
-     * @throws InvalidDataTypeException
3590
-     * @throws InvalidInterfaceException
3591
-     */
3592
-    protected function getAttendeeContactDetailsMetaboxFormHandler(EE_Attendee $attendee)
3593
-    {
3594
-        return new AttendeeContactDetailsMetaboxFormHandler($attendee, EE_Registry::instance());
3595
-    }
3596
-
3597
-
3598
-    /**
3599
-     * Metabox for attendee details
3600
-     *
3601
-     * @param WP_Post $post wp post object
3602
-     * @throws EE_Error
3603
-     * @throws ReflectionException
3604
-     */
3605
-    public function attendee_address_details($post)
3606
-    {
3607
-        // get attendee object (should already have it)
3608
-        $this->_template_args['attendee']     = $this->_cpt_model_obj;
3609
-        $this->_template_args['state_html']   = EEH_Form_Fields::generate_form_input(
3610
-            new EE_Question_Form_Input(
3611
-                EE_Question::new_instance(
3612
-                    [
3613
-                        'QST_ID'           => 0,
3614
-                        'QST_display_text' => esc_html__('State/Province', 'event_espresso'),
3615
-                        'QST_system'       => 'admin-state',
3616
-                    ]
3617
-                ),
3618
-                EE_Answer::new_instance(
3619
-                    [
3620
-                        'ANS_ID'    => 0,
3621
-                        'ANS_value' => $this->_cpt_model_obj->state_ID(),
3622
-                    ]
3623
-                ),
3624
-                [
3625
-                    'input_id'       => 'STA_ID',
3626
-                    'input_name'     => 'STA_ID',
3627
-                    'input_prefix'   => '',
3628
-                    'append_qstn_id' => false,
3629
-                ]
3630
-            )
3631
-        );
3632
-        $this->_template_args['country_html'] = EEH_Form_Fields::generate_form_input(
3633
-            new EE_Question_Form_Input(
3634
-                EE_Question::new_instance(
3635
-                    [
3636
-                        'QST_ID'           => 0,
3637
-                        'QST_display_text' => esc_html__('Country', 'event_espresso'),
3638
-                        'QST_system'       => 'admin-country',
3639
-                    ]
3640
-                ),
3641
-                EE_Answer::new_instance(
3642
-                    [
3643
-                        'ANS_ID'    => 0,
3644
-                        'ANS_value' => $this->_cpt_model_obj->country_ID(),
3645
-                    ]
3646
-                ),
3647
-                [
3648
-                    'input_id'       => 'CNT_ISO',
3649
-                    'input_name'     => 'CNT_ISO',
3650
-                    'input_prefix'   => '',
3651
-                    'append_qstn_id' => false,
3652
-                ]
3653
-            )
3654
-        );
3655
-        $template                             =
3656
-            REG_TEMPLATE_PATH . 'attendee_address_details_metabox_content.template.php';
3657
-        EEH_Template::display_template($template, $this->_template_args);
3658
-    }
3659
-
3660
-
3661
-    /**
3662
-     * _attendee_details
3663
-     *
3664
-     * @param $post
3665
-     * @return void
3666
-     * @throws DomainException
3667
-     * @throws EE_Error
3668
-     * @throws InvalidArgumentException
3669
-     * @throws InvalidDataTypeException
3670
-     * @throws InvalidInterfaceException
3671
-     * @throws ReflectionException
3672
-     */
3673
-    public function attendee_registrations_meta_box($post)
3674
-    {
3675
-        $this->_template_args['attendee']      = $this->_cpt_model_obj;
3676
-        $this->_template_args['registrations'] = $this->_cpt_model_obj->get_many_related('Registration');
3677
-        $template                              =
3678
-            REG_TEMPLATE_PATH . 'attendee_registrations_main_meta_box.template.php';
3679
-        EEH_Template::display_template($template, $this->_template_args);
3680
-    }
3681
-
3682
-
3683
-    /**
3684
-     * add in the form fields for the attendee edit
3685
-     *
3686
-     * @param WP_Post $post wp post object
3687
-     * @return void echos html for new form.
3688
-     * @throws DomainException
3689
-     */
3690
-    public function after_title_form_fields($post)
3691
-    {
3692
-        if ($post->post_type === 'espresso_attendees') {
3693
-            $template                  = REG_TEMPLATE_PATH . 'attendee_details_after_title_form_fields.template.php';
3694
-            $template_args['attendee'] = $this->_cpt_model_obj;
3695
-            EEH_Template::display_template($template, $template_args);
3696
-        }
3697
-    }
3698
-
3699
-
3700
-    /**
3701
-     * _trash_or_restore_attendee
3702
-     *
3703
-     * @param boolean $trash - whether to move item to trash (TRUE) or restore it (FALSE)
3704
-     * @return void
3705
-     * @throws EE_Error
3706
-     * @throws InvalidArgumentException
3707
-     * @throws InvalidDataTypeException
3708
-     * @throws InvalidInterfaceException
3709
-     */
3710
-    protected function _trash_or_restore_attendees($trash = true)
3711
-    {
3712
-        do_action('AHEE_log', __FILE__, __FUNCTION__, '');
3713
-        $status = $trash ? 'trash' : 'publish';
3714
-        // Checkboxes
3715
-        if ($this->request->requestParamIsSet('checkbox')) {
3716
-            $ATT_IDs = $this->request->getRequestParam('checkbox', [], 'int', true);
3717
-            // if array has more than one element than success message should be plural
3718
-            $success = count($ATT_IDs) > 1 ? 2 : 1;
3719
-            // cycle thru checkboxes
3720
-            foreach ($ATT_IDs as $ATT_ID) {
3721
-                $updated = $this->getAttendeeModel()->update_by_ID(['status' => $status], $ATT_ID);
3722
-                if (! $updated) {
3723
-                    $success = 0;
3724
-                }
3725
-            }
3726
-        } else {
3727
-            // grab single id and delete
3728
-            $ATT_ID = $this->request->getRequestParam('ATT_ID', 0, 'int');
3729
-            // update attendee
3730
-            $success = $this->getAttendeeModel()->update_by_ID(['status' => $status], $ATT_ID) ? 1 : 0;
3731
-        }
3732
-        $what        = $success > 1
3733
-            ? esc_html__('Contacts', 'event_espresso')
3734
-            : esc_html__('Contact', 'event_espresso');
3735
-        $action_desc = $trash
3736
-            ? esc_html__('moved to the trash', 'event_espresso')
3737
-            : esc_html__('restored', 'event_espresso');
3738
-        $this->_redirect_after_action($success, $what, $action_desc, ['action' => 'contact_list']);
3739
-    }
2893
+		}
2894
+		$template_args = [
2895
+			'title'                    => '',
2896
+			'content'                  => '',
2897
+			'step_button_text'         => '',
2898
+			'show_notification_toggle' => false,
2899
+		];
2900
+		// to indicate we're processing a new registration
2901
+		$hidden_fields = [
2902
+			'processing_registration' => [
2903
+				'type'  => 'hidden',
2904
+				'value' => 0,
2905
+			],
2906
+			'event_id'                => [
2907
+				'type'  => 'hidden',
2908
+				'value' => $this->_reg_event->ID(),
2909
+			],
2910
+		];
2911
+		// if the cart is empty then we know we're at step one, so we'll display the ticket selector
2912
+		$cart = EE_Registry::instance()->SSN->cart();
2913
+		$step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
2914
+		switch ($step) {
2915
+			case 'ticket':
2916
+				$hidden_fields['processing_registration']['value'] = 1;
2917
+				$template_args['title']                            = esc_html__(
2918
+					'Step One: Select the Ticket for this registration',
2919
+					'event_espresso'
2920
+				);
2921
+				$template_args['content']                          =
2922
+					EED_Ticket_Selector::instance()->display_ticket_selector($this->_reg_event);
2923
+				$template_args['content']                          .= '</div>';
2924
+				$template_args['step_button_text']                 = esc_html__(
2925
+					'Add Tickets and Continue to Registrant Details',
2926
+					'event_espresso'
2927
+				);
2928
+				$template_args['show_notification_toggle']         = false;
2929
+				break;
2930
+			case 'questions':
2931
+				$hidden_fields['processing_registration']['value'] = 2;
2932
+				$template_args['title']                            = esc_html__(
2933
+					'Step Two: Add Registrant Details for this Registration',
2934
+					'event_espresso'
2935
+				);
2936
+				// in theory, we should be able to run EED_SPCO at this point
2937
+				// because the cart should have been set up properly by the first process_reg_step run.
2938
+				$template_args['content']                  =
2939
+					EED_Single_Page_Checkout::registration_checkout_for_admin();
2940
+				$template_args['step_button_text']         = esc_html__(
2941
+					'Save Registration and Continue to Details',
2942
+					'event_espresso'
2943
+				);
2944
+				$template_args['show_notification_toggle'] = true;
2945
+				break;
2946
+		}
2947
+		// we come back to the process_registration_step route.
2948
+		$this->_set_add_edit_form_tags('process_reg_step', $hidden_fields);
2949
+		return EEH_Template::display_template(
2950
+			REG_TEMPLATE_PATH . 'reg_admin_register_new_attendee_step_content.template.php',
2951
+			$template_args,
2952
+			true
2953
+		);
2954
+	}
2955
+
2956
+
2957
+	/**
2958
+	 * set_reg_event
2959
+	 *
2960
+	 * @return bool
2961
+	 * @throws EE_Error
2962
+	 * @throws InvalidArgumentException
2963
+	 * @throws InvalidDataTypeException
2964
+	 * @throws InvalidInterfaceException
2965
+	 */
2966
+	private function _set_reg_event()
2967
+	{
2968
+		if (is_object($this->_reg_event)) {
2969
+			return true;
2970
+		}
2971
+
2972
+		$EVT_ID = $this->request->getRequestParam('event_id', 0, 'int');
2973
+		if (! $EVT_ID) {
2974
+			return false;
2975
+		}
2976
+		$this->_reg_event = $this->getEventModel()->get_one_by_ID($EVT_ID);
2977
+		return true;
2978
+	}
2979
+
2980
+
2981
+	/**
2982
+	 * process_reg_step
2983
+	 *
2984
+	 * @return void
2985
+	 * @throws DomainException
2986
+	 * @throws EE_Error
2987
+	 * @throws InvalidArgumentException
2988
+	 * @throws InvalidDataTypeException
2989
+	 * @throws InvalidInterfaceException
2990
+	 * @throws ReflectionException
2991
+	 * @throws RuntimeException
2992
+	 */
2993
+	public function process_reg_step()
2994
+	{
2995
+		EE_System::do_not_cache();
2996
+		$this->_set_reg_event();
2997
+		/** @var CurrentPage $current_page */
2998
+		$current_page = $this->loader->getShared(CurrentPage::class);
2999
+		$current_page->setEspressoPage(true);
3000
+		$this->request->setRequestParam('uts', time());
3001
+		// what step are we on?
3002
+		$cart = EE_Registry::instance()->SSN->cart();
3003
+		$step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
3004
+		// if doing ajax then we need to verify the nonce
3005
+		if ($this->request->isAjax()) {
3006
+			$nonce = $this->request->getRequestParam($this->_req_nonce, '');
3007
+			$this->_verify_nonce($nonce, $this->_req_nonce);
3008
+		}
3009
+		switch ($step) {
3010
+			case 'ticket':
3011
+				// process ticket selection
3012
+				$success = EED_Ticket_Selector::instance()->process_ticket_selections();
3013
+				if ($success) {
3014
+					EE_Error::add_success(
3015
+						esc_html__(
3016
+							'Tickets Selected. Now complete the registration.',
3017
+							'event_espresso'
3018
+						)
3019
+					);
3020
+				} else {
3021
+					$this->request->setRequestParam('step_error', true);
3022
+					$query_args['step_error'] = $this->request->getRequestParam('step_error', true, 'bool');
3023
+				}
3024
+				if ($this->request->isAjax()) {
3025
+					$this->new_registration(); // display next step
3026
+				} else {
3027
+					$query_args = [
3028
+						'action'                  => 'new_registration',
3029
+						'processing_registration' => 1,
3030
+						'event_id'                => $this->_reg_event->ID(),
3031
+						'uts'                     => time(),
3032
+					];
3033
+					$this->_redirect_after_action(
3034
+						false,
3035
+						'',
3036
+						'',
3037
+						$query_args,
3038
+						true
3039
+					);
3040
+				}
3041
+				break;
3042
+			case 'questions':
3043
+				if (! $this->request->requestParamIsSet('txn_reg_status_change[send_notifications]')) {
3044
+					add_filter('FHEE__EED_Messages___maybe_registration__deliver_notifications', '__return_false', 15);
3045
+				}
3046
+				// process registration
3047
+				$transaction = EED_Single_Page_Checkout::instance()->process_registration_from_admin();
3048
+				if ($cart instanceof EE_Cart) {
3049
+					$grand_total = $cart->get_grand_total();
3050
+					if ($grand_total instanceof EE_Line_Item) {
3051
+						$grand_total->save_this_and_descendants_to_txn();
3052
+					}
3053
+				}
3054
+				if (! $transaction instanceof EE_Transaction) {
3055
+					$query_args = [
3056
+						'action'                  => 'new_registration',
3057
+						'processing_registration' => 2,
3058
+						'event_id'                => $this->_reg_event->ID(),
3059
+						'uts'                     => time(),
3060
+					];
3061
+					if ($this->request->isAjax()) {
3062
+						// display registration form again because there are errors (maybe validation?)
3063
+						$this->new_registration();
3064
+						return;
3065
+					}
3066
+					$this->_redirect_after_action(
3067
+						false,
3068
+						'',
3069
+						'',
3070
+						$query_args,
3071
+						true
3072
+					);
3073
+					return;
3074
+				}
3075
+				// maybe update status, and make sure to save transaction if not done already
3076
+				if (! $transaction->update_status_based_on_total_paid()) {
3077
+					$transaction->save();
3078
+				}
3079
+				EE_Registry::instance()->SSN->clear_session(__CLASS__, __FUNCTION__);
3080
+				$query_args = [
3081
+					'action'        => 'redirect_to_txn',
3082
+					'TXN_ID'        => $transaction->ID(),
3083
+					'EVT_ID'        => $this->_reg_event->ID(),
3084
+					'event_name'    => urlencode($this->_reg_event->name()),
3085
+					'redirect_from' => 'new_registration',
3086
+				];
3087
+				$this->_redirect_after_action(false, '', '', $query_args, true);
3088
+				break;
3089
+		}
3090
+		// what are you looking here for?  Should be nothing to do at this point.
3091
+	}
3092
+
3093
+
3094
+	/**
3095
+	 * redirect_to_txn
3096
+	 *
3097
+	 * @return void
3098
+	 * @throws EE_Error
3099
+	 * @throws InvalidArgumentException
3100
+	 * @throws InvalidDataTypeException
3101
+	 * @throws InvalidInterfaceException
3102
+	 * @throws ReflectionException
3103
+	 */
3104
+	public function redirect_to_txn()
3105
+	{
3106
+		EE_System::do_not_cache();
3107
+		EE_Registry::instance()->SSN->clear_session(__CLASS__, __FUNCTION__);
3108
+		$query_args = [
3109
+			'action' => 'view_transaction',
3110
+			'TXN_ID' => $this->request->getRequestParam('TXN_ID', 0, 'int'),
3111
+			'page'   => 'espresso_transactions',
3112
+		];
3113
+		if ($this->request->requestParamIsSet('EVT_ID') && $this->request->requestParamIsSet('redirect_from')) {
3114
+			$query_args['EVT_ID']        = $this->request->getRequestParam('EVT_ID', 0, 'int');
3115
+			$query_args['event_name']    = urlencode($this->request->getRequestParam('event_name'));
3116
+			$query_args['redirect_from'] = $this->request->getRequestParam('redirect_from');
3117
+		}
3118
+		EE_Error::add_success(
3119
+			esc_html__(
3120
+				'Registration Created.  Please review the transaction and add any payments as necessary',
3121
+				'event_espresso'
3122
+			)
3123
+		);
3124
+		$this->_redirect_after_action(false, '', '', $query_args, true);
3125
+	}
3126
+
3127
+
3128
+	/**
3129
+	 * generates HTML for the Attendee Contact List
3130
+	 *
3131
+	 * @return void
3132
+	 * @throws DomainException
3133
+	 * @throws EE_Error
3134
+	 */
3135
+	protected function _attendee_contact_list_table()
3136
+	{
3137
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
3138
+		$this->_search_btn_label = esc_html__('Contacts', 'event_espresso');
3139
+		$this->display_admin_list_table_page_with_no_sidebar();
3140
+	}
3141
+
3142
+
3143
+	/**
3144
+	 * get_attendees
3145
+	 *
3146
+	 * @param      $per_page
3147
+	 * @param bool $count whether to return count or data.
3148
+	 * @param bool $trash
3149
+	 * @return array|int
3150
+	 * @throws EE_Error
3151
+	 * @throws InvalidArgumentException
3152
+	 * @throws InvalidDataTypeException
3153
+	 * @throws InvalidInterfaceException
3154
+	 */
3155
+	public function get_attendees($per_page, $count = false, $trash = false)
3156
+	{
3157
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
3158
+		require_once(REG_ADMIN . 'EE_Attendee_Contact_List_Table.class.php');
3159
+		$orderby = $this->request->getRequestParam('orderby');
3160
+		switch ($orderby) {
3161
+			case 'ATT_ID':
3162
+			case 'ATT_fname':
3163
+			case 'ATT_email':
3164
+			case 'ATT_city':
3165
+			case 'STA_ID':
3166
+			case 'CNT_ID':
3167
+				break;
3168
+			case 'Registration_Count':
3169
+				$orderby = 'Registration_Count';
3170
+				break;
3171
+			default:
3172
+				$orderby = 'ATT_lname';
3173
+		}
3174
+		$sort         = $this->request->getRequestParam('order', 'ASC');
3175
+		$current_page = $this->request->getRequestParam('paged', 1, 'int');
3176
+		$per_page     = absint($per_page) ? $per_page : 10;
3177
+		$per_page     = $this->request->getRequestParam('perpage', $per_page, 'int');
3178
+		$_where       = [];
3179
+		$search_term  = $this->request->getRequestParam('s');
3180
+		if ($search_term) {
3181
+			$search_term  = '%' . $search_term . '%';
3182
+			$_where['OR'] = [
3183
+				'Registration.Event.EVT_name'       => ['LIKE', $search_term],
3184
+				'Registration.Event.EVT_desc'       => ['LIKE', $search_term],
3185
+				'Registration.Event.EVT_short_desc' => ['LIKE', $search_term],
3186
+				'ATT_fname'                         => ['LIKE', $search_term],
3187
+				'ATT_lname'                         => ['LIKE', $search_term],
3188
+				'ATT_short_bio'                     => ['LIKE', $search_term],
3189
+				'ATT_email'                         => ['LIKE', $search_term],
3190
+				'ATT_address'                       => ['LIKE', $search_term],
3191
+				'ATT_address2'                      => ['LIKE', $search_term],
3192
+				'ATT_city'                          => ['LIKE', $search_term],
3193
+				'Country.CNT_name'                  => ['LIKE', $search_term],
3194
+				'State.STA_name'                    => ['LIKE', $search_term],
3195
+				'ATT_phone'                         => ['LIKE', $search_term],
3196
+				'Registration.REG_final_price'      => ['LIKE', $search_term],
3197
+				'Registration.REG_code'             => ['LIKE', $search_term],
3198
+				'Registration.REG_group_size'       => ['LIKE', $search_term],
3199
+			];
3200
+		}
3201
+		$offset     = ($current_page - 1) * $per_page;
3202
+		$limit      = $count ? null : [$offset, $per_page];
3203
+		$query_args = [
3204
+			$_where,
3205
+			'extra_selects' => ['Registration_Count' => ['Registration.REG_ID', 'count', '%d']],
3206
+			'limit'         => $limit,
3207
+		];
3208
+		if (! $count) {
3209
+			$query_args['order_by'] = [$orderby => $sort];
3210
+		}
3211
+		$query_args[0]['status'] = $trash ? ['!=', 'publish'] : ['IN', ['publish']];
3212
+		return $count
3213
+			? $this->getAttendeeModel()->count($query_args, 'ATT_ID', true)
3214
+			: $this->getAttendeeModel()->get_all($query_args);
3215
+	}
3216
+
3217
+
3218
+	/**
3219
+	 * This is just taking care of resending the registration confirmation
3220
+	 *
3221
+	 * @return void
3222
+	 * @throws EE_Error
3223
+	 * @throws InvalidArgumentException
3224
+	 * @throws InvalidDataTypeException
3225
+	 * @throws InvalidInterfaceException
3226
+	 * @throws ReflectionException
3227
+	 */
3228
+	protected function _resend_registration()
3229
+	{
3230
+		$this->_process_resend_registration();
3231
+		$REG_ID      = $this->request->getRequestParam('_REG_ID', 0, 'int');
3232
+		$redirect_to = $this->request->getRequestParam('redirect_to');
3233
+		$query_args  = $redirect_to
3234
+			? ['action' => $redirect_to, '_REG_ID' => $REG_ID]
3235
+			: ['action' => 'default'];
3236
+		$this->_redirect_after_action(false, '', '', $query_args, true);
3237
+	}
3238
+
3239
+
3240
+	/**
3241
+	 * Creates a registration report, but accepts the name of a method to use for preparing the query parameters
3242
+	 * to use when selecting registrations
3243
+	 *
3244
+	 * @param string $method_name_for_getting_query_params the name of the method (on this class) to use for preparing
3245
+	 *                                                     the query parameters from the request
3246
+	 * @return void ends the request with a redirect or download
3247
+	 */
3248
+	public function _registrations_report_base($method_name_for_getting_query_params)
3249
+	{
3250
+		$EVT_ID = $this->request->requestParamIsSet('EVT_ID')
3251
+			? $this->request->getRequestParam('EVT_ID', 0, 'int')
3252
+			: null;
3253
+		if (! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
3254
+			$request_params = $this->request->requestParams();
3255
+			wp_redirect(
3256
+				EE_Admin_Page::add_query_args_and_nonce(
3257
+					[
3258
+						'page'        => 'espresso_batch',
3259
+						'batch'       => 'file',
3260
+						'EVT_ID'      => $EVT_ID,
3261
+						'filters'     => urlencode(
3262
+							serialize(
3263
+								$this->$method_name_for_getting_query_params(
3264
+									EEH_Array::is_set($request_params, 'filters', [])
3265
+								)
3266
+							)
3267
+						),
3268
+						'use_filters' => EEH_Array::is_set($request_params, 'use_filters', false),
3269
+						'job_handler' => urlencode('EventEspressoBatchRequest\JobHandlers\RegistrationsReport'),
3270
+						'return_url'  => urlencode($this->request->getRequestParam('return_url', '', 'url')),
3271
+					]
3272
+				)
3273
+			);
3274
+		} else {
3275
+			// Pull the current request params
3276
+			$request_args = $this->request->requestParams();
3277
+			// Set the required request_args to be passed to the export
3278
+			$required_request_args = [
3279
+				'export' => 'report',
3280
+				'action' => 'registrations_report_for_event',
3281
+				'EVT_ID' => $EVT_ID,
3282
+			];
3283
+			// Merge required request args, overriding any currently set
3284
+			$request_args = array_merge($request_args, $required_request_args);
3285
+			if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
3286
+				require_once(EE_CLASSES . 'EE_Export.class.php');
3287
+				$EE_Export = EE_Export::instance($request_args);
3288
+				$EE_Export->export();
3289
+			}
3290
+		}
3291
+	}
3292
+
3293
+
3294
+	/**
3295
+	 * Creates a registration report using only query parameters in the request
3296
+	 *
3297
+	 * @return void
3298
+	 */
3299
+	public function _registrations_report()
3300
+	{
3301
+		$this->_registrations_report_base('_get_registration_query_parameters');
3302
+	}
3303
+
3304
+
3305
+	public function _contact_list_export()
3306
+	{
3307
+		if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
3308
+			require_once(EE_CLASSES . 'EE_Export.class.php');
3309
+			$EE_Export = EE_Export::instance($this->request->requestParams());
3310
+			$EE_Export->export_attendees();
3311
+		}
3312
+	}
3313
+
3314
+
3315
+	public function _contact_list_report()
3316
+	{
3317
+		if (! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
3318
+			wp_redirect(
3319
+				EE_Admin_Page::add_query_args_and_nonce(
3320
+					[
3321
+						'page'        => 'espresso_batch',
3322
+						'batch'       => 'file',
3323
+						'job_handler' => urlencode('EventEspressoBatchRequest\JobHandlers\AttendeesReport'),
3324
+						'return_url'  => urlencode($this->request->getRequestParam('return_url', '', 'url')),
3325
+					]
3326
+				)
3327
+			);
3328
+		} else {
3329
+			if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
3330
+				require_once(EE_CLASSES . 'EE_Export.class.php');
3331
+				$EE_Export = EE_Export::instance($this->request->requestParams());
3332
+				$EE_Export->report_attendees();
3333
+			}
3334
+		}
3335
+	}
3336
+
3337
+
3338
+
3339
+
3340
+
3341
+	/***************************************        ATTENDEE DETAILS        ***************************************/
3342
+	/**
3343
+	 * This duplicates the attendee object for the given incoming registration id and attendee_id.
3344
+	 *
3345
+	 * @return void
3346
+	 * @throws EE_Error
3347
+	 * @throws InvalidArgumentException
3348
+	 * @throws InvalidDataTypeException
3349
+	 * @throws InvalidInterfaceException
3350
+	 * @throws ReflectionException
3351
+	 */
3352
+	protected function _duplicate_attendee()
3353
+	{
3354
+		$REG_ID = $this->request->getRequestParam('_REG_ID', 0, 'int');
3355
+		$action = $this->request->getRequestParam('return', 'default');
3356
+		// verify we have necessary info
3357
+		if (! $REG_ID) {
3358
+			EE_Error::add_error(
3359
+				esc_html__(
3360
+					'Unable to create the contact for the registration because the required parameters are not present (_REG_ID )',
3361
+					'event_espresso'
3362
+				),
3363
+				__FILE__,
3364
+				__LINE__,
3365
+				__FUNCTION__
3366
+			);
3367
+			$query_args = ['action' => $action];
3368
+			$this->_redirect_after_action('', '', '', $query_args, true);
3369
+		}
3370
+		// okay necessary deets present... let's dupe the incoming attendee and attach to incoming registration.
3371
+		$registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
3372
+		if (! $registration instanceof EE_Registration) {
3373
+			throw new RuntimeException(
3374
+				sprintf(
3375
+					esc_html__(
3376
+						'Unable to create the contact because a valid registration could not be retrieved for REG ID: %1$d',
3377
+						'event_espresso'
3378
+					),
3379
+					$REG_ID
3380
+				)
3381
+			);
3382
+		}
3383
+		$attendee = $registration->attendee();
3384
+		// remove relation of existing attendee on registration
3385
+		$registration->_remove_relation_to($attendee, 'Attendee');
3386
+		// new attendee
3387
+		$new_attendee = clone $attendee;
3388
+		$new_attendee->set('ATT_ID', 0);
3389
+		$new_attendee->save();
3390
+		// add new attendee to reg
3391
+		$registration->_add_relation_to($new_attendee, 'Attendee');
3392
+		EE_Error::add_success(
3393
+			esc_html__(
3394
+				'New Contact record created.  Now make any edits you wish to make for this contact.',
3395
+				'event_espresso'
3396
+			)
3397
+		);
3398
+		// redirect to edit page for attendee
3399
+		$query_args = ['post' => $new_attendee->ID(), 'action' => 'edit_attendee'];
3400
+		$this->_redirect_after_action('', '', '', $query_args, true);
3401
+	}
3402
+
3403
+
3404
+	/**
3405
+	 * Callback invoked by parent EE_Admin_CPT class hooked in on `save_post` wp hook.
3406
+	 *
3407
+	 * @param int     $post_id
3408
+	 * @param WP_Post $post
3409
+	 * @throws DomainException
3410
+	 * @throws EE_Error
3411
+	 * @throws InvalidArgumentException
3412
+	 * @throws InvalidDataTypeException
3413
+	 * @throws InvalidInterfaceException
3414
+	 * @throws LogicException
3415
+	 * @throws InvalidFormSubmissionException
3416
+	 * @throws ReflectionException
3417
+	 */
3418
+	protected function _insert_update_cpt_item($post_id, $post)
3419
+	{
3420
+		$success  = true;
3421
+		$attendee = $post instanceof WP_Post && $post->post_type === 'espresso_attendees'
3422
+			? $this->getAttendeeModel()->get_one_by_ID($post_id)
3423
+			: null;
3424
+		// for attendee updates
3425
+		if ($attendee instanceof EE_Attendee) {
3426
+			// note we should only be UPDATING attendees at this point.
3427
+			$fname          = $this->request->getRequestParam('ATT_fname', '');
3428
+			$lname          = $this->request->getRequestParam('ATT_lname', '');
3429
+			$updated_fields = [
3430
+				'ATT_fname'     => $fname,
3431
+				'ATT_lname'     => $lname,
3432
+				'ATT_full_name' => "{$fname} {$lname}",
3433
+				'ATT_address'   => $this->request->getRequestParam('ATT_address', ''),
3434
+				'ATT_address2'  => $this->request->getRequestParam('ATT_address2', ''),
3435
+				'ATT_city'      => $this->request->getRequestParam('ATT_city', ''),
3436
+				'STA_ID'        => $this->request->getRequestParam('STA_ID', ''),
3437
+				'CNT_ISO'       => $this->request->getRequestParam('CNT_ISO', ''),
3438
+				'ATT_zip'       => $this->request->getRequestParam('ATT_zip', ''),
3439
+			];
3440
+			foreach ($updated_fields as $field => $value) {
3441
+				$attendee->set($field, $value);
3442
+			}
3443
+
3444
+			// process contact details metabox form handler (which will also save the attendee)
3445
+			$contact_details_form = $this->getAttendeeContactDetailsMetaboxFormHandler($attendee);
3446
+			$success              = $contact_details_form->process($this->request->requestParams());
3447
+
3448
+			$attendee_update_callbacks = apply_filters(
3449
+				'FHEE__Registrations_Admin_Page__insert_update_cpt_item__attendee_update',
3450
+				[]
3451
+			);
3452
+			foreach ($attendee_update_callbacks as $a_callback) {
3453
+				if (false === call_user_func_array($a_callback, [$attendee, $this->request->requestParams()])) {
3454
+					throw new EE_Error(
3455
+						sprintf(
3456
+							esc_html__(
3457
+								'The %s callback given for the "FHEE__Registrations_Admin_Page__insert_update_cpt_item__attendee_update" filter is not a valid callback.  Please check the spelling.',
3458
+								'event_espresso'
3459
+							),
3460
+							$a_callback
3461
+						)
3462
+					);
3463
+				}
3464
+			}
3465
+		}
3466
+
3467
+		if ($success === false) {
3468
+			EE_Error::add_error(
3469
+				esc_html__(
3470
+					'Something went wrong with updating the meta table data for the registration.',
3471
+					'event_espresso'
3472
+				),
3473
+				__FILE__,
3474
+				__FUNCTION__,
3475
+				__LINE__
3476
+			);
3477
+		}
3478
+	}
3479
+
3480
+
3481
+	public function trash_cpt_item($post_id)
3482
+	{
3483
+	}
3484
+
3485
+
3486
+	public function delete_cpt_item($post_id)
3487
+	{
3488
+	}
3489
+
3490
+
3491
+	public function restore_cpt_item($post_id)
3492
+	{
3493
+	}
3494
+
3495
+
3496
+	protected function _restore_cpt_item($post_id, $revision_id)
3497
+	{
3498
+	}
3499
+
3500
+
3501
+	/**
3502
+	 * @throws EE_Error
3503
+	 * @throws ReflectionException
3504
+	 * @since 4.10.2.p
3505
+	 */
3506
+	public function attendee_editor_metaboxes()
3507
+	{
3508
+		$this->verify_cpt_object();
3509
+		remove_meta_box(
3510
+			'postexcerpt',
3511
+			$this->_cpt_routes[ $this->_req_action ],
3512
+			'normal'
3513
+		);
3514
+		remove_meta_box('commentstatusdiv', $this->_cpt_routes[ $this->_req_action ], 'normal');
3515
+		if (post_type_supports('espresso_attendees', 'excerpt')) {
3516
+			add_meta_box(
3517
+				'postexcerpt',
3518
+				esc_html__('Short Biography', 'event_espresso'),
3519
+				'post_excerpt_meta_box',
3520
+				$this->_cpt_routes[ $this->_req_action ],
3521
+				'normal'
3522
+			);
3523
+		}
3524
+		if (post_type_supports('espresso_attendees', 'comments')) {
3525
+			add_meta_box(
3526
+				'commentsdiv',
3527
+				esc_html__('Notes on the Contact', 'event_espresso'),
3528
+				'post_comment_meta_box',
3529
+				$this->_cpt_routes[ $this->_req_action ],
3530
+				'normal',
3531
+				'core'
3532
+			);
3533
+		}
3534
+		add_meta_box(
3535
+			'attendee_contact_info',
3536
+			esc_html__('Contact Info', 'event_espresso'),
3537
+			[$this, 'attendee_contact_info'],
3538
+			$this->_cpt_routes[ $this->_req_action ],
3539
+			'side',
3540
+			'core'
3541
+		);
3542
+		add_meta_box(
3543
+			'attendee_details_address',
3544
+			esc_html__('Address Details', 'event_espresso'),
3545
+			[$this, 'attendee_address_details'],
3546
+			$this->_cpt_routes[ $this->_req_action ],
3547
+			'normal',
3548
+			'core'
3549
+		);
3550
+		add_meta_box(
3551
+			'attendee_registrations',
3552
+			esc_html__('Registrations for this Contact', 'event_espresso'),
3553
+			[$this, 'attendee_registrations_meta_box'],
3554
+			$this->_cpt_routes[ $this->_req_action ],
3555
+			'normal',
3556
+			'high'
3557
+		);
3558
+	}
3559
+
3560
+
3561
+	/**
3562
+	 * Metabox for attendee contact info
3563
+	 *
3564
+	 * @param WP_Post $post wp post object
3565
+	 * @return void attendee contact info ( and form )
3566
+	 * @throws EE_Error
3567
+	 * @throws InvalidArgumentException
3568
+	 * @throws InvalidDataTypeException
3569
+	 * @throws InvalidInterfaceException
3570
+	 * @throws LogicException
3571
+	 * @throws DomainException
3572
+	 */
3573
+	public function attendee_contact_info($post)
3574
+	{
3575
+		// get attendee object ( should already have it )
3576
+		$form = $this->getAttendeeContactDetailsMetaboxFormHandler($this->_cpt_model_obj);
3577
+		$form->enqueueStylesAndScripts();
3578
+		echo $form->display(); // already escaped
3579
+	}
3580
+
3581
+
3582
+	/**
3583
+	 * Return form handler for the contact details metabox
3584
+	 *
3585
+	 * @param EE_Attendee $attendee
3586
+	 * @return AttendeeContactDetailsMetaboxFormHandler
3587
+	 * @throws DomainException
3588
+	 * @throws InvalidArgumentException
3589
+	 * @throws InvalidDataTypeException
3590
+	 * @throws InvalidInterfaceException
3591
+	 */
3592
+	protected function getAttendeeContactDetailsMetaboxFormHandler(EE_Attendee $attendee)
3593
+	{
3594
+		return new AttendeeContactDetailsMetaboxFormHandler($attendee, EE_Registry::instance());
3595
+	}
3596
+
3597
+
3598
+	/**
3599
+	 * Metabox for attendee details
3600
+	 *
3601
+	 * @param WP_Post $post wp post object
3602
+	 * @throws EE_Error
3603
+	 * @throws ReflectionException
3604
+	 */
3605
+	public function attendee_address_details($post)
3606
+	{
3607
+		// get attendee object (should already have it)
3608
+		$this->_template_args['attendee']     = $this->_cpt_model_obj;
3609
+		$this->_template_args['state_html']   = EEH_Form_Fields::generate_form_input(
3610
+			new EE_Question_Form_Input(
3611
+				EE_Question::new_instance(
3612
+					[
3613
+						'QST_ID'           => 0,
3614
+						'QST_display_text' => esc_html__('State/Province', 'event_espresso'),
3615
+						'QST_system'       => 'admin-state',
3616
+					]
3617
+				),
3618
+				EE_Answer::new_instance(
3619
+					[
3620
+						'ANS_ID'    => 0,
3621
+						'ANS_value' => $this->_cpt_model_obj->state_ID(),
3622
+					]
3623
+				),
3624
+				[
3625
+					'input_id'       => 'STA_ID',
3626
+					'input_name'     => 'STA_ID',
3627
+					'input_prefix'   => '',
3628
+					'append_qstn_id' => false,
3629
+				]
3630
+			)
3631
+		);
3632
+		$this->_template_args['country_html'] = EEH_Form_Fields::generate_form_input(
3633
+			new EE_Question_Form_Input(
3634
+				EE_Question::new_instance(
3635
+					[
3636
+						'QST_ID'           => 0,
3637
+						'QST_display_text' => esc_html__('Country', 'event_espresso'),
3638
+						'QST_system'       => 'admin-country',
3639
+					]
3640
+				),
3641
+				EE_Answer::new_instance(
3642
+					[
3643
+						'ANS_ID'    => 0,
3644
+						'ANS_value' => $this->_cpt_model_obj->country_ID(),
3645
+					]
3646
+				),
3647
+				[
3648
+					'input_id'       => 'CNT_ISO',
3649
+					'input_name'     => 'CNT_ISO',
3650
+					'input_prefix'   => '',
3651
+					'append_qstn_id' => false,
3652
+				]
3653
+			)
3654
+		);
3655
+		$template                             =
3656
+			REG_TEMPLATE_PATH . 'attendee_address_details_metabox_content.template.php';
3657
+		EEH_Template::display_template($template, $this->_template_args);
3658
+	}
3659
+
3660
+
3661
+	/**
3662
+	 * _attendee_details
3663
+	 *
3664
+	 * @param $post
3665
+	 * @return void
3666
+	 * @throws DomainException
3667
+	 * @throws EE_Error
3668
+	 * @throws InvalidArgumentException
3669
+	 * @throws InvalidDataTypeException
3670
+	 * @throws InvalidInterfaceException
3671
+	 * @throws ReflectionException
3672
+	 */
3673
+	public function attendee_registrations_meta_box($post)
3674
+	{
3675
+		$this->_template_args['attendee']      = $this->_cpt_model_obj;
3676
+		$this->_template_args['registrations'] = $this->_cpt_model_obj->get_many_related('Registration');
3677
+		$template                              =
3678
+			REG_TEMPLATE_PATH . 'attendee_registrations_main_meta_box.template.php';
3679
+		EEH_Template::display_template($template, $this->_template_args);
3680
+	}
3681
+
3682
+
3683
+	/**
3684
+	 * add in the form fields for the attendee edit
3685
+	 *
3686
+	 * @param WP_Post $post wp post object
3687
+	 * @return void echos html for new form.
3688
+	 * @throws DomainException
3689
+	 */
3690
+	public function after_title_form_fields($post)
3691
+	{
3692
+		if ($post->post_type === 'espresso_attendees') {
3693
+			$template                  = REG_TEMPLATE_PATH . 'attendee_details_after_title_form_fields.template.php';
3694
+			$template_args['attendee'] = $this->_cpt_model_obj;
3695
+			EEH_Template::display_template($template, $template_args);
3696
+		}
3697
+	}
3698
+
3699
+
3700
+	/**
3701
+	 * _trash_or_restore_attendee
3702
+	 *
3703
+	 * @param boolean $trash - whether to move item to trash (TRUE) or restore it (FALSE)
3704
+	 * @return void
3705
+	 * @throws EE_Error
3706
+	 * @throws InvalidArgumentException
3707
+	 * @throws InvalidDataTypeException
3708
+	 * @throws InvalidInterfaceException
3709
+	 */
3710
+	protected function _trash_or_restore_attendees($trash = true)
3711
+	{
3712
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
3713
+		$status = $trash ? 'trash' : 'publish';
3714
+		// Checkboxes
3715
+		if ($this->request->requestParamIsSet('checkbox')) {
3716
+			$ATT_IDs = $this->request->getRequestParam('checkbox', [], 'int', true);
3717
+			// if array has more than one element than success message should be plural
3718
+			$success = count($ATT_IDs) > 1 ? 2 : 1;
3719
+			// cycle thru checkboxes
3720
+			foreach ($ATT_IDs as $ATT_ID) {
3721
+				$updated = $this->getAttendeeModel()->update_by_ID(['status' => $status], $ATT_ID);
3722
+				if (! $updated) {
3723
+					$success = 0;
3724
+				}
3725
+			}
3726
+		} else {
3727
+			// grab single id and delete
3728
+			$ATT_ID = $this->request->getRequestParam('ATT_ID', 0, 'int');
3729
+			// update attendee
3730
+			$success = $this->getAttendeeModel()->update_by_ID(['status' => $status], $ATT_ID) ? 1 : 0;
3731
+		}
3732
+		$what        = $success > 1
3733
+			? esc_html__('Contacts', 'event_espresso')
3734
+			: esc_html__('Contact', 'event_espresso');
3735
+		$action_desc = $trash
3736
+			? esc_html__('moved to the trash', 'event_espresso')
3737
+			: esc_html__('restored', 'event_espresso');
3738
+		$this->_redirect_after_action($success, $what, $action_desc, ['action' => 'contact_list']);
3739
+	}
3740 3740
 }
Please login to merge, or discard this patch.
admin_pages/events/templates/event_tickets_metabox_ticket_row.template.php 1 patch
Braces   +10 added lines, -4 removed lines patch added patch discarded remove patch
@@ -84,12 +84,15 @@  discard block
 block discarded – undo
84 84
                    name="edit_prices[<?php echo esc_attr($ticketrow); ?>][1][PRC_amount]"
85 85
                    value="<?php echo esc_attr($PRC_amount); ?>"
86 86
             />
87
-        <?php else : ?>
87
+        <?php else {
88
+	: ?>
88 89
             <input type="text"
89 90
                    size="1"
90 91
                    class="edit-price-PRC_amount ee-small-text-inp ee-inp-right"
91 92
                    name="disabled_price_amount"
92
-                   value="<?php echo esc_attr($PRC_amount); ?>"
93
+                   value="<?php echo esc_attr($PRC_amount);
94
+}
95
+?>"
93 96
                 <?php echo esc_attr($disabled); ?>
94 97
             />
95 98
             <input type="hidden"
@@ -123,11 +126,14 @@  discard block
 block discarded – undo
123 126
                    name="<?php echo esc_attr("{$edit_ticketrow_name}[{$ticketrow}][TKT_qty]"); ?>"
124 127
                    value="<?php echo absint($TKT_qty); ?>"
125 128
             />
126
-        <?php else : ?>
129
+        <?php else {
130
+	: ?>
127 131
             <input type="text"
128 132
                    class="edit-ticket-TKT_qty ee-small-text-inp ee-inp-right"
129 133
                    name="disabled_tkt_qty"
130
-                   value="<?php echo absint($TKT_qty); ?>"
134
+                   value="<?php echo absint($TKT_qty);
135
+}
136
+?>"
131 137
                 <?php echo esc_attr($disabled); ?>
132 138
             />
133 139
             <input type="hidden"
Please login to merge, or discard this patch.
admin_pages/events/Events_Admin_Page.core.php 2 patches
Indentation   +2796 added lines, -2796 removed lines patch added patch discarded remove patch
@@ -16,2803 +16,2803 @@
 block discarded – undo
16 16
 class Events_Admin_Page extends EE_Admin_Page_CPT
17 17
 {
18 18
 
19
-    /**
20
-     * This will hold the event object for event_details screen.
19
+	/**
20
+	 * This will hold the event object for event_details screen.
21
+	 *
22
+	 * @var EE_Event $_event
23
+	 */
24
+	protected $_event;
25
+
26
+
27
+	/**
28
+	 * This will hold the category object for category_details screen.
29
+	 *
30
+	 * @var stdClass $_category
31
+	 */
32
+	protected $_category;
33
+
34
+
35
+	/**
36
+	 * This will hold the event model instance
37
+	 *
38
+	 * @var EEM_Event $_event_model
39
+	 */
40
+	protected $_event_model;
41
+
42
+
43
+	/**
44
+	 * @var EE_Event
45
+	 */
46
+	protected $_cpt_model_obj = false;
47
+
48
+
49
+	/**
50
+	 * @var NodeGroupDao
51
+	 */
52
+	protected $model_obj_node_group_persister;
53
+
54
+
55
+	/**
56
+	 * Initialize page props for this admin page group.
57
+	 */
58
+	protected function _init_page_props()
59
+	{
60
+		$this->page_slug        = EVENTS_PG_SLUG;
61
+		$this->page_label       = EVENTS_LABEL;
62
+		$this->_admin_base_url  = EVENTS_ADMIN_URL;
63
+		$this->_admin_base_path = EVENTS_ADMIN;
64
+		$this->_cpt_model_names = [
65
+			'create_new' => 'EEM_Event',
66
+			'edit'       => 'EEM_Event',
67
+		];
68
+		$this->_cpt_edit_routes = [
69
+			'espresso_events' => 'edit',
70
+		];
71
+		add_action(
72
+			'AHEE__EE_Admin_Page_CPT__set_model_object__after_set_object',
73
+			[$this, 'verify_event_edit'],
74
+			10,
75
+			2
76
+		);
77
+	}
78
+
79
+
80
+	/**
81
+	 * Sets the ajax hooks used for this admin page group.
82
+	 */
83
+	protected function _ajax_hooks()
84
+	{
85
+		add_action('wp_ajax_ee_save_timezone_setting', [$this, 'saveTimezoneString']);
86
+	}
87
+
88
+
89
+	/**
90
+	 * Sets the page properties for this admin page group.
91
+	 */
92
+	protected function _define_page_props()
93
+	{
94
+		$this->_admin_page_title = EVENTS_LABEL;
95
+		$this->_labels           = [
96
+			'buttons'      => [
97
+				'add'             => esc_html__('Add New Event', 'event_espresso'),
98
+				'edit'            => esc_html__('Edit Event', 'event_espresso'),
99
+				'delete'          => esc_html__('Delete Event', 'event_espresso'),
100
+				'add_category'    => esc_html__('Add New Category', 'event_espresso'),
101
+				'edit_category'   => esc_html__('Edit Category', 'event_espresso'),
102
+				'delete_category' => esc_html__('Delete Category', 'event_espresso'),
103
+			],
104
+			'editor_title' => [
105
+				'espresso_events' => esc_html__('Enter event title here', 'event_espresso'),
106
+			],
107
+			'publishbox'   => [
108
+				'create_new'        => esc_html__('Save New Event', 'event_espresso'),
109
+				'edit'              => esc_html__('Update Event', 'event_espresso'),
110
+				'add_category'      => esc_html__('Save New Category', 'event_espresso'),
111
+				'edit_category'     => esc_html__('Update Category', 'event_espresso'),
112
+				'template_settings' => esc_html__('Update Settings', 'event_espresso'),
113
+			],
114
+		];
115
+	}
116
+
117
+
118
+	/**
119
+	 * Sets the page routes property for this admin page group.
120
+	 */
121
+	protected function _set_page_routes()
122
+	{
123
+		// load formatter helper
124
+		// load field generator helper
125
+		// is there a evt_id in the request?
126
+		$EVT_ID = $this->request->getRequestParam('EVT_ID', 0, 'int');
127
+		$EVT_ID = $this->request->getRequestParam('post', $EVT_ID, 'int');
128
+
129
+		$this->_page_routes = [
130
+			'default'                       => [
131
+				'func'       => '_events_overview_list_table',
132
+				'capability' => 'ee_read_events',
133
+			],
134
+			'create_new'                    => [
135
+				'func'       => '_create_new_cpt_item',
136
+				'capability' => 'ee_edit_events',
137
+			],
138
+			'edit'                          => [
139
+				'func'       => '_edit_cpt_item',
140
+				'capability' => 'ee_edit_event',
141
+				'obj_id'     => $EVT_ID,
142
+			],
143
+			'copy_event'                    => [
144
+				'func'       => '_copy_events',
145
+				'capability' => 'ee_edit_event',
146
+				'obj_id'     => $EVT_ID,
147
+				'noheader'   => true,
148
+			],
149
+			'trash_event'                   => [
150
+				'func'       => '_trash_or_restore_event',
151
+				'args'       => ['event_status' => 'trash'],
152
+				'capability' => 'ee_delete_event',
153
+				'obj_id'     => $EVT_ID,
154
+				'noheader'   => true,
155
+			],
156
+			'trash_events'                  => [
157
+				'func'       => '_trash_or_restore_events',
158
+				'args'       => ['event_status' => 'trash'],
159
+				'capability' => 'ee_delete_events',
160
+				'noheader'   => true,
161
+			],
162
+			'restore_event'                 => [
163
+				'func'       => '_trash_or_restore_event',
164
+				'args'       => ['event_status' => 'draft'],
165
+				'capability' => 'ee_delete_event',
166
+				'obj_id'     => $EVT_ID,
167
+				'noheader'   => true,
168
+			],
169
+			'restore_events'                => [
170
+				'func'       => '_trash_or_restore_events',
171
+				'args'       => ['event_status' => 'draft'],
172
+				'capability' => 'ee_delete_events',
173
+				'noheader'   => true,
174
+			],
175
+			'delete_event'                  => [
176
+				'func'       => '_delete_event',
177
+				'capability' => 'ee_delete_event',
178
+				'obj_id'     => $EVT_ID,
179
+				'noheader'   => true,
180
+			],
181
+			'delete_events'                 => [
182
+				'func'       => '_delete_events',
183
+				'capability' => 'ee_delete_events',
184
+				'noheader'   => true,
185
+			],
186
+			'view_report'                   => [
187
+				'func'       => '_view_report',
188
+				'capability' => 'ee_edit_events',
189
+			],
190
+			'default_event_settings'        => [
191
+				'func'       => '_default_event_settings',
192
+				'capability' => 'manage_options',
193
+			],
194
+			'update_default_event_settings' => [
195
+				'func'       => '_update_default_event_settings',
196
+				'capability' => 'manage_options',
197
+				'noheader'   => true,
198
+			],
199
+			'template_settings'             => [
200
+				'func'       => '_template_settings',
201
+				'capability' => 'manage_options',
202
+			],
203
+			// event category tab related
204
+			'add_category'                  => [
205
+				'func'       => '_category_details',
206
+				'capability' => 'ee_edit_event_category',
207
+				'args'       => ['add'],
208
+			],
209
+			'edit_category'                 => [
210
+				'func'       => '_category_details',
211
+				'capability' => 'ee_edit_event_category',
212
+				'args'       => ['edit'],
213
+			],
214
+			'delete_categories'             => [
215
+				'func'       => '_delete_categories',
216
+				'capability' => 'ee_delete_event_category',
217
+				'noheader'   => true,
218
+			],
219
+			'delete_category'               => [
220
+				'func'       => '_delete_categories',
221
+				'capability' => 'ee_delete_event_category',
222
+				'noheader'   => true,
223
+			],
224
+			'insert_category'               => [
225
+				'func'       => '_insert_or_update_category',
226
+				'args'       => ['new_category' => true],
227
+				'capability' => 'ee_edit_event_category',
228
+				'noheader'   => true,
229
+			],
230
+			'update_category'               => [
231
+				'func'       => '_insert_or_update_category',
232
+				'args'       => ['new_category' => false],
233
+				'capability' => 'ee_edit_event_category',
234
+				'noheader'   => true,
235
+			],
236
+			'category_list'                 => [
237
+				'func'       => '_category_list_table',
238
+				'capability' => 'ee_manage_event_categories',
239
+			],
240
+			'preview_deletion'              => [
241
+				'func'       => 'previewDeletion',
242
+				'capability' => 'ee_delete_events',
243
+			],
244
+			'confirm_deletion'              => [
245
+				'func'       => 'confirmDeletion',
246
+				'capability' => 'ee_delete_events',
247
+				'noheader'   => true,
248
+			],
249
+		];
250
+	}
251
+
252
+
253
+	/**
254
+	 * Set the _page_config property for this admin page group.
255
+	 */
256
+	protected function _set_page_config()
257
+	{
258
+		$post_id            = $this->request->getRequestParam('post', 0, 'int');
259
+		$EVT_CAT_ID         = $this->request->getRequestParam('EVT_CAT_ID', 0, 'int');
260
+		$this->_page_config = [
261
+			'default'                => [
262
+				'nav'           => [
263
+					'label' => esc_html__('Overview', 'event_espresso'),
264
+					'order' => 10,
265
+				],
266
+				'list_table'    => 'Events_Admin_List_Table',
267
+				'help_tabs'     => [
268
+					'events_overview_help_tab'                       => [
269
+						'title'    => esc_html__('Events Overview', 'event_espresso'),
270
+						'filename' => 'events_overview',
271
+					],
272
+					'events_overview_table_column_headings_help_tab' => [
273
+						'title'    => esc_html__('Events Overview Table Column Headings', 'event_espresso'),
274
+						'filename' => 'events_overview_table_column_headings',
275
+					],
276
+					'events_overview_filters_help_tab'               => [
277
+						'title'    => esc_html__('Events Overview Filters', 'event_espresso'),
278
+						'filename' => 'events_overview_filters',
279
+					],
280
+					'events_overview_view_help_tab'                  => [
281
+						'title'    => esc_html__('Events Overview Views', 'event_espresso'),
282
+						'filename' => 'events_overview_views',
283
+					],
284
+					'events_overview_other_help_tab'                 => [
285
+						'title'    => esc_html__('Events Overview Other', 'event_espresso'),
286
+						'filename' => 'events_overview_other',
287
+					],
288
+				],
289
+				'qtips'         => [
290
+					'EE_Event_List_Table_Tips',
291
+				],
292
+				'require_nonce' => false,
293
+			],
294
+			'create_new'             => [
295
+				'nav'           => [
296
+					'label'      => esc_html__('Add Event', 'event_espresso'),
297
+					'order'      => 5,
298
+					'persistent' => false,
299
+				],
300
+				'metaboxes'     => ['_register_event_editor_meta_boxes'],
301
+				'help_tabs'     => [
302
+					'event_editor_help_tab'                            => [
303
+						'title'    => esc_html__('Event Editor', 'event_espresso'),
304
+						'filename' => 'event_editor',
305
+					],
306
+					'event_editor_title_richtexteditor_help_tab'       => [
307
+						'title'    => esc_html__('Event Title & Rich Text Editor', 'event_espresso'),
308
+						'filename' => 'event_editor_title_richtexteditor',
309
+					],
310
+					'event_editor_venue_details_help_tab'              => [
311
+						'title'    => esc_html__('Event Venue Details', 'event_espresso'),
312
+						'filename' => 'event_editor_venue_details',
313
+					],
314
+					'event_editor_event_datetimes_help_tab'            => [
315
+						'title'    => esc_html__('Event Datetimes', 'event_espresso'),
316
+						'filename' => 'event_editor_event_datetimes',
317
+					],
318
+					'event_editor_event_tickets_help_tab'              => [
319
+						'title'    => esc_html__('Event Tickets', 'event_espresso'),
320
+						'filename' => 'event_editor_event_tickets',
321
+					],
322
+					'event_editor_event_registration_options_help_tab' => [
323
+						'title'    => esc_html__('Event Registration Options', 'event_espresso'),
324
+						'filename' => 'event_editor_event_registration_options',
325
+					],
326
+					'event_editor_tags_categories_help_tab'            => [
327
+						'title'    => esc_html__('Event Tags & Categories', 'event_espresso'),
328
+						'filename' => 'event_editor_tags_categories',
329
+					],
330
+					'event_editor_questions_registrants_help_tab'      => [
331
+						'title'    => esc_html__('Questions for Registrants', 'event_espresso'),
332
+						'filename' => 'event_editor_questions_registrants',
333
+					],
334
+					'event_editor_save_new_event_help_tab'             => [
335
+						'title'    => esc_html__('Save New Event', 'event_espresso'),
336
+						'filename' => 'event_editor_save_new_event',
337
+					],
338
+					'event_editor_other_help_tab'                      => [
339
+						'title'    => esc_html__('Event Other', 'event_espresso'),
340
+						'filename' => 'event_editor_other',
341
+					],
342
+				],
343
+				'qtips'         => ['EE_Event_Editor_Decaf_Tips'],
344
+				'require_nonce' => false,
345
+			],
346
+			'edit'                   => [
347
+				'nav'           => [
348
+					'label'      => esc_html__('Edit Event', 'event_espresso'),
349
+					'order'      => 5,
350
+					'persistent' => false,
351
+					'url'        => $post_id
352
+						? EE_Admin_Page::add_query_args_and_nonce(
353
+							['post' => $post_id, 'action' => 'edit'],
354
+							$this->_current_page_view_url
355
+						)
356
+						: $this->_admin_base_url,
357
+				],
358
+				'metaboxes'     => ['_register_event_editor_meta_boxes'],
359
+				'help_tabs'     => [
360
+					'event_editor_help_tab'                            => [
361
+						'title'    => esc_html__('Event Editor', 'event_espresso'),
362
+						'filename' => 'event_editor',
363
+					],
364
+					'event_editor_title_richtexteditor_help_tab'       => [
365
+						'title'    => esc_html__('Event Title & Rich Text Editor', 'event_espresso'),
366
+						'filename' => 'event_editor_title_richtexteditor',
367
+					],
368
+					'event_editor_venue_details_help_tab'              => [
369
+						'title'    => esc_html__('Event Venue Details', 'event_espresso'),
370
+						'filename' => 'event_editor_venue_details',
371
+					],
372
+					'event_editor_event_datetimes_help_tab'            => [
373
+						'title'    => esc_html__('Event Datetimes', 'event_espresso'),
374
+						'filename' => 'event_editor_event_datetimes',
375
+					],
376
+					'event_editor_event_tickets_help_tab'              => [
377
+						'title'    => esc_html__('Event Tickets', 'event_espresso'),
378
+						'filename' => 'event_editor_event_tickets',
379
+					],
380
+					'event_editor_event_registration_options_help_tab' => [
381
+						'title'    => esc_html__('Event Registration Options', 'event_espresso'),
382
+						'filename' => 'event_editor_event_registration_options',
383
+					],
384
+					'event_editor_tags_categories_help_tab'            => [
385
+						'title'    => esc_html__('Event Tags & Categories', 'event_espresso'),
386
+						'filename' => 'event_editor_tags_categories',
387
+					],
388
+					'event_editor_questions_registrants_help_tab'      => [
389
+						'title'    => esc_html__('Questions for Registrants', 'event_espresso'),
390
+						'filename' => 'event_editor_questions_registrants',
391
+					],
392
+					'event_editor_save_new_event_help_tab'             => [
393
+						'title'    => esc_html__('Save New Event', 'event_espresso'),
394
+						'filename' => 'event_editor_save_new_event',
395
+					],
396
+					'event_editor_other_help_tab'                      => [
397
+						'title'    => esc_html__('Event Other', 'event_espresso'),
398
+						'filename' => 'event_editor_other',
399
+					],
400
+				],
401
+				'qtips'         => ['EE_Event_Editor_Decaf_Tips'],
402
+				'require_nonce' => false,
403
+			],
404
+			'default_event_settings' => [
405
+				'nav'           => [
406
+					'label' => esc_html__('Default Settings', 'event_espresso'),
407
+					'order' => 40,
408
+				],
409
+				'metaboxes'     => array_merge($this->_default_espresso_metaboxes, ['_publish_post_box']),
410
+				'labels'        => [
411
+					'publishbox' => esc_html__('Update Settings', 'event_espresso'),
412
+				],
413
+				'help_tabs'     => [
414
+					'default_settings_help_tab'        => [
415
+						'title'    => esc_html__('Default Event Settings', 'event_espresso'),
416
+						'filename' => 'events_default_settings',
417
+					],
418
+					'default_settings_status_help_tab' => [
419
+						'title'    => esc_html__('Default Registration Status', 'event_espresso'),
420
+						'filename' => 'events_default_settings_status',
421
+					],
422
+					'default_maximum_tickets_help_tab' => [
423
+						'title'    => esc_html__('Default Maximum Tickets Per Order', 'event_espresso'),
424
+						'filename' => 'events_default_settings_max_tickets',
425
+					],
426
+				],
427
+				'require_nonce' => false,
428
+			],
429
+			// template settings
430
+			'template_settings'      => [
431
+				'nav'           => [
432
+					'label' => esc_html__('Templates', 'event_espresso'),
433
+					'order' => 30,
434
+				],
435
+				'metaboxes'     => $this->_default_espresso_metaboxes,
436
+				'help_tabs'     => [
437
+					'general_settings_templates_help_tab' => [
438
+						'title'    => esc_html__('Templates', 'event_espresso'),
439
+						'filename' => 'general_settings_templates',
440
+					],
441
+				],
442
+				'require_nonce' => false,
443
+			],
444
+			// event category stuff
445
+			'add_category'           => [
446
+				'nav'           => [
447
+					'label'      => esc_html__('Add Category', 'event_espresso'),
448
+					'order'      => 15,
449
+					'persistent' => false,
450
+				],
451
+				'help_tabs'     => [
452
+					'add_category_help_tab' => [
453
+						'title'    => esc_html__('Add New Event Category', 'event_espresso'),
454
+						'filename' => 'events_add_category',
455
+					],
456
+				],
457
+				'metaboxes'     => ['_publish_post_box'],
458
+				'require_nonce' => false,
459
+			],
460
+			'edit_category'          => [
461
+				'nav'           => [
462
+					'label'      => esc_html__('Edit Category', 'event_espresso'),
463
+					'order'      => 15,
464
+					'persistent' => false,
465
+					'url'        => $EVT_CAT_ID
466
+						? add_query_arg(
467
+							['EVT_CAT_ID' => $EVT_CAT_ID],
468
+							$this->_current_page_view_url
469
+						)
470
+						: $this->_admin_base_url,
471
+				],
472
+				'help_tabs'     => [
473
+					'edit_category_help_tab' => [
474
+						'title'    => esc_html__('Edit Event Category', 'event_espresso'),
475
+						'filename' => 'events_edit_category',
476
+					],
477
+				],
478
+				'metaboxes'     => ['_publish_post_box'],
479
+				'require_nonce' => false,
480
+			],
481
+			'category_list'          => [
482
+				'nav'           => [
483
+					'label' => esc_html__('Categories', 'event_espresso'),
484
+					'order' => 20,
485
+				],
486
+				'list_table'    => 'Event_Categories_Admin_List_Table',
487
+				'help_tabs'     => [
488
+					'events_categories_help_tab'                       => [
489
+						'title'    => esc_html__('Event Categories', 'event_espresso'),
490
+						'filename' => 'events_categories',
491
+					],
492
+					'events_categories_table_column_headings_help_tab' => [
493
+						'title'    => esc_html__('Event Categories Table Column Headings', 'event_espresso'),
494
+						'filename' => 'events_categories_table_column_headings',
495
+					],
496
+					'events_categories_view_help_tab'                  => [
497
+						'title'    => esc_html__('Event Categories Views', 'event_espresso'),
498
+						'filename' => 'events_categories_views',
499
+					],
500
+					'events_categories_other_help_tab'                 => [
501
+						'title'    => esc_html__('Event Categories Other', 'event_espresso'),
502
+						'filename' => 'events_categories_other',
503
+					],
504
+				],
505
+				'metaboxes'     => $this->_default_espresso_metaboxes,
506
+				'require_nonce' => false,
507
+			],
508
+			'preview_deletion'       => [
509
+				'nav'           => [
510
+					'label'      => esc_html__('Preview Deletion', 'event_espresso'),
511
+					'order'      => 15,
512
+					'persistent' => false,
513
+					'url'        => '',
514
+				],
515
+				'require_nonce' => false,
516
+			],
517
+		];
518
+	}
519
+
520
+
521
+	/**
522
+	 * Used to register any global screen options if necessary for every route in this admin page group.
523
+	 */
524
+	protected function _add_screen_options()
525
+	{
526
+	}
527
+
528
+
529
+	/**
530
+	 * Implementing the screen options for the 'default' route.
531
+	 */
532
+	protected function _add_screen_options_default()
533
+	{
534
+		$this->_per_page_screen_option();
535
+	}
536
+
537
+
538
+	/**
539
+	 * Implementing screen options for the category list route.
540
+	 */
541
+	protected function _add_screen_options_category_list()
542
+	{
543
+		$page_title              = $this->_admin_page_title;
544
+		$this->_admin_page_title = esc_html__('Categories', 'event_espresso');
545
+		$this->_per_page_screen_option();
546
+		$this->_admin_page_title = $page_title;
547
+	}
548
+
549
+
550
+	/**
551
+	 * Used to register any global feature pointers for the admin page group.
552
+	 */
553
+	protected function _add_feature_pointers()
554
+	{
555
+	}
556
+
557
+
558
+	/**
559
+	 * Registers and enqueues any global scripts and styles for the entire admin page group.
560
+	 */
561
+	public function load_scripts_styles()
562
+	{
563
+		wp_register_style(
564
+			'events-admin-css',
565
+			EVENTS_ASSETS_URL . 'events-admin-page.css',
566
+			[],
567
+			EVENT_ESPRESSO_VERSION
568
+		);
569
+		wp_register_style('ee-cat-admin', EVENTS_ASSETS_URL . 'ee-cat-admin.css', [], EVENT_ESPRESSO_VERSION);
570
+		wp_enqueue_style('events-admin-css');
571
+		wp_enqueue_style('ee-cat-admin');
572
+		// todo note: we also need to load_scripts_styles per view (i.e. default/view_report/event_details
573
+		// registers for all views
574
+		// scripts
575
+		wp_register_script(
576
+			'event_editor_js',
577
+			EVENTS_ASSETS_URL . 'event_editor.js',
578
+			['ee_admin_js', 'jquery-ui-slider', 'jquery-ui-timepicker-addon'],
579
+			EVENT_ESPRESSO_VERSION,
580
+			true
581
+		);
582
+	}
583
+
584
+
585
+	/**
586
+	 * Enqueuing scripts and styles specific to this view
587
+	 */
588
+	public function load_scripts_styles_create_new()
589
+	{
590
+		$this->load_scripts_styles_edit();
591
+	}
592
+
593
+
594
+	/**
595
+	 * Enqueuing scripts and styles specific to this view
596
+	 */
597
+	public function load_scripts_styles_edit()
598
+	{
599
+		// styles
600
+		wp_enqueue_style('espresso-ui-theme');
601
+		wp_register_style(
602
+			'event-editor-css',
603
+			EVENTS_ASSETS_URL . 'event-editor.css',
604
+			['ee-admin-css'],
605
+			EVENT_ESPRESSO_VERSION
606
+		);
607
+		wp_enqueue_style('event-editor-css');
608
+		// scripts
609
+		wp_register_script(
610
+			'event-datetime-metabox',
611
+			EVENTS_ASSETS_URL . 'event-datetime-metabox.js',
612
+			['event_editor_js', 'ee-datepicker'],
613
+			EVENT_ESPRESSO_VERSION
614
+		);
615
+		wp_enqueue_script('event-datetime-metabox');
616
+	}
617
+
618
+
619
+	/**
620
+	 * Populating the _views property for the category list table view.
621
+	 */
622
+	protected function _set_list_table_views_category_list()
623
+	{
624
+		$this->_views = [
625
+			'all' => [
626
+				'slug'        => 'all',
627
+				'label'       => esc_html__('All', 'event_espresso'),
628
+				'count'       => 0,
629
+				'bulk_action' => [
630
+					'delete_categories' => esc_html__('Delete Permanently', 'event_espresso'),
631
+				],
632
+			],
633
+		];
634
+	}
635
+
636
+
637
+	/**
638
+	 * For adding anything that fires on the admin_init hook for any route within this admin page group.
639
+	 */
640
+	public function admin_init()
641
+	{
642
+		EE_Registry::$i18n_js_strings['image_confirm'] = esc_html__(
643
+			'Do you really want to delete this image? Please remember to update your event to complete the removal.',
644
+			'event_espresso'
645
+		);
646
+	}
647
+
648
+
649
+	/**
650
+	 * For adding anything that should be triggered on the admin_notices hook for any route within this admin page
651
+	 * group.
652
+	 */
653
+	public function admin_notices()
654
+	{
655
+	}
656
+
657
+
658
+	/**
659
+	 * For adding anything that should be triggered on the `admin_print_footer_scripts` hook for any route within
660
+	 * this admin page group.
661
+	 */
662
+	public function admin_footer_scripts()
663
+	{
664
+	}
665
+
666
+
667
+	/**
668
+	 * Call this function to verify if an event is public and has tickets for sale.  If it does, then we need to show a
669
+	 * warning (via EE_Error::add_error());
670
+	 *
671
+	 * @param EE_Event $event Event object
672
+	 * @param string   $req_type
673
+	 * @return void
674
+	 * @throws EE_Error
675
+	 * @throws ReflectionException
676
+	 */
677
+	public function verify_event_edit($event = null, $req_type = '')
678
+	{
679
+		// don't need to do this when processing
680
+		if (! empty($req_type)) {
681
+			return;
682
+		}
683
+		// no event?
684
+		if (empty($event)) {
685
+			// set event
686
+			$event = $this->_cpt_model_obj;
687
+		}
688
+		// STILL no event?
689
+		if (! $event instanceof EE_Event) {
690
+			return;
691
+		}
692
+		$orig_status = $event->status();
693
+		// first check if event is active.
694
+		if (
695
+			$orig_status === EEM_Event::cancelled
696
+			|| $orig_status === EEM_Event::postponed
697
+			|| $event->is_expired()
698
+			|| $event->is_inactive()
699
+		) {
700
+			return;
701
+		}
702
+		// made it here so it IS active... next check that any of the tickets are sold.
703
+		if ($event->is_sold_out(true)) {
704
+			if ($orig_status !== EEM_Event::sold_out && $event->status() !== $orig_status) {
705
+				EE_Error::add_attention(
706
+					sprintf(
707
+						esc_html__(
708
+							'Please note that the Event Status has automatically been changed to %s because there are no more spaces available for this event.  However, this change is not permanent until you update the event.  You can change the status back to something else before updating if you wish.',
709
+							'event_espresso'
710
+						),
711
+						EEH_Template::pretty_status(EEM_Event::sold_out, false, 'sentence')
712
+					)
713
+				);
714
+			}
715
+			return;
716
+		} elseif ($orig_status === EEM_Event::sold_out) {
717
+			EE_Error::add_attention(
718
+				sprintf(
719
+					esc_html__(
720
+						'Please note that the Event Status has automatically been changed to %s because more spaces have become available for this event, most likely due to abandoned transactions freeing up reserved tickets.  However, this change is not permanent until you update the event. If you wish, you can change the status back to something else before updating.',
721
+						'event_espresso'
722
+					),
723
+					EEH_Template::pretty_status($event->status(), false, 'sentence')
724
+				)
725
+			);
726
+		}
727
+		// now we need to determine if the event has any tickets on sale.  If not then we dont' show the error
728
+		if (! $event->tickets_on_sale()) {
729
+			return;
730
+		}
731
+		// made it here so show warning
732
+		$this->_edit_event_warning();
733
+	}
734
+
735
+
736
+	/**
737
+	 * This is the text used for when an event is being edited that is public and has tickets for sale.
738
+	 * When needed, hook this into a EE_Error::add_error() notice.
739
+	 *
740
+	 * @access protected
741
+	 * @return void
742
+	 */
743
+	protected function _edit_event_warning()
744
+	{
745
+		// we don't want to add warnings during these requests
746
+		if ($this->request->getRequestParam('action') === 'editpost') {
747
+			return;
748
+		}
749
+		EE_Error::add_attention(
750
+			sprintf(
751
+				esc_html__(
752
+					'Your event is open for registration. Making changes may disrupt any transactions in progress. %sLearn more%s',
753
+					'event_espresso'
754
+				),
755
+				'<a class="espresso-help-tab-lnk">',
756
+				'</a>'
757
+			)
758
+		);
759
+	}
760
+
761
+
762
+	/**
763
+	 * When a user is creating a new event, notify them if they haven't set their timezone.
764
+	 * Otherwise, do the normal logic
765
+	 *
766
+	 * @return void
767
+	 * @throws EE_Error
768
+	 */
769
+	protected function _create_new_cpt_item()
770
+	{
771
+		$has_timezone_string = get_option('timezone_string');
772
+		// only nag them about setting their timezone if it's their first event, and they haven't already done it
773
+		if (! $has_timezone_string && ! EEM_Event::instance()->exists([])) {
774
+			EE_Error::add_attention(
775
+				sprintf(
776
+					esc_html__(
777
+						'Your website\'s timezone is currently set to a UTC offset. We recommend updating your timezone to a city or region near you before you create an event. Change your timezone now:%1$s%2$s%3$sChange Timezone%4$s',
778
+						'event_espresso'
779
+					),
780
+					'<br>',
781
+					'<select id="timezone_string" name="timezone_string" aria-describedby="timezone-description">'
782
+					. EEH_DTT_Helper::wp_timezone_choice('', EEH_DTT_Helper::get_user_locale())
783
+					. '</select>',
784
+					'<button class="button button-secondary timezone-submit">',
785
+					'</button><span class="spinner"></span>'
786
+				),
787
+				__FILE__,
788
+				__FUNCTION__,
789
+				__LINE__
790
+			);
791
+		}
792
+		parent::_create_new_cpt_item();
793
+	}
794
+
795
+
796
+	/**
797
+	 * Sets the _views property for the default route in this admin page group.
798
+	 */
799
+	protected function _set_list_table_views_default()
800
+	{
801
+		$this->_views = [
802
+			'all'   => [
803
+				'slug'        => 'all',
804
+				'label'       => esc_html__('View All Events', 'event_espresso'),
805
+				'count'       => 0,
806
+				'bulk_action' => [
807
+					'trash_events' => esc_html__('Move to Trash', 'event_espresso'),
808
+				],
809
+			],
810
+			'draft' => [
811
+				'slug'        => 'draft',
812
+				'label'       => esc_html__('Draft', 'event_espresso'),
813
+				'count'       => 0,
814
+				'bulk_action' => [
815
+					'trash_events' => esc_html__('Move to Trash', 'event_espresso'),
816
+				],
817
+			],
818
+		];
819
+		if (EE_Registry::instance()->CAP->current_user_can('ee_delete_events', 'espresso_events_trash_events')) {
820
+			$this->_views['trash'] = [
821
+				'slug'        => 'trash',
822
+				'label'       => esc_html__('Trash', 'event_espresso'),
823
+				'count'       => 0,
824
+				'bulk_action' => [
825
+					'restore_events' => esc_html__('Restore From Trash', 'event_espresso'),
826
+					'delete_events'  => esc_html__('Delete Permanently', 'event_espresso'),
827
+				],
828
+			];
829
+		}
830
+	}
831
+
832
+
833
+	/**
834
+	 * Provides the legend item array for the default list table view.
835
+	 *
836
+	 * @return array
837
+	 * @throws EE_Error
838
+	 * @throws EE_Error
839
+	 */
840
+	protected function _event_legend_items()
841
+	{
842
+		$items    = [
843
+			'view_details'   => [
844
+				'class' => 'dashicons dashicons-search',
845
+				'desc'  => esc_html__('View Event', 'event_espresso'),
846
+			],
847
+			'edit_event'     => [
848
+				'class' => 'ee-icon ee-icon-calendar-edit',
849
+				'desc'  => esc_html__('Edit Event Details', 'event_espresso'),
850
+			],
851
+			'view_attendees' => [
852
+				'class' => 'dashicons dashicons-groups',
853
+				'desc'  => esc_html__('View Registrations for Event', 'event_espresso'),
854
+			],
855
+		];
856
+		$items    = apply_filters('FHEE__Events_Admin_Page___event_legend_items__items', $items);
857
+		$statuses = [
858
+			'sold_out_status'  => [
859
+				'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::sold_out,
860
+				'desc'  => EEH_Template::pretty_status(EE_Datetime::sold_out, false, 'sentence'),
861
+			],
862
+			'active_status'    => [
863
+				'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::active,
864
+				'desc'  => EEH_Template::pretty_status(EE_Datetime::active, false, 'sentence'),
865
+			],
866
+			'upcoming_status'  => [
867
+				'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::upcoming,
868
+				'desc'  => EEH_Template::pretty_status(EE_Datetime::upcoming, false, 'sentence'),
869
+			],
870
+			'postponed_status' => [
871
+				'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::postponed,
872
+				'desc'  => EEH_Template::pretty_status(EE_Datetime::postponed, false, 'sentence'),
873
+			],
874
+			'cancelled_status' => [
875
+				'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::cancelled,
876
+				'desc'  => EEH_Template::pretty_status(EE_Datetime::cancelled, false, 'sentence'),
877
+			],
878
+			'expired_status'   => [
879
+				'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::expired,
880
+				'desc'  => EEH_Template::pretty_status(EE_Datetime::expired, false, 'sentence'),
881
+			],
882
+			'inactive_status'  => [
883
+				'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::inactive,
884
+				'desc'  => EEH_Template::pretty_status(EE_Datetime::inactive, false, 'sentence'),
885
+			],
886
+		];
887
+		$statuses = apply_filters('FHEE__Events_Admin_Page__event_legend_items__statuses', $statuses);
888
+		return array_merge($items, $statuses);
889
+	}
890
+
891
+
892
+	/**
893
+	 * @return EEM_Event
894
+	 * @throws EE_Error
895
+	 * @throws ReflectionException
896
+	 */
897
+	private function _event_model()
898
+	{
899
+		if (! $this->_event_model instanceof EEM_Event) {
900
+			$this->_event_model = EE_Registry::instance()->load_model('Event');
901
+		}
902
+		return $this->_event_model;
903
+	}
904
+
905
+
906
+	/**
907
+	 * Adds extra buttons to the WP CPT permalink field row.
908
+	 * Method is called from parent and is hooked into the wp 'get_sample_permalink_html' filter.
909
+	 *
910
+	 * @param string $return    the current html
911
+	 * @param int    $id        the post id for the page
912
+	 * @param string $new_title What the title is
913
+	 * @param string $new_slug  what the slug is
914
+	 * @return string            The new html string for the permalink area
915
+	 */
916
+	public function extra_permalink_field_buttons($return, $id, $new_title, $new_slug)
917
+	{
918
+		// make sure this is only when editing
919
+		if (! empty($id)) {
920
+			$post   = get_post($id);
921
+			$return .= '<a class="button button-small" onclick="prompt(\'Shortcode:\', jQuery(\'#shortcode\').val()); return false;" href="#"  tabindex="-1">'
922
+					   . esc_html__('Shortcode', 'event_espresso')
923
+					   . '</a> ';
924
+			$return .= '<input id="shortcode" type="hidden" value="[ESPRESSO_TICKET_SELECTOR event_id='
925
+					   . $post->ID
926
+					   . ']">';
927
+		}
928
+		return $return;
929
+	}
930
+
931
+
932
+	/**
933
+	 * _events_overview_list_table
934
+	 * This contains the logic for showing the events_overview list
935
+	 *
936
+	 * @access protected
937
+	 * @return void
938
+	 * @throws EE_Error
939
+	 */
940
+	protected function _events_overview_list_table()
941
+	{
942
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
943
+		$this->_template_args['after_list_table']                           =
944
+			! empty($this->_template_args['after_list_table'])
945
+				? (array) $this->_template_args['after_list_table']
946
+				: [];
947
+		$this->_template_args['after_list_table']['view_event_list_button'] = EEH_HTML::br()
948
+			. EEH_Template::get_button_or_link(
949
+				get_post_type_archive_link('espresso_events'),
950
+				esc_html__("View Event Archive Page", "event_espresso"),
951
+				'button'
952
+			);
953
+		$this->_template_args['after_list_table']['legend']                 = $this->_display_legend(
954
+			$this->_event_legend_items()
955
+		);
956
+		$this->_admin_page_title                                            .= ' ' . $this->get_action_link_or_button(
957
+			'create_new',
958
+			'add',
959
+			[],
960
+			'add-new-h2'
961
+		);
962
+		$this->display_admin_list_table_page_with_no_sidebar();
963
+	}
964
+
965
+
966
+	/**
967
+	 * this allows for extra misc actions in the default WP publish box
968
+	 *
969
+	 * @return void
970
+	 * @throws EE_Error
971
+	 * @throws ReflectionException
972
+	 */
973
+	public function extra_misc_actions_publish_box()
974
+	{
975
+		$this->_generate_publish_box_extra_content();
976
+	}
977
+
978
+
979
+	/**
980
+	 * This is hooked into the WordPress do_action('save_post') hook and runs after the custom post type has been
981
+	 * saved.
982
+	 * Typically you would use this to save any additional data.
983
+	 * Keep in mind also that "save_post" runs on EVERY post update to the database.
984
+	 * ALSO very important.  When a post transitions from scheduled to published,
985
+	 * the save_post action is fired but you will NOT have any _POST data containing any extra info you may have from
986
+	 * other meta saves. So MAKE sure that you handle this accordingly.
987
+	 *
988
+	 * @access protected
989
+	 * @abstract
990
+	 * @param string $post_id The ID of the cpt that was saved (so you can link relationally)
991
+	 * @param WP_Post $post    The post object of the cpt that was saved.
992
+	 * @return void
993
+	 * @throws EE_Error
994
+	 * @throws ReflectionException
995
+	 */
996
+	protected function _insert_update_cpt_item($post_id, $post)
997
+	{
998
+		if ($post instanceof WP_Post && $post->post_type !== 'espresso_events') {
999
+			// get out we're not processing an event save.
1000
+			return;
1001
+		}
1002
+
1003
+		$event_values = [
1004
+			'EVT_display_desc'                => $this->request->getRequestParam('display_desc', false, 'bool'),
1005
+			'EVT_display_ticket_selector'     => $this->request->getRequestParam(
1006
+				'display_ticket_selector',
1007
+				false,
1008
+				'bool'
1009
+			),
1010
+			'EVT_additional_limit'            => min(
1011
+				apply_filters('FHEE__EE_Events_Admin__insert_update_cpt_item__EVT_additional_limit_max', 255),
1012
+				$this->request->getRequestParam('additional_limit', null, 'int')
1013
+			),
1014
+			'EVT_default_registration_status' => $this->request->getRequestParam(
1015
+				'EVT_default_registration_status',
1016
+				EE_Registry::instance()->CFG->registration->default_STS_ID
1017
+			),
1018
+
1019
+			'EVT_member_only'     => $this->request->getRequestParam('member_only', false, 'bool'),
1020
+			'EVT_allow_overflow'  => $this->request->getRequestParam('EVT_allow_overflow', false, 'bool'),
1021
+			'EVT_timezone_string' => $this->request->getRequestParam('timezone_string'),
1022
+			'EVT_external_URL'    => $this->request->getRequestParam('externalURL'),
1023
+			'EVT_phone'           => $this->request->getRequestParam('event_phone'),
1024
+		];
1025
+		// update event
1026
+		$success = $this->_event_model()->update_by_ID($event_values, $post_id);
1027
+		// get event_object for other metaboxes...
1028
+		// though it would seem to make sense to just use $this->_event_model()->get_one_by_ID( $post_id )..
1029
+		// i have to setup where conditions to override the filters in the model
1030
+		// that filter out autodraft and inherit statuses so we GET the inherit id!
1031
+		$event = $this->_event_model()->get_one(
1032
+			[
1033
+				[
1034
+					$this->_event_model()->primary_key_name() => $post_id,
1035
+					'OR'                                      => [
1036
+						'status'   => $post->post_status,
1037
+						// if trying to "Publish" a sold out event, it's status will get switched back to "sold_out" in the db,
1038
+						// but the returned object here has a status of "publish", so use the original post status as well
1039
+						'status*1' => $this->request->getRequestParam('original_post_status'),
1040
+					],
1041
+				],
1042
+			]
1043
+		);
1044
+		// the following are default callbacks for event attachment updates that can be overridden by caffeinated functionality and/or addons.
1045
+		$event_update_callbacks = apply_filters(
1046
+			'FHEE__Events_Admin_Page___insert_update_cpt_item__event_update_callbacks',
1047
+			[
1048
+				[$this, '_default_venue_update'],
1049
+				[$this, '_default_tickets_update'],
1050
+			]
1051
+		);
1052
+		$att_success            = true;
1053
+		foreach ($event_update_callbacks as $e_callback) {
1054
+			$_success = is_callable($e_callback)
1055
+				? call_user_func($e_callback, $event, $this->request->requestParams())
1056
+				: false;
1057
+			// if ANY of these updates fail then we want the appropriate global error message
1058
+			$att_success = ! $att_success ? $att_success : $_success;
1059
+		}
1060
+		// any errors?
1061
+		if ($success && false === $att_success) {
1062
+			EE_Error::add_error(
1063
+				esc_html__(
1064
+					'Event Details saved successfully but something went wrong with saving attachments.',
1065
+					'event_espresso'
1066
+				),
1067
+				__FILE__,
1068
+				__FUNCTION__,
1069
+				__LINE__
1070
+			);
1071
+		} elseif ($success === false) {
1072
+			EE_Error::add_error(
1073
+				esc_html__('Event Details did not save successfully.', 'event_espresso'),
1074
+				__FILE__,
1075
+				__FUNCTION__,
1076
+				__LINE__
1077
+			);
1078
+		}
1079
+	}
1080
+
1081
+
1082
+	/**
1083
+	 * @param int $post_id
1084
+	 * @param int $revision_id
1085
+	 * @throws EE_Error
1086
+	 * @throws EE_Error
1087
+	 * @throws ReflectionException
1088
+	 * @see parent::restore_item()
1089
+	 */
1090
+	protected function _restore_cpt_item($post_id, $revision_id)
1091
+	{
1092
+		// copy existing event meta to new post
1093
+		$post_evt = $this->_event_model()->get_one_by_ID($post_id);
1094
+		if ($post_evt instanceof EE_Event) {
1095
+			// meta revision restore
1096
+			$post_evt->restore_revision($revision_id);
1097
+			// related objs restore
1098
+			$post_evt->restore_revision($revision_id, ['Venue', 'Datetime', 'Price']);
1099
+		}
1100
+	}
1101
+
1102
+
1103
+	/**
1104
+	 * Attach the venue to the Event
1105
+	 *
1106
+	 * @param EE_Event $event Event Object to add the venue to
1107
+	 * @param array    $data  The request data from the form
1108
+	 * @return bool           Success or fail.
1109
+	 * @throws EE_Error
1110
+	 * @throws ReflectionException
1111
+	 */
1112
+	protected function _default_venue_update(EE_Event $event, $data)
1113
+	{
1114
+		require_once(EE_MODELS . 'EEM_Venue.model.php');
1115
+		$venue_model = EE_Registry::instance()->load_model('Venue');
1116
+		$venue_id    = ! empty($data['venue_id']) ? $data['venue_id'] : null;
1117
+		// very important.  If we don't have a venue name...
1118
+		// then we'll get out because not necessary to create empty venue
1119
+		if (empty($data['venue_title'])) {
1120
+			return false;
1121
+		}
1122
+		$venue_array = [
1123
+			'VNU_wp_user'         => $event->get('EVT_wp_user'),
1124
+			'VNU_name'            => $data['venue_title'],
1125
+			'VNU_desc'            => ! empty($data['venue_description']) ? $data['venue_description'] : null,
1126
+			'VNU_identifier'      => ! empty($data['venue_identifier']) ? $data['venue_identifier'] : null,
1127
+			'VNU_short_desc'      => ! empty($data['venue_short_description'])
1128
+				? $data['venue_short_description']
1129
+				: null,
1130
+			'VNU_address'         => ! empty($data['address']) ? $data['address'] : null,
1131
+			'VNU_address2'        => ! empty($data['address2']) ? $data['address2'] : null,
1132
+			'VNU_city'            => ! empty($data['city']) ? $data['city'] : null,
1133
+			'STA_ID'              => ! empty($data['state']) ? $data['state'] : null,
1134
+			'CNT_ISO'             => ! empty($data['countries']) ? $data['countries'] : null,
1135
+			'VNU_zip'             => ! empty($data['zip']) ? $data['zip'] : null,
1136
+			'VNU_phone'           => ! empty($data['venue_phone']) ? $data['venue_phone'] : null,
1137
+			'VNU_capacity'        => ! empty($data['venue_capacity']) ? $data['venue_capacity'] : null,
1138
+			'VNU_url'             => ! empty($data['venue_url']) ? $data['venue_url'] : null,
1139
+			'VNU_virtual_phone'   => ! empty($data['virtual_phone']) ? $data['virtual_phone'] : null,
1140
+			'VNU_virtual_url'     => ! empty($data['virtual_url']) ? $data['virtual_url'] : null,
1141
+			'VNU_enable_for_gmap' => isset($data['enable_for_gmap']) ? 1 : 0,
1142
+			'status'              => 'publish',
1143
+		];
1144
+		// if we've got the venue_id then we're just updating the existing venue so let's do that and then get out.
1145
+		if (! empty($venue_id)) {
1146
+			$update_where  = [$venue_model->primary_key_name() => $venue_id];
1147
+			$rows_affected = $venue_model->update($venue_array, [$update_where]);
1148
+			// we've gotta make sure that the venue is always attached to a revision.. add_relation_to should take care of making sure that the relation is already present.
1149
+			$event->_add_relation_to($venue_id, 'Venue');
1150
+			return $rows_affected > 0;
1151
+		}
1152
+		// we insert the venue
1153
+		$venue_id = $venue_model->insert($venue_array);
1154
+		$event->_add_relation_to($venue_id, 'Venue');
1155
+		return ! empty($venue_id);
1156
+		// when we have the ancestor come in it's already been handled by the revision save.
1157
+	}
1158
+
1159
+
1160
+	/**
1161
+	 * Handles saving everything related to Tickets (datetimes, tickets, prices)
1162
+	 *
1163
+	 * @param EE_Event $event The Event object we're attaching data to
1164
+	 * @param array    $data  The request data from the form
1165
+	 * @return array
1166
+	 * @throws EE_Error
1167
+	 * @throws ReflectionException
1168
+	 * @throws Exception
1169
+	 */
1170
+	protected function _default_tickets_update(EE_Event $event, $data)
1171
+	{
1172
+		$datetime       = null;
1173
+		$saved_tickets  = [];
1174
+		$event_timezone = $event->get_timezone();
1175
+		$date_formats   = ['Y-m-d', 'h:i a'];
1176
+		foreach ($data['edit_event_datetimes'] as $row => $datetime_data) {
1177
+			// trim all values to ensure any excess whitespace is removed.
1178
+			$datetime_data                = array_map('trim', $datetime_data);
1179
+			$datetime_data['DTT_EVT_end'] =
1180
+				isset($datetime_data['DTT_EVT_end']) && ! empty($datetime_data['DTT_EVT_end'])
1181
+					? $datetime_data['DTT_EVT_end']
1182
+					: $datetime_data['DTT_EVT_start'];
1183
+			$datetime_values              = [
1184
+				'DTT_ID'        => ! empty($datetime_data['DTT_ID']) ? $datetime_data['DTT_ID'] : null,
1185
+				'DTT_EVT_start' => $datetime_data['DTT_EVT_start'],
1186
+				'DTT_EVT_end'   => $datetime_data['DTT_EVT_end'],
1187
+				'DTT_reg_limit' => empty($datetime_data['DTT_reg_limit']) ? EE_INF : $datetime_data['DTT_reg_limit'],
1188
+				'DTT_order'     => $row,
1189
+			];
1190
+			// if we have an id then let's get existing object first and then set the new values.
1191
+			//  Otherwise we instantiate a new object for save.
1192
+			if (! empty($datetime_data['DTT_ID'])) {
1193
+				$datetime = EEM_Datetime::instance($event_timezone)->get_one_by_ID($datetime_data['DTT_ID']);
1194
+				if (! $datetime instanceof EE_Datetime) {
1195
+					throw new RuntimeException(
1196
+						sprintf(
1197
+							esc_html__(
1198
+								'Something went wrong! A valid Datetime could not be retrieved from the database using the supplied ID: %1$d',
1199
+								'event_espresso'
1200
+							),
1201
+							$datetime_data['DTT_ID']
1202
+						)
1203
+					);
1204
+				}
1205
+				$datetime->set_date_format($date_formats[0]);
1206
+				$datetime->set_time_format($date_formats[1]);
1207
+				foreach ($datetime_values as $field => $value) {
1208
+					$datetime->set($field, $value);
1209
+				}
1210
+			} else {
1211
+				$datetime = EE_Datetime::new_instance($datetime_values, $event_timezone, $date_formats);
1212
+			}
1213
+			if (! $datetime instanceof EE_Datetime) {
1214
+				throw new RuntimeException(
1215
+					sprintf(
1216
+						esc_html__(
1217
+							'Something went wrong! A valid Datetime could not be generated or retrieved using the supplied data: %1$s',
1218
+							'event_espresso'
1219
+						),
1220
+						print_r($datetime_values, true)
1221
+					)
1222
+				);
1223
+			}
1224
+			// before going any further make sure our dates are setup correctly
1225
+			// so that the end date is always equal or greater than the start date.
1226
+			if ($datetime->get_raw('DTT_EVT_start') > $datetime->get_raw('DTT_EVT_end')) {
1227
+				$datetime->set('DTT_EVT_end', $datetime->get('DTT_EVT_start'));
1228
+				$datetime = EEH_DTT_Helper::date_time_add($datetime, 'DTT_EVT_end', 'days');
1229
+			}
1230
+			$datetime->save();
1231
+			$event->_add_relation_to($datetime, 'Datetime');
1232
+		}
1233
+		// no datetimes get deleted so we don't do any of that logic here.
1234
+		// update tickets next
1235
+		$old_tickets = isset($data['ticket_IDs']) ? explode(',', $data['ticket_IDs']) : [];
1236
+
1237
+		// set up some default start and end dates in case those are not present in the incoming data
1238
+		$default_start_date = new DateTime('now', new DateTimeZone($event->get_timezone()));
1239
+		$default_start_date = $default_start_date->format($date_formats[0] . ' ' . $date_formats[1]);
1240
+		// use the start date of the first datetime for the end date
1241
+		$first_datetime   = $event->first_datetime();
1242
+		$default_end_date = $first_datetime->start_date_and_time($date_formats[0], $date_formats[1]);
1243
+
1244
+		// now process the incoming data
1245
+		foreach ($data['edit_tickets'] as $row => $ticket_data) {
1246
+			$update_prices = false;
1247
+			$ticket_price  = isset($data['edit_prices'][ $row ][1]['PRC_amount'])
1248
+				? $data['edit_prices'][ $row ][1]['PRC_amount']
1249
+				: 0;
1250
+			// trim inputs to ensure any excess whitespace is removed.
1251
+			$ticket_data   = array_map('trim', $ticket_data);
1252
+			$ticket_values = [
1253
+				'TKT_ID'          => ! empty($ticket_data['TKT_ID']) ? $ticket_data['TKT_ID'] : null,
1254
+				'TTM_ID'          => ! empty($ticket_data['TTM_ID']) ? $ticket_data['TTM_ID'] : 0,
1255
+				'TKT_name'        => ! empty($ticket_data['TKT_name']) ? $ticket_data['TKT_name'] : '',
1256
+				'TKT_description' => ! empty($ticket_data['TKT_description']) ? $ticket_data['TKT_description'] : '',
1257
+				'TKT_start_date'  => ! empty($ticket_data['TKT_start_date'])
1258
+					? $ticket_data['TKT_start_date']
1259
+					: $default_start_date,
1260
+				'TKT_end_date'    => ! empty($ticket_data['TKT_end_date'])
1261
+					? $ticket_data['TKT_end_date']
1262
+					: $default_end_date,
1263
+				'TKT_qty'         => ! empty($ticket_data['TKT_qty'])
1264
+									 || (isset($ticket_data['TKT_qty']) && (int) $ticket_data['TKT_qty'] === 0)
1265
+					? $ticket_data['TKT_qty']
1266
+					: EE_INF,
1267
+				'TKT_uses'        => ! empty($ticket_data['TKT_uses'])
1268
+									 || (isset($ticket_data['TKT_uses']) && (int) $ticket_data['TKT_uses'] === 0)
1269
+					? $ticket_data['TKT_uses']
1270
+					: EE_INF,
1271
+				'TKT_min'         => ! empty($ticket_data['TKT_min']) ? $ticket_data['TKT_min'] : 0,
1272
+				'TKT_max'         => ! empty($ticket_data['TKT_max']) ? $ticket_data['TKT_max'] : EE_INF,
1273
+				'TKT_order'       => isset($ticket_data['TKT_order']) ? $ticket_data['TKT_order'] : $row,
1274
+				'TKT_price'       => $ticket_price,
1275
+				'TKT_row'         => $row,
1276
+			];
1277
+			// if this is a default ticket, then we need to set the TKT_ID to 0 and update accordingly,
1278
+			// which means in turn that the prices will become new prices as well.
1279
+			if (isset($ticket_data['TKT_is_default']) && $ticket_data['TKT_is_default']) {
1280
+				$ticket_values['TKT_ID']         = 0;
1281
+				$ticket_values['TKT_is_default'] = 0;
1282
+				$update_prices                   = true;
1283
+			}
1284
+			// if we have a TKT_ID then we need to get that existing TKT_obj and update it
1285
+			// we actually do our saves ahead of adding any relations because its entirely possible that this
1286
+			// ticket didn't get removed or added to any datetime in the session but DID have it's items modified.
1287
+			// keep in mind that if the ticket has been sold (and we have changed pricing information),
1288
+			// then we won't be updating the tkt but instead a new tkt will be created and the old one archived.
1289
+			if (! empty($ticket_data['TKT_ID'])) {
1290
+				$existing_ticket = EEM_Ticket::instance($event_timezone)->get_one_by_ID($ticket_data['TKT_ID']);
1291
+				if (! $existing_ticket instanceof EE_Ticket) {
1292
+					throw new RuntimeException(
1293
+						sprintf(
1294
+							esc_html__(
1295
+								'Something went wrong! A valid Ticket could not be retrieved from the database using the supplied ID: %1$d',
1296
+								'event_espresso'
1297
+							),
1298
+							$ticket_data['TKT_ID']
1299
+						)
1300
+					);
1301
+				}
1302
+				$ticket_sold = $existing_ticket->count_related(
1303
+					'Registration',
1304
+					[
1305
+						[
1306
+							'STS_ID' => [
1307
+								'NOT IN',
1308
+								[EEM_Registration::status_id_incomplete],
1309
+							],
1310
+						],
1311
+					]
1312
+				) > 0;
1313
+				// let's just check the total price for the existing ticket and determine if it matches the new total price.
1314
+				// if they are different then we create a new ticket (if $ticket_sold)
1315
+				// if they aren't different then we go ahead and modify existing ticket.
1316
+				$create_new_ticket = $ticket_sold
1317
+									 && $ticket_price !== $existing_ticket->price()
1318
+									 && ! $existing_ticket->deleted();
1319
+				$existing_ticket->set_date_format($date_formats[0]);
1320
+				$existing_ticket->set_time_format($date_formats[1]);
1321
+				// set new values
1322
+				foreach ($ticket_values as $field => $value) {
1323
+					if ($field == 'TKT_qty') {
1324
+						$existing_ticket->set_qty($value);
1325
+					} elseif ($field == 'TKT_price') {
1326
+						$existing_ticket->set('TKT_price', $ticket_price);
1327
+					} else {
1328
+						$existing_ticket->set($field, $value);
1329
+					}
1330
+				}
1331
+				$ticket = $existing_ticket;
1332
+				// if $create_new_ticket is false then we can safely update the existing ticket.
1333
+				//  Otherwise we have to create a new ticket.
1334
+				if ($create_new_ticket) {
1335
+					// archive the old ticket first
1336
+					$existing_ticket->set('TKT_deleted', 1);
1337
+					$existing_ticket->save();
1338
+					// make sure this ticket is still recorded in our $saved_tickets
1339
+					// so we don't run it through the regular trash routine.
1340
+					$saved_tickets[ $existing_ticket->ID() ] = $existing_ticket;
1341
+					// create new ticket that's a copy of the existing except,
1342
+					// (a new id of course and not archived) AND has the new TKT_price associated with it.
1343
+					$new_ticket = clone $existing_ticket;
1344
+					$new_ticket->set('TKT_ID', 0);
1345
+					$new_ticket->set('TKT_deleted', 0);
1346
+					$new_ticket->set('TKT_sold', 0);
1347
+					// now we need to make sure that $new prices are created as well and attached to new ticket.
1348
+					$update_prices = true;
1349
+					$ticket        = $new_ticket;
1350
+				}
1351
+			} else {
1352
+				// no TKT_id so a new ticket
1353
+				$ticket_values['TKT_price'] = $ticket_price;
1354
+				$ticket                     = EE_Ticket::new_instance($ticket_values, $event_timezone, $date_formats);
1355
+				$update_prices              = true;
1356
+			}
1357
+			if (! $ticket instanceof EE_Ticket) {
1358
+				throw new RuntimeException(
1359
+					sprintf(
1360
+						esc_html__(
1361
+							'Something went wrong! A valid Ticket could not be generated or retrieved using the supplied data: %1$s',
1362
+							'event_espresso'
1363
+						),
1364
+						print_r($ticket_values, true)
1365
+					)
1366
+				);
1367
+			}
1368
+			// cap ticket qty by datetime reg limits
1369
+			$ticket->set_qty(min($ticket->qty(), $ticket->qty('reg_limit')));
1370
+			// update ticket.
1371
+			$ticket->save();
1372
+			// before going any further make sure our dates are setup correctly
1373
+			// so that the end date is always equal or greater than the start date.
1374
+			if ($ticket->get_raw('TKT_start_date') > $ticket->get_raw('TKT_end_date')) {
1375
+				$ticket->set('TKT_end_date', $ticket->get('TKT_start_date'));
1376
+				$ticket = EEH_DTT_Helper::date_time_add($ticket, 'TKT_end_date', 'days');
1377
+				$ticket->save();
1378
+			}
1379
+			// initially let's add the ticket to the datetime
1380
+			$datetime->_add_relation_to($ticket, 'Ticket');
1381
+			$saved_tickets[ $ticket->ID() ] = $ticket;
1382
+			// add prices to ticket
1383
+			$prices_data = isset($data['edit_prices'][ $row ]) && is_array($data['edit_prices'][ $row ])
1384
+				? $data['edit_prices'][ $row ]
1385
+				: [];
1386
+			$this->_add_prices_to_ticket($prices_data, $ticket, $update_prices);
1387
+		}
1388
+		// however now we need to handle permanently deleting tickets via the ui.
1389
+		//  Keep in mind that the ui does not allow deleting/archiving tickets that have ticket sold.
1390
+		//  However, it does allow for deleting tickets that have no tickets sold,
1391
+		// in which case we want to get rid of permanently because there is no need to save in db.
1392
+		$old_tickets     = isset($old_tickets[0]) && $old_tickets[0] == '' ? [] : $old_tickets;
1393
+		$tickets_removed = array_diff($old_tickets, array_keys($saved_tickets));
1394
+		foreach ($tickets_removed as $id) {
1395
+			$id = absint($id);
1396
+			// get the ticket for this id
1397
+			$ticket_to_remove = EEM_Ticket::instance()->get_one_by_ID($id);
1398
+			if (! $ticket_to_remove instanceof EE_Ticket) {
1399
+				continue;
1400
+			}
1401
+			// need to get all the related datetimes on this ticket and remove from every single one of them
1402
+			// (remember this process can ONLY kick off if there are NO tickets sold)
1403
+			$related_datetimes = $ticket_to_remove->get_many_related('Datetime');
1404
+			foreach ($related_datetimes as $related_datetime) {
1405
+				$ticket_to_remove->_remove_relation_to($related_datetime, 'Datetime');
1406
+			}
1407
+			// need to do the same for prices (except these prices can also be deleted because again,
1408
+			// tickets can only be trashed if they don't have any TKTs sold (otherwise they are just archived))
1409
+			$ticket_to_remove->delete_related_permanently('Price');
1410
+			// finally let's delete this ticket
1411
+			// (which should not be blocked at this point b/c we've removed all our relationships)
1412
+			$ticket_to_remove->delete_permanently();
1413
+		}
1414
+		return [$datetime, $saved_tickets];
1415
+	}
1416
+
1417
+
1418
+	/**
1419
+	 * This attaches a list of given prices to a ticket.
1420
+	 * Note we dont' have to worry about ever removing relationships (or archiving prices) because if there is a change
1421
+	 * in price information on a ticket, a new ticket is created anyways so the archived ticket will retain the old
1422
+	 * price info and prices are automatically "archived" via the ticket.
1423
+	 *
1424
+	 * @access  private
1425
+	 * @param array     $prices_data Array of prices from the form.
1426
+	 * @param EE_Ticket $ticket      EE_Ticket object that prices are being attached to.
1427
+	 * @param bool      $new_prices  Whether attach existing incoming prices or create new ones.
1428
+	 * @return  void
1429
+	 * @throws EE_Error
1430
+	 * @throws ReflectionException
1431
+	 */
1432
+	private function _add_prices_to_ticket($prices_data, EE_Ticket $ticket, $new_prices = false)
1433
+	{
1434
+		$timezone = $ticket->get_timezone();
1435
+		foreach ($prices_data as $row => $price_data) {
1436
+			$price_values = [
1437
+				'PRC_ID'         => ! empty($price_data['PRC_ID']) ? $price_data['PRC_ID'] : null,
1438
+				'PRT_ID'         => ! empty($price_data['PRT_ID']) ? $price_data['PRT_ID'] : null,
1439
+				'PRC_amount'     => ! empty($price_data['PRC_amount']) ? $price_data['PRC_amount'] : 0,
1440
+				'PRC_name'       => ! empty($price_data['PRC_name']) ? $price_data['PRC_name'] : '',
1441
+				'PRC_desc'       => ! empty($price_data['PRC_desc']) ? $price_data['PRC_desc'] : '',
1442
+				'PRC_is_default' => 0, // make sure prices are NOT set as default from this context
1443
+				'PRC_order'      => $row,
1444
+			];
1445
+			if ($new_prices || empty($price_values['PRC_ID'])) {
1446
+				$price_values['PRC_ID'] = 0;
1447
+				$price                  = EE_Price::new_instance($price_values, $timezone);
1448
+			} else {
1449
+				$price = EEM_Price::instance($timezone)->get_one_by_ID($price_data['PRC_ID']);
1450
+				// update this price with new values
1451
+				foreach ($price_values as $field => $new_price) {
1452
+					$price->set($field, $new_price);
1453
+				}
1454
+			}
1455
+			if (! $price instanceof EE_Price) {
1456
+				throw new RuntimeException(
1457
+					sprintf(
1458
+						esc_html__(
1459
+							'Something went wrong! A valid Price could not be generated or retrieved using the supplied data: %1$s',
1460
+							'event_espresso'
1461
+						),
1462
+						print_r($price_values, true)
1463
+					)
1464
+				);
1465
+			}
1466
+			$price->save();
1467
+			$ticket->_add_relation_to($price, 'Price');
1468
+		}
1469
+	}
1470
+
1471
+
1472
+	/**
1473
+	 * Add in our autosave ajax handlers
1474
+	 *
1475
+	 */
1476
+	protected function _ee_autosave_create_new()
1477
+	{
1478
+	}
1479
+
1480
+
1481
+	/**
1482
+	 * More autosave handlers.
1483
+	 */
1484
+	protected function _ee_autosave_edit()
1485
+	{
1486
+		// TEMPORARILY EXITING CAUSE THIS IS A TODO
1487
+	}
1488
+
1489
+
1490
+	/**
1491
+	 * @throws EE_Error
1492
+	 * @throws ReflectionException
1493
+	 */
1494
+	private function _generate_publish_box_extra_content()
1495
+	{
1496
+		// load formatter helper
1497
+		// args for getting related registrations
1498
+		$approved_query_args        = [
1499
+			[
1500
+				'REG_deleted' => 0,
1501
+				'STS_ID'      => EEM_Registration::status_id_approved,
1502
+			],
1503
+		];
1504
+		$not_approved_query_args    = [
1505
+			[
1506
+				'REG_deleted' => 0,
1507
+				'STS_ID'      => EEM_Registration::status_id_not_approved,
1508
+			],
1509
+		];
1510
+		$pending_payment_query_args = [
1511
+			[
1512
+				'REG_deleted' => 0,
1513
+				'STS_ID'      => EEM_Registration::status_id_pending_payment,
1514
+			],
1515
+		];
1516
+		// publish box
1517
+		$publish_box_extra_args = [
1518
+			'view_approved_reg_url'        => add_query_arg(
1519
+				[
1520
+					'action'      => 'default',
1521
+					'event_id'    => $this->_cpt_model_obj->ID(),
1522
+					'_reg_status' => EEM_Registration::status_id_approved,
1523
+				],
1524
+				REG_ADMIN_URL
1525
+			),
1526
+			'view_not_approved_reg_url'    => add_query_arg(
1527
+				[
1528
+					'action'      => 'default',
1529
+					'event_id'    => $this->_cpt_model_obj->ID(),
1530
+					'_reg_status' => EEM_Registration::status_id_not_approved,
1531
+				],
1532
+				REG_ADMIN_URL
1533
+			),
1534
+			'view_pending_payment_reg_url' => add_query_arg(
1535
+				[
1536
+					'action'      => 'default',
1537
+					'event_id'    => $this->_cpt_model_obj->ID(),
1538
+					'_reg_status' => EEM_Registration::status_id_pending_payment,
1539
+				],
1540
+				REG_ADMIN_URL
1541
+			),
1542
+			'approved_regs'                => $this->_cpt_model_obj->count_related(
1543
+				'Registration',
1544
+				$approved_query_args
1545
+			),
1546
+			'not_approved_regs'            => $this->_cpt_model_obj->count_related(
1547
+				'Registration',
1548
+				$not_approved_query_args
1549
+			),
1550
+			'pending_payment_regs'         => $this->_cpt_model_obj->count_related(
1551
+				'Registration',
1552
+				$pending_payment_query_args
1553
+			),
1554
+			'misc_pub_section_class'       => apply_filters(
1555
+				'FHEE_Events_Admin_Page___generate_publish_box_extra_content__misc_pub_section_class',
1556
+				'misc-pub-section'
1557
+			),
1558
+		];
1559
+		ob_start();
1560
+		do_action(
1561
+			'AHEE__Events_Admin_Page___generate_publish_box_extra_content__event_editor_overview_add',
1562
+			$this->_cpt_model_obj
1563
+		);
1564
+		$publish_box_extra_args['event_editor_overview_add'] = ob_get_clean();
1565
+		// load template
1566
+		EEH_Template::display_template(
1567
+			EVENTS_TEMPLATE_PATH . 'event_publish_box_extras.template.php',
1568
+			$publish_box_extra_args
1569
+		);
1570
+	}
1571
+
1572
+
1573
+	/**
1574
+	 * @return EE_Event
1575
+	 */
1576
+	public function get_event_object()
1577
+	{
1578
+		return $this->_cpt_model_obj;
1579
+	}
1580
+
1581
+
1582
+
1583
+
1584
+	/** METABOXES * */
1585
+	/**
1586
+	 * _register_event_editor_meta_boxes
1587
+	 * add all metaboxes related to the event_editor
1588
+	 *
1589
+	 * @return void
1590
+	 * @throws EE_Error
1591
+	 * @throws ReflectionException
1592
+	 */
1593
+	protected function _register_event_editor_meta_boxes()
1594
+	{
1595
+		$this->verify_cpt_object();
1596
+		add_meta_box(
1597
+			'espresso_event_editor_tickets',
1598
+			esc_html__('Event Datetime & Ticket', 'event_espresso'),
1599
+			[$this, 'ticket_metabox'],
1600
+			$this->page_slug,
1601
+			'normal',
1602
+			'high'
1603
+		);
1604
+		add_meta_box(
1605
+			'espresso_event_editor_event_options',
1606
+			esc_html__('Event Registration Options', 'event_espresso'),
1607
+			[$this, 'registration_options_meta_box'],
1608
+			$this->page_slug,
1609
+			'side'
1610
+		);
1611
+		// NOTE: if you're looking for other metaboxes in here,
1612
+		// where a metabox has a related management page in the admin
1613
+		// you will find it setup in the related management page's "_Hooks" file.
1614
+		// i.e. messages metabox is found in "espresso_events_Messages_Hooks.class.php".
1615
+	}
1616
+
1617
+
1618
+	/**
1619
+	 * @throws DomainException
1620
+	 * @throws EE_Error
1621
+	 * @throws ReflectionException
1622
+	 */
1623
+	public function ticket_metabox()
1624
+	{
1625
+		$existing_datetime_ids = $existing_ticket_ids = [];
1626
+		// defaults for template args
1627
+		$template_args = [
1628
+			'existing_datetime_ids'    => '',
1629
+			'event_datetime_help_link' => '',
1630
+			'ticket_options_help_link' => '',
1631
+			'time'                     => null,
1632
+			'ticket_rows'              => '',
1633
+			'existing_ticket_ids'      => '',
1634
+			'total_ticket_rows'        => 1,
1635
+			'ticket_js_structure'      => '',
1636
+			'trash_icon'               => 'ee-lock-icon',
1637
+			'disabled'                 => '',
1638
+		];
1639
+		$event_id      = is_object($this->_cpt_model_obj) ? $this->_cpt_model_obj->ID() : null;
1640
+		/**
1641
+		 * 1. Start with retrieving Datetimes
1642
+		 * 2. Fore each datetime get related tickets
1643
+		 * 3. For each ticket get related prices
1644
+		 */
1645
+		$times          = EEM_Datetime::instance()->get_all_event_dates($event_id);
1646
+		$first_datetime = reset($times);
1647
+		// do we get related tickets?
1648
+		if (
1649
+			$first_datetime instanceof EE_Datetime
1650
+			&& $first_datetime->ID() !== 0
1651
+		) {
1652
+			$existing_datetime_ids[] = $first_datetime->get('DTT_ID');
1653
+			$template_args['time']   = $first_datetime;
1654
+			$related_tickets         = $first_datetime->tickets(
1655
+				[
1656
+					['OR' => ['TKT_deleted' => 1, 'TKT_deleted*' => 0]],
1657
+					'default_where_conditions' => 'none',
1658
+				]
1659
+			);
1660
+			if (! empty($related_tickets)) {
1661
+				$template_args['total_ticket_rows'] = count($related_tickets);
1662
+				$row                                = 0;
1663
+				foreach ($related_tickets as $ticket) {
1664
+					$existing_ticket_ids[]        = $ticket->get('TKT_ID');
1665
+					$template_args['ticket_rows'] .= $this->_get_ticket_row($ticket, false, $row);
1666
+					$row++;
1667
+				}
1668
+			} else {
1669
+				$template_args['total_ticket_rows'] = 1;
1670
+				/** @type EE_Ticket $ticket */
1671
+				$ticket                       = EEM_Ticket::instance()->create_default_object();
1672
+				$template_args['ticket_rows'] .= $this->_get_ticket_row($ticket);
1673
+			}
1674
+		} else {
1675
+			$template_args['time']        = $times[0];
1676
+			$tickets                      = EEM_Ticket::instance()->get_all_default_tickets();
1677
+			$template_args['ticket_rows'] .= $this->_get_ticket_row($tickets[1]);
1678
+			// NOTE: we're just sending the first default row
1679
+			// (decaf can't manage default tickets so this should be sufficient);
1680
+		}
1681
+		$template_args['event_datetime_help_link'] = $this->_get_help_tab_link(
1682
+			'event_editor_event_datetimes_help_tab'
1683
+		);
1684
+		$template_args['ticket_options_help_link'] = $this->_get_help_tab_link('ticket_options_info');
1685
+		$template_args['existing_datetime_ids']    = implode(',', $existing_datetime_ids);
1686
+		$template_args['existing_ticket_ids']      = implode(',', $existing_ticket_ids);
1687
+		$template_args['ticket_js_structure']      = $this->_get_ticket_row(
1688
+			EEM_Ticket::instance()->create_default_object(),
1689
+			true
1690
+		);
1691
+		$template                                  = apply_filters(
1692
+			'FHEE__Events_Admin_Page__ticket_metabox__template',
1693
+			EVENTS_TEMPLATE_PATH . 'event_tickets_metabox_main.template.php'
1694
+		);
1695
+		EEH_Template::display_template($template, $template_args);
1696
+	}
1697
+
1698
+
1699
+	/**
1700
+	 * Setup an individual ticket form for the decaf event editor page
1701
+	 *
1702
+	 * @access private
1703
+	 * @param EE_Ticket $ticket   the ticket object
1704
+	 * @param boolean   $skeleton whether we're generating a skeleton for js manipulation
1705
+	 * @param int       $row
1706
+	 * @return string generated html for the ticket row.
1707
+	 * @throws EE_Error
1708
+	 * @throws ReflectionException
1709
+	 */
1710
+	private function _get_ticket_row($ticket, $skeleton = false, $row = 0)
1711
+	{
1712
+		$template_args = [
1713
+			'tkt_status_class'    => ' tkt-status-' . $ticket->ticket_status(),
1714
+			'tkt_archive_class'   => $ticket->ticket_status() === EE_Ticket::archived && ! $skeleton ? ' tkt-archived'
1715
+				: '',
1716
+			'ticketrow'           => $skeleton ? 'TICKETNUM' : $row,
1717
+			'TKT_ID'              => $ticket->get('TKT_ID'),
1718
+			'TKT_name'            => $ticket->get('TKT_name'),
1719
+			'TKT_start_date'      => $skeleton ? '' : $ticket->get_date('TKT_start_date', 'Y-m-d h:i a'),
1720
+			'TKT_end_date'        => $skeleton ? '' : $ticket->get_date('TKT_end_date', 'Y-m-d h:i a'),
1721
+			'TKT_is_default'      => $ticket->get('TKT_is_default'),
1722
+			'TKT_qty'             => $ticket->get_pretty('TKT_qty', 'input'),
1723
+			'edit_ticketrow_name' => $skeleton ? 'TICKETNAMEATTR' : 'edit_tickets',
1724
+			'TKT_sold'            => $skeleton ? 0 : $ticket->get('TKT_sold'),
1725
+			'trash_icon'          => ($skeleton || (! empty($ticket) && ! $ticket->get('TKT_deleted')))
1726
+									 && (! empty($ticket) && $ticket->get('TKT_sold') === 0)
1727
+				? 'trash-icon dashicons dashicons-post-trash clickable' : 'ee-lock-icon',
1728
+			'disabled'            => $skeleton || (! empty($ticket) && ! $ticket->get('TKT_deleted')) ? ''
1729
+				: ' disabled=disabled',
1730
+		];
1731
+		$price         = $ticket->ID() !== 0
1732
+			? $ticket->get_first_related('Price', ['default_where_conditions' => 'none'])
1733
+			: null;
1734
+		$price         = $price instanceof EE_Price
1735
+			? $price
1736
+			: EEM_Price::instance()->create_default_object();
1737
+		$price_args    = [
1738
+			'price_currency_symbol' => EE_Registry::instance()->CFG->currency->sign,
1739
+			'PRC_amount'            => $price->get('PRC_amount'),
1740
+			'PRT_ID'                => $price->get('PRT_ID'),
1741
+			'PRC_ID'                => $price->get('PRC_ID'),
1742
+			'PRC_is_default'        => $price->get('PRC_is_default'),
1743
+		];
1744
+		// make sure we have default start and end dates if skeleton
1745
+		// handle rows that should NOT be empty
1746
+		if (empty($template_args['TKT_start_date'])) {
1747
+			// if empty then the start date will be now.
1748
+			$template_args['TKT_start_date'] = date('Y-m-d h:i a', current_time('timestamp'));
1749
+		}
1750
+		if (empty($template_args['TKT_end_date'])) {
1751
+			// get the earliest datetime (if present);
1752
+			$earliest_datetime             = $this->_cpt_model_obj->ID() > 0
1753
+				? $this->_cpt_model_obj->get_first_related(
1754
+					'Datetime',
1755
+					['order_by' => ['DTT_EVT_start' => 'ASC']]
1756
+				)
1757
+				: null;
1758
+			$template_args['TKT_end_date'] = $earliest_datetime instanceof EE_Datetime
1759
+				? $earliest_datetime->get_datetime('DTT_EVT_start', 'Y-m-d', 'h:i a')
1760
+				: date('Y-m-d h:i a', mktime(0, 0, 0, date('m'), date('d') + 7, date('Y')));
1761
+		}
1762
+		$template_args = array_merge($template_args, $price_args);
1763
+		$template      = apply_filters(
1764
+			'FHEE__Events_Admin_Page__get_ticket_row__template',
1765
+			EVENTS_TEMPLATE_PATH . 'event_tickets_metabox_ticket_row.template.php',
1766
+			$ticket
1767
+		);
1768
+		return EEH_Template::display_template($template, $template_args, true);
1769
+	}
1770
+
1771
+
1772
+	/**
1773
+	 * @throws EE_Error
1774
+	 * @throws ReflectionException
1775
+	 */
1776
+	public function registration_options_meta_box()
1777
+	{
1778
+		$yes_no_values             = [
1779
+			['id' => true, 'text' => esc_html__('Yes', 'event_espresso')],
1780
+			['id' => false, 'text' => esc_html__('No', 'event_espresso')],
1781
+		];
1782
+		$default_reg_status_values = EEM_Registration::reg_status_array(
1783
+			[
1784
+				EEM_Registration::status_id_cancelled,
1785
+				EEM_Registration::status_id_declined,
1786
+				EEM_Registration::status_id_incomplete,
1787
+			],
1788
+			true
1789
+		);
1790
+		// $template_args['is_active_select'] = EEH_Form_Fields::select_input('is_active', $yes_no_values, $this->_cpt_model_obj->is_active());
1791
+		$template_args['_event']                          = $this->_cpt_model_obj;
1792
+		$template_args['event']                           = $this->_cpt_model_obj;
1793
+		$template_args['active_status']                   = $this->_cpt_model_obj->pretty_active_status(false);
1794
+		$template_args['additional_limit']                = $this->_cpt_model_obj->additional_limit();
1795
+		$template_args['default_registration_status']     = EEH_Form_Fields::select_input(
1796
+			'default_reg_status',
1797
+			$default_reg_status_values,
1798
+			$this->_cpt_model_obj->default_registration_status()
1799
+		);
1800
+		$template_args['display_description']             = EEH_Form_Fields::select_input(
1801
+			'display_desc',
1802
+			$yes_no_values,
1803
+			$this->_cpt_model_obj->display_description()
1804
+		);
1805
+		$template_args['display_ticket_selector']         = EEH_Form_Fields::select_input(
1806
+			'display_ticket_selector',
1807
+			$yes_no_values,
1808
+			$this->_cpt_model_obj->display_ticket_selector(),
1809
+			'',
1810
+			'',
1811
+			false
1812
+		);
1813
+		$template_args['additional_registration_options'] = apply_filters(
1814
+			'FHEE__Events_Admin_Page__registration_options_meta_box__additional_registration_options',
1815
+			'',
1816
+			$template_args,
1817
+			$yes_no_values,
1818
+			$default_reg_status_values
1819
+		);
1820
+		EEH_Template::display_template(
1821
+			EVENTS_TEMPLATE_PATH . 'event_registration_options.template.php',
1822
+			$template_args
1823
+		);
1824
+	}
1825
+
1826
+
1827
+	/**
1828
+	 * _get_events()
1829
+	 * This method simply returns all the events (for the given _view and paging)
1830
+	 *
1831
+	 * @access public
1832
+	 * @param int  $per_page     count of items per page (20 default);
1833
+	 * @param int  $current_page what is the current page being viewed.
1834
+	 * @param bool $count        if TRUE then we just return a count of ALL events matching the given _view.
1835
+	 *                           If FALSE then we return an array of event objects
1836
+	 *                           that match the given _view and paging parameters.
1837
+	 * @return array|int         an array of event objects or a count of them.
1838
+	 * @throws Exception
1839
+	 */
1840
+	public function get_events($per_page = 10, $current_page = 1, $count = false)
1841
+	{
1842
+		$EEM_Event   = $this->_event_model();
1843
+		$offset      = ($current_page - 1) * $per_page;
1844
+		$limit       = $count ? null : $offset . ',' . $per_page;
1845
+		$orderby     = $this->request->getRequestParam('orderby', 'EVT_ID');
1846
+		$order       = $this->request->getRequestParam('order', 'DESC');
1847
+		$month_range = $this->request->getRequestParam('month_range');
1848
+		if ($month_range) {
1849
+			$pieces = explode(' ', $month_range, 3);
1850
+			// simulate the FIRST day of the month, that fixes issues for months like February
1851
+			// where PHP doesn't know what to assume for date.
1852
+			// @see https://events.codebasehq.com/projects/event-espresso/tickets/10437
1853
+			$month_r = ! empty($pieces[0]) ? date('m', EEH_DTT_Helper::first_of_month_timestamp($pieces[0])) : '';
1854
+			$year_r  = ! empty($pieces[1]) ? $pieces[1] : '';
1855
+		}
1856
+		$where  = [];
1857
+		$status = $this->request->getRequestParam('status');
1858
+		// determine what post_status our condition will have for the query.
1859
+		switch ($status) {
1860
+			case 'month':
1861
+			case 'today':
1862
+			case null:
1863
+			case 'all':
1864
+				break;
1865
+			case 'draft':
1866
+				$where['status'] = ['IN', ['draft', 'auto-draft']];
1867
+				break;
1868
+			default:
1869
+				$where['status'] = $status;
1870
+		}
1871
+		// categories? The default for all categories is -1
1872
+		$category = $this->request->getRequestParam('EVT_CAT', -1, 'int');
1873
+		if ($category !== -1) {
1874
+			$where['Term_Taxonomy.taxonomy'] = EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY;
1875
+			$where['Term_Taxonomy.term_id']  = $category;
1876
+		}
1877
+		// date where conditions
1878
+		$start_formats = EEM_Datetime::instance()->get_formats_for('DTT_EVT_start');
1879
+		if ($month_range) {
1880
+			$DateTime = new DateTime(
1881
+				$year_r . '-' . $month_r . '-01 00:00:00',
1882
+				new DateTimeZone('UTC')
1883
+			);
1884
+			$start    = $DateTime->getTimestamp();
1885
+			// set the datetime to be the end of the month
1886
+			$DateTime->setDate(
1887
+				$year_r,
1888
+				$month_r,
1889
+				$DateTime->format('t')
1890
+			)->setTime(23, 59, 59);
1891
+			$end                             = $DateTime->getTimestamp();
1892
+			$where['Datetime.DTT_EVT_start'] = ['BETWEEN', [$start, $end]];
1893
+		} elseif ($status === 'today') {
1894
+			$DateTime                        =
1895
+				new DateTime('now', new DateTimeZone(EEM_Event::instance()->get_timezone()));
1896
+			$start                           = $DateTime->setTime(0, 0)->format(implode(' ', $start_formats));
1897
+			$end                             = $DateTime->setTime(23, 59, 59)->format(implode(' ', $start_formats));
1898
+			$where['Datetime.DTT_EVT_start'] = ['BETWEEN', [$start, $end]];
1899
+		} elseif ($status === 'month') {
1900
+			$now                             = date('Y-m-01');
1901
+			$DateTime                        =
1902
+				new DateTime($now, new DateTimeZone(EEM_Event::instance()->get_timezone()));
1903
+			$start                           = $DateTime->setTime(0, 0)->format(implode(' ', $start_formats));
1904
+			$end                             = $DateTime->setDate(date('Y'), date('m'), $DateTime->format('t'))
1905
+														->setTime(23, 59, 59)
1906
+														->format(implode(' ', $start_formats));
1907
+			$where['Datetime.DTT_EVT_start'] = ['BETWEEN', [$start, $end]];
1908
+		}
1909
+		if (! EE_Registry::instance()->CAP->current_user_can('ee_read_others_events', 'get_events')) {
1910
+			$where['EVT_wp_user'] = get_current_user_id();
1911
+		} else {
1912
+			if (! isset($where['status'])) {
1913
+				if (! EE_Registry::instance()->CAP->current_user_can('ee_read_private_events', 'get_events')) {
1914
+					$where['OR'] = [
1915
+						'status*restrict_private' => ['!=', 'private'],
1916
+						'AND'                     => [
1917
+							'status*inclusive' => ['=', 'private'],
1918
+							'EVT_wp_user'      => get_current_user_id(),
1919
+						],
1920
+					];
1921
+				}
1922
+			}
1923
+		}
1924
+		$wp_user = $this->request->getRequestParam('EVT_wp_user', 0, 'int');
1925
+		if (
1926
+			$wp_user
1927
+			&& $wp_user !== get_current_user_id()
1928
+			&& EE_Registry::instance()->CAP->current_user_can('ee_read_others_events', 'get_events')
1929
+		) {
1930
+			$where['EVT_wp_user'] = $wp_user;
1931
+		}
1932
+		// search query handling
1933
+		$search_term = $this->request->getRequestParam('s');
1934
+		if ($search_term) {
1935
+			$search_term = '%' . $search_term . '%';
1936
+			$where['OR'] = [
1937
+				'EVT_name'       => ['LIKE', $search_term],
1938
+				'EVT_desc'       => ['LIKE', $search_term],
1939
+				'EVT_short_desc' => ['LIKE', $search_term],
1940
+			];
1941
+		}
1942
+		// filter events by venue.
1943
+		$venue = $this->request->getRequestParam('venue', 0, 'int');
1944
+		if ($venue) {
1945
+			$where['Venue.VNU_ID'] = $venue;
1946
+		}
1947
+		$request_params = $this->request->requestParams();
1948
+		$where          = apply_filters('FHEE__Events_Admin_Page__get_events__where', $where, $request_params);
1949
+		$query_params   = apply_filters(
1950
+			'FHEE__Events_Admin_Page__get_events__query_params',
1951
+			[
1952
+				$where,
1953
+				'limit'    => $limit,
1954
+				'order_by' => $orderby,
1955
+				'order'    => $order,
1956
+				'group_by' => 'EVT_ID',
1957
+			],
1958
+			$request_params
1959
+		);
1960
+
1961
+		// let's first check if we have special requests coming in.
1962
+		$active_status = $this->request->getRequestParam('active_status');
1963
+		if ($active_status) {
1964
+			switch ($active_status) {
1965
+				case 'upcoming':
1966
+					return $EEM_Event->get_upcoming_events($query_params, $count);
1967
+				case 'expired':
1968
+					return $EEM_Event->get_expired_events($query_params, $count);
1969
+				case 'active':
1970
+					return $EEM_Event->get_active_events($query_params, $count);
1971
+				case 'inactive':
1972
+					return $EEM_Event->get_inactive_events($query_params, $count);
1973
+			}
1974
+		}
1975
+
1976
+		return $count ? $EEM_Event->count([$where], 'EVT_ID', true) : $EEM_Event->get_all($query_params);
1977
+	}
1978
+
1979
+
1980
+	/**
1981
+	 * handling for WordPress CPT actions (trash, restore, delete)
1982
+	 *
1983
+	 * @param string $post_id
1984
+	 * @throws EE_Error
1985
+	 * @throws ReflectionException
1986
+	 */
1987
+	public function trash_cpt_item($post_id)
1988
+	{
1989
+		$this->request->setRequestParam('EVT_ID', $post_id);
1990
+		$this->_trash_or_restore_event('trash', false);
1991
+	}
1992
+
1993
+
1994
+	/**
1995
+	 * @param string $post_id
1996
+	 * @throws EE_Error
1997
+	 * @throws ReflectionException
1998
+	 */
1999
+	public function restore_cpt_item($post_id)
2000
+	{
2001
+		$this->request->setRequestParam('EVT_ID', $post_id);
2002
+		$this->_trash_or_restore_event('draft', false);
2003
+	}
2004
+
2005
+
2006
+	/**
2007
+	 * @param string $post_id
2008
+	 * @throws EE_Error
2009
+	 * @throws EE_Error
2010
+	 */
2011
+	public function delete_cpt_item($post_id)
2012
+	{
2013
+		throw new EE_Error(
2014
+			esc_html__(
2015
+				'Please contact Event Espresso support with the details of the steps taken to produce this error.',
2016
+				'event_espresso'
2017
+			)
2018
+		);
2019
+		// $this->request->setRequestParam('EVT_ID', $post_id);
2020
+		// $this->_delete_event();
2021
+	}
2022
+
2023
+
2024
+	/**
2025
+	 * _trash_or_restore_event
2026
+	 *
2027
+	 * @access protected
2028
+	 * @param string $event_status
2029
+	 * @param bool   $redirect_after
2030
+	 * @throws EE_Error
2031
+	 * @throws EE_Error
2032
+	 * @throws ReflectionException
2033
+	 */
2034
+	protected function _trash_or_restore_event($event_status = 'trash', $redirect_after = true)
2035
+	{
2036
+		// determine the event id and set to array.
2037
+		$EVT_ID = $this->request->getRequestParam('EVT_ID', 0, 'int');
2038
+		// loop thru events
2039
+		if ($EVT_ID) {
2040
+			// clean status
2041
+			$event_status = sanitize_key($event_status);
2042
+			// grab status
2043
+			if (! empty($event_status)) {
2044
+				$success = $this->_change_event_status($EVT_ID, $event_status);
2045
+			} else {
2046
+				$success = false;
2047
+				$msg     = esc_html__(
2048
+					'An error occurred. The event could not be moved to the trash because a valid event status was not not supplied.',
2049
+					'event_espresso'
2050
+				);
2051
+				EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2052
+			}
2053
+		} else {
2054
+			$success = false;
2055
+			$msg     = esc_html__(
2056
+				'An error occurred. The event could not be moved to the trash because a valid event ID was not not supplied.',
2057
+				'event_espresso'
2058
+			);
2059
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2060
+		}
2061
+		$action = $event_status == 'trash' ? 'moved to the trash' : 'restored from the trash';
2062
+		if ($redirect_after) {
2063
+			$this->_redirect_after_action($success, 'Event', $action, ['action' => 'default']);
2064
+		}
2065
+	}
2066
+
2067
+
2068
+	/**
2069
+	 * _trash_or_restore_events
2070
+	 *
2071
+	 * @access protected
2072
+	 * @param string $event_status
2073
+	 * @return void
2074
+	 * @throws EE_Error
2075
+	 * @throws EE_Error
2076
+	 * @throws ReflectionException
2077
+	 */
2078
+	protected function _trash_or_restore_events($event_status = 'trash')
2079
+	{
2080
+		// clean status
2081
+		$event_status = sanitize_key($event_status);
2082
+		// grab status
2083
+		if (! empty($event_status)) {
2084
+			$success = true;
2085
+			// determine the event id and set to array.
2086
+			$EVT_IDs = $this->request->getRequestParam('EVT_IDs', [], 'int', true);
2087
+			// loop thru events
2088
+			foreach ($EVT_IDs as $EVT_ID) {
2089
+				if ($EVT_ID = absint($EVT_ID)) {
2090
+					$results = $this->_change_event_status($EVT_ID, $event_status);
2091
+					$success = $results !== false ? $success : false;
2092
+				} else {
2093
+					$msg = sprintf(
2094
+						esc_html__(
2095
+							'An error occurred. Event #%d could not be moved to the trash because a valid event ID was not not supplied.',
2096
+							'event_espresso'
2097
+						),
2098
+						$EVT_ID
2099
+					);
2100
+					EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2101
+					$success = false;
2102
+				}
2103
+			}
2104
+		} else {
2105
+			$success = false;
2106
+			$msg     = esc_html__(
2107
+				'An error occurred. The event could not be moved to the trash because a valid event status was not not supplied.',
2108
+				'event_espresso'
2109
+			);
2110
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2111
+		}
2112
+		// in order to force a pluralized result message we need to send back a success status greater than 1
2113
+		$success = $success ? 2 : false;
2114
+		$action  = $event_status == 'trash' ? 'moved to the trash' : 'restored from the trash';
2115
+		$this->_redirect_after_action($success, 'Events', $action, ['action' => 'default']);
2116
+	}
2117
+
2118
+
2119
+	/**
2120
+	 * @param int    $EVT_ID
2121
+	 * @param string $event_status
2122
+	 * @return bool
2123
+	 * @throws EE_Error
2124
+	 * @throws ReflectionException
2125
+	 */
2126
+	private function _change_event_status($EVT_ID = 0, $event_status = '')
2127
+	{
2128
+		// grab event id
2129
+		if (! $EVT_ID) {
2130
+			$msg = esc_html__(
2131
+				'An error occurred. No Event ID or an invalid Event ID was received.',
2132
+				'event_espresso'
2133
+			);
2134
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2135
+			return false;
2136
+		}
2137
+		$this->_cpt_model_obj = EEM_Event::instance()->get_one_by_ID($EVT_ID);
2138
+		// clean status
2139
+		$event_status = sanitize_key($event_status);
2140
+		// grab status
2141
+		if (empty($event_status)) {
2142
+			$msg = esc_html__(
2143
+				'An error occurred. No Event Status or an invalid Event Status was received.',
2144
+				'event_espresso'
2145
+			);
2146
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2147
+			return false;
2148
+		}
2149
+		// was event trashed or restored ?
2150
+		switch ($event_status) {
2151
+			case 'draft':
2152
+				$action = 'restored from the trash';
2153
+				$hook   = 'AHEE_event_restored_from_trash';
2154
+				break;
2155
+			case 'trash':
2156
+				$action = 'moved to the trash';
2157
+				$hook   = 'AHEE_event_moved_to_trash';
2158
+				break;
2159
+			default:
2160
+				$action = 'updated';
2161
+				$hook   = false;
2162
+		}
2163
+		// use class to change status
2164
+		$this->_cpt_model_obj->set_status($event_status);
2165
+		$success = $this->_cpt_model_obj->save();
2166
+		if (! $success) {
2167
+			$msg = sprintf(esc_html__('An error occurred. The event could not be %s.', 'event_espresso'), $action);
2168
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2169
+			return false;
2170
+		}
2171
+		if ($hook) {
2172
+			do_action($hook);
2173
+		}
2174
+		return true;
2175
+	}
2176
+
2177
+
2178
+	/**
2179
+	 * @param array $event_ids
2180
+	 * @return array
2181
+	 * @since   4.10.23.p
2182
+	 */
2183
+	private function cleanEventIds(array $event_ids)
2184
+	{
2185
+		return array_map('absint', $event_ids);
2186
+	}
2187
+
2188
+
2189
+	/**
2190
+	 * @return array
2191
+	 * @since   4.10.23.p
2192
+	 */
2193
+	private function getEventIdsFromRequest()
2194
+	{
2195
+		if ($this->request->requestParamIsSet('EVT_IDs')) {
2196
+			return $this->request->getRequestParam('EVT_IDs', [], 'int', true);
2197
+		} else {
2198
+			return $this->request->getRequestParam('EVT_ID', [], 'int', true);
2199
+		}
2200
+	}
2201
+
2202
+
2203
+	/**
2204
+	 * @param bool $preview_delete
2205
+	 * @throws EE_Error
2206
+	 */
2207
+	protected function _delete_event($preview_delete = true)
2208
+	{
2209
+		$this->_delete_events($preview_delete);
2210
+	}
2211
+
2212
+
2213
+	/**
2214
+	 * Gets the tree traversal batch persister.
2215
+	 *
2216
+	 * @return NodeGroupDao
2217
+	 * @throws InvalidArgumentException
2218
+	 * @throws InvalidDataTypeException
2219
+	 * @throws InvalidInterfaceException
2220
+	 * @since 4.10.12.p
2221
+	 */
2222
+	protected function getModelObjNodeGroupPersister()
2223
+	{
2224
+		if (! $this->model_obj_node_group_persister instanceof NodeGroupDao) {
2225
+			$this->model_obj_node_group_persister =
2226
+				$this->getLoader()->load('\EventEspresso\core\services\orm\tree_traversal\NodeGroupDao');
2227
+		}
2228
+		return $this->model_obj_node_group_persister;
2229
+	}
2230
+
2231
+
2232
+	/**
2233
+	 * @param bool $preview_delete
2234
+	 * @return void
2235
+	 * @throws EE_Error
2236
+	 */
2237
+	protected function _delete_events($preview_delete = true)
2238
+	{
2239
+		$event_ids = $this->getEventIdsFromRequest();
2240
+		if ($preview_delete) {
2241
+			$this->generateDeletionPreview($event_ids);
2242
+		} else {
2243
+			EEM_Event::instance()->delete_permanently([['EVT_ID' => ['IN', $event_ids]]]);
2244
+		}
2245
+	}
2246
+
2247
+
2248
+	/**
2249
+	 * @param array $event_ids
2250
+	 */
2251
+	protected function generateDeletionPreview(array $event_ids)
2252
+	{
2253
+		$event_ids = $this->cleanEventIds($event_ids);
2254
+		// Set a code we can use to reference this deletion task in the batch jobs and preview page.
2255
+		$deletion_job_code = $this->getModelObjNodeGroupPersister()->generateGroupCode();
2256
+		$return_url        = EE_Admin_Page::add_query_args_and_nonce(
2257
+			[
2258
+				'action'            => 'preview_deletion',
2259
+				'deletion_job_code' => $deletion_job_code,
2260
+			],
2261
+			$this->_admin_base_url
2262
+		);
2263
+		EEH_URL::safeRedirectAndExit(
2264
+			EE_Admin_Page::add_query_args_and_nonce(
2265
+				[
2266
+					'page'              => 'espresso_batch',
2267
+					'batch'             => EED_Batch::batch_job,
2268
+					'EVT_IDs'           => $event_ids,
2269
+					'deletion_job_code' => $deletion_job_code,
2270
+					'job_handler'       => urlencode('EventEspressoBatchRequest\JobHandlers\PreviewEventDeletion'),
2271
+					'return_url'        => urlencode($return_url),
2272
+				],
2273
+				admin_url()
2274
+			)
2275
+		);
2276
+	}
2277
+
2278
+
2279
+	/**
2280
+	 * Checks for a POST submission
2281
+	 *
2282
+	 * @since 4.10.12.p
2283
+	 */
2284
+	protected function confirmDeletion()
2285
+	{
2286
+		$deletion_redirect_logic =
2287
+			$this->getLoader()->getShared('\EventEspresso\core\domain\services\admin\events\data\ConfirmDeletion');
2288
+		$deletion_redirect_logic->handle($this->get_request_data(), $this->admin_base_url());
2289
+	}
2290
+
2291
+
2292
+	/**
2293
+	 * A page for users to preview what exactly will be deleted, and confirm they want to delete it.
2294
+	 *
2295
+	 * @throws EE_Error
2296
+	 * @since 4.10.12.p
2297
+	 */
2298
+	protected function previewDeletion()
2299
+	{
2300
+		$preview_deletion_logic =
2301
+			$this->getLoader()->getShared('\EventEspresso\core\domain\services\admin\events\data\PreviewDeletion');
2302
+		$this->set_template_args($preview_deletion_logic->handle($this->get_request_data(), $this->admin_base_url()));
2303
+		$this->display_admin_page_with_no_sidebar();
2304
+	}
2305
+
2306
+
2307
+	/**
2308
+	 * get total number of events
2309
+	 *
2310
+	 * @access public
2311
+	 * @return int
2312
+	 * @throws EE_Error
2313
+	 * @throws EE_Error
2314
+	 */
2315
+	public function total_events()
2316
+	{
2317
+		return EEM_Event::instance()->count(
2318
+			['caps' => 'read_admin'],
2319
+			'EVT_ID',
2320
+			true
2321
+		);
2322
+	}
2323
+
2324
+
2325
+	/**
2326
+	 * get total number of draft events
2327
+	 *
2328
+	 * @access public
2329
+	 * @return int
2330
+	 * @throws EE_Error
2331
+	 * @throws EE_Error
2332
+	 */
2333
+	public function total_events_draft()
2334
+	{
2335
+		return EEM_Event::instance()->count(
2336
+			[
2337
+				['status' => ['IN', ['draft', 'auto-draft']]],
2338
+				'caps' => 'read_admin',
2339
+			],
2340
+			'EVT_ID',
2341
+			true
2342
+		);
2343
+	}
2344
+
2345
+
2346
+	/**
2347
+	 * get total number of trashed events
2348
+	 *
2349
+	 * @access public
2350
+	 * @return int
2351
+	 * @throws EE_Error
2352
+	 * @throws EE_Error
2353
+	 */
2354
+	public function total_trashed_events()
2355
+	{
2356
+		return EEM_Event::instance()->count(
2357
+			[
2358
+				['status' => 'trash'],
2359
+				'caps' => 'read_admin',
2360
+			],
2361
+			'EVT_ID',
2362
+			true
2363
+		);
2364
+	}
2365
+
2366
+
2367
+	/**
2368
+	 *    _default_event_settings
2369
+	 *    This generates the Default Settings Tab
2370
+	 *
2371
+	 * @return void
2372
+	 * @throws EE_Error
2373
+	 */
2374
+	protected function _default_event_settings()
2375
+	{
2376
+		$this->_set_add_edit_form_tags('update_default_event_settings');
2377
+		$this->_set_publish_post_box_vars(null, false, false, null, false);
2378
+		$this->_template_args['admin_page_content'] = $this->_default_event_settings_form()->get_html();
2379
+		$this->display_admin_page_with_sidebar();
2380
+	}
2381
+
2382
+
2383
+	/**
2384
+	 * Return the form for event settings.
2385
+	 *
2386
+	 * @return EE_Form_Section_Proper
2387
+	 * @throws EE_Error
2388
+	 */
2389
+	protected function _default_event_settings_form()
2390
+	{
2391
+		$registration_config              = EE_Registry::instance()->CFG->registration;
2392
+		$registration_stati_for_selection = EEM_Registration::reg_status_array(
2393
+		// exclude
2394
+			[
2395
+				EEM_Registration::status_id_cancelled,
2396
+				EEM_Registration::status_id_declined,
2397
+				EEM_Registration::status_id_incomplete,
2398
+				EEM_Registration::status_id_wait_list,
2399
+			],
2400
+			true
2401
+		);
2402
+		return new EE_Form_Section_Proper(
2403
+			[
2404
+				'name'            => 'update_default_event_settings',
2405
+				'html_id'         => 'update_default_event_settings',
2406
+				'html_class'      => 'form-table',
2407
+				'layout_strategy' => new EE_Admin_Two_Column_Layout(),
2408
+				'subsections'     => apply_filters(
2409
+					'FHEE__Events_Admin_Page___default_event_settings_form__form_subsections',
2410
+					[
2411
+						'default_reg_status'  => new EE_Select_Input(
2412
+							$registration_stati_for_selection,
2413
+							[
2414
+								'default'         => isset($registration_config->default_STS_ID)
2415
+													 && array_key_exists(
2416
+														 $registration_config->default_STS_ID,
2417
+														 $registration_stati_for_selection
2418
+													 )
2419
+									? sanitize_text_field($registration_config->default_STS_ID)
2420
+									: EEM_Registration::status_id_pending_payment,
2421
+								'html_label_text' => esc_html__('Default Registration Status', 'event_espresso')
2422
+													 . EEH_Template::get_help_tab_link(
2423
+														 'default_settings_status_help_tab'
2424
+													 ),
2425
+								'html_help_text'  => esc_html__(
2426
+									'This setting allows you to preselect what the default registration status setting is when creating an event.  Note that changing this setting does NOT retroactively apply it to existing events.',
2427
+									'event_espresso'
2428
+								),
2429
+							]
2430
+						),
2431
+						'default_max_tickets' => new EE_Integer_Input(
2432
+							[
2433
+								'default'         => isset($registration_config->default_maximum_number_of_tickets)
2434
+									? $registration_config->default_maximum_number_of_tickets
2435
+									: EEM_Event::get_default_additional_limit(),
2436
+								'html_label_text' => esc_html__(
2437
+									'Default Maximum Tickets Allowed Per Order:',
2438
+									'event_espresso'
2439
+								)
2440
+								. EEH_Template::get_help_tab_link(
2441
+									'default_maximum_tickets_help_tab"'
2442
+								),
2443
+								'html_help_text'  => esc_html__(
2444
+									'This setting allows you to indicate what will be the default for the maximum number of tickets per order when creating new events.',
2445
+									'event_espresso'
2446
+								),
2447
+							]
2448
+						),
2449
+					]
2450
+				),
2451
+			]
2452
+		);
2453
+	}
2454
+
2455
+
2456
+	/**
2457
+	 * _update_default_event_settings
2458
+	 *
2459
+	 * @access protected
2460
+	 * @return void
2461
+	 * @throws EE_Error
2462
+	 */
2463
+	protected function _update_default_event_settings()
2464
+	{
2465
+		$registration_config = EE_Registry::instance()->CFG->registration;
2466
+		$form                = $this->_default_event_settings_form();
2467
+		if ($form->was_submitted()) {
2468
+			$form->receive_form_submission();
2469
+			if ($form->is_valid()) {
2470
+				$valid_data = $form->valid_data();
2471
+				if (isset($valid_data['default_reg_status'])) {
2472
+					$registration_config->default_STS_ID = $valid_data['default_reg_status'];
2473
+				}
2474
+				if (isset($valid_data['default_max_tickets'])) {
2475
+					$registration_config->default_maximum_number_of_tickets = $valid_data['default_max_tickets'];
2476
+				}
2477
+				// update because data was valid!
2478
+				EE_Registry::instance()->CFG->update_espresso_config();
2479
+				EE_Error::overwrite_success();
2480
+				EE_Error::add_success(
2481
+					esc_html__('Default Event Settings were updated', 'event_espresso')
2482
+				);
2483
+			}
2484
+		}
2485
+		$this->_redirect_after_action(0, '', '', ['action' => 'default_event_settings'], true);
2486
+	}
2487
+
2488
+
2489
+	/*************        Templates        *************
21 2490
      *
22
-     * @var EE_Event $_event
23
-     */
24
-    protected $_event;
25
-
26
-
27
-    /**
28
-     * This will hold the category object for category_details screen.
29
-     *
30
-     * @var stdClass $_category
31
-     */
32
-    protected $_category;
33
-
34
-
35
-    /**
36
-     * This will hold the event model instance
37
-     *
38
-     * @var EEM_Event $_event_model
39
-     */
40
-    protected $_event_model;
41
-
42
-
43
-    /**
44
-     * @var EE_Event
45
-     */
46
-    protected $_cpt_model_obj = false;
47
-
48
-
49
-    /**
50
-     * @var NodeGroupDao
51
-     */
52
-    protected $model_obj_node_group_persister;
53
-
54
-
55
-    /**
56
-     * Initialize page props for this admin page group.
57
-     */
58
-    protected function _init_page_props()
59
-    {
60
-        $this->page_slug        = EVENTS_PG_SLUG;
61
-        $this->page_label       = EVENTS_LABEL;
62
-        $this->_admin_base_url  = EVENTS_ADMIN_URL;
63
-        $this->_admin_base_path = EVENTS_ADMIN;
64
-        $this->_cpt_model_names = [
65
-            'create_new' => 'EEM_Event',
66
-            'edit'       => 'EEM_Event',
67
-        ];
68
-        $this->_cpt_edit_routes = [
69
-            'espresso_events' => 'edit',
70
-        ];
71
-        add_action(
72
-            'AHEE__EE_Admin_Page_CPT__set_model_object__after_set_object',
73
-            [$this, 'verify_event_edit'],
74
-            10,
75
-            2
76
-        );
77
-    }
78
-
79
-
80
-    /**
81
-     * Sets the ajax hooks used for this admin page group.
82
-     */
83
-    protected function _ajax_hooks()
84
-    {
85
-        add_action('wp_ajax_ee_save_timezone_setting', [$this, 'saveTimezoneString']);
86
-    }
87
-
88
-
89
-    /**
90
-     * Sets the page properties for this admin page group.
91
-     */
92
-    protected function _define_page_props()
93
-    {
94
-        $this->_admin_page_title = EVENTS_LABEL;
95
-        $this->_labels           = [
96
-            'buttons'      => [
97
-                'add'             => esc_html__('Add New Event', 'event_espresso'),
98
-                'edit'            => esc_html__('Edit Event', 'event_espresso'),
99
-                'delete'          => esc_html__('Delete Event', 'event_espresso'),
100
-                'add_category'    => esc_html__('Add New Category', 'event_espresso'),
101
-                'edit_category'   => esc_html__('Edit Category', 'event_espresso'),
102
-                'delete_category' => esc_html__('Delete Category', 'event_espresso'),
103
-            ],
104
-            'editor_title' => [
105
-                'espresso_events' => esc_html__('Enter event title here', 'event_espresso'),
106
-            ],
107
-            'publishbox'   => [
108
-                'create_new'        => esc_html__('Save New Event', 'event_espresso'),
109
-                'edit'              => esc_html__('Update Event', 'event_espresso'),
110
-                'add_category'      => esc_html__('Save New Category', 'event_espresso'),
111
-                'edit_category'     => esc_html__('Update Category', 'event_espresso'),
112
-                'template_settings' => esc_html__('Update Settings', 'event_espresso'),
113
-            ],
114
-        ];
115
-    }
116
-
117
-
118
-    /**
119
-     * Sets the page routes property for this admin page group.
120
-     */
121
-    protected function _set_page_routes()
122
-    {
123
-        // load formatter helper
124
-        // load field generator helper
125
-        // is there a evt_id in the request?
126
-        $EVT_ID = $this->request->getRequestParam('EVT_ID', 0, 'int');
127
-        $EVT_ID = $this->request->getRequestParam('post', $EVT_ID, 'int');
128
-
129
-        $this->_page_routes = [
130
-            'default'                       => [
131
-                'func'       => '_events_overview_list_table',
132
-                'capability' => 'ee_read_events',
133
-            ],
134
-            'create_new'                    => [
135
-                'func'       => '_create_new_cpt_item',
136
-                'capability' => 'ee_edit_events',
137
-            ],
138
-            'edit'                          => [
139
-                'func'       => '_edit_cpt_item',
140
-                'capability' => 'ee_edit_event',
141
-                'obj_id'     => $EVT_ID,
142
-            ],
143
-            'copy_event'                    => [
144
-                'func'       => '_copy_events',
145
-                'capability' => 'ee_edit_event',
146
-                'obj_id'     => $EVT_ID,
147
-                'noheader'   => true,
148
-            ],
149
-            'trash_event'                   => [
150
-                'func'       => '_trash_or_restore_event',
151
-                'args'       => ['event_status' => 'trash'],
152
-                'capability' => 'ee_delete_event',
153
-                'obj_id'     => $EVT_ID,
154
-                'noheader'   => true,
155
-            ],
156
-            'trash_events'                  => [
157
-                'func'       => '_trash_or_restore_events',
158
-                'args'       => ['event_status' => 'trash'],
159
-                'capability' => 'ee_delete_events',
160
-                'noheader'   => true,
161
-            ],
162
-            'restore_event'                 => [
163
-                'func'       => '_trash_or_restore_event',
164
-                'args'       => ['event_status' => 'draft'],
165
-                'capability' => 'ee_delete_event',
166
-                'obj_id'     => $EVT_ID,
167
-                'noheader'   => true,
168
-            ],
169
-            'restore_events'                => [
170
-                'func'       => '_trash_or_restore_events',
171
-                'args'       => ['event_status' => 'draft'],
172
-                'capability' => 'ee_delete_events',
173
-                'noheader'   => true,
174
-            ],
175
-            'delete_event'                  => [
176
-                'func'       => '_delete_event',
177
-                'capability' => 'ee_delete_event',
178
-                'obj_id'     => $EVT_ID,
179
-                'noheader'   => true,
180
-            ],
181
-            'delete_events'                 => [
182
-                'func'       => '_delete_events',
183
-                'capability' => 'ee_delete_events',
184
-                'noheader'   => true,
185
-            ],
186
-            'view_report'                   => [
187
-                'func'       => '_view_report',
188
-                'capability' => 'ee_edit_events',
189
-            ],
190
-            'default_event_settings'        => [
191
-                'func'       => '_default_event_settings',
192
-                'capability' => 'manage_options',
193
-            ],
194
-            'update_default_event_settings' => [
195
-                'func'       => '_update_default_event_settings',
196
-                'capability' => 'manage_options',
197
-                'noheader'   => true,
198
-            ],
199
-            'template_settings'             => [
200
-                'func'       => '_template_settings',
201
-                'capability' => 'manage_options',
202
-            ],
203
-            // event category tab related
204
-            'add_category'                  => [
205
-                'func'       => '_category_details',
206
-                'capability' => 'ee_edit_event_category',
207
-                'args'       => ['add'],
208
-            ],
209
-            'edit_category'                 => [
210
-                'func'       => '_category_details',
211
-                'capability' => 'ee_edit_event_category',
212
-                'args'       => ['edit'],
213
-            ],
214
-            'delete_categories'             => [
215
-                'func'       => '_delete_categories',
216
-                'capability' => 'ee_delete_event_category',
217
-                'noheader'   => true,
218
-            ],
219
-            'delete_category'               => [
220
-                'func'       => '_delete_categories',
221
-                'capability' => 'ee_delete_event_category',
222
-                'noheader'   => true,
223
-            ],
224
-            'insert_category'               => [
225
-                'func'       => '_insert_or_update_category',
226
-                'args'       => ['new_category' => true],
227
-                'capability' => 'ee_edit_event_category',
228
-                'noheader'   => true,
229
-            ],
230
-            'update_category'               => [
231
-                'func'       => '_insert_or_update_category',
232
-                'args'       => ['new_category' => false],
233
-                'capability' => 'ee_edit_event_category',
234
-                'noheader'   => true,
235
-            ],
236
-            'category_list'                 => [
237
-                'func'       => '_category_list_table',
238
-                'capability' => 'ee_manage_event_categories',
239
-            ],
240
-            'preview_deletion'              => [
241
-                'func'       => 'previewDeletion',
242
-                'capability' => 'ee_delete_events',
243
-            ],
244
-            'confirm_deletion'              => [
245
-                'func'       => 'confirmDeletion',
246
-                'capability' => 'ee_delete_events',
247
-                'noheader'   => true,
248
-            ],
249
-        ];
250
-    }
251
-
252
-
253
-    /**
254
-     * Set the _page_config property for this admin page group.
255
-     */
256
-    protected function _set_page_config()
257
-    {
258
-        $post_id            = $this->request->getRequestParam('post', 0, 'int');
259
-        $EVT_CAT_ID         = $this->request->getRequestParam('EVT_CAT_ID', 0, 'int');
260
-        $this->_page_config = [
261
-            'default'                => [
262
-                'nav'           => [
263
-                    'label' => esc_html__('Overview', 'event_espresso'),
264
-                    'order' => 10,
265
-                ],
266
-                'list_table'    => 'Events_Admin_List_Table',
267
-                'help_tabs'     => [
268
-                    'events_overview_help_tab'                       => [
269
-                        'title'    => esc_html__('Events Overview', 'event_espresso'),
270
-                        'filename' => 'events_overview',
271
-                    ],
272
-                    'events_overview_table_column_headings_help_tab' => [
273
-                        'title'    => esc_html__('Events Overview Table Column Headings', 'event_espresso'),
274
-                        'filename' => 'events_overview_table_column_headings',
275
-                    ],
276
-                    'events_overview_filters_help_tab'               => [
277
-                        'title'    => esc_html__('Events Overview Filters', 'event_espresso'),
278
-                        'filename' => 'events_overview_filters',
279
-                    ],
280
-                    'events_overview_view_help_tab'                  => [
281
-                        'title'    => esc_html__('Events Overview Views', 'event_espresso'),
282
-                        'filename' => 'events_overview_views',
283
-                    ],
284
-                    'events_overview_other_help_tab'                 => [
285
-                        'title'    => esc_html__('Events Overview Other', 'event_espresso'),
286
-                        'filename' => 'events_overview_other',
287
-                    ],
288
-                ],
289
-                'qtips'         => [
290
-                    'EE_Event_List_Table_Tips',
291
-                ],
292
-                'require_nonce' => false,
293
-            ],
294
-            'create_new'             => [
295
-                'nav'           => [
296
-                    'label'      => esc_html__('Add Event', 'event_espresso'),
297
-                    'order'      => 5,
298
-                    'persistent' => false,
299
-                ],
300
-                'metaboxes'     => ['_register_event_editor_meta_boxes'],
301
-                'help_tabs'     => [
302
-                    'event_editor_help_tab'                            => [
303
-                        'title'    => esc_html__('Event Editor', 'event_espresso'),
304
-                        'filename' => 'event_editor',
305
-                    ],
306
-                    'event_editor_title_richtexteditor_help_tab'       => [
307
-                        'title'    => esc_html__('Event Title & Rich Text Editor', 'event_espresso'),
308
-                        'filename' => 'event_editor_title_richtexteditor',
309
-                    ],
310
-                    'event_editor_venue_details_help_tab'              => [
311
-                        'title'    => esc_html__('Event Venue Details', 'event_espresso'),
312
-                        'filename' => 'event_editor_venue_details',
313
-                    ],
314
-                    'event_editor_event_datetimes_help_tab'            => [
315
-                        'title'    => esc_html__('Event Datetimes', 'event_espresso'),
316
-                        'filename' => 'event_editor_event_datetimes',
317
-                    ],
318
-                    'event_editor_event_tickets_help_tab'              => [
319
-                        'title'    => esc_html__('Event Tickets', 'event_espresso'),
320
-                        'filename' => 'event_editor_event_tickets',
321
-                    ],
322
-                    'event_editor_event_registration_options_help_tab' => [
323
-                        'title'    => esc_html__('Event Registration Options', 'event_espresso'),
324
-                        'filename' => 'event_editor_event_registration_options',
325
-                    ],
326
-                    'event_editor_tags_categories_help_tab'            => [
327
-                        'title'    => esc_html__('Event Tags & Categories', 'event_espresso'),
328
-                        'filename' => 'event_editor_tags_categories',
329
-                    ],
330
-                    'event_editor_questions_registrants_help_tab'      => [
331
-                        'title'    => esc_html__('Questions for Registrants', 'event_espresso'),
332
-                        'filename' => 'event_editor_questions_registrants',
333
-                    ],
334
-                    'event_editor_save_new_event_help_tab'             => [
335
-                        'title'    => esc_html__('Save New Event', 'event_espresso'),
336
-                        'filename' => 'event_editor_save_new_event',
337
-                    ],
338
-                    'event_editor_other_help_tab'                      => [
339
-                        'title'    => esc_html__('Event Other', 'event_espresso'),
340
-                        'filename' => 'event_editor_other',
341
-                    ],
342
-                ],
343
-                'qtips'         => ['EE_Event_Editor_Decaf_Tips'],
344
-                'require_nonce' => false,
345
-            ],
346
-            'edit'                   => [
347
-                'nav'           => [
348
-                    'label'      => esc_html__('Edit Event', 'event_espresso'),
349
-                    'order'      => 5,
350
-                    'persistent' => false,
351
-                    'url'        => $post_id
352
-                        ? EE_Admin_Page::add_query_args_and_nonce(
353
-                            ['post' => $post_id, 'action' => 'edit'],
354
-                            $this->_current_page_view_url
355
-                        )
356
-                        : $this->_admin_base_url,
357
-                ],
358
-                'metaboxes'     => ['_register_event_editor_meta_boxes'],
359
-                'help_tabs'     => [
360
-                    'event_editor_help_tab'                            => [
361
-                        'title'    => esc_html__('Event Editor', 'event_espresso'),
362
-                        'filename' => 'event_editor',
363
-                    ],
364
-                    'event_editor_title_richtexteditor_help_tab'       => [
365
-                        'title'    => esc_html__('Event Title & Rich Text Editor', 'event_espresso'),
366
-                        'filename' => 'event_editor_title_richtexteditor',
367
-                    ],
368
-                    'event_editor_venue_details_help_tab'              => [
369
-                        'title'    => esc_html__('Event Venue Details', 'event_espresso'),
370
-                        'filename' => 'event_editor_venue_details',
371
-                    ],
372
-                    'event_editor_event_datetimes_help_tab'            => [
373
-                        'title'    => esc_html__('Event Datetimes', 'event_espresso'),
374
-                        'filename' => 'event_editor_event_datetimes',
375
-                    ],
376
-                    'event_editor_event_tickets_help_tab'              => [
377
-                        'title'    => esc_html__('Event Tickets', 'event_espresso'),
378
-                        'filename' => 'event_editor_event_tickets',
379
-                    ],
380
-                    'event_editor_event_registration_options_help_tab' => [
381
-                        'title'    => esc_html__('Event Registration Options', 'event_espresso'),
382
-                        'filename' => 'event_editor_event_registration_options',
383
-                    ],
384
-                    'event_editor_tags_categories_help_tab'            => [
385
-                        'title'    => esc_html__('Event Tags & Categories', 'event_espresso'),
386
-                        'filename' => 'event_editor_tags_categories',
387
-                    ],
388
-                    'event_editor_questions_registrants_help_tab'      => [
389
-                        'title'    => esc_html__('Questions for Registrants', 'event_espresso'),
390
-                        'filename' => 'event_editor_questions_registrants',
391
-                    ],
392
-                    'event_editor_save_new_event_help_tab'             => [
393
-                        'title'    => esc_html__('Save New Event', 'event_espresso'),
394
-                        'filename' => 'event_editor_save_new_event',
395
-                    ],
396
-                    'event_editor_other_help_tab'                      => [
397
-                        'title'    => esc_html__('Event Other', 'event_espresso'),
398
-                        'filename' => 'event_editor_other',
399
-                    ],
400
-                ],
401
-                'qtips'         => ['EE_Event_Editor_Decaf_Tips'],
402
-                'require_nonce' => false,
403
-            ],
404
-            'default_event_settings' => [
405
-                'nav'           => [
406
-                    'label' => esc_html__('Default Settings', 'event_espresso'),
407
-                    'order' => 40,
408
-                ],
409
-                'metaboxes'     => array_merge($this->_default_espresso_metaboxes, ['_publish_post_box']),
410
-                'labels'        => [
411
-                    'publishbox' => esc_html__('Update Settings', 'event_espresso'),
412
-                ],
413
-                'help_tabs'     => [
414
-                    'default_settings_help_tab'        => [
415
-                        'title'    => esc_html__('Default Event Settings', 'event_espresso'),
416
-                        'filename' => 'events_default_settings',
417
-                    ],
418
-                    'default_settings_status_help_tab' => [
419
-                        'title'    => esc_html__('Default Registration Status', 'event_espresso'),
420
-                        'filename' => 'events_default_settings_status',
421
-                    ],
422
-                    'default_maximum_tickets_help_tab' => [
423
-                        'title'    => esc_html__('Default Maximum Tickets Per Order', 'event_espresso'),
424
-                        'filename' => 'events_default_settings_max_tickets',
425
-                    ],
426
-                ],
427
-                'require_nonce' => false,
428
-            ],
429
-            // template settings
430
-            'template_settings'      => [
431
-                'nav'           => [
432
-                    'label' => esc_html__('Templates', 'event_espresso'),
433
-                    'order' => 30,
434
-                ],
435
-                'metaboxes'     => $this->_default_espresso_metaboxes,
436
-                'help_tabs'     => [
437
-                    'general_settings_templates_help_tab' => [
438
-                        'title'    => esc_html__('Templates', 'event_espresso'),
439
-                        'filename' => 'general_settings_templates',
440
-                    ],
441
-                ],
442
-                'require_nonce' => false,
443
-            ],
444
-            // event category stuff
445
-            'add_category'           => [
446
-                'nav'           => [
447
-                    'label'      => esc_html__('Add Category', 'event_espresso'),
448
-                    'order'      => 15,
449
-                    'persistent' => false,
450
-                ],
451
-                'help_tabs'     => [
452
-                    'add_category_help_tab' => [
453
-                        'title'    => esc_html__('Add New Event Category', 'event_espresso'),
454
-                        'filename' => 'events_add_category',
455
-                    ],
456
-                ],
457
-                'metaboxes'     => ['_publish_post_box'],
458
-                'require_nonce' => false,
459
-            ],
460
-            'edit_category'          => [
461
-                'nav'           => [
462
-                    'label'      => esc_html__('Edit Category', 'event_espresso'),
463
-                    'order'      => 15,
464
-                    'persistent' => false,
465
-                    'url'        => $EVT_CAT_ID
466
-                        ? add_query_arg(
467
-                            ['EVT_CAT_ID' => $EVT_CAT_ID],
468
-                            $this->_current_page_view_url
469
-                        )
470
-                        : $this->_admin_base_url,
471
-                ],
472
-                'help_tabs'     => [
473
-                    'edit_category_help_tab' => [
474
-                        'title'    => esc_html__('Edit Event Category', 'event_espresso'),
475
-                        'filename' => 'events_edit_category',
476
-                    ],
477
-                ],
478
-                'metaboxes'     => ['_publish_post_box'],
479
-                'require_nonce' => false,
480
-            ],
481
-            'category_list'          => [
482
-                'nav'           => [
483
-                    'label' => esc_html__('Categories', 'event_espresso'),
484
-                    'order' => 20,
485
-                ],
486
-                'list_table'    => 'Event_Categories_Admin_List_Table',
487
-                'help_tabs'     => [
488
-                    'events_categories_help_tab'                       => [
489
-                        'title'    => esc_html__('Event Categories', 'event_espresso'),
490
-                        'filename' => 'events_categories',
491
-                    ],
492
-                    'events_categories_table_column_headings_help_tab' => [
493
-                        'title'    => esc_html__('Event Categories Table Column Headings', 'event_espresso'),
494
-                        'filename' => 'events_categories_table_column_headings',
495
-                    ],
496
-                    'events_categories_view_help_tab'                  => [
497
-                        'title'    => esc_html__('Event Categories Views', 'event_espresso'),
498
-                        'filename' => 'events_categories_views',
499
-                    ],
500
-                    'events_categories_other_help_tab'                 => [
501
-                        'title'    => esc_html__('Event Categories Other', 'event_espresso'),
502
-                        'filename' => 'events_categories_other',
503
-                    ],
504
-                ],
505
-                'metaboxes'     => $this->_default_espresso_metaboxes,
506
-                'require_nonce' => false,
507
-            ],
508
-            'preview_deletion'       => [
509
-                'nav'           => [
510
-                    'label'      => esc_html__('Preview Deletion', 'event_espresso'),
511
-                    'order'      => 15,
512
-                    'persistent' => false,
513
-                    'url'        => '',
514
-                ],
515
-                'require_nonce' => false,
516
-            ],
517
-        ];
518
-    }
519
-
520
-
521
-    /**
522
-     * Used to register any global screen options if necessary for every route in this admin page group.
523
-     */
524
-    protected function _add_screen_options()
525
-    {
526
-    }
527
-
528
-
529
-    /**
530
-     * Implementing the screen options for the 'default' route.
531
-     */
532
-    protected function _add_screen_options_default()
533
-    {
534
-        $this->_per_page_screen_option();
535
-    }
536
-
537
-
538
-    /**
539
-     * Implementing screen options for the category list route.
540
-     */
541
-    protected function _add_screen_options_category_list()
542
-    {
543
-        $page_title              = $this->_admin_page_title;
544
-        $this->_admin_page_title = esc_html__('Categories', 'event_espresso');
545
-        $this->_per_page_screen_option();
546
-        $this->_admin_page_title = $page_title;
547
-    }
548
-
549
-
550
-    /**
551
-     * Used to register any global feature pointers for the admin page group.
552
-     */
553
-    protected function _add_feature_pointers()
554
-    {
555
-    }
556
-
557
-
558
-    /**
559
-     * Registers and enqueues any global scripts and styles for the entire admin page group.
560
-     */
561
-    public function load_scripts_styles()
562
-    {
563
-        wp_register_style(
564
-            'events-admin-css',
565
-            EVENTS_ASSETS_URL . 'events-admin-page.css',
566
-            [],
567
-            EVENT_ESPRESSO_VERSION
568
-        );
569
-        wp_register_style('ee-cat-admin', EVENTS_ASSETS_URL . 'ee-cat-admin.css', [], EVENT_ESPRESSO_VERSION);
570
-        wp_enqueue_style('events-admin-css');
571
-        wp_enqueue_style('ee-cat-admin');
572
-        // todo note: we also need to load_scripts_styles per view (i.e. default/view_report/event_details
573
-        // registers for all views
574
-        // scripts
575
-        wp_register_script(
576
-            'event_editor_js',
577
-            EVENTS_ASSETS_URL . 'event_editor.js',
578
-            ['ee_admin_js', 'jquery-ui-slider', 'jquery-ui-timepicker-addon'],
579
-            EVENT_ESPRESSO_VERSION,
580
-            true
581
-        );
582
-    }
583
-
584
-
585
-    /**
586
-     * Enqueuing scripts and styles specific to this view
587
-     */
588
-    public function load_scripts_styles_create_new()
589
-    {
590
-        $this->load_scripts_styles_edit();
591
-    }
592
-
593
-
594
-    /**
595
-     * Enqueuing scripts and styles specific to this view
596
-     */
597
-    public function load_scripts_styles_edit()
598
-    {
599
-        // styles
600
-        wp_enqueue_style('espresso-ui-theme');
601
-        wp_register_style(
602
-            'event-editor-css',
603
-            EVENTS_ASSETS_URL . 'event-editor.css',
604
-            ['ee-admin-css'],
605
-            EVENT_ESPRESSO_VERSION
606
-        );
607
-        wp_enqueue_style('event-editor-css');
608
-        // scripts
609
-        wp_register_script(
610
-            'event-datetime-metabox',
611
-            EVENTS_ASSETS_URL . 'event-datetime-metabox.js',
612
-            ['event_editor_js', 'ee-datepicker'],
613
-            EVENT_ESPRESSO_VERSION
614
-        );
615
-        wp_enqueue_script('event-datetime-metabox');
616
-    }
617
-
618
-
619
-    /**
620
-     * Populating the _views property for the category list table view.
621
-     */
622
-    protected function _set_list_table_views_category_list()
623
-    {
624
-        $this->_views = [
625
-            'all' => [
626
-                'slug'        => 'all',
627
-                'label'       => esc_html__('All', 'event_espresso'),
628
-                'count'       => 0,
629
-                'bulk_action' => [
630
-                    'delete_categories' => esc_html__('Delete Permanently', 'event_espresso'),
631
-                ],
632
-            ],
633
-        ];
634
-    }
635
-
636
-
637
-    /**
638
-     * For adding anything that fires on the admin_init hook for any route within this admin page group.
639
-     */
640
-    public function admin_init()
641
-    {
642
-        EE_Registry::$i18n_js_strings['image_confirm'] = esc_html__(
643
-            'Do you really want to delete this image? Please remember to update your event to complete the removal.',
644
-            'event_espresso'
645
-        );
646
-    }
647
-
648
-
649
-    /**
650
-     * For adding anything that should be triggered on the admin_notices hook for any route within this admin page
651
-     * group.
652
-     */
653
-    public function admin_notices()
654
-    {
655
-    }
656
-
657
-
658
-    /**
659
-     * For adding anything that should be triggered on the `admin_print_footer_scripts` hook for any route within
660
-     * this admin page group.
661
-     */
662
-    public function admin_footer_scripts()
663
-    {
664
-    }
665
-
666
-
667
-    /**
668
-     * Call this function to verify if an event is public and has tickets for sale.  If it does, then we need to show a
669
-     * warning (via EE_Error::add_error());
670
-     *
671
-     * @param EE_Event $event Event object
672
-     * @param string   $req_type
673
-     * @return void
674
-     * @throws EE_Error
675
-     * @throws ReflectionException
676
-     */
677
-    public function verify_event_edit($event = null, $req_type = '')
678
-    {
679
-        // don't need to do this when processing
680
-        if (! empty($req_type)) {
681
-            return;
682
-        }
683
-        // no event?
684
-        if (empty($event)) {
685
-            // set event
686
-            $event = $this->_cpt_model_obj;
687
-        }
688
-        // STILL no event?
689
-        if (! $event instanceof EE_Event) {
690
-            return;
691
-        }
692
-        $orig_status = $event->status();
693
-        // first check if event is active.
694
-        if (
695
-            $orig_status === EEM_Event::cancelled
696
-            || $orig_status === EEM_Event::postponed
697
-            || $event->is_expired()
698
-            || $event->is_inactive()
699
-        ) {
700
-            return;
701
-        }
702
-        // made it here so it IS active... next check that any of the tickets are sold.
703
-        if ($event->is_sold_out(true)) {
704
-            if ($orig_status !== EEM_Event::sold_out && $event->status() !== $orig_status) {
705
-                EE_Error::add_attention(
706
-                    sprintf(
707
-                        esc_html__(
708
-                            'Please note that the Event Status has automatically been changed to %s because there are no more spaces available for this event.  However, this change is not permanent until you update the event.  You can change the status back to something else before updating if you wish.',
709
-                            'event_espresso'
710
-                        ),
711
-                        EEH_Template::pretty_status(EEM_Event::sold_out, false, 'sentence')
712
-                    )
713
-                );
714
-            }
715
-            return;
716
-        } elseif ($orig_status === EEM_Event::sold_out) {
717
-            EE_Error::add_attention(
718
-                sprintf(
719
-                    esc_html__(
720
-                        'Please note that the Event Status has automatically been changed to %s because more spaces have become available for this event, most likely due to abandoned transactions freeing up reserved tickets.  However, this change is not permanent until you update the event. If you wish, you can change the status back to something else before updating.',
721
-                        'event_espresso'
722
-                    ),
723
-                    EEH_Template::pretty_status($event->status(), false, 'sentence')
724
-                )
725
-            );
726
-        }
727
-        // now we need to determine if the event has any tickets on sale.  If not then we dont' show the error
728
-        if (! $event->tickets_on_sale()) {
729
-            return;
730
-        }
731
-        // made it here so show warning
732
-        $this->_edit_event_warning();
733
-    }
734
-
735
-
736
-    /**
737
-     * This is the text used for when an event is being edited that is public and has tickets for sale.
738
-     * When needed, hook this into a EE_Error::add_error() notice.
739
-     *
740
-     * @access protected
741
-     * @return void
742
-     */
743
-    protected function _edit_event_warning()
744
-    {
745
-        // we don't want to add warnings during these requests
746
-        if ($this->request->getRequestParam('action') === 'editpost') {
747
-            return;
748
-        }
749
-        EE_Error::add_attention(
750
-            sprintf(
751
-                esc_html__(
752
-                    'Your event is open for registration. Making changes may disrupt any transactions in progress. %sLearn more%s',
753
-                    'event_espresso'
754
-                ),
755
-                '<a class="espresso-help-tab-lnk">',
756
-                '</a>'
757
-            )
758
-        );
759
-    }
760
-
761
-
762
-    /**
763
-     * When a user is creating a new event, notify them if they haven't set their timezone.
764
-     * Otherwise, do the normal logic
765
-     *
766
-     * @return void
767
-     * @throws EE_Error
768
-     */
769
-    protected function _create_new_cpt_item()
770
-    {
771
-        $has_timezone_string = get_option('timezone_string');
772
-        // only nag them about setting their timezone if it's their first event, and they haven't already done it
773
-        if (! $has_timezone_string && ! EEM_Event::instance()->exists([])) {
774
-            EE_Error::add_attention(
775
-                sprintf(
776
-                    esc_html__(
777
-                        'Your website\'s timezone is currently set to a UTC offset. We recommend updating your timezone to a city or region near you before you create an event. Change your timezone now:%1$s%2$s%3$sChange Timezone%4$s',
778
-                        'event_espresso'
779
-                    ),
780
-                    '<br>',
781
-                    '<select id="timezone_string" name="timezone_string" aria-describedby="timezone-description">'
782
-                    . EEH_DTT_Helper::wp_timezone_choice('', EEH_DTT_Helper::get_user_locale())
783
-                    . '</select>',
784
-                    '<button class="button button-secondary timezone-submit">',
785
-                    '</button><span class="spinner"></span>'
786
-                ),
787
-                __FILE__,
788
-                __FUNCTION__,
789
-                __LINE__
790
-            );
791
-        }
792
-        parent::_create_new_cpt_item();
793
-    }
794
-
795
-
796
-    /**
797
-     * Sets the _views property for the default route in this admin page group.
798
-     */
799
-    protected function _set_list_table_views_default()
800
-    {
801
-        $this->_views = [
802
-            'all'   => [
803
-                'slug'        => 'all',
804
-                'label'       => esc_html__('View All Events', 'event_espresso'),
805
-                'count'       => 0,
806
-                'bulk_action' => [
807
-                    'trash_events' => esc_html__('Move to Trash', 'event_espresso'),
808
-                ],
809
-            ],
810
-            'draft' => [
811
-                'slug'        => 'draft',
812
-                'label'       => esc_html__('Draft', 'event_espresso'),
813
-                'count'       => 0,
814
-                'bulk_action' => [
815
-                    'trash_events' => esc_html__('Move to Trash', 'event_espresso'),
816
-                ],
817
-            ],
818
-        ];
819
-        if (EE_Registry::instance()->CAP->current_user_can('ee_delete_events', 'espresso_events_trash_events')) {
820
-            $this->_views['trash'] = [
821
-                'slug'        => 'trash',
822
-                'label'       => esc_html__('Trash', 'event_espresso'),
823
-                'count'       => 0,
824
-                'bulk_action' => [
825
-                    'restore_events' => esc_html__('Restore From Trash', 'event_espresso'),
826
-                    'delete_events'  => esc_html__('Delete Permanently', 'event_espresso'),
827
-                ],
828
-            ];
829
-        }
830
-    }
831
-
832
-
833
-    /**
834
-     * Provides the legend item array for the default list table view.
835
-     *
836
-     * @return array
837
-     * @throws EE_Error
838
-     * @throws EE_Error
839
-     */
840
-    protected function _event_legend_items()
841
-    {
842
-        $items    = [
843
-            'view_details'   => [
844
-                'class' => 'dashicons dashicons-search',
845
-                'desc'  => esc_html__('View Event', 'event_espresso'),
846
-            ],
847
-            'edit_event'     => [
848
-                'class' => 'ee-icon ee-icon-calendar-edit',
849
-                'desc'  => esc_html__('Edit Event Details', 'event_espresso'),
850
-            ],
851
-            'view_attendees' => [
852
-                'class' => 'dashicons dashicons-groups',
853
-                'desc'  => esc_html__('View Registrations for Event', 'event_espresso'),
854
-            ],
855
-        ];
856
-        $items    = apply_filters('FHEE__Events_Admin_Page___event_legend_items__items', $items);
857
-        $statuses = [
858
-            'sold_out_status'  => [
859
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::sold_out,
860
-                'desc'  => EEH_Template::pretty_status(EE_Datetime::sold_out, false, 'sentence'),
861
-            ],
862
-            'active_status'    => [
863
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::active,
864
-                'desc'  => EEH_Template::pretty_status(EE_Datetime::active, false, 'sentence'),
865
-            ],
866
-            'upcoming_status'  => [
867
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::upcoming,
868
-                'desc'  => EEH_Template::pretty_status(EE_Datetime::upcoming, false, 'sentence'),
869
-            ],
870
-            'postponed_status' => [
871
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::postponed,
872
-                'desc'  => EEH_Template::pretty_status(EE_Datetime::postponed, false, 'sentence'),
873
-            ],
874
-            'cancelled_status' => [
875
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::cancelled,
876
-                'desc'  => EEH_Template::pretty_status(EE_Datetime::cancelled, false, 'sentence'),
877
-            ],
878
-            'expired_status'   => [
879
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::expired,
880
-                'desc'  => EEH_Template::pretty_status(EE_Datetime::expired, false, 'sentence'),
881
-            ],
882
-            'inactive_status'  => [
883
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::inactive,
884
-                'desc'  => EEH_Template::pretty_status(EE_Datetime::inactive, false, 'sentence'),
885
-            ],
886
-        ];
887
-        $statuses = apply_filters('FHEE__Events_Admin_Page__event_legend_items__statuses', $statuses);
888
-        return array_merge($items, $statuses);
889
-    }
890
-
891
-
892
-    /**
893
-     * @return EEM_Event
894
-     * @throws EE_Error
895
-     * @throws ReflectionException
896
-     */
897
-    private function _event_model()
898
-    {
899
-        if (! $this->_event_model instanceof EEM_Event) {
900
-            $this->_event_model = EE_Registry::instance()->load_model('Event');
901
-        }
902
-        return $this->_event_model;
903
-    }
904
-
905
-
906
-    /**
907
-     * Adds extra buttons to the WP CPT permalink field row.
908
-     * Method is called from parent and is hooked into the wp 'get_sample_permalink_html' filter.
909
-     *
910
-     * @param string $return    the current html
911
-     * @param int    $id        the post id for the page
912
-     * @param string $new_title What the title is
913
-     * @param string $new_slug  what the slug is
914
-     * @return string            The new html string for the permalink area
915
-     */
916
-    public function extra_permalink_field_buttons($return, $id, $new_title, $new_slug)
917
-    {
918
-        // make sure this is only when editing
919
-        if (! empty($id)) {
920
-            $post   = get_post($id);
921
-            $return .= '<a class="button button-small" onclick="prompt(\'Shortcode:\', jQuery(\'#shortcode\').val()); return false;" href="#"  tabindex="-1">'
922
-                       . esc_html__('Shortcode', 'event_espresso')
923
-                       . '</a> ';
924
-            $return .= '<input id="shortcode" type="hidden" value="[ESPRESSO_TICKET_SELECTOR event_id='
925
-                       . $post->ID
926
-                       . ']">';
927
-        }
928
-        return $return;
929
-    }
930
-
931
-
932
-    /**
933
-     * _events_overview_list_table
934
-     * This contains the logic for showing the events_overview list
935
-     *
936
-     * @access protected
937
-     * @return void
938
-     * @throws EE_Error
939
-     */
940
-    protected function _events_overview_list_table()
941
-    {
942
-        do_action('AHEE_log', __FILE__, __FUNCTION__, '');
943
-        $this->_template_args['after_list_table']                           =
944
-            ! empty($this->_template_args['after_list_table'])
945
-                ? (array) $this->_template_args['after_list_table']
946
-                : [];
947
-        $this->_template_args['after_list_table']['view_event_list_button'] = EEH_HTML::br()
948
-            . EEH_Template::get_button_or_link(
949
-                get_post_type_archive_link('espresso_events'),
950
-                esc_html__("View Event Archive Page", "event_espresso"),
951
-                'button'
952
-            );
953
-        $this->_template_args['after_list_table']['legend']                 = $this->_display_legend(
954
-            $this->_event_legend_items()
955
-        );
956
-        $this->_admin_page_title                                            .= ' ' . $this->get_action_link_or_button(
957
-            'create_new',
958
-            'add',
959
-            [],
960
-            'add-new-h2'
961
-        );
962
-        $this->display_admin_list_table_page_with_no_sidebar();
963
-    }
964
-
965
-
966
-    /**
967
-     * this allows for extra misc actions in the default WP publish box
968
-     *
969
-     * @return void
970
-     * @throws EE_Error
971
-     * @throws ReflectionException
972
-     */
973
-    public function extra_misc_actions_publish_box()
974
-    {
975
-        $this->_generate_publish_box_extra_content();
976
-    }
977
-
978
-
979
-    /**
980
-     * This is hooked into the WordPress do_action('save_post') hook and runs after the custom post type has been
981
-     * saved.
982
-     * Typically you would use this to save any additional data.
983
-     * Keep in mind also that "save_post" runs on EVERY post update to the database.
984
-     * ALSO very important.  When a post transitions from scheduled to published,
985
-     * the save_post action is fired but you will NOT have any _POST data containing any extra info you may have from
986
-     * other meta saves. So MAKE sure that you handle this accordingly.
987
-     *
988
-     * @access protected
989
-     * @abstract
990
-     * @param string $post_id The ID of the cpt that was saved (so you can link relationally)
991
-     * @param WP_Post $post    The post object of the cpt that was saved.
992
-     * @return void
993
-     * @throws EE_Error
994
-     * @throws ReflectionException
995
-     */
996
-    protected function _insert_update_cpt_item($post_id, $post)
997
-    {
998
-        if ($post instanceof WP_Post && $post->post_type !== 'espresso_events') {
999
-            // get out we're not processing an event save.
1000
-            return;
1001
-        }
1002
-
1003
-        $event_values = [
1004
-            'EVT_display_desc'                => $this->request->getRequestParam('display_desc', false, 'bool'),
1005
-            'EVT_display_ticket_selector'     => $this->request->getRequestParam(
1006
-                'display_ticket_selector',
1007
-                false,
1008
-                'bool'
1009
-            ),
1010
-            'EVT_additional_limit'            => min(
1011
-                apply_filters('FHEE__EE_Events_Admin__insert_update_cpt_item__EVT_additional_limit_max', 255),
1012
-                $this->request->getRequestParam('additional_limit', null, 'int')
1013
-            ),
1014
-            'EVT_default_registration_status' => $this->request->getRequestParam(
1015
-                'EVT_default_registration_status',
1016
-                EE_Registry::instance()->CFG->registration->default_STS_ID
1017
-            ),
1018
-
1019
-            'EVT_member_only'     => $this->request->getRequestParam('member_only', false, 'bool'),
1020
-            'EVT_allow_overflow'  => $this->request->getRequestParam('EVT_allow_overflow', false, 'bool'),
1021
-            'EVT_timezone_string' => $this->request->getRequestParam('timezone_string'),
1022
-            'EVT_external_URL'    => $this->request->getRequestParam('externalURL'),
1023
-            'EVT_phone'           => $this->request->getRequestParam('event_phone'),
1024
-        ];
1025
-        // update event
1026
-        $success = $this->_event_model()->update_by_ID($event_values, $post_id);
1027
-        // get event_object for other metaboxes...
1028
-        // though it would seem to make sense to just use $this->_event_model()->get_one_by_ID( $post_id )..
1029
-        // i have to setup where conditions to override the filters in the model
1030
-        // that filter out autodraft and inherit statuses so we GET the inherit id!
1031
-        $event = $this->_event_model()->get_one(
1032
-            [
1033
-                [
1034
-                    $this->_event_model()->primary_key_name() => $post_id,
1035
-                    'OR'                                      => [
1036
-                        'status'   => $post->post_status,
1037
-                        // if trying to "Publish" a sold out event, it's status will get switched back to "sold_out" in the db,
1038
-                        // but the returned object here has a status of "publish", so use the original post status as well
1039
-                        'status*1' => $this->request->getRequestParam('original_post_status'),
1040
-                    ],
1041
-                ],
1042
-            ]
1043
-        );
1044
-        // the following are default callbacks for event attachment updates that can be overridden by caffeinated functionality and/or addons.
1045
-        $event_update_callbacks = apply_filters(
1046
-            'FHEE__Events_Admin_Page___insert_update_cpt_item__event_update_callbacks',
1047
-            [
1048
-                [$this, '_default_venue_update'],
1049
-                [$this, '_default_tickets_update'],
1050
-            ]
1051
-        );
1052
-        $att_success            = true;
1053
-        foreach ($event_update_callbacks as $e_callback) {
1054
-            $_success = is_callable($e_callback)
1055
-                ? call_user_func($e_callback, $event, $this->request->requestParams())
1056
-                : false;
1057
-            // if ANY of these updates fail then we want the appropriate global error message
1058
-            $att_success = ! $att_success ? $att_success : $_success;
1059
-        }
1060
-        // any errors?
1061
-        if ($success && false === $att_success) {
1062
-            EE_Error::add_error(
1063
-                esc_html__(
1064
-                    'Event Details saved successfully but something went wrong with saving attachments.',
1065
-                    'event_espresso'
1066
-                ),
1067
-                __FILE__,
1068
-                __FUNCTION__,
1069
-                __LINE__
1070
-            );
1071
-        } elseif ($success === false) {
1072
-            EE_Error::add_error(
1073
-                esc_html__('Event Details did not save successfully.', 'event_espresso'),
1074
-                __FILE__,
1075
-                __FUNCTION__,
1076
-                __LINE__
1077
-            );
1078
-        }
1079
-    }
1080
-
1081
-
1082
-    /**
1083
-     * @param int $post_id
1084
-     * @param int $revision_id
1085
-     * @throws EE_Error
1086
-     * @throws EE_Error
1087
-     * @throws ReflectionException
1088
-     * @see parent::restore_item()
1089
-     */
1090
-    protected function _restore_cpt_item($post_id, $revision_id)
1091
-    {
1092
-        // copy existing event meta to new post
1093
-        $post_evt = $this->_event_model()->get_one_by_ID($post_id);
1094
-        if ($post_evt instanceof EE_Event) {
1095
-            // meta revision restore
1096
-            $post_evt->restore_revision($revision_id);
1097
-            // related objs restore
1098
-            $post_evt->restore_revision($revision_id, ['Venue', 'Datetime', 'Price']);
1099
-        }
1100
-    }
1101
-
1102
-
1103
-    /**
1104
-     * Attach the venue to the Event
1105
-     *
1106
-     * @param EE_Event $event Event Object to add the venue to
1107
-     * @param array    $data  The request data from the form
1108
-     * @return bool           Success or fail.
1109
-     * @throws EE_Error
1110
-     * @throws ReflectionException
1111
-     */
1112
-    protected function _default_venue_update(EE_Event $event, $data)
1113
-    {
1114
-        require_once(EE_MODELS . 'EEM_Venue.model.php');
1115
-        $venue_model = EE_Registry::instance()->load_model('Venue');
1116
-        $venue_id    = ! empty($data['venue_id']) ? $data['venue_id'] : null;
1117
-        // very important.  If we don't have a venue name...
1118
-        // then we'll get out because not necessary to create empty venue
1119
-        if (empty($data['venue_title'])) {
1120
-            return false;
1121
-        }
1122
-        $venue_array = [
1123
-            'VNU_wp_user'         => $event->get('EVT_wp_user'),
1124
-            'VNU_name'            => $data['venue_title'],
1125
-            'VNU_desc'            => ! empty($data['venue_description']) ? $data['venue_description'] : null,
1126
-            'VNU_identifier'      => ! empty($data['venue_identifier']) ? $data['venue_identifier'] : null,
1127
-            'VNU_short_desc'      => ! empty($data['venue_short_description'])
1128
-                ? $data['venue_short_description']
1129
-                : null,
1130
-            'VNU_address'         => ! empty($data['address']) ? $data['address'] : null,
1131
-            'VNU_address2'        => ! empty($data['address2']) ? $data['address2'] : null,
1132
-            'VNU_city'            => ! empty($data['city']) ? $data['city'] : null,
1133
-            'STA_ID'              => ! empty($data['state']) ? $data['state'] : null,
1134
-            'CNT_ISO'             => ! empty($data['countries']) ? $data['countries'] : null,
1135
-            'VNU_zip'             => ! empty($data['zip']) ? $data['zip'] : null,
1136
-            'VNU_phone'           => ! empty($data['venue_phone']) ? $data['venue_phone'] : null,
1137
-            'VNU_capacity'        => ! empty($data['venue_capacity']) ? $data['venue_capacity'] : null,
1138
-            'VNU_url'             => ! empty($data['venue_url']) ? $data['venue_url'] : null,
1139
-            'VNU_virtual_phone'   => ! empty($data['virtual_phone']) ? $data['virtual_phone'] : null,
1140
-            'VNU_virtual_url'     => ! empty($data['virtual_url']) ? $data['virtual_url'] : null,
1141
-            'VNU_enable_for_gmap' => isset($data['enable_for_gmap']) ? 1 : 0,
1142
-            'status'              => 'publish',
1143
-        ];
1144
-        // if we've got the venue_id then we're just updating the existing venue so let's do that and then get out.
1145
-        if (! empty($venue_id)) {
1146
-            $update_where  = [$venue_model->primary_key_name() => $venue_id];
1147
-            $rows_affected = $venue_model->update($venue_array, [$update_where]);
1148
-            // we've gotta make sure that the venue is always attached to a revision.. add_relation_to should take care of making sure that the relation is already present.
1149
-            $event->_add_relation_to($venue_id, 'Venue');
1150
-            return $rows_affected > 0;
1151
-        }
1152
-        // we insert the venue
1153
-        $venue_id = $venue_model->insert($venue_array);
1154
-        $event->_add_relation_to($venue_id, 'Venue');
1155
-        return ! empty($venue_id);
1156
-        // when we have the ancestor come in it's already been handled by the revision save.
1157
-    }
1158
-
1159
-
1160
-    /**
1161
-     * Handles saving everything related to Tickets (datetimes, tickets, prices)
1162
-     *
1163
-     * @param EE_Event $event The Event object we're attaching data to
1164
-     * @param array    $data  The request data from the form
1165
-     * @return array
1166
-     * @throws EE_Error
1167
-     * @throws ReflectionException
1168
-     * @throws Exception
1169
-     */
1170
-    protected function _default_tickets_update(EE_Event $event, $data)
1171
-    {
1172
-        $datetime       = null;
1173
-        $saved_tickets  = [];
1174
-        $event_timezone = $event->get_timezone();
1175
-        $date_formats   = ['Y-m-d', 'h:i a'];
1176
-        foreach ($data['edit_event_datetimes'] as $row => $datetime_data) {
1177
-            // trim all values to ensure any excess whitespace is removed.
1178
-            $datetime_data                = array_map('trim', $datetime_data);
1179
-            $datetime_data['DTT_EVT_end'] =
1180
-                isset($datetime_data['DTT_EVT_end']) && ! empty($datetime_data['DTT_EVT_end'])
1181
-                    ? $datetime_data['DTT_EVT_end']
1182
-                    : $datetime_data['DTT_EVT_start'];
1183
-            $datetime_values              = [
1184
-                'DTT_ID'        => ! empty($datetime_data['DTT_ID']) ? $datetime_data['DTT_ID'] : null,
1185
-                'DTT_EVT_start' => $datetime_data['DTT_EVT_start'],
1186
-                'DTT_EVT_end'   => $datetime_data['DTT_EVT_end'],
1187
-                'DTT_reg_limit' => empty($datetime_data['DTT_reg_limit']) ? EE_INF : $datetime_data['DTT_reg_limit'],
1188
-                'DTT_order'     => $row,
1189
-            ];
1190
-            // if we have an id then let's get existing object first and then set the new values.
1191
-            //  Otherwise we instantiate a new object for save.
1192
-            if (! empty($datetime_data['DTT_ID'])) {
1193
-                $datetime = EEM_Datetime::instance($event_timezone)->get_one_by_ID($datetime_data['DTT_ID']);
1194
-                if (! $datetime instanceof EE_Datetime) {
1195
-                    throw new RuntimeException(
1196
-                        sprintf(
1197
-                            esc_html__(
1198
-                                'Something went wrong! A valid Datetime could not be retrieved from the database using the supplied ID: %1$d',
1199
-                                'event_espresso'
1200
-                            ),
1201
-                            $datetime_data['DTT_ID']
1202
-                        )
1203
-                    );
1204
-                }
1205
-                $datetime->set_date_format($date_formats[0]);
1206
-                $datetime->set_time_format($date_formats[1]);
1207
-                foreach ($datetime_values as $field => $value) {
1208
-                    $datetime->set($field, $value);
1209
-                }
1210
-            } else {
1211
-                $datetime = EE_Datetime::new_instance($datetime_values, $event_timezone, $date_formats);
1212
-            }
1213
-            if (! $datetime instanceof EE_Datetime) {
1214
-                throw new RuntimeException(
1215
-                    sprintf(
1216
-                        esc_html__(
1217
-                            'Something went wrong! A valid Datetime could not be generated or retrieved using the supplied data: %1$s',
1218
-                            'event_espresso'
1219
-                        ),
1220
-                        print_r($datetime_values, true)
1221
-                    )
1222
-                );
1223
-            }
1224
-            // before going any further make sure our dates are setup correctly
1225
-            // so that the end date is always equal or greater than the start date.
1226
-            if ($datetime->get_raw('DTT_EVT_start') > $datetime->get_raw('DTT_EVT_end')) {
1227
-                $datetime->set('DTT_EVT_end', $datetime->get('DTT_EVT_start'));
1228
-                $datetime = EEH_DTT_Helper::date_time_add($datetime, 'DTT_EVT_end', 'days');
1229
-            }
1230
-            $datetime->save();
1231
-            $event->_add_relation_to($datetime, 'Datetime');
1232
-        }
1233
-        // no datetimes get deleted so we don't do any of that logic here.
1234
-        // update tickets next
1235
-        $old_tickets = isset($data['ticket_IDs']) ? explode(',', $data['ticket_IDs']) : [];
1236
-
1237
-        // set up some default start and end dates in case those are not present in the incoming data
1238
-        $default_start_date = new DateTime('now', new DateTimeZone($event->get_timezone()));
1239
-        $default_start_date = $default_start_date->format($date_formats[0] . ' ' . $date_formats[1]);
1240
-        // use the start date of the first datetime for the end date
1241
-        $first_datetime   = $event->first_datetime();
1242
-        $default_end_date = $first_datetime->start_date_and_time($date_formats[0], $date_formats[1]);
1243
-
1244
-        // now process the incoming data
1245
-        foreach ($data['edit_tickets'] as $row => $ticket_data) {
1246
-            $update_prices = false;
1247
-            $ticket_price  = isset($data['edit_prices'][ $row ][1]['PRC_amount'])
1248
-                ? $data['edit_prices'][ $row ][1]['PRC_amount']
1249
-                : 0;
1250
-            // trim inputs to ensure any excess whitespace is removed.
1251
-            $ticket_data   = array_map('trim', $ticket_data);
1252
-            $ticket_values = [
1253
-                'TKT_ID'          => ! empty($ticket_data['TKT_ID']) ? $ticket_data['TKT_ID'] : null,
1254
-                'TTM_ID'          => ! empty($ticket_data['TTM_ID']) ? $ticket_data['TTM_ID'] : 0,
1255
-                'TKT_name'        => ! empty($ticket_data['TKT_name']) ? $ticket_data['TKT_name'] : '',
1256
-                'TKT_description' => ! empty($ticket_data['TKT_description']) ? $ticket_data['TKT_description'] : '',
1257
-                'TKT_start_date'  => ! empty($ticket_data['TKT_start_date'])
1258
-                    ? $ticket_data['TKT_start_date']
1259
-                    : $default_start_date,
1260
-                'TKT_end_date'    => ! empty($ticket_data['TKT_end_date'])
1261
-                    ? $ticket_data['TKT_end_date']
1262
-                    : $default_end_date,
1263
-                'TKT_qty'         => ! empty($ticket_data['TKT_qty'])
1264
-                                     || (isset($ticket_data['TKT_qty']) && (int) $ticket_data['TKT_qty'] === 0)
1265
-                    ? $ticket_data['TKT_qty']
1266
-                    : EE_INF,
1267
-                'TKT_uses'        => ! empty($ticket_data['TKT_uses'])
1268
-                                     || (isset($ticket_data['TKT_uses']) && (int) $ticket_data['TKT_uses'] === 0)
1269
-                    ? $ticket_data['TKT_uses']
1270
-                    : EE_INF,
1271
-                'TKT_min'         => ! empty($ticket_data['TKT_min']) ? $ticket_data['TKT_min'] : 0,
1272
-                'TKT_max'         => ! empty($ticket_data['TKT_max']) ? $ticket_data['TKT_max'] : EE_INF,
1273
-                'TKT_order'       => isset($ticket_data['TKT_order']) ? $ticket_data['TKT_order'] : $row,
1274
-                'TKT_price'       => $ticket_price,
1275
-                'TKT_row'         => $row,
1276
-            ];
1277
-            // if this is a default ticket, then we need to set the TKT_ID to 0 and update accordingly,
1278
-            // which means in turn that the prices will become new prices as well.
1279
-            if (isset($ticket_data['TKT_is_default']) && $ticket_data['TKT_is_default']) {
1280
-                $ticket_values['TKT_ID']         = 0;
1281
-                $ticket_values['TKT_is_default'] = 0;
1282
-                $update_prices                   = true;
1283
-            }
1284
-            // if we have a TKT_ID then we need to get that existing TKT_obj and update it
1285
-            // we actually do our saves ahead of adding any relations because its entirely possible that this
1286
-            // ticket didn't get removed or added to any datetime in the session but DID have it's items modified.
1287
-            // keep in mind that if the ticket has been sold (and we have changed pricing information),
1288
-            // then we won't be updating the tkt but instead a new tkt will be created and the old one archived.
1289
-            if (! empty($ticket_data['TKT_ID'])) {
1290
-                $existing_ticket = EEM_Ticket::instance($event_timezone)->get_one_by_ID($ticket_data['TKT_ID']);
1291
-                if (! $existing_ticket instanceof EE_Ticket) {
1292
-                    throw new RuntimeException(
1293
-                        sprintf(
1294
-                            esc_html__(
1295
-                                'Something went wrong! A valid Ticket could not be retrieved from the database using the supplied ID: %1$d',
1296
-                                'event_espresso'
1297
-                            ),
1298
-                            $ticket_data['TKT_ID']
1299
-                        )
1300
-                    );
1301
-                }
1302
-                $ticket_sold = $existing_ticket->count_related(
1303
-                    'Registration',
1304
-                    [
1305
-                        [
1306
-                            'STS_ID' => [
1307
-                                'NOT IN',
1308
-                                [EEM_Registration::status_id_incomplete],
1309
-                            ],
1310
-                        ],
1311
-                    ]
1312
-                ) > 0;
1313
-                // let's just check the total price for the existing ticket and determine if it matches the new total price.
1314
-                // if they are different then we create a new ticket (if $ticket_sold)
1315
-                // if they aren't different then we go ahead and modify existing ticket.
1316
-                $create_new_ticket = $ticket_sold
1317
-                                     && $ticket_price !== $existing_ticket->price()
1318
-                                     && ! $existing_ticket->deleted();
1319
-                $existing_ticket->set_date_format($date_formats[0]);
1320
-                $existing_ticket->set_time_format($date_formats[1]);
1321
-                // set new values
1322
-                foreach ($ticket_values as $field => $value) {
1323
-                    if ($field == 'TKT_qty') {
1324
-                        $existing_ticket->set_qty($value);
1325
-                    } elseif ($field == 'TKT_price') {
1326
-                        $existing_ticket->set('TKT_price', $ticket_price);
1327
-                    } else {
1328
-                        $existing_ticket->set($field, $value);
1329
-                    }
1330
-                }
1331
-                $ticket = $existing_ticket;
1332
-                // if $create_new_ticket is false then we can safely update the existing ticket.
1333
-                //  Otherwise we have to create a new ticket.
1334
-                if ($create_new_ticket) {
1335
-                    // archive the old ticket first
1336
-                    $existing_ticket->set('TKT_deleted', 1);
1337
-                    $existing_ticket->save();
1338
-                    // make sure this ticket is still recorded in our $saved_tickets
1339
-                    // so we don't run it through the regular trash routine.
1340
-                    $saved_tickets[ $existing_ticket->ID() ] = $existing_ticket;
1341
-                    // create new ticket that's a copy of the existing except,
1342
-                    // (a new id of course and not archived) AND has the new TKT_price associated with it.
1343
-                    $new_ticket = clone $existing_ticket;
1344
-                    $new_ticket->set('TKT_ID', 0);
1345
-                    $new_ticket->set('TKT_deleted', 0);
1346
-                    $new_ticket->set('TKT_sold', 0);
1347
-                    // now we need to make sure that $new prices are created as well and attached to new ticket.
1348
-                    $update_prices = true;
1349
-                    $ticket        = $new_ticket;
1350
-                }
1351
-            } else {
1352
-                // no TKT_id so a new ticket
1353
-                $ticket_values['TKT_price'] = $ticket_price;
1354
-                $ticket                     = EE_Ticket::new_instance($ticket_values, $event_timezone, $date_formats);
1355
-                $update_prices              = true;
1356
-            }
1357
-            if (! $ticket instanceof EE_Ticket) {
1358
-                throw new RuntimeException(
1359
-                    sprintf(
1360
-                        esc_html__(
1361
-                            'Something went wrong! A valid Ticket could not be generated or retrieved using the supplied data: %1$s',
1362
-                            'event_espresso'
1363
-                        ),
1364
-                        print_r($ticket_values, true)
1365
-                    )
1366
-                );
1367
-            }
1368
-            // cap ticket qty by datetime reg limits
1369
-            $ticket->set_qty(min($ticket->qty(), $ticket->qty('reg_limit')));
1370
-            // update ticket.
1371
-            $ticket->save();
1372
-            // before going any further make sure our dates are setup correctly
1373
-            // so that the end date is always equal or greater than the start date.
1374
-            if ($ticket->get_raw('TKT_start_date') > $ticket->get_raw('TKT_end_date')) {
1375
-                $ticket->set('TKT_end_date', $ticket->get('TKT_start_date'));
1376
-                $ticket = EEH_DTT_Helper::date_time_add($ticket, 'TKT_end_date', 'days');
1377
-                $ticket->save();
1378
-            }
1379
-            // initially let's add the ticket to the datetime
1380
-            $datetime->_add_relation_to($ticket, 'Ticket');
1381
-            $saved_tickets[ $ticket->ID() ] = $ticket;
1382
-            // add prices to ticket
1383
-            $prices_data = isset($data['edit_prices'][ $row ]) && is_array($data['edit_prices'][ $row ])
1384
-                ? $data['edit_prices'][ $row ]
1385
-                : [];
1386
-            $this->_add_prices_to_ticket($prices_data, $ticket, $update_prices);
1387
-        }
1388
-        // however now we need to handle permanently deleting tickets via the ui.
1389
-        //  Keep in mind that the ui does not allow deleting/archiving tickets that have ticket sold.
1390
-        //  However, it does allow for deleting tickets that have no tickets sold,
1391
-        // in which case we want to get rid of permanently because there is no need to save in db.
1392
-        $old_tickets     = isset($old_tickets[0]) && $old_tickets[0] == '' ? [] : $old_tickets;
1393
-        $tickets_removed = array_diff($old_tickets, array_keys($saved_tickets));
1394
-        foreach ($tickets_removed as $id) {
1395
-            $id = absint($id);
1396
-            // get the ticket for this id
1397
-            $ticket_to_remove = EEM_Ticket::instance()->get_one_by_ID($id);
1398
-            if (! $ticket_to_remove instanceof EE_Ticket) {
1399
-                continue;
1400
-            }
1401
-            // need to get all the related datetimes on this ticket and remove from every single one of them
1402
-            // (remember this process can ONLY kick off if there are NO tickets sold)
1403
-            $related_datetimes = $ticket_to_remove->get_many_related('Datetime');
1404
-            foreach ($related_datetimes as $related_datetime) {
1405
-                $ticket_to_remove->_remove_relation_to($related_datetime, 'Datetime');
1406
-            }
1407
-            // need to do the same for prices (except these prices can also be deleted because again,
1408
-            // tickets can only be trashed if they don't have any TKTs sold (otherwise they are just archived))
1409
-            $ticket_to_remove->delete_related_permanently('Price');
1410
-            // finally let's delete this ticket
1411
-            // (which should not be blocked at this point b/c we've removed all our relationships)
1412
-            $ticket_to_remove->delete_permanently();
1413
-        }
1414
-        return [$datetime, $saved_tickets];
1415
-    }
1416
-
1417
-
1418
-    /**
1419
-     * This attaches a list of given prices to a ticket.
1420
-     * Note we dont' have to worry about ever removing relationships (or archiving prices) because if there is a change
1421
-     * in price information on a ticket, a new ticket is created anyways so the archived ticket will retain the old
1422
-     * price info and prices are automatically "archived" via the ticket.
1423
-     *
1424
-     * @access  private
1425
-     * @param array     $prices_data Array of prices from the form.
1426
-     * @param EE_Ticket $ticket      EE_Ticket object that prices are being attached to.
1427
-     * @param bool      $new_prices  Whether attach existing incoming prices or create new ones.
1428
-     * @return  void
1429
-     * @throws EE_Error
1430
-     * @throws ReflectionException
1431
-     */
1432
-    private function _add_prices_to_ticket($prices_data, EE_Ticket $ticket, $new_prices = false)
1433
-    {
1434
-        $timezone = $ticket->get_timezone();
1435
-        foreach ($prices_data as $row => $price_data) {
1436
-            $price_values = [
1437
-                'PRC_ID'         => ! empty($price_data['PRC_ID']) ? $price_data['PRC_ID'] : null,
1438
-                'PRT_ID'         => ! empty($price_data['PRT_ID']) ? $price_data['PRT_ID'] : null,
1439
-                'PRC_amount'     => ! empty($price_data['PRC_amount']) ? $price_data['PRC_amount'] : 0,
1440
-                'PRC_name'       => ! empty($price_data['PRC_name']) ? $price_data['PRC_name'] : '',
1441
-                'PRC_desc'       => ! empty($price_data['PRC_desc']) ? $price_data['PRC_desc'] : '',
1442
-                'PRC_is_default' => 0, // make sure prices are NOT set as default from this context
1443
-                'PRC_order'      => $row,
1444
-            ];
1445
-            if ($new_prices || empty($price_values['PRC_ID'])) {
1446
-                $price_values['PRC_ID'] = 0;
1447
-                $price                  = EE_Price::new_instance($price_values, $timezone);
1448
-            } else {
1449
-                $price = EEM_Price::instance($timezone)->get_one_by_ID($price_data['PRC_ID']);
1450
-                // update this price with new values
1451
-                foreach ($price_values as $field => $new_price) {
1452
-                    $price->set($field, $new_price);
1453
-                }
1454
-            }
1455
-            if (! $price instanceof EE_Price) {
1456
-                throw new RuntimeException(
1457
-                    sprintf(
1458
-                        esc_html__(
1459
-                            'Something went wrong! A valid Price could not be generated or retrieved using the supplied data: %1$s',
1460
-                            'event_espresso'
1461
-                        ),
1462
-                        print_r($price_values, true)
1463
-                    )
1464
-                );
1465
-            }
1466
-            $price->save();
1467
-            $ticket->_add_relation_to($price, 'Price');
1468
-        }
1469
-    }
1470
-
1471
-
1472
-    /**
1473
-     * Add in our autosave ajax handlers
1474
-     *
1475
-     */
1476
-    protected function _ee_autosave_create_new()
1477
-    {
1478
-    }
1479
-
1480
-
1481
-    /**
1482
-     * More autosave handlers.
1483
-     */
1484
-    protected function _ee_autosave_edit()
1485
-    {
1486
-        // TEMPORARILY EXITING CAUSE THIS IS A TODO
1487
-    }
1488
-
1489
-
1490
-    /**
1491
-     * @throws EE_Error
1492
-     * @throws ReflectionException
1493
-     */
1494
-    private function _generate_publish_box_extra_content()
1495
-    {
1496
-        // load formatter helper
1497
-        // args for getting related registrations
1498
-        $approved_query_args        = [
1499
-            [
1500
-                'REG_deleted' => 0,
1501
-                'STS_ID'      => EEM_Registration::status_id_approved,
1502
-            ],
1503
-        ];
1504
-        $not_approved_query_args    = [
1505
-            [
1506
-                'REG_deleted' => 0,
1507
-                'STS_ID'      => EEM_Registration::status_id_not_approved,
1508
-            ],
1509
-        ];
1510
-        $pending_payment_query_args = [
1511
-            [
1512
-                'REG_deleted' => 0,
1513
-                'STS_ID'      => EEM_Registration::status_id_pending_payment,
1514
-            ],
1515
-        ];
1516
-        // publish box
1517
-        $publish_box_extra_args = [
1518
-            'view_approved_reg_url'        => add_query_arg(
1519
-                [
1520
-                    'action'      => 'default',
1521
-                    'event_id'    => $this->_cpt_model_obj->ID(),
1522
-                    '_reg_status' => EEM_Registration::status_id_approved,
1523
-                ],
1524
-                REG_ADMIN_URL
1525
-            ),
1526
-            'view_not_approved_reg_url'    => add_query_arg(
1527
-                [
1528
-                    'action'      => 'default',
1529
-                    'event_id'    => $this->_cpt_model_obj->ID(),
1530
-                    '_reg_status' => EEM_Registration::status_id_not_approved,
1531
-                ],
1532
-                REG_ADMIN_URL
1533
-            ),
1534
-            'view_pending_payment_reg_url' => add_query_arg(
1535
-                [
1536
-                    'action'      => 'default',
1537
-                    'event_id'    => $this->_cpt_model_obj->ID(),
1538
-                    '_reg_status' => EEM_Registration::status_id_pending_payment,
1539
-                ],
1540
-                REG_ADMIN_URL
1541
-            ),
1542
-            'approved_regs'                => $this->_cpt_model_obj->count_related(
1543
-                'Registration',
1544
-                $approved_query_args
1545
-            ),
1546
-            'not_approved_regs'            => $this->_cpt_model_obj->count_related(
1547
-                'Registration',
1548
-                $not_approved_query_args
1549
-            ),
1550
-            'pending_payment_regs'         => $this->_cpt_model_obj->count_related(
1551
-                'Registration',
1552
-                $pending_payment_query_args
1553
-            ),
1554
-            'misc_pub_section_class'       => apply_filters(
1555
-                'FHEE_Events_Admin_Page___generate_publish_box_extra_content__misc_pub_section_class',
1556
-                'misc-pub-section'
1557
-            ),
1558
-        ];
1559
-        ob_start();
1560
-        do_action(
1561
-            'AHEE__Events_Admin_Page___generate_publish_box_extra_content__event_editor_overview_add',
1562
-            $this->_cpt_model_obj
1563
-        );
1564
-        $publish_box_extra_args['event_editor_overview_add'] = ob_get_clean();
1565
-        // load template
1566
-        EEH_Template::display_template(
1567
-            EVENTS_TEMPLATE_PATH . 'event_publish_box_extras.template.php',
1568
-            $publish_box_extra_args
1569
-        );
1570
-    }
1571
-
1572
-
1573
-    /**
1574
-     * @return EE_Event
1575
-     */
1576
-    public function get_event_object()
1577
-    {
1578
-        return $this->_cpt_model_obj;
1579
-    }
1580
-
1581
-
1582
-
1583
-
1584
-    /** METABOXES * */
1585
-    /**
1586
-     * _register_event_editor_meta_boxes
1587
-     * add all metaboxes related to the event_editor
1588
-     *
1589
-     * @return void
1590
-     * @throws EE_Error
1591
-     * @throws ReflectionException
1592
-     */
1593
-    protected function _register_event_editor_meta_boxes()
1594
-    {
1595
-        $this->verify_cpt_object();
1596
-        add_meta_box(
1597
-            'espresso_event_editor_tickets',
1598
-            esc_html__('Event Datetime & Ticket', 'event_espresso'),
1599
-            [$this, 'ticket_metabox'],
1600
-            $this->page_slug,
1601
-            'normal',
1602
-            'high'
1603
-        );
1604
-        add_meta_box(
1605
-            'espresso_event_editor_event_options',
1606
-            esc_html__('Event Registration Options', 'event_espresso'),
1607
-            [$this, 'registration_options_meta_box'],
1608
-            $this->page_slug,
1609
-            'side'
1610
-        );
1611
-        // NOTE: if you're looking for other metaboxes in here,
1612
-        // where a metabox has a related management page in the admin
1613
-        // you will find it setup in the related management page's "_Hooks" file.
1614
-        // i.e. messages metabox is found in "espresso_events_Messages_Hooks.class.php".
1615
-    }
1616
-
1617
-
1618
-    /**
1619
-     * @throws DomainException
1620
-     * @throws EE_Error
1621
-     * @throws ReflectionException
1622
-     */
1623
-    public function ticket_metabox()
1624
-    {
1625
-        $existing_datetime_ids = $existing_ticket_ids = [];
1626
-        // defaults for template args
1627
-        $template_args = [
1628
-            'existing_datetime_ids'    => '',
1629
-            'event_datetime_help_link' => '',
1630
-            'ticket_options_help_link' => '',
1631
-            'time'                     => null,
1632
-            'ticket_rows'              => '',
1633
-            'existing_ticket_ids'      => '',
1634
-            'total_ticket_rows'        => 1,
1635
-            'ticket_js_structure'      => '',
1636
-            'trash_icon'               => 'ee-lock-icon',
1637
-            'disabled'                 => '',
1638
-        ];
1639
-        $event_id      = is_object($this->_cpt_model_obj) ? $this->_cpt_model_obj->ID() : null;
1640
-        /**
1641
-         * 1. Start with retrieving Datetimes
1642
-         * 2. Fore each datetime get related tickets
1643
-         * 3. For each ticket get related prices
1644
-         */
1645
-        $times          = EEM_Datetime::instance()->get_all_event_dates($event_id);
1646
-        $first_datetime = reset($times);
1647
-        // do we get related tickets?
1648
-        if (
1649
-            $first_datetime instanceof EE_Datetime
1650
-            && $first_datetime->ID() !== 0
1651
-        ) {
1652
-            $existing_datetime_ids[] = $first_datetime->get('DTT_ID');
1653
-            $template_args['time']   = $first_datetime;
1654
-            $related_tickets         = $first_datetime->tickets(
1655
-                [
1656
-                    ['OR' => ['TKT_deleted' => 1, 'TKT_deleted*' => 0]],
1657
-                    'default_where_conditions' => 'none',
1658
-                ]
1659
-            );
1660
-            if (! empty($related_tickets)) {
1661
-                $template_args['total_ticket_rows'] = count($related_tickets);
1662
-                $row                                = 0;
1663
-                foreach ($related_tickets as $ticket) {
1664
-                    $existing_ticket_ids[]        = $ticket->get('TKT_ID');
1665
-                    $template_args['ticket_rows'] .= $this->_get_ticket_row($ticket, false, $row);
1666
-                    $row++;
1667
-                }
1668
-            } else {
1669
-                $template_args['total_ticket_rows'] = 1;
1670
-                /** @type EE_Ticket $ticket */
1671
-                $ticket                       = EEM_Ticket::instance()->create_default_object();
1672
-                $template_args['ticket_rows'] .= $this->_get_ticket_row($ticket);
1673
-            }
1674
-        } else {
1675
-            $template_args['time']        = $times[0];
1676
-            $tickets                      = EEM_Ticket::instance()->get_all_default_tickets();
1677
-            $template_args['ticket_rows'] .= $this->_get_ticket_row($tickets[1]);
1678
-            // NOTE: we're just sending the first default row
1679
-            // (decaf can't manage default tickets so this should be sufficient);
1680
-        }
1681
-        $template_args['event_datetime_help_link'] = $this->_get_help_tab_link(
1682
-            'event_editor_event_datetimes_help_tab'
1683
-        );
1684
-        $template_args['ticket_options_help_link'] = $this->_get_help_tab_link('ticket_options_info');
1685
-        $template_args['existing_datetime_ids']    = implode(',', $existing_datetime_ids);
1686
-        $template_args['existing_ticket_ids']      = implode(',', $existing_ticket_ids);
1687
-        $template_args['ticket_js_structure']      = $this->_get_ticket_row(
1688
-            EEM_Ticket::instance()->create_default_object(),
1689
-            true
1690
-        );
1691
-        $template                                  = apply_filters(
1692
-            'FHEE__Events_Admin_Page__ticket_metabox__template',
1693
-            EVENTS_TEMPLATE_PATH . 'event_tickets_metabox_main.template.php'
1694
-        );
1695
-        EEH_Template::display_template($template, $template_args);
1696
-    }
1697
-
1698
-
1699
-    /**
1700
-     * Setup an individual ticket form for the decaf event editor page
1701
-     *
1702
-     * @access private
1703
-     * @param EE_Ticket $ticket   the ticket object
1704
-     * @param boolean   $skeleton whether we're generating a skeleton for js manipulation
1705
-     * @param int       $row
1706
-     * @return string generated html for the ticket row.
1707
-     * @throws EE_Error
1708
-     * @throws ReflectionException
1709
-     */
1710
-    private function _get_ticket_row($ticket, $skeleton = false, $row = 0)
1711
-    {
1712
-        $template_args = [
1713
-            'tkt_status_class'    => ' tkt-status-' . $ticket->ticket_status(),
1714
-            'tkt_archive_class'   => $ticket->ticket_status() === EE_Ticket::archived && ! $skeleton ? ' tkt-archived'
1715
-                : '',
1716
-            'ticketrow'           => $skeleton ? 'TICKETNUM' : $row,
1717
-            'TKT_ID'              => $ticket->get('TKT_ID'),
1718
-            'TKT_name'            => $ticket->get('TKT_name'),
1719
-            'TKT_start_date'      => $skeleton ? '' : $ticket->get_date('TKT_start_date', 'Y-m-d h:i a'),
1720
-            'TKT_end_date'        => $skeleton ? '' : $ticket->get_date('TKT_end_date', 'Y-m-d h:i a'),
1721
-            'TKT_is_default'      => $ticket->get('TKT_is_default'),
1722
-            'TKT_qty'             => $ticket->get_pretty('TKT_qty', 'input'),
1723
-            'edit_ticketrow_name' => $skeleton ? 'TICKETNAMEATTR' : 'edit_tickets',
1724
-            'TKT_sold'            => $skeleton ? 0 : $ticket->get('TKT_sold'),
1725
-            'trash_icon'          => ($skeleton || (! empty($ticket) && ! $ticket->get('TKT_deleted')))
1726
-                                     && (! empty($ticket) && $ticket->get('TKT_sold') === 0)
1727
-                ? 'trash-icon dashicons dashicons-post-trash clickable' : 'ee-lock-icon',
1728
-            'disabled'            => $skeleton || (! empty($ticket) && ! $ticket->get('TKT_deleted')) ? ''
1729
-                : ' disabled=disabled',
1730
-        ];
1731
-        $price         = $ticket->ID() !== 0
1732
-            ? $ticket->get_first_related('Price', ['default_where_conditions' => 'none'])
1733
-            : null;
1734
-        $price         = $price instanceof EE_Price
1735
-            ? $price
1736
-            : EEM_Price::instance()->create_default_object();
1737
-        $price_args    = [
1738
-            'price_currency_symbol' => EE_Registry::instance()->CFG->currency->sign,
1739
-            'PRC_amount'            => $price->get('PRC_amount'),
1740
-            'PRT_ID'                => $price->get('PRT_ID'),
1741
-            'PRC_ID'                => $price->get('PRC_ID'),
1742
-            'PRC_is_default'        => $price->get('PRC_is_default'),
1743
-        ];
1744
-        // make sure we have default start and end dates if skeleton
1745
-        // handle rows that should NOT be empty
1746
-        if (empty($template_args['TKT_start_date'])) {
1747
-            // if empty then the start date will be now.
1748
-            $template_args['TKT_start_date'] = date('Y-m-d h:i a', current_time('timestamp'));
1749
-        }
1750
-        if (empty($template_args['TKT_end_date'])) {
1751
-            // get the earliest datetime (if present);
1752
-            $earliest_datetime             = $this->_cpt_model_obj->ID() > 0
1753
-                ? $this->_cpt_model_obj->get_first_related(
1754
-                    'Datetime',
1755
-                    ['order_by' => ['DTT_EVT_start' => 'ASC']]
1756
-                )
1757
-                : null;
1758
-            $template_args['TKT_end_date'] = $earliest_datetime instanceof EE_Datetime
1759
-                ? $earliest_datetime->get_datetime('DTT_EVT_start', 'Y-m-d', 'h:i a')
1760
-                : date('Y-m-d h:i a', mktime(0, 0, 0, date('m'), date('d') + 7, date('Y')));
1761
-        }
1762
-        $template_args = array_merge($template_args, $price_args);
1763
-        $template      = apply_filters(
1764
-            'FHEE__Events_Admin_Page__get_ticket_row__template',
1765
-            EVENTS_TEMPLATE_PATH . 'event_tickets_metabox_ticket_row.template.php',
1766
-            $ticket
1767
-        );
1768
-        return EEH_Template::display_template($template, $template_args, true);
1769
-    }
1770
-
1771
-
1772
-    /**
1773
-     * @throws EE_Error
1774
-     * @throws ReflectionException
1775
-     */
1776
-    public function registration_options_meta_box()
1777
-    {
1778
-        $yes_no_values             = [
1779
-            ['id' => true, 'text' => esc_html__('Yes', 'event_espresso')],
1780
-            ['id' => false, 'text' => esc_html__('No', 'event_espresso')],
1781
-        ];
1782
-        $default_reg_status_values = EEM_Registration::reg_status_array(
1783
-            [
1784
-                EEM_Registration::status_id_cancelled,
1785
-                EEM_Registration::status_id_declined,
1786
-                EEM_Registration::status_id_incomplete,
1787
-            ],
1788
-            true
1789
-        );
1790
-        // $template_args['is_active_select'] = EEH_Form_Fields::select_input('is_active', $yes_no_values, $this->_cpt_model_obj->is_active());
1791
-        $template_args['_event']                          = $this->_cpt_model_obj;
1792
-        $template_args['event']                           = $this->_cpt_model_obj;
1793
-        $template_args['active_status']                   = $this->_cpt_model_obj->pretty_active_status(false);
1794
-        $template_args['additional_limit']                = $this->_cpt_model_obj->additional_limit();
1795
-        $template_args['default_registration_status']     = EEH_Form_Fields::select_input(
1796
-            'default_reg_status',
1797
-            $default_reg_status_values,
1798
-            $this->_cpt_model_obj->default_registration_status()
1799
-        );
1800
-        $template_args['display_description']             = EEH_Form_Fields::select_input(
1801
-            'display_desc',
1802
-            $yes_no_values,
1803
-            $this->_cpt_model_obj->display_description()
1804
-        );
1805
-        $template_args['display_ticket_selector']         = EEH_Form_Fields::select_input(
1806
-            'display_ticket_selector',
1807
-            $yes_no_values,
1808
-            $this->_cpt_model_obj->display_ticket_selector(),
1809
-            '',
1810
-            '',
1811
-            false
1812
-        );
1813
-        $template_args['additional_registration_options'] = apply_filters(
1814
-            'FHEE__Events_Admin_Page__registration_options_meta_box__additional_registration_options',
1815
-            '',
1816
-            $template_args,
1817
-            $yes_no_values,
1818
-            $default_reg_status_values
1819
-        );
1820
-        EEH_Template::display_template(
1821
-            EVENTS_TEMPLATE_PATH . 'event_registration_options.template.php',
1822
-            $template_args
1823
-        );
1824
-    }
1825
-
1826
-
1827
-    /**
1828
-     * _get_events()
1829
-     * This method simply returns all the events (for the given _view and paging)
1830
-     *
1831
-     * @access public
1832
-     * @param int  $per_page     count of items per page (20 default);
1833
-     * @param int  $current_page what is the current page being viewed.
1834
-     * @param bool $count        if TRUE then we just return a count of ALL events matching the given _view.
1835
-     *                           If FALSE then we return an array of event objects
1836
-     *                           that match the given _view and paging parameters.
1837
-     * @return array|int         an array of event objects or a count of them.
1838
-     * @throws Exception
1839
-     */
1840
-    public function get_events($per_page = 10, $current_page = 1, $count = false)
1841
-    {
1842
-        $EEM_Event   = $this->_event_model();
1843
-        $offset      = ($current_page - 1) * $per_page;
1844
-        $limit       = $count ? null : $offset . ',' . $per_page;
1845
-        $orderby     = $this->request->getRequestParam('orderby', 'EVT_ID');
1846
-        $order       = $this->request->getRequestParam('order', 'DESC');
1847
-        $month_range = $this->request->getRequestParam('month_range');
1848
-        if ($month_range) {
1849
-            $pieces = explode(' ', $month_range, 3);
1850
-            // simulate the FIRST day of the month, that fixes issues for months like February
1851
-            // where PHP doesn't know what to assume for date.
1852
-            // @see https://events.codebasehq.com/projects/event-espresso/tickets/10437
1853
-            $month_r = ! empty($pieces[0]) ? date('m', EEH_DTT_Helper::first_of_month_timestamp($pieces[0])) : '';
1854
-            $year_r  = ! empty($pieces[1]) ? $pieces[1] : '';
1855
-        }
1856
-        $where  = [];
1857
-        $status = $this->request->getRequestParam('status');
1858
-        // determine what post_status our condition will have for the query.
1859
-        switch ($status) {
1860
-            case 'month':
1861
-            case 'today':
1862
-            case null:
1863
-            case 'all':
1864
-                break;
1865
-            case 'draft':
1866
-                $where['status'] = ['IN', ['draft', 'auto-draft']];
1867
-                break;
1868
-            default:
1869
-                $where['status'] = $status;
1870
-        }
1871
-        // categories? The default for all categories is -1
1872
-        $category = $this->request->getRequestParam('EVT_CAT', -1, 'int');
1873
-        if ($category !== -1) {
1874
-            $where['Term_Taxonomy.taxonomy'] = EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY;
1875
-            $where['Term_Taxonomy.term_id']  = $category;
1876
-        }
1877
-        // date where conditions
1878
-        $start_formats = EEM_Datetime::instance()->get_formats_for('DTT_EVT_start');
1879
-        if ($month_range) {
1880
-            $DateTime = new DateTime(
1881
-                $year_r . '-' . $month_r . '-01 00:00:00',
1882
-                new DateTimeZone('UTC')
1883
-            );
1884
-            $start    = $DateTime->getTimestamp();
1885
-            // set the datetime to be the end of the month
1886
-            $DateTime->setDate(
1887
-                $year_r,
1888
-                $month_r,
1889
-                $DateTime->format('t')
1890
-            )->setTime(23, 59, 59);
1891
-            $end                             = $DateTime->getTimestamp();
1892
-            $where['Datetime.DTT_EVT_start'] = ['BETWEEN', [$start, $end]];
1893
-        } elseif ($status === 'today') {
1894
-            $DateTime                        =
1895
-                new DateTime('now', new DateTimeZone(EEM_Event::instance()->get_timezone()));
1896
-            $start                           = $DateTime->setTime(0, 0)->format(implode(' ', $start_formats));
1897
-            $end                             = $DateTime->setTime(23, 59, 59)->format(implode(' ', $start_formats));
1898
-            $where['Datetime.DTT_EVT_start'] = ['BETWEEN', [$start, $end]];
1899
-        } elseif ($status === 'month') {
1900
-            $now                             = date('Y-m-01');
1901
-            $DateTime                        =
1902
-                new DateTime($now, new DateTimeZone(EEM_Event::instance()->get_timezone()));
1903
-            $start                           = $DateTime->setTime(0, 0)->format(implode(' ', $start_formats));
1904
-            $end                             = $DateTime->setDate(date('Y'), date('m'), $DateTime->format('t'))
1905
-                                                        ->setTime(23, 59, 59)
1906
-                                                        ->format(implode(' ', $start_formats));
1907
-            $where['Datetime.DTT_EVT_start'] = ['BETWEEN', [$start, $end]];
1908
-        }
1909
-        if (! EE_Registry::instance()->CAP->current_user_can('ee_read_others_events', 'get_events')) {
1910
-            $where['EVT_wp_user'] = get_current_user_id();
1911
-        } else {
1912
-            if (! isset($where['status'])) {
1913
-                if (! EE_Registry::instance()->CAP->current_user_can('ee_read_private_events', 'get_events')) {
1914
-                    $where['OR'] = [
1915
-                        'status*restrict_private' => ['!=', 'private'],
1916
-                        'AND'                     => [
1917
-                            'status*inclusive' => ['=', 'private'],
1918
-                            'EVT_wp_user'      => get_current_user_id(),
1919
-                        ],
1920
-                    ];
1921
-                }
1922
-            }
1923
-        }
1924
-        $wp_user = $this->request->getRequestParam('EVT_wp_user', 0, 'int');
1925
-        if (
1926
-            $wp_user
1927
-            && $wp_user !== get_current_user_id()
1928
-            && EE_Registry::instance()->CAP->current_user_can('ee_read_others_events', 'get_events')
1929
-        ) {
1930
-            $where['EVT_wp_user'] = $wp_user;
1931
-        }
1932
-        // search query handling
1933
-        $search_term = $this->request->getRequestParam('s');
1934
-        if ($search_term) {
1935
-            $search_term = '%' . $search_term . '%';
1936
-            $where['OR'] = [
1937
-                'EVT_name'       => ['LIKE', $search_term],
1938
-                'EVT_desc'       => ['LIKE', $search_term],
1939
-                'EVT_short_desc' => ['LIKE', $search_term],
1940
-            ];
1941
-        }
1942
-        // filter events by venue.
1943
-        $venue = $this->request->getRequestParam('venue', 0, 'int');
1944
-        if ($venue) {
1945
-            $where['Venue.VNU_ID'] = $venue;
1946
-        }
1947
-        $request_params = $this->request->requestParams();
1948
-        $where          = apply_filters('FHEE__Events_Admin_Page__get_events__where', $where, $request_params);
1949
-        $query_params   = apply_filters(
1950
-            'FHEE__Events_Admin_Page__get_events__query_params',
1951
-            [
1952
-                $where,
1953
-                'limit'    => $limit,
1954
-                'order_by' => $orderby,
1955
-                'order'    => $order,
1956
-                'group_by' => 'EVT_ID',
1957
-            ],
1958
-            $request_params
1959
-        );
1960
-
1961
-        // let's first check if we have special requests coming in.
1962
-        $active_status = $this->request->getRequestParam('active_status');
1963
-        if ($active_status) {
1964
-            switch ($active_status) {
1965
-                case 'upcoming':
1966
-                    return $EEM_Event->get_upcoming_events($query_params, $count);
1967
-                case 'expired':
1968
-                    return $EEM_Event->get_expired_events($query_params, $count);
1969
-                case 'active':
1970
-                    return $EEM_Event->get_active_events($query_params, $count);
1971
-                case 'inactive':
1972
-                    return $EEM_Event->get_inactive_events($query_params, $count);
1973
-            }
1974
-        }
1975
-
1976
-        return $count ? $EEM_Event->count([$where], 'EVT_ID', true) : $EEM_Event->get_all($query_params);
1977
-    }
1978
-
1979
-
1980
-    /**
1981
-     * handling for WordPress CPT actions (trash, restore, delete)
1982
-     *
1983
-     * @param string $post_id
1984
-     * @throws EE_Error
1985
-     * @throws ReflectionException
1986
-     */
1987
-    public function trash_cpt_item($post_id)
1988
-    {
1989
-        $this->request->setRequestParam('EVT_ID', $post_id);
1990
-        $this->_trash_or_restore_event('trash', false);
1991
-    }
1992
-
1993
-
1994
-    /**
1995
-     * @param string $post_id
1996
-     * @throws EE_Error
1997
-     * @throws ReflectionException
1998
-     */
1999
-    public function restore_cpt_item($post_id)
2000
-    {
2001
-        $this->request->setRequestParam('EVT_ID', $post_id);
2002
-        $this->_trash_or_restore_event('draft', false);
2003
-    }
2004
-
2005
-
2006
-    /**
2007
-     * @param string $post_id
2008
-     * @throws EE_Error
2009
-     * @throws EE_Error
2010
-     */
2011
-    public function delete_cpt_item($post_id)
2012
-    {
2013
-        throw new EE_Error(
2014
-            esc_html__(
2015
-                'Please contact Event Espresso support with the details of the steps taken to produce this error.',
2016
-                'event_espresso'
2017
-            )
2018
-        );
2019
-        // $this->request->setRequestParam('EVT_ID', $post_id);
2020
-        // $this->_delete_event();
2021
-    }
2022
-
2023
-
2024
-    /**
2025
-     * _trash_or_restore_event
2026
-     *
2027
-     * @access protected
2028
-     * @param string $event_status
2029
-     * @param bool   $redirect_after
2030
-     * @throws EE_Error
2031
-     * @throws EE_Error
2032
-     * @throws ReflectionException
2033
-     */
2034
-    protected function _trash_or_restore_event($event_status = 'trash', $redirect_after = true)
2035
-    {
2036
-        // determine the event id and set to array.
2037
-        $EVT_ID = $this->request->getRequestParam('EVT_ID', 0, 'int');
2038
-        // loop thru events
2039
-        if ($EVT_ID) {
2040
-            // clean status
2041
-            $event_status = sanitize_key($event_status);
2042
-            // grab status
2043
-            if (! empty($event_status)) {
2044
-                $success = $this->_change_event_status($EVT_ID, $event_status);
2045
-            } else {
2046
-                $success = false;
2047
-                $msg     = esc_html__(
2048
-                    'An error occurred. The event could not be moved to the trash because a valid event status was not not supplied.',
2049
-                    'event_espresso'
2050
-                );
2051
-                EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2052
-            }
2053
-        } else {
2054
-            $success = false;
2055
-            $msg     = esc_html__(
2056
-                'An error occurred. The event could not be moved to the trash because a valid event ID was not not supplied.',
2057
-                'event_espresso'
2058
-            );
2059
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2060
-        }
2061
-        $action = $event_status == 'trash' ? 'moved to the trash' : 'restored from the trash';
2062
-        if ($redirect_after) {
2063
-            $this->_redirect_after_action($success, 'Event', $action, ['action' => 'default']);
2064
-        }
2065
-    }
2066
-
2067
-
2068
-    /**
2069
-     * _trash_or_restore_events
2070
-     *
2071
-     * @access protected
2072
-     * @param string $event_status
2073
-     * @return void
2074
-     * @throws EE_Error
2075
-     * @throws EE_Error
2076
-     * @throws ReflectionException
2077
-     */
2078
-    protected function _trash_or_restore_events($event_status = 'trash')
2079
-    {
2080
-        // clean status
2081
-        $event_status = sanitize_key($event_status);
2082
-        // grab status
2083
-        if (! empty($event_status)) {
2084
-            $success = true;
2085
-            // determine the event id and set to array.
2086
-            $EVT_IDs = $this->request->getRequestParam('EVT_IDs', [], 'int', true);
2087
-            // loop thru events
2088
-            foreach ($EVT_IDs as $EVT_ID) {
2089
-                if ($EVT_ID = absint($EVT_ID)) {
2090
-                    $results = $this->_change_event_status($EVT_ID, $event_status);
2091
-                    $success = $results !== false ? $success : false;
2092
-                } else {
2093
-                    $msg = sprintf(
2094
-                        esc_html__(
2095
-                            'An error occurred. Event #%d could not be moved to the trash because a valid event ID was not not supplied.',
2096
-                            'event_espresso'
2097
-                        ),
2098
-                        $EVT_ID
2099
-                    );
2100
-                    EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2101
-                    $success = false;
2102
-                }
2103
-            }
2104
-        } else {
2105
-            $success = false;
2106
-            $msg     = esc_html__(
2107
-                'An error occurred. The event could not be moved to the trash because a valid event status was not not supplied.',
2108
-                'event_espresso'
2109
-            );
2110
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2111
-        }
2112
-        // in order to force a pluralized result message we need to send back a success status greater than 1
2113
-        $success = $success ? 2 : false;
2114
-        $action  = $event_status == 'trash' ? 'moved to the trash' : 'restored from the trash';
2115
-        $this->_redirect_after_action($success, 'Events', $action, ['action' => 'default']);
2116
-    }
2117
-
2118
-
2119
-    /**
2120
-     * @param int    $EVT_ID
2121
-     * @param string $event_status
2122
-     * @return bool
2123
-     * @throws EE_Error
2124
-     * @throws ReflectionException
2125
-     */
2126
-    private function _change_event_status($EVT_ID = 0, $event_status = '')
2127
-    {
2128
-        // grab event id
2129
-        if (! $EVT_ID) {
2130
-            $msg = esc_html__(
2131
-                'An error occurred. No Event ID or an invalid Event ID was received.',
2132
-                'event_espresso'
2133
-            );
2134
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2135
-            return false;
2136
-        }
2137
-        $this->_cpt_model_obj = EEM_Event::instance()->get_one_by_ID($EVT_ID);
2138
-        // clean status
2139
-        $event_status = sanitize_key($event_status);
2140
-        // grab status
2141
-        if (empty($event_status)) {
2142
-            $msg = esc_html__(
2143
-                'An error occurred. No Event Status or an invalid Event Status was received.',
2144
-                'event_espresso'
2145
-            );
2146
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2147
-            return false;
2148
-        }
2149
-        // was event trashed or restored ?
2150
-        switch ($event_status) {
2151
-            case 'draft':
2152
-                $action = 'restored from the trash';
2153
-                $hook   = 'AHEE_event_restored_from_trash';
2154
-                break;
2155
-            case 'trash':
2156
-                $action = 'moved to the trash';
2157
-                $hook   = 'AHEE_event_moved_to_trash';
2158
-                break;
2159
-            default:
2160
-                $action = 'updated';
2161
-                $hook   = false;
2162
-        }
2163
-        // use class to change status
2164
-        $this->_cpt_model_obj->set_status($event_status);
2165
-        $success = $this->_cpt_model_obj->save();
2166
-        if (! $success) {
2167
-            $msg = sprintf(esc_html__('An error occurred. The event could not be %s.', 'event_espresso'), $action);
2168
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2169
-            return false;
2170
-        }
2171
-        if ($hook) {
2172
-            do_action($hook);
2173
-        }
2174
-        return true;
2175
-    }
2176
-
2177
-
2178
-    /**
2179
-     * @param array $event_ids
2180
-     * @return array
2181
-     * @since   4.10.23.p
2182
-     */
2183
-    private function cleanEventIds(array $event_ids)
2184
-    {
2185
-        return array_map('absint', $event_ids);
2186
-    }
2187
-
2188
-
2189
-    /**
2190
-     * @return array
2191
-     * @since   4.10.23.p
2192
-     */
2193
-    private function getEventIdsFromRequest()
2194
-    {
2195
-        if ($this->request->requestParamIsSet('EVT_IDs')) {
2196
-            return $this->request->getRequestParam('EVT_IDs', [], 'int', true);
2197
-        } else {
2198
-            return $this->request->getRequestParam('EVT_ID', [], 'int', true);
2199
-        }
2200
-    }
2201
-
2202
-
2203
-    /**
2204
-     * @param bool $preview_delete
2205
-     * @throws EE_Error
2206
-     */
2207
-    protected function _delete_event($preview_delete = true)
2208
-    {
2209
-        $this->_delete_events($preview_delete);
2210
-    }
2211
-
2212
-
2213
-    /**
2214
-     * Gets the tree traversal batch persister.
2215
-     *
2216
-     * @return NodeGroupDao
2217
-     * @throws InvalidArgumentException
2218
-     * @throws InvalidDataTypeException
2219
-     * @throws InvalidInterfaceException
2220
-     * @since 4.10.12.p
2221
-     */
2222
-    protected function getModelObjNodeGroupPersister()
2223
-    {
2224
-        if (! $this->model_obj_node_group_persister instanceof NodeGroupDao) {
2225
-            $this->model_obj_node_group_persister =
2226
-                $this->getLoader()->load('\EventEspresso\core\services\orm\tree_traversal\NodeGroupDao');
2227
-        }
2228
-        return $this->model_obj_node_group_persister;
2229
-    }
2230
-
2231
-
2232
-    /**
2233
-     * @param bool $preview_delete
2234
-     * @return void
2235
-     * @throws EE_Error
2236
-     */
2237
-    protected function _delete_events($preview_delete = true)
2238
-    {
2239
-        $event_ids = $this->getEventIdsFromRequest();
2240
-        if ($preview_delete) {
2241
-            $this->generateDeletionPreview($event_ids);
2242
-        } else {
2243
-            EEM_Event::instance()->delete_permanently([['EVT_ID' => ['IN', $event_ids]]]);
2244
-        }
2245
-    }
2246
-
2247
-
2248
-    /**
2249
-     * @param array $event_ids
2250
-     */
2251
-    protected function generateDeletionPreview(array $event_ids)
2252
-    {
2253
-        $event_ids = $this->cleanEventIds($event_ids);
2254
-        // Set a code we can use to reference this deletion task in the batch jobs and preview page.
2255
-        $deletion_job_code = $this->getModelObjNodeGroupPersister()->generateGroupCode();
2256
-        $return_url        = EE_Admin_Page::add_query_args_and_nonce(
2257
-            [
2258
-                'action'            => 'preview_deletion',
2259
-                'deletion_job_code' => $deletion_job_code,
2260
-            ],
2261
-            $this->_admin_base_url
2262
-        );
2263
-        EEH_URL::safeRedirectAndExit(
2264
-            EE_Admin_Page::add_query_args_and_nonce(
2265
-                [
2266
-                    'page'              => 'espresso_batch',
2267
-                    'batch'             => EED_Batch::batch_job,
2268
-                    'EVT_IDs'           => $event_ids,
2269
-                    'deletion_job_code' => $deletion_job_code,
2270
-                    'job_handler'       => urlencode('EventEspressoBatchRequest\JobHandlers\PreviewEventDeletion'),
2271
-                    'return_url'        => urlencode($return_url),
2272
-                ],
2273
-                admin_url()
2274
-            )
2275
-        );
2276
-    }
2277
-
2278
-
2279
-    /**
2280
-     * Checks for a POST submission
2281
-     *
2282
-     * @since 4.10.12.p
2283
-     */
2284
-    protected function confirmDeletion()
2285
-    {
2286
-        $deletion_redirect_logic =
2287
-            $this->getLoader()->getShared('\EventEspresso\core\domain\services\admin\events\data\ConfirmDeletion');
2288
-        $deletion_redirect_logic->handle($this->get_request_data(), $this->admin_base_url());
2289
-    }
2290
-
2291
-
2292
-    /**
2293
-     * A page for users to preview what exactly will be deleted, and confirm they want to delete it.
2294
-     *
2295
-     * @throws EE_Error
2296
-     * @since 4.10.12.p
2297
-     */
2298
-    protected function previewDeletion()
2299
-    {
2300
-        $preview_deletion_logic =
2301
-            $this->getLoader()->getShared('\EventEspresso\core\domain\services\admin\events\data\PreviewDeletion');
2302
-        $this->set_template_args($preview_deletion_logic->handle($this->get_request_data(), $this->admin_base_url()));
2303
-        $this->display_admin_page_with_no_sidebar();
2304
-    }
2305
-
2306
-
2307
-    /**
2308
-     * get total number of events
2309
-     *
2310
-     * @access public
2311
-     * @return int
2312
-     * @throws EE_Error
2313
-     * @throws EE_Error
2314
-     */
2315
-    public function total_events()
2316
-    {
2317
-        return EEM_Event::instance()->count(
2318
-            ['caps' => 'read_admin'],
2319
-            'EVT_ID',
2320
-            true
2321
-        );
2322
-    }
2323
-
2324
-
2325
-    /**
2326
-     * get total number of draft events
2327
-     *
2328
-     * @access public
2329
-     * @return int
2330
-     * @throws EE_Error
2331
-     * @throws EE_Error
2332
-     */
2333
-    public function total_events_draft()
2334
-    {
2335
-        return EEM_Event::instance()->count(
2336
-            [
2337
-                ['status' => ['IN', ['draft', 'auto-draft']]],
2338
-                'caps' => 'read_admin',
2339
-            ],
2340
-            'EVT_ID',
2341
-            true
2342
-        );
2343
-    }
2344
-
2345
-
2346
-    /**
2347
-     * get total number of trashed events
2348
-     *
2349
-     * @access public
2350
-     * @return int
2351
-     * @throws EE_Error
2352
-     * @throws EE_Error
2353
-     */
2354
-    public function total_trashed_events()
2355
-    {
2356
-        return EEM_Event::instance()->count(
2357
-            [
2358
-                ['status' => 'trash'],
2359
-                'caps' => 'read_admin',
2360
-            ],
2361
-            'EVT_ID',
2362
-            true
2363
-        );
2364
-    }
2365
-
2366
-
2367
-    /**
2368
-     *    _default_event_settings
2369
-     *    This generates the Default Settings Tab
2370
-     *
2371
-     * @return void
2372
-     * @throws EE_Error
2373
-     */
2374
-    protected function _default_event_settings()
2375
-    {
2376
-        $this->_set_add_edit_form_tags('update_default_event_settings');
2377
-        $this->_set_publish_post_box_vars(null, false, false, null, false);
2378
-        $this->_template_args['admin_page_content'] = $this->_default_event_settings_form()->get_html();
2379
-        $this->display_admin_page_with_sidebar();
2380
-    }
2381
-
2382
-
2383
-    /**
2384
-     * Return the form for event settings.
2385
-     *
2386
-     * @return EE_Form_Section_Proper
2387
-     * @throws EE_Error
2388
-     */
2389
-    protected function _default_event_settings_form()
2390
-    {
2391
-        $registration_config              = EE_Registry::instance()->CFG->registration;
2392
-        $registration_stati_for_selection = EEM_Registration::reg_status_array(
2393
-        // exclude
2394
-            [
2395
-                EEM_Registration::status_id_cancelled,
2396
-                EEM_Registration::status_id_declined,
2397
-                EEM_Registration::status_id_incomplete,
2398
-                EEM_Registration::status_id_wait_list,
2399
-            ],
2400
-            true
2401
-        );
2402
-        return new EE_Form_Section_Proper(
2403
-            [
2404
-                'name'            => 'update_default_event_settings',
2405
-                'html_id'         => 'update_default_event_settings',
2406
-                'html_class'      => 'form-table',
2407
-                'layout_strategy' => new EE_Admin_Two_Column_Layout(),
2408
-                'subsections'     => apply_filters(
2409
-                    'FHEE__Events_Admin_Page___default_event_settings_form__form_subsections',
2410
-                    [
2411
-                        'default_reg_status'  => new EE_Select_Input(
2412
-                            $registration_stati_for_selection,
2413
-                            [
2414
-                                'default'         => isset($registration_config->default_STS_ID)
2415
-                                                     && array_key_exists(
2416
-                                                         $registration_config->default_STS_ID,
2417
-                                                         $registration_stati_for_selection
2418
-                                                     )
2419
-                                    ? sanitize_text_field($registration_config->default_STS_ID)
2420
-                                    : EEM_Registration::status_id_pending_payment,
2421
-                                'html_label_text' => esc_html__('Default Registration Status', 'event_espresso')
2422
-                                                     . EEH_Template::get_help_tab_link(
2423
-                                                         'default_settings_status_help_tab'
2424
-                                                     ),
2425
-                                'html_help_text'  => esc_html__(
2426
-                                    'This setting allows you to preselect what the default registration status setting is when creating an event.  Note that changing this setting does NOT retroactively apply it to existing events.',
2427
-                                    'event_espresso'
2428
-                                ),
2429
-                            ]
2430
-                        ),
2431
-                        'default_max_tickets' => new EE_Integer_Input(
2432
-                            [
2433
-                                'default'         => isset($registration_config->default_maximum_number_of_tickets)
2434
-                                    ? $registration_config->default_maximum_number_of_tickets
2435
-                                    : EEM_Event::get_default_additional_limit(),
2436
-                                'html_label_text' => esc_html__(
2437
-                                    'Default Maximum Tickets Allowed Per Order:',
2438
-                                    'event_espresso'
2439
-                                )
2440
-                                . EEH_Template::get_help_tab_link(
2441
-                                    'default_maximum_tickets_help_tab"'
2442
-                                ),
2443
-                                'html_help_text'  => esc_html__(
2444
-                                    'This setting allows you to indicate what will be the default for the maximum number of tickets per order when creating new events.',
2445
-                                    'event_espresso'
2446
-                                ),
2447
-                            ]
2448
-                        ),
2449
-                    ]
2450
-                ),
2451
-            ]
2452
-        );
2453
-    }
2454
-
2455
-
2456
-    /**
2457
-     * _update_default_event_settings
2458
-     *
2459
-     * @access protected
2460
-     * @return void
2461
-     * @throws EE_Error
2462
-     */
2463
-    protected function _update_default_event_settings()
2464
-    {
2465
-        $registration_config = EE_Registry::instance()->CFG->registration;
2466
-        $form                = $this->_default_event_settings_form();
2467
-        if ($form->was_submitted()) {
2468
-            $form->receive_form_submission();
2469
-            if ($form->is_valid()) {
2470
-                $valid_data = $form->valid_data();
2471
-                if (isset($valid_data['default_reg_status'])) {
2472
-                    $registration_config->default_STS_ID = $valid_data['default_reg_status'];
2473
-                }
2474
-                if (isset($valid_data['default_max_tickets'])) {
2475
-                    $registration_config->default_maximum_number_of_tickets = $valid_data['default_max_tickets'];
2476
-                }
2477
-                // update because data was valid!
2478
-                EE_Registry::instance()->CFG->update_espresso_config();
2479
-                EE_Error::overwrite_success();
2480
-                EE_Error::add_success(
2481
-                    esc_html__('Default Event Settings were updated', 'event_espresso')
2482
-                );
2483
-            }
2484
-        }
2485
-        $this->_redirect_after_action(0, '', '', ['action' => 'default_event_settings'], true);
2486
-    }
2487
-
2488
-
2489
-    /*************        Templates        *************
2490
-     *
2491
-     * @throws EE_Error
2492
-     */
2493
-    protected function _template_settings()
2494
-    {
2495
-        $this->_admin_page_title              = esc_html__('Template Settings (Preview)', 'event_espresso');
2496
-        $this->_template_args['preview_img']  = '<img src="'
2497
-                                                . EVENTS_ASSETS_URL
2498
-                                                . '/images/'
2499
-                                                . 'caffeinated_template_features.jpg" alt="'
2500
-                                                . esc_attr__('Template Settings Preview screenshot', 'event_espresso')
2501
-                                                . '" />';
2502
-        $this->_template_args['preview_text'] = '<strong>'
2503
-                                                . esc_html__(
2504
-                                                    'Template Settings is a feature that is only available in the premium version of Event Espresso 4 which is available with a support license purchase on EventEspresso.com. Template Settings allow you to configure some of the appearance options for both the Event List and Event Details pages.',
2505
-                                                    'event_espresso'
2506
-                                                ) . '</strong>';
2507
-        $this->display_admin_caf_preview_page('template_settings_tab');
2508
-    }
2509
-
2510
-
2511
-    /** Event Category Stuff **/
2512
-    /**
2513
-     * set the _category property with the category object for the loaded page.
2514
-     *
2515
-     * @access private
2516
-     * @return void
2517
-     */
2518
-    private function _set_category_object()
2519
-    {
2520
-        if (isset($this->_category->id) && ! empty($this->_category->id)) {
2521
-            return;
2522
-        } //already have the category object so get out.
2523
-        // set default category object
2524
-        $this->_set_empty_category_object();
2525
-        // only set if we've got an id
2526
-        $category_ID = $this->request->getRequestParam('EVT_CAT_ID', 0, 'int');
2527
-        if (! $category_ID) {
2528
-            return;
2529
-        }
2530
-        $term = get_term($category_ID, EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY);
2531
-        if (! empty($term)) {
2532
-            $this->_category->category_name       = $term->name;
2533
-            $this->_category->category_identifier = $term->slug;
2534
-            $this->_category->category_desc       = $term->description;
2535
-            $this->_category->id                  = $term->term_id;
2536
-            $this->_category->parent              = $term->parent;
2537
-        }
2538
-    }
2539
-
2540
-
2541
-    /**
2542
-     * Clears out category properties.
2543
-     */
2544
-    private function _set_empty_category_object()
2545
-    {
2546
-        $this->_category                = new stdClass();
2547
-        $this->_category->category_name = $this->_category->category_identifier = $this->_category->category_desc = '';
2548
-        $this->_category->id            = $this->_category->parent = 0;
2549
-    }
2550
-
2551
-
2552
-    /**
2553
-     * @throws EE_Error
2554
-     */
2555
-    protected function _category_list_table()
2556
-    {
2557
-        do_action('AHEE_log', __FILE__, __FUNCTION__, '');
2558
-        $this->_search_btn_label = esc_html__('Categories', 'event_espresso');
2559
-        $this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
2560
-            'add_category',
2561
-            'add_category',
2562
-            [],
2563
-            'add-new-h2'
2564
-        );
2565
-        $this->display_admin_list_table_page_with_sidebar();
2566
-    }
2567
-
2568
-
2569
-    /**
2570
-     * Output category details view.
2571
-     *
2572
-     * @throws EE_Error
2573
-     * @throws EE_Error
2574
-     */
2575
-    protected function _category_details($view)
2576
-    {
2577
-        // load formatter helper
2578
-        // load field generator helper
2579
-        $route = $view == 'edit' ? 'update_category' : 'insert_category';
2580
-        $this->_set_add_edit_form_tags($route);
2581
-        $this->_set_category_object();
2582
-        $id            = ! empty($this->_category->id) ? $this->_category->id : '';
2583
-        $delete_action = 'delete_category';
2584
-        // custom redirect
2585
-        $redirect = EE_Admin_Page::add_query_args_and_nonce(
2586
-            ['action' => 'category_list'],
2587
-            $this->_admin_base_url
2588
-        );
2589
-        $this->_set_publish_post_box_vars('EVT_CAT_ID', $id, $delete_action, $redirect);
2590
-        // take care of contents
2591
-        $this->_template_args['admin_page_content'] = $this->_category_details_content();
2592
-        $this->display_admin_page_with_sidebar();
2593
-    }
2594
-
2595
-
2596
-    /**
2597
-     * Output category details content.
2598
-     */
2599
-    protected function _category_details_content()
2600
-    {
2601
-        $editor_args['category_desc'] = [
2602
-            'type'          => 'wp_editor',
2603
-            'value'         => EEH_Formatter::admin_format_content($this->_category->category_desc),
2604
-            'class'         => 'my_editor_custom',
2605
-            'wpeditor_args' => ['media_buttons' => false],
2606
-        ];
2607
-        $_wp_editor                   = $this->_generate_admin_form_fields($editor_args, 'array');
2608
-        $all_terms                    = get_terms(
2609
-            [EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY],
2610
-            ['hide_empty' => 0, 'exclude' => [$this->_category->id]]
2611
-        );
2612
-        // setup category select for term parents.
2613
-        $category_select_values[] = [
2614
-            'text' => esc_html__('No Parent', 'event_espresso'),
2615
-            'id'   => 0,
2616
-        ];
2617
-        foreach ($all_terms as $term) {
2618
-            $category_select_values[] = [
2619
-                'text' => $term->name,
2620
-                'id'   => $term->term_id,
2621
-            ];
2622
-        }
2623
-        $category_select = EEH_Form_Fields::select_input(
2624
-            'category_parent',
2625
-            $category_select_values,
2626
-            $this->_category->parent
2627
-        );
2628
-        $template_args   = [
2629
-            'category'                 => $this->_category,
2630
-            'category_select'          => $category_select,
2631
-            'unique_id_info_help_link' => $this->_get_help_tab_link('unique_id_info'),
2632
-            'category_desc_editor'     => $_wp_editor['category_desc']['field'],
2633
-            'disable'                  => '',
2634
-            'disabled_message'         => false,
2635
-        ];
2636
-        $template        = EVENTS_TEMPLATE_PATH . 'event_category_details.template.php';
2637
-        return EEH_Template::display_template($template, $template_args, true);
2638
-    }
2639
-
2640
-
2641
-    /**
2642
-     * Handles deleting categories.
2643
-     *
2644
-     * @throws EE_Error
2645
-     */
2646
-    protected function _delete_categories()
2647
-    {
2648
-        $category_IDs = $this->request->getRequestParam('EVT_CAT_ID', 0, 'int', true);
2649
-        foreach ($category_IDs as $category_ID) {
2650
-            $this->_delete_category($category_ID);
2651
-        }
2652
-        // doesn't matter what page we're coming from... we're going to the same place after delete.
2653
-        $query_args = [
2654
-            'action' => 'category_list',
2655
-        ];
2656
-        $this->_redirect_after_action(0, '', '', $query_args);
2657
-    }
2658
-
2659
-
2660
-    /**
2661
-     * Handles deleting specific category.
2662
-     *
2663
-     * @param int $cat_id
2664
-     */
2665
-    protected function _delete_category($cat_id)
2666
-    {
2667
-        $cat_id = absint($cat_id);
2668
-        wp_delete_term($cat_id, EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY);
2669
-    }
2670
-
2671
-
2672
-    /**
2673
-     * Handles triggering the update or insertion of a new category.
2674
-     *
2675
-     * @param bool $new_category true means we're triggering the insert of a new category.
2676
-     * @throws EE_Error
2677
-     * @throws EE_Error
2678
-     */
2679
-    protected function _insert_or_update_category($new_category)
2680
-    {
2681
-        $cat_id  = $new_category ? $this->_insert_category() : $this->_insert_category(true);
2682
-        $success = 0; // we already have a success message so lets not send another.
2683
-        if ($cat_id) {
2684
-            $query_args = [
2685
-                'action'     => 'edit_category',
2686
-                'EVT_CAT_ID' => $cat_id,
2687
-            ];
2688
-        } else {
2689
-            $query_args = ['action' => 'add_category'];
2690
-        }
2691
-        $this->_redirect_after_action($success, '', '', $query_args, true);
2692
-    }
2693
-
2694
-
2695
-    /**
2696
-     * Inserts or updates category
2697
-     *
2698
-     * @param bool $update (true indicates we're updating a category).
2699
-     * @return bool|mixed|string
2700
-     */
2701
-    private function _insert_category($update = false)
2702
-    {
2703
-        $category_ID         = $update ? $this->request->getRequestParam('EVT_CAT_ID', 0, 'int') : 0;
2704
-        $category_name       = $this->request->getRequestParam('category_name', '');
2705
-        $category_desc       = $this->request->getRequestParam('category_desc', '');
2706
-        $category_parent     = $this->request->getRequestParam('category_parent', 0, 'int');
2707
-        $category_identifier = $this->request->getRequestParam('category_identifier', '');
2708
-
2709
-        if (empty($category_name)) {
2710
-            $msg = esc_html__('You must add a name for the category.', 'event_espresso');
2711
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2712
-            return false;
2713
-        }
2714
-        $term_args = [
2715
-            'name'        => $category_name,
2716
-            'description' => $category_desc,
2717
-            'parent'      => $category_parent,
2718
-        ];
2719
-        // was the category_identifier input disabled?
2720
-        if ($category_identifier) {
2721
-            $term_args['slug'] = $category_identifier;
2722
-        }
2723
-        $insert_ids = $update
2724
-            ? wp_update_term($category_ID, EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY, $term_args)
2725
-            : wp_insert_term($category_name, EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY, $term_args);
2726
-        if (! is_array($insert_ids)) {
2727
-            $msg = esc_html__(
2728
-                'An error occurred and the category has not been saved to the database.',
2729
-                'event_espresso'
2730
-            );
2731
-            EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2732
-        } else {
2733
-            $category_ID = $insert_ids['term_id'];
2734
-            $msg         =
2735
-                sprintf(esc_html__('The category %s was successfully saved', 'event_espresso'), $category_name);
2736
-            EE_Error::add_success($msg);
2737
-        }
2738
-        return $category_ID;
2739
-    }
2740
-
2741
-
2742
-    /**
2743
-     * Gets categories or count of categories matching the arguments in the request.
2744
-     *
2745
-     * @param int  $per_page
2746
-     * @param int  $current_page
2747
-     * @param bool $count
2748
-     * @return EE_Term_Taxonomy[]|int
2749
-     * @throws EE_Error
2750
-     * @throws EE_Error
2751
-     */
2752
-    public function get_categories($per_page = 10, $current_page = 1, $count = false)
2753
-    {
2754
-        // testing term stuff
2755
-        $orderby     = $this->request->getRequestParam('orderby', 'Term.term_id');
2756
-        $order       = $this->request->getRequestParam('order', 'DESC');
2757
-        $limit       = ($current_page - 1) * $per_page;
2758
-        $where       = ['taxonomy' => EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY];
2759
-        $search_term = $this->request->getRequestParam('s');
2760
-        if ($search_term) {
2761
-            $search_term = '%' . $search_term . '%';
2762
-            $where['OR'] = [
2763
-                'Term.name'   => ['LIKE', $search_term],
2764
-                'description' => ['LIKE', $search_term],
2765
-            ];
2766
-        }
2767
-        $query_params = [
2768
-            $where,
2769
-            'order_by'   => [$orderby => $order],
2770
-            'limit'      => $limit . ',' . $per_page,
2771
-            'force_join' => ['Term'],
2772
-        ];
2773
-        return $count
2774
-            ? EEM_Term_Taxonomy::instance()->count($query_params, 'term_id')
2775
-            : EEM_Term_Taxonomy::instance()->get_all($query_params);
2776
-    }
2777
-
2778
-    /* end category stuff */
2779
-    /**************/
2780
-
2781
-
2782
-    /**
2783
-     * Callback for the `ee_save_timezone_setting` ajax action.
2784
-     *
2785
-     * @throws EE_Error
2786
-     */
2787
-    public function saveTimezoneString()
2788
-    {
2789
-        $timezone_string = $this->request->getRequestParam('timezone_selected');
2790
-        if (empty($timezone_string) || ! EEH_DTT_Helper::validate_timezone($timezone_string, false)) {
2791
-            EE_Error::add_error(
2792
-                esc_html__('An invalid timezone string submitted.', 'event_espresso'),
2793
-                __FILE__,
2794
-                __FUNCTION__,
2795
-                __LINE__
2796
-            );
2797
-            $this->_template_args['error'] = true;
2798
-            $this->_return_json();
2799
-        }
2800
-
2801
-        update_option('timezone_string', $timezone_string);
2802
-        EE_Error::add_success(
2803
-            esc_html__('Your timezone string was updated.', 'event_espresso')
2804
-        );
2805
-        $this->_template_args['success'] = true;
2806
-        $this->_return_json(true, ['action' => 'create_new']);
2807
-    }
2808
-
2809
-
2810
-    /**
2811 2491
      * @throws EE_Error
2812
-     * @deprecated 4.10.25.p
2813 2492
      */
2814
-    public function save_timezonestring_setting()
2815
-    {
2816
-        $this->saveTimezoneString();
2817
-    }
2493
+	protected function _template_settings()
2494
+	{
2495
+		$this->_admin_page_title              = esc_html__('Template Settings (Preview)', 'event_espresso');
2496
+		$this->_template_args['preview_img']  = '<img src="'
2497
+												. EVENTS_ASSETS_URL
2498
+												. '/images/'
2499
+												. 'caffeinated_template_features.jpg" alt="'
2500
+												. esc_attr__('Template Settings Preview screenshot', 'event_espresso')
2501
+												. '" />';
2502
+		$this->_template_args['preview_text'] = '<strong>'
2503
+												. esc_html__(
2504
+													'Template Settings is a feature that is only available in the premium version of Event Espresso 4 which is available with a support license purchase on EventEspresso.com. Template Settings allow you to configure some of the appearance options for both the Event List and Event Details pages.',
2505
+													'event_espresso'
2506
+												) . '</strong>';
2507
+		$this->display_admin_caf_preview_page('template_settings_tab');
2508
+	}
2509
+
2510
+
2511
+	/** Event Category Stuff **/
2512
+	/**
2513
+	 * set the _category property with the category object for the loaded page.
2514
+	 *
2515
+	 * @access private
2516
+	 * @return void
2517
+	 */
2518
+	private function _set_category_object()
2519
+	{
2520
+		if (isset($this->_category->id) && ! empty($this->_category->id)) {
2521
+			return;
2522
+		} //already have the category object so get out.
2523
+		// set default category object
2524
+		$this->_set_empty_category_object();
2525
+		// only set if we've got an id
2526
+		$category_ID = $this->request->getRequestParam('EVT_CAT_ID', 0, 'int');
2527
+		if (! $category_ID) {
2528
+			return;
2529
+		}
2530
+		$term = get_term($category_ID, EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY);
2531
+		if (! empty($term)) {
2532
+			$this->_category->category_name       = $term->name;
2533
+			$this->_category->category_identifier = $term->slug;
2534
+			$this->_category->category_desc       = $term->description;
2535
+			$this->_category->id                  = $term->term_id;
2536
+			$this->_category->parent              = $term->parent;
2537
+		}
2538
+	}
2539
+
2540
+
2541
+	/**
2542
+	 * Clears out category properties.
2543
+	 */
2544
+	private function _set_empty_category_object()
2545
+	{
2546
+		$this->_category                = new stdClass();
2547
+		$this->_category->category_name = $this->_category->category_identifier = $this->_category->category_desc = '';
2548
+		$this->_category->id            = $this->_category->parent = 0;
2549
+	}
2550
+
2551
+
2552
+	/**
2553
+	 * @throws EE_Error
2554
+	 */
2555
+	protected function _category_list_table()
2556
+	{
2557
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
2558
+		$this->_search_btn_label = esc_html__('Categories', 'event_espresso');
2559
+		$this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
2560
+			'add_category',
2561
+			'add_category',
2562
+			[],
2563
+			'add-new-h2'
2564
+		);
2565
+		$this->display_admin_list_table_page_with_sidebar();
2566
+	}
2567
+
2568
+
2569
+	/**
2570
+	 * Output category details view.
2571
+	 *
2572
+	 * @throws EE_Error
2573
+	 * @throws EE_Error
2574
+	 */
2575
+	protected function _category_details($view)
2576
+	{
2577
+		// load formatter helper
2578
+		// load field generator helper
2579
+		$route = $view == 'edit' ? 'update_category' : 'insert_category';
2580
+		$this->_set_add_edit_form_tags($route);
2581
+		$this->_set_category_object();
2582
+		$id            = ! empty($this->_category->id) ? $this->_category->id : '';
2583
+		$delete_action = 'delete_category';
2584
+		// custom redirect
2585
+		$redirect = EE_Admin_Page::add_query_args_and_nonce(
2586
+			['action' => 'category_list'],
2587
+			$this->_admin_base_url
2588
+		);
2589
+		$this->_set_publish_post_box_vars('EVT_CAT_ID', $id, $delete_action, $redirect);
2590
+		// take care of contents
2591
+		$this->_template_args['admin_page_content'] = $this->_category_details_content();
2592
+		$this->display_admin_page_with_sidebar();
2593
+	}
2594
+
2595
+
2596
+	/**
2597
+	 * Output category details content.
2598
+	 */
2599
+	protected function _category_details_content()
2600
+	{
2601
+		$editor_args['category_desc'] = [
2602
+			'type'          => 'wp_editor',
2603
+			'value'         => EEH_Formatter::admin_format_content($this->_category->category_desc),
2604
+			'class'         => 'my_editor_custom',
2605
+			'wpeditor_args' => ['media_buttons' => false],
2606
+		];
2607
+		$_wp_editor                   = $this->_generate_admin_form_fields($editor_args, 'array');
2608
+		$all_terms                    = get_terms(
2609
+			[EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY],
2610
+			['hide_empty' => 0, 'exclude' => [$this->_category->id]]
2611
+		);
2612
+		// setup category select for term parents.
2613
+		$category_select_values[] = [
2614
+			'text' => esc_html__('No Parent', 'event_espresso'),
2615
+			'id'   => 0,
2616
+		];
2617
+		foreach ($all_terms as $term) {
2618
+			$category_select_values[] = [
2619
+				'text' => $term->name,
2620
+				'id'   => $term->term_id,
2621
+			];
2622
+		}
2623
+		$category_select = EEH_Form_Fields::select_input(
2624
+			'category_parent',
2625
+			$category_select_values,
2626
+			$this->_category->parent
2627
+		);
2628
+		$template_args   = [
2629
+			'category'                 => $this->_category,
2630
+			'category_select'          => $category_select,
2631
+			'unique_id_info_help_link' => $this->_get_help_tab_link('unique_id_info'),
2632
+			'category_desc_editor'     => $_wp_editor['category_desc']['field'],
2633
+			'disable'                  => '',
2634
+			'disabled_message'         => false,
2635
+		];
2636
+		$template        = EVENTS_TEMPLATE_PATH . 'event_category_details.template.php';
2637
+		return EEH_Template::display_template($template, $template_args, true);
2638
+	}
2639
+
2640
+
2641
+	/**
2642
+	 * Handles deleting categories.
2643
+	 *
2644
+	 * @throws EE_Error
2645
+	 */
2646
+	protected function _delete_categories()
2647
+	{
2648
+		$category_IDs = $this->request->getRequestParam('EVT_CAT_ID', 0, 'int', true);
2649
+		foreach ($category_IDs as $category_ID) {
2650
+			$this->_delete_category($category_ID);
2651
+		}
2652
+		// doesn't matter what page we're coming from... we're going to the same place after delete.
2653
+		$query_args = [
2654
+			'action' => 'category_list',
2655
+		];
2656
+		$this->_redirect_after_action(0, '', '', $query_args);
2657
+	}
2658
+
2659
+
2660
+	/**
2661
+	 * Handles deleting specific category.
2662
+	 *
2663
+	 * @param int $cat_id
2664
+	 */
2665
+	protected function _delete_category($cat_id)
2666
+	{
2667
+		$cat_id = absint($cat_id);
2668
+		wp_delete_term($cat_id, EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY);
2669
+	}
2670
+
2671
+
2672
+	/**
2673
+	 * Handles triggering the update or insertion of a new category.
2674
+	 *
2675
+	 * @param bool $new_category true means we're triggering the insert of a new category.
2676
+	 * @throws EE_Error
2677
+	 * @throws EE_Error
2678
+	 */
2679
+	protected function _insert_or_update_category($new_category)
2680
+	{
2681
+		$cat_id  = $new_category ? $this->_insert_category() : $this->_insert_category(true);
2682
+		$success = 0; // we already have a success message so lets not send another.
2683
+		if ($cat_id) {
2684
+			$query_args = [
2685
+				'action'     => 'edit_category',
2686
+				'EVT_CAT_ID' => $cat_id,
2687
+			];
2688
+		} else {
2689
+			$query_args = ['action' => 'add_category'];
2690
+		}
2691
+		$this->_redirect_after_action($success, '', '', $query_args, true);
2692
+	}
2693
+
2694
+
2695
+	/**
2696
+	 * Inserts or updates category
2697
+	 *
2698
+	 * @param bool $update (true indicates we're updating a category).
2699
+	 * @return bool|mixed|string
2700
+	 */
2701
+	private function _insert_category($update = false)
2702
+	{
2703
+		$category_ID         = $update ? $this->request->getRequestParam('EVT_CAT_ID', 0, 'int') : 0;
2704
+		$category_name       = $this->request->getRequestParam('category_name', '');
2705
+		$category_desc       = $this->request->getRequestParam('category_desc', '');
2706
+		$category_parent     = $this->request->getRequestParam('category_parent', 0, 'int');
2707
+		$category_identifier = $this->request->getRequestParam('category_identifier', '');
2708
+
2709
+		if (empty($category_name)) {
2710
+			$msg = esc_html__('You must add a name for the category.', 'event_espresso');
2711
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2712
+			return false;
2713
+		}
2714
+		$term_args = [
2715
+			'name'        => $category_name,
2716
+			'description' => $category_desc,
2717
+			'parent'      => $category_parent,
2718
+		];
2719
+		// was the category_identifier input disabled?
2720
+		if ($category_identifier) {
2721
+			$term_args['slug'] = $category_identifier;
2722
+		}
2723
+		$insert_ids = $update
2724
+			? wp_update_term($category_ID, EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY, $term_args)
2725
+			: wp_insert_term($category_name, EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY, $term_args);
2726
+		if (! is_array($insert_ids)) {
2727
+			$msg = esc_html__(
2728
+				'An error occurred and the category has not been saved to the database.',
2729
+				'event_espresso'
2730
+			);
2731
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2732
+		} else {
2733
+			$category_ID = $insert_ids['term_id'];
2734
+			$msg         =
2735
+				sprintf(esc_html__('The category %s was successfully saved', 'event_espresso'), $category_name);
2736
+			EE_Error::add_success($msg);
2737
+		}
2738
+		return $category_ID;
2739
+	}
2740
+
2741
+
2742
+	/**
2743
+	 * Gets categories or count of categories matching the arguments in the request.
2744
+	 *
2745
+	 * @param int  $per_page
2746
+	 * @param int  $current_page
2747
+	 * @param bool $count
2748
+	 * @return EE_Term_Taxonomy[]|int
2749
+	 * @throws EE_Error
2750
+	 * @throws EE_Error
2751
+	 */
2752
+	public function get_categories($per_page = 10, $current_page = 1, $count = false)
2753
+	{
2754
+		// testing term stuff
2755
+		$orderby     = $this->request->getRequestParam('orderby', 'Term.term_id');
2756
+		$order       = $this->request->getRequestParam('order', 'DESC');
2757
+		$limit       = ($current_page - 1) * $per_page;
2758
+		$where       = ['taxonomy' => EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY];
2759
+		$search_term = $this->request->getRequestParam('s');
2760
+		if ($search_term) {
2761
+			$search_term = '%' . $search_term . '%';
2762
+			$where['OR'] = [
2763
+				'Term.name'   => ['LIKE', $search_term],
2764
+				'description' => ['LIKE', $search_term],
2765
+			];
2766
+		}
2767
+		$query_params = [
2768
+			$where,
2769
+			'order_by'   => [$orderby => $order],
2770
+			'limit'      => $limit . ',' . $per_page,
2771
+			'force_join' => ['Term'],
2772
+		];
2773
+		return $count
2774
+			? EEM_Term_Taxonomy::instance()->count($query_params, 'term_id')
2775
+			: EEM_Term_Taxonomy::instance()->get_all($query_params);
2776
+	}
2777
+
2778
+	/* end category stuff */
2779
+	/**************/
2780
+
2781
+
2782
+	/**
2783
+	 * Callback for the `ee_save_timezone_setting` ajax action.
2784
+	 *
2785
+	 * @throws EE_Error
2786
+	 */
2787
+	public function saveTimezoneString()
2788
+	{
2789
+		$timezone_string = $this->request->getRequestParam('timezone_selected');
2790
+		if (empty($timezone_string) || ! EEH_DTT_Helper::validate_timezone($timezone_string, false)) {
2791
+			EE_Error::add_error(
2792
+				esc_html__('An invalid timezone string submitted.', 'event_espresso'),
2793
+				__FILE__,
2794
+				__FUNCTION__,
2795
+				__LINE__
2796
+			);
2797
+			$this->_template_args['error'] = true;
2798
+			$this->_return_json();
2799
+		}
2800
+
2801
+		update_option('timezone_string', $timezone_string);
2802
+		EE_Error::add_success(
2803
+			esc_html__('Your timezone string was updated.', 'event_espresso')
2804
+		);
2805
+		$this->_template_args['success'] = true;
2806
+		$this->_return_json(true, ['action' => 'create_new']);
2807
+	}
2808
+
2809
+
2810
+	/**
2811
+	 * @throws EE_Error
2812
+	 * @deprecated 4.10.25.p
2813
+	 */
2814
+	public function save_timezonestring_setting()
2815
+	{
2816
+		$this->saveTimezoneString();
2817
+	}
2818 2818
 }
Please login to merge, or discard this patch.
Spacing   +82 added lines, -82 removed lines patch added patch discarded remove patch
@@ -562,11 +562,11 @@  discard block
 block discarded – undo
562 562
     {
563 563
         wp_register_style(
564 564
             'events-admin-css',
565
-            EVENTS_ASSETS_URL . 'events-admin-page.css',
565
+            EVENTS_ASSETS_URL.'events-admin-page.css',
566 566
             [],
567 567
             EVENT_ESPRESSO_VERSION
568 568
         );
569
-        wp_register_style('ee-cat-admin', EVENTS_ASSETS_URL . 'ee-cat-admin.css', [], EVENT_ESPRESSO_VERSION);
569
+        wp_register_style('ee-cat-admin', EVENTS_ASSETS_URL.'ee-cat-admin.css', [], EVENT_ESPRESSO_VERSION);
570 570
         wp_enqueue_style('events-admin-css');
571 571
         wp_enqueue_style('ee-cat-admin');
572 572
         // todo note: we also need to load_scripts_styles per view (i.e. default/view_report/event_details
@@ -574,7 +574,7 @@  discard block
 block discarded – undo
574 574
         // scripts
575 575
         wp_register_script(
576 576
             'event_editor_js',
577
-            EVENTS_ASSETS_URL . 'event_editor.js',
577
+            EVENTS_ASSETS_URL.'event_editor.js',
578 578
             ['ee_admin_js', 'jquery-ui-slider', 'jquery-ui-timepicker-addon'],
579 579
             EVENT_ESPRESSO_VERSION,
580 580
             true
@@ -600,7 +600,7 @@  discard block
 block discarded – undo
600 600
         wp_enqueue_style('espresso-ui-theme');
601 601
         wp_register_style(
602 602
             'event-editor-css',
603
-            EVENTS_ASSETS_URL . 'event-editor.css',
603
+            EVENTS_ASSETS_URL.'event-editor.css',
604 604
             ['ee-admin-css'],
605 605
             EVENT_ESPRESSO_VERSION
606 606
         );
@@ -608,7 +608,7 @@  discard block
 block discarded – undo
608 608
         // scripts
609 609
         wp_register_script(
610 610
             'event-datetime-metabox',
611
-            EVENTS_ASSETS_URL . 'event-datetime-metabox.js',
611
+            EVENTS_ASSETS_URL.'event-datetime-metabox.js',
612 612
             ['event_editor_js', 'ee-datepicker'],
613 613
             EVENT_ESPRESSO_VERSION
614 614
         );
@@ -677,7 +677,7 @@  discard block
 block discarded – undo
677 677
     public function verify_event_edit($event = null, $req_type = '')
678 678
     {
679 679
         // don't need to do this when processing
680
-        if (! empty($req_type)) {
680
+        if ( ! empty($req_type)) {
681 681
             return;
682 682
         }
683 683
         // no event?
@@ -686,7 +686,7 @@  discard block
 block discarded – undo
686 686
             $event = $this->_cpt_model_obj;
687 687
         }
688 688
         // STILL no event?
689
-        if (! $event instanceof EE_Event) {
689
+        if ( ! $event instanceof EE_Event) {
690 690
             return;
691 691
         }
692 692
         $orig_status = $event->status();
@@ -725,7 +725,7 @@  discard block
 block discarded – undo
725 725
             );
726 726
         }
727 727
         // now we need to determine if the event has any tickets on sale.  If not then we dont' show the error
728
-        if (! $event->tickets_on_sale()) {
728
+        if ( ! $event->tickets_on_sale()) {
729 729
             return;
730 730
         }
731 731
         // made it here so show warning
@@ -770,7 +770,7 @@  discard block
 block discarded – undo
770 770
     {
771 771
         $has_timezone_string = get_option('timezone_string');
772 772
         // only nag them about setting their timezone if it's their first event, and they haven't already done it
773
-        if (! $has_timezone_string && ! EEM_Event::instance()->exists([])) {
773
+        if ( ! $has_timezone_string && ! EEM_Event::instance()->exists([])) {
774 774
             EE_Error::add_attention(
775 775
                 sprintf(
776 776
                     esc_html__(
@@ -839,7 +839,7 @@  discard block
 block discarded – undo
839 839
      */
840 840
     protected function _event_legend_items()
841 841
     {
842
-        $items    = [
842
+        $items = [
843 843
             'view_details'   => [
844 844
                 'class' => 'dashicons dashicons-search',
845 845
                 'desc'  => esc_html__('View Event', 'event_espresso'),
@@ -856,31 +856,31 @@  discard block
 block discarded – undo
856 856
         $items    = apply_filters('FHEE__Events_Admin_Page___event_legend_items__items', $items);
857 857
         $statuses = [
858 858
             'sold_out_status'  => [
859
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::sold_out,
859
+                'class' => 'ee-status-legend ee-status-legend-'.EE_Datetime::sold_out,
860 860
                 'desc'  => EEH_Template::pretty_status(EE_Datetime::sold_out, false, 'sentence'),
861 861
             ],
862 862
             'active_status'    => [
863
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::active,
863
+                'class' => 'ee-status-legend ee-status-legend-'.EE_Datetime::active,
864 864
                 'desc'  => EEH_Template::pretty_status(EE_Datetime::active, false, 'sentence'),
865 865
             ],
866 866
             'upcoming_status'  => [
867
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::upcoming,
867
+                'class' => 'ee-status-legend ee-status-legend-'.EE_Datetime::upcoming,
868 868
                 'desc'  => EEH_Template::pretty_status(EE_Datetime::upcoming, false, 'sentence'),
869 869
             ],
870 870
             'postponed_status' => [
871
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::postponed,
871
+                'class' => 'ee-status-legend ee-status-legend-'.EE_Datetime::postponed,
872 872
                 'desc'  => EEH_Template::pretty_status(EE_Datetime::postponed, false, 'sentence'),
873 873
             ],
874 874
             'cancelled_status' => [
875
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::cancelled,
875
+                'class' => 'ee-status-legend ee-status-legend-'.EE_Datetime::cancelled,
876 876
                 'desc'  => EEH_Template::pretty_status(EE_Datetime::cancelled, false, 'sentence'),
877 877
             ],
878 878
             'expired_status'   => [
879
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::expired,
879
+                'class' => 'ee-status-legend ee-status-legend-'.EE_Datetime::expired,
880 880
                 'desc'  => EEH_Template::pretty_status(EE_Datetime::expired, false, 'sentence'),
881 881
             ],
882 882
             'inactive_status'  => [
883
-                'class' => 'ee-status-legend ee-status-legend-' . EE_Datetime::inactive,
883
+                'class' => 'ee-status-legend ee-status-legend-'.EE_Datetime::inactive,
884 884
                 'desc'  => EEH_Template::pretty_status(EE_Datetime::inactive, false, 'sentence'),
885 885
             ],
886 886
         ];
@@ -896,7 +896,7 @@  discard block
 block discarded – undo
896 896
      */
897 897
     private function _event_model()
898 898
     {
899
-        if (! $this->_event_model instanceof EEM_Event) {
899
+        if ( ! $this->_event_model instanceof EEM_Event) {
900 900
             $this->_event_model = EE_Registry::instance()->load_model('Event');
901 901
         }
902 902
         return $this->_event_model;
@@ -916,8 +916,8 @@  discard block
 block discarded – undo
916 916
     public function extra_permalink_field_buttons($return, $id, $new_title, $new_slug)
917 917
     {
918 918
         // make sure this is only when editing
919
-        if (! empty($id)) {
920
-            $post   = get_post($id);
919
+        if ( ! empty($id)) {
920
+            $post = get_post($id);
921 921
             $return .= '<a class="button button-small" onclick="prompt(\'Shortcode:\', jQuery(\'#shortcode\').val()); return false;" href="#"  tabindex="-1">'
922 922
                        . esc_html__('Shortcode', 'event_espresso')
923 923
                        . '</a> ';
@@ -940,7 +940,7 @@  discard block
 block discarded – undo
940 940
     protected function _events_overview_list_table()
941 941
     {
942 942
         do_action('AHEE_log', __FILE__, __FUNCTION__, '');
943
-        $this->_template_args['after_list_table']                           =
943
+        $this->_template_args['after_list_table'] =
944 944
             ! empty($this->_template_args['after_list_table'])
945 945
                 ? (array) $this->_template_args['after_list_table']
946 946
                 : [];
@@ -950,10 +950,10 @@  discard block
 block discarded – undo
950 950
                 esc_html__("View Event Archive Page", "event_espresso"),
951 951
                 'button'
952 952
             );
953
-        $this->_template_args['after_list_table']['legend']                 = $this->_display_legend(
953
+        $this->_template_args['after_list_table']['legend'] = $this->_display_legend(
954 954
             $this->_event_legend_items()
955 955
         );
956
-        $this->_admin_page_title                                            .= ' ' . $this->get_action_link_or_button(
956
+        $this->_admin_page_title .= ' '.$this->get_action_link_or_button(
957 957
             'create_new',
958 958
             'add',
959 959
             [],
@@ -1049,7 +1049,7 @@  discard block
 block discarded – undo
1049 1049
                 [$this, '_default_tickets_update'],
1050 1050
             ]
1051 1051
         );
1052
-        $att_success            = true;
1052
+        $att_success = true;
1053 1053
         foreach ($event_update_callbacks as $e_callback) {
1054 1054
             $_success = is_callable($e_callback)
1055 1055
                 ? call_user_func($e_callback, $event, $this->request->requestParams())
@@ -1111,7 +1111,7 @@  discard block
 block discarded – undo
1111 1111
      */
1112 1112
     protected function _default_venue_update(EE_Event $event, $data)
1113 1113
     {
1114
-        require_once(EE_MODELS . 'EEM_Venue.model.php');
1114
+        require_once(EE_MODELS.'EEM_Venue.model.php');
1115 1115
         $venue_model = EE_Registry::instance()->load_model('Venue');
1116 1116
         $venue_id    = ! empty($data['venue_id']) ? $data['venue_id'] : null;
1117 1117
         // very important.  If we don't have a venue name...
@@ -1142,7 +1142,7 @@  discard block
 block discarded – undo
1142 1142
             'status'              => 'publish',
1143 1143
         ];
1144 1144
         // if we've got the venue_id then we're just updating the existing venue so let's do that and then get out.
1145
-        if (! empty($venue_id)) {
1145
+        if ( ! empty($venue_id)) {
1146 1146
             $update_where  = [$venue_model->primary_key_name() => $venue_id];
1147 1147
             $rows_affected = $venue_model->update($venue_array, [$update_where]);
1148 1148
             // we've gotta make sure that the venue is always attached to a revision.. add_relation_to should take care of making sure that the relation is already present.
@@ -1180,7 +1180,7 @@  discard block
 block discarded – undo
1180 1180
                 isset($datetime_data['DTT_EVT_end']) && ! empty($datetime_data['DTT_EVT_end'])
1181 1181
                     ? $datetime_data['DTT_EVT_end']
1182 1182
                     : $datetime_data['DTT_EVT_start'];
1183
-            $datetime_values              = [
1183
+            $datetime_values = [
1184 1184
                 'DTT_ID'        => ! empty($datetime_data['DTT_ID']) ? $datetime_data['DTT_ID'] : null,
1185 1185
                 'DTT_EVT_start' => $datetime_data['DTT_EVT_start'],
1186 1186
                 'DTT_EVT_end'   => $datetime_data['DTT_EVT_end'],
@@ -1189,9 +1189,9 @@  discard block
 block discarded – undo
1189 1189
             ];
1190 1190
             // if we have an id then let's get existing object first and then set the new values.
1191 1191
             //  Otherwise we instantiate a new object for save.
1192
-            if (! empty($datetime_data['DTT_ID'])) {
1192
+            if ( ! empty($datetime_data['DTT_ID'])) {
1193 1193
                 $datetime = EEM_Datetime::instance($event_timezone)->get_one_by_ID($datetime_data['DTT_ID']);
1194
-                if (! $datetime instanceof EE_Datetime) {
1194
+                if ( ! $datetime instanceof EE_Datetime) {
1195 1195
                     throw new RuntimeException(
1196 1196
                         sprintf(
1197 1197
                             esc_html__(
@@ -1210,7 +1210,7 @@  discard block
 block discarded – undo
1210 1210
             } else {
1211 1211
                 $datetime = EE_Datetime::new_instance($datetime_values, $event_timezone, $date_formats);
1212 1212
             }
1213
-            if (! $datetime instanceof EE_Datetime) {
1213
+            if ( ! $datetime instanceof EE_Datetime) {
1214 1214
                 throw new RuntimeException(
1215 1215
                     sprintf(
1216 1216
                         esc_html__(
@@ -1236,7 +1236,7 @@  discard block
 block discarded – undo
1236 1236
 
1237 1237
         // set up some default start and end dates in case those are not present in the incoming data
1238 1238
         $default_start_date = new DateTime('now', new DateTimeZone($event->get_timezone()));
1239
-        $default_start_date = $default_start_date->format($date_formats[0] . ' ' . $date_formats[1]);
1239
+        $default_start_date = $default_start_date->format($date_formats[0].' '.$date_formats[1]);
1240 1240
         // use the start date of the first datetime for the end date
1241 1241
         $first_datetime   = $event->first_datetime();
1242 1242
         $default_end_date = $first_datetime->start_date_and_time($date_formats[0], $date_formats[1]);
@@ -1244,8 +1244,8 @@  discard block
 block discarded – undo
1244 1244
         // now process the incoming data
1245 1245
         foreach ($data['edit_tickets'] as $row => $ticket_data) {
1246 1246
             $update_prices = false;
1247
-            $ticket_price  = isset($data['edit_prices'][ $row ][1]['PRC_amount'])
1248
-                ? $data['edit_prices'][ $row ][1]['PRC_amount']
1247
+            $ticket_price  = isset($data['edit_prices'][$row][1]['PRC_amount'])
1248
+                ? $data['edit_prices'][$row][1]['PRC_amount']
1249 1249
                 : 0;
1250 1250
             // trim inputs to ensure any excess whitespace is removed.
1251 1251
             $ticket_data   = array_map('trim', $ticket_data);
@@ -1286,9 +1286,9 @@  discard block
 block discarded – undo
1286 1286
             // ticket didn't get removed or added to any datetime in the session but DID have it's items modified.
1287 1287
             // keep in mind that if the ticket has been sold (and we have changed pricing information),
1288 1288
             // then we won't be updating the tkt but instead a new tkt will be created and the old one archived.
1289
-            if (! empty($ticket_data['TKT_ID'])) {
1289
+            if ( ! empty($ticket_data['TKT_ID'])) {
1290 1290
                 $existing_ticket = EEM_Ticket::instance($event_timezone)->get_one_by_ID($ticket_data['TKT_ID']);
1291
-                if (! $existing_ticket instanceof EE_Ticket) {
1291
+                if ( ! $existing_ticket instanceof EE_Ticket) {
1292 1292
                     throw new RuntimeException(
1293 1293
                         sprintf(
1294 1294
                             esc_html__(
@@ -1337,7 +1337,7 @@  discard block
 block discarded – undo
1337 1337
                     $existing_ticket->save();
1338 1338
                     // make sure this ticket is still recorded in our $saved_tickets
1339 1339
                     // so we don't run it through the regular trash routine.
1340
-                    $saved_tickets[ $existing_ticket->ID() ] = $existing_ticket;
1340
+                    $saved_tickets[$existing_ticket->ID()] = $existing_ticket;
1341 1341
                     // create new ticket that's a copy of the existing except,
1342 1342
                     // (a new id of course and not archived) AND has the new TKT_price associated with it.
1343 1343
                     $new_ticket = clone $existing_ticket;
@@ -1354,7 +1354,7 @@  discard block
 block discarded – undo
1354 1354
                 $ticket                     = EE_Ticket::new_instance($ticket_values, $event_timezone, $date_formats);
1355 1355
                 $update_prices              = true;
1356 1356
             }
1357
-            if (! $ticket instanceof EE_Ticket) {
1357
+            if ( ! $ticket instanceof EE_Ticket) {
1358 1358
                 throw new RuntimeException(
1359 1359
                     sprintf(
1360 1360
                         esc_html__(
@@ -1378,10 +1378,10 @@  discard block
 block discarded – undo
1378 1378
             }
1379 1379
             // initially let's add the ticket to the datetime
1380 1380
             $datetime->_add_relation_to($ticket, 'Ticket');
1381
-            $saved_tickets[ $ticket->ID() ] = $ticket;
1381
+            $saved_tickets[$ticket->ID()] = $ticket;
1382 1382
             // add prices to ticket
1383
-            $prices_data = isset($data['edit_prices'][ $row ]) && is_array($data['edit_prices'][ $row ])
1384
-                ? $data['edit_prices'][ $row ]
1383
+            $prices_data = isset($data['edit_prices'][$row]) && is_array($data['edit_prices'][$row])
1384
+                ? $data['edit_prices'][$row]
1385 1385
                 : [];
1386 1386
             $this->_add_prices_to_ticket($prices_data, $ticket, $update_prices);
1387 1387
         }
@@ -1395,7 +1395,7 @@  discard block
 block discarded – undo
1395 1395
             $id = absint($id);
1396 1396
             // get the ticket for this id
1397 1397
             $ticket_to_remove = EEM_Ticket::instance()->get_one_by_ID($id);
1398
-            if (! $ticket_to_remove instanceof EE_Ticket) {
1398
+            if ( ! $ticket_to_remove instanceof EE_Ticket) {
1399 1399
                 continue;
1400 1400
             }
1401 1401
             // need to get all the related datetimes on this ticket and remove from every single one of them
@@ -1452,7 +1452,7 @@  discard block
 block discarded – undo
1452 1452
                     $price->set($field, $new_price);
1453 1453
                 }
1454 1454
             }
1455
-            if (! $price instanceof EE_Price) {
1455
+            if ( ! $price instanceof EE_Price) {
1456 1456
                 throw new RuntimeException(
1457 1457
                     sprintf(
1458 1458
                         esc_html__(
@@ -1495,13 +1495,13 @@  discard block
 block discarded – undo
1495 1495
     {
1496 1496
         // load formatter helper
1497 1497
         // args for getting related registrations
1498
-        $approved_query_args        = [
1498
+        $approved_query_args = [
1499 1499
             [
1500 1500
                 'REG_deleted' => 0,
1501 1501
                 'STS_ID'      => EEM_Registration::status_id_approved,
1502 1502
             ],
1503 1503
         ];
1504
-        $not_approved_query_args    = [
1504
+        $not_approved_query_args = [
1505 1505
             [
1506 1506
                 'REG_deleted' => 0,
1507 1507
                 'STS_ID'      => EEM_Registration::status_id_not_approved,
@@ -1564,7 +1564,7 @@  discard block
 block discarded – undo
1564 1564
         $publish_box_extra_args['event_editor_overview_add'] = ob_get_clean();
1565 1565
         // load template
1566 1566
         EEH_Template::display_template(
1567
-            EVENTS_TEMPLATE_PATH . 'event_publish_box_extras.template.php',
1567
+            EVENTS_TEMPLATE_PATH.'event_publish_box_extras.template.php',
1568 1568
             $publish_box_extra_args
1569 1569
         );
1570 1570
     }
@@ -1636,7 +1636,7 @@  discard block
 block discarded – undo
1636 1636
             'trash_icon'               => 'ee-lock-icon',
1637 1637
             'disabled'                 => '',
1638 1638
         ];
1639
-        $event_id      = is_object($this->_cpt_model_obj) ? $this->_cpt_model_obj->ID() : null;
1639
+        $event_id = is_object($this->_cpt_model_obj) ? $this->_cpt_model_obj->ID() : null;
1640 1640
         /**
1641 1641
          * 1. Start with retrieving Datetimes
1642 1642
          * 2. Fore each datetime get related tickets
@@ -1657,18 +1657,18 @@  discard block
 block discarded – undo
1657 1657
                     'default_where_conditions' => 'none',
1658 1658
                 ]
1659 1659
             );
1660
-            if (! empty($related_tickets)) {
1660
+            if ( ! empty($related_tickets)) {
1661 1661
                 $template_args['total_ticket_rows'] = count($related_tickets);
1662 1662
                 $row                                = 0;
1663 1663
                 foreach ($related_tickets as $ticket) {
1664
-                    $existing_ticket_ids[]        = $ticket->get('TKT_ID');
1664
+                    $existing_ticket_ids[] = $ticket->get('TKT_ID');
1665 1665
                     $template_args['ticket_rows'] .= $this->_get_ticket_row($ticket, false, $row);
1666 1666
                     $row++;
1667 1667
                 }
1668 1668
             } else {
1669 1669
                 $template_args['total_ticket_rows'] = 1;
1670 1670
                 /** @type EE_Ticket $ticket */
1671
-                $ticket                       = EEM_Ticket::instance()->create_default_object();
1671
+                $ticket = EEM_Ticket::instance()->create_default_object();
1672 1672
                 $template_args['ticket_rows'] .= $this->_get_ticket_row($ticket);
1673 1673
             }
1674 1674
         } else {
@@ -1688,9 +1688,9 @@  discard block
 block discarded – undo
1688 1688
             EEM_Ticket::instance()->create_default_object(),
1689 1689
             true
1690 1690
         );
1691
-        $template                                  = apply_filters(
1691
+        $template = apply_filters(
1692 1692
             'FHEE__Events_Admin_Page__ticket_metabox__template',
1693
-            EVENTS_TEMPLATE_PATH . 'event_tickets_metabox_main.template.php'
1693
+            EVENTS_TEMPLATE_PATH.'event_tickets_metabox_main.template.php'
1694 1694
         );
1695 1695
         EEH_Template::display_template($template, $template_args);
1696 1696
     }
@@ -1710,7 +1710,7 @@  discard block
 block discarded – undo
1710 1710
     private function _get_ticket_row($ticket, $skeleton = false, $row = 0)
1711 1711
     {
1712 1712
         $template_args = [
1713
-            'tkt_status_class'    => ' tkt-status-' . $ticket->ticket_status(),
1713
+            'tkt_status_class'    => ' tkt-status-'.$ticket->ticket_status(),
1714 1714
             'tkt_archive_class'   => $ticket->ticket_status() === EE_Ticket::archived && ! $skeleton ? ' tkt-archived'
1715 1715
                 : '',
1716 1716
             'ticketrow'           => $skeleton ? 'TICKETNUM' : $row,
@@ -1722,10 +1722,10 @@  discard block
 block discarded – undo
1722 1722
             'TKT_qty'             => $ticket->get_pretty('TKT_qty', 'input'),
1723 1723
             'edit_ticketrow_name' => $skeleton ? 'TICKETNAMEATTR' : 'edit_tickets',
1724 1724
             'TKT_sold'            => $skeleton ? 0 : $ticket->get('TKT_sold'),
1725
-            'trash_icon'          => ($skeleton || (! empty($ticket) && ! $ticket->get('TKT_deleted')))
1726
-                                     && (! empty($ticket) && $ticket->get('TKT_sold') === 0)
1725
+            'trash_icon'          => ($skeleton || ( ! empty($ticket) && ! $ticket->get('TKT_deleted')))
1726
+                                     && ( ! empty($ticket) && $ticket->get('TKT_sold') === 0)
1727 1727
                 ? 'trash-icon dashicons dashicons-post-trash clickable' : 'ee-lock-icon',
1728
-            'disabled'            => $skeleton || (! empty($ticket) && ! $ticket->get('TKT_deleted')) ? ''
1728
+            'disabled'            => $skeleton || ( ! empty($ticket) && ! $ticket->get('TKT_deleted')) ? ''
1729 1729
                 : ' disabled=disabled',
1730 1730
         ];
1731 1731
         $price         = $ticket->ID() !== 0
@@ -1749,7 +1749,7 @@  discard block
 block discarded – undo
1749 1749
         }
1750 1750
         if (empty($template_args['TKT_end_date'])) {
1751 1751
             // get the earliest datetime (if present);
1752
-            $earliest_datetime             = $this->_cpt_model_obj->ID() > 0
1752
+            $earliest_datetime = $this->_cpt_model_obj->ID() > 0
1753 1753
                 ? $this->_cpt_model_obj->get_first_related(
1754 1754
                     'Datetime',
1755 1755
                     ['order_by' => ['DTT_EVT_start' => 'ASC']]
@@ -1762,7 +1762,7 @@  discard block
 block discarded – undo
1762 1762
         $template_args = array_merge($template_args, $price_args);
1763 1763
         $template      = apply_filters(
1764 1764
             'FHEE__Events_Admin_Page__get_ticket_row__template',
1765
-            EVENTS_TEMPLATE_PATH . 'event_tickets_metabox_ticket_row.template.php',
1765
+            EVENTS_TEMPLATE_PATH.'event_tickets_metabox_ticket_row.template.php',
1766 1766
             $ticket
1767 1767
         );
1768 1768
         return EEH_Template::display_template($template, $template_args, true);
@@ -1775,7 +1775,7 @@  discard block
 block discarded – undo
1775 1775
      */
1776 1776
     public function registration_options_meta_box()
1777 1777
     {
1778
-        $yes_no_values             = [
1778
+        $yes_no_values = [
1779 1779
             ['id' => true, 'text' => esc_html__('Yes', 'event_espresso')],
1780 1780
             ['id' => false, 'text' => esc_html__('No', 'event_espresso')],
1781 1781
         ];
@@ -1797,12 +1797,12 @@  discard block
 block discarded – undo
1797 1797
             $default_reg_status_values,
1798 1798
             $this->_cpt_model_obj->default_registration_status()
1799 1799
         );
1800
-        $template_args['display_description']             = EEH_Form_Fields::select_input(
1800
+        $template_args['display_description'] = EEH_Form_Fields::select_input(
1801 1801
             'display_desc',
1802 1802
             $yes_no_values,
1803 1803
             $this->_cpt_model_obj->display_description()
1804 1804
         );
1805
-        $template_args['display_ticket_selector']         = EEH_Form_Fields::select_input(
1805
+        $template_args['display_ticket_selector'] = EEH_Form_Fields::select_input(
1806 1806
             'display_ticket_selector',
1807 1807
             $yes_no_values,
1808 1808
             $this->_cpt_model_obj->display_ticket_selector(),
@@ -1818,7 +1818,7 @@  discard block
 block discarded – undo
1818 1818
             $default_reg_status_values
1819 1819
         );
1820 1820
         EEH_Template::display_template(
1821
-            EVENTS_TEMPLATE_PATH . 'event_registration_options.template.php',
1821
+            EVENTS_TEMPLATE_PATH.'event_registration_options.template.php',
1822 1822
             $template_args
1823 1823
         );
1824 1824
     }
@@ -1841,7 +1841,7 @@  discard block
 block discarded – undo
1841 1841
     {
1842 1842
         $EEM_Event   = $this->_event_model();
1843 1843
         $offset      = ($current_page - 1) * $per_page;
1844
-        $limit       = $count ? null : $offset . ',' . $per_page;
1844
+        $limit       = $count ? null : $offset.','.$per_page;
1845 1845
         $orderby     = $this->request->getRequestParam('orderby', 'EVT_ID');
1846 1846
         $order       = $this->request->getRequestParam('order', 'DESC');
1847 1847
         $month_range = $this->request->getRequestParam('month_range');
@@ -1878,10 +1878,10 @@  discard block
 block discarded – undo
1878 1878
         $start_formats = EEM_Datetime::instance()->get_formats_for('DTT_EVT_start');
1879 1879
         if ($month_range) {
1880 1880
             $DateTime = new DateTime(
1881
-                $year_r . '-' . $month_r . '-01 00:00:00',
1881
+                $year_r.'-'.$month_r.'-01 00:00:00',
1882 1882
                 new DateTimeZone('UTC')
1883 1883
             );
1884
-            $start    = $DateTime->getTimestamp();
1884
+            $start = $DateTime->getTimestamp();
1885 1885
             // set the datetime to be the end of the month
1886 1886
             $DateTime->setDate(
1887 1887
                 $year_r,
@@ -1906,11 +1906,11 @@  discard block
 block discarded – undo
1906 1906
                                                         ->format(implode(' ', $start_formats));
1907 1907
             $where['Datetime.DTT_EVT_start'] = ['BETWEEN', [$start, $end]];
1908 1908
         }
1909
-        if (! EE_Registry::instance()->CAP->current_user_can('ee_read_others_events', 'get_events')) {
1909
+        if ( ! EE_Registry::instance()->CAP->current_user_can('ee_read_others_events', 'get_events')) {
1910 1910
             $where['EVT_wp_user'] = get_current_user_id();
1911 1911
         } else {
1912
-            if (! isset($where['status'])) {
1913
-                if (! EE_Registry::instance()->CAP->current_user_can('ee_read_private_events', 'get_events')) {
1912
+            if ( ! isset($where['status'])) {
1913
+                if ( ! EE_Registry::instance()->CAP->current_user_can('ee_read_private_events', 'get_events')) {
1914 1914
                     $where['OR'] = [
1915 1915
                         'status*restrict_private' => ['!=', 'private'],
1916 1916
                         'AND'                     => [
@@ -1932,7 +1932,7 @@  discard block
 block discarded – undo
1932 1932
         // search query handling
1933 1933
         $search_term = $this->request->getRequestParam('s');
1934 1934
         if ($search_term) {
1935
-            $search_term = '%' . $search_term . '%';
1935
+            $search_term = '%'.$search_term.'%';
1936 1936
             $where['OR'] = [
1937 1937
                 'EVT_name'       => ['LIKE', $search_term],
1938 1938
                 'EVT_desc'       => ['LIKE', $search_term],
@@ -2040,7 +2040,7 @@  discard block
 block discarded – undo
2040 2040
             // clean status
2041 2041
             $event_status = sanitize_key($event_status);
2042 2042
             // grab status
2043
-            if (! empty($event_status)) {
2043
+            if ( ! empty($event_status)) {
2044 2044
                 $success = $this->_change_event_status($EVT_ID, $event_status);
2045 2045
             } else {
2046 2046
                 $success = false;
@@ -2080,7 +2080,7 @@  discard block
 block discarded – undo
2080 2080
         // clean status
2081 2081
         $event_status = sanitize_key($event_status);
2082 2082
         // grab status
2083
-        if (! empty($event_status)) {
2083
+        if ( ! empty($event_status)) {
2084 2084
             $success = true;
2085 2085
             // determine the event id and set to array.
2086 2086
             $EVT_IDs = $this->request->getRequestParam('EVT_IDs', [], 'int', true);
@@ -2126,7 +2126,7 @@  discard block
 block discarded – undo
2126 2126
     private function _change_event_status($EVT_ID = 0, $event_status = '')
2127 2127
     {
2128 2128
         // grab event id
2129
-        if (! $EVT_ID) {
2129
+        if ( ! $EVT_ID) {
2130 2130
             $msg = esc_html__(
2131 2131
                 'An error occurred. No Event ID or an invalid Event ID was received.',
2132 2132
                 'event_espresso'
@@ -2163,7 +2163,7 @@  discard block
 block discarded – undo
2163 2163
         // use class to change status
2164 2164
         $this->_cpt_model_obj->set_status($event_status);
2165 2165
         $success = $this->_cpt_model_obj->save();
2166
-        if (! $success) {
2166
+        if ( ! $success) {
2167 2167
             $msg = sprintf(esc_html__('An error occurred. The event could not be %s.', 'event_espresso'), $action);
2168 2168
             EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
2169 2169
             return false;
@@ -2221,7 +2221,7 @@  discard block
 block discarded – undo
2221 2221
      */
2222 2222
     protected function getModelObjNodeGroupPersister()
2223 2223
     {
2224
-        if (! $this->model_obj_node_group_persister instanceof NodeGroupDao) {
2224
+        if ( ! $this->model_obj_node_group_persister instanceof NodeGroupDao) {
2225 2225
             $this->model_obj_node_group_persister =
2226 2226
                 $this->getLoader()->load('\EventEspresso\core\services\orm\tree_traversal\NodeGroupDao');
2227 2227
         }
@@ -2503,7 +2503,7 @@  discard block
 block discarded – undo
2503 2503
                                                 . esc_html__(
2504 2504
                                                     'Template Settings is a feature that is only available in the premium version of Event Espresso 4 which is available with a support license purchase on EventEspresso.com. Template Settings allow you to configure some of the appearance options for both the Event List and Event Details pages.',
2505 2505
                                                     'event_espresso'
2506
-                                                ) . '</strong>';
2506
+                                                ).'</strong>';
2507 2507
         $this->display_admin_caf_preview_page('template_settings_tab');
2508 2508
     }
2509 2509
 
@@ -2524,11 +2524,11 @@  discard block
 block discarded – undo
2524 2524
         $this->_set_empty_category_object();
2525 2525
         // only set if we've got an id
2526 2526
         $category_ID = $this->request->getRequestParam('EVT_CAT_ID', 0, 'int');
2527
-        if (! $category_ID) {
2527
+        if ( ! $category_ID) {
2528 2528
             return;
2529 2529
         }
2530 2530
         $term = get_term($category_ID, EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY);
2531
-        if (! empty($term)) {
2531
+        if ( ! empty($term)) {
2532 2532
             $this->_category->category_name       = $term->name;
2533 2533
             $this->_category->category_identifier = $term->slug;
2534 2534
             $this->_category->category_desc       = $term->description;
@@ -2556,7 +2556,7 @@  discard block
 block discarded – undo
2556 2556
     {
2557 2557
         do_action('AHEE_log', __FILE__, __FUNCTION__, '');
2558 2558
         $this->_search_btn_label = esc_html__('Categories', 'event_espresso');
2559
-        $this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
2559
+        $this->_admin_page_title .= ' '.$this->get_action_link_or_button(
2560 2560
             'add_category',
2561 2561
             'add_category',
2562 2562
             [],
@@ -2625,7 +2625,7 @@  discard block
 block discarded – undo
2625 2625
             $category_select_values,
2626 2626
             $this->_category->parent
2627 2627
         );
2628
-        $template_args   = [
2628
+        $template_args = [
2629 2629
             'category'                 => $this->_category,
2630 2630
             'category_select'          => $category_select,
2631 2631
             'unique_id_info_help_link' => $this->_get_help_tab_link('unique_id_info'),
@@ -2633,7 +2633,7 @@  discard block
 block discarded – undo
2633 2633
             'disable'                  => '',
2634 2634
             'disabled_message'         => false,
2635 2635
         ];
2636
-        $template        = EVENTS_TEMPLATE_PATH . 'event_category_details.template.php';
2636
+        $template = EVENTS_TEMPLATE_PATH.'event_category_details.template.php';
2637 2637
         return EEH_Template::display_template($template, $template_args, true);
2638 2638
     }
2639 2639
 
@@ -2723,7 +2723,7 @@  discard block
 block discarded – undo
2723 2723
         $insert_ids = $update
2724 2724
             ? wp_update_term($category_ID, EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY, $term_args)
2725 2725
             : wp_insert_term($category_name, EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY, $term_args);
2726
-        if (! is_array($insert_ids)) {
2726
+        if ( ! is_array($insert_ids)) {
2727 2727
             $msg = esc_html__(
2728 2728
                 'An error occurred and the category has not been saved to the database.',
2729 2729
                 'event_espresso'
@@ -2758,7 +2758,7 @@  discard block
 block discarded – undo
2758 2758
         $where       = ['taxonomy' => EEM_CPT_Base::EVENT_CATEGORY_TAXONOMY];
2759 2759
         $search_term = $this->request->getRequestParam('s');
2760 2760
         if ($search_term) {
2761
-            $search_term = '%' . $search_term . '%';
2761
+            $search_term = '%'.$search_term.'%';
2762 2762
             $where['OR'] = [
2763 2763
                 'Term.name'   => ['LIKE', $search_term],
2764 2764
                 'description' => ['LIKE', $search_term],
@@ -2767,7 +2767,7 @@  discard block
 block discarded – undo
2767 2767
         $query_params = [
2768 2768
             $where,
2769 2769
             'order_by'   => [$orderby => $order],
2770
-            'limit'      => $limit . ',' . $per_page,
2770
+            'limit'      => $limit.','.$per_page,
2771 2771
             'force_join' => ['Term'],
2772 2772
         ];
2773 2773
         return $count
Please login to merge, or discard this patch.