eventespresso / event-espresso-core

admin_pages/registrations/Registrations_Admin_Page.core.php

Indentation +3844 added lines, -3844 removed lines

@@ -25,2286 +25,2286 @@ 
  */
 class Registrations_Admin_Page extends EE_Admin_Page_CPT
 {
-    private ?EE_Registration $_registration = null;
-
-    private ?EE_Event $_reg_event = null;
-
-    private array $session_data = [];
-
-    private static array $_reg_status = [];
-
-    /**
-     * Form for displaying the custom questions for this registration.
-     * This gets used a few times throughout the request so it's best to cache it
-     */
-    protected ?EE_Registration_Custom_Questions_Form $_reg_custom_questions_form = null;
-
-    private ?EEM_Registration $registration_model = null;
-
-    private ?EEM_Attendee $attendee_model = null;
-
-    private ?EEM_Event $event_model = null;
-
-    private ?EEM_Status $status_model = null;
-
-    /**
-     * @var EE_Attendee|null
-     */
-    protected $_cpt_model_obj;
-
-
-    /**
-     * @param bool $routing
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    public function __construct($routing = true)
-    {
-        parent::__construct($routing);
-        $this->cpt_editpost_route = 'edit_attendee';
-        add_action('wp_loaded', [$this, 'wp_loaded']);
-    }
-
-
-    /**
-     * @return EEM_Registration
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @since 4.10.2.p
-     */
-    protected function getRegistrationModel(): EEM_Registration
-    {
-        if (! $this->registration_model instanceof EEM_Registration) {
-            $this->registration_model = $this->loader->getShared('EEM_Registration');
-        }
-        return $this->registration_model;
-    }
-
-
-    /**
-     * @return EEM_Attendee
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @since 4.10.2.p
-     */
-    protected function getAttendeeModel(): EEM_Attendee
-    {
-        if (! $this->attendee_model instanceof EEM_Attendee) {
-            $this->attendee_model = $this->loader->getShared('EEM_Attendee');
-        }
-        return $this->attendee_model;
-    }
-
-
-    /**
-     * @return EEM_Event
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @since 4.10.2.p
-     */
-    protected function getEventModel(): EEM_Event
-    {
-        if (! $this->event_model instanceof EEM_Event) {
-            $this->event_model = $this->loader->getShared('EEM_Event');
-        }
-        return $this->event_model;
-    }
-
-
-    /**
-     * @return EEM_Status
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @since 4.10.2.p
-     */
-    protected function getStatusModel(): EEM_Status
-    {
-        if (! $this->status_model instanceof EEM_Status) {
-            $this->status_model = $this->loader->getShared('EEM_Status');
-        }
-        return $this->status_model;
-    }
-
-
-    public function wp_loaded()
-    {
-        // when adding a new registration...
-        $action = $this->request->getRequestParam('action');
-        if ($action === 'new_registration') {
-            EE_System::do_not_cache();
-            if ($this->request->getRequestParam('processing_registration', 0, 'int') !== 1) {
-                // and it's NOT the attendee information reg step
-                // force cookie expiration by setting time to last week
-                setcookie('ee_registration_added', 0, time() - WEEK_IN_SECONDS, '/');
-                // and update the global
-                $_COOKIE['ee_registration_added'] = 0;
-            }
-        }
-    }
-
-
-    protected function _init_page_props()
-    {
-        $this->page_slug        = REG_PG_SLUG;
-        $this->_admin_base_url  = REG_ADMIN_URL;
-        $this->_admin_base_path = REG_ADMIN;
-        $this->page_label       = esc_html__('Registrations', 'event_espresso');
-        $this->_cpt_routes      = [
-            'add_new_attendee' => 'espresso_attendees',
-            'edit_attendee'    => 'espresso_attendees',
-            'insert_attendee'  => 'espresso_attendees',
-            'update_attendee'  => 'espresso_attendees',
-        ];
-        $this->_cpt_model_names = [
-            'add_new_attendee' => 'EEM_Attendee',
-            'edit_attendee'    => 'EEM_Attendee',
-        ];
-        $this->_cpt_edit_routes = [
-            'espresso_attendees' => 'edit_attendee',
-        ];
-        $this->_pagenow_map     = [
-            'add_new_attendee' => 'post-new.php',
-            'edit_attendee'    => 'post.php',
-            'trash'            => 'post.php',
-        ];
-        add_action('edit_form_after_title', [$this, 'after_title_form_fields']);
-        // add filters so that the comment urls don't take users to a confusing 404 page
-        add_filter('get_comment_link', [$this, 'clear_comment_link'], 10, 2);
-    }
-
-
-    /**
-     * @param string     $link    The comment permalink with '#comment-$id' appended.
-     * @param WP_Comment $comment The current comment object.
-     * @return string
-     */
-    public function clear_comment_link(string $link, WP_Comment $comment): string
-    {
-        // gotta make sure this only happens on this route
-        $post_type = get_post_type($comment->comment_post_ID);
-        if ($post_type === EspressoPostType::ATTENDEES) {
-            return '#commentsdiv';
-        }
-        return $link;
-    }
-
-
-    protected function _ajax_hooks()
-    {
-    }
-
-
-    protected function _define_page_props()
-    {
-        $this->_admin_page_title = $this->page_label;
-        $this->_labels           = [
-            'buttons'                      => [
-                'add-registrant'      => esc_html__('Add New Registration', 'event_espresso'),
-                'add-attendee'        => esc_html__('Add Contact', 'event_espresso'),
-                'edit'                => esc_html__('Edit Contact', 'event_espresso'),
-                'csv_reg_report'      => esc_html__('Registrations CSV Report', 'event_espresso'),
-                'contact_list_report' => esc_html__('Contact List Report', 'event_espresso'),
-                'contact_list_export' => esc_html__('Export Data', 'event_espresso'),
-            ],
-            'publishbox'                   => [
-                'add_new_attendee' => esc_html__('Add Contact Record', 'event_espresso'),
-                'edit_attendee'    => esc_html__('Update Contact Record', 'event_espresso'),
-            ],
-            'hide_add_button_on_cpt_route' => [
-                'edit_attendee' => true,
-            ],
-        ];
-    }
-
-
-    /**
-     * grab url requests and route them
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function _set_page_routes()
-    {
-        $this->_get_registration_status_array();
-        $REG_ID             = $this->request->getRequestParam('_REG_ID', 0, 'int');
-        $REG_ID             = $this->request->getRequestParam('reg_status_change_form[REG_ID]', $REG_ID, 'int');
-        $ATT_ID             = $this->request->getRequestParam('ATT_ID', 0, 'int');
-        $ATT_ID             = $this->request->getRequestParam('post', $ATT_ID, 'int');
-        $this->_page_routes = [
-            'default'                             => [
-                'func'       => [$this, '_registrations_overview_list_table'],
-                'capability' => 'ee_read_registrations',
-            ],
-            'view_registration'                   => [
-                'func'       => [$this, '_registration_details'],
-                'capability' => 'ee_read_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'edit_registration'                   => [
-                'func'       => [$this, '_update_attendee_registration_form'],
-                'noheader'           => true,
-                'headers_sent_route' => 'view_registration',
-                'capability'         => 'ee_edit_registration',
-                'obj_id'             => $REG_ID,
-                '_REG_ID'            => $REG_ID,
-            ],
-            'trash_registrations'                 => [
-                'func'       => [$this, '_trash_or_restore_registrations'],
-                'args'       => ['trash' => true],
-                'noheader'   => true,
-                'capability' => 'ee_delete_registrations',
-            ],
-            'restore_registrations'               => [
-                'func'       => [$this, '_trash_or_restore_registrations'],
-                'args'       => ['trash' => false],
-                'noheader'   => true,
-                'capability' => 'ee_delete_registrations',
-            ],
-            'delete_registrations'                => [
-                'func'       => [$this, '_delete_registrations'],
-                'noheader'   => true,
-                'capability' => 'ee_delete_registrations',
-            ],
-            'new_registration'                    => [
-                'func'       => [$this, 'new_registration'],
-                'capability' => 'ee_edit_registrations',
-            ],
-            'process_reg_step'                    => [
-                'func'       => [$this, 'process_reg_step'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-            ],
-            'redirect_to_txn'                     => [
-                'func'       => [$this, 'redirect_to_txn'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-            ],
-            'change_reg_status'                   => [
-                'func'       => [$this, '_change_reg_status'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'approve_registration'                => [
-                'func'       => [$this, 'approve_registration'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'approve_and_notify_registration'     => [
-                'func'       => [$this, 'approve_registration'],
-                'noheader'   => true,
-                'args'       => [true],
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'approve_registrations'               => [
-                'func'       => [$this, 'bulk_action_on_registrations'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-                'args'       => ['approve'],
-            ],
-            'approve_and_notify_registrations'    => [
-                'func'       => [$this, 'bulk_action_on_registrations'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-                'args'       => ['approve', true],
-            ],
-            'decline_registration'                => [
-                'func'       => [$this, 'decline_registration'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'decline_and_notify_registration'     => [
-                'func'       => [$this, 'decline_registration'],
-                'noheader'   => true,
-                'args'       => [true],
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'decline_registrations'               => [
-                'func'       => [$this, 'bulk_action_on_registrations'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-                'args'       => ['decline'],
-            ],
-            'decline_and_notify_registrations'    => [
-                'func'       => [$this, 'bulk_action_on_registrations'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-                'args'       => ['decline', true],
-            ],
-            'pending_registration'                => [
-                'func'       => [$this, 'pending_registration'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'pending_and_notify_registration'     => [
-                'func'       => [$this, 'pending_registration'],
-                'noheader'   => true,
-                'args'       => [true],
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'pending_registrations'               => [
-                'func'       => [$this, 'bulk_action_on_registrations'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-                'args'       => ['pending'],
-            ],
-            'pending_and_notify_registrations'    => [
-                'func'       => [$this, 'bulk_action_on_registrations'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-                'args'       => ['pending', true],
-            ],
-            'no_approve_registration'             => [
-                'func'       => [$this, 'not_approve_registration'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'no_approve_and_notify_registration'  => [
-                'func'       => [$this, 'not_approve_registration'],
-                'noheader'   => true,
-                'args'       => [true],
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'no_approve_registrations'            => [
-                'func'       => [$this, 'bulk_action_on_registrations'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-                'args'       => ['not_approve'],
-            ],
-            'no_approve_and_notify_registrations' => [
-                'func'       => [$this, 'bulk_action_on_registrations'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-                'args'       => ['not_approve', true],
-            ],
-            'cancel_registration'                 => [
-                'func'       => [$this, 'cancel_registration'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'cancel_and_notify_registration'      => [
-                'func'       => [$this, 'cancel_registration'],
-                'noheader'   => true,
-                'args'       => [true],
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'cancel_registrations'                => [
-                'func'       => [$this, 'bulk_action_on_registrations'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-                'args'       => ['cancel'],
-            ],
-            'cancel_and_notify_registrations'     => [
-                'func'       => [$this, 'bulk_action_on_registrations'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-                'args'       => ['cancel', true],
-            ],
-            'wait_list_registration'              => [
-                'func'       => [$this, 'wait_list_registration'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'wait_list_and_notify_registration'   => [
-                'func'       => [$this, 'wait_list_registration'],
-                'noheader'   => true,
-                'args'       => [true],
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $REG_ID,
-            ],
-            'contact_list'                        => [
-                'func'       => [$this, '_attendee_contact_list_table'],
-                'capability' => 'ee_read_contacts',
-            ],
-            'add_new_attendee'                    => [
-                'func'       => [$this, '_create_new_cpt_item'],
-                'args' => [
-                    'new_attendee' => true,
-                    'capability'   => 'ee_edit_contacts',
-                ],
-            ],
-            'edit_attendee'                       => [
-                'func'       => [$this, '_edit_cpt_item'],
-                'capability' => 'ee_edit_contacts',
-                'obj_id'     => $ATT_ID,
-            ],
-            'duplicate_attendee'                  => [
-                'func'       => [$this, '_duplicate_attendee'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_contacts',
-                'obj_id'     => $ATT_ID,
-            ],
-            'insert_attendee'                     => [
-                'func'       => [$this, '_insert_or_update_attendee'],
-                'args'       => [
-                    'new_attendee' => true,
-                ],
-                'noheader'   => true,
-                'capability' => 'ee_edit_contacts',
-            ],
-            'update_attendee'                     => [
-                'func'       => [$this, '_insert_or_update_attendee'],
-                'args'       => [
-                    'new_attendee' => false,
-                ],
-                'noheader'   => true,
-                'capability' => 'ee_edit_contacts',
-                'obj_id'     => $ATT_ID,
-            ],
-            'trash_attendees'                     => [
-                'func'       => [$this, '_trash_or_restore_attendees'],
-                'args'       => [
-                    'trash' => 'true',
-                ],
-                'noheader'   => true,
-                'capability' => 'ee_delete_contacts',
-            ],
-            'trash_attendee'                      => [
-                'func'       => [$this, '_trash_or_restore_attendees'],
-                'args'       => [
-                    'trash' => true,
-                ],
-                'noheader'   => true,
-                'capability' => 'ee_delete_contacts',
-                'obj_id'     => $ATT_ID,
-            ],
-            'restore_attendees'                   => [
-                'func'       => [$this, '_trash_or_restore_attendees'],
-                'args'       => [
-                    'trash' => false,
-                ],
-                'noheader'   => true,
-                'capability' => 'ee_delete_contacts',
-                'obj_id'     => $ATT_ID,
-            ],
-            'delete_attendee'                     => [
-                'func'       => [$this, 'deleteAttendees'],
-                'capability' => 'ee_delete_contacts',
-                'obj_id'     => $ATT_ID,
-                'noheader'   => true,
-            ],
-            'delete_attendees'                    => [
-                'func'       => [$this, 'deleteAttendees'],
-                'capability' => 'ee_delete_contacts',
-                'noheader'   => true,
-            ],
-            'resend_registration'                 => [
-                'func'       => [$this, '_resend_registration'],
-                'noheader'   => true,
-                'capability' => 'ee_send_message',
-            ],
-            'registrations_report'                => [
-                'func'       => [$this, '_registrations_report'],
-                'noheader'   => true,
-                'capability' => 'ee_read_registrations',
-            ],
-            'contact_list_export'                 => [
-                'func'       => [$this, '_contact_list_export'],
-                'noheader'   => true,
-                'capability' => 'export',
-            ],
-            'contact_list_report'                 => [
-                'func'       => [$this, '_contact_list_report'],
-                'noheader'   => true,
-                'capability' => 'ee_read_contacts',
-            ],
-        ];
-    }
-
-
-    protected function _set_page_config()
-    {
-        $REG_ID             = $this->request->getRequestParam('_REG_ID', 0, 'int');
-        $ATT_ID             = $this->request->getRequestParam('ATT_ID', 0, 'int');
-        $this->_page_config = [
-            'default'           => [
-                'nav'           => [
-                    'label' => esc_html__('Overview', 'event_espresso'),
-                    'icon'  => 'dashicons-list-view',
-                    'order' => 5,
-                ],
-                'help_tabs'     => [
-                    'registrations_overview_help_tab'                       => [
-                        'title'    => esc_html__('Registrations Overview', 'event_espresso'),
-                        'filename' => 'registrations_overview',
-                    ],
-                    'registrations_overview_table_column_headings_help_tab' => [
-                        'title'    => esc_html__('Registrations Table Column Headings', 'event_espresso'),
-                        'filename' => 'registrations_overview_table_column_headings',
-                    ],
-                    'registrations_overview_filters_help_tab'               => [
-                        'title'    => esc_html__('Registration Filters', 'event_espresso'),
-                        'filename' => 'registrations_overview_filters',
-                    ],
-                    'registrations_overview_views_help_tab'                 => [
-                        'title'    => esc_html__('Registration Views', 'event_espresso'),
-                        'filename' => 'registrations_overview_views',
-                    ],
-                    'registrations_regoverview_other_help_tab'              => [
-                        'title'    => esc_html__('Registrations Other', 'event_espresso'),
-                        'filename' => 'registrations_overview_other',
-                    ],
-                ],
-                'list_table'    => 'EE_Registrations_List_Table',
-                'require_nonce' => false,
-            ],
-            'view_registration' => [
-                'nav'           => [
-                    'label'      => esc_html__('REG Details', 'event_espresso'),
-                    'icon'       => 'dashicons-clipboard',
-                    'order'      => 15,
-                    'url'        => $REG_ID
-                        ? add_query_arg(['_REG_ID' => $REG_ID], $this->_current_page_view_url)
-                        : $this->_admin_base_url,
-                    'persistent' => false,
-                ],
-                'help_tabs'     => [
-                    'registrations_details_help_tab'                    => [
-                        'title'    => esc_html__('Registration Details', 'event_espresso'),
-                        'filename' => 'registrations_details',
-                    ],
-                    'registrations_details_table_help_tab'              => [
-                        'title'    => esc_html__('Registration Details Table', 'event_espresso'),
-                        'filename' => 'registrations_details_table',
-                    ],
-                    'registrations_details_form_answers_help_tab'       => [
-                        'title'    => esc_html__('Registration Form Answers', 'event_espresso'),
-                        'filename' => 'registrations_details_form_answers',
-                    ],
-                    'registrations_details_registrant_details_help_tab' => [
-                        'title'    => esc_html__('Contact Details', 'event_espresso'),
-                        'filename' => 'registrations_details_registrant_details',
-                    ],
-                ],
-                'metaboxes'     => array_merge(
-                    $this->_default_espresso_metaboxes,
-                    ['_registration_details_metaboxes']
-                ),
-                'require_nonce' => false,
-            ],
-            'new_registration'  => [
-                'nav'           => [
-                    'label'      => esc_html__('Add New Registration', 'event_espresso'),
-                    'icon'       => 'dashicons-plus-alt',
-                    'url'        => '#',
-                    'order'      => 15,
-                    'persistent' => false,
-                ],
-                'metaboxes'     => $this->_default_espresso_metaboxes,
-                'labels'        => [
-                    'publishbox' => esc_html__('Save Registration', 'event_espresso'),
-                ],
-                'require_nonce' => false,
-            ],
-            'add_new_attendee'  => [
-                'nav'           => [
-                    'label'      => esc_html__('Add Contact', 'event_espresso'),
-                    'icon'       => 'dashicons-plus-alt',
-                    'order'      => 15,
-                    'persistent' => false,
-                ],
-                'metaboxes'     => array_merge(
-                    $this->_default_espresso_metaboxes,
-                    ['_publish_post_box', 'attendee_editor_metaboxes']
-                ),
-                'require_nonce' => false,
-            ],
-            'edit_attendee'     => [
-                'nav'           => [
-                    'label'      => esc_html__('Edit Contact', 'event_espresso'),
-                    'icon'       => 'dashicons-edit-large',
-                    'order'      => 15,
-                    'persistent' => false,
-                    'url'        => $ATT_ID
-                        ? add_query_arg(['ATT_ID' => $ATT_ID], $this->_current_page_view_url)
-                        : $this->_admin_base_url,
-                ],
-                'metaboxes'     => array_merge(
-                    $this->_default_espresso_metaboxes,
-                    ['attendee_editor_metaboxes']
-                ),
-                'require_nonce' => false,
-            ],
-            'contact_list'      => [
-                'nav'           => [
-                    'label' => esc_html__('Contact List', 'event_espresso'),
-                    'icon'  => 'dashicons-id-alt',
-                    'order' => 20,
-                ],
-                'list_table'    => 'EE_Attendee_Contact_List_Table',
-                'help_tabs'     => [
-                    'registrations_contact_list_help_tab'                       => [
-                        'title'    => esc_html__('Registrations Contact List', 'event_espresso'),
-                        'filename' => 'registrations_contact_list',
-                    ],
-                    'registrations_contact-list_table_column_headings_help_tab' => [
-                        'title'    => esc_html__('Contact List Table Column Headings', 'event_espresso'),
-                        'filename' => 'registrations_contact_list_table_column_headings',
-                    ],
-                    'registrations_contact_list_views_help_tab'                 => [
-                        'title'    => esc_html__('Contact List Views', 'event_espresso'),
-                        'filename' => 'registrations_contact_list_views',
-                    ],
-                    'registrations_contact_list_other_help_tab'                 => [
-                        'title'    => esc_html__('Contact List Other', 'event_espresso'),
-                        'filename' => 'registrations_contact_list_other',
-                    ],
-                ],
-                'metaboxes'     => [],
-                'require_nonce' => false,
-            ],
-            // override default cpt routes
-            'create_new'        => '',
-            'edit'              => '',
-        ];
-    }
-
-
-    /**
-     * The below methods aren't used by this class currently
-     */
-    protected function _add_screen_options()
-    {
-    }
-
-
-    protected function _add_feature_pointers()
-    {
-    }
-
-
-    public function admin_init()
-    {
-        EE_Registry::$i18n_js_strings['update_att_qstns'] = esc_html__(
-            'click "Update Registration Questions" to save your changes',
-            'event_espresso'
-        );
-        EE_Registry::$i18n_js_strings['confirm_update_reg_details'] = esc_html__(
-            "Are you sure you want to update the submitted registration form data? This cannot be undone.\nPress OK to proceed or Cancel to keep the current data.",
-        );
-    }
-
-
-    public function admin_notices()
-    {
-    }
-
-
-    public function admin_footer_scripts()
-    {
-    }
-
-
-    /**
-     * get list of registration statuses
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function _get_registration_status_array()
-    {
-        self::$_reg_status = EEM_Registration::reg_status_array([], true);
-    }
-
-
-    /**
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @since 4.10.2.p
-     */
-    protected function _add_screen_options_default()
-    {
-        $this->_per_page_screen_option();
-    }
-
-
-    /**
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @since 4.10.2.p
-     */
-    protected function _add_screen_options_contact_list()
-    {
-        $page_title              = $this->_admin_page_title;
-        $this->_admin_page_title = esc_html__('Contacts', 'event_espresso');
-        $this->_per_page_screen_option();
-        $this->_admin_page_title = $page_title;
-    }
-
-
-    public function load_scripts_styles()
-    {
-        // style
-        wp_register_style(
-            'espresso_reg',
-            REG_ASSETS_URL . 'espresso_registrations_admin.css',
-            ['ee-admin-css'],
-            EVENT_ESPRESSO_VERSION
-        );
-        wp_enqueue_style('espresso_reg');
-        // script
-        wp_register_script(
-            'espresso_reg',
-            REG_ASSETS_URL . 'espresso_registrations_admin.js',
-            ['jquery-ui-datepicker', 'jquery-ui-draggable', 'ee_admin_js'],
-            EVENT_ESPRESSO_VERSION,
-            true
-        );
-        wp_enqueue_script('espresso_reg');
-    }
-
-
-    /**
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @since 4.10.2.p
-     */
-    public function load_scripts_styles_edit_attendee()
-    {
-        // stuff to only show up on our attendee edit details page.
-        $attendee_details_translations = [
-            'att_publish_text' => sprintf(
-            /* translators: The date and time */
-                wp_strip_all_tags(__('Created on: %s', 'event_espresso')),
-                '<b>' . $this->_cpt_model_obj->get_datetime('ATT_created') . '</b>'
-            ),
-        ];
-        wp_localize_script('espresso_reg', 'ATTENDEE_DETAILS', $attendee_details_translations);
-        wp_enqueue_script(JqueryAssetManager::JS_HANDLE_JQUERY_VALIDATE);
-    }
-
-
-    /**
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @since 4.10.2.p
-     */
-    public function load_scripts_styles_view_registration()
-    {
-        $this->_set_registration_object();
-        // styles
-        wp_enqueue_style('espresso-ui-theme');
-        // scripts
-        $this->_get_reg_custom_questions_form($this->_registration->ID());
-        $this->_reg_custom_questions_form->wp_enqueue_scripts();
-    }
-
-
-    public function load_scripts_styles_contact_list()
-    {
-        wp_dequeue_style('espresso_reg');
-        wp_register_style(
-            'espresso_att',
-            REG_ASSETS_URL . 'espresso_attendees_admin.css',
-            ['ee-admin-css'],
-            EVENT_ESPRESSO_VERSION
-        );
-        wp_enqueue_style('espresso_att');
-    }
-
-
-    /**
-     * @throws ReflectionException
-     * @throws EE_Error
-     */
-    public function load_scripts_styles_new_registration()
-    {
-        wp_register_script(
-            'ee-spco-for-admin',
-            REG_ASSETS_URL . 'spco_for_admin.js',
-            ['underscore', 'jquery'],
-            EVENT_ESPRESSO_VERSION,
-            true
-        );
-        wp_enqueue_script('ee-spco-for-admin');
-        add_filter('FHEE__EED_Ticket_Selector__load_tckt_slctr_assets', '__return_true');
-        EE_Form_Section_Proper::wp_enqueue_scripts();
-        EED_Ticket_Selector::load_tckt_slctr_assets();
-    }
-
-
-    public function AHEE__EE_Admin_Page__route_admin_request_resend_registration()
-    {
-        add_filter('FHEE_load_EE_messages', '__return_true');
-    }
-
-
-    public function AHEE__EE_Admin_Page__route_admin_request_approve_registration()
-    {
-        add_filter('FHEE_load_EE_messages', '__return_true');
-    }
-
-
-    /**
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @since 4.10.2.p
-     */
-    protected function _set_list_table_views_default()
-    {
-        // for notification related bulk actions we need to make sure only active messengers have an option.
-        EED_Messages::set_autoloaders();
-        /** @type EE_Message_Resource_Manager $message_resource_manager */
-        $message_resource_manager = EE_Registry::instance()->load_lib('Message_Resource_Manager');
-        $active_mts               = $message_resource_manager->list_of_active_message_types();
-        // key= bulk_action_slug, value= message type.
-        $match_array = [
-            'approve_registrations'    => 'registration',
-            'decline_registrations'    => 'declined_registration',
-            'pending_registrations'    => 'pending_approval',
-            'no_approve_registrations' => 'not_approved_registration',
-            'cancel_registrations'     => 'cancelled_registration',
-        ];
-        $can_send    = $this->capabilities->current_user_can(
-            'ee_send_message',
-            'batch_send_messages'
-        );
-        /** setup reg status bulk actions **/
-        $def_reg_status_actions['approve_registrations'] = esc_html__('Approve Registrations', 'event_espresso');
-        if ($can_send && in_array($match_array['approve_registrations'], $active_mts, true)) {
-            $def_reg_status_actions['approve_and_notify_registrations'] = esc_html__(
-                'Approve and Notify Registrations',
-                'event_espresso'
-            );
-        }
-        $def_reg_status_actions['decline_registrations'] = esc_html__('Decline Registrations', 'event_espresso');
-        if ($can_send && in_array($match_array['decline_registrations'], $active_mts, true)) {
-            $def_reg_status_actions['decline_and_notify_registrations'] = esc_html__(
-                'Decline and Notify Registrations',
-                'event_espresso'
-            );
-        }
-        $def_reg_status_actions['pending_registrations'] = esc_html__(
-            'Set Registrations to Pending Payment',
-            'event_espresso'
-        );
-        if ($can_send && in_array($match_array['pending_registrations'], $active_mts, true)) {
-            $def_reg_status_actions['pending_and_notify_registrations'] = esc_html__(
-                'Set Registrations to Pending Payment and Notify',
-                'event_espresso'
-            );
-        }
-        $def_reg_status_actions['no_approve_registrations'] = esc_html__(
-            'Set Registrations to Awaiting Review',
-            'event_espresso'
-        );
-        if ($can_send && in_array($match_array['no_approve_registrations'], $active_mts, true)) {
-            $def_reg_status_actions['no_approve_and_notify_registrations'] = esc_html__(
-                'Set Registrations to Awaiting Review and Notify',
-                'event_espresso'
-            );
-        }
-        $def_reg_status_actions['cancel_registrations'] = esc_html__('Cancel Registrations', 'event_espresso');
-        if ($can_send && in_array($match_array['cancel_registrations'], $active_mts, true)) {
-            $def_reg_status_actions['cancel_and_notify_registrations'] = esc_html__(
-                'Cancel Registrations and Notify',
-                'event_espresso'
-            );
-        }
-        $def_reg_status_actions = apply_filters(
-            'FHEE__Registrations_Admin_Page___set_list_table_views_default__def_reg_status_actions_array',
-            $def_reg_status_actions,
-            $active_mts,
-            $can_send
-        );
-
-        $current_time = current_time('timestamp');
-        $this->_views = [
-            'all'       => [
-                'slug'        => 'all',
-                'label'       => esc_html__('View All Registrations', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => array_merge(
-                    $def_reg_status_actions,
-                    [
-                        'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
-                    ]
-                ),
-            ],
-            'today'     => [
-                'slug'        => 'today',
-                'label'       => sprintf(
-                    esc_html__('Today - %s', 'event_espresso'),
-                    date('M d, Y', $current_time)
-                ),
-                'count'       => 0,
-                'bulk_action' => array_merge(
-                    $def_reg_status_actions,
-                    [
-                        'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
-                    ]
-                ),
-            ],
-            'yesterday' => [
-                'slug'        => 'yesterday',
-                'label'       => sprintf(
-                    esc_html__('Yesterday - %s', 'event_espresso'),
-                    date('M d, Y', $current_time - DAY_IN_SECONDS)
-                ),
-                'count'       => 0,
-                'bulk_action' => array_merge(
-                    $def_reg_status_actions,
-                    [
-                        'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
-                    ]
-                ),
-            ],
-            'month'     => [
-                'slug'        => 'month',
-                'label'       => esc_html__('This Month', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => array_merge(
-                    $def_reg_status_actions,
-                    [
-                        'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
-                    ]
-                ),
-            ],
-        ];
-        if (
-            $this->capabilities->current_user_can(
-                'ee_delete_registrations',
-                'espresso_registrations_delete_registration'
-            )
-        ) {
-            $this->_views['incomplete'] = [
-                'slug'        => 'incomplete',
-                'label'       => esc_html__('Incomplete', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => [
-                    'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
-                ],
-            ];
-            $this->_views['trash']      = [
-                'slug'        => 'trash',
-                'label'       => esc_html__('Trash', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => [
-                    'restore_registrations' => esc_html__('Restore Registrations', 'event_espresso'),
-                    'delete_registrations'  => esc_html__('Delete Registrations Permanently', 'event_espresso'),
-                ],
-            ];
-        }
-    }
-
-
-    protected function _set_list_table_views_contact_list()
-    {
-        $this->_views = [
-            'in_use' => [
-                'slug'        => 'in_use',
-                'label'       => esc_html__('In Use', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => [
-                    'trash_attendees' => esc_html__('Move to Trash', 'event_espresso'),
-                ],
-            ],
-        ];
-        if (
-            $this->capabilities->current_user_can(
-                'ee_delete_contacts',
-                'espresso_registrations_trash_attendees'
-            )
-        ) {
-            $this->_views['trash'] = [
-                'slug'        => 'trash',
-                'label'       => esc_html__('Trash', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => [
-                    'restore_attendees' => esc_html__('Restore from Trash', 'event_espresso'),
-                    'delete_attendees'  => esc_html__('Permanently Delete', 'event_espresso'),
-                ],
-            ];
-        }
-    }
-
-
-    /**
-     * @return array
-     * @throws EE_Error
-     */
-    protected function _registration_legend_items(): array
-    {
-        $fc_items = [
-            'star-icon'        => [
-                'class' => 'dashicons dashicons-star-filled gold-icon',
-                'desc'  => esc_html__('This is the Primary Registrant', 'event_espresso'),
-            ],
-            'view_details'     => [
-                'class' => 'dashicons dashicons-clipboard',
-                'desc'  => esc_html__('View Registration Details', 'event_espresso'),
-            ],
-            'edit_attendee'    => [
-                'class' => 'dashicons dashicons-admin-users',
-                'desc'  => esc_html__('Edit Contact Details', 'event_espresso'),
-            ],
-            'view_transaction' => [
-                'class' => 'dashicons dashicons-cart',
-                'desc'  => esc_html__('View Transaction Details', 'event_espresso'),
-            ],
-            'view_invoice'     => [
-                'class' => 'dashicons dashicons-media-spreadsheet',
-                'desc'  => esc_html__('View Transaction Invoice', 'event_espresso'),
-            ],
-        ];
-        if (
-            $this->capabilities->current_user_can(
-                'ee_send_message',
-                'espresso_registrations_resend_registration'
-            )
-        ) {
-            $fc_items['resend_registration'] = [
-                'class' => 'dashicons dashicons-email-alt',
-                'desc'  => esc_html__('Resend Registration Details', 'event_espresso'),
-            ];
-        } else {
-            $fc_items['blank'] = ['class' => 'blank', 'desc' => ''];
-        }
-        if (
-            $this->capabilities->current_user_can(
-                'ee_read_global_messages',
-                'view_filtered_messages'
-            )
-        ) {
-            $related_for_icon = EEH_MSG_Template::get_message_action_icon('see_notifications_for');
-            if (is_array($related_for_icon) && isset($related_for_icon['css_class'], $related_for_icon['label'])) {
-                $fc_items['view_related_messages'] = [
-                    'class' => $related_for_icon['css_class'],
-                    'desc'  => $related_for_icon['label'],
-                ];
-            }
-        }
-        $sc_items = [
-            'approved_status'   => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::APPROVED,
-                'desc'  => EEH_Template::pretty_status(
-                    RegStatus::APPROVED,
-                    false,
-                    'sentence'
-                ),
-            ],
-            'pending_status'    => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::PENDING_PAYMENT,
-                'desc'  => EEH_Template::pretty_status(
-                    RegStatus::PENDING_PAYMENT,
-                    false,
-                    'sentence'
-                ),
-            ],
-            'wait_list'         => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::WAIT_LIST,
-                'desc'  => EEH_Template::pretty_status(
-                    RegStatus::WAIT_LIST,
-                    false,
-                    'sentence'
-                ),
-            ],
-            'incomplete_status' => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::INCOMPLETE,
-                'desc'  => EEH_Template::pretty_status(
-                    RegStatus::INCOMPLETE,
-                    false,
-                    'sentence'
-                ),
-            ],
-            'not_approved'      => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::AWAITING_REVIEW,
-                'desc'  => EEH_Template::pretty_status(
-                    RegStatus::AWAITING_REVIEW,
-                    false,
-                    'sentence'
-                ),
-            ],
-            'declined_status'   => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::DECLINED,
-                'desc'  => EEH_Template::pretty_status(
-                    RegStatus::DECLINED,
-                    false,
-                    'sentence'
-                ),
-            ],
-            'cancelled_status'  => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::CANCELLED,
-                'desc'  => EEH_Template::pretty_status(
-                    RegStatus::CANCELLED,
-                    false,
-                    'sentence'
-                ),
-            ],
-        ];
-        return array_merge($fc_items, $sc_items);
-    }
-
-
-
-    /***************************************        REGISTRATION OVERVIEW        **************************************/
-
-
-    /**
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     */
-    protected function _registrations_overview_list_table()
-    {
-        $this->appendAddNewRegistrationButtonToPageTitle();
-        $header_text                  = '';
-        $admin_page_header_decorators = [
-            'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\AttendeeFilterHeader',
-            'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\EventFilterHeader',
-            'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\DateFilterHeader',
-            'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\TicketFilterHeader',
-        ];
-        foreach ($admin_page_header_decorators as $admin_page_header_decorator) {
-            $filter_header_decorator = $this->loader->getNew($admin_page_header_decorator);
-            $header_text             = $filter_header_decorator->getHeaderText($header_text);
-        }
-        $this->_template_args['before_list_table'] = $header_text;
-        $this->_template_args['after_list_table']  = $this->_display_legend($this->_registration_legend_items());
-        $this->display_admin_list_table_page_with_no_sidebar();
-    }
-
-
-    /**
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     */
-    private function appendAddNewRegistrationButtonToPageTitle()
-    {
-        $EVT_ID = $this->request->getRequestParam('event_id', 0, 'int');
-        if (
-            $EVT_ID
-            && $this->capabilities->current_user_can(
-                'ee_edit_registrations',
-                'espresso_registrations_new_registration',
-                $EVT_ID
-            )
-        ) {
-            $this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
-                    'new_registration',
-                    'add-registrant',
-                    ['event_id' => $EVT_ID],
-                    'add-new-h2'
-                );
-        }
-    }
-
-
-    /**
-     * This sets the _registration property for the registration details screen
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    private function _set_registration_object()
-    {
-        // get out if we've already set the object
-        if ($this->_registration instanceof EE_Registration) {
-            return;
-        }
-        $REG_ID = $this->request->getRequestParam('_REG_ID', 0, 'int');
-        if ($this->_registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID)) {
-            return;
-        }
-        $error_msg = sprintf(
-            esc_html__(
-                'An error occurred and the details for Registration ID #%s could not be retrieved.',
-                'event_espresso'
-            ),
-            $REG_ID
-        );
-        EE_Error::add_error($error_msg, __FILE__, __FUNCTION__, __LINE__);
-        $this->_registration = null;
-    }
-
-
-    /**
-     * Used to retrieve registrations for the list table.
-     *
-     * @param int  $per_page
-     * @param bool $count
-     * @param bool $this_month
-     * @param bool $today
-     * @param bool $yesterday
-     * @return EE_Registration[]|int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function get_registrations(
-        int $per_page = 10,
-        bool $count = false,
-        bool $this_month = false,
-        bool $today = false,
-        bool $yesterday = false
-    ) {
-        if ($this_month) {
-            $this->request->setRequestParam('status', 'month');
-        }
-        if ($today) {
-            $this->request->setRequestParam('status', 'today');
-        }
-        if ($yesterday) {
-            $this->request->setRequestParam('status', 'yesterday');
-        }
-        $query_params = $this->_get_registration_query_parameters([], $per_page, $count);
-        /**
-         * Override the default groupby added by EEM_Base so that sorts with multiple order bys work as expected
-         *
-         * @link https://events.codebasehq.com/projects/event-espresso/tickets/10093
-         * @see  https://github.com/eventespresso/event-espresso-core/tree/master/docs/G--Model-System/model-query-params.md
-         *                      or if you have the development copy of EE you can view this at the path:
-         *                      /docs/G--Model-System/model-query-params.md
-         */
-        $query_params['group_by'] = '';
-
-        return $count
-            ? $this->getRegistrationModel()->count($query_params)
-            /** @type EE_Registration[] */
-            : $this->getRegistrationModel()->get_all($query_params);
-    }
-
-
-    /**
-     * Retrieves the query parameters to be used by the Registration model for getting registrations.
-     * Note: this listens to values on the request for some query parameters.
-     *
-     * @param array $request
-     * @param int   $per_page
-     * @param bool  $count
-     * @return array
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     */
-    protected function _get_registration_query_parameters(
-        array $request = [],
-        int $per_page = 10,
-        bool $count = false
-    ): array {
-        /** @var QueryBuilder $list_table_query_builder */
-        $list_table_query_builder = $this->loader->getNew(QueryBuilder::class, [null, null, $request]);
-        return $list_table_query_builder->getQueryParams($per_page, $count);
-    }
-
-
-    public function get_registration_status_array(): array
-    {
-        return self::$_reg_status;
-    }
-
-
-
-
-    /***************************************        REGISTRATION DETAILS        ***************************************/
-    /**
-     * generates HTML for the View Registration Details Admin page
-     *
-     * @return void
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws EntityNotFoundException
-     * @throws ReflectionException
-     */
-    protected function _registration_details()
-    {
-        $this->_template_args = [];
-        $this->_set_registration_object();
-        if (is_object($this->_registration)) {
-            $transaction                                   = $this->_registration->transaction()
-                ? $this->_registration->transaction()
-                : EE_Transaction::new_instance();
-            $this->session_data                            = $transaction->session_data();
-            $event_id                                      = $this->_registration->event_ID();
-            $this->_template_args['reg_nmbr']['value']     = $this->_registration->ID();
-            $this->_template_args['reg_nmbr']['label']     = esc_html__('Registration Number', 'event_espresso');
-            $this->_template_args['reg_datetime']['value'] = $this->_registration->get_i18n_datetime('REG_date');
-            $this->_template_args['reg_datetime']['label'] = esc_html__('Date', 'event_espresso');
-            $this->_template_args['grand_total']           = $transaction->total();
-            $this->_template_args['currency_sign']         = EE_Registry::instance()->CFG->currency->sign;
-            // link back to overview
-            $this->_template_args['reg_overview_url']            = REG_ADMIN_URL;
-            $this->_template_args['registration']                = $this->_registration;
-            $this->_template_args['filtered_registrations_link'] = EE_Admin_Page::add_query_args_and_nonce(
-                [
-                    'action'   => 'default',
-                    'event_id' => $event_id,
-                ],
-                REG_ADMIN_URL
-            );
-            $this->_template_args['filtered_transactions_link']  = EE_Admin_Page::add_query_args_and_nonce(
-                [
-                    'action' => 'default',
-                    'EVT_ID' => $event_id,
-                    'page'   => 'espresso_transactions',
-                ],
-                admin_url('admin.php')
-            );
-            $this->_template_args['event_link']                  = EE_Admin_Page::add_query_args_and_nonce(
-                [
-                    'page'   => 'espresso_events',
-                    'action' => 'edit',
-                    'post'   => $event_id,
-                ],
-                admin_url('admin.php')
-            );
-            // next and previous links
-            $next_reg                                      = $this->_registration->next(
-                null,
-                [],
-                'REG_ID'
-            );
-            $this->_template_args['next_registration']     = $next_reg
-                ? $this->_next_link(
-                    EE_Admin_Page::add_query_args_and_nonce(
-                        [
-                            'action'  => 'view_registration',
-                            '_REG_ID' => $next_reg['REG_ID'],
-                        ],
-                        REG_ADMIN_URL
-                    ),
-                    'dashicons dashicons-arrow-right ee-icon-size-22'
-                )
-                : '';
-            $previous_reg                                  = $this->_registration->previous(
-                null,
-                [],
-                'REG_ID'
-            );
-            $this->_template_args['previous_registration'] = $previous_reg
-                ? $this->_previous_link(
-                    EE_Admin_Page::add_query_args_and_nonce(
-                        [
-                            'action'  => 'view_registration',
-                            '_REG_ID' => $previous_reg['REG_ID'],
-                        ],
-                        REG_ADMIN_URL
-                    ),
-                    'dashicons dashicons-arrow-left ee-icon-size-22'
-                )
-                : '';
-            // grab header
-            $template_path                             = REG_TEMPLATE_PATH . 'reg_admin_details_header.template.php';
-            $this->_template_args['REG_ID']            = $this->_registration->ID();
-            $this->_template_args['admin_page_header'] = EEH_Template::display_template(
-                $template_path,
-                $this->_template_args,
-                true
-            );
-        } else {
-            $this->_template_args['admin_page_header'] = '';
-            $this->_display_espresso_notices();
-        }
-        // the details template wrapper
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    /**
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @since 4.10.2.p
-     */
-    protected function _registration_details_metaboxes()
-    {
-        do_action('AHEE__Registrations_Admin_Page___registration_details_metabox__start', $this);
-        $this->_set_registration_object();
-        $attendee = $this->_registration instanceof EE_Registration ? $this->_registration->attendee() : null;
-        $this->addMetaBox(
-            'edit-reg-status-mbox',
-            esc_html__('Registration Status', 'event_espresso'),
-            [$this, 'set_reg_status_buttons_metabox'],
-            $this->_wp_page_slug
-        );
-        $this->addMetaBox(
-            'edit-reg-details-mbox',
-            '<span>' . esc_html__('Registration Details', 'event_espresso')
-            . '&nbsp;<span class="dashicons dashicons-clipboard"></span></span>',
-            [$this, '_reg_details_meta_box'],
-            $this->_wp_page_slug
-        );
-        if (
-            $attendee instanceof EE_Attendee
-            && $this->capabilities->current_user_can(
-                'ee_read_registration',
-                'edit-reg-questions-mbox',
-                $this->_registration->ID()
-            )
-        ) {
-            $this->addMetaBox(
-                'edit-reg-questions-mbox',
-                esc_html__('Registration Form Answers', 'event_espresso'),
-                [$this, '_reg_questions_meta_box'],
-                $this->_wp_page_slug
-            );
-        }
-        $this->addMetaBox(
-            'edit-reg-registrant-mbox',
-            esc_html__('Contact Details', 'event_espresso'),
-            [$this, '_reg_registrant_side_meta_box'],
-            $this->_wp_page_slug,
-            'side'
-        );
-        if ($this->_registration->group_size() > 1) {
-            $this->addMetaBox(
-                'edit-reg-attendees-mbox',
-                esc_html__('Other Registrations in this Transaction', 'event_espresso'),
-                [$this, '_reg_attendees_meta_box'],
-                $this->_wp_page_slug
-            );
-        }
-    }
-
-
-    /**
-     * set_reg_status_buttons_metabox
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws DateMalformedStringException
-     */
-    public function set_reg_status_buttons_metabox()
-    {
-        $this->_set_registration_object();
-        $change_reg_status_form = $this->_generate_reg_status_change_form();
-        $output                 = $change_reg_status_form->form_open(
-            self::add_query_args_and_nonce(
-                [
-                    'action' => 'change_reg_status',
-                ],
-                REG_ADMIN_URL
-            )
-        );
-        $output                 .= $change_reg_status_form->get_html();
-        $output                 .= $change_reg_status_form->form_close();
-        echo wp_kses($output, AllowedTags::getWithFormTags());
-    }
-
-
-    /**
-     * @return EE_Form_Section_Proper
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws ReflectionException
-     * @throws DateMalformedStringException
-     */
-    protected function _generate_reg_status_change_form(): EE_Form_Section_Proper
-    {
-        $subsections = [
-            'return' => new EE_Hidden_Input(
-                [
-                    'name'    => 'return',
-                    'default' => 'view_registration',
-                ]
-            ),
-            'REG_ID' => new EE_Hidden_Input(
-                [
-                    'name'    => 'REG_ID',
-                    'default' => $this->_registration->ID(),
-                ]
-            ),
-        ];
-
-        $status_changes = $this->_registration->get_extra_meta(EE_Registration::META_KEY_REG_STATUS_CHANGE);
-
-        if (! empty($status_changes)) {
-            $date_format = get_option('date_format', 'Y-m-d') . ' ' . get_option('time_format', 'H:i:s');
-            $html = EEH_HTML::tr();
-            $html .= EEH_HTML::th(
-                EEH_HTML::label(esc_html__('Registration Status Changes', 'event_espresso'))
-            );
-            $html .= EEH_HTML::td();
-            $html .= EEH_HTML::ul();
-            foreach ($status_changes as $status_change) {
-                $date = new DateTime('@' . $status_change['date']);
-                $reason = $status_change['reason'] ?: esc_html__('not specified', 'event_espresso');
-                $html .= EEH_HTML::li(
-                    EEH_HTML::strong($date->format($date_format))
-                    . EEH_HTML::br()
-                    . EEH_HTML::span(
-                        $status_change['change'],
-                        '',
-                        '',
-                        'margin-inline-start: 1em;'
-                    )
-                    . EEH_HTML::br()
-                    . EEH_HTML::span(
-                        sprintf(
-                            esc_html__('Reason: %1$s', 'event_espresso'),
-                            $reason,
-                        ),
-                        '',
-                        '',
-                        'margin-inline-start: 1em;'
-                    )
-                );
-            }
-            $html .= EEH_HTML::ulx();
-            $html .= EEH_HTML::tdx();
-            $html .= EEH_HTML::trx();
-            $subsections['reg_cancellations'] = new EE_Form_Section_HTML($html, ['add_wrapper' => false]);
-        }
-
-
-        if (
-            $this->capabilities->current_user_can(
-                'ee_edit_registration',
-                'toggle_registration_status',
-                $this->_registration->ID()
-            )
-        ) {
-            $subsections['reg_status']         = new EE_Select_Input(
-                $this->_get_reg_statuses(),
-                [
-                    'html_label_text' => esc_html__('Change Registration Status to', 'event_espresso'),
-                    'default'         => $this->_registration->status_ID(),
-                    'html_class'      => 'ee-input-width--small',
-                ]
-            );
-            $subsections['reason']         = new EE_Text_Input(
-                [
-                    'html_label_text' => esc_html__('Reason for Registration Status Change', 'event_espresso')
-                ]
-            );
-            $subsections['send_notifications'] = new EE_Yes_No_Input(
-                [
-                    'html_label_text' => esc_html__('Send Related Messages', 'event_espresso'),
-                    'default'         => false,
-                    'html_help_text'  => esc_html__(
-                        'If set to "Yes", then the related messages will be sent to the registrant.',
-                        'event_espresso'
-                    ),
-                ]
-            );
-            $subsections['submit']             = new EE_Submit_Input(
-                [
-                    'html_class'      => 'button--primary',
-                    'html_label_text' => '&nbsp;',
-                    'default'         => esc_html__('Update Registration Status', 'event_espresso'),
-                ]
-            );
-        }
-        return new EE_Form_Section_Proper(
-            [
-              'name'            => 'reg_status_change_form',
-              'html_id'         => 'reg-status-change-form',
-              'layout_strategy' => new EE_Admin_Two_Column_Layout(),
-              'subsections'     => $subsections
-            ]
-        );
-    }
-
-
-    /**
-     * Returns an array of all the buttons for the various statuses and switch status actions
-     *
-     * @return array
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws EntityNotFoundException
-     * @throws ReflectionException
-     */
-    protected function _get_reg_statuses(): array
-    {
-        $reg_status_array = $this->getRegistrationModel()->reg_status_array();
-        unset($reg_status_array[ RegStatus::INCOMPLETE ]);
-        // get current reg status
-        $current_status = $this->_registration->status_ID();
-        // is registration for free event? This will determine whether to display the pending payment option
-        if (
-            $current_status !== RegStatus::PENDING_PAYMENT
-            && EEH_Money::compare_floats($this->_registration->ticket()->price(), 0.00)
-        ) {
-            unset($reg_status_array[ RegStatus::PENDING_PAYMENT ]);
-        }
-        return $this->getStatusModel()->localized_status($reg_status_array, false, 'sentence');
-    }
-
-
-    /**
-     * This method is used when using _REG_ID from request which may or may not be an array of reg_ids.
-     *
-     * @param string $status REG status given for changing registrations to.
-     * @param bool $notify Whether to send messages notifications or not.
-     * @return array (array with reg_id(s) updated and whether update was successful.
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     */
-    protected function _set_registration_status_from_request(string $status = '', bool $notify = false): array
-    {
-        $REG_IDs = $this->request->requestParamIsSet('reg_status_change_form')
-            ? $this->request->getRequestParam('reg_status_change_form[REG_ID]', [], 'int', true)
-            : $this->request->getRequestParam('_REG_ID', [], 'int', true);
-
-        // sanitize $REG_IDs
-        $REG_IDs = array_map('absint', $REG_IDs);
-        // and remove empty entries
-        $REG_IDs = array_filter($REG_IDs);
-
-        $result = $this->_set_registration_status($REG_IDs, $status, $notify);
-
-        /**
-         * Set and filter $_req_data['_REG_ID'] for any potential future messages notifications.
-         * Currently this value is used downstream by the _process_resend_registration method.
-         *
-         * @param int|array                $registration_ids The registration ids that have had their status changed successfully.
-         * @param bool                     $status           The status registrations were changed to.
-         * @param bool                     $success          If the status was changed successfully for all registrations.
-         * @param Registrations_Admin_Page $admin_page
-         */
-        $REG_ID = apply_filters(
-            'FHEE__Registrations_Admin_Page___set_registration_status_from_request__REG_IDs',
-            $result['REG_ID'],
-            $status,
-            $result['success'],
-            $this
-        );
-        $this->request->setRequestParam('_REG_ID', $REG_ID);
-
-        // notify?
-        if (
-            $notify
-            && $result['success']
-            && ! empty($REG_ID)
-            && $this->capabilities->current_user_can(
-                'ee_send_message',
-                'espresso_registrations_resend_registration'
-            )
-        ) {
-            $this->_process_resend_registration();
-        }
-        return $result;
-    }
-
-
-    /**
-     * Set the registration status for the given reg_id (which may or may not be an array, it gets typecast to an
-     * array). Note, this method does NOT take care of possible notifications.  That is required by calling code.
-     *
-     * @param array  $REG_IDs
-     * @param string $status
-     * @param bool   $notify Used to indicate whether notification was requested or not.  This determines the context
-     *                       slug sent with setting the registration status.
-     * @return array (an array with 'success' key representing whether status change was successful, and 'REG_ID' as
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     * @throws EntityNotFoundException
-     * @throws DomainException
-     */
-    protected function _set_registration_status(array $REG_IDs = [], string $status = '', bool $notify = false): array
-    {
-        global $current_user;
-        $admin_name = $current_user->display_name;
-        $reason = $this->request->getRequestParam('reg_status_change_form[reason]');
-        if (empty($REG_IDs)) {
-            return ['REG_ID' => $REG_IDs, 'success' => false];
-        }
-        $success = true;
-        // set default status if none is passed
-        $status         = $status ?: RegStatus::PENDING_PAYMENT;
-        $status_context = $notify
-            ? Domain::CONTEXT_REGISTRATION_STATUS_CHANGE_REGISTRATION_ADMIN_NOTIFY
-            : Domain::CONTEXT_REGISTRATION_STATUS_CHANGE_REGISTRATION_ADMIN;
-        // loop through REG_ID's and change status
-        foreach ($REG_IDs as $REG_ID) {
-            $registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
-            if ($registration instanceof EE_Registration) {
-                $updated = $registration->set_status(
-                    $status,
-                    false,
-                    new Context(
-                        $status_context,
-                        esc_html__(
-                            'Manually triggered status change on a Registration Admin Page route.',
-                            'event_espresso'
-                        )
-                    )
-                );
-                $registration->add_extra_meta(
-                    EE_Registration::META_KEY_REG_STATUS_CHANGE,
-                    [
-                        'date'   => time(),
-                        'change' => sprintf(
-                            esc_html__('changed to "%1$s" by %2$s', 'event_espresso'),
-                            EEH_Template::pretty_status($status, false, 'sentence'),
-                            $admin_name
-                        ),
-                        'reason' => $reason,
-                    ]
-                );
-                $registration->save();
-                // verifying explicit fails because update *may* just return 0 for 0 rows affected
-                $success = $updated && $success;
-            }
-        }
-
-        // return $success and processed registrations
-        return ['REG_ID' => $REG_IDs, 'success' => $success];
-    }
-
-
-    /**
-     * Common logic for setting up success message and redirecting to appropriate route
-     *
-     * @param string $STS_ID status id for the registration changed to
-     * @param bool   $notify indicates whether the _set_registration_status_from_request does notifications or not.
-     * @return void
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     */
-    protected function _reg_status_change_return(string $STS_ID, bool $notify = false)
-    {
-        $result  = ! empty($STS_ID)
-            ? $this->_set_registration_status_from_request($STS_ID, $notify)
-            : ['success' => false];
-        $success = isset($result['success']) && $result['success'];
-        // setup success message
-        if ($success) {
-            if (is_array($result['REG_ID']) && count($result['REG_ID']) === 1) {
-                $msg = sprintf(
-                    esc_html__('Registration status has been set to %s', 'event_espresso'),
-                    EEH_Template::pretty_status($STS_ID, false, 'lower')
-                );
-            } else {
-                $msg = sprintf(
-                    esc_html__('Registrations have been set to %s.', 'event_espresso'),
-                    EEH_Template::pretty_status($STS_ID, false, 'lower')
-                );
-            }
-            EE_Error::add_success($msg);
-        } else {
-            EE_Error::add_error(
-                esc_html__(
-                    'Something went wrong, and the status was not changed',
-                    'event_espresso'
-                ),
-                __FILE__,
-                __LINE__,
-                __FUNCTION__
-            );
-        }
-        $return = $this->request->getRequestParam('return');
-        $route  = $return === 'view_registration'
-            ? ['action' => 'view_registration', '_REG_ID' => reset($result['REG_ID'])]
-            : ['action' => 'default'];
-        $route  = $this->mergeExistingRequestParamsWithRedirectArgs($route);
-        $this->_redirect_after_action($success, '', '', $route, true);
-    }
-
-
-    /**
-     * incoming reg status change from reg details page.
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     * @throws DomainException
-     */
-    protected function _change_reg_status()
-    {
-        $this->request->setRequestParam('return', 'view_registration');
-        // set notify based on whether the send notifications toggle is set or not
-        $notify     = $this->request->getRequestParam('reg_status_change_form[send_notifications]', false, 'bool');
-        $reg_status = $this->request->getRequestParam('reg_status_change_form[reg_status]', '');
-
-        switch ($reg_status) {
-            case RegStatus::APPROVED:
-            case EEH_Template::pretty_status(RegStatus::APPROVED, false, 'sentence'):
-                $this->approve_registration($notify);
-                break;
-            case RegStatus::PENDING_PAYMENT:
-            case EEH_Template::pretty_status(RegStatus::PENDING_PAYMENT, false, 'sentence'):
-                $this->pending_registration($notify);
-                break;
-            case RegStatus::AWAITING_REVIEW:
-            case EEH_Template::pretty_status(RegStatus::AWAITING_REVIEW, false, 'sentence'):
-                $this->not_approve_registration($notify);
-                break;
-            case RegStatus::DECLINED:
-            case EEH_Template::pretty_status(RegStatus::DECLINED, false, 'sentence'):
-                $this->decline_registration($notify);
-                break;
-            case RegStatus::CANCELLED:
-            case EEH_Template::pretty_status(RegStatus::CANCELLED, false, 'sentence'):
-                $this->cancel_registration($notify);
-                break;
-            case RegStatus::WAIT_LIST:
-            case EEH_Template::pretty_status(RegStatus::WAIT_LIST, false, 'sentence'):
-                $this->wait_list_registration($notify);
-                break;
-            case RegStatus::INCOMPLETE:
-            default:
-                $this->request->unSetRequestParam('return');
-                $this->_reg_status_change_return('');
-                break;
-        }
-    }
-
-
-    /**
-     * Callback for bulk action routes.
-     * Note: although we could just register the singular route callbacks for each bulk action route as well, this
-     * method was chosen so there is one central place all the registration status bulk actions are going through.
-     * Potentially, this provides an easier place to locate logic that is specific to these bulk actions (as opposed to
-     * when an action is happening on just a single registration).
-     *
-     * @param string $action
-     * @param bool   $notify
-     */
-    protected function bulk_action_on_registrations(string $action, bool $notify = false)
-    {
-        do_action(
-            'AHEE__Registrations_Admin_Page__bulk_action_on_registrations__before_execution',
-            $this,
-            $action,
-            $notify
-        );
-        $method = $action . '_registration';
-        if (method_exists($this, $method)) {
-            $this->$method($notify);
-        }
-    }
-
-
-    /**
-     * approve_registration
-     *
-     * @param bool $notify whether to notify the registrant about their approval.
-     * @return void
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     * @throws DomainException
-     */
-    protected function approve_registration(bool $notify = false)
-    {
-        $this->_reg_status_change_return(RegStatus::APPROVED, $notify);
-    }
-
-
-    /**
-     * decline_registration
-     *
-     * @param bool $notify whether to notify the registrant about their status change.
-     * @return void
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     * @throws DomainException
-     */
-    protected function decline_registration(bool $notify = false)
-    {
-        $this->_reg_status_change_return(RegStatus::DECLINED, $notify);
-    }
-
-
-    /**
-     * cancel_registration
-     *
-     * @param bool $notify whether to notify the registrant about their status change.
-     * @return void
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     * @throws DomainException
-     */
-    protected function cancel_registration(bool $notify = false)
-    {
-        $this->_reg_status_change_return(RegStatus::CANCELLED, $notify);
-    }
-
-
-    /**
-     * not_approve_registration
-     *
-     * @param bool $notify whether to notify the registrant about their status change.
-     * @return void
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     * @throws DomainException
-     */
-    protected function not_approve_registration(bool $notify = false)
-    {
-        $this->_reg_status_change_return(RegStatus::AWAITING_REVIEW, $notify);
-    }
-
-
-    /**
-     * decline_registration
-     *
-     * @param bool $notify whether to notify the registrant about their status change.
-     * @return void
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     * @throws DomainException
-     */
-    protected function pending_registration(bool $notify = false)
-    {
-        $this->_reg_status_change_return(RegStatus::PENDING_PAYMENT, $notify);
-    }
-
-
-    /**
-     * waitlist_registration
-     *
-     * @param bool $notify whether to notify the registrant about their status change.
-     * @return void
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     * @throws DomainException
-     */
-    protected function wait_list_registration(bool $notify = false)
-    {
-        $this->_reg_status_change_return(RegStatus::WAIT_LIST, $notify);
-    }
-
-
-    /**
-     * generates HTML for the Registration main meta box
-     *
-     * @return void
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws EntityNotFoundException
-     */
-    public function _reg_details_meta_box()
-    {
-        EEH_Autoloader::register_line_item_display_autoloaders();
-        EEH_Autoloader::register_line_item_filter_autoloaders();
-
-        $transaction        = $this->_registration->transaction()
-            ? $this->_registration->transaction()
-            : EE_Transaction::new_instance();
-        $this->session_data = $transaction->session_data();
-        $filters            = new EE_Line_Item_Filter_Collection();
-        $filters->add(new EE_Single_Registration_Line_Item_Filter($this->_registration));
-        $filters->add(new EE_Non_Zero_Line_Item_Filter());
-        $line_item_filter_processor              = new EE_Line_Item_Filter_Processor(
-            $filters,
-            $transaction->total_line_item()
-        );
-        $filtered_line_item_tree                 = $line_item_filter_processor->process();
-        $line_item_display                       = new EE_Line_Item_Display(
-            'reg_admin_table',
-            'EE_Admin_Table_Registration_Line_Item_Display_Strategy'
-        );
-        $this->_template_args['line_item_table'] = $line_item_display->display_line_item(
-            $filtered_line_item_tree,
-            ['EE_Registration' => $this->_registration]
-        );
-        $attendee                                = $this->_registration->attendee();
-        if (
-            $this->capabilities->current_user_can(
-                'ee_read_transaction',
-                'espresso_transactions_view_transaction'
-            )
-        ) {
-            $this->_template_args['view_transaction_button'] = EEH_Template::get_button_or_link(
-                EE_Admin_Page::add_query_args_and_nonce(
-                    [
-                        'action' => 'view_transaction',
-                        'TXN_ID' => $transaction->ID(),
-                    ],
-                    TXN_ADMIN_URL
-                ),
-                esc_html__(' View Transaction', 'event_espresso'),
-                'button button--secondary right',
-                'dashicons dashicons-cart'
-            );
-        } else {
-            $this->_template_args['view_transaction_button'] = '';
-        }
-        if (
-            $attendee instanceof EE_Attendee
-            && $this->capabilities->current_user_can(
-                'ee_send_message',
-                'espresso_registrations_resend_registration'
-            )
-        ) {
-            $this->_template_args['resend_registration_button'] = EEH_Template::get_button_or_link(
-                EE_Admin_Page::add_query_args_and_nonce(
-                    [
-                        'action'      => 'resend_registration',
-                        '_REG_ID'     => $this->_registration->ID(),
-                        'redirect_to' => 'view_registration',
-                    ],
-                    REG_ADMIN_URL
-                ),
-                esc_html__(' Resend Registration', 'event_espresso'),
-                'button button--secondary right',
-                'dashicons dashicons-email-alt'
-            );
-        } else {
-            $this->_template_args['resend_registration_button'] = '';
-        }
-        $this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
-        $payment                               = $transaction->get_first_related('Payment');
-        $payment                               = ! $payment instanceof EE_Payment
-            ? EE_Payment::new_instance()
-            : $payment;
-        $payment_method                        = $payment->get_first_related('Payment_Method');
-        $payment_method                        = ! $payment_method instanceof EE_Payment_Method
-            ? EE_Payment_Method::new_instance()
-            : $payment_method;
-        $reg_details                           = [
-            'payment_method'       => $payment_method->name(),
-            'response_msg'         => $payment->gateway_response(),
-            'registration_id'      => $this->_registration->get('REG_code'),
-            'registration_session' => $this->_registration->session_ID(),
-            'ip_address'           => $this->session_data['ip_address'] ?? '',
-            'user_agent'           => $this->session_data['user_agent'] ?? '',
-        ];
-        if (isset($reg_details['registration_id'])) {
-            $this->_template_args['reg_details']['registration_id']['value'] = $reg_details['registration_id'];
-            $this->_template_args['reg_details']['registration_id']['label'] = esc_html__(
-                'Registration ID',
-                'event_espresso'
-            );
-            $this->_template_args['reg_details']['registration_id']['class'] = 'regular-text';
-        }
-        if (isset($reg_details['payment_method'])) {
-            $this->_template_args['reg_details']['payment_method']['value'] = $reg_details['payment_method'];
-            $this->_template_args['reg_details']['payment_method']['label'] = esc_html__(
-                'Most Recent Payment Method',
-                'event_espresso'
-            );
-            $this->_template_args['reg_details']['payment_method']['class'] = 'regular-text';
-            $this->_template_args['reg_details']['response_msg']['value']   = $reg_details['response_msg'];
-            $this->_template_args['reg_details']['response_msg']['label']   = esc_html__(
-                'Payment method response',
-                'event_espresso'
-            );
-            $this->_template_args['reg_details']['response_msg']['class']   = 'regular-text';
-        }
-        $this->_template_args['reg_details']['registration_session']['value'] = $reg_details['registration_session'];
-        $this->_template_args['reg_details']['registration_session']['label'] = esc_html__(
-            'Registration Session',
-            'event_espresso'
-        );
-        $this->_template_args['reg_details']['registration_session']['class'] = 'regular-text';
-        $this->_template_args['reg_details']['ip_address']['value']           = $reg_details['ip_address'];
-        $this->_template_args['reg_details']['ip_address']['label']           = esc_html__(
-            'Registration placed from IP',
-            'event_espresso'
-        );
-        $this->_template_args['reg_details']['ip_address']['class']           = 'regular-text';
-        $this->_template_args['reg_details']['user_agent']['value']           = $reg_details['user_agent'];
-        $this->_template_args['reg_details']['user_agent']['label']           = esc_html__(
-            'Registrant User Agent',
-            'event_espresso'
-        );
-        $this->_template_args['reg_details']['user_agent']['class']           = 'large-text';
-        $this->_template_args['event_link']                                   = EE_Admin_Page::add_query_args_and_nonce(
-            [
-                'action'   => 'default',
-                'event_id' => $this->_registration->event_ID(),
-            ],
-            REG_ADMIN_URL
-        );
-
-        $this->_template_args['REG_ID']   = $this->_registration->ID();
-        $this->_template_args['event_id'] = $this->_registration->event_ID();
-
-        $template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_details.template.php';
-        EEH_Template::display_template($template_path, $this->_template_args); // already escaped
-    }
-
-
-    /**
-     * generates HTML for the Registration Questions meta box.
-     * If pre-4.8.32.rc.000 hooks are used, uses old methods (with its filters),
-     * otherwise uses new forms system
-     *
-     * @return void
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    public function _reg_questions_meta_box()
-    {
-        // allow someone to override this method entirely
-        if (
-            apply_filters(
-                'FHEE__Registrations_Admin_Page___reg_questions_meta_box__do_default',
-                true,
-                $this,
-                $this->_registration
-            )
-        ) {
-            $form = $this->_get_reg_custom_questions_form(
-                $this->_registration->ID()
-            );
-
-            $this->_template_args['att_questions'] = count($form->subforms()) > 0
-                ? $form->get_html_and_js()
-                : '';
-
-            $this->_template_args['reg_questions_form_action'] = 'edit_registration';
-            $this->_template_args['REG_ID']                    = $this->_registration->ID();
-            $template_path                                     =
-                REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_questions.template.php';
-            EEH_Template::display_template($template_path, $this->_template_args);
-        }
-    }
-
-
-    /**
-     * form_before_question_group
-     *
-     * @param string $output
-     * @return        string
-     * @deprecated    as of 4.8.32.rc.000
-     */
-    public function form_before_question_group(string $output): string
-    {
-        EE_Error::doing_it_wrong(
-            __CLASS__ . '::' . __FUNCTION__,
-            esc_html__(
-                '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.',
-                'event_espresso'
-            ),
-            '4.8.32.rc.000'
-        );
-        return '
+	private ?EE_Registration $_registration = null;
+
+	private ?EE_Event $_reg_event = null;
+
+	private array $session_data = [];
+
+	private static array $_reg_status = [];
+
+	/**
+	 * Form for displaying the custom questions for this registration.
+	 * This gets used a few times throughout the request so it's best to cache it
+	 */
+	protected ?EE_Registration_Custom_Questions_Form $_reg_custom_questions_form = null;
+
+	private ?EEM_Registration $registration_model = null;
+
+	private ?EEM_Attendee $attendee_model = null;
+
+	private ?EEM_Event $event_model = null;
+
+	private ?EEM_Status $status_model = null;
+
+	/**
+	 * @var EE_Attendee|null
+	 */
+	protected $_cpt_model_obj;
+
+
+	/**
+	 * @param bool $routing
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	public function __construct($routing = true)
+	{
+		parent::__construct($routing);
+		$this->cpt_editpost_route = 'edit_attendee';
+		add_action('wp_loaded', [$this, 'wp_loaded']);
+	}
+
+
+	/**
+	 * @return EEM_Registration
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @since 4.10.2.p
+	 */
+	protected function getRegistrationModel(): EEM_Registration
+	{
+		if (! $this->registration_model instanceof EEM_Registration) {
+			$this->registration_model = $this->loader->getShared('EEM_Registration');
+		}
+		return $this->registration_model;
+	}
+
+
+	/**
+	 * @return EEM_Attendee
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @since 4.10.2.p
+	 */
+	protected function getAttendeeModel(): EEM_Attendee
+	{
+		if (! $this->attendee_model instanceof EEM_Attendee) {
+			$this->attendee_model = $this->loader->getShared('EEM_Attendee');
+		}
+		return $this->attendee_model;
+	}
+
+
+	/**
+	 * @return EEM_Event
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @since 4.10.2.p
+	 */
+	protected function getEventModel(): EEM_Event
+	{
+		if (! $this->event_model instanceof EEM_Event) {
+			$this->event_model = $this->loader->getShared('EEM_Event');
+		}
+		return $this->event_model;
+	}
+
+
+	/**
+	 * @return EEM_Status
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @since 4.10.2.p
+	 */
+	protected function getStatusModel(): EEM_Status
+	{
+		if (! $this->status_model instanceof EEM_Status) {
+			$this->status_model = $this->loader->getShared('EEM_Status');
+		}
+		return $this->status_model;
+	}
+
+
+	public function wp_loaded()
+	{
+		// when adding a new registration...
+		$action = $this->request->getRequestParam('action');
+		if ($action === 'new_registration') {
+			EE_System::do_not_cache();
+			if ($this->request->getRequestParam('processing_registration', 0, 'int') !== 1) {
+				// and it's NOT the attendee information reg step
+				// force cookie expiration by setting time to last week
+				setcookie('ee_registration_added', 0, time() - WEEK_IN_SECONDS, '/');
+				// and update the global
+				$_COOKIE['ee_registration_added'] = 0;
+			}
+		}
+	}
+
+
+	protected function _init_page_props()
+	{
+		$this->page_slug        = REG_PG_SLUG;
+		$this->_admin_base_url  = REG_ADMIN_URL;
+		$this->_admin_base_path = REG_ADMIN;
+		$this->page_label       = esc_html__('Registrations', 'event_espresso');
+		$this->_cpt_routes      = [
+			'add_new_attendee' => 'espresso_attendees',
+			'edit_attendee'    => 'espresso_attendees',
+			'insert_attendee'  => 'espresso_attendees',
+			'update_attendee'  => 'espresso_attendees',
+		];
+		$this->_cpt_model_names = [
+			'add_new_attendee' => 'EEM_Attendee',
+			'edit_attendee'    => 'EEM_Attendee',
+		];
+		$this->_cpt_edit_routes = [
+			'espresso_attendees' => 'edit_attendee',
+		];
+		$this->_pagenow_map     = [
+			'add_new_attendee' => 'post-new.php',
+			'edit_attendee'    => 'post.php',
+			'trash'            => 'post.php',
+		];
+		add_action('edit_form_after_title', [$this, 'after_title_form_fields']);
+		// add filters so that the comment urls don't take users to a confusing 404 page
+		add_filter('get_comment_link', [$this, 'clear_comment_link'], 10, 2);
+	}
+
+
+	/**
+	 * @param string     $link    The comment permalink with '#comment-$id' appended.
+	 * @param WP_Comment $comment The current comment object.
+	 * @return string
+	 */
+	public function clear_comment_link(string $link, WP_Comment $comment): string
+	{
+		// gotta make sure this only happens on this route
+		$post_type = get_post_type($comment->comment_post_ID);
+		if ($post_type === EspressoPostType::ATTENDEES) {
+			return '#commentsdiv';
+		}
+		return $link;
+	}
+
+
+	protected function _ajax_hooks()
+	{
+	}
+
+
+	protected function _define_page_props()
+	{
+		$this->_admin_page_title = $this->page_label;
+		$this->_labels           = [
+			'buttons'                      => [
+				'add-registrant'      => esc_html__('Add New Registration', 'event_espresso'),
+				'add-attendee'        => esc_html__('Add Contact', 'event_espresso'),
+				'edit'                => esc_html__('Edit Contact', 'event_espresso'),
+				'csv_reg_report'      => esc_html__('Registrations CSV Report', 'event_espresso'),
+				'contact_list_report' => esc_html__('Contact List Report', 'event_espresso'),
+				'contact_list_export' => esc_html__('Export Data', 'event_espresso'),
+			],
+			'publishbox'                   => [
+				'add_new_attendee' => esc_html__('Add Contact Record', 'event_espresso'),
+				'edit_attendee'    => esc_html__('Update Contact Record', 'event_espresso'),
+			],
+			'hide_add_button_on_cpt_route' => [
+				'edit_attendee' => true,
+			],
+		];
+	}
+
+
+	/**
+	 * grab url requests and route them
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function _set_page_routes()
+	{
+		$this->_get_registration_status_array();
+		$REG_ID             = $this->request->getRequestParam('_REG_ID', 0, 'int');
+		$REG_ID             = $this->request->getRequestParam('reg_status_change_form[REG_ID]', $REG_ID, 'int');
+		$ATT_ID             = $this->request->getRequestParam('ATT_ID', 0, 'int');
+		$ATT_ID             = $this->request->getRequestParam('post', $ATT_ID, 'int');
+		$this->_page_routes = [
+			'default'                             => [
+				'func'       => [$this, '_registrations_overview_list_table'],
+				'capability' => 'ee_read_registrations',
+			],
+			'view_registration'                   => [
+				'func'       => [$this, '_registration_details'],
+				'capability' => 'ee_read_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'edit_registration'                   => [
+				'func'       => [$this, '_update_attendee_registration_form'],
+				'noheader'           => true,
+				'headers_sent_route' => 'view_registration',
+				'capability'         => 'ee_edit_registration',
+				'obj_id'             => $REG_ID,
+				'_REG_ID'            => $REG_ID,
+			],
+			'trash_registrations'                 => [
+				'func'       => [$this, '_trash_or_restore_registrations'],
+				'args'       => ['trash' => true],
+				'noheader'   => true,
+				'capability' => 'ee_delete_registrations',
+			],
+			'restore_registrations'               => [
+				'func'       => [$this, '_trash_or_restore_registrations'],
+				'args'       => ['trash' => false],
+				'noheader'   => true,
+				'capability' => 'ee_delete_registrations',
+			],
+			'delete_registrations'                => [
+				'func'       => [$this, '_delete_registrations'],
+				'noheader'   => true,
+				'capability' => 'ee_delete_registrations',
+			],
+			'new_registration'                    => [
+				'func'       => [$this, 'new_registration'],
+				'capability' => 'ee_edit_registrations',
+			],
+			'process_reg_step'                    => [
+				'func'       => [$this, 'process_reg_step'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+			],
+			'redirect_to_txn'                     => [
+				'func'       => [$this, 'redirect_to_txn'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+			],
+			'change_reg_status'                   => [
+				'func'       => [$this, '_change_reg_status'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'approve_registration'                => [
+				'func'       => [$this, 'approve_registration'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'approve_and_notify_registration'     => [
+				'func'       => [$this, 'approve_registration'],
+				'noheader'   => true,
+				'args'       => [true],
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'approve_registrations'               => [
+				'func'       => [$this, 'bulk_action_on_registrations'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+				'args'       => ['approve'],
+			],
+			'approve_and_notify_registrations'    => [
+				'func'       => [$this, 'bulk_action_on_registrations'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+				'args'       => ['approve', true],
+			],
+			'decline_registration'                => [
+				'func'       => [$this, 'decline_registration'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'decline_and_notify_registration'     => [
+				'func'       => [$this, 'decline_registration'],
+				'noheader'   => true,
+				'args'       => [true],
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'decline_registrations'               => [
+				'func'       => [$this, 'bulk_action_on_registrations'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+				'args'       => ['decline'],
+			],
+			'decline_and_notify_registrations'    => [
+				'func'       => [$this, 'bulk_action_on_registrations'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+				'args'       => ['decline', true],
+			],
+			'pending_registration'                => [
+				'func'       => [$this, 'pending_registration'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'pending_and_notify_registration'     => [
+				'func'       => [$this, 'pending_registration'],
+				'noheader'   => true,
+				'args'       => [true],
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'pending_registrations'               => [
+				'func'       => [$this, 'bulk_action_on_registrations'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+				'args'       => ['pending'],
+			],
+			'pending_and_notify_registrations'    => [
+				'func'       => [$this, 'bulk_action_on_registrations'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+				'args'       => ['pending', true],
+			],
+			'no_approve_registration'             => [
+				'func'       => [$this, 'not_approve_registration'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'no_approve_and_notify_registration'  => [
+				'func'       => [$this, 'not_approve_registration'],
+				'noheader'   => true,
+				'args'       => [true],
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'no_approve_registrations'            => [
+				'func'       => [$this, 'bulk_action_on_registrations'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+				'args'       => ['not_approve'],
+			],
+			'no_approve_and_notify_registrations' => [
+				'func'       => [$this, 'bulk_action_on_registrations'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+				'args'       => ['not_approve', true],
+			],
+			'cancel_registration'                 => [
+				'func'       => [$this, 'cancel_registration'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'cancel_and_notify_registration'      => [
+				'func'       => [$this, 'cancel_registration'],
+				'noheader'   => true,
+				'args'       => [true],
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'cancel_registrations'                => [
+				'func'       => [$this, 'bulk_action_on_registrations'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+				'args'       => ['cancel'],
+			],
+			'cancel_and_notify_registrations'     => [
+				'func'       => [$this, 'bulk_action_on_registrations'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+				'args'       => ['cancel', true],
+			],
+			'wait_list_registration'              => [
+				'func'       => [$this, 'wait_list_registration'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'wait_list_and_notify_registration'   => [
+				'func'       => [$this, 'wait_list_registration'],
+				'noheader'   => true,
+				'args'       => [true],
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $REG_ID,
+			],
+			'contact_list'                        => [
+				'func'       => [$this, '_attendee_contact_list_table'],
+				'capability' => 'ee_read_contacts',
+			],
+			'add_new_attendee'                    => [
+				'func'       => [$this, '_create_new_cpt_item'],
+				'args' => [
+					'new_attendee' => true,
+					'capability'   => 'ee_edit_contacts',
+				],
+			],
+			'edit_attendee'                       => [
+				'func'       => [$this, '_edit_cpt_item'],
+				'capability' => 'ee_edit_contacts',
+				'obj_id'     => $ATT_ID,
+			],
+			'duplicate_attendee'                  => [
+				'func'       => [$this, '_duplicate_attendee'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_contacts',
+				'obj_id'     => $ATT_ID,
+			],
+			'insert_attendee'                     => [
+				'func'       => [$this, '_insert_or_update_attendee'],
+				'args'       => [
+					'new_attendee' => true,
+				],
+				'noheader'   => true,
+				'capability' => 'ee_edit_contacts',
+			],
+			'update_attendee'                     => [
+				'func'       => [$this, '_insert_or_update_attendee'],
+				'args'       => [
+					'new_attendee' => false,
+				],
+				'noheader'   => true,
+				'capability' => 'ee_edit_contacts',
+				'obj_id'     => $ATT_ID,
+			],
+			'trash_attendees'                     => [
+				'func'       => [$this, '_trash_or_restore_attendees'],
+				'args'       => [
+					'trash' => 'true',
+				],
+				'noheader'   => true,
+				'capability' => 'ee_delete_contacts',
+			],
+			'trash_attendee'                      => [
+				'func'       => [$this, '_trash_or_restore_attendees'],
+				'args'       => [
+					'trash' => true,
+				],
+				'noheader'   => true,
+				'capability' => 'ee_delete_contacts',
+				'obj_id'     => $ATT_ID,
+			],
+			'restore_attendees'                   => [
+				'func'       => [$this, '_trash_or_restore_attendees'],
+				'args'       => [
+					'trash' => false,
+				],
+				'noheader'   => true,
+				'capability' => 'ee_delete_contacts',
+				'obj_id'     => $ATT_ID,
+			],
+			'delete_attendee'                     => [
+				'func'       => [$this, 'deleteAttendees'],
+				'capability' => 'ee_delete_contacts',
+				'obj_id'     => $ATT_ID,
+				'noheader'   => true,
+			],
+			'delete_attendees'                    => [
+				'func'       => [$this, 'deleteAttendees'],
+				'capability' => 'ee_delete_contacts',
+				'noheader'   => true,
+			],
+			'resend_registration'                 => [
+				'func'       => [$this, '_resend_registration'],
+				'noheader'   => true,
+				'capability' => 'ee_send_message',
+			],
+			'registrations_report'                => [
+				'func'       => [$this, '_registrations_report'],
+				'noheader'   => true,
+				'capability' => 'ee_read_registrations',
+			],
+			'contact_list_export'                 => [
+				'func'       => [$this, '_contact_list_export'],
+				'noheader'   => true,
+				'capability' => 'export',
+			],
+			'contact_list_report'                 => [
+				'func'       => [$this, '_contact_list_report'],
+				'noheader'   => true,
+				'capability' => 'ee_read_contacts',
+			],
+		];
+	}
+
+
+	protected function _set_page_config()
+	{
+		$REG_ID             = $this->request->getRequestParam('_REG_ID', 0, 'int');
+		$ATT_ID             = $this->request->getRequestParam('ATT_ID', 0, 'int');
+		$this->_page_config = [
+			'default'           => [
+				'nav'           => [
+					'label' => esc_html__('Overview', 'event_espresso'),
+					'icon'  => 'dashicons-list-view',
+					'order' => 5,
+				],
+				'help_tabs'     => [
+					'registrations_overview_help_tab'                       => [
+						'title'    => esc_html__('Registrations Overview', 'event_espresso'),
+						'filename' => 'registrations_overview',
+					],
+					'registrations_overview_table_column_headings_help_tab' => [
+						'title'    => esc_html__('Registrations Table Column Headings', 'event_espresso'),
+						'filename' => 'registrations_overview_table_column_headings',
+					],
+					'registrations_overview_filters_help_tab'               => [
+						'title'    => esc_html__('Registration Filters', 'event_espresso'),
+						'filename' => 'registrations_overview_filters',
+					],
+					'registrations_overview_views_help_tab'                 => [
+						'title'    => esc_html__('Registration Views', 'event_espresso'),
+						'filename' => 'registrations_overview_views',
+					],
+					'registrations_regoverview_other_help_tab'              => [
+						'title'    => esc_html__('Registrations Other', 'event_espresso'),
+						'filename' => 'registrations_overview_other',
+					],
+				],
+				'list_table'    => 'EE_Registrations_List_Table',
+				'require_nonce' => false,
+			],
+			'view_registration' => [
+				'nav'           => [
+					'label'      => esc_html__('REG Details', 'event_espresso'),
+					'icon'       => 'dashicons-clipboard',
+					'order'      => 15,
+					'url'        => $REG_ID
+						? add_query_arg(['_REG_ID' => $REG_ID], $this->_current_page_view_url)
+						: $this->_admin_base_url,
+					'persistent' => false,
+				],
+				'help_tabs'     => [
+					'registrations_details_help_tab'                    => [
+						'title'    => esc_html__('Registration Details', 'event_espresso'),
+						'filename' => 'registrations_details',
+					],
+					'registrations_details_table_help_tab'              => [
+						'title'    => esc_html__('Registration Details Table', 'event_espresso'),
+						'filename' => 'registrations_details_table',
+					],
+					'registrations_details_form_answers_help_tab'       => [
+						'title'    => esc_html__('Registration Form Answers', 'event_espresso'),
+						'filename' => 'registrations_details_form_answers',
+					],
+					'registrations_details_registrant_details_help_tab' => [
+						'title'    => esc_html__('Contact Details', 'event_espresso'),
+						'filename' => 'registrations_details_registrant_details',
+					],
+				],
+				'metaboxes'     => array_merge(
+					$this->_default_espresso_metaboxes,
+					['_registration_details_metaboxes']
+				),
+				'require_nonce' => false,
+			],
+			'new_registration'  => [
+				'nav'           => [
+					'label'      => esc_html__('Add New Registration', 'event_espresso'),
+					'icon'       => 'dashicons-plus-alt',
+					'url'        => '#',
+					'order'      => 15,
+					'persistent' => false,
+				],
+				'metaboxes'     => $this->_default_espresso_metaboxes,
+				'labels'        => [
+					'publishbox' => esc_html__('Save Registration', 'event_espresso'),
+				],
+				'require_nonce' => false,
+			],
+			'add_new_attendee'  => [
+				'nav'           => [
+					'label'      => esc_html__('Add Contact', 'event_espresso'),
+					'icon'       => 'dashicons-plus-alt',
+					'order'      => 15,
+					'persistent' => false,
+				],
+				'metaboxes'     => array_merge(
+					$this->_default_espresso_metaboxes,
+					['_publish_post_box', 'attendee_editor_metaboxes']
+				),
+				'require_nonce' => false,
+			],
+			'edit_attendee'     => [
+				'nav'           => [
+					'label'      => esc_html__('Edit Contact', 'event_espresso'),
+					'icon'       => 'dashicons-edit-large',
+					'order'      => 15,
+					'persistent' => false,
+					'url'        => $ATT_ID
+						? add_query_arg(['ATT_ID' => $ATT_ID], $this->_current_page_view_url)
+						: $this->_admin_base_url,
+				],
+				'metaboxes'     => array_merge(
+					$this->_default_espresso_metaboxes,
+					['attendee_editor_metaboxes']
+				),
+				'require_nonce' => false,
+			],
+			'contact_list'      => [
+				'nav'           => [
+					'label' => esc_html__('Contact List', 'event_espresso'),
+					'icon'  => 'dashicons-id-alt',
+					'order' => 20,
+				],
+				'list_table'    => 'EE_Attendee_Contact_List_Table',
+				'help_tabs'     => [
+					'registrations_contact_list_help_tab'                       => [
+						'title'    => esc_html__('Registrations Contact List', 'event_espresso'),
+						'filename' => 'registrations_contact_list',
+					],
+					'registrations_contact-list_table_column_headings_help_tab' => [
+						'title'    => esc_html__('Contact List Table Column Headings', 'event_espresso'),
+						'filename' => 'registrations_contact_list_table_column_headings',
+					],
+					'registrations_contact_list_views_help_tab'                 => [
+						'title'    => esc_html__('Contact List Views', 'event_espresso'),
+						'filename' => 'registrations_contact_list_views',
+					],
+					'registrations_contact_list_other_help_tab'                 => [
+						'title'    => esc_html__('Contact List Other', 'event_espresso'),
+						'filename' => 'registrations_contact_list_other',
+					],
+				],
+				'metaboxes'     => [],
+				'require_nonce' => false,
+			],
+			// override default cpt routes
+			'create_new'        => '',
+			'edit'              => '',
+		];
+	}
+
+
+	/**
+	 * The below methods aren't used by this class currently
+	 */
+	protected function _add_screen_options()
+	{
+	}
+
+
+	protected function _add_feature_pointers()
+	{
+	}
+
+
+	public function admin_init()
+	{
+		EE_Registry::$i18n_js_strings['update_att_qstns'] = esc_html__(
+			'click "Update Registration Questions" to save your changes',
+			'event_espresso'
+		);
+		EE_Registry::$i18n_js_strings['confirm_update_reg_details'] = esc_html__(
+			"Are you sure you want to update the submitted registration form data? This cannot be undone.\nPress OK to proceed or Cancel to keep the current data.",
+		);
+	}
+
+
+	public function admin_notices()
+	{
+	}
+
+
+	public function admin_footer_scripts()
+	{
+	}
+
+
+	/**
+	 * get list of registration statuses
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function _get_registration_status_array()
+	{
+		self::$_reg_status = EEM_Registration::reg_status_array([], true);
+	}
+
+
+	/**
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @since 4.10.2.p
+	 */
+	protected function _add_screen_options_default()
+	{
+		$this->_per_page_screen_option();
+	}
+
+
+	/**
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @since 4.10.2.p
+	 */
+	protected function _add_screen_options_contact_list()
+	{
+		$page_title              = $this->_admin_page_title;
+		$this->_admin_page_title = esc_html__('Contacts', 'event_espresso');
+		$this->_per_page_screen_option();
+		$this->_admin_page_title = $page_title;
+	}
+
+
+	public function load_scripts_styles()
+	{
+		// style
+		wp_register_style(
+			'espresso_reg',
+			REG_ASSETS_URL . 'espresso_registrations_admin.css',
+			['ee-admin-css'],
+			EVENT_ESPRESSO_VERSION
+		);
+		wp_enqueue_style('espresso_reg');
+		// script
+		wp_register_script(
+			'espresso_reg',
+			REG_ASSETS_URL . 'espresso_registrations_admin.js',
+			['jquery-ui-datepicker', 'jquery-ui-draggable', 'ee_admin_js'],
+			EVENT_ESPRESSO_VERSION,
+			true
+		);
+		wp_enqueue_script('espresso_reg');
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @since 4.10.2.p
+	 */
+	public function load_scripts_styles_edit_attendee()
+	{
+		// stuff to only show up on our attendee edit details page.
+		$attendee_details_translations = [
+			'att_publish_text' => sprintf(
+			/* translators: The date and time */
+				wp_strip_all_tags(__('Created on: %s', 'event_espresso')),
+				'<b>' . $this->_cpt_model_obj->get_datetime('ATT_created') . '</b>'
+			),
+		];
+		wp_localize_script('espresso_reg', 'ATTENDEE_DETAILS', $attendee_details_translations);
+		wp_enqueue_script(JqueryAssetManager::JS_HANDLE_JQUERY_VALIDATE);
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @since 4.10.2.p
+	 */
+	public function load_scripts_styles_view_registration()
+	{
+		$this->_set_registration_object();
+		// styles
+		wp_enqueue_style('espresso-ui-theme');
+		// scripts
+		$this->_get_reg_custom_questions_form($this->_registration->ID());
+		$this->_reg_custom_questions_form->wp_enqueue_scripts();
+	}
+
+
+	public function load_scripts_styles_contact_list()
+	{
+		wp_dequeue_style('espresso_reg');
+		wp_register_style(
+			'espresso_att',
+			REG_ASSETS_URL . 'espresso_attendees_admin.css',
+			['ee-admin-css'],
+			EVENT_ESPRESSO_VERSION
+		);
+		wp_enqueue_style('espresso_att');
+	}
+
+
+	/**
+	 * @throws ReflectionException
+	 * @throws EE_Error
+	 */
+	public function load_scripts_styles_new_registration()
+	{
+		wp_register_script(
+			'ee-spco-for-admin',
+			REG_ASSETS_URL . 'spco_for_admin.js',
+			['underscore', 'jquery'],
+			EVENT_ESPRESSO_VERSION,
+			true
+		);
+		wp_enqueue_script('ee-spco-for-admin');
+		add_filter('FHEE__EED_Ticket_Selector__load_tckt_slctr_assets', '__return_true');
+		EE_Form_Section_Proper::wp_enqueue_scripts();
+		EED_Ticket_Selector::load_tckt_slctr_assets();
+	}
+
+
+	public function AHEE__EE_Admin_Page__route_admin_request_resend_registration()
+	{
+		add_filter('FHEE_load_EE_messages', '__return_true');
+	}
+
+
+	public function AHEE__EE_Admin_Page__route_admin_request_approve_registration()
+	{
+		add_filter('FHEE_load_EE_messages', '__return_true');
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @since 4.10.2.p
+	 */
+	protected function _set_list_table_views_default()
+	{
+		// for notification related bulk actions we need to make sure only active messengers have an option.
+		EED_Messages::set_autoloaders();
+		/** @type EE_Message_Resource_Manager $message_resource_manager */
+		$message_resource_manager = EE_Registry::instance()->load_lib('Message_Resource_Manager');
+		$active_mts               = $message_resource_manager->list_of_active_message_types();
+		// key= bulk_action_slug, value= message type.
+		$match_array = [
+			'approve_registrations'    => 'registration',
+			'decline_registrations'    => 'declined_registration',
+			'pending_registrations'    => 'pending_approval',
+			'no_approve_registrations' => 'not_approved_registration',
+			'cancel_registrations'     => 'cancelled_registration',
+		];
+		$can_send    = $this->capabilities->current_user_can(
+			'ee_send_message',
+			'batch_send_messages'
+		);
+		/** setup reg status bulk actions **/
+		$def_reg_status_actions['approve_registrations'] = esc_html__('Approve Registrations', 'event_espresso');
+		if ($can_send && in_array($match_array['approve_registrations'], $active_mts, true)) {
+			$def_reg_status_actions['approve_and_notify_registrations'] = esc_html__(
+				'Approve and Notify Registrations',
+				'event_espresso'
+			);
+		}
+		$def_reg_status_actions['decline_registrations'] = esc_html__('Decline Registrations', 'event_espresso');
+		if ($can_send && in_array($match_array['decline_registrations'], $active_mts, true)) {
+			$def_reg_status_actions['decline_and_notify_registrations'] = esc_html__(
+				'Decline and Notify Registrations',
+				'event_espresso'
+			);
+		}
+		$def_reg_status_actions['pending_registrations'] = esc_html__(
+			'Set Registrations to Pending Payment',
+			'event_espresso'
+		);
+		if ($can_send && in_array($match_array['pending_registrations'], $active_mts, true)) {
+			$def_reg_status_actions['pending_and_notify_registrations'] = esc_html__(
+				'Set Registrations to Pending Payment and Notify',
+				'event_espresso'
+			);
+		}
+		$def_reg_status_actions['no_approve_registrations'] = esc_html__(
+			'Set Registrations to Awaiting Review',
+			'event_espresso'
+		);
+		if ($can_send && in_array($match_array['no_approve_registrations'], $active_mts, true)) {
+			$def_reg_status_actions['no_approve_and_notify_registrations'] = esc_html__(
+				'Set Registrations to Awaiting Review and Notify',
+				'event_espresso'
+			);
+		}
+		$def_reg_status_actions['cancel_registrations'] = esc_html__('Cancel Registrations', 'event_espresso');
+		if ($can_send && in_array($match_array['cancel_registrations'], $active_mts, true)) {
+			$def_reg_status_actions['cancel_and_notify_registrations'] = esc_html__(
+				'Cancel Registrations and Notify',
+				'event_espresso'
+			);
+		}
+		$def_reg_status_actions = apply_filters(
+			'FHEE__Registrations_Admin_Page___set_list_table_views_default__def_reg_status_actions_array',
+			$def_reg_status_actions,
+			$active_mts,
+			$can_send
+		);
+
+		$current_time = current_time('timestamp');
+		$this->_views = [
+			'all'       => [
+				'slug'        => 'all',
+				'label'       => esc_html__('View All Registrations', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => array_merge(
+					$def_reg_status_actions,
+					[
+						'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
+					]
+				),
+			],
+			'today'     => [
+				'slug'        => 'today',
+				'label'       => sprintf(
+					esc_html__('Today - %s', 'event_espresso'),
+					date('M d, Y', $current_time)
+				),
+				'count'       => 0,
+				'bulk_action' => array_merge(
+					$def_reg_status_actions,
+					[
+						'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
+					]
+				),
+			],
+			'yesterday' => [
+				'slug'        => 'yesterday',
+				'label'       => sprintf(
+					esc_html__('Yesterday - %s', 'event_espresso'),
+					date('M d, Y', $current_time - DAY_IN_SECONDS)
+				),
+				'count'       => 0,
+				'bulk_action' => array_merge(
+					$def_reg_status_actions,
+					[
+						'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
+					]
+				),
+			],
+			'month'     => [
+				'slug'        => 'month',
+				'label'       => esc_html__('This Month', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => array_merge(
+					$def_reg_status_actions,
+					[
+						'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
+					]
+				),
+			],
+		];
+		if (
+			$this->capabilities->current_user_can(
+				'ee_delete_registrations',
+				'espresso_registrations_delete_registration'
+			)
+		) {
+			$this->_views['incomplete'] = [
+				'slug'        => 'incomplete',
+				'label'       => esc_html__('Incomplete', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => [
+					'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
+				],
+			];
+			$this->_views['trash']      = [
+				'slug'        => 'trash',
+				'label'       => esc_html__('Trash', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => [
+					'restore_registrations' => esc_html__('Restore Registrations', 'event_espresso'),
+					'delete_registrations'  => esc_html__('Delete Registrations Permanently', 'event_espresso'),
+				],
+			];
+		}
+	}
+
+
+	protected function _set_list_table_views_contact_list()
+	{
+		$this->_views = [
+			'in_use' => [
+				'slug'        => 'in_use',
+				'label'       => esc_html__('In Use', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => [
+					'trash_attendees' => esc_html__('Move to Trash', 'event_espresso'),
+				],
+			],
+		];
+		if (
+			$this->capabilities->current_user_can(
+				'ee_delete_contacts',
+				'espresso_registrations_trash_attendees'
+			)
+		) {
+			$this->_views['trash'] = [
+				'slug'        => 'trash',
+				'label'       => esc_html__('Trash', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => [
+					'restore_attendees' => esc_html__('Restore from Trash', 'event_espresso'),
+					'delete_attendees'  => esc_html__('Permanently Delete', 'event_espresso'),
+				],
+			];
+		}
+	}
+
+
+	/**
+	 * @return array
+	 * @throws EE_Error
+	 */
+	protected function _registration_legend_items(): array
+	{
+		$fc_items = [
+			'star-icon'        => [
+				'class' => 'dashicons dashicons-star-filled gold-icon',
+				'desc'  => esc_html__('This is the Primary Registrant', 'event_espresso'),
+			],
+			'view_details'     => [
+				'class' => 'dashicons dashicons-clipboard',
+				'desc'  => esc_html__('View Registration Details', 'event_espresso'),
+			],
+			'edit_attendee'    => [
+				'class' => 'dashicons dashicons-admin-users',
+				'desc'  => esc_html__('Edit Contact Details', 'event_espresso'),
+			],
+			'view_transaction' => [
+				'class' => 'dashicons dashicons-cart',
+				'desc'  => esc_html__('View Transaction Details', 'event_espresso'),
+			],
+			'view_invoice'     => [
+				'class' => 'dashicons dashicons-media-spreadsheet',
+				'desc'  => esc_html__('View Transaction Invoice', 'event_espresso'),
+			],
+		];
+		if (
+			$this->capabilities->current_user_can(
+				'ee_send_message',
+				'espresso_registrations_resend_registration'
+			)
+		) {
+			$fc_items['resend_registration'] = [
+				'class' => 'dashicons dashicons-email-alt',
+				'desc'  => esc_html__('Resend Registration Details', 'event_espresso'),
+			];
+		} else {
+			$fc_items['blank'] = ['class' => 'blank', 'desc' => ''];
+		}
+		if (
+			$this->capabilities->current_user_can(
+				'ee_read_global_messages',
+				'view_filtered_messages'
+			)
+		) {
+			$related_for_icon = EEH_MSG_Template::get_message_action_icon('see_notifications_for');
+			if (is_array($related_for_icon) && isset($related_for_icon['css_class'], $related_for_icon['label'])) {
+				$fc_items['view_related_messages'] = [
+					'class' => $related_for_icon['css_class'],
+					'desc'  => $related_for_icon['label'],
+				];
+			}
+		}
+		$sc_items = [
+			'approved_status'   => [
+				'class' => 'ee-status-legend ee-status-bg--' . RegStatus::APPROVED,
+				'desc'  => EEH_Template::pretty_status(
+					RegStatus::APPROVED,
+					false,
+					'sentence'
+				),
+			],
+			'pending_status'    => [
+				'class' => 'ee-status-legend ee-status-bg--' . RegStatus::PENDING_PAYMENT,
+				'desc'  => EEH_Template::pretty_status(
+					RegStatus::PENDING_PAYMENT,
+					false,
+					'sentence'
+				),
+			],
+			'wait_list'         => [
+				'class' => 'ee-status-legend ee-status-bg--' . RegStatus::WAIT_LIST,
+				'desc'  => EEH_Template::pretty_status(
+					RegStatus::WAIT_LIST,
+					false,
+					'sentence'
+				),
+			],
+			'incomplete_status' => [
+				'class' => 'ee-status-legend ee-status-bg--' . RegStatus::INCOMPLETE,
+				'desc'  => EEH_Template::pretty_status(
+					RegStatus::INCOMPLETE,
+					false,
+					'sentence'
+				),
+			],
+			'not_approved'      => [
+				'class' => 'ee-status-legend ee-status-bg--' . RegStatus::AWAITING_REVIEW,
+				'desc'  => EEH_Template::pretty_status(
+					RegStatus::AWAITING_REVIEW,
+					false,
+					'sentence'
+				),
+			],
+			'declined_status'   => [
+				'class' => 'ee-status-legend ee-status-bg--' . RegStatus::DECLINED,
+				'desc'  => EEH_Template::pretty_status(
+					RegStatus::DECLINED,
+					false,
+					'sentence'
+				),
+			],
+			'cancelled_status'  => [
+				'class' => 'ee-status-legend ee-status-bg--' . RegStatus::CANCELLED,
+				'desc'  => EEH_Template::pretty_status(
+					RegStatus::CANCELLED,
+					false,
+					'sentence'
+				),
+			],
+		];
+		return array_merge($fc_items, $sc_items);
+	}
+
+
+
+	/***************************************        REGISTRATION OVERVIEW        **************************************/
+
+
+	/**
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 */
+	protected function _registrations_overview_list_table()
+	{
+		$this->appendAddNewRegistrationButtonToPageTitle();
+		$header_text                  = '';
+		$admin_page_header_decorators = [
+			'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\AttendeeFilterHeader',
+			'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\EventFilterHeader',
+			'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\DateFilterHeader',
+			'EventEspresso\core\domain\services\admin\registrations\list_table\page_header\TicketFilterHeader',
+		];
+		foreach ($admin_page_header_decorators as $admin_page_header_decorator) {
+			$filter_header_decorator = $this->loader->getNew($admin_page_header_decorator);
+			$header_text             = $filter_header_decorator->getHeaderText($header_text);
+		}
+		$this->_template_args['before_list_table'] = $header_text;
+		$this->_template_args['after_list_table']  = $this->_display_legend($this->_registration_legend_items());
+		$this->display_admin_list_table_page_with_no_sidebar();
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 */
+	private function appendAddNewRegistrationButtonToPageTitle()
+	{
+		$EVT_ID = $this->request->getRequestParam('event_id', 0, 'int');
+		if (
+			$EVT_ID
+			&& $this->capabilities->current_user_can(
+				'ee_edit_registrations',
+				'espresso_registrations_new_registration',
+				$EVT_ID
+			)
+		) {
+			$this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
+					'new_registration',
+					'add-registrant',
+					['event_id' => $EVT_ID],
+					'add-new-h2'
+				);
+		}
+	}
+
+
+	/**
+	 * This sets the _registration property for the registration details screen
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	private function _set_registration_object()
+	{
+		// get out if we've already set the object
+		if ($this->_registration instanceof EE_Registration) {
+			return;
+		}
+		$REG_ID = $this->request->getRequestParam('_REG_ID', 0, 'int');
+		if ($this->_registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID)) {
+			return;
+		}
+		$error_msg = sprintf(
+			esc_html__(
+				'An error occurred and the details for Registration ID #%s could not be retrieved.',
+				'event_espresso'
+			),
+			$REG_ID
+		);
+		EE_Error::add_error($error_msg, __FILE__, __FUNCTION__, __LINE__);
+		$this->_registration = null;
+	}
+
+
+	/**
+	 * Used to retrieve registrations for the list table.
+	 *
+	 * @param int  $per_page
+	 * @param bool $count
+	 * @param bool $this_month
+	 * @param bool $today
+	 * @param bool $yesterday
+	 * @return EE_Registration[]|int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function get_registrations(
+		int $per_page = 10,
+		bool $count = false,
+		bool $this_month = false,
+		bool $today = false,
+		bool $yesterday = false
+	) {
+		if ($this_month) {
+			$this->request->setRequestParam('status', 'month');
+		}
+		if ($today) {
+			$this->request->setRequestParam('status', 'today');
+		}
+		if ($yesterday) {
+			$this->request->setRequestParam('status', 'yesterday');
+		}
+		$query_params = $this->_get_registration_query_parameters([], $per_page, $count);
+		/**
+		 * Override the default groupby added by EEM_Base so that sorts with multiple order bys work as expected
+		 *
+		 * @link https://events.codebasehq.com/projects/event-espresso/tickets/10093
+		 * @see  https://github.com/eventespresso/event-espresso-core/tree/master/docs/G--Model-System/model-query-params.md
+		 *                      or if you have the development copy of EE you can view this at the path:
+		 *                      /docs/G--Model-System/model-query-params.md
+		 */
+		$query_params['group_by'] = '';
+
+		return $count
+			? $this->getRegistrationModel()->count($query_params)
+			/** @type EE_Registration[] */
+			: $this->getRegistrationModel()->get_all($query_params);
+	}
+
+
+	/**
+	 * Retrieves the query parameters to be used by the Registration model for getting registrations.
+	 * Note: this listens to values on the request for some query parameters.
+	 *
+	 * @param array $request
+	 * @param int   $per_page
+	 * @param bool  $count
+	 * @return array
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 */
+	protected function _get_registration_query_parameters(
+		array $request = [],
+		int $per_page = 10,
+		bool $count = false
+	): array {
+		/** @var QueryBuilder $list_table_query_builder */
+		$list_table_query_builder = $this->loader->getNew(QueryBuilder::class, [null, null, $request]);
+		return $list_table_query_builder->getQueryParams($per_page, $count);
+	}
+
+
+	public function get_registration_status_array(): array
+	{
+		return self::$_reg_status;
+	}
+
+
+
+
+	/***************************************        REGISTRATION DETAILS        ***************************************/
+	/**
+	 * generates HTML for the View Registration Details Admin page
+	 *
+	 * @return void
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws EntityNotFoundException
+	 * @throws ReflectionException
+	 */
+	protected function _registration_details()
+	{
+		$this->_template_args = [];
+		$this->_set_registration_object();
+		if (is_object($this->_registration)) {
+			$transaction                                   = $this->_registration->transaction()
+				? $this->_registration->transaction()
+				: EE_Transaction::new_instance();
+			$this->session_data                            = $transaction->session_data();
+			$event_id                                      = $this->_registration->event_ID();
+			$this->_template_args['reg_nmbr']['value']     = $this->_registration->ID();
+			$this->_template_args['reg_nmbr']['label']     = esc_html__('Registration Number', 'event_espresso');
+			$this->_template_args['reg_datetime']['value'] = $this->_registration->get_i18n_datetime('REG_date');
+			$this->_template_args['reg_datetime']['label'] = esc_html__('Date', 'event_espresso');
+			$this->_template_args['grand_total']           = $transaction->total();
+			$this->_template_args['currency_sign']         = EE_Registry::instance()->CFG->currency->sign;
+			// link back to overview
+			$this->_template_args['reg_overview_url']            = REG_ADMIN_URL;
+			$this->_template_args['registration']                = $this->_registration;
+			$this->_template_args['filtered_registrations_link'] = EE_Admin_Page::add_query_args_and_nonce(
+				[
+					'action'   => 'default',
+					'event_id' => $event_id,
+				],
+				REG_ADMIN_URL
+			);
+			$this->_template_args['filtered_transactions_link']  = EE_Admin_Page::add_query_args_and_nonce(
+				[
+					'action' => 'default',
+					'EVT_ID' => $event_id,
+					'page'   => 'espresso_transactions',
+				],
+				admin_url('admin.php')
+			);
+			$this->_template_args['event_link']                  = EE_Admin_Page::add_query_args_and_nonce(
+				[
+					'page'   => 'espresso_events',
+					'action' => 'edit',
+					'post'   => $event_id,
+				],
+				admin_url('admin.php')
+			);
+			// next and previous links
+			$next_reg                                      = $this->_registration->next(
+				null,
+				[],
+				'REG_ID'
+			);
+			$this->_template_args['next_registration']     = $next_reg
+				? $this->_next_link(
+					EE_Admin_Page::add_query_args_and_nonce(
+						[
+							'action'  => 'view_registration',
+							'_REG_ID' => $next_reg['REG_ID'],
+						],
+						REG_ADMIN_URL
+					),
+					'dashicons dashicons-arrow-right ee-icon-size-22'
+				)
+				: '';
+			$previous_reg                                  = $this->_registration->previous(
+				null,
+				[],
+				'REG_ID'
+			);
+			$this->_template_args['previous_registration'] = $previous_reg
+				? $this->_previous_link(
+					EE_Admin_Page::add_query_args_and_nonce(
+						[
+							'action'  => 'view_registration',
+							'_REG_ID' => $previous_reg['REG_ID'],
+						],
+						REG_ADMIN_URL
+					),
+					'dashicons dashicons-arrow-left ee-icon-size-22'
+				)
+				: '';
+			// grab header
+			$template_path                             = REG_TEMPLATE_PATH . 'reg_admin_details_header.template.php';
+			$this->_template_args['REG_ID']            = $this->_registration->ID();
+			$this->_template_args['admin_page_header'] = EEH_Template::display_template(
+				$template_path,
+				$this->_template_args,
+				true
+			);
+		} else {
+			$this->_template_args['admin_page_header'] = '';
+			$this->_display_espresso_notices();
+		}
+		// the details template wrapper
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @since 4.10.2.p
+	 */
+	protected function _registration_details_metaboxes()
+	{
+		do_action('AHEE__Registrations_Admin_Page___registration_details_metabox__start', $this);
+		$this->_set_registration_object();
+		$attendee = $this->_registration instanceof EE_Registration ? $this->_registration->attendee() : null;
+		$this->addMetaBox(
+			'edit-reg-status-mbox',
+			esc_html__('Registration Status', 'event_espresso'),
+			[$this, 'set_reg_status_buttons_metabox'],
+			$this->_wp_page_slug
+		);
+		$this->addMetaBox(
+			'edit-reg-details-mbox',
+			'<span>' . esc_html__('Registration Details', 'event_espresso')
+			. '&nbsp;<span class="dashicons dashicons-clipboard"></span></span>',
+			[$this, '_reg_details_meta_box'],
+			$this->_wp_page_slug
+		);
+		if (
+			$attendee instanceof EE_Attendee
+			&& $this->capabilities->current_user_can(
+				'ee_read_registration',
+				'edit-reg-questions-mbox',
+				$this->_registration->ID()
+			)
+		) {
+			$this->addMetaBox(
+				'edit-reg-questions-mbox',
+				esc_html__('Registration Form Answers', 'event_espresso'),
+				[$this, '_reg_questions_meta_box'],
+				$this->_wp_page_slug
+			);
+		}
+		$this->addMetaBox(
+			'edit-reg-registrant-mbox',
+			esc_html__('Contact Details', 'event_espresso'),
+			[$this, '_reg_registrant_side_meta_box'],
+			$this->_wp_page_slug,
+			'side'
+		);
+		if ($this->_registration->group_size() > 1) {
+			$this->addMetaBox(
+				'edit-reg-attendees-mbox',
+				esc_html__('Other Registrations in this Transaction', 'event_espresso'),
+				[$this, '_reg_attendees_meta_box'],
+				$this->_wp_page_slug
+			);
+		}
+	}
+
+
+	/**
+	 * set_reg_status_buttons_metabox
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws DateMalformedStringException
+	 */
+	public function set_reg_status_buttons_metabox()
+	{
+		$this->_set_registration_object();
+		$change_reg_status_form = $this->_generate_reg_status_change_form();
+		$output                 = $change_reg_status_form->form_open(
+			self::add_query_args_and_nonce(
+				[
+					'action' => 'change_reg_status',
+				],
+				REG_ADMIN_URL
+			)
+		);
+		$output                 .= $change_reg_status_form->get_html();
+		$output                 .= $change_reg_status_form->form_close();
+		echo wp_kses($output, AllowedTags::getWithFormTags());
+	}
+
+
+	/**
+	 * @return EE_Form_Section_Proper
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws ReflectionException
+	 * @throws DateMalformedStringException
+	 */
+	protected function _generate_reg_status_change_form(): EE_Form_Section_Proper
+	{
+		$subsections = [
+			'return' => new EE_Hidden_Input(
+				[
+					'name'    => 'return',
+					'default' => 'view_registration',
+				]
+			),
+			'REG_ID' => new EE_Hidden_Input(
+				[
+					'name'    => 'REG_ID',
+					'default' => $this->_registration->ID(),
+				]
+			),
+		];
+
+		$status_changes = $this->_registration->get_extra_meta(EE_Registration::META_KEY_REG_STATUS_CHANGE);
+
+		if (! empty($status_changes)) {
+			$date_format = get_option('date_format', 'Y-m-d') . ' ' . get_option('time_format', 'H:i:s');
+			$html = EEH_HTML::tr();
+			$html .= EEH_HTML::th(
+				EEH_HTML::label(esc_html__('Registration Status Changes', 'event_espresso'))
+			);
+			$html .= EEH_HTML::td();
+			$html .= EEH_HTML::ul();
+			foreach ($status_changes as $status_change) {
+				$date = new DateTime('@' . $status_change['date']);
+				$reason = $status_change['reason'] ?: esc_html__('not specified', 'event_espresso');
+				$html .= EEH_HTML::li(
+					EEH_HTML::strong($date->format($date_format))
+					. EEH_HTML::br()
+					. EEH_HTML::span(
+						$status_change['change'],
+						'',
+						'',
+						'margin-inline-start: 1em;'
+					)
+					. EEH_HTML::br()
+					. EEH_HTML::span(
+						sprintf(
+							esc_html__('Reason: %1$s', 'event_espresso'),
+							$reason,
+						),
+						'',
+						'',
+						'margin-inline-start: 1em;'
+					)
+				);
+			}
+			$html .= EEH_HTML::ulx();
+			$html .= EEH_HTML::tdx();
+			$html .= EEH_HTML::trx();
+			$subsections['reg_cancellations'] = new EE_Form_Section_HTML($html, ['add_wrapper' => false]);
+		}
+
+
+		if (
+			$this->capabilities->current_user_can(
+				'ee_edit_registration',
+				'toggle_registration_status',
+				$this->_registration->ID()
+			)
+		) {
+			$subsections['reg_status']         = new EE_Select_Input(
+				$this->_get_reg_statuses(),
+				[
+					'html_label_text' => esc_html__('Change Registration Status to', 'event_espresso'),
+					'default'         => $this->_registration->status_ID(),
+					'html_class'      => 'ee-input-width--small',
+				]
+			);
+			$subsections['reason']         = new EE_Text_Input(
+				[
+					'html_label_text' => esc_html__('Reason for Registration Status Change', 'event_espresso')
+				]
+			);
+			$subsections['send_notifications'] = new EE_Yes_No_Input(
+				[
+					'html_label_text' => esc_html__('Send Related Messages', 'event_espresso'),
+					'default'         => false,
+					'html_help_text'  => esc_html__(
+						'If set to "Yes", then the related messages will be sent to the registrant.',
+						'event_espresso'
+					),
+				]
+			);
+			$subsections['submit']             = new EE_Submit_Input(
+				[
+					'html_class'      => 'button--primary',
+					'html_label_text' => '&nbsp;',
+					'default'         => esc_html__('Update Registration Status', 'event_espresso'),
+				]
+			);
+		}
+		return new EE_Form_Section_Proper(
+			[
+			  'name'            => 'reg_status_change_form',
+			  'html_id'         => 'reg-status-change-form',
+			  'layout_strategy' => new EE_Admin_Two_Column_Layout(),
+			  'subsections'     => $subsections
+			]
+		);
+	}
+
+
+	/**
+	 * Returns an array of all the buttons for the various statuses and switch status actions
+	 *
+	 * @return array
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws EntityNotFoundException
+	 * @throws ReflectionException
+	 */
+	protected function _get_reg_statuses(): array
+	{
+		$reg_status_array = $this->getRegistrationModel()->reg_status_array();
+		unset($reg_status_array[ RegStatus::INCOMPLETE ]);
+		// get current reg status
+		$current_status = $this->_registration->status_ID();
+		// is registration for free event? This will determine whether to display the pending payment option
+		if (
+			$current_status !== RegStatus::PENDING_PAYMENT
+			&& EEH_Money::compare_floats($this->_registration->ticket()->price(), 0.00)
+		) {
+			unset($reg_status_array[ RegStatus::PENDING_PAYMENT ]);
+		}
+		return $this->getStatusModel()->localized_status($reg_status_array, false, 'sentence');
+	}
+
+
+	/**
+	 * This method is used when using _REG_ID from request which may or may not be an array of reg_ids.
+	 *
+	 * @param string $status REG status given for changing registrations to.
+	 * @param bool $notify Whether to send messages notifications or not.
+	 * @return array (array with reg_id(s) updated and whether update was successful.
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 */
+	protected function _set_registration_status_from_request(string $status = '', bool $notify = false): array
+	{
+		$REG_IDs = $this->request->requestParamIsSet('reg_status_change_form')
+			? $this->request->getRequestParam('reg_status_change_form[REG_ID]', [], 'int', true)
+			: $this->request->getRequestParam('_REG_ID', [], 'int', true);
+
+		// sanitize $REG_IDs
+		$REG_IDs = array_map('absint', $REG_IDs);
+		// and remove empty entries
+		$REG_IDs = array_filter($REG_IDs);
+
+		$result = $this->_set_registration_status($REG_IDs, $status, $notify);
+
+		/**
+		 * Set and filter $_req_data['_REG_ID'] for any potential future messages notifications.
+		 * Currently this value is used downstream by the _process_resend_registration method.
+		 *
+		 * @param int|array                $registration_ids The registration ids that have had their status changed successfully.
+		 * @param bool                     $status           The status registrations were changed to.
+		 * @param bool                     $success          If the status was changed successfully for all registrations.
+		 * @param Registrations_Admin_Page $admin_page
+		 */
+		$REG_ID = apply_filters(
+			'FHEE__Registrations_Admin_Page___set_registration_status_from_request__REG_IDs',
+			$result['REG_ID'],
+			$status,
+			$result['success'],
+			$this
+		);
+		$this->request->setRequestParam('_REG_ID', $REG_ID);
+
+		// notify?
+		if (
+			$notify
+			&& $result['success']
+			&& ! empty($REG_ID)
+			&& $this->capabilities->current_user_can(
+				'ee_send_message',
+				'espresso_registrations_resend_registration'
+			)
+		) {
+			$this->_process_resend_registration();
+		}
+		return $result;
+	}
+
+
+	/**
+	 * Set the registration status for the given reg_id (which may or may not be an array, it gets typecast to an
+	 * array). Note, this method does NOT take care of possible notifications.  That is required by calling code.
+	 *
+	 * @param array  $REG_IDs
+	 * @param string $status
+	 * @param bool   $notify Used to indicate whether notification was requested or not.  This determines the context
+	 *                       slug sent with setting the registration status.
+	 * @return array (an array with 'success' key representing whether status change was successful, and 'REG_ID' as
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 * @throws EntityNotFoundException
+	 * @throws DomainException
+	 */
+	protected function _set_registration_status(array $REG_IDs = [], string $status = '', bool $notify = false): array
+	{
+		global $current_user;
+		$admin_name = $current_user->display_name;
+		$reason = $this->request->getRequestParam('reg_status_change_form[reason]');
+		if (empty($REG_IDs)) {
+			return ['REG_ID' => $REG_IDs, 'success' => false];
+		}
+		$success = true;
+		// set default status if none is passed
+		$status         = $status ?: RegStatus::PENDING_PAYMENT;
+		$status_context = $notify
+			? Domain::CONTEXT_REGISTRATION_STATUS_CHANGE_REGISTRATION_ADMIN_NOTIFY
+			: Domain::CONTEXT_REGISTRATION_STATUS_CHANGE_REGISTRATION_ADMIN;
+		// loop through REG_ID's and change status
+		foreach ($REG_IDs as $REG_ID) {
+			$registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
+			if ($registration instanceof EE_Registration) {
+				$updated = $registration->set_status(
+					$status,
+					false,
+					new Context(
+						$status_context,
+						esc_html__(
+							'Manually triggered status change on a Registration Admin Page route.',
+							'event_espresso'
+						)
+					)
+				);
+				$registration->add_extra_meta(
+					EE_Registration::META_KEY_REG_STATUS_CHANGE,
+					[
+						'date'   => time(),
+						'change' => sprintf(
+							esc_html__('changed to "%1$s" by %2$s', 'event_espresso'),
+							EEH_Template::pretty_status($status, false, 'sentence'),
+							$admin_name
+						),
+						'reason' => $reason,
+					]
+				);
+				$registration->save();
+				// verifying explicit fails because update *may* just return 0 for 0 rows affected
+				$success = $updated && $success;
+			}
+		}
+
+		// return $success and processed registrations
+		return ['REG_ID' => $REG_IDs, 'success' => $success];
+	}
+
+
+	/**
+	 * Common logic for setting up success message and redirecting to appropriate route
+	 *
+	 * @param string $STS_ID status id for the registration changed to
+	 * @param bool   $notify indicates whether the _set_registration_status_from_request does notifications or not.
+	 * @return void
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 */
+	protected function _reg_status_change_return(string $STS_ID, bool $notify = false)
+	{
+		$result  = ! empty($STS_ID)
+			? $this->_set_registration_status_from_request($STS_ID, $notify)
+			: ['success' => false];
+		$success = isset($result['success']) && $result['success'];
+		// setup success message
+		if ($success) {
+			if (is_array($result['REG_ID']) && count($result['REG_ID']) === 1) {
+				$msg = sprintf(
+					esc_html__('Registration status has been set to %s', 'event_espresso'),
+					EEH_Template::pretty_status($STS_ID, false, 'lower')
+				);
+			} else {
+				$msg = sprintf(
+					esc_html__('Registrations have been set to %s.', 'event_espresso'),
+					EEH_Template::pretty_status($STS_ID, false, 'lower')
+				);
+			}
+			EE_Error::add_success($msg);
+		} else {
+			EE_Error::add_error(
+				esc_html__(
+					'Something went wrong, and the status was not changed',
+					'event_espresso'
+				),
+				__FILE__,
+				__LINE__,
+				__FUNCTION__
+			);
+		}
+		$return = $this->request->getRequestParam('return');
+		$route  = $return === 'view_registration'
+			? ['action' => 'view_registration', '_REG_ID' => reset($result['REG_ID'])]
+			: ['action' => 'default'];
+		$route  = $this->mergeExistingRequestParamsWithRedirectArgs($route);
+		$this->_redirect_after_action($success, '', '', $route, true);
+	}
+
+
+	/**
+	 * incoming reg status change from reg details page.
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 * @throws DomainException
+	 */
+	protected function _change_reg_status()
+	{
+		$this->request->setRequestParam('return', 'view_registration');
+		// set notify based on whether the send notifications toggle is set or not
+		$notify     = $this->request->getRequestParam('reg_status_change_form[send_notifications]', false, 'bool');
+		$reg_status = $this->request->getRequestParam('reg_status_change_form[reg_status]', '');
+
+		switch ($reg_status) {
+			case RegStatus::APPROVED:
+			case EEH_Template::pretty_status(RegStatus::APPROVED, false, 'sentence'):
+				$this->approve_registration($notify);
+				break;
+			case RegStatus::PENDING_PAYMENT:
+			case EEH_Template::pretty_status(RegStatus::PENDING_PAYMENT, false, 'sentence'):
+				$this->pending_registration($notify);
+				break;
+			case RegStatus::AWAITING_REVIEW:
+			case EEH_Template::pretty_status(RegStatus::AWAITING_REVIEW, false, 'sentence'):
+				$this->not_approve_registration($notify);
+				break;
+			case RegStatus::DECLINED:
+			case EEH_Template::pretty_status(RegStatus::DECLINED, false, 'sentence'):
+				$this->decline_registration($notify);
+				break;
+			case RegStatus::CANCELLED:
+			case EEH_Template::pretty_status(RegStatus::CANCELLED, false, 'sentence'):
+				$this->cancel_registration($notify);
+				break;
+			case RegStatus::WAIT_LIST:
+			case EEH_Template::pretty_status(RegStatus::WAIT_LIST, false, 'sentence'):
+				$this->wait_list_registration($notify);
+				break;
+			case RegStatus::INCOMPLETE:
+			default:
+				$this->request->unSetRequestParam('return');
+				$this->_reg_status_change_return('');
+				break;
+		}
+	}
+
+
+	/**
+	 * Callback for bulk action routes.
+	 * Note: although we could just register the singular route callbacks for each bulk action route as well, this
+	 * method was chosen so there is one central place all the registration status bulk actions are going through.
+	 * Potentially, this provides an easier place to locate logic that is specific to these bulk actions (as opposed to
+	 * when an action is happening on just a single registration).
+	 *
+	 * @param string $action
+	 * @param bool   $notify
+	 */
+	protected function bulk_action_on_registrations(string $action, bool $notify = false)
+	{
+		do_action(
+			'AHEE__Registrations_Admin_Page__bulk_action_on_registrations__before_execution',
+			$this,
+			$action,
+			$notify
+		);
+		$method = $action . '_registration';
+		if (method_exists($this, $method)) {
+			$this->$method($notify);
+		}
+	}
+
+
+	/**
+	 * approve_registration
+	 *
+	 * @param bool $notify whether to notify the registrant about their approval.
+	 * @return void
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 * @throws DomainException
+	 */
+	protected function approve_registration(bool $notify = false)
+	{
+		$this->_reg_status_change_return(RegStatus::APPROVED, $notify);
+	}
+
+
+	/**
+	 * decline_registration
+	 *
+	 * @param bool $notify whether to notify the registrant about their status change.
+	 * @return void
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 * @throws DomainException
+	 */
+	protected function decline_registration(bool $notify = false)
+	{
+		$this->_reg_status_change_return(RegStatus::DECLINED, $notify);
+	}
+
+
+	/**
+	 * cancel_registration
+	 *
+	 * @param bool $notify whether to notify the registrant about their status change.
+	 * @return void
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 * @throws DomainException
+	 */
+	protected function cancel_registration(bool $notify = false)
+	{
+		$this->_reg_status_change_return(RegStatus::CANCELLED, $notify);
+	}
+
+
+	/**
+	 * not_approve_registration
+	 *
+	 * @param bool $notify whether to notify the registrant about their status change.
+	 * @return void
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 * @throws DomainException
+	 */
+	protected function not_approve_registration(bool $notify = false)
+	{
+		$this->_reg_status_change_return(RegStatus::AWAITING_REVIEW, $notify);
+	}
+
+
+	/**
+	 * decline_registration
+	 *
+	 * @param bool $notify whether to notify the registrant about their status change.
+	 * @return void
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 * @throws DomainException
+	 */
+	protected function pending_registration(bool $notify = false)
+	{
+		$this->_reg_status_change_return(RegStatus::PENDING_PAYMENT, $notify);
+	}
+
+
+	/**
+	 * waitlist_registration
+	 *
+	 * @param bool $notify whether to notify the registrant about their status change.
+	 * @return void
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 * @throws DomainException
+	 */
+	protected function wait_list_registration(bool $notify = false)
+	{
+		$this->_reg_status_change_return(RegStatus::WAIT_LIST, $notify);
+	}
+
+
+	/**
+	 * generates HTML for the Registration main meta box
+	 *
+	 * @return void
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws EntityNotFoundException
+	 */
+	public function _reg_details_meta_box()
+	{
+		EEH_Autoloader::register_line_item_display_autoloaders();
+		EEH_Autoloader::register_line_item_filter_autoloaders();
+
+		$transaction        = $this->_registration->transaction()
+			? $this->_registration->transaction()
+			: EE_Transaction::new_instance();
+		$this->session_data = $transaction->session_data();
+		$filters            = new EE_Line_Item_Filter_Collection();
+		$filters->add(new EE_Single_Registration_Line_Item_Filter($this->_registration));
+		$filters->add(new EE_Non_Zero_Line_Item_Filter());
+		$line_item_filter_processor              = new EE_Line_Item_Filter_Processor(
+			$filters,
+			$transaction->total_line_item()
+		);
+		$filtered_line_item_tree                 = $line_item_filter_processor->process();
+		$line_item_display                       = new EE_Line_Item_Display(
+			'reg_admin_table',
+			'EE_Admin_Table_Registration_Line_Item_Display_Strategy'
+		);
+		$this->_template_args['line_item_table'] = $line_item_display->display_line_item(
+			$filtered_line_item_tree,
+			['EE_Registration' => $this->_registration]
+		);
+		$attendee                                = $this->_registration->attendee();
+		if (
+			$this->capabilities->current_user_can(
+				'ee_read_transaction',
+				'espresso_transactions_view_transaction'
+			)
+		) {
+			$this->_template_args['view_transaction_button'] = EEH_Template::get_button_or_link(
+				EE_Admin_Page::add_query_args_and_nonce(
+					[
+						'action' => 'view_transaction',
+						'TXN_ID' => $transaction->ID(),
+					],
+					TXN_ADMIN_URL
+				),
+				esc_html__(' View Transaction', 'event_espresso'),
+				'button button--secondary right',
+				'dashicons dashicons-cart'
+			);
+		} else {
+			$this->_template_args['view_transaction_button'] = '';
+		}
+		if (
+			$attendee instanceof EE_Attendee
+			&& $this->capabilities->current_user_can(
+				'ee_send_message',
+				'espresso_registrations_resend_registration'
+			)
+		) {
+			$this->_template_args['resend_registration_button'] = EEH_Template::get_button_or_link(
+				EE_Admin_Page::add_query_args_and_nonce(
+					[
+						'action'      => 'resend_registration',
+						'_REG_ID'     => $this->_registration->ID(),
+						'redirect_to' => 'view_registration',
+					],
+					REG_ADMIN_URL
+				),
+				esc_html__(' Resend Registration', 'event_espresso'),
+				'button button--secondary right',
+				'dashicons dashicons-email-alt'
+			);
+		} else {
+			$this->_template_args['resend_registration_button'] = '';
+		}
+		$this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
+		$payment                               = $transaction->get_first_related('Payment');
+		$payment                               = ! $payment instanceof EE_Payment
+			? EE_Payment::new_instance()
+			: $payment;
+		$payment_method                        = $payment->get_first_related('Payment_Method');
+		$payment_method                        = ! $payment_method instanceof EE_Payment_Method
+			? EE_Payment_Method::new_instance()
+			: $payment_method;
+		$reg_details                           = [
+			'payment_method'       => $payment_method->name(),
+			'response_msg'         => $payment->gateway_response(),
+			'registration_id'      => $this->_registration->get('REG_code'),
+			'registration_session' => $this->_registration->session_ID(),
+			'ip_address'           => $this->session_data['ip_address'] ?? '',
+			'user_agent'           => $this->session_data['user_agent'] ?? '',
+		];
+		if (isset($reg_details['registration_id'])) {
+			$this->_template_args['reg_details']['registration_id']['value'] = $reg_details['registration_id'];
+			$this->_template_args['reg_details']['registration_id']['label'] = esc_html__(
+				'Registration ID',
+				'event_espresso'
+			);
+			$this->_template_args['reg_details']['registration_id']['class'] = 'regular-text';
+		}
+		if (isset($reg_details['payment_method'])) {
+			$this->_template_args['reg_details']['payment_method']['value'] = $reg_details['payment_method'];
+			$this->_template_args['reg_details']['payment_method']['label'] = esc_html__(
+				'Most Recent Payment Method',
+				'event_espresso'
+			);
+			$this->_template_args['reg_details']['payment_method']['class'] = 'regular-text';
+			$this->_template_args['reg_details']['response_msg']['value']   = $reg_details['response_msg'];
+			$this->_template_args['reg_details']['response_msg']['label']   = esc_html__(
+				'Payment method response',
+				'event_espresso'
+			);
+			$this->_template_args['reg_details']['response_msg']['class']   = 'regular-text';
+		}
+		$this->_template_args['reg_details']['registration_session']['value'] = $reg_details['registration_session'];
+		$this->_template_args['reg_details']['registration_session']['label'] = esc_html__(
+			'Registration Session',
+			'event_espresso'
+		);
+		$this->_template_args['reg_details']['registration_session']['class'] = 'regular-text';
+		$this->_template_args['reg_details']['ip_address']['value']           = $reg_details['ip_address'];
+		$this->_template_args['reg_details']['ip_address']['label']           = esc_html__(
+			'Registration placed from IP',
+			'event_espresso'
+		);
+		$this->_template_args['reg_details']['ip_address']['class']           = 'regular-text';
+		$this->_template_args['reg_details']['user_agent']['value']           = $reg_details['user_agent'];
+		$this->_template_args['reg_details']['user_agent']['label']           = esc_html__(
+			'Registrant User Agent',
+			'event_espresso'
+		);
+		$this->_template_args['reg_details']['user_agent']['class']           = 'large-text';
+		$this->_template_args['event_link']                                   = EE_Admin_Page::add_query_args_and_nonce(
+			[
+				'action'   => 'default',
+				'event_id' => $this->_registration->event_ID(),
+			],
+			REG_ADMIN_URL
+		);
+
+		$this->_template_args['REG_ID']   = $this->_registration->ID();
+		$this->_template_args['event_id'] = $this->_registration->event_ID();
+
+		$template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_details.template.php';
+		EEH_Template::display_template($template_path, $this->_template_args); // already escaped
+	}
+
+
+	/**
+	 * generates HTML for the Registration Questions meta box.
+	 * If pre-4.8.32.rc.000 hooks are used, uses old methods (with its filters),
+	 * otherwise uses new forms system
+	 *
+	 * @return void
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	public function _reg_questions_meta_box()
+	{
+		// allow someone to override this method entirely
+		if (
+			apply_filters(
+				'FHEE__Registrations_Admin_Page___reg_questions_meta_box__do_default',
+				true,
+				$this,
+				$this->_registration
+			)
+		) {
+			$form = $this->_get_reg_custom_questions_form(
+				$this->_registration->ID()
+			);
+
+			$this->_template_args['att_questions'] = count($form->subforms()) > 0
+				? $form->get_html_and_js()
+				: '';
+
+			$this->_template_args['reg_questions_form_action'] = 'edit_registration';
+			$this->_template_args['REG_ID']                    = $this->_registration->ID();
+			$template_path                                     =
+				REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_questions.template.php';
+			EEH_Template::display_template($template_path, $this->_template_args);
+		}
+	}
+
+
+	/**
+	 * form_before_question_group
+	 *
+	 * @param string $output
+	 * @return        string
+	 * @deprecated    as of 4.8.32.rc.000
+	 */
+	public function form_before_question_group(string $output): string
+	{
+		EE_Error::doing_it_wrong(
+			__CLASS__ . '::' . __FUNCTION__,
+			esc_html__(
+				'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.',
+				'event_espresso'
+			),
+			'4.8.32.rc.000'
+		);
+		return '
 	<table class="form-table ee-width-100">
 		<tbody>
 			';
-    }
-
-
-    /**
-     * form_after_question_group
-     *
-     * @param string $output
-     * @return        string
-     * @deprecated    as of 4.8.32.rc.000
-     */
-    public function form_after_question_group(string $output): string
-    {
-        EE_Error::doing_it_wrong(
-            __CLASS__ . '::' . __FUNCTION__,
-            esc_html__(
-                '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.',
-                'event_espresso'
-            ),
-            '4.8.32.rc.000'
-        );
-        return '
+	}
+
+
+	/**
+	 * form_after_question_group
+	 *
+	 * @param string $output
+	 * @return        string
+	 * @deprecated    as of 4.8.32.rc.000
+	 */
+	public function form_after_question_group(string $output): string
+	{
+		EE_Error::doing_it_wrong(
+			__CLASS__ . '::' . __FUNCTION__,
+			esc_html__(
+				'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.',
+				'event_espresso'
+			),
+			'4.8.32.rc.000'
+		);
+		return '
 			<tr class="hide-if-no-js">
 				<th> </th>
 				<td class="reg-admin-edit-attendee-question-td">
 					<a class="reg-admin-edit-attendee-question-lnk" href="#" aria-label="'
-            . esc_attr__('click to edit question', 'event_espresso')
-            . '">
+			. esc_attr__('click to edit question', 'event_espresso')
+			. '">
 						<span class="reg-admin-edit-question-group-spn lt-grey-txt">'
-            . esc_html__('edit the above question group', 'event_espresso')
-            . '</span>
+			. esc_html__('edit the above question group', 'event_espresso')
+			. '</span>
 						<div class="dashicons dashicons-edit"></div>
 					</a>
 				</td>
@@ -2312,631 +2312,631 @@ 
 		</tbody>
 	</table>
 ';
-    }
-
-
-    /**
-     * form_form_field_label_wrap
-     *
-     * @param string $label
-     * @return        string
-     * @deprecated    as of 4.8.32.rc.000
-     */
-    public function form_form_field_label_wrap(string $label): string
-    {
-        EE_Error::doing_it_wrong(
-            __CLASS__ . '::' . __FUNCTION__,
-            esc_html__(
-                '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.',
-                'event_espresso'
-            ),
-            '4.8.32.rc.000'
-        );
-        return '
+	}
+
+
+	/**
+	 * form_form_field_label_wrap
+	 *
+	 * @param string $label
+	 * @return        string
+	 * @deprecated    as of 4.8.32.rc.000
+	 */
+	public function form_form_field_label_wrap(string $label): string
+	{
+		EE_Error::doing_it_wrong(
+			__CLASS__ . '::' . __FUNCTION__,
+			esc_html__(
+				'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.',
+				'event_espresso'
+			),
+			'4.8.32.rc.000'
+		);
+		return '
 			<tr>
 				<th>
 					' . $label . '
 				</th>';
-    }
-
-
-    /**
-     * form_form_field_input__wrap
-     *
-     * @param string $input
-     * @return        string
-     * @deprecated    as of 4.8.32.rc.000
-     */
-    public function form_form_field_input__wrap(string $input): string
-    {
-        EE_Error::doing_it_wrong(
-            __CLASS__ . '::' . __FUNCTION__,
-            esc_html__(
-                '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.',
-                'event_espresso'
-            ),
-            '4.8.32.rc.000'
-        );
-        return '
+	}
+
+
+	/**
+	 * form_form_field_input__wrap
+	 *
+	 * @param string $input
+	 * @return        string
+	 * @deprecated    as of 4.8.32.rc.000
+	 */
+	public function form_form_field_input__wrap(string $input): string
+	{
+		EE_Error::doing_it_wrong(
+			__CLASS__ . '::' . __FUNCTION__,
+			esc_html__(
+				'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.',
+				'event_espresso'
+			),
+			'4.8.32.rc.000'
+		);
+		return '
 				<td class="reg-admin-attendee-questions-input-td disabled-input">
 					' . $input . '
 				</td>
 			</tr>';
-    }
-
-
-    /**
-     * Updates the registration's custom questions according to the form info, if the form is submitted.
-     * If it's not a post, the "view_registrations" route will be called next on the SAME request
-     * to display the page
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    protected function _update_attendee_registration_form()
-    {
-        do_action('AHEE__Registrations_Admin_Page___update_attendee_registration_form__start', $this);
-        if ($_SERVER['REQUEST_METHOD'] === 'POST') {
-            $REG_ID  = $this->request->getRequestParam('_REG_ID', 0, 'int');
-            $success = $this->_save_reg_custom_questions_form($REG_ID);
-            if ($success) {
-                $what  = esc_html__('Registration Form', 'event_espresso');
-                $route = $REG_ID
-                    ? ['action' => 'view_registration', '_REG_ID' => $REG_ID]
-                    : ['action' => 'default'];
-                $this->_redirect_after_action(true, $what, esc_html__('updated', 'event_espresso'), $route);
-            }
-        }
-    }
-
-
-    /**
-     * Gets the form for saving registrations custom questions (if done
-     * previously retrieves the cached form object, which may have validation errors in it)
-     *
-     * @param int $REG_ID
-     * @return EE_Registration_Custom_Questions_Form
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    protected function _get_reg_custom_questions_form(int $REG_ID): EE_Registration_Custom_Questions_Form
-    {
-        if (! $this->_reg_custom_questions_form) {
-            require_once(REG_ADMIN . 'form_sections/EE_Registration_Custom_Questions_Form.form.php');
-            $this->_reg_custom_questions_form = new EE_Registration_Custom_Questions_Form(
-                $this->getRegistrationModel()->get_one_by_ID($REG_ID)
-            );
-            $this->_reg_custom_questions_form->_construct_finalize(null, null);
-        }
-        return $this->_reg_custom_questions_form;
-    }
-
-
-    /**
-     * Saves
-     *
-     * @param bool $REG_ID
-     * @return bool
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    private function _save_reg_custom_questions_form($REG_ID = 0): bool
-    {
-        if (! $REG_ID) {
-            EE_Error::add_error(
-                esc_html__(
-                    'An error occurred. No registration ID was received.',
-                    'event_espresso'
-                ),
-                __FILE__,
-                __FUNCTION__,
-                __LINE__
-            );
-        }
-        $form = $this->_get_reg_custom_questions_form($REG_ID);
-        $form->receive_form_submission($this->request->requestParams());
-        $success = false;
-        if ($form->is_valid()) {
-            foreach ($form->subforms() as $question_group_form) {
-                foreach ($question_group_form->inputs() as $question_id => $input) {
-                    $where_conditions    = [
-                        'QST_ID' => $question_id,
-                        'REG_ID' => $REG_ID,
-                    ];
-                    $possibly_new_values = [
-                        'ANS_value' => $input->normalized_value(),
-                    ];
-                    $answer              = EEM_Answer::instance()->get_one([$where_conditions]);
-                    if ($answer instanceof EE_Answer) {
-                        $success = $answer->save($possibly_new_values);
-                    } else {
-                        // insert it then
-                        $cols_n_vals = array_merge($where_conditions, $possibly_new_values);
-                        $answer      = EE_Answer::new_instance($cols_n_vals);
-                        $success     = $answer->save();
-                    }
-                }
-            }
-        } else {
-            EE_Error::add_error($form->get_validation_error_string(), __FILE__, __FUNCTION__, __LINE__);
-        }
-        return $success;
-    }
-
-
-    /**
-     * generates HTML for the Registration main meta box
-     *
-     * @return void
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    public function _reg_attendees_meta_box()
-    {
-        $REG = $this->getRegistrationModel();
-        // get all other registrations on this transaction, and cache
-        // the attendees for them so we don't have to run another query using force_join
-        $registrations                           = $REG->get_all(
-            [
-                [
-                    'TXN_ID' => $this->_registration->transaction_ID(),
-                    'REG_ID' => ['!=', $this->_registration->ID()],
-                ],
-                'force_join'               => ['Attendee'],
-                'default_where_conditions' => 'other_models_only',
-            ]
-        );
-        $this->_template_args['attendees']       = [];
-        $this->_template_args['attendee_notice'] = '';
-        if (
-            empty($registrations)
-            || (is_array($registrations)
-                && ! EEH_Array::get_one_item_from_array($registrations))
-        ) {
-            EE_Error::add_error(
-                esc_html__(
-                    'There are no records attached to this registration. Something may have gone wrong with the registration',
-                    'event_espresso'
-                ),
-                __FILE__,
-                __FUNCTION__,
-                __LINE__
-            );
-            $this->_template_args['attendee_notice'] = EE_Error::get_notices();
-        } else {
-            $att_nmbr = 1;
-            foreach ($registrations as $registration) {
-                /* @var $registration EE_Registration */
-                $attendee                                                      = $registration->attendee()
-                    ? $registration->attendee()
-                    : $this->getAttendeeModel()->create_default_object();
-                $this->_template_args['attendees'][ $att_nmbr ]['STS_ID']      = $registration->status_ID();
-                $this->_template_args['attendees'][ $att_nmbr ]['fname']       = $attendee->fname();
-                $this->_template_args['attendees'][ $att_nmbr ]['lname']       = $attendee->lname();
-                $this->_template_args['attendees'][ $att_nmbr ]['email']       = $attendee->email();
-                $this->_template_args['attendees'][ $att_nmbr ]['final_price'] = $registration->final_price();
-                $this->_template_args['attendees'][ $att_nmbr ]['address']     = implode(
-                    ', ',
-                    $attendee->full_address_as_array()
-                );
-                $this->_template_args['attendees'][ $att_nmbr ]['att_link']    = self::add_query_args_and_nonce(
-                    [
-                        'action' => 'edit_attendee',
-                        'post'   => $attendee->ID(),
-                    ],
-                    REG_ADMIN_URL
-                );
-                $this->_template_args['attendees'][ $att_nmbr ]['event_name']  =
-                    $registration->event_obj() instanceof EE_Event
-                        ? $registration->event_obj()->name()
-                        : '';
-                $att_nmbr++;
-            }
-            $this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
-        }
-        $template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_attendees.template.php';
-        EEH_Template::display_template($template_path, $this->_template_args);
-    }
-
-
-    /**
-     * generates HTML for the Edit Registration side meta box
-     *
-     * @return void
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    public function _reg_registrant_side_meta_box()
-    {
-        /*@var $attendee EE_Attendee */
-        $att_check = $this->_registration->attendee();
-        $attendee  = $att_check instanceof EE_Attendee
-            ? $att_check
-            : $this->getAttendeeModel()->create_default_object();
-        // now let's determine if this is not the primary registration.  If it isn't then we set the
-        // primary_registration object for reference BUT ONLY if the Attendee object loaded is not the same as the
-        // primary registration object (that way we know if we need to show create button or not)
-        if (! $this->_registration->is_primary_registrant()) {
-            $primary_registration = $this->_registration->get_primary_registration();
-            $primary_attendee     = $primary_registration instanceof EE_Registration ? $primary_registration->attendee()
-                : null;
-            if (! $primary_attendee instanceof EE_Attendee || $attendee->ID() !== $primary_attendee->ID()) {
-                // in here?  This means the displayed registration is not the primary registrant but ALREADY HAS its own
-                // custom attendee object so let's not worry about the primary reg.
-                $primary_registration = null;
-            }
-        } else {
-            $primary_registration = null;
-        }
-        $this->_template_args['ATT_ID']            = $attendee->ID();
-        $this->_template_args['fname']             = $attendee->fname();
-        $this->_template_args['lname']             = $attendee->lname();
-        $this->_template_args['email']             = $attendee->email();
-        $this->_template_args['phone']             = $attendee->phone();
-        $this->_template_args['formatted_address'] = EEH_Address::format($attendee);
-        // edit link
-        $this->_template_args['att_edit_link']  = EE_Admin_Page::add_query_args_and_nonce(
-            [
-                'action' => 'edit_attendee',
-                'post'   => $attendee->ID(),
-            ],
-            REG_ADMIN_URL
-        );
-        $this->_template_args['att_edit_title'] = esc_html__('View details for this contact.', 'event_espresso');
-        $this->_template_args['att_edit_label'] = esc_html__('View/Edit Contact', 'event_espresso');
-        // create link
-        $this->_template_args['create_link']  = $primary_registration instanceof EE_Registration
-            ? EE_Admin_Page::add_query_args_and_nonce(
-                [
-                    'action'  => 'duplicate_attendee',
-                    '_REG_ID' => $this->_registration->ID(),
-                ],
-                REG_ADMIN_URL
-            ) : '';
-        $this->_template_args['create_label'] = esc_html__('Create Contact', 'event_espresso');
-        $this->_template_args['att_check']    = $att_check;
-        $template_path                        =
-            REG_TEMPLATE_PATH . 'reg_admin_details_side_meta_box_registrant.template.php';
-        EEH_Template::display_template($template_path, $this->_template_args);
-    }
-
-
-    /**
-     * trash or restore registrations
-     *
-     * @param boolean $trash whether to archive or restore
-     * @return void
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws EntityNotFoundException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     * @throws UnexpectedEntityException
-     */
-    protected function _trash_or_restore_registrations(bool $trash = true)
-    {
-        // if empty _REG_ID then get out because there's nothing to do
-        $REG_IDs = $this->request->getRequestParam('_REG_ID', [], 'int', true);
-        if (empty($REG_IDs)) {
-            EE_Error::add_error(
-                sprintf(
-                    esc_html__(
-                        'In order to %1$s registrations you must select which ones you wish to %1$s by clicking the checkboxes.',
-                        'event_espresso'
-                    ),
-                    $trash ? 'trash' : 'restore'
-                ),
-                __FILE__,
-                __LINE__,
-                __FUNCTION__
-            );
-            $this->_redirect_after_action(false, '', '', [], true);
-        }
-        $success        = 0;
-        $overwrite_msgs = false;
-        // Checkboxes
-        $reg_count = count($REG_IDs);
-        // cycle thru checkboxes
-        foreach ($REG_IDs as $REG_ID) {
-            /** @var EE_Registration $REG */
-            $REG = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
-            if ($trash) {
-                $payments = $REG->registration_payments();
-                if (! empty($payments)) {
-                    $name           = $REG->attendee() instanceof EE_Attendee
-                        ? $REG->attendee()->full_name()
-                        : esc_html__('Unknown Attendee', 'event_espresso');
-                    $overwrite_msgs = true;
-                    EE_Error::add_error(
-                        sprintf(
-                            esc_html__(
-                                '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.',
-                                'event_espresso'
-                            ),
-                            $name
-                        ),
-                        __FILE__,
-                        __FUNCTION__,
-                        __LINE__
-                    );
-                    // can't trash this registration because it has payments.
-                    continue;
-                }
-            }
-            $updated = $trash ? $REG->delete() : $REG->restore();
-            if ($updated) {
-                $success++;
-            }
-        }
-        $this->_redirect_after_action(
-            $success === $reg_count, // were ALL registrations affected?
-            $success > 1
-                ? esc_html__('Registrations', 'event_espresso')
-                : esc_html__('Registration', 'event_espresso'),
-            $trash
-                ? esc_html__('moved to the trash', 'event_espresso')
-                : esc_html__('restored', 'event_espresso'),
-            $this->mergeExistingRequestParamsWithRedirectArgs(['action' => 'default']),
-            $overwrite_msgs
-        );
-    }
-
-
-    /**
-     * This is used to permanently delete registrations.  Note, this will handle not only deleting permanently the
-     * registration but also.
-     * 1. Removing relations to EE_Attendee
-     * 2. Deleting permanently the related transaction, but ONLY if all related registrations to the transaction are
-     * ALSO trashed.
-     * 3. Deleting permanently any related Line items but only if the above conditions are met.
-     * 4. Removing relationships between all tickets and the related registrations
-     * 5. Deleting permanently any related Answers (and the answers for other related registrations that were deleted.)
-     * 6. Deleting permanently any related Check-ins.
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    protected function _delete_registrations()
-    {
-        $REG_MDL = $this->getRegistrationModel();
-        $success = 0;
-        // Checkboxes
-        $REG_IDs = $this->request->getRequestParam('_REG_ID', [], 'int', true);
-
-        if (! empty($REG_IDs)) {
-            // if array has more than one element than success message should be plural
-            $success = count($REG_IDs) > 1 ? 2 : 1;
-            // cycle thru checkboxes
-            foreach ($REG_IDs as $REG_ID) {
-                $REG = $REG_MDL->get_one_by_ID($REG_ID);
-                if (! $REG instanceof EE_Registration) {
-                    continue;
-                }
-                $deleted = $this->_delete_registration($REG);
-                if (! $deleted) {
-                    $success = 0;
-                }
-            }
-        }
-
-        $what        = $success > 1
-            ? esc_html__('Registrations', 'event_espresso')
-            : esc_html__('Registration', 'event_espresso');
-        $action_desc = esc_html__('permanently deleted.', 'event_espresso');
-        $this->_redirect_after_action(
-            $success,
-            $what,
-            $action_desc,
-            $this->mergeExistingRequestParamsWithRedirectArgs(['action' => 'default']),
-            true
-        );
-    }
-
-
-    /**
-     * handles the permanent deletion of a registration.  See comments with _delete_registrations() for details on what
-     * models get affected.
-     *
-     * @param EE_Registration $REG registration to be deleted permanently
-     * @return bool true = successful deletion, false = fail.
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    protected function _delete_registration(EE_Registration $REG): bool
-    {
-        // first we start with the transaction... ultimately, we WILL not delete permanently if there are any related
-        // registrations on the transaction that are NOT trashed.
-        $TXN         = $REG->transaction();
-        $REGS        = $TXN->get_many_related('Registration');
-        $all_trashed = true;
-        foreach ($REGS as $registration) {
-            if (! $registration->get('REG_deleted')) {
-                $all_trashed = false;
-            }
-        }
-        if (! $all_trashed) {
-            EE_Error::add_error(
-                esc_html__(
-                    '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.',
-                    'event_espresso'
-                ),
-                __FILE__,
-                __FUNCTION__,
-                __LINE__
-            );
-            return false;
-        }
-        // k made it here so that means we can delete all the related transactions and their answers (but let's do them
-        // separately from THIS one).
-        foreach ($REGS as $registration) {
-            // delete related answers
-            $registration->delete_related_permanently('Answer');
-            // remove relationship to EE_Attendee (but we ALWAYS leave the contact record intact)
-            $attendee = $registration->get_first_related('Attendee');
-            if ($attendee instanceof EE_Attendee) {
-                $registration->_remove_relation_to($attendee, 'Attendee');
-            }
-            // now remove relationships to tickets on this registration.
-            $registration->_remove_relations('Ticket');
-            // now delete permanently the checkins related to this registration.
-            $registration->delete_related_permanently('Checkin');
-            if ($registration->ID() === $REG->ID()) {
-                continue;
-            } //we don't want to delete permanently the existing registration just yet.
-            // remove relation to transaction for these registrations if NOT the existing registrations
-            $registration->_remove_relations('Transaction');
-            // delete permanently any related messages.
-            $registration->delete_related_permanently('Message');
-            // now delete this registration permanently
-            $registration->delete_permanently();
-        }
-        // now all related registrations on the transaction are handled.  So let's just handle this registration itself
-        // (the transaction and line items should be all that's left).
-        // delete the line items related to the transaction for this registration.
-        $TXN->delete_related_permanently('Line_Item');
-        // we need to remove all the relationships on the transaction
-        $TXN->delete_related_permanently('Payment');
-        $TXN->delete_related_permanently('Extra_Meta');
-        $TXN->delete_related_permanently('Message');
-        // now we can delete this REG permanently (and the transaction of course)
-        $REG->delete_related_permanently('Transaction');
-        return $REG->delete_permanently();
-    }
-
-
-    /**
-     *    generates HTML for the Register New Attendee Admin page
-     *
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws Throwable
-     */
-    public function new_registration()
-    {
-        if (! $this->_set_reg_event()) {
-            throw new EE_Error(
-                esc_html__(
-                    'Unable to continue with registering because there is no Event ID in the request',
-                    'event_espresso'
-                )
-            );
-        }
-        /** @var CurrentPage $current_page */
-        $current_page = $this->loader->getShared(CurrentPage::class);
-        $current_page->setEspressoPage(true);
-        // gotta start with a clean slate if we're not coming here via ajax
-        if (
-            ! $this->request->isAjax()
-            && (
-                ! $this->request->requestParamIsSet('processing_registration')
-                || $this->request->requestParamIsSet('step_error')
-            )
-        ) {
-            $this->clearSession(__CLASS__, __FUNCTION__);
-        }
-        $this->_template_args['event_name'] = '';
-        // event name
-        if ($this->_reg_event) {
-            $this->_template_args['event_name'] = $this->_reg_event->name();
-            $edit_event_url                     = self::add_query_args_and_nonce(
-                [
-                    'action' => 'edit',
-                    'post'   => $this->_reg_event->ID(),
-                ],
-                EVENTS_ADMIN_URL
-            );
-            $edit_event_lnk                     = '<a href="'
-                . $edit_event_url
-                . '" aria-label="'
-                . esc_attr__('Edit ', 'event_espresso')
-                . $this->_reg_event->name()
-                . '">'
-                . esc_html__('Edit Event', 'event_espresso')
-                . '</a>';
-            $this->_template_args['event_name'] .= ' <span class="admin-page-header-edit-lnk not-bold">'
-                . $edit_event_lnk
-                . '</span>';
-        }
-        $this->_template_args['step_content'] = $this->_get_registration_step_content();
-        if ($this->request->isAjax()) {
-            $this->_return_json();
-        }
-        // grab header
-        $template_path                              =
-            REG_TEMPLATE_PATH . 'reg_admin_register_new_attendee.template.php';
-        $this->_template_args['admin_page_content'] = EEH_Template::display_template(
-            $template_path,
-            $this->_template_args,
-            true
-        );
-        // $this->_set_publish_post_box_vars( NULL, FALSE, FALSE, NULL, FALSE );
-        // the details template wrapper
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    /**
-     * This returns the content for a registration step
-     *
-     * @return string html
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws Throwable
-     */
-    protected function _get_registration_step_content(): string
-    {
-        if (isset($_COOKIE['ee_registration_added']) && $_COOKIE['ee_registration_added']) {
-            $warning_msg = sprintf(
-                esc_html__(
-                    '%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',
-                    'event_espresso'
-                ),
-                '<br />',
-                '<h3 class="important-notice">',
-                '</h3>',
-                '<div class="float-right">',
-                '<span id="redirect_timer" class="important-notice">30</span>',
-                '</div>',
-                '<b>',
-                '</b>'
-            );
-            return '
+	}
+
+
+	/**
+	 * Updates the registration's custom questions according to the form info, if the form is submitted.
+	 * If it's not a post, the "view_registrations" route will be called next on the SAME request
+	 * to display the page
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	protected function _update_attendee_registration_form()
+	{
+		do_action('AHEE__Registrations_Admin_Page___update_attendee_registration_form__start', $this);
+		if ($_SERVER['REQUEST_METHOD'] === 'POST') {
+			$REG_ID  = $this->request->getRequestParam('_REG_ID', 0, 'int');
+			$success = $this->_save_reg_custom_questions_form($REG_ID);
+			if ($success) {
+				$what  = esc_html__('Registration Form', 'event_espresso');
+				$route = $REG_ID
+					? ['action' => 'view_registration', '_REG_ID' => $REG_ID]
+					: ['action' => 'default'];
+				$this->_redirect_after_action(true, $what, esc_html__('updated', 'event_espresso'), $route);
+			}
+		}
+	}
+
+
+	/**
+	 * Gets the form for saving registrations custom questions (if done
+	 * previously retrieves the cached form object, which may have validation errors in it)
+	 *
+	 * @param int $REG_ID
+	 * @return EE_Registration_Custom_Questions_Form
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	protected function _get_reg_custom_questions_form(int $REG_ID): EE_Registration_Custom_Questions_Form
+	{
+		if (! $this->_reg_custom_questions_form) {
+			require_once(REG_ADMIN . 'form_sections/EE_Registration_Custom_Questions_Form.form.php');
+			$this->_reg_custom_questions_form = new EE_Registration_Custom_Questions_Form(
+				$this->getRegistrationModel()->get_one_by_ID($REG_ID)
+			);
+			$this->_reg_custom_questions_form->_construct_finalize(null, null);
+		}
+		return $this->_reg_custom_questions_form;
+	}
+
+
+	/**
+	 * Saves
+	 *
+	 * @param bool $REG_ID
+	 * @return bool
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	private function _save_reg_custom_questions_form($REG_ID = 0): bool
+	{
+		if (! $REG_ID) {
+			EE_Error::add_error(
+				esc_html__(
+					'An error occurred. No registration ID was received.',
+					'event_espresso'
+				),
+				__FILE__,
+				__FUNCTION__,
+				__LINE__
+			);
+		}
+		$form = $this->_get_reg_custom_questions_form($REG_ID);
+		$form->receive_form_submission($this->request->requestParams());
+		$success = false;
+		if ($form->is_valid()) {
+			foreach ($form->subforms() as $question_group_form) {
+				foreach ($question_group_form->inputs() as $question_id => $input) {
+					$where_conditions    = [
+						'QST_ID' => $question_id,
+						'REG_ID' => $REG_ID,
+					];
+					$possibly_new_values = [
+						'ANS_value' => $input->normalized_value(),
+					];
+					$answer              = EEM_Answer::instance()->get_one([$where_conditions]);
+					if ($answer instanceof EE_Answer) {
+						$success = $answer->save($possibly_new_values);
+					} else {
+						// insert it then
+						$cols_n_vals = array_merge($where_conditions, $possibly_new_values);
+						$answer      = EE_Answer::new_instance($cols_n_vals);
+						$success     = $answer->save();
+					}
+				}
+			}
+		} else {
+			EE_Error::add_error($form->get_validation_error_string(), __FILE__, __FUNCTION__, __LINE__);
+		}
+		return $success;
+	}
+
+
+	/**
+	 * generates HTML for the Registration main meta box
+	 *
+	 * @return void
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	public function _reg_attendees_meta_box()
+	{
+		$REG = $this->getRegistrationModel();
+		// get all other registrations on this transaction, and cache
+		// the attendees for them so we don't have to run another query using force_join
+		$registrations                           = $REG->get_all(
+			[
+				[
+					'TXN_ID' => $this->_registration->transaction_ID(),
+					'REG_ID' => ['!=', $this->_registration->ID()],
+				],
+				'force_join'               => ['Attendee'],
+				'default_where_conditions' => 'other_models_only',
+			]
+		);
+		$this->_template_args['attendees']       = [];
+		$this->_template_args['attendee_notice'] = '';
+		if (
+			empty($registrations)
+			|| (is_array($registrations)
+				&& ! EEH_Array::get_one_item_from_array($registrations))
+		) {
+			EE_Error::add_error(
+				esc_html__(
+					'There are no records attached to this registration. Something may have gone wrong with the registration',
+					'event_espresso'
+				),
+				__FILE__,
+				__FUNCTION__,
+				__LINE__
+			);
+			$this->_template_args['attendee_notice'] = EE_Error::get_notices();
+		} else {
+			$att_nmbr = 1;
+			foreach ($registrations as $registration) {
+				/* @var $registration EE_Registration */
+				$attendee                                                      = $registration->attendee()
+					? $registration->attendee()
+					: $this->getAttendeeModel()->create_default_object();
+				$this->_template_args['attendees'][ $att_nmbr ]['STS_ID']      = $registration->status_ID();
+				$this->_template_args['attendees'][ $att_nmbr ]['fname']       = $attendee->fname();
+				$this->_template_args['attendees'][ $att_nmbr ]['lname']       = $attendee->lname();
+				$this->_template_args['attendees'][ $att_nmbr ]['email']       = $attendee->email();
+				$this->_template_args['attendees'][ $att_nmbr ]['final_price'] = $registration->final_price();
+				$this->_template_args['attendees'][ $att_nmbr ]['address']     = implode(
+					', ',
+					$attendee->full_address_as_array()
+				);
+				$this->_template_args['attendees'][ $att_nmbr ]['att_link']    = self::add_query_args_and_nonce(
+					[
+						'action' => 'edit_attendee',
+						'post'   => $attendee->ID(),
+					],
+					REG_ADMIN_URL
+				);
+				$this->_template_args['attendees'][ $att_nmbr ]['event_name']  =
+					$registration->event_obj() instanceof EE_Event
+						? $registration->event_obj()->name()
+						: '';
+				$att_nmbr++;
+			}
+			$this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
+		}
+		$template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_attendees.template.php';
+		EEH_Template::display_template($template_path, $this->_template_args);
+	}
+
+
+	/**
+	 * generates HTML for the Edit Registration side meta box
+	 *
+	 * @return void
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	public function _reg_registrant_side_meta_box()
+	{
+		/*@var $attendee EE_Attendee */
+		$att_check = $this->_registration->attendee();
+		$attendee  = $att_check instanceof EE_Attendee
+			? $att_check
+			: $this->getAttendeeModel()->create_default_object();
+		// now let's determine if this is not the primary registration.  If it isn't then we set the
+		// primary_registration object for reference BUT ONLY if the Attendee object loaded is not the same as the
+		// primary registration object (that way we know if we need to show create button or not)
+		if (! $this->_registration->is_primary_registrant()) {
+			$primary_registration = $this->_registration->get_primary_registration();
+			$primary_attendee     = $primary_registration instanceof EE_Registration ? $primary_registration->attendee()
+				: null;
+			if (! $primary_attendee instanceof EE_Attendee || $attendee->ID() !== $primary_attendee->ID()) {
+				// in here?  This means the displayed registration is not the primary registrant but ALREADY HAS its own
+				// custom attendee object so let's not worry about the primary reg.
+				$primary_registration = null;
+			}
+		} else {
+			$primary_registration = null;
+		}
+		$this->_template_args['ATT_ID']            = $attendee->ID();
+		$this->_template_args['fname']             = $attendee->fname();
+		$this->_template_args['lname']             = $attendee->lname();
+		$this->_template_args['email']             = $attendee->email();
+		$this->_template_args['phone']             = $attendee->phone();
+		$this->_template_args['formatted_address'] = EEH_Address::format($attendee);
+		// edit link
+		$this->_template_args['att_edit_link']  = EE_Admin_Page::add_query_args_and_nonce(
+			[
+				'action' => 'edit_attendee',
+				'post'   => $attendee->ID(),
+			],
+			REG_ADMIN_URL
+		);
+		$this->_template_args['att_edit_title'] = esc_html__('View details for this contact.', 'event_espresso');
+		$this->_template_args['att_edit_label'] = esc_html__('View/Edit Contact', 'event_espresso');
+		// create link
+		$this->_template_args['create_link']  = $primary_registration instanceof EE_Registration
+			? EE_Admin_Page::add_query_args_and_nonce(
+				[
+					'action'  => 'duplicate_attendee',
+					'_REG_ID' => $this->_registration->ID(),
+				],
+				REG_ADMIN_URL
+			) : '';
+		$this->_template_args['create_label'] = esc_html__('Create Contact', 'event_espresso');
+		$this->_template_args['att_check']    = $att_check;
+		$template_path                        =
+			REG_TEMPLATE_PATH . 'reg_admin_details_side_meta_box_registrant.template.php';
+		EEH_Template::display_template($template_path, $this->_template_args);
+	}
+
+
+	/**
+	 * trash or restore registrations
+	 *
+	 * @param boolean $trash whether to archive or restore
+	 * @return void
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws EntityNotFoundException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 * @throws UnexpectedEntityException
+	 */
+	protected function _trash_or_restore_registrations(bool $trash = true)
+	{
+		// if empty _REG_ID then get out because there's nothing to do
+		$REG_IDs = $this->request->getRequestParam('_REG_ID', [], 'int', true);
+		if (empty($REG_IDs)) {
+			EE_Error::add_error(
+				sprintf(
+					esc_html__(
+						'In order to %1$s registrations you must select which ones you wish to %1$s by clicking the checkboxes.',
+						'event_espresso'
+					),
+					$trash ? 'trash' : 'restore'
+				),
+				__FILE__,
+				__LINE__,
+				__FUNCTION__
+			);
+			$this->_redirect_after_action(false, '', '', [], true);
+		}
+		$success        = 0;
+		$overwrite_msgs = false;
+		// Checkboxes
+		$reg_count = count($REG_IDs);
+		// cycle thru checkboxes
+		foreach ($REG_IDs as $REG_ID) {
+			/** @var EE_Registration $REG */
+			$REG = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
+			if ($trash) {
+				$payments = $REG->registration_payments();
+				if (! empty($payments)) {
+					$name           = $REG->attendee() instanceof EE_Attendee
+						? $REG->attendee()->full_name()
+						: esc_html__('Unknown Attendee', 'event_espresso');
+					$overwrite_msgs = true;
+					EE_Error::add_error(
+						sprintf(
+							esc_html__(
+								'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.',
+								'event_espresso'
+							),
+							$name
+						),
+						__FILE__,
+						__FUNCTION__,
+						__LINE__
+					);
+					// can't trash this registration because it has payments.
+					continue;
+				}
+			}
+			$updated = $trash ? $REG->delete() : $REG->restore();
+			if ($updated) {
+				$success++;
+			}
+		}
+		$this->_redirect_after_action(
+			$success === $reg_count, // were ALL registrations affected?
+			$success > 1
+				? esc_html__('Registrations', 'event_espresso')
+				: esc_html__('Registration', 'event_espresso'),
+			$trash
+				? esc_html__('moved to the trash', 'event_espresso')
+				: esc_html__('restored', 'event_espresso'),
+			$this->mergeExistingRequestParamsWithRedirectArgs(['action' => 'default']),
+			$overwrite_msgs
+		);
+	}
+
+
+	/**
+	 * This is used to permanently delete registrations.  Note, this will handle not only deleting permanently the
+	 * registration but also.
+	 * 1. Removing relations to EE_Attendee
+	 * 2. Deleting permanently the related transaction, but ONLY if all related registrations to the transaction are
+	 * ALSO trashed.
+	 * 3. Deleting permanently any related Line items but only if the above conditions are met.
+	 * 4. Removing relationships between all tickets and the related registrations
+	 * 5. Deleting permanently any related Answers (and the answers for other related registrations that were deleted.)
+	 * 6. Deleting permanently any related Check-ins.
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	protected function _delete_registrations()
+	{
+		$REG_MDL = $this->getRegistrationModel();
+		$success = 0;
+		// Checkboxes
+		$REG_IDs = $this->request->getRequestParam('_REG_ID', [], 'int', true);
+
+		if (! empty($REG_IDs)) {
+			// if array has more than one element than success message should be plural
+			$success = count($REG_IDs) > 1 ? 2 : 1;
+			// cycle thru checkboxes
+			foreach ($REG_IDs as $REG_ID) {
+				$REG = $REG_MDL->get_one_by_ID($REG_ID);
+				if (! $REG instanceof EE_Registration) {
+					continue;
+				}
+				$deleted = $this->_delete_registration($REG);
+				if (! $deleted) {
+					$success = 0;
+				}
+			}
+		}
+
+		$what        = $success > 1
+			? esc_html__('Registrations', 'event_espresso')
+			: esc_html__('Registration', 'event_espresso');
+		$action_desc = esc_html__('permanently deleted.', 'event_espresso');
+		$this->_redirect_after_action(
+			$success,
+			$what,
+			$action_desc,
+			$this->mergeExistingRequestParamsWithRedirectArgs(['action' => 'default']),
+			true
+		);
+	}
+
+
+	/**
+	 * handles the permanent deletion of a registration.  See comments with _delete_registrations() for details on what
+	 * models get affected.
+	 *
+	 * @param EE_Registration $REG registration to be deleted permanently
+	 * @return bool true = successful deletion, false = fail.
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	protected function _delete_registration(EE_Registration $REG): bool
+	{
+		// first we start with the transaction... ultimately, we WILL not delete permanently if there are any related
+		// registrations on the transaction that are NOT trashed.
+		$TXN         = $REG->transaction();
+		$REGS        = $TXN->get_many_related('Registration');
+		$all_trashed = true;
+		foreach ($REGS as $registration) {
+			if (! $registration->get('REG_deleted')) {
+				$all_trashed = false;
+			}
+		}
+		if (! $all_trashed) {
+			EE_Error::add_error(
+				esc_html__(
+					'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.',
+					'event_espresso'
+				),
+				__FILE__,
+				__FUNCTION__,
+				__LINE__
+			);
+			return false;
+		}
+		// k made it here so that means we can delete all the related transactions and their answers (but let's do them
+		// separately from THIS one).
+		foreach ($REGS as $registration) {
+			// delete related answers
+			$registration->delete_related_permanently('Answer');
+			// remove relationship to EE_Attendee (but we ALWAYS leave the contact record intact)
+			$attendee = $registration->get_first_related('Attendee');
+			if ($attendee instanceof EE_Attendee) {
+				$registration->_remove_relation_to($attendee, 'Attendee');
+			}
+			// now remove relationships to tickets on this registration.
+			$registration->_remove_relations('Ticket');
+			// now delete permanently the checkins related to this registration.
+			$registration->delete_related_permanently('Checkin');
+			if ($registration->ID() === $REG->ID()) {
+				continue;
+			} //we don't want to delete permanently the existing registration just yet.
+			// remove relation to transaction for these registrations if NOT the existing registrations
+			$registration->_remove_relations('Transaction');
+			// delete permanently any related messages.
+			$registration->delete_related_permanently('Message');
+			// now delete this registration permanently
+			$registration->delete_permanently();
+		}
+		// now all related registrations on the transaction are handled.  So let's just handle this registration itself
+		// (the transaction and line items should be all that's left).
+		// delete the line items related to the transaction for this registration.
+		$TXN->delete_related_permanently('Line_Item');
+		// we need to remove all the relationships on the transaction
+		$TXN->delete_related_permanently('Payment');
+		$TXN->delete_related_permanently('Extra_Meta');
+		$TXN->delete_related_permanently('Message');
+		// now we can delete this REG permanently (and the transaction of course)
+		$REG->delete_related_permanently('Transaction');
+		return $REG->delete_permanently();
+	}
+
+
+	/**
+	 *    generates HTML for the Register New Attendee Admin page
+	 *
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws Throwable
+	 */
+	public function new_registration()
+	{
+		if (! $this->_set_reg_event()) {
+			throw new EE_Error(
+				esc_html__(
+					'Unable to continue with registering because there is no Event ID in the request',
+					'event_espresso'
+				)
+			);
+		}
+		/** @var CurrentPage $current_page */
+		$current_page = $this->loader->getShared(CurrentPage::class);
+		$current_page->setEspressoPage(true);
+		// gotta start with a clean slate if we're not coming here via ajax
+		if (
+			! $this->request->isAjax()
+			&& (
+				! $this->request->requestParamIsSet('processing_registration')
+				|| $this->request->requestParamIsSet('step_error')
+			)
+		) {
+			$this->clearSession(__CLASS__, __FUNCTION__);
+		}
+		$this->_template_args['event_name'] = '';
+		// event name
+		if ($this->_reg_event) {
+			$this->_template_args['event_name'] = $this->_reg_event->name();
+			$edit_event_url                     = self::add_query_args_and_nonce(
+				[
+					'action' => 'edit',
+					'post'   => $this->_reg_event->ID(),
+				],
+				EVENTS_ADMIN_URL
+			);
+			$edit_event_lnk                     = '<a href="'
+				. $edit_event_url
+				. '" aria-label="'
+				. esc_attr__('Edit ', 'event_espresso')
+				. $this->_reg_event->name()
+				. '">'
+				. esc_html__('Edit Event', 'event_espresso')
+				. '</a>';
+			$this->_template_args['event_name'] .= ' <span class="admin-page-header-edit-lnk not-bold">'
+				. $edit_event_lnk
+				. '</span>';
+		}
+		$this->_template_args['step_content'] = $this->_get_registration_step_content();
+		if ($this->request->isAjax()) {
+			$this->_return_json();
+		}
+		// grab header
+		$template_path                              =
+			REG_TEMPLATE_PATH . 'reg_admin_register_new_attendee.template.php';
+		$this->_template_args['admin_page_content'] = EEH_Template::display_template(
+			$template_path,
+			$this->_template_args,
+			true
+		);
+		// $this->_set_publish_post_box_vars( NULL, FALSE, FALSE, NULL, FALSE );
+		// the details template wrapper
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	/**
+	 * This returns the content for a registration step
+	 *
+	 * @return string html
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws Throwable
+	 */
+	protected function _get_registration_step_content(): string
+	{
+		if (isset($_COOKIE['ee_registration_added']) && $_COOKIE['ee_registration_added']) {
+			$warning_msg = sprintf(
+				esc_html__(
+					'%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',
+					'event_espresso'
+				),
+				'<br />',
+				'<h3 class="important-notice">',
+				'</h3>',
+				'<div class="float-right">',
+				'<span id="redirect_timer" class="important-notice">30</span>',
+				'</div>',
+				'<b>',
+				'</b>'
+			);
+			return '
 	<div id="ee-add-reg-back-button-dv"><p>' . $warning_msg . '</p></div>
 	<script >
 		// WHOAH !!! it appears that someone is using the back button from the Transaction admin page
@@ -2949,959 +2949,959 @@ 
 	        }
 	    }, 800 );
 	</script >';
-        }
-        $template_args = [
-            'title'                    => '',
-            'content'                  => '',
-            'step_button_text'         => '',
-            'show_notification_toggle' => false,
-        ];
-        // to indicate we're processing a new registration
-        $hidden_fields = [
-            'processing_registration' => [
-                'type'  => 'hidden',
-                'value' => 0,
-            ],
-            'event_id'                => [
-                'type'  => 'hidden',
-                'value' => $this->_reg_event->ID(),
-            ],
-        ];
-        // if the cart is empty then we know we're at step one, so we'll display the ticket selector
-        $cart = $this->getCart();
-        $step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
-        switch ($step) {
-            case 'ticket':
-                $hidden_fields['processing_registration']['value'] = 1;
-                $template_args['title']                            = esc_html__(
-                    'Step One: Select the Ticket for this registration',
-                    'event_espresso'
-                );
-                $template_args['content']                          =
-                    EED_Ticket_Selector::instance()->display_ticket_selector($this->_reg_event);
-                $template_args['content']                          .= '</div>';
-                $template_args['step_button_text']                 = esc_html__(
-                    'Add Tickets and Continue to Registrant Details',
-                    'event_espresso'
-                );
-                $template_args['show_notification_toggle']         = false;
-                break;
-            case 'questions':
-                $hidden_fields['processing_registration']['value'] = 2;
-                $template_args['title']                            = esc_html__(
-                    'Step Two: Add Registrant Details for this Registration',
-                    'event_espresso'
-                );
-                // in theory, we should be able to run EED_SPCO at this point
-                // because the cart should have been set up properly by the first process_reg_step run.
-                $template_args['content']                  =
-                    EED_Single_Page_Checkout::registration_checkout_for_admin();
-                $template_args['step_button_text']         = esc_html__(
-                    'Save Registration and Continue to Details',
-                    'event_espresso'
-                );
-                $template_args['show_notification_toggle'] = true;
-                break;
-        }
-        // we come back to the process_registration_step route.
-        $this->_set_add_edit_form_tags('process_reg_step', $hidden_fields);
-        return EEH_Template::display_template(
-            REG_TEMPLATE_PATH . 'reg_admin_register_new_attendee_step_content.template.php',
-            $template_args,
-            true
-        );
-    }
-
-
-    /**
-     * set_reg_event
-     *
-     * @return bool
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    private function _set_reg_event(): bool
-    {
-        if (is_object($this->_reg_event)) {
-            return true;
-        }
-
-        $EVT_ID = $this->request->getRequestParam('event_id', 0, 'int');
-        if (! $EVT_ID) {
-            return false;
-        }
-        $this->_reg_event = $this->getEventModel()->get_one_by_ID($EVT_ID);
-        return true;
-    }
-
-
-    /**
-     * process_reg_step
-     *
-     * @return void
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws RuntimeException
-     * @throws Throwable
-     */
-    public function process_reg_step()
-    {
-        EE_System::do_not_cache();
-        $this->_set_reg_event();
-        /** @var CurrentPage $current_page */
-        $current_page = $this->loader->getShared(CurrentPage::class);
-        $current_page->setEspressoPage(true);
-        $this->request->setRequestParam('uts', time());
-        // what step are we on?
-        $cart = $this->getCart();
-        $step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
-        // if doing ajax then we need to verify the nonce
-        if ($this->request->isAjax()) {
-            $nonce = $this->request->getRequestParam($this->_req_nonce, '');
-            $this->_verify_nonce($nonce, $this->_req_nonce);
-        }
-        switch ($step) {
-            case 'ticket':
-                // process ticket selection
-                $success = EED_Ticket_Selector::instance()->process_ticket_selections();
-                if ($success) {
-                    EE_Error::add_success(
-                        esc_html__(
-                            'Tickets Selected. Now complete the registration.',
-                            'event_espresso'
-                        )
-                    );
-                } else {
-                    $this->request->setRequestParam('step_error', true);
-                    $query_args['step_error'] = $this->request->getRequestParam('step_error', true, 'bool');
-                }
-                if ($this->request->isAjax()) {
-                    $this->new_registration(); // display next step
-                } else {
-                    $query_args = [
-                        'action'                  => 'new_registration',
-                        'processing_registration' => 1,
-                        'event_id'                => $this->_reg_event->ID(),
-                        'uts'                     => time(),
-                    ];
-                    $this->_redirect_after_action(
-                        false,
-                        '',
-                        '',
-                        $query_args,
-                        true
-                    );
-                }
-                break;
-            case 'questions':
-                if (! $this->request->requestParamIsSet('txn_reg_status_change[send_notifications]')) {
-                    add_filter('FHEE__EED_Messages___maybe_registration__deliver_notifications', '__return_false', 15);
-                }
-                // process registration
-                $transaction = EED_Single_Page_Checkout::instance()->process_registration_from_admin();
-                if ($cart instanceof EE_Cart) {
-                    $grand_total = $cart->get_grand_total();
-                    if ($grand_total instanceof EE_Line_Item) {
-                        $grand_total->save_this_and_descendants_to_txn();
-                    }
-                }
-                if (! $transaction instanceof EE_Transaction) {
-                    $query_args = [
-                        'action'                  => 'new_registration',
-                        'processing_registration' => 2,
-                        'event_id'                => $this->_reg_event->ID(),
-                        'uts'                     => time(),
-                    ];
-                    if ($this->request->isAjax()) {
-                        // display registration form again because there are errors (maybe validation?)
-                        $this->new_registration();
-                        return;
-                    }
-                    $this->_redirect_after_action(
-                        false,
-                        '',
-                        '',
-                        $query_args,
-                        true
-                    );
-                    return;
-                }
-                // maybe update status, and make sure to save transaction if not done already
-                if (! $transaction->update_status_based_on_total_paid()) {
-                    $transaction->save();
-                }
-                $this->clearSession(__CLASS__, __FUNCTION__);
-                $query_args = [
-                    'action'        => 'redirect_to_txn',
-                    'TXN_ID'        => $transaction->ID(),
-                    'EVT_ID'        => $this->_reg_event->ID(),
-                    'event_name'    => urlencode($this->_reg_event->name()),
-                    'redirect_from' => 'new_registration',
-                ];
-                $this->_redirect_after_action(false, '', '', $query_args, true);
-                break;
-        }
-        // what are you looking here for?  Should be nothing to do at this point.
-    }
-
-
-    /**
-     * redirect_to_txn
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    public function redirect_to_txn()
-    {
-        EE_System::do_not_cache();
-        $this->clearSession(__CLASS__, __FUNCTION__);
-        $query_args = [
-            'action' => 'view_transaction',
-            'TXN_ID' => $this->request->getRequestParam('TXN_ID', 0, 'int'),
-            'page'   => 'espresso_transactions',
-        ];
-        if ($this->request->requestParamIsSet('EVT_ID') && $this->request->requestParamIsSet('redirect_from')) {
-            $query_args['EVT_ID']        = $this->request->getRequestParam('EVT_ID', 0, 'int');
-            $query_args['event_name']    = urlencode($this->request->getRequestParam('event_name'));
-            $query_args['redirect_from'] = $this->request->getRequestParam('redirect_from');
-        }
-        EE_Error::add_success(
-            esc_html__(
-                'Registration Created.  Please review the transaction and add any payments as necessary',
-                'event_espresso'
-            )
-        );
-        $this->_redirect_after_action(false, '', '', $query_args, true);
-    }
-
-
-    /**
-     * generates HTML for the Attendee Contact List
-     *
-     * @return void
-     * @throws DomainException
-     * @throws EE_Error
-     */
-    protected function _attendee_contact_list_table()
-    {
-        $this->_search_btn_label = esc_html__('Contacts', 'event_espresso');
-        $this->display_admin_list_table_page_with_no_sidebar();
-    }
-
-
-    /**
-     * get_attendees
-     *
-     * @param int  $per_page
-     * @param bool $count whether to return count or data.
-     * @param bool $trash
-     * @return array|int
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    public function get_attendees(int $per_page, bool $count = false, bool $trash = false)
-    {
-        require_once(REG_ADMIN . 'EE_Attendee_Contact_List_Table.class.php');
-        $orderby = $this->request->getRequestParam('orderby');
-        switch ($orderby) {
-            case 'ATT_ID':
-            case 'ATT_fname':
-            case 'ATT_email':
-            case 'ATT_city':
-            case 'STA_ID':
-            case 'CNT_ID':
-                break;
-            case 'Registration_Count':
-                $orderby = 'Registration_Count';
-                break;
-            default:
-                $orderby = 'ATT_lname';
-        }
-        $sort         = $this->request->getRequestParam('order', 'ASC');
-        $current_page = $this->request->getRequestParam('paged', 1, 'int');
-        $per_page     = absint($per_page) ? $per_page : 10;
-        $per_page     = $this->request->getRequestParam('perpage', $per_page, 'int');
-        $_where       = [];
-        $search_term  = $this->request->getRequestParam('s');
-        if ($search_term) {
-            $search_term  = '%' . $search_term . '%';
-            $_where['OR'] = [
-                'Registration.Event.EVT_name'       => ['LIKE', $search_term],
-                'Registration.Event.EVT_desc'       => ['LIKE', $search_term],
-                'Registration.Event.EVT_short_desc' => ['LIKE', $search_term],
-                'ATT_fname'                         => ['LIKE', $search_term],
-                'ATT_lname'                         => ['LIKE', $search_term],
-                'ATT_short_bio'                     => ['LIKE', $search_term],
-                'ATT_email'                         => ['LIKE', $search_term],
-                'ATT_address'                       => ['LIKE', $search_term],
-                'ATT_address2'                      => ['LIKE', $search_term],
-                'ATT_city'                          => ['LIKE', $search_term],
-                'Country.CNT_name'                  => ['LIKE', $search_term],
-                'State.STA_name'                    => ['LIKE', $search_term],
-                'ATT_phone'                         => ['LIKE', $search_term],
-                'Registration.REG_final_price'      => ['LIKE', $search_term],
-                'Registration.REG_code'             => ['LIKE', $search_term],
-                'Registration.REG_group_size'       => ['LIKE', $search_term],
-            ];
-        }
-        $offset     = ($current_page - 1) * $per_page;
-        $limit      = $count ? null : [$offset, $per_page];
-        $query_args = [
-            $_where,
-            'extra_selects' => ['Registration_Count' => ['Registration.REG_ID', 'count', '%d']],
-            'limit'         => $limit,
-        ];
-        if (! $count) {
-            $query_args['order_by'] = [$orderby => $sort];
-        }
-        $query_args[0]['status'] = $trash ? ['!=', 'publish'] : ['IN', ['publish']];
-        return $count
-            ? $this->getAttendeeModel()->count($query_args, 'ATT_ID', true)
-            : $this->getAttendeeModel()->get_all($query_args);
-    }
-
-
-    /**
-     * This is just taking care of resending the registration confirmation
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    protected function _resend_registration()
-    {
-        $this->_process_resend_registration();
-        $REG_ID      = $this->request->getRequestParam('_REG_ID', 0, 'int');
-        $redirect_to = $this->request->getRequestParam('redirect_to');
-        $query_args  = $redirect_to
-            ? ['action' => $redirect_to, '_REG_ID' => $REG_ID]
-            : ['action' => 'default'];
-        $this->_redirect_after_action(false, '', '', $query_args, true);
-    }
-
-
-    /**
-     * Creates a registration report, but accepts the name of a method to use for preparing the query parameters
-     * to use when selecting registrations
-     *
-     * @param string $method_name_for_getting_query_params the name of the method (on this class) to use for preparing
-     *                                                     the query parameters from the request
-     * @return void ends the request with a redirect or download
-     */
-    public function _registrations_report_base(string $method_name_for_getting_query_params)
-    {
-        $EVT_ID = $this->request->requestParamIsSet('EVT_ID')
-            ? $this->request->getRequestParam('EVT_ID', 0, DataType::INT)
-            : null;
-        if (! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
-            $return_url    = $this->request->getRequestParam('return_url', '', DataType::URL);
-            $filters       = $this->request->getRequestParam('filters', [], DataType::STRING, true);
-            $report_params = $this->$method_name_for_getting_query_params($filters);
-            $report_params = $this->convertDatetimeObjectsToStrings($report_params);
-            $use_filters   = $this->request->getRequestParam('use_filters', false, DataType::BOOL);
-            wp_redirect(
-                EE_Admin_Page::add_query_args_and_nonce(
-                    [
-                        'page'        => EED_Batch::PAGE_SLUG,
-                        'batch'       => EED_Batch::batch_file_job,
-                        'EVT_ID'      => $EVT_ID,
-                        'filters'     => urlencode(serialize($report_params)),
-                        'use_filters' => urlencode($use_filters),
-                        'job_handler' => urlencode(
-                            'EventEspresso\core\libraries\batch\JobHandlers\RegistrationsReport'
-                        ),
-                        'return_url'  => urlencode($return_url),
-                    ]
-                )
-            );
-        } else {
-            // Pull the current request params
-            $request_args = $this->request->requestParams();
-            $request_args = $this->convertDatetimeObjectsToStrings($request_args);
-            // Set the required request_args to be passed to the export
-            $required_request_args = [
-                'export' => 'report',
-                'action' => 'registrations_report_for_event',
-                'EVT_ID' => $EVT_ID,
-            ];
-            // Merge required request args, overriding any currently set
-            $request_args = array_merge($request_args, $required_request_args);
-            if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
-                require_once(EE_CLASSES . 'EE_Export.class.php');
-                $EE_Export = EE_Export::instance($request_args);
-                $EE_Export->export();
-            }
-        }
-    }
-
-
-    /**
-     * recursively convert Datetime objects in query params array to strings using MySQL format
-     *
-     * @param array $query_params
-     * @return array
-     * @since 5.0.19.p
-     */
-    private function convertDatetimeObjectsToStrings(array $query_params): array
-    {
-        foreach ($query_params as $key => $value) {
-            if (is_array($value)) {
-                $query_params[ $key ] = $this->convertDatetimeObjectsToStrings($value);
-            } elseif ($value instanceof DateTime) {
-                $query_params[ $key ] = $value->format('Y-m-d H:i:s');
-            }
-        }
-        return $query_params;
-    }
-
-
-    /**
-     * Creates a registration report using only query parameters in the request
-     *
-     * @return void
-     */
-    public function _registrations_report()
-    {
-        $this->_registrations_report_base('_get_registration_query_parameters');
-    }
-
-
-    /**
-     * @throws EE_Error
-     */
-    public function _contact_list_export()
-    {
-        if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
-            require_once(EE_CLASSES . 'EE_Export.class.php');
-            $EE_Export = EE_Export::instance($this->request->requestParams());
-            $EE_Export->export_attendees();
-        }
-    }
-
-
-    public function _contact_list_report()
-    {
-        if (! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
-            wp_redirect(
-                EE_Admin_Page::add_query_args_and_nonce(
-                    [
-                        'page'        => EED_Batch::PAGE_SLUG,
-                        'batch'       => EED_Batch::batch_file_job,
-                        'job_handler' => urlencode('EventEspresso\core\libraries\batch\JobHandlers\AttendeesReport'),
-                        'return_url'  => urlencode($this->request->getRequestParam('return_url', '', DataType::URL)),
-                    ]
-                )
-            );
-        } else {
-            if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
-                require_once(EE_CLASSES . 'EE_Export.class.php');
-                $EE_Export = EE_Export::instance($this->request->requestParams());
-                $EE_Export->report_attendees();
-            }
-        }
-    }
-
-
-
-
-
-    /***************************************        ATTENDEE DETAILS        ***************************************/
-    /**
-     * This duplicates the attendee object for the given incoming registration id and attendee_id.
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    protected function _duplicate_attendee()
-    {
-        $REG_ID = $this->request->getRequestParam('_REG_ID', 0, 'int');
-        $action = $this->request->getRequestParam('return', 'default');
-        // verify we have necessary info
-        if (! $REG_ID) {
-            EE_Error::add_error(
-                esc_html__(
-                    'Unable to create the contact for the registration because the required parameters are not present (_REG_ID )',
-                    'event_espresso'
-                ),
-                __FILE__,
-                __LINE__,
-                __FUNCTION__
-            );
-            $query_args = ['action' => $action];
-            $this->_redirect_after_action('', '', '', $query_args, true);
-        }
-        // okay necessary deets present... let's dupe the incoming attendee and attach to incoming registration.
-        $registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
-        if (! $registration instanceof EE_Registration) {
-            throw new RuntimeException(
-                sprintf(
-                    esc_html__(
-                        'Unable to create the contact because a valid registration could not be retrieved for REG ID: %1$d',
-                        'event_espresso'
-                    ),
-                    $REG_ID
-                )
-            );
-        }
-        $attendee = $registration->attendee();
-        // remove relation of existing attendee on registration
-        $registration->_remove_relation_to($attendee, 'Attendee');
-        // new attendee
-        $new_attendee = clone $attendee;
-        $new_attendee->set('ATT_ID', 0);
-        $new_attendee->save();
-        // add new attendee to reg
-        $registration->_add_relation_to($new_attendee, 'Attendee');
-        EE_Error::add_success(
-            esc_html__(
-                'New Contact record created.  Now make any edits you wish to make for this contact.',
-                'event_espresso'
-            )
-        );
-        // redirect to edit page for attendee
-        $query_args = ['post' => $new_attendee->ID(), 'action' => 'edit_attendee'];
-        $this->_redirect_after_action('', '', '', $query_args, true);
-    }
-
-
-    /**
-     * Callback invoked by parent EE_Admin_CPT class hooked in on `save_post` wp hook.
-     *
-     * @param int     $post_id
-     * @param WP_Post $post
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws LogicException
-     * @throws InvalidFormSubmissionException
-     * @throws ReflectionException
-     */
-    protected function _insert_update_cpt_item($post_id, $post)
-    {
-        $success  = true;
-        $attendee = $post instanceof WP_Post && $post->post_type === EspressoPostType::ATTENDEES
-            ? $this->getAttendeeModel()->get_one_by_ID($post_id)
-            : null;
-        // for attendee updates
-        if ($attendee instanceof EE_Attendee) {
-            // note we should only be UPDATING attendees at this point.
-            $fname          = $this->request->getRequestParam('ATT_fname', '');
-            $lname          = $this->request->getRequestParam('ATT_lname', '');
-            $updated_fields = [
-                'ATT_fname'     => $fname,
-                'ATT_lname'     => $lname,
-                'ATT_full_name' => "$fname $lname",
-                'ATT_address'   => $this->request->getRequestParam('ATT_address', ''),
-                'ATT_address2'  => $this->request->getRequestParam('ATT_address2', ''),
-                'ATT_city'      => $this->request->getRequestParam('ATT_city', ''),
-                'STA_ID'        => $this->request->getRequestParam('STA_ID', ''),
-                'CNT_ISO'       => $this->request->getRequestParam('CNT_ISO', ''),
-                'ATT_zip'       => $this->request->getRequestParam('ATT_zip', ''),
-            ];
-            foreach ($updated_fields as $field => $value) {
-                $attendee->set($field, $value);
-            }
-
-            // process contact details metabox form handler (which will also save the attendee)
-            $contact_details_form = $this->getAttendeeContactDetailsMetaboxFormHandler($attendee);
-            $success              = $contact_details_form->process($this->request->requestParams());
-
-            $attendee_update_callbacks = apply_filters(
-                'FHEE__Registrations_Admin_Page__insert_update_cpt_item__attendee_update',
-                []
-            );
-            foreach ($attendee_update_callbacks as $a_callback) {
-                if (false === call_user_func_array($a_callback, [$attendee, $this->request->requestParams()])) {
-                    throw new EE_Error(
-                        sprintf(
-                            esc_html__(
-                                '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.',
-                                'event_espresso'
-                            ),
-                            $a_callback
-                        )
-                    );
-                }
-            }
-        }
-
-        if ($success === false) {
-            EE_Error::add_error(
-                esc_html__(
-                    'Something went wrong with updating the meta table data for the registration.',
-                    'event_espresso'
-                ),
-                __FILE__,
-                __FUNCTION__,
-                __LINE__
-            );
-        }
-    }
-
-
-    public function trash_cpt_item($post_id)
-    {
-    }
-
-
-    public function delete_cpt_item($post_id)
-    {
-    }
-
-
-    public function restore_cpt_item($post_id)
-    {
-    }
-
-
-    protected function _restore_cpt_item($post_id, $revision_id)
-    {
-    }
-
-
-    /**
-     * @throws EE_Error
-     * @throws ReflectionException
-     * @since 4.10.2.p
-     */
-    public function attendee_editor_metaboxes()
-    {
-        $this->verify_cpt_object();
-        remove_meta_box(
-            'postexcerpt',
-            $this->_cpt_routes[ $this->_req_action ],
-            'normal'
-        );
-        remove_meta_box('commentstatusdiv', $this->_cpt_routes[ $this->_req_action ], 'normal');
-        if (post_type_supports(EspressoPostType::ATTENDEES, 'excerpt')) {
-            $this->addMetaBox(
-                'postexcerpt',
-                esc_html__('Short Biography', 'event_espresso'),
-                'post_excerpt_meta_box',
-                $this->_cpt_routes[ $this->_req_action ]
-            );
-        }
-        if (post_type_supports(EspressoPostType::ATTENDEES, 'comments')) {
-            $this->addMetaBox(
-                'commentsdiv',
-                esc_html__('Notes on the Contact', 'event_espresso'),
-                'post_comment_meta_box',
-                $this->_cpt_routes[ $this->_req_action ],
-                'normal',
-                'core'
-            );
-        }
-        $this->addMetaBox(
-            'attendee_contact_info',
-            esc_html__('Contact Info', 'event_espresso'),
-            [$this, 'attendee_contact_info'],
-            $this->_cpt_routes[ $this->_req_action ],
-            'side',
-            'core'
-        );
-        $this->addMetaBox(
-            'attendee_details_address',
-            esc_html__('Address Details', 'event_espresso'),
-            [$this, 'attendee_address_details'],
-            $this->_cpt_routes[ $this->_req_action ],
-            'normal',
-            'core'
-        );
-        $this->addMetaBox(
-            'attendee_registrations',
-            esc_html__('Registrations for this Contact', 'event_espresso'),
-            [$this, 'attendee_registrations_meta_box'],
-            $this->_cpt_routes[ $this->_req_action ]
-        );
-    }
-
-
-    /**
-     * Metabox for attendee contact info
-     *
-     * @param WP_Post $post wp post object
-     * @return void attendee contact info ( and form )
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws LogicException
-     * @throws DomainException
-     */
-    public function attendee_contact_info(WP_Post $post)
-    {
-        // get attendee object ( should already have it )
-        $form = $this->getAttendeeContactDetailsMetaboxFormHandler($this->_cpt_model_obj);
-        $form->enqueueStylesAndScripts();
-        echo wp_kses($form->display(), AllowedTags::getWithFormTags());
-    }
-
-
-    /**
-     * Return form handler for the contact details metabox
-     *
-     * @param EE_Attendee $attendee
-     * @return AttendeeContactDetailsMetaboxFormHandler
-     * @throws DomainException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     */
-    protected function getAttendeeContactDetailsMetaboxFormHandler(EE_Attendee $attendee): AttendeeContactDetailsMetaboxFormHandler
-    {
-        return new AttendeeContactDetailsMetaboxFormHandler($attendee, EE_Registry::instance());
-    }
-
-
-    /**
-     * Metabox for attendee details
-     *
-     * @param WP_Post $post wp post object
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function attendee_address_details(WP_Post $post)
-    {
-        // get attendee object (should already have it)
-        $this->_template_args['attendee']     = $this->_cpt_model_obj;
-        $this->_template_args['state_html']   = EEH_Form_Fields::generate_form_input(
-            new EE_Question_Form_Input(
-                EE_Question::new_instance(
-                    [
-                        'QST_ID'           => 0,
-                        'QST_display_text' => esc_html__('State/Province', 'event_espresso'),
-                        'QST_system'       => 'admin-state',
-                    ]
-                ),
-                EE_Answer::new_instance(
-                    [
-                        'ANS_ID'    => 0,
-                        'ANS_value' => $this->_cpt_model_obj->state_ID(),
-                    ]
-                ),
-                [
-                    'input_id'       => 'STA_ID',
-                    'input_name'     => 'STA_ID',
-                    'input_prefix'   => '',
-                    'append_qstn_id' => false,
-                ]
-            )
-        );
-        $this->_template_args['country_html'] = EEH_Form_Fields::generate_form_input(
-            new EE_Question_Form_Input(
-                EE_Question::new_instance(
-                    [
-                        'QST_ID'           => 0,
-                        'QST_display_text' => esc_html__('Country', 'event_espresso'),
-                        'QST_system'       => 'admin-country',
-                    ]
-                ),
-                EE_Answer::new_instance(
-                    [
-                        'ANS_ID'    => 0,
-                        'ANS_value' => $this->_cpt_model_obj->country_ID(),
-                    ]
-                ),
-                [
-                    'input_id'       => 'CNT_ISO',
-                    'input_name'     => 'CNT_ISO',
-                    'input_prefix'   => '',
-                    'append_qstn_id' => false,
-                ]
-            )
-        );
-        $template                             =
-            REG_TEMPLATE_PATH . 'attendee_address_details_metabox_content.template.php';
-        EEH_Template::display_template($template, $this->_template_args);
-    }
-
-
-    /**
-     * @param WP_Post $post
-     * @return void
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    public function attendee_registrations_meta_box(WP_Post $post)
-    {
-        $this->_template_args['attendee']      = $this->_cpt_model_obj;
-        $this->_template_args['registrations'] = $this->_cpt_model_obj->get_many_related('Registration');
-        $template                              =
-            REG_TEMPLATE_PATH . 'attendee_registrations_main_meta_box.template.php';
-        EEH_Template::display_template($template, $this->_template_args);
-    }
-
-
-    /**
-     * add in the form fields for the attendee edit
-     *
-     * @param WP_Post $post wp post object
-     * @return void echos html for new form.
-     * @throws DomainException
-     */
-    public function after_title_form_fields(WP_Post $post)
-    {
-        if ($post->post_type === EspressoPostType::ATTENDEES) {
-            $template                  = REG_TEMPLATE_PATH . 'attendee_details_after_title_form_fields.template.php';
-            $template_args['attendee'] = $this->_cpt_model_obj;
-            EEH_Template::display_template($template, $template_args);
-        }
-    }
-
-
-    /**
-     * _trash_or_restore_attendee
-     *
-     * @param bool $trash - whether to move item to trash (TRUE) or restore it (FALSE)
-     * @return void
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    protected function _trash_or_restore_attendees(bool $trash = true)
-    {
-        $status = $trash ? 'trash' : 'publish';
-        // Checkboxes
-        if ($this->request->requestParamIsSet('ATT_IDs')) {
-            $ATT_IDs = $this->request->getRequestParam('ATT_IDs', [], 'int', true);
-            // if array has more than one element than success message should be plural
-            $success = count($ATT_IDs) > 1 ? 2 : 1;
-            // cycle thru checkboxes
-            foreach ($ATT_IDs as $ATT_ID) {
-                $updated = $this->getAttendeeModel()->update_by_ID(['status' => $status], $ATT_ID);
-                if (! $updated) {
-                    $success = 0;
-                }
-            }
-        } else {
-            // grab single id and delete
-            $ATT_ID = $this->request->getRequestParam('ATT_ID', 0, 'int');
-            // update attendee
-            $success = $this->getAttendeeModel()->update_by_ID(['status' => $status], $ATT_ID) ? 1 : 0;
-        }
-        $what        = $success > 1
-            ? esc_html__('Contacts', 'event_espresso')
-            : esc_html__('Contact', 'event_espresso');
-        $action_desc = $trash
-            ? esc_html__('moved to the trash', 'event_espresso')
-            : esc_html__('restored', 'event_espresso');
-        $this->_redirect_after_action($success, $what, $action_desc, ['action' => 'contact_list']);
-    }
-
-
-    /**
-     * @return void
-     * @throws EE_Error
-     * @throws ReflectionException
-     * @since  :VID:
-     */
-    protected function deleteAttendees()
-    {
-        $success = 0;
-        $att_ids = $this->getAttIdsFromRequest();
-        foreach ($att_ids as $att_id) {
-            $attendee = $this->getAttendeeModel()->get_one_by_ID($att_id);
-            if ($attendee instanceof EE_Attendee) {
-                $deleted = $attendee->delete_permanently();
-                if ($deleted) {
-                    $success++;
-                }
-            }
-        }
-        $what = $success > 1
-            ? esc_html__('Contacts', 'event_espresso')
-            : esc_html__('Contact', 'event_espresso');
-
-        $this->_redirect_after_action(
-            $success,
-            $what,
-            esc_html__('deleted', 'event_espresso'),
-            [
-                'action' => 'contact_list',
-                'status' => 'trash',
-            ],
-            $success == 0
-        );
-    }
-
-
-    /**
-     * @return array
-     * @since  :VID:
-     */
-    private function getAttIdsFromRequest(): array
-    {
-        if ($this->request->requestParamIsSet('ATT_IDs')) {
-            return $this->request->getRequestParam('ATT_IDs', [], 'int', true);
-        } else {
-            return $this->request->getRequestParam('ATT_ID', [], 'int', true);
-        }
-    }
-
-
-    /**
-     * @return EE_Session|null
-     * @since 5.0.20.p
-     */
-    private function getSession(): ?EE_Session
-    {
-        return EE_Registry::instance()->SSN;
-    }
-
-
-    /**
-     * @param string $class
-     * @param string $function
-     * @return void
-     * @throws EE_Error
-     * @throws ReflectionException
-     * @since 5.0.20.p
-     */
-    private function clearSession(string $class, string $function)
-    {
-        $session = $this->getSession();
-        if ($session instanceof EE_Session) {
-            $session->clear_session($class, $function);
-        }
-    }
-
-
-    /**
-     * @return EE_Cart|null
-     * @since 5.0.20.p
-     */
-    private function getCart(): ?EE_Cart
-    {
-        $session = $this->getSession();
-        return $session instanceof EE_Session ? $session->cart() : null;
-    }
+		}
+		$template_args = [
+			'title'                    => '',
+			'content'                  => '',
+			'step_button_text'         => '',
+			'show_notification_toggle' => false,
+		];
+		// to indicate we're processing a new registration
+		$hidden_fields = [
+			'processing_registration' => [
+				'type'  => 'hidden',
+				'value' => 0,
+			],
+			'event_id'                => [
+				'type'  => 'hidden',
+				'value' => $this->_reg_event->ID(),
+			],
+		];
+		// if the cart is empty then we know we're at step one, so we'll display the ticket selector
+		$cart = $this->getCart();
+		$step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
+		switch ($step) {
+			case 'ticket':
+				$hidden_fields['processing_registration']['value'] = 1;
+				$template_args['title']                            = esc_html__(
+					'Step One: Select the Ticket for this registration',
+					'event_espresso'
+				);
+				$template_args['content']                          =
+					EED_Ticket_Selector::instance()->display_ticket_selector($this->_reg_event);
+				$template_args['content']                          .= '</div>';
+				$template_args['step_button_text']                 = esc_html__(
+					'Add Tickets and Continue to Registrant Details',
+					'event_espresso'
+				);
+				$template_args['show_notification_toggle']         = false;
+				break;
+			case 'questions':
+				$hidden_fields['processing_registration']['value'] = 2;
+				$template_args['title']                            = esc_html__(
+					'Step Two: Add Registrant Details for this Registration',
+					'event_espresso'
+				);
+				// in theory, we should be able to run EED_SPCO at this point
+				// because the cart should have been set up properly by the first process_reg_step run.
+				$template_args['content']                  =
+					EED_Single_Page_Checkout::registration_checkout_for_admin();
+				$template_args['step_button_text']         = esc_html__(
+					'Save Registration and Continue to Details',
+					'event_espresso'
+				);
+				$template_args['show_notification_toggle'] = true;
+				break;
+		}
+		// we come back to the process_registration_step route.
+		$this->_set_add_edit_form_tags('process_reg_step', $hidden_fields);
+		return EEH_Template::display_template(
+			REG_TEMPLATE_PATH . 'reg_admin_register_new_attendee_step_content.template.php',
+			$template_args,
+			true
+		);
+	}
+
+
+	/**
+	 * set_reg_event
+	 *
+	 * @return bool
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	private function _set_reg_event(): bool
+	{
+		if (is_object($this->_reg_event)) {
+			return true;
+		}
+
+		$EVT_ID = $this->request->getRequestParam('event_id', 0, 'int');
+		if (! $EVT_ID) {
+			return false;
+		}
+		$this->_reg_event = $this->getEventModel()->get_one_by_ID($EVT_ID);
+		return true;
+	}
+
+
+	/**
+	 * process_reg_step
+	 *
+	 * @return void
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws RuntimeException
+	 * @throws Throwable
+	 */
+	public function process_reg_step()
+	{
+		EE_System::do_not_cache();
+		$this->_set_reg_event();
+		/** @var CurrentPage $current_page */
+		$current_page = $this->loader->getShared(CurrentPage::class);
+		$current_page->setEspressoPage(true);
+		$this->request->setRequestParam('uts', time());
+		// what step are we on?
+		$cart = $this->getCart();
+		$step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
+		// if doing ajax then we need to verify the nonce
+		if ($this->request->isAjax()) {
+			$nonce = $this->request->getRequestParam($this->_req_nonce, '');
+			$this->_verify_nonce($nonce, $this->_req_nonce);
+		}
+		switch ($step) {
+			case 'ticket':
+				// process ticket selection
+				$success = EED_Ticket_Selector::instance()->process_ticket_selections();
+				if ($success) {
+					EE_Error::add_success(
+						esc_html__(
+							'Tickets Selected. Now complete the registration.',
+							'event_espresso'
+						)
+					);
+				} else {
+					$this->request->setRequestParam('step_error', true);
+					$query_args['step_error'] = $this->request->getRequestParam('step_error', true, 'bool');
+				}
+				if ($this->request->isAjax()) {
+					$this->new_registration(); // display next step
+				} else {
+					$query_args = [
+						'action'                  => 'new_registration',
+						'processing_registration' => 1,
+						'event_id'                => $this->_reg_event->ID(),
+						'uts'                     => time(),
+					];
+					$this->_redirect_after_action(
+						false,
+						'',
+						'',
+						$query_args,
+						true
+					);
+				}
+				break;
+			case 'questions':
+				if (! $this->request->requestParamIsSet('txn_reg_status_change[send_notifications]')) {
+					add_filter('FHEE__EED_Messages___maybe_registration__deliver_notifications', '__return_false', 15);
+				}
+				// process registration
+				$transaction = EED_Single_Page_Checkout::instance()->process_registration_from_admin();
+				if ($cart instanceof EE_Cart) {
+					$grand_total = $cart->get_grand_total();
+					if ($grand_total instanceof EE_Line_Item) {
+						$grand_total->save_this_and_descendants_to_txn();
+					}
+				}
+				if (! $transaction instanceof EE_Transaction) {
+					$query_args = [
+						'action'                  => 'new_registration',
+						'processing_registration' => 2,
+						'event_id'                => $this->_reg_event->ID(),
+						'uts'                     => time(),
+					];
+					if ($this->request->isAjax()) {
+						// display registration form again because there are errors (maybe validation?)
+						$this->new_registration();
+						return;
+					}
+					$this->_redirect_after_action(
+						false,
+						'',
+						'',
+						$query_args,
+						true
+					);
+					return;
+				}
+				// maybe update status, and make sure to save transaction if not done already
+				if (! $transaction->update_status_based_on_total_paid()) {
+					$transaction->save();
+				}
+				$this->clearSession(__CLASS__, __FUNCTION__);
+				$query_args = [
+					'action'        => 'redirect_to_txn',
+					'TXN_ID'        => $transaction->ID(),
+					'EVT_ID'        => $this->_reg_event->ID(),
+					'event_name'    => urlencode($this->_reg_event->name()),
+					'redirect_from' => 'new_registration',
+				];
+				$this->_redirect_after_action(false, '', '', $query_args, true);
+				break;
+		}
+		// what are you looking here for?  Should be nothing to do at this point.
+	}
+
+
+	/**
+	 * redirect_to_txn
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	public function redirect_to_txn()
+	{
+		EE_System::do_not_cache();
+		$this->clearSession(__CLASS__, __FUNCTION__);
+		$query_args = [
+			'action' => 'view_transaction',
+			'TXN_ID' => $this->request->getRequestParam('TXN_ID', 0, 'int'),
+			'page'   => 'espresso_transactions',
+		];
+		if ($this->request->requestParamIsSet('EVT_ID') && $this->request->requestParamIsSet('redirect_from')) {
+			$query_args['EVT_ID']        = $this->request->getRequestParam('EVT_ID', 0, 'int');
+			$query_args['event_name']    = urlencode($this->request->getRequestParam('event_name'));
+			$query_args['redirect_from'] = $this->request->getRequestParam('redirect_from');
+		}
+		EE_Error::add_success(
+			esc_html__(
+				'Registration Created.  Please review the transaction and add any payments as necessary',
+				'event_espresso'
+			)
+		);
+		$this->_redirect_after_action(false, '', '', $query_args, true);
+	}
+
+
+	/**
+	 * generates HTML for the Attendee Contact List
+	 *
+	 * @return void
+	 * @throws DomainException
+	 * @throws EE_Error
+	 */
+	protected function _attendee_contact_list_table()
+	{
+		$this->_search_btn_label = esc_html__('Contacts', 'event_espresso');
+		$this->display_admin_list_table_page_with_no_sidebar();
+	}
+
+
+	/**
+	 * get_attendees
+	 *
+	 * @param int  $per_page
+	 * @param bool $count whether to return count or data.
+	 * @param bool $trash
+	 * @return array|int
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	public function get_attendees(int $per_page, bool $count = false, bool $trash = false)
+	{
+		require_once(REG_ADMIN . 'EE_Attendee_Contact_List_Table.class.php');
+		$orderby = $this->request->getRequestParam('orderby');
+		switch ($orderby) {
+			case 'ATT_ID':
+			case 'ATT_fname':
+			case 'ATT_email':
+			case 'ATT_city':
+			case 'STA_ID':
+			case 'CNT_ID':
+				break;
+			case 'Registration_Count':
+				$orderby = 'Registration_Count';
+				break;
+			default:
+				$orderby = 'ATT_lname';
+		}
+		$sort         = $this->request->getRequestParam('order', 'ASC');
+		$current_page = $this->request->getRequestParam('paged', 1, 'int');
+		$per_page     = absint($per_page) ? $per_page : 10;
+		$per_page     = $this->request->getRequestParam('perpage', $per_page, 'int');
+		$_where       = [];
+		$search_term  = $this->request->getRequestParam('s');
+		if ($search_term) {
+			$search_term  = '%' . $search_term . '%';
+			$_where['OR'] = [
+				'Registration.Event.EVT_name'       => ['LIKE', $search_term],
+				'Registration.Event.EVT_desc'       => ['LIKE', $search_term],
+				'Registration.Event.EVT_short_desc' => ['LIKE', $search_term],
+				'ATT_fname'                         => ['LIKE', $search_term],
+				'ATT_lname'                         => ['LIKE', $search_term],
+				'ATT_short_bio'                     => ['LIKE', $search_term],
+				'ATT_email'                         => ['LIKE', $search_term],
+				'ATT_address'                       => ['LIKE', $search_term],
+				'ATT_address2'                      => ['LIKE', $search_term],
+				'ATT_city'                          => ['LIKE', $search_term],
+				'Country.CNT_name'                  => ['LIKE', $search_term],
+				'State.STA_name'                    => ['LIKE', $search_term],
+				'ATT_phone'                         => ['LIKE', $search_term],
+				'Registration.REG_final_price'      => ['LIKE', $search_term],
+				'Registration.REG_code'             => ['LIKE', $search_term],
+				'Registration.REG_group_size'       => ['LIKE', $search_term],
+			];
+		}
+		$offset     = ($current_page - 1) * $per_page;
+		$limit      = $count ? null : [$offset, $per_page];
+		$query_args = [
+			$_where,
+			'extra_selects' => ['Registration_Count' => ['Registration.REG_ID', 'count', '%d']],
+			'limit'         => $limit,
+		];
+		if (! $count) {
+			$query_args['order_by'] = [$orderby => $sort];
+		}
+		$query_args[0]['status'] = $trash ? ['!=', 'publish'] : ['IN', ['publish']];
+		return $count
+			? $this->getAttendeeModel()->count($query_args, 'ATT_ID', true)
+			: $this->getAttendeeModel()->get_all($query_args);
+	}
+
+
+	/**
+	 * This is just taking care of resending the registration confirmation
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	protected function _resend_registration()
+	{
+		$this->_process_resend_registration();
+		$REG_ID      = $this->request->getRequestParam('_REG_ID', 0, 'int');
+		$redirect_to = $this->request->getRequestParam('redirect_to');
+		$query_args  = $redirect_to
+			? ['action' => $redirect_to, '_REG_ID' => $REG_ID]
+			: ['action' => 'default'];
+		$this->_redirect_after_action(false, '', '', $query_args, true);
+	}
+
+
+	/**
+	 * Creates a registration report, but accepts the name of a method to use for preparing the query parameters
+	 * to use when selecting registrations
+	 *
+	 * @param string $method_name_for_getting_query_params the name of the method (on this class) to use for preparing
+	 *                                                     the query parameters from the request
+	 * @return void ends the request with a redirect or download
+	 */
+	public function _registrations_report_base(string $method_name_for_getting_query_params)
+	{
+		$EVT_ID = $this->request->requestParamIsSet('EVT_ID')
+			? $this->request->getRequestParam('EVT_ID', 0, DataType::INT)
+			: null;
+		if (! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
+			$return_url    = $this->request->getRequestParam('return_url', '', DataType::URL);
+			$filters       = $this->request->getRequestParam('filters', [], DataType::STRING, true);
+			$report_params = $this->$method_name_for_getting_query_params($filters);
+			$report_params = $this->convertDatetimeObjectsToStrings($report_params);
+			$use_filters   = $this->request->getRequestParam('use_filters', false, DataType::BOOL);
+			wp_redirect(
+				EE_Admin_Page::add_query_args_and_nonce(
+					[
+						'page'        => EED_Batch::PAGE_SLUG,
+						'batch'       => EED_Batch::batch_file_job,
+						'EVT_ID'      => $EVT_ID,
+						'filters'     => urlencode(serialize($report_params)),
+						'use_filters' => urlencode($use_filters),
+						'job_handler' => urlencode(
+							'EventEspresso\core\libraries\batch\JobHandlers\RegistrationsReport'
+						),
+						'return_url'  => urlencode($return_url),
+					]
+				)
+			);
+		} else {
+			// Pull the current request params
+			$request_args = $this->request->requestParams();
+			$request_args = $this->convertDatetimeObjectsToStrings($request_args);
+			// Set the required request_args to be passed to the export
+			$required_request_args = [
+				'export' => 'report',
+				'action' => 'registrations_report_for_event',
+				'EVT_ID' => $EVT_ID,
+			];
+			// Merge required request args, overriding any currently set
+			$request_args = array_merge($request_args, $required_request_args);
+			if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
+				require_once(EE_CLASSES . 'EE_Export.class.php');
+				$EE_Export = EE_Export::instance($request_args);
+				$EE_Export->export();
+			}
+		}
+	}
+
+
+	/**
+	 * recursively convert Datetime objects in query params array to strings using MySQL format
+	 *
+	 * @param array $query_params
+	 * @return array
+	 * @since 5.0.19.p
+	 */
+	private function convertDatetimeObjectsToStrings(array $query_params): array
+	{
+		foreach ($query_params as $key => $value) {
+			if (is_array($value)) {
+				$query_params[ $key ] = $this->convertDatetimeObjectsToStrings($value);
+			} elseif ($value instanceof DateTime) {
+				$query_params[ $key ] = $value->format('Y-m-d H:i:s');
+			}
+		}
+		return $query_params;
+	}
+
+
+	/**
+	 * Creates a registration report using only query parameters in the request
+	 *
+	 * @return void
+	 */
+	public function _registrations_report()
+	{
+		$this->_registrations_report_base('_get_registration_query_parameters');
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 */
+	public function _contact_list_export()
+	{
+		if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
+			require_once(EE_CLASSES . 'EE_Export.class.php');
+			$EE_Export = EE_Export::instance($this->request->requestParams());
+			$EE_Export->export_attendees();
+		}
+	}
+
+
+	public function _contact_list_report()
+	{
+		if (! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
+			wp_redirect(
+				EE_Admin_Page::add_query_args_and_nonce(
+					[
+						'page'        => EED_Batch::PAGE_SLUG,
+						'batch'       => EED_Batch::batch_file_job,
+						'job_handler' => urlencode('EventEspresso\core\libraries\batch\JobHandlers\AttendeesReport'),
+						'return_url'  => urlencode($this->request->getRequestParam('return_url', '', DataType::URL)),
+					]
+				)
+			);
+		} else {
+			if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
+				require_once(EE_CLASSES . 'EE_Export.class.php');
+				$EE_Export = EE_Export::instance($this->request->requestParams());
+				$EE_Export->report_attendees();
+			}
+		}
+	}
+
+
+
+
+
+	/***************************************        ATTENDEE DETAILS        ***************************************/
+	/**
+	 * This duplicates the attendee object for the given incoming registration id and attendee_id.
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	protected function _duplicate_attendee()
+	{
+		$REG_ID = $this->request->getRequestParam('_REG_ID', 0, 'int');
+		$action = $this->request->getRequestParam('return', 'default');
+		// verify we have necessary info
+		if (! $REG_ID) {
+			EE_Error::add_error(
+				esc_html__(
+					'Unable to create the contact for the registration because the required parameters are not present (_REG_ID )',
+					'event_espresso'
+				),
+				__FILE__,
+				__LINE__,
+				__FUNCTION__
+			);
+			$query_args = ['action' => $action];
+			$this->_redirect_after_action('', '', '', $query_args, true);
+		}
+		// okay necessary deets present... let's dupe the incoming attendee and attach to incoming registration.
+		$registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
+		if (! $registration instanceof EE_Registration) {
+			throw new RuntimeException(
+				sprintf(
+					esc_html__(
+						'Unable to create the contact because a valid registration could not be retrieved for REG ID: %1$d',
+						'event_espresso'
+					),
+					$REG_ID
+				)
+			);
+		}
+		$attendee = $registration->attendee();
+		// remove relation of existing attendee on registration
+		$registration->_remove_relation_to($attendee, 'Attendee');
+		// new attendee
+		$new_attendee = clone $attendee;
+		$new_attendee->set('ATT_ID', 0);
+		$new_attendee->save();
+		// add new attendee to reg
+		$registration->_add_relation_to($new_attendee, 'Attendee');
+		EE_Error::add_success(
+			esc_html__(
+				'New Contact record created.  Now make any edits you wish to make for this contact.',
+				'event_espresso'
+			)
+		);
+		// redirect to edit page for attendee
+		$query_args = ['post' => $new_attendee->ID(), 'action' => 'edit_attendee'];
+		$this->_redirect_after_action('', '', '', $query_args, true);
+	}
+
+
+	/**
+	 * Callback invoked by parent EE_Admin_CPT class hooked in on `save_post` wp hook.
+	 *
+	 * @param int     $post_id
+	 * @param WP_Post $post
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws LogicException
+	 * @throws InvalidFormSubmissionException
+	 * @throws ReflectionException
+	 */
+	protected function _insert_update_cpt_item($post_id, $post)
+	{
+		$success  = true;
+		$attendee = $post instanceof WP_Post && $post->post_type === EspressoPostType::ATTENDEES
+			? $this->getAttendeeModel()->get_one_by_ID($post_id)
+			: null;
+		// for attendee updates
+		if ($attendee instanceof EE_Attendee) {
+			// note we should only be UPDATING attendees at this point.
+			$fname          = $this->request->getRequestParam('ATT_fname', '');
+			$lname          = $this->request->getRequestParam('ATT_lname', '');
+			$updated_fields = [
+				'ATT_fname'     => $fname,
+				'ATT_lname'     => $lname,
+				'ATT_full_name' => "$fname $lname",
+				'ATT_address'   => $this->request->getRequestParam('ATT_address', ''),
+				'ATT_address2'  => $this->request->getRequestParam('ATT_address2', ''),
+				'ATT_city'      => $this->request->getRequestParam('ATT_city', ''),
+				'STA_ID'        => $this->request->getRequestParam('STA_ID', ''),
+				'CNT_ISO'       => $this->request->getRequestParam('CNT_ISO', ''),
+				'ATT_zip'       => $this->request->getRequestParam('ATT_zip', ''),
+			];
+			foreach ($updated_fields as $field => $value) {
+				$attendee->set($field, $value);
+			}
+
+			// process contact details metabox form handler (which will also save the attendee)
+			$contact_details_form = $this->getAttendeeContactDetailsMetaboxFormHandler($attendee);
+			$success              = $contact_details_form->process($this->request->requestParams());
+
+			$attendee_update_callbacks = apply_filters(
+				'FHEE__Registrations_Admin_Page__insert_update_cpt_item__attendee_update',
+				[]
+			);
+			foreach ($attendee_update_callbacks as $a_callback) {
+				if (false === call_user_func_array($a_callback, [$attendee, $this->request->requestParams()])) {
+					throw new EE_Error(
+						sprintf(
+							esc_html__(
+								'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.',
+								'event_espresso'
+							),
+							$a_callback
+						)
+					);
+				}
+			}
+		}
+
+		if ($success === false) {
+			EE_Error::add_error(
+				esc_html__(
+					'Something went wrong with updating the meta table data for the registration.',
+					'event_espresso'
+				),
+				__FILE__,
+				__FUNCTION__,
+				__LINE__
+			);
+		}
+	}
+
+
+	public function trash_cpt_item($post_id)
+	{
+	}
+
+
+	public function delete_cpt_item($post_id)
+	{
+	}
+
+
+	public function restore_cpt_item($post_id)
+	{
+	}
+
+
+	protected function _restore_cpt_item($post_id, $revision_id)
+	{
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 * @since 4.10.2.p
+	 */
+	public function attendee_editor_metaboxes()
+	{
+		$this->verify_cpt_object();
+		remove_meta_box(
+			'postexcerpt',
+			$this->_cpt_routes[ $this->_req_action ],
+			'normal'
+		);
+		remove_meta_box('commentstatusdiv', $this->_cpt_routes[ $this->_req_action ], 'normal');
+		if (post_type_supports(EspressoPostType::ATTENDEES, 'excerpt')) {
+			$this->addMetaBox(
+				'postexcerpt',
+				esc_html__('Short Biography', 'event_espresso'),
+				'post_excerpt_meta_box',
+				$this->_cpt_routes[ $this->_req_action ]
+			);
+		}
+		if (post_type_supports(EspressoPostType::ATTENDEES, 'comments')) {
+			$this->addMetaBox(
+				'commentsdiv',
+				esc_html__('Notes on the Contact', 'event_espresso'),
+				'post_comment_meta_box',
+				$this->_cpt_routes[ $this->_req_action ],
+				'normal',
+				'core'
+			);
+		}
+		$this->addMetaBox(
+			'attendee_contact_info',
+			esc_html__('Contact Info', 'event_espresso'),
+			[$this, 'attendee_contact_info'],
+			$this->_cpt_routes[ $this->_req_action ],
+			'side',
+			'core'
+		);
+		$this->addMetaBox(
+			'attendee_details_address',
+			esc_html__('Address Details', 'event_espresso'),
+			[$this, 'attendee_address_details'],
+			$this->_cpt_routes[ $this->_req_action ],
+			'normal',
+			'core'
+		);
+		$this->addMetaBox(
+			'attendee_registrations',
+			esc_html__('Registrations for this Contact', 'event_espresso'),
+			[$this, 'attendee_registrations_meta_box'],
+			$this->_cpt_routes[ $this->_req_action ]
+		);
+	}
+
+
+	/**
+	 * Metabox for attendee contact info
+	 *
+	 * @param WP_Post $post wp post object
+	 * @return void attendee contact info ( and form )
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws LogicException
+	 * @throws DomainException
+	 */
+	public function attendee_contact_info(WP_Post $post)
+	{
+		// get attendee object ( should already have it )
+		$form = $this->getAttendeeContactDetailsMetaboxFormHandler($this->_cpt_model_obj);
+		$form->enqueueStylesAndScripts();
+		echo wp_kses($form->display(), AllowedTags::getWithFormTags());
+	}
+
+
+	/**
+	 * Return form handler for the contact details metabox
+	 *
+	 * @param EE_Attendee $attendee
+	 * @return AttendeeContactDetailsMetaboxFormHandler
+	 * @throws DomainException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 */
+	protected function getAttendeeContactDetailsMetaboxFormHandler(EE_Attendee $attendee): AttendeeContactDetailsMetaboxFormHandler
+	{
+		return new AttendeeContactDetailsMetaboxFormHandler($attendee, EE_Registry::instance());
+	}
+
+
+	/**
+	 * Metabox for attendee details
+	 *
+	 * @param WP_Post $post wp post object
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function attendee_address_details(WP_Post $post)
+	{
+		// get attendee object (should already have it)
+		$this->_template_args['attendee']     = $this->_cpt_model_obj;
+		$this->_template_args['state_html']   = EEH_Form_Fields::generate_form_input(
+			new EE_Question_Form_Input(
+				EE_Question::new_instance(
+					[
+						'QST_ID'           => 0,
+						'QST_display_text' => esc_html__('State/Province', 'event_espresso'),
+						'QST_system'       => 'admin-state',
+					]
+				),
+				EE_Answer::new_instance(
+					[
+						'ANS_ID'    => 0,
+						'ANS_value' => $this->_cpt_model_obj->state_ID(),
+					]
+				),
+				[
+					'input_id'       => 'STA_ID',
+					'input_name'     => 'STA_ID',
+					'input_prefix'   => '',
+					'append_qstn_id' => false,
+				]
+			)
+		);
+		$this->_template_args['country_html'] = EEH_Form_Fields::generate_form_input(
+			new EE_Question_Form_Input(
+				EE_Question::new_instance(
+					[
+						'QST_ID'           => 0,
+						'QST_display_text' => esc_html__('Country', 'event_espresso'),
+						'QST_system'       => 'admin-country',
+					]
+				),
+				EE_Answer::new_instance(
+					[
+						'ANS_ID'    => 0,
+						'ANS_value' => $this->_cpt_model_obj->country_ID(),
+					]
+				),
+				[
+					'input_id'       => 'CNT_ISO',
+					'input_name'     => 'CNT_ISO',
+					'input_prefix'   => '',
+					'append_qstn_id' => false,
+				]
+			)
+		);
+		$template                             =
+			REG_TEMPLATE_PATH . 'attendee_address_details_metabox_content.template.php';
+		EEH_Template::display_template($template, $this->_template_args);
+	}
+
+
+	/**
+	 * @param WP_Post $post
+	 * @return void
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	public function attendee_registrations_meta_box(WP_Post $post)
+	{
+		$this->_template_args['attendee']      = $this->_cpt_model_obj;
+		$this->_template_args['registrations'] = $this->_cpt_model_obj->get_many_related('Registration');
+		$template                              =
+			REG_TEMPLATE_PATH . 'attendee_registrations_main_meta_box.template.php';
+		EEH_Template::display_template($template, $this->_template_args);
+	}
+
+
+	/**
+	 * add in the form fields for the attendee edit
+	 *
+	 * @param WP_Post $post wp post object
+	 * @return void echos html for new form.
+	 * @throws DomainException
+	 */
+	public function after_title_form_fields(WP_Post $post)
+	{
+		if ($post->post_type === EspressoPostType::ATTENDEES) {
+			$template                  = REG_TEMPLATE_PATH . 'attendee_details_after_title_form_fields.template.php';
+			$template_args['attendee'] = $this->_cpt_model_obj;
+			EEH_Template::display_template($template, $template_args);
+		}
+	}
+
+
+	/**
+	 * _trash_or_restore_attendee
+	 *
+	 * @param bool $trash - whether to move item to trash (TRUE) or restore it (FALSE)
+	 * @return void
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	protected function _trash_or_restore_attendees(bool $trash = true)
+	{
+		$status = $trash ? 'trash' : 'publish';
+		// Checkboxes
+		if ($this->request->requestParamIsSet('ATT_IDs')) {
+			$ATT_IDs = $this->request->getRequestParam('ATT_IDs', [], 'int', true);
+			// if array has more than one element than success message should be plural
+			$success = count($ATT_IDs) > 1 ? 2 : 1;
+			// cycle thru checkboxes
+			foreach ($ATT_IDs as $ATT_ID) {
+				$updated = $this->getAttendeeModel()->update_by_ID(['status' => $status], $ATT_ID);
+				if (! $updated) {
+					$success = 0;
+				}
+			}
+		} else {
+			// grab single id and delete
+			$ATT_ID = $this->request->getRequestParam('ATT_ID', 0, 'int');
+			// update attendee
+			$success = $this->getAttendeeModel()->update_by_ID(['status' => $status], $ATT_ID) ? 1 : 0;
+		}
+		$what        = $success > 1
+			? esc_html__('Contacts', 'event_espresso')
+			: esc_html__('Contact', 'event_espresso');
+		$action_desc = $trash
+			? esc_html__('moved to the trash', 'event_espresso')
+			: esc_html__('restored', 'event_espresso');
+		$this->_redirect_after_action($success, $what, $action_desc, ['action' => 'contact_list']);
+	}
+
+
+	/**
+	 * @return void
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 * @since  :VID:
+	 */
+	protected function deleteAttendees()
+	{
+		$success = 0;
+		$att_ids = $this->getAttIdsFromRequest();
+		foreach ($att_ids as $att_id) {
+			$attendee = $this->getAttendeeModel()->get_one_by_ID($att_id);
+			if ($attendee instanceof EE_Attendee) {
+				$deleted = $attendee->delete_permanently();
+				if ($deleted) {
+					$success++;
+				}
+			}
+		}
+		$what = $success > 1
+			? esc_html__('Contacts', 'event_espresso')
+			: esc_html__('Contact', 'event_espresso');
+
+		$this->_redirect_after_action(
+			$success,
+			$what,
+			esc_html__('deleted', 'event_espresso'),
+			[
+				'action' => 'contact_list',
+				'status' => 'trash',
+			],
+			$success == 0
+		);
+	}
+
+
+	/**
+	 * @return array
+	 * @since  :VID:
+	 */
+	private function getAttIdsFromRequest(): array
+	{
+		if ($this->request->requestParamIsSet('ATT_IDs')) {
+			return $this->request->getRequestParam('ATT_IDs', [], 'int', true);
+		} else {
+			return $this->request->getRequestParam('ATT_ID', [], 'int', true);
+		}
+	}
+
+
+	/**
+	 * @return EE_Session|null
+	 * @since 5.0.20.p
+	 */
+	private function getSession(): ?EE_Session
+	{
+		return EE_Registry::instance()->SSN;
+	}
+
+
+	/**
+	 * @param string $class
+	 * @param string $function
+	 * @return void
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 * @since 5.0.20.p
+	 */
+	private function clearSession(string $class, string $function)
+	{
+		$session = $this->getSession();
+		if ($session instanceof EE_Session) {
+			$session->clear_session($class, $function);
+		}
+	}
+
+
+	/**
+	 * @return EE_Cart|null
+	 * @since 5.0.20.p
+	 */
+	private function getCart(): ?EE_Cart
+	{
+		$session = $this->getSession();
+		return $session instanceof EE_Session ? $session->cart() : null;
+	}
 }

Spacing +108 added lines, -108 removed lines

@@ -77,7 +77,7 @@ 
      */
     protected function getRegistrationModel(): EEM_Registration
     {
-        if (! $this->registration_model instanceof EEM_Registration) {
+        if ( ! $this->registration_model instanceof EEM_Registration) {
             $this->registration_model = $this->loader->getShared('EEM_Registration');
         }
         return $this->registration_model;
@@ -93,7 +93,7 @@ 
      */
     protected function getAttendeeModel(): EEM_Attendee
     {
-        if (! $this->attendee_model instanceof EEM_Attendee) {
+        if ( ! $this->attendee_model instanceof EEM_Attendee) {
             $this->attendee_model = $this->loader->getShared('EEM_Attendee');
         }
         return $this->attendee_model;
@@ -109,7 +109,7 @@ 
      */
     protected function getEventModel(): EEM_Event
     {
-        if (! $this->event_model instanceof EEM_Event) {
+        if ( ! $this->event_model instanceof EEM_Event) {
             $this->event_model = $this->loader->getShared('EEM_Event');
         }
         return $this->event_model;
@@ -125,7 +125,7 @@ 
      */
     protected function getStatusModel(): EEM_Status
     {
-        if (! $this->status_model instanceof EEM_Status) {
+        if ( ! $this->status_model instanceof EEM_Status) {
             $this->status_model = $this->loader->getShared('EEM_Status');
         }
         return $this->status_model;
@@ -758,7 +758,7 @@ 
         // style
         wp_register_style(
             'espresso_reg',
-            REG_ASSETS_URL . 'espresso_registrations_admin.css',
+            REG_ASSETS_URL.'espresso_registrations_admin.css',
             ['ee-admin-css'],
             EVENT_ESPRESSO_VERSION
         );
@@ -766,7 +766,7 @@ 
         // script
         wp_register_script(
             'espresso_reg',
-            REG_ASSETS_URL . 'espresso_registrations_admin.js',
+            REG_ASSETS_URL.'espresso_registrations_admin.js',
             ['jquery-ui-datepicker', 'jquery-ui-draggable', 'ee_admin_js'],
             EVENT_ESPRESSO_VERSION,
             true
@@ -790,7 +790,7 @@ 
             'att_publish_text' => sprintf(
             /* translators: The date and time */
                 wp_strip_all_tags(__('Created on: %s', 'event_espresso')),
-                '<b>' . $this->_cpt_model_obj->get_datetime('ATT_created') . '</b>'
+                '<b>'.$this->_cpt_model_obj->get_datetime('ATT_created').'</b>'
             ),
         ];
         wp_localize_script('espresso_reg', 'ATTENDEE_DETAILS', $attendee_details_translations);
@@ -822,7 +822,7 @@ 
         wp_dequeue_style('espresso_reg');
         wp_register_style(
             'espresso_att',
-            REG_ASSETS_URL . 'espresso_attendees_admin.css',
+            REG_ASSETS_URL.'espresso_attendees_admin.css',
             ['ee-admin-css'],
             EVENT_ESPRESSO_VERSION
         );
@@ -838,7 +838,7 @@ 
     {
         wp_register_script(
             'ee-spco-for-admin',
-            REG_ASSETS_URL . 'spco_for_admin.js',
+            REG_ASSETS_URL.'spco_for_admin.js',
             ['underscore', 'jquery'],
             EVENT_ESPRESSO_VERSION,
             true
@@ -885,7 +885,7 @@ 
             'no_approve_registrations' => 'not_approved_registration',
             'cancel_registrations'     => 'cancelled_registration',
         ];
-        $can_send    = $this->capabilities->current_user_can(
+        $can_send = $this->capabilities->current_user_can(
             'ee_send_message',
             'batch_send_messages'
         );
@@ -1005,7 +1005,7 @@ 
                     'trash_registrations' => esc_html__('Trash Registrations', 'event_espresso'),
                 ],
             ];
-            $this->_views['trash']      = [
+            $this->_views['trash'] = [
                 'slug'        => 'trash',
                 'label'       => esc_html__('Trash', 'event_espresso'),
                 'count'       => 0,
@@ -1106,7 +1106,7 @@ 
         }
         $sc_items = [
             'approved_status'   => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::APPROVED,
+                'class' => 'ee-status-legend ee-status-bg--'.RegStatus::APPROVED,
                 'desc'  => EEH_Template::pretty_status(
                     RegStatus::APPROVED,
                     false,
@@ -1114,7 +1114,7 @@ 
                 ),
             ],
             'pending_status'    => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::PENDING_PAYMENT,
+                'class' => 'ee-status-legend ee-status-bg--'.RegStatus::PENDING_PAYMENT,
                 'desc'  => EEH_Template::pretty_status(
                     RegStatus::PENDING_PAYMENT,
                     false,
@@ -1122,7 +1122,7 @@ 
                 ),
             ],
             'wait_list'         => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::WAIT_LIST,
+                'class' => 'ee-status-legend ee-status-bg--'.RegStatus::WAIT_LIST,
                 'desc'  => EEH_Template::pretty_status(
                     RegStatus::WAIT_LIST,
                     false,
@@ -1130,7 +1130,7 @@ 
                 ),
             ],
             'incomplete_status' => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::INCOMPLETE,
+                'class' => 'ee-status-legend ee-status-bg--'.RegStatus::INCOMPLETE,
                 'desc'  => EEH_Template::pretty_status(
                     RegStatus::INCOMPLETE,
                     false,
@@ -1138,7 +1138,7 @@ 
                 ),
             ],
             'not_approved'      => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::AWAITING_REVIEW,
+                'class' => 'ee-status-legend ee-status-bg--'.RegStatus::AWAITING_REVIEW,
                 'desc'  => EEH_Template::pretty_status(
                     RegStatus::AWAITING_REVIEW,
                     false,
@@ -1146,7 +1146,7 @@ 
                 ),
             ],
             'declined_status'   => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::DECLINED,
+                'class' => 'ee-status-legend ee-status-bg--'.RegStatus::DECLINED,
                 'desc'  => EEH_Template::pretty_status(
                     RegStatus::DECLINED,
                     false,
@@ -1154,7 +1154,7 @@ 
                 ),
             ],
             'cancelled_status'  => [
-                'class' => 'ee-status-legend ee-status-bg--' . RegStatus::CANCELLED,
+                'class' => 'ee-status-legend ee-status-bg--'.RegStatus::CANCELLED,
                 'desc'  => EEH_Template::pretty_status(
                     RegStatus::CANCELLED,
                     false,
@@ -1214,7 +1214,7 @@ 
                 $EVT_ID
             )
         ) {
-            $this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
+            $this->_admin_page_title .= ' '.$this->get_action_link_or_button(
                     'new_registration',
                     'add-registrant',
                     ['event_id' => $EVT_ID],
@@ -1373,7 +1373,7 @@ 
                 ],
                 REG_ADMIN_URL
             );
-            $this->_template_args['filtered_transactions_link']  = EE_Admin_Page::add_query_args_and_nonce(
+            $this->_template_args['filtered_transactions_link'] = EE_Admin_Page::add_query_args_and_nonce(
                 [
                     'action' => 'default',
                     'EVT_ID' => $event_id,
@@ -1381,7 +1381,7 @@ 
                 ],
                 admin_url('admin.php')
             );
-            $this->_template_args['event_link']                  = EE_Admin_Page::add_query_args_and_nonce(
+            $this->_template_args['event_link'] = EE_Admin_Page::add_query_args_and_nonce(
                 [
                     'page'   => 'espresso_events',
                     'action' => 'edit',
@@ -1390,12 +1390,12 @@ 
                 admin_url('admin.php')
             );
             // next and previous links
-            $next_reg                                      = $this->_registration->next(
+            $next_reg = $this->_registration->next(
                 null,
                 [],
                 'REG_ID'
             );
-            $this->_template_args['next_registration']     = $next_reg
+            $this->_template_args['next_registration'] = $next_reg
                 ? $this->_next_link(
                     EE_Admin_Page::add_query_args_and_nonce(
                         [
@@ -1407,7 +1407,7 @@ 
                     'dashicons dashicons-arrow-right ee-icon-size-22'
                 )
                 : '';
-            $previous_reg                                  = $this->_registration->previous(
+            $previous_reg = $this->_registration->previous(
                 null,
                 [],
                 'REG_ID'
@@ -1425,7 +1425,7 @@ 
                 )
                 : '';
             // grab header
-            $template_path                             = REG_TEMPLATE_PATH . 'reg_admin_details_header.template.php';
+            $template_path                             = REG_TEMPLATE_PATH.'reg_admin_details_header.template.php';
             $this->_template_args['REG_ID']            = $this->_registration->ID();
             $this->_template_args['admin_page_header'] = EEH_Template::display_template(
                 $template_path,
@@ -1462,7 +1462,7 @@ 
         );
         $this->addMetaBox(
             'edit-reg-details-mbox',
-            '<span>' . esc_html__('Registration Details', 'event_espresso')
+            '<span>'.esc_html__('Registration Details', 'event_espresso')
             . '&nbsp;<span class="dashicons dashicons-clipboard"></span></span>',
             [$this, '_reg_details_meta_box'],
             $this->_wp_page_slug
@@ -1556,8 +1556,8 @@ 
 
         $status_changes = $this->_registration->get_extra_meta(EE_Registration::META_KEY_REG_STATUS_CHANGE);
 
-        if (! empty($status_changes)) {
-            $date_format = get_option('date_format', 'Y-m-d') . ' ' . get_option('time_format', 'H:i:s');
+        if ( ! empty($status_changes)) {
+            $date_format = get_option('date_format', 'Y-m-d').' '.get_option('time_format', 'H:i:s');
             $html = EEH_HTML::tr();
             $html .= EEH_HTML::th(
                 EEH_HTML::label(esc_html__('Registration Status Changes', 'event_espresso'))
@@ -1565,7 +1565,7 @@ 
             $html .= EEH_HTML::td();
             $html .= EEH_HTML::ul();
             foreach ($status_changes as $status_change) {
-                $date = new DateTime('@' . $status_change['date']);
+                $date = new DateTime('@'.$status_change['date']);
                 $reason = $status_change['reason'] ?: esc_html__('not specified', 'event_espresso');
                 $html .= EEH_HTML::li(
                     EEH_HTML::strong($date->format($date_format))
@@ -1602,7 +1602,7 @@ 
                 $this->_registration->ID()
             )
         ) {
-            $subsections['reg_status']         = new EE_Select_Input(
+            $subsections['reg_status'] = new EE_Select_Input(
                 $this->_get_reg_statuses(),
                 [
                     'html_label_text' => esc_html__('Change Registration Status to', 'event_espresso'),
@@ -1610,7 +1610,7 @@ 
                     'html_class'      => 'ee-input-width--small',
                 ]
             );
-            $subsections['reason']         = new EE_Text_Input(
+            $subsections['reason'] = new EE_Text_Input(
                 [
                     'html_label_text' => esc_html__('Reason for Registration Status Change', 'event_espresso')
                 ]
@@ -1625,7 +1625,7 @@ 
                     ),
                 ]
             );
-            $subsections['submit']             = new EE_Submit_Input(
+            $subsections['submit'] = new EE_Submit_Input(
                 [
                     'html_class'      => 'button--primary',
                     'html_label_text' => '&nbsp;',
@@ -1658,7 +1658,7 @@ 
     protected function _get_reg_statuses(): array
     {
         $reg_status_array = $this->getRegistrationModel()->reg_status_array();
-        unset($reg_status_array[ RegStatus::INCOMPLETE ]);
+        unset($reg_status_array[RegStatus::INCOMPLETE]);
         // get current reg status
         $current_status = $this->_registration->status_ID();
         // is registration for free event? This will determine whether to display the pending payment option
@@ -1666,7 +1666,7 @@ 
             $current_status !== RegStatus::PENDING_PAYMENT
             && EEH_Money::compare_floats($this->_registration->ticket()->price(), 0.00)
         ) {
-            unset($reg_status_array[ RegStatus::PENDING_PAYMENT ]);
+            unset($reg_status_array[RegStatus::PENDING_PAYMENT]);
         }
         return $this->getStatusModel()->localized_status($reg_status_array, false, 'sentence');
     }
@@ -1931,7 +1931,7 @@ 
             $action,
             $notify
         );
-        $method = $action . '_registration';
+        $method = $action.'_registration';
         if (method_exists($this, $method)) {
             $this->$method($notify);
         }
@@ -2082,7 +2082,7 @@ 
         $filters            = new EE_Line_Item_Filter_Collection();
         $filters->add(new EE_Single_Registration_Line_Item_Filter($this->_registration));
         $filters->add(new EE_Non_Zero_Line_Item_Filter());
-        $line_item_filter_processor              = new EE_Line_Item_Filter_Processor(
+        $line_item_filter_processor = new EE_Line_Item_Filter_Processor(
             $filters,
             $transaction->total_line_item()
         );
@@ -2095,7 +2095,7 @@ 
             $filtered_line_item_tree,
             ['EE_Registration' => $this->_registration]
         );
-        $attendee                                = $this->_registration->attendee();
+        $attendee = $this->_registration->attendee();
         if (
             $this->capabilities->current_user_can(
                 'ee_read_transaction',
@@ -2177,7 +2177,7 @@ 
                 'Payment method response',
                 'event_espresso'
             );
-            $this->_template_args['reg_details']['response_msg']['class']   = 'regular-text';
+            $this->_template_args['reg_details']['response_msg']['class'] = 'regular-text';
         }
         $this->_template_args['reg_details']['registration_session']['value'] = $reg_details['registration_session'];
         $this->_template_args['reg_details']['registration_session']['label'] = esc_html__(
@@ -2208,7 +2208,7 @@ 
         $this->_template_args['REG_ID']   = $this->_registration->ID();
         $this->_template_args['event_id'] = $this->_registration->event_ID();
 
-        $template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_details.template.php';
+        $template_path = REG_TEMPLATE_PATH.'reg_admin_details_main_meta_box_reg_details.template.php';
         EEH_Template::display_template($template_path, $this->_template_args); // already escaped
     }
 
@@ -2248,7 +2248,7 @@ 
             $this->_template_args['reg_questions_form_action'] = 'edit_registration';
             $this->_template_args['REG_ID']                    = $this->_registration->ID();
             $template_path                                     =
-                REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_reg_questions.template.php';
+                REG_TEMPLATE_PATH.'reg_admin_details_main_meta_box_reg_questions.template.php';
             EEH_Template::display_template($template_path, $this->_template_args);
         }
     }
@@ -2264,7 +2264,7 @@ 
     public function form_before_question_group(string $output): string
     {
         EE_Error::doing_it_wrong(
-            __CLASS__ . '::' . __FUNCTION__,
+            __CLASS__.'::'.__FUNCTION__,
             esc_html__(
                 '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.',
                 'event_espresso'
@@ -2288,7 +2288,7 @@ 
     public function form_after_question_group(string $output): string
     {
         EE_Error::doing_it_wrong(
-            __CLASS__ . '::' . __FUNCTION__,
+            __CLASS__.'::'.__FUNCTION__,
             esc_html__(
                 '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.',
                 'event_espresso'
@@ -2325,7 +2325,7 @@ 
     public function form_form_field_label_wrap(string $label): string
     {
         EE_Error::doing_it_wrong(
-            __CLASS__ . '::' . __FUNCTION__,
+            __CLASS__.'::'.__FUNCTION__,
             esc_html__(
                 '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.',
                 'event_espresso'
@@ -2335,7 +2335,7 @@ 
         return '
 			<tr>
 				<th>
-					' . $label . '
+					' . $label.'
 				</th>';
     }
 
@@ -2350,7 +2350,7 @@ 
     public function form_form_field_input__wrap(string $input): string
     {
         EE_Error::doing_it_wrong(
-            __CLASS__ . '::' . __FUNCTION__,
+            __CLASS__.'::'.__FUNCTION__,
             esc_html__(
                 '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.',
                 'event_espresso'
@@ -2359,7 +2359,7 @@ 
         );
         return '
 				<td class="reg-admin-attendee-questions-input-td disabled-input">
-					' . $input . '
+					' . $input.'
 				</td>
 			</tr>';
     }
@@ -2408,8 +2408,8 @@ 
      */
     protected function _get_reg_custom_questions_form(int $REG_ID): EE_Registration_Custom_Questions_Form
     {
-        if (! $this->_reg_custom_questions_form) {
-            require_once(REG_ADMIN . 'form_sections/EE_Registration_Custom_Questions_Form.form.php');
+        if ( ! $this->_reg_custom_questions_form) {
+            require_once(REG_ADMIN.'form_sections/EE_Registration_Custom_Questions_Form.form.php');
             $this->_reg_custom_questions_form = new EE_Registration_Custom_Questions_Form(
                 $this->getRegistrationModel()->get_one_by_ID($REG_ID)
             );
@@ -2432,7 +2432,7 @@ 
      */
     private function _save_reg_custom_questions_form($REG_ID = 0): bool
     {
-        if (! $REG_ID) {
+        if ( ! $REG_ID) {
             EE_Error::add_error(
                 esc_html__(
                     'An error occurred. No registration ID was received.',
@@ -2449,7 +2449,7 @@ 
         if ($form->is_valid()) {
             foreach ($form->subforms() as $question_group_form) {
                 foreach ($question_group_form->inputs() as $question_id => $input) {
-                    $where_conditions    = [
+                    $where_conditions = [
                         'QST_ID' => $question_id,
                         'REG_ID' => $REG_ID,
                     ];
@@ -2490,7 +2490,7 @@ 
         $REG = $this->getRegistrationModel();
         // get all other registrations on this transaction, and cache
         // the attendees for them so we don't have to run another query using force_join
-        $registrations                           = $REG->get_all(
+        $registrations = $REG->get_all(
             [
                 [
                     'TXN_ID' => $this->_registration->transaction_ID(),
@@ -2524,23 +2524,23 @@ 
                 $attendee                                                      = $registration->attendee()
                     ? $registration->attendee()
                     : $this->getAttendeeModel()->create_default_object();
-                $this->_template_args['attendees'][ $att_nmbr ]['STS_ID']      = $registration->status_ID();
-                $this->_template_args['attendees'][ $att_nmbr ]['fname']       = $attendee->fname();
-                $this->_template_args['attendees'][ $att_nmbr ]['lname']       = $attendee->lname();
-                $this->_template_args['attendees'][ $att_nmbr ]['email']       = $attendee->email();
-                $this->_template_args['attendees'][ $att_nmbr ]['final_price'] = $registration->final_price();
-                $this->_template_args['attendees'][ $att_nmbr ]['address']     = implode(
+                $this->_template_args['attendees'][$att_nmbr]['STS_ID']      = $registration->status_ID();
+                $this->_template_args['attendees'][$att_nmbr]['fname']       = $attendee->fname();
+                $this->_template_args['attendees'][$att_nmbr]['lname']       = $attendee->lname();
+                $this->_template_args['attendees'][$att_nmbr]['email']       = $attendee->email();
+                $this->_template_args['attendees'][$att_nmbr]['final_price'] = $registration->final_price();
+                $this->_template_args['attendees'][$att_nmbr]['address']     = implode(
                     ', ',
                     $attendee->full_address_as_array()
                 );
-                $this->_template_args['attendees'][ $att_nmbr ]['att_link']    = self::add_query_args_and_nonce(
+                $this->_template_args['attendees'][$att_nmbr]['att_link'] = self::add_query_args_and_nonce(
                     [
                         'action' => 'edit_attendee',
                         'post'   => $attendee->ID(),
                     ],
                     REG_ADMIN_URL
                 );
-                $this->_template_args['attendees'][ $att_nmbr ]['event_name']  =
+                $this->_template_args['attendees'][$att_nmbr]['event_name'] =
                     $registration->event_obj() instanceof EE_Event
                         ? $registration->event_obj()->name()
                         : '';
@@ -2548,7 +2548,7 @@ 
             }
             $this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
         }
-        $template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_attendees.template.php';
+        $template_path = REG_TEMPLATE_PATH.'reg_admin_details_main_meta_box_attendees.template.php';
         EEH_Template::display_template($template_path, $this->_template_args);
     }
 
@@ -2574,11 +2574,11 @@ 
         // now let's determine if this is not the primary registration.  If it isn't then we set the
         // primary_registration object for reference BUT ONLY if the Attendee object loaded is not the same as the
         // primary registration object (that way we know if we need to show create button or not)
-        if (! $this->_registration->is_primary_registrant()) {
+        if ( ! $this->_registration->is_primary_registrant()) {
             $primary_registration = $this->_registration->get_primary_registration();
             $primary_attendee     = $primary_registration instanceof EE_Registration ? $primary_registration->attendee()
                 : null;
-            if (! $primary_attendee instanceof EE_Attendee || $attendee->ID() !== $primary_attendee->ID()) {
+            if ( ! $primary_attendee instanceof EE_Attendee || $attendee->ID() !== $primary_attendee->ID()) {
                 // in here?  This means the displayed registration is not the primary registrant but ALREADY HAS its own
                 // custom attendee object so let's not worry about the primary reg.
                 $primary_registration = null;
@@ -2593,7 +2593,7 @@ 
         $this->_template_args['phone']             = $attendee->phone();
         $this->_template_args['formatted_address'] = EEH_Address::format($attendee);
         // edit link
-        $this->_template_args['att_edit_link']  = EE_Admin_Page::add_query_args_and_nonce(
+        $this->_template_args['att_edit_link'] = EE_Admin_Page::add_query_args_and_nonce(
             [
                 'action' => 'edit_attendee',
                 'post'   => $attendee->ID(),
@@ -2603,7 +2603,7 @@ 
         $this->_template_args['att_edit_title'] = esc_html__('View details for this contact.', 'event_espresso');
         $this->_template_args['att_edit_label'] = esc_html__('View/Edit Contact', 'event_espresso');
         // create link
-        $this->_template_args['create_link']  = $primary_registration instanceof EE_Registration
+        $this->_template_args['create_link'] = $primary_registration instanceof EE_Registration
             ? EE_Admin_Page::add_query_args_and_nonce(
                 [
                     'action'  => 'duplicate_attendee',
@@ -2614,7 +2614,7 @@ 
         $this->_template_args['create_label'] = esc_html__('Create Contact', 'event_espresso');
         $this->_template_args['att_check']    = $att_check;
         $template_path                        =
-            REG_TEMPLATE_PATH . 'reg_admin_details_side_meta_box_registrant.template.php';
+            REG_TEMPLATE_PATH.'reg_admin_details_side_meta_box_registrant.template.php';
         EEH_Template::display_template($template_path, $this->_template_args);
     }
 
@@ -2663,7 +2663,7 @@ 
             $REG = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
             if ($trash) {
                 $payments = $REG->registration_payments();
-                if (! empty($payments)) {
+                if ( ! empty($payments)) {
                     $name           = $REG->attendee() instanceof EE_Attendee
                         ? $REG->attendee()->full_name()
                         : esc_html__('Unknown Attendee', 'event_espresso');
@@ -2728,17 +2728,17 @@ 
         // Checkboxes
         $REG_IDs = $this->request->getRequestParam('_REG_ID', [], 'int', true);
 
-        if (! empty($REG_IDs)) {
+        if ( ! empty($REG_IDs)) {
             // if array has more than one element than success message should be plural
             $success = count($REG_IDs) > 1 ? 2 : 1;
             // cycle thru checkboxes
             foreach ($REG_IDs as $REG_ID) {
                 $REG = $REG_MDL->get_one_by_ID($REG_ID);
-                if (! $REG instanceof EE_Registration) {
+                if ( ! $REG instanceof EE_Registration) {
                     continue;
                 }
                 $deleted = $this->_delete_registration($REG);
-                if (! $deleted) {
+                if ( ! $deleted) {
                     $success = 0;
                 }
             }
@@ -2778,11 +2778,11 @@ 
         $REGS        = $TXN->get_many_related('Registration');
         $all_trashed = true;
         foreach ($REGS as $registration) {
-            if (! $registration->get('REG_deleted')) {
+            if ( ! $registration->get('REG_deleted')) {
                 $all_trashed = false;
             }
         }
-        if (! $all_trashed) {
+        if ( ! $all_trashed) {
             EE_Error::add_error(
                 esc_html__(
                     '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.',
@@ -2845,7 +2845,7 @@ 
      */
     public function new_registration()
     {
-        if (! $this->_set_reg_event()) {
+        if ( ! $this->_set_reg_event()) {
             throw new EE_Error(
                 esc_html__(
                     'Unable to continue with registering because there is no Event ID in the request',
@@ -2877,7 +2877,7 @@ 
                 ],
                 EVENTS_ADMIN_URL
             );
-            $edit_event_lnk                     = '<a href="'
+            $edit_event_lnk = '<a href="'
                 . $edit_event_url
                 . '" aria-label="'
                 . esc_attr__('Edit ', 'event_espresso')
@@ -2895,7 +2895,7 @@ 
         }
         // grab header
         $template_path                              =
-            REG_TEMPLATE_PATH . 'reg_admin_register_new_attendee.template.php';
+            REG_TEMPLATE_PATH.'reg_admin_register_new_attendee.template.php';
         $this->_template_args['admin_page_content'] = EEH_Template::display_template(
             $template_path,
             $this->_template_args,
@@ -2937,7 +2937,7 @@ 
                 '</b>'
             );
             return '
-	<div id="ee-add-reg-back-button-dv"><p>' . $warning_msg . '</p></div>
+	<div id="ee-add-reg-back-button-dv"><p>' . $warning_msg.'</p></div>
 	<script >
 		// WHOAH !!! it appears that someone is using the back button from the Transaction admin page
 		// after just adding a new registration... we gotta try to put a stop to that !!!
@@ -2979,7 +2979,7 @@ 
                 );
                 $template_args['content']                          =
                     EED_Ticket_Selector::instance()->display_ticket_selector($this->_reg_event);
-                $template_args['content']                          .= '</div>';
+                $template_args['content'] .= '</div>';
                 $template_args['step_button_text']                 = esc_html__(
                     'Add Tickets and Continue to Registrant Details',
                     'event_espresso'
@@ -3006,7 +3006,7 @@ 
         // we come back to the process_registration_step route.
         $this->_set_add_edit_form_tags('process_reg_step', $hidden_fields);
         return EEH_Template::display_template(
-            REG_TEMPLATE_PATH . 'reg_admin_register_new_attendee_step_content.template.php',
+            REG_TEMPLATE_PATH.'reg_admin_register_new_attendee_step_content.template.php',
             $template_args,
             true
         );
@@ -3030,7 +3030,7 @@ 
         }
 
         $EVT_ID = $this->request->getRequestParam('event_id', 0, 'int');
-        if (! $EVT_ID) {
+        if ( ! $EVT_ID) {
             return false;
         }
         $this->_reg_event = $this->getEventModel()->get_one_by_ID($EVT_ID);
@@ -3101,7 +3101,7 @@ 
                 }
                 break;
             case 'questions':
-                if (! $this->request->requestParamIsSet('txn_reg_status_change[send_notifications]')) {
+                if ( ! $this->request->requestParamIsSet('txn_reg_status_change[send_notifications]')) {
                     add_filter('FHEE__EED_Messages___maybe_registration__deliver_notifications', '__return_false', 15);
                 }
                 // process registration
@@ -3112,7 +3112,7 @@ 
                         $grand_total->save_this_and_descendants_to_txn();
                     }
                 }
-                if (! $transaction instanceof EE_Transaction) {
+                if ( ! $transaction instanceof EE_Transaction) {
                     $query_args = [
                         'action'                  => 'new_registration',
                         'processing_registration' => 2,
@@ -3134,7 +3134,7 @@ 
                     return;
                 }
                 // maybe update status, and make sure to save transaction if not done already
-                if (! $transaction->update_status_based_on_total_paid()) {
+                if ( ! $transaction->update_status_based_on_total_paid()) {
                     $transaction->save();
                 }
                 $this->clearSession(__CLASS__, __FUNCTION__);
@@ -3215,7 +3215,7 @@ 
      */
     public function get_attendees(int $per_page, bool $count = false, bool $trash = false)
     {
-        require_once(REG_ADMIN . 'EE_Attendee_Contact_List_Table.class.php');
+        require_once(REG_ADMIN.'EE_Attendee_Contact_List_Table.class.php');
         $orderby = $this->request->getRequestParam('orderby');
         switch ($orderby) {
             case 'ATT_ID':
@@ -3238,7 +3238,7 @@ 
         $_where       = [];
         $search_term  = $this->request->getRequestParam('s');
         if ($search_term) {
-            $search_term  = '%' . $search_term . '%';
+            $search_term  = '%'.$search_term.'%';
             $_where['OR'] = [
                 'Registration.Event.EVT_name'       => ['LIKE', $search_term],
                 'Registration.Event.EVT_desc'       => ['LIKE', $search_term],
@@ -3265,7 +3265,7 @@ 
             'extra_selects' => ['Registration_Count' => ['Registration.REG_ID', 'count', '%d']],
             'limit'         => $limit,
         ];
-        if (! $count) {
+        if ( ! $count) {
             $query_args['order_by'] = [$orderby => $sort];
         }
         $query_args[0]['status'] = $trash ? ['!=', 'publish'] : ['IN', ['publish']];
@@ -3310,7 +3310,7 @@ 
         $EVT_ID = $this->request->requestParamIsSet('EVT_ID')
             ? $this->request->getRequestParam('EVT_ID', 0, DataType::INT)
             : null;
-        if (! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
+        if ( ! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
             $return_url    = $this->request->getRequestParam('return_url', '', DataType::URL);
             $filters       = $this->request->getRequestParam('filters', [], DataType::STRING, true);
             $report_params = $this->$method_name_for_getting_query_params($filters);
@@ -3343,8 +3343,8 @@ 
             ];
             // Merge required request args, overriding any currently set
             $request_args = array_merge($request_args, $required_request_args);
-            if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
-                require_once(EE_CLASSES . 'EE_Export.class.php');
+            if (is_readable(EE_CLASSES.'EE_Export.class.php')) {
+                require_once(EE_CLASSES.'EE_Export.class.php');
                 $EE_Export = EE_Export::instance($request_args);
                 $EE_Export->export();
             }
@@ -3363,9 +3363,9 @@ 
     {
         foreach ($query_params as $key => $value) {
             if (is_array($value)) {
-                $query_params[ $key ] = $this->convertDatetimeObjectsToStrings($value);
+                $query_params[$key] = $this->convertDatetimeObjectsToStrings($value);
             } elseif ($value instanceof DateTime) {
-                $query_params[ $key ] = $value->format('Y-m-d H:i:s');
+                $query_params[$key] = $value->format('Y-m-d H:i:s');
             }
         }
         return $query_params;
@@ -3388,8 +3388,8 @@ 
      */
     public function _contact_list_export()
     {
-        if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
-            require_once(EE_CLASSES . 'EE_Export.class.php');
+        if (is_readable(EE_CLASSES.'EE_Export.class.php')) {
+            require_once(EE_CLASSES.'EE_Export.class.php');
             $EE_Export = EE_Export::instance($this->request->requestParams());
             $EE_Export->export_attendees();
         }
@@ -3398,7 +3398,7 @@ 
 
     public function _contact_list_report()
     {
-        if (! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
+        if ( ! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
             wp_redirect(
                 EE_Admin_Page::add_query_args_and_nonce(
                     [
@@ -3410,8 +3410,8 @@ 
                 )
             );
         } else {
-            if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
-                require_once(EE_CLASSES . 'EE_Export.class.php');
+            if (is_readable(EE_CLASSES.'EE_Export.class.php')) {
+                require_once(EE_CLASSES.'EE_Export.class.php');
                 $EE_Export = EE_Export::instance($this->request->requestParams());
                 $EE_Export->report_attendees();
             }
@@ -3438,7 +3438,7 @@ 
         $REG_ID = $this->request->getRequestParam('_REG_ID', 0, 'int');
         $action = $this->request->getRequestParam('return', 'default');
         // verify we have necessary info
-        if (! $REG_ID) {
+        if ( ! $REG_ID) {
             EE_Error::add_error(
                 esc_html__(
                     'Unable to create the contact for the registration because the required parameters are not present (_REG_ID )',
@@ -3453,7 +3453,7 @@ 
         }
         // okay necessary deets present... let's dupe the incoming attendee and attach to incoming registration.
         $registration = $this->getRegistrationModel()->get_one_by_ID($REG_ID);
-        if (! $registration instanceof EE_Registration) {
+        if ( ! $registration instanceof EE_Registration) {
             throw new RuntimeException(
                 sprintf(
                     esc_html__(
@@ -3592,16 +3592,16 @@ 
         $this->verify_cpt_object();
         remove_meta_box(
             'postexcerpt',
-            $this->_cpt_routes[ $this->_req_action ],
+            $this->_cpt_routes[$this->_req_action],
             'normal'
         );
-        remove_meta_box('commentstatusdiv', $this->_cpt_routes[ $this->_req_action ], 'normal');
+        remove_meta_box('commentstatusdiv', $this->_cpt_routes[$this->_req_action], 'normal');
         if (post_type_supports(EspressoPostType::ATTENDEES, 'excerpt')) {
             $this->addMetaBox(
                 'postexcerpt',
                 esc_html__('Short Biography', 'event_espresso'),
                 'post_excerpt_meta_box',
-                $this->_cpt_routes[ $this->_req_action ]
+                $this->_cpt_routes[$this->_req_action]
             );
         }
         if (post_type_supports(EspressoPostType::ATTENDEES, 'comments')) {
@@ -3609,7 +3609,7 @@ 
                 'commentsdiv',
                 esc_html__('Notes on the Contact', 'event_espresso'),
                 'post_comment_meta_box',
-                $this->_cpt_routes[ $this->_req_action ],
+                $this->_cpt_routes[$this->_req_action],
                 'normal',
                 'core'
             );
@@ -3618,7 +3618,7 @@ 
             'attendee_contact_info',
             esc_html__('Contact Info', 'event_espresso'),
             [$this, 'attendee_contact_info'],
-            $this->_cpt_routes[ $this->_req_action ],
+            $this->_cpt_routes[$this->_req_action],
             'side',
             'core'
         );
@@ -3626,7 +3626,7 @@ 
             'attendee_details_address',
             esc_html__('Address Details', 'event_espresso'),
             [$this, 'attendee_address_details'],
-            $this->_cpt_routes[ $this->_req_action ],
+            $this->_cpt_routes[$this->_req_action],
             'normal',
             'core'
         );
@@ -3634,7 +3634,7 @@ 
             'attendee_registrations',
             esc_html__('Registrations for this Contact', 'event_espresso'),
             [$this, 'attendee_registrations_meta_box'],
-            $this->_cpt_routes[ $this->_req_action ]
+            $this->_cpt_routes[$this->_req_action]
         );
     }
 
@@ -3733,8 +3733,8 @@ 
                 ]
             )
         );
-        $template                             =
-            REG_TEMPLATE_PATH . 'attendee_address_details_metabox_content.template.php';
+        $template =
+            REG_TEMPLATE_PATH.'attendee_address_details_metabox_content.template.php';
         EEH_Template::display_template($template, $this->_template_args);
     }
 
@@ -3754,7 +3754,7 @@ 
         $this->_template_args['attendee']      = $this->_cpt_model_obj;
         $this->_template_args['registrations'] = $this->_cpt_model_obj->get_many_related('Registration');
         $template                              =
-            REG_TEMPLATE_PATH . 'attendee_registrations_main_meta_box.template.php';
+            REG_TEMPLATE_PATH.'attendee_registrations_main_meta_box.template.php';
         EEH_Template::display_template($template, $this->_template_args);
     }
 
@@ -3769,7 +3769,7 @@ 
     public function after_title_form_fields(WP_Post $post)
     {
         if ($post->post_type === EspressoPostType::ATTENDEES) {
-            $template                  = REG_TEMPLATE_PATH . 'attendee_details_after_title_form_fields.template.php';
+            $template                  = REG_TEMPLATE_PATH.'attendee_details_after_title_form_fields.template.php';
             $template_args['attendee'] = $this->_cpt_model_obj;
             EEH_Template::display_template($template, $template_args);
         }
@@ -3798,7 +3798,7 @@ 
             // cycle thru checkboxes
             foreach ($ATT_IDs as $ATT_ID) {
                 $updated = $this->getAttendeeModel()->update_by_ID(['status' => $status], $ATT_ID);
-                if (! $updated) {
+                if ( ! $updated) {
                     $success = 0;
                 }
             }

admin_pages/registrations/form_sections/EE_Registration_Custom_Questions_Form.form.php

Indentation +164 added lines, -164 removed lines

@@ -20,179 +20,179 @@
  */
 class EE_Registration_Custom_Questions_Form extends EE_Form_Section_Proper
 {
-    /**
-     *
-     * @var EE_Registration
-     */
-    protected $_registration = null;
+	/**
+	 *
+	 * @var EE_Registration
+	 */
+	protected $_registration = null;
 
 
-    /**
-     *
-     * @param EE_Registration $reg
-     * @param array           $options
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function __construct(EE_Registration $reg, $options = array())
-    {
-        $this->_registration = $reg;
-        if (! isset($options['layout_strategy'])) {
-            $options['layout_strategy'] = new EE_Admin_Two_Column_Layout();
-        }
-        if (! isset($options['html_id'])) {
-            $options['html_id'] = 'reg-admin-attendee-questions-frm';
-        }
-        $this->build_form_from_registration();
-        parent::__construct($options);
-    }
+	/**
+	 *
+	 * @param EE_Registration $reg
+	 * @param array           $options
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function __construct(EE_Registration $reg, $options = array())
+	{
+		$this->_registration = $reg;
+		if (! isset($options['layout_strategy'])) {
+			$options['layout_strategy'] = new EE_Admin_Two_Column_Layout();
+		}
+		if (! isset($options['html_id'])) {
+			$options['html_id'] = 'reg-admin-attendee-questions-frm';
+		}
+		$this->build_form_from_registration();
+		parent::__construct($options);
+	}
 
 
-    /**
-     * Gets the registration object this form is about
-     * @return EE_Registration
-     */
-    public function get_registration()
-    {
-        return $this->_registration;
-    }
+	/**
+	 * Gets the registration object this form is about
+	 * @return EE_Registration
+	 */
+	public function get_registration()
+	{
+		return $this->_registration;
+	}
 
-    /**
-     * @since 4.10.0.p
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws ReflectionException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     */
-    public function build_form_from_registration()
-    {
-        $reg = $this->get_registration();
-        if (! $reg instanceof EE_Registration) {
-            throw new EE_Error(esc_html__('We cannot build the registration custom questions form because there is no registration set on it yet', 'event_espresso'));
-        }
-        // we want to get all their question groups
-        $question_groups = EEM_Question_Group::instance()->get_all(
-            [
-                [
-                    'Event_Question_Group.EVT_ID' => $reg->event_ID(),
-                    'OR' => [
-                        'Question.QST_system*blank' =>  '',
-                        'Question.QST_system*null' => ['IS_NULL']
-                    ],
-                    'Event_Question_Group.'
-                    . EEM_Event_Question_Group::instance()->fieldNameForContext(
-                        $reg->is_primary_registrant()
-                    ) => true
-                ],
-                'order_by' => ['QSG_order' => 'ASC']
-            ]
-        );
-        // get each question groups questions
-        foreach ($question_groups as $question_group) {
-            if ($question_group instanceof EE_Question_Group) {
-                $this->_subsections[ $question_group->ID() ] = $this->build_subform_from_question_group(
-                    $question_group,
-                    $reg
-                );
-            }
-        }
-    }
+	/**
+	 * @since 4.10.0.p
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws ReflectionException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 */
+	public function build_form_from_registration()
+	{
+		$reg = $this->get_registration();
+		if (! $reg instanceof EE_Registration) {
+			throw new EE_Error(esc_html__('We cannot build the registration custom questions form because there is no registration set on it yet', 'event_espresso'));
+		}
+		// we want to get all their question groups
+		$question_groups = EEM_Question_Group::instance()->get_all(
+			[
+				[
+					'Event_Question_Group.EVT_ID' => $reg->event_ID(),
+					'OR' => [
+						'Question.QST_system*blank' =>  '',
+						'Question.QST_system*null' => ['IS_NULL']
+					],
+					'Event_Question_Group.'
+					. EEM_Event_Question_Group::instance()->fieldNameForContext(
+						$reg->is_primary_registrant()
+					) => true
+				],
+				'order_by' => ['QSG_order' => 'ASC']
+			]
+		);
+		// get each question groups questions
+		foreach ($question_groups as $question_group) {
+			if ($question_group instanceof EE_Question_Group) {
+				$this->_subsections[ $question_group->ID() ] = $this->build_subform_from_question_group(
+					$question_group,
+					$reg
+				);
+			}
+		}
+	}
 
 
-    /**
-     *
-     * @param EE_Question_Group $question_group
-     * @param EE_Registration   $registration
-     * @return EE_Form_Section_Proper
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function build_subform_from_question_group($question_group, $registration)
-    {
-        if (
-            ! $question_group instanceof EE_Question_Group ||
-            ! $registration instanceof EE_Registration
-        ) {
-            throw new EE_Error(esc_html__('A valid question group and registration must be passed to EE_Registration_Custom_Question_Form', 'event_espresso'));
-        }
-        $parts_of_subsection = array(
-            'title' => new EE_Form_Section_HTML(
-                EEH_HTML::h5(
-                    $question_group->name(),
-                    $question_group->identifier(),
-                    'espresso-question-group-title-h5 section-title'
-                )
-            )
-        );
-        $questions = $question_group->questions(
-            array(
-                array(
-                    'OR' => array(
-                        'QST_system*blank' => '',
-                        'QST_system*null' => array( 'IS_NULL' )
-                    )
-                )
-            )
-        );
-        foreach ($questions as $question) {
-            $parts_of_subsection[ $question->ID() ] = $question->generate_form_input($registration);
-        }
-        return new EE_Form_Section_Proper(
-            array(
-                'subsections' => $parts_of_subsection,
-                'html_class' => 'question-group-questions',
-            )
-        );
-    }
+	/**
+	 *
+	 * @param EE_Question_Group $question_group
+	 * @param EE_Registration   $registration
+	 * @return EE_Form_Section_Proper
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function build_subform_from_question_group($question_group, $registration)
+	{
+		if (
+			! $question_group instanceof EE_Question_Group ||
+			! $registration instanceof EE_Registration
+		) {
+			throw new EE_Error(esc_html__('A valid question group and registration must be passed to EE_Registration_Custom_Question_Form', 'event_espresso'));
+		}
+		$parts_of_subsection = array(
+			'title' => new EE_Form_Section_HTML(
+				EEH_HTML::h5(
+					$question_group->name(),
+					$question_group->identifier(),
+					'espresso-question-group-title-h5 section-title'
+				)
+			)
+		);
+		$questions = $question_group->questions(
+			array(
+				array(
+					'OR' => array(
+						'QST_system*blank' => '',
+						'QST_system*null' => array( 'IS_NULL' )
+					)
+				)
+			)
+		);
+		foreach ($questions as $question) {
+			$parts_of_subsection[ $question->ID() ] = $question->generate_form_input($registration);
+		}
+		return new EE_Form_Section_Proper(
+			array(
+				'subsections' => $parts_of_subsection,
+				'html_class' => 'question-group-questions',
+			)
+		);
+	}
 
 
-    /**
-     * Overrides parent so if inputs were disabled, we leave those with their defaults
-     * from the answers in the DB
-     *
-     * @param array $req_data like $_POST
-     * @return void
-     * @throws EE_Error
-     */
-    protected function _normalize($req_data)
-    {
-        $this->_received_submission = true;
-        $this->_validation_errors = array();
-        foreach ($this->get_validatable_subsections() as $subsection) {
-            if ($subsection->form_data_present_in($req_data)) {
-                try {
-                    $subsection->_normalize($req_data);
-                } catch (EE_Validation_Error $e) {
-                    $subsection->add_validation_error($e);
-                }
-            }
-        }
-    }
+	/**
+	 * Overrides parent so if inputs were disabled, we leave those with their defaults
+	 * from the answers in the DB
+	 *
+	 * @param array $req_data like $_POST
+	 * @return void
+	 * @throws EE_Error
+	 */
+	protected function _normalize($req_data)
+	{
+		$this->_received_submission = true;
+		$this->_validation_errors = array();
+		foreach ($this->get_validatable_subsections() as $subsection) {
+			if ($subsection->form_data_present_in($req_data)) {
+				try {
+					$subsection->_normalize($req_data);
+				} catch (EE_Validation_Error $e) {
+					$subsection->add_validation_error($e);
+				}
+			}
+		}
+	}
 
 
-    /**
-     * Performs validation on this form section and its subsections. For each subsection,
-     * calls _validate_{subsection_name} on THIS form (if the function exists) and passes it the subsection, then calls
-     * _validate on that subsection. If you need to perform validation on the form as a whole (considering multiple)
-     * you would be best to override this _validate method, calling parent::_validate() first.
-     *
-     * @throws EE_Error
-     */
-    protected function _validate()
-    {
-        /** @var RequestInterface $request */
-        $request = LoaderFactory::getLoader()->getShared(RequestInterface::class);
-        $form_data = $request->requestParams();
-        foreach ($this->get_validatable_subsections() as $subsection_name => $subsection) {
-            if ($subsection->form_data_present_in($form_data)) {
-                if (method_exists($this, '_validate_' . $subsection_name)) {
-                    call_user_func_array(array($this,'_validate_' . $subsection_name), array($subsection));
-                }
-                $subsection->_validate();
-            } elseif ($subsection instanceof EE_Form_Section_Proper) {
-                $subsection->_received_submission = true;
-            }
-        }
-    }
+	/**
+	 * Performs validation on this form section and its subsections. For each subsection,
+	 * calls _validate_{subsection_name} on THIS form (if the function exists) and passes it the subsection, then calls
+	 * _validate on that subsection. If you need to perform validation on the form as a whole (considering multiple)
+	 * you would be best to override this _validate method, calling parent::_validate() first.
+	 *
+	 * @throws EE_Error
+	 */
+	protected function _validate()
+	{
+		/** @var RequestInterface $request */
+		$request = LoaderFactory::getLoader()->getShared(RequestInterface::class);
+		$form_data = $request->requestParams();
+		foreach ($this->get_validatable_subsections() as $subsection_name => $subsection) {
+			if ($subsection->form_data_present_in($form_data)) {
+				if (method_exists($this, '_validate_' . $subsection_name)) {
+					call_user_func_array(array($this,'_validate_' . $subsection_name), array($subsection));
+				}
+				$subsection->_validate();
+			} elseif ($subsection instanceof EE_Form_Section_Proper) {
+				$subsection->_received_submission = true;
+			}
+		}
+	}
 }

Spacing +8 added lines, -8 removed lines

@@ -37,10 +37,10 @@ 
     public function __construct(EE_Registration $reg, $options = array())
     {
         $this->_registration = $reg;
-        if (! isset($options['layout_strategy'])) {
+        if ( ! isset($options['layout_strategy'])) {
             $options['layout_strategy'] = new EE_Admin_Two_Column_Layout();
         }
-        if (! isset($options['html_id'])) {
+        if ( ! isset($options['html_id'])) {
             $options['html_id'] = 'reg-admin-attendee-questions-frm';
         }
         $this->build_form_from_registration();
@@ -68,7 +68,7 @@ 
     public function build_form_from_registration()
     {
         $reg = $this->get_registration();
-        if (! $reg instanceof EE_Registration) {
+        if ( ! $reg instanceof EE_Registration) {
             throw new EE_Error(esc_html__('We cannot build the registration custom questions form because there is no registration set on it yet', 'event_espresso'));
         }
         // we want to get all their question groups
@@ -91,7 +91,7 @@ 
         // get each question groups questions
         foreach ($question_groups as $question_group) {
             if ($question_group instanceof EE_Question_Group) {
-                $this->_subsections[ $question_group->ID() ] = $this->build_subform_from_question_group(
+                $this->_subsections[$question_group->ID()] = $this->build_subform_from_question_group(
                     $question_group,
                     $reg
                 );
@@ -130,13 +130,13 @@ 
                 array(
                     'OR' => array(
                         'QST_system*blank' => '',
-                        'QST_system*null' => array( 'IS_NULL' )
+                        'QST_system*null' => array('IS_NULL')
                     )
                 )
             )
         );
         foreach ($questions as $question) {
-            $parts_of_subsection[ $question->ID() ] = $question->generate_form_input($registration);
+            $parts_of_subsection[$question->ID()] = $question->generate_form_input($registration);
         }
         return new EE_Form_Section_Proper(
             array(
@@ -186,8 +186,8 @@ 
         $form_data = $request->requestParams();
         foreach ($this->get_validatable_subsections() as $subsection_name => $subsection) {
             if ($subsection->form_data_present_in($form_data)) {
-                if (method_exists($this, '_validate_' . $subsection_name)) {
-                    call_user_func_array(array($this,'_validate_' . $subsection_name), array($subsection));
+                if (method_exists($this, '_validate_'.$subsection_name)) {
+                    call_user_func_array(array($this, '_validate_'.$subsection_name), array($subsection));
                 }
                 $subsection->_validate();
             } elseif ($subsection instanceof EE_Form_Section_Proper) {

admin_pages/about/About_Admin_Page.core.php

Indentation +285 added lines, -285 removed lines

@@ -17,140 +17,140 @@ 
  */
 class About_Admin_Page extends EE_Admin_Page
 {
-    protected function _init_page_props()
-    {
-        $this->page_slug = EE_ABOUT_PG_SLUG;
-        $this->page_label = esc_html__('About Event Espresso', 'event_espresso');
-        $this->_admin_base_url = EE_ABOUT_ADMIN_URL;
-        $this->_admin_base_path = EE_ABOUT_ADMIN;
-    }
-
-
-    protected function _ajax_hooks()
-    {
-        // todo: all hooks for ajax goes here.
-    }
-
-
-    protected function _define_page_props()
-    {
-        $this->_labels = array();
-        $this->_admin_page_title = $this->page_label;
-    }
-
-
-    protected function _set_page_routes()
-    {
-        $this->_page_routes = array(
-            'default' => array(
-                'func'       => [$this, '_overview'],
-                'capability' => 'manage_options',
-            ),
-            // 'overview' => '_overview',
-            // 'func'       => [$this, '_overview'],
-            // 'capability' => 'ee_read_ee'
-            // ),
-            'credits' => array(
-                'func'       => [$this, '_credits'],
-                'capability' => 'manage_options',
-            ),
-
-            'decafvpro' => array(
-                'func'       => [$this, '_decafvpro'],
-                'capability' => 'manage_options',
-            ),
-            'reviews'   => array(
-                'func'       => [$this, '_reviews'],
-                'capability' => 'manage_options',
-            ),
-        );
-    }
-
-
-    protected function _set_page_config()
-    {
-        $this->_page_config = array(
-            /*'default' => array(
+	protected function _init_page_props()
+	{
+		$this->page_slug = EE_ABOUT_PG_SLUG;
+		$this->page_label = esc_html__('About Event Espresso', 'event_espresso');
+		$this->_admin_base_url = EE_ABOUT_ADMIN_URL;
+		$this->_admin_base_path = EE_ABOUT_ADMIN;
+	}
+
+
+	protected function _ajax_hooks()
+	{
+		// todo: all hooks for ajax goes here.
+	}
+
+
+	protected function _define_page_props()
+	{
+		$this->_labels = array();
+		$this->_admin_page_title = $this->page_label;
+	}
+
+
+	protected function _set_page_routes()
+	{
+		$this->_page_routes = array(
+			'default' => array(
+				'func'       => [$this, '_overview'],
+				'capability' => 'manage_options',
+			),
+			// 'overview' => '_overview',
+			// 'func'       => [$this, '_overview'],
+			// 'capability' => 'ee_read_ee'
+			// ),
+			'credits' => array(
+				'func'       => [$this, '_credits'],
+				'capability' => 'manage_options',
+			),
+
+			'decafvpro' => array(
+				'func'       => [$this, '_decafvpro'],
+				'capability' => 'manage_options',
+			),
+			'reviews'   => array(
+				'func'       => [$this, '_reviews'],
+				'capability' => 'manage_options',
+			),
+		);
+	}
+
+
+	protected function _set_page_config()
+	{
+		$this->_page_config = array(
+			/*'default' => array(
                 'nav' => array(
                     'label' => esc_html__('What\'s New', 'event_espresso'),
                     'order' => 10),
                 'require_nonce' => FALSE
                 ),*/
-            // 'overview' => array(
-            'default' => array(
-                'nav'           => array(
-                    'label' => esc_html__('About', 'event_espresso'),
-                    'icon' => 'dashicons-welcome-learn-more',
-                    'order' => 20,
-                ),
-                'require_nonce' => false,
-            ),
-            'credits' => array(
-                'nav'           => array(
-                    'label' => esc_html__('Credits', 'event_espresso'),
-                    'icon' => 'dashicons-thumbs-up',
-                    'order' => 30,
-                ),
-                'require_nonce' => false,
-            ),
-
-            'decafvpro' => array(
-                'nav'           => array(
-                    'label' => esc_html__('Decaf vs Regular', 'event_espresso'),
-                    'icon' => 'dashicons-editor-code',
-                    'order' => 40,
-                ),
-                'require_nonce' => false,
-            ),
-            'reviews'   => array(
-                'nav'           => array(
-                    'label' => esc_html__('Reviews', 'event_espresso'),
-                    'icon' => 'dashicons-star-filled',
-                    'order' => 50,
-                ),
-                'require_nonce' => false,
-            ),
-        );
-    }
-
-
-    // none of the below group are currently used for Support pages
-    protected function _add_screen_options()
-    {
-    }
-
-    protected function _add_feature_pointers()
-    {
-    }
-
-    public function admin_init()
-    {
-    }
-
-    public function admin_notices()
-    {
-    }
-
-    public function admin_footer_scripts()
-    {
-    }
-
-    public function load_scripts_styles()
-    {
-        // enqueue style
-        wp_register_style(
-            'espresso_about_admin',
-            EE_ABOUT_ASSETS_URL . 'espresso_about_admin.css',
-            [],
-            EVENT_ESPRESSO_VERSION
-        );
-        wp_enqueue_style('espresso_about_admin');
-    }
-
-
-    protected function _whats_new()
-    {
-        /*$steps = EE_Maintenance_Mode::instance()->level() != EE_Maintenance_Mode::STATUS_FULL_SITE ? $this->_get_started_steps() : FALSE;
+			// 'overview' => array(
+			'default' => array(
+				'nav'           => array(
+					'label' => esc_html__('About', 'event_espresso'),
+					'icon' => 'dashicons-welcome-learn-more',
+					'order' => 20,
+				),
+				'require_nonce' => false,
+			),
+			'credits' => array(
+				'nav'           => array(
+					'label' => esc_html__('Credits', 'event_espresso'),
+					'icon' => 'dashicons-thumbs-up',
+					'order' => 30,
+				),
+				'require_nonce' => false,
+			),
+
+			'decafvpro' => array(
+				'nav'           => array(
+					'label' => esc_html__('Decaf vs Regular', 'event_espresso'),
+					'icon' => 'dashicons-editor-code',
+					'order' => 40,
+				),
+				'require_nonce' => false,
+			),
+			'reviews'   => array(
+				'nav'           => array(
+					'label' => esc_html__('Reviews', 'event_espresso'),
+					'icon' => 'dashicons-star-filled',
+					'order' => 50,
+				),
+				'require_nonce' => false,
+			),
+		);
+	}
+
+
+	// none of the below group are currently used for Support pages
+	protected function _add_screen_options()
+	{
+	}
+
+	protected function _add_feature_pointers()
+	{
+	}
+
+	public function admin_init()
+	{
+	}
+
+	public function admin_notices()
+	{
+	}
+
+	public function admin_footer_scripts()
+	{
+	}
+
+	public function load_scripts_styles()
+	{
+		// enqueue style
+		wp_register_style(
+			'espresso_about_admin',
+			EE_ABOUT_ASSETS_URL . 'espresso_about_admin.css',
+			[],
+			EVENT_ESPRESSO_VERSION
+		);
+		wp_enqueue_style('espresso_about_admin');
+	}
+
+
+	protected function _whats_new()
+	{
+		/*$steps = EE_Maintenance_Mode::instance()->level() != EE_Maintenance_Mode::STATUS_FULL_SITE ? $this->_get_started_steps() : FALSE;
         $steps = $steps !== FALSE ? $steps : '';
         $this->_admin_page_title = sprintf( esc_html__('Welcome to Event Espresso %s', 'event_espresso'), EVENT_ESPRESSO_VERSION );
         $settings_message = $steps;
@@ -158,167 +158,167 @@ 
         $template = EE_ABOUT_TEMPLATE_PATH . 'whats_new.template.php';
         $this->_template_args['about_admin_page_content'] = EEH_Template::display_template( $template, $this->_template_args, TRUE );
         $this->display_about_admin_page();*/
-    }
+	}
 
 
-    protected function _overview()
-    {
-        /*$this->_template_args['admin_page_title'] = esc_html__('About Event Espresso', 'event_espresso');
+	protected function _overview()
+	{
+		/*$this->_template_args['admin_page_title'] = esc_html__('About Event Espresso', 'event_espresso');
         $this->_template_args['admin_page_subtitle'] = esc_html__('Thank you for choosing Event Espresso Decaf, the most powerful, and free, Event Management plugin for WordPress.', 'event_espresso');
         $template = EE_ABOUT_TEMPLATE_PATH . 'ee4-overview.template.php';
         $this->_template_args['about_admin_page_content'] = EEH_Template::display_template( $template, $this->_template_args, TRUE );
         $this->display_about_admin_page();*/
 
-        // Copied from _whats_new()
-        $steps = DbStatus::isOnline() ? $this->_get_started_steps() : false;
-        $steps = $steps !== false ? $steps : '';
-        $this->_admin_page_title = sprintf(
-            esc_html__('Welcome to Event Espresso %s', 'event_espresso'),
-            EVENT_ESPRESSO_VERSION
-        );
-        $settings_message = $steps;
-        $this->_template_args['admin_page_subtitle'] = esc_html__(
-            'Thank you for choosing Event Espresso, the most powerful, and free, Event Management plugin for WordPress.',
-            'event_espresso'
-        ) . $settings_message;
-        $template = EE_ABOUT_TEMPLATE_PATH . 'ee4-overview.template.php';
-        $this->_template_args['about_admin_page_content'] = EEH_Template::display_template(
-            $template,
-            $this->_template_args,
-            true
-        );
-        $this->display_about_admin_page();
-    }
-
-
-    protected function _get_started_steps()
-    {
-        $steps = '<h2>' . esc_html__('Getting Started', 'event_espresso') . '</h2>';
-        $step_one = '<p>'
-                    . sprintf(
-                        esc_html__(
-                            '%sStep 1%s: Visit your %sOrganization Settings%s and add/update your details.',
-                            'event_espresso'
-                        ),
-                        '<strong>',
-                        '</strong>',
-                        '<a href="admin.php?page=espresso_general_settings">',
-                        '</a>'
-                    ) . '</strong></p>';
-        $step_two = '<p>'
-                    . sprintf(
-                        esc_html__('%sStep 2%s: Setup your %sPayment Methods%s.', 'event_espresso'),
-                        '<strong>',
-                        '</strong>',
-                        '<a href="admin.php?page=espresso_payment_settings">',
-                        '</a>'
-                    ) . '</strong></p>';
-        $step_three = '<p>'
-                      . sprintf(
-                          esc_html__('%sStep 3%s: Create your %sFirst Event%s.', 'event_espresso'),
-                          '<strong>',
-                          '</strong>',
-                          '<a href="admin.php?page=espresso_events&action=create_new">',
-                          '</a>'
-                      ) . '</strong></p>';
-
-        // done?
-        $done_step_one = EE_Registry::instance()->CFG->organization->address_1 == '123 Onna Road' ? false : true;
-        $active_invoice_pm = EEM_Payment_Method::instance()->get_one_active(
-            EEM_Payment_Method::scope_cart,
-            array(array('PMD_type' => 'Invoice'))
-        );
-        $active_pms_count = EEM_Payment_Method::instance()->count_active(EEM_Payment_Method::scope_cart);
-        // done step two if a non-invoice paymetn method is active; or there is more than one PM active, or
-        // if only the invoice is active but it's clearly been updated
-        $done_step_two = $active_pms_count > 1 ||
-                         ($active_pms_count === 1 && ! $active_invoice_pm) ||
-                         ($active_invoice_pm instanceof EE_Payment_Method && (
-                                 $active_invoice_pm->get_extra_meta('pdf_payee_name', true, '') ||
-                                 $active_invoice_pm->get_extra_meta('pdf_payee_email', true, '') ||
-                                 $active_invoice_pm->get_extra_meta('pdf_payee_tax_number', true, '') ||
-                                 $active_invoice_pm->get_extra_meta('pdf_payee_address', true, '') ||
-                                 $active_invoice_pm->get_extra_meta('page_extra_info', true, '')
-                             )
-                         );
-        $done_step_three = EE_Registry::instance()->load_model('Event')->count() > 0 ? true : false;
-
-        // if ALL steps are done, let's just return FALSE so we don't display anything
-        if ($done_step_one && $done_step_two && $done_step_three) {
-            return false;
-        }
-
-        // now let's put it together
-        $steps .= sprintf('%s' . $step_one . '%s', $done_step_one ? '<strike>' : '', $done_step_one ? '</strike>' : '');
-        $steps .= sprintf('%s' . $step_two . '%s', $done_step_two ? '<strike>' : '', $done_step_two ? '</strike>' : '');
-        $steps .= sprintf(
-            '%s' . $step_three . '%s',
-            $done_step_three ? '<strike>' : '',
-            $done_step_three ? '</strike>' : ''
-        );
-
-        return $steps;
-    }
-
-
-    protected function _credits()
-    {
-        $this->_template_args['admin_page_title'] = sprintf(
-            esc_html__('Welcome to Event Espresso %s', 'event_espresso'),
-            EVENT_ESPRESSO_VERSION
-        );
-        $this->_template_args['admin_page_subtitle'] = esc_html__(
-            'Thank you for choosing Event Espresso Decaf, the most powerful, and free, Event Management plugin for WordPress.',
-            'event_espresso'
-        );
-        $template = EE_ABOUT_TEMPLATE_PATH . 'credits.template.php';
-        $this->_template_args['about_admin_page_content'] = EEH_Template::display_template(
-            $template,
-            $this->_template_args,
-            true
-        );
-        $this->display_about_admin_page();
-    }
-
-
-    protected function _decafvpro()
-    {
-        $this->_template_args['admin_page_title'] = sprintf(
-            esc_html__('Welcome to Event Espresso %s', 'event_espresso'),
-            EVENT_ESPRESSO_VERSION
-        );
-        $this->_template_args['admin_page_subtitle'] = sprintf(
-            esc_html__(
-                'Event Espresso lets you focus on doing %swhat you love%s — %sorganizing your events%s',
-                'event_espresso'
-            ),
-            '<em>',
-            '</em>',
-            '<strong>',
-            '</strong>'
-        );
-        $template = EE_ABOUT_TEMPLATE_PATH . 'decafvpro.template.php';
-        $this->_template_args['about_admin_page_content'] = EEH_Template::display_template(
-            $template,
-            $this->_template_args,
-            true
-        );
-        $this->display_about_admin_page();
-    }
-
-    protected function _reviews()
-    {
-        $this->_template_args['admin_page_title'] = esc_html__('Rave Reviews About Event Espresso 4', 'event_espresso');
-        $this->_template_args['admin_page_subtitle'] = esc_html__(
-            'At Event Espresso, customer satisfaction is our ultimate goal.',
-            'event_espresso'
-        );
-        $template = EE_ABOUT_TEMPLATE_PATH . 'reviews.template.php';
-        $this->_template_args['about_admin_page_content'] = EEH_Template::display_template(
-            $template,
-            $this->_template_args,
-            true
-        );
-        $this->display_about_admin_page();
-    }
+		// Copied from _whats_new()
+		$steps = DbStatus::isOnline() ? $this->_get_started_steps() : false;
+		$steps = $steps !== false ? $steps : '';
+		$this->_admin_page_title = sprintf(
+			esc_html__('Welcome to Event Espresso %s', 'event_espresso'),
+			EVENT_ESPRESSO_VERSION
+		);
+		$settings_message = $steps;
+		$this->_template_args['admin_page_subtitle'] = esc_html__(
+			'Thank you for choosing Event Espresso, the most powerful, and free, Event Management plugin for WordPress.',
+			'event_espresso'
+		) . $settings_message;
+		$template = EE_ABOUT_TEMPLATE_PATH . 'ee4-overview.template.php';
+		$this->_template_args['about_admin_page_content'] = EEH_Template::display_template(
+			$template,
+			$this->_template_args,
+			true
+		);
+		$this->display_about_admin_page();
+	}
+
+
+	protected function _get_started_steps()
+	{
+		$steps = '<h2>' . esc_html__('Getting Started', 'event_espresso') . '</h2>';
+		$step_one = '<p>'
+					. sprintf(
+						esc_html__(
+							'%sStep 1%s: Visit your %sOrganization Settings%s and add/update your details.',
+							'event_espresso'
+						),
+						'<strong>',
+						'</strong>',
+						'<a href="admin.php?page=espresso_general_settings">',
+						'</a>'
+					) . '</strong></p>';
+		$step_two = '<p>'
+					. sprintf(
+						esc_html__('%sStep 2%s: Setup your %sPayment Methods%s.', 'event_espresso'),
+						'<strong>',
+						'</strong>',
+						'<a href="admin.php?page=espresso_payment_settings">',
+						'</a>'
+					) . '</strong></p>';
+		$step_three = '<p>'
+					  . sprintf(
+						  esc_html__('%sStep 3%s: Create your %sFirst Event%s.', 'event_espresso'),
+						  '<strong>',
+						  '</strong>',
+						  '<a href="admin.php?page=espresso_events&action=create_new">',
+						  '</a>'
+					  ) . '</strong></p>';
+
+		// done?
+		$done_step_one = EE_Registry::instance()->CFG->organization->address_1 == '123 Onna Road' ? false : true;
+		$active_invoice_pm = EEM_Payment_Method::instance()->get_one_active(
+			EEM_Payment_Method::scope_cart,
+			array(array('PMD_type' => 'Invoice'))
+		);
+		$active_pms_count = EEM_Payment_Method::instance()->count_active(EEM_Payment_Method::scope_cart);
+		// done step two if a non-invoice paymetn method is active; or there is more than one PM active, or
+		// if only the invoice is active but it's clearly been updated
+		$done_step_two = $active_pms_count > 1 ||
+						 ($active_pms_count === 1 && ! $active_invoice_pm) ||
+						 ($active_invoice_pm instanceof EE_Payment_Method && (
+								 $active_invoice_pm->get_extra_meta('pdf_payee_name', true, '') ||
+								 $active_invoice_pm->get_extra_meta('pdf_payee_email', true, '') ||
+								 $active_invoice_pm->get_extra_meta('pdf_payee_tax_number', true, '') ||
+								 $active_invoice_pm->get_extra_meta('pdf_payee_address', true, '') ||
+								 $active_invoice_pm->get_extra_meta('page_extra_info', true, '')
+							 )
+						 );
+		$done_step_three = EE_Registry::instance()->load_model('Event')->count() > 0 ? true : false;
+
+		// if ALL steps are done, let's just return FALSE so we don't display anything
+		if ($done_step_one && $done_step_two && $done_step_three) {
+			return false;
+		}
+
+		// now let's put it together
+		$steps .= sprintf('%s' . $step_one . '%s', $done_step_one ? '<strike>' : '', $done_step_one ? '</strike>' : '');
+		$steps .= sprintf('%s' . $step_two . '%s', $done_step_two ? '<strike>' : '', $done_step_two ? '</strike>' : '');
+		$steps .= sprintf(
+			'%s' . $step_three . '%s',
+			$done_step_three ? '<strike>' : '',
+			$done_step_three ? '</strike>' : ''
+		);
+
+		return $steps;
+	}
+
+
+	protected function _credits()
+	{
+		$this->_template_args['admin_page_title'] = sprintf(
+			esc_html__('Welcome to Event Espresso %s', 'event_espresso'),
+			EVENT_ESPRESSO_VERSION
+		);
+		$this->_template_args['admin_page_subtitle'] = esc_html__(
+			'Thank you for choosing Event Espresso Decaf, the most powerful, and free, Event Management plugin for WordPress.',
+			'event_espresso'
+		);
+		$template = EE_ABOUT_TEMPLATE_PATH . 'credits.template.php';
+		$this->_template_args['about_admin_page_content'] = EEH_Template::display_template(
+			$template,
+			$this->_template_args,
+			true
+		);
+		$this->display_about_admin_page();
+	}
+
+
+	protected function _decafvpro()
+	{
+		$this->_template_args['admin_page_title'] = sprintf(
+			esc_html__('Welcome to Event Espresso %s', 'event_espresso'),
+			EVENT_ESPRESSO_VERSION
+		);
+		$this->_template_args['admin_page_subtitle'] = sprintf(
+			esc_html__(
+				'Event Espresso lets you focus on doing %swhat you love%s — %sorganizing your events%s',
+				'event_espresso'
+			),
+			'<em>',
+			'</em>',
+			'<strong>',
+			'</strong>'
+		);
+		$template = EE_ABOUT_TEMPLATE_PATH . 'decafvpro.template.php';
+		$this->_template_args['about_admin_page_content'] = EEH_Template::display_template(
+			$template,
+			$this->_template_args,
+			true
+		);
+		$this->display_about_admin_page();
+	}
+
+	protected function _reviews()
+	{
+		$this->_template_args['admin_page_title'] = esc_html__('Rave Reviews About Event Espresso 4', 'event_espresso');
+		$this->_template_args['admin_page_subtitle'] = esc_html__(
+			'At Event Espresso, customer satisfaction is our ultimate goal.',
+			'event_espresso'
+		);
+		$template = EE_ABOUT_TEMPLATE_PATH . 'reviews.template.php';
+		$this->_template_args['about_admin_page_content'] = EEH_Template::display_template(
+			$template,
+			$this->_template_args,
+			true
+		);
+		$this->display_about_admin_page();
+	}
 }

admin_pages/registration_form/Registration_Form_Admin_Page.core.php

Indentation +741 added lines, -741 removed lines

@@ -17,692 +17,692 @@ 
  */
 class Registration_Form_Admin_Page extends EE_Admin_Page
 {
-    /**
-     * holds the specific question object for the question details screen
-     */
-    protected ?EE_Question $_question = null;
-
-    /**
-     * holds the specific question group object for the question group details screen
-     */
-    protected ?EE_Question_Group $_question_group = null;
-
-    protected EEM_Question $_question_model;
-
-    protected EEM_Question_Group $_question_group_model;
-
-
-    /**
-     * @Constructor
-     * @param bool $routing indicate whether we want to just load the object and handle routing or just load the object.
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function __construct($routing = true)
-    {
-        require_once(EE_MODELS . 'EEM_Question.model.php');
-        require_once(EE_MODELS . 'EEM_Question_Group.model.php');
-        $this->_question_model       = EEM_Question::instance();
-        $this->_question_group_model = EEM_Question_Group::instance();
-        parent::__construct($routing);
-    }
-
-
-    protected function _init_page_props()
-    {
-        $this->page_slug        = REGISTRATION_FORM_PG_SLUG;
-        $this->page_label       = esc_html__('Registration Form', 'event_espresso');
-        $this->_admin_base_url  = REGISTRATION_FORM_ADMIN_URL;
-        $this->_admin_base_path = REGISTRATION_FORM_ADMIN;
-    }
-
-
-    protected function _ajax_hooks()
-    {
-    }
-
-
-    protected function _define_page_props()
-    {
-        $this->_admin_page_title = esc_html__('Registration Form', 'event_espresso');
-        $this->_labels           = [
-            'buttons'    => [
-                'edit_question' => esc_html__('Edit Question', 'event_espresso'),
-            ],
-            'publishbox' => [
-                'edit_question' => esc_html__('Edit Question', 'event_espresso'),
-            ],
-        ];
-    }
-
-
-    /**
-     *_set_page_routes
-     */
-    protected function _set_page_routes()
-    {
-        $qst_id             =
-            ! empty($this->_req_data['QST_ID'])
-                ? $this->_req_data['QST_ID']
-                : 0;
-        $this->_page_routes = [
-            'default' => [
-                'func'       => [$this, '_questions_overview_list_table'],
-                'capability' => 'ee_read_questions',
-            ],
-
-            'edit_question' => [
-                'func'       => [$this, '_edit_question'],
-                'capability' => 'ee_edit_question',
-                'obj_id'     => $qst_id,
-                'args'       => ['edit'],
-            ],
-
-            'question_groups' => [
-                'func'       => [$this, '_questions_groups_preview'],
-                'capability' => 'ee_read_question_groups',
-            ],
-
-            'update_question' => [
-                'func'       => [$this, '_insert_or_update_question'],
-                'args'       => ['new_question' => false],
-                'capability' => 'ee_edit_question',
-                'obj_id'     => $qst_id,
-                'noheader'   => true,
-            ],
-        ];
-    }
-
-
-    protected function _set_page_config()
-    {
-        $this->_page_config = [
-            'default' => [
-                'nav'           => [
-                    'label' => esc_html__('Questions', 'event_espresso'),
-                    'icon'  => 'dashicons-editor-help',
-                    'order' => 10,
-                ],
-                'list_table'    => 'Registration_Form_Questions_Admin_List_Table',
-                'metaboxes'     => $this->_default_espresso_metaboxes,
-                'help_tabs'     => [
-                    'registration_form_questions_overview_help_tab'                           => [
-                        'title'    => esc_html__('Questions Overview', 'event_espresso'),
-                        'filename' => 'registration_form_questions_overview',
-                    ],
-                    'registration_form_questions_overview_table_column_headings_help_tab'     => [
-                        'title'    => esc_html__('Questions Overview Table Column Headings', 'event_espresso'),
-                        'filename' => 'registration_form_questions_overview_table_column_headings',
-                    ],
-                    'registration_form_questions_overview_views_bulk_actions_search_help_tab' => [
-                        'title'    => esc_html__('Question Overview Views & Bulk Actions & Search', 'event_espresso'),
-                        'filename' => 'registration_form_questions_overview_views_bulk_actions_search',
-                    ],
-                ],
-                'require_nonce' => false,
-            ],
-
-            'question_groups' => [
-                'nav'           => [
-                    'label' => esc_html__('Question Groups', 'event_espresso'),
-                    'icon'  => 'dashicons-forms',
-                    'order' => 20,
-                ],
-                'metaboxes'     => $this->_default_espresso_metaboxes,
-                'help_tabs'     => [
-                    'registration_form_question_groups_help_tab' => [
-                        'title'    => esc_html__('Question Groups', 'event_espresso'),
-                        'filename' => 'registration_form_question_groups',
-                    ],
-                ],
-                'require_nonce' => false,
-            ],
-
-            'edit_question' => [
-                'nav'           => [
-                    'label'      => esc_html__('Edit Question', 'event_espresso'),
-                    'icon'       => 'dashicons-edit-large',
-                    'order'      => 15,
-                    'persistent' => false,
-                    'url'        => isset($this->_req_data['question_id'])
-                        ? add_query_arg(
-                            ['question_id' => $this->_req_data['question_id']],
-                            $this->_current_page_view_url
-                        )
-                        : $this->_admin_base_url,
-                ],
-                'metaboxes'     => array_merge($this->_default_espresso_metaboxes, ['_publish_post_box']),
-                'help_tabs'     => [
-                    'registration_form_edit_question_group_help_tab' => [
-                        'title'    => esc_html__('Edit Question', 'event_espresso'),
-                        'filename' => 'registration_form_edit_question',
-                    ],
-                ],
-                'require_nonce' => false,
-            ],
-        ];
-    }
-
-
-    protected function _add_screen_options()
-    {
-        // todo
-    }
-
-
-    protected function _add_screen_options_default()
-    {
-        $page_title              = $this->_admin_page_title;
-        $this->_admin_page_title = esc_html__('Questions', 'event_espresso');
-        $this->_per_page_screen_option();
-        $this->_admin_page_title = $page_title;
-    }
-
-
-    protected function _add_screen_options_question_groups()
-    {
-        $page_title              = $this->_admin_page_title;
-        $this->_admin_page_title = esc_html__('Question Groups', 'event_espresso');
-        $this->_per_page_screen_option();
-        $this->_admin_page_title = $page_title;
-    }
-
-
-    // none of the below group are currently used for Event Categories
-    protected function _add_feature_pointers()
-    {
-    }
-
-
-    public function load_scripts_styles()
-    {
-        wp_register_style(
-            'espresso_registration',
-            REGISTRATION_FORM_ASSETS_URL . 'espresso_registration_form_admin.css',
-            [EspressoLegacyAdminAssetManager::CSS_HANDLE_EE_ADMIN],
-            EVENT_ESPRESSO_VERSION
-        );
-        wp_enqueue_style('espresso_registration');
-    }
-
-
-    public function admin_init()
-    {
-    }
-
-
-    public function admin_notices()
-    {
-    }
-
-
-    public function admin_footer_scripts()
-    {
-    }
-
-
-    public function load_scripts_styles_default()
-    {
-    }
-
-
-    public function load_scripts_styles_add_question()
-    {
-        $this->load_scripts_styles_question_details();
-    }
-
-
-    public function load_scripts_styles_edit_question()
-    {
-        $this->load_scripts_styles_question_details();
-    }
-
-
-    /**
-     * Loads the JS required for adding or editing a question
-     */
-    protected function load_scripts_styles_question_details()
-    {
-        $this->load_scripts_styles_forms();
-        wp_register_script(
-            'espresso_registration_form_single',
-            REGISTRATION_FORM_ASSETS_URL . 'espresso_registration_form_admin.js',
-            ['jquery-ui-sortable'],
-            EVENT_ESPRESSO_VERSION,
-            true
-        );
-        wp_enqueue_script('espresso_registration_form_single');
-        wp_localize_script(
-            'espresso_registration_form_single',
-            'ee_question_data',
-            [
-                'question_types_with_max'    => $this->_question_model->questionTypesWithMaxLength(),
-                'question_type_with_options' => $this->_question_model->question_types_with_options(),
-            ]
-        );
-    }
-
-
-    public function recaptcha_info_help_tab()
-    {
-        EEH_Template::display_template(REGISTRATION_FORM_TEMPLATE_PATH . 'recaptcha_info_help_tab.template.php');
-    }
-
-
-    public function load_scripts_styles_forms()
-    {
-        // styles
-        wp_enqueue_style('espresso-ui-theme');
-        // scripts
-        wp_enqueue_script('ee_admin_js');
-    }
-
-
-    protected function _set_list_table_views_default()
-    {
-        $this->_views = [
-            'all' => [
-                'slug'  => 'all',
-                'label' => esc_html__('View All Questions', 'event_espresso'),
-                'count' => 0,
-            ],
-        ];
-
-        if (
-            $this->capabilities->current_user_can(
-                'ee_delete_questions',
-                'espresso_registration_form_trash_questions'
-            )
-        ) {
-            $this->_views['trash'] = [
-                'slug'  => 'trash',
-                'label' => esc_html__('Trash', 'event_espresso'),
-                'count' => 0,
-            ];
-        }
-    }
-
-
-    /**
-     * This just previews the question groups tab that comes in caffeinated.
-     *
-     * @return void html
-     * @throws EE_Error
-     */
-    protected function _questions_groups_preview()
-    {
-        $this->_admin_page_title              = esc_html__('Question Groups (Preview)', 'event_espresso');
-        $this->_template_args['preview_img']  =
-            '<img src="' . REGISTRATION_FORM_ASSETS_URL . 'caf_reg_form_preview.jpg" alt="'
-            . esc_attr__(
-                'Preview Question Groups Overview List Table screenshot',
-                'event_espresso'
-            ) . '" />';
-        $this->_template_args['preview_text'] = '<strong>'
-            . esc_html__(
-                'Question Groups 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. With the Question Groups feature you are able to create new question groups, edit existing question groups, and create and edit new questions and add them to question groups.',
-                'event_espresso'
-            ) . '</strong>';
-        $this->display_admin_caf_preview_page('question_groups_tab');
-    }
-
-
-    /**
-     * Extracts the question field's values from the POST request to update or insert them
-     *
-     * @param EEM_Base $model
-     * @return array where each key is the name of a model's field/db column, and each value is its value.
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _set_column_values_for(EEM_Base $model): array
-    {
-        $column_values = [];
-        // some initial checks for proper values.
-        $QST_ID = $this->request->getRequestParam('QST_ID', 0, DataType::INT);
-        // if QST_admin_only, then no matter what QST_required is we disable.
-        $QST_admin_only = $this->request->getRequestParam('QST_admin_only', false, DataType::BOOL);
-        if ($QST_admin_only) {
-            $this->request->setRequestParam('QST_required', false);
-        }
-        // if the question shouldn't have a max length, don't let them set one
-        if (
-            ! (
-                $this->request->requestParamIsSet('QST_type')
-                && $this->request->requestParamIsSet('QST_max')
-            ) || ! in_array(
-                $this->request->getRequestParam('QST_type', '', DataType::STRING),
-                $this->_question_model->questionTypesWithMaxLength(),
-                true
-            )
-        ) {
-            // they're not allowed to set the max
-            $this->request->unSetRequestParam('QST_max', true);
-        }
-        foreach ($model->field_settings() as $fieldName => $settings) {
-            switch($fieldName) {
-                case 'QSG_identifier':
-                    // basically if QSG_identifier is empty or not set
-                    if (! $this->request->getRequestParam('QSG_identifier', '', DataType::STRING)) {
-                        $QSG_name                    = $this->request->getRequestParam('QSG_name', '', DataType::STRING);
-                        $column_values[ $fieldName ] = sanitize_title($QSG_name) . '-' . uniqid('', true);
-                    }
-                    break;
-
-                case 'QST_admin_label':
-                    if (! $this->request->getRequestParam('QST_admin_label', '', DataType::STRING)) {
-                        // the admin label is blank, use a slug version of the question text
-                        $QST_text                    = $this->request->getRequestParam('QST_display_text', '', DataType::STRING);
-                        $column_values[ $fieldName ] = sanitize_title(wp_trim_words($QST_text, 10));
-                    }
-                    break;
-
-                case 'QST_admin_only':
-                    if (! $QST_admin_only) {
-                        $column_values[ $fieldName ] = false;
-                    }
-                    break;
-
-                case 'QST_max':
-                    $qst_system = $this->_question_model->get_var(
-                        [ [ 'QST_ID' => $QST_ID ] ],
-                        'QST_system'
-                    );
-
-                    $max_max = $this->_question_model->absolute_max_for_system_question((string) $qst_system);
-                    $QST_max = $this->request->getRequestParam('QST_max', 0, DataType::INT);
-                    if ($QST_max === 0 || $QST_max > $max_max) {
-                        $column_values[ $fieldName ] = $max_max;
-                    }
-                    break;
-
-                default:
-                    // only add a property to the array if it's not null (otherwise the model should just use the default value)
-                    if ($this->request->requestParamIsSet($fieldName)) {
-                        // convert the schema type to the appropriate data type
-                        $schema_type = DataType::convertModelFieldSchemaType($settings->getSchemaType());
-                        $column_values[ $fieldName ] = $this->request->getRequestParam($fieldName, null, $schema_type);
-                    }
-            }
-        }
-        // validation for this data to be performed by the model before insertion.
-        return $column_values;
-    }
-
-
-    /**
-     *_questions_overview_list_table
-     *
-     * @throws EE_Error
-     */
-    protected function _questions_overview_list_table()
-    {
-        $this->_search_btn_label = esc_html__('Questions', 'event_espresso');
-        $this->display_admin_list_table_page_with_sidebar();
-    }
-
-
-    /**
-     * _edit_question
-     *
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _edit_question()
-    {
-        $ID = isset($this->_req_data['QST_ID']) && ! empty($this->_req_data['QST_ID'])
-            ? absint($this->_req_data['QST_ID'])
-            : false;
-
-        switch ($this->_req_action) {
-            case 'add_question':
-                $this->_admin_page_title = esc_html__('Add Question', 'event_espresso');
-                break;
-            case 'edit_question':
-                $this->_admin_page_title = esc_html__('Edit Question', 'event_espresso');
-                break;
-            default:
-                $this->_admin_page_title = ucwords(str_replace('_', ' ', $this->_req_action));
-        }
-
-        // add PRC_ID to title if editing
-        $this->_admin_page_title =
-            $ID
-                ? $this->_admin_page_title . ' # ' . $ID
-                : $this->_admin_page_title;
-        if ($ID) {
-            $question                 = $this->_question_model->get_one_by_ID($ID);
-            $additional_hidden_fields = ['QST_ID' => ['type' => 'hidden', 'value' => $ID]];
-            $this->_set_add_edit_form_tags('update_question', $additional_hidden_fields);
-        } else {
-            $question = EE_Question::new_instance();
-            $question->set_order_to_latest();
-            $this->_set_add_edit_form_tags('insert_question');
-        }
-        if ($question->system_ID() === EEM_Attendee::system_question_phone) {
-            $question_types = array_intersect_key(
-                $this->_question_model->allowed_question_types(),
-                array_flip(
-                    [
-                        EEM_Question::QST_type_text,
-                        EEM_Question::QST_type_us_phone,
-                    ]
-                )
-            );
-        } else {
-            $question_types = $question->has_answers()
-                ? $this->_question_model->question_types_in_same_category($question->type())
-                : $this->_question_model->allowed_question_types();
-        }
-        $this->_template_args['QST_ID']                     = $ID;
-        $this->_template_args['question']                   = $question;
-        $this->_template_args['question_types']             = $question_types;
-        $this->_template_args['max_max']                    =
-            $this->_question_model->absolute_max_for_system_question(
-                $question->system_ID()
-            );
-        $this->_template_args['question_type_descriptions'] = $this->_get_question_type_descriptions();
-        $this->_set_publish_post_box_vars('id', $ID);
-        $this->_template_args['admin_page_content'] = EEH_Template::display_template(
-            REGISTRATION_FORM_TEMPLATE_PATH . 'questions_main_meta_box.template.php',
-            $this->_template_args,
-            true
-        );
-
-        // the details template wrapper
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    /**
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _get_question_type_descriptions(): string
-    {
-        EE_Registry::instance()->load_helper('HTML');
-        $descriptions               = '';
-        $question_type_descriptions = $this->_question_model->question_descriptions();
-        foreach ($question_type_descriptions as $type => $question_type_description) {
-            if ($type == 'HTML_TEXTAREA') {
-                $html                      = new EE_Simple_HTML_Validation_Strategy();
-                $question_type_description .= sprintf(
-                    esc_html__('%1$s(allowed tags: %2$s)', 'event_espresso'),
-                    '<br/>',
-                    $html->get_list_of_allowed_tags()
-                );
-            }
-            $descriptions .= EEH_HTML::p(
-                $question_type_description,
-                'question_type_description-' . $type,
-                'question_type_description description',
-                'display:none;'
-            );
-        }
-        return $descriptions;
-    }
-
-
-    /**
-     * @param bool $new_question
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _insert_or_update_question(bool $new_question = true)
-    {
-        $set_column_values = $this->_set_column_values_for($this->_question_model);
-        if ($new_question) {
-            $question    = EE_Question::new_instance($set_column_values);
-            $action_desc = 'added';
-        } else {
-            $question = $this->_question_model->get_one_by_ID(
-                $this->request->getRequestParam('QST_ID', 0, DataType::INT)
-            );
-            foreach ($set_column_values as $field => $new_value) {
-                $question->set($field, $new_value);
-            }
-            $action_desc = 'updated';
-        }
-        $success = $question->save();
-        $ID      = $question->ID();
-        if ($ID && $question->should_have_question_options()) {
-            // save the related options
-            // trash removed options, save old ones
-            // get list of all options
-            $options          = $question->options();
-            $question_options = $this->request->getRequestParam('question_options', [], DataType::ARRAY);
-            $QSO_default      = $this->request->getRequestParam('QSO_default', null, DataType::INT);
-            if (! empty($options)) {
-                foreach ($options as $option_ID => $option) {
-                    $option_req_index = $this->_get_option_req_data_index($option_ID);
-                    if ($option_req_index !== false) {
-                        $question_options[ $option_req_index ]['QSO_default'] = $option_req_index === $QSO_default;
-                        $option->save($question_options[ $option_req_index ]);
-                    } else {
-                        // not found, remove it
-                        $option->delete();
-                    }
-                }
-            }
-            // save new related options
-            foreach ($question_options as $index => $option_req_data) {
-                // skip $index that is from our sample
-                if ($index === 'xxcountxx') {
-                    continue;
-                }
-                // note we allow saving blank options.
-                if (empty($option_req_data['QSO_ID'])) {
-                    // no ID! save it!
-                    $new_option = EE_Question_Option::new_instance(
-                        [
-                            'QSO_value'   => $option_req_data['QSO_value'],
-                            'QSO_desc'    => $option_req_data['QSO_desc'],
-                            'QSO_default' => $index === $QSO_default,
-                            'QSO_order'   => $option_req_data['QSO_order'],
-                            'QST_ID'      => $question->ID(),
-                        ]
-                    );
-                    $new_option->save();
-                }
-            }
-        }
-
-        $success = apply_filters(
-            'FHEE__Registration_Form_Admin_Page___insert_or_update_question__success',
-            (int) $success,
-            $question,
-            $this
-        );
-
-        $query_args = ['action' => 'edit_question', 'QST_ID' => $ID];
-        if ($success !== 0) {
-            $msg = $new_question
-                ? sprintf(
-                    esc_html__('The %s has been created', 'event_espresso'),
-                    $this->_question_model->item_name()
-                )
-                : sprintf(
-                    esc_html__('The %s has been updated', 'event_espresso'),
-                    $this->_question_model->item_name()
-                );
-            EE_Error::add_success($msg);
-        }
-
-        $this->_redirect_after_action(false, '', $action_desc, $query_args, true);
-    }
-
-
-    /**
-     * Upon saving a question, there should be an array of 'question_options'. This array is index numerically, but not
-     * by ID
-     * (this is done because new question options don't have an ID, but we may want to add multiple simultaneously).
-     * So, this function gets the index in that request data array called question_options. Returns FALSE if not found.
-     *
-     * @param int $ID of the question option to find
-     * @return int index in question_options array if successful, FALSE if unsuccessful
-     */
-    protected function _get_option_req_data_index(int $ID)
-    {
-        $req_data_for_question_options = $this->_req_data['question_options'];
-        foreach ($req_data_for_question_options as $num => $option_data) {
-            if (array_key_exists('QSO_ID', $option_data) && (int) $option_data['QSO_ID'] === $ID) {
-                return $num;
-            }
-        }
-        return false;
-    }
-
-
-
-
-    /* QUERIES */
-    /**
-     * For internal use in getting all the query parameters
-     * (because it's pretty well the same between question, question groups,
-     * and for both when searching for trashed and untrashed ones)
-     *
-     * @param EEM_Base $model either EEM_Question or EEM_Question_Group
-     * @param int      $per_page
-     * @param int      $current_page
-     * @return array model query params,
-     * @see https://github.com/eventespresso/event-espresso-core/tree/master/docs/G--Model-System/model-query-params.md
-     */
-    protected function get_query_params(EEM_Base $model, int $per_page = 10, int $current_page = 10): array
-    {
-        $query_params             = [];
-        $offset                   = ($current_page - 1) * $per_page;
-        $query_params['limit']    = [$offset, $per_page];
-
-        $order  = (isset($this->_req_data['order']) && ! empty($this->_req_data['order']))
-            ? $this->_req_data['order']
-            : 'ASC';
-
-        $orderby_field = $model instanceof EEM_Question ? 'QST_ID' : 'QSG_order';
-
-        $field_to_order_by = empty($this->_req_data['orderby']) ? $orderby_field : $this->_req_data['orderby'];
-
-        $query_params['order_by'] = [$field_to_order_by => $order];
-
-        $search_string = array_key_exists('s', $this->_req_data) ? $this->_req_data['s'] : null;
-        if (! empty($search_string)) {
-            if ($model instanceof EEM_Question_Group) {
-                $query_params[0] = [
-                    'OR' => [
-                        'QSG_name' => ['LIKE', "%$search_string%"],
-                        'QSG_desc' => ['LIKE', "%$search_string%"],
-                    ],
-                ];
-            } else {
-                $query_params[0] = [
-                    'QST_display_text' => ['LIKE', "%$search_string%"],
-                ];
-            }
-        }
-
-        // capability checks (just leaving this commented out for reference because
-        // it illustrates some complicated query params that could be useful when fully implemented)
-        /*if ( $model instanceof EEM_Question_Group ) {
+	/**
+	 * holds the specific question object for the question details screen
+	 */
+	protected ?EE_Question $_question = null;
+
+	/**
+	 * holds the specific question group object for the question group details screen
+	 */
+	protected ?EE_Question_Group $_question_group = null;
+
+	protected EEM_Question $_question_model;
+
+	protected EEM_Question_Group $_question_group_model;
+
+
+	/**
+	 * @Constructor
+	 * @param bool $routing indicate whether we want to just load the object and handle routing or just load the object.
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function __construct($routing = true)
+	{
+		require_once(EE_MODELS . 'EEM_Question.model.php');
+		require_once(EE_MODELS . 'EEM_Question_Group.model.php');
+		$this->_question_model       = EEM_Question::instance();
+		$this->_question_group_model = EEM_Question_Group::instance();
+		parent::__construct($routing);
+	}
+
+
+	protected function _init_page_props()
+	{
+		$this->page_slug        = REGISTRATION_FORM_PG_SLUG;
+		$this->page_label       = esc_html__('Registration Form', 'event_espresso');
+		$this->_admin_base_url  = REGISTRATION_FORM_ADMIN_URL;
+		$this->_admin_base_path = REGISTRATION_FORM_ADMIN;
+	}
+
+
+	protected function _ajax_hooks()
+	{
+	}
+
+
+	protected function _define_page_props()
+	{
+		$this->_admin_page_title = esc_html__('Registration Form', 'event_espresso');
+		$this->_labels           = [
+			'buttons'    => [
+				'edit_question' => esc_html__('Edit Question', 'event_espresso'),
+			],
+			'publishbox' => [
+				'edit_question' => esc_html__('Edit Question', 'event_espresso'),
+			],
+		];
+	}
+
+
+	/**
+	 *_set_page_routes
+	 */
+	protected function _set_page_routes()
+	{
+		$qst_id             =
+			! empty($this->_req_data['QST_ID'])
+				? $this->_req_data['QST_ID']
+				: 0;
+		$this->_page_routes = [
+			'default' => [
+				'func'       => [$this, '_questions_overview_list_table'],
+				'capability' => 'ee_read_questions',
+			],
+
+			'edit_question' => [
+				'func'       => [$this, '_edit_question'],
+				'capability' => 'ee_edit_question',
+				'obj_id'     => $qst_id,
+				'args'       => ['edit'],
+			],
+
+			'question_groups' => [
+				'func'       => [$this, '_questions_groups_preview'],
+				'capability' => 'ee_read_question_groups',
+			],
+
+			'update_question' => [
+				'func'       => [$this, '_insert_or_update_question'],
+				'args'       => ['new_question' => false],
+				'capability' => 'ee_edit_question',
+				'obj_id'     => $qst_id,
+				'noheader'   => true,
+			],
+		];
+	}
+
+
+	protected function _set_page_config()
+	{
+		$this->_page_config = [
+			'default' => [
+				'nav'           => [
+					'label' => esc_html__('Questions', 'event_espresso'),
+					'icon'  => 'dashicons-editor-help',
+					'order' => 10,
+				],
+				'list_table'    => 'Registration_Form_Questions_Admin_List_Table',
+				'metaboxes'     => $this->_default_espresso_metaboxes,
+				'help_tabs'     => [
+					'registration_form_questions_overview_help_tab'                           => [
+						'title'    => esc_html__('Questions Overview', 'event_espresso'),
+						'filename' => 'registration_form_questions_overview',
+					],
+					'registration_form_questions_overview_table_column_headings_help_tab'     => [
+						'title'    => esc_html__('Questions Overview Table Column Headings', 'event_espresso'),
+						'filename' => 'registration_form_questions_overview_table_column_headings',
+					],
+					'registration_form_questions_overview_views_bulk_actions_search_help_tab' => [
+						'title'    => esc_html__('Question Overview Views & Bulk Actions & Search', 'event_espresso'),
+						'filename' => 'registration_form_questions_overview_views_bulk_actions_search',
+					],
+				],
+				'require_nonce' => false,
+			],
+
+			'question_groups' => [
+				'nav'           => [
+					'label' => esc_html__('Question Groups', 'event_espresso'),
+					'icon'  => 'dashicons-forms',
+					'order' => 20,
+				],
+				'metaboxes'     => $this->_default_espresso_metaboxes,
+				'help_tabs'     => [
+					'registration_form_question_groups_help_tab' => [
+						'title'    => esc_html__('Question Groups', 'event_espresso'),
+						'filename' => 'registration_form_question_groups',
+					],
+				],
+				'require_nonce' => false,
+			],
+
+			'edit_question' => [
+				'nav'           => [
+					'label'      => esc_html__('Edit Question', 'event_espresso'),
+					'icon'       => 'dashicons-edit-large',
+					'order'      => 15,
+					'persistent' => false,
+					'url'        => isset($this->_req_data['question_id'])
+						? add_query_arg(
+							['question_id' => $this->_req_data['question_id']],
+							$this->_current_page_view_url
+						)
+						: $this->_admin_base_url,
+				],
+				'metaboxes'     => array_merge($this->_default_espresso_metaboxes, ['_publish_post_box']),
+				'help_tabs'     => [
+					'registration_form_edit_question_group_help_tab' => [
+						'title'    => esc_html__('Edit Question', 'event_espresso'),
+						'filename' => 'registration_form_edit_question',
+					],
+				],
+				'require_nonce' => false,
+			],
+		];
+	}
+
+
+	protected function _add_screen_options()
+	{
+		// todo
+	}
+
+
+	protected function _add_screen_options_default()
+	{
+		$page_title              = $this->_admin_page_title;
+		$this->_admin_page_title = esc_html__('Questions', 'event_espresso');
+		$this->_per_page_screen_option();
+		$this->_admin_page_title = $page_title;
+	}
+
+
+	protected function _add_screen_options_question_groups()
+	{
+		$page_title              = $this->_admin_page_title;
+		$this->_admin_page_title = esc_html__('Question Groups', 'event_espresso');
+		$this->_per_page_screen_option();
+		$this->_admin_page_title = $page_title;
+	}
+
+
+	// none of the below group are currently used for Event Categories
+	protected function _add_feature_pointers()
+	{
+	}
+
+
+	public function load_scripts_styles()
+	{
+		wp_register_style(
+			'espresso_registration',
+			REGISTRATION_FORM_ASSETS_URL . 'espresso_registration_form_admin.css',
+			[EspressoLegacyAdminAssetManager::CSS_HANDLE_EE_ADMIN],
+			EVENT_ESPRESSO_VERSION
+		);
+		wp_enqueue_style('espresso_registration');
+	}
+
+
+	public function admin_init()
+	{
+	}
+
+
+	public function admin_notices()
+	{
+	}
+
+
+	public function admin_footer_scripts()
+	{
+	}
+
+
+	public function load_scripts_styles_default()
+	{
+	}
+
+
+	public function load_scripts_styles_add_question()
+	{
+		$this->load_scripts_styles_question_details();
+	}
+
+
+	public function load_scripts_styles_edit_question()
+	{
+		$this->load_scripts_styles_question_details();
+	}
+
+
+	/**
+	 * Loads the JS required for adding or editing a question
+	 */
+	protected function load_scripts_styles_question_details()
+	{
+		$this->load_scripts_styles_forms();
+		wp_register_script(
+			'espresso_registration_form_single',
+			REGISTRATION_FORM_ASSETS_URL . 'espresso_registration_form_admin.js',
+			['jquery-ui-sortable'],
+			EVENT_ESPRESSO_VERSION,
+			true
+		);
+		wp_enqueue_script('espresso_registration_form_single');
+		wp_localize_script(
+			'espresso_registration_form_single',
+			'ee_question_data',
+			[
+				'question_types_with_max'    => $this->_question_model->questionTypesWithMaxLength(),
+				'question_type_with_options' => $this->_question_model->question_types_with_options(),
+			]
+		);
+	}
+
+
+	public function recaptcha_info_help_tab()
+	{
+		EEH_Template::display_template(REGISTRATION_FORM_TEMPLATE_PATH . 'recaptcha_info_help_tab.template.php');
+	}
+
+
+	public function load_scripts_styles_forms()
+	{
+		// styles
+		wp_enqueue_style('espresso-ui-theme');
+		// scripts
+		wp_enqueue_script('ee_admin_js');
+	}
+
+
+	protected function _set_list_table_views_default()
+	{
+		$this->_views = [
+			'all' => [
+				'slug'  => 'all',
+				'label' => esc_html__('View All Questions', 'event_espresso'),
+				'count' => 0,
+			],
+		];
+
+		if (
+			$this->capabilities->current_user_can(
+				'ee_delete_questions',
+				'espresso_registration_form_trash_questions'
+			)
+		) {
+			$this->_views['trash'] = [
+				'slug'  => 'trash',
+				'label' => esc_html__('Trash', 'event_espresso'),
+				'count' => 0,
+			];
+		}
+	}
+
+
+	/**
+	 * This just previews the question groups tab that comes in caffeinated.
+	 *
+	 * @return void html
+	 * @throws EE_Error
+	 */
+	protected function _questions_groups_preview()
+	{
+		$this->_admin_page_title              = esc_html__('Question Groups (Preview)', 'event_espresso');
+		$this->_template_args['preview_img']  =
+			'<img src="' . REGISTRATION_FORM_ASSETS_URL . 'caf_reg_form_preview.jpg" alt="'
+			. esc_attr__(
+				'Preview Question Groups Overview List Table screenshot',
+				'event_espresso'
+			) . '" />';
+		$this->_template_args['preview_text'] = '<strong>'
+			. esc_html__(
+				'Question Groups 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. With the Question Groups feature you are able to create new question groups, edit existing question groups, and create and edit new questions and add them to question groups.',
+				'event_espresso'
+			) . '</strong>';
+		$this->display_admin_caf_preview_page('question_groups_tab');
+	}
+
+
+	/**
+	 * Extracts the question field's values from the POST request to update or insert them
+	 *
+	 * @param EEM_Base $model
+	 * @return array where each key is the name of a model's field/db column, and each value is its value.
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _set_column_values_for(EEM_Base $model): array
+	{
+		$column_values = [];
+		// some initial checks for proper values.
+		$QST_ID = $this->request->getRequestParam('QST_ID', 0, DataType::INT);
+		// if QST_admin_only, then no matter what QST_required is we disable.
+		$QST_admin_only = $this->request->getRequestParam('QST_admin_only', false, DataType::BOOL);
+		if ($QST_admin_only) {
+			$this->request->setRequestParam('QST_required', false);
+		}
+		// if the question shouldn't have a max length, don't let them set one
+		if (
+			! (
+				$this->request->requestParamIsSet('QST_type')
+				&& $this->request->requestParamIsSet('QST_max')
+			) || ! in_array(
+				$this->request->getRequestParam('QST_type', '', DataType::STRING),
+				$this->_question_model->questionTypesWithMaxLength(),
+				true
+			)
+		) {
+			// they're not allowed to set the max
+			$this->request->unSetRequestParam('QST_max', true);
+		}
+		foreach ($model->field_settings() as $fieldName => $settings) {
+			switch($fieldName) {
+				case 'QSG_identifier':
+					// basically if QSG_identifier is empty or not set
+					if (! $this->request->getRequestParam('QSG_identifier', '', DataType::STRING)) {
+						$QSG_name                    = $this->request->getRequestParam('QSG_name', '', DataType::STRING);
+						$column_values[ $fieldName ] = sanitize_title($QSG_name) . '-' . uniqid('', true);
+					}
+					break;
+
+				case 'QST_admin_label':
+					if (! $this->request->getRequestParam('QST_admin_label', '', DataType::STRING)) {
+						// the admin label is blank, use a slug version of the question text
+						$QST_text                    = $this->request->getRequestParam('QST_display_text', '', DataType::STRING);
+						$column_values[ $fieldName ] = sanitize_title(wp_trim_words($QST_text, 10));
+					}
+					break;
+
+				case 'QST_admin_only':
+					if (! $QST_admin_only) {
+						$column_values[ $fieldName ] = false;
+					}
+					break;
+
+				case 'QST_max':
+					$qst_system = $this->_question_model->get_var(
+						[ [ 'QST_ID' => $QST_ID ] ],
+						'QST_system'
+					);
+
+					$max_max = $this->_question_model->absolute_max_for_system_question((string) $qst_system);
+					$QST_max = $this->request->getRequestParam('QST_max', 0, DataType::INT);
+					if ($QST_max === 0 || $QST_max > $max_max) {
+						$column_values[ $fieldName ] = $max_max;
+					}
+					break;
+
+				default:
+					// only add a property to the array if it's not null (otherwise the model should just use the default value)
+					if ($this->request->requestParamIsSet($fieldName)) {
+						// convert the schema type to the appropriate data type
+						$schema_type = DataType::convertModelFieldSchemaType($settings->getSchemaType());
+						$column_values[ $fieldName ] = $this->request->getRequestParam($fieldName, null, $schema_type);
+					}
+			}
+		}
+		// validation for this data to be performed by the model before insertion.
+		return $column_values;
+	}
+
+
+	/**
+	 *_questions_overview_list_table
+	 *
+	 * @throws EE_Error
+	 */
+	protected function _questions_overview_list_table()
+	{
+		$this->_search_btn_label = esc_html__('Questions', 'event_espresso');
+		$this->display_admin_list_table_page_with_sidebar();
+	}
+
+
+	/**
+	 * _edit_question
+	 *
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _edit_question()
+	{
+		$ID = isset($this->_req_data['QST_ID']) && ! empty($this->_req_data['QST_ID'])
+			? absint($this->_req_data['QST_ID'])
+			: false;
+
+		switch ($this->_req_action) {
+			case 'add_question':
+				$this->_admin_page_title = esc_html__('Add Question', 'event_espresso');
+				break;
+			case 'edit_question':
+				$this->_admin_page_title = esc_html__('Edit Question', 'event_espresso');
+				break;
+			default:
+				$this->_admin_page_title = ucwords(str_replace('_', ' ', $this->_req_action));
+		}
+
+		// add PRC_ID to title if editing
+		$this->_admin_page_title =
+			$ID
+				? $this->_admin_page_title . ' # ' . $ID
+				: $this->_admin_page_title;
+		if ($ID) {
+			$question                 = $this->_question_model->get_one_by_ID($ID);
+			$additional_hidden_fields = ['QST_ID' => ['type' => 'hidden', 'value' => $ID]];
+			$this->_set_add_edit_form_tags('update_question', $additional_hidden_fields);
+		} else {
+			$question = EE_Question::new_instance();
+			$question->set_order_to_latest();
+			$this->_set_add_edit_form_tags('insert_question');
+		}
+		if ($question->system_ID() === EEM_Attendee::system_question_phone) {
+			$question_types = array_intersect_key(
+				$this->_question_model->allowed_question_types(),
+				array_flip(
+					[
+						EEM_Question::QST_type_text,
+						EEM_Question::QST_type_us_phone,
+					]
+				)
+			);
+		} else {
+			$question_types = $question->has_answers()
+				? $this->_question_model->question_types_in_same_category($question->type())
+				: $this->_question_model->allowed_question_types();
+		}
+		$this->_template_args['QST_ID']                     = $ID;
+		$this->_template_args['question']                   = $question;
+		$this->_template_args['question_types']             = $question_types;
+		$this->_template_args['max_max']                    =
+			$this->_question_model->absolute_max_for_system_question(
+				$question->system_ID()
+			);
+		$this->_template_args['question_type_descriptions'] = $this->_get_question_type_descriptions();
+		$this->_set_publish_post_box_vars('id', $ID);
+		$this->_template_args['admin_page_content'] = EEH_Template::display_template(
+			REGISTRATION_FORM_TEMPLATE_PATH . 'questions_main_meta_box.template.php',
+			$this->_template_args,
+			true
+		);
+
+		// the details template wrapper
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	/**
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _get_question_type_descriptions(): string
+	{
+		EE_Registry::instance()->load_helper('HTML');
+		$descriptions               = '';
+		$question_type_descriptions = $this->_question_model->question_descriptions();
+		foreach ($question_type_descriptions as $type => $question_type_description) {
+			if ($type == 'HTML_TEXTAREA') {
+				$html                      = new EE_Simple_HTML_Validation_Strategy();
+				$question_type_description .= sprintf(
+					esc_html__('%1$s(allowed tags: %2$s)', 'event_espresso'),
+					'<br/>',
+					$html->get_list_of_allowed_tags()
+				);
+			}
+			$descriptions .= EEH_HTML::p(
+				$question_type_description,
+				'question_type_description-' . $type,
+				'question_type_description description',
+				'display:none;'
+			);
+		}
+		return $descriptions;
+	}
+
+
+	/**
+	 * @param bool $new_question
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _insert_or_update_question(bool $new_question = true)
+	{
+		$set_column_values = $this->_set_column_values_for($this->_question_model);
+		if ($new_question) {
+			$question    = EE_Question::new_instance($set_column_values);
+			$action_desc = 'added';
+		} else {
+			$question = $this->_question_model->get_one_by_ID(
+				$this->request->getRequestParam('QST_ID', 0, DataType::INT)
+			);
+			foreach ($set_column_values as $field => $new_value) {
+				$question->set($field, $new_value);
+			}
+			$action_desc = 'updated';
+		}
+		$success = $question->save();
+		$ID      = $question->ID();
+		if ($ID && $question->should_have_question_options()) {
+			// save the related options
+			// trash removed options, save old ones
+			// get list of all options
+			$options          = $question->options();
+			$question_options = $this->request->getRequestParam('question_options', [], DataType::ARRAY);
+			$QSO_default      = $this->request->getRequestParam('QSO_default', null, DataType::INT);
+			if (! empty($options)) {
+				foreach ($options as $option_ID => $option) {
+					$option_req_index = $this->_get_option_req_data_index($option_ID);
+					if ($option_req_index !== false) {
+						$question_options[ $option_req_index ]['QSO_default'] = $option_req_index === $QSO_default;
+						$option->save($question_options[ $option_req_index ]);
+					} else {
+						// not found, remove it
+						$option->delete();
+					}
+				}
+			}
+			// save new related options
+			foreach ($question_options as $index => $option_req_data) {
+				// skip $index that is from our sample
+				if ($index === 'xxcountxx') {
+					continue;
+				}
+				// note we allow saving blank options.
+				if (empty($option_req_data['QSO_ID'])) {
+					// no ID! save it!
+					$new_option = EE_Question_Option::new_instance(
+						[
+							'QSO_value'   => $option_req_data['QSO_value'],
+							'QSO_desc'    => $option_req_data['QSO_desc'],
+							'QSO_default' => $index === $QSO_default,
+							'QSO_order'   => $option_req_data['QSO_order'],
+							'QST_ID'      => $question->ID(),
+						]
+					);
+					$new_option->save();
+				}
+			}
+		}
+
+		$success = apply_filters(
+			'FHEE__Registration_Form_Admin_Page___insert_or_update_question__success',
+			(int) $success,
+			$question,
+			$this
+		);
+
+		$query_args = ['action' => 'edit_question', 'QST_ID' => $ID];
+		if ($success !== 0) {
+			$msg = $new_question
+				? sprintf(
+					esc_html__('The %s has been created', 'event_espresso'),
+					$this->_question_model->item_name()
+				)
+				: sprintf(
+					esc_html__('The %s has been updated', 'event_espresso'),
+					$this->_question_model->item_name()
+				);
+			EE_Error::add_success($msg);
+		}
+
+		$this->_redirect_after_action(false, '', $action_desc, $query_args, true);
+	}
+
+
+	/**
+	 * Upon saving a question, there should be an array of 'question_options'. This array is index numerically, but not
+	 * by ID
+	 * (this is done because new question options don't have an ID, but we may want to add multiple simultaneously).
+	 * So, this function gets the index in that request data array called question_options. Returns FALSE if not found.
+	 *
+	 * @param int $ID of the question option to find
+	 * @return int index in question_options array if successful, FALSE if unsuccessful
+	 */
+	protected function _get_option_req_data_index(int $ID)
+	{
+		$req_data_for_question_options = $this->_req_data['question_options'];
+		foreach ($req_data_for_question_options as $num => $option_data) {
+			if (array_key_exists('QSO_ID', $option_data) && (int) $option_data['QSO_ID'] === $ID) {
+				return $num;
+			}
+		}
+		return false;
+	}
+
+
+
+
+	/* QUERIES */
+	/**
+	 * For internal use in getting all the query parameters
+	 * (because it's pretty well the same between question, question groups,
+	 * and for both when searching for trashed and untrashed ones)
+	 *
+	 * @param EEM_Base $model either EEM_Question or EEM_Question_Group
+	 * @param int      $per_page
+	 * @param int      $current_page
+	 * @return array model query params,
+	 * @see https://github.com/eventespresso/event-espresso-core/tree/master/docs/G--Model-System/model-query-params.md
+	 */
+	protected function get_query_params(EEM_Base $model, int $per_page = 10, int $current_page = 10): array
+	{
+		$query_params             = [];
+		$offset                   = ($current_page - 1) * $per_page;
+		$query_params['limit']    = [$offset, $per_page];
+
+		$order  = (isset($this->_req_data['order']) && ! empty($this->_req_data['order']))
+			? $this->_req_data['order']
+			: 'ASC';
+
+		$orderby_field = $model instanceof EEM_Question ? 'QST_ID' : 'QSG_order';
+
+		$field_to_order_by = empty($this->_req_data['orderby']) ? $orderby_field : $this->_req_data['orderby'];
+
+		$query_params['order_by'] = [$field_to_order_by => $order];
+
+		$search_string = array_key_exists('s', $this->_req_data) ? $this->_req_data['s'] : null;
+		if (! empty($search_string)) {
+			if ($model instanceof EEM_Question_Group) {
+				$query_params[0] = [
+					'OR' => [
+						'QSG_name' => ['LIKE', "%$search_string%"],
+						'QSG_desc' => ['LIKE', "%$search_string%"],
+					],
+				];
+			} else {
+				$query_params[0] = [
+					'QST_display_text' => ['LIKE', "%$search_string%"],
+				];
+			}
+		}
+
+		// capability checks (just leaving this commented out for reference because
+		// it illustrates some complicated query params that could be useful when fully implemented)
+		/*if ( $model instanceof EEM_Question_Group ) {
             if (
                 ! $this->capabilities->current_user_can(
                     'edit_others_question_groups',
@@ -742,59 +742,59 @@ 
             }
         }/**/
 
-        return $query_params;
-    }
-
-
-    /**
-     * @param int  $per_page
-     * @param int  $current_page
-     * @param bool $count
-     * @return EE_Question[]|int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function get_questions(int $per_page = 10, int $current_page = 1, bool $count = false)
-    {
-        $query_params = $this->get_query_params($this->_question_model, $per_page, $current_page);
-        if ($count) {
-            $where = isset($query_params[0]) ? [$query_params[0]] : [];
-            return $this->_question_model->count($where);
-        }
-        return $this->_question_model->get_all($query_params);
-    }
-
-
-    /**
-     * @param int  $per_page
-     * @param int  $current_page
-     * @param bool $count
-     * @return EE_Soft_Delete_Base_Class[]|int
-     * @throws EE_Error
-     */
-    public function get_trashed_questions(int $per_page, int $current_page = 1, bool $count = false)
-    {
-        $query_params = $this->get_query_params($this->_question_model, $per_page, $current_page);
-        $where        = isset($query_params[0]) ? [$query_params[0]] : [];
-        return $count
-            ? $this->_question_model->count_deleted($where)
-            : $this->_question_model->get_all_deleted($query_params);
-    }
-
-
-    /**
-     * @param int  $per_page
-     * @param int  $current_page
-     * @param bool $count
-     * @return EE_Question_Group[]|int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function get_question_groups(int $per_page, int $current_page = 1, bool $count = false)
-    {
-        // note: this a subclass of EEM_Soft_Delete_Base, so this is actually only getting non-trashed items
-        return $this->_question_group_model->get_all(
-            $this->get_query_params($this->_question_group_model, $per_page, $current_page)
-        );
-    }
+		return $query_params;
+	}
+
+
+	/**
+	 * @param int  $per_page
+	 * @param int  $current_page
+	 * @param bool $count
+	 * @return EE_Question[]|int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function get_questions(int $per_page = 10, int $current_page = 1, bool $count = false)
+	{
+		$query_params = $this->get_query_params($this->_question_model, $per_page, $current_page);
+		if ($count) {
+			$where = isset($query_params[0]) ? [$query_params[0]] : [];
+			return $this->_question_model->count($where);
+		}
+		return $this->_question_model->get_all($query_params);
+	}
+
+
+	/**
+	 * @param int  $per_page
+	 * @param int  $current_page
+	 * @param bool $count
+	 * @return EE_Soft_Delete_Base_Class[]|int
+	 * @throws EE_Error
+	 */
+	public function get_trashed_questions(int $per_page, int $current_page = 1, bool $count = false)
+	{
+		$query_params = $this->get_query_params($this->_question_model, $per_page, $current_page);
+		$where        = isset($query_params[0]) ? [$query_params[0]] : [];
+		return $count
+			? $this->_question_model->count_deleted($where)
+			: $this->_question_model->get_all_deleted($query_params);
+	}
+
+
+	/**
+	 * @param int  $per_page
+	 * @param int  $current_page
+	 * @param bool $count
+	 * @return EE_Question_Group[]|int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function get_question_groups(int $per_page, int $current_page = 1, bool $count = false)
+	{
+		// note: this a subclass of EEM_Soft_Delete_Base, so this is actually only getting non-trashed items
+		return $this->_question_group_model->get_all(
+			$this->get_query_params($this->_question_group_model, $per_page, $current_page)
+		);
+	}
 }

Spacing +28 added lines, -28 removed lines

@@ -40,8 +40,8 @@ 
      */
     public function __construct($routing = true)
     {
-        require_once(EE_MODELS . 'EEM_Question.model.php');
-        require_once(EE_MODELS . 'EEM_Question_Group.model.php');
+        require_once(EE_MODELS.'EEM_Question.model.php');
+        require_once(EE_MODELS.'EEM_Question_Group.model.php');
         $this->_question_model       = EEM_Question::instance();
         $this->_question_group_model = EEM_Question_Group::instance();
         parent::__construct($routing);
@@ -81,7 +81,7 @@ 
      */
     protected function _set_page_routes()
     {
-        $qst_id             =
+        $qst_id =
             ! empty($this->_req_data['QST_ID'])
                 ? $this->_req_data['QST_ID']
                 : 0;
@@ -218,7 +218,7 @@ 
     {
         wp_register_style(
             'espresso_registration',
-            REGISTRATION_FORM_ASSETS_URL . 'espresso_registration_form_admin.css',
+            REGISTRATION_FORM_ASSETS_URL.'espresso_registration_form_admin.css',
             [EspressoLegacyAdminAssetManager::CSS_HANDLE_EE_ADMIN],
             EVENT_ESPRESSO_VERSION
         );
@@ -266,7 +266,7 @@ 
         $this->load_scripts_styles_forms();
         wp_register_script(
             'espresso_registration_form_single',
-            REGISTRATION_FORM_ASSETS_URL . 'espresso_registration_form_admin.js',
+            REGISTRATION_FORM_ASSETS_URL.'espresso_registration_form_admin.js',
             ['jquery-ui-sortable'],
             EVENT_ESPRESSO_VERSION,
             true
@@ -285,7 +285,7 @@ 
 
     public function recaptcha_info_help_tab()
     {
-        EEH_Template::display_template(REGISTRATION_FORM_TEMPLATE_PATH . 'recaptcha_info_help_tab.template.php');
+        EEH_Template::display_template(REGISTRATION_FORM_TEMPLATE_PATH.'recaptcha_info_help_tab.template.php');
     }
 
 
@@ -333,16 +333,16 @@ 
     {
         $this->_admin_page_title              = esc_html__('Question Groups (Preview)', 'event_espresso');
         $this->_template_args['preview_img']  =
-            '<img src="' . REGISTRATION_FORM_ASSETS_URL . 'caf_reg_form_preview.jpg" alt="'
+            '<img src="'.REGISTRATION_FORM_ASSETS_URL.'caf_reg_form_preview.jpg" alt="'
             . esc_attr__(
                 'Preview Question Groups Overview List Table screenshot',
                 'event_espresso'
-            ) . '" />';
+            ).'" />';
         $this->_template_args['preview_text'] = '<strong>'
             . esc_html__(
                 'Question Groups 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. With the Question Groups feature you are able to create new question groups, edit existing question groups, and create and edit new questions and add them to question groups.',
                 'event_espresso'
-            ) . '</strong>';
+            ).'</strong>';
         $this->display_admin_caf_preview_page('question_groups_tab');
     }
 
@@ -380,39 +380,39 @@ 
             $this->request->unSetRequestParam('QST_max', true);
         }
         foreach ($model->field_settings() as $fieldName => $settings) {
-            switch($fieldName) {
+            switch ($fieldName) {
                 case 'QSG_identifier':
                     // basically if QSG_identifier is empty or not set
-                    if (! $this->request->getRequestParam('QSG_identifier', '', DataType::STRING)) {
+                    if ( ! $this->request->getRequestParam('QSG_identifier', '', DataType::STRING)) {
                         $QSG_name                    = $this->request->getRequestParam('QSG_name', '', DataType::STRING);
-                        $column_values[ $fieldName ] = sanitize_title($QSG_name) . '-' . uniqid('', true);
+                        $column_values[$fieldName] = sanitize_title($QSG_name).'-'.uniqid('', true);
                     }
                     break;
 
                 case 'QST_admin_label':
-                    if (! $this->request->getRequestParam('QST_admin_label', '', DataType::STRING)) {
+                    if ( ! $this->request->getRequestParam('QST_admin_label', '', DataType::STRING)) {
                         // the admin label is blank, use a slug version of the question text
                         $QST_text                    = $this->request->getRequestParam('QST_display_text', '', DataType::STRING);
-                        $column_values[ $fieldName ] = sanitize_title(wp_trim_words($QST_text, 10));
+                        $column_values[$fieldName] = sanitize_title(wp_trim_words($QST_text, 10));
                     }
                     break;
 
                 case 'QST_admin_only':
-                    if (! $QST_admin_only) {
-                        $column_values[ $fieldName ] = false;
+                    if ( ! $QST_admin_only) {
+                        $column_values[$fieldName] = false;
                     }
                     break;
 
                 case 'QST_max':
                     $qst_system = $this->_question_model->get_var(
-                        [ [ 'QST_ID' => $QST_ID ] ],
+                        [['QST_ID' => $QST_ID]],
                         'QST_system'
                     );
 
                     $max_max = $this->_question_model->absolute_max_for_system_question((string) $qst_system);
                     $QST_max = $this->request->getRequestParam('QST_max', 0, DataType::INT);
                     if ($QST_max === 0 || $QST_max > $max_max) {
-                        $column_values[ $fieldName ] = $max_max;
+                        $column_values[$fieldName] = $max_max;
                     }
                     break;
 
@@ -421,7 +421,7 @@ 
                     if ($this->request->requestParamIsSet($fieldName)) {
                         // convert the schema type to the appropriate data type
                         $schema_type = DataType::convertModelFieldSchemaType($settings->getSchemaType());
-                        $column_values[ $fieldName ] = $this->request->getRequestParam($fieldName, null, $schema_type);
+                        $column_values[$fieldName] = $this->request->getRequestParam($fieldName, null, $schema_type);
                     }
             }
         }
@@ -468,7 +468,7 @@ 
         // add PRC_ID to title if editing
         $this->_admin_page_title =
             $ID
-                ? $this->_admin_page_title . ' # ' . $ID
+                ? $this->_admin_page_title.' # '.$ID
                 : $this->_admin_page_title;
         if ($ID) {
             $question                 = $this->_question_model->get_one_by_ID($ID);
@@ -504,7 +504,7 @@ 
         $this->_template_args['question_type_descriptions'] = $this->_get_question_type_descriptions();
         $this->_set_publish_post_box_vars('id', $ID);
         $this->_template_args['admin_page_content'] = EEH_Template::display_template(
-            REGISTRATION_FORM_TEMPLATE_PATH . 'questions_main_meta_box.template.php',
+            REGISTRATION_FORM_TEMPLATE_PATH.'questions_main_meta_box.template.php',
             $this->_template_args,
             true
         );
@@ -526,7 +526,7 @@ 
         $question_type_descriptions = $this->_question_model->question_descriptions();
         foreach ($question_type_descriptions as $type => $question_type_description) {
             if ($type == 'HTML_TEXTAREA') {
-                $html                      = new EE_Simple_HTML_Validation_Strategy();
+                $html = new EE_Simple_HTML_Validation_Strategy();
                 $question_type_description .= sprintf(
                     esc_html__('%1$s(allowed tags: %2$s)', 'event_espresso'),
                     '<br/>',
@@ -535,7 +535,7 @@ 
             }
             $descriptions .= EEH_HTML::p(
                 $question_type_description,
-                'question_type_description-' . $type,
+                'question_type_description-'.$type,
                 'question_type_description description',
                 'display:none;'
             );
@@ -573,12 +573,12 @@ 
             $options          = $question->options();
             $question_options = $this->request->getRequestParam('question_options', [], DataType::ARRAY);
             $QSO_default      = $this->request->getRequestParam('QSO_default', null, DataType::INT);
-            if (! empty($options)) {
+            if ( ! empty($options)) {
                 foreach ($options as $option_ID => $option) {
                     $option_req_index = $this->_get_option_req_data_index($option_ID);
                     if ($option_req_index !== false) {
-                        $question_options[ $option_req_index ]['QSO_default'] = $option_req_index === $QSO_default;
-                        $option->save($question_options[ $option_req_index ]);
+                        $question_options[$option_req_index]['QSO_default'] = $option_req_index === $QSO_default;
+                        $option->save($question_options[$option_req_index]);
                     } else {
                         // not found, remove it
                         $option->delete();
@@ -674,7 +674,7 @@ 
         $offset                   = ($current_page - 1) * $per_page;
         $query_params['limit']    = [$offset, $per_page];
 
-        $order  = (isset($this->_req_data['order']) && ! empty($this->_req_data['order']))
+        $order = (isset($this->_req_data['order']) && ! empty($this->_req_data['order']))
             ? $this->_req_data['order']
             : 'ASC';
 
@@ -685,7 +685,7 @@ 
         $query_params['order_by'] = [$field_to_order_by => $order];
 
         $search_string = array_key_exists('s', $this->_req_data) ? $this->_req_data['s'] : null;
-        if (! empty($search_string)) {
+        if ( ! empty($search_string)) {
             if ($model instanceof EEM_Question_Group) {
                 $query_params[0] = [
                     'OR' => [

admin_pages/registration_form/templates/questions_main_meta_box.template.php

Indentation +195 added lines, -195 removed lines

@@ -13,48 +13,48 @@ 
  */
 
 try {
-    // the following are already escaped
-    echo wp_kses(
-        EEH_Form_Fields::hidden_input('QST_system', $question->system_ID()),
-        AllowedTags::getWithFormTags()
-    );
-    echo wp_kses(
-        EEH_Form_Fields::hidden_input('QST_wp_user', $question->wp_user()),
-        AllowedTags::getWithFormTags()
-    );
-    echo wp_kses(
-        EEH_Form_Fields::hidden_input('QST_deleted', $question->deleted()),
-        AllowedTags::getWithFormTags()
-    );
+	// the following are already escaped
+	echo wp_kses(
+		EEH_Form_Fields::hidden_input('QST_system', $question->system_ID()),
+		AllowedTags::getWithFormTags()
+	);
+	echo wp_kses(
+		EEH_Form_Fields::hidden_input('QST_wp_user', $question->wp_user()),
+		AllowedTags::getWithFormTags()
+	);
+	echo wp_kses(
+		EEH_Form_Fields::hidden_input('QST_deleted', $question->deleted()),
+		AllowedTags::getWithFormTags()
+	);
 
-    $QST_system = $question->system_ID();
-    $fields     = $question->get_model()->field_settings();
+	$QST_system = $question->system_ID();
+	$fields     = $question->get_model()->field_settings();
 
-    do_action('AHEE__questions_main_meta_box__template__before_admin_page_content', $question);
+	do_action('AHEE__questions_main_meta_box__template__before_admin_page_content', $question);
 
-    // does question have any answers? cause if it does then we have to disable type
-    $has_answers = $question->has_answers();
-    global $allowedposttags;
-    $info_box = '';
-    if ($QST_system === 'country') {
-        $info_box = EEH_HTML::div(
-            EEH_HTML::h3(
-                '<span class="dashicons dashicons-info"></span> '
-                . esc_html__('Did you know...', 'event_espresso'),
-                '',
-                'ee-status--info'
-            ) .
-            EEH_HTML::p(
-                esc_html__(
-                    'If you add a State/Province Select input immediately after this Country Select input when building your registration form, then the State/Province Select input options will change to correspond with the choice made in this input. So for example, choosing "United States" in this Country Select input will populate the State/Province Select input with just the state options for the United States.',
-                    'event_espresso'
-                )
-            ),
-            '',
-            'ee-info-box'
-        );
-    }
-    do_action('AHEE__questions_main_meta_box__template__inner_admin_page_content', $question);
+	// does question have any answers? cause if it does then we have to disable type
+	$has_answers = $question->has_answers();
+	global $allowedposttags;
+	$info_box = '';
+	if ($QST_system === 'country') {
+		$info_box = EEH_HTML::div(
+			EEH_HTML::h3(
+				'<span class="dashicons dashicons-info"></span> '
+				. esc_html__('Did you know...', 'event_espresso'),
+				'',
+				'ee-status--info'
+			) .
+			EEH_HTML::p(
+				esc_html__(
+					'If you add a State/Province Select input immediately after this Country Select input when building your registration form, then the State/Province Select input options will change to correspond with the choice made in this input. So for example, choosing "United States" in this Country Select input will populate the State/Province Select input with just the state options for the United States.',
+					'event_espresso'
+				)
+			),
+			'',
+			'ee-info-box'
+		);
+	}
+	do_action('AHEE__questions_main_meta_box__template__inner_admin_page_content', $question);
 ?>
 
 <div class="padding">
@@ -67,8 +67,8 @@ 
                     <label for="QST_display_text">
                         <?php echo wp_kses($fields['QST_display_text']->get_nicename(), AllowedTags::getAllowedTags()); ?>
                         <?php echo wp_kses(
-                            EEH_Template::get_help_tab_link('question_text_info'), AllowedTags::getAllowedTags()
-                        ); ?>
+							EEH_Template::get_help_tab_link('question_text_info'), AllowedTags::getAllowedTags()
+						); ?>
                             <span class="ee-required-text">*</span>
                     </label>
                 </th>
@@ -84,16 +84,16 @@ 
             </tr>
 
             <?php
-            $id            = ! empty($QST_system) ? '_disabled' : '';
-            $disabled_attr = ! empty($QST_system) ? 'disabled' : '';
-            ?>
+			$id            = ! empty($QST_system) ? '_disabled' : '';
+			$disabled_attr = ! empty($QST_system) ? 'disabled' : '';
+			?>
             <tr>
                 <th>
                     <label for="QST_admin_label<?php esc_attr_e($id); ?>">
                         <?php echo wp_kses($fields['QST_admin_label']->get_nicename(), AllowedTags::getAllowedTags()); ?>
                         <?php echo wp_kses(
-                            EEH_Template::get_help_tab_link('question_label_info'), AllowedTags::getAllowedTags()
-                        ); ?>
+							EEH_Template::get_help_tab_link('question_label_info'), AllowedTags::getAllowedTags()
+						); ?>
                     </label>
                 </th>
                 <td>
@@ -128,11 +128,11 @@ 
             </tr>
 
             <?php
-            $id            = ! empty($QST_system) ? '_disabled' : '';
-            $disabled_attr = ! empty($QST_system) ? 'disabled' : '';
-            $admin_only    = $question->get('QST_admin_only');
-            $checked       = ! empty($admin_only) ? ' checked' : '';
-            ?>
+			$id            = ! empty($QST_system) ? '_disabled' : '';
+			$disabled_attr = ! empty($QST_system) ? 'disabled' : '';
+			$admin_only    = $question->get('QST_admin_only');
+			$checked       = ! empty($admin_only) ? ' checked' : '';
+			?>
             <tr>
                 <th>
                     <label for="QST_admin_only<?php esc_attr_e($id); ?>">
@@ -147,18 +147,18 @@ 
                            type="checkbox"
                            value="1"
                         <?php
-                        esc_attr_e($disabled_attr);
-                        esc_attr_e($checked);
-                        ?>
+						esc_attr_e($disabled_attr);
+						esc_attr_e($checked);
+						?>
                     />
                     <br>
                         <?php
-                        if (! empty($QST_system)) { ?>
+						if (! empty($QST_system)) { ?>
                             <p class="description ee-system-question" >
                                 <?php esc_html_e(
-                                    'System question! This field cannot be changed.',
-                                    'event_espresso'
-                                ); ?>
+									'System question! This field cannot be changed.',
+									'event_espresso'
+								); ?>
                             </p>
                         <?php } ?>
                 </td>
@@ -173,40 +173,40 @@ 
                 </th>
                 <td>
                     <?php
-                    $disabled = ! empty($QST_system) && $QST_system !== EEM_Attendee::system_question_phone;
-                    $id       = $disabled ? '_disabled' : '';
+					$disabled = ! empty($QST_system) && $QST_system !== EEM_Attendee::system_question_phone;
+					$id       = $disabled ? '_disabled' : '';
 
-                    if (empty($QST_system) || $QST_system !== EEM_Attendee::system_question_email_confirm) {
-                        unset($question_types[ EEM_Question::QST_type_email_confirm ]);
-                    }
+					if (empty($QST_system) || $QST_system !== EEM_Attendee::system_question_email_confirm) {
+						unset($question_types[ EEM_Question::QST_type_email_confirm ]);
+					}
 
-                    echo wp_kses(
-                        EEH_Form_Fields::select_input(
-                            'QST_type' . $id,
-                            $question_types,
-                            $question->type(),
-                            'id="QST_type' . $id . '" ' . $disabled_attr
-                        ),
-                        AllowedTags::getWithFormTags()
-                    );
-                    if ($disabled) { ?>
+					echo wp_kses(
+						EEH_Form_Fields::select_input(
+							'QST_type' . $id,
+							$question_types,
+							$question->type(),
+							'id="QST_type' . $id . '" ' . $disabled_attr
+						),
+						AllowedTags::getWithFormTags()
+					);
+					if ($disabled) { ?>
                         <input id='QST_type'
                                name="QST_type"
                                type="hidden"
                                value="<?php esc_attr_e($question->type()); ?>"
                         />
                         <?php
-                        $explanatory_text = esc_html__(
-                            'System question! This field cannot be changed.',
-                            'event_espresso'
-                        );
-                    } else {
-                        $explanatory_text = esc_html__(
-                            'Because there are currently answers for this question in the database, your options to change the question type have been limited to similar question-types.',
-                            'event_espresso'
-                        );
-                    }
-                    if ($disabled || $has_answers) { ?>
+						$explanatory_text = esc_html__(
+							'System question! This field cannot be changed.',
+							'event_espresso'
+						);
+					} else {
+						$explanatory_text = esc_html__(
+							'Because there are currently answers for this question in the database, your options to change the question type have been limited to similar question-types.',
+							'event_espresso'
+						);
+					}
+					if ($disabled || $has_answers) { ?>
                         <p class="description ee-system-question" >
                                 <?php echo esc_html($explanatory_text); ?>
                         </p>
@@ -236,19 +236,19 @@ 
                     />
                     <p class="description">
                         <?php esc_html_e(
-                            'Maximum number of characters allowed when answering this question',
-                            'event_espresso'
-                        ); ?>
+							'Maximum number of characters allowed when answering this question',
+							'event_espresso'
+						); ?>
                     </p>
                     <?php if ($QST_system) { ?>
                     <p class="description ee-system-question" >
                         <?php printf(
-                            esc_html__(
-                                'System question! The maximum number of characters that can be used for this question is %1$s',
-                                'event_espresso'
-                            ),
-                            $max_max
-                        ); ?>
+							esc_html__(
+								'System question! The maximum number of characters that can be used for this question is %1$s',
+								'event_espresso'
+							),
+							$max_max
+						); ?>
                     </p>
                     <?php } ?>
                 </td>
@@ -274,9 +274,9 @@ 
                                         <?php esc_html_e('Description', 'event_espresso') ?>
                                         </label>
                                         <span class="tiny-text"><?php esc_html_e(
-                                                '(optional, only shown on registration form)',
-                                                'event_espresso'
-                                            ) ?></span>
+												'(optional, only shown on registration form)',
+												'event_espresso'
+											) ?></span>
                                     </th>
                                     <th class="option-default-header">
                                         <label>
@@ -334,24 +334,24 @@ 
                                         </a>
                                         <a class="button button--icon-only sortable-drag-handle ee-aria-tooltip"
                                            aria-label="<?php esc_html_e(
-                                               'click and drag to change the order of this option',
-                                               'event_espresso'
-                                           ) ?>"
+											   'click and drag to change the order of this option',
+											   'event_espresso'
+										   ) ?>"
                                         >
                                             <span class='dashicons dashicons-image-flip-vertical '></span>
                                         </a>
                                     </td>
                                 </tr>
                                 <?php
-                                $count            = 0;
-                                $hasDefault       = false;
-                                $question_options = $question->options();
-                                if (! empty($question_options)) {
-                                    foreach ($question_options as $option_id => $option) {
-                                        $disabled_attr = $has_answers || $option->get('QSO_system')
-                                            ? 'disabled'
-                                            : '';
-                                        ?>
+								$count            = 0;
+								$hasDefault       = false;
+								$question_options = $question->options();
+								if (! empty($question_options)) {
+									foreach ($question_options as $option_id => $option) {
+										$disabled_attr = $has_answers || $option->get('QSO_system')
+											? 'disabled'
+											: '';
+										?>
                                         <tr class="question-option ee-options-sortable">
                                             <td class="option-value-cell">
                                                 <label class='screen-reader-text'
@@ -396,9 +396,9 @@ 
                                                     <?php esc_html_e('Check if this is the default value', 'event_espresso') ?>
                                                 </label>
                                                 <?php
-                                                $isDefault = $option->isDefault() ? ' checked' : '';
-                                                $hasDefault = $isDefault ? true : $hasDefault;
-                                                ?>
+												$isDefault = $option->isDefault() ? ' checked' : '';
+												$hasDefault = $isDefault ? true : $hasDefault;
+												?>
                                                 <input type="radio"
                                                        class="option-default"
                                                        id="question_options-<?php esc_attr_e($count); ?>-QSO_default"
@@ -411,44 +411,44 @@ 
                                             <?php if (! $option->system()) { ?>
                                                 <a class='button button--icon-only remove-option remove-item ee-aria-tooltip'
                                                    aria-label="<?php esc_html_e(
-                                                       'click to delete this option',
-                                                       'event_espresso'
-                                                   ) ?>"
+													   'click to delete this option',
+													   'event_espresso'
+												   ) ?>"
                                                 >
                                                     <span class='dashicons clickable dashicons-post-trash'></span>
                                                 </a>
                                             <?php } ?>
                                                 <a class='button button--icon-only sortable-drag-handle ee-aria-tooltip'
                                                    aria-label="<?php esc_html_e(
-                                                       'click and drag to change the order of this option',
-                                                       'event_espresso'
-                                                   ) ?>"
+													   'click and drag to change the order of this option',
+													   'event_espresso'
+												   ) ?>"
                                                 >
                                                     <span class='dashicons dashicons-image-flip-vertical '></span>
                                                 </a>
                                                 <?php
-                                                echo wp_kses(
-                                                    EEH_Form_Fields::hidden_input(
-                                                        "question_options[$count][QST_ID])",
-                                                        $option->question_ID()
-                                                    ),
-                                                    AllowedTags::getWithFormTags()
-                                                );
-                                                echo wp_kses(
-                                                    EEH_Form_Fields::hidden_input(
-                                                        "question_options[$count][QSO_ID])",
-                                                        $option->ID()
-                                                    ),
-                                                    AllowedTags::getWithFormTags()
-                                                );
-                                                $count++;
-                                                ?>
+												echo wp_kses(
+													EEH_Form_Fields::hidden_input(
+														"question_options[$count][QST_ID])",
+														$option->question_ID()
+													),
+													AllowedTags::getWithFormTags()
+												);
+												echo wp_kses(
+													EEH_Form_Fields::hidden_input(
+														"question_options[$count][QSO_ID])",
+														$option->ID()
+													),
+													AllowedTags::getWithFormTags()
+												);
+												$count++;
+												?>
                                             </td>
                                         </tr>
                                         <?php
-                                    }
-                                } else {
-                                    ?>
+									}
+								} else {
+									?>
                                     <tr class="question-option ee-options-sortable">
                                         <td class="option-value-cell">
                                             <label class='screen-reader-text' for='question_options[0][QSO_value]'
@@ -491,21 +491,21 @@ 
                                         </td>
                                         <td class="option-actions-cell">
                                             <?php echo wp_kses(
-                                                EEH_Form_Fields::hidden_input(
-                                                    "question_options_count",
-                                                    $count
-                                                ),
-                                                AllowedTags::getWithFormTags()
-                                            ); ?>
+												EEH_Form_Fields::hidden_input(
+													"question_options_count",
+													$count
+												),
+												AllowedTags::getWithFormTags()
+											); ?>
                                         </td>
                                     </tr>
                                     <?php
-                                }
-                                if (
-                                    $question->type() === EEM_Question::QST_type_checkbox
-                                    || $question->type() === EEM_Question::QST_type_radio
-                                ) :
-                                ?>
+								}
+								if (
+									$question->type() === EEM_Question::QST_type_checkbox
+									|| $question->type() === EEM_Question::QST_type_radio
+								) :
+								?>
                                 <tr class="question-option">
                                     <td class="option-value-cell">
                                     </td>
@@ -534,34 +534,34 @@ 
                                 <?php esc_html_e('Add Another Answer Option', 'event_espresso'); ?>
                             </a>
                             <?php echo wp_kses(
-                                EEH_Form_Fields::hidden_input(
-                                    "question_options_count",
-                                    $count
-                                ),
-                                AllowedTags::getWithFormTags()
-                            ); ?>
+								EEH_Form_Fields::hidden_input(
+									"question_options_count",
+									$count
+								),
+								AllowedTags::getWithFormTags()
+							); ?>
                         </div>
                         <br/>
 
                         <p class="description">
                             <?php esc_html_e(
-                                'Answer Options are the choices that you give people to select from for RADIO_BTN, CHECKBOX or DROPDOWN questions. The Value is a simple key that will be saved to the database and the description is optional. Note that values CANNOT contain any HTML, but descriptions can.',
-                                'event_espresso'
-                            ) ?>
+								'Answer Options are the choices that you give people to select from for RADIO_BTN, CHECKBOX or DROPDOWN questions. The Value is a simple key that will be saved to the database and the description is optional. Note that values CANNOT contain any HTML, but descriptions can.',
+								'event_espresso'
+							) ?>
                             <br />
                             <strong>
                                 <?php esc_html_e(
-                                    'The Default Answer Option will be automatically selected when the registration form is initially displayed, unless "no default value" is selected.',
-                                    'event_espresso'
-                                ) ?>
+									'The Default Answer Option will be automatically selected when the registration form is initially displayed, unless "no default value" is selected.',
+									'event_espresso'
+								) ?>
                             </strong>
                         </p>
                         <?php if ($has_answers) : ?>
                             <p class="description ee-system-question">
                                 <?php esc_html_e(
-                                    'Answer values that are not editable are this way because there are registrations in the database that have answers for this question.  If you need to correct a mistake, or edit an existing option value, then trash the existing one and create a new option with the changes.  This will ensure that the existing registrations that chose the original answer will preserve that answer.',
-                                    'event_espresso'
-                                ); ?>
+									'Answer values that are not editable are this way because there are registrations in the database that have answers for this question.  If you need to correct a mistake, or edit an existing option value, then trash the existing one and create a new option with the changes.  This will ensure that the existing registrations that chose the original answer will preserve that answer.',
+									'event_espresso'
+								); ?>
                             </p>
                         <?php endif; ?>
                     </td>
@@ -576,44 +576,44 @@ 
                 </th>
                 <td>
                     <?php
-                    $system_required   = ['fname', 'email'];
-                    $disabled_attr     = in_array($QST_system, $system_required) ? ' disabled' : '';
-                    $required_on       = $question->get('QST_admin_only');
-                    $show_required_class = $admin_only && $required_on ? '' : ' hidden';
-                    $disabled_attr     = $required_on || ! empty($disabled_attr) ? ' disabled' : '';
-                    $id                =
-                        ! empty($disabled_attr) && in_array($QST_system, $system_required) ? '_disabled' : '';
-                    $requiredOptions   = [
-                        ['text' => esc_html__('Optional', 'event_espresso'), 'id' => 0],
-                        ['text' => esc_html__('Required', 'event_espresso'), 'id' => 1],
-                    ];
-                    echo wp_kses(
-                        EEH_Form_Fields::select_input(
-                            'QST_required' . $id,
-                            $requiredOptions,
-                            $question->required(),
-                            'id="QST_required' . $id . '"' . $disabled_attr,
-                            'ee-input-width--small'
-                        ),
-                        AllowedTags::getWithFormTags()
-                    );
-                    ?>
+					$system_required   = ['fname', 'email'];
+					$disabled_attr     = in_array($QST_system, $system_required) ? ' disabled' : '';
+					$required_on       = $question->get('QST_admin_only');
+					$show_required_class = $admin_only && $required_on ? '' : ' hidden';
+					$disabled_attr     = $required_on || ! empty($disabled_attr) ? ' disabled' : '';
+					$id                =
+						! empty($disabled_attr) && in_array($QST_system, $system_required) ? '_disabled' : '';
+					$requiredOptions   = [
+						['text' => esc_html__('Optional', 'event_espresso'), 'id' => 0],
+						['text' => esc_html__('Required', 'event_espresso'), 'id' => 1],
+					];
+					echo wp_kses(
+						EEH_Form_Fields::select_input(
+							'QST_required' . $id,
+							$requiredOptions,
+							$question->required(),
+							'id="QST_required' . $id . '"' . $disabled_attr,
+							'ee-input-width--small'
+						),
+						AllowedTags::getWithFormTags()
+					);
+					?>
                     <p id="required_toggled_on"
                        class="description<?php esc_attr_e($show_required_class); ?>"
                     >
                         <?php esc_html_e(
-                            'Required is set to optional, and this field is disabled, because the question is Admin-Only.',
-                            'event_espresso'
-                        ) ?>
+							'Required is set to optional, and this field is disabled, because the question is Admin-Only.',
+							'event_espresso'
+						) ?>
                     </p>
                     <p id="required_toggled_off"
                        class="description ee-system-question"
                        style="color:#D54E21; display: none;"
                     >
                             <?php esc_html_e(
-                                'Required option field is no longer disabled because the question is not Admin-Only',
-                                'event_espresso'
-                            ) ?>
+								'Required option field is no longer disabled because the question is not Admin-Only',
+								'event_espresso'
+							) ?>
                     </p>
                     <?php if (! empty($disabled_attr) && in_array($QST_system, $system_required)) { ?>
                         <input id="QST_required"
@@ -647,8 +647,8 @@ 
                 </td>
             </tr>
             <?php
-            do_action('AHEE__questions_main_meta_box__template__after_table_form_table', $question);
-            ?>
+			do_action('AHEE__questions_main_meta_box__template__after_table_form_table', $question);
+			?>
         </tbody>
     </table>
 
@@ -656,7 +656,7 @@ 
 </div>
 
     <?php
-    do_action('AHEE__questions_main_meta_box__template__after_admin_page_content', $question);
+	do_action('AHEE__questions_main_meta_box__template__after_admin_page_content', $question);
 } catch (Exception $e) {
-    EE_Error::add_error($e->getMessage(), __FILE__, __LINE__, __METHOD__);
+	EE_Error::add_error($e->getMessage(), __FILE__, __LINE__, __METHOD__);
 }

Spacing +13 added lines, -13 removed lines

@@ -43,7 +43,7 @@ 
                 . esc_html__('Did you know...', 'event_espresso'),
                 '',
                 'ee-status--info'
-            ) .
+            ).
             EEH_HTML::p(
                 esc_html__(
                     'If you add a State/Province Select input immediately after this Country Select input when building your registration form, then the State/Province Select input options will change to correspond with the choice made in this input. So for example, choosing "United States" in this Country Select input will populate the State/Province Select input with just the state options for the United States.',
@@ -104,7 +104,7 @@ 
                            value="<?php esc_attr_e($question->get_f('QST_admin_label')); ?>"
                            <?php esc_attr_e($disabled_attr); ?>
                     />
-                    <?php if (! empty($QST_system)) { ?>
+                    <?php if ( ! empty($QST_system)) { ?>
                         <input class="ee-input-width--reg"
                                id='QST_admin_label'
                                name="QST_admin_label"
@@ -113,7 +113,7 @@ 
                         />
                     <?php } ?>
                     <br>
-                    <?php if (! empty($QST_system)) { ?>
+                    <?php if ( ! empty($QST_system)) { ?>
                         <p class="description ee-system-question" >
                             <?php esc_html_e('System question! This field cannot be changed.', 'event_espresso') ?>
                         </p>
@@ -153,7 +153,7 @@ 
                     />
                     <br>
                         <?php
-                        if (! empty($QST_system)) { ?>
+                        if ( ! empty($QST_system)) { ?>
                             <p class="description ee-system-question" >
                                 <?php esc_html_e(
                                     'System question! This field cannot be changed.',
@@ -177,15 +177,15 @@ 
                     $id       = $disabled ? '_disabled' : '';
 
                     if (empty($QST_system) || $QST_system !== EEM_Attendee::system_question_email_confirm) {
-                        unset($question_types[ EEM_Question::QST_type_email_confirm ]);
+                        unset($question_types[EEM_Question::QST_type_email_confirm]);
                     }
 
                     echo wp_kses(
                         EEH_Form_Fields::select_input(
-                            'QST_type' . $id,
+                            'QST_type'.$id,
                             $question_types,
                             $question->type(),
-                            'id="QST_type' . $id . '" ' . $disabled_attr
+                            'id="QST_type'.$id.'" '.$disabled_attr
                         ),
                         AllowedTags::getWithFormTags()
                     );
@@ -226,7 +226,7 @@ 
                     <input id="QST_max<?php esc_attr_e($id); ?>"
                         class="ee-input-width--tiny"
                     <?php if ($max_max !== EE_INF) :?>
-                        max="<?php esc_attr_e($max_max);?>"
+                        max="<?php esc_attr_e($max_max); ?>"
                     <?php  endif; ?>
                         min="1"
                         name="QST_max"
@@ -346,7 +346,7 @@ 
                                 $count            = 0;
                                 $hasDefault       = false;
                                 $question_options = $question->options();
-                                if (! empty($question_options)) {
+                                if ( ! empty($question_options)) {
                                     foreach ($question_options as $option_id => $option) {
                                         $disabled_attr = $has_answers || $option->get('QSO_system')
                                             ? 'disabled'
@@ -408,7 +408,7 @@ 
                                                 />
                                             </td>
                                             <td class="option-actions-cell">
-                                            <?php if (! $option->system()) { ?>
+                                            <?php if ( ! $option->system()) { ?>
                                                 <a class='button button--icon-only remove-option remove-item ee-aria-tooltip'
                                                    aria-label="<?php esc_html_e(
                                                        'click to delete this option',
@@ -589,10 +589,10 @@ 
                     ];
                     echo wp_kses(
                         EEH_Form_Fields::select_input(
-                            'QST_required' . $id,
+                            'QST_required'.$id,
                             $requiredOptions,
                             $question->required(),
-                            'id="QST_required' . $id . '"' . $disabled_attr,
+                            'id="QST_required'.$id.'"'.$disabled_attr,
                             'ee-input-width--small'
                         ),
                         AllowedTags::getWithFormTags()
@@ -615,7 +615,7 @@ 
                                 'event_espresso'
                             ) ?>
                     </p>
-                    <?php if (! empty($disabled_attr) && in_array($QST_system, $system_required)) { ?>
+                    <?php if ( ! empty($disabled_attr) && in_array($QST_system, $system_required)) { ?>
                         <input id="QST_required"
                                name="QST_required"
                                type='hidden'

admin_pages/general_settings/AdminOptionsSettings.php

Indentation +188 added lines, -188 removed lines

@@ -26,204 +26,204 @@
  */
 class AdminOptionsSettings extends FormHandler
 {
-    protected $template_args = array();
+	protected $template_args = array();
 
-    /**
-     * Form constructor.
-     *
-     * @param EE_Registry $registry
-     */
-    public function __construct(EE_Registry $registry)
-    {
-        parent::__construct(
-            esc_html__('Admin Options', 'event_espresso'),
-            esc_html__('Admin Options', 'event_espresso'),
-            'admin_option_settings',
-            '',
-            FormHandler::DO_NOT_SETUP_FORM,
-            $registry
-        );
-    }
+	/**
+	 * Form constructor.
+	 *
+	 * @param EE_Registry $registry
+	 */
+	public function __construct(EE_Registry $registry)
+	{
+		parent::__construct(
+			esc_html__('Admin Options', 'event_espresso'),
+			esc_html__('Admin Options', 'event_espresso'),
+			'admin_option_settings',
+			'',
+			FormHandler::DO_NOT_SETUP_FORM,
+			$registry
+		);
+	}
 
 
-    /**
-     * @param array $template_args
-     */
-    public function setTemplateArgs(array $template_args)
-    {
-        $this->template_args = $template_args;
-    }
+	/**
+	 * @param array $template_args
+	 */
+	public function setTemplateArgs(array $template_args)
+	{
+		$this->template_args = $template_args;
+	}
 
 
-    /**
-     * creates and returns the actual form
-     *
-     * @return EE_Form_Section_Proper
-     * @throws EE_Error
-     */
-    public function generate()
-    {
-        $form = new EE_Form_Section_Proper(
-            array(
-                'name'            => 'admin_option_settings',
-                'html_id'         => 'admin_option_settings',
-                'layout_strategy' => new EE_Admin_Two_Column_Layout(),
-                'subsections'     => array(
-                    'compatibility_hdr'        => new EE_Form_Section_HTML(
-                        EEH_HTML::h2(
-                            esc_html__('Compatibility Settings', 'event_espresso'),
-                            '',
-                            'ee-admin-settings-hdr'
-                        )
-                    ),
-                    'encode_session_data'      => new EE_Yes_No_Input(
-                        array(
-                            'html_label_text' => esc_html__('Encode Session Data?', 'event_espresso'),
-                            'html_help_text'  => sprintf(
-                                esc_html__(
-                                    'Some servers and database configurations can cause problems when saving the Event Espresso session data. Setting this option to "Yes" adds an extra layer of encoding to session data to prevent serialization errors, but can be incompatible with some server configurations.%1$sIf you receive "500 internal server" type errors during registration, try turning this option on.%1$sIf you get fatal PHP errors regarding missing base64 functions, then turn this option off.',
-                                    'event_espresso'
-                                ),
-                                '<br>'
-                            ),
-                            'default'         => $this->registry->CFG->admin->encode_session_data(),
-                            'required'        => false,
-                        )
-                    ),
-                ),
-            )
-        );
-        if (
-            $this->registry->CAP->current_user_can(
-                'manage_options',
-                'display_admin_settings_options_promote_and_affiliate'
-            )
-        ) {
-            $form->add_subsections(
-                array(
-                    'promote_ee_hdr'  => new EE_Form_Section_HTML(
-                        EEH_HTML::h2(
-                            esc_html__('Promote Event Espresso', 'event_espresso')
-                            . ' '
-                            . EEH_HTML::span(
-                                EEH_Template::get_help_tab_link('affiliate_info'),
-                                'affiliate_info'
-                            ),
-                            '',
-                            'ee-admin-settings-hdr'
-                        )
-                    ),
-                    'show_reg_footer' => new EE_Yes_No_Input(
-                        array(
-                            'html_label_text' => esc_html__(
-                                'Link to Event Espresso in your Registration Page?',
-                                'event_espresso'
-                            )
-                            . EEH_Template::get_help_tab_link('email_validation_info'),
-                            'html_help_text'  => esc_html__(
-                                'adds an unobtrusive link to Event Espresso\'s website in the footer of your registration form. Get an affiliate link (see below) and make money if people click the link and purchase Event Espresso.',
-                                'event_espresso'
-                            ),
-                            'default'         => filter_var($this->registry->CFG->admin->show_reg_footer, FILTER_VALIDATE_BOOLEAN),
-                            'required'        => false,
-                        )
-                    ),
-                    'affiliate_id'    => new EE_Text_Input(
-                        array(
-                            'html_label_text' => sprintf(
-                                esc_html__('Event Espresso %1$sAffiliate%2$s ID', 'event_espresso'),
-                                '<a href="https://eventespresso.com/affiliates/" target="_blank">',
-                                '</a>'
-                            ),
-                            'html_help_text'  => esc_html__(
-                                'Earn cash for promoting Event Espresso.',
-                                'event_espresso'
-                            ),
-                            'html_class'      => 'regular-text',
-                            'default'         => isset($this->registry->CFG->admin->affiliate_id)
-                                ? $this->registry->CFG->admin->get_pretty('affiliate_id')
-                                : '',
-                            'required'        => false,
-                        )
-                    ),
-                ),
-                'compatibility_hdr'
-            );
-        }
-        do_action(
-            'AHEE__EventEspresso_admin_pages_general_settings_AdminOptionsSettings__generate__form',
-            $form,
-            $this->registry->CFG->admin,
-            $this
-        );
-        return $form;
-    }
+	/**
+	 * creates and returns the actual form
+	 *
+	 * @return EE_Form_Section_Proper
+	 * @throws EE_Error
+	 */
+	public function generate()
+	{
+		$form = new EE_Form_Section_Proper(
+			array(
+				'name'            => 'admin_option_settings',
+				'html_id'         => 'admin_option_settings',
+				'layout_strategy' => new EE_Admin_Two_Column_Layout(),
+				'subsections'     => array(
+					'compatibility_hdr'        => new EE_Form_Section_HTML(
+						EEH_HTML::h2(
+							esc_html__('Compatibility Settings', 'event_espresso'),
+							'',
+							'ee-admin-settings-hdr'
+						)
+					),
+					'encode_session_data'      => new EE_Yes_No_Input(
+						array(
+							'html_label_text' => esc_html__('Encode Session Data?', 'event_espresso'),
+							'html_help_text'  => sprintf(
+								esc_html__(
+									'Some servers and database configurations can cause problems when saving the Event Espresso session data. Setting this option to "Yes" adds an extra layer of encoding to session data to prevent serialization errors, but can be incompatible with some server configurations.%1$sIf you receive "500 internal server" type errors during registration, try turning this option on.%1$sIf you get fatal PHP errors regarding missing base64 functions, then turn this option off.',
+									'event_espresso'
+								),
+								'<br>'
+							),
+							'default'         => $this->registry->CFG->admin->encode_session_data(),
+							'required'        => false,
+						)
+					),
+				),
+			)
+		);
+		if (
+			$this->registry->CAP->current_user_can(
+				'manage_options',
+				'display_admin_settings_options_promote_and_affiliate'
+			)
+		) {
+			$form->add_subsections(
+				array(
+					'promote_ee_hdr'  => new EE_Form_Section_HTML(
+						EEH_HTML::h2(
+							esc_html__('Promote Event Espresso', 'event_espresso')
+							. ' '
+							. EEH_HTML::span(
+								EEH_Template::get_help_tab_link('affiliate_info'),
+								'affiliate_info'
+							),
+							'',
+							'ee-admin-settings-hdr'
+						)
+					),
+					'show_reg_footer' => new EE_Yes_No_Input(
+						array(
+							'html_label_text' => esc_html__(
+								'Link to Event Espresso in your Registration Page?',
+								'event_espresso'
+							)
+							. EEH_Template::get_help_tab_link('email_validation_info'),
+							'html_help_text'  => esc_html__(
+								'adds an unobtrusive link to Event Espresso\'s website in the footer of your registration form. Get an affiliate link (see below) and make money if people click the link and purchase Event Espresso.',
+								'event_espresso'
+							),
+							'default'         => filter_var($this->registry->CFG->admin->show_reg_footer, FILTER_VALIDATE_BOOLEAN),
+							'required'        => false,
+						)
+					),
+					'affiliate_id'    => new EE_Text_Input(
+						array(
+							'html_label_text' => sprintf(
+								esc_html__('Event Espresso %1$sAffiliate%2$s ID', 'event_espresso'),
+								'<a href="https://eventespresso.com/affiliates/" target="_blank">',
+								'</a>'
+							),
+							'html_help_text'  => esc_html__(
+								'Earn cash for promoting Event Espresso.',
+								'event_espresso'
+							),
+							'html_class'      => 'regular-text',
+							'default'         => isset($this->registry->CFG->admin->affiliate_id)
+								? $this->registry->CFG->admin->get_pretty('affiliate_id')
+								: '',
+							'required'        => false,
+						)
+					),
+				),
+				'compatibility_hdr'
+			);
+		}
+		do_action(
+			'AHEE__EventEspresso_admin_pages_general_settings_AdminOptionsSettings__generate__form',
+			$form,
+			$this->registry->CFG->admin,
+			$this
+		);
+		return $form;
+	}
 
 
-    /**
-     * takes the generated form and displays it along with ony other non-form HTML that may be required
-     * returns a string of HTML that can be directly echoed in a template
-     *
-     * @return string
-     * @throws LogicException
-     * @throws EE_Error
-     */
-    public function display()
-    {
-        add_filter(
-            'FHEE__EventEspresso_core_libraries_form_sections_form_handlers_FormHandler__display__before_form',
-            array($this, 'handleOldAdminOptionsSettingsAction')
-        );
-        return parent::display();
-    }
+	/**
+	 * takes the generated form and displays it along with ony other non-form HTML that may be required
+	 * returns a string of HTML that can be directly echoed in a template
+	 *
+	 * @return string
+	 * @throws LogicException
+	 * @throws EE_Error
+	 */
+	public function display()
+	{
+		add_filter(
+			'FHEE__EventEspresso_core_libraries_form_sections_form_handlers_FormHandler__display__before_form',
+			array($this, 'handleOldAdminOptionsSettingsAction')
+		);
+		return parent::display();
+	}
 
 
-    /**
-     * @return string
-     */
-    public function handleOldAdminOptionsSettingsAction()
-    {
-        ob_start();
-        do_action('AHEE__admin_option_settings__template__before', $this->template_args);
-        return ob_get_clean();
-    }
+	/**
+	 * @return string
+	 */
+	public function handleOldAdminOptionsSettingsAction()
+	{
+		ob_start();
+		do_action('AHEE__admin_option_settings__template__before', $this->template_args);
+		return ob_get_clean();
+	}
 
 
-    /**
-     * handles processing the form submission
-     * returns true or false depending on whether the form was processed successfully or not
-     *
-     * @param array $form_data
-     * @return bool
-     * @throws InvalidFormSubmissionException
-     * @throws EE_Error
-     * @throws LogicException
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     */
-    public function process($form_data = array())
-    {
-        // process form
-        $valid_data = (array) parent::process($form_data);
-        if (empty($valid_data)) {
-            return false;
-        }
-        $this->registry->CFG->admin->show_reg_footer = isset($valid_data['show_reg_footer'])
-            ? absint($valid_data['show_reg_footer'])
-            : $this->registry->CFG->admin->show_reg_footer;
-        $this->registry->CFG->admin->affiliate_id = isset($valid_data['affiliate_id'])
-            ? sanitize_text_field($valid_data['affiliate_id'])
-            : $this->registry->CFG->admin->affiliate_id;
-        if (isset($valid_data['encode_session_data'])) {
-            $this->registry->CFG->admin->set_encode_session_data($valid_data['encode_session_data']);
-        }
+	/**
+	 * handles processing the form submission
+	 * returns true or false depending on whether the form was processed successfully or not
+	 *
+	 * @param array $form_data
+	 * @return bool
+	 * @throws InvalidFormSubmissionException
+	 * @throws EE_Error
+	 * @throws LogicException
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 */
+	public function process($form_data = array())
+	{
+		// process form
+		$valid_data = (array) parent::process($form_data);
+		if (empty($valid_data)) {
+			return false;
+		}
+		$this->registry->CFG->admin->show_reg_footer = isset($valid_data['show_reg_footer'])
+			? absint($valid_data['show_reg_footer'])
+			: $this->registry->CFG->admin->show_reg_footer;
+		$this->registry->CFG->admin->affiliate_id = isset($valid_data['affiliate_id'])
+			? sanitize_text_field($valid_data['affiliate_id'])
+			: $this->registry->CFG->admin->affiliate_id;
+		if (isset($valid_data['encode_session_data'])) {
+			$this->registry->CFG->admin->set_encode_session_data($valid_data['encode_session_data']);
+		}
 
-        return apply_filters(
-            'FHEE__EventEspresso_admin_pages_general_settings_AdminOptionsSettings__process__form_processed',
-            true, // form processed successfully
-            $valid_data,
-            $this->registry->CFG->admin,
-            $this
-        );
-    }
+		return apply_filters(
+			'FHEE__EventEspresso_admin_pages_general_settings_AdminOptionsSettings__process__form_processed',
+			true, // form processed successfully
+			$valid_data,
+			$this->registry->CFG->admin,
+			$this
+		);
+	}
 }

admin_pages/maintenance/Maintenance_Admin_Page.core.php

Indentation +959 added lines, -959 removed lines

@@ -15,963 +15,963 @@
  */
 class Maintenance_Admin_Page extends EE_Admin_Page
 {
-    /**
-     * @var EE_Data_Migration_Manager
-     */
-    protected $migration_manager;
-
-    /**
-     * @var EE_Maintenance_Mode
-     */
-    protected $maintenance_mode;
-
-    /**
-     * @var EE_Form_Section_Proper
-     */
-    protected $datetime_fix_offset_form;
-
-
-    /**
-     * @param bool $routing
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function __construct($routing = true)
-    {
-        $this->migration_manager = EE_Data_Migration_Manager::instance();
-        $this->maintenance_mode  = EE_Maintenance_Mode::instance();
-        parent::__construct($routing);
-    }
-
-
-    protected function _init_page_props()
-    {
-        $this->page_slug        = EE_MAINTENANCE_PG_SLUG;
-        $this->page_label       = EE_MAINTENANCE_LABEL;
-        $this->_admin_base_url  = EE_MAINTENANCE_ADMIN_URL;
-        $this->_admin_base_path = EE_MAINTENANCE_ADMIN;
-    }
-
-
-    protected function _ajax_hooks()
-    {
-        if (! $this->capabilities->current_user_can('manage_options', 'perform-migrations')) {
-            return;
-        }
-        add_action('wp_ajax_migration_step', [$this, 'migration_step']);
-        add_action('wp_ajax_add_error_to_migrations_ran', [$this, 'add_error_to_migrations_ran']);
-    }
-
-
-    protected function _define_page_props()
-    {
-        $this->_admin_page_title = EE_MAINTENANCE_LABEL;
-        $this->_labels           = [
-            'buttons' => [
-                'reset_reservations' => esc_html__('Reset Ticket and Datetime Reserved Counts', 'event_espresso'),
-                'reset_capabilities' => esc_html__('Reset Event Espresso Capabilities', 'event_espresso'),
-            ],
-        ];
-    }
-
-
-    protected function _set_page_routes()
-    {
-        $this->_page_routes = [
-            'default'                             => [
-                'func'       => [$this, '_maintenance'],
-                'capability' => 'manage_options',
-            ],
-            'change_maintenance_level'            => [
-                'func'       => [$this, '_change_maintenance_level'],
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ],
-            'system_status'                       => [
-                'func'       => [$this, '_system_status'],
-                'capability' => 'manage_options',
-            ],
-            'download_system_status'              => [
-                'func'       => [$this, '_download_system_status'],
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ],
-            'send_migration_crash_report'         => [
-                'func'       => [$this, '_send_migration_crash_report'],
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ],
-            'confirm_migration_crash_report_sent' => [
-                'func'       => [$this, '_confirm_migration_crash_report_sent'],
-                'capability' => 'manage_options',
-            ],
-            'data_reset'                          => [
-                'func'       => [$this, '_data_reset_and_delete'],
-                'capability' => 'manage_options',
-            ],
-            'reset_db'                            => [
-                'func'       => [$this, '_reset_db'],
-                'capability' => 'manage_options',
-                'noheader'   => true,
-                'args'       => ['nuke_old_ee4_data' => true],
-            ],
-            'start_with_fresh_ee4_db'             => [
-                'func'       => [$this, '_reset_db'],
-                'capability' => 'manage_options',
-                'noheader'   => true,
-                'args'       => ['nuke_old_ee4_data' => false],
-            ],
-            'delete_db'                           => [
-                'func'       => [$this, '_delete_db'],
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ],
-            'rerun_migration_from_ee3'            => [
-                'func'       => [$this, '_rerun_migration_from_ee3'],
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ],
-            'reset_reservations'                  => [
-                'func'       => [$this, '_reset_reservations'],
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ],
-            'reset_capabilities'                  => [
-                'func'       => [$this, '_reset_capabilities'],
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ],
-            'reattempt_migration'                 => [
-                'func'       => [$this, '_reattempt_migration'],
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ],
-            'datetime_tools'                      => [
-                'func'       => [$this, '_datetime_tools'],
-                'capability' => 'manage_options',
-            ],
-            'run_datetime_offset_fix'             => [
-                'func'               => [$this, '_apply_datetime_offset'],
-                'noheader'           => true,
-                'headers_sent_route' => 'datetime_tools',
-                'capability'         => 'manage_options',
-            ],
-        ];
-    }
-
-
-    protected function _set_page_config()
-    {
-        $this->_page_config = [
-            'default'        => [
-                'nav'           => [
-                    'label' => esc_html__('Maintenance', 'event_espresso'),
-                    'icon'  => 'dashicons-admin-tools',
-                    'order' => 10,
-                ],
-                'require_nonce' => false,
-            ],
-            'data_reset'     => [
-                'nav'           => [
-                    'label' => esc_html__('Reset/Delete Data', 'event_espresso'),
-                    'icon'  => 'dashicons-trash',
-                    'order' => 20,
-                ],
-                'require_nonce' => false,
-            ],
-            'datetime_tools' => [
-                'nav'           => [
-                    'label' => esc_html__('Datetime Utilities', 'event_espresso'),
-                    'icon'  => 'dashicons-calendar-alt',
-                    'order' => 25,
-                ],
-                'require_nonce' => false,
-            ],
-            'system_status'  => [
-                'nav'           => [
-                    'label' => esc_html__("System Information", "event_espresso"),
-                    'icon'  => 'dashicons-info',
-                    'order' => 30,
-                ],
-                'require_nonce' => false,
-            ],
-        ];
-    }
-
-
-    /**
-     * default maintenance page.
-     * If we're in maintenance mode level 2, then we need to show the migration scripts and all that UI.
-     *
-     * @throws EE_Error
-     */
-    public function _maintenance()
-    {
-        $show_maintenance_switch         = true;
-        $show_backup_db_text             = false;
-        $show_migration_progress         = false;
-        $script_names                    = [];
-        $addons_should_be_upgraded_first = false;
-        // it all depends on if we're in maintenance model level 1 (frontend-only) or
-        // level 2 (everything except maintenance page)
-        try {
-            // get the current maintenance level and check if we are removed
-            $was_full_site_maintenence_mode = MaintenanceStatus::isFullSite();
-            $no_longer_in_maintenence_mode = ! $this->maintenance_mode->set_maintenance_mode_if_db_old();
-            if ($was_full_site_maintenence_mode && $no_longer_in_maintenence_mode) {
-                // we just took the site out of maintenance mode, so notify the user.
-                // unfortunately this message appears to be echoed on the NEXT page load...
-                // oh well, we should really be checking for this on addon deactivation anyways
-                EE_Error::add_attention(
-                    esc_html__(
-                        'Site taken out of maintenance mode because no data migration scripts are required',
-                        'event_espresso'
-                    )
-                );
-                $this->_process_notices(['page' => 'espresso_maintenance_settings']);
-            }
-            // in case an exception is thrown while trying to handle migrations
-            if (MaintenanceStatus::isFullSite()) {
-                $show_maintenance_switch = false;
-                $show_migration_progress = true;
-                if (! isset($this->_req_data['continue_migration'])) {
-                    $show_backup_db_text = true;
-                }
-                $scripts_needing_to_run          =
-                    $this->migration_manager->check_for_applicable_data_migration_scripts();
-                $addons_should_be_upgraded_first = $this->migration_manager->addons_need_updating();
-                $script_names                    = [];
-                $current_script                  = null;
-                foreach ($scripts_needing_to_run as $script) {
-                    if ($script instanceof EE_Data_Migration_Script_Base) {
-                        if (! $current_script) {
-                            $current_script = $script;
-                            $current_script->migration_page_hooks();
-                        }
-                        $script_names[] = $script->pretty_name();
-                    }
-                }
-            }
-            $most_recent_migration = $this->migration_manager->get_last_ran_script(true);
-            $exception_thrown      = false;
-        } catch (EE_Error $e) {
-            $this->migration_manager->add_error_to_migrations_ran($e->getMessage());
-            // now, just so we can display the page correctly, make an error migration script stage object
-            // and also put the error on it. It only persists for the duration of this request
-            $most_recent_migration = new EE_DMS_Unknown_1_0_0();
-            $most_recent_migration->add_error($e->getMessage());
-            $exception_thrown = true;
-        }
-        $current_db_state = $this->migration_manager->ensure_current_database_state_is_set();
-        $current_db_state = str_replace('.decaf', '', $current_db_state);
-        if (
-            $exception_thrown
-            || (
-                $most_recent_migration instanceof EE_Data_Migration_Script_Base
-                && $most_recent_migration->is_broken()
-            )
-        ) {
-            $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_migration_was_borked_page.template.php';
-
-            $this->_template_args['support_url'] = 'https://eventespresso.com/support/forums/';
-            $this->_template_args['next_url']    = EEH_URL::add_query_args_and_nonce(
-                [
-                    'action'  => 'confirm_migration_crash_report_sent',
-                    'success' => '0',
-                ],
-                EE_MAINTENANCE_ADMIN_URL
-            );
-        } elseif ($addons_should_be_upgraded_first) {
-            $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_upgrade_addons_before_migrating.template.php';
-        } else {
-            if (
-                $most_recent_migration instanceof EE_Data_Migration_Script_Base
-                && $most_recent_migration->can_continue()
-            ) {
-                $show_backup_db_text                    = false;
-                $show_continue_current_migration_script = true;
-                $show_most_recent_migration             = true;
-            } elseif (isset($this->_req_data['continue_migration'])) {
-                $show_most_recent_migration             = true;
-                $show_continue_current_migration_script = false;
-            } else {
-                $show_most_recent_migration             = false;
-                $show_continue_current_migration_script = false;
-            }
-            if (isset($current_script)) {
-                $migrates_to          = $current_script->migrates_to_version();
-                $plugin_slug          = $migrates_to['slug'];
-                $new_version          = $migrates_to['version'];
-                $this->_template_args = array_merge(
-                    $this->_template_args,
-                    [
-                        'current_db_state' => sprintf(
-                            esc_html__("EE%s (%s)", "event_espresso"),
-                            $current_db_state[ $plugin_slug ] ?? 3,
-                            $plugin_slug
-                        ),
-                        'next_db_state'    => sprintf(
-                            esc_html__("EE%s (%s)", 'event_espresso'),
-                            $new_version,
-                            $plugin_slug
-                        ),
-                    ]
-                );
-            } else {
-                $this->_template_args['current_db_state'] = '';
-                $this->_template_args['next_db_state']    = '';
-            }
-            $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_migration_page.template.php';
-            $this->_template_args = array_merge(
-                $this->_template_args,
-                [
-                    'show_most_recent_migration'             => $show_most_recent_migration,
-                    // flag for showing the most recent migration's status and/or errors
-                    'show_migration_progress'                => $show_migration_progress,
-                    // flag for showing the option to run migrations and see their progress
-                    'show_backup_db_text'                    => $show_backup_db_text,
-                    // flag for showing text telling the user to back up their DB
-                    'show_maintenance_switch'                => $show_maintenance_switch,
-                    // flag for showing the option to change maintenance mode between levels 0 and 1
-                    'script_names'                           => $script_names,
-                    // array of names of scripts that have run
-                    'show_continue_current_migration_script' => $show_continue_current_migration_script,
-                    // flag to change wording to indicating that we're only CONTINUING a migration script (somehow it got interrupted0
-                    'reset_db_page_link'                     => EE_Admin_Page::add_query_args_and_nonce(
-                        ['action' => 'reset_db'],
-                        EE_MAINTENANCE_ADMIN_URL
-                    ),
-                    'data_reset_page'                        => EE_Admin_Page::add_query_args_and_nonce(
-                        ['action' => 'data_reset'],
-                        EE_MAINTENANCE_ADMIN_URL
-                    ),
-                    'update_migration_script_page_link'      => EE_Admin_Page::add_query_args_and_nonce(
-                        ['action' => 'change_maintenance_level'],
-                        EE_MAINTENANCE_ADMIN_URL
-                    ),
-                    'ultimate_db_state'                      => sprintf(
-                        esc_html__("EE%s", 'event_espresso'),
-                        espresso_version()
-                    ),
-                    'real_level'                             => $this->maintenance_mode->real_level(),
-                ]
-            );
-        }
-        $this->_template_args['most_recent_migration'] =
-            $most_recent_migration;// the actual most recently ran migration
-        // now render the migration options part, and put it in a variable
-        $migration_options_template_file                = apply_filters(
-            'FHEE__ee_migration_page__migration_options_template',
-            EE_MAINTENANCE_TEMPLATE_PATH . 'migration_options_from_ee4.template.php'
-        );
-        $migration_options_html                         = EEH_Template::display_template(
-            $migration_options_template_file,
-            $this->_template_args,
-            true
-        );
-        $this->_template_args['migration_options_html'] = $migration_options_html;
-        $this->_template_args['admin_page_content']     = EEH_Template::display_template(
-            $this->_template_path,
-            $this->_template_args,
-            true
-        );
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    /**
-     * returns JSON and executes another step of the currently-executing data migration (called via ajax)
-     *
-     * @throws EE_Error
-     */
-    public function migration_step()
-    {
-        if (! $this->capabilities->current_user_can('manage_options', __FUNCTION__)) {
-            wp_die(esc_html__('You do not have the required privileges to perform this action', 'event_espresso'));
-        }
-        $this->_template_args['data'] = $this->migration_manager->response_to_migration_ajax_request();
-        $this->_return_json();
-    }
-
-
-    /**
-     * Can be used by js when it notices a response with HTML in it in order
-     * to log the malformed response
-     *
-     * @throws EE_Error
-     */
-    public function add_error_to_migrations_ran()
-    {
-        $this->migration_manager->add_error_to_migrations_ran($this->_req_data['message']);
-        $this->_template_args['data'] = ['ok' => true];
-        $this->_return_json();
-    }
-
-
-    /**
-     * changes the maintenance level, provided there are still no migration scripts that should run
-     *
-     * @throws EE_Error
-     */
-    public function _change_maintenance_level()
-    {
-        $new_level = absint($this->_req_data['maintenance_mode_level']);
-        if (! $this->migration_manager->check_for_applicable_data_migration_scripts()) {
-            $this->maintenance_mode->set_maintenance_level($new_level);
-            $success = true;
-        } else {
-            $this->maintenance_mode->set_maintenance_mode_if_db_old();
-            $success = false;
-        }
-        $this->_redirect_after_action($success, 'Maintenance Mode', esc_html__("Updated", "event_espresso"));
-    }
-
-
-    /**
-     * a tab with options for resetting and/or deleting EE data
-     *
-     * @throws EE_Error
-     * @throws DomainException
-     */
-    public function _data_reset_and_delete()
-    {
-        $this->_template_path                              =
-            EE_MAINTENANCE_TEMPLATE_PATH . 'ee_data_reset_and_delete.template.php';
-        $this->_template_args['reset_reservations_button'] = $this->get_action_link_or_button(
-            'reset_reservations',
-            'reset_reservations',
-            [],
-            'button button--caution ee-confirm'
-        );
-        $this->_template_args['reset_capabilities_button'] = $this->get_action_link_or_button(
-            'reset_capabilities',
-            'reset_capabilities',
-            [],
-            'button button--caution ee-confirm'
-        );
-        $this->_template_args['delete_db_url']             = EE_Admin_Page::add_query_args_and_nonce(
-            ['action' => 'delete_db'],
-            EE_MAINTENANCE_ADMIN_URL
-        );
-        $this->_template_args['reset_db_url']              = EE_Admin_Page::add_query_args_and_nonce(
-            ['action' => 'reset_db'],
-            EE_MAINTENANCE_ADMIN_URL
-        );
-        $this->_template_args['admin_page_content']        = EEH_Template::display_template(
-            $this->_template_path,
-            $this->_template_args,
-            true
-        );
-        $this->display_admin_page_with_no_sidebar();
-    }
-
-
-    /**
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _reset_reservations()
-    {
-        if (EED_Ticket_Sales_Monitor::reset_reservation_counts()) {
-            EE_Error::add_success(
-                esc_html__(
-                    'Ticket and datetime reserved counts have been successfully reset.',
-                    'event_espresso'
-                )
-            );
-        } else {
-            EE_Error::add_success(
-                esc_html__(
-                    'Ticket and datetime reserved counts were correct and did not need resetting.',
-                    'event_espresso'
-                )
-            );
-        }
-        $this->_redirect_after_action(true, '', '', ['action' => 'data_reset'], true);
-    }
-
-
-    /**
-     * @throws EE_Error
-     */
-    protected function _reset_capabilities()
-    {
-        $this->capabilities->init_caps(true);
-        EE_Error::add_success(
-            esc_html__(
-                'Default Event Espresso capabilities have been restored for all current roles.',
-                'event_espresso'
-            )
-        );
-        $this->_redirect_after_action(false, '', '', ['action' => 'data_reset'], true);
-    }
-
-
-    /**
-     * resets the DMSs, so we can attempt to continue migrating after a fatal error
-     * (only a good idea when someone has somehow tried ot fix whatever caused
-     * the fatal error in teh first place)
-     *
-     * @throws EE_Error
-     */
-    protected function _reattempt_migration()
-    {
-        $this->migration_manager->reattempt();
-        $this->_redirect_after_action(false, '', '', ['action' => 'default'], true);
-    }
-
-
-    /**
-     * shows the big ol' System Information page
-     *
-     * @throws EE_Error
-     */
-    public function _system_status()
-    {
-        $this->_template_path                               =
-            EE_MAINTENANCE_TEMPLATE_PATH . 'ee_system_stati_page.template.php';
-        $this->_template_args['system_stati']               = EEM_System_Status::instance()->get_system_stati();
-        $this->_template_args['download_system_status_url'] = EE_Admin_Page::add_query_args_and_nonce(
-            [
-                'action' => 'download_system_status',
-            ],
-            EE_MAINTENANCE_ADMIN_URL
-        );
-        $this->_template_args['admin_page_content']         = EEH_Template::display_template(
-            $this->_template_path,
-            $this->_template_args,
-            true
-        );
-        $this->display_admin_page_with_no_sidebar();
-    }
-
-
-    /**
-     * Downloads an HTML file of the system status that can be easily stored or emailed
-     */
-    public function _download_system_status()
-    {
-        $status_info = EEM_System_Status::instance()->get_system_stati();
-        header('Content-Disposition: attachment');
-        header("Content-Disposition: attachment; filename=system_status_" . sanitize_key(site_url()) . ".html");
-        $output = '<style>table{border:1px solid darkgrey;}td{vertical-align:top}</style>';
-        $output .= '<h1>' . sprintf(
-            __('System Information for %1$s', 'event_espresso'),
-            esc_url_raw(site_url())
-        ) . '</h1>';
-        $output .= EEH_Template::layout_array_as_table($status_info);
-        echo esc_html($output);
-        die;
-    }
-
-
-    /**
-     * @throws EE_Error
-     */
-    public function _send_migration_crash_report()
-    {
-        $from      = $this->_req_data['from'];
-        $from_name = $this->_req_data['from_name'];
-        $body      = $this->_req_data['body'];
-        try {
-            $success = wp_mail(
-                EE_SUPPORT_EMAIL,
-                'Migration Crash Report',
-                $body . "/r/n<br>" . print_r(EEM_System_Status::instance()->get_system_stati(), true),
-                [
-                    "from:$from_name<$from>",
-                ]
-            );
-        } catch (Exception $e) {
-            $success = false;
-        }
-        $this->_redirect_after_action(
-            $success,
-            esc_html__("Migration Crash Report", "event_espresso"),
-            esc_html__("sent", "event_espresso"),
-            ['success' => $success, 'action' => 'confirm_migration_crash_report_sent']
-        );
-    }
-
-
-    /**
-     * @throws EE_Error
-     */
-    public function _confirm_migration_crash_report_sent()
-    {
-        try {
-            $most_recent_migration = $this->migration_manager->get_last_ran_script(true);
-        } catch (EE_Error $e) {
-            $this->migration_manager->add_error_to_migrations_ran($e->getMessage());
-            // now, just so we can display the page correctly, make an error migration script stage object
-            // and also put the error on it. It only persists for the duration of this request
-            $most_recent_migration = new EE_DMS_Unknown_1_0_0();
-            $most_recent_migration->add_error($e->getMessage());
-        }
-        $success                                       = $this->_req_data['success'] === '1';
-        $this->_template_args['success']               = $success;
-        $this->_template_args['most_recent_migration'] = $most_recent_migration;
-        $this->_template_args['reset_db_action_url']   = EE_Admin_Page::add_query_args_and_nonce(
-            ['action' => 'reset_db'],
-            EE_MAINTENANCE_ADMIN_URL
-        );
-        $this->_template_args['reset_db_page_url']     = EE_Admin_Page::add_query_args_and_nonce(
-            ['action' => 'data_reset'],
-            EE_MAINTENANCE_ADMIN_URL
-        );
-        $this->_template_args['reattempt_action_url']  = EE_Admin_Page::add_query_args_and_nonce(
-            ['action' => 'reattempt_migration'],
-            EE_MAINTENANCE_ADMIN_URL
-        );
-        $this->_template_path                          =
-            EE_MAINTENANCE_TEMPLATE_PATH . 'ee_confirm_migration_crash_report_sent.template.php';
-        $this->_template_args['admin_page_content']    = EEH_Template::display_template(
-            $this->_template_path,
-            $this->_template_args,
-            true
-        );
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    /**
-     * Resets the entire EE4 database.
-     * only sets up ee4 database for a fresh install-
-     * doesn't actually clean out the old wp options, or cpts
-     * (although it does erase old ee table data)
-     *
-     * @param boolean $nuke_old_ee4_data controls whether we destroy the old ee4 data,
-     *                                   or just try initializing ee4 default data
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function _reset_db($nuke_old_ee4_data = true)
-    {
-        $this->maintenance_mode->set_maintenance_level(EE_Maintenance_Mode::STATUS_OFF);
-        if ($nuke_old_ee4_data) {
-            EEH_Activation::delete_all_espresso_cpt_data();
-            EEH_Activation::delete_all_espresso_tables_and_data(false);
-            EEH_Activation::remove_cron_tasks();
-        }
-        // make sure when we reset the registry's config that it
-        // switches to using the new singleton
-        EE_Registry::instance()->CFG = EE_Registry::instance()->CFG->reset(true);
-        EE_System::instance()->initialize_db_if_no_migrations_required(true);
-        EE_System::instance()->redirect_to_about_ee();
-    }
-
-
-    /**
-     * Deletes ALL EE tables, Records, and Options from the database.
-     *
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function _delete_db()
-    {
-        $this->maintenance_mode->set_maintenance_level(EE_Maintenance_Mode::STATUS_OFF);
-        EEH_Activation::delete_all_espresso_cpt_data();
-        EEH_Activation::delete_all_espresso_tables_and_data();
-        EEH_Activation::remove_cron_tasks();
-        EEH_Activation::deactivate_event_espresso();
-        wp_safe_redirect(admin_url('plugins.php'));
-        exit;
-    }
-
-
-    /**
-     * sets up EE4 to rerun the migrations from ee3 to ee4
-     *
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function _rerun_migration_from_ee3()
-    {
-        $this->maintenance_mode->set_maintenance_level(EE_Maintenance_Mode::STATUS_OFF);
-        EEH_Activation::delete_all_espresso_cpt_data();
-        EEH_Activation::delete_all_espresso_tables_and_data(false);
-        // set the db state to something that will require migrations
-        update_option(EE_Data_Migration_Manager::current_database_state, '3.1.36.0');
-        $this->maintenance_mode->set_maintenance_level(EE_Maintenance_Mode::STATUS_FULL_SITE);
-        $this->_redirect_after_action(
-            true,
-            esc_html__("Database", 'event_espresso'),
-            esc_html__("reset", 'event_espresso')
-        );
-    }
-
-
-    // none of the below group are currently used for Gateway Settings
-    protected function _add_screen_options()
-    {
-    }
-
-
-    protected function _add_feature_pointers()
-    {
-    }
-
-
-    public function admin_init()
-    {
-    }
-
-
-    public function admin_notices()
-    {
-    }
-
-
-    public function admin_footer_scripts()
-    {
-    }
-
-
-    public function load_scripts_styles()
-    {
-        wp_enqueue_script('ee_admin_js');
-        wp_enqueue_script(
-            'ee-maintenance',
-            EE_MAINTENANCE_ASSETS_URL . 'ee-maintenance.js',
-            ['jquery'],
-            EVENT_ESPRESSO_VERSION,
-            true
-        );
-        wp_register_style(
-            'espresso_maintenance',
-            EE_MAINTENANCE_ASSETS_URL . 'ee-maintenance.css',
-            [],
-            EVENT_ESPRESSO_VERSION
-        );
-        wp_enqueue_style('espresso_maintenance');
-        // localize script stuff
-        wp_localize_script(
-            'ee-maintenance',
-            'ee_maintenance',
-            [
-                'migrating'                        => wp_strip_all_tags(__("Updating Database...", "event_espresso")),
-                'next'                             => wp_strip_all_tags(__("Next", "event_espresso")),
-                'fatal_error'                      => wp_strip_all_tags(
-                    __(
-                        "A Fatal Error Has Occurred",
-                        "event_espresso"
-                    )
-                ),
-                'click_next_when_ready'            => wp_strip_all_tags(
-                    __(
-                        "The current Database Update has ended. Click 'next' when ready to proceed",
-                        "event_espresso"
-                    )
-                ),
-                'status_no_more_migration_scripts' => EE_Data_Migration_Manager::status_no_more_migration_scripts,
-                'status_fatal_error'               => EE_Data_Migration_Manager::status_fatal_error,
-                'status_completed'                 => EE_Data_Migration_Manager::status_completed,
-                'confirm'                          => wp_strip_all_tags(
-                    __(
-                        'Are you sure you want to do this? It CANNOT be undone!',
-                        'event_espresso'
-                    )
-                ),
-                'confirm_skip_migration'           => wp_strip_all_tags(
-                    __(
-                        'You have chosen to NOT migrate your existing data. Are you sure you want to continue?',
-                        'event_espresso'
-                    )
-                ),
-            ]
-        );
-    }
-
-
-    public function load_scripts_styles_default()
-    {
-    }
-
-
-    /**
-     * Enqueue scripts and styles for the datetime tools page.
-     */
-    public function load_scripts_styles_datetime_tools()
-    {
-        EE_Datepicker_Input::enqueue_styles_and_scripts();
-    }
-
-
-    /**
-     * @throws EE_Error
-     */
-    protected function _datetime_tools()
-    {
-        $form_action                                = EE_Admin_Page::add_query_args_and_nonce(
-            [
-                'action'        => 'run_datetime_offset_fix',
-                'return_action' => $this->_req_action,
-            ],
-            EE_MAINTENANCE_ADMIN_URL
-        );
-        $form                                       = $this->_get_datetime_offset_fix_form();
-        $this->_admin_page_title                    = esc_html__('Datetime Utilities', 'event_espresso');
-        $this->_template_args['admin_page_content'] = $form->form_open($form_action, 'post')
-                                                      . $form->get_html_and_js()
-                                                      . $form->form_close();
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    /**
-     * @throws EE_Error
-     */
-    protected function _get_datetime_offset_fix_form()
-    {
-        if (! $this->datetime_fix_offset_form instanceof EE_Form_Section_Proper) {
-            $this->datetime_fix_offset_form = new EE_Form_Section_Proper(
-                [
-                    'name'            => 'datetime_offset_fix_option',
-                    'layout_strategy' => new EE_Admin_Two_Column_Layout(),
-                    'subsections'     => [
-                        'title'                  => new EE_Form_Section_HTML(
-                            EEH_HTML::h2(
-                                esc_html__('Datetime Offset Tool', 'event_espresso')
-                            )
-                        ),
-                        'explanation'            => new EE_Form_Section_HTML(
-                            EEH_HTML::p(
-                                esc_html__(
-                                    'Use this tool to automatically apply the provided offset to all Event Espresso records in your database that involve dates and times.',
-                                    'event_espresso'
-                                )
-                            )
-                            . EEH_HTML::p(
-                                esc_html__(
-                                    'Note: If you enter 1.25, that will result in the offset of 1 hour 15 minutes being applied.  Decimals represent the fraction of hours, not minutes.',
-                                    'event_espresso'
-                                )
-                            )
-                        ),
-                        'offset_input'           => new EE_Float_Input(
-                            [
-                                'html_name'       => 'offset_for_datetimes',
-                                'html_label_text' => esc_html__(
-                                    'Offset to apply (in hours):',
-                                    'event_espresso'
-                                ),
-                                'min_value'       => '-12',
-                                'max_value'       => '14',
-                                'step_value'      => '.25',
-                                'default'         => DatetimeOffsetFix::getOffset(),
-                            ]
-                        ),
-                        'date_range_explanation' => new EE_Form_Section_HTML(
-                            EEH_HTML::p(
-                                esc_html__(
-                                    'Leave the following fields blank if you want the offset to be applied to all dates. If however, you want to just apply the offset to a specific range of dates you can restrict the offset application using these fields.',
-                                    'event_espresso'
-                                )
-                            )
-                            . EEH_HTML::p(
-                                EEH_HTML::strong(
-                                    sprintf(
-                                        esc_html__(
-                                            'Note: please enter the dates in UTC (You can use %1$sthis online tool%2$s to assist with conversions).',
-                                            'event_espresso'
-                                        ),
-                                        '<a href="https://www.timeanddate.com/worldclock/converter.html">',
-                                        '</a>'
-                                    )
-                                )
-                            )
-                        ),
-                        'date_range_start_date'  => new EE_Datepicker_Input(
-                            [
-                                'html_name'       => 'offset_date_start_range',
-                                'html_label_text' => esc_html__(
-                                    'Start Date for dates the offset applied to:',
-                                    'event_espresso'
-                                ),
-                            ]
-                        ),
-                        'date_range_end_date'    => new EE_Datepicker_Input(
-                            [
-                                'html_name'       => 'offset_date_end_range',
-                                'html_label_text' => esc_html__(
-                                    'End Date for dates the offset is applied to:',
-                                    'event_espresso'
-                                ),
-                            ]
-                        ),
-                        'submit'                 => new EE_Submit_Input(
-                            [
-                                'html_label_text' => '',
-                                'default'         => esc_html__('Apply Offset', 'event_espresso'),
-                            ]
-                        ),
-                    ],
-                ]
-            );
-        }
-        return $this->datetime_fix_offset_form;
-    }
-
-
-    /**
-     * Callback for the run_datetime_offset_fix route.
-     *
-     * @throws EE_Error
-     */
-    protected function _apply_datetime_offset()
-    {
-        if ($_SERVER['REQUEST_METHOD'] === 'POST') {
-            $form = $this->_get_datetime_offset_fix_form();
-            $form->receive_form_submission($this->_req_data);
-            if ($form->is_valid()) {
-                // save offset data so batch processor can get it.
-                DatetimeOffsetFix::updateOffset((float) $form->get_input_value('offset_input'));
-                $utc_timezone          = new DateTimeZone('UTC');
-                $date_range_start_date = DateTime::createFromFormat(
-                    'm/d/Y H:i:s',
-                    $form->get_input_value('date_range_start_date') . ' 00:00:00',
-                    $utc_timezone
-                );
-                $date_range_end_date   = DateTime::createFromFormat(
-                    'm/d/Y H:i:s',
-                    $form->get_input_value('date_range_end_date') . ' 23:59:59',
-                    $utc_timezone
-                );
-                if ($date_range_start_date instanceof DateTime) {
-                    DatetimeOffsetFix::updateStartDateRange(DbSafeDateTime::createFromDateTime($date_range_start_date));
-                }
-                if ($date_range_end_date instanceof DateTime) {
-                    DatetimeOffsetFix::updateEndDateRange(DbSafeDateTime::createFromDateTime($date_range_end_date));
-                }
-                // redirect to batch tool
-                wp_redirect(
-                    EE_Admin_Page::add_query_args_and_nonce(
-                        [
-                            'page'        => EED_Batch::PAGE_SLUG,
-                            'batch'       => EED_Batch::batch_job,
-                            'label'       => esc_html__('Applying Offset', 'event_espresso'),
-                            'job_handler' => urlencode('EventEspresso\core\libraries\batch\JobHandlers\DatetimeOffsetFix'),
-                            'return_url'  => urlencode(
-                                add_query_arg(
-                                    [
-                                        'action' => 'datetime_tools',
-                                    ],
-                                    EEH_URL::current_url_without_query_paramaters(
-                                        [
-                                            'return_action',
-                                            'run_datetime_offset_fix_nonce',
-                                            'return',
-                                            'datetime_tools_nonce',
-                                        ]
-                                    )
-                                )
-                            ),
-                        ],
-                        admin_url()
-                    )
-                );
-                exit;
-            }
-        }
-    }
+	/**
+	 * @var EE_Data_Migration_Manager
+	 */
+	protected $migration_manager;
+
+	/**
+	 * @var EE_Maintenance_Mode
+	 */
+	protected $maintenance_mode;
+
+	/**
+	 * @var EE_Form_Section_Proper
+	 */
+	protected $datetime_fix_offset_form;
+
+
+	/**
+	 * @param bool $routing
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function __construct($routing = true)
+	{
+		$this->migration_manager = EE_Data_Migration_Manager::instance();
+		$this->maintenance_mode  = EE_Maintenance_Mode::instance();
+		parent::__construct($routing);
+	}
+
+
+	protected function _init_page_props()
+	{
+		$this->page_slug        = EE_MAINTENANCE_PG_SLUG;
+		$this->page_label       = EE_MAINTENANCE_LABEL;
+		$this->_admin_base_url  = EE_MAINTENANCE_ADMIN_URL;
+		$this->_admin_base_path = EE_MAINTENANCE_ADMIN;
+	}
+
+
+	protected function _ajax_hooks()
+	{
+		if (! $this->capabilities->current_user_can('manage_options', 'perform-migrations')) {
+			return;
+		}
+		add_action('wp_ajax_migration_step', [$this, 'migration_step']);
+		add_action('wp_ajax_add_error_to_migrations_ran', [$this, 'add_error_to_migrations_ran']);
+	}
+
+
+	protected function _define_page_props()
+	{
+		$this->_admin_page_title = EE_MAINTENANCE_LABEL;
+		$this->_labels           = [
+			'buttons' => [
+				'reset_reservations' => esc_html__('Reset Ticket and Datetime Reserved Counts', 'event_espresso'),
+				'reset_capabilities' => esc_html__('Reset Event Espresso Capabilities', 'event_espresso'),
+			],
+		];
+	}
+
+
+	protected function _set_page_routes()
+	{
+		$this->_page_routes = [
+			'default'                             => [
+				'func'       => [$this, '_maintenance'],
+				'capability' => 'manage_options',
+			],
+			'change_maintenance_level'            => [
+				'func'       => [$this, '_change_maintenance_level'],
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			],
+			'system_status'                       => [
+				'func'       => [$this, '_system_status'],
+				'capability' => 'manage_options',
+			],
+			'download_system_status'              => [
+				'func'       => [$this, '_download_system_status'],
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			],
+			'send_migration_crash_report'         => [
+				'func'       => [$this, '_send_migration_crash_report'],
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			],
+			'confirm_migration_crash_report_sent' => [
+				'func'       => [$this, '_confirm_migration_crash_report_sent'],
+				'capability' => 'manage_options',
+			],
+			'data_reset'                          => [
+				'func'       => [$this, '_data_reset_and_delete'],
+				'capability' => 'manage_options',
+			],
+			'reset_db'                            => [
+				'func'       => [$this, '_reset_db'],
+				'capability' => 'manage_options',
+				'noheader'   => true,
+				'args'       => ['nuke_old_ee4_data' => true],
+			],
+			'start_with_fresh_ee4_db'             => [
+				'func'       => [$this, '_reset_db'],
+				'capability' => 'manage_options',
+				'noheader'   => true,
+				'args'       => ['nuke_old_ee4_data' => false],
+			],
+			'delete_db'                           => [
+				'func'       => [$this, '_delete_db'],
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			],
+			'rerun_migration_from_ee3'            => [
+				'func'       => [$this, '_rerun_migration_from_ee3'],
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			],
+			'reset_reservations'                  => [
+				'func'       => [$this, '_reset_reservations'],
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			],
+			'reset_capabilities'                  => [
+				'func'       => [$this, '_reset_capabilities'],
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			],
+			'reattempt_migration'                 => [
+				'func'       => [$this, '_reattempt_migration'],
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			],
+			'datetime_tools'                      => [
+				'func'       => [$this, '_datetime_tools'],
+				'capability' => 'manage_options',
+			],
+			'run_datetime_offset_fix'             => [
+				'func'               => [$this, '_apply_datetime_offset'],
+				'noheader'           => true,
+				'headers_sent_route' => 'datetime_tools',
+				'capability'         => 'manage_options',
+			],
+		];
+	}
+
+
+	protected function _set_page_config()
+	{
+		$this->_page_config = [
+			'default'        => [
+				'nav'           => [
+					'label' => esc_html__('Maintenance', 'event_espresso'),
+					'icon'  => 'dashicons-admin-tools',
+					'order' => 10,
+				],
+				'require_nonce' => false,
+			],
+			'data_reset'     => [
+				'nav'           => [
+					'label' => esc_html__('Reset/Delete Data', 'event_espresso'),
+					'icon'  => 'dashicons-trash',
+					'order' => 20,
+				],
+				'require_nonce' => false,
+			],
+			'datetime_tools' => [
+				'nav'           => [
+					'label' => esc_html__('Datetime Utilities', 'event_espresso'),
+					'icon'  => 'dashicons-calendar-alt',
+					'order' => 25,
+				],
+				'require_nonce' => false,
+			],
+			'system_status'  => [
+				'nav'           => [
+					'label' => esc_html__("System Information", "event_espresso"),
+					'icon'  => 'dashicons-info',
+					'order' => 30,
+				],
+				'require_nonce' => false,
+			],
+		];
+	}
+
+
+	/**
+	 * default maintenance page.
+	 * If we're in maintenance mode level 2, then we need to show the migration scripts and all that UI.
+	 *
+	 * @throws EE_Error
+	 */
+	public function _maintenance()
+	{
+		$show_maintenance_switch         = true;
+		$show_backup_db_text             = false;
+		$show_migration_progress         = false;
+		$script_names                    = [];
+		$addons_should_be_upgraded_first = false;
+		// it all depends on if we're in maintenance model level 1 (frontend-only) or
+		// level 2 (everything except maintenance page)
+		try {
+			// get the current maintenance level and check if we are removed
+			$was_full_site_maintenence_mode = MaintenanceStatus::isFullSite();
+			$no_longer_in_maintenence_mode = ! $this->maintenance_mode->set_maintenance_mode_if_db_old();
+			if ($was_full_site_maintenence_mode && $no_longer_in_maintenence_mode) {
+				// we just took the site out of maintenance mode, so notify the user.
+				// unfortunately this message appears to be echoed on the NEXT page load...
+				// oh well, we should really be checking for this on addon deactivation anyways
+				EE_Error::add_attention(
+					esc_html__(
+						'Site taken out of maintenance mode because no data migration scripts are required',
+						'event_espresso'
+					)
+				);
+				$this->_process_notices(['page' => 'espresso_maintenance_settings']);
+			}
+			// in case an exception is thrown while trying to handle migrations
+			if (MaintenanceStatus::isFullSite()) {
+				$show_maintenance_switch = false;
+				$show_migration_progress = true;
+				if (! isset($this->_req_data['continue_migration'])) {
+					$show_backup_db_text = true;
+				}
+				$scripts_needing_to_run          =
+					$this->migration_manager->check_for_applicable_data_migration_scripts();
+				$addons_should_be_upgraded_first = $this->migration_manager->addons_need_updating();
+				$script_names                    = [];
+				$current_script                  = null;
+				foreach ($scripts_needing_to_run as $script) {
+					if ($script instanceof EE_Data_Migration_Script_Base) {
+						if (! $current_script) {
+							$current_script = $script;
+							$current_script->migration_page_hooks();
+						}
+						$script_names[] = $script->pretty_name();
+					}
+				}
+			}
+			$most_recent_migration = $this->migration_manager->get_last_ran_script(true);
+			$exception_thrown      = false;
+		} catch (EE_Error $e) {
+			$this->migration_manager->add_error_to_migrations_ran($e->getMessage());
+			// now, just so we can display the page correctly, make an error migration script stage object
+			// and also put the error on it. It only persists for the duration of this request
+			$most_recent_migration = new EE_DMS_Unknown_1_0_0();
+			$most_recent_migration->add_error($e->getMessage());
+			$exception_thrown = true;
+		}
+		$current_db_state = $this->migration_manager->ensure_current_database_state_is_set();
+		$current_db_state = str_replace('.decaf', '', $current_db_state);
+		if (
+			$exception_thrown
+			|| (
+				$most_recent_migration instanceof EE_Data_Migration_Script_Base
+				&& $most_recent_migration->is_broken()
+			)
+		) {
+			$this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_migration_was_borked_page.template.php';
+
+			$this->_template_args['support_url'] = 'https://eventespresso.com/support/forums/';
+			$this->_template_args['next_url']    = EEH_URL::add_query_args_and_nonce(
+				[
+					'action'  => 'confirm_migration_crash_report_sent',
+					'success' => '0',
+				],
+				EE_MAINTENANCE_ADMIN_URL
+			);
+		} elseif ($addons_should_be_upgraded_first) {
+			$this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_upgrade_addons_before_migrating.template.php';
+		} else {
+			if (
+				$most_recent_migration instanceof EE_Data_Migration_Script_Base
+				&& $most_recent_migration->can_continue()
+			) {
+				$show_backup_db_text                    = false;
+				$show_continue_current_migration_script = true;
+				$show_most_recent_migration             = true;
+			} elseif (isset($this->_req_data['continue_migration'])) {
+				$show_most_recent_migration             = true;
+				$show_continue_current_migration_script = false;
+			} else {
+				$show_most_recent_migration             = false;
+				$show_continue_current_migration_script = false;
+			}
+			if (isset($current_script)) {
+				$migrates_to          = $current_script->migrates_to_version();
+				$plugin_slug          = $migrates_to['slug'];
+				$new_version          = $migrates_to['version'];
+				$this->_template_args = array_merge(
+					$this->_template_args,
+					[
+						'current_db_state' => sprintf(
+							esc_html__("EE%s (%s)", "event_espresso"),
+							$current_db_state[ $plugin_slug ] ?? 3,
+							$plugin_slug
+						),
+						'next_db_state'    => sprintf(
+							esc_html__("EE%s (%s)", 'event_espresso'),
+							$new_version,
+							$plugin_slug
+						),
+					]
+				);
+			} else {
+				$this->_template_args['current_db_state'] = '';
+				$this->_template_args['next_db_state']    = '';
+			}
+			$this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_migration_page.template.php';
+			$this->_template_args = array_merge(
+				$this->_template_args,
+				[
+					'show_most_recent_migration'             => $show_most_recent_migration,
+					// flag for showing the most recent migration's status and/or errors
+					'show_migration_progress'                => $show_migration_progress,
+					// flag for showing the option to run migrations and see their progress
+					'show_backup_db_text'                    => $show_backup_db_text,
+					// flag for showing text telling the user to back up their DB
+					'show_maintenance_switch'                => $show_maintenance_switch,
+					// flag for showing the option to change maintenance mode between levels 0 and 1
+					'script_names'                           => $script_names,
+					// array of names of scripts that have run
+					'show_continue_current_migration_script' => $show_continue_current_migration_script,
+					// flag to change wording to indicating that we're only CONTINUING a migration script (somehow it got interrupted0
+					'reset_db_page_link'                     => EE_Admin_Page::add_query_args_and_nonce(
+						['action' => 'reset_db'],
+						EE_MAINTENANCE_ADMIN_URL
+					),
+					'data_reset_page'                        => EE_Admin_Page::add_query_args_and_nonce(
+						['action' => 'data_reset'],
+						EE_MAINTENANCE_ADMIN_URL
+					),
+					'update_migration_script_page_link'      => EE_Admin_Page::add_query_args_and_nonce(
+						['action' => 'change_maintenance_level'],
+						EE_MAINTENANCE_ADMIN_URL
+					),
+					'ultimate_db_state'                      => sprintf(
+						esc_html__("EE%s", 'event_espresso'),
+						espresso_version()
+					),
+					'real_level'                             => $this->maintenance_mode->real_level(),
+				]
+			);
+		}
+		$this->_template_args['most_recent_migration'] =
+			$most_recent_migration;// the actual most recently ran migration
+		// now render the migration options part, and put it in a variable
+		$migration_options_template_file                = apply_filters(
+			'FHEE__ee_migration_page__migration_options_template',
+			EE_MAINTENANCE_TEMPLATE_PATH . 'migration_options_from_ee4.template.php'
+		);
+		$migration_options_html                         = EEH_Template::display_template(
+			$migration_options_template_file,
+			$this->_template_args,
+			true
+		);
+		$this->_template_args['migration_options_html'] = $migration_options_html;
+		$this->_template_args['admin_page_content']     = EEH_Template::display_template(
+			$this->_template_path,
+			$this->_template_args,
+			true
+		);
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	/**
+	 * returns JSON and executes another step of the currently-executing data migration (called via ajax)
+	 *
+	 * @throws EE_Error
+	 */
+	public function migration_step()
+	{
+		if (! $this->capabilities->current_user_can('manage_options', __FUNCTION__)) {
+			wp_die(esc_html__('You do not have the required privileges to perform this action', 'event_espresso'));
+		}
+		$this->_template_args['data'] = $this->migration_manager->response_to_migration_ajax_request();
+		$this->_return_json();
+	}
+
+
+	/**
+	 * Can be used by js when it notices a response with HTML in it in order
+	 * to log the malformed response
+	 *
+	 * @throws EE_Error
+	 */
+	public function add_error_to_migrations_ran()
+	{
+		$this->migration_manager->add_error_to_migrations_ran($this->_req_data['message']);
+		$this->_template_args['data'] = ['ok' => true];
+		$this->_return_json();
+	}
+
+
+	/**
+	 * changes the maintenance level, provided there are still no migration scripts that should run
+	 *
+	 * @throws EE_Error
+	 */
+	public function _change_maintenance_level()
+	{
+		$new_level = absint($this->_req_data['maintenance_mode_level']);
+		if (! $this->migration_manager->check_for_applicable_data_migration_scripts()) {
+			$this->maintenance_mode->set_maintenance_level($new_level);
+			$success = true;
+		} else {
+			$this->maintenance_mode->set_maintenance_mode_if_db_old();
+			$success = false;
+		}
+		$this->_redirect_after_action($success, 'Maintenance Mode', esc_html__("Updated", "event_espresso"));
+	}
+
+
+	/**
+	 * a tab with options for resetting and/or deleting EE data
+	 *
+	 * @throws EE_Error
+	 * @throws DomainException
+	 */
+	public function _data_reset_and_delete()
+	{
+		$this->_template_path                              =
+			EE_MAINTENANCE_TEMPLATE_PATH . 'ee_data_reset_and_delete.template.php';
+		$this->_template_args['reset_reservations_button'] = $this->get_action_link_or_button(
+			'reset_reservations',
+			'reset_reservations',
+			[],
+			'button button--caution ee-confirm'
+		);
+		$this->_template_args['reset_capabilities_button'] = $this->get_action_link_or_button(
+			'reset_capabilities',
+			'reset_capabilities',
+			[],
+			'button button--caution ee-confirm'
+		);
+		$this->_template_args['delete_db_url']             = EE_Admin_Page::add_query_args_and_nonce(
+			['action' => 'delete_db'],
+			EE_MAINTENANCE_ADMIN_URL
+		);
+		$this->_template_args['reset_db_url']              = EE_Admin_Page::add_query_args_and_nonce(
+			['action' => 'reset_db'],
+			EE_MAINTENANCE_ADMIN_URL
+		);
+		$this->_template_args['admin_page_content']        = EEH_Template::display_template(
+			$this->_template_path,
+			$this->_template_args,
+			true
+		);
+		$this->display_admin_page_with_no_sidebar();
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _reset_reservations()
+	{
+		if (EED_Ticket_Sales_Monitor::reset_reservation_counts()) {
+			EE_Error::add_success(
+				esc_html__(
+					'Ticket and datetime reserved counts have been successfully reset.',
+					'event_espresso'
+				)
+			);
+		} else {
+			EE_Error::add_success(
+				esc_html__(
+					'Ticket and datetime reserved counts were correct and did not need resetting.',
+					'event_espresso'
+				)
+			);
+		}
+		$this->_redirect_after_action(true, '', '', ['action' => 'data_reset'], true);
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 */
+	protected function _reset_capabilities()
+	{
+		$this->capabilities->init_caps(true);
+		EE_Error::add_success(
+			esc_html__(
+				'Default Event Espresso capabilities have been restored for all current roles.',
+				'event_espresso'
+			)
+		);
+		$this->_redirect_after_action(false, '', '', ['action' => 'data_reset'], true);
+	}
+
+
+	/**
+	 * resets the DMSs, so we can attempt to continue migrating after a fatal error
+	 * (only a good idea when someone has somehow tried ot fix whatever caused
+	 * the fatal error in teh first place)
+	 *
+	 * @throws EE_Error
+	 */
+	protected function _reattempt_migration()
+	{
+		$this->migration_manager->reattempt();
+		$this->_redirect_after_action(false, '', '', ['action' => 'default'], true);
+	}
+
+
+	/**
+	 * shows the big ol' System Information page
+	 *
+	 * @throws EE_Error
+	 */
+	public function _system_status()
+	{
+		$this->_template_path                               =
+			EE_MAINTENANCE_TEMPLATE_PATH . 'ee_system_stati_page.template.php';
+		$this->_template_args['system_stati']               = EEM_System_Status::instance()->get_system_stati();
+		$this->_template_args['download_system_status_url'] = EE_Admin_Page::add_query_args_and_nonce(
+			[
+				'action' => 'download_system_status',
+			],
+			EE_MAINTENANCE_ADMIN_URL
+		);
+		$this->_template_args['admin_page_content']         = EEH_Template::display_template(
+			$this->_template_path,
+			$this->_template_args,
+			true
+		);
+		$this->display_admin_page_with_no_sidebar();
+	}
+
+
+	/**
+	 * Downloads an HTML file of the system status that can be easily stored or emailed
+	 */
+	public function _download_system_status()
+	{
+		$status_info = EEM_System_Status::instance()->get_system_stati();
+		header('Content-Disposition: attachment');
+		header("Content-Disposition: attachment; filename=system_status_" . sanitize_key(site_url()) . ".html");
+		$output = '<style>table{border:1px solid darkgrey;}td{vertical-align:top}</style>';
+		$output .= '<h1>' . sprintf(
+			__('System Information for %1$s', 'event_espresso'),
+			esc_url_raw(site_url())
+		) . '</h1>';
+		$output .= EEH_Template::layout_array_as_table($status_info);
+		echo esc_html($output);
+		die;
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 */
+	public function _send_migration_crash_report()
+	{
+		$from      = $this->_req_data['from'];
+		$from_name = $this->_req_data['from_name'];
+		$body      = $this->_req_data['body'];
+		try {
+			$success = wp_mail(
+				EE_SUPPORT_EMAIL,
+				'Migration Crash Report',
+				$body . "/r/n<br>" . print_r(EEM_System_Status::instance()->get_system_stati(), true),
+				[
+					"from:$from_name<$from>",
+				]
+			);
+		} catch (Exception $e) {
+			$success = false;
+		}
+		$this->_redirect_after_action(
+			$success,
+			esc_html__("Migration Crash Report", "event_espresso"),
+			esc_html__("sent", "event_espresso"),
+			['success' => $success, 'action' => 'confirm_migration_crash_report_sent']
+		);
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 */
+	public function _confirm_migration_crash_report_sent()
+	{
+		try {
+			$most_recent_migration = $this->migration_manager->get_last_ran_script(true);
+		} catch (EE_Error $e) {
+			$this->migration_manager->add_error_to_migrations_ran($e->getMessage());
+			// now, just so we can display the page correctly, make an error migration script stage object
+			// and also put the error on it. It only persists for the duration of this request
+			$most_recent_migration = new EE_DMS_Unknown_1_0_0();
+			$most_recent_migration->add_error($e->getMessage());
+		}
+		$success                                       = $this->_req_data['success'] === '1';
+		$this->_template_args['success']               = $success;
+		$this->_template_args['most_recent_migration'] = $most_recent_migration;
+		$this->_template_args['reset_db_action_url']   = EE_Admin_Page::add_query_args_and_nonce(
+			['action' => 'reset_db'],
+			EE_MAINTENANCE_ADMIN_URL
+		);
+		$this->_template_args['reset_db_page_url']     = EE_Admin_Page::add_query_args_and_nonce(
+			['action' => 'data_reset'],
+			EE_MAINTENANCE_ADMIN_URL
+		);
+		$this->_template_args['reattempt_action_url']  = EE_Admin_Page::add_query_args_and_nonce(
+			['action' => 'reattempt_migration'],
+			EE_MAINTENANCE_ADMIN_URL
+		);
+		$this->_template_path                          =
+			EE_MAINTENANCE_TEMPLATE_PATH . 'ee_confirm_migration_crash_report_sent.template.php';
+		$this->_template_args['admin_page_content']    = EEH_Template::display_template(
+			$this->_template_path,
+			$this->_template_args,
+			true
+		);
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	/**
+	 * Resets the entire EE4 database.
+	 * only sets up ee4 database for a fresh install-
+	 * doesn't actually clean out the old wp options, or cpts
+	 * (although it does erase old ee table data)
+	 *
+	 * @param boolean $nuke_old_ee4_data controls whether we destroy the old ee4 data,
+	 *                                   or just try initializing ee4 default data
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function _reset_db($nuke_old_ee4_data = true)
+	{
+		$this->maintenance_mode->set_maintenance_level(EE_Maintenance_Mode::STATUS_OFF);
+		if ($nuke_old_ee4_data) {
+			EEH_Activation::delete_all_espresso_cpt_data();
+			EEH_Activation::delete_all_espresso_tables_and_data(false);
+			EEH_Activation::remove_cron_tasks();
+		}
+		// make sure when we reset the registry's config that it
+		// switches to using the new singleton
+		EE_Registry::instance()->CFG = EE_Registry::instance()->CFG->reset(true);
+		EE_System::instance()->initialize_db_if_no_migrations_required(true);
+		EE_System::instance()->redirect_to_about_ee();
+	}
+
+
+	/**
+	 * Deletes ALL EE tables, Records, and Options from the database.
+	 *
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function _delete_db()
+	{
+		$this->maintenance_mode->set_maintenance_level(EE_Maintenance_Mode::STATUS_OFF);
+		EEH_Activation::delete_all_espresso_cpt_data();
+		EEH_Activation::delete_all_espresso_tables_and_data();
+		EEH_Activation::remove_cron_tasks();
+		EEH_Activation::deactivate_event_espresso();
+		wp_safe_redirect(admin_url('plugins.php'));
+		exit;
+	}
+
+
+	/**
+	 * sets up EE4 to rerun the migrations from ee3 to ee4
+	 *
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function _rerun_migration_from_ee3()
+	{
+		$this->maintenance_mode->set_maintenance_level(EE_Maintenance_Mode::STATUS_OFF);
+		EEH_Activation::delete_all_espresso_cpt_data();
+		EEH_Activation::delete_all_espresso_tables_and_data(false);
+		// set the db state to something that will require migrations
+		update_option(EE_Data_Migration_Manager::current_database_state, '3.1.36.0');
+		$this->maintenance_mode->set_maintenance_level(EE_Maintenance_Mode::STATUS_FULL_SITE);
+		$this->_redirect_after_action(
+			true,
+			esc_html__("Database", 'event_espresso'),
+			esc_html__("reset", 'event_espresso')
+		);
+	}
+
+
+	// none of the below group are currently used for Gateway Settings
+	protected function _add_screen_options()
+	{
+	}
+
+
+	protected function _add_feature_pointers()
+	{
+	}
+
+
+	public function admin_init()
+	{
+	}
+
+
+	public function admin_notices()
+	{
+	}
+
+
+	public function admin_footer_scripts()
+	{
+	}
+
+
+	public function load_scripts_styles()
+	{
+		wp_enqueue_script('ee_admin_js');
+		wp_enqueue_script(
+			'ee-maintenance',
+			EE_MAINTENANCE_ASSETS_URL . 'ee-maintenance.js',
+			['jquery'],
+			EVENT_ESPRESSO_VERSION,
+			true
+		);
+		wp_register_style(
+			'espresso_maintenance',
+			EE_MAINTENANCE_ASSETS_URL . 'ee-maintenance.css',
+			[],
+			EVENT_ESPRESSO_VERSION
+		);
+		wp_enqueue_style('espresso_maintenance');
+		// localize script stuff
+		wp_localize_script(
+			'ee-maintenance',
+			'ee_maintenance',
+			[
+				'migrating'                        => wp_strip_all_tags(__("Updating Database...", "event_espresso")),
+				'next'                             => wp_strip_all_tags(__("Next", "event_espresso")),
+				'fatal_error'                      => wp_strip_all_tags(
+					__(
+						"A Fatal Error Has Occurred",
+						"event_espresso"
+					)
+				),
+				'click_next_when_ready'            => wp_strip_all_tags(
+					__(
+						"The current Database Update has ended. Click 'next' when ready to proceed",
+						"event_espresso"
+					)
+				),
+				'status_no_more_migration_scripts' => EE_Data_Migration_Manager::status_no_more_migration_scripts,
+				'status_fatal_error'               => EE_Data_Migration_Manager::status_fatal_error,
+				'status_completed'                 => EE_Data_Migration_Manager::status_completed,
+				'confirm'                          => wp_strip_all_tags(
+					__(
+						'Are you sure you want to do this? It CANNOT be undone!',
+						'event_espresso'
+					)
+				),
+				'confirm_skip_migration'           => wp_strip_all_tags(
+					__(
+						'You have chosen to NOT migrate your existing data. Are you sure you want to continue?',
+						'event_espresso'
+					)
+				),
+			]
+		);
+	}
+
+
+	public function load_scripts_styles_default()
+	{
+	}
+
+
+	/**
+	 * Enqueue scripts and styles for the datetime tools page.
+	 */
+	public function load_scripts_styles_datetime_tools()
+	{
+		EE_Datepicker_Input::enqueue_styles_and_scripts();
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 */
+	protected function _datetime_tools()
+	{
+		$form_action                                = EE_Admin_Page::add_query_args_and_nonce(
+			[
+				'action'        => 'run_datetime_offset_fix',
+				'return_action' => $this->_req_action,
+			],
+			EE_MAINTENANCE_ADMIN_URL
+		);
+		$form                                       = $this->_get_datetime_offset_fix_form();
+		$this->_admin_page_title                    = esc_html__('Datetime Utilities', 'event_espresso');
+		$this->_template_args['admin_page_content'] = $form->form_open($form_action, 'post')
+													  . $form->get_html_and_js()
+													  . $form->form_close();
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 */
+	protected function _get_datetime_offset_fix_form()
+	{
+		if (! $this->datetime_fix_offset_form instanceof EE_Form_Section_Proper) {
+			$this->datetime_fix_offset_form = new EE_Form_Section_Proper(
+				[
+					'name'            => 'datetime_offset_fix_option',
+					'layout_strategy' => new EE_Admin_Two_Column_Layout(),
+					'subsections'     => [
+						'title'                  => new EE_Form_Section_HTML(
+							EEH_HTML::h2(
+								esc_html__('Datetime Offset Tool', 'event_espresso')
+							)
+						),
+						'explanation'            => new EE_Form_Section_HTML(
+							EEH_HTML::p(
+								esc_html__(
+									'Use this tool to automatically apply the provided offset to all Event Espresso records in your database that involve dates and times.',
+									'event_espresso'
+								)
+							)
+							. EEH_HTML::p(
+								esc_html__(
+									'Note: If you enter 1.25, that will result in the offset of 1 hour 15 minutes being applied.  Decimals represent the fraction of hours, not minutes.',
+									'event_espresso'
+								)
+							)
+						),
+						'offset_input'           => new EE_Float_Input(
+							[
+								'html_name'       => 'offset_for_datetimes',
+								'html_label_text' => esc_html__(
+									'Offset to apply (in hours):',
+									'event_espresso'
+								),
+								'min_value'       => '-12',
+								'max_value'       => '14',
+								'step_value'      => '.25',
+								'default'         => DatetimeOffsetFix::getOffset(),
+							]
+						),
+						'date_range_explanation' => new EE_Form_Section_HTML(
+							EEH_HTML::p(
+								esc_html__(
+									'Leave the following fields blank if you want the offset to be applied to all dates. If however, you want to just apply the offset to a specific range of dates you can restrict the offset application using these fields.',
+									'event_espresso'
+								)
+							)
+							. EEH_HTML::p(
+								EEH_HTML::strong(
+									sprintf(
+										esc_html__(
+											'Note: please enter the dates in UTC (You can use %1$sthis online tool%2$s to assist with conversions).',
+											'event_espresso'
+										),
+										'<a href="https://www.timeanddate.com/worldclock/converter.html">',
+										'</a>'
+									)
+								)
+							)
+						),
+						'date_range_start_date'  => new EE_Datepicker_Input(
+							[
+								'html_name'       => 'offset_date_start_range',
+								'html_label_text' => esc_html__(
+									'Start Date for dates the offset applied to:',
+									'event_espresso'
+								),
+							]
+						),
+						'date_range_end_date'    => new EE_Datepicker_Input(
+							[
+								'html_name'       => 'offset_date_end_range',
+								'html_label_text' => esc_html__(
+									'End Date for dates the offset is applied to:',
+									'event_espresso'
+								),
+							]
+						),
+						'submit'                 => new EE_Submit_Input(
+							[
+								'html_label_text' => '',
+								'default'         => esc_html__('Apply Offset', 'event_espresso'),
+							]
+						),
+					],
+				]
+			);
+		}
+		return $this->datetime_fix_offset_form;
+	}
+
+
+	/**
+	 * Callback for the run_datetime_offset_fix route.
+	 *
+	 * @throws EE_Error
+	 */
+	protected function _apply_datetime_offset()
+	{
+		if ($_SERVER['REQUEST_METHOD'] === 'POST') {
+			$form = $this->_get_datetime_offset_fix_form();
+			$form->receive_form_submission($this->_req_data);
+			if ($form->is_valid()) {
+				// save offset data so batch processor can get it.
+				DatetimeOffsetFix::updateOffset((float) $form->get_input_value('offset_input'));
+				$utc_timezone          = new DateTimeZone('UTC');
+				$date_range_start_date = DateTime::createFromFormat(
+					'm/d/Y H:i:s',
+					$form->get_input_value('date_range_start_date') . ' 00:00:00',
+					$utc_timezone
+				);
+				$date_range_end_date   = DateTime::createFromFormat(
+					'm/d/Y H:i:s',
+					$form->get_input_value('date_range_end_date') . ' 23:59:59',
+					$utc_timezone
+				);
+				if ($date_range_start_date instanceof DateTime) {
+					DatetimeOffsetFix::updateStartDateRange(DbSafeDateTime::createFromDateTime($date_range_start_date));
+				}
+				if ($date_range_end_date instanceof DateTime) {
+					DatetimeOffsetFix::updateEndDateRange(DbSafeDateTime::createFromDateTime($date_range_end_date));
+				}
+				// redirect to batch tool
+				wp_redirect(
+					EE_Admin_Page::add_query_args_and_nonce(
+						[
+							'page'        => EED_Batch::PAGE_SLUG,
+							'batch'       => EED_Batch::batch_job,
+							'label'       => esc_html__('Applying Offset', 'event_espresso'),
+							'job_handler' => urlencode('EventEspresso\core\libraries\batch\JobHandlers\DatetimeOffsetFix'),
+							'return_url'  => urlencode(
+								add_query_arg(
+									[
+										'action' => 'datetime_tools',
+									],
+									EEH_URL::current_url_without_query_paramaters(
+										[
+											'return_action',
+											'run_datetime_offset_fix_nonce',
+											'return',
+											'datetime_tools_nonce',
+										]
+									)
+								)
+							),
+						],
+						admin_url()
+					)
+				);
+				exit;
+			}
+		}
+	}
 }

admin_pages/payments/Payments_Admin_Page.core.php

Indentation +1295 added lines, -1295 removed lines

@@ -18,286 +18,286 @@ 
  */
 class Payments_Admin_Page extends EE_Admin_Page
 {
-    /**
-     * Variables used for when we're re-sorting the logs results,
-     * in case we needed to do two queries, and we need to resort
-     *
-     * @var string
-     */
-    private $_sort_logs_again_direction;
-
-
-    /**
-     * @Constructor
-     * @access public
-     * @param bool $routing indicate whether we want to just load the object and handle routing or just load the object.
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    public function __construct($routing = true)
-    {
-        parent::__construct($routing);
-    }
-
-
-    protected function _init_page_props()
-    {
-        $this->page_slug        = EE_PAYMENTS_PG_SLUG;
-        $this->page_label       = esc_html__('Payment Methods', 'event_espresso');
-        $this->_admin_base_url  = EE_PAYMENTS_ADMIN_URL;
-        $this->_admin_base_path = EE_PAYMENTS_ADMIN;
-    }
-
-
-    protected function _ajax_hooks()
-    {
-        // todo: all hooks for ajax goes here.
-    }
-
-
-    protected function _define_page_props()
-    {
-        $this->_admin_page_title = $this->page_label;
-        $this->_labels           = [
-            'publishbox' => esc_html__('Update Settings', 'event_espresso'),
-        ];
-    }
-
-
-    /**
-     * @param string $sort_logs_again_direction
-     */
-    public function setSortLogsAgainDirection(string $sort_logs_again_direction): void
-    {
-        $this->_sort_logs_again_direction = $sort_logs_again_direction;
-    }
-
-
-    protected function _set_page_routes()
-    {
-        /**
-         * note that with payment method capabilities, although we've implemented
-         * capability mapping which will be used for accessing payment methods owned by
-         * other users.  This is not fully implemented yet in the payment method ui.
-         * Currently, only the "plural" caps are in active use.
-         * When cap mapping is implemented, some routes will need to use the singular form of
-         * capability method and also include the $id of the payment method for the route.
-         **/
-        $this->_page_routes = [
-            'default'                   => [
-                'func'       => [$this, '_payment_methods_list'],
-                'capability' => 'ee_edit_payment_methods',
-            ],
-            'payment_settings'          => [
-                'func'       => [$this, '_payment_settings'],
-                'capability' => 'ee_manage_gateways',
-            ],
-            'activate_payment_method'   => [
-                'func'       => [$this, '_activate_payment_method'],
-                'noheader'   => true,
-                'capability' => 'ee_edit_payment_methods',
-            ],
-            'deactivate_payment_method' => [
-                'func'       => [$this, '_deactivate_payment_method'],
-                'noheader'   => true,
-                'capability' => 'ee_delete_payment_methods',
-            ],
-            'update_payment_method'     => [
-                'func'       => [$this, '_update_payment_method'],
-                'noheader'           => true,
-                'headers_sent_route' => 'default',
-                'capability'         => 'ee_edit_payment_methods',
-            ],
-            'update_payment_settings'   => [
-                'func'       => [$this, '_update_payment_settings'],
-                'noheader'   => true,
-                'capability' => 'ee_manage_gateways',
-            ],
-            'payment_log'               => [
-                'func'       => [$this, '_payment_log_overview_list_table'],
-                'capability' => 'ee_read_payment_methods',
-            ],
-            'payment_log_details'       => [
-                'func'       => [$this, '_payment_log_details'],
-                'capability' => 'ee_read_payment_methods',
-            ],
-        ];
-    }
-
-
-    /**
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _set_page_config()
-    {
-        $payment_method_list_config = [
-            'nav'           => [
-                'label' => esc_html__('Payment Methods', 'event_espresso'),
-                'icon'  => 'dashicons-bank',
-                'order' => 10,
-            ],
-            'metaboxes'     => $this->_default_espresso_metaboxes,
-            'help_tabs'     => array_merge(
-                [
-                    'payment_methods_overview_help_tab' => [
-                        'title'    => esc_html__('Payment Methods Overview', 'event_espresso'),
-                        'filename' => 'payment_methods_overview',
-                    ],
-                ],
-                $this->_add_payment_method_help_tabs()
-            ),
-            'require_nonce' => false,
-        ];
-        $this->_page_config         = [
-            'default'          => $payment_method_list_config,
-            'payment_settings' => [
-                'nav'           => [
-                    'label' => esc_html__('Settings', 'event_espresso'),
-                    'icon'  => 'dashicons-admin-generic',
-                    'order' => 20,
-                ],
-                'help_tabs'     => [
-                    'payment_methods_settings_help_tab' => [
-                        'title'    => esc_html__('Payment Method Settings', 'event_espresso'),
-                        'filename' => 'payment_methods_settings',
-                    ],
-                ],
-                'metaboxes'     => array_merge($this->_default_espresso_metaboxes, ['_publish_post_box']),
-                'require_nonce' => false,
-            ],
-            'payment_log'      => [
-                'nav'           => [
-                    'label' => esc_html__("Logs", 'event_espresso'),
-                    'icon'  => 'dashicons-text-page',
-                    'order' => 30,
-                ],
-                'list_table'    => 'Payment_Log_Admin_List_Table',
-                'metaboxes'     => $this->_default_espresso_metaboxes,
-                'require_nonce' => false,
-            ],
-        ];
-    }
-
-
-    /**
-     * @return array
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    protected function _add_payment_method_help_tabs(): array
-    {
-        EE_Registry::instance()->load_lib('Payment_Method_Manager');
-        $payment_method_types     = EE_Payment_Method_Manager::instance()->payment_method_types();
-        $all_pmt_help_tabs_config = [];
-        foreach ($payment_method_types as $payment_method_type) {
-            if (
-                ! $this->capabilities->current_user_can(
-                    $payment_method_type->cap_name(),
-                    'specific_payment_method_type_access'
-                )
-            ) {
-                continue;
-            }
-            foreach ($payment_method_type->help_tabs_config() as $help_tab_name => $config) {
-                $template_args                              = $config['template_args'] ?? [];
-                $template_args['admin_page_obj']            = $this;
-                $all_pmt_help_tabs_config[ $help_tab_name ] = [
-                    'title'   => $config['title'],
-                    'content' => EEH_Template::display_template(
-                        $payment_method_type->file_folder() . 'help_tabs/' . $config['filename'] . '.help_tab.php',
-                        $template_args,
-                        true
-                    ),
-                ];
-            }
-        }
-        return $all_pmt_help_tabs_config;
-    }
-
-
-    // none of the below group are currently used for Gateway Settings
-    protected function _add_screen_options()
-    {
-    }
-
-
-    protected function _add_feature_pointers()
-    {
-    }
-
-
-    public function admin_init()
-    {
-    }
-
-
-    public function admin_notices()
-    {
-    }
-
-
-    public function admin_footer_scripts()
-    {
-    }
-
-
-    public function load_scripts_styles()
-    {
-        // styles
-        wp_enqueue_style('espresso-ui-theme');
-        wp_register_style(
-            'espresso_payments',
-            EE_PAYMENTS_ASSETS_URL . 'ee-payments.css',
-            [],
-            EVENT_ESPRESSO_VERSION
-        );
-        // scripts
-        wp_enqueue_script('ee_admin_js');
-        wp_enqueue_script('ee-text-links');
-        wp_enqueue_script(
-            'espresso_payments',
-            EE_PAYMENTS_ASSETS_URL . 'espresso_payments_admin.js',
-            ['ee-datepicker'],
-            EVENT_ESPRESSO_VERSION,
-            true
-        );
-    }
-
-
-    public function load_scripts_styles_default()
-    {
-        wp_enqueue_style('espresso_payments');
-        wp_enqueue_style('ee-text-links');
-    }
-
-
-    public function load_scripts_styles_payment_log_details()
-    {
-        wp_enqueue_style('espresso_payments');
-    }
-
-
-    /**
-     * @throws EE_Error
-     */
-    private function veryifyTablesExist()
-    {
-        /** @var TableAnalysis $table_analysis */
-        $table_analysis = LoaderFactory::getShared(TableAnalysis::class);
-        /** @var TableManager $table_manager */
-        $table_manager = LoaderFactory::getShared(TableManager::class);
-        if (! $table_analysis->tableExists('esp_payment_method')) {
-            $table_manager->createTable(
-                'esp_payment_method',
-                "PMD_ID int(11) NOT NULL AUTO_INCREMENT,
+	/**
+	 * Variables used for when we're re-sorting the logs results,
+	 * in case we needed to do two queries, and we need to resort
+	 *
+	 * @var string
+	 */
+	private $_sort_logs_again_direction;
+
+
+	/**
+	 * @Constructor
+	 * @access public
+	 * @param bool $routing indicate whether we want to just load the object and handle routing or just load the object.
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	public function __construct($routing = true)
+	{
+		parent::__construct($routing);
+	}
+
+
+	protected function _init_page_props()
+	{
+		$this->page_slug        = EE_PAYMENTS_PG_SLUG;
+		$this->page_label       = esc_html__('Payment Methods', 'event_espresso');
+		$this->_admin_base_url  = EE_PAYMENTS_ADMIN_URL;
+		$this->_admin_base_path = EE_PAYMENTS_ADMIN;
+	}
+
+
+	protected function _ajax_hooks()
+	{
+		// todo: all hooks for ajax goes here.
+	}
+
+
+	protected function _define_page_props()
+	{
+		$this->_admin_page_title = $this->page_label;
+		$this->_labels           = [
+			'publishbox' => esc_html__('Update Settings', 'event_espresso'),
+		];
+	}
+
+
+	/**
+	 * @param string $sort_logs_again_direction
+	 */
+	public function setSortLogsAgainDirection(string $sort_logs_again_direction): void
+	{
+		$this->_sort_logs_again_direction = $sort_logs_again_direction;
+	}
+
+
+	protected function _set_page_routes()
+	{
+		/**
+		 * note that with payment method capabilities, although we've implemented
+		 * capability mapping which will be used for accessing payment methods owned by
+		 * other users.  This is not fully implemented yet in the payment method ui.
+		 * Currently, only the "plural" caps are in active use.
+		 * When cap mapping is implemented, some routes will need to use the singular form of
+		 * capability method and also include the $id of the payment method for the route.
+		 **/
+		$this->_page_routes = [
+			'default'                   => [
+				'func'       => [$this, '_payment_methods_list'],
+				'capability' => 'ee_edit_payment_methods',
+			],
+			'payment_settings'          => [
+				'func'       => [$this, '_payment_settings'],
+				'capability' => 'ee_manage_gateways',
+			],
+			'activate_payment_method'   => [
+				'func'       => [$this, '_activate_payment_method'],
+				'noheader'   => true,
+				'capability' => 'ee_edit_payment_methods',
+			],
+			'deactivate_payment_method' => [
+				'func'       => [$this, '_deactivate_payment_method'],
+				'noheader'   => true,
+				'capability' => 'ee_delete_payment_methods',
+			],
+			'update_payment_method'     => [
+				'func'       => [$this, '_update_payment_method'],
+				'noheader'           => true,
+				'headers_sent_route' => 'default',
+				'capability'         => 'ee_edit_payment_methods',
+			],
+			'update_payment_settings'   => [
+				'func'       => [$this, '_update_payment_settings'],
+				'noheader'   => true,
+				'capability' => 'ee_manage_gateways',
+			],
+			'payment_log'               => [
+				'func'       => [$this, '_payment_log_overview_list_table'],
+				'capability' => 'ee_read_payment_methods',
+			],
+			'payment_log_details'       => [
+				'func'       => [$this, '_payment_log_details'],
+				'capability' => 'ee_read_payment_methods',
+			],
+		];
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _set_page_config()
+	{
+		$payment_method_list_config = [
+			'nav'           => [
+				'label' => esc_html__('Payment Methods', 'event_espresso'),
+				'icon'  => 'dashicons-bank',
+				'order' => 10,
+			],
+			'metaboxes'     => $this->_default_espresso_metaboxes,
+			'help_tabs'     => array_merge(
+				[
+					'payment_methods_overview_help_tab' => [
+						'title'    => esc_html__('Payment Methods Overview', 'event_espresso'),
+						'filename' => 'payment_methods_overview',
+					],
+				],
+				$this->_add_payment_method_help_tabs()
+			),
+			'require_nonce' => false,
+		];
+		$this->_page_config         = [
+			'default'          => $payment_method_list_config,
+			'payment_settings' => [
+				'nav'           => [
+					'label' => esc_html__('Settings', 'event_espresso'),
+					'icon'  => 'dashicons-admin-generic',
+					'order' => 20,
+				],
+				'help_tabs'     => [
+					'payment_methods_settings_help_tab' => [
+						'title'    => esc_html__('Payment Method Settings', 'event_espresso'),
+						'filename' => 'payment_methods_settings',
+					],
+				],
+				'metaboxes'     => array_merge($this->_default_espresso_metaboxes, ['_publish_post_box']),
+				'require_nonce' => false,
+			],
+			'payment_log'      => [
+				'nav'           => [
+					'label' => esc_html__("Logs", 'event_espresso'),
+					'icon'  => 'dashicons-text-page',
+					'order' => 30,
+				],
+				'list_table'    => 'Payment_Log_Admin_List_Table',
+				'metaboxes'     => $this->_default_espresso_metaboxes,
+				'require_nonce' => false,
+			],
+		];
+	}
+
+
+	/**
+	 * @return array
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	protected function _add_payment_method_help_tabs(): array
+	{
+		EE_Registry::instance()->load_lib('Payment_Method_Manager');
+		$payment_method_types     = EE_Payment_Method_Manager::instance()->payment_method_types();
+		$all_pmt_help_tabs_config = [];
+		foreach ($payment_method_types as $payment_method_type) {
+			if (
+				! $this->capabilities->current_user_can(
+					$payment_method_type->cap_name(),
+					'specific_payment_method_type_access'
+				)
+			) {
+				continue;
+			}
+			foreach ($payment_method_type->help_tabs_config() as $help_tab_name => $config) {
+				$template_args                              = $config['template_args'] ?? [];
+				$template_args['admin_page_obj']            = $this;
+				$all_pmt_help_tabs_config[ $help_tab_name ] = [
+					'title'   => $config['title'],
+					'content' => EEH_Template::display_template(
+						$payment_method_type->file_folder() . 'help_tabs/' . $config['filename'] . '.help_tab.php',
+						$template_args,
+						true
+					),
+				];
+			}
+		}
+		return $all_pmt_help_tabs_config;
+	}
+
+
+	// none of the below group are currently used for Gateway Settings
+	protected function _add_screen_options()
+	{
+	}
+
+
+	protected function _add_feature_pointers()
+	{
+	}
+
+
+	public function admin_init()
+	{
+	}
+
+
+	public function admin_notices()
+	{
+	}
+
+
+	public function admin_footer_scripts()
+	{
+	}
+
+
+	public function load_scripts_styles()
+	{
+		// styles
+		wp_enqueue_style('espresso-ui-theme');
+		wp_register_style(
+			'espresso_payments',
+			EE_PAYMENTS_ASSETS_URL . 'ee-payments.css',
+			[],
+			EVENT_ESPRESSO_VERSION
+		);
+		// scripts
+		wp_enqueue_script('ee_admin_js');
+		wp_enqueue_script('ee-text-links');
+		wp_enqueue_script(
+			'espresso_payments',
+			EE_PAYMENTS_ASSETS_URL . 'espresso_payments_admin.js',
+			['ee-datepicker'],
+			EVENT_ESPRESSO_VERSION,
+			true
+		);
+	}
+
+
+	public function load_scripts_styles_default()
+	{
+		wp_enqueue_style('espresso_payments');
+		wp_enqueue_style('ee-text-links');
+	}
+
+
+	public function load_scripts_styles_payment_log_details()
+	{
+		wp_enqueue_style('espresso_payments');
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 */
+	private function veryifyTablesExist()
+	{
+		/** @var TableAnalysis $table_analysis */
+		$table_analysis = LoaderFactory::getShared(TableAnalysis::class);
+		/** @var TableManager $table_manager */
+		$table_manager = LoaderFactory::getShared(TableManager::class);
+		if (! $table_analysis->tableExists('esp_payment_method')) {
+			$table_manager->createTable(
+				'esp_payment_method',
+				"PMD_ID int(11) NOT NULL AUTO_INCREMENT,
 				PMD_type varchar(124) DEFAULT NULL,
 				PMD_name varchar(255) DEFAULT NULL,
 				PMD_desc text,
@@ -313,1023 +313,1023 @@ 
 				PRIMARY KEY  (PMD_ID),
 				UNIQUE KEY PMD_slug_UNIQUE (PMD_slug),
 				KEY PMD_type (PMD_type)",
-                'InnoDB'
-            );
-        }
-        if (! $table_analysis->tableExists('esp_currency_payment_method')) {
-            $table_manager->createTable(
-                'esp_currency_payment_method',
-                "CPM_ID int(11) NOT NULL AUTO_INCREMENT,
+				'InnoDB'
+			);
+		}
+		if (! $table_analysis->tableExists('esp_currency_payment_method')) {
+			$table_manager->createTable(
+				'esp_currency_payment_method',
+				"CPM_ID int(11) NOT NULL AUTO_INCREMENT,
 				CUR_code varchar(6) NOT NULL,
 				PMD_ID int(11) NOT NULL,
 				PRIMARY KEY  (CPM_ID),
 				KEY PMD_ID (PMD_ID)",
-                'InnoDB'
-            );
-        }
-    }
-
-
-    /**
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _payment_methods_list()
-    {
-        $this->veryifyTablesExist();
-        /**
-         * first let's ensure payment methods have been set up.
-         * We do this here because when people activate a payment method for the first time (as an addon),
-         * it may not set up its capabilities or get registered correctly due to the loading process.
-         * However, people MUST set up the details for the payment method,
-         * so it's safe to do a recheck here.
-         */
-        EE_Registry::instance()->load_lib('Payment_Method_Manager');
-        EEM_Payment_Method::instance()->verify_button_urls();
-        // set up tabs, one for each payment method type
-        $tabs            = [];
-        $payment_methods = [];
-        foreach (EE_Payment_Method_Manager::instance()->payment_method_types() as $pmt_obj) {
-            // we don't want to show admin-only PMTs for now
-            if ($pmt_obj instanceof EE_PMT_Admin_Only) {
-                continue;
-            }
-            // check access
-            if (
-                ! $this->capabilities->current_user_can(
-                    $pmt_obj->cap_name(),
-                    'specific_payment_method_type_access'
-                )
-            ) {
-                continue;
-            }
-            // check for any active pms of that type
-            $payment_method = EEM_Payment_Method::instance()->get_one_of_type($pmt_obj->system_name());
-            if (! $payment_method instanceof EE_Payment_Method) {
-                $payment_method = EE_Payment_Method::new_instance(
-                    [
-                        'PMD_slug'       => sanitize_key($pmt_obj->system_name()),
-                        'PMD_type'       => $pmt_obj->system_name(),
-                        'PMD_name'       => $pmt_obj->pretty_name(),
-                        'PMD_admin_name' => $pmt_obj->pretty_name(),
-                    ]
-                );
-            }
-            $payment_methods[ $payment_method->slug() ] = $payment_method;
-        }
-        $payment_methods = apply_filters(
-            'FHEE__Payments_Admin_Page___payment_methods_list__payment_methods',
-            $payment_methods
-        );
-        foreach ($payment_methods as $payment_method) {
-            if ($payment_method instanceof EE_Payment_Method) {
-                $this->addMetaBox(
-                // html id
-                    'espresso_' . $payment_method->slug() . '_payment_settings',
-                    // title
-                    sprintf(esc_html__('%s Settings', 'event_espresso'), $payment_method->admin_name()),
-                    // callback
-                    [$this, 'payment_method_settings_meta_box'],
-                    // post type
-                    null,
-                    // context
-                    'normal',
-                    // priority
-                    'default',
-                    // callback args
-                    ['payment_method' => $payment_method]
-                );
-                // setup for tabbed content
-                $tabs[ $payment_method->slug() ] = [
-                    'label' => $payment_method->admin_name(),
-                    'class' => $payment_method->active()
-                        ? 'gateway-active'
-                        : '',
-                    'href'  => 'espresso_' . $payment_method->slug() . '_payment_settings',
-                    'title' => esc_html__('Modify this Payment Method', 'event_espresso'),
-                    'slug'  => $payment_method->slug(),
-                    'icon'  => $payment_method->active()
-                        ? '<span class="dashicons dashicons-yes-alt"></span>'
-                        : '<span class="dashicons dashicons-remove"></span>',
-                ];
-            }
-        }
-        $this->_template_args['admin_page_header'] = EEH_Tabbed_Content::tab_text_links(
-            $tabs,
-            'payment_method_links',
-            '',
-            $this->_get_active_payment_method_slug()
-        );
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    /**
-     *   _get_active_payment_method_slug
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _get_active_payment_method_slug()
-    {
-        $payment_method_slug = false;
-        // decide which payment method tab to open first, as dictated by the request's 'payment_method'
-        if (isset($this->_req_data['payment_method'])) {
-            // if they provided the current payment method, use it
-            $payment_method_slug = sanitize_key($this->_req_data['payment_method']);
-        }
-
-        $payment_method = EEM_Payment_Method::instance()->get_one([['PMD_slug' => $payment_method_slug]]);
-        // if that didn't work or wasn't provided, find another way to select the current pm
-        if (! $this->_verify_payment_method($payment_method)) {
-            // like, looking for an active one
-            $payment_method = EEM_Payment_Method::instance()->get_one_active(EEM_Payment_Method::scope_cart);
-            // test that one as well
-            if ($this->_verify_payment_method($payment_method)) {
-                $payment_method_slug = $payment_method->slug();
-            } else {
-                $payment_method_slug = 'paypal_standard';
-            }
-        }
-        return $payment_method_slug;
-    }
-
-
-    /**
-     *    payment_method_settings_meta_box
-     *    returns TRUE if the passed payment method is properly constructed and the logged-in user has the correct
-     *    capabilities to access it
-     *
-     * @param EE_Payment_Method|null $payment_method
-     * @return boolean
-     * @throws EE_Error
-     */
-    protected function _verify_payment_method(?EE_Payment_Method $payment_method): bool
-    {
-        return $payment_method instanceof EE_Payment_Method
-               && $payment_method->type_obj() instanceof EE_PMT_Base
-               && $this->capabilities->current_user_can(
-                   $payment_method->type_obj()->cap_name(),
-                   'specific_payment_method_type_access'
-               );
-    }
-
-
-    /**
-     *    payment_method_settings_meta_box
-     *
-     * @param NULL  $post_obj_which_is_null is an object containing the current post (as a $post object)
-     * @param array $metabox                is an array with metabox id, title, callback, and args elements. the value
-     *                                      at 'args' has key 'payment_method', as set within _payment_methods_list
-     * @return void
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function payment_method_settings_meta_box($post_obj_which_is_null, array $metabox)
-    {
-        $payment_method = isset($metabox['args'], $metabox['args']['payment_method'])
-            ? $metabox['args']['payment_method']
-            : null;
-        if (! $payment_method instanceof EE_Payment_Method) {
-            throw new EE_Error(
-                esc_html__(
-                    'Payment method metabox setup incorrectly. No Payment method object was supplied',
-                    'event_espresso'
-                )
-            );
-        }
-        $payment_method_scopes = $payment_method->active();
-        // if the payment method really exists show its form, otherwise the activation template
-        if ($payment_method->ID() && ! empty($payment_method_scopes)) {
-            $form = $this->_generate_payment_method_settings_form($payment_method);
-            if ($form->form_data_present_in($this->_req_data)) {
-                $form->receive_form_submission($this->_req_data);
-            }
-            echo wp_kses(
-                $form->form_open() . $form->get_html_and_js() . $form->form_close(),
-                AllowedTags::getWithFormTags()
-            );
-        } else {
-            echo wp_kses(
-                $this->_activate_payment_method_button($payment_method)->get_html_and_js(),
-                AllowedTags::getWithFormTags()
-            );
-        }
-    }
-
-
-    /**
-     * Gets the form for all the settings related to this payment method type
-     *
-     * @access protected
-     * @param EE_Payment_Method|null $payment_method
-     * @return EE_Form_Section_Proper
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _generate_payment_method_settings_form(
-        ?EE_Payment_Method $payment_method
-    ): EE_Form_Section_Proper {
-        if (! $payment_method instanceof EE_Payment_Method) {
-            return new EE_Form_Section_Proper();
-        }
-        $subsections = apply_filters(
-            'FHEE__Payments_Admin_Page___generate_payment_method_settings_form__form_subsections',
-            [
-                'pci_dss_compliance'      => $this->_pci_dss_compliance($payment_method),
-                'currency_support'        => $this->_currency_support($payment_method),
-                'payment_method_settings' => $this->_payment_method_settings($payment_method),
-                'update'                  => $this->_update_payment_method_button($payment_method),
-                'deactivate'              => $this->_deactivate_payment_method_button($payment_method),
-                'fine_print'              => $this->_fine_print(),
-            ],
-            $payment_method
-        );
-        return new EE_Form_Section_Proper(
-            [
-                'name'            => $payment_method->slug() . '_settings_form',
-                'html_id'         => $payment_method->slug() . '_settings_form',
-                'action'          => EE_Admin_Page::add_query_args_and_nonce(
-                    [
-                        'action'         => 'update_payment_method',
-                        'payment_method' => $payment_method->slug(),
-                    ],
-                    EE_PAYMENTS_ADMIN_URL
-                ),
-                'layout_strategy' => new EE_Admin_Two_Column_Layout(),
-                'subsections'     => array_filter($subsections),
-            ]
-        );
-    }
-
-
-    /**
-     * _pci_dss_compliance
-     *
-     * @access protected
-     * @param EE_Payment_Method $payment_method
-     * @return EE_Form_Section_HTML|null
-     * @throws EE_Error
-     */
-    protected function _pci_dss_compliance(EE_Payment_Method $payment_method): ?EE_Form_Section_HTML
-    {
-        if (! $payment_method->type_obj()->requires_https()) {
-            return null;
-        }
-        return new EE_Form_Section_HTML(
-            EEH_HTML::tr(
-                EEH_HTML::th(
-                    EEH_HTML::label(
-                        EEH_HTML::strong(
-                            esc_html__('IMPORTANT', 'event_espresso'),
-                            '',
-                            'important-notice'
-                        )
-                    )
-                ) .
-                EEH_HTML::td(
-                    EEH_HTML::div(
-                        EEH_HTML::strong(
-                            esc_html__(
-                                'You are responsible for your own website security and Payment Card Industry Data Security Standards (PCI DSS) compliance.',
-                                'event_espresso'
-                            )
-                        ),
-                        '',
-                        'ee-status-outline ee-status-bg--warning'
-                    )
-                    . EEH_HTML::br()
-
-                    . EEH_HTML::div(
-                        esc_html__('Learn more about ', 'event_espresso')
-                        . EEH_HTML::link(
-                            'https://www.pcisecuritystandards.org/merchants/index.php',
-                            esc_html__('PCI DSS compliance', 'event_espresso')
-                        ),
-                        '',
-                        'ee-status-outline ee-status-bg--info'
-                    )
-                )
-            )
-        );
-    }
-
-
-    /**
-     * _currency_support
-     *
-     * @access protected
-     * @param EE_Payment_Method $payment_method
-     * @return EE_Form_Section_HTML|null
-     * @throws EE_Error
-     */
-    protected function _currency_support(EE_Payment_Method $payment_method): ?EE_Form_Section_HTML
-    {
-        if ($payment_method->usable_for_currency(EE_Config::instance()->currency->code)) {
-            return null;
-        }
-        return new EE_Form_Section_HTML(
-            EEH_HTML::tr(
-                EEH_HTML::th(
-                    EEH_HTML::label(
-                        EEH_HTML::strong(
-                            esc_html__('IMPORTANT', 'event_espresso'),
-                            '',
-                            'important-notice'
-                        )
-                    )
-                ) .
-                EEH_HTML::td(
-                    EEH_HTML::div(
-                        EEH_HTML::strong(
-                            sprintf(
-                                esc_html__(
-                                    'This payment method does not support the currency set on your site (%1$s). Please activate a different payment method or change your site\'s country and associated currency.',
-                                    'event_espresso'
-                                ),
-                                EE_Config::instance()->currency->code
-                            )
-                        ),
-                        '',
-                        'ee-status-outline ee-status-bg--warning'
-                    )
-                )
-            )
-        );
-    }
-
-
-    /**
-     * _update_payment_method_button
-     *
-     * @access protected
-     * @param EE_Payment_Method $payment_method
-     * @return EE_Payment_Method_Form
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _payment_method_settings(EE_Payment_Method $payment_method): EE_Payment_Method_Form
-    {
-        // modify the form, so we only have/show fields that will be implemented for this version
-        return $this->_simplify_form($payment_method->type_obj()->settings_form(), $payment_method->name());
-    }
-
-
-    /**
-     * Simplifies the form to merely reproduce 4.1's gateway settings functionality
-     *
-     * @param EE_Form_Section_Proper $form_section
-     * @param string                 $payment_method_name
-     * @return EE_Payment_Method_Form
-     * @throws EE_Error
-     */
-    protected function _simplify_form(
-        EE_Form_Section_Proper $form_section,
-        string $payment_method_name = ''
-    ): EE_Payment_Method_Form {
-        if ($form_section instanceof EE_Payment_Method_Form) {
-            $form_section->exclude(
-                [
-                    'PMD_type', // don't want them changing the type
-                    'PMD_slug', // or the slug (probably never)
-                    'PMD_wp_user', // or the user's ID
-                    'Currency', // or the currency, until the rest of EE supports simultaneous currencies
-                ]
-            );
-            return $form_section;
-        }
-        throw new EE_Error(
-            sprintf(
-                esc_html__(
-                    'The EE_Payment_Method_Form for the "%1$s" payment method is missing or invalid.',
-                    'event_espresso'
-                ),
-                $payment_method_name
-            )
-        );
-    }
-
-
-    /**
-     * _update_payment_method_button
-     *
-     * @access protected
-     * @param EE_Payment_Method $payment_method
-     * @return EE_Form_Section_HTML
-     * @throws EE_Error
-     */
-    protected function _update_payment_method_button(EE_Payment_Method $payment_method): EE_Form_Section_HTML
-    {
-        $update_button = new EE_Submit_Input(
-            [
-                'name'       => 'submit',
-                'html_id'    => 'save_' . $payment_method->slug() . '_settings',
-                'default'    => sprintf(
-                    esc_html__('Update %s Payment Settings', 'event_espresso'),
-                    $payment_method->admin_name()
-                ),
-                'html_label' => EEH_HTML::nbsp(),
-            ]
-        );
-        return new EE_Form_Section_HTML(
-            EEH_HTML::tr(
-                EEH_HTML::th(
-                // esc_html__('Update Settings', 'event_espresso'),
-                    '&nbsp;',
-                    '',
-                    'ee-update-' . $payment_method->slug() . '-settings__label'
-                ) .
-                EEH_HTML::td(
-                    $update_button->get_html_for_input(),
-                    '',
-                    'ee-update-' . $payment_method->slug() . '-settings__input'
-                ),
-                '',
-                'ee-update-' . $payment_method->slug() . '-settings'
-            )
-        );
-    }
-
-
-    /**
-     * _deactivate_payment_method_button
-     *
-     * @access protected
-     * @param EE_Payment_Method $payment_method
-     * @return EE_Form_Section_HTML
-     */
-    protected function _deactivate_payment_method_button(EE_Payment_Method $payment_method): EE_Form_Section_HTML
-    {
-        $link_text_and_title = sprintf(
-            esc_html__('Deactivate %1$s Payments?', 'event_espresso'),
-            $payment_method->admin_name()
-        );
-        return new EE_Form_Section_HTML(
-            EEH_HTML::tr(
-                EEH_HTML::th(
-                // esc_html__('Deactivate Payment Method', 'event_espresso'),
-                    '&nbsp;',
-                    '',
-                    'ee-deactivate-' . $payment_method->slug() . '-settings__label'
-                ) .
-                EEH_HTML::td(
-                    EEH_HTML::link(
-                        EE_Admin_Page::add_query_args_and_nonce(
-                            [
-                                'action'         => 'deactivate_payment_method',
-                                'payment_method' => $payment_method->slug(),
-                            ],
-                            EE_PAYMENTS_ADMIN_URL
-                        ),
-                        $link_text_and_title,
-                        $link_text_and_title,
-                        'deactivate_' . $payment_method->slug(),
-                        'button button--secondary'
-                    ),
-                    '',
-                    'ee-deactivate-' . $payment_method->slug() . '-settings__input'
-                ),
-                '',
-                'ee-deactivate-' . $payment_method->slug() . '-settings'
-            )
-        );
-    }
-
-
-    /**
-     * _activate_payment_method_button
-     *
-     * @access protected
-     * @param EE_Payment_Method $payment_method
-     * @return EE_Form_Section_Proper
-     * @throws EE_Error
-     */
-    protected function _activate_payment_method_button(EE_Payment_Method $payment_method): EE_Form_Section_Proper
-    {
-        $link_text_and_title = sprintf(
-            esc_html__('Activate %1$s Payment Method?', 'event_espresso'),
-            $payment_method->admin_name()
-        );
-        return new EE_Form_Section_Proper(
-            [
-                'name'            => 'activate_' . $payment_method->slug() . '_settings_form',
-                'html_id'         => 'activate_' . $payment_method->slug() . '_settings_form',
-                'action'          => '#',
-                'layout_strategy' => new EE_Admin_Two_Column_Layout(),
-                'subsections'     => apply_filters(
-                    'FHEE__Payments_Admin_Page___activate_payment_method_button__form_subsections',
-                    [
-                        new EE_Form_Section_HTML(
-                            EEH_HTML::table(
-                                EEH_HTML::tr(
-                                    EEH_HTML::td(
-                                        $payment_method->type_obj()->introductory_html(),
-                                        '',
-                                        '',
-                                        '',
-                                        'colspan="2"'
-                                    )
-                                ) .
-                                EEH_HTML::tr(
-                                    EEH_HTML::th(
-                                        EEH_HTML::label(esc_html__('Click to Activate ', 'event_espresso'))
-                                    ) .
-                                    EEH_HTML::td(
-                                        EEH_HTML::link(
-                                            EE_Admin_Page::add_query_args_and_nonce(
-                                                [
-                                                    'action'              => 'activate_payment_method',
-                                                    'payment_method_type' => $payment_method->type(),
-                                                ],
-                                                EE_PAYMENTS_ADMIN_URL
-                                            ),
-                                            $link_text_and_title,
-                                            $link_text_and_title,
-                                            'activate_' . $payment_method->slug(),
-                                            'button button--primary-alt'
-                                        )
-                                    )
-                                )
-                            )
-                        ),
-                    ],
-                    $payment_method
-                ),
-            ]
-        );
-    }
-
-
-    /**
-     * _fine_print
-     *
-     * @access protected
-     * @return EE_Form_Section_HTML
-     */
-    protected function _fine_print(): EE_Form_Section_HTML
-    {
-        return new EE_Form_Section_HTML(
-            EEH_HTML::tr(
-                EEH_HTML::th()
-                . EEH_HTML::thx()
-                . EEH_HTML::td(
-                    EEH_HTML::p(
-                        esc_html__('All fields marked with a * are required fields', 'event_espresso'),
-                        '',
-                        'grey-text'
-                    )
-                )
-            )
-        );
-    }
-
-
-    /**
-     * Activates a payment method of that type. Mostly assuming there is only 1 of that type (or none so far)
-     *
-     * @throws EE_Error
-     * @throws ReflectionException
-     * @global WP_User $current_user
-     */
-    protected function _activate_payment_method()
-    {
-        if (isset($this->_req_data['payment_method_type'])) {
-            $payment_method_type = sanitize_text_field($this->_req_data['payment_method_type']);
-            // see if one exists
-            EE_Registry::instance()->load_lib('Payment_Method_Manager');
-            $payment_method = EE_Payment_Method_Manager::instance()
-                                                       ->activate_a_payment_method_of_type($payment_method_type);
-            $this->_redirect_after_action(
-                1,
-                'Payment Method',
-                'activated',
-                ['action' => 'default', 'payment_method' => $payment_method->slug()]
-            );
-        } else {
-            $this->_redirect_after_action(false, 'Payment Method', 'activated', ['action' => 'default']);
-        }
-    }
-
-
-    /**
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _deactivate_payment_method()
-    {
-        if (isset($this->_req_data['payment_method'])) {
-            $payment_method_slug = sanitize_key($this->_req_data['payment_method']);
-            // deactivate it
-            EE_Registry::instance()->load_lib('Payment_Method_Manager');
-            $count_updated = EE_Payment_Method_Manager::instance()->deactivate_payment_method($payment_method_slug);
-            $this->_redirect_after_action(
-                $count_updated,
-                'Payment Method',
-                'deactivated',
-                ['action' => 'default', 'payment_method' => $payment_method_slug]
-            );
-        } else {
-            $this->_redirect_after_action(false, 'Payment Method', 'deactivated', ['action' => 'default']);
-        }
-    }
-
-
-    /**
-     * Processes the payment method form that was submitted. This is slightly trickier than usual form
-     * processing because we first need to identify WHICH form was processed and which payment method
-     * it corresponds to. Once we have done that, we see if the form is valid. If it is, the
-     * form's data is saved, and we redirect to the default payment methods page, setting the updated payment method
-     * as the currently-selected one. If it DOESN'T validate, we render the page with the form's errors (in the
-     * subsequently called 'headers_sent_func' which is _payment_methods_list)
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _update_payment_method()
-    {
-        if ($_SERVER['REQUEST_METHOD'] == 'POST') {
-            // ok let's find which gateway form to use based on the form input
-            EE_Registry::instance()->load_lib('Payment_Method_Manager');
-            /** @var $correct_pmt_form_to_use EE_Payment_Method_Form */
-            $correct_pmt_form_to_use = null;
-            $payment_method          = null;
-            foreach (EEM_Payment_Method::instance()->get_all() as $payment_method) {
-                if ($payment_method instanceof EE_Payment_Method) {
-                    // get the form and simplify it, like what we do when we display it
-                    $pmt_form = $this->_generate_payment_method_settings_form($payment_method);
-                    if ($pmt_form->form_data_present_in($this->_req_data)) {
-                        $correct_pmt_form_to_use = $pmt_form;
-                        break;
-                    }
-                }
-            }
-            // if we couldn't find the correct payment method type...
-            if (! $correct_pmt_form_to_use) {
-                EE_Error::add_error(
-                    esc_html__(
-                        "We could not find which payment method type your form submission related to. Please contact support",
-                        'event_espresso'
-                    ),
-                    __FILE__,
-                    __FUNCTION__,
-                    __LINE__
-                );
-                $this->_redirect_after_action(false, 'Payment Method', 'activated', ['action' => 'default']);
-            }
-            $correct_pmt_form_to_use->receive_form_submission($this->_req_data);
-            if ($correct_pmt_form_to_use->is_valid()) {
-                $payment_settings_subform = $correct_pmt_form_to_use->get_subsection('payment_method_settings');
-                if (! $payment_settings_subform instanceof EE_Payment_Method_Form) {
-                    throw new EE_Error(
-                        sprintf(
-                            esc_html__(
-                                'The payment method could not be saved because the form sections were misnamed. We expected to find %1$s, but did not.',
-                                'event_espresso'
-                            ),
-                            'payment_method_settings'
-                        )
-                    );
-                }
-                $payment_settings_subform->save();
-                /** @var $pm EE_Payment_Method */
-                $this->_redirect_after_action(
-                    true,
-                    'Payment Method',
-                    'updated',
-                    ['action' => 'default', 'payment_method' => $payment_method->slug()]
-                );
-            } else {
-                EE_Error::add_error(
-                    sprintf(
-                        esc_html__(
-                            'Payment method of type %s was not saved because there were validation errors. They have been marked in the form',
-                            'event_espresso'
-                        ),
-                        $payment_method instanceof EE_Payment_Method
-                            ? $payment_method->type_obj()->pretty_name()
-                            : esc_html__('"(unknown)"', 'event_espresso')
-                    ),
-                    __FILE__,
-                    __FUNCTION__,
-                    __LINE__
-                );
-            }
-        }
-    }
-
-
-    /**
-     * Displays payment settings (not payment METHOD settings, that's _payment_method_settings)
-     *
-     * @throws DomainException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     */
-    protected function _payment_settings()
-    {
-        $form = $this->getPaymentSettingsForm();
-        $this->_set_add_edit_form_tags('update_payment_settings');
-        $this->_set_publish_post_box_vars();
-        $this->_template_args['admin_page_content'] = EEH_HTML::div(
-            $form->get_html_and_js(),
-            '',
-            'padding'
-        );
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    /**
-     *        _update_payment_settings
-     *
-     * @access protected
-     * @return void
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     */
-    protected function _update_payment_settings()
-    {
-        $form = $this->getPaymentSettingsForm();
-        if ($form->was_submitted($this->_req_data)) {
-            $form->receive_form_submission($this->_req_data);
-            if ($form->is_valid()) {
-                /**
-                 * @var $reg_config EE_Registration_Config
-                 */
-                $loader                                   = LoaderFactory::getLoader();
-                $reg_config                               = $loader->getShared('EE_Registration_Config');
-                $valid_data                               = $form->valid_data();
-                $show_pending_payment_options             = $valid_data['show_pending_payment_options'] ?? null;
-                $reg_config->show_pending_payment_options = $show_pending_payment_options === 'ON';
-                $reg_config->gateway_log_lifespan         = $valid_data['gateway_log_lifespan'];
-            }
-        }
-        EE_Registry::instance()->CFG = apply_filters(
-            'FHEE__Payments_Admin_Page___update_payment_settings__CFG',
-            EE_Registry::instance()->CFG
-        );
-
-        $what    = esc_html__('Payment Settings', 'event_espresso');
-        $success = $this->_update_espresso_configuration(
-            $what,
-            EE_Registry::instance()->CFG,
-            __FILE__,
-            __FUNCTION__,
-            __LINE__
-        );
-        $this->_redirect_after_action(
-            $success,
-            $what,
-            esc_html__('updated', 'event_espresso'),
-            ['action' => 'payment_settings']
-        );
-    }
-
-
-    /**
-     * Gets the form used for updating payment settings
-     *
-     * @return EE_Form_Section_Proper
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     */
-    protected function getPaymentSettingsForm(): EE_Form_Section_Proper
-    {
-        /**
-         * @var $reg_config EE_Registration_Config
-         */
-        $reg_config = LoaderFactory::getLoader()->getShared('EE_Registration_Config');
-        return new EE_Form_Section_Proper(
-            [
-                'name'            => 'payment-settings',
-                'layout_strategy' => new EE_Admin_Two_Column_Layout(),
-                'subsections'     => [
-                    'show_pending_payment_options' => new EE_Switch_Input(
-                        [
-                            'default'        => $reg_config->show_pending_payment_options
-                                ? EE_Switch_Input::OPTION_ON
-                                : EE_Switch_Input::OPTION_OFF,
-                            'html_name'      => 'show_pending_payment_options',
-                            'html_help_text' => esc_html__(
-                                "If a payment is marked as 'Pending Payment', or if payment is deferred (ie, an offline gateway like Check, Bank, or Invoice is used), then give registrants the option to retry payment. ",
-                                'event_espresso'
-                            ),
-                        ],
-                        [
-                            EE_Switch_Input::OPTION_OFF => esc_html__(
-                                'pending payment options are NOT displayed',
-                                'event_espresso'
-                            ),
-                            EE_Switch_Input::OPTION_ON  => esc_html__(
-                                'pending payment options are displayed',
-                                'event_espresso'
-                            ),
-                        ]
-                    ),
-                    'gateway_log_lifespan'         => new EE_Select_Input(
-                        $reg_config->gatewayLogLifespanOptions(),
-                        [
-                            'html_label_text' => esc_html__('Gateway Logs Lifespan', 'event_espresso'),
-                            'html_help_text'  => esc_html__(
-                                'If issues arise with payments being made through a payment gateway, it\'s helpful to log non-sensitive communications with the payment gateway. But it\'s a security responsibility, so it\'s a good idea to not keep them for any longer than necessary.',
-                                'event_espresso'
-                            ),
-                            'default'         => $reg_config->gateway_log_lifespan,
-                        ]
-                    ),
-                ],
-            ]
-        );
-    }
-
-
-    /**
-     * @throws EE_Error
-     */
-    protected function _payment_log_overview_list_table()
-    {
-        $this->display_admin_list_table_page_with_sidebar();
-    }
-
-
-    protected function _set_list_table_views_payment_log()
-    {
-        $this->_views = [
-            'all' => [
-                'slug'  => 'all',
-                'label' => esc_html__('View All Logs', 'event_espresso'),
-                'count' => 0,
-            ],
-        ];
-    }
-
-
-    /**
-     * @param int  $per_page
-     * @param int  $current_page
-     * @param bool $count
-     * @return array|int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function get_payment_logs($per_page = 50, $current_page = 0, $count = false)
-    {
-        EE_Registry::instance()->load_model('Change_Log');
-        // we may need to do multiple queries (joining differently), so we actually want an array of query params
-        $query_params = [['LOG_type' => EEM_Change_Log::type_gateway]];
-        // check if they've selected a specific payment method
-        if (isset($this->_req_data['_payment_method']) && $this->_req_data['_payment_method'] !== 'all') {
-            $query_params[0]['OR*pm_or_pay_pm'] = [
-                'Payment.Payment_Method.PMD_ID' => $this->_req_data['_payment_method'],
-                'Payment_Method.PMD_ID'         => $this->_req_data['_payment_method'],
-            ];
-        }
-        // take into account search
-        if (isset($this->_req_data['s']) && $this->_req_data['s']) {
-            $similarity_string                                                              =
-                ['LIKE', '%' . str_replace("", "%", $this->_req_data['s']) . '%'];
-            $query_params[0]['OR*s']['Payment.Transaction.Registration.Attendee.ATT_fname'] = $similarity_string;
-            $query_params[0]['OR*s']['Payment.Transaction.Registration.Attendee.ATT_lname'] = $similarity_string;
-            $query_params[0]['OR*s']['Payment.Transaction.Registration.Attendee.ATT_email'] = $similarity_string;
-            $query_params[0]['OR*s']['Payment.Payment_Method.PMD_name']                     = $similarity_string;
-            $query_params[0]['OR*s']['Payment.Payment_Method.PMD_admin_name']               = $similarity_string;
-            $query_params[0]['OR*s']['Payment.Payment_Method.PMD_type']                     = $similarity_string;
-            $query_params[0]['OR*s']['Payment_Method.PMD_name']                             = $similarity_string;
-            $query_params[0]['OR*s']['Payment_Method.PMD_admin_name']                       = $similarity_string;
-            $query_params[0]['OR*s']['Payment_Method.PMD_type']                             = $similarity_string;
-            $query_params[0]['OR*s']['LOG_message']                                         = $similarity_string;
-        }
-        if (
-            isset($this->_req_data['payment-filter-start-date'])
-            && isset($this->_req_data['payment-filter-end-date'])
-        ) {
-            // add date
-            $start_date = wp_strip_all_tags($this->_req_data['payment-filter-start-date']);
-            $end_date   = wp_strip_all_tags($this->_req_data['payment-filter-end-date']);
-            // make sure our timestamps start and end right at the boundaries for each day
-            $start_date = date('Y-m-d', strtotime($start_date)) . ' 00:00:00';
-            $end_date   = date('Y-m-d', strtotime($end_date)) . ' 23:59:59';
-            // convert to timestamps
-            $start_date = strtotime($start_date);
-            $end_date   = strtotime($end_date);
-            // makes sure start date is the lowest value and vice versa
-            $start_date = min($start_date, $end_date);
-            $end_date   = max($start_date, $end_date);
-            // convert for query
-            $start_date                  = EEM_Change_Log::instance()->convert_datetime_for_query(
-                'LOG_time',
-                date('Y-m-d H:i:s', $start_date),
-                'Y-m-d H:i:s'
-            );
-            $end_date                    = EEM_Change_Log::instance()->convert_datetime_for_query(
-                'LOG_time',
-                date('Y-m-d H:i:s', $end_date),
-                'Y-m-d H:i:s'
-            );
-            $query_params[0]['LOG_time'] = ['BETWEEN', [$start_date, $end_date]];
-        }
-        if ($count) {
-            return EEM_Change_Log::instance()->count($query_params);
-        }
-        if (isset($this->_req_data['order'])) {
-            $sort                     = (isset($this->_req_data['order']) && ! empty($this->_req_data['order']))
-                ? $this->_req_data['order']
-                : 'DESC';
-            $query_params['order_by'] = ['LOG_time' => $sort];
-        } else {
-            $query_params['order_by'] = ['LOG_time' => 'DESC'];
-        }
-        $offset = ($current_page - 1) * $per_page;
-        if (! isset($this->_req_data['download_results'])) {
-            $query_params['limit'] = [$offset, $per_page];
-        }
-        // now they've requested to instead just download the file instead of viewing it.
-        if (isset($this->_req_data['download_results'])) {
-            $wpdb_results = EEM_Change_Log::instance()->get_all_efficiently($query_params);
-            header('Content-Disposition: attachment');
-            header("Content-Disposition: attachment; filename=ee_payment_logs_for_" . sanitize_key(site_url()));
-            echo '<h1> '
-                 . sprintf(
-                     esc_html__('Payment Logs for %1$s', 'event_espresso'),
-                     esc_url_raw(site_url())
-                 )
-                 . '</h1 >';
-            echo '<h3>' . esc_html__('Query:', 'event_espresso') . '</h3>';
-            echo esc_html(var_export($query_params, true));
-            echo '<h3>' . esc_html__('Results:', 'event_espresso') . '</h3>';
-            echo esc_html(var_export($wpdb_results, true));
-            die;
-        }
-        return EEM_Change_Log::instance()->get_all($query_params);
-    }
-
-
-    /**
-     * Used by usort to RE-sort log query results, because we lose the ordering
-     * because we're possibly combining the results from two queries
-     *
-     * @param EE_Change_Log $logA
-     * @param EE_Change_Log $logB
-     * @return int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _sort_logs_again($logA, $logB)
-    {
-        $timeA = $logA->get_raw('LOG_time');
-        $timeB = $logB->get_raw('LOG_time');
-        if ($timeA == $timeB) {
-            return 0;
-        }
-        $comparison = $timeA < $timeB
-            ? -1
-            : 1;
-        if (strtoupper($this->_sort_logs_again_direction) == 'DESC') {
-            return $comparison * -1;
-        }
-        return $comparison;
-    }
-
-
-    /**
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    protected function _payment_log_details()
-    {
-        EE_Registry::instance()->load_model('Change_Log');
-        /** @var $payment_log EE_Change_Log */
-        $payment_log    = EEM_Change_Log::instance()->get_one_by_ID($this->_req_data['ID']);
-        $payment_method = null;
-        $transaction    = null;
-        if ($payment_log instanceof EE_Change_Log) {
-            if ($payment_log->object() instanceof EE_Payment) {
-                $payment_method = $payment_log->object()->payment_method();
-                $transaction    = $payment_log->object()->transaction();
-            } elseif ($payment_log->object() instanceof EE_Payment_Method) {
-                $payment_method = $payment_log->object();
-            } elseif ($payment_log->object() instanceof EE_Transaction) {
-                $transaction    = $payment_log->object();
-                $payment_method = $transaction->payment_method();
-            }
-        }
-        $this->_template_args['admin_page_content'] = EEH_Template::display_template(
-            EE_PAYMENTS_TEMPLATE_PATH . 'payment_log_details.template.php',
-            [
-                'payment_log'    => $payment_log,
-                'payment_method' => $payment_method,
-                'transaction'    => $transaction,
-            ],
-            true
-        );
-        $this->display_admin_page_with_no_sidebar();
-    }
+				'InnoDB'
+			);
+		}
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _payment_methods_list()
+	{
+		$this->veryifyTablesExist();
+		/**
+		 * first let's ensure payment methods have been set up.
+		 * We do this here because when people activate a payment method for the first time (as an addon),
+		 * it may not set up its capabilities or get registered correctly due to the loading process.
+		 * However, people MUST set up the details for the payment method,
+		 * so it's safe to do a recheck here.
+		 */
+		EE_Registry::instance()->load_lib('Payment_Method_Manager');
+		EEM_Payment_Method::instance()->verify_button_urls();
+		// set up tabs, one for each payment method type
+		$tabs            = [];
+		$payment_methods = [];
+		foreach (EE_Payment_Method_Manager::instance()->payment_method_types() as $pmt_obj) {
+			// we don't want to show admin-only PMTs for now
+			if ($pmt_obj instanceof EE_PMT_Admin_Only) {
+				continue;
+			}
+			// check access
+			if (
+				! $this->capabilities->current_user_can(
+					$pmt_obj->cap_name(),
+					'specific_payment_method_type_access'
+				)
+			) {
+				continue;
+			}
+			// check for any active pms of that type
+			$payment_method = EEM_Payment_Method::instance()->get_one_of_type($pmt_obj->system_name());
+			if (! $payment_method instanceof EE_Payment_Method) {
+				$payment_method = EE_Payment_Method::new_instance(
+					[
+						'PMD_slug'       => sanitize_key($pmt_obj->system_name()),
+						'PMD_type'       => $pmt_obj->system_name(),
+						'PMD_name'       => $pmt_obj->pretty_name(),
+						'PMD_admin_name' => $pmt_obj->pretty_name(),
+					]
+				);
+			}
+			$payment_methods[ $payment_method->slug() ] = $payment_method;
+		}
+		$payment_methods = apply_filters(
+			'FHEE__Payments_Admin_Page___payment_methods_list__payment_methods',
+			$payment_methods
+		);
+		foreach ($payment_methods as $payment_method) {
+			if ($payment_method instanceof EE_Payment_Method) {
+				$this->addMetaBox(
+				// html id
+					'espresso_' . $payment_method->slug() . '_payment_settings',
+					// title
+					sprintf(esc_html__('%s Settings', 'event_espresso'), $payment_method->admin_name()),
+					// callback
+					[$this, 'payment_method_settings_meta_box'],
+					// post type
+					null,
+					// context
+					'normal',
+					// priority
+					'default',
+					// callback args
+					['payment_method' => $payment_method]
+				);
+				// setup for tabbed content
+				$tabs[ $payment_method->slug() ] = [
+					'label' => $payment_method->admin_name(),
+					'class' => $payment_method->active()
+						? 'gateway-active'
+						: '',
+					'href'  => 'espresso_' . $payment_method->slug() . '_payment_settings',
+					'title' => esc_html__('Modify this Payment Method', 'event_espresso'),
+					'slug'  => $payment_method->slug(),
+					'icon'  => $payment_method->active()
+						? '<span class="dashicons dashicons-yes-alt"></span>'
+						: '<span class="dashicons dashicons-remove"></span>',
+				];
+			}
+		}
+		$this->_template_args['admin_page_header'] = EEH_Tabbed_Content::tab_text_links(
+			$tabs,
+			'payment_method_links',
+			'',
+			$this->_get_active_payment_method_slug()
+		);
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	/**
+	 *   _get_active_payment_method_slug
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _get_active_payment_method_slug()
+	{
+		$payment_method_slug = false;
+		// decide which payment method tab to open first, as dictated by the request's 'payment_method'
+		if (isset($this->_req_data['payment_method'])) {
+			// if they provided the current payment method, use it
+			$payment_method_slug = sanitize_key($this->_req_data['payment_method']);
+		}
+
+		$payment_method = EEM_Payment_Method::instance()->get_one([['PMD_slug' => $payment_method_slug]]);
+		// if that didn't work or wasn't provided, find another way to select the current pm
+		if (! $this->_verify_payment_method($payment_method)) {
+			// like, looking for an active one
+			$payment_method = EEM_Payment_Method::instance()->get_one_active(EEM_Payment_Method::scope_cart);
+			// test that one as well
+			if ($this->_verify_payment_method($payment_method)) {
+				$payment_method_slug = $payment_method->slug();
+			} else {
+				$payment_method_slug = 'paypal_standard';
+			}
+		}
+		return $payment_method_slug;
+	}
+
+
+	/**
+	 *    payment_method_settings_meta_box
+	 *    returns TRUE if the passed payment method is properly constructed and the logged-in user has the correct
+	 *    capabilities to access it
+	 *
+	 * @param EE_Payment_Method|null $payment_method
+	 * @return boolean
+	 * @throws EE_Error
+	 */
+	protected function _verify_payment_method(?EE_Payment_Method $payment_method): bool
+	{
+		return $payment_method instanceof EE_Payment_Method
+			   && $payment_method->type_obj() instanceof EE_PMT_Base
+			   && $this->capabilities->current_user_can(
+				   $payment_method->type_obj()->cap_name(),
+				   'specific_payment_method_type_access'
+			   );
+	}
+
+
+	/**
+	 *    payment_method_settings_meta_box
+	 *
+	 * @param NULL  $post_obj_which_is_null is an object containing the current post (as a $post object)
+	 * @param array $metabox                is an array with metabox id, title, callback, and args elements. the value
+	 *                                      at 'args' has key 'payment_method', as set within _payment_methods_list
+	 * @return void
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function payment_method_settings_meta_box($post_obj_which_is_null, array $metabox)
+	{
+		$payment_method = isset($metabox['args'], $metabox['args']['payment_method'])
+			? $metabox['args']['payment_method']
+			: null;
+		if (! $payment_method instanceof EE_Payment_Method) {
+			throw new EE_Error(
+				esc_html__(
+					'Payment method metabox setup incorrectly. No Payment method object was supplied',
+					'event_espresso'
+				)
+			);
+		}
+		$payment_method_scopes = $payment_method->active();
+		// if the payment method really exists show its form, otherwise the activation template
+		if ($payment_method->ID() && ! empty($payment_method_scopes)) {
+			$form = $this->_generate_payment_method_settings_form($payment_method);
+			if ($form->form_data_present_in($this->_req_data)) {
+				$form->receive_form_submission($this->_req_data);
+			}
+			echo wp_kses(
+				$form->form_open() . $form->get_html_and_js() . $form->form_close(),
+				AllowedTags::getWithFormTags()
+			);
+		} else {
+			echo wp_kses(
+				$this->_activate_payment_method_button($payment_method)->get_html_and_js(),
+				AllowedTags::getWithFormTags()
+			);
+		}
+	}
+
+
+	/**
+	 * Gets the form for all the settings related to this payment method type
+	 *
+	 * @access protected
+	 * @param EE_Payment_Method|null $payment_method
+	 * @return EE_Form_Section_Proper
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _generate_payment_method_settings_form(
+		?EE_Payment_Method $payment_method
+	): EE_Form_Section_Proper {
+		if (! $payment_method instanceof EE_Payment_Method) {
+			return new EE_Form_Section_Proper();
+		}
+		$subsections = apply_filters(
+			'FHEE__Payments_Admin_Page___generate_payment_method_settings_form__form_subsections',
+			[
+				'pci_dss_compliance'      => $this->_pci_dss_compliance($payment_method),
+				'currency_support'        => $this->_currency_support($payment_method),
+				'payment_method_settings' => $this->_payment_method_settings($payment_method),
+				'update'                  => $this->_update_payment_method_button($payment_method),
+				'deactivate'              => $this->_deactivate_payment_method_button($payment_method),
+				'fine_print'              => $this->_fine_print(),
+			],
+			$payment_method
+		);
+		return new EE_Form_Section_Proper(
+			[
+				'name'            => $payment_method->slug() . '_settings_form',
+				'html_id'         => $payment_method->slug() . '_settings_form',
+				'action'          => EE_Admin_Page::add_query_args_and_nonce(
+					[
+						'action'         => 'update_payment_method',
+						'payment_method' => $payment_method->slug(),
+					],
+					EE_PAYMENTS_ADMIN_URL
+				),
+				'layout_strategy' => new EE_Admin_Two_Column_Layout(),
+				'subsections'     => array_filter($subsections),
+			]
+		);
+	}
+
+
+	/**
+	 * _pci_dss_compliance
+	 *
+	 * @access protected
+	 * @param EE_Payment_Method $payment_method
+	 * @return EE_Form_Section_HTML|null
+	 * @throws EE_Error
+	 */
+	protected function _pci_dss_compliance(EE_Payment_Method $payment_method): ?EE_Form_Section_HTML
+	{
+		if (! $payment_method->type_obj()->requires_https()) {
+			return null;
+		}
+		return new EE_Form_Section_HTML(
+			EEH_HTML::tr(
+				EEH_HTML::th(
+					EEH_HTML::label(
+						EEH_HTML::strong(
+							esc_html__('IMPORTANT', 'event_espresso'),
+							'',
+							'important-notice'
+						)
+					)
+				) .
+				EEH_HTML::td(
+					EEH_HTML::div(
+						EEH_HTML::strong(
+							esc_html__(
+								'You are responsible for your own website security and Payment Card Industry Data Security Standards (PCI DSS) compliance.',
+								'event_espresso'
+							)
+						),
+						'',
+						'ee-status-outline ee-status-bg--warning'
+					)
+					. EEH_HTML::br()
+
+					. EEH_HTML::div(
+						esc_html__('Learn more about ', 'event_espresso')
+						. EEH_HTML::link(
+							'https://www.pcisecuritystandards.org/merchants/index.php',
+							esc_html__('PCI DSS compliance', 'event_espresso')
+						),
+						'',
+						'ee-status-outline ee-status-bg--info'
+					)
+				)
+			)
+		);
+	}
+
+
+	/**
+	 * _currency_support
+	 *
+	 * @access protected
+	 * @param EE_Payment_Method $payment_method
+	 * @return EE_Form_Section_HTML|null
+	 * @throws EE_Error
+	 */
+	protected function _currency_support(EE_Payment_Method $payment_method): ?EE_Form_Section_HTML
+	{
+		if ($payment_method->usable_for_currency(EE_Config::instance()->currency->code)) {
+			return null;
+		}
+		return new EE_Form_Section_HTML(
+			EEH_HTML::tr(
+				EEH_HTML::th(
+					EEH_HTML::label(
+						EEH_HTML::strong(
+							esc_html__('IMPORTANT', 'event_espresso'),
+							'',
+							'important-notice'
+						)
+					)
+				) .
+				EEH_HTML::td(
+					EEH_HTML::div(
+						EEH_HTML::strong(
+							sprintf(
+								esc_html__(
+									'This payment method does not support the currency set on your site (%1$s). Please activate a different payment method or change your site\'s country and associated currency.',
+									'event_espresso'
+								),
+								EE_Config::instance()->currency->code
+							)
+						),
+						'',
+						'ee-status-outline ee-status-bg--warning'
+					)
+				)
+			)
+		);
+	}
+
+
+	/**
+	 * _update_payment_method_button
+	 *
+	 * @access protected
+	 * @param EE_Payment_Method $payment_method
+	 * @return EE_Payment_Method_Form
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _payment_method_settings(EE_Payment_Method $payment_method): EE_Payment_Method_Form
+	{
+		// modify the form, so we only have/show fields that will be implemented for this version
+		return $this->_simplify_form($payment_method->type_obj()->settings_form(), $payment_method->name());
+	}
+
+
+	/**
+	 * Simplifies the form to merely reproduce 4.1's gateway settings functionality
+	 *
+	 * @param EE_Form_Section_Proper $form_section
+	 * @param string                 $payment_method_name
+	 * @return EE_Payment_Method_Form
+	 * @throws EE_Error
+	 */
+	protected function _simplify_form(
+		EE_Form_Section_Proper $form_section,
+		string $payment_method_name = ''
+	): EE_Payment_Method_Form {
+		if ($form_section instanceof EE_Payment_Method_Form) {
+			$form_section->exclude(
+				[
+					'PMD_type', // don't want them changing the type
+					'PMD_slug', // or the slug (probably never)
+					'PMD_wp_user', // or the user's ID
+					'Currency', // or the currency, until the rest of EE supports simultaneous currencies
+				]
+			);
+			return $form_section;
+		}
+		throw new EE_Error(
+			sprintf(
+				esc_html__(
+					'The EE_Payment_Method_Form for the "%1$s" payment method is missing or invalid.',
+					'event_espresso'
+				),
+				$payment_method_name
+			)
+		);
+	}
+
+
+	/**
+	 * _update_payment_method_button
+	 *
+	 * @access protected
+	 * @param EE_Payment_Method $payment_method
+	 * @return EE_Form_Section_HTML
+	 * @throws EE_Error
+	 */
+	protected function _update_payment_method_button(EE_Payment_Method $payment_method): EE_Form_Section_HTML
+	{
+		$update_button = new EE_Submit_Input(
+			[
+				'name'       => 'submit',
+				'html_id'    => 'save_' . $payment_method->slug() . '_settings',
+				'default'    => sprintf(
+					esc_html__('Update %s Payment Settings', 'event_espresso'),
+					$payment_method->admin_name()
+				),
+				'html_label' => EEH_HTML::nbsp(),
+			]
+		);
+		return new EE_Form_Section_HTML(
+			EEH_HTML::tr(
+				EEH_HTML::th(
+				// esc_html__('Update Settings', 'event_espresso'),
+					'&nbsp;',
+					'',
+					'ee-update-' . $payment_method->slug() . '-settings__label'
+				) .
+				EEH_HTML::td(
+					$update_button->get_html_for_input(),
+					'',
+					'ee-update-' . $payment_method->slug() . '-settings__input'
+				),
+				'',
+				'ee-update-' . $payment_method->slug() . '-settings'
+			)
+		);
+	}
+
+
+	/**
+	 * _deactivate_payment_method_button
+	 *
+	 * @access protected
+	 * @param EE_Payment_Method $payment_method
+	 * @return EE_Form_Section_HTML
+	 */
+	protected function _deactivate_payment_method_button(EE_Payment_Method $payment_method): EE_Form_Section_HTML
+	{
+		$link_text_and_title = sprintf(
+			esc_html__('Deactivate %1$s Payments?', 'event_espresso'),
+			$payment_method->admin_name()
+		);
+		return new EE_Form_Section_HTML(
+			EEH_HTML::tr(
+				EEH_HTML::th(
+				// esc_html__('Deactivate Payment Method', 'event_espresso'),
+					'&nbsp;',
+					'',
+					'ee-deactivate-' . $payment_method->slug() . '-settings__label'
+				) .
+				EEH_HTML::td(
+					EEH_HTML::link(
+						EE_Admin_Page::add_query_args_and_nonce(
+							[
+								'action'         => 'deactivate_payment_method',
+								'payment_method' => $payment_method->slug(),
+							],
+							EE_PAYMENTS_ADMIN_URL
+						),
+						$link_text_and_title,
+						$link_text_and_title,
+						'deactivate_' . $payment_method->slug(),
+						'button button--secondary'
+					),
+					'',
+					'ee-deactivate-' . $payment_method->slug() . '-settings__input'
+				),
+				'',
+				'ee-deactivate-' . $payment_method->slug() . '-settings'
+			)
+		);
+	}
+
+
+	/**
+	 * _activate_payment_method_button
+	 *
+	 * @access protected
+	 * @param EE_Payment_Method $payment_method
+	 * @return EE_Form_Section_Proper
+	 * @throws EE_Error
+	 */
+	protected function _activate_payment_method_button(EE_Payment_Method $payment_method): EE_Form_Section_Proper
+	{
+		$link_text_and_title = sprintf(
+			esc_html__('Activate %1$s Payment Method?', 'event_espresso'),
+			$payment_method->admin_name()
+		);
+		return new EE_Form_Section_Proper(
+			[
+				'name'            => 'activate_' . $payment_method->slug() . '_settings_form',
+				'html_id'         => 'activate_' . $payment_method->slug() . '_settings_form',
+				'action'          => '#',
+				'layout_strategy' => new EE_Admin_Two_Column_Layout(),
+				'subsections'     => apply_filters(
+					'FHEE__Payments_Admin_Page___activate_payment_method_button__form_subsections',
+					[
+						new EE_Form_Section_HTML(
+							EEH_HTML::table(
+								EEH_HTML::tr(
+									EEH_HTML::td(
+										$payment_method->type_obj()->introductory_html(),
+										'',
+										'',
+										'',
+										'colspan="2"'
+									)
+								) .
+								EEH_HTML::tr(
+									EEH_HTML::th(
+										EEH_HTML::label(esc_html__('Click to Activate ', 'event_espresso'))
+									) .
+									EEH_HTML::td(
+										EEH_HTML::link(
+											EE_Admin_Page::add_query_args_and_nonce(
+												[
+													'action'              => 'activate_payment_method',
+													'payment_method_type' => $payment_method->type(),
+												],
+												EE_PAYMENTS_ADMIN_URL
+											),
+											$link_text_and_title,
+											$link_text_and_title,
+											'activate_' . $payment_method->slug(),
+											'button button--primary-alt'
+										)
+									)
+								)
+							)
+						),
+					],
+					$payment_method
+				),
+			]
+		);
+	}
+
+
+	/**
+	 * _fine_print
+	 *
+	 * @access protected
+	 * @return EE_Form_Section_HTML
+	 */
+	protected function _fine_print(): EE_Form_Section_HTML
+	{
+		return new EE_Form_Section_HTML(
+			EEH_HTML::tr(
+				EEH_HTML::th()
+				. EEH_HTML::thx()
+				. EEH_HTML::td(
+					EEH_HTML::p(
+						esc_html__('All fields marked with a * are required fields', 'event_espresso'),
+						'',
+						'grey-text'
+					)
+				)
+			)
+		);
+	}
+
+
+	/**
+	 * Activates a payment method of that type. Mostly assuming there is only 1 of that type (or none so far)
+	 *
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 * @global WP_User $current_user
+	 */
+	protected function _activate_payment_method()
+	{
+		if (isset($this->_req_data['payment_method_type'])) {
+			$payment_method_type = sanitize_text_field($this->_req_data['payment_method_type']);
+			// see if one exists
+			EE_Registry::instance()->load_lib('Payment_Method_Manager');
+			$payment_method = EE_Payment_Method_Manager::instance()
+													   ->activate_a_payment_method_of_type($payment_method_type);
+			$this->_redirect_after_action(
+				1,
+				'Payment Method',
+				'activated',
+				['action' => 'default', 'payment_method' => $payment_method->slug()]
+			);
+		} else {
+			$this->_redirect_after_action(false, 'Payment Method', 'activated', ['action' => 'default']);
+		}
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _deactivate_payment_method()
+	{
+		if (isset($this->_req_data['payment_method'])) {
+			$payment_method_slug = sanitize_key($this->_req_data['payment_method']);
+			// deactivate it
+			EE_Registry::instance()->load_lib('Payment_Method_Manager');
+			$count_updated = EE_Payment_Method_Manager::instance()->deactivate_payment_method($payment_method_slug);
+			$this->_redirect_after_action(
+				$count_updated,
+				'Payment Method',
+				'deactivated',
+				['action' => 'default', 'payment_method' => $payment_method_slug]
+			);
+		} else {
+			$this->_redirect_after_action(false, 'Payment Method', 'deactivated', ['action' => 'default']);
+		}
+	}
+
+
+	/**
+	 * Processes the payment method form that was submitted. This is slightly trickier than usual form
+	 * processing because we first need to identify WHICH form was processed and which payment method
+	 * it corresponds to. Once we have done that, we see if the form is valid. If it is, the
+	 * form's data is saved, and we redirect to the default payment methods page, setting the updated payment method
+	 * as the currently-selected one. If it DOESN'T validate, we render the page with the form's errors (in the
+	 * subsequently called 'headers_sent_func' which is _payment_methods_list)
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _update_payment_method()
+	{
+		if ($_SERVER['REQUEST_METHOD'] == 'POST') {
+			// ok let's find which gateway form to use based on the form input
+			EE_Registry::instance()->load_lib('Payment_Method_Manager');
+			/** @var $correct_pmt_form_to_use EE_Payment_Method_Form */
+			$correct_pmt_form_to_use = null;
+			$payment_method          = null;
+			foreach (EEM_Payment_Method::instance()->get_all() as $payment_method) {
+				if ($payment_method instanceof EE_Payment_Method) {
+					// get the form and simplify it, like what we do when we display it
+					$pmt_form = $this->_generate_payment_method_settings_form($payment_method);
+					if ($pmt_form->form_data_present_in($this->_req_data)) {
+						$correct_pmt_form_to_use = $pmt_form;
+						break;
+					}
+				}
+			}
+			// if we couldn't find the correct payment method type...
+			if (! $correct_pmt_form_to_use) {
+				EE_Error::add_error(
+					esc_html__(
+						"We could not find which payment method type your form submission related to. Please contact support",
+						'event_espresso'
+					),
+					__FILE__,
+					__FUNCTION__,
+					__LINE__
+				);
+				$this->_redirect_after_action(false, 'Payment Method', 'activated', ['action' => 'default']);
+			}
+			$correct_pmt_form_to_use->receive_form_submission($this->_req_data);
+			if ($correct_pmt_form_to_use->is_valid()) {
+				$payment_settings_subform = $correct_pmt_form_to_use->get_subsection('payment_method_settings');
+				if (! $payment_settings_subform instanceof EE_Payment_Method_Form) {
+					throw new EE_Error(
+						sprintf(
+							esc_html__(
+								'The payment method could not be saved because the form sections were misnamed. We expected to find %1$s, but did not.',
+								'event_espresso'
+							),
+							'payment_method_settings'
+						)
+					);
+				}
+				$payment_settings_subform->save();
+				/** @var $pm EE_Payment_Method */
+				$this->_redirect_after_action(
+					true,
+					'Payment Method',
+					'updated',
+					['action' => 'default', 'payment_method' => $payment_method->slug()]
+				);
+			} else {
+				EE_Error::add_error(
+					sprintf(
+						esc_html__(
+							'Payment method of type %s was not saved because there were validation errors. They have been marked in the form',
+							'event_espresso'
+						),
+						$payment_method instanceof EE_Payment_Method
+							? $payment_method->type_obj()->pretty_name()
+							: esc_html__('"(unknown)"', 'event_espresso')
+					),
+					__FILE__,
+					__FUNCTION__,
+					__LINE__
+				);
+			}
+		}
+	}
+
+
+	/**
+	 * Displays payment settings (not payment METHOD settings, that's _payment_method_settings)
+	 *
+	 * @throws DomainException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 */
+	protected function _payment_settings()
+	{
+		$form = $this->getPaymentSettingsForm();
+		$this->_set_add_edit_form_tags('update_payment_settings');
+		$this->_set_publish_post_box_vars();
+		$this->_template_args['admin_page_content'] = EEH_HTML::div(
+			$form->get_html_and_js(),
+			'',
+			'padding'
+		);
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	/**
+	 *        _update_payment_settings
+	 *
+	 * @access protected
+	 * @return void
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 */
+	protected function _update_payment_settings()
+	{
+		$form = $this->getPaymentSettingsForm();
+		if ($form->was_submitted($this->_req_data)) {
+			$form->receive_form_submission($this->_req_data);
+			if ($form->is_valid()) {
+				/**
+				 * @var $reg_config EE_Registration_Config
+				 */
+				$loader                                   = LoaderFactory::getLoader();
+				$reg_config                               = $loader->getShared('EE_Registration_Config');
+				$valid_data                               = $form->valid_data();
+				$show_pending_payment_options             = $valid_data['show_pending_payment_options'] ?? null;
+				$reg_config->show_pending_payment_options = $show_pending_payment_options === 'ON';
+				$reg_config->gateway_log_lifespan         = $valid_data['gateway_log_lifespan'];
+			}
+		}
+		EE_Registry::instance()->CFG = apply_filters(
+			'FHEE__Payments_Admin_Page___update_payment_settings__CFG',
+			EE_Registry::instance()->CFG
+		);
+
+		$what    = esc_html__('Payment Settings', 'event_espresso');
+		$success = $this->_update_espresso_configuration(
+			$what,
+			EE_Registry::instance()->CFG,
+			__FILE__,
+			__FUNCTION__,
+			__LINE__
+		);
+		$this->_redirect_after_action(
+			$success,
+			$what,
+			esc_html__('updated', 'event_espresso'),
+			['action' => 'payment_settings']
+		);
+	}
+
+
+	/**
+	 * Gets the form used for updating payment settings
+	 *
+	 * @return EE_Form_Section_Proper
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 */
+	protected function getPaymentSettingsForm(): EE_Form_Section_Proper
+	{
+		/**
+		 * @var $reg_config EE_Registration_Config
+		 */
+		$reg_config = LoaderFactory::getLoader()->getShared('EE_Registration_Config');
+		return new EE_Form_Section_Proper(
+			[
+				'name'            => 'payment-settings',
+				'layout_strategy' => new EE_Admin_Two_Column_Layout(),
+				'subsections'     => [
+					'show_pending_payment_options' => new EE_Switch_Input(
+						[
+							'default'        => $reg_config->show_pending_payment_options
+								? EE_Switch_Input::OPTION_ON
+								: EE_Switch_Input::OPTION_OFF,
+							'html_name'      => 'show_pending_payment_options',
+							'html_help_text' => esc_html__(
+								"If a payment is marked as 'Pending Payment', or if payment is deferred (ie, an offline gateway like Check, Bank, or Invoice is used), then give registrants the option to retry payment. ",
+								'event_espresso'
+							),
+						],
+						[
+							EE_Switch_Input::OPTION_OFF => esc_html__(
+								'pending payment options are NOT displayed',
+								'event_espresso'
+							),
+							EE_Switch_Input::OPTION_ON  => esc_html__(
+								'pending payment options are displayed',
+								'event_espresso'
+							),
+						]
+					),
+					'gateway_log_lifespan'         => new EE_Select_Input(
+						$reg_config->gatewayLogLifespanOptions(),
+						[
+							'html_label_text' => esc_html__('Gateway Logs Lifespan', 'event_espresso'),
+							'html_help_text'  => esc_html__(
+								'If issues arise with payments being made through a payment gateway, it\'s helpful to log non-sensitive communications with the payment gateway. But it\'s a security responsibility, so it\'s a good idea to not keep them for any longer than necessary.',
+								'event_espresso'
+							),
+							'default'         => $reg_config->gateway_log_lifespan,
+						]
+					),
+				],
+			]
+		);
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 */
+	protected function _payment_log_overview_list_table()
+	{
+		$this->display_admin_list_table_page_with_sidebar();
+	}
+
+
+	protected function _set_list_table_views_payment_log()
+	{
+		$this->_views = [
+			'all' => [
+				'slug'  => 'all',
+				'label' => esc_html__('View All Logs', 'event_espresso'),
+				'count' => 0,
+			],
+		];
+	}
+
+
+	/**
+	 * @param int  $per_page
+	 * @param int  $current_page
+	 * @param bool $count
+	 * @return array|int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function get_payment_logs($per_page = 50, $current_page = 0, $count = false)
+	{
+		EE_Registry::instance()->load_model('Change_Log');
+		// we may need to do multiple queries (joining differently), so we actually want an array of query params
+		$query_params = [['LOG_type' => EEM_Change_Log::type_gateway]];
+		// check if they've selected a specific payment method
+		if (isset($this->_req_data['_payment_method']) && $this->_req_data['_payment_method'] !== 'all') {
+			$query_params[0]['OR*pm_or_pay_pm'] = [
+				'Payment.Payment_Method.PMD_ID' => $this->_req_data['_payment_method'],
+				'Payment_Method.PMD_ID'         => $this->_req_data['_payment_method'],
+			];
+		}
+		// take into account search
+		if (isset($this->_req_data['s']) && $this->_req_data['s']) {
+			$similarity_string                                                              =
+				['LIKE', '%' . str_replace("", "%", $this->_req_data['s']) . '%'];
+			$query_params[0]['OR*s']['Payment.Transaction.Registration.Attendee.ATT_fname'] = $similarity_string;
+			$query_params[0]['OR*s']['Payment.Transaction.Registration.Attendee.ATT_lname'] = $similarity_string;
+			$query_params[0]['OR*s']['Payment.Transaction.Registration.Attendee.ATT_email'] = $similarity_string;
+			$query_params[0]['OR*s']['Payment.Payment_Method.PMD_name']                     = $similarity_string;
+			$query_params[0]['OR*s']['Payment.Payment_Method.PMD_admin_name']               = $similarity_string;
+			$query_params[0]['OR*s']['Payment.Payment_Method.PMD_type']                     = $similarity_string;
+			$query_params[0]['OR*s']['Payment_Method.PMD_name']                             = $similarity_string;
+			$query_params[0]['OR*s']['Payment_Method.PMD_admin_name']                       = $similarity_string;
+			$query_params[0]['OR*s']['Payment_Method.PMD_type']                             = $similarity_string;
+			$query_params[0]['OR*s']['LOG_message']                                         = $similarity_string;
+		}
+		if (
+			isset($this->_req_data['payment-filter-start-date'])
+			&& isset($this->_req_data['payment-filter-end-date'])
+		) {
+			// add date
+			$start_date = wp_strip_all_tags($this->_req_data['payment-filter-start-date']);
+			$end_date   = wp_strip_all_tags($this->_req_data['payment-filter-end-date']);
+			// make sure our timestamps start and end right at the boundaries for each day
+			$start_date = date('Y-m-d', strtotime($start_date)) . ' 00:00:00';
+			$end_date   = date('Y-m-d', strtotime($end_date)) . ' 23:59:59';
+			// convert to timestamps
+			$start_date = strtotime($start_date);
+			$end_date   = strtotime($end_date);
+			// makes sure start date is the lowest value and vice versa
+			$start_date = min($start_date, $end_date);
+			$end_date   = max($start_date, $end_date);
+			// convert for query
+			$start_date                  = EEM_Change_Log::instance()->convert_datetime_for_query(
+				'LOG_time',
+				date('Y-m-d H:i:s', $start_date),
+				'Y-m-d H:i:s'
+			);
+			$end_date                    = EEM_Change_Log::instance()->convert_datetime_for_query(
+				'LOG_time',
+				date('Y-m-d H:i:s', $end_date),
+				'Y-m-d H:i:s'
+			);
+			$query_params[0]['LOG_time'] = ['BETWEEN', [$start_date, $end_date]];
+		}
+		if ($count) {
+			return EEM_Change_Log::instance()->count($query_params);
+		}
+		if (isset($this->_req_data['order'])) {
+			$sort                     = (isset($this->_req_data['order']) && ! empty($this->_req_data['order']))
+				? $this->_req_data['order']
+				: 'DESC';
+			$query_params['order_by'] = ['LOG_time' => $sort];
+		} else {
+			$query_params['order_by'] = ['LOG_time' => 'DESC'];
+		}
+		$offset = ($current_page - 1) * $per_page;
+		if (! isset($this->_req_data['download_results'])) {
+			$query_params['limit'] = [$offset, $per_page];
+		}
+		// now they've requested to instead just download the file instead of viewing it.
+		if (isset($this->_req_data['download_results'])) {
+			$wpdb_results = EEM_Change_Log::instance()->get_all_efficiently($query_params);
+			header('Content-Disposition: attachment');
+			header("Content-Disposition: attachment; filename=ee_payment_logs_for_" . sanitize_key(site_url()));
+			echo '<h1> '
+				 . sprintf(
+					 esc_html__('Payment Logs for %1$s', 'event_espresso'),
+					 esc_url_raw(site_url())
+				 )
+				 . '</h1 >';
+			echo '<h3>' . esc_html__('Query:', 'event_espresso') . '</h3>';
+			echo esc_html(var_export($query_params, true));
+			echo '<h3>' . esc_html__('Results:', 'event_espresso') . '</h3>';
+			echo esc_html(var_export($wpdb_results, true));
+			die;
+		}
+		return EEM_Change_Log::instance()->get_all($query_params);
+	}
+
+
+	/**
+	 * Used by usort to RE-sort log query results, because we lose the ordering
+	 * because we're possibly combining the results from two queries
+	 *
+	 * @param EE_Change_Log $logA
+	 * @param EE_Change_Log $logB
+	 * @return int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _sort_logs_again($logA, $logB)
+	{
+		$timeA = $logA->get_raw('LOG_time');
+		$timeB = $logB->get_raw('LOG_time');
+		if ($timeA == $timeB) {
+			return 0;
+		}
+		$comparison = $timeA < $timeB
+			? -1
+			: 1;
+		if (strtoupper($this->_sort_logs_again_direction) == 'DESC') {
+			return $comparison * -1;
+		}
+		return $comparison;
+	}
+
+
+	/**
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	protected function _payment_log_details()
+	{
+		EE_Registry::instance()->load_model('Change_Log');
+		/** @var $payment_log EE_Change_Log */
+		$payment_log    = EEM_Change_Log::instance()->get_one_by_ID($this->_req_data['ID']);
+		$payment_method = null;
+		$transaction    = null;
+		if ($payment_log instanceof EE_Change_Log) {
+			if ($payment_log->object() instanceof EE_Payment) {
+				$payment_method = $payment_log->object()->payment_method();
+				$transaction    = $payment_log->object()->transaction();
+			} elseif ($payment_log->object() instanceof EE_Payment_Method) {
+				$payment_method = $payment_log->object();
+			} elseif ($payment_log->object() instanceof EE_Transaction) {
+				$transaction    = $payment_log->object();
+				$payment_method = $transaction->payment_method();
+			}
+		}
+		$this->_template_args['admin_page_content'] = EEH_Template::display_template(
+			EE_PAYMENTS_TEMPLATE_PATH . 'payment_log_details.template.php',
+			[
+				'payment_log'    => $payment_log,
+				'payment_method' => $payment_method,
+				'transaction'    => $transaction,
+			],
+			true
+		);
+		$this->display_admin_page_with_no_sidebar();
+	}
 }

admin_pages/support/Support_Admin_Page.core.php

Indentation +240 added lines, -240 removed lines

@@ -11,244 +11,244 @@
  */
 class Support_Admin_Page extends EE_Admin_Page
 {
-    protected function _init_page_props()
-    {
-        $this->page_slug = EE_SUPPORT_PG_SLUG;
-        $this->page_label = esc_html__('Help & Support', 'event_espresso');
-        $this->_admin_base_url = EE_SUPPORT_ADMIN_URL;
-        $this->_admin_base_path = EE_SUPPORT_ADMIN;
-    }
-
-
-    protected function _ajax_hooks()
-    {
-    }
-
-
-    protected function _define_page_props()
-    {
-        $this->_labels = array();
-        $this->_admin_page_title = $this->page_label;
-    }
-
-
-    protected function _set_page_routes()
-    {
-        $this->_page_routes = array(
-            'default'    => array(
-                'func'       => [$this, '_contact_support'],
-                'capability' => 'ee_read_ee',
-            ),
-            'developers' => array(
-                'func'       => [$this, '_developers'],
-                'capability' => 'ee_read_ee',
-            ),
-            'shortcodes' => array(
-                'func'       => [$this, '_shortcodes'],
-                'capability' => 'ee_read_ee',
-            ),
-        );
-    }
-
-
-    protected function _set_page_config()
-    {
-        $this->_page_config = array(
-            'default'    => array(
-                'nav'           => array(
-                    'label' => esc_html__('Support', 'event_espresso'),
-                    'icon' => 'dashicons-sos',
-                    'order' => 30,
-                ),
-                'metaboxes'     => array_merge($this->_default_espresso_metaboxes, array('_support_boxes')),
-                'require_nonce' => false,
-            ),
-            'developers' => array(
-                'nav'           => array(
-                    'label' => esc_html__('Developers', 'event_espresso'),
-                    'icon' => 'dashicons-coffee',
-                    'order' => 50,
-                ),
-                'metaboxes'     => $this->_default_espresso_metaboxes,
-                'require_nonce' => false,
-            ),
-            'shortcodes' => array(
-                'nav'           => array(
-                    'label' => esc_html__('Shortcodes', 'event_espresso'),
-                    'icon' => 'dashicons-shortcode',
-                    'order' => 60,
-                ),
-                'metaboxes'     => array_merge($this->_default_espresso_metaboxes, array('_shortcodes_boxes')),
-                'require_nonce' => false,
-            ),
-        );
-    }
-
-
-    // none of the below group are currently used for Support pages
-    protected function _add_screen_options()
-    {
-    }
-
-
-    protected function _add_feature_pointers()
-    {
-    }
-
-
-    public function admin_init()
-    {
-    }
-
-
-    public function admin_notices()
-    {
-    }
-
-
-    public function admin_footer_scripts()
-    {
-    }
-
-
-    public function load_scripts_styles()
-    {
-    }
-
-
-    protected function _installation()
-    {
-        $template_path = EE_SUPPORT_ADMIN_TEMPLATE_PATH . 'support_admin_details_installation.template.php';
-        $this->_template_args['admin_page_content'] = EEH_Template::display_template(
-            $template_path,
-            '',
-            true
-        );
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    protected function _resources()
-    {
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    protected function _add_settings_metabox($box, $label, array $args)
-    {
-        $this->addMetaBox(
-            "espresso_{$box}_settings",
-            $label,
-            function ($post, $metabox) {
-                EEH_Template::display_template(
-                    $metabox['args']['template_path'],
-                    $metabox['args']['template_args']
-                );
-            },
-            $this->_current_screen->id,
-            'normal',
-            'high',
-            apply_filters(
-                "FHEE__Support_Admin_Page___add_settings_metabox__{$box}_args_array",
-                $args
-            )
-        );
-    }
-
-
-    protected function _resources_boxes()
-    {
-        $boxes = apply_filters(
-            'FHEE__Support_Admin_Page___resources_boxes__boxes_array',
-            array(
-                'favorite_theme_developers' => esc_html__('Favorite Theme Developers', 'event_espresso'),
-                'highly_recommended_themes' => esc_html__('Highly Recommended Themes', 'event_espresso'),
-                'hire_developer'            => esc_html__('Hire a Developer', 'event_espresso'),
-                'partners'                  => esc_html__('Partners', 'event_espresso'),
-                'recommended_plugins'       => esc_html__('Recommended Plugins', 'event_espresso'),
-                'other_resources'           => esc_html__('Other Resources', 'event_espresso'),
-            )
-        );
-        foreach ($boxes as $box => $label) {
-            $this->_add_settings_metabox(
-                $box,
-                $label,
-                array(
-                    'template_path' => EE_SUPPORT_ADMIN_TEMPLATE_PATH . "support_admin_details_{$box}.template.php",
-                    'template_args' => $this->_template_args,
-                )
-            );
-        }
-    }
-
-
-    protected function _shortcodes()
-    {
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    protected function _shortcodes_boxes()
-    {
-        $boxes = apply_filters(
-            'FHEE__Support_Admin_Page___shortcodes_boxes__boxes_array',
-            array(
-                'shortcodes_event_listings'  => esc_html__('Event Listings', 'event_espresso'),
-                'shortcodes_ticket_selector' => esc_html__('Event Ticket Selector', 'event_espresso'),
-                'shortcodes_category'        => esc_html__('Event Categories', 'event_espresso'),
-                'shortcodes_attendee'        => esc_html__('Event Attendees', 'event_espresso')
-                /*'shortcodes_single_events' => esc_html__('Single Events', 'event_espresso'),*/
-                /*'shortcodes_attendee_listings' => esc_html__('Attendee Listings', 'event_espresso'),*/
-            )
-        );
-        foreach ($boxes as $box => $label) {
-            $this->_add_settings_metabox(
-                $box,
-                $label,
-                array(
-                    'template_path' => EE_SUPPORT_ADMIN_TEMPLATE_PATH . "support_admin_details_{$box}.template.php",
-                    'template_args' => $this->_template_args,
-                )
-            );
-        }
-    }
-
-
-    protected function _contact_support()
-    {
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-    protected function _support_boxes()
-    {
-        $boxes = apply_filters(
-            'FHEE__Support_Admin_Page___support_boxes__boxes_array',
-            array(
-                'contact_support'       => esc_html__('Contact Support', 'event_espresso'),
-                'important_information' => esc_html__('Important Information', 'event_espresso'),
-            )
-        );
-        foreach ($boxes as $box => $label) {
-            $this->_add_settings_metabox(
-                $box,
-                $label,
-                array(
-                    'template_path' => EE_SUPPORT_ADMIN_TEMPLATE_PATH . "support_admin_details_{$box}.template.php",
-                    'template_args' => $this->_template_args,
-                )
-            );
-        }
-    }
-
-
-    protected function _developers()
-    {
-        $this->_template_args['admin_page_content'] = EEH_Template::display_template(
-            EE_SUPPORT_ADMIN_TEMPLATE_PATH . 'developers_admin_details.template.php',
-            array(),
-            true
-        );
-        $this->display_admin_page_with_sidebar();
-    }
+	protected function _init_page_props()
+	{
+		$this->page_slug = EE_SUPPORT_PG_SLUG;
+		$this->page_label = esc_html__('Help & Support', 'event_espresso');
+		$this->_admin_base_url = EE_SUPPORT_ADMIN_URL;
+		$this->_admin_base_path = EE_SUPPORT_ADMIN;
+	}
+
+
+	protected function _ajax_hooks()
+	{
+	}
+
+
+	protected function _define_page_props()
+	{
+		$this->_labels = array();
+		$this->_admin_page_title = $this->page_label;
+	}
+
+
+	protected function _set_page_routes()
+	{
+		$this->_page_routes = array(
+			'default'    => array(
+				'func'       => [$this, '_contact_support'],
+				'capability' => 'ee_read_ee',
+			),
+			'developers' => array(
+				'func'       => [$this, '_developers'],
+				'capability' => 'ee_read_ee',
+			),
+			'shortcodes' => array(
+				'func'       => [$this, '_shortcodes'],
+				'capability' => 'ee_read_ee',
+			),
+		);
+	}
+
+
+	protected function _set_page_config()
+	{
+		$this->_page_config = array(
+			'default'    => array(
+				'nav'           => array(
+					'label' => esc_html__('Support', 'event_espresso'),
+					'icon' => 'dashicons-sos',
+					'order' => 30,
+				),
+				'metaboxes'     => array_merge($this->_default_espresso_metaboxes, array('_support_boxes')),
+				'require_nonce' => false,
+			),
+			'developers' => array(
+				'nav'           => array(
+					'label' => esc_html__('Developers', 'event_espresso'),
+					'icon' => 'dashicons-coffee',
+					'order' => 50,
+				),
+				'metaboxes'     => $this->_default_espresso_metaboxes,
+				'require_nonce' => false,
+			),
+			'shortcodes' => array(
+				'nav'           => array(
+					'label' => esc_html__('Shortcodes', 'event_espresso'),
+					'icon' => 'dashicons-shortcode',
+					'order' => 60,
+				),
+				'metaboxes'     => array_merge($this->_default_espresso_metaboxes, array('_shortcodes_boxes')),
+				'require_nonce' => false,
+			),
+		);
+	}
+
+
+	// none of the below group are currently used for Support pages
+	protected function _add_screen_options()
+	{
+	}
+
+
+	protected function _add_feature_pointers()
+	{
+	}
+
+
+	public function admin_init()
+	{
+	}
+
+
+	public function admin_notices()
+	{
+	}
+
+
+	public function admin_footer_scripts()
+	{
+	}
+
+
+	public function load_scripts_styles()
+	{
+	}
+
+
+	protected function _installation()
+	{
+		$template_path = EE_SUPPORT_ADMIN_TEMPLATE_PATH . 'support_admin_details_installation.template.php';
+		$this->_template_args['admin_page_content'] = EEH_Template::display_template(
+			$template_path,
+			'',
+			true
+		);
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	protected function _resources()
+	{
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	protected function _add_settings_metabox($box, $label, array $args)
+	{
+		$this->addMetaBox(
+			"espresso_{$box}_settings",
+			$label,
+			function ($post, $metabox) {
+				EEH_Template::display_template(
+					$metabox['args']['template_path'],
+					$metabox['args']['template_args']
+				);
+			},
+			$this->_current_screen->id,
+			'normal',
+			'high',
+			apply_filters(
+				"FHEE__Support_Admin_Page___add_settings_metabox__{$box}_args_array",
+				$args
+			)
+		);
+	}
+
+
+	protected function _resources_boxes()
+	{
+		$boxes = apply_filters(
+			'FHEE__Support_Admin_Page___resources_boxes__boxes_array',
+			array(
+				'favorite_theme_developers' => esc_html__('Favorite Theme Developers', 'event_espresso'),
+				'highly_recommended_themes' => esc_html__('Highly Recommended Themes', 'event_espresso'),
+				'hire_developer'            => esc_html__('Hire a Developer', 'event_espresso'),
+				'partners'                  => esc_html__('Partners', 'event_espresso'),
+				'recommended_plugins'       => esc_html__('Recommended Plugins', 'event_espresso'),
+				'other_resources'           => esc_html__('Other Resources', 'event_espresso'),
+			)
+		);
+		foreach ($boxes as $box => $label) {
+			$this->_add_settings_metabox(
+				$box,
+				$label,
+				array(
+					'template_path' => EE_SUPPORT_ADMIN_TEMPLATE_PATH . "support_admin_details_{$box}.template.php",
+					'template_args' => $this->_template_args,
+				)
+			);
+		}
+	}
+
+
+	protected function _shortcodes()
+	{
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	protected function _shortcodes_boxes()
+	{
+		$boxes = apply_filters(
+			'FHEE__Support_Admin_Page___shortcodes_boxes__boxes_array',
+			array(
+				'shortcodes_event_listings'  => esc_html__('Event Listings', 'event_espresso'),
+				'shortcodes_ticket_selector' => esc_html__('Event Ticket Selector', 'event_espresso'),
+				'shortcodes_category'        => esc_html__('Event Categories', 'event_espresso'),
+				'shortcodes_attendee'        => esc_html__('Event Attendees', 'event_espresso')
+				/*'shortcodes_single_events' => esc_html__('Single Events', 'event_espresso'),*/
+				/*'shortcodes_attendee_listings' => esc_html__('Attendee Listings', 'event_espresso'),*/
+			)
+		);
+		foreach ($boxes as $box => $label) {
+			$this->_add_settings_metabox(
+				$box,
+				$label,
+				array(
+					'template_path' => EE_SUPPORT_ADMIN_TEMPLATE_PATH . "support_admin_details_{$box}.template.php",
+					'template_args' => $this->_template_args,
+				)
+			);
+		}
+	}
+
+
+	protected function _contact_support()
+	{
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+	protected function _support_boxes()
+	{
+		$boxes = apply_filters(
+			'FHEE__Support_Admin_Page___support_boxes__boxes_array',
+			array(
+				'contact_support'       => esc_html__('Contact Support', 'event_espresso'),
+				'important_information' => esc_html__('Important Information', 'event_espresso'),
+			)
+		);
+		foreach ($boxes as $box => $label) {
+			$this->_add_settings_metabox(
+				$box,
+				$label,
+				array(
+					'template_path' => EE_SUPPORT_ADMIN_TEMPLATE_PATH . "support_admin_details_{$box}.template.php",
+					'template_args' => $this->_template_args,
+				)
+			);
+		}
+	}
+
+
+	protected function _developers()
+	{
+		$this->_template_args['admin_page_content'] = EEH_Template::display_template(
+			EE_SUPPORT_ADMIN_TEMPLATE_PATH . 'developers_admin_details.template.php',
+			array(),
+			true
+		);
+		$this->display_admin_page_with_sidebar();
+	}
 }