eventespresso / event-espresso-core

core/libraries/batch/JobHandlers/RegistrationsReport.php

Doc Comments +1 added lines, -1 removed lines

@@ -418,7 +418,7 @@
      * In this case, we delete the temporary file
      *
      * @param JobParameters $job_parameters
-     * @return boolean
+     * @return JobStepResponse
      */
     public function cleanup_job(JobParameters $job_parameters)
     {

Indentation +385 added lines, -385 removed lines

@@ -17,7 +17,7 @@ 
 use EventEspressoBatchRequest\Helpers\JobStepResponse;
 
 if ( ! defined('EVENT_ESPRESSO_VERSION')) {
-    exit('No direct script access allowed');
+	exit('No direct script access allowed');
 }
 
 
@@ -25,408 +25,408 @@ 
 class RegistrationsReport extends JobHandlerFile
 {
 
-    /**
-     * Performs any necessary setup for starting the job. This is also a good
-     * place to setup the $job_arguments which will be used for subsequent HTTP requests
-     * when continue_job will be called
-     *
-     * @param JobParameters $job_parameters
-     * @throws BatchRequestException
-     * @return JobStepResponse
-     */
-    public function create_job(JobParameters $job_parameters)
-    {
-        $event_id = intval($job_parameters->request_datum('EVT_ID', '0'));
-        if ( ! \EE_Capabilities::instance()->current_user_can('ee_read_registrations', 'generating_report')) {
-            throw new BatchRequestException(__('You do not have permission to view registrations', 'event_espresso'));
-        }
-        $filepath = $this->create_file_from_job_with_name($job_parameters->job_id(),
-            $this->get_filename_from_event($event_id));
-        $job_parameters->add_extra_data('filepath', $filepath);
-        $question_data_for_columns = $this->_get_questions_for_report($event_id);
-        $job_parameters->add_extra_data('questions_data', $question_data_for_columns);
-        $job_parameters->set_job_size($this->count_units_to_process($event_id));
-        //we should also set the header columns
-        $csv_data_for_row = $this->get_csv_data_for($event_id, 0, 1, $job_parameters->extra_datum('questions_data'));
-        \EEH_Export::write_data_array_to_csv($filepath, $csv_data_for_row, true);
-        //if we actually processed a row there, record it
-        if ($job_parameters->job_size()) {
-            $job_parameters->mark_processed(1);
-        }
-        return new JobStepResponse($job_parameters,
-            __('Registrations report started successfully...', 'event_espresso'));
-    }
+	/**
+	 * Performs any necessary setup for starting the job. This is also a good
+	 * place to setup the $job_arguments which will be used for subsequent HTTP requests
+	 * when continue_job will be called
+	 *
+	 * @param JobParameters $job_parameters
+	 * @throws BatchRequestException
+	 * @return JobStepResponse
+	 */
+	public function create_job(JobParameters $job_parameters)
+	{
+		$event_id = intval($job_parameters->request_datum('EVT_ID', '0'));
+		if ( ! \EE_Capabilities::instance()->current_user_can('ee_read_registrations', 'generating_report')) {
+			throw new BatchRequestException(__('You do not have permission to view registrations', 'event_espresso'));
+		}
+		$filepath = $this->create_file_from_job_with_name($job_parameters->job_id(),
+			$this->get_filename_from_event($event_id));
+		$job_parameters->add_extra_data('filepath', $filepath);
+		$question_data_for_columns = $this->_get_questions_for_report($event_id);
+		$job_parameters->add_extra_data('questions_data', $question_data_for_columns);
+		$job_parameters->set_job_size($this->count_units_to_process($event_id));
+		//we should also set the header columns
+		$csv_data_for_row = $this->get_csv_data_for($event_id, 0, 1, $job_parameters->extra_datum('questions_data'));
+		\EEH_Export::write_data_array_to_csv($filepath, $csv_data_for_row, true);
+		//if we actually processed a row there, record it
+		if ($job_parameters->job_size()) {
+			$job_parameters->mark_processed(1);
+		}
+		return new JobStepResponse($job_parameters,
+			__('Registrations report started successfully...', 'event_espresso'));
+	}
 
 
 
-    /**
-     * Creates teh filename form the event id (or lack thereof)
-     *
-     * @param int $event_id
-     * @return string
-     */
-    protected function get_filename_from_event($event_id)
-    {
-        if ($event_id) {
-            $event_slug = \EEM_Event::instance()->get_var(array(array('EVT_ID' => $event_id)), 'EVT_slug');
-            if ( ! $event_slug) {
-                $event_slug = __('unknown', 'event_espresso');
-            }
-        } else {
-            $event_slug = __('all', 'event_espresso');
-        }
-        return sprintf("registrations-for-%s.csv", $event_slug);
-    }
+	/**
+	 * Creates teh filename form the event id (or lack thereof)
+	 *
+	 * @param int $event_id
+	 * @return string
+	 */
+	protected function get_filename_from_event($event_id)
+	{
+		if ($event_id) {
+			$event_slug = \EEM_Event::instance()->get_var(array(array('EVT_ID' => $event_id)), 'EVT_slug');
+			if ( ! $event_slug) {
+				$event_slug = __('unknown', 'event_espresso');
+			}
+		} else {
+			$event_slug = __('all', 'event_espresso');
+		}
+		return sprintf("registrations-for-%s.csv", $event_slug);
+	}
 
 
 
-    /**
-     * Gets the questions which are to be used for this report, so they
-     * can be remembered for later
-     *
-     * @param int|null $event_id
-     * @return array of wpdb results for questions which are to be used for this report
-     */
-    protected function _get_questions_for_report($event_id)
-    {
-        $question_query_params = array(
-            array(
-                'Answer.ANS_ID' => array('IS_NOT_NULL'),
-            ),
-            'group_by' => array('QST_ID'),
-        );
-        if ($event_id) {
-            $question_query_params[0]['Answer.Registration.EVT_ID'] = $event_id;
-        }
-        return \EEM_Question::instance()->get_all_wpdb_results($question_query_params);
-    }
+	/**
+	 * Gets the questions which are to be used for this report, so they
+	 * can be remembered for later
+	 *
+	 * @param int|null $event_id
+	 * @return array of wpdb results for questions which are to be used for this report
+	 */
+	protected function _get_questions_for_report($event_id)
+	{
+		$question_query_params = array(
+			array(
+				'Answer.ANS_ID' => array('IS_NOT_NULL'),
+			),
+			'group_by' => array('QST_ID'),
+		);
+		if ($event_id) {
+			$question_query_params[0]['Answer.Registration.EVT_ID'] = $event_id;
+		}
+		return \EEM_Question::instance()->get_all_wpdb_results($question_query_params);
+	}
 
 
 
-    /**
-     * Performs another step of the job
-     *
-     * @param JobParameters $job_parameters
-     * @param int           $batch_size
-     * @return JobStepResponse
-     * @throws \EE_Error
-     */
-    public function continue_job(JobParameters $job_parameters, $batch_size = 50)
-    {
-        $csv_data = $this->get_csv_data_for($job_parameters->request_datum('EVT_ID', '0'),
-            $job_parameters->units_processed(), $batch_size, $job_parameters->extra_datum('questions_data'));
-        \EEH_Export::write_data_array_to_csv($job_parameters->extra_datum('filepath'), $csv_data, false);
-        $units_processed = count($csv_data);
-        $job_parameters->mark_processed($units_processed);
-        $extra_response_data = array(
-            'file_url' => '',
-        );
-        if ($units_processed < $batch_size) {
-            $job_parameters->set_status(JobParameters::status_complete);
-            $extra_response_data['file_url'] = $this->get_url_to_file($job_parameters->extra_datum('filepath'));
-        }
-        return new JobStepResponse($job_parameters,
-            sprintf(__('Wrote %1$s rows to report CSV file...', 'event_espresso'), count($csv_data)),
-            $extra_response_data);
-    }
+	/**
+	 * Performs another step of the job
+	 *
+	 * @param JobParameters $job_parameters
+	 * @param int           $batch_size
+	 * @return JobStepResponse
+	 * @throws \EE_Error
+	 */
+	public function continue_job(JobParameters $job_parameters, $batch_size = 50)
+	{
+		$csv_data = $this->get_csv_data_for($job_parameters->request_datum('EVT_ID', '0'),
+			$job_parameters->units_processed(), $batch_size, $job_parameters->extra_datum('questions_data'));
+		\EEH_Export::write_data_array_to_csv($job_parameters->extra_datum('filepath'), $csv_data, false);
+		$units_processed = count($csv_data);
+		$job_parameters->mark_processed($units_processed);
+		$extra_response_data = array(
+			'file_url' => '',
+		);
+		if ($units_processed < $batch_size) {
+			$job_parameters->set_status(JobParameters::status_complete);
+			$extra_response_data['file_url'] = $this->get_url_to_file($job_parameters->extra_datum('filepath'));
+		}
+		return new JobStepResponse($job_parameters,
+			sprintf(__('Wrote %1$s rows to report CSV file...', 'event_espresso'), count($csv_data)),
+			$extra_response_data);
+	}
 
 
 
-    /**
-     * Gets the csv data for a batch of registrations
-     *
-     * @param int|null $event_id
-     * @param int      $offset
-     * @param int      $limit
-     * @param array    $questions_for_these_regs_rows results of $wpdb->get_results( $something, ARRAY_A) when querying
-     *                                                for questions
-     * @return array top-level keys are numeric, next-level keys are column headers
-     */
-    function get_csv_data_for($event_id, $offset, $limit, $questions_for_these_regs_rows)
-    {
-        $reg_fields_to_include = array(
-            'TXN_ID',
-            'ATT_ID',
-            'REG_ID',
-            'REG_date',
-            'REG_code',
-            'REG_count',
-            'REG_final_price',
-        );
-        $att_fields_to_include = array(
-            'ATT_fname',
-            'ATT_lname',
-            'ATT_email',
-            'ATT_address',
-            'ATT_address2',
-            'ATT_city',
-            'STA_ID',
-            'CNT_ISO',
-            'ATT_zip',
-            'ATT_phone',
-        );
-        $registrations_csv_ready_array = array();
-        $reg_model = \EE_Registry::instance()->load_model('Registration');
-        $query_params = apply_filters('FHEE__EE_Export__report_registration_for_event', array(
-                array(
-                    'OR'                 => array(
-                        //don't include registrations from failed or abandoned transactions...
-                        'Transaction.STS_ID' => array(
-                            'NOT IN',
-                            array(
-                                \EEM_Transaction::failed_status_code,
-                                \EEM_Transaction::abandoned_status_code,
-                            ),
-                        ),
-                        //unless the registration is approved, in which case include it regardless of transaction status
-                        'STS_ID'             => \EEM_Registration::status_id_approved,
-                    ),
-                    'Ticket.TKT_deleted' => array('IN', array(true, false)),
-                ),
-                'order_by'   => array('Transaction.TXN_ID' => 'asc', 'REG_count' => 'asc'),
-                'force_join' => array('Transaction', 'Ticket', 'Attendee'),
-                'limit'      => array($offset, $limit),
-                'caps'       => \EEM_Base::caps_read_admin,
-            ), $event_id);
-        if ($event_id) {
-            $query_params[0]['EVT_ID'] = $event_id;
-        } else {
-            $query_params['force_join'][] = 'Event';
-        }
-        $registration_rows = $reg_model->get_all_wpdb_results($query_params);
-        //get all questions which relate to someone in this group
-        $registration_ids = array();
-        foreach ($registration_rows as $reg_row) {
-            $registration_ids[] = intval($reg_row['Registration.REG_ID']);
-        }
-        foreach ($registration_rows as $reg_row) {
-            if (is_array($reg_row)) {
-                $reg_csv_array = array();
-                if ( ! $event_id) {
-                    //get the event's name and Id
-                    $reg_csv_array[__('Event', 'event_espresso')] = sprintf(__('%1$s (%2$s)', 'event_espresso'),
-                        \EEH_Export::prepare_value_from_db_for_display(\EEM_Event::instance(), 'EVT_name',
-                            $reg_row['Event_CPT.post_title']), $reg_row['Event_CPT.ID']);
-                }
-                $is_primary_reg = $reg_row['Registration.REG_count'] == '1' ? true : false;
-                /*@var $reg_row EE_Registration */
-                foreach ($reg_fields_to_include as $field_name) {
-                    $field = $reg_model->field_settings_for($field_name);
-                    if ($field_name == 'REG_final_price') {
-                        $value = \EEH_Export::prepare_value_from_db_for_display($reg_model, $field_name,
-                            $reg_row['Registration.REG_final_price'], 'localized_float');
-                    } elseif ($field_name == 'REG_count') {
-                        $value = sprintf(__('%s of %s', 'event_espresso'),
-                            \EEH_Export::prepare_value_from_db_for_display($reg_model, 'REG_count',
-                                $reg_row['Registration.REG_count']),
-                            \EEH_Export::prepare_value_from_db_for_display($reg_model, 'REG_group_size',
-                                $reg_row['Registration.REG_group_size']));
-                    } elseif ($field_name == 'REG_date') {
-                        $value = \EEH_Export::prepare_value_from_db_for_display($reg_model, $field_name,
-                            $reg_row['Registration.REG_date'], 'no_html');
-                    } else {
-                        $value = \EEH_Export::prepare_value_from_db_for_display($reg_model, $field_name,
-                            $reg_row[$field->get_qualified_column()]);
-                    }
-                    $reg_csv_array[\EEH_Export::get_column_name_for_field($field)] = $value;
-                    if ($field_name == 'REG_final_price') {
-                        //add a column named Currency after the final price
-                        $reg_csv_array[__("Currency", "event_espresso")] = \EE_Config::instance()->currency->code;
-                    }
-                }
-                //get pretty status
-                $stati = \EEM_Status::instance()->localized_status(array(
-                    $reg_row['Registration.STS_ID']     => __('unknown', 'event_espresso'),
-                    $reg_row['TransactionTable.STS_ID'] => __('unknown', 'event_espresso'),
-                ), false, 'sentence');
-                $reg_csv_array[__("Registration Status", 'event_espresso')] = $stati[$reg_row['Registration.STS_ID']];
-                //get pretty transaction status
-                $reg_csv_array[__("Transaction Status",
-                    'event_espresso')] = $stati[$reg_row['TransactionTable.STS_ID']];
-                $reg_csv_array[__('Transaction Amount Due', 'event_espresso')] = $is_primary_reg
-                    ? \EEH_Export::prepare_value_from_db_for_display(\EEM_Transaction::instance(), 'TXN_total',
-                        $reg_row['TransactionTable.TXN_total'], 'localized_float') : '0.00';
-                $reg_csv_array[__('Amount Paid', 'event_espresso')] = $is_primary_reg
-                    ? \EEH_Export::prepare_value_from_db_for_display(\EEM_Transaction::instance(), 'TXN_paid',
-                        $reg_row['TransactionTable.TXN_paid'], 'localized_float') : '0.00';
-                $payment_methods = array();
-                $gateway_txn_ids_etc = array();
-                $payment_times = array();
-                if ($is_primary_reg && $reg_row['TransactionTable.TXN_ID']) {
-                    $payments_info = \EEM_Payment::instance()->get_all_wpdb_results(array(
-                        array(
-                            'TXN_ID' => $reg_row['TransactionTable.TXN_ID'],
-                            'STS_ID' => \EEM_Payment::status_id_approved,
-                        ),
-                        'force_join' => array('Payment_Method'),
-                    ), ARRAY_A,
-                        'Payment_Method.PMD_admin_name as name, Payment.PAY_txn_id_chq_nmbr as gateway_txn_id, Payment.PAY_timestamp as payment_time');
-                    foreach ($payments_info as $payment_method_and_gateway_txn_id) {
-                        $payment_methods[] = isset($payment_method_and_gateway_txn_id['name'])
-                            ? $payment_method_and_gateway_txn_id['name'] : __('Unknown', 'event_espresso');
-                        $gateway_txn_ids_etc[] = isset($payment_method_and_gateway_txn_id['gateway_txn_id'])
-                            ? $payment_method_and_gateway_txn_id['gateway_txn_id'] : '';
-                        $payment_times[] = isset($payment_method_and_gateway_txn_id['payment_time'])
-                            ? $payment_method_and_gateway_txn_id['payment_time'] : '';
-                    }
-                }
-                $reg_csv_array[__('Payment Date(s)', 'event_espresso')] = implode(',', $payment_times);
-                $reg_csv_array[__('Payment Method(s)', 'event_espresso')] = implode(",", $payment_methods);
-                $reg_csv_array[__('Gateway Transaction ID(s)', 'event_espresso')] = implode(',', $gateway_txn_ids_etc);
-                //get whether or not the user has checked in
-                $reg_csv_array[__("Check-Ins",
-                    "event_espresso")] = $reg_model->count_related($reg_row['Registration.REG_ID'], 'Checkin');
-                //get ticket of registration and its price
-                $ticket_model = \EE_Registry::instance()->load_model('Ticket');
-                if ($reg_row['Ticket.TKT_ID']) {
-                    $ticket_name = \EEH_Export::prepare_value_from_db_for_display($ticket_model, 'TKT_name',
-                        $reg_row['Ticket.TKT_name']);
-                    $datetimes_strings = array();
-                    foreach (
-                        \EEM_Datetime::instance()
-                                     ->get_all_wpdb_results(array(
-                                         array('Ticket.TKT_ID' => $reg_row['Ticket.TKT_ID']),
-                                         'order_by'                 => array('DTT_EVT_start' => 'ASC'),
-                                         'default_where_conditions' => 'none',
-                                     )) as $datetime
-                    ) {
-                        $datetimes_strings[] = \EEH_Export::prepare_value_from_db_for_display(\EEM_Datetime::instance(),
-                            'DTT_EVT_start', $datetime['Datetime.DTT_EVT_start']);
-                    }
-                } else {
-                    $ticket_name = __('Unknown', 'event_espresso');
-                    $datetimes_strings = array(__('Unknown', 'event_espresso'));
-                }
-                $reg_csv_array[$ticket_model->field_settings_for('TKT_name')->get_nicename()] = $ticket_name;
-                $reg_csv_array[__("Datetimes of Ticket", "event_espresso")] = implode(", ", $datetimes_strings);
-                //get datetime(s) of registration
-                //add attendee columns
-                foreach ($att_fields_to_include as $att_field_name) {
-                    $field_obj = \EEM_Attendee::instance()->field_settings_for($att_field_name);
-                    if ($reg_row['Attendee_CPT.ID']) {
-                        if ($att_field_name == 'STA_ID') {
-                            $value = \EEM_State::instance()
-                                               ->get_var(array(array('STA_ID' => $reg_row['Attendee_Meta.STA_ID'])),
-                                                   'STA_name');
-                        } elseif ($att_field_name == 'CNT_ISO') {
-                            $value = \EEM_Country::instance()
-                                                 ->get_var(array(array('CNT_ISO' => $reg_row['Attendee_Meta.CNT_ISO'])),
-                                                     'CNT_name');
-                        } else {
-                            $value = \EEH_Export::prepare_value_from_db_for_display(\EEM_Attendee::instance(),
-                                $att_field_name, $reg_row[$field_obj->get_qualified_column()]);
-                        }
-                    } else {
-                        $value = '';
-                    }
-                    $reg_csv_array[\EEH_Export::get_column_name_for_field($field_obj)] = $value;
-                }
-                //make sure each registration has the same questions in the same order
-                foreach ($questions_for_these_regs_rows as $question_row) {
-                    if ( ! isset($reg_csv_array[$question_row['Question.QST_admin_label']])) {
-                        $reg_csv_array[$question_row['Question.QST_admin_label']] = null;
-                    }
-                }
-                $answers = \EEM_Answer::instance()->get_all_wpdb_results(array(
-                        array('REG_ID' => $reg_row['Registration.REG_ID']),
-                        'force_join' => array('Question'),
-                    ));
-                //now fill out the questions THEY answered
-                foreach ($answers as $answer_row) {
-                    if ($answer_row['Question.QST_ID']) {
-                        $question_label = \EEH_Export::prepare_value_from_db_for_display(\EEM_Question::instance(),
-                            'QST_admin_label', $answer_row['Question.QST_admin_label']);
-                    } else {
-                        $question_label = sprintf(__('Question $s', 'event_espresso'), $answer_row['Answer.QST_ID']);
-                    }
-                    if (isset($answer_row['Question.QST_type'])
-                        && $answer_row['Question.QST_type'] == \EEM_Question::QST_type_state
-                    ) {
-                        $reg_csv_array[$question_label] = \EEM_State::instance()
-                                                                    ->get_state_name_by_ID($answer_row['Answer.ANS_value']);
-                    } else {
-                        //this isn't for html, so don't show html entities
-                        $reg_csv_array[$question_label] = html_entity_decode(\EEH_Export::prepare_value_from_db_for_display(\EEM_Answer::instance(),
-                            'ANS_value', $answer_row['Answer.ANS_value']));
-                    }
-                }
-                $registrations_csv_ready_array[] = apply_filters('FHEE__EE_Export__report_registrations__reg_csv_array',
-                    $reg_csv_array, $reg_row);
-            }
-        }
-        //if we couldn't export anything, we want to at least show the column headers
-        if (empty($registrations_csv_ready_array)) {
-            $reg_csv_array = array();
-            $model_and_fields_to_include = array(
-                'Registration' => $reg_fields_to_include,
-                'Attendee'     => $att_fields_to_include,
-            );
-            foreach ($model_and_fields_to_include as $model_name => $field_list) {
-                $model = \EE_Registry::instance()->load_model($model_name);
-                foreach ($field_list as $field_name) {
-                    $field = $model->field_settings_for($field_name);
-                    $reg_csv_array[\EEH_Export::get_column_name_for_field($field)] = null;
-                }
-            }
-            $registrations_csv_ready_array[] = $reg_csv_array;
-        }
-        return $registrations_csv_ready_array;
-    }
+	/**
+	 * Gets the csv data for a batch of registrations
+	 *
+	 * @param int|null $event_id
+	 * @param int      $offset
+	 * @param int      $limit
+	 * @param array    $questions_for_these_regs_rows results of $wpdb->get_results( $something, ARRAY_A) when querying
+	 *                                                for questions
+	 * @return array top-level keys are numeric, next-level keys are column headers
+	 */
+	function get_csv_data_for($event_id, $offset, $limit, $questions_for_these_regs_rows)
+	{
+		$reg_fields_to_include = array(
+			'TXN_ID',
+			'ATT_ID',
+			'REG_ID',
+			'REG_date',
+			'REG_code',
+			'REG_count',
+			'REG_final_price',
+		);
+		$att_fields_to_include = array(
+			'ATT_fname',
+			'ATT_lname',
+			'ATT_email',
+			'ATT_address',
+			'ATT_address2',
+			'ATT_city',
+			'STA_ID',
+			'CNT_ISO',
+			'ATT_zip',
+			'ATT_phone',
+		);
+		$registrations_csv_ready_array = array();
+		$reg_model = \EE_Registry::instance()->load_model('Registration');
+		$query_params = apply_filters('FHEE__EE_Export__report_registration_for_event', array(
+				array(
+					'OR'                 => array(
+						//don't include registrations from failed or abandoned transactions...
+						'Transaction.STS_ID' => array(
+							'NOT IN',
+							array(
+								\EEM_Transaction::failed_status_code,
+								\EEM_Transaction::abandoned_status_code,
+							),
+						),
+						//unless the registration is approved, in which case include it regardless of transaction status
+						'STS_ID'             => \EEM_Registration::status_id_approved,
+					),
+					'Ticket.TKT_deleted' => array('IN', array(true, false)),
+				),
+				'order_by'   => array('Transaction.TXN_ID' => 'asc', 'REG_count' => 'asc'),
+				'force_join' => array('Transaction', 'Ticket', 'Attendee'),
+				'limit'      => array($offset, $limit),
+				'caps'       => \EEM_Base::caps_read_admin,
+			), $event_id);
+		if ($event_id) {
+			$query_params[0]['EVT_ID'] = $event_id;
+		} else {
+			$query_params['force_join'][] = 'Event';
+		}
+		$registration_rows = $reg_model->get_all_wpdb_results($query_params);
+		//get all questions which relate to someone in this group
+		$registration_ids = array();
+		foreach ($registration_rows as $reg_row) {
+			$registration_ids[] = intval($reg_row['Registration.REG_ID']);
+		}
+		foreach ($registration_rows as $reg_row) {
+			if (is_array($reg_row)) {
+				$reg_csv_array = array();
+				if ( ! $event_id) {
+					//get the event's name and Id
+					$reg_csv_array[__('Event', 'event_espresso')] = sprintf(__('%1$s (%2$s)', 'event_espresso'),
+						\EEH_Export::prepare_value_from_db_for_display(\EEM_Event::instance(), 'EVT_name',
+							$reg_row['Event_CPT.post_title']), $reg_row['Event_CPT.ID']);
+				}
+				$is_primary_reg = $reg_row['Registration.REG_count'] == '1' ? true : false;
+				/*@var $reg_row EE_Registration */
+				foreach ($reg_fields_to_include as $field_name) {
+					$field = $reg_model->field_settings_for($field_name);
+					if ($field_name == 'REG_final_price') {
+						$value = \EEH_Export::prepare_value_from_db_for_display($reg_model, $field_name,
+							$reg_row['Registration.REG_final_price'], 'localized_float');
+					} elseif ($field_name == 'REG_count') {
+						$value = sprintf(__('%s of %s', 'event_espresso'),
+							\EEH_Export::prepare_value_from_db_for_display($reg_model, 'REG_count',
+								$reg_row['Registration.REG_count']),
+							\EEH_Export::prepare_value_from_db_for_display($reg_model, 'REG_group_size',
+								$reg_row['Registration.REG_group_size']));
+					} elseif ($field_name == 'REG_date') {
+						$value = \EEH_Export::prepare_value_from_db_for_display($reg_model, $field_name,
+							$reg_row['Registration.REG_date'], 'no_html');
+					} else {
+						$value = \EEH_Export::prepare_value_from_db_for_display($reg_model, $field_name,
+							$reg_row[$field->get_qualified_column()]);
+					}
+					$reg_csv_array[\EEH_Export::get_column_name_for_field($field)] = $value;
+					if ($field_name == 'REG_final_price') {
+						//add a column named Currency after the final price
+						$reg_csv_array[__("Currency", "event_espresso")] = \EE_Config::instance()->currency->code;
+					}
+				}
+				//get pretty status
+				$stati = \EEM_Status::instance()->localized_status(array(
+					$reg_row['Registration.STS_ID']     => __('unknown', 'event_espresso'),
+					$reg_row['TransactionTable.STS_ID'] => __('unknown', 'event_espresso'),
+				), false, 'sentence');
+				$reg_csv_array[__("Registration Status", 'event_espresso')] = $stati[$reg_row['Registration.STS_ID']];
+				//get pretty transaction status
+				$reg_csv_array[__("Transaction Status",
+					'event_espresso')] = $stati[$reg_row['TransactionTable.STS_ID']];
+				$reg_csv_array[__('Transaction Amount Due', 'event_espresso')] = $is_primary_reg
+					? \EEH_Export::prepare_value_from_db_for_display(\EEM_Transaction::instance(), 'TXN_total',
+						$reg_row['TransactionTable.TXN_total'], 'localized_float') : '0.00';
+				$reg_csv_array[__('Amount Paid', 'event_espresso')] = $is_primary_reg
+					? \EEH_Export::prepare_value_from_db_for_display(\EEM_Transaction::instance(), 'TXN_paid',
+						$reg_row['TransactionTable.TXN_paid'], 'localized_float') : '0.00';
+				$payment_methods = array();
+				$gateway_txn_ids_etc = array();
+				$payment_times = array();
+				if ($is_primary_reg && $reg_row['TransactionTable.TXN_ID']) {
+					$payments_info = \EEM_Payment::instance()->get_all_wpdb_results(array(
+						array(
+							'TXN_ID' => $reg_row['TransactionTable.TXN_ID'],
+							'STS_ID' => \EEM_Payment::status_id_approved,
+						),
+						'force_join' => array('Payment_Method'),
+					), ARRAY_A,
+						'Payment_Method.PMD_admin_name as name, Payment.PAY_txn_id_chq_nmbr as gateway_txn_id, Payment.PAY_timestamp as payment_time');
+					foreach ($payments_info as $payment_method_and_gateway_txn_id) {
+						$payment_methods[] = isset($payment_method_and_gateway_txn_id['name'])
+							? $payment_method_and_gateway_txn_id['name'] : __('Unknown', 'event_espresso');
+						$gateway_txn_ids_etc[] = isset($payment_method_and_gateway_txn_id['gateway_txn_id'])
+							? $payment_method_and_gateway_txn_id['gateway_txn_id'] : '';
+						$payment_times[] = isset($payment_method_and_gateway_txn_id['payment_time'])
+							? $payment_method_and_gateway_txn_id['payment_time'] : '';
+					}
+				}
+				$reg_csv_array[__('Payment Date(s)', 'event_espresso')] = implode(',', $payment_times);
+				$reg_csv_array[__('Payment Method(s)', 'event_espresso')] = implode(",", $payment_methods);
+				$reg_csv_array[__('Gateway Transaction ID(s)', 'event_espresso')] = implode(',', $gateway_txn_ids_etc);
+				//get whether or not the user has checked in
+				$reg_csv_array[__("Check-Ins",
+					"event_espresso")] = $reg_model->count_related($reg_row['Registration.REG_ID'], 'Checkin');
+				//get ticket of registration and its price
+				$ticket_model = \EE_Registry::instance()->load_model('Ticket');
+				if ($reg_row['Ticket.TKT_ID']) {
+					$ticket_name = \EEH_Export::prepare_value_from_db_for_display($ticket_model, 'TKT_name',
+						$reg_row['Ticket.TKT_name']);
+					$datetimes_strings = array();
+					foreach (
+						\EEM_Datetime::instance()
+									 ->get_all_wpdb_results(array(
+										 array('Ticket.TKT_ID' => $reg_row['Ticket.TKT_ID']),
+										 'order_by'                 => array('DTT_EVT_start' => 'ASC'),
+										 'default_where_conditions' => 'none',
+									 )) as $datetime
+					) {
+						$datetimes_strings[] = \EEH_Export::prepare_value_from_db_for_display(\EEM_Datetime::instance(),
+							'DTT_EVT_start', $datetime['Datetime.DTT_EVT_start']);
+					}
+				} else {
+					$ticket_name = __('Unknown', 'event_espresso');
+					$datetimes_strings = array(__('Unknown', 'event_espresso'));
+				}
+				$reg_csv_array[$ticket_model->field_settings_for('TKT_name')->get_nicename()] = $ticket_name;
+				$reg_csv_array[__("Datetimes of Ticket", "event_espresso")] = implode(", ", $datetimes_strings);
+				//get datetime(s) of registration
+				//add attendee columns
+				foreach ($att_fields_to_include as $att_field_name) {
+					$field_obj = \EEM_Attendee::instance()->field_settings_for($att_field_name);
+					if ($reg_row['Attendee_CPT.ID']) {
+						if ($att_field_name == 'STA_ID') {
+							$value = \EEM_State::instance()
+											   ->get_var(array(array('STA_ID' => $reg_row['Attendee_Meta.STA_ID'])),
+												   'STA_name');
+						} elseif ($att_field_name == 'CNT_ISO') {
+							$value = \EEM_Country::instance()
+												 ->get_var(array(array('CNT_ISO' => $reg_row['Attendee_Meta.CNT_ISO'])),
+													 'CNT_name');
+						} else {
+							$value = \EEH_Export::prepare_value_from_db_for_display(\EEM_Attendee::instance(),
+								$att_field_name, $reg_row[$field_obj->get_qualified_column()]);
+						}
+					} else {
+						$value = '';
+					}
+					$reg_csv_array[\EEH_Export::get_column_name_for_field($field_obj)] = $value;
+				}
+				//make sure each registration has the same questions in the same order
+				foreach ($questions_for_these_regs_rows as $question_row) {
+					if ( ! isset($reg_csv_array[$question_row['Question.QST_admin_label']])) {
+						$reg_csv_array[$question_row['Question.QST_admin_label']] = null;
+					}
+				}
+				$answers = \EEM_Answer::instance()->get_all_wpdb_results(array(
+						array('REG_ID' => $reg_row['Registration.REG_ID']),
+						'force_join' => array('Question'),
+					));
+				//now fill out the questions THEY answered
+				foreach ($answers as $answer_row) {
+					if ($answer_row['Question.QST_ID']) {
+						$question_label = \EEH_Export::prepare_value_from_db_for_display(\EEM_Question::instance(),
+							'QST_admin_label', $answer_row['Question.QST_admin_label']);
+					} else {
+						$question_label = sprintf(__('Question $s', 'event_espresso'), $answer_row['Answer.QST_ID']);
+					}
+					if (isset($answer_row['Question.QST_type'])
+						&& $answer_row['Question.QST_type'] == \EEM_Question::QST_type_state
+					) {
+						$reg_csv_array[$question_label] = \EEM_State::instance()
+																	->get_state_name_by_ID($answer_row['Answer.ANS_value']);
+					} else {
+						//this isn't for html, so don't show html entities
+						$reg_csv_array[$question_label] = html_entity_decode(\EEH_Export::prepare_value_from_db_for_display(\EEM_Answer::instance(),
+							'ANS_value', $answer_row['Answer.ANS_value']));
+					}
+				}
+				$registrations_csv_ready_array[] = apply_filters('FHEE__EE_Export__report_registrations__reg_csv_array',
+					$reg_csv_array, $reg_row);
+			}
+		}
+		//if we couldn't export anything, we want to at least show the column headers
+		if (empty($registrations_csv_ready_array)) {
+			$reg_csv_array = array();
+			$model_and_fields_to_include = array(
+				'Registration' => $reg_fields_to_include,
+				'Attendee'     => $att_fields_to_include,
+			);
+			foreach ($model_and_fields_to_include as $model_name => $field_list) {
+				$model = \EE_Registry::instance()->load_model($model_name);
+				foreach ($field_list as $field_name) {
+					$field = $model->field_settings_for($field_name);
+					$reg_csv_array[\EEH_Export::get_column_name_for_field($field)] = null;
+				}
+			}
+			$registrations_csv_ready_array[] = $reg_csv_array;
+		}
+		return $registrations_csv_ready_array;
+	}
 
 
 
-    /**
-     * Counts total unit to process
-     *
-     * @param int $event_id
-     * @return int
-     */
-    public function count_units_to_process($event_id)
-    {
-        //use the legacy filter
-        $query_params = apply_filters('FHEE__EE_Export__report_registration_for_event', array(
-                array(
-                    'OR'                 => array(
-                        //don't include registrations from failed or abandoned transactions...
-                        'Transaction.STS_ID' => array(
-                            'NOT IN',
-                            array(
-                                \EEM_Transaction::failed_status_code,
-                                \EEM_Transaction::abandoned_status_code,
-                            ),
-                        ),
-                        //unless the registration is approved, in which case include it regardless of transaction status
-                        'STS_ID'             => \EEM_Registration::status_id_approved,
-                    ),
-                    'Ticket.TKT_deleted' => array('IN', array(true, false)),
-                ),
-                'order_by'   => array('Transaction.TXN_ID' => 'asc', 'REG_count' => 'asc'),
-                'force_join' => array('Transaction', 'Ticket', 'Attendee'),
-                'caps'       => \EEM_Base::caps_read_admin,
-            ), $event_id);
-        if ($event_id) {
-            $query_params[0]['EVT_ID'] = $event_id;
-        } else {
-            $query_params['force_join'][] = 'Event';
-        }
-        return \EEM_Registration::instance()->count($query_params);
-    }
+	/**
+	 * Counts total unit to process
+	 *
+	 * @param int $event_id
+	 * @return int
+	 */
+	public function count_units_to_process($event_id)
+	{
+		//use the legacy filter
+		$query_params = apply_filters('FHEE__EE_Export__report_registration_for_event', array(
+				array(
+					'OR'                 => array(
+						//don't include registrations from failed or abandoned transactions...
+						'Transaction.STS_ID' => array(
+							'NOT IN',
+							array(
+								\EEM_Transaction::failed_status_code,
+								\EEM_Transaction::abandoned_status_code,
+							),
+						),
+						//unless the registration is approved, in which case include it regardless of transaction status
+						'STS_ID'             => \EEM_Registration::status_id_approved,
+					),
+					'Ticket.TKT_deleted' => array('IN', array(true, false)),
+				),
+				'order_by'   => array('Transaction.TXN_ID' => 'asc', 'REG_count' => 'asc'),
+				'force_join' => array('Transaction', 'Ticket', 'Attendee'),
+				'caps'       => \EEM_Base::caps_read_admin,
+			), $event_id);
+		if ($event_id) {
+			$query_params[0]['EVT_ID'] = $event_id;
+		} else {
+			$query_params['force_join'][] = 'Event';
+		}
+		return \EEM_Registration::instance()->count($query_params);
+	}
 
 
 
-    /**
-     * Performs any clean-up logic when we know the job is completed.
-     * In this case, we delete the temporary file
-     *
-     * @param JobParameters $job_parameters
-     * @return boolean
-     */
-    public function cleanup_job(JobParameters $job_parameters)
-    {
-        $this->_file_helper->delete(\EEH_File::remove_filename_from_filepath($job_parameters->extra_datum('filepath')),
-            true, 'd');
-        return new JobStepResponse($job_parameters, __('Cleaned up temporary file', 'event_espresso'));
-    }
+	/**
+	 * Performs any clean-up logic when we know the job is completed.
+	 * In this case, we delete the temporary file
+	 *
+	 * @param JobParameters $job_parameters
+	 * @return boolean
+	 */
+	public function cleanup_job(JobParameters $job_parameters)
+	{
+		$this->_file_helper->delete(\EEH_File::remove_filename_from_filepath($job_parameters->extra_datum('filepath')),
+			true, 'd');
+		return new JobStepResponse($job_parameters, __('Cleaned up temporary file', 'event_espresso'));
+	}
 }
 
 

admin_pages/registrations/Registrations_Admin_Page.core.php

Spacing +71 added lines, -71 removed lines

@@ -586,11 +586,11 @@ 
     {
         //style
         //wp_register_style('espresso_attendees', ATT_ASSETS_URL . 'espresso_attendees_admin.css', array(), EVENT_ESPRESSO_VERSION );
-        wp_register_style('espresso_reg', REG_ASSETS_URL . 'espresso_registrations_admin.css', array('ee-admin-css'),
+        wp_register_style('espresso_reg', REG_ASSETS_URL.'espresso_registrations_admin.css', array('ee-admin-css'),
             EVENT_ESPRESSO_VERSION);
         wp_enqueue_style('espresso_reg');
         //script
-        wp_register_script('espresso_reg', REG_ASSETS_URL . 'espresso_registrations_admin.js',
+        wp_register_script('espresso_reg', REG_ASSETS_URL.'espresso_registrations_admin.js',
             array('jquery-ui-datepicker', 'jquery-ui-draggable', 'ee_admin_js'), EVENT_ESPRESSO_VERSION, true);
         wp_enqueue_script('espresso_reg');
     }
@@ -624,7 +624,7 @@ 
     public function load_scripts_styles_contact_list()
     {
         wp_deregister_style('espresso_reg');
-        wp_register_style('espresso_att', REG_ASSETS_URL . 'espresso_attendees_admin.css', array('ee-admin-css'),
+        wp_register_style('espresso_att', REG_ASSETS_URL.'espresso_attendees_admin.css', array('ee-admin-css'),
             EVENT_ESPRESSO_VERSION);
         wp_enqueue_style('espresso_att');
     }
@@ -633,7 +633,7 @@ 
 
     public function load_scripts_styles_new_registration()
     {
-        wp_register_script('ee-spco-for-admin', REG_ASSETS_URL . 'spco_for_admin.js', array('underscore', 'jquery'),
+        wp_register_script('ee-spco-for-admin', REG_ASSETS_URL.'spco_for_admin.js', array('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');
@@ -833,31 +833,31 @@ 
         }
         $sc_items = array(
             'approved_status'   => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_approved,
+                'class' => 'ee-status-legend ee-status-legend-'.EEM_Registration::status_id_approved,
                 'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_approved, false, 'sentence'),
             ),
             'pending_status'    => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_pending_payment,
+                'class' => 'ee-status-legend ee-status-legend-'.EEM_Registration::status_id_pending_payment,
                 'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_pending_payment, false, 'sentence'),
             ),
             'wait_list'         => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_wait_list,
+                'class' => 'ee-status-legend ee-status-legend-'.EEM_Registration::status_id_wait_list,
                 'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_wait_list, false, 'sentence'),
             ),
             'incomplete_status' => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_incomplete,
+                'class' => 'ee-status-legend ee-status-legend-'.EEM_Registration::status_id_incomplete,
                 'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_incomplete, false, 'sentence'),
             ),
             'not_approved'      => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_not_approved,
+                'class' => 'ee-status-legend ee-status-legend-'.EEM_Registration::status_id_not_approved,
                 'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_not_approved, false, 'sentence'),
             ),
             'declined_status'   => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_declined,
+                'class' => 'ee-status-legend ee-status-legend-'.EEM_Registration::status_id_declined,
                 'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_declined, false, 'sentence'),
             ),
             'cancelled_status'  => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_cancelled,
+                'class' => 'ee-status-legend ee-status-legend-'.EEM_Registration::status_id_cancelled,
                 'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_cancelled, false, 'sentence'),
             ),
         );
@@ -878,17 +878,17 @@ 
             if (EE_Registry::instance()->CAP->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',
+                $this->_admin_page_title .= ' '.$this->get_action_link_or_button('new_registration', 'add-registrant',
                         array('event_id' => $EVT_ID), 'add-new-h2');
             }
             $event = EEM_Event::instance()->get_one_by_ID($EVT_ID);
             if ($event instanceof EE_Event) {
                 $this->_template_args['admin_page_header'] = sprintf(__('%s Viewing registrations for the event: %s%s',
                     'event_espresso'), '<h3 style="line-height:1.5em;">',
-                    '<br /><a href="' . EE_Admin_Page::add_query_args_and_nonce(array(
+                    '<br /><a href="'.EE_Admin_Page::add_query_args_and_nonce(array(
                         'action' => 'edit',
                         'post'   => $event->ID(),
-                    ), EVENTS_ADMIN_URL) . '">&nbsp;' . $event->get('EVT_name') . '&nbsp;</a>&nbsp;', '</h3>');
+                    ), EVENTS_ADMIN_URL).'">&nbsp;'.$event->get('EVT_name').'&nbsp;</a>&nbsp;', '</h3>');
             }
             $DTT_ID = ! empty($this->_req_data['datetime_id']) ? absint($this->_req_data['datetime_id']) : 0;
             $datetime = EEM_Datetime::instance()->get_one_by_ID($DTT_ID);
@@ -897,7 +897,7 @@ 
                 $this->_template_args['admin_page_header'] .= ' &nbsp;<span class="drk-grey-text">';
                 $this->_template_args['admin_page_header'] .= '<span class="dashicons dashicons-calendar"></span>';
                 $this->_template_args['admin_page_header'] .= $datetime->name();
-                $this->_template_args['admin_page_header'] .= ' ( ' . $datetime->start_date() . ' )';
+                $this->_template_args['admin_page_header'] .= ' ( '.$datetime->start_date().' )';
                 $this->_template_args['admin_page_header'] .= '</span></h3>';
             }
         }
@@ -948,13 +948,13 @@ 
     {
         $EVT_ID = ! empty($this->_req_data['event_id']) && $this->_req_data['event_id'] > 0
             ? absint($this->_req_data['event_id']) : false;
-        $CAT_ID = ! empty($this->_req_data['EVT_CAT']) && (int)$this->_req_data['EVT_CAT'] > 0
+        $CAT_ID = ! empty($this->_req_data['EVT_CAT']) && (int) $this->_req_data['EVT_CAT'] > 0
             ? absint($this->_req_data['EVT_CAT']) : false;
         $DTT_ID = isset($this->_req_data['datetime_id']) ? absint($this->_req_data['datetime_id']) : null;
         $reg_status = ! empty($this->_req_data['_reg_status']) ? sanitize_text_field($this->_req_data['_reg_status'])
             : false;
         $month_range = ! empty($this->_req_data['month_range']) ? sanitize_text_field($this->_req_data['month_range'])
-            : false;//should be like 2013-april
+            : false; //should be like 2013-april
         $today_a = ! empty($this->_req_data['status']) && $this->_req_data['status'] === 'today' ? true : false;
         $this_month_a = ! empty($this->_req_data['status']) && $this->_req_data['status'] === 'month' ? true : false;
         $start_date = false;
@@ -1018,9 +1018,9 @@ 
                 'BETWEEN',
                 array(
                     EEM_Registration::instance()
-                                    ->convert_datetime_for_query('REG_date', $curdate . $time_start, 'Y-m-d H:i:s'),
+                                    ->convert_datetime_for_query('REG_date', $curdate.$time_start, 'Y-m-d H:i:s'),
                     EEM_Registration::instance()
-                                    ->convert_datetime_for_query('REG_date', $curdate . $time_end, 'Y-m-d H:i:s'),
+                                    ->convert_datetime_for_query('REG_date', $curdate.$time_end, 'Y-m-d H:i:s'),
                 ),
             );
         } elseif ($this_month_a || $this_month) {
@@ -1031,10 +1031,10 @@ 
                 array(
                     EEM_Registration::instance()
                                     ->convert_datetime_for_query('REG_date',
-                                        $this_year_r . '-' . $this_month_r . '-01' . ' ' . $time_start, 'Y-m-d H:i:s'),
+                                        $this_year_r.'-'.$this_month_r.'-01'.' '.$time_start, 'Y-m-d H:i:s'),
                     EEM_Registration::instance()
                                     ->convert_datetime_for_query('REG_date',
-                                        $this_year_r . '-' . $this_month_r . '-' . $days_this_month . ' ' . $time_end,
+                                        $this_year_r.'-'.$this_month_r.'-'.$days_this_month.' '.$time_end,
                                         'Y-m-d H:i:s'),
                 ),
             );
@@ -1042,16 +1042,16 @@ 
             $pieces = explode(' ', $this->_req_data['month_range'], 3);
             $month_r = ! empty($pieces[0]) ? date('m', strtotime($month_range)) : '';
             $year_r = ! empty($pieces[1]) ? $pieces[1] : '';
-            $days_in_month = date('t', strtotime($year_r . '-' . $month_r . '-' . '01'));
+            $days_in_month = date('t', strtotime($year_r.'-'.$month_r.'-'.'01'));
             $_where['REG_date'] = array(
                 'BETWEEN',
                 array(
                     EEM_Registration::instance()
-                                    ->convert_datetime_for_query('REG_date', $year_r . '-' . $month_r . '-01 00:00:00',
+                                    ->convert_datetime_for_query('REG_date', $year_r.'-'.$month_r.'-01 00:00:00',
                                         'Y-m-d H:i:s'),
                     EEM_Registration::instance()
                                     ->convert_datetime_for_query('REG_date',
-                                        $year_r . '-' . $month_r . '-' . $days_in_month . ' 23:59:59', 'Y-m-d H:i:s'),
+                                        $year_r.'-'.$month_r.'-'.$days_in_month.' 23:59:59', 'Y-m-d H:i:s'),
                 ),
             );
         } elseif ($start_date && $end_date) {
@@ -1062,7 +1062,7 @@ 
             throw new EE_Error("not yet supported");
         }
         if ( ! empty($this->_req_data['s'])) {
-            $sstr = '%' . $this->_req_data['s'] . '%';
+            $sstr = '%'.$this->_req_data['s'].'%';
             $_where['OR'] = array(
                 'Event.EVT_name'                          => array('LIKE', $sstr),
                 'Event.EVT_desc'                          => array('LIKE', $sstr),
@@ -1123,16 +1123,16 @@ 
                 $event_name = $first_registration->event_obj()->name();
                 $event_date = $first_registration->date_obj()
                                                  ->start_date_and_time('l F j, Y,',
-                                                     'g:i:s a');// isset( $registrations[0]->DTT_EVT_start ) ? date( 'l F j, Y,    g:i:s a', $registrations[0]->DTT_EVT_start ) : '';
+                                                     'g:i:s a'); // isset( $registrations[0]->DTT_EVT_start ) ? date( 'l F j, Y,    g:i:s a', $registrations[0]->DTT_EVT_start ) : '';
                 // edit event link
                 if ($event_name != '') {
                     $edit_event_url = self::add_query_args_and_nonce(array(
                         'action' => 'edit_event',
                         'EVT_ID' => $EVT_ID,
                     ), EVENTS_ADMIN_URL);
-                    $edit_event_lnk = '<a href="' . $edit_event_url . '" title="' . esc_attr__('Edit ',
-                            'event_espresso') . $event_name . '">' . __('Edit Event', 'event_espresso') . '</a>';
-                    $event_name .= ' <span class="admin-page-header-edit-lnk not-bold">' . $edit_event_lnk . '</span>';
+                    $edit_event_lnk = '<a href="'.$edit_event_url.'" title="'.esc_attr__('Edit ',
+                            'event_espresso').$event_name.'">'.__('Edit Event', 'event_espresso').'</a>';
+                    $event_name .= ' <span class="admin-page-header-edit-lnk not-bold">'.$edit_event_lnk.'</span>';
                 }
                 $back_2_reg_url = self::add_query_args_and_nonce(array('action' => 'default'), REG_ADMIN_URL);
                 $back_2_reg_lnk = '<a href="'
@@ -1144,9 +1144,9 @@ 
                                   . '</a>';
                 $this->_template_args['before_admin_page_content'] = '
 			<div id="admin-page-header">
-				<h1><span class="small-text not-bold">' . __('Event: ', 'event_espresso') . '</span>' . $event_name . '</h1>
-				<h3><span class="small-text not-bold">' . __('Date: ', 'event_espresso') . '</span>' . $event_date . '</h3>
-				<span class="admin-page-header-go-back-lnk not-bold">' . $back_2_reg_lnk . '</span>
+				<h1><span class="small-text not-bold">' . __('Event: ', 'event_espresso').'</span>'.$event_name.'</h1>
+				<h3><span class="small-text not-bold">' . __('Date: ', 'event_espresso').'</span>'.$event_date.'</h3>
+				<span class="admin-page-header-go-back-lnk not-bold">' . $back_2_reg_lnk.'</span>
 			</div>
 			';
             }
@@ -1217,7 +1217,7 @@ 
                     '_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';
+            $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);
@@ -1294,8 +1294,8 @@ 
                         'default' => $this->_registration->ID(),
                     )),
                     'current_status'     => new EE_Form_Section_HTML(EEH_HTML::tr(EEH_HTML::th(EEH_HTML::label(EEH_HTML::strong(__('Current Registration Status',
-                            'event_espresso')))) . EEH_HTML::td(EEH_HTML::strong($this->_registration->pretty_status(),
-                            '', 'status-' . $this->_registration->status_ID(),
+                            'event_espresso')))).EEH_HTML::td(EEH_HTML::strong($this->_registration->pretty_status(),
+                            '', 'status-'.$this->_registration->status_ID(),
                             'line-height: 1em; font-size: 1.5em; font-weight: bold;')))),
                     'reg_status'         => new EE_Select_Input($this->_get_reg_statuses(), array(
                             'html_label_text' => __('Change Registration Status to', 'event_espresso'),
@@ -1383,9 +1383,9 @@ 
     {
         if (isset($this->_req_data['reg_status_change_form'])) {
             $REG_IDs = isset($this->_req_data['reg_status_change_form']['REG_ID'])
-                ? (array)$this->_req_data['reg_status_change_form']['REG_ID'] : array();
+                ? (array) $this->_req_data['reg_status_change_form']['REG_ID'] : array();
         } else {
-            $REG_IDs = isset($this->_req_data['_REG_ID']) ? (array)$this->_req_data['_REG_ID'] : array();
+            $REG_IDs = isset($this->_req_data['_REG_ID']) ? (array) $this->_req_data['_REG_ID'] : array();
         }
         $success = $this->_set_registration_status($REG_IDs, $status);
         //notify?
@@ -1414,7 +1414,7 @@ 
     {
         $success = false;
         // typecast $REG_IDs
-        $REG_IDs = (array)$REG_IDs;
+        $REG_IDs = (array) $REG_IDs;
         if ( ! empty($REG_IDs)) {
             $success = true;
             // set default status if none is passed
@@ -1714,7 +1714,7 @@ 
         ), 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';
+        $template_path = REG_TEMPLATE_PATH.'reg_admin_details_main_meta_box_reg_details.template.php';
         echo EEH_Template::display_template($template_path, $this->_template_args, true);
     }
 
@@ -1737,7 +1737,7 @@ 
             $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';
+            $template_path = REG_TEMPLATE_PATH.'reg_admin_details_main_meta_box_reg_questions.template.php';
             echo EEH_Template::display_template($template_path, $this->_template_args, true);
         }
     }
@@ -1754,7 +1754,7 @@ 
      */
     public function form_before_question_group($output)
     {
-        EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
+        EE_Error::doing_it_wrong(__CLASS__.'::'.__FUNCTION__,
             __('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');
@@ -1776,7 +1776,7 @@ 
      */
     public function form_after_question_group($output)
     {
-        EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
+        EE_Error::doing_it_wrong(__CLASS__.'::'.__FUNCTION__,
             __('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');
@@ -1811,14 +1811,14 @@ 
      */
     public function form_form_field_label_wrap($label)
     {
-        EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
+        EE_Error::doing_it_wrong(__CLASS__.'::'.__FUNCTION__,
             __('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 . '
+					' . $label.'
 				</th>';
     }
 
@@ -1834,13 +1834,13 @@ 
      */
     public function form_form_field_input__wrap($input)
     {
-        EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
+        EE_Error::doing_it_wrong(__CLASS__.'::'.__FUNCTION__,
             __('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 . '
+					' . $input.'
 				</td>
 			</tr>';
     }
@@ -1882,7 +1882,7 @@ 
     protected function _get_reg_custom_questions_form($REG_ID)
     {
         if ( ! $this->_reg_custom_questions_form) {
-            require_once(REG_ADMIN . 'form_sections' . DS . 'EE_Registration_Custom_Questions_Form.form.php');
+            require_once(REG_ADMIN.'form_sections'.DS.'EE_Registration_Custom_Questions_Form.form.php');
             $this->_reg_custom_questions_form = new EE_Registration_Custom_Questions_Form(EEM_Registration::instance()
                                                                                                           ->get_one_by_ID($REG_ID));
             $this->_reg_custom_questions_form->_construct_finalize(null, null);
@@ -1973,10 +1973,10 @@ 
                     : EEM_Attendee::instance()
                                   ->create_default_object();
                 $this->_template_args['attendees'][$att_nmbr]['STS_ID'] = $registration->status_ID();
-                $this->_template_args['attendees'][$att_nmbr]['fname'] = $attendee->fname();//( isset( $registration->ATT_fname ) & ! empty( $registration->ATT_fname ) ) ? $registration->ATT_fname : '';
-                $this->_template_args['attendees'][$att_nmbr]['lname'] = $attendee->lname();//( isset( $registration->ATT_lname ) & ! empty( $registration->ATT_lname ) ) ? $registration->ATT_lname : '';
-                $this->_template_args['attendees'][$att_nmbr]['email'] = $attendee->email();//( isset( $registration->ATT_email ) & ! empty( $registration->ATT_email ) ) ? $registration->ATT_email : '';
-                $this->_template_args['attendees'][$att_nmbr]['final_price'] = $registration->final_price();//( isset( $registration->REG_final_price ) & ! empty( $registration->REG_final_price ) ) ? $registration->REG_final_price : '';
+                $this->_template_args['attendees'][$att_nmbr]['fname'] = $attendee->fname(); //( isset( $registration->ATT_fname ) & ! empty( $registration->ATT_fname ) ) ? $registration->ATT_fname : '';
+                $this->_template_args['attendees'][$att_nmbr]['lname'] = $attendee->lname(); //( isset( $registration->ATT_lname ) & ! empty( $registration->ATT_lname ) ) ? $registration->ATT_lname : '';
+                $this->_template_args['attendees'][$att_nmbr]['email'] = $attendee->email(); //( isset( $registration->ATT_email ) & ! empty( $registration->ATT_email ) ) ? $registration->ATT_email : '';
+                $this->_template_args['attendees'][$att_nmbr]['final_price'] = $registration->final_price(); //( isset( $registration->REG_final_price ) & ! empty( $registration->REG_final_price ) ) ? $registration->REG_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(array(
@@ -1990,7 +1990,7 @@ 
             $this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
             //			$this->_template_args['registration_form_url'] = add_query_arg( array( 'action' => 'edit_registration', 'process' => 'attendees'  ), REG_ADMIN_URL );
         }
-        $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';
         echo EEH_Template::display_template($template_path, $this->_template_args, true);
     }
 
@@ -2020,9 +2020,9 @@ 
             $primary_registration = null;
         }
         $this->_template_args['ATT_ID'] = $attendee->ID();
-        $this->_template_args['fname'] = $attendee->fname();//$this->_registration->ATT_fname;
-        $this->_template_args['lname'] = $attendee->lname();//$this->_registration->ATT_lname;
-        $this->_template_args['email'] = $attendee->email();//$this->_registration->ATT_email;
+        $this->_template_args['fname'] = $attendee->fname(); //$this->_registration->ATT_fname;
+        $this->_template_args['lname'] = $attendee->lname(); //$this->_registration->ATT_lname;
+        $this->_template_args['email'] = $attendee->email(); //$this->_registration->ATT_email;
         $this->_template_args['phone'] = $attendee->phone();
         $this->_template_args['formatted_address'] = EEH_Address::format($attendee);
         //edit link
@@ -2039,7 +2039,7 @@ 
             ), REG_ADMIN_URL) : '';
         $this->_template_args['create_label'] = __('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';
+        $template_path = REG_TEMPLATE_PATH.'reg_admin_details_side_meta_box_registrant.template.php';
         echo EEH_Template::display_template($template_path, $this->_template_args, true);
     }
 
@@ -2274,7 +2274,7 @@ 
             $this->_return_json();
         }
         // grab header
-        $template_path = REG_TEMPLATE_PATH . 'reg_admin_register_new_attendee.template.php';
+        $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 );
@@ -2297,7 +2297,7 @@ 
                 '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>
+	<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 !!!
@@ -2518,7 +2518,7 @@ 
     public function get_attendees($per_page, $count = false, $trash = false)
     {
         do_action('AHEE_log', __FILE__, __FUNCTION__, '');
-        require_once(REG_ADMIN . 'EE_Attendee_Contact_List_Table.class.php');
+        require_once(REG_ADMIN.'EE_Attendee_Contact_List_Table.class.php');
         $ATT_MDL = EEM_Attendee::instance();
         $this->_req_data['orderby'] = ! empty($this->_req_data['orderby']) ? $this->_req_data['orderby'] : '';
         switch ($this->_req_data['orderby']) {
@@ -2552,7 +2552,7 @@ 
             ? $this->_req_data['perpage'] : $per_page;
         $_where = array();
         if ( ! empty($this->_req_data['s'])) {
-            $sstr = '%' . $this->_req_data['s'] . '%';
+            $sstr = '%'.$this->_req_data['s'].'%';
             $_where['OR'] = array(
                 'Registration.Event.EVT_name'       => array('LIKE', $sstr),
                 'Registration.Event.EVT_desc'       => array('LIKE', $sstr),
@@ -2643,8 +2643,8 @@ 
                 'EVT_ID' => isset($this->_req_data['EVT_ID']) ? $this->_req_data['EVT_ID'] : null,
             );
             $this->_req_data = array_merge($this->_req_data, $new_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($this->_req_data);
                 $EE_Export->export();
             }
@@ -2655,8 +2655,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->_req_data);
             $EE_Export->export_attendees();
         }
@@ -2674,8 +2674,8 @@ 
                 'return_url'  => urlencode($this->_req_data['return_url']),
             )));
         } 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->_req_data);
                 $EE_Export->report_attendees();
             }
@@ -2733,7 +2733,7 @@ 
             $updated_fields = array(
                 'ATT_fname'     => $this->_req_data['ATT_fname'],
                 'ATT_lname'     => $this->_req_data['ATT_lname'],
-                'ATT_full_name' => $this->_req_data['ATT_fname'] . ' ' . $this->_req_data['ATT_lname'],
+                'ATT_full_name' => $this->_req_data['ATT_fname'].' '.$this->_req_data['ATT_lname'],
                 'ATT_address'   => isset($this->_req_data['ATT_address']) ? $this->_req_data['ATT_address'] : '',
                 'ATT_address2'  => isset($this->_req_data['ATT_address2']) ? $this->_req_data['ATT_address2'] : '',
                 'ATT_city'      => isset($this->_req_data['ATT_city']) ? $this->_req_data['ATT_city'] : '',
@@ -2822,7 +2822,7 @@ 
     {
         //get attendee object ( should already have it )
         $this->_template_args['attendee'] = $this->_cpt_model_obj;
-        $template = REG_TEMPLATE_PATH . 'attendee_contact_info_metabox_content.template.php';
+        $template = REG_TEMPLATE_PATH.'attendee_contact_info_metabox_content.template.php';
         EEH_Template::display_template($template, $this->_template_args);
     }
 
@@ -2864,7 +2864,7 @@ 
                 'input_prefix'   => '',
                 'append_qstn_id' => false,
             )));
-        $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);
     }
 
@@ -2880,7 +2880,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';
+        $template = REG_TEMPLATE_PATH.'attendee_registrations_main_meta_box.template.php';
         EEH_Template::display_template($template, $this->_template_args);
     }
 
@@ -2895,7 +2895,7 @@ 
     public function after_title_form_fields($post)
     {
         if ($post->post_type == 'espresso_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);
         }

Indentation +2885 added lines, -2885 removed lines

@@ -1,5 +1,5 @@ 
 <?php if ( ! defined('EVENT_ESPRESSO_VERSION')) {
-    exit('No direct script access allowed');
+	exit('No direct script access allowed');
 }
 
 
@@ -24,1772 +24,1772 @@ 
 class Registrations_Admin_Page extends EE_Admin_Page_CPT
 {
 
-    /**
-     * @var EE_Registration
-     */
-    private $_registration;
-
-    /**
-     * @var EE_Event
-     */
-    private $_reg_event;
-
-    /**
-     * @var EE_Session
-     */
-    private        $_session;
-
-    private static $_reg_status;
-
-    /**
-     * Form for displaying the custom questions for this registration.
-     * This gets used a few times throughout the request so its best to cache it
-     *
-     * @var EE_Registration_Custom_Questions_Form
-     */
-    protected $_reg_custom_questions_form = null;
-
-
-
-    /**
-     *        constructor
-     *
-     * @Constructor
-     * @access public
-     * @param bool $routing
-     * @return Registrations_Admin_Page
-     */
-    public function __construct($routing = true)
-    {
-        parent::__construct($routing);
-        add_action('wp_loaded', array($this, 'wp_loaded'));
-    }
-
-
-
-    public function wp_loaded()
-    {
-        // when adding a new registration...
-        if (isset($this->_req_data['action']) && $this->_req_data['action'] === 'new_registration') {
-            EE_System::do_not_cache();
-            if ( ! isset($this->_req_data['processing_registration'])
-                 || absint($this->_req_data['processing_registration']) !== 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 = __('Registrations', 'event_espresso');
-        $this->_cpt_routes = array(
-            'add_new_attendee' => 'espresso_attendees',
-            'edit_attendee'    => 'espresso_attendees',
-            'insert_attendee'  => 'espresso_attendees',
-            'update_attendee'  => 'espresso_attendees',
-        );
-        $this->_cpt_model_names = array(
-            'add_new_attendee' => 'EEM_Attendee',
-            'edit_attendee'    => 'EEM_Attendee',
-        );
-        $this->_cpt_edit_routes = array(
-            'espresso_attendees' => 'edit_attendee',
-        );
-        $this->_pagenow_map = array(
-            'add_new_attendee' => 'post-new.php',
-            'edit_attendee'    => 'post.php',
-            'trash'            => 'post.php',
-        );
-        add_action('edit_form_after_title', array($this, 'after_title_form_fields'), 10);
-        //add filters so that the comment urls don't take users to a confusing 404 page
-        add_filter('get_comment_link', array($this, 'clear_comment_link'), 10, 3);
-    }
-
-
-
-    public function clear_comment_link($link, $comment, $args)
-    {
-        //gotta make sure this only happens on this route
-        $post_type = get_post_type($comment->comment_post_ID);
-        if ($post_type === 'espresso_attendees') {
-            return '#commentsdiv';
-        }
-        return $link;
-    }
-
-
-
-    protected function _ajax_hooks()
-    {
-        //todo: all hooks for registrations ajax goes in here
-        add_action('wp_ajax_toggle_checkin_status', array($this, 'toggle_checkin_status'));
-    }
-
-
-
-    protected function _define_page_props()
-    {
-        $this->_admin_page_title = $this->page_label;
-        $this->_labels = array(
-            'buttons'                      => array(
-                'add-registrant'      => __('Add New Registration', 'event_espresso'),
-                'add-attendee'        => __('Add Contact', 'event_espresso'),
-                'edit'                => __('Edit Contact', 'event_espresso'),
-                'report'              => __("Event Registrations CSV Report", "event_espresso"),
-                'report_all'          => __('All Registrations CSV Report', 'event_espresso'),
-                'contact_list_report' => __('Contact List Report', 'event_espresso'),
-                'contact_list_export' => __("Export Data", "event_espresso"),
-            ),
-            'publishbox'                   => array(
-                'add_new_attendee' => __("Add Contact Record", 'event_espresso'),
-                'edit_attendee'    => __("Update Contact Record", 'event_espresso'),
-            ),
-            'hide_add_button_on_cpt_route' => array(
-                'edit_attendee' => true,
-            ),
-        );
-    }
-
-
-
-    /**
-     *        grab url requests and route them
-     *
-     * @access private
-     * @return void
-     */
-    public function _set_page_routes()
-    {
-        $this->_get_registration_status_array();
-        $reg_id = ! empty($this->_req_data['_REG_ID']) && ! is_array($this->_req_data['_REG_ID'])
-            ? $this->_req_data['_REG_ID'] : 0;
-        $att_id = ! empty($this->_req_data['ATT_ID']) && ! is_array($this->_req_data['ATT_ID'])
-            ? $this->_req_data['ATT_ID'] : 0;
-        $att_id = ! empty($this->_req_data['post']) && ! is_array($this->_req_data['post']) ? $this->_req_data['post']
-            : $att_id;
-        $this->_page_routes = array(
-            'default' => array(
-                'func'       => '_registrations_overview_list_table',
-                'capability' => 'ee_read_registrations',
-            ),
-            'view_registration' => array(
-                'func'       => '_registration_details',
-                'capability' => 'ee_read_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'edit_registration' => array(
-                'func'               => '_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' => array(
-                'func'       => '_trash_or_restore_registrations',
-                'args'       => array('trash' => true),
-                'noheader'   => true,
-                'capability' => 'ee_delete_registrations',
-            ),
-            'restore_registrations' => array(
-                'func'       => '_trash_or_restore_registrations',
-                'args'       => array('trash' => false),
-                'noheader'   => true,
-                'capability' => 'ee_delete_registrations',
-            ),
-            'delete_registrations' => array(
-                'func'       => '_delete_registrations',
-                'noheader'   => true,
-                'capability' => 'ee_delete_registrations',
-            ),
-            'new_registration' => array(
-                'func'       => 'new_registration',
-                'capability' => 'ee_edit_registrations',
-            ),
-            'process_reg_step' => array(
-                'func'       => 'process_reg_step',
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-            ),
-            'redirect_to_txn' => array(
-                'func'       => 'redirect_to_txn',
-                'noheader'   => true,
-                'capability' => 'ee_edit_registrations',
-            ),
-            'change_reg_status' => array(
-                'func'       => '_change_reg_status',
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'approve_registration' => array(
-                'func'       => 'approve_registration',
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'approve_and_notify_registration' => array(
-                'func'       => 'approve_registration',
-                'noheader'   => true,
-                'args'       => array(true),
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'decline_registration' => array(
-                'func'       => 'decline_registration',
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'decline_and_notify_registration' => array(
-                'func'       => 'decline_registration',
-                'noheader'   => true,
-                'args'       => array(true),
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'pending_registration' => array(
-                'func'       => 'pending_registration',
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'pending_and_notify_registration' => array(
-                'func'       => 'pending_registration',
-                'noheader'   => true,
-                'args'       => array(true),
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'no_approve_registration' => array(
-                'func'       => 'not_approve_registration',
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'no_approve_and_notify_registration' => array(
-                'func'       => 'not_approve_registration',
-                'noheader'   => true,
-                'args'       => array(true),
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'cancel_registration' => array(
-                'func'       => 'cancel_registration',
-                'noheader'   => true,
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'cancel_and_notify_registration' => array(
-                'func'       => 'cancel_registration',
-                'noheader'   => true,
-                'args'       => array(true),
-                'capability' => 'ee_edit_registration',
-                'obj_id'     => $reg_id,
-            ),
-            'contact_list' => array(
-                'func'       => '_attendee_contact_list_table',
-                'capability' => 'ee_read_contacts',
-            ),
-            'add_new_attendee' => array(
-                'func' => '_create_new_cpt_item',
-                'args' => array(
-                    'new_attendee' => true,
-                    'capability'   => 'ee_edit_contacts',
-                ),
-            ),
-            'edit_attendee' => array(
-                'func'       => '_edit_cpt_item',
-                'capability' => 'ee_edit_contacts',
-                'obj_id'     => $att_id,
-            ),
-            'duplicate_attendee' => array(
-                'func'       => '_duplicate_attendee',
-                'noheader'   => true,
-                'capability' => 'ee_edit_contacts',
-                'obj_id'     => $att_id,
-            ),
-            'insert_attendee' => array(
-                'func'       => '_insert_or_update_attendee',
-                'args'       => array(
-                    'new_attendee' => true,
-                ),
-                'noheader'   => true,
-                'capability' => 'ee_edit_contacts',
-            ),
-            'update_attendee' => array(
-                'func'       => '_insert_or_update_attendee',
-                'args'       => array(
-                    'new_attendee' => false,
-                ),
-                'noheader'   => true,
-                'capability' => 'ee_edit_contacts',
-                'obj_id'     => $att_id,
-            ),
-            'trash_attendees' => array(
-                'func'       => '_trash_or_restore_attendees',
-                'args'       => array(
-                    'trash' => true,
-                ),
-                'noheader'   => true,
-                'capability' => 'ee_delete_contacts',
-                'obj_id'     => $att_id,
-            ),
-            'restore_attendees'    => array(
-                'func'       => '_trash_or_restore_attendees',
-                'args'       => array(
-                    'trash' => false,
-                ),
-                'noheader'   => true,
-                'capability' => 'ee_delete_contacts',
-                'obj_id'     => $att_id,
-            ),
-            'resend_registration'  => array(
-                'func'       => '_resend_registration',
-                'noheader'   => true,
-                'capability' => 'ee_send_message',
-            ),
-            'registrations_report' => array(
-                'func'       => '_registrations_report',
-                'noheader'   => true,
-                'capability' => 'ee_read_registrations',
-            ),
-            'contact_list_export'  => array(
-                'func'       => '_contact_list_export',
-                'noheader'   => true,
-                'capability' => 'export',
-            ),
-            'contact_list_report'  => array(
-                'func'       => '_contact_list_report',
-                'noheader'   => true,
-                'capability' => 'ee_read_contacts',
-            ),
-        );
-    }
-
-
-
-    protected function _set_page_config()
-    {
-        $this->_page_config = array(
-            'default' => array(
-                'nav'           => array(
-                    'label' => __('Overview', 'event_espresso'),
-                    'order' => 5,
-                ),
-                'help_tabs'     => array(
-                    'registrations_overview_help_tab'                       => array(
-                        'title'    => __('Registrations Overview', 'event_espresso'),
-                        'filename' => 'registrations_overview',
-                    ),
-                    'registrations_overview_table_column_headings_help_tab' => array(
-                        'title'    => __('Registrations Table Column Headings', 'event_espresso'),
-                        'filename' => 'registrations_overview_table_column_headings',
-                    ),
-                    'registrations_overview_filters_help_tab'               => array(
-                        'title'    => __('Registration Filters', 'event_espresso'),
-                        'filename' => 'registrations_overview_filters',
-                    ),
-                    'registrations_overview_views_help_tab'                 => array(
-                        'title'    => __('Registration Views', 'event_espresso'),
-                        'filename' => 'registrations_overview_views',
-                    ),
-                    'registrations_regoverview_other_help_tab'              => array(
-                        'title'    => __('Registrations Other', 'event_espresso'),
-                        'filename' => 'registrations_overview_other',
-                    ),
-                ),
-                'help_tour'     => array('Registration_Overview_Help_Tour'),
-                'qtips'         => array('Registration_List_Table_Tips'),
-                'list_table'    => 'EE_Registrations_List_Table',
-                'require_nonce' => false,
-            ),
-            'view_registration' => array(
-                'nav'           => array(
-                    'label'      => __('REG Details', 'event_espresso'),
-                    'order'      => 15,
-                    'url'        => isset($this->_req_data['_REG_ID'])
-                        ? add_query_arg(array('_REG_ID' => $this->_req_data['_REG_ID']), $this->_current_page_view_url)
-                        : $this->_admin_base_url,
-                    'persistent' => false,
-                ),
-                'help_tabs'     => array(
-                    'registrations_details_help_tab'                    => array(
-                        'title'    => __('Registration Details', 'event_espresso'),
-                        'filename' => 'registrations_details',
-                    ),
-                    'registrations_details_table_help_tab'              => array(
-                        'title'    => __('Registration Details Table', 'event_espresso'),
-                        'filename' => 'registrations_details_table',
-                    ),
-                    'registrations_details_form_answers_help_tab'       => array(
-                        'title'    => __('Registration Form Answers', 'event_espresso'),
-                        'filename' => 'registrations_details_form_answers',
-                    ),
-                    'registrations_details_registrant_details_help_tab' => array(
-                        'title'    => __('Contact Details', 'event_espresso'),
-                        'filename' => 'registrations_details_registrant_details',
-                    ),
-                ),
-                'help_tour'     => array('Registration_Details_Help_Tour'),
-                'metaboxes'     => array_merge($this->_default_espresso_metaboxes,
-                    array('_registration_details_metaboxes')),
-                'require_nonce' => false,
-            ),
-            'new_registration' => array(
-                'nav'           => array(
-                    'label'      => __('Add New Registration', 'event_espresso'),
-                    'url'        => '#',
-                    'order'      => 15,
-                    'persistent' => false,
-                ),
-                'metaboxes'     => $this->_default_espresso_metaboxes,
-                'labels'        => array(
-                    'publishbox' => __('Save Registration', 'event_espresso'),
-                ),
-                'require_nonce' => false,
-            ),
-            'add_new_attendee' => array(
-                'nav'           => array(
-                    'label'      => __('Add Contact', 'event_espresso'),
-                    'order'      => 15,
-                    'persistent' => false,
-                ),
-                'metaboxes'     => array_merge($this->_default_espresso_metaboxes,
-                    array('_publish_post_box', 'attendee_editor_metaboxes')),
-                'require_nonce' => false,
-            ),
-            'edit_attendee' => array(
-                'nav'           => array(
-                    'label'      => __('Edit Contact', 'event_espresso'),
-                    'order'      => 15,
-                    'persistent' => false,
-                    'url'        => isset($this->_req_data['ATT_ID'])
-                        ? add_query_arg(array('ATT_ID' => $this->_req_data['ATT_ID']), $this->_current_page_view_url)
-                        : $this->_admin_base_url,
-                ),
-                'metaboxes'     => array('attendee_editor_metaboxes'),
-                'require_nonce' => false,
-            ),
-            'contact_list' => array(
-                'nav'           => array(
-                    'label' => __('Contact List', 'event_espresso'),
-                    'order' => 20,
-                ),
-                'list_table'    => 'EE_Attendee_Contact_List_Table',
-                'help_tabs'     => array(
-                    'registrations_contact_list_help_tab'                       => array(
-                        'title'    => __('Registrations Contact List', 'event_espresso'),
-                        'filename' => 'registrations_contact_list',
-                    ),
-                    'registrations_contact-list_table_column_headings_help_tab' => array(
-                        'title'    => __('Contact List Table Column Headings', 'event_espresso'),
-                        'filename' => 'registrations_contact_list_table_column_headings',
-                    ),
-                    'registrations_contact_list_views_help_tab'                 => array(
-                        'title'    => __('Contact List Views', 'event_espresso'),
-                        'filename' => 'registrations_contact_list_views',
-                    ),
-                    'registrations_contact_list_other_help_tab'                 => array(
-                        'title'    => __('Contact List Other', 'event_espresso'),
-                        'filename' => 'registrations_contact_list_other',
-                    ),
-                ),
-                'help_tour'     => array('Contact_List_Help_Tour'),
-                'metaboxes'     => array(),
-                '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'] = __('click "Update Registration Questions" to save your changes',
-            'event_espresso');
-    }
-
-
-
-    public function admin_notices()
-    {
-    }
-
-
-
-    public function admin_footer_scripts()
-    {
-    }
-
-
-
-    /**
-     *        get list of registration statuses
-     *
-     * @access private
-     * @return void
-     */
-    private function _get_registration_status_array()
-    {
-        self::$_reg_status = EEM_Registration::reg_status_array(array(), true);
-    }
-
-
-
-    protected function _add_screen_options_default()
-    {
-        $this->_per_page_screen_option();
-    }
-
-
-
-    protected function _add_screen_options_contact_list()
-    {
-        $page_title = $this->_admin_page_title;
-        $this->_admin_page_title = __("Contacts", 'event_espresso');
-        $this->_per_page_screen_option();
-        $this->_admin_page_title = $page_title;
-    }
-
-
-
-    public function load_scripts_styles()
-    {
-        //style
-        //wp_register_style('espresso_attendees', ATT_ASSETS_URL . 'espresso_attendees_admin.css', array(), EVENT_ESPRESSO_VERSION );
-        wp_register_style('espresso_reg', REG_ASSETS_URL . 'espresso_registrations_admin.css', array('ee-admin-css'),
-            EVENT_ESPRESSO_VERSION);
-        wp_enqueue_style('espresso_reg');
-        //script
-        wp_register_script('espresso_reg', REG_ASSETS_URL . 'espresso_registrations_admin.js',
-            array('jquery-ui-datepicker', 'jquery-ui-draggable', 'ee_admin_js'), EVENT_ESPRESSO_VERSION, true);
-        wp_enqueue_script('espresso_reg');
-    }
-
-
-
-    public function load_scripts_styles_edit_attendee()
-    {
-        //stuff to only show up on our attendee edit details page.
-        $attendee_details_translations = array(
-            'att_publish_text' => sprintf(__('Created on: <b>%1$s</b>', 'event_espresso'),
-                $this->_cpt_model_obj->get_datetime('ATT_created')),
-        );
-        wp_localize_script('espresso_reg', 'ATTENDEE_DETAILS', $attendee_details_translations);
-        wp_enqueue_script('jquery-validate');
-    }
-
-
-
-    public function load_scripts_styles_view_registration()
-    {
-        //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(true);
-    }
-
-
-
-    public function load_scripts_styles_contact_list()
-    {
-        wp_deregister_style('espresso_reg');
-        wp_register_style('espresso_att', REG_ASSETS_URL . 'espresso_attendees_admin.css', array('ee-admin-css'),
-            EVENT_ESPRESSO_VERSION);
-        wp_enqueue_style('espresso_att');
-    }
-
-
-
-    public function load_scripts_styles_new_registration()
-    {
-        wp_register_script('ee-spco-for-admin', REG_ASSETS_URL . 'spco_for_admin.js', array('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();
-        EE_Datepicker_Input::enqueue_styles_and_scripts();
-    }
-
-
-
-    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');
-    }
-
-
-
-    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 = array(
-            'approve_registration'    => 'registration',
-            'decline_registration'    => 'declined_registration',
-            'pending_registration'    => 'pending_approval',
-            'no_approve_registration' => 'not_approved_registration',
-            'cancel_registration'     => 'cancelled_registration',
-        );
-        /** setup reg status bulk actions **/
-        $def_reg_status_actions['approve_registration'] = __('Approve Registrations', 'event_espresso');
-        if (in_array($match_array['approve_registration'], $active_mts)
-            && EE_Registry::instance()->CAP->current_user_can('ee_send_message', 'batch_send_messages')
-        ) {
-            $def_reg_status_actions['approve_and_notify_registration'] = __('Approve and Notify Registrations',
-                'event_espresso');
-        }
-        $def_reg_status_actions['decline_registration'] = __('Decline Registrations', 'event_espresso');
-        if (in_array($match_array['decline_registration'], $active_mts)
-            && EE_Registry::instance()->CAP->current_user_can('ee_send_message', 'batch_send_messages')
-        ) {
-            $def_reg_status_actions['decline_and_notify_registration'] = __('Decline and Notify Registrations',
-                'event_espresso');
-        }
-        $def_reg_status_actions['pending_registration'] = __('Set Registrations to Pending Payment', 'event_espresso');
-        if (in_array($match_array['pending_registration'], $active_mts)
-            && EE_Registry::instance()->CAP->current_user_can('ee_send_message', 'batch_send_messages')
-        ) {
-            $def_reg_status_actions['pending_and_notify_registration'] = __('Set Registrations to Pending Payment and Notify',
-                'event_espresso');
-        }
-        $def_reg_status_actions['no_approve_registration'] = __('Set Registrations to Not Approved', 'event_espresso');
-        if (in_array($match_array['no_approve_registration'], $active_mts)
-            && EE_Registry::instance()->CAP->current_user_can('ee_send_message', 'batch_send_messages')
-        ) {
-            $def_reg_status_actions['no_approve_and_notify_registration'] = __('Set Registrations to Not Approved and Notify',
-                'event_espresso');
-        }
-        $def_reg_status_actions['cancel_registration'] = __('Cancel Registrations', 'event_espresso');
-        if (in_array($match_array['cancel_registration'], $active_mts)
-            && EE_Registry::instance()->CAP->current_user_can('ee_send_message', 'batch_send_messages')
-        ) {
-            $def_reg_status_actions['cancel_and_notify_registration'] = __('Cancel Registrations and Notify',
-                'event_espresso');
-        }
-        $this->_views = array(
-            'all'   => array(
-                'slug'        => 'all',
-                'label'       => __('View All Registrations', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => array_merge($def_reg_status_actions, array(
-                    'trash_registrations' => __('Trash Registrations', 'event_espresso'),
-                )),
-            ),
-            'month' => array(
-                'slug'        => 'month',
-                'label'       => __('This Month', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => array_merge($def_reg_status_actions, array(
-                    'trash_registrations' => __('Trash Registrations', 'event_espresso'),
-                )),
-            ),
-            'today' => array(
-                'slug'        => 'today',
-                'label'       => sprintf(__('Today - %s', 'event_espresso'), date('M d, Y', current_time('timestamp'))),
-                'count'       => 0,
-                'bulk_action' => array_merge($def_reg_status_actions, array(
-                    'trash_registrations' => __('Trash Registrations', 'event_espresso'),
-                )),
-            ),
-        );
-        if (EE_Registry::instance()->CAP->current_user_can('ee_delete_registrations',
-            'espresso_registrations_delete_registration')
-        ) {
-            $this->_views['incomplete'] = array(
-                'slug'        => 'incomplete',
-                'label'       => __('Incomplete', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => array(
-                    'trash_registrations' => __('Trash Registrations', 'event_espresso'),
-                ),
-            );
-            $this->_views['trash'] = array(
-                'slug'        => 'trash',
-                'label'       => __('Trash', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => array(
-                    'restore_registrations' => __('Restore Registrations', 'event_espresso'),
-                    'delete_registrations'  => __('Delete Registrations Permanently', 'event_espresso'),
-                ),
-            );
-        }
-    }
-
-
-
-    protected function _set_list_table_views_contact_list()
-    {
-        $this->_views = array(
-            'in_use' => array(
-                'slug'        => 'in_use',
-                'label'       => __('In Use', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => array(
-                    'trash_attendees' => __('Move to Trash', 'event_espresso'),
-                ),
-            ),
-        );
-        if (EE_Registry::instance()->CAP->current_user_can('ee_delete_contacts',
-            'espresso_registrations_trash_attendees')
-        ) {
-            $this->_views['trash'] = array(
-                'slug'        => 'trash',
-                'label'       => __('Trash', 'event_espresso'),
-                'count'       => 0,
-                'bulk_action' => array(
-                    'restore_attendees' => __('Restore from Trash', 'event_espresso'),
-                ),
-            );
-        }
-    }
-
-
-
-    protected function _registration_legend_items()
-    {
-        $fc_items = array(
-            'star-icon'        => array(
-                'class' => 'dashicons dashicons-star-filled lt-blue-icon ee-icon-size-8',
-                'desc'  => __('This is the Primary Registrant', 'event_espresso'),
-            ),
-            'view_details'     => array(
-                'class' => 'dashicons dashicons-clipboard',
-                'desc'  => __('View Registration Details', 'event_espresso'),
-            ),
-            'edit_attendee'    => array(
-                'class' => 'ee-icon ee-icon-user-edit ee-icon-size-16',
-                'desc'  => __('Edit Contact Details', 'event_espresso'),
-            ),
-            'view_transaction' => array(
-                'class' => 'dashicons dashicons-cart',
-                'desc'  => __('View Transaction Details', 'event_espresso'),
-            ),
-            'view_invoice'     => array(
-                'class' => 'dashicons dashicons-media-spreadsheet',
-                'desc'  => __('View Transaction Invoice', 'event_espresso'),
-            ),
-        );
-        if (EE_Registry::instance()->CAP->current_user_can('ee_send_message',
-            'espresso_registrations_resend_registration')
-        ) {
-            $fc_items['resend_registration'] = array(
-                'class' => 'dashicons dashicons-email-alt',
-                'desc'  => __('Resend Registration Details', 'event_espresso'),
-            );
-        } else {
-            $fc_items['blank'] = array('class' => 'blank', 'desc' => '');
-        }
-        if (EE_Registry::instance()->CAP->current_user_can('ee_read_global_messages', 'view_filtered_messages')) {
-            $related_for_icon = EEH_MSG_Template::get_message_action_icon('see_notifications_for');
-            if (isset($related_for_icon['css_class']) && isset($related_for_icon['label'])) {
-                $fc_items['view_related_messages'] = array(
-                    'class' => $related_for_icon['css_class'],
-                    'desc'  => $related_for_icon['label'],
-                );
-            }
-        }
-        $sc_items = array(
-            'approved_status'   => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_approved,
-                'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_approved, false, 'sentence'),
-            ),
-            'pending_status'    => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_pending_payment,
-                'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_pending_payment, false, 'sentence'),
-            ),
-            'wait_list'         => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_wait_list,
-                'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_wait_list, false, 'sentence'),
-            ),
-            'incomplete_status' => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_incomplete,
-                'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_incomplete, false, 'sentence'),
-            ),
-            'not_approved'      => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_not_approved,
-                'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_not_approved, false, 'sentence'),
-            ),
-            'declined_status'   => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_declined,
-                'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_declined, false, 'sentence'),
-            ),
-            'cancelled_status'  => array(
-                'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_cancelled,
-                'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_cancelled, false, 'sentence'),
-            ),
-        );
-        return array_merge($fc_items, $sc_items);
-    }
-
-
-
-    /***************************************        REGISTRATION OVERVIEW        **************************************/
-    /**
-     * @throws \EE_Error
-     */
-    protected function _registrations_overview_list_table()
-    {
-        $this->_template_args['admin_page_header'] = '';
-        $EVT_ID = ! empty($this->_req_data['event_id']) ? absint($this->_req_data['event_id']) : 0;
-        if ($EVT_ID) {
-            if (EE_Registry::instance()->CAP->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',
-                        array('event_id' => $EVT_ID), 'add-new-h2');
-            }
-            $event = EEM_Event::instance()->get_one_by_ID($EVT_ID);
-            if ($event instanceof EE_Event) {
-                $this->_template_args['admin_page_header'] = sprintf(__('%s Viewing registrations for the event: %s%s',
-                    'event_espresso'), '<h3 style="line-height:1.5em;">',
-                    '<br /><a href="' . EE_Admin_Page::add_query_args_and_nonce(array(
-                        'action' => 'edit',
-                        'post'   => $event->ID(),
-                    ), EVENTS_ADMIN_URL) . '">&nbsp;' . $event->get('EVT_name') . '&nbsp;</a>&nbsp;', '</h3>');
-            }
-            $DTT_ID = ! empty($this->_req_data['datetime_id']) ? absint($this->_req_data['datetime_id']) : 0;
-            $datetime = EEM_Datetime::instance()->get_one_by_ID($DTT_ID);
-            if ($datetime instanceof EE_Datetime && $this->_template_args['admin_page_header'] !== '') {
-                $this->_template_args['admin_page_header'] = substr($this->_template_args['admin_page_header'], 0, -5);
-                $this->_template_args['admin_page_header'] .= ' &nbsp;<span class="drk-grey-text">';
-                $this->_template_args['admin_page_header'] .= '<span class="dashicons dashicons-calendar"></span>';
-                $this->_template_args['admin_page_header'] .= $datetime->name();
-                $this->_template_args['admin_page_header'] .= ' ( ' . $datetime->start_date() . ' )';
-                $this->_template_args['admin_page_header'] .= '</span></h3>';
-            }
-        }
-        $this->_template_args['after_list_table'] = $this->_display_legend($this->_registration_legend_items());
-        $this->display_admin_list_table_page_with_no_sidebar();
-    }
-
-
-
-    /**
-     * This sets the _registration property for the registration details screen
-     *
-     * @access private
-     * @return bool
-     */
-    private function _set_registration_object()
-    {
-        //get out if we've already set the object
-        if (is_object($this->_registration)) {
-            return true;
-        }
-        $REG = EEM_Registration::instance();
-        $REG_ID = ( ! empty($this->_req_data['_REG_ID'])) ? absint($this->_req_data['_REG_ID']) : false;
-        if ($this->_registration = $REG->get_one_by_ID($REG_ID)) {
-            return true;
-        } else {
-            $error_msg = sprintf(__('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;
-            return false;
-        }
-    }
-
-
-
-    /**
-     * get registrations for given parameters (used by list table)
-     *
-     * @param  int     $per_page   how many registrations displayed per page
-     * @param  boolean $count      return the count or objects
-     * @param  boolean $this_month whether to return for just this month
-     * @param  boolean $today      whether to return results for just today
-     * @throws \EE_Error
-     * @return mixed (int|array)  int = count || array of registration objects
-     */
-    public function get_registrations($per_page = 10, $count = false, $this_month = false, $today = false)
-    {
-        $EVT_ID = ! empty($this->_req_data['event_id']) && $this->_req_data['event_id'] > 0
-            ? absint($this->_req_data['event_id']) : false;
-        $CAT_ID = ! empty($this->_req_data['EVT_CAT']) && (int)$this->_req_data['EVT_CAT'] > 0
-            ? absint($this->_req_data['EVT_CAT']) : false;
-        $DTT_ID = isset($this->_req_data['datetime_id']) ? absint($this->_req_data['datetime_id']) : null;
-        $reg_status = ! empty($this->_req_data['_reg_status']) ? sanitize_text_field($this->_req_data['_reg_status'])
-            : false;
-        $month_range = ! empty($this->_req_data['month_range']) ? sanitize_text_field($this->_req_data['month_range'])
-            : false;//should be like 2013-april
-        $today_a = ! empty($this->_req_data['status']) && $this->_req_data['status'] === 'today' ? true : false;
-        $this_month_a = ! empty($this->_req_data['status']) && $this->_req_data['status'] === 'month' ? true : false;
-        $start_date = false;
-        $end_date = false;
-        $_where = array();
-        $trash = ! empty($this->_req_data['status']) && $this->_req_data['status'] === 'trash' ? true : false;
-        $incomplete = ! empty($this->_req_data['status']) && $this->_req_data['status'] === 'incomplete' ? true : false;
-        //set orderby
-        $this->_req_data['orderby'] = ! empty($this->_req_data['orderby']) ? $this->_req_data['orderby'] : '';
-        switch ($this->_req_data['orderby']) {
-            case '_REG_ID':
-                $orderby = 'REG_ID';
-                break;
-            case '_Reg_status':
-                $orderby = 'STS_ID';
-                break;
-            case 'ATT_fname':
-                $orderby = 'Attendee.ATT_lname';
-                break;
-            case 'event_name':
-                $orderby = 'Event.EVT_name';
-                break;
-            case 'DTT_EVT_start':
-                $orderby = 'Event.Datetime.DTT_EVT_start';
-                break;
-            default: //'REG_date'
-                $orderby = 'REG_date';
-        }
-        $sort = (isset($this->_req_data['order']) && ! empty($this->_req_data['order'])) ? $this->_req_data['order']
-            : 'DESC';
-        $current_page = isset($this->_req_data['paged']) && ! empty($this->_req_data['paged'])
-            ? $this->_req_data['paged'] : 1;
-        $per_page = isset($this->_req_data['perpage']) && ! empty($this->_req_data['perpage'])
-            ? $this->_req_data['perpage'] : $per_page;
-        $offset = ($current_page - 1) * $per_page;
-        $limit = $count ? null : array($offset, $per_page);
-        if ($EVT_ID) {
-            $_where['EVT_ID'] = $EVT_ID;
-        }
-        if ($CAT_ID) {
-            $_where['Event.Term_Taxonomy.term_id'] = $CAT_ID;
-        }
-        //if DTT is included we filter by that datetime.
-        if ($DTT_ID) {
-            $_where['Ticket.Datetime.DTT_ID'] = $DTT_ID;
-        }
-        if ($incomplete) {
-            $_where['STS_ID'] = EEM_Registration::status_id_incomplete;
-        } else if ( ! $trash) {
-            $_where['STS_ID'] = array('!=', EEM_Registration::status_id_incomplete);
-        }
-        if ($reg_status) {
-            $_where['STS_ID'] = $reg_status;
-        }
-        $this_year_r = date('Y', current_time('timestamp'));
-        $time_start = ' 00:00:00';
-        $time_end = ' 23:59:59';
-        if ($today_a || $today) {
-            $curdate = date('Y-m-d', current_time('timestamp'));
-            $_where['REG_date'] = array(
-                'BETWEEN',
-                array(
-                    EEM_Registration::instance()
-                                    ->convert_datetime_for_query('REG_date', $curdate . $time_start, 'Y-m-d H:i:s'),
-                    EEM_Registration::instance()
-                                    ->convert_datetime_for_query('REG_date', $curdate . $time_end, 'Y-m-d H:i:s'),
-                ),
-            );
-        } elseif ($this_month_a || $this_month) {
-            $this_month_r = date('m', current_time('timestamp'));
-            $days_this_month = date('t', current_time('timestamp'));
-            $_where['REG_date'] = array(
-                'BETWEEN',
-                array(
-                    EEM_Registration::instance()
-                                    ->convert_datetime_for_query('REG_date',
-                                        $this_year_r . '-' . $this_month_r . '-01' . ' ' . $time_start, 'Y-m-d H:i:s'),
-                    EEM_Registration::instance()
-                                    ->convert_datetime_for_query('REG_date',
-                                        $this_year_r . '-' . $this_month_r . '-' . $days_this_month . ' ' . $time_end,
-                                        'Y-m-d H:i:s'),
-                ),
-            );
-        } elseif ($month_range) {
-            $pieces = explode(' ', $this->_req_data['month_range'], 3);
-            $month_r = ! empty($pieces[0]) ? date('m', strtotime($month_range)) : '';
-            $year_r = ! empty($pieces[1]) ? $pieces[1] : '';
-            $days_in_month = date('t', strtotime($year_r . '-' . $month_r . '-' . '01'));
-            $_where['REG_date'] = array(
-                'BETWEEN',
-                array(
-                    EEM_Registration::instance()
-                                    ->convert_datetime_for_query('REG_date', $year_r . '-' . $month_r . '-01 00:00:00',
-                                        'Y-m-d H:i:s'),
-                    EEM_Registration::instance()
-                                    ->convert_datetime_for_query('REG_date',
-                                        $year_r . '-' . $month_r . '-' . $days_in_month . ' 23:59:59', 'Y-m-d H:i:s'),
-                ),
-            );
-        } elseif ($start_date && $end_date) {
-            throw new EE_Error("not yet supported");
-        } elseif ($start_date) {
-            throw new EE_Error("not yet supported");
-        } elseif ($end_date) {
-            throw new EE_Error("not yet supported");
-        }
-        if ( ! empty($this->_req_data['s'])) {
-            $sstr = '%' . $this->_req_data['s'] . '%';
-            $_where['OR'] = array(
-                'Event.EVT_name'                          => array('LIKE', $sstr),
-                'Event.EVT_desc'                          => array('LIKE', $sstr),
-                'Event.EVT_short_desc'                    => array('LIKE', $sstr),
-                'Attendee.ATT_full_name'                  => array('LIKE', $sstr),
-                'Attendee.ATT_fname'                      => array('LIKE', $sstr),
-                'Attendee.ATT_lname'                      => array('LIKE', $sstr),
-                'Attendee.ATT_short_bio'                  => array('LIKE', $sstr),
-                'Attendee.ATT_email'                      => array('LIKE', $sstr),
-                'Attendee.ATT_address'                    => array('LIKE', $sstr),
-                'Attendee.ATT_address2'                   => array('LIKE', $sstr),
-                'Attendee.ATT_city'                       => array('LIKE', $sstr),
-                'REG_final_price'                         => array('LIKE', $sstr),
-                'REG_code'                                => array('LIKE', $sstr),
-                'REG_count'                               => array('LIKE', $sstr),
-                'REG_group_size'                          => array('LIKE', $sstr),
-                'Ticket.TKT_name'                         => array('LIKE', $sstr),
-                'Ticket.TKT_description'                  => array('LIKE', $sstr),
-                'Transaction.Payment.PAY_txn_id_chq_nmbr' => array('LIKE', $sstr),
-            );
-        }
-        //capability checks
-        if ( ! EE_Registry::instance()->CAP->current_user_can('ee_read_others_registrations', 'get_registrations')) {
-            $_where['AND'] = array(
-                'Event.EVT_wp_user' => get_current_user_id(),
-            );
-        }
-        if ($count) {
-            if ($trash) {
-                return EEM_Registration::instance()->count_deleted(array($_where));
-            } else if ($incomplete) {
-                return EEM_Registration::instance()->count(array($_where));
-            } else {
-                return EEM_Registration::instance()->count(array(
-                    $_where,
-                    'default_where_conditions' => 'this_model_only',
-                ));
-            }
-        } else {
-            //make sure we remove default where conditions cause all registrations matching query are returned
-            $query_params = array(
-                $_where,
-                'order_by'                 => array($orderby => $sort),
-                'default_where_conditions' => 'this_model_only',
-            );
-            if ($per_page !== -1) {
-                $query_params['limit'] = $limit;
-            }
-            $registrations = $trash ? EEM_Registration::instance()->get_all_deleted($query_params)
-                : EEM_Registration::instance()->get_all($query_params);
-            if ($EVT_ID
-                && isset($registrations[0])
-                && $registrations[0] instanceof EE_Registration
-                && $registrations[0]->event_obj()
-            ) {
-                $first_registration = $registrations[0];
-                //EEH_Debug_Tools::printr( $registrations[0], '$registrations  <br /><span style="font-size:10px;font-weight:normal;">' . __FILE__ . '<br />line no: ' . __LINE__ . '</span>', 'auto' );
-                $event_name = $first_registration->event_obj()->name();
-                $event_date = $first_registration->date_obj()
-                                                 ->start_date_and_time('l F j, Y,',
-                                                     'g:i:s a');// isset( $registrations[0]->DTT_EVT_start ) ? date( 'l F j, Y,    g:i:s a', $registrations[0]->DTT_EVT_start ) : '';
-                // edit event link
-                if ($event_name != '') {
-                    $edit_event_url = self::add_query_args_and_nonce(array(
-                        'action' => 'edit_event',
-                        'EVT_ID' => $EVT_ID,
-                    ), EVENTS_ADMIN_URL);
-                    $edit_event_lnk = '<a href="' . $edit_event_url . '" title="' . esc_attr__('Edit ',
-                            'event_espresso') . $event_name . '">' . __('Edit Event', 'event_espresso') . '</a>';
-                    $event_name .= ' <span class="admin-page-header-edit-lnk not-bold">' . $edit_event_lnk . '</span>';
-                }
-                $back_2_reg_url = self::add_query_args_and_nonce(array('action' => 'default'), REG_ADMIN_URL);
-                $back_2_reg_lnk = '<a href="'
-                                  . $back_2_reg_url
-                                  . '" title="'
-                                  . esc_attr__('click to return to viewing all registrations ', 'event_espresso')
-                                  . '">&laquo; '
-                                  . __('Back to All Registrations', 'event_espresso')
-                                  . '</a>';
-                $this->_template_args['before_admin_page_content'] = '
+	/**
+	 * @var EE_Registration
+	 */
+	private $_registration;
+
+	/**
+	 * @var EE_Event
+	 */
+	private $_reg_event;
+
+	/**
+	 * @var EE_Session
+	 */
+	private        $_session;
+
+	private static $_reg_status;
+
+	/**
+	 * Form for displaying the custom questions for this registration.
+	 * This gets used a few times throughout the request so its best to cache it
+	 *
+	 * @var EE_Registration_Custom_Questions_Form
+	 */
+	protected $_reg_custom_questions_form = null;
+
+
+
+	/**
+	 *        constructor
+	 *
+	 * @Constructor
+	 * @access public
+	 * @param bool $routing
+	 * @return Registrations_Admin_Page
+	 */
+	public function __construct($routing = true)
+	{
+		parent::__construct($routing);
+		add_action('wp_loaded', array($this, 'wp_loaded'));
+	}
+
+
+
+	public function wp_loaded()
+	{
+		// when adding a new registration...
+		if (isset($this->_req_data['action']) && $this->_req_data['action'] === 'new_registration') {
+			EE_System::do_not_cache();
+			if ( ! isset($this->_req_data['processing_registration'])
+				 || absint($this->_req_data['processing_registration']) !== 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 = __('Registrations', 'event_espresso');
+		$this->_cpt_routes = array(
+			'add_new_attendee' => 'espresso_attendees',
+			'edit_attendee'    => 'espresso_attendees',
+			'insert_attendee'  => 'espresso_attendees',
+			'update_attendee'  => 'espresso_attendees',
+		);
+		$this->_cpt_model_names = array(
+			'add_new_attendee' => 'EEM_Attendee',
+			'edit_attendee'    => 'EEM_Attendee',
+		);
+		$this->_cpt_edit_routes = array(
+			'espresso_attendees' => 'edit_attendee',
+		);
+		$this->_pagenow_map = array(
+			'add_new_attendee' => 'post-new.php',
+			'edit_attendee'    => 'post.php',
+			'trash'            => 'post.php',
+		);
+		add_action('edit_form_after_title', array($this, 'after_title_form_fields'), 10);
+		//add filters so that the comment urls don't take users to a confusing 404 page
+		add_filter('get_comment_link', array($this, 'clear_comment_link'), 10, 3);
+	}
+
+
+
+	public function clear_comment_link($link, $comment, $args)
+	{
+		//gotta make sure this only happens on this route
+		$post_type = get_post_type($comment->comment_post_ID);
+		if ($post_type === 'espresso_attendees') {
+			return '#commentsdiv';
+		}
+		return $link;
+	}
+
+
+
+	protected function _ajax_hooks()
+	{
+		//todo: all hooks for registrations ajax goes in here
+		add_action('wp_ajax_toggle_checkin_status', array($this, 'toggle_checkin_status'));
+	}
+
+
+
+	protected function _define_page_props()
+	{
+		$this->_admin_page_title = $this->page_label;
+		$this->_labels = array(
+			'buttons'                      => array(
+				'add-registrant'      => __('Add New Registration', 'event_espresso'),
+				'add-attendee'        => __('Add Contact', 'event_espresso'),
+				'edit'                => __('Edit Contact', 'event_espresso'),
+				'report'              => __("Event Registrations CSV Report", "event_espresso"),
+				'report_all'          => __('All Registrations CSV Report', 'event_espresso'),
+				'contact_list_report' => __('Contact List Report', 'event_espresso'),
+				'contact_list_export' => __("Export Data", "event_espresso"),
+			),
+			'publishbox'                   => array(
+				'add_new_attendee' => __("Add Contact Record", 'event_espresso'),
+				'edit_attendee'    => __("Update Contact Record", 'event_espresso'),
+			),
+			'hide_add_button_on_cpt_route' => array(
+				'edit_attendee' => true,
+			),
+		);
+	}
+
+
+
+	/**
+	 *        grab url requests and route them
+	 *
+	 * @access private
+	 * @return void
+	 */
+	public function _set_page_routes()
+	{
+		$this->_get_registration_status_array();
+		$reg_id = ! empty($this->_req_data['_REG_ID']) && ! is_array($this->_req_data['_REG_ID'])
+			? $this->_req_data['_REG_ID'] : 0;
+		$att_id = ! empty($this->_req_data['ATT_ID']) && ! is_array($this->_req_data['ATT_ID'])
+			? $this->_req_data['ATT_ID'] : 0;
+		$att_id = ! empty($this->_req_data['post']) && ! is_array($this->_req_data['post']) ? $this->_req_data['post']
+			: $att_id;
+		$this->_page_routes = array(
+			'default' => array(
+				'func'       => '_registrations_overview_list_table',
+				'capability' => 'ee_read_registrations',
+			),
+			'view_registration' => array(
+				'func'       => '_registration_details',
+				'capability' => 'ee_read_registration',
+				'obj_id'     => $reg_id,
+			),
+			'edit_registration' => array(
+				'func'               => '_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' => array(
+				'func'       => '_trash_or_restore_registrations',
+				'args'       => array('trash' => true),
+				'noheader'   => true,
+				'capability' => 'ee_delete_registrations',
+			),
+			'restore_registrations' => array(
+				'func'       => '_trash_or_restore_registrations',
+				'args'       => array('trash' => false),
+				'noheader'   => true,
+				'capability' => 'ee_delete_registrations',
+			),
+			'delete_registrations' => array(
+				'func'       => '_delete_registrations',
+				'noheader'   => true,
+				'capability' => 'ee_delete_registrations',
+			),
+			'new_registration' => array(
+				'func'       => 'new_registration',
+				'capability' => 'ee_edit_registrations',
+			),
+			'process_reg_step' => array(
+				'func'       => 'process_reg_step',
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+			),
+			'redirect_to_txn' => array(
+				'func'       => 'redirect_to_txn',
+				'noheader'   => true,
+				'capability' => 'ee_edit_registrations',
+			),
+			'change_reg_status' => array(
+				'func'       => '_change_reg_status',
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $reg_id,
+			),
+			'approve_registration' => array(
+				'func'       => 'approve_registration',
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $reg_id,
+			),
+			'approve_and_notify_registration' => array(
+				'func'       => 'approve_registration',
+				'noheader'   => true,
+				'args'       => array(true),
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $reg_id,
+			),
+			'decline_registration' => array(
+				'func'       => 'decline_registration',
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $reg_id,
+			),
+			'decline_and_notify_registration' => array(
+				'func'       => 'decline_registration',
+				'noheader'   => true,
+				'args'       => array(true),
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $reg_id,
+			),
+			'pending_registration' => array(
+				'func'       => 'pending_registration',
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $reg_id,
+			),
+			'pending_and_notify_registration' => array(
+				'func'       => 'pending_registration',
+				'noheader'   => true,
+				'args'       => array(true),
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $reg_id,
+			),
+			'no_approve_registration' => array(
+				'func'       => 'not_approve_registration',
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $reg_id,
+			),
+			'no_approve_and_notify_registration' => array(
+				'func'       => 'not_approve_registration',
+				'noheader'   => true,
+				'args'       => array(true),
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $reg_id,
+			),
+			'cancel_registration' => array(
+				'func'       => 'cancel_registration',
+				'noheader'   => true,
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $reg_id,
+			),
+			'cancel_and_notify_registration' => array(
+				'func'       => 'cancel_registration',
+				'noheader'   => true,
+				'args'       => array(true),
+				'capability' => 'ee_edit_registration',
+				'obj_id'     => $reg_id,
+			),
+			'contact_list' => array(
+				'func'       => '_attendee_contact_list_table',
+				'capability' => 'ee_read_contacts',
+			),
+			'add_new_attendee' => array(
+				'func' => '_create_new_cpt_item',
+				'args' => array(
+					'new_attendee' => true,
+					'capability'   => 'ee_edit_contacts',
+				),
+			),
+			'edit_attendee' => array(
+				'func'       => '_edit_cpt_item',
+				'capability' => 'ee_edit_contacts',
+				'obj_id'     => $att_id,
+			),
+			'duplicate_attendee' => array(
+				'func'       => '_duplicate_attendee',
+				'noheader'   => true,
+				'capability' => 'ee_edit_contacts',
+				'obj_id'     => $att_id,
+			),
+			'insert_attendee' => array(
+				'func'       => '_insert_or_update_attendee',
+				'args'       => array(
+					'new_attendee' => true,
+				),
+				'noheader'   => true,
+				'capability' => 'ee_edit_contacts',
+			),
+			'update_attendee' => array(
+				'func'       => '_insert_or_update_attendee',
+				'args'       => array(
+					'new_attendee' => false,
+				),
+				'noheader'   => true,
+				'capability' => 'ee_edit_contacts',
+				'obj_id'     => $att_id,
+			),
+			'trash_attendees' => array(
+				'func'       => '_trash_or_restore_attendees',
+				'args'       => array(
+					'trash' => true,
+				),
+				'noheader'   => true,
+				'capability' => 'ee_delete_contacts',
+				'obj_id'     => $att_id,
+			),
+			'restore_attendees'    => array(
+				'func'       => '_trash_or_restore_attendees',
+				'args'       => array(
+					'trash' => false,
+				),
+				'noheader'   => true,
+				'capability' => 'ee_delete_contacts',
+				'obj_id'     => $att_id,
+			),
+			'resend_registration'  => array(
+				'func'       => '_resend_registration',
+				'noheader'   => true,
+				'capability' => 'ee_send_message',
+			),
+			'registrations_report' => array(
+				'func'       => '_registrations_report',
+				'noheader'   => true,
+				'capability' => 'ee_read_registrations',
+			),
+			'contact_list_export'  => array(
+				'func'       => '_contact_list_export',
+				'noheader'   => true,
+				'capability' => 'export',
+			),
+			'contact_list_report'  => array(
+				'func'       => '_contact_list_report',
+				'noheader'   => true,
+				'capability' => 'ee_read_contacts',
+			),
+		);
+	}
+
+
+
+	protected function _set_page_config()
+	{
+		$this->_page_config = array(
+			'default' => array(
+				'nav'           => array(
+					'label' => __('Overview', 'event_espresso'),
+					'order' => 5,
+				),
+				'help_tabs'     => array(
+					'registrations_overview_help_tab'                       => array(
+						'title'    => __('Registrations Overview', 'event_espresso'),
+						'filename' => 'registrations_overview',
+					),
+					'registrations_overview_table_column_headings_help_tab' => array(
+						'title'    => __('Registrations Table Column Headings', 'event_espresso'),
+						'filename' => 'registrations_overview_table_column_headings',
+					),
+					'registrations_overview_filters_help_tab'               => array(
+						'title'    => __('Registration Filters', 'event_espresso'),
+						'filename' => 'registrations_overview_filters',
+					),
+					'registrations_overview_views_help_tab'                 => array(
+						'title'    => __('Registration Views', 'event_espresso'),
+						'filename' => 'registrations_overview_views',
+					),
+					'registrations_regoverview_other_help_tab'              => array(
+						'title'    => __('Registrations Other', 'event_espresso'),
+						'filename' => 'registrations_overview_other',
+					),
+				),
+				'help_tour'     => array('Registration_Overview_Help_Tour'),
+				'qtips'         => array('Registration_List_Table_Tips'),
+				'list_table'    => 'EE_Registrations_List_Table',
+				'require_nonce' => false,
+			),
+			'view_registration' => array(
+				'nav'           => array(
+					'label'      => __('REG Details', 'event_espresso'),
+					'order'      => 15,
+					'url'        => isset($this->_req_data['_REG_ID'])
+						? add_query_arg(array('_REG_ID' => $this->_req_data['_REG_ID']), $this->_current_page_view_url)
+						: $this->_admin_base_url,
+					'persistent' => false,
+				),
+				'help_tabs'     => array(
+					'registrations_details_help_tab'                    => array(
+						'title'    => __('Registration Details', 'event_espresso'),
+						'filename' => 'registrations_details',
+					),
+					'registrations_details_table_help_tab'              => array(
+						'title'    => __('Registration Details Table', 'event_espresso'),
+						'filename' => 'registrations_details_table',
+					),
+					'registrations_details_form_answers_help_tab'       => array(
+						'title'    => __('Registration Form Answers', 'event_espresso'),
+						'filename' => 'registrations_details_form_answers',
+					),
+					'registrations_details_registrant_details_help_tab' => array(
+						'title'    => __('Contact Details', 'event_espresso'),
+						'filename' => 'registrations_details_registrant_details',
+					),
+				),
+				'help_tour'     => array('Registration_Details_Help_Tour'),
+				'metaboxes'     => array_merge($this->_default_espresso_metaboxes,
+					array('_registration_details_metaboxes')),
+				'require_nonce' => false,
+			),
+			'new_registration' => array(
+				'nav'           => array(
+					'label'      => __('Add New Registration', 'event_espresso'),
+					'url'        => '#',
+					'order'      => 15,
+					'persistent' => false,
+				),
+				'metaboxes'     => $this->_default_espresso_metaboxes,
+				'labels'        => array(
+					'publishbox' => __('Save Registration', 'event_espresso'),
+				),
+				'require_nonce' => false,
+			),
+			'add_new_attendee' => array(
+				'nav'           => array(
+					'label'      => __('Add Contact', 'event_espresso'),
+					'order'      => 15,
+					'persistent' => false,
+				),
+				'metaboxes'     => array_merge($this->_default_espresso_metaboxes,
+					array('_publish_post_box', 'attendee_editor_metaboxes')),
+				'require_nonce' => false,
+			),
+			'edit_attendee' => array(
+				'nav'           => array(
+					'label'      => __('Edit Contact', 'event_espresso'),
+					'order'      => 15,
+					'persistent' => false,
+					'url'        => isset($this->_req_data['ATT_ID'])
+						? add_query_arg(array('ATT_ID' => $this->_req_data['ATT_ID']), $this->_current_page_view_url)
+						: $this->_admin_base_url,
+				),
+				'metaboxes'     => array('attendee_editor_metaboxes'),
+				'require_nonce' => false,
+			),
+			'contact_list' => array(
+				'nav'           => array(
+					'label' => __('Contact List', 'event_espresso'),
+					'order' => 20,
+				),
+				'list_table'    => 'EE_Attendee_Contact_List_Table',
+				'help_tabs'     => array(
+					'registrations_contact_list_help_tab'                       => array(
+						'title'    => __('Registrations Contact List', 'event_espresso'),
+						'filename' => 'registrations_contact_list',
+					),
+					'registrations_contact-list_table_column_headings_help_tab' => array(
+						'title'    => __('Contact List Table Column Headings', 'event_espresso'),
+						'filename' => 'registrations_contact_list_table_column_headings',
+					),
+					'registrations_contact_list_views_help_tab'                 => array(
+						'title'    => __('Contact List Views', 'event_espresso'),
+						'filename' => 'registrations_contact_list_views',
+					),
+					'registrations_contact_list_other_help_tab'                 => array(
+						'title'    => __('Contact List Other', 'event_espresso'),
+						'filename' => 'registrations_contact_list_other',
+					),
+				),
+				'help_tour'     => array('Contact_List_Help_Tour'),
+				'metaboxes'     => array(),
+				'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'] = __('click "Update Registration Questions" to save your changes',
+			'event_espresso');
+	}
+
+
+
+	public function admin_notices()
+	{
+	}
+
+
+
+	public function admin_footer_scripts()
+	{
+	}
+
+
+
+	/**
+	 *        get list of registration statuses
+	 *
+	 * @access private
+	 * @return void
+	 */
+	private function _get_registration_status_array()
+	{
+		self::$_reg_status = EEM_Registration::reg_status_array(array(), true);
+	}
+
+
+
+	protected function _add_screen_options_default()
+	{
+		$this->_per_page_screen_option();
+	}
+
+
+
+	protected function _add_screen_options_contact_list()
+	{
+		$page_title = $this->_admin_page_title;
+		$this->_admin_page_title = __("Contacts", 'event_espresso');
+		$this->_per_page_screen_option();
+		$this->_admin_page_title = $page_title;
+	}
+
+
+
+	public function load_scripts_styles()
+	{
+		//style
+		//wp_register_style('espresso_attendees', ATT_ASSETS_URL . 'espresso_attendees_admin.css', array(), EVENT_ESPRESSO_VERSION );
+		wp_register_style('espresso_reg', REG_ASSETS_URL . 'espresso_registrations_admin.css', array('ee-admin-css'),
+			EVENT_ESPRESSO_VERSION);
+		wp_enqueue_style('espresso_reg');
+		//script
+		wp_register_script('espresso_reg', REG_ASSETS_URL . 'espresso_registrations_admin.js',
+			array('jquery-ui-datepicker', 'jquery-ui-draggable', 'ee_admin_js'), EVENT_ESPRESSO_VERSION, true);
+		wp_enqueue_script('espresso_reg');
+	}
+
+
+
+	public function load_scripts_styles_edit_attendee()
+	{
+		//stuff to only show up on our attendee edit details page.
+		$attendee_details_translations = array(
+			'att_publish_text' => sprintf(__('Created on: <b>%1$s</b>', 'event_espresso'),
+				$this->_cpt_model_obj->get_datetime('ATT_created')),
+		);
+		wp_localize_script('espresso_reg', 'ATTENDEE_DETAILS', $attendee_details_translations);
+		wp_enqueue_script('jquery-validate');
+	}
+
+
+
+	public function load_scripts_styles_view_registration()
+	{
+		//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(true);
+	}
+
+
+
+	public function load_scripts_styles_contact_list()
+	{
+		wp_deregister_style('espresso_reg');
+		wp_register_style('espresso_att', REG_ASSETS_URL . 'espresso_attendees_admin.css', array('ee-admin-css'),
+			EVENT_ESPRESSO_VERSION);
+		wp_enqueue_style('espresso_att');
+	}
+
+
+
+	public function load_scripts_styles_new_registration()
+	{
+		wp_register_script('ee-spco-for-admin', REG_ASSETS_URL . 'spco_for_admin.js', array('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();
+		EE_Datepicker_Input::enqueue_styles_and_scripts();
+	}
+
+
+
+	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');
+	}
+
+
+
+	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 = array(
+			'approve_registration'    => 'registration',
+			'decline_registration'    => 'declined_registration',
+			'pending_registration'    => 'pending_approval',
+			'no_approve_registration' => 'not_approved_registration',
+			'cancel_registration'     => 'cancelled_registration',
+		);
+		/** setup reg status bulk actions **/
+		$def_reg_status_actions['approve_registration'] = __('Approve Registrations', 'event_espresso');
+		if (in_array($match_array['approve_registration'], $active_mts)
+			&& EE_Registry::instance()->CAP->current_user_can('ee_send_message', 'batch_send_messages')
+		) {
+			$def_reg_status_actions['approve_and_notify_registration'] = __('Approve and Notify Registrations',
+				'event_espresso');
+		}
+		$def_reg_status_actions['decline_registration'] = __('Decline Registrations', 'event_espresso');
+		if (in_array($match_array['decline_registration'], $active_mts)
+			&& EE_Registry::instance()->CAP->current_user_can('ee_send_message', 'batch_send_messages')
+		) {
+			$def_reg_status_actions['decline_and_notify_registration'] = __('Decline and Notify Registrations',
+				'event_espresso');
+		}
+		$def_reg_status_actions['pending_registration'] = __('Set Registrations to Pending Payment', 'event_espresso');
+		if (in_array($match_array['pending_registration'], $active_mts)
+			&& EE_Registry::instance()->CAP->current_user_can('ee_send_message', 'batch_send_messages')
+		) {
+			$def_reg_status_actions['pending_and_notify_registration'] = __('Set Registrations to Pending Payment and Notify',
+				'event_espresso');
+		}
+		$def_reg_status_actions['no_approve_registration'] = __('Set Registrations to Not Approved', 'event_espresso');
+		if (in_array($match_array['no_approve_registration'], $active_mts)
+			&& EE_Registry::instance()->CAP->current_user_can('ee_send_message', 'batch_send_messages')
+		) {
+			$def_reg_status_actions['no_approve_and_notify_registration'] = __('Set Registrations to Not Approved and Notify',
+				'event_espresso');
+		}
+		$def_reg_status_actions['cancel_registration'] = __('Cancel Registrations', 'event_espresso');
+		if (in_array($match_array['cancel_registration'], $active_mts)
+			&& EE_Registry::instance()->CAP->current_user_can('ee_send_message', 'batch_send_messages')
+		) {
+			$def_reg_status_actions['cancel_and_notify_registration'] = __('Cancel Registrations and Notify',
+				'event_espresso');
+		}
+		$this->_views = array(
+			'all'   => array(
+				'slug'        => 'all',
+				'label'       => __('View All Registrations', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => array_merge($def_reg_status_actions, array(
+					'trash_registrations' => __('Trash Registrations', 'event_espresso'),
+				)),
+			),
+			'month' => array(
+				'slug'        => 'month',
+				'label'       => __('This Month', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => array_merge($def_reg_status_actions, array(
+					'trash_registrations' => __('Trash Registrations', 'event_espresso'),
+				)),
+			),
+			'today' => array(
+				'slug'        => 'today',
+				'label'       => sprintf(__('Today - %s', 'event_espresso'), date('M d, Y', current_time('timestamp'))),
+				'count'       => 0,
+				'bulk_action' => array_merge($def_reg_status_actions, array(
+					'trash_registrations' => __('Trash Registrations', 'event_espresso'),
+				)),
+			),
+		);
+		if (EE_Registry::instance()->CAP->current_user_can('ee_delete_registrations',
+			'espresso_registrations_delete_registration')
+		) {
+			$this->_views['incomplete'] = array(
+				'slug'        => 'incomplete',
+				'label'       => __('Incomplete', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => array(
+					'trash_registrations' => __('Trash Registrations', 'event_espresso'),
+				),
+			);
+			$this->_views['trash'] = array(
+				'slug'        => 'trash',
+				'label'       => __('Trash', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => array(
+					'restore_registrations' => __('Restore Registrations', 'event_espresso'),
+					'delete_registrations'  => __('Delete Registrations Permanently', 'event_espresso'),
+				),
+			);
+		}
+	}
+
+
+
+	protected function _set_list_table_views_contact_list()
+	{
+		$this->_views = array(
+			'in_use' => array(
+				'slug'        => 'in_use',
+				'label'       => __('In Use', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => array(
+					'trash_attendees' => __('Move to Trash', 'event_espresso'),
+				),
+			),
+		);
+		if (EE_Registry::instance()->CAP->current_user_can('ee_delete_contacts',
+			'espresso_registrations_trash_attendees')
+		) {
+			$this->_views['trash'] = array(
+				'slug'        => 'trash',
+				'label'       => __('Trash', 'event_espresso'),
+				'count'       => 0,
+				'bulk_action' => array(
+					'restore_attendees' => __('Restore from Trash', 'event_espresso'),
+				),
+			);
+		}
+	}
+
+
+
+	protected function _registration_legend_items()
+	{
+		$fc_items = array(
+			'star-icon'        => array(
+				'class' => 'dashicons dashicons-star-filled lt-blue-icon ee-icon-size-8',
+				'desc'  => __('This is the Primary Registrant', 'event_espresso'),
+			),
+			'view_details'     => array(
+				'class' => 'dashicons dashicons-clipboard',
+				'desc'  => __('View Registration Details', 'event_espresso'),
+			),
+			'edit_attendee'    => array(
+				'class' => 'ee-icon ee-icon-user-edit ee-icon-size-16',
+				'desc'  => __('Edit Contact Details', 'event_espresso'),
+			),
+			'view_transaction' => array(
+				'class' => 'dashicons dashicons-cart',
+				'desc'  => __('View Transaction Details', 'event_espresso'),
+			),
+			'view_invoice'     => array(
+				'class' => 'dashicons dashicons-media-spreadsheet',
+				'desc'  => __('View Transaction Invoice', 'event_espresso'),
+			),
+		);
+		if (EE_Registry::instance()->CAP->current_user_can('ee_send_message',
+			'espresso_registrations_resend_registration')
+		) {
+			$fc_items['resend_registration'] = array(
+				'class' => 'dashicons dashicons-email-alt',
+				'desc'  => __('Resend Registration Details', 'event_espresso'),
+			);
+		} else {
+			$fc_items['blank'] = array('class' => 'blank', 'desc' => '');
+		}
+		if (EE_Registry::instance()->CAP->current_user_can('ee_read_global_messages', 'view_filtered_messages')) {
+			$related_for_icon = EEH_MSG_Template::get_message_action_icon('see_notifications_for');
+			if (isset($related_for_icon['css_class']) && isset($related_for_icon['label'])) {
+				$fc_items['view_related_messages'] = array(
+					'class' => $related_for_icon['css_class'],
+					'desc'  => $related_for_icon['label'],
+				);
+			}
+		}
+		$sc_items = array(
+			'approved_status'   => array(
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_approved,
+				'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_approved, false, 'sentence'),
+			),
+			'pending_status'    => array(
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_pending_payment,
+				'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_pending_payment, false, 'sentence'),
+			),
+			'wait_list'         => array(
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_wait_list,
+				'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_wait_list, false, 'sentence'),
+			),
+			'incomplete_status' => array(
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_incomplete,
+				'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_incomplete, false, 'sentence'),
+			),
+			'not_approved'      => array(
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_not_approved,
+				'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_not_approved, false, 'sentence'),
+			),
+			'declined_status'   => array(
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_declined,
+				'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_declined, false, 'sentence'),
+			),
+			'cancelled_status'  => array(
+				'class' => 'ee-status-legend ee-status-legend-' . EEM_Registration::status_id_cancelled,
+				'desc'  => EEH_Template::pretty_status(EEM_Registration::status_id_cancelled, false, 'sentence'),
+			),
+		);
+		return array_merge($fc_items, $sc_items);
+	}
+
+
+
+	/***************************************        REGISTRATION OVERVIEW        **************************************/
+	/**
+	 * @throws \EE_Error
+	 */
+	protected function _registrations_overview_list_table()
+	{
+		$this->_template_args['admin_page_header'] = '';
+		$EVT_ID = ! empty($this->_req_data['event_id']) ? absint($this->_req_data['event_id']) : 0;
+		if ($EVT_ID) {
+			if (EE_Registry::instance()->CAP->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',
+						array('event_id' => $EVT_ID), 'add-new-h2');
+			}
+			$event = EEM_Event::instance()->get_one_by_ID($EVT_ID);
+			if ($event instanceof EE_Event) {
+				$this->_template_args['admin_page_header'] = sprintf(__('%s Viewing registrations for the event: %s%s',
+					'event_espresso'), '<h3 style="line-height:1.5em;">',
+					'<br /><a href="' . EE_Admin_Page::add_query_args_and_nonce(array(
+						'action' => 'edit',
+						'post'   => $event->ID(),
+					), EVENTS_ADMIN_URL) . '">&nbsp;' . $event->get('EVT_name') . '&nbsp;</a>&nbsp;', '</h3>');
+			}
+			$DTT_ID = ! empty($this->_req_data['datetime_id']) ? absint($this->_req_data['datetime_id']) : 0;
+			$datetime = EEM_Datetime::instance()->get_one_by_ID($DTT_ID);
+			if ($datetime instanceof EE_Datetime && $this->_template_args['admin_page_header'] !== '') {
+				$this->_template_args['admin_page_header'] = substr($this->_template_args['admin_page_header'], 0, -5);
+				$this->_template_args['admin_page_header'] .= ' &nbsp;<span class="drk-grey-text">';
+				$this->_template_args['admin_page_header'] .= '<span class="dashicons dashicons-calendar"></span>';
+				$this->_template_args['admin_page_header'] .= $datetime->name();
+				$this->_template_args['admin_page_header'] .= ' ( ' . $datetime->start_date() . ' )';
+				$this->_template_args['admin_page_header'] .= '</span></h3>';
+			}
+		}
+		$this->_template_args['after_list_table'] = $this->_display_legend($this->_registration_legend_items());
+		$this->display_admin_list_table_page_with_no_sidebar();
+	}
+
+
+
+	/**
+	 * This sets the _registration property for the registration details screen
+	 *
+	 * @access private
+	 * @return bool
+	 */
+	private function _set_registration_object()
+	{
+		//get out if we've already set the object
+		if (is_object($this->_registration)) {
+			return true;
+		}
+		$REG = EEM_Registration::instance();
+		$REG_ID = ( ! empty($this->_req_data['_REG_ID'])) ? absint($this->_req_data['_REG_ID']) : false;
+		if ($this->_registration = $REG->get_one_by_ID($REG_ID)) {
+			return true;
+		} else {
+			$error_msg = sprintf(__('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;
+			return false;
+		}
+	}
+
+
+
+	/**
+	 * get registrations for given parameters (used by list table)
+	 *
+	 * @param  int     $per_page   how many registrations displayed per page
+	 * @param  boolean $count      return the count or objects
+	 * @param  boolean $this_month whether to return for just this month
+	 * @param  boolean $today      whether to return results for just today
+	 * @throws \EE_Error
+	 * @return mixed (int|array)  int = count || array of registration objects
+	 */
+	public function get_registrations($per_page = 10, $count = false, $this_month = false, $today = false)
+	{
+		$EVT_ID = ! empty($this->_req_data['event_id']) && $this->_req_data['event_id'] > 0
+			? absint($this->_req_data['event_id']) : false;
+		$CAT_ID = ! empty($this->_req_data['EVT_CAT']) && (int)$this->_req_data['EVT_CAT'] > 0
+			? absint($this->_req_data['EVT_CAT']) : false;
+		$DTT_ID = isset($this->_req_data['datetime_id']) ? absint($this->_req_data['datetime_id']) : null;
+		$reg_status = ! empty($this->_req_data['_reg_status']) ? sanitize_text_field($this->_req_data['_reg_status'])
+			: false;
+		$month_range = ! empty($this->_req_data['month_range']) ? sanitize_text_field($this->_req_data['month_range'])
+			: false;//should be like 2013-april
+		$today_a = ! empty($this->_req_data['status']) && $this->_req_data['status'] === 'today' ? true : false;
+		$this_month_a = ! empty($this->_req_data['status']) && $this->_req_data['status'] === 'month' ? true : false;
+		$start_date = false;
+		$end_date = false;
+		$_where = array();
+		$trash = ! empty($this->_req_data['status']) && $this->_req_data['status'] === 'trash' ? true : false;
+		$incomplete = ! empty($this->_req_data['status']) && $this->_req_data['status'] === 'incomplete' ? true : false;
+		//set orderby
+		$this->_req_data['orderby'] = ! empty($this->_req_data['orderby']) ? $this->_req_data['orderby'] : '';
+		switch ($this->_req_data['orderby']) {
+			case '_REG_ID':
+				$orderby = 'REG_ID';
+				break;
+			case '_Reg_status':
+				$orderby = 'STS_ID';
+				break;
+			case 'ATT_fname':
+				$orderby = 'Attendee.ATT_lname';
+				break;
+			case 'event_name':
+				$orderby = 'Event.EVT_name';
+				break;
+			case 'DTT_EVT_start':
+				$orderby = 'Event.Datetime.DTT_EVT_start';
+				break;
+			default: //'REG_date'
+				$orderby = 'REG_date';
+		}
+		$sort = (isset($this->_req_data['order']) && ! empty($this->_req_data['order'])) ? $this->_req_data['order']
+			: 'DESC';
+		$current_page = isset($this->_req_data['paged']) && ! empty($this->_req_data['paged'])
+			? $this->_req_data['paged'] : 1;
+		$per_page = isset($this->_req_data['perpage']) && ! empty($this->_req_data['perpage'])
+			? $this->_req_data['perpage'] : $per_page;
+		$offset = ($current_page - 1) * $per_page;
+		$limit = $count ? null : array($offset, $per_page);
+		if ($EVT_ID) {
+			$_where['EVT_ID'] = $EVT_ID;
+		}
+		if ($CAT_ID) {
+			$_where['Event.Term_Taxonomy.term_id'] = $CAT_ID;
+		}
+		//if DTT is included we filter by that datetime.
+		if ($DTT_ID) {
+			$_where['Ticket.Datetime.DTT_ID'] = $DTT_ID;
+		}
+		if ($incomplete) {
+			$_where['STS_ID'] = EEM_Registration::status_id_incomplete;
+		} else if ( ! $trash) {
+			$_where['STS_ID'] = array('!=', EEM_Registration::status_id_incomplete);
+		}
+		if ($reg_status) {
+			$_where['STS_ID'] = $reg_status;
+		}
+		$this_year_r = date('Y', current_time('timestamp'));
+		$time_start = ' 00:00:00';
+		$time_end = ' 23:59:59';
+		if ($today_a || $today) {
+			$curdate = date('Y-m-d', current_time('timestamp'));
+			$_where['REG_date'] = array(
+				'BETWEEN',
+				array(
+					EEM_Registration::instance()
+									->convert_datetime_for_query('REG_date', $curdate . $time_start, 'Y-m-d H:i:s'),
+					EEM_Registration::instance()
+									->convert_datetime_for_query('REG_date', $curdate . $time_end, 'Y-m-d H:i:s'),
+				),
+			);
+		} elseif ($this_month_a || $this_month) {
+			$this_month_r = date('m', current_time('timestamp'));
+			$days_this_month = date('t', current_time('timestamp'));
+			$_where['REG_date'] = array(
+				'BETWEEN',
+				array(
+					EEM_Registration::instance()
+									->convert_datetime_for_query('REG_date',
+										$this_year_r . '-' . $this_month_r . '-01' . ' ' . $time_start, 'Y-m-d H:i:s'),
+					EEM_Registration::instance()
+									->convert_datetime_for_query('REG_date',
+										$this_year_r . '-' . $this_month_r . '-' . $days_this_month . ' ' . $time_end,
+										'Y-m-d H:i:s'),
+				),
+			);
+		} elseif ($month_range) {
+			$pieces = explode(' ', $this->_req_data['month_range'], 3);
+			$month_r = ! empty($pieces[0]) ? date('m', strtotime($month_range)) : '';
+			$year_r = ! empty($pieces[1]) ? $pieces[1] : '';
+			$days_in_month = date('t', strtotime($year_r . '-' . $month_r . '-' . '01'));
+			$_where['REG_date'] = array(
+				'BETWEEN',
+				array(
+					EEM_Registration::instance()
+									->convert_datetime_for_query('REG_date', $year_r . '-' . $month_r . '-01 00:00:00',
+										'Y-m-d H:i:s'),
+					EEM_Registration::instance()
+									->convert_datetime_for_query('REG_date',
+										$year_r . '-' . $month_r . '-' . $days_in_month . ' 23:59:59', 'Y-m-d H:i:s'),
+				),
+			);
+		} elseif ($start_date && $end_date) {
+			throw new EE_Error("not yet supported");
+		} elseif ($start_date) {
+			throw new EE_Error("not yet supported");
+		} elseif ($end_date) {
+			throw new EE_Error("not yet supported");
+		}
+		if ( ! empty($this->_req_data['s'])) {
+			$sstr = '%' . $this->_req_data['s'] . '%';
+			$_where['OR'] = array(
+				'Event.EVT_name'                          => array('LIKE', $sstr),
+				'Event.EVT_desc'                          => array('LIKE', $sstr),
+				'Event.EVT_short_desc'                    => array('LIKE', $sstr),
+				'Attendee.ATT_full_name'                  => array('LIKE', $sstr),
+				'Attendee.ATT_fname'                      => array('LIKE', $sstr),
+				'Attendee.ATT_lname'                      => array('LIKE', $sstr),
+				'Attendee.ATT_short_bio'                  => array('LIKE', $sstr),
+				'Attendee.ATT_email'                      => array('LIKE', $sstr),
+				'Attendee.ATT_address'                    => array('LIKE', $sstr),
+				'Attendee.ATT_address2'                   => array('LIKE', $sstr),
+				'Attendee.ATT_city'                       => array('LIKE', $sstr),
+				'REG_final_price'                         => array('LIKE', $sstr),
+				'REG_code'                                => array('LIKE', $sstr),
+				'REG_count'                               => array('LIKE', $sstr),
+				'REG_group_size'                          => array('LIKE', $sstr),
+				'Ticket.TKT_name'                         => array('LIKE', $sstr),
+				'Ticket.TKT_description'                  => array('LIKE', $sstr),
+				'Transaction.Payment.PAY_txn_id_chq_nmbr' => array('LIKE', $sstr),
+			);
+		}
+		//capability checks
+		if ( ! EE_Registry::instance()->CAP->current_user_can('ee_read_others_registrations', 'get_registrations')) {
+			$_where['AND'] = array(
+				'Event.EVT_wp_user' => get_current_user_id(),
+			);
+		}
+		if ($count) {
+			if ($trash) {
+				return EEM_Registration::instance()->count_deleted(array($_where));
+			} else if ($incomplete) {
+				return EEM_Registration::instance()->count(array($_where));
+			} else {
+				return EEM_Registration::instance()->count(array(
+					$_where,
+					'default_where_conditions' => 'this_model_only',
+				));
+			}
+		} else {
+			//make sure we remove default where conditions cause all registrations matching query are returned
+			$query_params = array(
+				$_where,
+				'order_by'                 => array($orderby => $sort),
+				'default_where_conditions' => 'this_model_only',
+			);
+			if ($per_page !== -1) {
+				$query_params['limit'] = $limit;
+			}
+			$registrations = $trash ? EEM_Registration::instance()->get_all_deleted($query_params)
+				: EEM_Registration::instance()->get_all($query_params);
+			if ($EVT_ID
+				&& isset($registrations[0])
+				&& $registrations[0] instanceof EE_Registration
+				&& $registrations[0]->event_obj()
+			) {
+				$first_registration = $registrations[0];
+				//EEH_Debug_Tools::printr( $registrations[0], '$registrations  <br /><span style="font-size:10px;font-weight:normal;">' . __FILE__ . '<br />line no: ' . __LINE__ . '</span>', 'auto' );
+				$event_name = $first_registration->event_obj()->name();
+				$event_date = $first_registration->date_obj()
+												 ->start_date_and_time('l F j, Y,',
+													 'g:i:s a');// isset( $registrations[0]->DTT_EVT_start ) ? date( 'l F j, Y,    g:i:s a', $registrations[0]->DTT_EVT_start ) : '';
+				// edit event link
+				if ($event_name != '') {
+					$edit_event_url = self::add_query_args_and_nonce(array(
+						'action' => 'edit_event',
+						'EVT_ID' => $EVT_ID,
+					), EVENTS_ADMIN_URL);
+					$edit_event_lnk = '<a href="' . $edit_event_url . '" title="' . esc_attr__('Edit ',
+							'event_espresso') . $event_name . '">' . __('Edit Event', 'event_espresso') . '</a>';
+					$event_name .= ' <span class="admin-page-header-edit-lnk not-bold">' . $edit_event_lnk . '</span>';
+				}
+				$back_2_reg_url = self::add_query_args_and_nonce(array('action' => 'default'), REG_ADMIN_URL);
+				$back_2_reg_lnk = '<a href="'
+								  . $back_2_reg_url
+								  . '" title="'
+								  . esc_attr__('click to return to viewing all registrations ', 'event_espresso')
+								  . '">&laquo; '
+								  . __('Back to All Registrations', 'event_espresso')
+								  . '</a>';
+				$this->_template_args['before_admin_page_content'] = '
 			<div id="admin-page-header">
 				<h1><span class="small-text not-bold">' . __('Event: ', 'event_espresso') . '</span>' . $event_name . '</h1>
 				<h3><span class="small-text not-bold">' . __('Date: ', 'event_espresso') . '</span>' . $event_date . '</h3>
 				<span class="admin-page-header-go-back-lnk not-bold">' . $back_2_reg_lnk . '</span>
 			</div>
 			';
-            }
-            return $registrations;
-        }
-    }
-
-
-
-    public function get_registration_status_array()
-    {
-        return self::$_reg_status;
-    }
-
-
-
-
-    /***************************************        REGISTRATION DETAILS        ***************************************/
-    /**
-     *        generates HTML for the View Registration Details Admin page
-     *
-     * @access protected
-     * @return void
-     */
-    protected function _registration_details()
-    {
-        $this->_template_args = array();
-        $this->_set_registration_object();
-        if (is_object($this->_registration)) {
-            $transaction = $this->_registration->transaction() ? $this->_registration->transaction()
-                : EE_Transaction::new_instance();
-            $this->_session = $transaction->session_data();
-            $event_id = $this->_registration->event_ID();
-            $this->_template_args['reg_nmbr']['value'] = $this->_registration->ID();
-            $this->_template_args['reg_nmbr']['label'] = __('Registration Number', 'event_espresso');
-            $this->_template_args['reg_datetime']['value'] = $this->_registration->get_i18n_datetime('REG_date');
-            $this->_template_args['reg_datetime']['label'] = __('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(array(
-                'action'   => 'default',
-                'event_id' => $event_id,
-            ), REG_ADMIN_URL);
-            $this->_template_args['filtered_transactions_link'] = EE_Admin_Page::add_query_args_and_nonce(array(
-                '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(array(
-                'page'   => 'espresso_events',
-                'action' => 'edit',
-                'post'   => $event_id,
-            ), admin_url('admin.php'));
-            //next and previous links
-            $next_reg = $this->_registration->next(null, array(), 'REG_ID');
-            $this->_template_args['next_registration'] = $next_reg
-                ? $this->_next_link(EE_Admin_Page::add_query_args_and_nonce(array(
-                    '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, array(), 'REG_ID');
-            $this->_template_args['previous_registration'] = $previous_reg
-                ? $this->_previous_link(EE_Admin_Page::add_query_args_and_nonce(array(
-                    '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();
-    }
-
-
-
-    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;
-        add_meta_box('edit-reg-status-mbox', __('Registration Status', 'event_espresso'),
-            array($this, 'set_reg_status_buttons_metabox'), $this->wp_page_slug, 'normal', 'high');
-        add_meta_box('edit-reg-details-mbox', __('Registration Details', 'event_espresso'),
-            array($this, '_reg_details_meta_box'), $this->wp_page_slug, 'normal', 'high');
-        if ($attendee instanceof EE_Attendee
-            && EE_Registry::instance()->CAP->current_user_can('ee_edit_registration', 'edit-reg-questions-mbox')
-        ) {
-            add_meta_box('edit-reg-questions-mbox', __('Registration Form Answers', 'event_espresso'),
-                array($this, '_reg_questions_meta_box'), $this->wp_page_slug, 'normal', 'high');
-        }
-        add_meta_box('edit-reg-registrant-mbox', __('Contact Details', 'event_espresso'),
-            array($this, '_reg_registrant_side_meta_box'), $this->wp_page_slug, 'side', 'high');
-        if ($this->_registration->group_size() > 1) {
-            add_meta_box('edit-reg-attendees-mbox', __('Other Registrations in this Transaction', 'event_espresso'),
-                array($this, '_reg_attendees_meta_box'), $this->wp_page_slug, 'normal', 'high');
-        }
-    }
-
-
-
-    /**
-     * set_reg_status_buttons_metabox
-     *
-     * @access protected
-     * @return string
-     * @throws \EE_Error
-     */
-    public function set_reg_status_buttons_metabox()
-    {
-        $this->_set_registration_object();
-        $change_reg_status_form = $this->_generate_reg_status_change_form();
-        echo $change_reg_status_form->form_open(self::add_query_args_and_nonce(array(
-            'action' => 'change_reg_status',
-        ), REG_ADMIN_URL));
-        echo $change_reg_status_form->get_html();
-        echo $change_reg_status_form->form_close();
-    }
-
-
-
-    /**
-     * @return EE_Form_Section_Proper
-     */
-    protected function _generate_reg_status_change_form()
-    {
-        return new EE_Form_Section_Proper(array(
-                'name'            => 'reg_status_change_form',
-                'html_id'         => 'reg-status-change-form',
-                'layout_strategy' => new EE_Admin_Two_Column_Layout(),
-                'subsections'     => array(
-                    'return'             => new EE_Hidden_Input(array(
-                        'name'    => 'return',
-                        'default' => 'view_registration',
-                    )),
-                    'REG_ID'             => new EE_Hidden_Input(array(
-                        'name'    => 'REG_ID',
-                        'default' => $this->_registration->ID(),
-                    )),
-                    'current_status'     => new EE_Form_Section_HTML(EEH_HTML::tr(EEH_HTML::th(EEH_HTML::label(EEH_HTML::strong(__('Current Registration Status',
-                            'event_espresso')))) . EEH_HTML::td(EEH_HTML::strong($this->_registration->pretty_status(),
-                            '', 'status-' . $this->_registration->status_ID(),
-                            'line-height: 1em; font-size: 1.5em; font-weight: bold;')))),
-                    'reg_status'         => new EE_Select_Input($this->_get_reg_statuses(), array(
-                            'html_label_text' => __('Change Registration Status to', 'event_espresso'),
-                            'default'         => $this->_registration->status_ID(),
-                        )),
-                    'send_notifications' => new EE_Yes_No_Input(array(
-                            'html_label_text' => __('Send Related Messages', 'event_espresso'),
-                            'default'         => false,
-                            'html_help_text'  => __('If set to "Yes", then the related messages will be sent to the registrant.',
-                                'event_espresso'),
-                        )),
-                    'submit'             => new EE_Submit_Input(array(
-                        'html_class'      => 'button-primary',
-                        'html_label_text' => '&nbsp;',
-                        'default'         => __('Update Registration Status', 'event_espresso'),
-                    )),
-                ),
-            ));
-    }
-
-
-
-    /**
-     * Returns an array of all the buttons for the various statuses and switch status actions
-     *
-     * @return string
-     */
-    protected function _get_current_reg_status_help_text($STS_ID = '')
-    {
-        //$reg_status_help_text = array(
-        //	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
-        //	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
-        //	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
-        //	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
-        //	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
-        //	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
-        //);
-        //Approved
-        //An approved registration allows payments and may have a transaction status of incomplete or complete . The registration is marked as active and a space is reserved for the registrant .
-        //Cancelled
-        //	A {
-        //	cancelled} registration is performed by the registrant . Payments are not allowed, the registration is inactive, and no space is reserved .
-        //Declined
-        //A declined registration is performed by the event admin . Payments are not allowed, the registration is inactive, and not space is reserved .
-        //Not Approved
-        //A not approved registration is performed by the event admin . Payments are not allowed, the registration is active, and no space is reserved .
-        //Pending Payment
-        //A pending registration allows payments . The status will be automatically toggled to approved if the {
-        //	payment} is made in full by registrant .
-    }
-
-
-
-    /**
-     * Returns an array of all the buttons for the various statuses and switch status actions
-     *
-     * @return array
-     */
-    protected function _get_reg_statuses()
-    {
-        $reg_status_array = EEM_Registration::instance()->reg_status_array();
-        unset ($reg_status_array[EEM_Registration::status_id_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 != EEM_Registration::status_id_pending_payment
-            && $this->_registration->transaction()
-                                   ->is_free()
-        ) {
-            unset($reg_status_array[EEM_Registration::status_id_pending_payment]);
-        }
-        return EEM_Status::instance()->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 bool $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.
-     */
-    protected function _set_registration_status_from_request($status = false, $notify = false)
-    {
-        if (isset($this->_req_data['reg_status_change_form'])) {
-            $REG_IDs = isset($this->_req_data['reg_status_change_form']['REG_ID'])
-                ? (array)$this->_req_data['reg_status_change_form']['REG_ID'] : array();
-        } else {
-            $REG_IDs = isset($this->_req_data['_REG_ID']) ? (array)$this->_req_data['_REG_ID'] : array();
-        }
-        $success = $this->_set_registration_status($REG_IDs, $status);
-        //notify?
-        if ($success
-            && $notify
-            && EE_Registry::instance()->CAP->current_user_can('ee_send_message',
-                'espresso_registrations_resend_registration')
-        ) {
-            $this->_process_resend_registration();
-        }
-        return $success;
-    }
-
-
-
-    /**
-     * 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 bool  $status
-     * @return array (an array with 'success' key representing whether status change was successful, and 'REG_ID' as
-     *               the array of updated registrations).
-     */
-    protected function _set_registration_status($REG_IDs = array(), $status = false)
-    {
-        $success = false;
-        // typecast $REG_IDs
-        $REG_IDs = (array)$REG_IDs;
-        if ( ! empty($REG_IDs)) {
-            $success = true;
-            // set default status if none is passed
-            $status = $status ? $status : EEM_Registration::status_id_pending_payment;
-            // sanitize $REG_IDs
-            $REG_IDs = array_filter($REG_IDs, 'absint');
-            //loop through REG_ID's and change status
-            foreach ($REG_IDs as $REG_ID) {
-                $registration = EEM_Registration::instance()->get_one_by_ID($REG_ID);
-                if ($registration instanceof EE_Registration) {
-                    $registration->set_status($status);
-                    $result = $registration->save();
-                    // verifying explicit fails because update *may* just return 0 for 0 rows affected
-                    $success = $result !== false ? $success : false;
-                }
-            }
-        }
-        //reset _req_data['_REG_ID'] for any potential future messages notifications
-        $this->_req_data['_REG_ID'] = $REG_IDs;
-        //return $success and processed registrations
-        return array('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
-     */
-    protected function _reg_status_change_return($STS_ID, $notify = false)
-    {
-        $result = ! empty($STS_ID) ? $this->_set_registration_status_from_request($STS_ID, $notify)
-            : array('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(__('Registration status has been set to %s', 'event_espresso'),
-                    EEH_Template::pretty_status($STS_ID, false, 'lower'));
-            } else {
-                $msg = sprintf(__('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(__('Something went wrong, and the status was not changed', 'event_espresso'), __FILE__,
-                __LINE__, __FUNCTION__);
-        }
-        if (isset($this->_req_data['return']) && $this->_req_data['return'] == 'view_registration') {
-            $route = array('action' => 'view_registration', '_REG_ID' => reset($result['REG_ID']));
-        } else {
-            $route = array('action' => 'default');
-        }
-        //unset nonces
-        foreach ($this->_req_data as $ref => $value) {
-            if (strpos($ref, 'nonce') !== false) {
-                unset($this->_req_data[$ref]);
-                continue;
-            }
-            $value = is_array($value) ? array_map('urlencode', $value) : urlencode($value);
-            $this->_req_data[$ref] = $value;
-        }
-        //merge request vars so that the reloaded list table contains any existing filter query params
-        $route = array_merge($this->_req_data, $route);
-        $this->_redirect_after_action($success, '', '', $route, true);
-    }
-
-
-
-    /**
-     * incoming reg status change from reg details page.
-     *
-     * @return void
-     */
-    protected function _change_reg_status()
-    {
-        $this->_req_data['return'] = 'view_registration';
-        //set notify based on whether the send notifications toggle is set or not
-        $notify = ! empty($this->_req_data['reg_status_change_form']['send_notifications']);
-        //$notify = ! empty( $this->_req_data['txn_reg_status_change']['send_notifications'] );
-        $this->_req_data['reg_status_change_form']['reg_status'] = isset($this->_req_data['reg_status_change_form']['reg_status'])
-            ? $this->_req_data['reg_status_change_form']['reg_status'] : '';
-        switch ($this->_req_data['reg_status_change_form']['reg_status']) {
-            case EEM_Registration::status_id_approved :
-            case EEH_Template::pretty_status(EEM_Registration::status_id_approved, false, 'sentence') :
-                $this->approve_registration($notify);
-                break;
-            case EEM_Registration::status_id_pending_payment :
-            case EEH_Template::pretty_status(EEM_Registration::status_id_pending_payment, false, 'sentence') :
-                $this->pending_registration($notify);
-                break;
-            case EEM_Registration::status_id_not_approved :
-            case EEH_Template::pretty_status(EEM_Registration::status_id_not_approved, false, 'sentence') :
-                $this->not_approve_registration($notify);
-                break;
-            case EEM_Registration::status_id_declined :
-            case EEH_Template::pretty_status(EEM_Registration::status_id_declined, false, 'sentence') :
-                $this->decline_registration($notify);
-                break;
-            case EEM_Registration::status_id_cancelled :
-            case EEH_Template::pretty_status(EEM_Registration::status_id_cancelled, false, 'sentence') :
-                $this->cancel_registration($notify);
-                break;
-            case EEM_Registration::status_id_wait_list :
-            case EEH_Template::pretty_status(EEM_Registration::status_id_wait_list, false, 'sentence') :
-                $this->waitlist_registration($notify);
-                break;
-            case EEM_Registration::status_id_incomplete :
-            default :
-                $result['success'] = false;
-                unset($this->_req_data['return']);
-                $this->_reg_status_change_return('', false);
-                break;
-        }
-    }
-
-
-
-    /**
-     * approve_registration
-     *
-     * @access protected
-     * @param bool $notify whether or not to notify the registrant about their approval.
-     * @return void
-     */
-    protected function approve_registration($notify = false)
-    {
-        $this->_reg_status_change_return(EEM_Registration::status_id_approved, $notify);
-    }
-
-
-
-    /**
-     *        decline_registration
-     *
-     * @access protected
-     * @param bool $notify whether or not to notify the registrant about their status change.
-     * @return void
-     */
-    protected function decline_registration($notify = false)
-    {
-        $this->_reg_status_change_return(EEM_Registration::status_id_declined, $notify);
-    }
-
-
-
-    /**
-     *        cancel_registration
-     *
-     * @access protected
-     * @param bool $notify whether or not to notify the registrant about their status change.
-     * @return void
-     */
-    protected function cancel_registration($notify = false)
-    {
-        $this->_reg_status_change_return(EEM_Registration::status_id_cancelled, $notify);
-    }
-
-
-
-    /**
-     *        not_approve_registration
-     *
-     * @access protected
-     * @param bool $notify whether or not to notify the registrant about their status change.
-     * @return void
-     */
-    protected function not_approve_registration($notify = false)
-    {
-        $this->_reg_status_change_return(EEM_Registration::status_id_not_approved, $notify);
-    }
-
-
-
-    /**
-     *        decline_registration
-     *
-     * @access protected
-     * @param bool $notify whether or not to notify the registrant about their status change.
-     * @return void
-     */
-    protected function pending_registration($notify = false)
-    {
-        $this->_reg_status_change_return(EEM_Registration::status_id_pending_payment, $notify);
-    }
-
-
-
-    /**
-     * waitlist_registration
-     *
-     * @access protected
-     * @param bool $notify whether or not to notify the registrant about their status change.
-     * @return void
-     */
-    protected function waitlist_registration($notify = false)
-    {
-        $this->_reg_status_change_return(EEM_Registration::status_id_wait_list, $notify);
-    }
-
-
-
-    /**
-     *        generates HTML for the Registration main meta box
-     *
-     * @access public
-     * @return void
-     */
-    public function _reg_details_meta_box()
-    {
-        EEH_Autoloader::register_line_item_display_autoloaders();
-        EEH_Autoloader::register_line_item_filter_autoloaders();
-        EE_Registry::instance()->load_helper('Line_Item');
-        $transaction = $this->_registration->transaction() ? $this->_registration->transaction()
-            : EE_Transaction::new_instance();
-        $this->_session = $transaction->session_data();
-        $filters = new EE_Line_Item_Filter_Collection();
-        //$filters->add( new EE_Non_Zero_Line_Item_Filter() );
-        $filters->add(new EE_Single_Registration_Line_Item_Filter($this->_registration));
-        $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,
-            array('EE_Registration' => $this->_registration));
-        $attendee = $this->_registration->attendee();
-        if (EE_Registry::instance()->CAP->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(array(
-                'action' => 'view_transaction',
-                'TXN_ID' => $transaction->ID(),
-            ), TXN_ADMIN_URL), esc_html__(' View Transaction'), 'button secondary-button right',
-                'dashicons dashicons-cart');
-        } else {
-            $this->_template_args['view_transaction_button'] = '';
-        }
-        if ($attendee instanceof EE_Attendee
-            && EE_Registry::instance()->CAP->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(array(
-                'action'      => 'resend_registration',
-                '_REG_ID'     => $this->_registration->ID(),
-                'redirect_to' => 'view_registration',
-            ), REG_ADMIN_URL), esc_html__(' Resend Registration'), 'button secondary-button 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 = array(
-            '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'           => isset($this->_session['ip_address']) ? $this->_session['ip_address'] : '',
-            'user_agent'           => isset($this->_session['user_agent']) ? $this->_session['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'] = __('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'] = __('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'] = __('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'] = __('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'] = __('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'] = __('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(array(
-            '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';
-        echo EEH_Template::display_template($template_path, $this->_template_args, true);
-    }
-
-
-
-    /**
-     * 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
-     *
-     * @access public
-     * @return void
-     */
-    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';
-            echo EEH_Template::display_template($template_path, $this->_template_args, true);
-        }
-    }
-
-
-
-    /**
-     * form_before_question_group
-     *
-     * @deprecated    as of 4.8.32.rc.000
-     * @access        public
-     * @param        string $output
-     * @return        string
-     */
-    public function form_before_question_group($output)
-    {
-        EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
-            __('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 '
+			}
+			return $registrations;
+		}
+	}
+
+
+
+	public function get_registration_status_array()
+	{
+		return self::$_reg_status;
+	}
+
+
+
+
+	/***************************************        REGISTRATION DETAILS        ***************************************/
+	/**
+	 *        generates HTML for the View Registration Details Admin page
+	 *
+	 * @access protected
+	 * @return void
+	 */
+	protected function _registration_details()
+	{
+		$this->_template_args = array();
+		$this->_set_registration_object();
+		if (is_object($this->_registration)) {
+			$transaction = $this->_registration->transaction() ? $this->_registration->transaction()
+				: EE_Transaction::new_instance();
+			$this->_session = $transaction->session_data();
+			$event_id = $this->_registration->event_ID();
+			$this->_template_args['reg_nmbr']['value'] = $this->_registration->ID();
+			$this->_template_args['reg_nmbr']['label'] = __('Registration Number', 'event_espresso');
+			$this->_template_args['reg_datetime']['value'] = $this->_registration->get_i18n_datetime('REG_date');
+			$this->_template_args['reg_datetime']['label'] = __('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(array(
+				'action'   => 'default',
+				'event_id' => $event_id,
+			), REG_ADMIN_URL);
+			$this->_template_args['filtered_transactions_link'] = EE_Admin_Page::add_query_args_and_nonce(array(
+				'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(array(
+				'page'   => 'espresso_events',
+				'action' => 'edit',
+				'post'   => $event_id,
+			), admin_url('admin.php'));
+			//next and previous links
+			$next_reg = $this->_registration->next(null, array(), 'REG_ID');
+			$this->_template_args['next_registration'] = $next_reg
+				? $this->_next_link(EE_Admin_Page::add_query_args_and_nonce(array(
+					'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, array(), 'REG_ID');
+			$this->_template_args['previous_registration'] = $previous_reg
+				? $this->_previous_link(EE_Admin_Page::add_query_args_and_nonce(array(
+					'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();
+	}
+
+
+
+	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;
+		add_meta_box('edit-reg-status-mbox', __('Registration Status', 'event_espresso'),
+			array($this, 'set_reg_status_buttons_metabox'), $this->wp_page_slug, 'normal', 'high');
+		add_meta_box('edit-reg-details-mbox', __('Registration Details', 'event_espresso'),
+			array($this, '_reg_details_meta_box'), $this->wp_page_slug, 'normal', 'high');
+		if ($attendee instanceof EE_Attendee
+			&& EE_Registry::instance()->CAP->current_user_can('ee_edit_registration', 'edit-reg-questions-mbox')
+		) {
+			add_meta_box('edit-reg-questions-mbox', __('Registration Form Answers', 'event_espresso'),
+				array($this, '_reg_questions_meta_box'), $this->wp_page_slug, 'normal', 'high');
+		}
+		add_meta_box('edit-reg-registrant-mbox', __('Contact Details', 'event_espresso'),
+			array($this, '_reg_registrant_side_meta_box'), $this->wp_page_slug, 'side', 'high');
+		if ($this->_registration->group_size() > 1) {
+			add_meta_box('edit-reg-attendees-mbox', __('Other Registrations in this Transaction', 'event_espresso'),
+				array($this, '_reg_attendees_meta_box'), $this->wp_page_slug, 'normal', 'high');
+		}
+	}
+
+
+
+	/**
+	 * set_reg_status_buttons_metabox
+	 *
+	 * @access protected
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function set_reg_status_buttons_metabox()
+	{
+		$this->_set_registration_object();
+		$change_reg_status_form = $this->_generate_reg_status_change_form();
+		echo $change_reg_status_form->form_open(self::add_query_args_and_nonce(array(
+			'action' => 'change_reg_status',
+		), REG_ADMIN_URL));
+		echo $change_reg_status_form->get_html();
+		echo $change_reg_status_form->form_close();
+	}
+
+
+
+	/**
+	 * @return EE_Form_Section_Proper
+	 */
+	protected function _generate_reg_status_change_form()
+	{
+		return new EE_Form_Section_Proper(array(
+				'name'            => 'reg_status_change_form',
+				'html_id'         => 'reg-status-change-form',
+				'layout_strategy' => new EE_Admin_Two_Column_Layout(),
+				'subsections'     => array(
+					'return'             => new EE_Hidden_Input(array(
+						'name'    => 'return',
+						'default' => 'view_registration',
+					)),
+					'REG_ID'             => new EE_Hidden_Input(array(
+						'name'    => 'REG_ID',
+						'default' => $this->_registration->ID(),
+					)),
+					'current_status'     => new EE_Form_Section_HTML(EEH_HTML::tr(EEH_HTML::th(EEH_HTML::label(EEH_HTML::strong(__('Current Registration Status',
+							'event_espresso')))) . EEH_HTML::td(EEH_HTML::strong($this->_registration->pretty_status(),
+							'', 'status-' . $this->_registration->status_ID(),
+							'line-height: 1em; font-size: 1.5em; font-weight: bold;')))),
+					'reg_status'         => new EE_Select_Input($this->_get_reg_statuses(), array(
+							'html_label_text' => __('Change Registration Status to', 'event_espresso'),
+							'default'         => $this->_registration->status_ID(),
+						)),
+					'send_notifications' => new EE_Yes_No_Input(array(
+							'html_label_text' => __('Send Related Messages', 'event_espresso'),
+							'default'         => false,
+							'html_help_text'  => __('If set to "Yes", then the related messages will be sent to the registrant.',
+								'event_espresso'),
+						)),
+					'submit'             => new EE_Submit_Input(array(
+						'html_class'      => 'button-primary',
+						'html_label_text' => '&nbsp;',
+						'default'         => __('Update Registration Status', 'event_espresso'),
+					)),
+				),
+			));
+	}
+
+
+
+	/**
+	 * Returns an array of all the buttons for the various statuses and switch status actions
+	 *
+	 * @return string
+	 */
+	protected function _get_current_reg_status_help_text($STS_ID = '')
+	{
+		//$reg_status_help_text = array(
+		//	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
+		//	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
+		//	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
+		//	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
+		//	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
+		//	'RAP' => __( 'XXXXXXXXXXX', 'event_espresso' ),
+		//);
+		//Approved
+		//An approved registration allows payments and may have a transaction status of incomplete or complete . The registration is marked as active and a space is reserved for the registrant .
+		//Cancelled
+		//	A {
+		//	cancelled} registration is performed by the registrant . Payments are not allowed, the registration is inactive, and no space is reserved .
+		//Declined
+		//A declined registration is performed by the event admin . Payments are not allowed, the registration is inactive, and not space is reserved .
+		//Not Approved
+		//A not approved registration is performed by the event admin . Payments are not allowed, the registration is active, and no space is reserved .
+		//Pending Payment
+		//A pending registration allows payments . The status will be automatically toggled to approved if the {
+		//	payment} is made in full by registrant .
+	}
+
+
+
+	/**
+	 * Returns an array of all the buttons for the various statuses and switch status actions
+	 *
+	 * @return array
+	 */
+	protected function _get_reg_statuses()
+	{
+		$reg_status_array = EEM_Registration::instance()->reg_status_array();
+		unset ($reg_status_array[EEM_Registration::status_id_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 != EEM_Registration::status_id_pending_payment
+			&& $this->_registration->transaction()
+								   ->is_free()
+		) {
+			unset($reg_status_array[EEM_Registration::status_id_pending_payment]);
+		}
+		return EEM_Status::instance()->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 bool $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.
+	 */
+	protected function _set_registration_status_from_request($status = false, $notify = false)
+	{
+		if (isset($this->_req_data['reg_status_change_form'])) {
+			$REG_IDs = isset($this->_req_data['reg_status_change_form']['REG_ID'])
+				? (array)$this->_req_data['reg_status_change_form']['REG_ID'] : array();
+		} else {
+			$REG_IDs = isset($this->_req_data['_REG_ID']) ? (array)$this->_req_data['_REG_ID'] : array();
+		}
+		$success = $this->_set_registration_status($REG_IDs, $status);
+		//notify?
+		if ($success
+			&& $notify
+			&& EE_Registry::instance()->CAP->current_user_can('ee_send_message',
+				'espresso_registrations_resend_registration')
+		) {
+			$this->_process_resend_registration();
+		}
+		return $success;
+	}
+
+
+
+	/**
+	 * 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 bool  $status
+	 * @return array (an array with 'success' key representing whether status change was successful, and 'REG_ID' as
+	 *               the array of updated registrations).
+	 */
+	protected function _set_registration_status($REG_IDs = array(), $status = false)
+	{
+		$success = false;
+		// typecast $REG_IDs
+		$REG_IDs = (array)$REG_IDs;
+		if ( ! empty($REG_IDs)) {
+			$success = true;
+			// set default status if none is passed
+			$status = $status ? $status : EEM_Registration::status_id_pending_payment;
+			// sanitize $REG_IDs
+			$REG_IDs = array_filter($REG_IDs, 'absint');
+			//loop through REG_ID's and change status
+			foreach ($REG_IDs as $REG_ID) {
+				$registration = EEM_Registration::instance()->get_one_by_ID($REG_ID);
+				if ($registration instanceof EE_Registration) {
+					$registration->set_status($status);
+					$result = $registration->save();
+					// verifying explicit fails because update *may* just return 0 for 0 rows affected
+					$success = $result !== false ? $success : false;
+				}
+			}
+		}
+		//reset _req_data['_REG_ID'] for any potential future messages notifications
+		$this->_req_data['_REG_ID'] = $REG_IDs;
+		//return $success and processed registrations
+		return array('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
+	 */
+	protected function _reg_status_change_return($STS_ID, $notify = false)
+	{
+		$result = ! empty($STS_ID) ? $this->_set_registration_status_from_request($STS_ID, $notify)
+			: array('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(__('Registration status has been set to %s', 'event_espresso'),
+					EEH_Template::pretty_status($STS_ID, false, 'lower'));
+			} else {
+				$msg = sprintf(__('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(__('Something went wrong, and the status was not changed', 'event_espresso'), __FILE__,
+				__LINE__, __FUNCTION__);
+		}
+		if (isset($this->_req_data['return']) && $this->_req_data['return'] == 'view_registration') {
+			$route = array('action' => 'view_registration', '_REG_ID' => reset($result['REG_ID']));
+		} else {
+			$route = array('action' => 'default');
+		}
+		//unset nonces
+		foreach ($this->_req_data as $ref => $value) {
+			if (strpos($ref, 'nonce') !== false) {
+				unset($this->_req_data[$ref]);
+				continue;
+			}
+			$value = is_array($value) ? array_map('urlencode', $value) : urlencode($value);
+			$this->_req_data[$ref] = $value;
+		}
+		//merge request vars so that the reloaded list table contains any existing filter query params
+		$route = array_merge($this->_req_data, $route);
+		$this->_redirect_after_action($success, '', '', $route, true);
+	}
+
+
+
+	/**
+	 * incoming reg status change from reg details page.
+	 *
+	 * @return void
+	 */
+	protected function _change_reg_status()
+	{
+		$this->_req_data['return'] = 'view_registration';
+		//set notify based on whether the send notifications toggle is set or not
+		$notify = ! empty($this->_req_data['reg_status_change_form']['send_notifications']);
+		//$notify = ! empty( $this->_req_data['txn_reg_status_change']['send_notifications'] );
+		$this->_req_data['reg_status_change_form']['reg_status'] = isset($this->_req_data['reg_status_change_form']['reg_status'])
+			? $this->_req_data['reg_status_change_form']['reg_status'] : '';
+		switch ($this->_req_data['reg_status_change_form']['reg_status']) {
+			case EEM_Registration::status_id_approved :
+			case EEH_Template::pretty_status(EEM_Registration::status_id_approved, false, 'sentence') :
+				$this->approve_registration($notify);
+				break;
+			case EEM_Registration::status_id_pending_payment :
+			case EEH_Template::pretty_status(EEM_Registration::status_id_pending_payment, false, 'sentence') :
+				$this->pending_registration($notify);
+				break;
+			case EEM_Registration::status_id_not_approved :
+			case EEH_Template::pretty_status(EEM_Registration::status_id_not_approved, false, 'sentence') :
+				$this->not_approve_registration($notify);
+				break;
+			case EEM_Registration::status_id_declined :
+			case EEH_Template::pretty_status(EEM_Registration::status_id_declined, false, 'sentence') :
+				$this->decline_registration($notify);
+				break;
+			case EEM_Registration::status_id_cancelled :
+			case EEH_Template::pretty_status(EEM_Registration::status_id_cancelled, false, 'sentence') :
+				$this->cancel_registration($notify);
+				break;
+			case EEM_Registration::status_id_wait_list :
+			case EEH_Template::pretty_status(EEM_Registration::status_id_wait_list, false, 'sentence') :
+				$this->waitlist_registration($notify);
+				break;
+			case EEM_Registration::status_id_incomplete :
+			default :
+				$result['success'] = false;
+				unset($this->_req_data['return']);
+				$this->_reg_status_change_return('', false);
+				break;
+		}
+	}
+
+
+
+	/**
+	 * approve_registration
+	 *
+	 * @access protected
+	 * @param bool $notify whether or not to notify the registrant about their approval.
+	 * @return void
+	 */
+	protected function approve_registration($notify = false)
+	{
+		$this->_reg_status_change_return(EEM_Registration::status_id_approved, $notify);
+	}
+
+
+
+	/**
+	 *        decline_registration
+	 *
+	 * @access protected
+	 * @param bool $notify whether or not to notify the registrant about their status change.
+	 * @return void
+	 */
+	protected function decline_registration($notify = false)
+	{
+		$this->_reg_status_change_return(EEM_Registration::status_id_declined, $notify);
+	}
+
+
+
+	/**
+	 *        cancel_registration
+	 *
+	 * @access protected
+	 * @param bool $notify whether or not to notify the registrant about their status change.
+	 * @return void
+	 */
+	protected function cancel_registration($notify = false)
+	{
+		$this->_reg_status_change_return(EEM_Registration::status_id_cancelled, $notify);
+	}
+
+
+
+	/**
+	 *        not_approve_registration
+	 *
+	 * @access protected
+	 * @param bool $notify whether or not to notify the registrant about their status change.
+	 * @return void
+	 */
+	protected function not_approve_registration($notify = false)
+	{
+		$this->_reg_status_change_return(EEM_Registration::status_id_not_approved, $notify);
+	}
+
+
+
+	/**
+	 *        decline_registration
+	 *
+	 * @access protected
+	 * @param bool $notify whether or not to notify the registrant about their status change.
+	 * @return void
+	 */
+	protected function pending_registration($notify = false)
+	{
+		$this->_reg_status_change_return(EEM_Registration::status_id_pending_payment, $notify);
+	}
+
+
+
+	/**
+	 * waitlist_registration
+	 *
+	 * @access protected
+	 * @param bool $notify whether or not to notify the registrant about their status change.
+	 * @return void
+	 */
+	protected function waitlist_registration($notify = false)
+	{
+		$this->_reg_status_change_return(EEM_Registration::status_id_wait_list, $notify);
+	}
+
+
+
+	/**
+	 *        generates HTML for the Registration main meta box
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function _reg_details_meta_box()
+	{
+		EEH_Autoloader::register_line_item_display_autoloaders();
+		EEH_Autoloader::register_line_item_filter_autoloaders();
+		EE_Registry::instance()->load_helper('Line_Item');
+		$transaction = $this->_registration->transaction() ? $this->_registration->transaction()
+			: EE_Transaction::new_instance();
+		$this->_session = $transaction->session_data();
+		$filters = new EE_Line_Item_Filter_Collection();
+		//$filters->add( new EE_Non_Zero_Line_Item_Filter() );
+		$filters->add(new EE_Single_Registration_Line_Item_Filter($this->_registration));
+		$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,
+			array('EE_Registration' => $this->_registration));
+		$attendee = $this->_registration->attendee();
+		if (EE_Registry::instance()->CAP->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(array(
+				'action' => 'view_transaction',
+				'TXN_ID' => $transaction->ID(),
+			), TXN_ADMIN_URL), esc_html__(' View Transaction'), 'button secondary-button right',
+				'dashicons dashicons-cart');
+		} else {
+			$this->_template_args['view_transaction_button'] = '';
+		}
+		if ($attendee instanceof EE_Attendee
+			&& EE_Registry::instance()->CAP->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(array(
+				'action'      => 'resend_registration',
+				'_REG_ID'     => $this->_registration->ID(),
+				'redirect_to' => 'view_registration',
+			), REG_ADMIN_URL), esc_html__(' Resend Registration'), 'button secondary-button 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 = array(
+			'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'           => isset($this->_session['ip_address']) ? $this->_session['ip_address'] : '',
+			'user_agent'           => isset($this->_session['user_agent']) ? $this->_session['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'] = __('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'] = __('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'] = __('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'] = __('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'] = __('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'] = __('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(array(
+			'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';
+		echo EEH_Template::display_template($template_path, $this->_template_args, true);
+	}
+
+
+
+	/**
+	 * 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
+	 *
+	 * @access public
+	 * @return void
+	 */
+	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';
+			echo EEH_Template::display_template($template_path, $this->_template_args, true);
+		}
+	}
+
+
+
+	/**
+	 * form_before_question_group
+	 *
+	 * @deprecated    as of 4.8.32.rc.000
+	 * @access        public
+	 * @param        string $output
+	 * @return        string
+	 */
+	public function form_before_question_group($output)
+	{
+		EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
+			__('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
-     *
-     * @deprecated    as of 4.8.32.rc.000
-     * @access        public
-     * @param        string $output
-     * @return        string
-     */
-    public function form_after_question_group($output)
-    {
-        EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
-            __('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
+	 *
+	 * @deprecated    as of 4.8.32.rc.000
+	 * @access        public
+	 * @param        string $output
+	 * @return        string
+	 */
+	public function form_after_question_group($output)
+	{
+		EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
+			__('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="#" title="'
-               . 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">'
-               . __('edit the above question group', 'event_espresso')
-               . '</span>
+			   . __('edit the above question group', 'event_espresso')
+			   . '</span>
 						<div class="dashicons dashicons-edit"></div>
 					</a>
 				</td>
@@ -1797,506 +1797,506 @@ 
 		</tbody>
 	</table>
 ';
-    }
-
-
-
-    /**
-     * form_form_field_label_wrap
-     *
-     * @deprecated    as of 4.8.32.rc.000
-     * @access        public
-     * @param        string $label
-     * @return        string
-     */
-    public function form_form_field_label_wrap($label)
-    {
-        EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
-            __('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
+	 *
+	 * @deprecated    as of 4.8.32.rc.000
+	 * @access        public
+	 * @param        string $label
+	 * @return        string
+	 */
+	public function form_form_field_label_wrap($label)
+	{
+		EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
+			__('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
-     *
-     * @deprecated    as of 4.8.32.rc.000
-     * @access        public
-     * @param        string $input
-     * @return        string
-     */
-    public function form_form_field_input__wrap($input)
-    {
-        EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
-            __('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
+	 *
+	 * @deprecated    as of 4.8.32.rc.000
+	 * @access        public
+	 * @param        string $input
+	 * @return        string
+	 */
+	public function form_form_field_input__wrap($input)
+	{
+		EE_Error::doing_it_wrong(__CLASS__ . '::' . __FUNCTION__,
+			__('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
-     *
-     * @access protected
-     * @return void
-     */
-    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 = isset($this->_req_data['_REG_ID']) ? absint($this->_req_data['_REG_ID']) : false;
-            $success = $this->_save_reg_custom_questions_form($REG_ID);
-            if ($success) {
-                $what = __('Registration Form', 'event_espresso');
-                $route = $REG_ID ? array('action' => 'view_registration', '_REG_ID' => $REG_ID)
-                    : array('action' => 'default');
-                $this->_redirect_after_action($success, $what, __('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
-     */
-    protected function _get_reg_custom_questions_form($REG_ID)
-    {
-        if ( ! $this->_reg_custom_questions_form) {
-            require_once(REG_ADMIN . 'form_sections' . DS . 'EE_Registration_Custom_Questions_Form.form.php');
-            $this->_reg_custom_questions_form = new EE_Registration_Custom_Questions_Form(EEM_Registration::instance()
-                                                                                                          ->get_one_by_ID($REG_ID));
-            $this->_reg_custom_questions_form->_construct_finalize(null, null);
-        }
-        return $this->_reg_custom_questions_form;
-    }
-
-
-
-    /**
-     * Saves
-     *
-     * @access private
-     * @param bool $REG_ID
-     * @return bool
-     */
-    private function _save_reg_custom_questions_form($REG_ID = false)
-    {
-        if ( ! $REG_ID) {
-            EE_Error::add_error(__('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->_req_data);
-        $success = false;
-        if ($form->is_valid()) {
-            foreach ($form->subforms() as $question_group_id => $question_group_form) {
-                foreach ($question_group_form->inputs() as $question_id => $input) {
-                    $where_conditions = array(
-                        'QST_ID' => $question_id,
-                        'REG_ID' => $REG_ID,
-                    );
-                    $possibly_new_values = array(
-                        'ANS_value' => $input->normalized_value(),
-                    );
-                    $answer = EEM_Answer::instance()->get_one(array($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
-     *
-     * @access public
-     * @return void
-     */
-    public function _reg_attendees_meta_box()
-    {
-        $REG = EEM_Registration::instance();
-        //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(array(
-            array(
-                'TXN_ID' => $this->_registration->transaction_ID(),
-                'REG_ID' => array('!=', $this->_registration->ID()),
-            ),
-            'force_join' => array('Attendee'),
-        ));
-        $this->_template_args['attendees'] = array();
-        $this->_template_args['attendee_notice'] = '';
-        if (empty($registrations)
-            || (is_array($registrations)
-                && ! EEH_Array::get_one_item_from_array($registrations))
-        ) {
-            EE_Error::add_error(__('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()
-                    : EEM_Attendee::instance()
-                                  ->create_default_object();
-                $this->_template_args['attendees'][$att_nmbr]['STS_ID'] = $registration->status_ID();
-                $this->_template_args['attendees'][$att_nmbr]['fname'] = $attendee->fname();//( isset( $registration->ATT_fname ) & ! empty( $registration->ATT_fname ) ) ? $registration->ATT_fname : '';
-                $this->_template_args['attendees'][$att_nmbr]['lname'] = $attendee->lname();//( isset( $registration->ATT_lname ) & ! empty( $registration->ATT_lname ) ) ? $registration->ATT_lname : '';
-                $this->_template_args['attendees'][$att_nmbr]['email'] = $attendee->email();//( isset( $registration->ATT_email ) & ! empty( $registration->ATT_email ) ) ? $registration->ATT_email : '';
-                $this->_template_args['attendees'][$att_nmbr]['final_price'] = $registration->final_price();//( isset( $registration->REG_final_price ) & ! empty( $registration->REG_final_price ) ) ? $registration->REG_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(array(
-                    'action' => 'edit_attendee',
-                    'post'   => $attendee->ID(),
-                ), REG_ADMIN_URL);
-                $this->_template_args['attendees'][$att_nmbr]['event_name'] = $registration->event_obj()->name();
-                $att_nmbr++;
-            }
-            //EEH_Debug_Tools::printr( $attendees, '$attendees  <br /><span style="font-size:10px;font-weight:normal;">( file: '. __FILE__ . ' - line no: ' . __LINE__ . ' )</span>', 'auto' );
-            $this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
-            //			$this->_template_args['registration_form_url'] = add_query_arg( array( 'action' => 'edit_registration', 'process' => 'attendees'  ), REG_ADMIN_URL );
-        }
-        $template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_attendees.template.php';
-        echo EEH_Template::display_template($template_path, $this->_template_args, true);
-    }
-
-
-
-    /**
-     *        generates HTML for the Edit Registration side meta box
-     *
-     * @access public
-     * @return void
-     */
-    public function _reg_registrant_side_meta_box()
-    {
-        /*@var $attendee EE_Attendee */
-        $att_check = $this->_registration->attendee();
-        $attendee = $att_check instanceof EE_Attendee ? $att_check : EEM_Attendee::instance()->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->_registration->ATT_fname;
-        $this->_template_args['lname'] = $attendee->lname();//$this->_registration->ATT_lname;
-        $this->_template_args['email'] = $attendee->email();//$this->_registration->ATT_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(array(
-            'action' => 'edit_attendee',
-            'post'   => $attendee->ID(),
-        ), REG_ADMIN_URL);
-        $this->_template_args['att_edit_label'] = __('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(array(
-                'action'  => 'duplicate_attendee',
-                '_REG_ID' => $this->_registration->ID(),
-            ), REG_ADMIN_URL) : '';
-        $this->_template_args['create_label'] = __('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';
-        echo EEH_Template::display_template($template_path, $this->_template_args, true);
-    }
-
-
-
-    /**
-     * trash or restore registrations
-     *
-     * @param  boolean $trash whether to archive or restore
-     * @access protected
-     * @return void
-     */
-    protected function _trash_or_restore_registrations($trash = true)
-    {
-        $REGM = EEM_Registration::instance();
-        $success = 1;
-        $error = 0;
-        $tickets = array();
-        $dtts = array();
-        //if empty _REG_ID then get out because there's nothing to do
-        if (empty($this->_req_data['_REG_ID'])) {
-            $msg = $trash
-                ? __('In order to trash registrations you must select which ones you wish to trash by clicking the checkboxes.',
-                    'event_espresso')
-                : __('In order to restore registrations you must select which ones you wish to restore by clicking the checkboxes.',
-                    'event_espresso');
-            EE_Error::add_error($msg, __FILE__, __LINE__, __FUNCTION__);
-            $this->_redirect_after_action(false, '', '', array(), true);
-        }
-        //Checkboxes
-        if ( ! empty($this->_req_data['_REG_ID']) && is_array($this->_req_data['_REG_ID'])) {
-            // if array has more than one element than success message should be plural
-            $success = count($this->_req_data['_REG_ID']) > 1 ? 2 : 1;
-            // cycle thru checkboxes
-            while (list($ind, $REG_ID) = each($this->_req_data['_REG_ID'])) {
-                /** @var EE_Registration $REG */
-                $REG = $REGM->get_one_by_ID($REG_ID);
-                $payment_count = $REG->get_first_related('Transaction')->count_related('Payment');
-                if ($payment_count > 0) {
-                    $name = $REG->attendee() instanceof EE_Attendee ? $REG->attendee()->full_name()
-                        : __('Unknown Attendee', 'event_espresso');
-                    $error = 1;
-                    $success = 0;
-                    EE_Error::add_error(sprintf(__('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__);
-                    continue; //can't trash this registration because it has payments.
-                }
-                $ticket = $REG->get_first_related('Ticket');
-                $tickets[$ticket->ID()] = $ticket;
-                $dtt = $ticket->get_many_related('Datetime');
-                $dtts = array_merge($dtts, $dtt);
-                $updated = $trash ? $REG->delete() : $REG->restore();
-                if ( ! $updated) {
-                    $success = 0;
-                } else {
-                    $success = 2;
-                }/**/
-            }
-        } else {
-            // grab single id and delete
-            $REG_ID = absint($this->_req_data['_REG_ID']);
-            $REG = $REGM->get_one_by_ID($REG_ID);
-            $ticket = $REG->get_first_related('Ticket');
-            $tickets[$ticket->ID()] = $ticket;
-            $dtts = $ticket->get_many_related('Datetime');
-            $updated = $trash ? $REG->delete() : $REG->restore();
-            if ( ! $updated) {
-                $success = 0;
-            }
-        }
-        //now let's update counts
-        EEM_Ticket::instance()->update_tickets_sold($tickets);
-        EEM_Datetime::instance()->update_sold($dtts);
-        $what = $success > 1 ? __('Registrations', 'event_espresso') : __('Registration', 'event_espresso');
-        $action_desc = $trash ? __('moved to the trash', 'event_espresso') : __('restored', 'event_espresso');
-        $overwrite_msgs = $error ? true : false;
-        $this->_redirect_after_action($success, $what, $action_desc, array('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 Checkins.
-     *
-     * @return void
-     */
-    protected function _delete_registrations()
-    {
-        $REG_MDL = EEM_Registration::instance();
-        $success = 1;
-        //Checkboxes
-        if ( ! empty($this->_req_data['_REG_ID']) && is_array($this->_req_data['_REG_ID'])) {
-            // if array has more than one element than success message should be plural
-            $success = count($this->_req_data['_REG_ID']) > 1 ? 2 : 1;
-            // cycle thru checkboxes
-            while (list($ind, $REG_ID) = each($this->_req_data['_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;
-                }
-            }
-        } else {
-            // grab single id and delete
-            $REG_ID = $this->_req_data['_REG_ID'];
-            $REG = $REG_MDL->get_one_by_ID($REG_ID);
-            $deleted = $this->_delete_registration($REG);
-            if ( ! $deleted) {
-                $success = 0;
-            }
-        }
-        $what = $success > 1 ? __('Registrations', 'event_espresso') : __('Registration', 'event_espresso');
-        $action_desc = __('permanently deleted.', 'event_espresso');
-        $this->_redirect_after_action($success, $what, $action_desc, array('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 permenantly
-     * @return boolean              true = successful deletion, false = fail.
-     */
-    protected function _delete_registration(EE_Registration $REG)
-    {
-        //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->get_first_related('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(__('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
-     *
-     * @access private
-     * @throws \EE_Error
-     * @return void
-     */
-    public function new_registration()
-    {
-        if ( ! $this->_set_reg_event()) {
-            throw new EE_Error(__('Unable to continue with registering because there is no Event ID in the request',
-                'event_espresso'));
-        }
-        EE_Registry::instance()->REQ->set_espresso_page(true);
-        // gotta start with a clean slate if we're not coming here via ajax
-        if ( ! defined('DOING_AJAX')
-             && ( ! isset($this->_req_data['processing_registration']) || isset($this->_req_data['step_error']))
-        ) {
-            EE_Registry::instance()->SSN->clear_session(__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(array(
-                'action' => 'edit',
-                'post'   => $this->_reg_event->ID(),
-            ), EVENTS_ADMIN_URL);
-            $edit_event_lnk = '<a href="'
-                              . $edit_event_url
-                              . '" title="'
-                              . esc_attr__('Edit ', 'event_espresso')
-                              . $this->_reg_event->name()
-                              . '">'
-                              . __('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 (defined('DOING_AJAX')) {
-            $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
-     *
-     * @access protected
-     * @return string html
-     */
-    protected function _get_registration_step_content()
-    {
-        if (isset($_COOKIE['ee_registration_added']) && $_COOKIE['ee_registration_added']) {
-            $warning_msg = sprintf(__('%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
+	 *
+	 * @access protected
+	 * @return void
+	 */
+	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 = isset($this->_req_data['_REG_ID']) ? absint($this->_req_data['_REG_ID']) : false;
+			$success = $this->_save_reg_custom_questions_form($REG_ID);
+			if ($success) {
+				$what = __('Registration Form', 'event_espresso');
+				$route = $REG_ID ? array('action' => 'view_registration', '_REG_ID' => $REG_ID)
+					: array('action' => 'default');
+				$this->_redirect_after_action($success, $what, __('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
+	 */
+	protected function _get_reg_custom_questions_form($REG_ID)
+	{
+		if ( ! $this->_reg_custom_questions_form) {
+			require_once(REG_ADMIN . 'form_sections' . DS . 'EE_Registration_Custom_Questions_Form.form.php');
+			$this->_reg_custom_questions_form = new EE_Registration_Custom_Questions_Form(EEM_Registration::instance()
+																										  ->get_one_by_ID($REG_ID));
+			$this->_reg_custom_questions_form->_construct_finalize(null, null);
+		}
+		return $this->_reg_custom_questions_form;
+	}
+
+
+
+	/**
+	 * Saves
+	 *
+	 * @access private
+	 * @param bool $REG_ID
+	 * @return bool
+	 */
+	private function _save_reg_custom_questions_form($REG_ID = false)
+	{
+		if ( ! $REG_ID) {
+			EE_Error::add_error(__('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->_req_data);
+		$success = false;
+		if ($form->is_valid()) {
+			foreach ($form->subforms() as $question_group_id => $question_group_form) {
+				foreach ($question_group_form->inputs() as $question_id => $input) {
+					$where_conditions = array(
+						'QST_ID' => $question_id,
+						'REG_ID' => $REG_ID,
+					);
+					$possibly_new_values = array(
+						'ANS_value' => $input->normalized_value(),
+					);
+					$answer = EEM_Answer::instance()->get_one(array($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
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function _reg_attendees_meta_box()
+	{
+		$REG = EEM_Registration::instance();
+		//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(array(
+			array(
+				'TXN_ID' => $this->_registration->transaction_ID(),
+				'REG_ID' => array('!=', $this->_registration->ID()),
+			),
+			'force_join' => array('Attendee'),
+		));
+		$this->_template_args['attendees'] = array();
+		$this->_template_args['attendee_notice'] = '';
+		if (empty($registrations)
+			|| (is_array($registrations)
+				&& ! EEH_Array::get_one_item_from_array($registrations))
+		) {
+			EE_Error::add_error(__('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()
+					: EEM_Attendee::instance()
+								  ->create_default_object();
+				$this->_template_args['attendees'][$att_nmbr]['STS_ID'] = $registration->status_ID();
+				$this->_template_args['attendees'][$att_nmbr]['fname'] = $attendee->fname();//( isset( $registration->ATT_fname ) & ! empty( $registration->ATT_fname ) ) ? $registration->ATT_fname : '';
+				$this->_template_args['attendees'][$att_nmbr]['lname'] = $attendee->lname();//( isset( $registration->ATT_lname ) & ! empty( $registration->ATT_lname ) ) ? $registration->ATT_lname : '';
+				$this->_template_args['attendees'][$att_nmbr]['email'] = $attendee->email();//( isset( $registration->ATT_email ) & ! empty( $registration->ATT_email ) ) ? $registration->ATT_email : '';
+				$this->_template_args['attendees'][$att_nmbr]['final_price'] = $registration->final_price();//( isset( $registration->REG_final_price ) & ! empty( $registration->REG_final_price ) ) ? $registration->REG_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(array(
+					'action' => 'edit_attendee',
+					'post'   => $attendee->ID(),
+				), REG_ADMIN_URL);
+				$this->_template_args['attendees'][$att_nmbr]['event_name'] = $registration->event_obj()->name();
+				$att_nmbr++;
+			}
+			//EEH_Debug_Tools::printr( $attendees, '$attendees  <br /><span style="font-size:10px;font-weight:normal;">( file: '. __FILE__ . ' - line no: ' . __LINE__ . ' )</span>', 'auto' );
+			$this->_template_args['currency_sign'] = EE_Registry::instance()->CFG->currency->sign;
+			//			$this->_template_args['registration_form_url'] = add_query_arg( array( 'action' => 'edit_registration', 'process' => 'attendees'  ), REG_ADMIN_URL );
+		}
+		$template_path = REG_TEMPLATE_PATH . 'reg_admin_details_main_meta_box_attendees.template.php';
+		echo EEH_Template::display_template($template_path, $this->_template_args, true);
+	}
+
+
+
+	/**
+	 *        generates HTML for the Edit Registration side meta box
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function _reg_registrant_side_meta_box()
+	{
+		/*@var $attendee EE_Attendee */
+		$att_check = $this->_registration->attendee();
+		$attendee = $att_check instanceof EE_Attendee ? $att_check : EEM_Attendee::instance()->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->_registration->ATT_fname;
+		$this->_template_args['lname'] = $attendee->lname();//$this->_registration->ATT_lname;
+		$this->_template_args['email'] = $attendee->email();//$this->_registration->ATT_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(array(
+			'action' => 'edit_attendee',
+			'post'   => $attendee->ID(),
+		), REG_ADMIN_URL);
+		$this->_template_args['att_edit_label'] = __('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(array(
+				'action'  => 'duplicate_attendee',
+				'_REG_ID' => $this->_registration->ID(),
+			), REG_ADMIN_URL) : '';
+		$this->_template_args['create_label'] = __('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';
+		echo EEH_Template::display_template($template_path, $this->_template_args, true);
+	}
+
+
+
+	/**
+	 * trash or restore registrations
+	 *
+	 * @param  boolean $trash whether to archive or restore
+	 * @access protected
+	 * @return void
+	 */
+	protected function _trash_or_restore_registrations($trash = true)
+	{
+		$REGM = EEM_Registration::instance();
+		$success = 1;
+		$error = 0;
+		$tickets = array();
+		$dtts = array();
+		//if empty _REG_ID then get out because there's nothing to do
+		if (empty($this->_req_data['_REG_ID'])) {
+			$msg = $trash
+				? __('In order to trash registrations you must select which ones you wish to trash by clicking the checkboxes.',
+					'event_espresso')
+				: __('In order to restore registrations you must select which ones you wish to restore by clicking the checkboxes.',
+					'event_espresso');
+			EE_Error::add_error($msg, __FILE__, __LINE__, __FUNCTION__);
+			$this->_redirect_after_action(false, '', '', array(), true);
+		}
+		//Checkboxes
+		if ( ! empty($this->_req_data['_REG_ID']) && is_array($this->_req_data['_REG_ID'])) {
+			// if array has more than one element than success message should be plural
+			$success = count($this->_req_data['_REG_ID']) > 1 ? 2 : 1;
+			// cycle thru checkboxes
+			while (list($ind, $REG_ID) = each($this->_req_data['_REG_ID'])) {
+				/** @var EE_Registration $REG */
+				$REG = $REGM->get_one_by_ID($REG_ID);
+				$payment_count = $REG->get_first_related('Transaction')->count_related('Payment');
+				if ($payment_count > 0) {
+					$name = $REG->attendee() instanceof EE_Attendee ? $REG->attendee()->full_name()
+						: __('Unknown Attendee', 'event_espresso');
+					$error = 1;
+					$success = 0;
+					EE_Error::add_error(sprintf(__('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__);
+					continue; //can't trash this registration because it has payments.
+				}
+				$ticket = $REG->get_first_related('Ticket');
+				$tickets[$ticket->ID()] = $ticket;
+				$dtt = $ticket->get_many_related('Datetime');
+				$dtts = array_merge($dtts, $dtt);
+				$updated = $trash ? $REG->delete() : $REG->restore();
+				if ( ! $updated) {
+					$success = 0;
+				} else {
+					$success = 2;
+				}/**/
+			}
+		} else {
+			// grab single id and delete
+			$REG_ID = absint($this->_req_data['_REG_ID']);
+			$REG = $REGM->get_one_by_ID($REG_ID);
+			$ticket = $REG->get_first_related('Ticket');
+			$tickets[$ticket->ID()] = $ticket;
+			$dtts = $ticket->get_many_related('Datetime');
+			$updated = $trash ? $REG->delete() : $REG->restore();
+			if ( ! $updated) {
+				$success = 0;
+			}
+		}
+		//now let's update counts
+		EEM_Ticket::instance()->update_tickets_sold($tickets);
+		EEM_Datetime::instance()->update_sold($dtts);
+		$what = $success > 1 ? __('Registrations', 'event_espresso') : __('Registration', 'event_espresso');
+		$action_desc = $trash ? __('moved to the trash', 'event_espresso') : __('restored', 'event_espresso');
+		$overwrite_msgs = $error ? true : false;
+		$this->_redirect_after_action($success, $what, $action_desc, array('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 Checkins.
+	 *
+	 * @return void
+	 */
+	protected function _delete_registrations()
+	{
+		$REG_MDL = EEM_Registration::instance();
+		$success = 1;
+		//Checkboxes
+		if ( ! empty($this->_req_data['_REG_ID']) && is_array($this->_req_data['_REG_ID'])) {
+			// if array has more than one element than success message should be plural
+			$success = count($this->_req_data['_REG_ID']) > 1 ? 2 : 1;
+			// cycle thru checkboxes
+			while (list($ind, $REG_ID) = each($this->_req_data['_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;
+				}
+			}
+		} else {
+			// grab single id and delete
+			$REG_ID = $this->_req_data['_REG_ID'];
+			$REG = $REG_MDL->get_one_by_ID($REG_ID);
+			$deleted = $this->_delete_registration($REG);
+			if ( ! $deleted) {
+				$success = 0;
+			}
+		}
+		$what = $success > 1 ? __('Registrations', 'event_espresso') : __('Registration', 'event_espresso');
+		$action_desc = __('permanently deleted.', 'event_espresso');
+		$this->_redirect_after_action($success, $what, $action_desc, array('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 permenantly
+	 * @return boolean              true = successful deletion, false = fail.
+	 */
+	protected function _delete_registration(EE_Registration $REG)
+	{
+		//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->get_first_related('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(__('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
+	 *
+	 * @access private
+	 * @throws \EE_Error
+	 * @return void
+	 */
+	public function new_registration()
+	{
+		if ( ! $this->_set_reg_event()) {
+			throw new EE_Error(__('Unable to continue with registering because there is no Event ID in the request',
+				'event_espresso'));
+		}
+		EE_Registry::instance()->REQ->set_espresso_page(true);
+		// gotta start with a clean slate if we're not coming here via ajax
+		if ( ! defined('DOING_AJAX')
+			 && ( ! isset($this->_req_data['processing_registration']) || isset($this->_req_data['step_error']))
+		) {
+			EE_Registry::instance()->SSN->clear_session(__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(array(
+				'action' => 'edit',
+				'post'   => $this->_reg_event->ID(),
+			), EVENTS_ADMIN_URL);
+			$edit_event_lnk = '<a href="'
+							  . $edit_event_url
+							  . '" title="'
+							  . esc_attr__('Edit ', 'event_espresso')
+							  . $this->_reg_event->name()
+							  . '">'
+							  . __('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 (defined('DOING_AJAX')) {
+			$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
+	 *
+	 * @access protected
+	 * @return string html
+	 */
+	protected function _get_registration_step_content()
+	{
+		if (isset($_COOKIE['ee_registration_added']) && $_COOKIE['ee_registration_added']) {
+			$warning_msg = sprintf(__('%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
@@ -2309,646 +2309,646 @@ 
 	        }
 	    }, 800 );
 	</script >';
-        }
-        $template_args = array(
-            'title'                    => '',
-            'content'                  => '',
-            'step_button_text'         => '',
-            'show_notification_toggle' => false,
-        );
-        //to indicate we're processing a new registration
-        $hidden_fields = array(
-            'processing_registration' => array(
-                'type'  => 'hidden',
-                'value' => 0,
-            ),
-            'event_id'                => array(
-                'type'  => 'hidden',
-                'value' => $this->_reg_event->ID(),
-            ),
-        );
-        //if the cart is empty then we know we're at step one so we'll display ticket selector
-        $cart = EE_Registry::instance()->SSN->cart();
-        $step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
-        switch ($step) {
-            case 'ticket' :
-                $hidden_fields['processing_registration']['value'] = 1;
-                $template_args['title'] = __('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['step_button_text'] = __('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'] = __('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 setup properly by the first process_reg_step run.
-                $template_args['content'] = EED_Single_Page_Checkout::registration_checkout_for_admin();
-                $template_args['step_button_text'] = __('Save Registration and Continue to Details', 'event_espresso');
-                $template_args['show_notification_toggle'] = true;
-                break;
-        }
-        $this->_set_add_edit_form_tags('process_reg_step',
-            $hidden_fields); //we come back to the process_registration_step route.
-        return EEH_Template::display_template(REG_TEMPLATE_PATH
-                                              . 'reg_admin_register_new_attendee_step_content.template.php',
-            $template_args, true);
-    }
-
-
-
-    /**
-     *        set_reg_event
-     *
-     * @access private
-     * @return boolean
-     */
-    private function _set_reg_event()
-    {
-        if (is_object($this->_reg_event)) {
-            return true;
-        }
-        $EVT_ID = ( ! empty($this->_req_data['event_id'])) ? absint($this->_req_data['event_id']) : false;
-        if ( ! $EVT_ID) {
-            return false;
-        }
-        $this->_reg_event = EEM_Event::instance()->get_one_by_ID($EVT_ID);
-        return true;
-    }
-
-
-
-    /**
-     * process_reg_step
-     *
-     * @access        public
-     * @return        string
-     * @throws \RuntimeException
-     * @throws \EE_Error
-     */
-    public function process_reg_step()
-    {
-        EE_System::do_not_cache();
-        $this->_set_reg_event();
-        EE_Registry::instance()->REQ->set_espresso_page(true);
-        EE_Registry::instance()->REQ->set('uts', time());
-        //what step are we on?
-        $cart = EE_Registry::instance()->SSN->cart();
-        $step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
-        //if doing ajax then we need to verify the nonce
-        if (defined('DOING_AJAX')) {
-            $nonce = isset($this->_req_data[$this->_req_nonce])
-                ? sanitize_text_field($this->_req_data[$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 {
-                    $query_args['step_error'] = $this->_req_data['step_error'] = true;
-                }
-                if (defined('DOING_AJAX')) {
-                    $this->new_registration(); //display next step
-                } else {
-                    $query_args = array(
-                        '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 ( ! isset($this->_req_data['txn_reg_status_change'], $this->_req_data['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_cart_grand_total();
-                    if ($grand_total instanceof EE_Line_Item) {
-                        $grand_total->save_this_and_descendants_to_txn();
-                    }
-                }
-                if ( ! $transaction instanceof EE_Transaction) {
-                    $query_args = array(
-                        'action'                  => 'new_registration',
-                        'processing_registration' => 2,
-                        'event_id'                => $this->_reg_event->ID(),
-                        'uts'                     => time(),
-                    );
-                    if (defined('DOING_AJAX')) {
-                        //display registration form again because there are errors (maybe validation?)
-                        $this->new_registration();
-                        return;
-                    } else {
-                        $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();
-                }
-                EE_Registry::instance()->SSN->clear_session(__CLASS__, __FUNCTION__);
-                $this->_req_data = array();
-                $query_args = array(
-                    '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
-     *
-     * @access public
-     * @return void
-     */
-    public function redirect_to_txn()
-    {
-        EE_System::do_not_cache();
-        EE_Registry::instance()->SSN->clear_session(__CLASS__, __FUNCTION__);
-        $query_args = array(
-            'action' => 'view_transaction',
-            'TXN_ID' => isset($this->_req_data['TXN_ID']) ? absint($this->_req_data['TXN_ID']) : 0,
-            'page'   => 'espresso_transactions',
-        );
-        if (isset($this->_req_data['EVT_ID'], $this->_req_data['redirect_from'])) {
-            $query_args['EVT_ID'] = $this->_req_data['EVT_ID'];
-            $query_args['event_name'] = urlencode($this->_req_data['event_name']);
-            $query_args['redirect_from'] = $this->_req_data['redirect_from'];
-        }
-        EE_Error::add_success(__('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
-     *
-     * @access protected
-     * @return void
-     */
-    protected function _attendee_contact_list_table()
-    {
-        do_action('AHEE_log', __FILE__, __FUNCTION__, '');
-        $this->_search_btn_label = __('Contacts', 'event_espresso');
-        $this->display_admin_list_table_page_with_no_sidebar();
-    }
-
-
-
-    /**
-     *        get_attendees
-     *
-     * @param bool $count whether to return count or data.
-     * @access public
-     * @return array
-     */
-    public function get_attendees($per_page, $count = false, $trash = false)
-    {
-        do_action('AHEE_log', __FILE__, __FUNCTION__, '');
-        require_once(REG_ADMIN . 'EE_Attendee_Contact_List_Table.class.php');
-        $ATT_MDL = EEM_Attendee::instance();
-        $this->_req_data['orderby'] = ! empty($this->_req_data['orderby']) ? $this->_req_data['orderby'] : '';
-        switch ($this->_req_data['orderby']) {
-            case 'ATT_ID':
-                $orderby = 'ATT_ID';
-                break;
-            case 'ATT_fname':
-                $orderby = 'ATT_fname';
-                break;
-            case 'ATT_email':
-                $orderby = 'ATT_email';
-                break;
-            case 'ATT_city':
-                $orderby = 'ATT_city';
-                break;
-            case 'STA_ID':
-                $orderby = 'STA_ID';
-                break;
-            case 'CNT_ID':
-                $orderby = 'CNT_ID';
-                break;
-            default:
-                $orderby = 'ATT_lname';
-        }
-        $sort = (isset($this->_req_data['order']) && ! empty($this->_req_data['order'])) ? $this->_req_data['order']
-            : 'ASC';
-        $current_page = isset($this->_req_data['paged']) && ! empty($this->_req_data['paged'])
-            ? $this->_req_data['paged'] : 1;
-        $per_page = isset($per_page) && ! empty($per_page) ? $per_page : 10;
-        $per_page = isset($this->_req_data['perpage']) && ! empty($this->_req_data['perpage'])
-            ? $this->_req_data['perpage'] : $per_page;
-        $_where = array();
-        if ( ! empty($this->_req_data['s'])) {
-            $sstr = '%' . $this->_req_data['s'] . '%';
-            $_where['OR'] = array(
-                'Registration.Event.EVT_name'       => array('LIKE', $sstr),
-                'Registration.Event.EVT_desc'       => array('LIKE', $sstr),
-                'Registration.Event.EVT_short_desc' => array('LIKE', $sstr),
-                'ATT_fname'                         => array('LIKE', $sstr),
-                'ATT_lname'                         => array('LIKE', $sstr),
-                'ATT_short_bio'                     => array('LIKE', $sstr),
-                'ATT_email'                         => array('LIKE', $sstr),
-                'ATT_address'                       => array('LIKE', $sstr),
-                'ATT_address2'                      => array('LIKE', $sstr),
-                'ATT_city'                          => array('LIKE', $sstr),
-                'Country.CNT_name'                  => array('LIKE', $sstr),
-                'State.STA_name'                    => array('LIKE', $sstr),
-                'ATT_phone'                         => array('LIKE', $sstr),
-                'Registration.REG_final_price'      => array('LIKE', $sstr),
-                'Registration.REG_code'             => array('LIKE', $sstr),
-                'Registration.REG_count'            => array('LIKE', $sstr),
-                'Registration.REG_group_size'       => array('LIKE', $sstr),
-            );
-        }
-        $offset = ($current_page - 1) * $per_page;
-        $limit = $count ? null : array($offset, $per_page);
-        if ($trash) {
-            $_where['status'] = array('!=', 'publish');
-            $all_attendees = $count
-                ? $ATT_MDL->count(array(
-                    $_where,
-                    'order_by' => array($orderby => $sort),
-                    'limit'    => $limit,
-                ), 'ATT_ID', true)
-                : $ATT_MDL->get_all(array(
-                    $_where,
-                    'order_by' => array($orderby => $sort),
-                    'limit'    => $limit,
-                ));
-        } else {
-            $_where['status'] = array('IN', array('publish'));
-            $all_attendees = $count
-                ? $ATT_MDL->count(array(
-                    $_where,
-                    'order_by' => array($orderby => $sort),
-                    'limit'    => $limit,
-                ), 'ATT_ID', true)
-                : $ATT_MDL->get_all(array(
-                    $_where,
-                    'order_by' => array($orderby => $sort),
-                    'limit'    => $limit,
-                ));
-        }
-        return $all_attendees;
-    }
-
-
-
-    /**
-     * This is just taking care of resending the registration confirmation
-     *
-     * @access protected
-     * @return void
-     */
-    protected function _resend_registration()
-    {
-        $this->_process_resend_registration();
-        $query_args = isset($this->_req_data['redirect_to'])
-            ? array('action' => $this->_req_data['redirect_to'], '_REG_ID' => $this->_req_data['_REG_ID'])
-            : array(
-                'action' => 'default',
-            );
-        $this->_redirect_after_action(false, '', '', $query_args, true);
-    }
-
-
-
-    public function _registrations_report()
-    {
-        if ( ! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
-            wp_redirect(EE_Admin_Page::add_query_args_and_nonce(array(
-                'page'        => 'espresso_batch',
-                'batch'       => 'file',
-                'EVT_ID'      => isset($this->_req_data['EVT_ID']) ? $this->_req_data['EVT_ID'] : null,
-                'job_handler' => urlencode('EventEspressoBatchRequest\JobHandlers\RegistrationsReport'),
-                'return_url'  => urlencode($this->_req_data['return_url']),
-            )));
-        } else {
-            $new_request_args = array(
-                'export' => 'report',
-                'action' => 'registrations_report_for_event',
-                'EVT_ID' => isset($this->_req_data['EVT_ID']) ? $this->_req_data['EVT_ID'] : null,
-            );
-            $this->_req_data = array_merge($this->_req_data, $new_request_args);
-            if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
-                require_once(EE_CLASSES . 'EE_Export.class.php');
-                $EE_Export = EE_Export::instance($this->_req_data);
-                $EE_Export->export();
-            }
-        }
-    }
-
-
-
-    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->_req_data);
-            $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(array(
-                'page'        => 'espresso_batch',
-                'batch'       => 'file',
-                'job_handler' => urlencode('EventEspressoBatchRequest\JobHandlers\AttendeesReport'),
-                'return_url'  => urlencode($this->_req_data['return_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->_req_data);
-                $EE_Export->report_attendees();
-            }
-        }
-    }
-
-
-
-
-
-    /***************************************        ATTENDEE DETAILS        ***************************************/
-    /**
-     * This duplicates the attendee object for the given incoming registration id and attendee_id.
-     *
-     * @return void
-     */
-    protected function _duplicate_attendee()
-    {
-        $action = ! empty($this->_req_data['return']) ? $this->_req_data['return'] : 'default';
-        //verify we have necessary info
-        if (empty($this->_req_data['_REG_ID'])) {
-            EE_Error::add_error(__('Unable to create the contact for the registration because the required parameters are not present (_REG_ID )',
-                'event_espresso'), __FILE__, __LINE__, __FUNCTION__);
-            $query_args = array('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 = EEM_Registration::instance()->get_one_by_ID($this->_req_data['_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(__('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 = array('post' => $new_attendee->ID(), 'action' => 'edit_attendee');
-        $this->_redirect_after_action('', '', '', $query_args, true);
-    }
-
-
-
-    //related to cpt routes
-    protected function _insert_update_cpt_item($post_id, $post)
-    {
-        $success = true;
-        $attendee = EEM_Attendee::instance()->get_one_by_ID($post_id);
-        //for attendee updates
-        if ($post->post_type = 'espresso_attendees' && ! empty($attendee)) {
-            //note we should only be UPDATING attendees at this point.
-            $updated_fields = array(
-                'ATT_fname'     => $this->_req_data['ATT_fname'],
-                'ATT_lname'     => $this->_req_data['ATT_lname'],
-                'ATT_full_name' => $this->_req_data['ATT_fname'] . ' ' . $this->_req_data['ATT_lname'],
-                'ATT_address'   => isset($this->_req_data['ATT_address']) ? $this->_req_data['ATT_address'] : '',
-                'ATT_address2'  => isset($this->_req_data['ATT_address2']) ? $this->_req_data['ATT_address2'] : '',
-                'ATT_city'      => isset($this->_req_data['ATT_city']) ? $this->_req_data['ATT_city'] : '',
-                'STA_ID'        => isset($this->_req_data['STA_ID']) ? $this->_req_data['STA_ID'] : '',
-                'CNT_ISO'       => isset($this->_req_data['CNT_ISO']) ? $this->_req_data['CNT_ISO'] : '',
-                'ATT_zip'       => isset($this->_req_data['ATT_zip']) ? $this->_req_data['ATT_zip'] : '',
-                'ATT_email'     => isset($this->_req_data['ATT_email']) ? $this->_req_data['ATT_email'] : '',
-                'ATT_phone'     => isset($this->_req_data['ATT_phone']) ? $this->_req_data['ATT_phone'] : '',
-            );
-            foreach ($updated_fields as $field => $value) {
-                $attendee->set($field, $value);
-            }
-            $success = $attendee->save();
-            $attendee_update_callbacks = apply_filters('FHEE__Registrations_Admin_Page__insert_update_cpt_item__attendee_update',
-                array());
-            foreach ($attendee_update_callbacks as $a_callback) {
-                if (false === call_user_func_array($a_callback, array($attendee, $this->_req_data))) {
-                    throw new EE_Error(sprintf(__('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(__('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)
-    {
-    }
-
-
-
-    public function attendee_editor_metaboxes()
-    {
-        $this->verify_cpt_object();
-        remove_meta_box('postexcerpt', __('Excerpt'), 'post_excerpt_meta_box', $this->_cpt_routes[$this->_req_action],
-            'normal', 'core');
-        remove_meta_box('commentstatusdiv', $this->_cpt_routes[$this->_req_action], 'normal', 'core');
-        if (post_type_supports('espresso_attendees', 'excerpt')) {
-            add_meta_box('postexcerpt', __('Short Biography', 'event_espresso'), 'post_excerpt_meta_box',
-                $this->_cpt_routes[$this->_req_action], 'normal');
-        }
-        if (post_type_supports('espresso_attendees', 'comments')) {
-            add_meta_box('commentsdiv', __('Notes on the Contact', 'event_espresso'), 'post_comment_meta_box',
-                $this->_cpt_routes[$this->_req_action], 'normal', 'core');
-        }
-        add_meta_box('attendee_contact_info', __('Contact Info', 'event_espresso'),
-            array($this, 'attendee_contact_info'), $this->_cpt_routes[$this->_req_action], 'side', 'core');
-        add_meta_box('attendee_details_address', __('Address Details', 'event_espresso'),
-            array($this, 'attendee_address_details'), $this->_cpt_routes[$this->_req_action], 'normal', 'core');
-        add_meta_box('attendee_registrations', __('Registrations for this Contact', 'event_espresso'),
-            array($this, 'attendee_registrations_meta_box'), $this->_cpt_routes[$this->_req_action], 'normal', 'high');
-    }
-
-
-
-    /**
-     * Metabox for attendee contact info
-     *
-     * @param  WP_Post $post wp post object
-     * @return string        attendee contact info ( and form )
-     */
-    public function attendee_contact_info($post)
-    {
-        //get attendee object ( should already have it )
-        $this->_template_args['attendee'] = $this->_cpt_model_obj;
-        $template = REG_TEMPLATE_PATH . 'attendee_contact_info_metabox_content.template.php';
-        EEH_Template::display_template($template, $this->_template_args);
-    }
-
-
-
-    /**
-     * Metabox for attendee details
-     *
-     * @param  WP_Post $post wp post object
-     * @return string        attendee address details (and form)
-     */
-    public function attendee_address_details($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(array(
-            'QST_ID'           => 0,
-            'QST_display_text' => __('State/Province', 'event_espresso'),
-            'QST_system'       => 'admin-state',
-        )), EE_Answer::new_instance(array(
-            'ANS_ID'    => 0,
-            'ANS_value' => $this->_cpt_model_obj->state_ID(),
-        )), array(
-                '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(array(
-            'QST_ID'           => 0,
-            'QST_display_text' => __('Country', 'event_espresso'),
-            'QST_system'       => 'admin-country',
-        )), EE_Answer::new_instance(array(
-            'ANS_ID'    => 0,
-            'ANS_value' => $this->_cpt_model_obj->country_ID(),
-        )), array(
-                '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);
-    }
-
-
-
-    /**
-     *        _attendee_details
-     *
-     * @access protected
-     * @return void
-     */
-    public function attendee_registrations_meta_box($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 string        html for new form.
-     */
-    public function after_title_form_fields($post)
-    {
-        if ($post->post_type == 'espresso_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 boolean $trash - whether to move item to trash (TRUE) or restore it (FALSE)
-     * @access protected
-     * @return void
-     */
-    protected function _trash_or_restore_attendees($trash = true)
-    {
-        do_action('AHEE_log', __FILE__, __FUNCTION__, '');
-        $ATT_MDL = EEM_Attendee::instance();
-        $success = 1;
-        //Checkboxes
-        if ( ! empty($this->_req_data['checkbox']) && is_array($this->_req_data['checkbox'])) {
-            // if array has more than one element than success message should be plural
-            $success = count($this->_req_data['checkbox']) > 1 ? 2 : 1;
-            // cycle thru checkboxes
-            while (list($ATT_ID, $value) = each($this->_req_data['checkbox'])) {
-                $updated = $trash ? $ATT_MDL->update_by_ID(array('status' => 'trash'), $ATT_ID)
-                    : $ATT_MDL->update_by_ID(array('status' => 'publish'), $ATT_ID);
-                if ( ! $updated) {
-                    $success = 0;
-                }
-            }
-        } else {
-            // grab single id and delete
-            $ATT_ID = absint($this->_req_data['ATT_ID']);
-            //get attendee
-            $att = $ATT_MDL->get_one_by_ID($ATT_ID);
-            $updated = $trash ? $att->set_status('trash') : $att->set_status('publish');
-            $updated = $att->save();
-            if ( ! $updated) {
-                $success = 0;
-            }
-        }
-        $what = $success > 1 ? __('Contacts', 'event_espresso') : __('Contact', 'event_espresso');
-        $action_desc = $trash ? __('moved to the trash', 'event_espresso') : __('restored', 'event_espresso');
-        $this->_redirect_after_action($success, $what, $action_desc, array('action' => 'contact_list'));
-    }
+		}
+		$template_args = array(
+			'title'                    => '',
+			'content'                  => '',
+			'step_button_text'         => '',
+			'show_notification_toggle' => false,
+		);
+		//to indicate we're processing a new registration
+		$hidden_fields = array(
+			'processing_registration' => array(
+				'type'  => 'hidden',
+				'value' => 0,
+			),
+			'event_id'                => array(
+				'type'  => 'hidden',
+				'value' => $this->_reg_event->ID(),
+			),
+		);
+		//if the cart is empty then we know we're at step one so we'll display ticket selector
+		$cart = EE_Registry::instance()->SSN->cart();
+		$step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
+		switch ($step) {
+			case 'ticket' :
+				$hidden_fields['processing_registration']['value'] = 1;
+				$template_args['title'] = __('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['step_button_text'] = __('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'] = __('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 setup properly by the first process_reg_step run.
+				$template_args['content'] = EED_Single_Page_Checkout::registration_checkout_for_admin();
+				$template_args['step_button_text'] = __('Save Registration and Continue to Details', 'event_espresso');
+				$template_args['show_notification_toggle'] = true;
+				break;
+		}
+		$this->_set_add_edit_form_tags('process_reg_step',
+			$hidden_fields); //we come back to the process_registration_step route.
+		return EEH_Template::display_template(REG_TEMPLATE_PATH
+											  . 'reg_admin_register_new_attendee_step_content.template.php',
+			$template_args, true);
+	}
+
+
+
+	/**
+	 *        set_reg_event
+	 *
+	 * @access private
+	 * @return boolean
+	 */
+	private function _set_reg_event()
+	{
+		if (is_object($this->_reg_event)) {
+			return true;
+		}
+		$EVT_ID = ( ! empty($this->_req_data['event_id'])) ? absint($this->_req_data['event_id']) : false;
+		if ( ! $EVT_ID) {
+			return false;
+		}
+		$this->_reg_event = EEM_Event::instance()->get_one_by_ID($EVT_ID);
+		return true;
+	}
+
+
+
+	/**
+	 * process_reg_step
+	 *
+	 * @access        public
+	 * @return        string
+	 * @throws \RuntimeException
+	 * @throws \EE_Error
+	 */
+	public function process_reg_step()
+	{
+		EE_System::do_not_cache();
+		$this->_set_reg_event();
+		EE_Registry::instance()->REQ->set_espresso_page(true);
+		EE_Registry::instance()->REQ->set('uts', time());
+		//what step are we on?
+		$cart = EE_Registry::instance()->SSN->cart();
+		$step = ! $cart instanceof EE_Cart ? 'ticket' : 'questions';
+		//if doing ajax then we need to verify the nonce
+		if (defined('DOING_AJAX')) {
+			$nonce = isset($this->_req_data[$this->_req_nonce])
+				? sanitize_text_field($this->_req_data[$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 {
+					$query_args['step_error'] = $this->_req_data['step_error'] = true;
+				}
+				if (defined('DOING_AJAX')) {
+					$this->new_registration(); //display next step
+				} else {
+					$query_args = array(
+						'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 ( ! isset($this->_req_data['txn_reg_status_change'], $this->_req_data['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_cart_grand_total();
+					if ($grand_total instanceof EE_Line_Item) {
+						$grand_total->save_this_and_descendants_to_txn();
+					}
+				}
+				if ( ! $transaction instanceof EE_Transaction) {
+					$query_args = array(
+						'action'                  => 'new_registration',
+						'processing_registration' => 2,
+						'event_id'                => $this->_reg_event->ID(),
+						'uts'                     => time(),
+					);
+					if (defined('DOING_AJAX')) {
+						//display registration form again because there are errors (maybe validation?)
+						$this->new_registration();
+						return;
+					} else {
+						$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();
+				}
+				EE_Registry::instance()->SSN->clear_session(__CLASS__, __FUNCTION__);
+				$this->_req_data = array();
+				$query_args = array(
+					'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
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function redirect_to_txn()
+	{
+		EE_System::do_not_cache();
+		EE_Registry::instance()->SSN->clear_session(__CLASS__, __FUNCTION__);
+		$query_args = array(
+			'action' => 'view_transaction',
+			'TXN_ID' => isset($this->_req_data['TXN_ID']) ? absint($this->_req_data['TXN_ID']) : 0,
+			'page'   => 'espresso_transactions',
+		);
+		if (isset($this->_req_data['EVT_ID'], $this->_req_data['redirect_from'])) {
+			$query_args['EVT_ID'] = $this->_req_data['EVT_ID'];
+			$query_args['event_name'] = urlencode($this->_req_data['event_name']);
+			$query_args['redirect_from'] = $this->_req_data['redirect_from'];
+		}
+		EE_Error::add_success(__('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
+	 *
+	 * @access protected
+	 * @return void
+	 */
+	protected function _attendee_contact_list_table()
+	{
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
+		$this->_search_btn_label = __('Contacts', 'event_espresso');
+		$this->display_admin_list_table_page_with_no_sidebar();
+	}
+
+
+
+	/**
+	 *        get_attendees
+	 *
+	 * @param bool $count whether to return count or data.
+	 * @access public
+	 * @return array
+	 */
+	public function get_attendees($per_page, $count = false, $trash = false)
+	{
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
+		require_once(REG_ADMIN . 'EE_Attendee_Contact_List_Table.class.php');
+		$ATT_MDL = EEM_Attendee::instance();
+		$this->_req_data['orderby'] = ! empty($this->_req_data['orderby']) ? $this->_req_data['orderby'] : '';
+		switch ($this->_req_data['orderby']) {
+			case 'ATT_ID':
+				$orderby = 'ATT_ID';
+				break;
+			case 'ATT_fname':
+				$orderby = 'ATT_fname';
+				break;
+			case 'ATT_email':
+				$orderby = 'ATT_email';
+				break;
+			case 'ATT_city':
+				$orderby = 'ATT_city';
+				break;
+			case 'STA_ID':
+				$orderby = 'STA_ID';
+				break;
+			case 'CNT_ID':
+				$orderby = 'CNT_ID';
+				break;
+			default:
+				$orderby = 'ATT_lname';
+		}
+		$sort = (isset($this->_req_data['order']) && ! empty($this->_req_data['order'])) ? $this->_req_data['order']
+			: 'ASC';
+		$current_page = isset($this->_req_data['paged']) && ! empty($this->_req_data['paged'])
+			? $this->_req_data['paged'] : 1;
+		$per_page = isset($per_page) && ! empty($per_page) ? $per_page : 10;
+		$per_page = isset($this->_req_data['perpage']) && ! empty($this->_req_data['perpage'])
+			? $this->_req_data['perpage'] : $per_page;
+		$_where = array();
+		if ( ! empty($this->_req_data['s'])) {
+			$sstr = '%' . $this->_req_data['s'] . '%';
+			$_where['OR'] = array(
+				'Registration.Event.EVT_name'       => array('LIKE', $sstr),
+				'Registration.Event.EVT_desc'       => array('LIKE', $sstr),
+				'Registration.Event.EVT_short_desc' => array('LIKE', $sstr),
+				'ATT_fname'                         => array('LIKE', $sstr),
+				'ATT_lname'                         => array('LIKE', $sstr),
+				'ATT_short_bio'                     => array('LIKE', $sstr),
+				'ATT_email'                         => array('LIKE', $sstr),
+				'ATT_address'                       => array('LIKE', $sstr),
+				'ATT_address2'                      => array('LIKE', $sstr),
+				'ATT_city'                          => array('LIKE', $sstr),
+				'Country.CNT_name'                  => array('LIKE', $sstr),
+				'State.STA_name'                    => array('LIKE', $sstr),
+				'ATT_phone'                         => array('LIKE', $sstr),
+				'Registration.REG_final_price'      => array('LIKE', $sstr),
+				'Registration.REG_code'             => array('LIKE', $sstr),
+				'Registration.REG_count'            => array('LIKE', $sstr),
+				'Registration.REG_group_size'       => array('LIKE', $sstr),
+			);
+		}
+		$offset = ($current_page - 1) * $per_page;
+		$limit = $count ? null : array($offset, $per_page);
+		if ($trash) {
+			$_where['status'] = array('!=', 'publish');
+			$all_attendees = $count
+				? $ATT_MDL->count(array(
+					$_where,
+					'order_by' => array($orderby => $sort),
+					'limit'    => $limit,
+				), 'ATT_ID', true)
+				: $ATT_MDL->get_all(array(
+					$_where,
+					'order_by' => array($orderby => $sort),
+					'limit'    => $limit,
+				));
+		} else {
+			$_where['status'] = array('IN', array('publish'));
+			$all_attendees = $count
+				? $ATT_MDL->count(array(
+					$_where,
+					'order_by' => array($orderby => $sort),
+					'limit'    => $limit,
+				), 'ATT_ID', true)
+				: $ATT_MDL->get_all(array(
+					$_where,
+					'order_by' => array($orderby => $sort),
+					'limit'    => $limit,
+				));
+		}
+		return $all_attendees;
+	}
+
+
+
+	/**
+	 * This is just taking care of resending the registration confirmation
+	 *
+	 * @access protected
+	 * @return void
+	 */
+	protected function _resend_registration()
+	{
+		$this->_process_resend_registration();
+		$query_args = isset($this->_req_data['redirect_to'])
+			? array('action' => $this->_req_data['redirect_to'], '_REG_ID' => $this->_req_data['_REG_ID'])
+			: array(
+				'action' => 'default',
+			);
+		$this->_redirect_after_action(false, '', '', $query_args, true);
+	}
+
+
+
+	public function _registrations_report()
+	{
+		if ( ! defined('EE_USE_OLD_CSV_REPORT_CLASS')) {
+			wp_redirect(EE_Admin_Page::add_query_args_and_nonce(array(
+				'page'        => 'espresso_batch',
+				'batch'       => 'file',
+				'EVT_ID'      => isset($this->_req_data['EVT_ID']) ? $this->_req_data['EVT_ID'] : null,
+				'job_handler' => urlencode('EventEspressoBatchRequest\JobHandlers\RegistrationsReport'),
+				'return_url'  => urlencode($this->_req_data['return_url']),
+			)));
+		} else {
+			$new_request_args = array(
+				'export' => 'report',
+				'action' => 'registrations_report_for_event',
+				'EVT_ID' => isset($this->_req_data['EVT_ID']) ? $this->_req_data['EVT_ID'] : null,
+			);
+			$this->_req_data = array_merge($this->_req_data, $new_request_args);
+			if (is_readable(EE_CLASSES . 'EE_Export.class.php')) {
+				require_once(EE_CLASSES . 'EE_Export.class.php');
+				$EE_Export = EE_Export::instance($this->_req_data);
+				$EE_Export->export();
+			}
+		}
+	}
+
+
+
+	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->_req_data);
+			$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(array(
+				'page'        => 'espresso_batch',
+				'batch'       => 'file',
+				'job_handler' => urlencode('EventEspressoBatchRequest\JobHandlers\AttendeesReport'),
+				'return_url'  => urlencode($this->_req_data['return_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->_req_data);
+				$EE_Export->report_attendees();
+			}
+		}
+	}
+
+
+
+
+
+	/***************************************        ATTENDEE DETAILS        ***************************************/
+	/**
+	 * This duplicates the attendee object for the given incoming registration id and attendee_id.
+	 *
+	 * @return void
+	 */
+	protected function _duplicate_attendee()
+	{
+		$action = ! empty($this->_req_data['return']) ? $this->_req_data['return'] : 'default';
+		//verify we have necessary info
+		if (empty($this->_req_data['_REG_ID'])) {
+			EE_Error::add_error(__('Unable to create the contact for the registration because the required parameters are not present (_REG_ID )',
+				'event_espresso'), __FILE__, __LINE__, __FUNCTION__);
+			$query_args = array('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 = EEM_Registration::instance()->get_one_by_ID($this->_req_data['_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(__('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 = array('post' => $new_attendee->ID(), 'action' => 'edit_attendee');
+		$this->_redirect_after_action('', '', '', $query_args, true);
+	}
+
+
+
+	//related to cpt routes
+	protected function _insert_update_cpt_item($post_id, $post)
+	{
+		$success = true;
+		$attendee = EEM_Attendee::instance()->get_one_by_ID($post_id);
+		//for attendee updates
+		if ($post->post_type = 'espresso_attendees' && ! empty($attendee)) {
+			//note we should only be UPDATING attendees at this point.
+			$updated_fields = array(
+				'ATT_fname'     => $this->_req_data['ATT_fname'],
+				'ATT_lname'     => $this->_req_data['ATT_lname'],
+				'ATT_full_name' => $this->_req_data['ATT_fname'] . ' ' . $this->_req_data['ATT_lname'],
+				'ATT_address'   => isset($this->_req_data['ATT_address']) ? $this->_req_data['ATT_address'] : '',
+				'ATT_address2'  => isset($this->_req_data['ATT_address2']) ? $this->_req_data['ATT_address2'] : '',
+				'ATT_city'      => isset($this->_req_data['ATT_city']) ? $this->_req_data['ATT_city'] : '',
+				'STA_ID'        => isset($this->_req_data['STA_ID']) ? $this->_req_data['STA_ID'] : '',
+				'CNT_ISO'       => isset($this->_req_data['CNT_ISO']) ? $this->_req_data['CNT_ISO'] : '',
+				'ATT_zip'       => isset($this->_req_data['ATT_zip']) ? $this->_req_data['ATT_zip'] : '',
+				'ATT_email'     => isset($this->_req_data['ATT_email']) ? $this->_req_data['ATT_email'] : '',
+				'ATT_phone'     => isset($this->_req_data['ATT_phone']) ? $this->_req_data['ATT_phone'] : '',
+			);
+			foreach ($updated_fields as $field => $value) {
+				$attendee->set($field, $value);
+			}
+			$success = $attendee->save();
+			$attendee_update_callbacks = apply_filters('FHEE__Registrations_Admin_Page__insert_update_cpt_item__attendee_update',
+				array());
+			foreach ($attendee_update_callbacks as $a_callback) {
+				if (false === call_user_func_array($a_callback, array($attendee, $this->_req_data))) {
+					throw new EE_Error(sprintf(__('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(__('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)
+	{
+	}
+
+
+
+	public function attendee_editor_metaboxes()
+	{
+		$this->verify_cpt_object();
+		remove_meta_box('postexcerpt', __('Excerpt'), 'post_excerpt_meta_box', $this->_cpt_routes[$this->_req_action],
+			'normal', 'core');
+		remove_meta_box('commentstatusdiv', $this->_cpt_routes[$this->_req_action], 'normal', 'core');
+		if (post_type_supports('espresso_attendees', 'excerpt')) {
+			add_meta_box('postexcerpt', __('Short Biography', 'event_espresso'), 'post_excerpt_meta_box',
+				$this->_cpt_routes[$this->_req_action], 'normal');
+		}
+		if (post_type_supports('espresso_attendees', 'comments')) {
+			add_meta_box('commentsdiv', __('Notes on the Contact', 'event_espresso'), 'post_comment_meta_box',
+				$this->_cpt_routes[$this->_req_action], 'normal', 'core');
+		}
+		add_meta_box('attendee_contact_info', __('Contact Info', 'event_espresso'),
+			array($this, 'attendee_contact_info'), $this->_cpt_routes[$this->_req_action], 'side', 'core');
+		add_meta_box('attendee_details_address', __('Address Details', 'event_espresso'),
+			array($this, 'attendee_address_details'), $this->_cpt_routes[$this->_req_action], 'normal', 'core');
+		add_meta_box('attendee_registrations', __('Registrations for this Contact', 'event_espresso'),
+			array($this, 'attendee_registrations_meta_box'), $this->_cpt_routes[$this->_req_action], 'normal', 'high');
+	}
+
+
+
+	/**
+	 * Metabox for attendee contact info
+	 *
+	 * @param  WP_Post $post wp post object
+	 * @return string        attendee contact info ( and form )
+	 */
+	public function attendee_contact_info($post)
+	{
+		//get attendee object ( should already have it )
+		$this->_template_args['attendee'] = $this->_cpt_model_obj;
+		$template = REG_TEMPLATE_PATH . 'attendee_contact_info_metabox_content.template.php';
+		EEH_Template::display_template($template, $this->_template_args);
+	}
+
+
+
+	/**
+	 * Metabox for attendee details
+	 *
+	 * @param  WP_Post $post wp post object
+	 * @return string        attendee address details (and form)
+	 */
+	public function attendee_address_details($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(array(
+			'QST_ID'           => 0,
+			'QST_display_text' => __('State/Province', 'event_espresso'),
+			'QST_system'       => 'admin-state',
+		)), EE_Answer::new_instance(array(
+			'ANS_ID'    => 0,
+			'ANS_value' => $this->_cpt_model_obj->state_ID(),
+		)), array(
+				'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(array(
+			'QST_ID'           => 0,
+			'QST_display_text' => __('Country', 'event_espresso'),
+			'QST_system'       => 'admin-country',
+		)), EE_Answer::new_instance(array(
+			'ANS_ID'    => 0,
+			'ANS_value' => $this->_cpt_model_obj->country_ID(),
+		)), array(
+				'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);
+	}
+
+
+
+	/**
+	 *        _attendee_details
+	 *
+	 * @access protected
+	 * @return void
+	 */
+	public function attendee_registrations_meta_box($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 string        html for new form.
+	 */
+	public function after_title_form_fields($post)
+	{
+		if ($post->post_type == 'espresso_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 boolean $trash - whether to move item to trash (TRUE) or restore it (FALSE)
+	 * @access protected
+	 * @return void
+	 */
+	protected function _trash_or_restore_attendees($trash = true)
+	{
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
+		$ATT_MDL = EEM_Attendee::instance();
+		$success = 1;
+		//Checkboxes
+		if ( ! empty($this->_req_data['checkbox']) && is_array($this->_req_data['checkbox'])) {
+			// if array has more than one element than success message should be plural
+			$success = count($this->_req_data['checkbox']) > 1 ? 2 : 1;
+			// cycle thru checkboxes
+			while (list($ATT_ID, $value) = each($this->_req_data['checkbox'])) {
+				$updated = $trash ? $ATT_MDL->update_by_ID(array('status' => 'trash'), $ATT_ID)
+					: $ATT_MDL->update_by_ID(array('status' => 'publish'), $ATT_ID);
+				if ( ! $updated) {
+					$success = 0;
+				}
+			}
+		} else {
+			// grab single id and delete
+			$ATT_ID = absint($this->_req_data['ATT_ID']);
+			//get attendee
+			$att = $ATT_MDL->get_one_by_ID($ATT_ID);
+			$updated = $trash ? $att->set_status('trash') : $att->set_status('publish');
+			$updated = $att->save();
+			if ( ! $updated) {
+				$success = 0;
+			}
+		}
+		$what = $success > 1 ? __('Contacts', 'event_espresso') : __('Contact', 'event_espresso');
+		$action_desc = $trash ? __('moved to the trash', 'event_espresso') : __('restored', 'event_espresso');
+		$this->_redirect_after_action($success, $what, $action_desc, array('action' => 'contact_list'));
+	}
 
 }
 

admin_pages/venues/Venues_Admin_Page.core.php

Spacing +241 added lines, -241 removed lines

@@ -1,5 +1,5 @@ 
 <?php
-if (!defined('EVENT_ESPRESSO_VERSION') )
+if ( ! defined('EVENT_ESPRESSO_VERSION'))
 	exit('NO direct script access allowed');
 
 /**
@@ -62,10 +62,10 @@ 
 
 
 	protected function _init_page_props() {
-		require_once( EE_MODELS . 'EEM_Venue.model.php' );
+		require_once(EE_MODELS.'EEM_Venue.model.php');
 		$this->page_slug = EE_VENUES_PG_SLUG;
 		$this->_admin_base_url = EE_VENUES_ADMIN_URL;
-		$this->_admin_base_path = EE_ADMIN_PAGES . 'venues';
+		$this->_admin_base_path = EE_ADMIN_PAGES.'venues';
 		$this->page_label = __('Event Venues', 'event_espresso');
 		$this->_cpt_model_names = array(
 			'create_new' => 'EEM_Venue',
@@ -108,7 +108,7 @@ 
 				'edit' => __('Update Venue', 'event_espresso'),
 				'add_category' => __('Save New Category', 'event_espresso'),
 				'edit_category' => __('Update Category', 'event_espresso'),
-				'google_map_settings' => __( 'Update Settings', 'event_espresso' )
+				'google_map_settings' => __('Update Settings', 'event_espresso')
 				)
 		);
 	}
@@ -123,8 +123,8 @@ 
 		//load field generator helper
 
 		//is there a vnu_id in the request?
-		$vnu_id = ! empty( $this->_req_data['VNU_ID'] ) && ! is_array( $this->_req_data['VNU_ID'] ) ? $this->_req_data['VNU_ID'] : 0;
-		$vnu_id = ! empty( $this->_req_data['post'] ) ? $this->_req_data['post'] : $vnu_id;
+		$vnu_id = ! empty($this->_req_data['VNU_ID']) && ! is_array($this->_req_data['VNU_ID']) ? $this->_req_data['VNU_ID'] : 0;
+		$vnu_id = ! empty($this->_req_data['post']) ? $this->_req_data['post'] : $vnu_id;
 
 		$this->_page_routes = array(
 			'default' => array(
@@ -142,27 +142,27 @@ 
 				),
 			'trash_venue' => array(
 				'func' => '_trash_or_restore_venue',
-				'args' => array( 'venue_status' => 'trash' ),
+				'args' => array('venue_status' => 'trash'),
 				'noheader' => TRUE,
 				'capability' => 'ee_delete_venue',
 				'obj_id' => $vnu_id
 				),
 			'trash_venues' => array(
 				'func' => '_trash_or_restore_venues',
-				'args' => array( 'venue_status' => 'trash' ),
+				'args' => array('venue_status' => 'trash'),
 				'noheader' => TRUE,
 				'capability' => 'ee_delete_venues'
 				),
 			'restore_venue' => array(
 				'func' => '_trash_or_restore_venue',
-				'args' => array( 'venue_status' => 'draft' ),
+				'args' => array('venue_status' => 'draft'),
 				'noheader' => TRUE,
 				'capability' => 'ee_delete_venue',
 				'obj_id' => $vnu_id
 				),
 			'restore_venues' => array(
 				'func' => '_trash_or_restore_venues',
-				'args' => array( 'venue_status' => 'draft' ),
+				'args' => array('venue_status' => 'draft'),
 				'noheader' => TRUE,
 				'capability' => 'ee_delete_venues'
 				),
@@ -264,7 +264,7 @@ 
 						'filename' => 'venues_overview_views_bulk_actions_search'
 					)
 				),
-				'help_tour' => array( 'Venues_Overview_Help_Tour' ),
+				'help_tour' => array('Venues_Overview_Help_Tour'),
 				'metaboxes' => array('_espresso_news_post_box', '_espresso_links_post_box'),
 				'require_nonce' => FALSE
 			),
@@ -300,7 +300,7 @@ 
 						'filename' => 'venues_editor_other'
 					)
 				),
-				'help_tour' => array( 'Venues_Add_Venue_Help_Tour' ),
+				'help_tour' => array('Venues_Add_Venue_Help_Tour'),
 				'metaboxes' => array('_venue_editor_metaboxes'),
 				'require_nonce' => FALSE
 				),
@@ -309,7 +309,7 @@ 
 					'label' => __('Edit Venue', 'event_espresso'),
 					'order' => 5,
 					'persistent' => FALSE,
-					'url' => isset($this->_req_data['post']) ? add_query_arg(array('post' => $this->_req_data['post'] ), $this->_current_page_view_url )  : $this->_admin_base_url
+					'url' => isset($this->_req_data['post']) ? add_query_arg(array('post' => $this->_req_data['post']), $this->_current_page_view_url) : $this->_admin_base_url
 				),
 				'help_tabs' => array(
 					'venues_editor_help_tab' => array(
@@ -343,17 +343,17 @@ 
 			),
 			'google_map_settings' => array(
 				'nav' => array(
-					'label' => esc_html__('Google Maps', 'event_espresso' ),
+					'label' => esc_html__('Google Maps', 'event_espresso'),
 					'order' => 40
 				),
-				'metaboxes' => array_merge( $this->_default_espresso_metaboxes, array('_publish_post_box' ) ),
+				'metaboxes' => array_merge($this->_default_espresso_metaboxes, array('_publish_post_box')),
 				'help_tabs' => array(
 					'general_settings_google_maps_help_tab' => array(
 						'title' => __('Google Maps', 'event_espresso'),
 						'filename' => 'general_settings_google_maps'
 					)
 				),
-				'help_tour' => array( 'Google_Maps_Help_Tour' ),
+				'help_tour' => array('Google_Maps_Help_Tour'),
 				'require_nonce' => FALSE
 			),
 			//venue category stuff
@@ -369,7 +369,7 @@ 
 						'filename' => 'venues_add_category'
 					)
 				),
-				'help_tour' => array( 'Venues_Add_Category_Help_Tour' ),
+				'help_tour' => array('Venues_Add_Category_Help_Tour'),
 				'require_nonce' => FALSE
 				),
 			'edit_category' => array(
@@ -377,7 +377,7 @@ 
 					'label' => __('Edit Category', 'event_espresso'),
 					'order' => 15,
 					'persistent' => FALSE,
-					'url' => isset($this->_req_data['EVT_CAT_ID']) ? add_query_arg(array('EVT_CAT_ID' => $this->_req_data['EVT_CAT_ID'] ), $this->_current_page_view_url )  : $this->_admin_base_url
+					'url' => isset($this->_req_data['EVT_CAT_ID']) ? add_query_arg(array('EVT_CAT_ID' => $this->_req_data['EVT_CAT_ID']), $this->_current_page_view_url) : $this->_admin_base_url
 					),
 				'metaboxes' => array('_publish_post_box'),
 				'help_tabs' => array(
@@ -413,7 +413,7 @@ 
 						'filename' => 'venues_categories_other'
 					)
 				),
-				'help_tour' => array( 'Venues_Categories_Help_Tour' ),
+				'help_tour' => array('Venues_Categories_Help_Tour'),
 				'metaboxes' => $this->_default_espresso_metaboxes,
 				'require_nonce' => FALSE
 				)
@@ -470,7 +470,7 @@ 
 
 
 	public function load_scripts_styles() {
-		wp_register_style('ee-cat-admin', EVENTS_ASSETS_URL . 'ee-cat-admin.css', array(), EVENT_ESPRESSO_VERSION );
+		wp_register_style('ee-cat-admin', EVENTS_ASSETS_URL.'ee-cat-admin.css', array(), EVENT_ESPRESSO_VERSION);
 		wp_enqueue_style('ee-cat-admin');
 	}
 
@@ -493,7 +493,7 @@ 
 	public function load_scripts_styles_edit() {
 		//styles
 		wp_enqueue_style('espresso-ui-theme');
-		wp_register_style( 'espresso_venues', EE_VENUES_ASSETS_URL . 'ee-venues-admin.css', array(), EVENT_ESPRESSO_VERSION );
+		wp_register_style('espresso_venues', EE_VENUES_ASSETS_URL.'ee-venues-admin.css', array(), EVENT_ESPRESSO_VERSION);
 		wp_enqueue_style('espresso_venues');
 	}
 
@@ -512,13 +512,13 @@ 
 				)
 		);
 
-		if ( EE_Registry::instance()->CAP->current_user_can( 'ee_delete_venues', 'espresso_venues_trash_venues' ) ) {
+		if (EE_Registry::instance()->CAP->current_user_can('ee_delete_venues', 'espresso_venues_trash_venues')) {
 			$this->_views['all']['bulk_action'] = array(
 				'trash_venues' => __('Move to Trash', 'event_espresso')
 			);
 			$this->_views['trash'] = array(
 				'slug' => 'trash',
-				'label' => __( 'Trash', 'event_espresso' ),
+				'label' => __('Trash', 'event_espresso'),
 				'count' => 0,
 				'bulk_action' => array(
 					'restore_venues' => __('Restore from Trash', 'event_espresso'),
@@ -551,9 +551,9 @@ 
 
 
 	protected function _overview_list_table() {
-		do_action( 'AHEE_log', __FILE__, __FUNCTION__, '' );
-		$this->_template_args['after_list_table'] = EEH_Template::get_button_or_link( get_post_type_archive_link('espresso_venues'), __("View Venue Archive Page", "event_espresso"), 'button' );
-		$this->_admin_page_title .= ' ' . $this->get_action_link_or_button('create_new', 'add', array(), 'add-new-h2');
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
+		$this->_template_args['after_list_table'] = EEH_Template::get_button_or_link(get_post_type_archive_link('espresso_venues'), __("View Venue Archive Page", "event_espresso"), 'button');
+		$this->_admin_page_title .= ' '.$this->get_action_link_or_button('create_new', 'add', array(), 'add-new-h2');
 		$this->_search_btn_label = __('Venues', 'event_espresso');
 		$this->display_admin_list_table_page_with_sidebar();
 	}
@@ -566,8 +566,8 @@ 
 			'vnu_url' => $this->_cpt_model_obj->venue_url(),
 			'vnu_phone' => $this->_cpt_model_obj->phone()
 			);
-		$template = EE_VENUES_TEMPLATE_PATH . 'venue_publish_box_extras.template.php';
-		EEH_Template::display_template( $template, $extra_rows );
+		$template = EE_VENUES_TEMPLATE_PATH.'venue_publish_box_extras.template.php';
+		EEH_Template::display_template($template, $extra_rows);
 	}
 
 
@@ -583,31 +583,31 @@ 
 		$default_map_settings->use_google_maps = TRUE;
 		$default_map_settings->google_map_api_key = '';
 		// for event details pages (reg page)
-		$default_map_settings->event_details_map_width = 585; 			// ee_map_width_single
-		$default_map_settings->event_details_map_height = 362; 			// ee_map_height_single
-		$default_map_settings->event_details_map_zoom = 14; 			// ee_map_zoom_single
-		$default_map_settings->event_details_display_nav = TRUE; 			// ee_map_nav_display_single
-		$default_map_settings->event_details_nav_size = FALSE; 			// ee_map_nav_size_single
-		$default_map_settings->event_details_control_type = 'default'; 		// ee_map_type_control_single
-		$default_map_settings->event_details_map_align = 'center'; 			// ee_map_align_single
+		$default_map_settings->event_details_map_width = 585; // ee_map_width_single
+		$default_map_settings->event_details_map_height = 362; // ee_map_height_single
+		$default_map_settings->event_details_map_zoom = 14; // ee_map_zoom_single
+		$default_map_settings->event_details_display_nav = TRUE; // ee_map_nav_display_single
+		$default_map_settings->event_details_nav_size = FALSE; // ee_map_nav_size_single
+		$default_map_settings->event_details_control_type = 'default'; // ee_map_type_control_single
+		$default_map_settings->event_details_map_align = 'center'; // ee_map_align_single
 		// for event list pages
-		$default_map_settings->event_list_map_width = 300; 			// ee_map_width
-		$default_map_settings->event_list_map_height = 185; 		// ee_map_height
-		$default_map_settings->event_list_map_zoom = 12; 			// ee_map_zoom
-		$default_map_settings->event_list_display_nav = FALSE; 		// ee_map_nav_display
-		$default_map_settings->event_list_nav_size = TRUE; 			// ee_map_nav_size
-		$default_map_settings->event_list_control_type = 'dropdown'; 		// ee_map_type_control
-		$default_map_settings->event_list_map_align = 'center'; 			// ee_map_align
+		$default_map_settings->event_list_map_width = 300; // ee_map_width
+		$default_map_settings->event_list_map_height = 185; // ee_map_height
+		$default_map_settings->event_list_map_zoom = 12; // ee_map_zoom
+		$default_map_settings->event_list_display_nav = FALSE; // ee_map_nav_display
+		$default_map_settings->event_list_nav_size = TRUE; // ee_map_nav_size
+		$default_map_settings->event_list_control_type = 'dropdown'; // ee_map_type_control
+		$default_map_settings->event_list_map_align = 'center'; // ee_map_align
 
 		$this->_template_args['map_settings'] =
-			isset( EE_Registry::instance()->CFG->map_settings ) && ! empty( EE_Registry::instance()->CFG->map_settings )
-				? (object)array_merge( (array)$default_map_settings, (array)EE_Registry::instance()->CFG->map_settings )
+			isset(EE_Registry::instance()->CFG->map_settings) && ! empty(EE_Registry::instance()->CFG->map_settings)
+				? (object) array_merge((array) $default_map_settings, (array) EE_Registry::instance()->CFG->map_settings)
 				: $default_map_settings;
 
-		$this->_set_add_edit_form_tags( 'update_google_map_settings' );
-		$this->_set_publish_post_box_vars( NULL, FALSE, FALSE, NULL, FALSE );
+		$this->_set_add_edit_form_tags('update_google_map_settings');
+		$this->_set_publish_post_box_vars(NULL, FALSE, FALSE, NULL, FALSE);
 		$this->_template_args['admin_page_content'] = EEH_Template::display_template(
-			EE_VENUES_TEMPLATE_PATH . 'google_map.template.php',
+			EE_VENUES_TEMPLATE_PATH.'google_map.template.php',
 			$this->_template_args,
 			true
 		);
@@ -617,83 +617,83 @@ 
 	protected function _update_google_map_settings() {
 
 		EE_Registry::instance()->CFG->map_settings->use_google_maps =
-			isset( $this->_req_data['use_google_maps'] )
-				? absint( $this->_req_data['use_google_maps'] )
+			isset($this->_req_data['use_google_maps'])
+				? absint($this->_req_data['use_google_maps'])
 				: EE_Registry::instance()->CFG->map_settings->use_google_maps;
 
 		EE_Registry::instance()->CFG->map_settings->google_map_api_key =
-			isset( $this->_req_data['google_map_api_key'] )
-				? sanitize_text_field( $this->_req_data['google_map_api_key'] )
+			isset($this->_req_data['google_map_api_key'])
+				? sanitize_text_field($this->_req_data['google_map_api_key'])
 				: EE_Registry::instance()->CFG->map_settings->google_map_api_key;
 
 		EE_Registry::instance()->CFG->map_settings->event_details_map_width =
-			isset( $this->_req_data['event_details_map_width'] )
-				? absint( $this->_req_data['event_details_map_width'] )
+			isset($this->_req_data['event_details_map_width'])
+				? absint($this->_req_data['event_details_map_width'])
 				: EE_Registry::instance()->CFG->map_settings->event_details_map_width;
 
 		EE_Registry::instance()->CFG->map_settings->event_details_map_height =
-			isset( $this->_req_data['event_details_map_height'] )
-				? absint( $this->_req_data['event_details_map_height'] )
+			isset($this->_req_data['event_details_map_height'])
+				? absint($this->_req_data['event_details_map_height'])
 				: EE_Registry::instance()->CFG->map_settings->event_details_map_height;
 
 		EE_Registry::instance()->CFG->map_settings->event_details_map_zoom =
-			isset( $this->_req_data['event_details_map_zoom'] )
-				? absint( $this->_req_data['event_details_map_zoom'] )
+			isset($this->_req_data['event_details_map_zoom'])
+				? absint($this->_req_data['event_details_map_zoom'])
 				: EE_Registry::instance()->CFG->map_settings->event_details_map_zoom;
 
 		EE_Registry::instance()->CFG->map_settings->event_details_display_nav =
-			isset( $this->_req_data['event_details_display_nav'] )
-				? absint( $this->_req_data['event_details_display_nav'] )
+			isset($this->_req_data['event_details_display_nav'])
+				? absint($this->_req_data['event_details_display_nav'])
 				: EE_Registry::instance()->CFG->map_settings->event_details_display_nav;
 
 		EE_Registry::instance()->CFG->map_settings->event_details_nav_size =
-			isset( $this->_req_data['event_details_nav_size'] )
-				? absint( $this->_req_data['event_details_nav_size'] )
+			isset($this->_req_data['event_details_nav_size'])
+				? absint($this->_req_data['event_details_nav_size'])
 				: EE_Registry::instance()->CFG->map_settings->event_details_nav_size;
 
 		EE_Registry::instance()->CFG->map_settings->event_details_control_type =
-			isset( $this->_req_data['event_details_control_type'] )
-				? sanitize_text_field( $this->_req_data['event_details_control_type'] )
+			isset($this->_req_data['event_details_control_type'])
+				? sanitize_text_field($this->_req_data['event_details_control_type'])
 				: EE_Registry::instance()->CFG->map_settings->event_details_control_type;
 
 		EE_Registry::instance()->CFG->map_settings->event_details_map_align =
-			isset( $this->_req_data['event_details_map_align'] )
-				? sanitize_text_field( $this->_req_data['event_details_map_align'] )
+			isset($this->_req_data['event_details_map_align'])
+				? sanitize_text_field($this->_req_data['event_details_map_align'])
 				: EE_Registry::instance()->CFG->map_settings->event_details_map_align;
 
 		EE_Registry::instance()->CFG->map_settings->event_list_map_width =
-			isset( $this->_req_data['event_list_map_width'] )
-				? absint( $this->_req_data['event_list_map_width'] )
+			isset($this->_req_data['event_list_map_width'])
+				? absint($this->_req_data['event_list_map_width'])
 				: EE_Registry::instance()->CFG->map_settings->event_list_map_width;
 
 		EE_Registry::instance()->CFG->map_settings->event_list_map_height =
-			isset( $this->_req_data['event_list_map_height'] )
-				? absint( $this->_req_data['event_list_map_height'] )
+			isset($this->_req_data['event_list_map_height'])
+				? absint($this->_req_data['event_list_map_height'])
 				: EE_Registry::instance()->CFG->map_settings->event_list_map_height;
 
 		EE_Registry::instance()->CFG->map_settings->event_list_map_zoom =
-			isset( $this->_req_data['event_list_map_zoom'] )
-				? absint( $this->_req_data['event_list_map_zoom'] )
+			isset($this->_req_data['event_list_map_zoom'])
+				? absint($this->_req_data['event_list_map_zoom'])
 				: EE_Registry::instance()->CFG->map_settings->event_list_map_zoom;
 
 		EE_Registry::instance()->CFG->map_settings->event_list_display_nav =
-			isset( $this->_req_data['event_list_display_nav'] )
-				? absint( $this->_req_data['event_list_display_nav'] )
+			isset($this->_req_data['event_list_display_nav'])
+				? absint($this->_req_data['event_list_display_nav'])
 				: EE_Registry::instance()->CFG->map_settings->event_list_display_nav;
 
 		EE_Registry::instance()->CFG->map_settings->event_list_nav_size =
-			isset( $this->_req_data['event_list_nav_size'] )
-				? absint( $this->_req_data['event_list_nav_size'] )
+			isset($this->_req_data['event_list_nav_size'])
+				? absint($this->_req_data['event_list_nav_size'])
 				: EE_Registry::instance()->CFG->map_settings->event_list_nav_size;
 
 		EE_Registry::instance()->CFG->map_settings->event_list_control_type =
-			isset( $this->_req_data['event_list_control_type'] )
-				? sanitize_text_field( $this->_req_data['event_list_control_type'] )
+			isset($this->_req_data['event_list_control_type'])
+				? sanitize_text_field($this->_req_data['event_list_control_type'])
 				: EE_Registry::instance()->CFG->map_settings->event_list_control_type;
 
 		EE_Registry::instance()->CFG->map_settings->event_list_map_align =
-			isset( $this->_req_data['event_list_map_align'] )
-				? sanitize_text_field( $this->_req_data['event_list_map_align'] )
+			isset($this->_req_data['event_list_map_align'])
+				? sanitize_text_field($this->_req_data['event_list_map_align'])
 				: EE_Registry::instance()->CFG->map_settings->event_list_map_align;
 
 		EE_Registry::instance()->CFG->map_settings = apply_filters(
@@ -707,7 +707,7 @@ 
 			EE_Registry::instance()->CFG->map_settings,
 			__FILE__, __FUNCTION__, __LINE__
 		);
-		$this->_redirect_after_action( $success, $what, 'updated', array( 'action' => 'google_map_settings' ) );
+		$this->_redirect_after_action($success, $what, 'updated', array('action' => 'google_map_settings'));
 
 	}
 
@@ -716,9 +716,9 @@ 
 	protected function _venue_editor_metaboxes() {
 		$this->verify_cpt_object();
 
-		add_meta_box( 'espresso_venue_address_options', __('Physical Location', 'event_espresso'), array( $this, 'venue_address_metabox'), $this->page_slug, 'side', 'default' );
-		add_meta_box( 'espresso_venue_gmap_options', __('Google Map', 'event_espresso'), array( $this, 'venue_gmap_metabox'), $this->page_slug, 'side', 'default' );
-		add_meta_box( 'espresso_venue_virtual_loc_options', __('Virtual Location', 'event_espresso'), array( $this, 'venue_virtual_loc_metabox'), $this->page_slug, 'side', 'default' );
+		add_meta_box('espresso_venue_address_options', __('Physical Location', 'event_espresso'), array($this, 'venue_address_metabox'), $this->page_slug, 'side', 'default');
+		add_meta_box('espresso_venue_gmap_options', __('Google Map', 'event_espresso'), array($this, 'venue_gmap_metabox'), $this->page_slug, 'side', 'default');
+		add_meta_box('espresso_venue_virtual_loc_options', __('Virtual Location', 'event_espresso'), array($this, 'venue_virtual_loc_metabox'), $this->page_slug, 'side', 'default');
 
 	}
 
@@ -726,23 +726,23 @@ 
 
 	public function venue_gmap_metabox() {
 		$template_args = array(
-			'vnu_enable_for_gmap' => EEH_Form_Fields::select_input('vnu_enable_for_gmap', $this->get_yes_no_values(), $this->_cpt_model_obj->enable_for_gmap() ),
+			'vnu_enable_for_gmap' => EEH_Form_Fields::select_input('vnu_enable_for_gmap', $this->get_yes_no_values(), $this->_cpt_model_obj->enable_for_gmap()),
 			'vnu_google_map_link' => $this->_cpt_model_obj->google_map_link(),
 			);
-		$template = EE_VENUES_TEMPLATE_PATH . 'venue_gmap_metabox_content.template.php';
-		EEH_Template::display_template( $template, $template_args );
+		$template = EE_VENUES_TEMPLATE_PATH.'venue_gmap_metabox_content.template.php';
+		EEH_Template::display_template($template, $template_args);
 	}
 
 
 
 	public function venue_address_metabox() {
 
-		$template_args['_venue'] =$this->_cpt_model_obj;
+		$template_args['_venue'] = $this->_cpt_model_obj;
 
 		$template_args['states_dropdown'] = EEH_Form_Fields::generate_form_input(
 			$QFI = new EE_Question_Form_Input(
-				EE_Question::new_instance( array( 'QST_display_text' => esc_html__( 'State', 'event_espresso' ), 'QST_system' => 'state' )),
-				EE_Answer::new_instance( array(  'ANS_value'=> $this->_cpt_model_obj->state_ID() )),
+				EE_Question::new_instance(array('QST_display_text' => esc_html__('State', 'event_espresso'), 'QST_system' => 'state')),
+				EE_Answer::new_instance(array('ANS_value'=> $this->_cpt_model_obj->state_ID())),
 				array(
 					'input_name' =>  'sta_id',
 					'input_id' => 'sta_id',
@@ -754,8 +754,8 @@ 
 		);
 		$template_args['countries_dropdown'] = EEH_Form_Fields::generate_form_input(
 			$QFI = new EE_Question_Form_Input(
-				EE_Question::new_instance( array( 'QST_display_text' => esc_html__( 'Country', 'event_espresso' ), 'QST_system' => 'country' )),
-				EE_Answer::new_instance( array(  'ANS_value'=> $this->_cpt_model_obj->country_ID() )),
+				EE_Question::new_instance(array('QST_display_text' => esc_html__('Country', 'event_espresso'), 'QST_system' => 'country')),
+				EE_Answer::new_instance(array('ANS_value'=> $this->_cpt_model_obj->country_ID())),
 				array(
 					'input_name' =>  'cnt_iso',
 					'input_id' => 'cnt_iso',
@@ -766,8 +766,8 @@ 
 			)
 		);
 
-		$template = EE_VENUES_TEMPLATE_PATH . 'venue_address_metabox_content.template.php';
-		EEH_Template::display_template( $template, $template_args );
+		$template = EE_VENUES_TEMPLATE_PATH.'venue_address_metabox_content.template.php';
+		EEH_Template::display_template($template, $template_args);
 	}
 
 
@@ -779,8 +779,8 @@ 
 		$template_args = array(
 			'_venue' => $this->_cpt_model_obj
 			);
-		$template = EE_VENUES_TEMPLATE_PATH . 'venue_virtual_location_metabox_content.template.php';
-		EEH_Template::display_template( $template, $template_args );
+		$template = EE_VENUES_TEMPLATE_PATH.'venue_virtual_location_metabox_content.template.php';
+		EEH_Template::display_template($template, $template_args);
 	}
 
 
@@ -803,52 +803,52 @@ 
 	 * @param  object $post    Post object (with "blessed" WP properties)
 	 * @return void
 	 */
-	protected function _insert_update_cpt_item( $post_id, $post ) {
+	protected function _insert_update_cpt_item($post_id, $post) {
 
-		if ( $post instanceof WP_Post && $post->post_type !== 'espresso_venues' ) {
-			return;// get out we're not processing the saving of venues.
+		if ($post instanceof WP_Post && $post->post_type !== 'espresso_venues') {
+			return; // get out we're not processing the saving of venues.
 		}
 
-		$wheres = array( $this->_venue_model->primary_key_name() => $post_id );
+		$wheres = array($this->_venue_model->primary_key_name() => $post_id);
 
 		$venue_values = array(
-			'VNU_address' => !empty( $this->_req_data['vnu_address'] ) ? $this->_req_data['vnu_address'] : NULL,
-			'VNU_address2' => !empty( $this->_req_data['vnu_address2'] ) ? $this->_req_data['vnu_address2'] : NULL,
-			'VNU_city' => !empty( $this->_req_data['vnu_city'] ) ? $this->_req_data['vnu_city'] : NULL,
-			'STA_ID' => !empty( $this->_req_data['sta_id'] ) ? $this->_req_data['sta_id'] : NULL,
-			'CNT_ISO' => !empty( $this->_req_data['cnt_iso'] ) ? $this->_req_data['cnt_iso'] : NULL,
-			'VNU_zip' => !empty( $this->_req_data['vnu_zip'] ) ? $this->_req_data['vnu_zip'] : NULL,
-			'VNU_phone' => !empty( $this->_req_data['vnu_phone'] ) ? $this->_req_data['vnu_phone'] : NULL,
-			'VNU_capacity' => !empty( $this->_req_data['vnu_capacity'] ) ? str_replace( ',', '', $this->_req_data['vnu_capacity'] ) : EE_INF,
-			'VNU_url' => !empty( $this->_req_data['vnu_url'] ) ? $this->_req_data['vnu_url'] : NULL,
-			'VNU_virtual_phone' => !empty( $this->_req_data['vnu_virtual_phone'] ) ? $this->_req_data['vnu_virtual_phone'] : NULL,
-			'VNU_virtual_url' => !empty( $this->_req_data['vnu_virtual_url'] ) ? $this->_req_data['vnu_virtual_url'] : NULL,
-			'VNU_enable_for_gmap' => !empty( $this->_req_data['vnu_enable_for_gmap'] ) ? TRUE : FALSE,
-			'VNU_google_map_link' => !empty( $this->_req_data['vnu_google_map_link'] ) ? $this->_req_data['vnu_google_map_link'] : NULL
+			'VNU_address' => ! empty($this->_req_data['vnu_address']) ? $this->_req_data['vnu_address'] : NULL,
+			'VNU_address2' => ! empty($this->_req_data['vnu_address2']) ? $this->_req_data['vnu_address2'] : NULL,
+			'VNU_city' => ! empty($this->_req_data['vnu_city']) ? $this->_req_data['vnu_city'] : NULL,
+			'STA_ID' => ! empty($this->_req_data['sta_id']) ? $this->_req_data['sta_id'] : NULL,
+			'CNT_ISO' => ! empty($this->_req_data['cnt_iso']) ? $this->_req_data['cnt_iso'] : NULL,
+			'VNU_zip' => ! empty($this->_req_data['vnu_zip']) ? $this->_req_data['vnu_zip'] : NULL,
+			'VNU_phone' => ! empty($this->_req_data['vnu_phone']) ? $this->_req_data['vnu_phone'] : NULL,
+			'VNU_capacity' => ! empty($this->_req_data['vnu_capacity']) ? str_replace(',', '', $this->_req_data['vnu_capacity']) : EE_INF,
+			'VNU_url' => ! empty($this->_req_data['vnu_url']) ? $this->_req_data['vnu_url'] : NULL,
+			'VNU_virtual_phone' => ! empty($this->_req_data['vnu_virtual_phone']) ? $this->_req_data['vnu_virtual_phone'] : NULL,
+			'VNU_virtual_url' => ! empty($this->_req_data['vnu_virtual_url']) ? $this->_req_data['vnu_virtual_url'] : NULL,
+			'VNU_enable_for_gmap' => ! empty($this->_req_data['vnu_enable_for_gmap']) ? TRUE : FALSE,
+			'VNU_google_map_link' => ! empty($this->_req_data['vnu_google_map_link']) ? $this->_req_data['vnu_google_map_link'] : NULL
 			);
 
 		//update venue
-		$success = $this->_venue_model->update( $venue_values, array( $wheres ) );
+		$success = $this->_venue_model->update($venue_values, array($wheres));
 
 		//get venue_object for other metaboxes that might be added via the filter... though it would seem to make sense to just use $this->_venue_model->get_one_by_ID( $post_id ).. i have to setup where conditions to override the filters in the model that filter out autodraft and inherit statuses so we GET the inherit id!
-		$get_one_where = array( $this->_venue_model->primary_key_name() => $post_id, 'status' => $post->post_status  );
-		$venue = $this->_venue_model->get_one( array( $get_one_where ) );
+		$get_one_where = array($this->_venue_model->primary_key_name() => $post_id, 'status' => $post->post_status);
+		$venue = $this->_venue_model->get_one(array($get_one_where));
 
 		//notice we've applied a filter for venue metabox callbacks but we don't actually have any default venue metaboxes in use.  So this is just here for addons to more easily hook into venue saves.
-		$venue_update_callbacks = apply_filters( 'FHEE__Venues_Admin_Page___insert_update_cpt_item__venue_update_callbacks', array() );
+		$venue_update_callbacks = apply_filters('FHEE__Venues_Admin_Page___insert_update_cpt_item__venue_update_callbacks', array());
 
 		$att_success = TRUE;
 
-		foreach ( $venue_update_callbacks as $v_callback ) {
-			$_succ = call_user_func_array( $v_callback, array( $venue,  $this->_req_data ) );
-			$att_success = !$att_success ? $att_success : $_succ; //if ANY of these updates fail then we want the appropriate global error message
+		foreach ($venue_update_callbacks as $v_callback) {
+			$_succ = call_user_func_array($v_callback, array($venue, $this->_req_data));
+			$att_success = ! $att_success ? $att_success : $_succ; //if ANY of these updates fail then we want the appropriate global error message
 		}
 
 		//any errors?
-		if ( $success && !$att_success ) {
-			EE_Error::add_error( __('Venue Details saved successfully but something went wrong with saving attachments.', 'event_espresso'), __FILE__, __FUNCTION__, __LINE__ );
-		} else if ( $success === FALSE ) {
-			EE_Error::add_error( __('Venue Details did not save successfully.', 'event_espresso'), __FILE__, __FUNCTION__, __LINE__ );
+		if ($success && ! $att_success) {
+			EE_Error::add_error(__('Venue Details saved successfully but something went wrong with saving attachments.', 'event_espresso'), __FILE__, __FUNCTION__, __LINE__);
+		} else if ($success === FALSE) {
+			EE_Error::add_error(__('Venue Details did not save successfully.', 'event_espresso'), __FILE__, __FUNCTION__, __LINE__);
 		}
 	}
 
@@ -856,9 +856,9 @@ 
 
 
 
-	public function trash_cpt_item( $post_id ) {
+	public function trash_cpt_item($post_id) {
 		$this->_req_data['VNU_ID'] = $post_id;
-		$this->_trash_or_restore_venue( 'trash', FALSE );
+		$this->_trash_or_restore_venue('trash', FALSE);
 	}
 
 
@@ -866,18 +866,18 @@ 
 
 
 
-	public function restore_cpt_item( $post_id ) {
+	public function restore_cpt_item($post_id) {
 		$this->_req_data['VNU_ID'] = $post_id;
-		$this->_trash_or_restore_venue( 'draft', FALSE );
+		$this->_trash_or_restore_venue('draft', FALSE);
 	}
 
 
 
 
 
-	public function delete_cpt_item( $post_id ) {
+	public function delete_cpt_item($post_id) {
 		$this->_req_data['VNU_ID'] = $post_id;
-		$this->_delete_venue( FALSE );
+		$this->_delete_venue(FALSE);
 	}
 
 
@@ -892,15 +892,15 @@ 
 
 
 
-	protected function _trash_or_restore_venue( $venue_status = 'trash', $redirect_after = TRUE ) {
-		$VNU_ID = isset( $this->_req_data['VNU_ID'] ) ? absint( $this->_req_data['VNU_ID'] ) : FALSE;
+	protected function _trash_or_restore_venue($venue_status = 'trash', $redirect_after = TRUE) {
+		$VNU_ID = isset($this->_req_data['VNU_ID']) ? absint($this->_req_data['VNU_ID']) : FALSE;
 
 		//loop thru venues
-		if ( $VNU_ID ) {
+		if ($VNU_ID) {
 			//clean status
-			$venue_status = sanitize_key( $venue_status );
+			$venue_status = sanitize_key($venue_status);
 			// grab status
-			if (!empty($venue_status)) {
+			if ( ! empty($venue_status)) {
 				$success = $this->_change_venue_status($VNU_ID, $venue_status);
 			} else {
 				$success = FALSE;
@@ -914,7 +914,7 @@ 
 		}
 		$action = $venue_status == 'trash' ? 'moved to the trash' : 'restored from the trash';
 
-		if ( $redirect_after )
+		if ($redirect_after)
 			$this->_redirect_after_action($success, 'Venue', $action, array('action' => 'default'));
 
 	}
@@ -923,11 +923,11 @@ 
 
 
 
-	protected function _trash_or_restore_venues( $venue_status = 'trash' ) {
+	protected function _trash_or_restore_venues($venue_status = 'trash') {
 		// clean status
 		$venue_status = sanitize_key($venue_status);
 		// grab status
-		if (!empty($venue_status)) {
+		if ( ! empty($venue_status)) {
 			$success = TRUE;
 			//determine the event id and set to array.
 			$VNU_IDs = isset($this->_req_data['venue_id']) ? (array) $this->_req_data['venue_id'] : array();
@@ -967,20 +967,20 @@ 
 	 * @param  string $venue_status
 	 * @return void
 	 */
-	private function _change_venue_status( $VNU_ID = 0, $venue_status = '' ) {
+	private function _change_venue_status($VNU_ID = 0, $venue_status = '') {
 		// grab venue id
-		if (! $VNU_ID) {
+		if ( ! $VNU_ID) {
 			$msg = __('An error occurred. No Venue ID or an invalid Venue ID was received.', 'event_espresso');
 			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
 			return FALSE;
 		}
 
-		$this->_cpt_model_obj = EEM_Venue::instance()->get_one_by_ID( $VNU_ID );
+		$this->_cpt_model_obj = EEM_Venue::instance()->get_one_by_ID($VNU_ID);
 
 		// clean status
 		$venue_status = sanitize_key($venue_status);
 		// grab status
-		if ( ! $venue_status ) {
+		if ( ! $venue_status) {
 			$msg = __('An error occurred. No Venue Status or an invalid Venue Status was received.', 'event_espresso');
 			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
 			return FALSE;
@@ -1001,7 +1001,7 @@ 
 				$hook = FALSE;
 		}
 		//use class to change status
-		$this->_cpt_model_obj->set_status( $venue_status );
+		$this->_cpt_model_obj->set_status($venue_status);
 		$success = $this->_cpt_model_obj->save();
 
 		if ($success === FALSE) {
@@ -1020,21 +1020,21 @@ 
 	 * @param  bool $redirect_after
 	 * @return void
 	 */
-	protected function _delete_venue( $redirect_after = true ) {
+	protected function _delete_venue($redirect_after = true) {
 		//determine the venue id and set to array.
 		$VNU_ID = isset($this->_req_data['VNU_ID']) ? absint($this->_req_data['VNU_ID']) : NULL;
-		$VNU_ID = isset( $this->_req_data['post'] ) ? absint( $this->_req_data['post'] ) : $VNU_ID;
+		$VNU_ID = isset($this->_req_data['post']) ? absint($this->_req_data['post']) : $VNU_ID;
 
 
 		// loop thru venues
 		if ($VNU_ID) {
-			$success = $this->_delete_or_trash_venue( $VNU_ID );
+			$success = $this->_delete_or_trash_venue($VNU_ID);
 		} else {
 			$success = FALSE;
 			$msg = __('An error occurred. An venue could not be deleted because a valid venue ID was not not supplied.', 'event_espresso');
 			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
 		}
-		if ( $redirect_after )
+		if ($redirect_after)
 			$this->_redirect_after_action($success, 'Venue', 'deleted', array('action' => 'default'));
 	}
 
@@ -1066,7 +1066,7 @@ 
 	//todo: put in parent
 	private function _delete_or_trash_venue($VNU_ID = FALSE) {
 		// grab event id
-		if (!$VNU_ID = absint($VNU_ID)) {
+		if ( ! $VNU_ID = absint($VNU_ID)) {
 			$msg = __('An error occurred. No Venue ID or an invalid Venue ID was received.', 'event_espresso');
 			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
 			return FALSE;
@@ -1086,7 +1086,7 @@ 
 			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
 			return FALSE;
 		}
-		do_action( 'AHEE__Venues_Admin_Page___delete_or_trash_venue__after_venue_deleted' );
+		do_action('AHEE__Venues_Admin_Page___delete_or_trash_venue__after_venue_deleted');
 		return TRUE;
 	}
 
@@ -1097,11 +1097,11 @@ 
 	/* QUERIES */
 
 
-	public function get_venues( $per_page = 10, $count = FALSE ) {
+	public function get_venues($per_page = 10, $count = FALSE) {
 
-		$_orderby = !empty( $this->_req_data['orderby'] ) ? $this->_req_data['orderby'] : '';
+		$_orderby = ! empty($this->_req_data['orderby']) ? $this->_req_data['orderby'] : '';
 
-		switch ( $_orderby ) {
+		switch ($_orderby) {
 			case 'id':
 				$orderby = 'VNU_ID';
 				break;
@@ -1119,43 +1119,43 @@ 
 		}
 
 
-		$sort = ( isset( $this->_req_data['order'] ) && ! empty( $this->_req_data['order'] )) ? $this->_req_data['order'] : 'ASC';
+		$sort = (isset($this->_req_data['order']) && ! empty($this->_req_data['order'])) ? $this->_req_data['order'] : 'ASC';
 
-		$current_page = isset( $this->_req_data['paged'] ) && !empty( $this->_req_data['paged'] ) ? $this->_req_data['paged'] : 1;
-		$per_page = isset( $per_page ) && !empty( $per_page ) ? $per_page : 10;
-		$per_page = isset( $this->_req_data['perpage'] ) && !empty( $this->_req_data['perpage'] ) ? $this->_req_data['perpage'] : $per_page;
+		$current_page = isset($this->_req_data['paged']) && ! empty($this->_req_data['paged']) ? $this->_req_data['paged'] : 1;
+		$per_page = isset($per_page) && ! empty($per_page) ? $per_page : 10;
+		$per_page = isset($this->_req_data['perpage']) && ! empty($this->_req_data['perpage']) ? $this->_req_data['perpage'] : $per_page;
 
 
-		$offset = ($current_page-1)*$per_page;
+		$offset = ($current_page - 1) * $per_page;
 		$limit = array($offset, $per_page);
 
-		$category = isset( $this->_req_data['category'] ) && $this->_req_data['category'] > 0 ? $this->_req_data['category'] : NULL;
+		$category = isset($this->_req_data['category']) && $this->_req_data['category'] > 0 ? $this->_req_data['category'] : NULL;
 		$where = array();
 
 		//only set initial status if it is in the incoming request.  Otherwise the "all" view display's all statuses.
-		if ( isset( $this->_req_data['status'] ) && $this->_req_data['status'] != 'all' ) {
+		if (isset($this->_req_data['status']) && $this->_req_data['status'] != 'all') {
 			$where['status'] = $this->_req_data['status'];
 		}
 
-		if ( isset( $this->_req_data['venue_status'] ) ) {
+		if (isset($this->_req_data['venue_status'])) {
 			$where['status'] = $this->_req_data['venue_status'];
 		}
 
 
-		if ( $category ) {
+		if ($category) {
 			$where['Term_Taxonomy.taxonomy'] = 'espresso_venue_categories';
 			$where['Term_Taxonomy.term_id'] = $category;
 		}
 
 
-		if ( ! EE_Registry::instance()->CAP->current_user_can( 'ee_read_others_venues', 'get_venues' ) ) {
-			$where['VNU_wp_user'] =  get_current_user_id();
+		if ( ! EE_Registry::instance()->CAP->current_user_can('ee_read_others_venues', 'get_venues')) {
+			$where['VNU_wp_user'] = get_current_user_id();
 		} else {
-				if ( ! EE_Registry::instance()->CAP->current_user_can( 'ee_read_private_venues', 'get_venues' ) ) {
+				if ( ! EE_Registry::instance()->CAP->current_user_can('ee_read_private_venues', 'get_venues')) {
 					$where['OR'] = array(
-						'status*restrict_private' => array( '!=', 'private' ),
+						'status*restrict_private' => array('!=', 'private'),
 						'AND'                     => array(
-							'status*inclusive' => array( '=', 'private' ),
+							'status*inclusive' => array('=', 'private'),
 							'VNU_wp_user'      => get_current_user_id()
 						)
 					);
@@ -1165,30 +1165,30 @@ 
 
 
 
-		if ( isset( $this->_req_data['s'] ) ) {
-			$sstr = '%' . $this->_req_data['s'] . '%';
+		if (isset($this->_req_data['s'])) {
+			$sstr = '%'.$this->_req_data['s'].'%';
 			$where['OR'] = array(
-				'VNU_name' => array('LIKE',$sstr ),
-				'VNU_desc' => array('LIKE',$sstr ),
-				'VNU_short_desc' => array( 'LIKE',$sstr ),
-				'VNU_address' => array( 'LIKE', $sstr ),
-				'VNU_address2' => array( 'LIKE', $sstr ),
-				'VNU_city' => array( 'LIKE', $sstr ),
-				'VNU_zip' => array( 'LIKE', $sstr ),
-				'VNU_phone' => array( 'LIKE', $sstr ),
-				'VNU_url' => array( 'LIKE', $sstr ),
-				'VNU_virtual_phone' => array( 'LIKE', $sstr ),
-				'VNU_virtual_url' => array( 'LIKE', $sstr ),
-				'VNU_google_map_link' => array( 'LIKE', $sstr ),
-				'Event.EVT_name' => array('LIKE', $sstr ),
-				'Event.EVT_desc' => array('LIKE', $sstr ),
-				'Event.EVT_phone' => array('LIKE', $sstr ),
-				'Event.EVT_external_URL' => array('LIKE', $sstr ),
+				'VNU_name' => array('LIKE', $sstr),
+				'VNU_desc' => array('LIKE', $sstr),
+				'VNU_short_desc' => array('LIKE', $sstr),
+				'VNU_address' => array('LIKE', $sstr),
+				'VNU_address2' => array('LIKE', $sstr),
+				'VNU_city' => array('LIKE', $sstr),
+				'VNU_zip' => array('LIKE', $sstr),
+				'VNU_phone' => array('LIKE', $sstr),
+				'VNU_url' => array('LIKE', $sstr),
+				'VNU_virtual_phone' => array('LIKE', $sstr),
+				'VNU_virtual_url' => array('LIKE', $sstr),
+				'VNU_google_map_link' => array('LIKE', $sstr),
+				'Event.EVT_name' => array('LIKE', $sstr),
+				'Event.EVT_desc' => array('LIKE', $sstr),
+				'Event.EVT_phone' => array('LIKE', $sstr),
+				'Event.EVT_external_URL' => array('LIKE', $sstr),
 				);
 		}
 
 
-		$venues = $count ? $this->_venue_model->count( array($where), 'VNU_ID' ) : $this->_venue_model->get_all( array( $where, 'limit' => $limit, 'order_by' => $orderby, 'order' => $sort ) );
+		$venues = $count ? $this->_venue_model->count(array($where), 'VNU_ID') : $this->_venue_model->get_all(array($where, 'limit' => $limit, 'order_by' => $orderby, 'order' => $sort));
 
 		return $venues;
 
@@ -1206,22 +1206,22 @@ 
 	 * @return void
 	 */
 	private function _set_category_object() {
-		if ( isset( $this->_category->id ) && !empty( $this->_category->id ) )
+		if (isset($this->_category->id) && ! empty($this->_category->id))
 			return; //already have the category object so get out.
 
 		//set default category object
 		$this->_set_empty_category_object();
 
 		//only set if we've got an id
-		if ( !isset($this->_req_data['VEN_CAT_ID'] ) ) {
+		if ( ! isset($this->_req_data['VEN_CAT_ID'])) {
 			return;
 		}
 
 		$category_id = absint($this->_req_data['VEN_CAT_ID']);
-		$term = get_term( $category_id, 'espresso_venue_categories' );
+		$term = get_term($category_id, 'espresso_venue_categories');
 
 
-		if ( !empty( $term ) ) {
+		if ( ! empty($term)) {
 			$this->_category->category_name = $term->name;
 			$this->_category->category_identifier = $term->slug;
 			$this->_category->category_desc = $term->description;
@@ -1235,15 +1235,15 @@ 
 
 	private function _set_empty_category_object() {
 		$this->_category = new stdClass();
-		$this->_category->category_name = $this->_category->category_identifier = $this->_category->category_desc  = '';
+		$this->_category->category_name = $this->_category->category_identifier = $this->_category->category_desc = '';
 		$this->_category->id = $this->_category->parent = 0;
 	}
 
 
 
 	protected function _category_list_table() {
-		do_action( 'AHEE_log', __FILE__, __FUNCTION__, '' );
-		$this->_admin_page_title .= ' ' . $this->get_action_link_or_button(
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
+		$this->_admin_page_title .= ' '.$this->get_action_link_or_button(
 		    'add_category',
             'add_category',
             array(),
@@ -1263,13 +1263,13 @@ 
 		$this->_set_add_edit_form_tags($route);
 
 		$this->_set_category_object();
-		$id = !empty($this->_category->id) ? $this->_category->id : '';
+		$id = ! empty($this->_category->id) ? $this->_category->id : '';
 
 		$delete_action = 'delete_category';
 
-		$redirect = EE_Admin_Page::add_query_args_and_nonce( array( 'action' => 'category_list' ), $this->_admin_base_url );
+		$redirect = EE_Admin_Page::add_query_args_and_nonce(array('action' => 'category_list'), $this->_admin_base_url);
 
-		$this->_set_publish_post_box_vars( 'VEN_CAT_ID', $id, $delete_action, $redirect );
+		$this->_set_publish_post_box_vars('VEN_CAT_ID', $id, $delete_action, $redirect);
 
 		//take care of contents
 		$this->_template_args['admin_page_content'] = $this->_category_details_content();
@@ -1283,25 +1283,25 @@ 
 			'type' => 'wp_editor',
 			'value' => EEH_Formatter::admin_format_content($this->_category->category_desc),
 			'class' => 'my_editor_custom',
-			'wpeditor_args' => array( 'media_buttons' => FALSE )
+			'wpeditor_args' => array('media_buttons' => FALSE)
 		);
-		$_wp_editor = $this->_generate_admin_form_fields( $editor_args, 'array' );
+		$_wp_editor = $this->_generate_admin_form_fields($editor_args, 'array');
 
-		$all_terms = get_terms( array('espresso_venue_categories' ), array( 'hide_empty' => 0, 'exclude' => array( $this->_category->id ) ) );
+		$all_terms = get_terms(array('espresso_venue_categories'), array('hide_empty' => 0, 'exclude' => array($this->_category->id)));
 
 		//setup category select for term parents.
 		$category_select_values[] = array(
 			'text' => __('No Parent', 'event_espresso'),
 			'id' => 0
 			);
-		foreach ( $all_terms as $term ) {
+		foreach ($all_terms as $term) {
 			$category_select_values[] = array(
 				'text' => $term->name,
 				'id' => $term->term_id
 				);
 		}
 
-		$category_select = EEH_Form_Fields::select_input( 'category_parent', $category_select_values, $this->_category->parent );
+		$category_select = EEH_Form_Fields::select_input('category_parent', $category_select_values, $this->_category->parent);
 		$template_args = array(
 			'category' => $this->_category,
 			'category_select' => $category_select,
@@ -1310,15 +1310,15 @@ 
 			'disable' => '',
 			'disabled_message' =>FALSE
 			);
-		$template = EVENTS_TEMPLATE_PATH . 'event_category_details.template.php';
-		return EEH_Template::display_template($template, $template_args, TRUE );
+		$template = EVENTS_TEMPLATE_PATH.'event_category_details.template.php';
+		return EEH_Template::display_template($template, $template_args, TRUE);
 	}
 
 
 	protected function _delete_categories() {
-		$cat_ids = isset( $this->_req_data['VEN_CAT_ID'] ) ? (array) $this->_req_data['VEN_CAT_ID'] : (array) $this->_req_data['category_id'];
+		$cat_ids = isset($this->_req_data['VEN_CAT_ID']) ? (array) $this->_req_data['VEN_CAT_ID'] : (array) $this->_req_data['category_id'];
 
-		foreach ( $cat_ids as $cat_id ) {
+		foreach ($cat_ids as $cat_id) {
 			$this->_delete_category($cat_id);
 		}
 
@@ -1326,7 +1326,7 @@ 
 		$query_args = array(
 			'action' => 'category_list'
 			);
-		$this->_redirect_after_action(0,'','',$query_args);
+		$this->_redirect_after_action(0, '', '', $query_args);
 
 	}
 
@@ -1335,58 +1335,58 @@ 
 
 
 	protected function _delete_category($cat_id) {
-		$cat_id = absint( $cat_id );
-		wp_delete_term( $cat_id, 'espresso_venue_categories' );
+		$cat_id = absint($cat_id);
+		wp_delete_term($cat_id, 'espresso_venue_categories');
 	}
 
 
 
 	protected function _insert_or_update_category($new_category) {
 
-		$cat_id = $new_category ? $this->_insert_category() : $this->_insert_category( TRUE );
+		$cat_id = $new_category ? $this->_insert_category() : $this->_insert_category(TRUE);
 		$success = 0; //we already have a success message so lets not send another.
-		if ( $cat_id ) {
+		if ($cat_id) {
 			$query_args = array(
 				'action'     => 'edit_category',
 				'VEN_CAT_ID' => $cat_id
 			);
 		} else {
-			$query_args = array( 'action' => 'add_category' );
+			$query_args = array('action' => 'add_category');
 		}
-		$this->_redirect_after_action( $success, '','', $query_args, TRUE );
+		$this->_redirect_after_action($success, '', '', $query_args, TRUE);
 
 	}
 
 
 
-	private function _insert_category( $update = FALSE ) {
+	private function _insert_category($update = FALSE) {
 		$cat_id = $update ? $this->_req_data['VEN_CAT_ID'] : '';
-		$category_name= isset( $this->_req_data['category_name'] ) ? $this->_req_data['category_name'] : '';
-		$category_desc= isset( $this->_req_data['category_desc'] ) ? $this->_req_data['category_desc'] : '';
-		$category_parent = isset( $this->_req_data['category_parent'] ) ? $this->_req_data['category_parent'] : 0;
+		$category_name = isset($this->_req_data['category_name']) ? $this->_req_data['category_name'] : '';
+		$category_desc = isset($this->_req_data['category_desc']) ? $this->_req_data['category_desc'] : '';
+		$category_parent = isset($this->_req_data['category_parent']) ? $this->_req_data['category_parent'] : 0;
 
-		if ( empty( $category_name ) ) {
-			$msg = __( 'You must add a name for the category.', 'event_espresso' );
-			EE_Error::add_error( $msg, __FILE__, __FUNCTION__, __LINE__ );
+		if (empty($category_name)) {
+			$msg = __('You must add a name for the category.', 'event_espresso');
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
 			return false;
 		}
 
 
-		$term_args=array(
+		$term_args = array(
 			'name'=>$category_name,
 			'description'=>$category_desc,
 			'parent'=>$category_parent
 		);
 
-		$insert_ids = $update ? wp_update_term( $cat_id, 'espresso_venue_categories', $term_args ) :wp_insert_term( $category_name, 'espresso_venue_categories', $term_args );
+		$insert_ids = $update ? wp_update_term($cat_id, 'espresso_venue_categories', $term_args) : wp_insert_term($category_name, 'espresso_venue_categories', $term_args);
 
-		if ( !is_array( $insert_ids ) ) {
-			$msg = __( 'An error occurred and the category has not been saved to the database.', 'event_espresso' );
-			EE_Error::add_error( $msg, __FILE__, __FUNCTION__, __LINE__ );
+		if ( ! is_array($insert_ids)) {
+			$msg = __('An error occurred and the category has not been saved to the database.', 'event_espresso');
+			EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
 		} else {
 			$cat_id = $insert_ids['term_id'];
-			$msg = sprintf ( __('The category %s was successfully created', 'event_espresso'), $category_name );
-			EE_Error::add_success( $msg );
+			$msg = sprintf(__('The category %s was successfully created', 'event_espresso'), $category_name);
+			EE_Error::add_success($msg);
 		}
 
 		return $cat_id;
@@ -1406,11 +1406,11 @@ 
 			'category_ids' => $this->_req_data['VEN_CAT_ID']
 			);
 
-		$this->_req_data = array_merge( $this->_req_data, $new_request_args );
+		$this->_req_data = array_merge($this->_req_data, $new_request_args);
 
-		if ( is_readable( EE_CLASSES . 'EE_Export.class.php') ) {
-			require_once( EE_CLASSES . 'EE_Export.class.php');
-			$EE_Export = EE_Export::instance( $this->_req_data );
+		if (is_readable(EE_CLASSES.'EE_Export.class.php')) {
+			require_once(EE_CLASSES.'EE_Export.class.php');
+			$EE_Export = EE_Export::instance($this->_req_data);
 			$EE_Export->export();
 		}
 
@@ -1422,7 +1422,7 @@ 
 
 	protected function _import_categories() {
 
-		require_once(EE_CLASSES . 'EE_Import.class.php');
+		require_once(EE_CLASSES.'EE_Import.class.php');
 		EE_Import::instance()->import();
 
 	}
@@ -1430,29 +1430,29 @@ 
 
 
 
-	public function get_categories( $per_page = 10, $current_page = 1, $count = FALSE ) {
+	public function get_categories($per_page = 10, $current_page = 1, $count = FALSE) {
 
 		//testing term stuff
-		$orderby = isset( $this->_req_data['orderby'] ) ? $this->_req_data['orderby'] : 'Term.term_id';
-		$order = isset( $this->_req_data['order'] ) ? $this->_req_data['order'] : 'DESC';
-		$limit = ($current_page-1)*$per_page;
-		$where = array( 'taxonomy' => 'espresso_venue_categories' );
-		if ( isset( $this->_req_data['s'] ) ) {
-			$sstr = '%' . $this->_req_data['s'] . '%';
+		$orderby = isset($this->_req_data['orderby']) ? $this->_req_data['orderby'] : 'Term.term_id';
+		$order = isset($this->_req_data['order']) ? $this->_req_data['order'] : 'DESC';
+		$limit = ($current_page - 1) * $per_page;
+		$where = array('taxonomy' => 'espresso_venue_categories');
+		if (isset($this->_req_data['s'])) {
+			$sstr = '%'.$this->_req_data['s'].'%';
 			$where['OR'] = array(
-				'Term.name' => array( 'LIKE', $sstr),
-				'description' => array( 'LIKE', $sstr )
+				'Term.name' => array('LIKE', $sstr),
+				'description' => array('LIKE', $sstr)
 				);
 		}
 
 		$query_params = array(
 			$where,
-			'order_by' => array( $orderby => $order ),
-			'limit' => $limit . ',' . $per_page,
+			'order_by' => array($orderby => $order),
+			'limit' => $limit.','.$per_page,
 			'force_join' => array('Term')
 			);
 
-		$categories = $count ? EEM_Term_Taxonomy::instance()->count( $query_params, 'term_id' ) :EEM_Term_Taxonomy::instance()->get_all( $query_params );
+		$categories = $count ? EEM_Term_Taxonomy::instance()->count($query_params, 'term_id') : EEM_Term_Taxonomy::instance()->get_all($query_params);
 
 		return $categories;
 	}

admin_pages/registrations/EE_Registrations_List_Table.class.php

Doc Comments +1 added lines, -1 removed lines

@@ -227,7 +227,7 @@
      *    _get_table_filters
      *
      * @access protected
-     * @return array
+     * @return string[]
      */
     protected function _get_table_filters()
     {

Spacing +27 added lines, -27 removed lines

@@ -157,7 +157,7 @@ 
         );
         $this->_primary_column = '_REG_ID';
         $this->_sortable_columns = array(
-            '_REG_date'     => array('_REG_date' => true),   //true means its already sorted
+            '_REG_date'     => array('_REG_date' => true), //true means its already sorted
             'ATT_fname'     => array('ATT_fname' => false),
             'event_name'    => array('event_name' => false),
             'DTT_EVT_start' => array('DTT_EVT_start' => false),
@@ -179,7 +179,7 @@ 
     {
         $class = parent::_get_row_class($item);
         //add status class
-        $class .= ' ee-status-strip reg-status-' . $item->status_ID();
+        $class .= ' ee-status-strip reg-status-'.$item->status_ID();
         if ($this->_has_checkbox_column) {
             $class .= ' has-checkbox-column';
         }
@@ -327,11 +327,11 @@ 
         //setup date query.
         $beginning_string = EEM_Registration::instance()
                                             ->convert_datetime_for_query('REG_date',
-                                                $this_year_r . '-' . $this_month_r . '-01' . ' ' . $time_start,
+                                                $this_year_r.'-'.$this_month_r.'-01'.' '.$time_start,
                                                 'Y-m-d H:i:s');
         $end_string = EEM_Registration::instance()
                                       ->convert_datetime_for_query('REG_date',
-                                          $this_year_r . '-' . $this_month_r . '-' . $days_this_month . ' ' . $time_end,
+                                          $this_year_r.'-'.$this_month_r.'-'.$days_this_month.' '.$time_end,
                                           'Y-m-d H:i:s');
         $_where['REG_date'] = array(
             'BETWEEN',
@@ -364,9 +364,9 @@ 
             'BETWEEN',
             array(
                 EEM_Registration::instance()
-                                ->convert_datetime_for_query('REG_date', $current_date . $time_start, 'Y-m-d H:i:s'),
+                                ->convert_datetime_for_query('REG_date', $current_date.$time_start, 'Y-m-d H:i:s'),
                 EEM_Registration::instance()
-                                ->convert_datetime_for_query('REG_date', $current_date . $time_end, 'Y-m-d H:i:s'),
+                                ->convert_datetime_for_query('REG_date', $current_date.$time_end, 'Y-m-d H:i:s'),
             ),
         );
         $_where['STS_ID'] = array('!=', EEM_Registration::status_id_incomplete);
@@ -410,8 +410,8 @@ 
         $content .= '<div class="show-on-mobile-view-only">';
         $content .= '<br>';
         $content .= $attendee instanceof EE_Attendee ? $attendee->full_name() : '';
-        $content .= '&nbsp;' . sprintf(__('(%1$s / %2$s)', 'event_espresso'), $item->count(), $item->group_size());
-        $content .= '<br>' . sprintf(__('Reg Code: %s', 'event_espresso'), $item->get('REG_code'));
+        $content .= '&nbsp;'.sprintf(__('(%1$s / %2$s)', 'event_espresso'), $item->count(), $item->group_size());
+        $content .= '<br>'.sprintf(__('Reg Code: %s', 'event_espresso'), $item->get('REG_code'));
         $content .= '</div>';
         return $content;
     }
@@ -482,10 +482,10 @@ 
                   . $event_name
                   . '</a>' : $event_name;
             $edit_event_url = EE_Admin_Page::add_query_args_and_nonce(array('event_id' => $EVT_ID), REG_ADMIN_URL);
-            $actions['event_filter'] = '<a href="' . $edit_event_url . '" title="';
+            $actions['event_filter'] = '<a href="'.$edit_event_url.'" title="';
             $actions['event_filter'] .= sprintf(esc_attr__('Filter this list to only show registrations for %s',
                 'event_espresso'), $event_name);
-            $actions['event_filter'] .= '">' . __('View Registrations', 'event_espresso') . '</a>';
+            $actions['event_filter'] .= '">'.__('View Registrations', 'event_espresso').'</a>';
         } else {
             $edit_event = $event_name;
             $actions['event_filter'] = '';
@@ -551,12 +551,12 @@ 
         $t = $item->get_first_related('Transaction');
         $payment_count = $t instanceof EE_Transaction ? $t->count_related('Payment') : 0;
         //append group count to name
-        $link .= '&nbsp;' . sprintf(__('(%1$s / %2$s)', 'event_espresso'), $item->count(), $item->group_size());
+        $link .= '&nbsp;'.sprintf(__('(%1$s / %2$s)', 'event_espresso'), $item->count(), $item->group_size());
         //append reg_code
-        $link .= '<br>' . sprintf(__('Reg Code: %s', 'event_espresso'), $item->get('REG_code'));
+        $link .= '<br>'.sprintf(__('Reg Code: %s', 'event_espresso'), $item->get('REG_code'));
         //reg status text for accessibility
-        $link .= '<br><span class="ee-status-text-small">' . EEH_Template::pretty_status($item->status_ID(), false,
-                'sentence') . '</span>';
+        $link .= '<br><span class="ee-status-text-small">'.EEH_Template::pretty_status($item->status_ID(), false,
+                'sentence').'</span>';
         //trash/restore/delete actions
         $actions = array();
         if ($this->_view !== 'trash'
@@ -568,8 +568,8 @@ 
                 'action'  => 'trash_registrations',
                 '_REG_ID' => $item->ID(),
             ), REG_ADMIN_URL);
-            $actions['trash'] = '<a href="' . $trash_lnk_url . '" title="' . esc_attr__('Trash Registration',
-                    'event_espresso') . '">' . __('Trash', 'event_espresso') . '</a>';
+            $actions['trash'] = '<a href="'.$trash_lnk_url.'" title="'.esc_attr__('Trash Registration',
+                    'event_espresso').'">'.__('Trash', 'event_espresso').'</a>';
         } elseif ($this->_view === 'trash') {
             // restore registration link
             if (EE_Registry::instance()->CAP->current_user_can('ee_delete_registration',
@@ -579,8 +579,8 @@ 
                     'action'  => 'restore_registrations',
                     '_REG_ID' => $item->ID(),
                 ), REG_ADMIN_URL);
-                $actions['restore'] = '<a href="' . $restore_lnk_url . '" title="' . esc_attr__('Restore Registration',
-                        'event_espresso') . '">' . __('Restore', 'event_espresso') . '</a>';
+                $actions['restore'] = '<a href="'.$restore_lnk_url.'" title="'.esc_attr__('Restore Registration',
+                        'event_espresso').'">'.__('Restore', 'event_espresso').'</a>';
             }
             if (EE_Registry::instance()->CAP->current_user_can('ee_delete_registration',
                 'espresso_registrations_ee_delete_registrations', $item->ID())
@@ -648,7 +648,7 @@ 
                                                                               . $ticket->name()
                                                                               . '</span><br />' : '';
         if ($item->final_price() > 0) {
-            $content .= '<span class="reg-pad-rght">' . $item->pretty_final_price() . '</span>';
+            $content .= '<span class="reg-pad-rght">'.$item->pretty_final_price().'</span>';
         } else {
             // free event
             $content .= '<span class="reg-overview-free-event-spn reg-pad-rght">'
@@ -675,7 +675,7 @@ 
             : '<span class="TKT_name">'
               . $ticket->name()
               . '</span><br />';
-        $content .= '<span class="reg-pad-rght">' . $item->pretty_final_price() . '</span>';
+        $content .= '<span class="reg-pad-rght">'.$item->pretty_final_price().'</span>';
         return $content;
     }
 
@@ -693,10 +693,10 @@ 
         $payment_method = $item->payment_method();
         $payment_method_name = $payment_method instanceof EE_Payment_Method ? $payment_method->admin_name()
             : __('Unknown', 'event_espresso');
-        $content = '<span class="reg-pad-rght">' . $item->pretty_paid() . '</span>';
+        $content = '<span class="reg-pad-rght">'.$item->pretty_paid().'</span>';
         if ($item->paid() > 0) {
-            $content .= '<br><span class="ee-status-text-small">' . sprintf(__('...via %s', 'event_espresso'),
-                    $payment_method_name) . '</span>';
+            $content .= '<br><span class="ee-status-text-small">'.sprintf(__('...via %s', 'event_espresso'),
+                    $payment_method_name).'</span>';
         }
         return $content;
     }
@@ -728,7 +728,7 @@ 
                   . esc_attr__('View Transaction', 'event_espresso')
                   . '">'
                   . $item->transaction()->pretty_total()
-                  . '</a></span>' : '<span class="reg-pad-rght">' . $item->transaction()->pretty_total() . '</span>';
+                  . '</a></span>' : '<span class="reg-pad-rght">'.$item->transaction()->pretty_total().'</span>';
         } else {
             return __("None", "event_espresso");
         }
@@ -765,7 +765,7 @@ 
                       . esc_attr__('View Transaction', 'event_espresso')
                       . '">'
                       . $item->transaction()->pretty_paid()
-                      . '</a><span>' : '<span class="reg-pad-rght">' . $item->transaction()->pretty_paid() . '</span>';
+                      . '</a><span>' : '<span class="reg-pad-rght">'.$item->transaction()->pretty_paid().'</span>';
             }
         }
         return '&nbsp;';
@@ -805,7 +805,7 @@ 
         $actions['view_lnk'] = EE_Registry::instance()->CAP->current_user_can('ee_read_registration',
             'espresso_registrations_view_registration', $item->ID()) ? '
 			<li>
-			<a href="' . $view_lnk_url . '" title="' . esc_attr__('View Registration Details', 'event_espresso') . '" class="tiny-text">
+			<a href="' . $view_lnk_url.'" title="'.esc_attr__('View Registration Details', 'event_espresso').'" class="tiny-text">
 				<div class="dashicons dashicons-clipboard"></div>
 			</a>
 			</li>' : '';
@@ -813,7 +813,7 @@ 
             'espresso_registrations_edit_attendee')
                                && $attendee instanceof EE_Attendee ? '
 			<li>
-			<a href="' . $edit_lnk_url . '" title="' . esc_attr__('Edit Contact Details', 'event_espresso') . '" class="tiny-text">
+			<a href="' . $edit_lnk_url.'" title="'.esc_attr__('Edit Contact Details', 'event_espresso').'" class="tiny-text">
 				<div class="ee-icon ee-icon-user-edit ee-icon-size-16"></div>
 			</a>
 			</li>' : '';

Indentation +818 added lines, -818 removed lines

@@ -1,5 +1,5 @@ 
 <?php if ( ! defined('EVENT_ESPRESSO_VERSION')) {
-    exit('No direct script access allowed');
+	exit('No direct script access allowed');
 }
 
 
@@ -26,847 +26,847 @@ 
 
 
 
-    private $_status;
-
-
-
-    /**
-     * An array of transaction details for the related transaction to the registration being processed.
-     * This is set via the _set_related_details method.
-     *
-     * @var array
-     */
-    protected $_transaction_details = array();
-
-
-
-    /**
-     * An array of event details for the related event to the registration being processed.
-     * This is set via the _set_related_details method.
-     *
-     * @var array
-     */
-    protected $_event_details = array();
-
-
-
-    /**
-     * @param \Registrations_Admin_Page $admin_page
-     */
-    public function __construct(Registrations_Admin_Page $admin_page)
-    {
-        if ( ! empty($_GET['event_id'])) {
-            $extra_query_args = array();
-            foreach ($admin_page->get_views() as $key => $view_details) {
-                $extra_query_args[$view_details['slug']] = array('event_id' => $_GET['event_id']);
-            }
-            $this->_views = $admin_page->get_list_table_view_RLs($extra_query_args);
-        }
-        parent::__construct($admin_page);
-        $this->_status = $this->_admin_page->get_registration_status_array();
-    }
-
-
-
-    /**
-     *    _setup_data
-     *
-     * @access protected
-     * @return void
-     */
-    protected function _setup_data()
-    {
-        $this->_data = $this->_admin_page->get_registrations($this->_per_page);
-        $this->_all_data_count = $this->_admin_page->get_registrations($this->_per_page, true, false, false);
-    }
-
-
-
-    /**
-     *    _set_properties
-     *
-     * @access protected
-     * @return void
-     */
-    protected function _set_properties()
-    {
-        $this->_wp_list_args = array(
-            'singular' => __('registration', 'event_espresso'),
-            'plural'   => __('registrations', 'event_espresso'),
-            'ajax'     => true,
-            'screen'   => $this->_admin_page->get_current_screen()->id,
-        );
-        $ID_column_name = __('ID', 'event_espresso');
-        $ID_column_name .= ' : <span class="show-on-mobile-view-only" style="float:none">';
-        $ID_column_name .= __('Registrant Name', 'event_espresso');
-        $ID_column_name .= '</span> ';
-        if (isset($_GET['event_id'])) {
-            $this->_columns = array(
-                'cb'               => '<input type="checkbox" />', //Render a checkbox instead of text
-                '_REG_ID'          => $ID_column_name,
-                'ATT_fname'        => __('Name', 'event_espresso'),
-                'ATT_email'        => __('Email', 'event_espresso'),
-                '_REG_date'        => __('Reg Date', 'event_espresso'),
-                'PRC_amount'       => __('TKT Price', 'event_espresso'),
-                '_REG_final_price' => __('Final Price', 'event_espresso'),
-                'TXN_total'        => __('Total Txn', 'event_espresso'),
-                'TXN_paid'         => __('Paid', 'event_espresso'),
-                'actions'          => __('Actions', 'event_espresso'),
-            );
-            $this->_bottom_buttons = array(
-                'report' => array(
-                    'route'         => 'registrations_report',
-                    'extra_request' => array(
-                        'EVT_ID'     => isset($this->_req_data['event_id']) ? $this->_req_data['event_id'] : null,
-                        'return_url' => urlencode("//{$_SERVER['HTTP_HOST']}{$_SERVER['REQUEST_URI']}"),
-                    ),
-                ),
-            );
-        } else {
-            $this->_columns = array(
-                'cb'               => '<input type="checkbox" />', //Render a checkbox instead of text
-                '_REG_ID'          => $ID_column_name,
-                'ATT_fname'        => __('Name', 'event_espresso'),
-                '_REG_date'        => __('TXN Date', 'event_espresso'),
-                'event_name'       => __('Event', 'event_espresso'),
-                'DTT_EVT_start'    => __('Event Date', 'event_espresso'),
-                '_REG_final_price' => __('Price', 'event_espresso'),
-                '_REG_paid'        => __('Paid', 'event_espresso'),
-                'actions'          => __('Actions', 'event_espresso'),
-            );
-            $this->_bottom_buttons = array(
-                'report_all' => array(
-                    'route'         => 'registrations_report',
-                    'extra_request' => array(
-                        'return_url' => urlencode("//{$_SERVER['HTTP_HOST']}{$_SERVER['REQUEST_URI']}"),
-                    ),
-                ),
-            );
-        }
-        $this->_primary_column = '_REG_ID';
-        $this->_sortable_columns = array(
-            '_REG_date'     => array('_REG_date' => true),   //true means its already sorted
-            'ATT_fname'     => array('ATT_fname' => false),
-            'event_name'    => array('event_name' => false),
-            'DTT_EVT_start' => array('DTT_EVT_start' => false),
-            '_REG_ID'       => array('_REG_ID' => false),
-        );
-        $this->_hidden_columns = array();
-    }
-
-
-
-    /**
-     * This simply sets up the row class for the table rows.
-     * Allows for easier overriding of child methods for setting up sorting.
-     *
-     * @param  EE_Registration $item the current item
-     * @return string
-     */
-    protected function _get_row_class($item)
-    {
-        $class = parent::_get_row_class($item);
-        //add status class
-        $class .= ' ee-status-strip reg-status-' . $item->status_ID();
-        if ($this->_has_checkbox_column) {
-            $class .= ' has-checkbox-column';
-        }
-        return $class;
-    }
-
-
-
-    /**
-     * Set the $_transaction_details property if not set yet.
-     *
-     * @param EE_Registration $registration
-     * @throws \EE_Error
-     */
-    protected function _set_related_details(EE_Registration $registration)
-    {
-        $transaction = $registration->get_first_related('Transaction');
-        $status = $transaction instanceof EE_Transaction ? $transaction->status_ID()
-            : EEM_Transaction::failed_status_code;
-        $this->_transaction_details = array(
-            'transaction' => $transaction,
-            'status'      => $status,
-            'id'          => $transaction instanceof EE_Transaction ? $transaction->ID() : 0,
-            'title_attr'  => sprintf(__('View Transaction Details (%s)', 'event_espresso'),
-                EEH_Template::pretty_status($status, false, 'sentence')),
-        );
-        try {
-            $event = $registration->event();
-        } catch (\EventEspresso\core\exceptions\EntityNotFoundException $e) {
-            $event = null;
-        }
-        $status = $event instanceof EE_Event ? $event->get_active_status() : EE_Datetime::inactive;
-        $this->_event_details = array(
-            'event'      => $event,
-            'status'     => $status,
-            'id'         => $event instanceof EE_Event ? $event->ID() : 0,
-            'title_attr' => sprintf(__('Edit Event (%s)', 'event_espresso'),
-                EEH_Template::pretty_status($status, false, 'sentence')),
-        );
-    }
-
-
-
-    /**
-     *    _get_table_filters
-     *
-     * @access protected
-     * @return array
-     */
-    protected function _get_table_filters()
-    {
-        $filters = array();
-        //todo we're currently using old functions here. We need to move things into the Events_Admin_Page() class as methods.
-        $cur_date = isset($this->_req_data['month_range']) ? $this->_req_data['month_range'] : '';
-        $cur_category = isset($this->_req_data['EVT_CAT']) ? $this->_req_data['EVT_CAT'] : -1;
-        $reg_status = isset($this->_req_data['_reg_status']) ? $this->_req_data['_reg_status'] : '';
-        $filters[] = EEH_Form_Fields::generate_registration_months_dropdown($cur_date, $reg_status, $cur_category);
-        $filters[] = EEH_Form_Fields::generate_event_category_dropdown($cur_category);
-        $status = array();
-        $status[] = array('id' => 0, 'text' => __('Select Status', 'event_espresso'));
-        foreach ($this->_status as $key => $value) {
-            $status[] = array('id' => $key, 'text' => $value);
-        }
-        if ($this->_view !== 'incomplete') {
-            $filters[] = EEH_Form_Fields::select_input('_reg_status', $status,
-                isset($this->_req_data['_reg_status']) ? strtoupper(sanitize_key($this->_req_data['_reg_status']))
-                    : '');
-        }
-        if (isset($this->_req_data['event_id'])) {
-            $filters[] = EEH_Form_Fields::hidden_input('event_id', $this->_req_data['event_id'], 'reg_event_id');
-        }
-        return $filters;
-    }
-
-
-
-    /**
-     *    _add_view_counts
-     *
-     * @access protected
-     * @return void
-     * @throws \EE_Error
-     */
-    protected function _add_view_counts()
-    {
-        $this->_views['all']['count'] = $this->_total_registrations();
-        $this->_views['month']['count'] = $this->_total_registrations_this_month();
-        $this->_views['today']['count'] = $this->_total_registrations_today();
-        if (EE_Registry::instance()->CAP->current_user_can('ee_delete_registrations',
-            'espresso_registrations_trash_registrations')
-        ) {
-            $this->_views['incomplete']['count'] = $this->_total_registrations('incomplete');
-            $this->_views['trash']['count'] = $this->_total_registrations('trash');
-        }
-    }
-
-
-
-    /**
-     * _total_registrations
-     *
-     * @access protected
-     * @param string $view
-     * @return int
-     * @throws \EE_Error
-     */
-    protected function _total_registrations($view = '')
-    {
-        $_where = array();
-        $EVT_ID = isset($this->_req_data['event_id']) ? absint($this->_req_data['event_id']) : false;
-        if ($EVT_ID) {
-            $_where['EVT_ID'] = $EVT_ID;
-        }
-        switch ($view) {
-            case 'trash' :
-                return EEM_Registration::instance()->count_deleted(array($_where));
-                break;
-            case 'incomplete' :
-                $_where['STS_ID'] = EEM_Registration::status_id_incomplete;
-                break;
-            default :
-                $_where['STS_ID'] = array('!=', EEM_Registration::status_id_incomplete);
-        }
-        return EEM_Registration::instance()->count(array($_where));
-    }
-
-
-
-    /**
-     * _total_registrations_this_month
-     *
-     * @access protected
-     * @return int
-     * @throws \EE_Error
-     */
-    protected function _total_registrations_this_month()
-    {
-        $EVT_ID = isset($this->_req_data['event_id']) ? absint($this->_req_data['event_id']) : false;
-        $_where = $EVT_ID ? array('EVT_ID' => $EVT_ID) : array();
-        $this_year_r = date('Y', current_time('timestamp'));
-        $time_start = ' 00:00:00';
-        $time_end = ' 23:59:59';
-        $this_month_r = date('m', current_time('timestamp'));
-        $days_this_month = date('t', current_time('timestamp'));
-        //setup date query.
-        $beginning_string = EEM_Registration::instance()
-                                            ->convert_datetime_for_query('REG_date',
-                                                $this_year_r . '-' . $this_month_r . '-01' . ' ' . $time_start,
-                                                'Y-m-d H:i:s');
-        $end_string = EEM_Registration::instance()
-                                      ->convert_datetime_for_query('REG_date',
-                                          $this_year_r . '-' . $this_month_r . '-' . $days_this_month . ' ' . $time_end,
-                                          'Y-m-d H:i:s');
-        $_where['REG_date'] = array(
-            'BETWEEN',
-            array(
-                $beginning_string,
-                $end_string,
-            ),
-        );
-        $_where['STS_ID'] = array('!=', EEM_Registration::status_id_incomplete);
-        return EEM_Registration::instance()->count(array($_where));
-    }
-
-
-
-    /**
-     * _total_registrations_today
-     *
-     * @access protected
-     * @return int
-     * @throws \EE_Error
-     */
-    protected function _total_registrations_today()
-    {
-        $EVT_ID = isset($this->_req_data['event_id']) ? absint($this->_req_data['event_id']) : false;
-        $_where = $EVT_ID ? array('EVT_ID' => $EVT_ID) : array();
-        $current_date = date('Y-m-d', current_time('timestamp'));
-        $time_start = ' 00:00:00';
-        $time_end = ' 23:59:59';
-        $_where['REG_date'] = array(
-            'BETWEEN',
-            array(
-                EEM_Registration::instance()
-                                ->convert_datetime_for_query('REG_date', $current_date . $time_start, 'Y-m-d H:i:s'),
-                EEM_Registration::instance()
-                                ->convert_datetime_for_query('REG_date', $current_date . $time_end, 'Y-m-d H:i:s'),
-            ),
-        );
-        $_where['STS_ID'] = array('!=', EEM_Registration::status_id_incomplete);
-        return EEM_Registration::instance()->count(array($_where));
-    }
-
-
-
-    /**
-     * column_cb
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     * @throws \EE_Error
-     */
-    public function column_cb($item)
-    {
-        /** checkbox/lock **/
-        $transaction = $item->get_first_related('Transaction');
-        $payment_count = $transaction instanceof EE_Transaction ? $transaction->count_related('Payment') : 0;
-        return $payment_count > 0 ? sprintf('<input type="checkbox" name="_REG_ID[]" value="%1$s" />', $item->ID())
-                                    . '<span class="ee-lock-icon"></span>'
-            : sprintf('<input type="checkbox" name="_REG_ID[]" value="%1$s" />', $item->ID());
-    }
-
-
-
-    /**
-     * column__REG_ID
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     * @throws \EE_Error
-     */
-    public function column__REG_ID(EE_Registration $item)
-    {
-        $attendee = $item->attendee();
-        $content = $item->ID();
-        $content .= '<div class="show-on-mobile-view-only">';
-        $content .= '<br>';
-        $content .= $attendee instanceof EE_Attendee ? $attendee->full_name() : '';
-        $content .= '&nbsp;' . sprintf(__('(%1$s / %2$s)', 'event_espresso'), $item->count(), $item->group_size());
-        $content .= '<br>' . sprintf(__('Reg Code: %s', 'event_espresso'), $item->get('REG_code'));
-        $content .= '</div>';
-        return $content;
-    }
-
-
-
-    /**
-     * column__REG_date
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     * @throws \EE_Error
-     */
-    public function column__REG_date(EE_Registration $item)
-    {
-        $this->_set_related_details($item);
-        //Build row actions
-        $view_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
-            'action' => 'view_transaction',
-            'TXN_ID' => $this->_transaction_details['id'],
-        ), TXN_ADMIN_URL);
-        $view_link = EE_Registry::instance()->CAP->current_user_can('ee_read_transaction',
-            'espresso_transactions_view_transaction') ? '<a class="ee-status-color-'
-                                                        . $this->_transaction_details['status']
-                                                        . '" href="'
-                                                        . $view_lnk_url
-                                                        . '" title="'
-                                                        . esc_attr($this->_transaction_details['title_attr'])
-                                                        . '">'
-                                                        . $item->get_i18n_datetime('REG_date')
-                                                        . '</a>' : $item->get_i18n_datetime('REG_date');
-        $view_link .= '<br><span class="ee-status-text-small">'
-                      . EEH_Template::pretty_status($this->_transaction_details['status'], false, 'sentence')
-                      . '</span>';
-        return $view_link;
-    }
-
-
-
-    /**
-     * column_event_name
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     * @throws \EE_Error
-     */
-    public function column_event_name(EE_Registration $item)
-    {
-        $this->_set_related_details($item);
-        // page=espresso_events&action=edit_event&EVT_ID=2&edit_event_nonce=cf3a7e5b62
-        $EVT_ID = $item->event_ID();
-        $event_name = $item->event_name();
-        $event_name = $event_name ? $event_name : __("No Associated Event", 'event_espresso');
-        $event_name = wp_trim_words($event_name, 30, '...');
-        if ($EVT_ID) {
-            $edit_event_url = EE_Admin_Page::add_query_args_and_nonce(array('action' => 'edit', 'post' => $EVT_ID),
-                EVENTS_ADMIN_URL);
-            $edit_event = EE_Registry::instance()->CAP->current_user_can('ee_edit_event', 'edit_event', $EVT_ID)
-                ? '<a class="ee-status-color-'
-                  . $this->_event_details['status']
-                  . '" href="'
-                  . $edit_event_url
-                  . '" title="'
-                  . esc_attr($this->_event_details['title_attr'])
-                  . '">'
-                  . $event_name
-                  . '</a>' : $event_name;
-            $edit_event_url = EE_Admin_Page::add_query_args_and_nonce(array('event_id' => $EVT_ID), REG_ADMIN_URL);
-            $actions['event_filter'] = '<a href="' . $edit_event_url . '" title="';
-            $actions['event_filter'] .= sprintf(esc_attr__('Filter this list to only show registrations for %s',
-                'event_espresso'), $event_name);
-            $actions['event_filter'] .= '">' . __('View Registrations', 'event_espresso') . '</a>';
-        } else {
-            $edit_event = $event_name;
-            $actions['event_filter'] = '';
-        }
-        return sprintf('%1$s %2$s', $edit_event, $this->row_actions($actions));
-    }
-
-
-
-    /**
-     * column_DTT_EVT_start
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     * @throws \EE_Error
-     */
-    public function column_DTT_EVT_start(EE_Registration $item)
-    {
-        $datetime_strings = array();
-        $ticket = $item->ticket(true);
-        if ($ticket instanceof EE_Ticket) {
-            $remove_defaults = array('default_where_conditions' => 'none');
-            $datetimes = $ticket->datetimes($remove_defaults);
-            foreach ($datetimes as $datetime) {
-                $datetime_strings[] = $datetime->get_i18n_datetime('DTT_EVT_start');
-            }
-            return implode("<br />", $datetime_strings);
-        } else {
-            return __('There is no ticket on this registration', 'event_espresso');
-        }
-    }
-
-
-
-    /**
-     * column_ATT_fname
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     * @throws \EE_Error
-     */
-    public function column_ATT_fname(EE_Registration $item)
-    {
-        $attendee = $item->attendee();
-        $edit_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
-            'action'  => 'view_registration',
-            '_REG_ID' => $item->ID(),
-        ), REG_ADMIN_URL);
-        $attendee_name = $attendee instanceof EE_Attendee ? $attendee->full_name() : '';
-        $link = EE_Registry::instance()->CAP->current_user_can('ee_read_registration',
-            'espresso_registrations_view_registration', $item->ID()) ? '<a href="'
-                                                                       . $edit_lnk_url
-                                                                       . '" title="'
-                                                                       . esc_attr__('View Registration Details',
-                'event_espresso')
-                                                                       . '">'
-                                                                       . $attendee_name
-                                                                       . '</a>' : $attendee_name;
-        $link .= $item->count() === 1
-            ? '&nbsp;<sup><div class="dashicons dashicons-star-filled lt-blue-icon ee-icon-size-8"></div></sup>' : '';
-        $t = $item->get_first_related('Transaction');
-        $payment_count = $t instanceof EE_Transaction ? $t->count_related('Payment') : 0;
-        //append group count to name
-        $link .= '&nbsp;' . sprintf(__('(%1$s / %2$s)', 'event_espresso'), $item->count(), $item->group_size());
-        //append reg_code
-        $link .= '<br>' . sprintf(__('Reg Code: %s', 'event_espresso'), $item->get('REG_code'));
-        //reg status text for accessibility
-        $link .= '<br><span class="ee-status-text-small">' . EEH_Template::pretty_status($item->status_ID(), false,
-                'sentence') . '</span>';
-        //trash/restore/delete actions
-        $actions = array();
-        if ($this->_view !== 'trash'
-            && $payment_count === 0
-            && EE_Registry::instance()->CAP->current_user_can('ee_delete_registration',
-                'espresso_registrations_trash_registrations', $item->ID())
-        ) {
-            $trash_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
-                'action'  => 'trash_registrations',
-                '_REG_ID' => $item->ID(),
-            ), REG_ADMIN_URL);
-            $actions['trash'] = '<a href="' . $trash_lnk_url . '" title="' . esc_attr__('Trash Registration',
-                    'event_espresso') . '">' . __('Trash', 'event_espresso') . '</a>';
-        } elseif ($this->_view === 'trash') {
-            // restore registration link
-            if (EE_Registry::instance()->CAP->current_user_can('ee_delete_registration',
-                'espresso_registrations_restore_registrations', $item->ID())
-            ) {
-                $restore_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
-                    'action'  => 'restore_registrations',
-                    '_REG_ID' => $item->ID(),
-                ), REG_ADMIN_URL);
-                $actions['restore'] = '<a href="' . $restore_lnk_url . '" title="' . esc_attr__('Restore Registration',
-                        'event_espresso') . '">' . __('Restore', 'event_espresso') . '</a>';
-            }
-            if (EE_Registry::instance()->CAP->current_user_can('ee_delete_registration',
-                'espresso_registrations_ee_delete_registrations', $item->ID())
-            ) {
-                $delete_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
-                    'action'  => 'delete_registrations',
-                    '_REG_ID' => $item->ID(),
-                ), REG_ADMIN_URL);
-                $actions['delete'] = '<a href="'
-                                     . $delete_lnk_url
-                                     . '" title="'
-                                     . esc_attr__('Delete Registration Permanently', 'event_espresso')
-                                     . '">'
-                                     . __('Delete', 'event_espresso')
-                                     . '</a>';
-            }
-        }
-        return sprintf('%1$s %2$s', $link, $this->row_actions($actions));
-    }
-
-
-
-    /**
-     * column_ATT_email
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     * @throws \EE_Error
-     */
-    public function column_ATT_email(EE_Registration $item)
-    {
-        $attendee = $item->get_first_related('Attendee');
-        return ! $attendee instanceof EE_Attendee ? __('No attached contact record.', 'event_espresso')
-            : $attendee->email();
-    }
-
-
-
-    /**
-     * column__REG_count
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     */
-    public function column__REG_count(EE_Registration $item)
-    {
-        return sprintf(__('%1$s / %2$s', 'event_espresso'), $item->count(), $item->group_size());
-    }
-
-
-
-    /**
-     * column_PRC_amount
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     */
-    public function column_PRC_amount(EE_Registration $item)
-    {
-        $ticket = $item->ticket();
-        $content = isset($_GET['event_id']) && $ticket instanceof EE_Ticket ? '<span class="TKT_name">'
-                                                                              . $ticket->name()
-                                                                              . '</span><br />' : '';
-        if ($item->final_price() > 0) {
-            $content .= '<span class="reg-pad-rght">' . $item->pretty_final_price() . '</span>';
-        } else {
-            // free event
-            $content .= '<span class="reg-overview-free-event-spn reg-pad-rght">'
-                        . __('free', 'event_espresso')
-                        . '</span>';
-        }
-        return $content;
-    }
-
-
-
-    /**
-     * column__REG_final_price
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     */
-    public function column__REG_final_price(EE_Registration $item)
-    {
-        $ticket = $item->ticket();
-        $content = isset($_GET['event_id']) || ! $ticket instanceof EE_Ticket
-            ? ''
-            : '<span class="TKT_name">'
-              . $ticket->name()
-              . '</span><br />';
-        $content .= '<span class="reg-pad-rght">' . $item->pretty_final_price() . '</span>';
-        return $content;
-    }
-
-
-
-    /**
-     * column__REG_paid
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     */
-    public function column__REG_paid(EE_Registration $item)
-    {
-        $payment_method = $item->payment_method();
-        $payment_method_name = $payment_method instanceof EE_Payment_Method ? $payment_method->admin_name()
-            : __('Unknown', 'event_espresso');
-        $content = '<span class="reg-pad-rght">' . $item->pretty_paid() . '</span>';
-        if ($item->paid() > 0) {
-            $content .= '<br><span class="ee-status-text-small">' . sprintf(__('...via %s', 'event_espresso'),
-                    $payment_method_name) . '</span>';
-        }
-        return $content;
-    }
-
-
-
-    /**
-     * column_TXN_total
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     * @throws \EE_Error
-     */
-    public function column_TXN_total(EE_Registration $item)
-    {
-        if ($item->transaction()) {
-            $view_txn_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
-                'action' => 'view_transaction',
-                'TXN_ID' => $item->transaction_ID(),
-            ), TXN_ADMIN_URL);
-            return EE_Registry::instance()->CAP->current_user_can('ee_read_transaction',
-                'espresso_transactions_view_transaction', $item->transaction_ID())
-                ? '<span class="reg-pad-rght"><a class="status-'
-                  . $item->transaction()->status_ID()
-                  . '" href="'
-                  . $view_txn_lnk_url
-                  . '"  title="'
-                  . esc_attr__('View Transaction', 'event_espresso')
-                  . '">'
-                  . $item->transaction()->pretty_total()
-                  . '</a></span>' : '<span class="reg-pad-rght">' . $item->transaction()->pretty_total() . '</span>';
-        } else {
-            return __("None", "event_espresso");
-        }
-    }
-
-
-
-    /**
-     * column_TXN_paid
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     * @throws \EE_Error
-     */
-    public function column_TXN_paid(EE_Registration $item)
-    {
-        if ($item->count() === 1) {
-            $transaction = $item->transaction() ? $item->transaction() : EE_Transaction::new_instance();
-            if ($transaction->paid() >= $transaction->total()) {
-                return '<span class="reg-pad-rght"><div class="dashicons dashicons-yes green-icon"></div></span>';
-            } else {
-                $view_txn_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
-                    'action' => 'view_transaction',
-                    'TXN_ID' => $item->transaction_ID(),
-                ), TXN_ADMIN_URL);
-                return EE_Registry::instance()->CAP->current_user_can('ee_read_transaction',
-                    'espresso_transactions_view_transaction', $item->transaction_ID())
-                    ? '<span class="reg-pad-rght"><a class="status-'
-                      . $transaction->status_ID()
-                      . '" href="'
-                      . $view_txn_lnk_url
-                      . '"  title="'
-                      . esc_attr__('View Transaction', 'event_espresso')
-                      . '">'
-                      . $item->transaction()->pretty_paid()
-                      . '</a><span>' : '<span class="reg-pad-rght">' . $item->transaction()->pretty_paid() . '</span>';
-            }
-        }
-        return '&nbsp;';
-    }
-
-
-
-    /**
-     * column_actions
-     *
-     * @access public
-     * @param \EE_Registration $item
-     * @return string
-     * @throws \EE_Error
-     */
-    public function column_actions(EE_Registration $item)
-    {
-        $actions = array();
-        $attendee = $item->attendee();
-        $this->_set_related_details($item);
-        //Build row actions
-        $view_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
-            'action'  => 'view_registration',
-            '_REG_ID' => $item->ID(),
-        ), REG_ADMIN_URL);
-        $edit_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
-            'action' => 'edit_attendee',
-            'post'   => $item->attendee_ID(),
-        ), REG_ADMIN_URL);
-        // page=attendees&event_admin_reports=resend_email&registration_id=43653465634&event_id=2&form_action=resend_email
-        //$resend_reg_lnk_url_params = array( 'action'=>'resend_registration', '_REG_ID'=>$item->REG_ID );
-        $resend_reg_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
-            'action'  => 'resend_registration',
-            '_REG_ID' => $item->ID(),
-        ), REG_ADMIN_URL, true);
-        //Build row actions
-        $actions['view_lnk'] = EE_Registry::instance()->CAP->current_user_can('ee_read_registration',
-            'espresso_registrations_view_registration', $item->ID()) ? '
+	private $_status;
+
+
+
+	/**
+	 * An array of transaction details for the related transaction to the registration being processed.
+	 * This is set via the _set_related_details method.
+	 *
+	 * @var array
+	 */
+	protected $_transaction_details = array();
+
+
+
+	/**
+	 * An array of event details for the related event to the registration being processed.
+	 * This is set via the _set_related_details method.
+	 *
+	 * @var array
+	 */
+	protected $_event_details = array();
+
+
+
+	/**
+	 * @param \Registrations_Admin_Page $admin_page
+	 */
+	public function __construct(Registrations_Admin_Page $admin_page)
+	{
+		if ( ! empty($_GET['event_id'])) {
+			$extra_query_args = array();
+			foreach ($admin_page->get_views() as $key => $view_details) {
+				$extra_query_args[$view_details['slug']] = array('event_id' => $_GET['event_id']);
+			}
+			$this->_views = $admin_page->get_list_table_view_RLs($extra_query_args);
+		}
+		parent::__construct($admin_page);
+		$this->_status = $this->_admin_page->get_registration_status_array();
+	}
+
+
+
+	/**
+	 *    _setup_data
+	 *
+	 * @access protected
+	 * @return void
+	 */
+	protected function _setup_data()
+	{
+		$this->_data = $this->_admin_page->get_registrations($this->_per_page);
+		$this->_all_data_count = $this->_admin_page->get_registrations($this->_per_page, true, false, false);
+	}
+
+
+
+	/**
+	 *    _set_properties
+	 *
+	 * @access protected
+	 * @return void
+	 */
+	protected function _set_properties()
+	{
+		$this->_wp_list_args = array(
+			'singular' => __('registration', 'event_espresso'),
+			'plural'   => __('registrations', 'event_espresso'),
+			'ajax'     => true,
+			'screen'   => $this->_admin_page->get_current_screen()->id,
+		);
+		$ID_column_name = __('ID', 'event_espresso');
+		$ID_column_name .= ' : <span class="show-on-mobile-view-only" style="float:none">';
+		$ID_column_name .= __('Registrant Name', 'event_espresso');
+		$ID_column_name .= '</span> ';
+		if (isset($_GET['event_id'])) {
+			$this->_columns = array(
+				'cb'               => '<input type="checkbox" />', //Render a checkbox instead of text
+				'_REG_ID'          => $ID_column_name,
+				'ATT_fname'        => __('Name', 'event_espresso'),
+				'ATT_email'        => __('Email', 'event_espresso'),
+				'_REG_date'        => __('Reg Date', 'event_espresso'),
+				'PRC_amount'       => __('TKT Price', 'event_espresso'),
+				'_REG_final_price' => __('Final Price', 'event_espresso'),
+				'TXN_total'        => __('Total Txn', 'event_espresso'),
+				'TXN_paid'         => __('Paid', 'event_espresso'),
+				'actions'          => __('Actions', 'event_espresso'),
+			);
+			$this->_bottom_buttons = array(
+				'report' => array(
+					'route'         => 'registrations_report',
+					'extra_request' => array(
+						'EVT_ID'     => isset($this->_req_data['event_id']) ? $this->_req_data['event_id'] : null,
+						'return_url' => urlencode("//{$_SERVER['HTTP_HOST']}{$_SERVER['REQUEST_URI']}"),
+					),
+				),
+			);
+		} else {
+			$this->_columns = array(
+				'cb'               => '<input type="checkbox" />', //Render a checkbox instead of text
+				'_REG_ID'          => $ID_column_name,
+				'ATT_fname'        => __('Name', 'event_espresso'),
+				'_REG_date'        => __('TXN Date', 'event_espresso'),
+				'event_name'       => __('Event', 'event_espresso'),
+				'DTT_EVT_start'    => __('Event Date', 'event_espresso'),
+				'_REG_final_price' => __('Price', 'event_espresso'),
+				'_REG_paid'        => __('Paid', 'event_espresso'),
+				'actions'          => __('Actions', 'event_espresso'),
+			);
+			$this->_bottom_buttons = array(
+				'report_all' => array(
+					'route'         => 'registrations_report',
+					'extra_request' => array(
+						'return_url' => urlencode("//{$_SERVER['HTTP_HOST']}{$_SERVER['REQUEST_URI']}"),
+					),
+				),
+			);
+		}
+		$this->_primary_column = '_REG_ID';
+		$this->_sortable_columns = array(
+			'_REG_date'     => array('_REG_date' => true),   //true means its already sorted
+			'ATT_fname'     => array('ATT_fname' => false),
+			'event_name'    => array('event_name' => false),
+			'DTT_EVT_start' => array('DTT_EVT_start' => false),
+			'_REG_ID'       => array('_REG_ID' => false),
+		);
+		$this->_hidden_columns = array();
+	}
+
+
+
+	/**
+	 * This simply sets up the row class for the table rows.
+	 * Allows for easier overriding of child methods for setting up sorting.
+	 *
+	 * @param  EE_Registration $item the current item
+	 * @return string
+	 */
+	protected function _get_row_class($item)
+	{
+		$class = parent::_get_row_class($item);
+		//add status class
+		$class .= ' ee-status-strip reg-status-' . $item->status_ID();
+		if ($this->_has_checkbox_column) {
+			$class .= ' has-checkbox-column';
+		}
+		return $class;
+	}
+
+
+
+	/**
+	 * Set the $_transaction_details property if not set yet.
+	 *
+	 * @param EE_Registration $registration
+	 * @throws \EE_Error
+	 */
+	protected function _set_related_details(EE_Registration $registration)
+	{
+		$transaction = $registration->get_first_related('Transaction');
+		$status = $transaction instanceof EE_Transaction ? $transaction->status_ID()
+			: EEM_Transaction::failed_status_code;
+		$this->_transaction_details = array(
+			'transaction' => $transaction,
+			'status'      => $status,
+			'id'          => $transaction instanceof EE_Transaction ? $transaction->ID() : 0,
+			'title_attr'  => sprintf(__('View Transaction Details (%s)', 'event_espresso'),
+				EEH_Template::pretty_status($status, false, 'sentence')),
+		);
+		try {
+			$event = $registration->event();
+		} catch (\EventEspresso\core\exceptions\EntityNotFoundException $e) {
+			$event = null;
+		}
+		$status = $event instanceof EE_Event ? $event->get_active_status() : EE_Datetime::inactive;
+		$this->_event_details = array(
+			'event'      => $event,
+			'status'     => $status,
+			'id'         => $event instanceof EE_Event ? $event->ID() : 0,
+			'title_attr' => sprintf(__('Edit Event (%s)', 'event_espresso'),
+				EEH_Template::pretty_status($status, false, 'sentence')),
+		);
+	}
+
+
+
+	/**
+	 *    _get_table_filters
+	 *
+	 * @access protected
+	 * @return array
+	 */
+	protected function _get_table_filters()
+	{
+		$filters = array();
+		//todo we're currently using old functions here. We need to move things into the Events_Admin_Page() class as methods.
+		$cur_date = isset($this->_req_data['month_range']) ? $this->_req_data['month_range'] : '';
+		$cur_category = isset($this->_req_data['EVT_CAT']) ? $this->_req_data['EVT_CAT'] : -1;
+		$reg_status = isset($this->_req_data['_reg_status']) ? $this->_req_data['_reg_status'] : '';
+		$filters[] = EEH_Form_Fields::generate_registration_months_dropdown($cur_date, $reg_status, $cur_category);
+		$filters[] = EEH_Form_Fields::generate_event_category_dropdown($cur_category);
+		$status = array();
+		$status[] = array('id' => 0, 'text' => __('Select Status', 'event_espresso'));
+		foreach ($this->_status as $key => $value) {
+			$status[] = array('id' => $key, 'text' => $value);
+		}
+		if ($this->_view !== 'incomplete') {
+			$filters[] = EEH_Form_Fields::select_input('_reg_status', $status,
+				isset($this->_req_data['_reg_status']) ? strtoupper(sanitize_key($this->_req_data['_reg_status']))
+					: '');
+		}
+		if (isset($this->_req_data['event_id'])) {
+			$filters[] = EEH_Form_Fields::hidden_input('event_id', $this->_req_data['event_id'], 'reg_event_id');
+		}
+		return $filters;
+	}
+
+
+
+	/**
+	 *    _add_view_counts
+	 *
+	 * @access protected
+	 * @return void
+	 * @throws \EE_Error
+	 */
+	protected function _add_view_counts()
+	{
+		$this->_views['all']['count'] = $this->_total_registrations();
+		$this->_views['month']['count'] = $this->_total_registrations_this_month();
+		$this->_views['today']['count'] = $this->_total_registrations_today();
+		if (EE_Registry::instance()->CAP->current_user_can('ee_delete_registrations',
+			'espresso_registrations_trash_registrations')
+		) {
+			$this->_views['incomplete']['count'] = $this->_total_registrations('incomplete');
+			$this->_views['trash']['count'] = $this->_total_registrations('trash');
+		}
+	}
+
+
+
+	/**
+	 * _total_registrations
+	 *
+	 * @access protected
+	 * @param string $view
+	 * @return int
+	 * @throws \EE_Error
+	 */
+	protected function _total_registrations($view = '')
+	{
+		$_where = array();
+		$EVT_ID = isset($this->_req_data['event_id']) ? absint($this->_req_data['event_id']) : false;
+		if ($EVT_ID) {
+			$_where['EVT_ID'] = $EVT_ID;
+		}
+		switch ($view) {
+			case 'trash' :
+				return EEM_Registration::instance()->count_deleted(array($_where));
+				break;
+			case 'incomplete' :
+				$_where['STS_ID'] = EEM_Registration::status_id_incomplete;
+				break;
+			default :
+				$_where['STS_ID'] = array('!=', EEM_Registration::status_id_incomplete);
+		}
+		return EEM_Registration::instance()->count(array($_where));
+	}
+
+
+
+	/**
+	 * _total_registrations_this_month
+	 *
+	 * @access protected
+	 * @return int
+	 * @throws \EE_Error
+	 */
+	protected function _total_registrations_this_month()
+	{
+		$EVT_ID = isset($this->_req_data['event_id']) ? absint($this->_req_data['event_id']) : false;
+		$_where = $EVT_ID ? array('EVT_ID' => $EVT_ID) : array();
+		$this_year_r = date('Y', current_time('timestamp'));
+		$time_start = ' 00:00:00';
+		$time_end = ' 23:59:59';
+		$this_month_r = date('m', current_time('timestamp'));
+		$days_this_month = date('t', current_time('timestamp'));
+		//setup date query.
+		$beginning_string = EEM_Registration::instance()
+											->convert_datetime_for_query('REG_date',
+												$this_year_r . '-' . $this_month_r . '-01' . ' ' . $time_start,
+												'Y-m-d H:i:s');
+		$end_string = EEM_Registration::instance()
+									  ->convert_datetime_for_query('REG_date',
+										  $this_year_r . '-' . $this_month_r . '-' . $days_this_month . ' ' . $time_end,
+										  'Y-m-d H:i:s');
+		$_where['REG_date'] = array(
+			'BETWEEN',
+			array(
+				$beginning_string,
+				$end_string,
+			),
+		);
+		$_where['STS_ID'] = array('!=', EEM_Registration::status_id_incomplete);
+		return EEM_Registration::instance()->count(array($_where));
+	}
+
+
+
+	/**
+	 * _total_registrations_today
+	 *
+	 * @access protected
+	 * @return int
+	 * @throws \EE_Error
+	 */
+	protected function _total_registrations_today()
+	{
+		$EVT_ID = isset($this->_req_data['event_id']) ? absint($this->_req_data['event_id']) : false;
+		$_where = $EVT_ID ? array('EVT_ID' => $EVT_ID) : array();
+		$current_date = date('Y-m-d', current_time('timestamp'));
+		$time_start = ' 00:00:00';
+		$time_end = ' 23:59:59';
+		$_where['REG_date'] = array(
+			'BETWEEN',
+			array(
+				EEM_Registration::instance()
+								->convert_datetime_for_query('REG_date', $current_date . $time_start, 'Y-m-d H:i:s'),
+				EEM_Registration::instance()
+								->convert_datetime_for_query('REG_date', $current_date . $time_end, 'Y-m-d H:i:s'),
+			),
+		);
+		$_where['STS_ID'] = array('!=', EEM_Registration::status_id_incomplete);
+		return EEM_Registration::instance()->count(array($_where));
+	}
+
+
+
+	/**
+	 * column_cb
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function column_cb($item)
+	{
+		/** checkbox/lock **/
+		$transaction = $item->get_first_related('Transaction');
+		$payment_count = $transaction instanceof EE_Transaction ? $transaction->count_related('Payment') : 0;
+		return $payment_count > 0 ? sprintf('<input type="checkbox" name="_REG_ID[]" value="%1$s" />', $item->ID())
+									. '<span class="ee-lock-icon"></span>'
+			: sprintf('<input type="checkbox" name="_REG_ID[]" value="%1$s" />', $item->ID());
+	}
+
+
+
+	/**
+	 * column__REG_ID
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function column__REG_ID(EE_Registration $item)
+	{
+		$attendee = $item->attendee();
+		$content = $item->ID();
+		$content .= '<div class="show-on-mobile-view-only">';
+		$content .= '<br>';
+		$content .= $attendee instanceof EE_Attendee ? $attendee->full_name() : '';
+		$content .= '&nbsp;' . sprintf(__('(%1$s / %2$s)', 'event_espresso'), $item->count(), $item->group_size());
+		$content .= '<br>' . sprintf(__('Reg Code: %s', 'event_espresso'), $item->get('REG_code'));
+		$content .= '</div>';
+		return $content;
+	}
+
+
+
+	/**
+	 * column__REG_date
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function column__REG_date(EE_Registration $item)
+	{
+		$this->_set_related_details($item);
+		//Build row actions
+		$view_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
+			'action' => 'view_transaction',
+			'TXN_ID' => $this->_transaction_details['id'],
+		), TXN_ADMIN_URL);
+		$view_link = EE_Registry::instance()->CAP->current_user_can('ee_read_transaction',
+			'espresso_transactions_view_transaction') ? '<a class="ee-status-color-'
+														. $this->_transaction_details['status']
+														. '" href="'
+														. $view_lnk_url
+														. '" title="'
+														. esc_attr($this->_transaction_details['title_attr'])
+														. '">'
+														. $item->get_i18n_datetime('REG_date')
+														. '</a>' : $item->get_i18n_datetime('REG_date');
+		$view_link .= '<br><span class="ee-status-text-small">'
+					  . EEH_Template::pretty_status($this->_transaction_details['status'], false, 'sentence')
+					  . '</span>';
+		return $view_link;
+	}
+
+
+
+	/**
+	 * column_event_name
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function column_event_name(EE_Registration $item)
+	{
+		$this->_set_related_details($item);
+		// page=espresso_events&action=edit_event&EVT_ID=2&edit_event_nonce=cf3a7e5b62
+		$EVT_ID = $item->event_ID();
+		$event_name = $item->event_name();
+		$event_name = $event_name ? $event_name : __("No Associated Event", 'event_espresso');
+		$event_name = wp_trim_words($event_name, 30, '...');
+		if ($EVT_ID) {
+			$edit_event_url = EE_Admin_Page::add_query_args_and_nonce(array('action' => 'edit', 'post' => $EVT_ID),
+				EVENTS_ADMIN_URL);
+			$edit_event = EE_Registry::instance()->CAP->current_user_can('ee_edit_event', 'edit_event', $EVT_ID)
+				? '<a class="ee-status-color-'
+				  . $this->_event_details['status']
+				  . '" href="'
+				  . $edit_event_url
+				  . '" title="'
+				  . esc_attr($this->_event_details['title_attr'])
+				  . '">'
+				  . $event_name
+				  . '</a>' : $event_name;
+			$edit_event_url = EE_Admin_Page::add_query_args_and_nonce(array('event_id' => $EVT_ID), REG_ADMIN_URL);
+			$actions['event_filter'] = '<a href="' . $edit_event_url . '" title="';
+			$actions['event_filter'] .= sprintf(esc_attr__('Filter this list to only show registrations for %s',
+				'event_espresso'), $event_name);
+			$actions['event_filter'] .= '">' . __('View Registrations', 'event_espresso') . '</a>';
+		} else {
+			$edit_event = $event_name;
+			$actions['event_filter'] = '';
+		}
+		return sprintf('%1$s %2$s', $edit_event, $this->row_actions($actions));
+	}
+
+
+
+	/**
+	 * column_DTT_EVT_start
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function column_DTT_EVT_start(EE_Registration $item)
+	{
+		$datetime_strings = array();
+		$ticket = $item->ticket(true);
+		if ($ticket instanceof EE_Ticket) {
+			$remove_defaults = array('default_where_conditions' => 'none');
+			$datetimes = $ticket->datetimes($remove_defaults);
+			foreach ($datetimes as $datetime) {
+				$datetime_strings[] = $datetime->get_i18n_datetime('DTT_EVT_start');
+			}
+			return implode("<br />", $datetime_strings);
+		} else {
+			return __('There is no ticket on this registration', 'event_espresso');
+		}
+	}
+
+
+
+	/**
+	 * column_ATT_fname
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function column_ATT_fname(EE_Registration $item)
+	{
+		$attendee = $item->attendee();
+		$edit_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
+			'action'  => 'view_registration',
+			'_REG_ID' => $item->ID(),
+		), REG_ADMIN_URL);
+		$attendee_name = $attendee instanceof EE_Attendee ? $attendee->full_name() : '';
+		$link = EE_Registry::instance()->CAP->current_user_can('ee_read_registration',
+			'espresso_registrations_view_registration', $item->ID()) ? '<a href="'
+																	   . $edit_lnk_url
+																	   . '" title="'
+																	   . esc_attr__('View Registration Details',
+				'event_espresso')
+																	   . '">'
+																	   . $attendee_name
+																	   . '</a>' : $attendee_name;
+		$link .= $item->count() === 1
+			? '&nbsp;<sup><div class="dashicons dashicons-star-filled lt-blue-icon ee-icon-size-8"></div></sup>' : '';
+		$t = $item->get_first_related('Transaction');
+		$payment_count = $t instanceof EE_Transaction ? $t->count_related('Payment') : 0;
+		//append group count to name
+		$link .= '&nbsp;' . sprintf(__('(%1$s / %2$s)', 'event_espresso'), $item->count(), $item->group_size());
+		//append reg_code
+		$link .= '<br>' . sprintf(__('Reg Code: %s', 'event_espresso'), $item->get('REG_code'));
+		//reg status text for accessibility
+		$link .= '<br><span class="ee-status-text-small">' . EEH_Template::pretty_status($item->status_ID(), false,
+				'sentence') . '</span>';
+		//trash/restore/delete actions
+		$actions = array();
+		if ($this->_view !== 'trash'
+			&& $payment_count === 0
+			&& EE_Registry::instance()->CAP->current_user_can('ee_delete_registration',
+				'espresso_registrations_trash_registrations', $item->ID())
+		) {
+			$trash_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
+				'action'  => 'trash_registrations',
+				'_REG_ID' => $item->ID(),
+			), REG_ADMIN_URL);
+			$actions['trash'] = '<a href="' . $trash_lnk_url . '" title="' . esc_attr__('Trash Registration',
+					'event_espresso') . '">' . __('Trash', 'event_espresso') . '</a>';
+		} elseif ($this->_view === 'trash') {
+			// restore registration link
+			if (EE_Registry::instance()->CAP->current_user_can('ee_delete_registration',
+				'espresso_registrations_restore_registrations', $item->ID())
+			) {
+				$restore_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
+					'action'  => 'restore_registrations',
+					'_REG_ID' => $item->ID(),
+				), REG_ADMIN_URL);
+				$actions['restore'] = '<a href="' . $restore_lnk_url . '" title="' . esc_attr__('Restore Registration',
+						'event_espresso') . '">' . __('Restore', 'event_espresso') . '</a>';
+			}
+			if (EE_Registry::instance()->CAP->current_user_can('ee_delete_registration',
+				'espresso_registrations_ee_delete_registrations', $item->ID())
+			) {
+				$delete_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
+					'action'  => 'delete_registrations',
+					'_REG_ID' => $item->ID(),
+				), REG_ADMIN_URL);
+				$actions['delete'] = '<a href="'
+									 . $delete_lnk_url
+									 . '" title="'
+									 . esc_attr__('Delete Registration Permanently', 'event_espresso')
+									 . '">'
+									 . __('Delete', 'event_espresso')
+									 . '</a>';
+			}
+		}
+		return sprintf('%1$s %2$s', $link, $this->row_actions($actions));
+	}
+
+
+
+	/**
+	 * column_ATT_email
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function column_ATT_email(EE_Registration $item)
+	{
+		$attendee = $item->get_first_related('Attendee');
+		return ! $attendee instanceof EE_Attendee ? __('No attached contact record.', 'event_espresso')
+			: $attendee->email();
+	}
+
+
+
+	/**
+	 * column__REG_count
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 */
+	public function column__REG_count(EE_Registration $item)
+	{
+		return sprintf(__('%1$s / %2$s', 'event_espresso'), $item->count(), $item->group_size());
+	}
+
+
+
+	/**
+	 * column_PRC_amount
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 */
+	public function column_PRC_amount(EE_Registration $item)
+	{
+		$ticket = $item->ticket();
+		$content = isset($_GET['event_id']) && $ticket instanceof EE_Ticket ? '<span class="TKT_name">'
+																			  . $ticket->name()
+																			  . '</span><br />' : '';
+		if ($item->final_price() > 0) {
+			$content .= '<span class="reg-pad-rght">' . $item->pretty_final_price() . '</span>';
+		} else {
+			// free event
+			$content .= '<span class="reg-overview-free-event-spn reg-pad-rght">'
+						. __('free', 'event_espresso')
+						. '</span>';
+		}
+		return $content;
+	}
+
+
+
+	/**
+	 * column__REG_final_price
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 */
+	public function column__REG_final_price(EE_Registration $item)
+	{
+		$ticket = $item->ticket();
+		$content = isset($_GET['event_id']) || ! $ticket instanceof EE_Ticket
+			? ''
+			: '<span class="TKT_name">'
+			  . $ticket->name()
+			  . '</span><br />';
+		$content .= '<span class="reg-pad-rght">' . $item->pretty_final_price() . '</span>';
+		return $content;
+	}
+
+
+
+	/**
+	 * column__REG_paid
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 */
+	public function column__REG_paid(EE_Registration $item)
+	{
+		$payment_method = $item->payment_method();
+		$payment_method_name = $payment_method instanceof EE_Payment_Method ? $payment_method->admin_name()
+			: __('Unknown', 'event_espresso');
+		$content = '<span class="reg-pad-rght">' . $item->pretty_paid() . '</span>';
+		if ($item->paid() > 0) {
+			$content .= '<br><span class="ee-status-text-small">' . sprintf(__('...via %s', 'event_espresso'),
+					$payment_method_name) . '</span>';
+		}
+		return $content;
+	}
+
+
+
+	/**
+	 * column_TXN_total
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function column_TXN_total(EE_Registration $item)
+	{
+		if ($item->transaction()) {
+			$view_txn_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
+				'action' => 'view_transaction',
+				'TXN_ID' => $item->transaction_ID(),
+			), TXN_ADMIN_URL);
+			return EE_Registry::instance()->CAP->current_user_can('ee_read_transaction',
+				'espresso_transactions_view_transaction', $item->transaction_ID())
+				? '<span class="reg-pad-rght"><a class="status-'
+				  . $item->transaction()->status_ID()
+				  . '" href="'
+				  . $view_txn_lnk_url
+				  . '"  title="'
+				  . esc_attr__('View Transaction', 'event_espresso')
+				  . '">'
+				  . $item->transaction()->pretty_total()
+				  . '</a></span>' : '<span class="reg-pad-rght">' . $item->transaction()->pretty_total() . '</span>';
+		} else {
+			return __("None", "event_espresso");
+		}
+	}
+
+
+
+	/**
+	 * column_TXN_paid
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function column_TXN_paid(EE_Registration $item)
+	{
+		if ($item->count() === 1) {
+			$transaction = $item->transaction() ? $item->transaction() : EE_Transaction::new_instance();
+			if ($transaction->paid() >= $transaction->total()) {
+				return '<span class="reg-pad-rght"><div class="dashicons dashicons-yes green-icon"></div></span>';
+			} else {
+				$view_txn_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
+					'action' => 'view_transaction',
+					'TXN_ID' => $item->transaction_ID(),
+				), TXN_ADMIN_URL);
+				return EE_Registry::instance()->CAP->current_user_can('ee_read_transaction',
+					'espresso_transactions_view_transaction', $item->transaction_ID())
+					? '<span class="reg-pad-rght"><a class="status-'
+					  . $transaction->status_ID()
+					  . '" href="'
+					  . $view_txn_lnk_url
+					  . '"  title="'
+					  . esc_attr__('View Transaction', 'event_espresso')
+					  . '">'
+					  . $item->transaction()->pretty_paid()
+					  . '</a><span>' : '<span class="reg-pad-rght">' . $item->transaction()->pretty_paid() . '</span>';
+			}
+		}
+		return '&nbsp;';
+	}
+
+
+
+	/**
+	 * column_actions
+	 *
+	 * @access public
+	 * @param \EE_Registration $item
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function column_actions(EE_Registration $item)
+	{
+		$actions = array();
+		$attendee = $item->attendee();
+		$this->_set_related_details($item);
+		//Build row actions
+		$view_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
+			'action'  => 'view_registration',
+			'_REG_ID' => $item->ID(),
+		), REG_ADMIN_URL);
+		$edit_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
+			'action' => 'edit_attendee',
+			'post'   => $item->attendee_ID(),
+		), REG_ADMIN_URL);
+		// page=attendees&event_admin_reports=resend_email&registration_id=43653465634&event_id=2&form_action=resend_email
+		//$resend_reg_lnk_url_params = array( 'action'=>'resend_registration', '_REG_ID'=>$item->REG_ID );
+		$resend_reg_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
+			'action'  => 'resend_registration',
+			'_REG_ID' => $item->ID(),
+		), REG_ADMIN_URL, true);
+		//Build row actions
+		$actions['view_lnk'] = EE_Registry::instance()->CAP->current_user_can('ee_read_registration',
+			'espresso_registrations_view_registration', $item->ID()) ? '
 			<li>
 			<a href="' . $view_lnk_url . '" title="' . esc_attr__('View Registration Details', 'event_espresso') . '" class="tiny-text">
 				<div class="dashicons dashicons-clipboard"></div>
 			</a>
 			</li>' : '';
-        $actions['edit_lnk'] = EE_Registry::instance()->CAP->current_user_can('ee_edit_contacts',
-            'espresso_registrations_edit_attendee')
-                               && $attendee instanceof EE_Attendee ? '
+		$actions['edit_lnk'] = EE_Registry::instance()->CAP->current_user_can('ee_edit_contacts',
+			'espresso_registrations_edit_attendee')
+							   && $attendee instanceof EE_Attendee ? '
 			<li>
 			<a href="' . $edit_lnk_url . '" title="' . esc_attr__('Edit Contact Details', 'event_espresso') . '" class="tiny-text">
 				<div class="ee-icon ee-icon-user-edit ee-icon-size-16"></div>
 			</a>
 			</li>' : '';
-        $actions['resend_reg_lnk'] = $attendee instanceof EE_Attendee
-                                     && EE_Registry::instance()->CAP->current_user_can('ee_send_message',
-            'espresso_registrations_resend_registration', $item->ID()) ? '
+		$actions['resend_reg_lnk'] = $attendee instanceof EE_Attendee
+									 && EE_Registry::instance()->CAP->current_user_can('ee_send_message',
+			'espresso_registrations_resend_registration', $item->ID()) ? '
 			<li>
 			<a href="'
-                                                                         . $resend_reg_lnk_url
-                                                                         . '" title="'
-                                                                         . esc_attr__('Resend Registration Details',
-                'event_espresso')
-                                                                         . '" class="tiny-text">
+																		 . $resend_reg_lnk_url
+																		 . '" title="'
+																		 . esc_attr__('Resend Registration Details',
+				'event_espresso')
+																		 . '" class="tiny-text">
 				<div class="dashicons dashicons-email-alt"></div>
 			</a>
 			</li>' : '';
-        // page=transactions&action=view_transaction&txn=256&_wpnonce=6414da4dbb
-        $view_txn_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
-            'action' => 'view_transaction',
-            'TXN_ID' => $this->_transaction_details['id'],
-        ), TXN_ADMIN_URL);
-        $actions['view_txn_lnk'] = EE_Registry::instance()->CAP->current_user_can('ee_read_transaction',
-            'espresso_transactions_view_transaction', $this->_transaction_details['id']) ? '
+		// page=transactions&action=view_transaction&txn=256&_wpnonce=6414da4dbb
+		$view_txn_lnk_url = EE_Admin_Page::add_query_args_and_nonce(array(
+			'action' => 'view_transaction',
+			'TXN_ID' => $this->_transaction_details['id'],
+		), TXN_ADMIN_URL);
+		$actions['view_txn_lnk'] = EE_Registry::instance()->CAP->current_user_can('ee_read_transaction',
+			'espresso_transactions_view_transaction', $this->_transaction_details['id']) ? '
 			<li>
 			<a class="ee-status-color-'
-                                                                                           . $this->_transaction_details['status']
-                                                                                           . ' tiny-text" href="'
-                                                                                           . $view_txn_lnk_url
-                                                                                           . '"  title="'
-                                                                                           . $this->_transaction_details['title_attr']
-                                                                                           . '">
+																						   . $this->_transaction_details['status']
+																						   . ' tiny-text" href="'
+																						   . $view_txn_lnk_url
+																						   . '"  title="'
+																						   . $this->_transaction_details['title_attr']
+																						   . '">
 				<div class="dashicons dashicons-cart"></div>
 			</a>
 			</li>' : '';
-        //invoice link
-        $actions['dl_invoice_lnk'] = '';
-        $dl_invoice_lnk_url = $item->invoice_url();
-        //only show invoice link if message type is active.
-        if ($attendee instanceof EE_Attendee
-            && $item->is_primary_registrant()
-            && EEH_MSG_Template::is_mt_active('invoice')
-        ) {
-            $actions['dl_invoice_lnk'] = '
+		//invoice link
+		$actions['dl_invoice_lnk'] = '';
+		$dl_invoice_lnk_url = $item->invoice_url();
+		//only show invoice link if message type is active.
+		if ($attendee instanceof EE_Attendee
+			&& $item->is_primary_registrant()
+			&& EEH_MSG_Template::is_mt_active('invoice')
+		) {
+			$actions['dl_invoice_lnk'] = '
 		<li>
 			<a title="'
-                                         . esc_attr__('View Transaction Invoice', 'event_espresso')
-                                         . '" target="_blank" href="'
-                                         . $dl_invoice_lnk_url
-                                         . '" class="tiny-text">
+										 . esc_attr__('View Transaction Invoice', 'event_espresso')
+										 . '" target="_blank" href="'
+										 . $dl_invoice_lnk_url
+										 . '" class="tiny-text">
 				<span class="dashicons dashicons-media-spreadsheet ee-icon-size-18"></span>
 			</a>
 		</li>';
-        }
-        $actions['filtered_messages_link'] = '';
-        //message list table link (filtered by REG_ID
-        if (EE_Registry::instance()->CAP->current_user_can('ee_read_global_messages', 'view_filtered_messages')) {
-            $actions['filtered_messages_link'] = '<li>'
-                                                 . EEH_MSG_Template::get_message_action_link('see_notifications_for',
-                    null, array(
-                        '_REG_ID' => $item->ID(),
-                    ))
-                                                 . '</li>';
-        }
-        $actions = apply_filters('FHEE__EE_Registrations_List_Table__column_actions__actions', $actions, $item, $this);
-        return $this->_action_string(implode('', $actions), $item, 'ul', 'reg-overview-actions-ul');
-    }
+		}
+		$actions['filtered_messages_link'] = '';
+		//message list table link (filtered by REG_ID
+		if (EE_Registry::instance()->CAP->current_user_can('ee_read_global_messages', 'view_filtered_messages')) {
+			$actions['filtered_messages_link'] = '<li>'
+												 . EEH_MSG_Template::get_message_action_link('see_notifications_for',
+					null, array(
+						'_REG_ID' => $item->ID(),
+					))
+												 . '</li>';
+		}
+		$actions = apply_filters('FHEE__EE_Registrations_List_Table__column_actions__actions', $actions, $item, $this);
+		return $this->_action_string(implode('', $actions), $item, 'ul', 'reg-overview-actions-ul');
+	}
 
 }

core/db_models/EEM_Base.model.php

Doc Comments +16 added lines, -14 removed lines

@@ -860,7 +860,7 @@ 
      *  on this model (or follows the _model_chain_to_wp_user and uses that model's
      * foreign key to the WP_User table)
      *
-     * @return string|boolean string on success, boolean false when there is no
+     * @return string|false string on success, boolean false when there is no
      * foreign key to the WP_User table
      */
     public function wp_user_field_name()
@@ -966,7 +966,7 @@ 
      *
      * @param array  $query_params      like EEM_Base::get_all's $query_params
      * @param string $output            ARRAY_A, OBJECT_K, etc. Just like
-     * @param mixed  $columns_to_select , What columns to select. By default, we select all columns specified by the
+     * @param string  $columns_to_select , What columns to select. By default, we select all columns specified by the
      *                                  fields on the model, and the models we joined to in the query. However, you can
      *                                  override this and set the select to "*", or a specific column name, like
      *                                  "ATT_ID", etc. If you would like to use these custom selections in WHERE,
@@ -1358,7 +1358,7 @@ 
      * @param string $field_name The name of the field the formats are being retrieved for.
      * @param bool   $pretty     Whether to return the pretty formats (true) or not (false).
      * @throws EE_Error   If the given field_name is not of the EE_Datetime_Field type.
-     * @return array formats in an array with the date format first, and the time format last.
+     * @return string[] formats in an array with the date format first, and the time format last.
      */
     public function get_formats_for($field_name, $pretty = false)
     {
@@ -1391,7 +1391,7 @@ 
      *                                 be returned.
      * @param string $what             Whether to return the string in just the time format, the date format, or both.
      * @throws EE_Error    If the given field_name is not of the EE_Datetime_Field type.
-     * @return int|string  If the given field_name is not of the EE_Datetime_Field type, then an EE_Error
+     * @return string|null  If the given field_name is not of the EE_Datetime_Field type, then an EE_Error
      *                                 exception is triggered.
      */
     public function current_time_for_query($field_name, $timestamp = false, $what = 'both')
@@ -1723,7 +1723,7 @@ 
      * Wrapper for EEM_Base::delete_permanently()
      *
      * @param mixed $id
-     * @return boolean whether the row got deleted or not
+     * @return integer whether the row got deleted or not
      * @throws \EE_Error
      */
     public function delete_permanently_by_ID($id)
@@ -1743,7 +1743,7 @@ 
      * Wrapper for EEM_Base::delete()
      *
      * @param mixed $id
-     * @return boolean whether the row got deleted or not
+     * @return integer whether the row got deleted or not
      * @throws \EE_Error
      */
     public function delete_by_ID($id)
@@ -2193,7 +2193,7 @@ 
      * Verifies the EE addons' database is up-to-date and records that we've done it on
      * EEM_Base::$_db_verification_level
      *
-     * @param $wpdb_method
+     * @param string $wpdb_method
      * @param $arguments_to_provide
      * @return string
      */
@@ -2317,6 +2317,7 @@ 
      *                             methods that allow you to further specify extra columns to join by (such as HABTM).
      *                             Keep in mind that the only acceptable query_params is strict "col" => "value" pairs
      *                             because these will be inserted in any new rows created as well.
+     * @param EE_Base_Class $id_or_obj
      */
     public function remove_relationship_to($id_or_obj, $other_model_id_or_obj, $relationName, $where_query = array())
     {
@@ -2327,7 +2328,7 @@ 
 
 
     /**
-     * @param mixed           $id_or_obj
+     * @param EE_Base_Class           $id_or_obj
      * @param string          $relationName
      * @param array           $where_query_params
      * @param EE_Base_Class[] objects to which relations were removed
@@ -2368,7 +2369,7 @@ 
      * However, if the model objects can't be deleted because of blocking related model objects, then
      * they aren't deleted. (Unless the thing that would have been deleted can be soft-deleted, that still happens).
      *
-     * @param EE_Base_Class|int|string $id_or_obj
+     * @param EE_Base_Class $id_or_obj
      * @param string                   $model_name
      * @param array                    $query_params
      * @return int how many deleted
@@ -2389,7 +2390,7 @@ 
      * the model objects can't be hard deleted because of blocking related model objects,
      * just does a soft-delete on them instead.
      *
-     * @param EE_Base_Class|int|string $id_or_obj
+     * @param EE_Base_Class $id_or_obj
      * @param string                   $model_name
      * @param array                    $query_params
      * @return int how many deleted
@@ -2446,6 +2447,7 @@ 
      * @param string $model_name   like 'Event', or 'Registration'
      * @param array  $query_params like EEM_Base::get_all's
      * @param string $field_to_sum name of field to count by. By default, uses primary key
+     * @param EE_Base_Class $id_or_obj
      * @return float
      * @throws \EE_Error
      */
@@ -2909,7 +2911,7 @@ 
      * Finds all the fields that correspond to the given table
      *
      * @param string $table_alias , array key in EEM_Base::_tables
-     * @return EE_Model_Field_Base[]
+     * @return EE_Model_Field_Base
      */
     public function _get_fields_for_table($table_alias)
     {
@@ -4354,7 +4356,7 @@ 
      * gets the field object of type 'primary_key' from the fieldsSettings attribute.
      * Eg, on EE_Answer that would be ANS_ID field object
      *
-     * @param $field_obj
+     * @param EE_Model_Field_Base $field_obj
      * @return boolean
      */
     public function is_primary_key_field($field_obj)
@@ -4465,7 +4467,7 @@ 
      * @param string $table_alias eg Event, Event_Meta, Registration, Transaction, but maybe
      *                            a table alias with a model chain prefix, like 'Venue__Event_Venue___Event_Meta'.
      *                            Either one works
-     * @return EE_Table_Base
+     * @return string
      */
     public function get_table_for_alias($table_alias)
     {
@@ -5075,7 +5077,7 @@ 
     /**
      * Read comments for assume_values_already_prepared_by_model_object()
      *
-     * @return int
+     * @return boolean
      */
     public function get_assumption_concerning_values_already_prepared_by_model_object()
     {

Indentation +5564 added lines, -5564 removed lines

@@ -29,5572 +29,5572 @@
 abstract class EEM_Base extends EE_Base
 {
 
-    //admin posty
-    //basic -> grants access to mine -> if they don't have it, select none
-    //*_others -> grants access to others that arent private, and all mine -> if they don't have it, select mine
-    //*_private -> grants full access -> if dont have it, select all mine and others' non-private
-    //*_published -> grants access to published -> if they dont have it, select non-published
-    //*_global/default/system -> grants access to global items -> if they don't have it, select non-global
-    //publish_{thing} -> can change status TO publish; SPECIAL CASE
-    //frontend posty
-    //by default has access to published
-    //basic -> grants access to mine that arent published, and all published
-    //*_others ->grants access to others that arent private, all mine
-    //*_private -> grants full access
-    //frontend non-posty
-    //like admin posty
-    //category-y
-    //assign -> grants access to join-table
-    //(delete, edit)
-    //payment-method-y
-    //for each registered payment method,
-    //ee_payment_method_{pmttype} -> if they don't have it, select all where they aren't of that type
-    /**
-     * Flag to indicate whether the values provided to EEM_Base have already been prepared
-     * by the model object or not (ie, the model object has used the field's _prepare_for_set function on the values).
-     * They almost always WILL NOT, but it's not necessarily a requirement.
-     * For example, if you want to run EEM_Event::instance()->get_all(array(array('EVT_ID'=>$_GET['event_id'])));
-     *
-     * @var boolean
-     */
-    private $_values_already_prepared_by_model_object = 0;
-
-    /**
-     * when $_values_already_prepared_by_model_object equals this, we assume
-     * the data is just like form input that needs to have the model fields'
-     * prepare_for_set and prepare_for_use_in_db called on it
-     */
-    const not_prepared_by_model_object = 0;
-
-    /**
-     * when $_values_already_prepared_by_model_object equals this, we
-     * assume this value is coming from a model object and doesn't need to have
-     * prepare_for_set called on it, just prepare_for_use_in_db is used
-     */
-    const prepared_by_model_object = 1;
-
-    /**
-     * when $_values_already_prepared_by_model_object equals this, we assume
-     * the values are already to be used in the database (ie no processing is done
-     * on them by the model's fields)
-     */
-    const prepared_for_use_in_db = 2;
-
-
-    protected $singular_item = 'Item';
-
-    protected $plural_item   = 'Items';
-
-    /**
-     * @type \EE_Table_Base[] $_tables array of EE_Table objects for defining which tables comprise this model.
-     */
-    protected $_tables;
-
-    /**
-     * with two levels: top-level has array keys which are database table aliases (ie, keys in _tables)
-     * and the value is an array. Each of those sub-arrays have keys of field names (eg 'ATT_ID', which should also be
-     * variable names on the model objects (eg, EE_Attendee), and the keys should be children of EE_Model_Field
-     *
-     * @var \EE_Model_Field_Base[] $_fields
-     */
-    protected $_fields;
-
-    /**
-     * array of different kinds of relations
-     *
-     * @var \EE_Model_Relation_Base[] $_model_relations
-     */
-    protected $_model_relations;
-
-    /**
-     * @var \EE_Index[] $_indexes
-     */
-    protected $_indexes = array();
-
-    /**
-     * Default strategy for getting where conditions on this model. This strategy is used to get default
-     * where conditions which are added to get_all, update, and delete queries. They can be overridden
-     * by setting the same columns as used in these queries in the query yourself.
-     *
-     * @var EE_Default_Where_Conditions
-     */
-    protected $_default_where_conditions_strategy;
-
-    /**
-     * Strategy for getting conditions on this model when 'default_where_conditions' equals 'minimum'.
-     * This is particularly useful when you want something between 'none' and 'default'
-     *
-     * @var EE_Default_Where_Conditions
-     */
-    protected $_minimum_where_conditions_strategy;
-
-    /**
-     * String describing how to find the "owner" of this model's objects.
-     * When there is a foreign key on this model to the wp_users table, this isn't needed.
-     * But when there isn't, this indicates which related model, or transiently-related model,
-     * has the foreign key to the wp_users table.
-     * Eg, for EEM_Registration this would be 'Event' because registrations are directly
-     * related to events, and events have a foreign key to wp_users.
-     * On EEM_Transaction, this would be 'Transaction.Event'
-     *
-     * @var string
-     */
-    protected $_model_chain_to_wp_user = '';
-
-    /**
-     * This is a flag typically set by updates so that we don't load the where strategy on updates because updates
-     * don't need it (particularly CPT models)
-     *
-     * @var bool
-     */
-    protected $_ignore_where_strategy = false;
-
-    /**
-     * String used in caps relating to this model. Eg, if the caps relating to this
-     * model are 'ee_edit_events', 'ee_read_events', etc, it would be 'events'.
-     *
-     * @var string. If null it hasn't been initialized yet. If false then we
-     * have indicated capabilities don't apply to this
-     */
-    protected $_caps_slug = null;
-
-    /**
-     * 2d array where top-level keys are one of EEM_Base::valid_cap_contexts(),
-     * and next-level keys are capability names, and each's value is a
-     * EE_Default_Where_Condition. If the requester requests to apply caps to the query,
-     * they specify which context to use (ie, frontend, backend, edit or delete)
-     * and then each capability in the corresponding sub-array that they're missing
-     * adds the where conditions onto the query.
-     *
-     * @var array
-     */
-    protected $_cap_restrictions = array(
-        self::caps_read       => array(),
-        self::caps_read_admin => array(),
-        self::caps_edit       => array(),
-        self::caps_delete     => array(),
-    );
-
-    /**
-     * Array defining which cap restriction generators to use to create default
-     * cap restrictions to put in EEM_Base::_cap_restrictions.
-     * Array-keys are one of EEM_Base::valid_cap_contexts(), and values are a child of
-     * EE_Restriction_Generator_Base. If you don't want any cap restrictions generated
-     * automatically set this to false (not just null).
-     *
-     * @var EE_Restriction_Generator_Base[]
-     */
-    protected $_cap_restriction_generators = array();
-
-    /**
-     * constants used to categorize capability restrictions on EEM_Base::_caps_restrictions
-     */
-    const caps_read       = 'read';
-
-    const caps_read_admin = 'read_admin';
-
-    const caps_edit       = 'edit';
-
-    const caps_delete     = 'delete';
-
-    /**
-     * Keys are all the cap contexts (ie constants EEM_Base::_caps_*) and values are their 'action'
-     * as how they'd be used in capability names. Eg EEM_Base::caps_read ('read_frontend')
-     * maps to 'read' because when looking for relevant permissions we're going to use
-     * 'read' in teh capabilities names like 'ee_read_events' etc.
-     *
-     * @var array
-     */
-    protected $_cap_contexts_to_cap_action_map = array(
-        self::caps_read       => 'read',
-        self::caps_read_admin => 'read',
-        self::caps_edit       => 'edit',
-        self::caps_delete     => 'delete',
-    );
-
-    /**
-     * Timezone
-     * This gets set via the constructor so that we know what timezone incoming strings|timestamps are in when there
-     * are EE_Datetime_Fields in use.  This can also be used before a get to set what timezone you want strings coming
-     * out of the created objects.  NOT all EEM_Base child classes use this property but any that use a
-     * EE_Datetime_Field data type will have access to it.
-     *
-     * @var string
-     */
-    protected $_timezone;
-
-
-    /**
-     * This holds the id of the blog currently making the query.  Has no bearing on single site but is used for
-     * multisite.
-     *
-     * @var int
-     */
-    protected static $_model_query_blog_id;
-
-    /**
-     * A copy of _fields, except the array keys are the model names pointed to by
-     * the field
-     *
-     * @var EE_Model_Field_Base[]
-     */
-    private $_cache_foreign_key_to_fields = array();
-
-    /**
-     * Cached list of all the fields on the model, indexed by their name
-     *
-     * @var EE_Model_Field_Base[]
-     */
-    private $_cached_fields = null;
-
-    /**
-     * Cached list of all the fields on the model, except those that are
-     * marked as only pertinent to the database
-     *
-     * @var EE_Model_Field_Base[]
-     */
-    private $_cached_fields_non_db_only = null;
-
-    /**
-     * A cached reference to the primary key for quick lookup
-     *
-     * @var EE_Model_Field_Base
-     */
-    private $_primary_key_field = null;
-
-    /**
-     * Flag indicating whether this model has a primary key or not
-     *
-     * @var boolean
-     */
-    protected $_has_primary_key_field = null;
-
-    /**
-     * Whether or not this model is based off a table in WP core only (CPTs should set
-     * this to FALSE, but if we were to make an EE_WP_Post model, it should set this to true).
-     *
-     * @var boolean
-     */
-    protected $_wp_core_model = false;
-
-    /**
-     *    List of valid operators that can be used for querying.
-     * The keys are all operators we'll accept, the values are the real SQL
-     * operators used
-     *
-     * @var array
-     */
-    protected $_valid_operators = array(
-        '='           => '=',
-        '<='          => '<=',
-        '<'           => '<',
-        '>='          => '>=',
-        '>'           => '>',
-        '!='          => '!=',
-        'LIKE'        => 'LIKE',
-        'like'        => 'LIKE',
-        'NOT_LIKE'    => 'NOT LIKE',
-        'not_like'    => 'NOT LIKE',
-        'NOT LIKE'    => 'NOT LIKE',
-        'not like'    => 'NOT LIKE',
-        'IN'          => 'IN',
-        'in'          => 'IN',
-        'NOT_IN'      => 'NOT IN',
-        'not_in'      => 'NOT IN',
-        'NOT IN'      => 'NOT IN',
-        'not in'      => 'NOT IN',
-        'between'     => 'BETWEEN',
-        'BETWEEN'     => 'BETWEEN',
-        'IS_NOT_NULL' => 'IS NOT NULL',
-        'is_not_null' => 'IS NOT NULL',
-        'IS NOT NULL' => 'IS NOT NULL',
-        'is not null' => 'IS NOT NULL',
-        'IS_NULL'     => 'IS NULL',
-        'is_null'     => 'IS NULL',
-        'IS NULL'     => 'IS NULL',
-        'is null'     => 'IS NULL',
-        'REGEXP'      => 'REGEXP',
-        'regexp'      => 'REGEXP',
-        'NOT_REGEXP'  => 'NOT REGEXP',
-        'not_regexp'  => 'NOT REGEXP',
-        'NOT REGEXP'  => 'NOT REGEXP',
-        'not regexp'  => 'NOT REGEXP',
-    );
-
-    /**
-     * operators that work like 'IN', accepting a comma-separated list of values inside brackets. Eg '(1,2,3)'
-     *
-     * @var array
-     */
-    protected $_in_style_operators = array('IN', 'NOT IN');
-
-    /**
-     * operators that work like 'BETWEEN'.  Typically used for datetime calculations, i.e. "BETWEEN '12-1-2011' AND
-     * '12-31-2012'"
-     *
-     * @var array
-     */
-    protected $_between_style_operators = array('BETWEEN');
-
-    /**
-     * operators that are used for handling NUll and !NULL queries.  Typically used for when checking if a row exists
-     * on a join table.
-     *
-     * @var array
-     */
-    protected $_null_style_operators = array('IS NOT NULL', 'IS NULL');
-
-    /**
-     * Allowed values for $query_params['order'] for ordering in queries
-     *
-     * @var array
-     */
-    protected $_allowed_order_values = array('asc', 'desc', 'ASC', 'DESC');
-
-    /**
-     * When these are keys in a WHERE or HAVING clause, they are handled much differently
-     * than regular field names. It is assumed that their values are an array of WHERE conditions
-     *
-     * @var array
-     */
-    private $_logic_query_param_keys = array('not', 'and', 'or', 'NOT', 'AND', 'OR');
-
-    /**
-     * Allowed keys in $query_params arrays passed into queries. Note that 0 is meant to always be a
-     * 'where', but 'where' clauses are so common that we thought we'd omit it
-     *
-     * @var array
-     */
-    private $_allowed_query_params = array(
-        0,
-        'limit',
-        'order_by',
-        'group_by',
-        'having',
-        'force_join',
-        'order',
-        'on_join_limit',
-        'default_where_conditions',
-        'caps',
-    );
-
-    /**
-     * All the data types that can be used in $wpdb->prepare statements.
-     *
-     * @var array
-     */
-    private $_valid_wpdb_data_types = array('%d', '%s', '%f');
-
-    /**
-     *    EE_Registry Object
-     *
-     * @var    object
-     * @access    protected
-     */
-    protected $EE = null;
-
-
-    /**
-     * Property which, when set, will have this model echo out the next X queries to the page for debugging.
-     *
-     * @var int
-     */
-    protected $_show_next_x_db_queries = 0;
-
-    /**
-     * When using _get_all_wpdb_results, you can specify a custom selection. If you do so,
-     * it gets saved on this property so those selections can be used in WHERE, GROUP_BY, etc.
-     *
-     * @var array
-     */
-    protected $_custom_selections = array();
-
-    /**
-     * key => value Entity Map using  array( EEM_Base::$_model_query_blog_id => array( ID => model object ) )
-     * caches every model object we've fetched from the DB on this request
-     *
-     * @var array
-     */
-    protected $_entity_map;
-
-    /**
-     * constant used to show EEM_Base has not yet verified the db on this http request
-     */
-    const db_verified_none = 0;
-
-    /**
-     * constant used to show EEM_Base has verified the EE core db on this http request,
-     * but not the addons' dbs
-     */
-    const db_verified_core = 1;
-
-    /**
-     * constant used to show EEM_Base has verified the addons' dbs (and implicitly
-     * the EE core db too)
-     */
-    const db_verified_addons = 2;
-
-    /**
-     * indicates whether an EEM_Base child has already re-verified the DB
-     * is ok (we don't want to do it repetitively). Should be set to one the constants
-     * looking like EEM_Base::db_verified_*
-     *
-     * @var int - 0 = none, 1 = core, 2 = addons
-     */
-    protected static $_db_verification_level = EEM_Base::db_verified_none;
-
-
-
-    /**
-     * About all child constructors:
-     * they should define the _tables, _fields and _model_relations arrays.
-     * Should ALWAYS be called after child constructor.
-     * In order to make the child constructors to be as simple as possible, this parent constructor
-     * finalizes constructing all the object's attributes.
-     * Generally, rather than requiring a child to code
-     * $this->_tables = array(
-     *        'Event_Post_Table' => new EE_Table('Event_Post_Table','wp_posts')
-     *        ...);
-     *  (thus repeating itself in the array key and in the constructor of the new EE_Table,)
-     * each EE_Table has a function to set the table's alias after the constructor, using
-     * the array key ('Event_Post_Table'), instead of repeating it. The model fields and model relations
-     * do something similar.
-     *
-     * @param null $timezone
-     * @throws \EE_Error
-     */
-    protected function __construct($timezone = null)
-    {
-        // check that the model has not been loaded too soon
-        if ( ! did_action('AHEE__EE_System__load_espresso_addons')) {
-            throw new EE_Error (
-                sprintf(
-                    __('The %1$s model can not be loaded before the "AHEE__EE_System__load_espresso_addons" hook has been called. This gives other addons a chance to extend this model.',
-                        'event_espresso'),
-                    get_class($this)
-                )
-            );
-        }
-        /**
-         * Set blogid for models to current blog. However we ONLY do this if $_model_query_blog_id is not already set.
-         */
-        if (empty(EEM_Base::$_model_query_blog_id)) {
-            EEM_Base::set_model_query_blog_id();
-        }
-        /**
-         * Filters the list of tables on a model. It is best to NOT use this directly and instead
-         * just use EE_Register_Model_Extension
-         *
-         * @var EE_Table_Base[] $_tables
-         */
-        $this->_tables = apply_filters('FHEE__' . get_class($this) . '__construct__tables', $this->_tables);
-        foreach ($this->_tables as $table_alias => $table_obj) {
-            /** @var $table_obj EE_Table_Base */
-            $table_obj->_construct_finalize_with_alias($table_alias);
-            if ($table_obj instanceof EE_Secondary_Table) {
-                /** @var $table_obj EE_Secondary_Table */
-                $table_obj->_construct_finalize_set_table_to_join_with($this->_get_main_table());
-            }
-        }
-        /**
-         * Filters the list of fields on a model. It is best to NOT use this directly and instead just use
-         * EE_Register_Model_Extension
-         *
-         * @param EE_Model_Field_Base[] $_fields
-         */
-        $this->_fields = apply_filters('FHEE__' . get_class($this) . '__construct__fields', $this->_fields);
-        $this->_invalidate_field_caches();
-        foreach ($this->_fields as $table_alias => $fields_for_table) {
-            if ( ! array_key_exists($table_alias, $this->_tables)) {
-                throw new EE_Error(sprintf(__("Table alias %s does not exist in EEM_Base child's _tables array. Only tables defined are %s",
-                    'event_espresso'), $table_alias, implode(",", $this->_fields)));
-            }
-            foreach ($fields_for_table as $field_name => $field_obj) {
-                /** @var $field_obj EE_Model_Field_Base | EE_Primary_Key_Field_Base */
-                //primary key field base has a slightly different _construct_finalize
-                /** @var $field_obj EE_Model_Field_Base */
-                $field_obj->_construct_finalize($table_alias, $field_name, $this->get_this_model_name());
-            }
-        }
-        // everything is related to Extra_Meta
-        if (get_class($this) !== 'EEM_Extra_Meta') {
-            //make extra meta related to everything, but don't block deleting things just
-            //because they have related extra meta info. For now just orphan those extra meta
-            //in the future we should automatically delete them
-            $this->_model_relations['Extra_Meta'] = new EE_Has_Many_Any_Relation(false);
-        }
-        //and change logs
-        if (get_class($this) !== 'EEM_Change_Log') {
-            $this->_model_relations['Change_Log'] = new EE_Has_Many_Any_Relation(false);
-        }
-        /**
-         * Filters the list of relations on a model. It is best to NOT use this directly and instead just use
-         * EE_Register_Model_Extension
-         *
-         * @param EE_Model_Relation_Base[] $_model_relations
-         */
-        $this->_model_relations = apply_filters('FHEE__' . get_class($this) . '__construct__model_relations',
-            $this->_model_relations);
-        foreach ($this->_model_relations as $model_name => $relation_obj) {
-            /** @var $relation_obj EE_Model_Relation_Base */
-            $relation_obj->_construct_finalize_set_models($this->get_this_model_name(), $model_name);
-        }
-        foreach ($this->_indexes as $index_name => $index_obj) {
-            /** @var $index_obj EE_Index */
-            $index_obj->_construct_finalize($index_name, $this->get_this_model_name());
-        }
-        $this->set_timezone($timezone);
-        //finalize default where condition strategy, or set default
-        if ( ! $this->_default_where_conditions_strategy) {
-            //nothing was set during child constructor, so set default
-            $this->_default_where_conditions_strategy = new EE_Default_Where_Conditions();
-        }
-        $this->_default_where_conditions_strategy->_finalize_construct($this);
-        if ( ! $this->_minimum_where_conditions_strategy) {
-            //nothing was set during child constructor, so set default
-            $this->_minimum_where_conditions_strategy = new EE_Default_Where_Conditions();
-        }
-        $this->_minimum_where_conditions_strategy->_finalize_construct($this);
-        //if the cap slug hasn't been set, and we haven't set it to false on purpose
-        //to indicate to NOT set it, set it to the logical default
-        if ($this->_caps_slug === null) {
-            $this->_caps_slug = EEH_Inflector::pluralize_and_lower($this->get_this_model_name());
-        }
-        //initialize the standard cap restriction generators if none were specified by the child constructor
-        if ($this->_cap_restriction_generators !== false) {
-            foreach ($this->cap_contexts_to_cap_action_map() as $cap_context => $action) {
-                if ( ! isset($this->_cap_restriction_generators[$cap_context])) {
-                    $this->_cap_restriction_generators[$cap_context] = apply_filters(
-                        'FHEE__EEM_Base___construct__standard_cap_restriction_generator',
-                        new EE_Restriction_Generator_Protected(),
-                        $cap_context,
-                        $this
-                    );
-                }
-            }
-        }
-        //if there are cap restriction generators, use them to make the default cap restrictions
-        if ($this->_cap_restriction_generators !== false) {
-            foreach ($this->_cap_restriction_generators as $context => $generator_object) {
-                if ( ! $generator_object) {
-                    continue;
-                }
-                if ( ! $generator_object instanceof EE_Restriction_Generator_Base) {
-                    throw new EE_Error(
-                        sprintf(
-                            __('Index "%1$s" in the model %2$s\'s _cap_restriction_generators is not a child of EE_Restriction_Generator_Base. It should be that or NULL.',
-                                'event_espresso'),
-                            $context,
-                            $this->get_this_model_name()
-                        )
-                    );
-                }
-                $action = $this->cap_action_for_context($context);
-                if ( ! $generator_object->construction_finalized()) {
-                    $generator_object->_construct_finalize($this, $action);
-                }
-            }
-        }
-        do_action('AHEE__' . get_class($this) . '__construct__end');
-    }
-
-
-
-    /**
-     * Generates the cap restrictions for the given context, or if they were
-     * already generated just gets what's cached
-     *
-     * @param string $context one of EEM_Base::valid_cap_contexts()
-     * @return EE_Default_Where_Conditions[]
-     */
-    protected function _generate_cap_restrictions($context)
-    {
-        if (isset($this->_cap_restriction_generators[$context])
-            && $this->_cap_restriction_generators[$context]
-               instanceof
-               EE_Restriction_Generator_Base
-        ) {
-            return $this->_cap_restriction_generators[$context]->generate_restrictions();
-        } else {
-            return array();
-        }
-    }
-
-
-
-    /**
-     * Used to set the $_model_query_blog_id static property.
-     *
-     * @param int $blog_id  If provided then will set the blog_id for the models to this id.  If not provided then the
-     *                      value for get_current_blog_id() will be used.
-     */
-    public static function set_model_query_blog_id($blog_id = 0)
-    {
-        EEM_Base::$_model_query_blog_id = $blog_id > 0 ? (int)$blog_id : get_current_blog_id();
-    }
-
-
-
-    /**
-     * Returns whatever is set as the internal $model_query_blog_id.
-     *
-     * @return int
-     */
-    public static function get_model_query_blog_id()
-    {
-        return EEM_Base::$_model_query_blog_id;
-    }
-
-
-
-    /**
-     *        This function is a singleton method used to instantiate the Espresso_model object
-     *
-     * @access public
-     * @param string $timezone string representing the timezone we want to set for returned Date Time Strings (and any
-     *                         incoming timezone data that gets saved).  Note this just sends the timezone info to the
-     *                         date time model field objects.  Default is NULL (and will be assumed using the set
-     *                         timezone in the 'timezone_string' wp option)
-     * @return static (as in the concrete child class)
-     */
-    public static function instance($timezone = null)
-    {
-        // check if instance of Espresso_model already exists
-        if ( ! static::$_instance instanceof static) {
-            // instantiate Espresso_model
-            static::$_instance = new static($timezone);
-        }
-        //we might have a timezone set, let set_timezone decide what to do with it
-        static::$_instance->set_timezone($timezone);
-        // Espresso_model object
-        return static::$_instance;
-    }
-
-
-
-    /**
-     * resets the model and returns it
-     *
-     * @param null | string $timezone
-     * @return EEM_Base|null (if the model was already instantiated, returns it, with
-     * all its properties reset; if it wasn't instantiated, returns null)
-     */
-    public static function reset($timezone = null)
-    {
-        if (static::$_instance instanceof EEM_Base) {
-            //let's try to NOT swap out the current instance for a new one
-            //because if someone has a reference to it, we can't remove their reference
-            //so it's best to keep using the same reference, but change the original object
-            //reset all its properties to their original values as defined in the class
-            $r = new ReflectionClass(get_class(static::$_instance));
-            $static_properties = $r->getStaticProperties();
-            foreach ($r->getDefaultProperties() as $property => $value) {
-                //don't set instance to null like it was originally,
-                //but it's static anyways, and we're ignoring static properties (for now at least)
-                if ( ! isset($static_properties[$property])) {
-                    static::$_instance->{$property} = $value;
-                }
-            }
-            //and then directly call its constructor again, like we would if we
-            //were creating a new one
-            static::$_instance->__construct($timezone);
-            return self::instance();
-        }
-        return null;
-    }
-
-
-
-    /**
-     * retrieve the status details from esp_status table as an array IF this model has the status table as a relation.
-     *
-     * @param  boolean $translated return localized strings or JUST the array.
-     * @return array
-     * @throws \EE_Error
-     */
-    public function status_array($translated = false)
-    {
-        if ( ! array_key_exists('Status', $this->_model_relations)) {
-            return array();
-        }
-        $model_name = $this->get_this_model_name();
-        $status_type = str_replace(' ', '_', strtolower(str_replace('_', ' ', $model_name)));
-        $stati = EEM_Status::instance()->get_all(array(array('STS_type' => $status_type)));
-        $status_array = array();
-        foreach ($stati as $status) {
-            $status_array[$status->ID()] = $status->get('STS_code');
-        }
-        return $translated
-            ? EEM_Status::instance()->localized_status($status_array, false, 'sentence')
-            : $status_array;
-    }
-
-
-
-    /**
-     * Gets all the EE_Base_Class objects which match the $query_params, by querying the DB.
-     *
-     * @param array $query_params             {
-     * @var array $0 (where) array {
-     *                                        eg: array('QST_display_text'=>'Are you bob?','QST_admin_text'=>'Determine
-     *                                        if user is bob') becomes SQL >> "...WHERE QST_display_text = 'Are you
-     *                                        bob?' AND QST_admin_text = 'Determine if user is bob'...") To add WHERE
-     *                                        conditions based on related models (and even
-     *                                        models-related-to-related-models) prepend the model's name onto the field
-     *                                        name. Eg,
-     *                                        EEM_Event::instance()->get_all(array(array('Venue.VNU_ID'=>12))); becomes
-     *                                        SQL >> "SELECT * FROM wp_posts AS Event_CPT LEFT JOIN wp_esp_event_meta
-     *                                        AS Event_Meta ON Event_CPT.ID = Event_Meta.EVT_ID LEFT JOIN
-     *                                        wp_esp_event_venue AS Event_Venue ON Event_Venue.EVT_ID=Event_CPT.ID LEFT
-     *                                        JOIN wp_posts AS Venue_CPT ON Venue_CPT.ID=Event_Venue.VNU_ID LEFT JOIN wp_esp_venue_meta AS Venue_Meta ON Venue_CPT.ID = Venue_Meta.VNU_ID WHERE Venue_CPT.ID = 12 Notice that automatically
-     *                                        took care of joining Events to Venues (even when each of those models actually consisted of two tables). Also, you may chain the model relations together. Eg instead of just having
-     *                                        "Venue.VNU_ID", you could have
-     *                                        "Registration.Attendee.ATT_ID" as a field on a query for events (because
-     *                                        events are related to Registrations, which are related to Attendees). You
-     *                                        can take it even further with
-     *                                        "Registration.Transaction.Payment.PAY_amount" etc. To change the operator
-     *                                        (from the default of '='), change the value to an numerically-indexed
-     *                                        array, where the first item in the list is the operator. eg: array(
-     *                                        'QST_display_text' => array('LIKE','%bob%'), 'QST_ID' => array('<',34),
-     *                                        'QST_wp_user' => array('in',array(1,2,7,23))) becomes SQL >> "...WHERE
-     *                                        QST_display_text LIKE '%bob%' AND QST_ID < 34 AND QST_wp_user IN
-     *                                        (1,2,7,23)...". Valid operators so far: =, !=, <, <=, >, >=, LIKE, NOT
-     *                                        LIKE, IN (followed by numeric-indexed array), NOT IN (dido), BETWEEN (followed by an array with exactly 2 date strings), IS NULL, and IS NOT NULL Values can be a string, int, or float. They can
-     *                                        also be arrays IFF the operator is IN. Also, values can actually be field names. To indicate the value is a field, simply provide a third array item (true) to the operator-value array like so:
-     *                                        eg: array( 'DTT_reg_limit' => array('>', 'DTT_sold', TRUE) ) becomes SQL >> "...WHERE DTT_reg_limit > DTT_sold" Note: you can also use related model field names like you would any other field
-     *                                        name. eg: array('Datetime.DTT_reg_limit'=>array('=','Datetime.DTT_sold',TRUE) could be used if you were querying EEM_Tickets (because Datetime is directly related to tickets) Also, by default
-     *                                        all the where conditions are AND'd together. To override this, add an array key 'OR' (or 'AND') and the array to be OR'd together eg: array('OR'=>array('TXN_ID' => 23 , 'TXN_timestamp__>' =>
-     *                                        345678912)) becomes SQL >> "...WHERE TXN_ID = 23 OR TXN_timestamp = 345678912...". Also, to negate an entire set of conditions, use 'NOT' as an array key. eg: array('NOT'=>array('TXN_total' =>
-     *                                        50, 'TXN_paid'=>23) becomes SQL >> "...where ! (TXN_total =50 AND TXN_paid =23) Note: the 'glue' used to join each condition will continue to be what you last specified. IE, "AND"s by default,
-     *                                        but if you had previously specified to use ORs to join, ORs will continue to be used. So, if you specify to use an "OR" to join conditions, it will continue to "stick" until you specify an AND.
-     *                                        eg array('OR'=>array('NOT'=>array('TXN_total' => 50, 'TXN_paid'=>23)),AND=>array('TXN_ID'=>1,'STS_ID'=>'TIN') becomes SQL >> "...where ! (TXN_total =50 OR TXN_paid =23) AND TXN_ID=1 AND
-     *                                        STS_ID='TIN'" They can be nested indefinitely. eg: array('OR'=>array('TXN_total' => 23, 'NOT'=> array( 'TXN_timestamp'=> 345678912, 'AND'=>array('TXN_paid' => 53, 'STS_ID' => 'TIN')))) becomes
-     *                                        SQL >> "...WHERE TXN_total = 23 OR ! (TXN_timestamp = 345678912 OR (TXN_paid = 53 AND STS_ID = 'TIN'))..." GOTCHA: because this is an array, array keys must be unique, making it impossible to
-     *                                        place two or more where conditions applying to the same field. eg:
-     *                                        array('PAY_timestamp'=>array('>',$start_date),'PAY_timestamp'=>array('<',$end_date),'PAY_timestamp'=>array('!=',$special_date)), as PHP enforces that the array keys must be unique, thus
-     *                                        removing the first two array entries with key 'PAY_timestamp'. becomes SQL >> "PAY_timestamp !=  4234232", ignoring the first two PAY_timestamp conditions). To overcome this, you can add a '*'
-     *                                        character to the end of the field's name, followed by anything. These will be removed when generating the SQL string, but allow for the array keys to be unique. eg: you could rewrite the
-     *                                        previous query as: array('PAY_timestamp'=>array('>',$start_date),'PAY_timestamp*1st'=>array('<',$end_date),'PAY_timestamp*2nd'=>array('!=',$special_date)) which correctly becomes SQL >>
-     *                                        "PAY_timestamp > 123412341 AND PAY_timestamp < 2354235235234 AND PAY_timestamp != 1241234123" This can be applied to condition operators too, eg:
-     *                                        array('OR'=>array('REG_ID'=>3,'Transaction.TXN_ID'=>23),'OR*whatever'=>array('Attendee.ATT_fname'=>'bob','Attendee.ATT_lname'=>'wilson')));
-     * @var mixed   $limit                    int|array    adds a limit to the query just like the SQL limit clause, so
-     *                                        limits of "23", "25,50", and array(23,42) are all valid would become SQL "...LIMIT 23", "...LIMIT 25,50",
-     *                                        and "...LIMIT 23,42" respectively. Remember when you provide two numbers for the limit, the 1st number is
-     *                                        the OFFSET, the 2nd is the LIMIT
-     * @var array   $on_join_limit            allows the setting of a special select join with a internal limit so you
-     *                                        can do paging on one-to-many multi-table-joins. Send an array in the following format array('on_join_limit'
-     *                                        => array( 'table_alias', array(1,2) ) ).
-     * @var mixed   $order_by                 name of a column to order by, or an array where keys are field names and
-     *                                        values are either 'ASC' or 'DESC'. 'limit'=>array('STS_ID'=>'ASC','REG_date'=>'DESC'), which would becomes
-     *                                        SQL "...ORDER BY TXN_timestamp..." and "...ORDER BY STS_ID ASC, REG_date DESC..." respectively. Like the
-     *                                        'where' conditions, these fields can be on related models. Eg
-     *                                        'order_by'=>array('Registration.Transaction.TXN_amount'=>'ASC') is perfectly valid from any model related
-     *                                        to 'Registration' (like Event, Attendee, Price, Datetime, etc.)
-     * @var string  $order                    If 'order_by' is used and its value is a string (NOT an array), then
-     *                                        'order' specifies whether to order the field specified in 'order_by' in ascending or descending order.
-     *                                        Acceptable values are 'ASC' or 'DESC'. If, 'order_by' isn't used, but 'order' is, then it is assumed you
-     *                                        want to order by the primary key. Eg,
-     *                                        EEM_Event::instance()->get_all(array('order_by'=>'Datetime.DTT_EVT_start','order'=>'ASC'); //(will join
-     *                                        with the Datetime model's table(s) and order by its field DTT_EVT_start) or
-     *                                        EEM_Registration::instance()->get_all(array('order'=>'ASC'));//will make SQL "SELECT * FROM
-     *                                        wp_esp_registration ORDER BY REG_ID ASC"
-     * @var mixed   $group_by                 name of field to order by, or an array of fields. Eg either
-     *                                        'group_by'=>'VNU_ID', or 'group_by'=>array('EVT_name','Registration.Transaction.TXN_total') Note: if no
-     *                                        $group_by is specified, and a limit is set, automatically groups by the model's primary key (or combined
-     *                                        primary keys). This avoids some weirdness that results when using limits, tons of joins, and no group by,
-     *                                        see https://events.codebasehq.com/projects/event-espresso/tickets/9389
-     * @var array   $having                   exactly like WHERE parameters array, except these conditions apply to the
-     *                                        grouped results (whereas WHERE conditions apply to the pre-grouped results)
-     * @var array   $force_join               forces a join with the models named. Should be a numerically-indexed
-     *                                        array where values are models to be joined in the query.Eg array('Attendee','Payment','Datetime'). You may
-     *                                        join with transient models using period, eg "Registration.Transaction.Payment". You will probably only want
-     *                                        to do this in hopes of increasing efficiency, as related models which belongs to the current model
-     *                                        (ie, the current model has a foreign key to them, like how Registration
-     *                                        belongs to Attendee) can be cached in order to avoid future queries
-     * @var string  $default_where_conditions can be set to 'none', 'this_model_only', 'other_models_only', or 'all'.
-     *                                        set this to 'none' to disable all default where conditions. Eg, usually soft-deleted objects are
-     *                                        filtered-out if you want to include them, set this query param to 'none'. If you want to ONLY disable THIS
-     *                                        model's default where conditions set it to 'other_models_only'. If you only want this model's default where
-     *                                        conditions added to the query, use 'this_model_only'. If you want to use all default where conditions
-     *                                        (default), set to 'all'.
-     * @var string  $caps                     controls what capability requirements to apply to the query; ie, should
-     *                                        we just NOT apply any capabilities/permissions/restrictions and return everything? Or should we only show
-     *                                        the current user items they should be able to view on the frontend, backend, edit, or delete? can be set to
-     *                                        'none' (default), 'read_frontend', 'read_backend', 'edit' or 'delete'
-     *                                        }
-     * @return EE_Base_Class[]  *note that there is NO option to pass the output type. If you want results different
-     *                                        from EE_Base_Class[], use _get_all_wpdb_results()and make it public again. Array keys
-     *                                        are object IDs (if there is a primary key on the model. if not, numerically indexed)
-     *                                        Some full examples: get 10 transactions which have Scottish attendees:
-     *                                        EEM_Transaction::instance()->get_all( array( array(
-     *                                        'OR'=>array(
-     *                                        'Registration.Attendee.ATT_fname'=>array('like','Mc%'),
-     *                                        'Registration.Attendee.ATT_fname*other'=>array('like','Mac%')
-     *                                        )
-     *                                        ),
-     *                                        'limit'=>10,
-     *                                        'group_by'=>'TXN_ID'
-     *                                        ));
-     *                                        get all the answers to the question titled "shirt size" for event with id
-     *                                        12, ordered by their answer EEM_Answer::instance()->get_all(array( array(
-     *                                        'Question.QST_display_text'=>'shirt size',
-     *                                        'Registration.Event.EVT_ID'=>12
-     *                                        ),
-     *                                        'order_by'=>array('ANS_value'=>'ASC')
-     *                                        ));
-     * @throws \EE_Error
-     */
-    public function get_all($query_params = array())
-    {
-        if (isset($query_params['limit'])
-            && ! isset($query_params['group_by'])
-        ) {
-            $query_params['group_by'] = array_keys($this->get_combined_primary_key_fields());
-        }
-        return $this->_create_objects($this->_get_all_wpdb_results($query_params, ARRAY_A, null));
-    }
-
-
-
-    /**
-     * Modifies the query parameters so we only get back model objects
-     * that "belong" to the current user
-     *
-     * @param array $query_params @see EEM_Base::get_all()
-     * @return array like EEM_Base::get_all
-     */
-    public function alter_query_params_to_only_include_mine($query_params = array())
-    {
-        $wp_user_field_name = $this->wp_user_field_name();
-        if ($wp_user_field_name) {
-            $query_params[0][$wp_user_field_name] = get_current_user_id();
-        }
-        return $query_params;
-    }
-
-
-
-    /**
-     * Returns the name of the field's name that points to the WP_User table
-     *  on this model (or follows the _model_chain_to_wp_user and uses that model's
-     * foreign key to the WP_User table)
-     *
-     * @return string|boolean string on success, boolean false when there is no
-     * foreign key to the WP_User table
-     */
-    public function wp_user_field_name()
-    {
-        try {
-            if ( ! empty($this->_model_chain_to_wp_user)) {
-                $models_to_follow_to_wp_users = explode('.', $this->_model_chain_to_wp_user);
-                $last_model_name = end($models_to_follow_to_wp_users);
-                $model_with_fk_to_wp_users = EE_Registry::instance()->load_model($last_model_name);
-                $model_chain_to_wp_user = $this->_model_chain_to_wp_user . '.';
-            } else {
-                $model_with_fk_to_wp_users = $this;
-                $model_chain_to_wp_user = '';
-            }
-            $wp_user_field = $model_with_fk_to_wp_users->get_foreign_key_to('WP_User');
-            return $model_chain_to_wp_user . $wp_user_field->get_name();
-        } catch (EE_Error $e) {
-            return false;
-        }
-    }
-
-
-
-    /**
-     * Returns the _model_chain_to_wp_user string, which indicates which related model
-     * (or transiently-related model) has a foreign key to the wp_users table;
-     * useful for finding if model objects of this type are 'owned' by the current user.
-     * This is an empty string when the foreign key is on this model and when it isn't,
-     * but is only non-empty when this model's ownership is indicated by a RELATED model
-     * (or transiently-related model)
-     *
-     * @return string
-     */
-    public function model_chain_to_wp_user()
-    {
-        return $this->_model_chain_to_wp_user;
-    }
-
-
-
-    /**
-     * Whether this model is 'owned' by a specific wordpress user (even indirectly,
-     * like how registrations don't have a foreign key to wp_users, but the
-     * events they are for are), or is unrelated to wp users.
-     * generally available
-     *
-     * @return boolean
-     */
-    public function is_owned()
-    {
-        if ($this->model_chain_to_wp_user()) {
-            return true;
-        } else {
-            try {
-                $this->get_foreign_key_to('WP_User');
-                return true;
-            } catch (EE_Error $e) {
-                return false;
-            }
-        }
-    }
-
-
-
-    /**
-     * Used internally to get WPDB results, because other functions, besides get_all, may want to do some queries, but
-     * may want to preserve the WPDB results (eg, update, which first queries to make sure we have all the tables on
-     * the model)
-     *
-     * @param array  $query_params      like EEM_Base::get_all's $query_params
-     * @param string $output            ARRAY_A, OBJECT_K, etc. Just like
-     * @param mixed  $columns_to_select , What columns to select. By default, we select all columns specified by the
-     *                                  fields on the model, and the models we joined to in the query. However, you can
-     *                                  override this and set the select to "*", or a specific column name, like
-     *                                  "ATT_ID", etc. If you would like to use these custom selections in WHERE,
-     *                                  GROUP_BY, or HAVING clauses, you must instead provide an array. Array keys are
-     *                                  the aliases used to refer to this selection, and values are to be
-     *                                  numerically-indexed arrays, where 0 is the selection and 1 is the data type.
-     *                                  Eg, array('count'=>array('COUNT(REG_ID)','%d'))
-     * @return array | stdClass[] like results of $wpdb->get_results($sql,OBJECT), (ie, output type is OBJECT)
-     * @throws \EE_Error
-     */
-    protected function _get_all_wpdb_results($query_params = array(), $output = ARRAY_A, $columns_to_select = null)
-    {
-        // remember the custom selections, if any, and type cast as array
-        // (unless $columns_to_select is an object, then just set as an empty array)
-        // Note: (array) 'some string' === array( 'some string' )
-        $this->_custom_selections = ! is_object($columns_to_select) ? (array)$columns_to_select : array();
-        $model_query_info = $this->_create_model_query_info_carrier($query_params);
-        $select_expressions = $columns_to_select !== null
-            ? $this->_construct_select_from_input($columns_to_select)
-            : $this->_construct_default_select_sql($model_query_info);
-        $SQL = "SELECT $select_expressions " . $this->_construct_2nd_half_of_select_query($model_query_info);
-        return $this->_do_wpdb_query('get_results', array($SQL, $output));
-    }
-
-
-
-    /**
-     * Gets an array of rows from the database just like $wpdb->get_results would,
-     * but you can use the $query_params like on EEM_Base::get_all() to more easily
-     * take care of joins, field preparation etc.
-     *
-     * @param array  $query_params      like EEM_Base::get_all's $query_params
-     * @param string $output            ARRAY_A, OBJECT_K, etc. Just like
-     * @param mixed  $columns_to_select , What columns to select. By default, we select all columns specified by the
-     *                                  fields on the model, and the models we joined to in the query. However, you can
-     *                                  override this and set the select to "*", or a specific column name, like
-     *                                  "ATT_ID", etc. If you would like to use these custom selections in WHERE,
-     *                                  GROUP_BY, or HAVING clauses, you must instead provide an array. Array keys are
-     *                                  the aliases used to refer to this selection, and values are to be
-     *                                  numerically-indexed arrays, where 0 is the selection and 1 is the data type.
-     *                                  Eg, array('count'=>array('COUNT(REG_ID)','%d'))
-     * @return array|stdClass[] like results of $wpdb->get_results($sql,OBJECT), (ie, output type is OBJECT)
-     * @throws \EE_Error
-     */
-    public function get_all_wpdb_results($query_params = array(), $output = ARRAY_A, $columns_to_select = null)
-    {
-        return $this->_get_all_wpdb_results($query_params, $output, $columns_to_select);
-    }
-
-
-
-    /**
-     * For creating a custom select statement
-     *
-     * @param mixed $columns_to_select either a string to be inserted directly as the select statement,
-     *                                 or an array where keys are aliases, and values are arrays where 0=>the selection
-     *                                 SQL, and 1=>is the datatype
-     * @throws EE_Error
-     * @return string
-     */
-    private function _construct_select_from_input($columns_to_select)
-    {
-        if (is_array($columns_to_select)) {
-            $select_sql_array = array();
-            foreach ($columns_to_select as $alias => $selection_and_datatype) {
-                if ( ! is_array($selection_and_datatype) || ! isset($selection_and_datatype[1])) {
-                    throw new EE_Error(
-                        sprintf(
-                            __(
-                                "Custom selection %s (alias %s) needs to be an array like array('COUNT(REG_ID)','%%d')",
-                                "event_espresso"
-                            ),
-                            $selection_and_datatype,
-                            $alias
-                        )
-                    );
-                }
-                if ( ! in_array($selection_and_datatype[1], $this->_valid_wpdb_data_types)) {
-                    throw new EE_Error(
-                        sprintf(
-                            __(
-                                "Datatype %s (for selection '%s' and alias '%s') is not a valid wpdb datatype (eg %%s)",
-                                "event_espresso"
-                            ),
-                            $selection_and_datatype[1],
-                            $selection_and_datatype[0],
-                            $alias,
-                            implode(",", $this->_valid_wpdb_data_types)
-                        )
-                    );
-                }
-                $select_sql_array[] = "{$selection_and_datatype[0]} AS $alias";
-            }
-            $columns_to_select_string = implode(", ", $select_sql_array);
-        } else {
-            $columns_to_select_string = $columns_to_select;
-        }
-        return $columns_to_select_string;
-    }
-
-
-
-    /**
-     * Convenient wrapper for getting the primary key field's name. Eg, on Registration, this would be 'REG_ID'
-     *
-     * @return string
-     * @throws \EE_Error
-     */
-    public function primary_key_name()
-    {
-        return $this->get_primary_key_field()->get_name();
-    }
-
-
-
-    /**
-     * Gets a single item for this model from the DB, given only its ID (or null if none is found).
-     * If there is no primary key on this model, $id is treated as primary key string
-     *
-     * @param mixed $id int or string, depending on the type of the model's primary key
-     * @return EE_Base_Class
-     */
-    public function get_one_by_ID($id)
-    {
-        if ($this->get_from_entity_map($id)) {
-            return $this->get_from_entity_map($id);
-        }
-        return $this->get_one(
-            $this->alter_query_params_to_restrict_by_ID(
-                $id,
-                array('default_where_conditions' => 'minimum')
-            )
-        );
-    }
-
-
-
-    /**
-     * Alters query parameters to only get items with this ID are returned.
-     * Takes into account that the ID might be a string produced by EEM_Base::get_index_primary_key_string(),
-     * or could just be a simple primary key ID
-     *
-     * @param int   $id
-     * @param array $query_params
-     * @return array of normal query params, @see EEM_Base::get_all
-     * @throws \EE_Error
-     */
-    public function alter_query_params_to_restrict_by_ID($id, $query_params = array())
-    {
-        if ( ! isset($query_params[0])) {
-            $query_params[0] = array();
-        }
-        $conditions_from_id = $this->parse_index_primary_key_string($id);
-        if ($conditions_from_id === null) {
-            $query_params[0][$this->primary_key_name()] = $id;
-        } else {
-            //no primary key, so the $id must be from the get_index_primary_key_string()
-            $query_params[0] = array_replace_recursive($query_params[0], $this->parse_index_primary_key_string($id));
-        }
-        return $query_params;
-    }
-
-
-
-    /**
-     * Gets a single item for this model from the DB, given the $query_params. Only returns a single class, not an
-     * array. If no item is found, null is returned.
-     *
-     * @param array $query_params like EEM_Base's $query_params variable.
-     * @return EE_Base_Class|EE_Soft_Delete_Base_Class|NULL
-     * @throws \EE_Error
-     */
-    public function get_one($query_params = array())
-    {
-        if ( ! is_array($query_params)) {
-            EE_Error::doing_it_wrong('EEM_Base::get_one',
-                sprintf(__('$query_params should be an array, you passed a variable of type %s', 'event_espresso'),
-                    gettype($query_params)), '4.6.0');
-            $query_params = array();
-        }
-        $query_params['limit'] = 1;
-        $items = $this->get_all($query_params);
-        if (empty($items)) {
-            return null;
-        } else {
-            return array_shift($items);
-        }
-    }
-
-
-
-    /**
-     * Returns the next x number of items in sequence from the given value as
-     * found in the database matching the given query conditions.
-     *
-     * @param mixed $current_field_value    Value used for the reference point.
-     * @param null  $field_to_order_by      What field is used for the
-     *                                      reference point.
-     * @param int   $limit                  How many to return.
-     * @param array $query_params           Extra conditions on the query.
-     * @param null  $columns_to_select      If left null, then an array of
-     *                                      EE_Base_Class objects is returned,
-     *                                      otherwise you can indicate just the
-     *                                      columns you want returned.
-     * @return EE_Base_Class[]|array
-     * @throws \EE_Error
-     */
-    public function next_x(
-        $current_field_value,
-        $field_to_order_by = null,
-        $limit = 1,
-        $query_params = array(),
-        $columns_to_select = null
-    ) {
-        return $this->_get_consecutive($current_field_value, '>', $field_to_order_by, $limit, $query_params,
-            $columns_to_select);
-    }
-
-
-
-    /**
-     * Returns the previous x number of items in sequence from the given value
-     * as found in the database matching the given query conditions.
-     *
-     * @param mixed $current_field_value    Value used for the reference point.
-     * @param null  $field_to_order_by      What field is used for the
-     *                                      reference point.
-     * @param int   $limit                  How many to return.
-     * @param array $query_params           Extra conditions on the query.
-     * @param null  $columns_to_select      If left null, then an array of
-     *                                      EE_Base_Class objects is returned,
-     *                                      otherwise you can indicate just the
-     *                                      columns you want returned.
-     * @return EE_Base_Class[]|array
-     * @throws \EE_Error
-     */
-    public function previous_x(
-        $current_field_value,
-        $field_to_order_by = null,
-        $limit = 1,
-        $query_params = array(),
-        $columns_to_select = null
-    ) {
-        return $this->_get_consecutive($current_field_value, '<', $field_to_order_by, $limit, $query_params,
-            $columns_to_select);
-    }
-
-
-
-    /**
-     * Returns the next item in sequence from the given value as found in the
-     * database matching the given query conditions.
-     *
-     * @param mixed $current_field_value    Value used for the reference point.
-     * @param null  $field_to_order_by      What field is used for the
-     *                                      reference point.
-     * @param array $query_params           Extra conditions on the query.
-     * @param null  $columns_to_select      If left null, then an EE_Base_Class
-     *                                      object is returned, otherwise you
-     *                                      can indicate just the columns you
-     *                                      want and a single array indexed by
-     *                                      the columns will be returned.
-     * @return EE_Base_Class|null|array()
-     * @throws \EE_Error
-     */
-    public function next(
-        $current_field_value,
-        $field_to_order_by = null,
-        $query_params = array(),
-        $columns_to_select = null
-    ) {
-        $results = $this->_get_consecutive($current_field_value, '>', $field_to_order_by, 1, $query_params,
-            $columns_to_select);
-        return empty($results) ? null : reset($results);
-    }
-
-
-
-    /**
-     * Returns the previous item in sequence from the given value as found in
-     * the database matching the given query conditions.
-     *
-     * @param mixed $current_field_value    Value used for the reference point.
-     * @param null  $field_to_order_by      What field is used for the
-     *                                      reference point.
-     * @param array $query_params           Extra conditions on the query.
-     * @param null  $columns_to_select      If left null, then an EE_Base_Class
-     *                                      object is returned, otherwise you
-     *                                      can indicate just the columns you
-     *                                      want and a single array indexed by
-     *                                      the columns will be returned.
-     * @return EE_Base_Class|null|array()
-     * @throws EE_Error
-     */
-    public function previous(
-        $current_field_value,
-        $field_to_order_by = null,
-        $query_params = array(),
-        $columns_to_select = null
-    ) {
-        $results = $this->_get_consecutive($current_field_value, '<', $field_to_order_by, 1, $query_params,
-            $columns_to_select);
-        return empty($results) ? null : reset($results);
-    }
-
-
-
-    /**
-     * Returns the a consecutive number of items in sequence from the given
-     * value as found in the database matching the given query conditions.
-     *
-     * @param mixed  $current_field_value   Value used for the reference point.
-     * @param string $operand               What operand is used for the sequence.
-     * @param string $field_to_order_by     What field is used for the reference point.
-     * @param int    $limit                 How many to return.
-     * @param array  $query_params          Extra conditions on the query.
-     * @param null   $columns_to_select     If left null, then an array of EE_Base_Class objects is returned,
-     *                                      otherwise you can indicate just the columns you want returned.
-     * @return EE_Base_Class[]|array
-     * @throws EE_Error
-     */
-    protected function _get_consecutive(
-        $current_field_value,
-        $operand = '>',
-        $field_to_order_by = null,
-        $limit = 1,
-        $query_params = array(),
-        $columns_to_select = null
-    ) {
-        //if $field_to_order_by is empty then let's assume we're ordering by the primary key.
-        if (empty($field_to_order_by)) {
-            if ($this->has_primary_key_field()) {
-                $field_to_order_by = $this->get_primary_key_field()->get_name();
-            } else {
-                if (WP_DEBUG) {
-                    throw new EE_Error(__('EEM_Base::_get_consecutive() has been called with no $field_to_order_by argument and there is no primary key on the field.  Please provide the field you would like to use as the base for retrieving the next item(s).',
-                        'event_espresso'));
-                }
-                EE_Error::add_error(__('There was an error with the query.', 'event_espresso'));
-                return array();
-            }
-        }
-        if ( ! is_array($query_params)) {
-            EE_Error::doing_it_wrong('EEM_Base::_get_consecutive',
-                sprintf(__('$query_params should be an array, you passed a variable of type %s', 'event_espresso'),
-                    gettype($query_params)), '4.6.0');
-            $query_params = array();
-        }
-        //let's add the where query param for consecutive look up.
-        $query_params[0][$field_to_order_by] = array($operand, $current_field_value);
-        $query_params['limit'] = $limit;
-        //set direction
-        $incoming_orderby = isset($query_params['order_by']) ? (array)$query_params['order_by'] : array();
-        $query_params['order_by'] = $operand === '>'
-            ? array($field_to_order_by => 'ASC') + $incoming_orderby
-            : array($field_to_order_by => 'DESC') + $incoming_orderby;
-        //if $columns_to_select is empty then that means we're returning EE_Base_Class objects
-        if (empty($columns_to_select)) {
-            return $this->get_all($query_params);
-        } else {
-            //getting just the fields
-            return $this->_get_all_wpdb_results($query_params, ARRAY_A, $columns_to_select);
-        }
-    }
-
-
-
-    /**
-     * This sets the _timezone property after model object has been instantiated.
-     *
-     * @param null | string $timezone valid PHP DateTimeZone timezone string
-     */
-    public function set_timezone($timezone)
-    {
-        if ($timezone !== null) {
-            $this->_timezone = $timezone;
-        }
-        //note we need to loop through relations and set the timezone on those objects as well.
-        foreach ($this->_model_relations as $relation) {
-            $relation->set_timezone($timezone);
-        }
-        //and finally we do the same for any datetime fields
-        foreach ($this->_fields as $field) {
-            if ($field instanceof EE_Datetime_Field) {
-                $field->set_timezone($timezone);
-            }
-        }
-    }
-
-
-
-    /**
-     * This just returns whatever is set for the current timezone.
-     *
-     * @access public
-     * @return string
-     */
-    public function get_timezone()
-    {
-        //first validate if timezone is set.  If not, then let's set it be whatever is set on the model fields.
-        if (empty($this->_timezone)) {
-            foreach ($this->_fields as $field) {
-                if ($field instanceof EE_Datetime_Field) {
-                    $this->set_timezone($field->get_timezone());
-                    break;
-                }
-            }
-        }
-        //if timezone STILL empty then return the default timezone for the site.
-        if (empty($this->_timezone)) {
-            $this->set_timezone(EEH_DTT_Helper::get_timezone());
-        }
-        return $this->_timezone;
-    }
-
-
-
-    /**
-     * This returns the date formats set for the given field name and also ensures that
-     * $this->_timezone property is set correctly.
-     *
-     * @since 4.6.x
-     * @param string $field_name The name of the field the formats are being retrieved for.
-     * @param bool   $pretty     Whether to return the pretty formats (true) or not (false).
-     * @throws EE_Error   If the given field_name is not of the EE_Datetime_Field type.
-     * @return array formats in an array with the date format first, and the time format last.
-     */
-    public function get_formats_for($field_name, $pretty = false)
-    {
-        $field_settings = $this->field_settings_for($field_name);
-        //if not a valid EE_Datetime_Field then throw error
-        if ( ! $field_settings instanceof EE_Datetime_Field) {
-            throw new EE_Error(sprintf(__('The field sent into EEM_Base::get_formats_for (%s) is not registered as a EE_Datetime_Field. Please check the spelling and make sure you are submitting the right field name to retrieve date_formats for.',
-                'event_espresso'), $field_name));
-        }
-        //while we are here, let's make sure the timezone internally in EEM_Base matches what is stored on
-        //the field.
-        $this->_timezone = $field_settings->get_timezone();
-        return array($field_settings->get_date_format($pretty), $field_settings->get_time_format($pretty));
-    }
-
-
-
-    /**
-     * This returns the current time in a format setup for a query on this model.
-     * Usage of this method makes it easier to setup queries against EE_Datetime_Field columns because
-     * it will return:
-     *  - a formatted string in the timezone and format currently set on the EE_Datetime_Field for the given field for
-     *  NOW
-     *  - or a unix timestamp (equivalent to time())
-     *
-     * @since 4.6.x
-     * @param string $field_name       The field the current time is needed for.
-     * @param bool   $timestamp        True means to return a unix timestamp. Otherwise a
-     *                                 formatted string matching the set format for the field in the set timezone will
-     *                                 be returned.
-     * @param string $what             Whether to return the string in just the time format, the date format, or both.
-     * @throws EE_Error    If the given field_name is not of the EE_Datetime_Field type.
-     * @return int|string  If the given field_name is not of the EE_Datetime_Field type, then an EE_Error
-     *                                 exception is triggered.
-     */
-    public function current_time_for_query($field_name, $timestamp = false, $what = 'both')
-    {
-        $formats = $this->get_formats_for($field_name);
-        $DateTime = new DateTime("now", new DateTimeZone($this->_timezone));
-        if ($timestamp) {
-            return $DateTime->format('U');
-        }
-        //not returning timestamp, so return formatted string in timezone.
-        switch ($what) {
-            case 'time' :
-                return $DateTime->format($formats[1]);
-                break;
-            case 'date' :
-                return $DateTime->format($formats[0]);
-                break;
-            default :
-                return $DateTime->format(implode(' ', $formats));
-                break;
-        }
-    }
-
-
-
-    /**
-     * This receives a time string for a given field and ensures that it is setup to match what the internal settings
-     * for the model are.  Returns a DateTime object.
-     * Note: a gotcha for when you send in unix timestamp.  Remember a unix timestamp is already timezone agnostic,
-     * (functionally the equivalent of UTC+0).  So when you send it in, whatever timezone string you include is
-     * ignored.
-     *
-     * @param string $field_name      The field being setup.
-     * @param string $timestring      The date time string being used.
-     * @param string $incoming_format The format for the time string.
-     * @param string $timezone        By default, it is assumed the incoming time string is in timezone for
-     *                                the blog.  If this is not the case, then it can be specified here.  If incoming
-     *                                format is
-     *                                'U', this is ignored.
-     * @return DateTime
-     * @throws \EE_Error
-     */
-    public function convert_datetime_for_query($field_name, $timestring, $incoming_format, $timezone = '')
-    {
-        //just using this to ensure the timezone is set correctly internally
-        $this->get_formats_for($field_name);
-        //load EEH_DTT_Helper
-        $set_timezone = empty($timezone) ? EEH_DTT_Helper::get_timezone() : $timezone;
-        $incomingDateTime = date_create_from_format($incoming_format, $timestring, new DateTimeZone($set_timezone));
-        return $incomingDateTime->setTimezone(new DateTimeZone($this->_timezone));
-    }
-
-
-
-    /**
-     * Gets all the tables comprising this model. Array keys are the table aliases, and values are EE_Table objects
-     *
-     * @return EE_Table_Base[]
-     */
-    public function get_tables()
-    {
-        return $this->_tables;
-    }
-
-
-
-    /**
-     * Updates all the database entries (in each table for this model) according to $fields_n_values and optionally
-     * also updates all the model objects, where the criteria expressed in $query_params are met..
-     * Also note: if this model has multiple tables, this update verifies all the secondary tables have an entry for
-     * each row (in the primary table) we're trying to update; if not, it inserts an entry in the secondary table. Eg:
-     * if our model has 2 tables: wp_posts (primary), and wp_esp_event (secondary). Let's say we are trying to update a
-     * model object with EVT_ID = 1
-     * (which means where wp_posts has ID = 1, because wp_posts.ID is the primary key's column), which exists, but
-     * there is no entry in wp_esp_event for this entry in wp_posts. So, this update script will insert a row into
-     * wp_esp_event, using any available parameters from $fields_n_values (eg, if "EVT_limit" => 40 is in
-     * $fields_n_values, the new entry in wp_esp_event will set EVT_limit = 40, and use default for other columns which
-     * are not specified)
-     *
-     * @param array   $fields_n_values         keys are model fields (exactly like keys in EEM_Base::_fields, NOT db
-     *                                         columns!), values are strings, ints, floats, and maybe arrays if they
-     *                                         are to be serialized. Basically, the values are what you'd expect to be
-     *                                         values on the model, NOT necessarily what's in the DB. For example, if
-     *                                         we wanted to update only the TXN_details on any Transactions where its
-     *                                         ID=34, we'd use this method as follows:
-     *                                         EEM_Transaction::instance()->update(
-     *                                         array('TXN_details'=>array('detail1'=>'monkey','detail2'=>'banana'),
-     *                                         array(array('TXN_ID'=>34)));
-     * @param array   $query_params            very much like EEM_Base::get_all's $query_params
-     *                                         in client code into what's expected to be stored on each field. Eg,
-     *                                         consider updating Question's QST_admin_label field is of type
-     *                                         Simple_HTML. If you use this function to update that field to $new_value
-     *                                         = (note replace 8's with appropriate opening and closing tags in the
-     *                                         following example)"8script8alert('I hack all');8/script88b8boom
-     *                                         baby8/b8", then if you set $values_already_prepared_by_model_object to
-     *                                         TRUE, it is assumed that you've already called
-     *                                         EE_Simple_HTML_Field->prepare_for_set($new_value), which removes the
-     *                                         malicious javascript. However, if
-     *                                         $values_already_prepared_by_model_object is left as FALSE, then
-     *                                         EE_Simple_HTML_Field->prepare_for_set($new_value) will be called on it, and every other field, before insertion. We provide this parameter because model objects perform their prepare_for_set
-     *                                         function on all their values, and so don't need to be called again (and in many cases, shouldn't be called again. Eg: if we escape HTML characters in the prepare_for_set method...)
-     * @param boolean $keep_model_objs_in_sync if TRUE, makes sure we ALSO update model objects
-     *                                         in this model's entity map according to $fields_n_values that match
-     *                                         $query_params. This obviously has some overhead, so you can disable it
-     *                                         by setting this to FALSE, but be aware that model objects being used
-     *                                         could get out-of-sync with the database
-     * @return int how many rows got updated or FALSE if something went wrong with the query (wp returns FALSE or num
-     *                                         rows affected which *could* include 0 which DOES NOT mean the query was bad)
-     * @throws \EE_Error
-     */
-    public function update($fields_n_values, $query_params, $keep_model_objs_in_sync = true)
-    {
-        if ( ! is_array($query_params)) {
-            EE_Error::doing_it_wrong('EEM_Base::update',
-                sprintf(__('$query_params should be an array, you passed a variable of type %s', 'event_espresso'),
-                    gettype($query_params)), '4.6.0');
-            $query_params = array();
-        }
-        /**
-         * Action called before a model update call has been made.
-         *
-         * @param EEM_Base $model
-         * @param array    $fields_n_values the updated fields and their new values
-         * @param array    $query_params    @see EEM_Base::get_all()
-         */
-        do_action('AHEE__EEM_Base__update__begin', $this, $fields_n_values, $query_params);
-        /**
-         * Filters the fields about to be updated given the query parameters. You can provide the
-         * $query_params to $this->get_all() to find exactly which records will be updated
-         *
-         * @param array    $fields_n_values fields and their new values
-         * @param EEM_Base $model           the model being queried
-         * @param array    $query_params    see EEM_Base::get_all()
-         */
-        $fields_n_values = (array)apply_filters('FHEE__EEM_Base__update__fields_n_values', $fields_n_values, $this,
-            $query_params);
-        //need to verify that, for any entry we want to update, there are entries in each secondary table.
-        //to do that, for each table, verify that it's PK isn't null.
-        $tables = $this->get_tables();
-        //and if the other tables don't have a row for each table-to-be-updated, we'll insert one with whatever values available in the current update query
-        //NOTE: we should make this code more efficient by NOT querying twice
-        //before the real update, but that needs to first go through ALPHA testing
-        //as it's dangerous. says Mike August 8 2014
-        //we want to make sure the default_where strategy is ignored
-        $this->_ignore_where_strategy = true;
-        $wpdb_select_results = $this->_get_all_wpdb_results($query_params);
-        foreach ($wpdb_select_results as $wpdb_result) {
-            // type cast stdClass as array
-            $wpdb_result = (array)$wpdb_result;
-            //get the model object's PK, as we'll want this if we need to insert a row into secondary tables
-            if ($this->has_primary_key_field()) {
-                $main_table_pk_value = $wpdb_result[$this->get_primary_key_field()->get_qualified_column()];
-            } else {
-                //if there's no primary key, we basically can't support having a 2nd table on the model (we could but it would be lots of work)
-                $main_table_pk_value = null;
-            }
-            //if there are more than 1 tables, we'll want to verify that each table for this model has an entry in the other tables
-            //and if the other tables don't have a row for each table-to-be-updated, we'll insert one with whatever values available in the current update query
-            if (count($tables) > 1) {
-                //foreach matching row in the DB, ensure that each table's PK isn't null. If so, there must not be an entry
-                //in that table, and so we'll want to insert one
-                foreach ($tables as $table_obj) {
-                    $this_table_pk_column = $table_obj->get_fully_qualified_pk_column();
-                    //if there is no private key for this table on the results, it means there's no entry
-                    //in this table, right? so insert a row in the current table, using any fields available
-                    if ( ! (array_key_exists($this_table_pk_column, $wpdb_result)
-                            && $wpdb_result[$this_table_pk_column])
-                    ) {
-                        $success = $this->_insert_into_specific_table($table_obj, $fields_n_values,
-                            $main_table_pk_value);
-                        //if we died here, report the error
-                        if ( ! $success) {
-                            return false;
-                        }
-                    }
-                }
-            }
-            //				//and now check that if we have cached any models by that ID on the model, that
-            //				//they also get updated properly
-            //				$model_object = $this->get_from_entity_map( $main_table_pk_value );
-            //				if( $model_object ){
-            //					foreach( $fields_n_values as $field => $value ){
-            //						$model_object->set($field, $value);
-            //let's make sure default_where strategy is followed now
-            $this->_ignore_where_strategy = false;
-        }
-        //if we want to keep model objects in sync, AND
-        //if this wasn't called from a model object (to update itself)
-        //then we want to make sure we keep all the existing
-        //model objects in sync with the db
-        if ($keep_model_objs_in_sync && ! $this->_values_already_prepared_by_model_object) {
-            if ($this->has_primary_key_field()) {
-                $model_objs_affected_ids = $this->get_col($query_params);
-            } else {
-                //we need to select a bunch of columns and then combine them into the the "index primary key string"s
-                $models_affected_key_columns = $this->_get_all_wpdb_results($query_params, ARRAY_A);
-                $model_objs_affected_ids = array();
-                foreach ($models_affected_key_columns as $row) {
-                    $combined_index_key = $this->get_index_primary_key_string($row);
-                    $model_objs_affected_ids[$combined_index_key] = $combined_index_key;
-                }
-            }
-            if ( ! $model_objs_affected_ids) {
-                //wait wait wait- if nothing was affected let's stop here
-                return 0;
-            }
-            foreach ($model_objs_affected_ids as $id) {
-                $model_obj_in_entity_map = $this->get_from_entity_map($id);
-                if ($model_obj_in_entity_map) {
-                    foreach ($fields_n_values as $field => $new_value) {
-                        $model_obj_in_entity_map->set($field, $new_value);
-                    }
-                }
-            }
-            //if there is a primary key on this model, we can now do a slight optimization
-            if ($this->has_primary_key_field()) {
-                //we already know what we want to update. So let's make the query simpler so it's a little more efficient
-                $query_params = array(
-                    array($this->primary_key_name() => array('IN', $model_objs_affected_ids)),
-                    'limit'                    => count($model_objs_affected_ids),
-                    'default_where_conditions' => 'none',
-                );
-            }
-        }
-        $model_query_info = $this->_create_model_query_info_carrier($query_params);
-        $SQL = "UPDATE "
-               . $model_query_info->get_full_join_sql()
-               . " SET "
-               . $this->_construct_update_sql($fields_n_values)
-               . $model_query_info->get_where_sql();//note: doesn't use _construct_2nd_half_of_select_query() because doesn't accept LIMIT, ORDER BY, etc.
-        $rows_affected = $this->_do_wpdb_query('query', array($SQL));
-        /**
-         * Action called after a model update call has been made.
-         *
-         * @param EEM_Base $model
-         * @param array    $fields_n_values the updated fields and their new values
-         * @param array    $query_params    @see EEM_Base::get_all()
-         * @param int      $rows_affected
-         */
-        do_action('AHEE__EEM_Base__update__end', $this, $fields_n_values, $query_params, $rows_affected);
-        return $rows_affected;//how many supposedly got updated
-    }
-
-
-
-    /**
-     * Analogous to $wpdb->get_col, returns a 1-dimensional array where teh values
-     * are teh values of the field specified (or by default the primary key field)
-     * that matched the query params. Note that you should pass the name of the
-     * model FIELD, not the database table's column name.
-     *
-     * @param array  $query_params @see EEM_Base::get_all()
-     * @param string $field_to_select
-     * @return array just like $wpdb->get_col()
-     * @throws \EE_Error
-     */
-    public function get_col($query_params = array(), $field_to_select = null)
-    {
-        if ($field_to_select) {
-            $field = $this->field_settings_for($field_to_select);
-        } elseif ($this->has_primary_key_field()) {
-            $field = $this->get_primary_key_field();
-        } else {
-            //no primary key, just grab the first column
-            $field = reset($this->field_settings());
-        }
-        $model_query_info = $this->_create_model_query_info_carrier($query_params);
-        $select_expressions = $field->get_qualified_column();
-        $SQL = "SELECT $select_expressions " . $this->_construct_2nd_half_of_select_query($model_query_info);
-        return $this->_do_wpdb_query('get_col', array($SQL));
-    }
-
-
-
-    /**
-     * Returns a single column value for a single row from the database
-     *
-     * @param array  $query_params    @see EEM_Base::get_all()
-     * @param string $field_to_select @see EEM_Base::get_col()
-     * @return string
-     * @throws \EE_Error
-     */
-    public function get_var($query_params = array(), $field_to_select = null)
-    {
-        $query_params['limit'] = 1;
-        $col = $this->get_col($query_params, $field_to_select);
-        if ( ! empty($col)) {
-            return reset($col);
-        } else {
-            return null;
-        }
-    }
-
-
-
-    /**
-     * Makes the SQL for after "UPDATE table_X inner join table_Y..." and before "...WHERE". Eg "Question.name='party
-     * time?', Question.desc='what do you think?',..." Values are filtered through wpdb->prepare to avoid against SQL
-     * injection, but currently no further filtering is done
-     *
-     * @global      $wpdb
-     * @param array $fields_n_values array keys are field names on this model, and values are what those fields should
-     *                               be updated to in the DB
-     * @return string of SQL
-     * @throws \EE_Error
-     */
-    public function _construct_update_sql($fields_n_values)
-    {
-        /** @type WPDB $wpdb */
-        global $wpdb;
-        $cols_n_values = array();
-        foreach ($fields_n_values as $field_name => $value) {
-            $field_obj = $this->field_settings_for($field_name);
-            //if the value is NULL, we want to assign the value to that.
-            //wpdb->prepare doesn't really handle that properly
-            $prepared_value = $this->_prepare_value_or_use_default($field_obj, $fields_n_values);
-            $value_sql = $prepared_value === null ? 'NULL'
-                : $wpdb->prepare($field_obj->get_wpdb_data_type(), $prepared_value);
-            $cols_n_values[] = $field_obj->get_qualified_column() . "=" . $value_sql;
-        }
-        return implode(",", $cols_n_values);
-    }
-
-
-
-    /**
-     * Deletes a single row from the DB given the model object's primary key value. (eg, EE_Attendee->ID()'s value).
-     * Performs a HARD delete, meaning the database row should always be removed,
-     * not just have a flag field on it switched
-     * Wrapper for EEM_Base::delete_permanently()
-     *
-     * @param mixed $id
-     * @return boolean whether the row got deleted or not
-     * @throws \EE_Error
-     */
-    public function delete_permanently_by_ID($id)
-    {
-        return $this->delete_permanently(
-            array(
-                array($this->get_primary_key_field()->get_name() => $id),
-                'limit' => 1,
-            )
-        );
-    }
-
-
-
-    /**
-     * Deletes a single row from the DB given the model object's primary key value. (eg, EE_Attendee->ID()'s value).
-     * Wrapper for EEM_Base::delete()
-     *
-     * @param mixed $id
-     * @return boolean whether the row got deleted or not
-     * @throws \EE_Error
-     */
-    public function delete_by_ID($id)
-    {
-        return $this->delete(
-            array(
-                array($this->get_primary_key_field()->get_name() => $id),
-                'limit' => 1,
-            )
-        );
-    }
-
-
-
-    /**
-     * Identical to delete_permanently, but does a "soft" delete if possible,
-     * meaning if the model has a field that indicates its been "trashed" or
-     * "soft deleted", we will just set that instead of actually deleting the rows.
-     *
-     * @see EEM_Base::delete_permanently
-     * @param array   $query_params
-     * @param boolean $allow_blocking
-     * @return int how many rows got deleted
-     * @throws \EE_Error
-     */
-    public function delete($query_params, $allow_blocking = true)
-    {
-        return $this->delete_permanently($query_params, $allow_blocking);
-    }
-
-
-
-    /**
-     * Deletes the model objects that meet the query params. Note: this method is overridden
-     * in EEM_Soft_Delete_Base so that soft-deleted model objects are instead only flagged
-     * as archived, not actually deleted
-     *
-     * @param array   $query_params   very much like EEM_Base::get_all's $query_params
-     * @param boolean $allow_blocking if TRUE, matched objects will only be deleted if there is no related model info
-     *                                that blocks it (ie, there' sno other data that depends on this data); if false,
-     *                                deletes regardless of other objects which may depend on it. Its generally
-     *                                advisable to always leave this as TRUE, otherwise you could easily corrupt your
-     *                                DB
-     * @return int how many rows got deleted
-     * @throws \EE_Error
-     */
-    public function delete_permanently($query_params, $allow_blocking = true)
-    {
-        /**
-         * Action called just before performing a real deletion query. You can use the
-         * model and its $query_params to find exactly which items will be deleted
-         *
-         * @param EEM_Base $model
-         * @param array    $query_params   @see EEM_Base::get_all()
-         * @param boolean  $allow_blocking whether or not to allow related model objects
-         *                                 to block (prevent) this deletion
-         */
-        do_action('AHEE__EEM_Base__delete__begin', $this, $query_params, $allow_blocking);
-        //some MySQL databases may be running safe mode, which may restrict
-        //deletion if there is no KEY column used in the WHERE statement of a deletion.
-        //to get around this, we first do a SELECT, get all the IDs, and then run another query
-        //to delete them
-        $items_for_deletion = $this->_get_all_wpdb_results($query_params);
-        $deletion_where = $this->_setup_ids_for_delete($items_for_deletion, $allow_blocking);
-        if ($deletion_where) {
-            //echo "objects for deletion:";var_dump($objects_for_deletion);
-            $model_query_info = $this->_create_model_query_info_carrier($query_params);
-            $table_aliases = array_keys($this->_tables);
-            $SQL = "DELETE "
-                   . implode(", ", $table_aliases)
-                   . " FROM "
-                   . $model_query_info->get_full_join_sql()
-                   . " WHERE "
-                   . $deletion_where;
-            //		/echo "delete sql:$SQL";
-            $rows_deleted = $this->_do_wpdb_query('query', array($SQL));
-        } else {
-            $rows_deleted = 0;
-        }
-        //and lastly make sure those items are removed from the entity map; if they could be put into it at all
-        if ($this->has_primary_key_field()) {
-            foreach ($items_for_deletion as $item_for_deletion_row) {
-                $pk_value = $item_for_deletion_row[$this->get_primary_key_field()->get_qualified_column()];
-                if (isset($this->_entity_map[EEM_Base::$_model_query_blog_id][$pk_value])) {
-                    unset($this->_entity_map[EEM_Base::$_model_query_blog_id][$pk_value]);
-                }
-            }
-        }
-        /**
-         * Action called just after performing a real deletion query. Although at this point the
-         * items should have been deleted
-         *
-         * @param EEM_Base $model
-         * @param array    $query_params @see EEM_Base::get_all()
-         * @param int      $rows_deleted
-         */
-        do_action('AHEE__EEM_Base__delete__end', $this, $query_params, $rows_deleted);
-        return $rows_deleted;//how many supposedly got deleted
-    }
-
-
-
-    /**
-     * Checks all the relations that throw error messages when there are blocking related objects
-     * for related model objects. If there are any related model objects on those relations,
-     * adds an EE_Error, and return true
-     *
-     * @param EE_Base_Class|int $this_model_obj_or_id
-     * @param EE_Base_Class     $ignore_this_model_obj a model object like 'EE_Event', or 'EE_Term_Taxonomy', which
-     *                                                 should be ignored when determining whether there are related
-     *                                                 model objects which block this model object's deletion. Useful
-     *                                                 if you know A is related to B and are considering deleting A,
-     *                                                 but want to see if A has any other objects blocking its deletion
-     *                                                 before removing the relation between A and B
-     * @return boolean
-     * @throws \EE_Error
-     */
-    public function delete_is_blocked_by_related_models($this_model_obj_or_id, $ignore_this_model_obj = null)
-    {
-        //first, if $ignore_this_model_obj was supplied, get its model
-        if ($ignore_this_model_obj && $ignore_this_model_obj instanceof EE_Base_Class) {
-            $ignored_model = $ignore_this_model_obj->get_model();
-        } else {
-            $ignored_model = null;
-        }
-        //now check all the relations of $this_model_obj_or_id and see if there
-        //are any related model objects blocking it?
-        $is_blocked = false;
-        foreach ($this->_model_relations as $relation_name => $relation_obj) {
-            if ($relation_obj->block_delete_if_related_models_exist()) {
-                //if $ignore_this_model_obj was supplied, then for the query
-                //on that model needs to be told to ignore $ignore_this_model_obj
-                if ($ignored_model && $relation_name === $ignored_model->get_this_model_name()) {
-                    $related_model_objects = $relation_obj->get_all_related($this_model_obj_or_id, array(
-                        array(
-                            $ignored_model->get_primary_key_field()->get_name() => array(
-                                '!=',
-                                $ignore_this_model_obj->ID(),
-                            ),
-                        ),
-                    ));
-                } else {
-                    $related_model_objects = $relation_obj->get_all_related($this_model_obj_or_id);
-                }
-                if ($related_model_objects) {
-                    EE_Error::add_error($relation_obj->get_deletion_error_message(), __FILE__, __FUNCTION__, __LINE__);
-                    $is_blocked = true;
-                }
-            }
-        }
-        return $is_blocked;
-    }
-
-
-
-    /**
-     * This sets up our delete where sql and accounts for if we have secondary tables that will have rows deleted as
-     * well.
-     *
-     * @param  array  $objects_for_deletion This should be the values returned by $this->_get_all_wpdb_results()
-     * @param boolean $allow_blocking       if TRUE, matched objects will only be deleted if there is no related model
-     *                                      info that blocks it (ie, there' sno other data that depends on this data);
-     *                                      if false, deletes regardless of other objects which may depend on it. Its
-     *                                      generally advisable to always leave this as TRUE, otherwise you could
-     *                                      easily corrupt your DB
-     * @throws EE_Error
-     * @return string    everything that comes after the WHERE statement.
-     */
-    protected function _setup_ids_for_delete($objects_for_deletion, $allow_blocking = true)
-    {
-        if ($this->has_primary_key_field()) {
-            $primary_table = $this->_get_main_table();
-            $other_tables = $this->_get_other_tables();
-            $deletes = $query = array();
-            foreach ($objects_for_deletion as $delete_object) {
-                //before we mark this object for deletion,
-                //make sure there's no related objects blocking its deletion (if we're checking)
-                if (
-                    $allow_blocking
-                    && $this->delete_is_blocked_by_related_models(
-                        $delete_object[$primary_table->get_fully_qualified_pk_column()]
-                    )
-                ) {
-                    continue;
-                }
-                //primary table deletes
-                if (isset($delete_object[$primary_table->get_fully_qualified_pk_column()])) {
-                    $deletes[$primary_table->get_fully_qualified_pk_column()][] = $delete_object[$primary_table->get_fully_qualified_pk_column()];
-                }
-                //other tables
-                if ( ! empty($other_tables)) {
-                    foreach ($other_tables as $ot) {
-                        //first check if we've got the foreign key column here.
-                        if (isset($delete_object[$ot->get_fully_qualified_fk_column()])) {
-                            $deletes[$ot->get_fully_qualified_pk_column()][] = $delete_object[$ot->get_fully_qualified_fk_column()];
-                        }
-                        // wait! it's entirely possible that we'll have a the primary key
-                        // for this table in here, if it's a foreign key for one of the other secondary tables
-                        if (isset($delete_object[$ot->get_fully_qualified_pk_column()])) {
-                            $deletes[$ot->get_fully_qualified_pk_column()][] = $delete_object[$ot->get_fully_qualified_pk_column()];
-                        }
-                        // finally, it is possible that the fk for this table is found
-                        // in the fully qualified pk column for the fk table, so let's see if that's there!
-                        if (isset($delete_object[$ot->get_fully_qualified_pk_on_fk_table()])) {
-                            $deletes[$ot->get_fully_qualified_pk_column()][] = $delete_object[$ot->get_fully_qualified_pk_column()];
-                        }
-                    }
-                }
-            }
-            //we should have deletes now, so let's just go through and setup the where statement
-            foreach ($deletes as $column => $values) {
-                //make sure we have unique $values;
-                $values = array_unique($values);
-                $query[] = $column . ' IN(' . implode(",", $values) . ')';
-            }
-            return ! empty($query) ? implode(' AND ', $query) : '';
-        } elseif (count($this->get_combined_primary_key_fields()) > 1) {
-            $ways_to_identify_a_row = array();
-            $fields = $this->get_combined_primary_key_fields();
-            //note: because there' sno primary key, that means nothing else  can be pointing to this model, right?
-            foreach ($objects_for_deletion as $delete_object) {
-                $values_for_each_cpk_for_a_row = array();
-                foreach ($fields as $cpk_field) {
-                    if ($cpk_field instanceof EE_Model_Field_Base) {
-                        $values_for_each_cpk_for_a_row[] = $cpk_field->get_qualified_column()
-                                                           . "="
-                                                           . $delete_object[$cpk_field->get_qualified_column()];
-                    }
-                }
-                $ways_to_identify_a_row[] = "(" . implode(" AND ", $values_for_each_cpk_for_a_row) . ")";
-            }
-            return implode(" OR ", $ways_to_identify_a_row);
-        } else {
-            //so there's no primary key and no combined key...
-            //sorry, can't help you
-            throw new EE_Error(sprintf(__("Cannot delete objects of type %s because there is no primary key NOR combined key",
-                "event_espresso"), get_class($this)));
-        }
-    }
-
-
-
-    /**
-     * Count all the rows that match criteria expressed in $query_params (an array just like arg to EEM_Base::get_all).
-     * If $field_to_count isn't provided, the model's primary key is used. Otherwise, we count by field_to_count's
-     * column
-     *
-     * @param array  $query_params   like EEM_Base::get_all's
-     * @param string $field_to_count field on model to count by (not column name)
-     * @param bool   $distinct       if we want to only count the distinct values for the column then you can trigger
-     *                               that by the setting $distinct to TRUE;
-     * @return int
-     * @throws \EE_Error
-     */
-    public function count($query_params = array(), $field_to_count = null, $distinct = false)
-    {
-        $model_query_info = $this->_create_model_query_info_carrier($query_params);
-        if ($field_to_count) {
-            $field_obj = $this->field_settings_for($field_to_count);
-            $column_to_count = $field_obj->get_qualified_column();
-        } elseif ($this->has_primary_key_field()) {
-            $pk_field_obj = $this->get_primary_key_field();
-            $column_to_count = $pk_field_obj->get_qualified_column();
-        } else {
-            //there's no primary key
-            //if we're counting distinct items, and there's no primary key,
-            //we need to list out the columns for distinction;
-            //otherwise we can just use star
-            if ($distinct) {
-                $columns_to_use = array();
-                foreach ($this->get_combined_primary_key_fields() as $field_obj) {
-                    $columns_to_use[] = $field_obj->get_qualified_column();
-                }
-                $column_to_count = implode(',', $columns_to_use);
-            } else {
-                $column_to_count = '*';
-            }
-        }
-        $column_to_count = $distinct ? "DISTINCT " . $column_to_count : $column_to_count;
-        $SQL = "SELECT COUNT(" . $column_to_count . ")" . $this->_construct_2nd_half_of_select_query($model_query_info);
-        return (int)$this->_do_wpdb_query('get_var', array($SQL));
-    }
-
-
-
-    /**
-     * Sums up the value of the $field_to_sum (defaults to the primary key, which isn't terribly useful)
-     *
-     * @param array  $query_params like EEM_Base::get_all
-     * @param string $field_to_sum name of field (array key in $_fields array)
-     * @return float
-     * @throws \EE_Error
-     */
-    public function sum($query_params, $field_to_sum = null)
-    {
-        $model_query_info = $this->_create_model_query_info_carrier($query_params);
-        if ($field_to_sum) {
-            $field_obj = $this->field_settings_for($field_to_sum);
-        } else {
-            $field_obj = $this->get_primary_key_field();
-        }
-        $column_to_count = $field_obj->get_qualified_column();
-        $SQL = "SELECT SUM(" . $column_to_count . ")" . $this->_construct_2nd_half_of_select_query($model_query_info);
-        $return_value = $this->_do_wpdb_query('get_var', array($SQL));
-        $data_type = $field_obj->get_wpdb_data_type();
-        if ($data_type === '%d' || $data_type === '%s') {
-            return (float)$return_value;
-        } else {//must be %f
-            return (float)$return_value;
-        }
-    }
-
-
-
-    /**
-     * Just calls the specified method on $wpdb with the given arguments
-     * Consolidates a little extra error handling code
-     *
-     * @param string $wpdb_method
-     * @param array  $arguments_to_provide
-     * @throws EE_Error
-     * @global wpdb  $wpdb
-     * @return mixed
-     */
-    protected function _do_wpdb_query($wpdb_method, $arguments_to_provide)
-    {
-        //if we're in maintenance mode level 2, DON'T run any queries
-        //because level 2 indicates the database needs updating and
-        //is probably out of sync with the code
-        if ( ! EE_Maintenance_Mode::instance()->models_can_query()) {
-            throw new EE_Error(sprintf(__("Event Espresso Level 2 Maintenance mode is active. That means EE can not run ANY database queries until the necessary migration scripts have run which will take EE out of maintenance mode level 2. Please inform support of this error.",
-                "event_espresso")));
-        }
-        /** @type WPDB $wpdb */
-        global $wpdb;
-        if ( ! method_exists($wpdb, $wpdb_method)) {
-            throw new EE_Error(sprintf(__('There is no method named "%s" on Wordpress\' $wpdb object',
-                'event_espresso'), $wpdb_method));
-        }
-        if (WP_DEBUG) {
-            $old_show_errors_value = $wpdb->show_errors;
-            $wpdb->show_errors(false);
-        }
-        $result = $this->_process_wpdb_query($wpdb_method, $arguments_to_provide);
-        $this->show_db_query_if_previously_requested($wpdb->last_query);
-        if (WP_DEBUG) {
-            $wpdb->show_errors($old_show_errors_value);
-            if ( ! empty($wpdb->last_error)) {
-                throw new EE_Error(sprintf(__('WPDB Error: "%s"', 'event_espresso'), $wpdb->last_error));
-            } elseif ($result === false) {
-                throw new EE_Error(sprintf(__('WPDB Error occurred, but no error message was logged by wpdb! The wpdb method called was "%1$s" and the arguments were "%2$s"',
-                    'event_espresso'), $wpdb_method, var_export($arguments_to_provide, true)));
-            }
-        } elseif ($result === false) {
-            EE_Error::add_error(
-                sprintf(
-                    __('A database error has occurred. Turn on WP_DEBUG for more information.||A database error occurred doing wpdb method "%1$s", with arguments "%2$s". The error was "%3$s"',
-                        'event_espresso'),
-                    $wpdb_method,
-                    var_export($arguments_to_provide, true),
-                    $wpdb->last_error
-                ),
-                __FILE__,
-                __FUNCTION__,
-                __LINE__
-            );
-        }
-        return $result;
-    }
-
-
-
-    /**
-     * Attempts to run the indicated WPDB method with the provided arguments,
-     * and if there's an error tries to verify the DB is correct. Uses
-     * the static property EEM_Base::$_db_verification_level to determine whether
-     * we should try to fix the EE core db, the addons, or just give up
-     *
-     * @param string $wpdb_method
-     * @param array  $arguments_to_provide
-     * @return mixed
-     */
-    private function _process_wpdb_query($wpdb_method, $arguments_to_provide)
-    {
-        /** @type WPDB $wpdb */
-        global $wpdb;
-        $wpdb->last_error = null;
-        $result = call_user_func_array(array($wpdb, $wpdb_method), $arguments_to_provide);
-        // was there an error running the query? but we don't care on new activations
-        // (we're going to setup the DB anyway on new activations)
-        if (($result === false || ! empty($wpdb->last_error))
-            && EE_System::instance()->detect_req_type() !== EE_System::req_type_new_activation
-        ) {
-            switch (EEM_Base::$_db_verification_level) {
-                case EEM_Base::db_verified_none :
-                    // let's double-check core's DB
-                    $error_message = $this->_verify_core_db($wpdb_method, $arguments_to_provide);
-                    break;
-                case EEM_Base::db_verified_core :
-                    // STILL NO LOVE?? verify all the addons too. Maybe they need to be fixed
-                    $error_message = $this->_verify_addons_db($wpdb_method, $arguments_to_provide);
-                    break;
-                case EEM_Base::db_verified_addons :
-                    // ummmm... you in trouble
-                    return $result;
-                    break;
-            }
-            if ( ! empty($error_message)) {
-                EE_Log::instance()->log(__FILE__, __FUNCTION__, $error_message, 'error');
-                trigger_error($error_message);
-            }
-            return $this->_process_wpdb_query($wpdb_method, $arguments_to_provide);
-        }
-        return $result;
-    }
-
-
-
-    /**
-     * Verifies the EE core database is up-to-date and records that we've done it on
-     * EEM_Base::$_db_verification_level
-     *
-     * @param string $wpdb_method
-     * @param array  $arguments_to_provide
-     * @return string
-     */
-    private function _verify_core_db($wpdb_method, $arguments_to_provide)
-    {
-        /** @type WPDB $wpdb */
-        global $wpdb;
-        //ok remember that we've already attempted fixing the core db, in case the problem persists
-        EEM_Base::$_db_verification_level = EEM_Base::db_verified_core;
-        $error_message = sprintf(
-            __('WPDB Error "%1$s" while running wpdb method "%2$s" with arguments %3$s. Automatically attempting to fix EE Core DB',
-                'event_espresso'),
-            $wpdb->last_error,
-            $wpdb_method,
-            json_encode($arguments_to_provide)
-        );
-        EE_System::instance()->initialize_db_if_no_migrations_required(false, true);
-        return $error_message;
-    }
-
-
-
-    /**
-     * Verifies the EE addons' database is up-to-date and records that we've done it on
-     * EEM_Base::$_db_verification_level
-     *
-     * @param $wpdb_method
-     * @param $arguments_to_provide
-     * @return string
-     */
-    private function _verify_addons_db($wpdb_method, $arguments_to_provide)
-    {
-        /** @type WPDB $wpdb */
-        global $wpdb;
-        //ok remember that we've already attempted fixing the addons dbs, in case the problem persists
-        EEM_Base::$_db_verification_level = EEM_Base::db_verified_addons;
-        $error_message = sprintf(
-            __('WPDB AGAIN: Error "%1$s" while running the same method and arguments as before. Automatically attempting to fix EE Addons DB',
-                'event_espresso'),
-            $wpdb->last_error,
-            $wpdb_method,
-            json_encode($arguments_to_provide)
-        );
-        EE_System::instance()->initialize_addons();
-        return $error_message;
-    }
-
-
-
-    /**
-     * In order to avoid repeating this code for the get_all, sum, and count functions, put the code parts
-     * that are identical in here. Returns a string of SQL of everything in a SELECT query except the beginning
-     * SELECT clause, eg " FROM wp_posts AS Event INNER JOIN ... WHERE ... ORDER BY ... LIMIT ... GROUP BY ... HAVING
-     * ..."
-     *
-     * @param EE_Model_Query_Info_Carrier $model_query_info
-     * @return string
-     */
-    private function _construct_2nd_half_of_select_query(EE_Model_Query_Info_Carrier $model_query_info)
-    {
-        return " FROM " . $model_query_info->get_full_join_sql() .
-               $model_query_info->get_where_sql() .
-               $model_query_info->get_group_by_sql() .
-               $model_query_info->get_having_sql() .
-               $model_query_info->get_order_by_sql() .
-               $model_query_info->get_limit_sql();
-    }
-
-
-
-    /**
-     * Set to easily debug the next X queries ran from this model.
-     *
-     * @param int $count
-     */
-    public function show_next_x_db_queries($count = 1)
-    {
-        $this->_show_next_x_db_queries = $count;
-    }
-
-
-
-    /**
-     * @param $sql_query
-     */
-    public function show_db_query_if_previously_requested($sql_query)
-    {
-        if ($this->_show_next_x_db_queries > 0) {
-            echo $sql_query;
-            $this->_show_next_x_db_queries--;
-        }
-    }
-
-
-
-    /**
-     * Adds a relationship of the correct type between $modelObject and $otherModelObject.
-     * There are the 3 cases:
-     * 'belongsTo' relationship: sets $id_or_obj's foreign_key to be $other_model_id_or_obj's primary_key. If
-     * $otherModelObject has no ID, it is first saved.
-     * 'hasMany' relationship: sets $other_model_id_or_obj's foreign_key to be $id_or_obj's primary_key. If $id_or_obj
-     * has no ID, it is first saved.
-     * 'hasAndBelongsToMany' relationships: checks that there isn't already an entry in the join table, and adds one.
-     * If one of the model Objects has not yet been saved to the database, it is saved before adding the entry in the
-     * join table
-     *
-     * @param        EE_Base_Class                     /int $thisModelObject
-     * @param        EE_Base_Class                     /int $id_or_obj EE_base_Class or ID of other Model Object
-     * @param string $relationName                     , key in EEM_Base::_relations
-     *                                                 an attendee to a group, you also want to specify which role they
-     *                                                 will have in that group. So you would use this parameter to
-     *                                                 specify array('role-column-name'=>'role-id')
-     * @param array  $extra_join_model_fields_n_values This allows you to enter further query params for the relation
-     *                                                 to for relation to methods that allow you to further specify
-     *                                                 extra columns to join by (such as HABTM).  Keep in mind that the
-     *                                                 only acceptable query_params is strict "col" => "value" pairs
-     *                                                 because these will be inserted in any new rows created as well.
-     * @return EE_Base_Class which was added as a relation. Object referred to by $other_model_id_or_obj
-     * @throws \EE_Error
-     */
-    public function add_relationship_to(
-        $id_or_obj,
-        $other_model_id_or_obj,
-        $relationName,
-        $extra_join_model_fields_n_values = array()
-    ) {
-        $relation_obj = $this->related_settings_for($relationName);
-        return $relation_obj->add_relation_to($id_or_obj, $other_model_id_or_obj, $extra_join_model_fields_n_values);
-    }
-
-
-
-    /**
-     * Removes a relationship of the correct type between $modelObject and $otherModelObject.
-     * There are the 3 cases:
-     * 'belongsTo' relationship: sets $modelObject's foreign_key to null, if that field is nullable.Otherwise throws an
-     * error
-     * 'hasMany' relationship: sets $otherModelObject's foreign_key to null,if that field is nullable.Otherwise throws
-     * an error
-     * 'hasAndBelongsToMany' relationships:removes any existing entry in the join table between the two models.
-     *
-     * @param        EE_Base_Class /int $id_or_obj
-     * @param        EE_Base_Class /int $other_model_id_or_obj EE_Base_Class or ID of other Model Object
-     * @param string $relationName key in EEM_Base::_relations
-     * @return boolean of success
-     * @throws \EE_Error
-     * @param array  $where_query  This allows you to enter further query params for the relation to for relation to
-     *                             methods that allow you to further specify extra columns to join by (such as HABTM).
-     *                             Keep in mind that the only acceptable query_params is strict "col" => "value" pairs
-     *                             because these will be inserted in any new rows created as well.
-     */
-    public function remove_relationship_to($id_or_obj, $other_model_id_or_obj, $relationName, $where_query = array())
-    {
-        $relation_obj = $this->related_settings_for($relationName);
-        return $relation_obj->remove_relation_to($id_or_obj, $other_model_id_or_obj, $where_query);
-    }
-
-
-
-    /**
-     * @param mixed           $id_or_obj
-     * @param string          $relationName
-     * @param array           $where_query_params
-     * @param EE_Base_Class[] objects to which relations were removed
-     * @return \EE_Base_Class[]
-     * @throws \EE_Error
-     */
-    public function remove_relations($id_or_obj, $relationName, $where_query_params = array())
-    {
-        $relation_obj = $this->related_settings_for($relationName);
-        return $relation_obj->remove_relations($id_or_obj, $where_query_params);
-    }
-
-
-
-    /**
-     * Gets all the related items of the specified $model_name, using $query_params.
-     * Note: by default, we remove the "default query params"
-     * because we want to get even deleted items etc.
-     *
-     * @param mixed  $id_or_obj    EE_Base_Class child or its ID
-     * @param string $model_name   like 'Event', 'Registration', etc. always singular
-     * @param array  $query_params like EEM_Base::get_all
-     * @return EE_Base_Class[]
-     * @throws \EE_Error
-     */
-    public function get_all_related($id_or_obj, $model_name, $query_params = null)
-    {
-        $model_obj = $this->ensure_is_obj($id_or_obj);
-        $relation_settings = $this->related_settings_for($model_name);
-        return $relation_settings->get_all_related($model_obj, $query_params);
-    }
-
-
-
-    /**
-     * Deletes all the model objects across the relation indicated by $model_name
-     * which are related to $id_or_obj which meet the criteria set in $query_params.
-     * However, if the model objects can't be deleted because of blocking related model objects, then
-     * they aren't deleted. (Unless the thing that would have been deleted can be soft-deleted, that still happens).
-     *
-     * @param EE_Base_Class|int|string $id_or_obj
-     * @param string                   $model_name
-     * @param array                    $query_params
-     * @return int how many deleted
-     * @throws \EE_Error
-     */
-    public function delete_related($id_or_obj, $model_name, $query_params = array())
-    {
-        $model_obj = $this->ensure_is_obj($id_or_obj);
-        $relation_settings = $this->related_settings_for($model_name);
-        return $relation_settings->delete_all_related($model_obj, $query_params);
-    }
-
-
-
-    /**
-     * Hard deletes all the model objects across the relation indicated by $model_name
-     * which are related to $id_or_obj which meet the criteria set in $query_params. If
-     * the model objects can't be hard deleted because of blocking related model objects,
-     * just does a soft-delete on them instead.
-     *
-     * @param EE_Base_Class|int|string $id_or_obj
-     * @param string                   $model_name
-     * @param array                    $query_params
-     * @return int how many deleted
-     * @throws \EE_Error
-     */
-    public function delete_related_permanently($id_or_obj, $model_name, $query_params = array())
-    {
-        $model_obj = $this->ensure_is_obj($id_or_obj);
-        $relation_settings = $this->related_settings_for($model_name);
-        return $relation_settings->delete_related_permanently($model_obj, $query_params);
-    }
-
-
-
-    /**
-     * Instead of getting the related model objects, simply counts them. Ignores default_where_conditions by default,
-     * unless otherwise specified in the $query_params
-     *
-     * @param        int             /EE_Base_Class $id_or_obj
-     * @param string $model_name     like 'Event', or 'Registration'
-     * @param array  $query_params   like EEM_Base::get_all's
-     * @param string $field_to_count name of field to count by. By default, uses primary key
-     * @param bool   $distinct       if we want to only count the distinct values for the column then you can trigger
-     *                               that by the setting $distinct to TRUE;
-     * @return int
-     * @throws \EE_Error
-     */
-    public function count_related(
-        $id_or_obj,
-        $model_name,
-        $query_params = array(),
-        $field_to_count = null,
-        $distinct = false
-    ) {
-        $related_model = $this->get_related_model_obj($model_name);
-        //we're just going to use the query params on the related model's normal get_all query,
-        //except add a condition to say to match the current mod
-        if ( ! isset($query_params['default_where_conditions'])) {
-            $query_params['default_where_conditions'] = 'none';
-        }
-        $this_model_name = $this->get_this_model_name();
-        $this_pk_field_name = $this->get_primary_key_field()->get_name();
-        $query_params[0][$this_model_name . "." . $this_pk_field_name] = $id_or_obj;
-        return $related_model->count($query_params, $field_to_count, $distinct);
-    }
-
-
-
-    /**
-     * Instead of getting the related model objects, simply sums up the values of the specified field.
-     * Note: ignores default_where_conditions by default, unless otherwise specified in the $query_params
-     *
-     * @param        int           /EE_Base_Class $id_or_obj
-     * @param string $model_name   like 'Event', or 'Registration'
-     * @param array  $query_params like EEM_Base::get_all's
-     * @param string $field_to_sum name of field to count by. By default, uses primary key
-     * @return float
-     * @throws \EE_Error
-     */
-    public function sum_related($id_or_obj, $model_name, $query_params, $field_to_sum = null)
-    {
-        $related_model = $this->get_related_model_obj($model_name);
-        if ( ! is_array($query_params)) {
-            EE_Error::doing_it_wrong('EEM_Base::sum_related',
-                sprintf(__('$query_params should be an array, you passed a variable of type %s', 'event_espresso'),
-                    gettype($query_params)), '4.6.0');
-            $query_params = array();
-        }
-        //we're just going to use the query params on the related model's normal get_all query,
-        //except add a condition to say to match the current mod
-        if ( ! isset($query_params['default_where_conditions'])) {
-            $query_params['default_where_conditions'] = 'none';
-        }
-        $this_model_name = $this->get_this_model_name();
-        $this_pk_field_name = $this->get_primary_key_field()->get_name();
-        $query_params[0][$this_model_name . "." . $this_pk_field_name] = $id_or_obj;
-        return $related_model->sum($query_params, $field_to_sum);
-    }
-
-
-
-    /**
-     * Uses $this->_relatedModels info to find the first related model object of relation $relationName to the given
-     * $modelObject
-     *
-     * @param int | EE_Base_Class $id_or_obj        EE_Base_Class child or its ID
-     * @param string              $other_model_name , key in $this->_relatedModels, eg 'Registration', or 'Events'
-     * @param array               $query_params     like EEM_Base::get_all's
-     * @return EE_Base_Class
-     * @throws \EE_Error
-     */
-    public function get_first_related(EE_Base_Class $id_or_obj, $other_model_name, $query_params)
-    {
-        $query_params['limit'] = 1;
-        $results = $this->get_all_related($id_or_obj, $other_model_name, $query_params);
-        if ($results) {
-            return array_shift($results);
-        } else {
-            return null;
-        }
-    }
-
-
-
-    /**
-     * Gets the model's name as it's expected in queries. For example, if this is EEM_Event model, that would be Event
-     *
-     * @return string
-     */
-    public function get_this_model_name()
-    {
-        return str_replace("EEM_", "", get_class($this));
-    }
-
-
-
-    /**
-     * Gets the model field on this model which is of type EE_Any_Foreign_Model_Name_Field
-     *
-     * @return EE_Any_Foreign_Model_Name_Field
-     * @throws EE_Error
-     */
-    public function get_field_containing_related_model_name()
-    {
-        foreach ($this->field_settings(true) as $field) {
-            if ($field instanceof EE_Any_Foreign_Model_Name_Field) {
-                $field_with_model_name = $field;
-            }
-        }
-        if ( ! isset($field_with_model_name) || ! $field_with_model_name) {
-            throw new EE_Error(sprintf(__("There is no EE_Any_Foreign_Model_Name field on model %s", "event_espresso"),
-                $this->get_this_model_name()));
-        }
-        return $field_with_model_name;
-    }
-
-
-
-    /**
-     * Inserts a new entry into the database, for each table.
-     * Note: does not add the item to the entity map because that is done by EE_Base_Class::save() right after this.
-     * If client code uses EEM_Base::insert() directly, then although the item isn't in the entity map,
-     * we also know there is no model object with the newly inserted item's ID at the moment (because
-     * if there were, then they would already be in the DB and this would fail); and in the future if someone
-     * creates a model object with this ID (or grabs it from the DB) then it will be added to the
-     * entity map at that time anyways. SO, no need for EEM_Base::insert ot add to the entity map
-     *
-     * @param array $field_n_values keys are field names, values are their values (in the client code's domain if
-     *                              $values_already_prepared_by_model_object is false, in the model object's domain if
-     *                              $values_already_prepared_by_model_object is true. See comment about this at the top
-     *                              of EEM_Base)
-     * @return int new primary key on main table that got inserted
-     * @throws EE_Error
-     */
-    public function insert($field_n_values)
-    {
-        /**
-         * Filters the fields and their values before inserting an item using the models
-         *
-         * @param array    $fields_n_values keys are the fields and values are their new values
-         * @param EEM_Base $model           the model used
-         */
-        $field_n_values = (array)apply_filters('FHEE__EEM_Base__insert__fields_n_values', $field_n_values, $this);
-        if ($this->_satisfies_unique_indexes($field_n_values)) {
-            $main_table = $this->_get_main_table();
-            $new_id = $this->_insert_into_specific_table($main_table, $field_n_values, false);
-            if ($new_id !== false) {
-                foreach ($this->_get_other_tables() as $other_table) {
-                    $this->_insert_into_specific_table($other_table, $field_n_values, $new_id);
-                }
-            }
-            /**
-             * Done just after attempting to insert a new model object
-             *
-             * @param EEM_Base   $model           used
-             * @param array      $fields_n_values fields and their values
-             * @param int|string the              ID of the newly-inserted model object
-             */
-            do_action('AHEE__EEM_Base__insert__end', $this, $field_n_values, $new_id);
-            return $new_id;
-        } else {
-            return false;
-        }
-    }
-
-
-
-    /**
-     * Checks that the result would satisfy the unique indexes on this model
-     *
-     * @param array  $field_n_values
-     * @param string $action
-     * @return boolean
-     * @throws \EE_Error
-     */
-    protected function _satisfies_unique_indexes($field_n_values, $action = 'insert')
-    {
-        foreach ($this->unique_indexes() as $index_name => $index) {
-            $uniqueness_where_params = array_intersect_key($field_n_values, $index->fields());
-            if ($this->exists(array($uniqueness_where_params))) {
-                EE_Error::add_error(
-                    sprintf(
-                        __(
-                            "Could not %s %s. %s uniqueness index failed. Fields %s must form a unique set, but an entry already exists with values %s.",
-                            "event_espresso"
-                        ),
-                        $action,
-                        $this->_get_class_name(),
-                        $index_name,
-                        implode(",", $index->field_names()),
-                        http_build_query($uniqueness_where_params)
-                    ),
-                    __FILE__,
-                    __FUNCTION__,
-                    __LINE__
-                );
-                return false;
-            }
-        }
-        return true;
-    }
-
-
-
-    /**
-     * Checks the database for an item that conflicts (ie, if this item were
-     * saved to the DB would break some uniqueness requirement, like a primary key
-     * or an index primary key set) with the item specified. $id_obj_or_fields_array
-     * can be either an EE_Base_Class or an array of fields n values
-     *
-     * @param EE_Base_Class|array $obj_or_fields_array
-     * @param boolean             $include_primary_key whether to use the model object's primary key
-     *                                                 when looking for conflicts
-     *                                                 (ie, if false, we ignore the model object's primary key
-     *                                                 when finding "conflicts". If true, it's also considered).
-     *                                                 Only works for INT primary key,
-     *                                                 STRING primary keys cannot be ignored
-     * @throws EE_Error
-     * @return EE_Base_Class|array
-     */
-    public function get_one_conflicting($obj_or_fields_array, $include_primary_key = true)
-    {
-        if ($obj_or_fields_array instanceof EE_Base_Class) {
-            $fields_n_values = $obj_or_fields_array->model_field_array();
-        } elseif (is_array($obj_or_fields_array)) {
-            $fields_n_values = $obj_or_fields_array;
-        } else {
-            throw new EE_Error(
-                sprintf(
-                    __(
-                        "%s get_all_conflicting should be called with a model object or an array of field names and values, you provided %d",
-                        "event_espresso"
-                    ),
-                    get_class($this),
-                    $obj_or_fields_array
-                )
-            );
-        }
-        $query_params = array();
-        if ($this->has_primary_key_field()
-            && ($include_primary_key
-                || $this->get_primary_key_field()
-                   instanceof
-                   EE_Primary_Key_String_Field)
-            && isset($fields_n_values[$this->primary_key_name()])
-        ) {
-            $query_params[0]['OR'][$this->primary_key_name()] = $fields_n_values[$this->primary_key_name()];
-        }
-        foreach ($this->unique_indexes() as $unique_index_name => $unique_index) {
-            $uniqueness_where_params = array_intersect_key($fields_n_values, $unique_index->fields());
-            $query_params[0]['OR']['AND*' . $unique_index_name] = $uniqueness_where_params;
-        }
-        //if there is nothing to base this search on, then we shouldn't find anything
-        if (empty($query_params)) {
-            return array();
-        } else {
-            return $this->get_one($query_params);
-        }
-    }
-
-
-
-    /**
-     * Like count, but is optimized and returns a boolean instead of an int
-     *
-     * @param array $query_params
-     * @return boolean
-     * @throws \EE_Error
-     */
-    public function exists($query_params)
-    {
-        $query_params['limit'] = 1;
-        return $this->count($query_params) > 0;
-    }
-
-
-
-    /**
-     * Wrapper for exists, except ignores default query parameters so we're only considering ID
-     *
-     * @param int|string $id
-     * @return boolean
-     * @throws \EE_Error
-     */
-    public function exists_by_ID($id)
-    {
-        return $this->exists(array('default_where_conditions' => 'none', array($this->primary_key_name() => $id)));
-    }
-
-
-
-    /**
-     * Inserts a new row in $table, using the $cols_n_values which apply to that table.
-     * If a $new_id is supplied and if $table is an EE_Other_Table, we assume
-     * we need to add a foreign key column to point to $new_id (which should be the primary key's value
-     * on the main table)
-     * This is protected rather than private because private is not accessible to any child methods and there MAY be
-     * cases where we want to call it directly rather than via insert().
-     *
-     * @access   protected
-     * @param EE_Table_Base $table
-     * @param array         $fields_n_values each key should be in field's keys, and value should be an int, string or
-     *                                       float
-     * @param int           $new_id          for now we assume only int keys
-     * @throws EE_Error
-     * @global WPDB         $wpdb            only used to get the $wpdb->insert_id after performing an insert
-     * @return int ID of new row inserted, or FALSE on failure
-     */
-    protected function _insert_into_specific_table(EE_Table_Base $table, $fields_n_values, $new_id = 0)
-    {
-        global $wpdb;
-        $insertion_col_n_values = array();
-        $format_for_insertion = array();
-        $fields_on_table = $this->_get_fields_for_table($table->get_table_alias());
-        foreach ($fields_on_table as $field_name => $field_obj) {
-            //check if its an auto-incrementing column, in which case we should just leave it to do its autoincrement thing
-            if ($field_obj->is_auto_increment()) {
-                continue;
-            }
-            $prepared_value = $this->_prepare_value_or_use_default($field_obj, $fields_n_values);
-            //if the value we want to assign it to is NULL, just don't mention it for the insertion
-            if ($prepared_value !== null) {
-                $insertion_col_n_values[$field_obj->get_table_column()] = $prepared_value;
-                $format_for_insertion[] = $field_obj->get_wpdb_data_type();
-            }
-        }
-        if ($table instanceof EE_Secondary_Table && $new_id) {
-            //its not the main table, so we should have already saved the main table's PK which we just inserted
-            //so add the fk to the main table as a column
-            $insertion_col_n_values[$table->get_fk_on_table()] = $new_id;
-            $format_for_insertion[] = '%d';//yes right now we're only allowing these foreign keys to be INTs
-        }
-        //insert the new entry
-        $result = $this->_do_wpdb_query('insert',
-            array($table->get_table_name(), $insertion_col_n_values, $format_for_insertion));
-        if ($result === false) {
-            return false;
-        }
-        //ok, now what do we return for the ID of the newly-inserted thing?
-        if ($this->has_primary_key_field()) {
-            if ($this->get_primary_key_field()->is_auto_increment()) {
-                return $wpdb->insert_id;
-            } else {
-                //it's not an auto-increment primary key, so
-                //it must have been supplied
-                return $fields_n_values[$this->get_primary_key_field()->get_name()];
-            }
-        } else {
-            //we can't return a  primary key because there is none. instead return
-            //a unique string indicating this model
-            return $this->get_index_primary_key_string($fields_n_values);
-        }
-    }
-
-
-
-    /**
-     * Prepare the $field_obj 's value in $fields_n_values for use in the database.
-     * If the field doesn't allow NULL, try to use its default. (If it doesn't allow NULL,
-     * and there is no default, we pass it along. WPDB will take care of it)
-     *
-     * @param EE_Model_Field_Base $field_obj
-     * @param array               $fields_n_values
-     * @return mixed string|int|float depending on what the table column will be expecting
-     * @throws \EE_Error
-     */
-    protected function _prepare_value_or_use_default($field_obj, $fields_n_values)
-    {
-        //if this field doesn't allow nullable, don't allow it
-        if ( ! $field_obj->is_nullable()
-             && (
-                 ! isset($fields_n_values[$field_obj->get_name()]) || $fields_n_values[$field_obj->get_name()] === null)
-        ) {
-            $fields_n_values[$field_obj->get_name()] = $field_obj->get_default_value();
-        }
-        $unprepared_value = isset($fields_n_values[$field_obj->get_name()]) ? $fields_n_values[$field_obj->get_name()]
-            : null;
-        return $this->_prepare_value_for_use_in_db($unprepared_value, $field_obj);
-    }
-
-
-
-    /**
-     * Consolidates code for preparing  a value supplied to the model for use int eh db. Calls the field's
-     * prepare_for_use_in_db method on the value, and depending on $value_already_prepare_by_model_obj, may also call
-     * the field's prepare_for_set() method.
-     *
-     * @param mixed               $value value in the client code domain if $value_already_prepared_by_model_object is
-     *                                   false, otherwise a value in the model object's domain (see lengthy comment at
-     *                                   top of file)
-     * @param EE_Model_Field_Base $field field which will be doing the preparing of the value. If null, we assume
-     *                                   $value is a custom selection
-     * @return mixed a value ready for use in the database for insertions, updating, or in a where clause
-     */
-    private function _prepare_value_for_use_in_db($value, $field)
-    {
-        if ($field && $field instanceof EE_Model_Field_Base) {
-            switch ($this->_values_already_prepared_by_model_object) {
-                /** @noinspection PhpMissingBreakStatementInspection */
-                case self::not_prepared_by_model_object:
-                    $value = $field->prepare_for_set($value);
-                //purposefully left out "return"
-                case self::prepared_by_model_object:
-                    $value = $field->prepare_for_use_in_db($value);
-                case self::prepared_for_use_in_db:
-                    //leave the value alone
-            }
-            return $value;
-        } else {
-            return $value;
-        }
-    }
-
-
-
-    /**
-     * Returns the main table on this model
-     *
-     * @return EE_Primary_Table
-     * @throws EE_Error
-     */
-    protected function _get_main_table()
-    {
-        foreach ($this->_tables as $table) {
-            if ($table instanceof EE_Primary_Table) {
-                return $table;
-            }
-        }
-        throw new EE_Error(sprintf(__('There are no main tables on %s. They should be added to _tables array in the constructor',
-            'event_espresso'), get_class($this)));
-    }
-
-
-
-    /**
-     * table
-     * returns EE_Primary_Table table name
-     *
-     * @return string
-     * @throws \EE_Error
-     */
-    public function table()
-    {
-        return $this->_get_main_table()->get_table_name();
-    }
-
-
-
-    /**
-     * table
-     * returns first EE_Secondary_Table table name
-     *
-     * @return string
-     */
-    public function second_table()
-    {
-        // grab second table from tables array
-        $second_table = end($this->_tables);
-        return $second_table instanceof EE_Secondary_Table ? $second_table->get_table_name() : null;
-    }
-
-
-
-    /**
-     * get_table_obj_by_alias
-     * returns table name given it's alias
-     *
-     * @param string $table_alias
-     * @return EE_Primary_Table | EE_Secondary_Table
-     */
-    public function get_table_obj_by_alias($table_alias = '')
-    {
-        return isset($this->_tables[$table_alias]) ? $this->_tables[$table_alias] : null;
-    }
-
-
-
-    /**
-     * Gets all the tables of type EE_Other_Table from EEM_CPT_Basel_Model::_tables
-     *
-     * @return EE_Secondary_Table[]
-     */
-    protected function _get_other_tables()
-    {
-        $other_tables = array();
-        foreach ($this->_tables as $table_alias => $table) {
-            if ($table instanceof EE_Secondary_Table) {
-                $other_tables[$table_alias] = $table;
-            }
-        }
-        return $other_tables;
-    }
-
-
-
-    /**
-     * Finds all the fields that correspond to the given table
-     *
-     * @param string $table_alias , array key in EEM_Base::_tables
-     * @return EE_Model_Field_Base[]
-     */
-    public function _get_fields_for_table($table_alias)
-    {
-        return $this->_fields[$table_alias];
-    }
-
-
-
-    /**
-     * Recurses through all the where parameters, and finds all the related models we'll need
-     * to complete this query. Eg, given where parameters like array('EVT_ID'=>3) from within Event model, we won't
-     * need any related models. But if the array were array('Registrations.REG_ID'=>3), we'd need the related
-     * Registration model. If it were array('Registrations.Transactions.Payments.PAY_ID'=>3), then we'd need the
-     * related Registration, Transaction, and Payment models.
-     *
-     * @param array $query_params like EEM_Base::get_all's $query_parameters['where']
-     * @return EE_Model_Query_Info_Carrier
-     * @throws \EE_Error
-     */
-    public function _extract_related_models_from_query($query_params)
-    {
-        $query_info_carrier = new EE_Model_Query_Info_Carrier();
-        if (array_key_exists(0, $query_params)) {
-            $this->_extract_related_models_from_sub_params_array_keys($query_params[0], $query_info_carrier, 0);
-        }
-        if (array_key_exists('group_by', $query_params)) {
-            if (is_array($query_params['group_by'])) {
-                $this->_extract_related_models_from_sub_params_array_values(
-                    $query_params['group_by'],
-                    $query_info_carrier,
-                    'group_by'
-                );
-            } elseif ( ! empty ($query_params['group_by'])) {
-                $this->_extract_related_model_info_from_query_param(
-                    $query_params['group_by'],
-                    $query_info_carrier,
-                    'group_by'
-                );
-            }
-        }
-        if (array_key_exists('having', $query_params)) {
-            $this->_extract_related_models_from_sub_params_array_keys(
-                $query_params[0],
-                $query_info_carrier,
-                'having'
-            );
-        }
-        if (array_key_exists('order_by', $query_params)) {
-            if (is_array($query_params['order_by'])) {
-                $this->_extract_related_models_from_sub_params_array_keys(
-                    $query_params['order_by'],
-                    $query_info_carrier,
-                    'order_by'
-                );
-            } elseif ( ! empty($query_params['order_by'])) {
-                $this->_extract_related_model_info_from_query_param(
-                    $query_params['order_by'],
-                    $query_info_carrier,
-                    'order_by'
-                );
-            }
-        }
-        if (array_key_exists('force_join', $query_params)) {
-            $this->_extract_related_models_from_sub_params_array_values(
-                $query_params['force_join'],
-                $query_info_carrier,
-                'force_join'
-            );
-        }
-        return $query_info_carrier;
-    }
-
-
-
-    /**
-     * For extracting related models from WHERE (0), HAVING (having), ORDER BY (order_by) or forced joins (force_join)
-     *
-     * @param array                       $sub_query_params like EEM_Base::get_all's $query_params[0] or
-     *                                                      $query_params['having']
-     * @param EE_Model_Query_Info_Carrier $model_query_info_carrier
-     * @param string                      $query_param_type one of $this->_allowed_query_params
-     * @throws EE_Error
-     * @return \EE_Model_Query_Info_Carrier
-     */
-    private function _extract_related_models_from_sub_params_array_keys(
-        $sub_query_params,
-        EE_Model_Query_Info_Carrier $model_query_info_carrier,
-        $query_param_type
-    ) {
-        if ( ! empty($sub_query_params)) {
-            $sub_query_params = (array)$sub_query_params;
-            foreach ($sub_query_params as $param => $possibly_array_of_params) {
-                //$param could be simply 'EVT_ID', or it could be 'Registrations.REG_ID', or even 'Registrations.Transactions.Payments.PAY_amount'
-                $this->_extract_related_model_info_from_query_param($param, $model_query_info_carrier,
-                    $query_param_type);
-                //if $possibly_array_of_params is an array, try recursing into it, searching for keys which
-                //indicate needed joins. Eg, array('NOT'=>array('Registration.TXN_ID'=>23)). In this case, we tried
-                //extracting models out of the 'NOT', which obviously wasn't successful, and then we recurse into the value
-                //of array('Registration.TXN_ID'=>23)
-                $query_param_sans_stars = $this->_remove_stars_and_anything_after_from_condition_query_param_key($param);
-                if (in_array($query_param_sans_stars, $this->_logic_query_param_keys, true)) {
-                    if ( ! is_array($possibly_array_of_params)) {
-                        throw new EE_Error(sprintf(__("You used a special where query param %s, but the value isn't an array of where query params, it's just %s'. It should be an array, eg array('EVT_ID'=>23,'OR'=>array('Venue.VNU_ID'=>32,'Venue.VNU_name'=>'monkey_land'))",
-                            "event_espresso"),
-                            $param, $possibly_array_of_params));
-                    } else {
-                        $this->_extract_related_models_from_sub_params_array_keys($possibly_array_of_params,
-                            $model_query_info_carrier, $query_param_type);
-                    }
-                } elseif ($query_param_type === 0 //ie WHERE
-                          && is_array($possibly_array_of_params)
-                          && isset($possibly_array_of_params[2])
-                          && $possibly_array_of_params[2] == true
-                ) {
-                    //then $possible_array_of_params looks something like array('<','DTT_sold',true)
-                    //indicating that $possible_array_of_params[1] is actually a field name,
-                    //from which we should extract query parameters!
-                    if ( ! isset($possibly_array_of_params[0], $possibly_array_of_params[1])) {
-                        throw new EE_Error(sprintf(__("Improperly formed query parameter %s. It should be numerically indexed like array('<','DTT_sold',true); but you provided %s",
-                            "event_espresso"), $query_param_type, implode(",", $possibly_array_of_params)));
-                    }
-                    $this->_extract_related_model_info_from_query_param($possibly_array_of_params[1],
-                        $model_query_info_carrier, $query_param_type);
-                }
-            }
-        }
-        return $model_query_info_carrier;
-    }
-
-
-
-    /**
-     * For extracting related models from forced_joins, where the array values contain the info about what
-     * models to join with. Eg an array like array('Attendee','Price.Price_Type');
-     *
-     * @param array                       $sub_query_params like EEM_Base::get_all's $query_params[0] or
-     *                                                      $query_params['having']
-     * @param EE_Model_Query_Info_Carrier $model_query_info_carrier
-     * @param string                      $query_param_type one of $this->_allowed_query_params
-     * @throws EE_Error
-     * @return \EE_Model_Query_Info_Carrier
-     */
-    private function _extract_related_models_from_sub_params_array_values(
-        $sub_query_params,
-        EE_Model_Query_Info_Carrier $model_query_info_carrier,
-        $query_param_type
-    ) {
-        if ( ! empty($sub_query_params)) {
-            if ( ! is_array($sub_query_params)) {
-                throw new EE_Error(sprintf(__("Query parameter %s should be an array, but it isn't.", "event_espresso"),
-                    $sub_query_params));
-            }
-            foreach ($sub_query_params as $param) {
-                //$param could be simply 'EVT_ID', or it could be 'Registrations.REG_ID', or even 'Registrations.Transactions.Payments.PAY_amount'
-                $this->_extract_related_model_info_from_query_param($param, $model_query_info_carrier,
-                    $query_param_type);
-            }
-        }
-        return $model_query_info_carrier;
-    }
-
-
-
-    /**
-     * Extract all the query parts from $query_params (an array like whats passed to EEM_Base::get_all)
-     * and put into a EEM_Related_Model_Info_Carrier for easy extraction into a query. We create this object
-     * instead of directly constructing the SQL because often we need to extract info from the $query_params
-     * but use them in a different order. Eg, we need to know what models we are querying
-     * before we know what joins to perform. However, we need to know what data types correspond to which fields on
-     * other models before we can finalize the where clause SQL.
-     *
-     * @param array $query_params
-     * @throws EE_Error
-     * @return EE_Model_Query_Info_Carrier
-     */
-    public function _create_model_query_info_carrier($query_params)
-    {
-        if ( ! is_array($query_params)) {
-            EE_Error::doing_it_wrong(
-                'EEM_Base::_create_model_query_info_carrier',
-                sprintf(
-                    __(
-                        '$query_params should be an array, you passed a variable of type %s',
-                        'event_espresso'
-                    ),
-                    gettype($query_params)
-                ),
-                '4.6.0'
-            );
-            $query_params = array();
-        }
-        $where_query_params = isset($query_params[0]) ? $query_params[0] : array();
-        //first check if we should alter the query to account for caps or not
-        //because the caps might require us to do extra joins
-        if (isset($query_params['caps']) && $query_params['caps'] !== 'none') {
-            $query_params[0] = $where_query_params = array_replace_recursive(
-                $where_query_params,
-                $this->caps_where_conditions(
-                    $query_params['caps']
-                )
-            );
-        }
-        $query_object = $this->_extract_related_models_from_query($query_params);
-        //verify where_query_params has NO numeric indexes.... that's simply not how you use it!
-        foreach ($where_query_params as $key => $value) {
-            if (is_int($key)) {
-                throw new EE_Error(
-                    sprintf(
-                        __(
-                            "WHERE query params must NOT be numerically-indexed. You provided the array key '%s' for value '%s' while querying model %s. All the query params provided were '%s' Please read documentation on EEM_Base::get_all.",
-                            "event_espresso"
-                        ),
-                        $key,
-                        var_export($value, true),
-                        var_export($query_params, true),
-                        get_class($this)
-                    )
-                );
-            }
-        }
-        if (
-            array_key_exists('default_where_conditions', $query_params)
-            && ! empty($query_params['default_where_conditions'])
-        ) {
-            $use_default_where_conditions = $query_params['default_where_conditions'];
-        } else {
-            $use_default_where_conditions = 'all';
-        }
-        $where_query_params = array_merge(
-            $this->_get_default_where_conditions_for_models_in_query(
-                $query_object,
-                $use_default_where_conditions,
-                $where_query_params
-            ),
-            $where_query_params
-        );
-        $query_object->set_where_sql($this->_construct_where_clause($where_query_params));
-        // if this is a "on_join_limit" then we are limiting on on a specific table in a multi_table join.
-        // So we need to setup a subquery and use that for the main join.
-        // Note for now this only works on the primary table for the model.
-        // So for instance, you could set the limit array like this:
-        // array( 'on_join_limit' => array('Primary_Table_Alias', array(1,10) ) )
-        if (array_key_exists('on_join_limit', $query_params) && ! empty($query_params['on_join_limit'])) {
-            $query_object->set_main_model_join_sql(
-                $this->_construct_limit_join_select(
-                    $query_params['on_join_limit'][0],
-                    $query_params['on_join_limit'][1]
-                )
-            );
-        }
-        //set limit
-        if (array_key_exists('limit', $query_params)) {
-            if (is_array($query_params['limit'])) {
-                if ( ! isset($query_params['limit'][0], $query_params['limit'][1])) {
-                    $e = sprintf(
-                        __(
-                            "Invalid DB query. You passed '%s' for the LIMIT, but only the following are valid: an integer, string representing an integer, a string like 'int,int', or an array like array(int,int)",
-                            "event_espresso"
-                        ),
-                        http_build_query($query_params['limit'])
-                    );
-                    throw new EE_Error($e . "|" . $e);
-                }
-                //they passed us an array for the limit. Assume it's like array(50,25), meaning offset by 50, and get 25
-                $query_object->set_limit_sql(" LIMIT " . $query_params['limit'][0] . "," . $query_params['limit'][1]);
-            } elseif ( ! empty ($query_params['limit'])) {
-                $query_object->set_limit_sql(" LIMIT " . $query_params['limit']);
-            }
-        }
-        //set order by
-        if (array_key_exists('order_by', $query_params)) {
-            if (is_array($query_params['order_by'])) {
-                //if they're using 'order_by' as an array, they can't use 'order' (because 'order_by' must
-                //specify whether to ascend or descend on each field. Eg 'order_by'=>array('EVT_ID'=>'ASC'). So
-                //including 'order' wouldn't make any sense if 'order_by' has already specified which way to order!
-                if (array_key_exists('order', $query_params)) {
-                    throw new EE_Error(
-                        sprintf(
-                            __(
-                                "In querying %s, we are using query parameter 'order_by' as an array (keys:%s,values:%s), and so we can't use query parameter 'order' (value %s). You should just use the 'order_by' parameter ",
-                                "event_espresso"
-                            ),
-                            get_class($this),
-                            implode(", ", array_keys($query_params['order_by'])),
-                            implode(", ", $query_params['order_by']),
-                            $query_params['order']
-                        )
-                    );
-                }
-                $this->_extract_related_models_from_sub_params_array_keys(
-                    $query_params['order_by'],
-                    $query_object,
-                    'order_by'
-                );
-                //assume it's an array of fields to order by
-                $order_array = array();
-                foreach ($query_params['order_by'] as $field_name_to_order_by => $order) {
-                    $order = $this->_extract_order($order);
-                    $order_array[] = $this->_deduce_column_name_from_query_param($field_name_to_order_by) . SP . $order;
-                }
-                $query_object->set_order_by_sql(" ORDER BY " . implode(",", $order_array));
-            } elseif ( ! empty ($query_params['order_by'])) {
-                $this->_extract_related_model_info_from_query_param(
-                    $query_params['order_by'],
-                    $query_object,
-                    'order',
-                    $query_params['order_by']
-                );
-                $order = isset($query_params['order'])
-                    ? $this->_extract_order($query_params['order'])
-                    : 'DESC';
-                $query_object->set_order_by_sql(
-                    " ORDER BY " . $this->_deduce_column_name_from_query_param($query_params['order_by']) . SP . $order
-                );
-            }
-        }
-        //if 'order_by' wasn't set, maybe they are just using 'order' on its own?
-        if ( ! array_key_exists('order_by', $query_params)
-             && array_key_exists('order', $query_params)
-             && ! empty($query_params['order'])
-        ) {
-            $pk_field = $this->get_primary_key_field();
-            $order = $this->_extract_order($query_params['order']);
-            $query_object->set_order_by_sql(" ORDER BY " . $pk_field->get_qualified_column() . SP . $order);
-        }
-        //set group by
-        if (array_key_exists('group_by', $query_params)) {
-            if (is_array($query_params['group_by'])) {
-                //it's an array, so assume we'll be grouping by a bunch of stuff
-                $group_by_array = array();
-                foreach ($query_params['group_by'] as $field_name_to_group_by) {
-                    $group_by_array[] = $this->_deduce_column_name_from_query_param($field_name_to_group_by);
-                }
-                $query_object->set_group_by_sql(" GROUP BY " . implode(", ", $group_by_array));
-            } elseif ( ! empty ($query_params['group_by'])) {
-                $query_object->set_group_by_sql(
-                    " GROUP BY " . $this->_deduce_column_name_from_query_param($query_params['group_by'])
-                );
-            }
-        }
-        //set having
-        if (array_key_exists('having', $query_params) && $query_params['having']) {
-            $query_object->set_having_sql($this->_construct_having_clause($query_params['having']));
-        }
-        //now, just verify they didn't pass anything wack
-        foreach ($query_params as $query_key => $query_value) {
-            if ( ! in_array($query_key, $this->_allowed_query_params, true)) {
-                throw new EE_Error(
-                    sprintf(
-                        __(
-                            "You passed %s as a query parameter to %s, which is illegal! The allowed query parameters are %s",
-                            'event_espresso'
-                        ),
-                        $query_key,
-                        get_class($this),
-                        //						print_r( $this->_allowed_query_params, TRUE )
-                        implode(',', $this->_allowed_query_params)
-                    )
-                );
-            }
-        }
-        $main_model_join_sql = $query_object->get_main_model_join_sql();
-        if (empty($main_model_join_sql)) {
-            $query_object->set_main_model_join_sql($this->_construct_internal_join());
-        }
-        return $query_object;
-    }
-
-
-
-    /**
-     * Gets the where conditions that should be imposed on the query based on the
-     * context (eg reading frontend, backend, edit or delete).
-     *
-     * @param string $context one of EEM_Base::valid_cap_contexts()
-     * @return array like EEM_Base::get_all() 's $query_params[0]
-     * @throws \EE_Error
-     */
-    public function caps_where_conditions($context = self::caps_read)
-    {
-        EEM_Base::verify_is_valid_cap_context($context);
-        $cap_where_conditions = array();
-        $cap_restrictions = $this->caps_missing($context);
-        /**
-         * @var $cap_restrictions EE_Default_Where_Conditions[]
-         */
-        foreach ($cap_restrictions as $cap => $restriction_if_no_cap) {
-            $cap_where_conditions = array_replace_recursive($cap_where_conditions,
-                $restriction_if_no_cap->get_default_where_conditions());
-        }
-        return apply_filters('FHEE__EEM_Base__caps_where_conditions__return', $cap_where_conditions, $this, $context,
-            $cap_restrictions);
-    }
-
-
-
-    /**
-     * Verifies that $should_be_order_string is in $this->_allowed_order_values,
-     * otherwise throws an exception
-     *
-     * @param string $should_be_order_string
-     * @return string either ASC, asc, DESC or desc
-     * @throws EE_Error
-     */
-    private function _extract_order($should_be_order_string)
-    {
-        if (in_array($should_be_order_string, $this->_allowed_order_values)) {
-            return $should_be_order_string;
-        } else {
-            throw new EE_Error(sprintf(__("While performing a query on '%s', tried to use '%s' as an order parameter. ",
-                "event_espresso"), get_class($this), $should_be_order_string));
-        }
-    }
-
-
-
-    /**
-     * Looks at all the models which are included in this query, and asks each
-     * for their universal_where_params, and returns them in the same format as $query_params[0] (where),
-     * so they can be merged
-     *
-     * @param EE_Model_Query_Info_Carrier $query_info_carrier
-     * @param string                      $use_default_where_conditions can be 'none','other_models_only', or 'all'.
-     *                                                                  'none' means NO default where conditions will
-     *                                                                  be used AT ALL during this query.
-     *                                                                  'other_models_only' means default where
-     *                                                                  conditions from other models will be used, but
-     *                                                                  not for this primary model. 'all', the default,
-     *                                                                  means default where conditions will apply as
-     *                                                                  normal
-     * @param array                       $where_query_params           like EEM_Base::get_all's $query_params[0]
-     * @throws EE_Error
-     * @return array like $query_params[0], see EEM_Base::get_all for documentation
-     */
-    private function _get_default_where_conditions_for_models_in_query(
-        EE_Model_Query_Info_Carrier $query_info_carrier,
-        $use_default_where_conditions = 'all',
-        $where_query_params = array()
-    ) {
-        $allowed_used_default_where_conditions_values = array(
-            'all',
-            'this_model_only',
-            'other_models_only',
-            'minimum',
-            'none',
-        );
-        if ( ! in_array($use_default_where_conditions, $allowed_used_default_where_conditions_values)) {
-            throw new EE_Error(sprintf(__("You passed an invalid value to the query parameter 'default_where_conditions' of '%s'. Allowed values are %s",
-                "event_espresso"), $use_default_where_conditions,
-                implode(", ", $allowed_used_default_where_conditions_values)));
-        }
-        $universal_query_params = array();
-        if ($use_default_where_conditions === 'all' || $use_default_where_conditions === 'this_model_only') {
-            $universal_query_params = $this->_get_default_where_conditions();
-        } else if ($use_default_where_conditions === 'minimum') {
-            $universal_query_params = $this->_get_minimum_where_conditions();
-        }
-        if (in_array($use_default_where_conditions, array('all', 'other_models_only'))) {
-            foreach ($query_info_carrier->get_model_names_included() as $model_relation_path => $model_name) {
-                $related_model = $this->get_related_model_obj($model_name);
-                $related_model_universal_where_params = $related_model->_get_default_where_conditions($model_relation_path);
-                $overrides = $this->_override_defaults_or_make_null_friendly(
-                    $related_model_universal_where_params,
-                    $where_query_params,
-                    $related_model,
-                    $model_relation_path
-                );
-                $universal_query_params = EEH_Array::merge_arrays_and_overwrite_keys(
-                    $universal_query_params,
-                    $overrides
-                );
-            }
-        }
-        return $universal_query_params;
-    }
-
-
-
-    /**
-     * Checks if any of the defaults have been overridden. If there are any that AREN'T overridden,
-     * then we also add a special where condition which allows for that model's primary key
-     * to be null (which is important for JOINs. Eg, if you want to see all Events ordered by Venue's name,
-     * then Event's with NO Venue won't appear unless you allow VNU_ID to be NULL)
-     *
-     * @param array    $default_where_conditions
-     * @param array    $provided_where_conditions
-     * @param EEM_Base $model
-     * @param string   $model_relation_path like 'Transaction.Payment.'
-     * @return array like EEM_Base::get_all's $query_params[0]
-     * @throws \EE_Error
-     */
-    private function _override_defaults_or_make_null_friendly(
-        $default_where_conditions,
-        $provided_where_conditions,
-        $model,
-        $model_relation_path
-    ) {
-        $null_friendly_where_conditions = array();
-        $none_overridden = true;
-        $or_condition_key_for_defaults = 'OR*' . get_class($model);
-        foreach ($default_where_conditions as $key => $val) {
-            if (isset($provided_where_conditions[$key])) {
-                $none_overridden = false;
-            } else {
-                $null_friendly_where_conditions[$or_condition_key_for_defaults]['AND'][$key] = $val;
-            }
-        }
-        if ($none_overridden && $default_where_conditions) {
-            if ($model->has_primary_key_field()) {
-                $null_friendly_where_conditions[$or_condition_key_for_defaults][$model_relation_path
-                                                                                . "."
-                                                                                . $model->primary_key_name()] = array('IS NULL');
-            }/*else{
+	//admin posty
+	//basic -> grants access to mine -> if they don't have it, select none
+	//*_others -> grants access to others that arent private, and all mine -> if they don't have it, select mine
+	//*_private -> grants full access -> if dont have it, select all mine and others' non-private
+	//*_published -> grants access to published -> if they dont have it, select non-published
+	//*_global/default/system -> grants access to global items -> if they don't have it, select non-global
+	//publish_{thing} -> can change status TO publish; SPECIAL CASE
+	//frontend posty
+	//by default has access to published
+	//basic -> grants access to mine that arent published, and all published
+	//*_others ->grants access to others that arent private, all mine
+	//*_private -> grants full access
+	//frontend non-posty
+	//like admin posty
+	//category-y
+	//assign -> grants access to join-table
+	//(delete, edit)
+	//payment-method-y
+	//for each registered payment method,
+	//ee_payment_method_{pmttype} -> if they don't have it, select all where they aren't of that type
+	/**
+	 * Flag to indicate whether the values provided to EEM_Base have already been prepared
+	 * by the model object or not (ie, the model object has used the field's _prepare_for_set function on the values).
+	 * They almost always WILL NOT, but it's not necessarily a requirement.
+	 * For example, if you want to run EEM_Event::instance()->get_all(array(array('EVT_ID'=>$_GET['event_id'])));
+	 *
+	 * @var boolean
+	 */
+	private $_values_already_prepared_by_model_object = 0;
+
+	/**
+	 * when $_values_already_prepared_by_model_object equals this, we assume
+	 * the data is just like form input that needs to have the model fields'
+	 * prepare_for_set and prepare_for_use_in_db called on it
+	 */
+	const not_prepared_by_model_object = 0;
+
+	/**
+	 * when $_values_already_prepared_by_model_object equals this, we
+	 * assume this value is coming from a model object and doesn't need to have
+	 * prepare_for_set called on it, just prepare_for_use_in_db is used
+	 */
+	const prepared_by_model_object = 1;
+
+	/**
+	 * when $_values_already_prepared_by_model_object equals this, we assume
+	 * the values are already to be used in the database (ie no processing is done
+	 * on them by the model's fields)
+	 */
+	const prepared_for_use_in_db = 2;
+
+
+	protected $singular_item = 'Item';
+
+	protected $plural_item   = 'Items';
+
+	/**
+	 * @type \EE_Table_Base[] $_tables array of EE_Table objects for defining which tables comprise this model.
+	 */
+	protected $_tables;
+
+	/**
+	 * with two levels: top-level has array keys which are database table aliases (ie, keys in _tables)
+	 * and the value is an array. Each of those sub-arrays have keys of field names (eg 'ATT_ID', which should also be
+	 * variable names on the model objects (eg, EE_Attendee), and the keys should be children of EE_Model_Field
+	 *
+	 * @var \EE_Model_Field_Base[] $_fields
+	 */
+	protected $_fields;
+
+	/**
+	 * array of different kinds of relations
+	 *
+	 * @var \EE_Model_Relation_Base[] $_model_relations
+	 */
+	protected $_model_relations;
+
+	/**
+	 * @var \EE_Index[] $_indexes
+	 */
+	protected $_indexes = array();
+
+	/**
+	 * Default strategy for getting where conditions on this model. This strategy is used to get default
+	 * where conditions which are added to get_all, update, and delete queries. They can be overridden
+	 * by setting the same columns as used in these queries in the query yourself.
+	 *
+	 * @var EE_Default_Where_Conditions
+	 */
+	protected $_default_where_conditions_strategy;
+
+	/**
+	 * Strategy for getting conditions on this model when 'default_where_conditions' equals 'minimum'.
+	 * This is particularly useful when you want something between 'none' and 'default'
+	 *
+	 * @var EE_Default_Where_Conditions
+	 */
+	protected $_minimum_where_conditions_strategy;
+
+	/**
+	 * String describing how to find the "owner" of this model's objects.
+	 * When there is a foreign key on this model to the wp_users table, this isn't needed.
+	 * But when there isn't, this indicates which related model, or transiently-related model,
+	 * has the foreign key to the wp_users table.
+	 * Eg, for EEM_Registration this would be 'Event' because registrations are directly
+	 * related to events, and events have a foreign key to wp_users.
+	 * On EEM_Transaction, this would be 'Transaction.Event'
+	 *
+	 * @var string
+	 */
+	protected $_model_chain_to_wp_user = '';
+
+	/**
+	 * This is a flag typically set by updates so that we don't load the where strategy on updates because updates
+	 * don't need it (particularly CPT models)
+	 *
+	 * @var bool
+	 */
+	protected $_ignore_where_strategy = false;
+
+	/**
+	 * String used in caps relating to this model. Eg, if the caps relating to this
+	 * model are 'ee_edit_events', 'ee_read_events', etc, it would be 'events'.
+	 *
+	 * @var string. If null it hasn't been initialized yet. If false then we
+	 * have indicated capabilities don't apply to this
+	 */
+	protected $_caps_slug = null;
+
+	/**
+	 * 2d array where top-level keys are one of EEM_Base::valid_cap_contexts(),
+	 * and next-level keys are capability names, and each's value is a
+	 * EE_Default_Where_Condition. If the requester requests to apply caps to the query,
+	 * they specify which context to use (ie, frontend, backend, edit or delete)
+	 * and then each capability in the corresponding sub-array that they're missing
+	 * adds the where conditions onto the query.
+	 *
+	 * @var array
+	 */
+	protected $_cap_restrictions = array(
+		self::caps_read       => array(),
+		self::caps_read_admin => array(),
+		self::caps_edit       => array(),
+		self::caps_delete     => array(),
+	);
+
+	/**
+	 * Array defining which cap restriction generators to use to create default
+	 * cap restrictions to put in EEM_Base::_cap_restrictions.
+	 * Array-keys are one of EEM_Base::valid_cap_contexts(), and values are a child of
+	 * EE_Restriction_Generator_Base. If you don't want any cap restrictions generated
+	 * automatically set this to false (not just null).
+	 *
+	 * @var EE_Restriction_Generator_Base[]
+	 */
+	protected $_cap_restriction_generators = array();
+
+	/**
+	 * constants used to categorize capability restrictions on EEM_Base::_caps_restrictions
+	 */
+	const caps_read       = 'read';
+
+	const caps_read_admin = 'read_admin';
+
+	const caps_edit       = 'edit';
+
+	const caps_delete     = 'delete';
+
+	/**
+	 * Keys are all the cap contexts (ie constants EEM_Base::_caps_*) and values are their 'action'
+	 * as how they'd be used in capability names. Eg EEM_Base::caps_read ('read_frontend')
+	 * maps to 'read' because when looking for relevant permissions we're going to use
+	 * 'read' in teh capabilities names like 'ee_read_events' etc.
+	 *
+	 * @var array
+	 */
+	protected $_cap_contexts_to_cap_action_map = array(
+		self::caps_read       => 'read',
+		self::caps_read_admin => 'read',
+		self::caps_edit       => 'edit',
+		self::caps_delete     => 'delete',
+	);
+
+	/**
+	 * Timezone
+	 * This gets set via the constructor so that we know what timezone incoming strings|timestamps are in when there
+	 * are EE_Datetime_Fields in use.  This can also be used before a get to set what timezone you want strings coming
+	 * out of the created objects.  NOT all EEM_Base child classes use this property but any that use a
+	 * EE_Datetime_Field data type will have access to it.
+	 *
+	 * @var string
+	 */
+	protected $_timezone;
+
+
+	/**
+	 * This holds the id of the blog currently making the query.  Has no bearing on single site but is used for
+	 * multisite.
+	 *
+	 * @var int
+	 */
+	protected static $_model_query_blog_id;
+
+	/**
+	 * A copy of _fields, except the array keys are the model names pointed to by
+	 * the field
+	 *
+	 * @var EE_Model_Field_Base[]
+	 */
+	private $_cache_foreign_key_to_fields = array();
+
+	/**
+	 * Cached list of all the fields on the model, indexed by their name
+	 *
+	 * @var EE_Model_Field_Base[]
+	 */
+	private $_cached_fields = null;
+
+	/**
+	 * Cached list of all the fields on the model, except those that are
+	 * marked as only pertinent to the database
+	 *
+	 * @var EE_Model_Field_Base[]
+	 */
+	private $_cached_fields_non_db_only = null;
+
+	/**
+	 * A cached reference to the primary key for quick lookup
+	 *
+	 * @var EE_Model_Field_Base
+	 */
+	private $_primary_key_field = null;
+
+	/**
+	 * Flag indicating whether this model has a primary key or not
+	 *
+	 * @var boolean
+	 */
+	protected $_has_primary_key_field = null;
+
+	/**
+	 * Whether or not this model is based off a table in WP core only (CPTs should set
+	 * this to FALSE, but if we were to make an EE_WP_Post model, it should set this to true).
+	 *
+	 * @var boolean
+	 */
+	protected $_wp_core_model = false;
+
+	/**
+	 *    List of valid operators that can be used for querying.
+	 * The keys are all operators we'll accept, the values are the real SQL
+	 * operators used
+	 *
+	 * @var array
+	 */
+	protected $_valid_operators = array(
+		'='           => '=',
+		'<='          => '<=',
+		'<'           => '<',
+		'>='          => '>=',
+		'>'           => '>',
+		'!='          => '!=',
+		'LIKE'        => 'LIKE',
+		'like'        => 'LIKE',
+		'NOT_LIKE'    => 'NOT LIKE',
+		'not_like'    => 'NOT LIKE',
+		'NOT LIKE'    => 'NOT LIKE',
+		'not like'    => 'NOT LIKE',
+		'IN'          => 'IN',
+		'in'          => 'IN',
+		'NOT_IN'      => 'NOT IN',
+		'not_in'      => 'NOT IN',
+		'NOT IN'      => 'NOT IN',
+		'not in'      => 'NOT IN',
+		'between'     => 'BETWEEN',
+		'BETWEEN'     => 'BETWEEN',
+		'IS_NOT_NULL' => 'IS NOT NULL',
+		'is_not_null' => 'IS NOT NULL',
+		'IS NOT NULL' => 'IS NOT NULL',
+		'is not null' => 'IS NOT NULL',
+		'IS_NULL'     => 'IS NULL',
+		'is_null'     => 'IS NULL',
+		'IS NULL'     => 'IS NULL',
+		'is null'     => 'IS NULL',
+		'REGEXP'      => 'REGEXP',
+		'regexp'      => 'REGEXP',
+		'NOT_REGEXP'  => 'NOT REGEXP',
+		'not_regexp'  => 'NOT REGEXP',
+		'NOT REGEXP'  => 'NOT REGEXP',
+		'not regexp'  => 'NOT REGEXP',
+	);
+
+	/**
+	 * operators that work like 'IN', accepting a comma-separated list of values inside brackets. Eg '(1,2,3)'
+	 *
+	 * @var array
+	 */
+	protected $_in_style_operators = array('IN', 'NOT IN');
+
+	/**
+	 * operators that work like 'BETWEEN'.  Typically used for datetime calculations, i.e. "BETWEEN '12-1-2011' AND
+	 * '12-31-2012'"
+	 *
+	 * @var array
+	 */
+	protected $_between_style_operators = array('BETWEEN');
+
+	/**
+	 * operators that are used for handling NUll and !NULL queries.  Typically used for when checking if a row exists
+	 * on a join table.
+	 *
+	 * @var array
+	 */
+	protected $_null_style_operators = array('IS NOT NULL', 'IS NULL');
+
+	/**
+	 * Allowed values for $query_params['order'] for ordering in queries
+	 *
+	 * @var array
+	 */
+	protected $_allowed_order_values = array('asc', 'desc', 'ASC', 'DESC');
+
+	/**
+	 * When these are keys in a WHERE or HAVING clause, they are handled much differently
+	 * than regular field names. It is assumed that their values are an array of WHERE conditions
+	 *
+	 * @var array
+	 */
+	private $_logic_query_param_keys = array('not', 'and', 'or', 'NOT', 'AND', 'OR');
+
+	/**
+	 * Allowed keys in $query_params arrays passed into queries. Note that 0 is meant to always be a
+	 * 'where', but 'where' clauses are so common that we thought we'd omit it
+	 *
+	 * @var array
+	 */
+	private $_allowed_query_params = array(
+		0,
+		'limit',
+		'order_by',
+		'group_by',
+		'having',
+		'force_join',
+		'order',
+		'on_join_limit',
+		'default_where_conditions',
+		'caps',
+	);
+
+	/**
+	 * All the data types that can be used in $wpdb->prepare statements.
+	 *
+	 * @var array
+	 */
+	private $_valid_wpdb_data_types = array('%d', '%s', '%f');
+
+	/**
+	 *    EE_Registry Object
+	 *
+	 * @var    object
+	 * @access    protected
+	 */
+	protected $EE = null;
+
+
+	/**
+	 * Property which, when set, will have this model echo out the next X queries to the page for debugging.
+	 *
+	 * @var int
+	 */
+	protected $_show_next_x_db_queries = 0;
+
+	/**
+	 * When using _get_all_wpdb_results, you can specify a custom selection. If you do so,
+	 * it gets saved on this property so those selections can be used in WHERE, GROUP_BY, etc.
+	 *
+	 * @var array
+	 */
+	protected $_custom_selections = array();
+
+	/**
+	 * key => value Entity Map using  array( EEM_Base::$_model_query_blog_id => array( ID => model object ) )
+	 * caches every model object we've fetched from the DB on this request
+	 *
+	 * @var array
+	 */
+	protected $_entity_map;
+
+	/**
+	 * constant used to show EEM_Base has not yet verified the db on this http request
+	 */
+	const db_verified_none = 0;
+
+	/**
+	 * constant used to show EEM_Base has verified the EE core db on this http request,
+	 * but not the addons' dbs
+	 */
+	const db_verified_core = 1;
+
+	/**
+	 * constant used to show EEM_Base has verified the addons' dbs (and implicitly
+	 * the EE core db too)
+	 */
+	const db_verified_addons = 2;
+
+	/**
+	 * indicates whether an EEM_Base child has already re-verified the DB
+	 * is ok (we don't want to do it repetitively). Should be set to one the constants
+	 * looking like EEM_Base::db_verified_*
+	 *
+	 * @var int - 0 = none, 1 = core, 2 = addons
+	 */
+	protected static $_db_verification_level = EEM_Base::db_verified_none;
+
+
+
+	/**
+	 * About all child constructors:
+	 * they should define the _tables, _fields and _model_relations arrays.
+	 * Should ALWAYS be called after child constructor.
+	 * In order to make the child constructors to be as simple as possible, this parent constructor
+	 * finalizes constructing all the object's attributes.
+	 * Generally, rather than requiring a child to code
+	 * $this->_tables = array(
+	 *        'Event_Post_Table' => new EE_Table('Event_Post_Table','wp_posts')
+	 *        ...);
+	 *  (thus repeating itself in the array key and in the constructor of the new EE_Table,)
+	 * each EE_Table has a function to set the table's alias after the constructor, using
+	 * the array key ('Event_Post_Table'), instead of repeating it. The model fields and model relations
+	 * do something similar.
+	 *
+	 * @param null $timezone
+	 * @throws \EE_Error
+	 */
+	protected function __construct($timezone = null)
+	{
+		// check that the model has not been loaded too soon
+		if ( ! did_action('AHEE__EE_System__load_espresso_addons')) {
+			throw new EE_Error (
+				sprintf(
+					__('The %1$s model can not be loaded before the "AHEE__EE_System__load_espresso_addons" hook has been called. This gives other addons a chance to extend this model.',
+						'event_espresso'),
+					get_class($this)
+				)
+			);
+		}
+		/**
+		 * Set blogid for models to current blog. However we ONLY do this if $_model_query_blog_id is not already set.
+		 */
+		if (empty(EEM_Base::$_model_query_blog_id)) {
+			EEM_Base::set_model_query_blog_id();
+		}
+		/**
+		 * Filters the list of tables on a model. It is best to NOT use this directly and instead
+		 * just use EE_Register_Model_Extension
+		 *
+		 * @var EE_Table_Base[] $_tables
+		 */
+		$this->_tables = apply_filters('FHEE__' . get_class($this) . '__construct__tables', $this->_tables);
+		foreach ($this->_tables as $table_alias => $table_obj) {
+			/** @var $table_obj EE_Table_Base */
+			$table_obj->_construct_finalize_with_alias($table_alias);
+			if ($table_obj instanceof EE_Secondary_Table) {
+				/** @var $table_obj EE_Secondary_Table */
+				$table_obj->_construct_finalize_set_table_to_join_with($this->_get_main_table());
+			}
+		}
+		/**
+		 * Filters the list of fields on a model. It is best to NOT use this directly and instead just use
+		 * EE_Register_Model_Extension
+		 *
+		 * @param EE_Model_Field_Base[] $_fields
+		 */
+		$this->_fields = apply_filters('FHEE__' . get_class($this) . '__construct__fields', $this->_fields);
+		$this->_invalidate_field_caches();
+		foreach ($this->_fields as $table_alias => $fields_for_table) {
+			if ( ! array_key_exists($table_alias, $this->_tables)) {
+				throw new EE_Error(sprintf(__("Table alias %s does not exist in EEM_Base child's _tables array. Only tables defined are %s",
+					'event_espresso'), $table_alias, implode(",", $this->_fields)));
+			}
+			foreach ($fields_for_table as $field_name => $field_obj) {
+				/** @var $field_obj EE_Model_Field_Base | EE_Primary_Key_Field_Base */
+				//primary key field base has a slightly different _construct_finalize
+				/** @var $field_obj EE_Model_Field_Base */
+				$field_obj->_construct_finalize($table_alias, $field_name, $this->get_this_model_name());
+			}
+		}
+		// everything is related to Extra_Meta
+		if (get_class($this) !== 'EEM_Extra_Meta') {
+			//make extra meta related to everything, but don't block deleting things just
+			//because they have related extra meta info. For now just orphan those extra meta
+			//in the future we should automatically delete them
+			$this->_model_relations['Extra_Meta'] = new EE_Has_Many_Any_Relation(false);
+		}
+		//and change logs
+		if (get_class($this) !== 'EEM_Change_Log') {
+			$this->_model_relations['Change_Log'] = new EE_Has_Many_Any_Relation(false);
+		}
+		/**
+		 * Filters the list of relations on a model. It is best to NOT use this directly and instead just use
+		 * EE_Register_Model_Extension
+		 *
+		 * @param EE_Model_Relation_Base[] $_model_relations
+		 */
+		$this->_model_relations = apply_filters('FHEE__' . get_class($this) . '__construct__model_relations',
+			$this->_model_relations);
+		foreach ($this->_model_relations as $model_name => $relation_obj) {
+			/** @var $relation_obj EE_Model_Relation_Base */
+			$relation_obj->_construct_finalize_set_models($this->get_this_model_name(), $model_name);
+		}
+		foreach ($this->_indexes as $index_name => $index_obj) {
+			/** @var $index_obj EE_Index */
+			$index_obj->_construct_finalize($index_name, $this->get_this_model_name());
+		}
+		$this->set_timezone($timezone);
+		//finalize default where condition strategy, or set default
+		if ( ! $this->_default_where_conditions_strategy) {
+			//nothing was set during child constructor, so set default
+			$this->_default_where_conditions_strategy = new EE_Default_Where_Conditions();
+		}
+		$this->_default_where_conditions_strategy->_finalize_construct($this);
+		if ( ! $this->_minimum_where_conditions_strategy) {
+			//nothing was set during child constructor, so set default
+			$this->_minimum_where_conditions_strategy = new EE_Default_Where_Conditions();
+		}
+		$this->_minimum_where_conditions_strategy->_finalize_construct($this);
+		//if the cap slug hasn't been set, and we haven't set it to false on purpose
+		//to indicate to NOT set it, set it to the logical default
+		if ($this->_caps_slug === null) {
+			$this->_caps_slug = EEH_Inflector::pluralize_and_lower($this->get_this_model_name());
+		}
+		//initialize the standard cap restriction generators if none were specified by the child constructor
+		if ($this->_cap_restriction_generators !== false) {
+			foreach ($this->cap_contexts_to_cap_action_map() as $cap_context => $action) {
+				if ( ! isset($this->_cap_restriction_generators[$cap_context])) {
+					$this->_cap_restriction_generators[$cap_context] = apply_filters(
+						'FHEE__EEM_Base___construct__standard_cap_restriction_generator',
+						new EE_Restriction_Generator_Protected(),
+						$cap_context,
+						$this
+					);
+				}
+			}
+		}
+		//if there are cap restriction generators, use them to make the default cap restrictions
+		if ($this->_cap_restriction_generators !== false) {
+			foreach ($this->_cap_restriction_generators as $context => $generator_object) {
+				if ( ! $generator_object) {
+					continue;
+				}
+				if ( ! $generator_object instanceof EE_Restriction_Generator_Base) {
+					throw new EE_Error(
+						sprintf(
+							__('Index "%1$s" in the model %2$s\'s _cap_restriction_generators is not a child of EE_Restriction_Generator_Base. It should be that or NULL.',
+								'event_espresso'),
+							$context,
+							$this->get_this_model_name()
+						)
+					);
+				}
+				$action = $this->cap_action_for_context($context);
+				if ( ! $generator_object->construction_finalized()) {
+					$generator_object->_construct_finalize($this, $action);
+				}
+			}
+		}
+		do_action('AHEE__' . get_class($this) . '__construct__end');
+	}
+
+
+
+	/**
+	 * Generates the cap restrictions for the given context, or if they were
+	 * already generated just gets what's cached
+	 *
+	 * @param string $context one of EEM_Base::valid_cap_contexts()
+	 * @return EE_Default_Where_Conditions[]
+	 */
+	protected function _generate_cap_restrictions($context)
+	{
+		if (isset($this->_cap_restriction_generators[$context])
+			&& $this->_cap_restriction_generators[$context]
+			   instanceof
+			   EE_Restriction_Generator_Base
+		) {
+			return $this->_cap_restriction_generators[$context]->generate_restrictions();
+		} else {
+			return array();
+		}
+	}
+
+
+
+	/**
+	 * Used to set the $_model_query_blog_id static property.
+	 *
+	 * @param int $blog_id  If provided then will set the blog_id for the models to this id.  If not provided then the
+	 *                      value for get_current_blog_id() will be used.
+	 */
+	public static function set_model_query_blog_id($blog_id = 0)
+	{
+		EEM_Base::$_model_query_blog_id = $blog_id > 0 ? (int)$blog_id : get_current_blog_id();
+	}
+
+
+
+	/**
+	 * Returns whatever is set as the internal $model_query_blog_id.
+	 *
+	 * @return int
+	 */
+	public static function get_model_query_blog_id()
+	{
+		return EEM_Base::$_model_query_blog_id;
+	}
+
+
+
+	/**
+	 *        This function is a singleton method used to instantiate the Espresso_model object
+	 *
+	 * @access public
+	 * @param string $timezone string representing the timezone we want to set for returned Date Time Strings (and any
+	 *                         incoming timezone data that gets saved).  Note this just sends the timezone info to the
+	 *                         date time model field objects.  Default is NULL (and will be assumed using the set
+	 *                         timezone in the 'timezone_string' wp option)
+	 * @return static (as in the concrete child class)
+	 */
+	public static function instance($timezone = null)
+	{
+		// check if instance of Espresso_model already exists
+		if ( ! static::$_instance instanceof static) {
+			// instantiate Espresso_model
+			static::$_instance = new static($timezone);
+		}
+		//we might have a timezone set, let set_timezone decide what to do with it
+		static::$_instance->set_timezone($timezone);
+		// Espresso_model object
+		return static::$_instance;
+	}
+
+
+
+	/**
+	 * resets the model and returns it
+	 *
+	 * @param null | string $timezone
+	 * @return EEM_Base|null (if the model was already instantiated, returns it, with
+	 * all its properties reset; if it wasn't instantiated, returns null)
+	 */
+	public static function reset($timezone = null)
+	{
+		if (static::$_instance instanceof EEM_Base) {
+			//let's try to NOT swap out the current instance for a new one
+			//because if someone has a reference to it, we can't remove their reference
+			//so it's best to keep using the same reference, but change the original object
+			//reset all its properties to their original values as defined in the class
+			$r = new ReflectionClass(get_class(static::$_instance));
+			$static_properties = $r->getStaticProperties();
+			foreach ($r->getDefaultProperties() as $property => $value) {
+				//don't set instance to null like it was originally,
+				//but it's static anyways, and we're ignoring static properties (for now at least)
+				if ( ! isset($static_properties[$property])) {
+					static::$_instance->{$property} = $value;
+				}
+			}
+			//and then directly call its constructor again, like we would if we
+			//were creating a new one
+			static::$_instance->__construct($timezone);
+			return self::instance();
+		}
+		return null;
+	}
+
+
+
+	/**
+	 * retrieve the status details from esp_status table as an array IF this model has the status table as a relation.
+	 *
+	 * @param  boolean $translated return localized strings or JUST the array.
+	 * @return array
+	 * @throws \EE_Error
+	 */
+	public function status_array($translated = false)
+	{
+		if ( ! array_key_exists('Status', $this->_model_relations)) {
+			return array();
+		}
+		$model_name = $this->get_this_model_name();
+		$status_type = str_replace(' ', '_', strtolower(str_replace('_', ' ', $model_name)));
+		$stati = EEM_Status::instance()->get_all(array(array('STS_type' => $status_type)));
+		$status_array = array();
+		foreach ($stati as $status) {
+			$status_array[$status->ID()] = $status->get('STS_code');
+		}
+		return $translated
+			? EEM_Status::instance()->localized_status($status_array, false, 'sentence')
+			: $status_array;
+	}
+
+
+
+	/**
+	 * Gets all the EE_Base_Class objects which match the $query_params, by querying the DB.
+	 *
+	 * @param array $query_params             {
+	 * @var array $0 (where) array {
+	 *                                        eg: array('QST_display_text'=>'Are you bob?','QST_admin_text'=>'Determine
+	 *                                        if user is bob') becomes SQL >> "...WHERE QST_display_text = 'Are you
+	 *                                        bob?' AND QST_admin_text = 'Determine if user is bob'...") To add WHERE
+	 *                                        conditions based on related models (and even
+	 *                                        models-related-to-related-models) prepend the model's name onto the field
+	 *                                        name. Eg,
+	 *                                        EEM_Event::instance()->get_all(array(array('Venue.VNU_ID'=>12))); becomes
+	 *                                        SQL >> "SELECT * FROM wp_posts AS Event_CPT LEFT JOIN wp_esp_event_meta
+	 *                                        AS Event_Meta ON Event_CPT.ID = Event_Meta.EVT_ID LEFT JOIN
+	 *                                        wp_esp_event_venue AS Event_Venue ON Event_Venue.EVT_ID=Event_CPT.ID LEFT
+	 *                                        JOIN wp_posts AS Venue_CPT ON Venue_CPT.ID=Event_Venue.VNU_ID LEFT JOIN wp_esp_venue_meta AS Venue_Meta ON Venue_CPT.ID = Venue_Meta.VNU_ID WHERE Venue_CPT.ID = 12 Notice that automatically
+	 *                                        took care of joining Events to Venues (even when each of those models actually consisted of two tables). Also, you may chain the model relations together. Eg instead of just having
+	 *                                        "Venue.VNU_ID", you could have
+	 *                                        "Registration.Attendee.ATT_ID" as a field on a query for events (because
+	 *                                        events are related to Registrations, which are related to Attendees). You
+	 *                                        can take it even further with
+	 *                                        "Registration.Transaction.Payment.PAY_amount" etc. To change the operator
+	 *                                        (from the default of '='), change the value to an numerically-indexed
+	 *                                        array, where the first item in the list is the operator. eg: array(
+	 *                                        'QST_display_text' => array('LIKE','%bob%'), 'QST_ID' => array('<',34),
+	 *                                        'QST_wp_user' => array('in',array(1,2,7,23))) becomes SQL >> "...WHERE
+	 *                                        QST_display_text LIKE '%bob%' AND QST_ID < 34 AND QST_wp_user IN
+	 *                                        (1,2,7,23)...". Valid operators so far: =, !=, <, <=, >, >=, LIKE, NOT
+	 *                                        LIKE, IN (followed by numeric-indexed array), NOT IN (dido), BETWEEN (followed by an array with exactly 2 date strings), IS NULL, and IS NOT NULL Values can be a string, int, or float. They can
+	 *                                        also be arrays IFF the operator is IN. Also, values can actually be field names. To indicate the value is a field, simply provide a third array item (true) to the operator-value array like so:
+	 *                                        eg: array( 'DTT_reg_limit' => array('>', 'DTT_sold', TRUE) ) becomes SQL >> "...WHERE DTT_reg_limit > DTT_sold" Note: you can also use related model field names like you would any other field
+	 *                                        name. eg: array('Datetime.DTT_reg_limit'=>array('=','Datetime.DTT_sold',TRUE) could be used if you were querying EEM_Tickets (because Datetime is directly related to tickets) Also, by default
+	 *                                        all the where conditions are AND'd together. To override this, add an array key 'OR' (or 'AND') and the array to be OR'd together eg: array('OR'=>array('TXN_ID' => 23 , 'TXN_timestamp__>' =>
+	 *                                        345678912)) becomes SQL >> "...WHERE TXN_ID = 23 OR TXN_timestamp = 345678912...". Also, to negate an entire set of conditions, use 'NOT' as an array key. eg: array('NOT'=>array('TXN_total' =>
+	 *                                        50, 'TXN_paid'=>23) becomes SQL >> "...where ! (TXN_total =50 AND TXN_paid =23) Note: the 'glue' used to join each condition will continue to be what you last specified. IE, "AND"s by default,
+	 *                                        but if you had previously specified to use ORs to join, ORs will continue to be used. So, if you specify to use an "OR" to join conditions, it will continue to "stick" until you specify an AND.
+	 *                                        eg array('OR'=>array('NOT'=>array('TXN_total' => 50, 'TXN_paid'=>23)),AND=>array('TXN_ID'=>1,'STS_ID'=>'TIN') becomes SQL >> "...where ! (TXN_total =50 OR TXN_paid =23) AND TXN_ID=1 AND
+	 *                                        STS_ID='TIN'" They can be nested indefinitely. eg: array('OR'=>array('TXN_total' => 23, 'NOT'=> array( 'TXN_timestamp'=> 345678912, 'AND'=>array('TXN_paid' => 53, 'STS_ID' => 'TIN')))) becomes
+	 *                                        SQL >> "...WHERE TXN_total = 23 OR ! (TXN_timestamp = 345678912 OR (TXN_paid = 53 AND STS_ID = 'TIN'))..." GOTCHA: because this is an array, array keys must be unique, making it impossible to
+	 *                                        place two or more where conditions applying to the same field. eg:
+	 *                                        array('PAY_timestamp'=>array('>',$start_date),'PAY_timestamp'=>array('<',$end_date),'PAY_timestamp'=>array('!=',$special_date)), as PHP enforces that the array keys must be unique, thus
+	 *                                        removing the first two array entries with key 'PAY_timestamp'. becomes SQL >> "PAY_timestamp !=  4234232", ignoring the first two PAY_timestamp conditions). To overcome this, you can add a '*'
+	 *                                        character to the end of the field's name, followed by anything. These will be removed when generating the SQL string, but allow for the array keys to be unique. eg: you could rewrite the
+	 *                                        previous query as: array('PAY_timestamp'=>array('>',$start_date),'PAY_timestamp*1st'=>array('<',$end_date),'PAY_timestamp*2nd'=>array('!=',$special_date)) which correctly becomes SQL >>
+	 *                                        "PAY_timestamp > 123412341 AND PAY_timestamp < 2354235235234 AND PAY_timestamp != 1241234123" This can be applied to condition operators too, eg:
+	 *                                        array('OR'=>array('REG_ID'=>3,'Transaction.TXN_ID'=>23),'OR*whatever'=>array('Attendee.ATT_fname'=>'bob','Attendee.ATT_lname'=>'wilson')));
+	 * @var mixed   $limit                    int|array    adds a limit to the query just like the SQL limit clause, so
+	 *                                        limits of "23", "25,50", and array(23,42) are all valid would become SQL "...LIMIT 23", "...LIMIT 25,50",
+	 *                                        and "...LIMIT 23,42" respectively. Remember when you provide two numbers for the limit, the 1st number is
+	 *                                        the OFFSET, the 2nd is the LIMIT
+	 * @var array   $on_join_limit            allows the setting of a special select join with a internal limit so you
+	 *                                        can do paging on one-to-many multi-table-joins. Send an array in the following format array('on_join_limit'
+	 *                                        => array( 'table_alias', array(1,2) ) ).
+	 * @var mixed   $order_by                 name of a column to order by, or an array where keys are field names and
+	 *                                        values are either 'ASC' or 'DESC'. 'limit'=>array('STS_ID'=>'ASC','REG_date'=>'DESC'), which would becomes
+	 *                                        SQL "...ORDER BY TXN_timestamp..." and "...ORDER BY STS_ID ASC, REG_date DESC..." respectively. Like the
+	 *                                        'where' conditions, these fields can be on related models. Eg
+	 *                                        'order_by'=>array('Registration.Transaction.TXN_amount'=>'ASC') is perfectly valid from any model related
+	 *                                        to 'Registration' (like Event, Attendee, Price, Datetime, etc.)
+	 * @var string  $order                    If 'order_by' is used and its value is a string (NOT an array), then
+	 *                                        'order' specifies whether to order the field specified in 'order_by' in ascending or descending order.
+	 *                                        Acceptable values are 'ASC' or 'DESC'. If, 'order_by' isn't used, but 'order' is, then it is assumed you
+	 *                                        want to order by the primary key. Eg,
+	 *                                        EEM_Event::instance()->get_all(array('order_by'=>'Datetime.DTT_EVT_start','order'=>'ASC'); //(will join
+	 *                                        with the Datetime model's table(s) and order by its field DTT_EVT_start) or
+	 *                                        EEM_Registration::instance()->get_all(array('order'=>'ASC'));//will make SQL "SELECT * FROM
+	 *                                        wp_esp_registration ORDER BY REG_ID ASC"
+	 * @var mixed   $group_by                 name of field to order by, or an array of fields. Eg either
+	 *                                        'group_by'=>'VNU_ID', or 'group_by'=>array('EVT_name','Registration.Transaction.TXN_total') Note: if no
+	 *                                        $group_by is specified, and a limit is set, automatically groups by the model's primary key (or combined
+	 *                                        primary keys). This avoids some weirdness that results when using limits, tons of joins, and no group by,
+	 *                                        see https://events.codebasehq.com/projects/event-espresso/tickets/9389
+	 * @var array   $having                   exactly like WHERE parameters array, except these conditions apply to the
+	 *                                        grouped results (whereas WHERE conditions apply to the pre-grouped results)
+	 * @var array   $force_join               forces a join with the models named. Should be a numerically-indexed
+	 *                                        array where values are models to be joined in the query.Eg array('Attendee','Payment','Datetime'). You may
+	 *                                        join with transient models using period, eg "Registration.Transaction.Payment". You will probably only want
+	 *                                        to do this in hopes of increasing efficiency, as related models which belongs to the current model
+	 *                                        (ie, the current model has a foreign key to them, like how Registration
+	 *                                        belongs to Attendee) can be cached in order to avoid future queries
+	 * @var string  $default_where_conditions can be set to 'none', 'this_model_only', 'other_models_only', or 'all'.
+	 *                                        set this to 'none' to disable all default where conditions. Eg, usually soft-deleted objects are
+	 *                                        filtered-out if you want to include them, set this query param to 'none'. If you want to ONLY disable THIS
+	 *                                        model's default where conditions set it to 'other_models_only'. If you only want this model's default where
+	 *                                        conditions added to the query, use 'this_model_only'. If you want to use all default where conditions
+	 *                                        (default), set to 'all'.
+	 * @var string  $caps                     controls what capability requirements to apply to the query; ie, should
+	 *                                        we just NOT apply any capabilities/permissions/restrictions and return everything? Or should we only show
+	 *                                        the current user items they should be able to view on the frontend, backend, edit, or delete? can be set to
+	 *                                        'none' (default), 'read_frontend', 'read_backend', 'edit' or 'delete'
+	 *                                        }
+	 * @return EE_Base_Class[]  *note that there is NO option to pass the output type. If you want results different
+	 *                                        from EE_Base_Class[], use _get_all_wpdb_results()and make it public again. Array keys
+	 *                                        are object IDs (if there is a primary key on the model. if not, numerically indexed)
+	 *                                        Some full examples: get 10 transactions which have Scottish attendees:
+	 *                                        EEM_Transaction::instance()->get_all( array( array(
+	 *                                        'OR'=>array(
+	 *                                        'Registration.Attendee.ATT_fname'=>array('like','Mc%'),
+	 *                                        'Registration.Attendee.ATT_fname*other'=>array('like','Mac%')
+	 *                                        )
+	 *                                        ),
+	 *                                        'limit'=>10,
+	 *                                        'group_by'=>'TXN_ID'
+	 *                                        ));
+	 *                                        get all the answers to the question titled "shirt size" for event with id
+	 *                                        12, ordered by their answer EEM_Answer::instance()->get_all(array( array(
+	 *                                        'Question.QST_display_text'=>'shirt size',
+	 *                                        'Registration.Event.EVT_ID'=>12
+	 *                                        ),
+	 *                                        'order_by'=>array('ANS_value'=>'ASC')
+	 *                                        ));
+	 * @throws \EE_Error
+	 */
+	public function get_all($query_params = array())
+	{
+		if (isset($query_params['limit'])
+			&& ! isset($query_params['group_by'])
+		) {
+			$query_params['group_by'] = array_keys($this->get_combined_primary_key_fields());
+		}
+		return $this->_create_objects($this->_get_all_wpdb_results($query_params, ARRAY_A, null));
+	}
+
+
+
+	/**
+	 * Modifies the query parameters so we only get back model objects
+	 * that "belong" to the current user
+	 *
+	 * @param array $query_params @see EEM_Base::get_all()
+	 * @return array like EEM_Base::get_all
+	 */
+	public function alter_query_params_to_only_include_mine($query_params = array())
+	{
+		$wp_user_field_name = $this->wp_user_field_name();
+		if ($wp_user_field_name) {
+			$query_params[0][$wp_user_field_name] = get_current_user_id();
+		}
+		return $query_params;
+	}
+
+
+
+	/**
+	 * Returns the name of the field's name that points to the WP_User table
+	 *  on this model (or follows the _model_chain_to_wp_user and uses that model's
+	 * foreign key to the WP_User table)
+	 *
+	 * @return string|boolean string on success, boolean false when there is no
+	 * foreign key to the WP_User table
+	 */
+	public function wp_user_field_name()
+	{
+		try {
+			if ( ! empty($this->_model_chain_to_wp_user)) {
+				$models_to_follow_to_wp_users = explode('.', $this->_model_chain_to_wp_user);
+				$last_model_name = end($models_to_follow_to_wp_users);
+				$model_with_fk_to_wp_users = EE_Registry::instance()->load_model($last_model_name);
+				$model_chain_to_wp_user = $this->_model_chain_to_wp_user . '.';
+			} else {
+				$model_with_fk_to_wp_users = $this;
+				$model_chain_to_wp_user = '';
+			}
+			$wp_user_field = $model_with_fk_to_wp_users->get_foreign_key_to('WP_User');
+			return $model_chain_to_wp_user . $wp_user_field->get_name();
+		} catch (EE_Error $e) {
+			return false;
+		}
+	}
+
+
+
+	/**
+	 * Returns the _model_chain_to_wp_user string, which indicates which related model
+	 * (or transiently-related model) has a foreign key to the wp_users table;
+	 * useful for finding if model objects of this type are 'owned' by the current user.
+	 * This is an empty string when the foreign key is on this model and when it isn't,
+	 * but is only non-empty when this model's ownership is indicated by a RELATED model
+	 * (or transiently-related model)
+	 *
+	 * @return string
+	 */
+	public function model_chain_to_wp_user()
+	{
+		return $this->_model_chain_to_wp_user;
+	}
+
+
+
+	/**
+	 * Whether this model is 'owned' by a specific wordpress user (even indirectly,
+	 * like how registrations don't have a foreign key to wp_users, but the
+	 * events they are for are), or is unrelated to wp users.
+	 * generally available
+	 *
+	 * @return boolean
+	 */
+	public function is_owned()
+	{
+		if ($this->model_chain_to_wp_user()) {
+			return true;
+		} else {
+			try {
+				$this->get_foreign_key_to('WP_User');
+				return true;
+			} catch (EE_Error $e) {
+				return false;
+			}
+		}
+	}
+
+
+
+	/**
+	 * Used internally to get WPDB results, because other functions, besides get_all, may want to do some queries, but
+	 * may want to preserve the WPDB results (eg, update, which first queries to make sure we have all the tables on
+	 * the model)
+	 *
+	 * @param array  $query_params      like EEM_Base::get_all's $query_params
+	 * @param string $output            ARRAY_A, OBJECT_K, etc. Just like
+	 * @param mixed  $columns_to_select , What columns to select. By default, we select all columns specified by the
+	 *                                  fields on the model, and the models we joined to in the query. However, you can
+	 *                                  override this and set the select to "*", or a specific column name, like
+	 *                                  "ATT_ID", etc. If you would like to use these custom selections in WHERE,
+	 *                                  GROUP_BY, or HAVING clauses, you must instead provide an array. Array keys are
+	 *                                  the aliases used to refer to this selection, and values are to be
+	 *                                  numerically-indexed arrays, where 0 is the selection and 1 is the data type.
+	 *                                  Eg, array('count'=>array('COUNT(REG_ID)','%d'))
+	 * @return array | stdClass[] like results of $wpdb->get_results($sql,OBJECT), (ie, output type is OBJECT)
+	 * @throws \EE_Error
+	 */
+	protected function _get_all_wpdb_results($query_params = array(), $output = ARRAY_A, $columns_to_select = null)
+	{
+		// remember the custom selections, if any, and type cast as array
+		// (unless $columns_to_select is an object, then just set as an empty array)
+		// Note: (array) 'some string' === array( 'some string' )
+		$this->_custom_selections = ! is_object($columns_to_select) ? (array)$columns_to_select : array();
+		$model_query_info = $this->_create_model_query_info_carrier($query_params);
+		$select_expressions = $columns_to_select !== null
+			? $this->_construct_select_from_input($columns_to_select)
+			: $this->_construct_default_select_sql($model_query_info);
+		$SQL = "SELECT $select_expressions " . $this->_construct_2nd_half_of_select_query($model_query_info);
+		return $this->_do_wpdb_query('get_results', array($SQL, $output));
+	}
+
+
+
+	/**
+	 * Gets an array of rows from the database just like $wpdb->get_results would,
+	 * but you can use the $query_params like on EEM_Base::get_all() to more easily
+	 * take care of joins, field preparation etc.
+	 *
+	 * @param array  $query_params      like EEM_Base::get_all's $query_params
+	 * @param string $output            ARRAY_A, OBJECT_K, etc. Just like
+	 * @param mixed  $columns_to_select , What columns to select. By default, we select all columns specified by the
+	 *                                  fields on the model, and the models we joined to in the query. However, you can
+	 *                                  override this and set the select to "*", or a specific column name, like
+	 *                                  "ATT_ID", etc. If you would like to use these custom selections in WHERE,
+	 *                                  GROUP_BY, or HAVING clauses, you must instead provide an array. Array keys are
+	 *                                  the aliases used to refer to this selection, and values are to be
+	 *                                  numerically-indexed arrays, where 0 is the selection and 1 is the data type.
+	 *                                  Eg, array('count'=>array('COUNT(REG_ID)','%d'))
+	 * @return array|stdClass[] like results of $wpdb->get_results($sql,OBJECT), (ie, output type is OBJECT)
+	 * @throws \EE_Error
+	 */
+	public function get_all_wpdb_results($query_params = array(), $output = ARRAY_A, $columns_to_select = null)
+	{
+		return $this->_get_all_wpdb_results($query_params, $output, $columns_to_select);
+	}
+
+
+
+	/**
+	 * For creating a custom select statement
+	 *
+	 * @param mixed $columns_to_select either a string to be inserted directly as the select statement,
+	 *                                 or an array where keys are aliases, and values are arrays where 0=>the selection
+	 *                                 SQL, and 1=>is the datatype
+	 * @throws EE_Error
+	 * @return string
+	 */
+	private function _construct_select_from_input($columns_to_select)
+	{
+		if (is_array($columns_to_select)) {
+			$select_sql_array = array();
+			foreach ($columns_to_select as $alias => $selection_and_datatype) {
+				if ( ! is_array($selection_and_datatype) || ! isset($selection_and_datatype[1])) {
+					throw new EE_Error(
+						sprintf(
+							__(
+								"Custom selection %s (alias %s) needs to be an array like array('COUNT(REG_ID)','%%d')",
+								"event_espresso"
+							),
+							$selection_and_datatype,
+							$alias
+						)
+					);
+				}
+				if ( ! in_array($selection_and_datatype[1], $this->_valid_wpdb_data_types)) {
+					throw new EE_Error(
+						sprintf(
+							__(
+								"Datatype %s (for selection '%s' and alias '%s') is not a valid wpdb datatype (eg %%s)",
+								"event_espresso"
+							),
+							$selection_and_datatype[1],
+							$selection_and_datatype[0],
+							$alias,
+							implode(",", $this->_valid_wpdb_data_types)
+						)
+					);
+				}
+				$select_sql_array[] = "{$selection_and_datatype[0]} AS $alias";
+			}
+			$columns_to_select_string = implode(", ", $select_sql_array);
+		} else {
+			$columns_to_select_string = $columns_to_select;
+		}
+		return $columns_to_select_string;
+	}
+
+
+
+	/**
+	 * Convenient wrapper for getting the primary key field's name. Eg, on Registration, this would be 'REG_ID'
+	 *
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function primary_key_name()
+	{
+		return $this->get_primary_key_field()->get_name();
+	}
+
+
+
+	/**
+	 * Gets a single item for this model from the DB, given only its ID (or null if none is found).
+	 * If there is no primary key on this model, $id is treated as primary key string
+	 *
+	 * @param mixed $id int or string, depending on the type of the model's primary key
+	 * @return EE_Base_Class
+	 */
+	public function get_one_by_ID($id)
+	{
+		if ($this->get_from_entity_map($id)) {
+			return $this->get_from_entity_map($id);
+		}
+		return $this->get_one(
+			$this->alter_query_params_to_restrict_by_ID(
+				$id,
+				array('default_where_conditions' => 'minimum')
+			)
+		);
+	}
+
+
+
+	/**
+	 * Alters query parameters to only get items with this ID are returned.
+	 * Takes into account that the ID might be a string produced by EEM_Base::get_index_primary_key_string(),
+	 * or could just be a simple primary key ID
+	 *
+	 * @param int   $id
+	 * @param array $query_params
+	 * @return array of normal query params, @see EEM_Base::get_all
+	 * @throws \EE_Error
+	 */
+	public function alter_query_params_to_restrict_by_ID($id, $query_params = array())
+	{
+		if ( ! isset($query_params[0])) {
+			$query_params[0] = array();
+		}
+		$conditions_from_id = $this->parse_index_primary_key_string($id);
+		if ($conditions_from_id === null) {
+			$query_params[0][$this->primary_key_name()] = $id;
+		} else {
+			//no primary key, so the $id must be from the get_index_primary_key_string()
+			$query_params[0] = array_replace_recursive($query_params[0], $this->parse_index_primary_key_string($id));
+		}
+		return $query_params;
+	}
+
+
+
+	/**
+	 * Gets a single item for this model from the DB, given the $query_params. Only returns a single class, not an
+	 * array. If no item is found, null is returned.
+	 *
+	 * @param array $query_params like EEM_Base's $query_params variable.
+	 * @return EE_Base_Class|EE_Soft_Delete_Base_Class|NULL
+	 * @throws \EE_Error
+	 */
+	public function get_one($query_params = array())
+	{
+		if ( ! is_array($query_params)) {
+			EE_Error::doing_it_wrong('EEM_Base::get_one',
+				sprintf(__('$query_params should be an array, you passed a variable of type %s', 'event_espresso'),
+					gettype($query_params)), '4.6.0');
+			$query_params = array();
+		}
+		$query_params['limit'] = 1;
+		$items = $this->get_all($query_params);
+		if (empty($items)) {
+			return null;
+		} else {
+			return array_shift($items);
+		}
+	}
+
+
+
+	/**
+	 * Returns the next x number of items in sequence from the given value as
+	 * found in the database matching the given query conditions.
+	 *
+	 * @param mixed $current_field_value    Value used for the reference point.
+	 * @param null  $field_to_order_by      What field is used for the
+	 *                                      reference point.
+	 * @param int   $limit                  How many to return.
+	 * @param array $query_params           Extra conditions on the query.
+	 * @param null  $columns_to_select      If left null, then an array of
+	 *                                      EE_Base_Class objects is returned,
+	 *                                      otherwise you can indicate just the
+	 *                                      columns you want returned.
+	 * @return EE_Base_Class[]|array
+	 * @throws \EE_Error
+	 */
+	public function next_x(
+		$current_field_value,
+		$field_to_order_by = null,
+		$limit = 1,
+		$query_params = array(),
+		$columns_to_select = null
+	) {
+		return $this->_get_consecutive($current_field_value, '>', $field_to_order_by, $limit, $query_params,
+			$columns_to_select);
+	}
+
+
+
+	/**
+	 * Returns the previous x number of items in sequence from the given value
+	 * as found in the database matching the given query conditions.
+	 *
+	 * @param mixed $current_field_value    Value used for the reference point.
+	 * @param null  $field_to_order_by      What field is used for the
+	 *                                      reference point.
+	 * @param int   $limit                  How many to return.
+	 * @param array $query_params           Extra conditions on the query.
+	 * @param null  $columns_to_select      If left null, then an array of
+	 *                                      EE_Base_Class objects is returned,
+	 *                                      otherwise you can indicate just the
+	 *                                      columns you want returned.
+	 * @return EE_Base_Class[]|array
+	 * @throws \EE_Error
+	 */
+	public function previous_x(
+		$current_field_value,
+		$field_to_order_by = null,
+		$limit = 1,
+		$query_params = array(),
+		$columns_to_select = null
+	) {
+		return $this->_get_consecutive($current_field_value, '<', $field_to_order_by, $limit, $query_params,
+			$columns_to_select);
+	}
+
+
+
+	/**
+	 * Returns the next item in sequence from the given value as found in the
+	 * database matching the given query conditions.
+	 *
+	 * @param mixed $current_field_value    Value used for the reference point.
+	 * @param null  $field_to_order_by      What field is used for the
+	 *                                      reference point.
+	 * @param array $query_params           Extra conditions on the query.
+	 * @param null  $columns_to_select      If left null, then an EE_Base_Class
+	 *                                      object is returned, otherwise you
+	 *                                      can indicate just the columns you
+	 *                                      want and a single array indexed by
+	 *                                      the columns will be returned.
+	 * @return EE_Base_Class|null|array()
+	 * @throws \EE_Error
+	 */
+	public function next(
+		$current_field_value,
+		$field_to_order_by = null,
+		$query_params = array(),
+		$columns_to_select = null
+	) {
+		$results = $this->_get_consecutive($current_field_value, '>', $field_to_order_by, 1, $query_params,
+			$columns_to_select);
+		return empty($results) ? null : reset($results);
+	}
+
+
+
+	/**
+	 * Returns the previous item in sequence from the given value as found in
+	 * the database matching the given query conditions.
+	 *
+	 * @param mixed $current_field_value    Value used for the reference point.
+	 * @param null  $field_to_order_by      What field is used for the
+	 *                                      reference point.
+	 * @param array $query_params           Extra conditions on the query.
+	 * @param null  $columns_to_select      If left null, then an EE_Base_Class
+	 *                                      object is returned, otherwise you
+	 *                                      can indicate just the columns you
+	 *                                      want and a single array indexed by
+	 *                                      the columns will be returned.
+	 * @return EE_Base_Class|null|array()
+	 * @throws EE_Error
+	 */
+	public function previous(
+		$current_field_value,
+		$field_to_order_by = null,
+		$query_params = array(),
+		$columns_to_select = null
+	) {
+		$results = $this->_get_consecutive($current_field_value, '<', $field_to_order_by, 1, $query_params,
+			$columns_to_select);
+		return empty($results) ? null : reset($results);
+	}
+
+
+
+	/**
+	 * Returns the a consecutive number of items in sequence from the given
+	 * value as found in the database matching the given query conditions.
+	 *
+	 * @param mixed  $current_field_value   Value used for the reference point.
+	 * @param string $operand               What operand is used for the sequence.
+	 * @param string $field_to_order_by     What field is used for the reference point.
+	 * @param int    $limit                 How many to return.
+	 * @param array  $query_params          Extra conditions on the query.
+	 * @param null   $columns_to_select     If left null, then an array of EE_Base_Class objects is returned,
+	 *                                      otherwise you can indicate just the columns you want returned.
+	 * @return EE_Base_Class[]|array
+	 * @throws EE_Error
+	 */
+	protected function _get_consecutive(
+		$current_field_value,
+		$operand = '>',
+		$field_to_order_by = null,
+		$limit = 1,
+		$query_params = array(),
+		$columns_to_select = null
+	) {
+		//if $field_to_order_by is empty then let's assume we're ordering by the primary key.
+		if (empty($field_to_order_by)) {
+			if ($this->has_primary_key_field()) {
+				$field_to_order_by = $this->get_primary_key_field()->get_name();
+			} else {
+				if (WP_DEBUG) {
+					throw new EE_Error(__('EEM_Base::_get_consecutive() has been called with no $field_to_order_by argument and there is no primary key on the field.  Please provide the field you would like to use as the base for retrieving the next item(s).',
+						'event_espresso'));
+				}
+				EE_Error::add_error(__('There was an error with the query.', 'event_espresso'));
+				return array();
+			}
+		}
+		if ( ! is_array($query_params)) {
+			EE_Error::doing_it_wrong('EEM_Base::_get_consecutive',
+				sprintf(__('$query_params should be an array, you passed a variable of type %s', 'event_espresso'),
+					gettype($query_params)), '4.6.0');
+			$query_params = array();
+		}
+		//let's add the where query param for consecutive look up.
+		$query_params[0][$field_to_order_by] = array($operand, $current_field_value);
+		$query_params['limit'] = $limit;
+		//set direction
+		$incoming_orderby = isset($query_params['order_by']) ? (array)$query_params['order_by'] : array();
+		$query_params['order_by'] = $operand === '>'
+			? array($field_to_order_by => 'ASC') + $incoming_orderby
+			: array($field_to_order_by => 'DESC') + $incoming_orderby;
+		//if $columns_to_select is empty then that means we're returning EE_Base_Class objects
+		if (empty($columns_to_select)) {
+			return $this->get_all($query_params);
+		} else {
+			//getting just the fields
+			return $this->_get_all_wpdb_results($query_params, ARRAY_A, $columns_to_select);
+		}
+	}
+
+
+
+	/**
+	 * This sets the _timezone property after model object has been instantiated.
+	 *
+	 * @param null | string $timezone valid PHP DateTimeZone timezone string
+	 */
+	public function set_timezone($timezone)
+	{
+		if ($timezone !== null) {
+			$this->_timezone = $timezone;
+		}
+		//note we need to loop through relations and set the timezone on those objects as well.
+		foreach ($this->_model_relations as $relation) {
+			$relation->set_timezone($timezone);
+		}
+		//and finally we do the same for any datetime fields
+		foreach ($this->_fields as $field) {
+			if ($field instanceof EE_Datetime_Field) {
+				$field->set_timezone($timezone);
+			}
+		}
+	}
+
+
+
+	/**
+	 * This just returns whatever is set for the current timezone.
+	 *
+	 * @access public
+	 * @return string
+	 */
+	public function get_timezone()
+	{
+		//first validate if timezone is set.  If not, then let's set it be whatever is set on the model fields.
+		if (empty($this->_timezone)) {
+			foreach ($this->_fields as $field) {
+				if ($field instanceof EE_Datetime_Field) {
+					$this->set_timezone($field->get_timezone());
+					break;
+				}
+			}
+		}
+		//if timezone STILL empty then return the default timezone for the site.
+		if (empty($this->_timezone)) {
+			$this->set_timezone(EEH_DTT_Helper::get_timezone());
+		}
+		return $this->_timezone;
+	}
+
+
+
+	/**
+	 * This returns the date formats set for the given field name and also ensures that
+	 * $this->_timezone property is set correctly.
+	 *
+	 * @since 4.6.x
+	 * @param string $field_name The name of the field the formats are being retrieved for.
+	 * @param bool   $pretty     Whether to return the pretty formats (true) or not (false).
+	 * @throws EE_Error   If the given field_name is not of the EE_Datetime_Field type.
+	 * @return array formats in an array with the date format first, and the time format last.
+	 */
+	public function get_formats_for($field_name, $pretty = false)
+	{
+		$field_settings = $this->field_settings_for($field_name);
+		//if not a valid EE_Datetime_Field then throw error
+		if ( ! $field_settings instanceof EE_Datetime_Field) {
+			throw new EE_Error(sprintf(__('The field sent into EEM_Base::get_formats_for (%s) is not registered as a EE_Datetime_Field. Please check the spelling and make sure you are submitting the right field name to retrieve date_formats for.',
+				'event_espresso'), $field_name));
+		}
+		//while we are here, let's make sure the timezone internally in EEM_Base matches what is stored on
+		//the field.
+		$this->_timezone = $field_settings->get_timezone();
+		return array($field_settings->get_date_format($pretty), $field_settings->get_time_format($pretty));
+	}
+
+
+
+	/**
+	 * This returns the current time in a format setup for a query on this model.
+	 * Usage of this method makes it easier to setup queries against EE_Datetime_Field columns because
+	 * it will return:
+	 *  - a formatted string in the timezone and format currently set on the EE_Datetime_Field for the given field for
+	 *  NOW
+	 *  - or a unix timestamp (equivalent to time())
+	 *
+	 * @since 4.6.x
+	 * @param string $field_name       The field the current time is needed for.
+	 * @param bool   $timestamp        True means to return a unix timestamp. Otherwise a
+	 *                                 formatted string matching the set format for the field in the set timezone will
+	 *                                 be returned.
+	 * @param string $what             Whether to return the string in just the time format, the date format, or both.
+	 * @throws EE_Error    If the given field_name is not of the EE_Datetime_Field type.
+	 * @return int|string  If the given field_name is not of the EE_Datetime_Field type, then an EE_Error
+	 *                                 exception is triggered.
+	 */
+	public function current_time_for_query($field_name, $timestamp = false, $what = 'both')
+	{
+		$formats = $this->get_formats_for($field_name);
+		$DateTime = new DateTime("now", new DateTimeZone($this->_timezone));
+		if ($timestamp) {
+			return $DateTime->format('U');
+		}
+		//not returning timestamp, so return formatted string in timezone.
+		switch ($what) {
+			case 'time' :
+				return $DateTime->format($formats[1]);
+				break;
+			case 'date' :
+				return $DateTime->format($formats[0]);
+				break;
+			default :
+				return $DateTime->format(implode(' ', $formats));
+				break;
+		}
+	}
+
+
+
+	/**
+	 * This receives a time string for a given field and ensures that it is setup to match what the internal settings
+	 * for the model are.  Returns a DateTime object.
+	 * Note: a gotcha for when you send in unix timestamp.  Remember a unix timestamp is already timezone agnostic,
+	 * (functionally the equivalent of UTC+0).  So when you send it in, whatever timezone string you include is
+	 * ignored.
+	 *
+	 * @param string $field_name      The field being setup.
+	 * @param string $timestring      The date time string being used.
+	 * @param string $incoming_format The format for the time string.
+	 * @param string $timezone        By default, it is assumed the incoming time string is in timezone for
+	 *                                the blog.  If this is not the case, then it can be specified here.  If incoming
+	 *                                format is
+	 *                                'U', this is ignored.
+	 * @return DateTime
+	 * @throws \EE_Error
+	 */
+	public function convert_datetime_for_query($field_name, $timestring, $incoming_format, $timezone = '')
+	{
+		//just using this to ensure the timezone is set correctly internally
+		$this->get_formats_for($field_name);
+		//load EEH_DTT_Helper
+		$set_timezone = empty($timezone) ? EEH_DTT_Helper::get_timezone() : $timezone;
+		$incomingDateTime = date_create_from_format($incoming_format, $timestring, new DateTimeZone($set_timezone));
+		return $incomingDateTime->setTimezone(new DateTimeZone($this->_timezone));
+	}
+
+
+
+	/**
+	 * Gets all the tables comprising this model. Array keys are the table aliases, and values are EE_Table objects
+	 *
+	 * @return EE_Table_Base[]
+	 */
+	public function get_tables()
+	{
+		return $this->_tables;
+	}
+
+
+
+	/**
+	 * Updates all the database entries (in each table for this model) according to $fields_n_values and optionally
+	 * also updates all the model objects, where the criteria expressed in $query_params are met..
+	 * Also note: if this model has multiple tables, this update verifies all the secondary tables have an entry for
+	 * each row (in the primary table) we're trying to update; if not, it inserts an entry in the secondary table. Eg:
+	 * if our model has 2 tables: wp_posts (primary), and wp_esp_event (secondary). Let's say we are trying to update a
+	 * model object with EVT_ID = 1
+	 * (which means where wp_posts has ID = 1, because wp_posts.ID is the primary key's column), which exists, but
+	 * there is no entry in wp_esp_event for this entry in wp_posts. So, this update script will insert a row into
+	 * wp_esp_event, using any available parameters from $fields_n_values (eg, if "EVT_limit" => 40 is in
+	 * $fields_n_values, the new entry in wp_esp_event will set EVT_limit = 40, and use default for other columns which
+	 * are not specified)
+	 *
+	 * @param array   $fields_n_values         keys are model fields (exactly like keys in EEM_Base::_fields, NOT db
+	 *                                         columns!), values are strings, ints, floats, and maybe arrays if they
+	 *                                         are to be serialized. Basically, the values are what you'd expect to be
+	 *                                         values on the model, NOT necessarily what's in the DB. For example, if
+	 *                                         we wanted to update only the TXN_details on any Transactions where its
+	 *                                         ID=34, we'd use this method as follows:
+	 *                                         EEM_Transaction::instance()->update(
+	 *                                         array('TXN_details'=>array('detail1'=>'monkey','detail2'=>'banana'),
+	 *                                         array(array('TXN_ID'=>34)));
+	 * @param array   $query_params            very much like EEM_Base::get_all's $query_params
+	 *                                         in client code into what's expected to be stored on each field. Eg,
+	 *                                         consider updating Question's QST_admin_label field is of type
+	 *                                         Simple_HTML. If you use this function to update that field to $new_value
+	 *                                         = (note replace 8's with appropriate opening and closing tags in the
+	 *                                         following example)"8script8alert('I hack all');8/script88b8boom
+	 *                                         baby8/b8", then if you set $values_already_prepared_by_model_object to
+	 *                                         TRUE, it is assumed that you've already called
+	 *                                         EE_Simple_HTML_Field->prepare_for_set($new_value), which removes the
+	 *                                         malicious javascript. However, if
+	 *                                         $values_already_prepared_by_model_object is left as FALSE, then
+	 *                                         EE_Simple_HTML_Field->prepare_for_set($new_value) will be called on it, and every other field, before insertion. We provide this parameter because model objects perform their prepare_for_set
+	 *                                         function on all their values, and so don't need to be called again (and in many cases, shouldn't be called again. Eg: if we escape HTML characters in the prepare_for_set method...)
+	 * @param boolean $keep_model_objs_in_sync if TRUE, makes sure we ALSO update model objects
+	 *                                         in this model's entity map according to $fields_n_values that match
+	 *                                         $query_params. This obviously has some overhead, so you can disable it
+	 *                                         by setting this to FALSE, but be aware that model objects being used
+	 *                                         could get out-of-sync with the database
+	 * @return int how many rows got updated or FALSE if something went wrong with the query (wp returns FALSE or num
+	 *                                         rows affected which *could* include 0 which DOES NOT mean the query was bad)
+	 * @throws \EE_Error
+	 */
+	public function update($fields_n_values, $query_params, $keep_model_objs_in_sync = true)
+	{
+		if ( ! is_array($query_params)) {
+			EE_Error::doing_it_wrong('EEM_Base::update',
+				sprintf(__('$query_params should be an array, you passed a variable of type %s', 'event_espresso'),
+					gettype($query_params)), '4.6.0');
+			$query_params = array();
+		}
+		/**
+		 * Action called before a model update call has been made.
+		 *
+		 * @param EEM_Base $model
+		 * @param array    $fields_n_values the updated fields and their new values
+		 * @param array    $query_params    @see EEM_Base::get_all()
+		 */
+		do_action('AHEE__EEM_Base__update__begin', $this, $fields_n_values, $query_params);
+		/**
+		 * Filters the fields about to be updated given the query parameters. You can provide the
+		 * $query_params to $this->get_all() to find exactly which records will be updated
+		 *
+		 * @param array    $fields_n_values fields and their new values
+		 * @param EEM_Base $model           the model being queried
+		 * @param array    $query_params    see EEM_Base::get_all()
+		 */
+		$fields_n_values = (array)apply_filters('FHEE__EEM_Base__update__fields_n_values', $fields_n_values, $this,
+			$query_params);
+		//need to verify that, for any entry we want to update, there are entries in each secondary table.
+		//to do that, for each table, verify that it's PK isn't null.
+		$tables = $this->get_tables();
+		//and if the other tables don't have a row for each table-to-be-updated, we'll insert one with whatever values available in the current update query
+		//NOTE: we should make this code more efficient by NOT querying twice
+		//before the real update, but that needs to first go through ALPHA testing
+		//as it's dangerous. says Mike August 8 2014
+		//we want to make sure the default_where strategy is ignored
+		$this->_ignore_where_strategy = true;
+		$wpdb_select_results = $this->_get_all_wpdb_results($query_params);
+		foreach ($wpdb_select_results as $wpdb_result) {
+			// type cast stdClass as array
+			$wpdb_result = (array)$wpdb_result;
+			//get the model object's PK, as we'll want this if we need to insert a row into secondary tables
+			if ($this->has_primary_key_field()) {
+				$main_table_pk_value = $wpdb_result[$this->get_primary_key_field()->get_qualified_column()];
+			} else {
+				//if there's no primary key, we basically can't support having a 2nd table on the model (we could but it would be lots of work)
+				$main_table_pk_value = null;
+			}
+			//if there are more than 1 tables, we'll want to verify that each table for this model has an entry in the other tables
+			//and if the other tables don't have a row for each table-to-be-updated, we'll insert one with whatever values available in the current update query
+			if (count($tables) > 1) {
+				//foreach matching row in the DB, ensure that each table's PK isn't null. If so, there must not be an entry
+				//in that table, and so we'll want to insert one
+				foreach ($tables as $table_obj) {
+					$this_table_pk_column = $table_obj->get_fully_qualified_pk_column();
+					//if there is no private key for this table on the results, it means there's no entry
+					//in this table, right? so insert a row in the current table, using any fields available
+					if ( ! (array_key_exists($this_table_pk_column, $wpdb_result)
+							&& $wpdb_result[$this_table_pk_column])
+					) {
+						$success = $this->_insert_into_specific_table($table_obj, $fields_n_values,
+							$main_table_pk_value);
+						//if we died here, report the error
+						if ( ! $success) {
+							return false;
+						}
+					}
+				}
+			}
+			//				//and now check that if we have cached any models by that ID on the model, that
+			//				//they also get updated properly
+			//				$model_object = $this->get_from_entity_map( $main_table_pk_value );
+			//				if( $model_object ){
+			//					foreach( $fields_n_values as $field => $value ){
+			//						$model_object->set($field, $value);
+			//let's make sure default_where strategy is followed now
+			$this->_ignore_where_strategy = false;
+		}
+		//if we want to keep model objects in sync, AND
+		//if this wasn't called from a model object (to update itself)
+		//then we want to make sure we keep all the existing
+		//model objects in sync with the db
+		if ($keep_model_objs_in_sync && ! $this->_values_already_prepared_by_model_object) {
+			if ($this->has_primary_key_field()) {
+				$model_objs_affected_ids = $this->get_col($query_params);
+			} else {
+				//we need to select a bunch of columns and then combine them into the the "index primary key string"s
+				$models_affected_key_columns = $this->_get_all_wpdb_results($query_params, ARRAY_A);
+				$model_objs_affected_ids = array();
+				foreach ($models_affected_key_columns as $row) {
+					$combined_index_key = $this->get_index_primary_key_string($row);
+					$model_objs_affected_ids[$combined_index_key] = $combined_index_key;
+				}
+			}
+			if ( ! $model_objs_affected_ids) {
+				//wait wait wait- if nothing was affected let's stop here
+				return 0;
+			}
+			foreach ($model_objs_affected_ids as $id) {
+				$model_obj_in_entity_map = $this->get_from_entity_map($id);
+				if ($model_obj_in_entity_map) {
+					foreach ($fields_n_values as $field => $new_value) {
+						$model_obj_in_entity_map->set($field, $new_value);
+					}
+				}
+			}
+			//if there is a primary key on this model, we can now do a slight optimization
+			if ($this->has_primary_key_field()) {
+				//we already know what we want to update. So let's make the query simpler so it's a little more efficient
+				$query_params = array(
+					array($this->primary_key_name() => array('IN', $model_objs_affected_ids)),
+					'limit'                    => count($model_objs_affected_ids),
+					'default_where_conditions' => 'none',
+				);
+			}
+		}
+		$model_query_info = $this->_create_model_query_info_carrier($query_params);
+		$SQL = "UPDATE "
+			   . $model_query_info->get_full_join_sql()
+			   . " SET "
+			   . $this->_construct_update_sql($fields_n_values)
+			   . $model_query_info->get_where_sql();//note: doesn't use _construct_2nd_half_of_select_query() because doesn't accept LIMIT, ORDER BY, etc.
+		$rows_affected = $this->_do_wpdb_query('query', array($SQL));
+		/**
+		 * Action called after a model update call has been made.
+		 *
+		 * @param EEM_Base $model
+		 * @param array    $fields_n_values the updated fields and their new values
+		 * @param array    $query_params    @see EEM_Base::get_all()
+		 * @param int      $rows_affected
+		 */
+		do_action('AHEE__EEM_Base__update__end', $this, $fields_n_values, $query_params, $rows_affected);
+		return $rows_affected;//how many supposedly got updated
+	}
+
+
+
+	/**
+	 * Analogous to $wpdb->get_col, returns a 1-dimensional array where teh values
+	 * are teh values of the field specified (or by default the primary key field)
+	 * that matched the query params. Note that you should pass the name of the
+	 * model FIELD, not the database table's column name.
+	 *
+	 * @param array  $query_params @see EEM_Base::get_all()
+	 * @param string $field_to_select
+	 * @return array just like $wpdb->get_col()
+	 * @throws \EE_Error
+	 */
+	public function get_col($query_params = array(), $field_to_select = null)
+	{
+		if ($field_to_select) {
+			$field = $this->field_settings_for($field_to_select);
+		} elseif ($this->has_primary_key_field()) {
+			$field = $this->get_primary_key_field();
+		} else {
+			//no primary key, just grab the first column
+			$field = reset($this->field_settings());
+		}
+		$model_query_info = $this->_create_model_query_info_carrier($query_params);
+		$select_expressions = $field->get_qualified_column();
+		$SQL = "SELECT $select_expressions " . $this->_construct_2nd_half_of_select_query($model_query_info);
+		return $this->_do_wpdb_query('get_col', array($SQL));
+	}
+
+
+
+	/**
+	 * Returns a single column value for a single row from the database
+	 *
+	 * @param array  $query_params    @see EEM_Base::get_all()
+	 * @param string $field_to_select @see EEM_Base::get_col()
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function get_var($query_params = array(), $field_to_select = null)
+	{
+		$query_params['limit'] = 1;
+		$col = $this->get_col($query_params, $field_to_select);
+		if ( ! empty($col)) {
+			return reset($col);
+		} else {
+			return null;
+		}
+	}
+
+
+
+	/**
+	 * Makes the SQL for after "UPDATE table_X inner join table_Y..." and before "...WHERE". Eg "Question.name='party
+	 * time?', Question.desc='what do you think?',..." Values are filtered through wpdb->prepare to avoid against SQL
+	 * injection, but currently no further filtering is done
+	 *
+	 * @global      $wpdb
+	 * @param array $fields_n_values array keys are field names on this model, and values are what those fields should
+	 *                               be updated to in the DB
+	 * @return string of SQL
+	 * @throws \EE_Error
+	 */
+	public function _construct_update_sql($fields_n_values)
+	{
+		/** @type WPDB $wpdb */
+		global $wpdb;
+		$cols_n_values = array();
+		foreach ($fields_n_values as $field_name => $value) {
+			$field_obj = $this->field_settings_for($field_name);
+			//if the value is NULL, we want to assign the value to that.
+			//wpdb->prepare doesn't really handle that properly
+			$prepared_value = $this->_prepare_value_or_use_default($field_obj, $fields_n_values);
+			$value_sql = $prepared_value === null ? 'NULL'
+				: $wpdb->prepare($field_obj->get_wpdb_data_type(), $prepared_value);
+			$cols_n_values[] = $field_obj->get_qualified_column() . "=" . $value_sql;
+		}
+		return implode(",", $cols_n_values);
+	}
+
+
+
+	/**
+	 * Deletes a single row from the DB given the model object's primary key value. (eg, EE_Attendee->ID()'s value).
+	 * Performs a HARD delete, meaning the database row should always be removed,
+	 * not just have a flag field on it switched
+	 * Wrapper for EEM_Base::delete_permanently()
+	 *
+	 * @param mixed $id
+	 * @return boolean whether the row got deleted or not
+	 * @throws \EE_Error
+	 */
+	public function delete_permanently_by_ID($id)
+	{
+		return $this->delete_permanently(
+			array(
+				array($this->get_primary_key_field()->get_name() => $id),
+				'limit' => 1,
+			)
+		);
+	}
+
+
+
+	/**
+	 * Deletes a single row from the DB given the model object's primary key value. (eg, EE_Attendee->ID()'s value).
+	 * Wrapper for EEM_Base::delete()
+	 *
+	 * @param mixed $id
+	 * @return boolean whether the row got deleted or not
+	 * @throws \EE_Error
+	 */
+	public function delete_by_ID($id)
+	{
+		return $this->delete(
+			array(
+				array($this->get_primary_key_field()->get_name() => $id),
+				'limit' => 1,
+			)
+		);
+	}
+
+
+
+	/**
+	 * Identical to delete_permanently, but does a "soft" delete if possible,
+	 * meaning if the model has a field that indicates its been "trashed" or
+	 * "soft deleted", we will just set that instead of actually deleting the rows.
+	 *
+	 * @see EEM_Base::delete_permanently
+	 * @param array   $query_params
+	 * @param boolean $allow_blocking
+	 * @return int how many rows got deleted
+	 * @throws \EE_Error
+	 */
+	public function delete($query_params, $allow_blocking = true)
+	{
+		return $this->delete_permanently($query_params, $allow_blocking);
+	}
+
+
+
+	/**
+	 * Deletes the model objects that meet the query params. Note: this method is overridden
+	 * in EEM_Soft_Delete_Base so that soft-deleted model objects are instead only flagged
+	 * as archived, not actually deleted
+	 *
+	 * @param array   $query_params   very much like EEM_Base::get_all's $query_params
+	 * @param boolean $allow_blocking if TRUE, matched objects will only be deleted if there is no related model info
+	 *                                that blocks it (ie, there' sno other data that depends on this data); if false,
+	 *                                deletes regardless of other objects which may depend on it. Its generally
+	 *                                advisable to always leave this as TRUE, otherwise you could easily corrupt your
+	 *                                DB
+	 * @return int how many rows got deleted
+	 * @throws \EE_Error
+	 */
+	public function delete_permanently($query_params, $allow_blocking = true)
+	{
+		/**
+		 * Action called just before performing a real deletion query. You can use the
+		 * model and its $query_params to find exactly which items will be deleted
+		 *
+		 * @param EEM_Base $model
+		 * @param array    $query_params   @see EEM_Base::get_all()
+		 * @param boolean  $allow_blocking whether or not to allow related model objects
+		 *                                 to block (prevent) this deletion
+		 */
+		do_action('AHEE__EEM_Base__delete__begin', $this, $query_params, $allow_blocking);
+		//some MySQL databases may be running safe mode, which may restrict
+		//deletion if there is no KEY column used in the WHERE statement of a deletion.
+		//to get around this, we first do a SELECT, get all the IDs, and then run another query
+		//to delete them
+		$items_for_deletion = $this->_get_all_wpdb_results($query_params);
+		$deletion_where = $this->_setup_ids_for_delete($items_for_deletion, $allow_blocking);
+		if ($deletion_where) {
+			//echo "objects for deletion:";var_dump($objects_for_deletion);
+			$model_query_info = $this->_create_model_query_info_carrier($query_params);
+			$table_aliases = array_keys($this->_tables);
+			$SQL = "DELETE "
+				   . implode(", ", $table_aliases)
+				   . " FROM "
+				   . $model_query_info->get_full_join_sql()
+				   . " WHERE "
+				   . $deletion_where;
+			//		/echo "delete sql:$SQL";
+			$rows_deleted = $this->_do_wpdb_query('query', array($SQL));
+		} else {
+			$rows_deleted = 0;
+		}
+		//and lastly make sure those items are removed from the entity map; if they could be put into it at all
+		if ($this->has_primary_key_field()) {
+			foreach ($items_for_deletion as $item_for_deletion_row) {
+				$pk_value = $item_for_deletion_row[$this->get_primary_key_field()->get_qualified_column()];
+				if (isset($this->_entity_map[EEM_Base::$_model_query_blog_id][$pk_value])) {
+					unset($this->_entity_map[EEM_Base::$_model_query_blog_id][$pk_value]);
+				}
+			}
+		}
+		/**
+		 * Action called just after performing a real deletion query. Although at this point the
+		 * items should have been deleted
+		 *
+		 * @param EEM_Base $model
+		 * @param array    $query_params @see EEM_Base::get_all()
+		 * @param int      $rows_deleted
+		 */
+		do_action('AHEE__EEM_Base__delete__end', $this, $query_params, $rows_deleted);
+		return $rows_deleted;//how many supposedly got deleted
+	}
+
+
+
+	/**
+	 * Checks all the relations that throw error messages when there are blocking related objects
+	 * for related model objects. If there are any related model objects on those relations,
+	 * adds an EE_Error, and return true
+	 *
+	 * @param EE_Base_Class|int $this_model_obj_or_id
+	 * @param EE_Base_Class     $ignore_this_model_obj a model object like 'EE_Event', or 'EE_Term_Taxonomy', which
+	 *                                                 should be ignored when determining whether there are related
+	 *                                                 model objects which block this model object's deletion. Useful
+	 *                                                 if you know A is related to B and are considering deleting A,
+	 *                                                 but want to see if A has any other objects blocking its deletion
+	 *                                                 before removing the relation between A and B
+	 * @return boolean
+	 * @throws \EE_Error
+	 */
+	public function delete_is_blocked_by_related_models($this_model_obj_or_id, $ignore_this_model_obj = null)
+	{
+		//first, if $ignore_this_model_obj was supplied, get its model
+		if ($ignore_this_model_obj && $ignore_this_model_obj instanceof EE_Base_Class) {
+			$ignored_model = $ignore_this_model_obj->get_model();
+		} else {
+			$ignored_model = null;
+		}
+		//now check all the relations of $this_model_obj_or_id and see if there
+		//are any related model objects blocking it?
+		$is_blocked = false;
+		foreach ($this->_model_relations as $relation_name => $relation_obj) {
+			if ($relation_obj->block_delete_if_related_models_exist()) {
+				//if $ignore_this_model_obj was supplied, then for the query
+				//on that model needs to be told to ignore $ignore_this_model_obj
+				if ($ignored_model && $relation_name === $ignored_model->get_this_model_name()) {
+					$related_model_objects = $relation_obj->get_all_related($this_model_obj_or_id, array(
+						array(
+							$ignored_model->get_primary_key_field()->get_name() => array(
+								'!=',
+								$ignore_this_model_obj->ID(),
+							),
+						),
+					));
+				} else {
+					$related_model_objects = $relation_obj->get_all_related($this_model_obj_or_id);
+				}
+				if ($related_model_objects) {
+					EE_Error::add_error($relation_obj->get_deletion_error_message(), __FILE__, __FUNCTION__, __LINE__);
+					$is_blocked = true;
+				}
+			}
+		}
+		return $is_blocked;
+	}
+
+
+
+	/**
+	 * This sets up our delete where sql and accounts for if we have secondary tables that will have rows deleted as
+	 * well.
+	 *
+	 * @param  array  $objects_for_deletion This should be the values returned by $this->_get_all_wpdb_results()
+	 * @param boolean $allow_blocking       if TRUE, matched objects will only be deleted if there is no related model
+	 *                                      info that blocks it (ie, there' sno other data that depends on this data);
+	 *                                      if false, deletes regardless of other objects which may depend on it. Its
+	 *                                      generally advisable to always leave this as TRUE, otherwise you could
+	 *                                      easily corrupt your DB
+	 * @throws EE_Error
+	 * @return string    everything that comes after the WHERE statement.
+	 */
+	protected function _setup_ids_for_delete($objects_for_deletion, $allow_blocking = true)
+	{
+		if ($this->has_primary_key_field()) {
+			$primary_table = $this->_get_main_table();
+			$other_tables = $this->_get_other_tables();
+			$deletes = $query = array();
+			foreach ($objects_for_deletion as $delete_object) {
+				//before we mark this object for deletion,
+				//make sure there's no related objects blocking its deletion (if we're checking)
+				if (
+					$allow_blocking
+					&& $this->delete_is_blocked_by_related_models(
+						$delete_object[$primary_table->get_fully_qualified_pk_column()]
+					)
+				) {
+					continue;
+				}
+				//primary table deletes
+				if (isset($delete_object[$primary_table->get_fully_qualified_pk_column()])) {
+					$deletes[$primary_table->get_fully_qualified_pk_column()][] = $delete_object[$primary_table->get_fully_qualified_pk_column()];
+				}
+				//other tables
+				if ( ! empty($other_tables)) {
+					foreach ($other_tables as $ot) {
+						//first check if we've got the foreign key column here.
+						if (isset($delete_object[$ot->get_fully_qualified_fk_column()])) {
+							$deletes[$ot->get_fully_qualified_pk_column()][] = $delete_object[$ot->get_fully_qualified_fk_column()];
+						}
+						// wait! it's entirely possible that we'll have a the primary key
+						// for this table in here, if it's a foreign key for one of the other secondary tables
+						if (isset($delete_object[$ot->get_fully_qualified_pk_column()])) {
+							$deletes[$ot->get_fully_qualified_pk_column()][] = $delete_object[$ot->get_fully_qualified_pk_column()];
+						}
+						// finally, it is possible that the fk for this table is found
+						// in the fully qualified pk column for the fk table, so let's see if that's there!
+						if (isset($delete_object[$ot->get_fully_qualified_pk_on_fk_table()])) {
+							$deletes[$ot->get_fully_qualified_pk_column()][] = $delete_object[$ot->get_fully_qualified_pk_column()];
+						}
+					}
+				}
+			}
+			//we should have deletes now, so let's just go through and setup the where statement
+			foreach ($deletes as $column => $values) {
+				//make sure we have unique $values;
+				$values = array_unique($values);
+				$query[] = $column . ' IN(' . implode(",", $values) . ')';
+			}
+			return ! empty($query) ? implode(' AND ', $query) : '';
+		} elseif (count($this->get_combined_primary_key_fields()) > 1) {
+			$ways_to_identify_a_row = array();
+			$fields = $this->get_combined_primary_key_fields();
+			//note: because there' sno primary key, that means nothing else  can be pointing to this model, right?
+			foreach ($objects_for_deletion as $delete_object) {
+				$values_for_each_cpk_for_a_row = array();
+				foreach ($fields as $cpk_field) {
+					if ($cpk_field instanceof EE_Model_Field_Base) {
+						$values_for_each_cpk_for_a_row[] = $cpk_field->get_qualified_column()
+														   . "="
+														   . $delete_object[$cpk_field->get_qualified_column()];
+					}
+				}
+				$ways_to_identify_a_row[] = "(" . implode(" AND ", $values_for_each_cpk_for_a_row) . ")";
+			}
+			return implode(" OR ", $ways_to_identify_a_row);
+		} else {
+			//so there's no primary key and no combined key...
+			//sorry, can't help you
+			throw new EE_Error(sprintf(__("Cannot delete objects of type %s because there is no primary key NOR combined key",
+				"event_espresso"), get_class($this)));
+		}
+	}
+
+
+
+	/**
+	 * Count all the rows that match criteria expressed in $query_params (an array just like arg to EEM_Base::get_all).
+	 * If $field_to_count isn't provided, the model's primary key is used. Otherwise, we count by field_to_count's
+	 * column
+	 *
+	 * @param array  $query_params   like EEM_Base::get_all's
+	 * @param string $field_to_count field on model to count by (not column name)
+	 * @param bool   $distinct       if we want to only count the distinct values for the column then you can trigger
+	 *                               that by the setting $distinct to TRUE;
+	 * @return int
+	 * @throws \EE_Error
+	 */
+	public function count($query_params = array(), $field_to_count = null, $distinct = false)
+	{
+		$model_query_info = $this->_create_model_query_info_carrier($query_params);
+		if ($field_to_count) {
+			$field_obj = $this->field_settings_for($field_to_count);
+			$column_to_count = $field_obj->get_qualified_column();
+		} elseif ($this->has_primary_key_field()) {
+			$pk_field_obj = $this->get_primary_key_field();
+			$column_to_count = $pk_field_obj->get_qualified_column();
+		} else {
+			//there's no primary key
+			//if we're counting distinct items, and there's no primary key,
+			//we need to list out the columns for distinction;
+			//otherwise we can just use star
+			if ($distinct) {
+				$columns_to_use = array();
+				foreach ($this->get_combined_primary_key_fields() as $field_obj) {
+					$columns_to_use[] = $field_obj->get_qualified_column();
+				}
+				$column_to_count = implode(',', $columns_to_use);
+			} else {
+				$column_to_count = '*';
+			}
+		}
+		$column_to_count = $distinct ? "DISTINCT " . $column_to_count : $column_to_count;
+		$SQL = "SELECT COUNT(" . $column_to_count . ")" . $this->_construct_2nd_half_of_select_query($model_query_info);
+		return (int)$this->_do_wpdb_query('get_var', array($SQL));
+	}
+
+
+
+	/**
+	 * Sums up the value of the $field_to_sum (defaults to the primary key, which isn't terribly useful)
+	 *
+	 * @param array  $query_params like EEM_Base::get_all
+	 * @param string $field_to_sum name of field (array key in $_fields array)
+	 * @return float
+	 * @throws \EE_Error
+	 */
+	public function sum($query_params, $field_to_sum = null)
+	{
+		$model_query_info = $this->_create_model_query_info_carrier($query_params);
+		if ($field_to_sum) {
+			$field_obj = $this->field_settings_for($field_to_sum);
+		} else {
+			$field_obj = $this->get_primary_key_field();
+		}
+		$column_to_count = $field_obj->get_qualified_column();
+		$SQL = "SELECT SUM(" . $column_to_count . ")" . $this->_construct_2nd_half_of_select_query($model_query_info);
+		$return_value = $this->_do_wpdb_query('get_var', array($SQL));
+		$data_type = $field_obj->get_wpdb_data_type();
+		if ($data_type === '%d' || $data_type === '%s') {
+			return (float)$return_value;
+		} else {//must be %f
+			return (float)$return_value;
+		}
+	}
+
+
+
+	/**
+	 * Just calls the specified method on $wpdb with the given arguments
+	 * Consolidates a little extra error handling code
+	 *
+	 * @param string $wpdb_method
+	 * @param array  $arguments_to_provide
+	 * @throws EE_Error
+	 * @global wpdb  $wpdb
+	 * @return mixed
+	 */
+	protected function _do_wpdb_query($wpdb_method, $arguments_to_provide)
+	{
+		//if we're in maintenance mode level 2, DON'T run any queries
+		//because level 2 indicates the database needs updating and
+		//is probably out of sync with the code
+		if ( ! EE_Maintenance_Mode::instance()->models_can_query()) {
+			throw new EE_Error(sprintf(__("Event Espresso Level 2 Maintenance mode is active. That means EE can not run ANY database queries until the necessary migration scripts have run which will take EE out of maintenance mode level 2. Please inform support of this error.",
+				"event_espresso")));
+		}
+		/** @type WPDB $wpdb */
+		global $wpdb;
+		if ( ! method_exists($wpdb, $wpdb_method)) {
+			throw new EE_Error(sprintf(__('There is no method named "%s" on Wordpress\' $wpdb object',
+				'event_espresso'), $wpdb_method));
+		}
+		if (WP_DEBUG) {
+			$old_show_errors_value = $wpdb->show_errors;
+			$wpdb->show_errors(false);
+		}
+		$result = $this->_process_wpdb_query($wpdb_method, $arguments_to_provide);
+		$this->show_db_query_if_previously_requested($wpdb->last_query);
+		if (WP_DEBUG) {
+			$wpdb->show_errors($old_show_errors_value);
+			if ( ! empty($wpdb->last_error)) {
+				throw new EE_Error(sprintf(__('WPDB Error: "%s"', 'event_espresso'), $wpdb->last_error));
+			} elseif ($result === false) {
+				throw new EE_Error(sprintf(__('WPDB Error occurred, but no error message was logged by wpdb! The wpdb method called was "%1$s" and the arguments were "%2$s"',
+					'event_espresso'), $wpdb_method, var_export($arguments_to_provide, true)));
+			}
+		} elseif ($result === false) {
+			EE_Error::add_error(
+				sprintf(
+					__('A database error has occurred. Turn on WP_DEBUG for more information.||A database error occurred doing wpdb method "%1$s", with arguments "%2$s". The error was "%3$s"',
+						'event_espresso'),
+					$wpdb_method,
+					var_export($arguments_to_provide, true),
+					$wpdb->last_error
+				),
+				__FILE__,
+				__FUNCTION__,
+				__LINE__
+			);
+		}
+		return $result;
+	}
+
+
+
+	/**
+	 * Attempts to run the indicated WPDB method with the provided arguments,
+	 * and if there's an error tries to verify the DB is correct. Uses
+	 * the static property EEM_Base::$_db_verification_level to determine whether
+	 * we should try to fix the EE core db, the addons, or just give up
+	 *
+	 * @param string $wpdb_method
+	 * @param array  $arguments_to_provide
+	 * @return mixed
+	 */
+	private function _process_wpdb_query($wpdb_method, $arguments_to_provide)
+	{
+		/** @type WPDB $wpdb */
+		global $wpdb;
+		$wpdb->last_error = null;
+		$result = call_user_func_array(array($wpdb, $wpdb_method), $arguments_to_provide);
+		// was there an error running the query? but we don't care on new activations
+		// (we're going to setup the DB anyway on new activations)
+		if (($result === false || ! empty($wpdb->last_error))
+			&& EE_System::instance()->detect_req_type() !== EE_System::req_type_new_activation
+		) {
+			switch (EEM_Base::$_db_verification_level) {
+				case EEM_Base::db_verified_none :
+					// let's double-check core's DB
+					$error_message = $this->_verify_core_db($wpdb_method, $arguments_to_provide);
+					break;
+				case EEM_Base::db_verified_core :
+					// STILL NO LOVE?? verify all the addons too. Maybe they need to be fixed
+					$error_message = $this->_verify_addons_db($wpdb_method, $arguments_to_provide);
+					break;
+				case EEM_Base::db_verified_addons :
+					// ummmm... you in trouble
+					return $result;
+					break;
+			}
+			if ( ! empty($error_message)) {
+				EE_Log::instance()->log(__FILE__, __FUNCTION__, $error_message, 'error');
+				trigger_error($error_message);
+			}
+			return $this->_process_wpdb_query($wpdb_method, $arguments_to_provide);
+		}
+		return $result;
+	}
+
+
+
+	/**
+	 * Verifies the EE core database is up-to-date and records that we've done it on
+	 * EEM_Base::$_db_verification_level
+	 *
+	 * @param string $wpdb_method
+	 * @param array  $arguments_to_provide
+	 * @return string
+	 */
+	private function _verify_core_db($wpdb_method, $arguments_to_provide)
+	{
+		/** @type WPDB $wpdb */
+		global $wpdb;
+		//ok remember that we've already attempted fixing the core db, in case the problem persists
+		EEM_Base::$_db_verification_level = EEM_Base::db_verified_core;
+		$error_message = sprintf(
+			__('WPDB Error "%1$s" while running wpdb method "%2$s" with arguments %3$s. Automatically attempting to fix EE Core DB',
+				'event_espresso'),
+			$wpdb->last_error,
+			$wpdb_method,
+			json_encode($arguments_to_provide)
+		);
+		EE_System::instance()->initialize_db_if_no_migrations_required(false, true);
+		return $error_message;
+	}
+
+
+
+	/**
+	 * Verifies the EE addons' database is up-to-date and records that we've done it on
+	 * EEM_Base::$_db_verification_level
+	 *
+	 * @param $wpdb_method
+	 * @param $arguments_to_provide
+	 * @return string
+	 */
+	private function _verify_addons_db($wpdb_method, $arguments_to_provide)
+	{
+		/** @type WPDB $wpdb */
+		global $wpdb;
+		//ok remember that we've already attempted fixing the addons dbs, in case the problem persists
+		EEM_Base::$_db_verification_level = EEM_Base::db_verified_addons;
+		$error_message = sprintf(
+			__('WPDB AGAIN: Error "%1$s" while running the same method and arguments as before. Automatically attempting to fix EE Addons DB',
+				'event_espresso'),
+			$wpdb->last_error,
+			$wpdb_method,
+			json_encode($arguments_to_provide)
+		);
+		EE_System::instance()->initialize_addons();
+		return $error_message;
+	}
+
+
+
+	/**
+	 * In order to avoid repeating this code for the get_all, sum, and count functions, put the code parts
+	 * that are identical in here. Returns a string of SQL of everything in a SELECT query except the beginning
+	 * SELECT clause, eg " FROM wp_posts AS Event INNER JOIN ... WHERE ... ORDER BY ... LIMIT ... GROUP BY ... HAVING
+	 * ..."
+	 *
+	 * @param EE_Model_Query_Info_Carrier $model_query_info
+	 * @return string
+	 */
+	private function _construct_2nd_half_of_select_query(EE_Model_Query_Info_Carrier $model_query_info)
+	{
+		return " FROM " . $model_query_info->get_full_join_sql() .
+			   $model_query_info->get_where_sql() .
+			   $model_query_info->get_group_by_sql() .
+			   $model_query_info->get_having_sql() .
+			   $model_query_info->get_order_by_sql() .
+			   $model_query_info->get_limit_sql();
+	}
+
+
+
+	/**
+	 * Set to easily debug the next X queries ran from this model.
+	 *
+	 * @param int $count
+	 */
+	public function show_next_x_db_queries($count = 1)
+	{
+		$this->_show_next_x_db_queries = $count;
+	}
+
+
+
+	/**
+	 * @param $sql_query
+	 */
+	public function show_db_query_if_previously_requested($sql_query)
+	{
+		if ($this->_show_next_x_db_queries > 0) {
+			echo $sql_query;
+			$this->_show_next_x_db_queries--;
+		}
+	}
+
+
+
+	/**
+	 * Adds a relationship of the correct type between $modelObject and $otherModelObject.
+	 * There are the 3 cases:
+	 * 'belongsTo' relationship: sets $id_or_obj's foreign_key to be $other_model_id_or_obj's primary_key. If
+	 * $otherModelObject has no ID, it is first saved.
+	 * 'hasMany' relationship: sets $other_model_id_or_obj's foreign_key to be $id_or_obj's primary_key. If $id_or_obj
+	 * has no ID, it is first saved.
+	 * 'hasAndBelongsToMany' relationships: checks that there isn't already an entry in the join table, and adds one.
+	 * If one of the model Objects has not yet been saved to the database, it is saved before adding the entry in the
+	 * join table
+	 *
+	 * @param        EE_Base_Class                     /int $thisModelObject
+	 * @param        EE_Base_Class                     /int $id_or_obj EE_base_Class or ID of other Model Object
+	 * @param string $relationName                     , key in EEM_Base::_relations
+	 *                                                 an attendee to a group, you also want to specify which role they
+	 *                                                 will have in that group. So you would use this parameter to
+	 *                                                 specify array('role-column-name'=>'role-id')
+	 * @param array  $extra_join_model_fields_n_values This allows you to enter further query params for the relation
+	 *                                                 to for relation to methods that allow you to further specify
+	 *                                                 extra columns to join by (such as HABTM).  Keep in mind that the
+	 *                                                 only acceptable query_params is strict "col" => "value" pairs
+	 *                                                 because these will be inserted in any new rows created as well.
+	 * @return EE_Base_Class which was added as a relation. Object referred to by $other_model_id_or_obj
+	 * @throws \EE_Error
+	 */
+	public function add_relationship_to(
+		$id_or_obj,
+		$other_model_id_or_obj,
+		$relationName,
+		$extra_join_model_fields_n_values = array()
+	) {
+		$relation_obj = $this->related_settings_for($relationName);
+		return $relation_obj->add_relation_to($id_or_obj, $other_model_id_or_obj, $extra_join_model_fields_n_values);
+	}
+
+
+
+	/**
+	 * Removes a relationship of the correct type between $modelObject and $otherModelObject.
+	 * There are the 3 cases:
+	 * 'belongsTo' relationship: sets $modelObject's foreign_key to null, if that field is nullable.Otherwise throws an
+	 * error
+	 * 'hasMany' relationship: sets $otherModelObject's foreign_key to null,if that field is nullable.Otherwise throws
+	 * an error
+	 * 'hasAndBelongsToMany' relationships:removes any existing entry in the join table between the two models.
+	 *
+	 * @param        EE_Base_Class /int $id_or_obj
+	 * @param        EE_Base_Class /int $other_model_id_or_obj EE_Base_Class or ID of other Model Object
+	 * @param string $relationName key in EEM_Base::_relations
+	 * @return boolean of success
+	 * @throws \EE_Error
+	 * @param array  $where_query  This allows you to enter further query params for the relation to for relation to
+	 *                             methods that allow you to further specify extra columns to join by (such as HABTM).
+	 *                             Keep in mind that the only acceptable query_params is strict "col" => "value" pairs
+	 *                             because these will be inserted in any new rows created as well.
+	 */
+	public function remove_relationship_to($id_or_obj, $other_model_id_or_obj, $relationName, $where_query = array())
+	{
+		$relation_obj = $this->related_settings_for($relationName);
+		return $relation_obj->remove_relation_to($id_or_obj, $other_model_id_or_obj, $where_query);
+	}
+
+
+
+	/**
+	 * @param mixed           $id_or_obj
+	 * @param string          $relationName
+	 * @param array           $where_query_params
+	 * @param EE_Base_Class[] objects to which relations were removed
+	 * @return \EE_Base_Class[]
+	 * @throws \EE_Error
+	 */
+	public function remove_relations($id_or_obj, $relationName, $where_query_params = array())
+	{
+		$relation_obj = $this->related_settings_for($relationName);
+		return $relation_obj->remove_relations($id_or_obj, $where_query_params);
+	}
+
+
+
+	/**
+	 * Gets all the related items of the specified $model_name, using $query_params.
+	 * Note: by default, we remove the "default query params"
+	 * because we want to get even deleted items etc.
+	 *
+	 * @param mixed  $id_or_obj    EE_Base_Class child or its ID
+	 * @param string $model_name   like 'Event', 'Registration', etc. always singular
+	 * @param array  $query_params like EEM_Base::get_all
+	 * @return EE_Base_Class[]
+	 * @throws \EE_Error
+	 */
+	public function get_all_related($id_or_obj, $model_name, $query_params = null)
+	{
+		$model_obj = $this->ensure_is_obj($id_or_obj);
+		$relation_settings = $this->related_settings_for($model_name);
+		return $relation_settings->get_all_related($model_obj, $query_params);
+	}
+
+
+
+	/**
+	 * Deletes all the model objects across the relation indicated by $model_name
+	 * which are related to $id_or_obj which meet the criteria set in $query_params.
+	 * However, if the model objects can't be deleted because of blocking related model objects, then
+	 * they aren't deleted. (Unless the thing that would have been deleted can be soft-deleted, that still happens).
+	 *
+	 * @param EE_Base_Class|int|string $id_or_obj
+	 * @param string                   $model_name
+	 * @param array                    $query_params
+	 * @return int how many deleted
+	 * @throws \EE_Error
+	 */
+	public function delete_related($id_or_obj, $model_name, $query_params = array())
+	{
+		$model_obj = $this->ensure_is_obj($id_or_obj);
+		$relation_settings = $this->related_settings_for($model_name);
+		return $relation_settings->delete_all_related($model_obj, $query_params);
+	}
+
+
+
+	/**
+	 * Hard deletes all the model objects across the relation indicated by $model_name
+	 * which are related to $id_or_obj which meet the criteria set in $query_params. If
+	 * the model objects can't be hard deleted because of blocking related model objects,
+	 * just does a soft-delete on them instead.
+	 *
+	 * @param EE_Base_Class|int|string $id_or_obj
+	 * @param string                   $model_name
+	 * @param array                    $query_params
+	 * @return int how many deleted
+	 * @throws \EE_Error
+	 */
+	public function delete_related_permanently($id_or_obj, $model_name, $query_params = array())
+	{
+		$model_obj = $this->ensure_is_obj($id_or_obj);
+		$relation_settings = $this->related_settings_for($model_name);
+		return $relation_settings->delete_related_permanently($model_obj, $query_params);
+	}
+
+
+
+	/**
+	 * Instead of getting the related model objects, simply counts them. Ignores default_where_conditions by default,
+	 * unless otherwise specified in the $query_params
+	 *
+	 * @param        int             /EE_Base_Class $id_or_obj
+	 * @param string $model_name     like 'Event', or 'Registration'
+	 * @param array  $query_params   like EEM_Base::get_all's
+	 * @param string $field_to_count name of field to count by. By default, uses primary key
+	 * @param bool   $distinct       if we want to only count the distinct values for the column then you can trigger
+	 *                               that by the setting $distinct to TRUE;
+	 * @return int
+	 * @throws \EE_Error
+	 */
+	public function count_related(
+		$id_or_obj,
+		$model_name,
+		$query_params = array(),
+		$field_to_count = null,
+		$distinct = false
+	) {
+		$related_model = $this->get_related_model_obj($model_name);
+		//we're just going to use the query params on the related model's normal get_all query,
+		//except add a condition to say to match the current mod
+		if ( ! isset($query_params['default_where_conditions'])) {
+			$query_params['default_where_conditions'] = 'none';
+		}
+		$this_model_name = $this->get_this_model_name();
+		$this_pk_field_name = $this->get_primary_key_field()->get_name();
+		$query_params[0][$this_model_name . "." . $this_pk_field_name] = $id_or_obj;
+		return $related_model->count($query_params, $field_to_count, $distinct);
+	}
+
+
+
+	/**
+	 * Instead of getting the related model objects, simply sums up the values of the specified field.
+	 * Note: ignores default_where_conditions by default, unless otherwise specified in the $query_params
+	 *
+	 * @param        int           /EE_Base_Class $id_or_obj
+	 * @param string $model_name   like 'Event', or 'Registration'
+	 * @param array  $query_params like EEM_Base::get_all's
+	 * @param string $field_to_sum name of field to count by. By default, uses primary key
+	 * @return float
+	 * @throws \EE_Error
+	 */
+	public function sum_related($id_or_obj, $model_name, $query_params, $field_to_sum = null)
+	{
+		$related_model = $this->get_related_model_obj($model_name);
+		if ( ! is_array($query_params)) {
+			EE_Error::doing_it_wrong('EEM_Base::sum_related',
+				sprintf(__('$query_params should be an array, you passed a variable of type %s', 'event_espresso'),
+					gettype($query_params)), '4.6.0');
+			$query_params = array();
+		}
+		//we're just going to use the query params on the related model's normal get_all query,
+		//except add a condition to say to match the current mod
+		if ( ! isset($query_params['default_where_conditions'])) {
+			$query_params['default_where_conditions'] = 'none';
+		}
+		$this_model_name = $this->get_this_model_name();
+		$this_pk_field_name = $this->get_primary_key_field()->get_name();
+		$query_params[0][$this_model_name . "." . $this_pk_field_name] = $id_or_obj;
+		return $related_model->sum($query_params, $field_to_sum);
+	}
+
+
+
+	/**
+	 * Uses $this->_relatedModels info to find the first related model object of relation $relationName to the given
+	 * $modelObject
+	 *
+	 * @param int | EE_Base_Class $id_or_obj        EE_Base_Class child or its ID
+	 * @param string              $other_model_name , key in $this->_relatedModels, eg 'Registration', or 'Events'
+	 * @param array               $query_params     like EEM_Base::get_all's
+	 * @return EE_Base_Class
+	 * @throws \EE_Error
+	 */
+	public function get_first_related(EE_Base_Class $id_or_obj, $other_model_name, $query_params)
+	{
+		$query_params['limit'] = 1;
+		$results = $this->get_all_related($id_or_obj, $other_model_name, $query_params);
+		if ($results) {
+			return array_shift($results);
+		} else {
+			return null;
+		}
+	}
+
+
+
+	/**
+	 * Gets the model's name as it's expected in queries. For example, if this is EEM_Event model, that would be Event
+	 *
+	 * @return string
+	 */
+	public function get_this_model_name()
+	{
+		return str_replace("EEM_", "", get_class($this));
+	}
+
+
+
+	/**
+	 * Gets the model field on this model which is of type EE_Any_Foreign_Model_Name_Field
+	 *
+	 * @return EE_Any_Foreign_Model_Name_Field
+	 * @throws EE_Error
+	 */
+	public function get_field_containing_related_model_name()
+	{
+		foreach ($this->field_settings(true) as $field) {
+			if ($field instanceof EE_Any_Foreign_Model_Name_Field) {
+				$field_with_model_name = $field;
+			}
+		}
+		if ( ! isset($field_with_model_name) || ! $field_with_model_name) {
+			throw new EE_Error(sprintf(__("There is no EE_Any_Foreign_Model_Name field on model %s", "event_espresso"),
+				$this->get_this_model_name()));
+		}
+		return $field_with_model_name;
+	}
+
+
+
+	/**
+	 * Inserts a new entry into the database, for each table.
+	 * Note: does not add the item to the entity map because that is done by EE_Base_Class::save() right after this.
+	 * If client code uses EEM_Base::insert() directly, then although the item isn't in the entity map,
+	 * we also know there is no model object with the newly inserted item's ID at the moment (because
+	 * if there were, then they would already be in the DB and this would fail); and in the future if someone
+	 * creates a model object with this ID (or grabs it from the DB) then it will be added to the
+	 * entity map at that time anyways. SO, no need for EEM_Base::insert ot add to the entity map
+	 *
+	 * @param array $field_n_values keys are field names, values are their values (in the client code's domain if
+	 *                              $values_already_prepared_by_model_object is false, in the model object's domain if
+	 *                              $values_already_prepared_by_model_object is true. See comment about this at the top
+	 *                              of EEM_Base)
+	 * @return int new primary key on main table that got inserted
+	 * @throws EE_Error
+	 */
+	public function insert($field_n_values)
+	{
+		/**
+		 * Filters the fields and their values before inserting an item using the models
+		 *
+		 * @param array    $fields_n_values keys are the fields and values are their new values
+		 * @param EEM_Base $model           the model used
+		 */
+		$field_n_values = (array)apply_filters('FHEE__EEM_Base__insert__fields_n_values', $field_n_values, $this);
+		if ($this->_satisfies_unique_indexes($field_n_values)) {
+			$main_table = $this->_get_main_table();
+			$new_id = $this->_insert_into_specific_table($main_table, $field_n_values, false);
+			if ($new_id !== false) {
+				foreach ($this->_get_other_tables() as $other_table) {
+					$this->_insert_into_specific_table($other_table, $field_n_values, $new_id);
+				}
+			}
+			/**
+			 * Done just after attempting to insert a new model object
+			 *
+			 * @param EEM_Base   $model           used
+			 * @param array      $fields_n_values fields and their values
+			 * @param int|string the              ID of the newly-inserted model object
+			 */
+			do_action('AHEE__EEM_Base__insert__end', $this, $field_n_values, $new_id);
+			return $new_id;
+		} else {
+			return false;
+		}
+	}
+
+
+
+	/**
+	 * Checks that the result would satisfy the unique indexes on this model
+	 *
+	 * @param array  $field_n_values
+	 * @param string $action
+	 * @return boolean
+	 * @throws \EE_Error
+	 */
+	protected function _satisfies_unique_indexes($field_n_values, $action = 'insert')
+	{
+		foreach ($this->unique_indexes() as $index_name => $index) {
+			$uniqueness_where_params = array_intersect_key($field_n_values, $index->fields());
+			if ($this->exists(array($uniqueness_where_params))) {
+				EE_Error::add_error(
+					sprintf(
+						__(
+							"Could not %s %s. %s uniqueness index failed. Fields %s must form a unique set, but an entry already exists with values %s.",
+							"event_espresso"
+						),
+						$action,
+						$this->_get_class_name(),
+						$index_name,
+						implode(",", $index->field_names()),
+						http_build_query($uniqueness_where_params)
+					),
+					__FILE__,
+					__FUNCTION__,
+					__LINE__
+				);
+				return false;
+			}
+		}
+		return true;
+	}
+
+
+
+	/**
+	 * Checks the database for an item that conflicts (ie, if this item were
+	 * saved to the DB would break some uniqueness requirement, like a primary key
+	 * or an index primary key set) with the item specified. $id_obj_or_fields_array
+	 * can be either an EE_Base_Class or an array of fields n values
+	 *
+	 * @param EE_Base_Class|array $obj_or_fields_array
+	 * @param boolean             $include_primary_key whether to use the model object's primary key
+	 *                                                 when looking for conflicts
+	 *                                                 (ie, if false, we ignore the model object's primary key
+	 *                                                 when finding "conflicts". If true, it's also considered).
+	 *                                                 Only works for INT primary key,
+	 *                                                 STRING primary keys cannot be ignored
+	 * @throws EE_Error
+	 * @return EE_Base_Class|array
+	 */
+	public function get_one_conflicting($obj_or_fields_array, $include_primary_key = true)
+	{
+		if ($obj_or_fields_array instanceof EE_Base_Class) {
+			$fields_n_values = $obj_or_fields_array->model_field_array();
+		} elseif (is_array($obj_or_fields_array)) {
+			$fields_n_values = $obj_or_fields_array;
+		} else {
+			throw new EE_Error(
+				sprintf(
+					__(
+						"%s get_all_conflicting should be called with a model object or an array of field names and values, you provided %d",
+						"event_espresso"
+					),
+					get_class($this),
+					$obj_or_fields_array
+				)
+			);
+		}
+		$query_params = array();
+		if ($this->has_primary_key_field()
+			&& ($include_primary_key
+				|| $this->get_primary_key_field()
+				   instanceof
+				   EE_Primary_Key_String_Field)
+			&& isset($fields_n_values[$this->primary_key_name()])
+		) {
+			$query_params[0]['OR'][$this->primary_key_name()] = $fields_n_values[$this->primary_key_name()];
+		}
+		foreach ($this->unique_indexes() as $unique_index_name => $unique_index) {
+			$uniqueness_where_params = array_intersect_key($fields_n_values, $unique_index->fields());
+			$query_params[0]['OR']['AND*' . $unique_index_name] = $uniqueness_where_params;
+		}
+		//if there is nothing to base this search on, then we shouldn't find anything
+		if (empty($query_params)) {
+			return array();
+		} else {
+			return $this->get_one($query_params);
+		}
+	}
+
+
+
+	/**
+	 * Like count, but is optimized and returns a boolean instead of an int
+	 *
+	 * @param array $query_params
+	 * @return boolean
+	 * @throws \EE_Error
+	 */
+	public function exists($query_params)
+	{
+		$query_params['limit'] = 1;
+		return $this->count($query_params) > 0;
+	}
+
+
+
+	/**
+	 * Wrapper for exists, except ignores default query parameters so we're only considering ID
+	 *
+	 * @param int|string $id
+	 * @return boolean
+	 * @throws \EE_Error
+	 */
+	public function exists_by_ID($id)
+	{
+		return $this->exists(array('default_where_conditions' => 'none', array($this->primary_key_name() => $id)));
+	}
+
+
+
+	/**
+	 * Inserts a new row in $table, using the $cols_n_values which apply to that table.
+	 * If a $new_id is supplied and if $table is an EE_Other_Table, we assume
+	 * we need to add a foreign key column to point to $new_id (which should be the primary key's value
+	 * on the main table)
+	 * This is protected rather than private because private is not accessible to any child methods and there MAY be
+	 * cases where we want to call it directly rather than via insert().
+	 *
+	 * @access   protected
+	 * @param EE_Table_Base $table
+	 * @param array         $fields_n_values each key should be in field's keys, and value should be an int, string or
+	 *                                       float
+	 * @param int           $new_id          for now we assume only int keys
+	 * @throws EE_Error
+	 * @global WPDB         $wpdb            only used to get the $wpdb->insert_id after performing an insert
+	 * @return int ID of new row inserted, or FALSE on failure
+	 */
+	protected function _insert_into_specific_table(EE_Table_Base $table, $fields_n_values, $new_id = 0)
+	{
+		global $wpdb;
+		$insertion_col_n_values = array();
+		$format_for_insertion = array();
+		$fields_on_table = $this->_get_fields_for_table($table->get_table_alias());
+		foreach ($fields_on_table as $field_name => $field_obj) {
+			//check if its an auto-incrementing column, in which case we should just leave it to do its autoincrement thing
+			if ($field_obj->is_auto_increment()) {
+				continue;
+			}
+			$prepared_value = $this->_prepare_value_or_use_default($field_obj, $fields_n_values);
+			//if the value we want to assign it to is NULL, just don't mention it for the insertion
+			if ($prepared_value !== null) {
+				$insertion_col_n_values[$field_obj->get_table_column()] = $prepared_value;
+				$format_for_insertion[] = $field_obj->get_wpdb_data_type();
+			}
+		}
+		if ($table instanceof EE_Secondary_Table && $new_id) {
+			//its not the main table, so we should have already saved the main table's PK which we just inserted
+			//so add the fk to the main table as a column
+			$insertion_col_n_values[$table->get_fk_on_table()] = $new_id;
+			$format_for_insertion[] = '%d';//yes right now we're only allowing these foreign keys to be INTs
+		}
+		//insert the new entry
+		$result = $this->_do_wpdb_query('insert',
+			array($table->get_table_name(), $insertion_col_n_values, $format_for_insertion));
+		if ($result === false) {
+			return false;
+		}
+		//ok, now what do we return for the ID of the newly-inserted thing?
+		if ($this->has_primary_key_field()) {
+			if ($this->get_primary_key_field()->is_auto_increment()) {
+				return $wpdb->insert_id;
+			} else {
+				//it's not an auto-increment primary key, so
+				//it must have been supplied
+				return $fields_n_values[$this->get_primary_key_field()->get_name()];
+			}
+		} else {
+			//we can't return a  primary key because there is none. instead return
+			//a unique string indicating this model
+			return $this->get_index_primary_key_string($fields_n_values);
+		}
+	}
+
+
+
+	/**
+	 * Prepare the $field_obj 's value in $fields_n_values for use in the database.
+	 * If the field doesn't allow NULL, try to use its default. (If it doesn't allow NULL,
+	 * and there is no default, we pass it along. WPDB will take care of it)
+	 *
+	 * @param EE_Model_Field_Base $field_obj
+	 * @param array               $fields_n_values
+	 * @return mixed string|int|float depending on what the table column will be expecting
+	 * @throws \EE_Error
+	 */
+	protected function _prepare_value_or_use_default($field_obj, $fields_n_values)
+	{
+		//if this field doesn't allow nullable, don't allow it
+		if ( ! $field_obj->is_nullable()
+			 && (
+				 ! isset($fields_n_values[$field_obj->get_name()]) || $fields_n_values[$field_obj->get_name()] === null)
+		) {
+			$fields_n_values[$field_obj->get_name()] = $field_obj->get_default_value();
+		}
+		$unprepared_value = isset($fields_n_values[$field_obj->get_name()]) ? $fields_n_values[$field_obj->get_name()]
+			: null;
+		return $this->_prepare_value_for_use_in_db($unprepared_value, $field_obj);
+	}
+
+
+
+	/**
+	 * Consolidates code for preparing  a value supplied to the model for use int eh db. Calls the field's
+	 * prepare_for_use_in_db method on the value, and depending on $value_already_prepare_by_model_obj, may also call
+	 * the field's prepare_for_set() method.
+	 *
+	 * @param mixed               $value value in the client code domain if $value_already_prepared_by_model_object is
+	 *                                   false, otherwise a value in the model object's domain (see lengthy comment at
+	 *                                   top of file)
+	 * @param EE_Model_Field_Base $field field which will be doing the preparing of the value. If null, we assume
+	 *                                   $value is a custom selection
+	 * @return mixed a value ready for use in the database for insertions, updating, or in a where clause
+	 */
+	private function _prepare_value_for_use_in_db($value, $field)
+	{
+		if ($field && $field instanceof EE_Model_Field_Base) {
+			switch ($this->_values_already_prepared_by_model_object) {
+				/** @noinspection PhpMissingBreakStatementInspection */
+				case self::not_prepared_by_model_object:
+					$value = $field->prepare_for_set($value);
+				//purposefully left out "return"
+				case self::prepared_by_model_object:
+					$value = $field->prepare_for_use_in_db($value);
+				case self::prepared_for_use_in_db:
+					//leave the value alone
+			}
+			return $value;
+		} else {
+			return $value;
+		}
+	}
+
+
+
+	/**
+	 * Returns the main table on this model
+	 *
+	 * @return EE_Primary_Table
+	 * @throws EE_Error
+	 */
+	protected function _get_main_table()
+	{
+		foreach ($this->_tables as $table) {
+			if ($table instanceof EE_Primary_Table) {
+				return $table;
+			}
+		}
+		throw new EE_Error(sprintf(__('There are no main tables on %s. They should be added to _tables array in the constructor',
+			'event_espresso'), get_class($this)));
+	}
+
+
+
+	/**
+	 * table
+	 * returns EE_Primary_Table table name
+	 *
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function table()
+	{
+		return $this->_get_main_table()->get_table_name();
+	}
+
+
+
+	/**
+	 * table
+	 * returns first EE_Secondary_Table table name
+	 *
+	 * @return string
+	 */
+	public function second_table()
+	{
+		// grab second table from tables array
+		$second_table = end($this->_tables);
+		return $second_table instanceof EE_Secondary_Table ? $second_table->get_table_name() : null;
+	}
+
+
+
+	/**
+	 * get_table_obj_by_alias
+	 * returns table name given it's alias
+	 *
+	 * @param string $table_alias
+	 * @return EE_Primary_Table | EE_Secondary_Table
+	 */
+	public function get_table_obj_by_alias($table_alias = '')
+	{
+		return isset($this->_tables[$table_alias]) ? $this->_tables[$table_alias] : null;
+	}
+
+
+
+	/**
+	 * Gets all the tables of type EE_Other_Table from EEM_CPT_Basel_Model::_tables
+	 *
+	 * @return EE_Secondary_Table[]
+	 */
+	protected function _get_other_tables()
+	{
+		$other_tables = array();
+		foreach ($this->_tables as $table_alias => $table) {
+			if ($table instanceof EE_Secondary_Table) {
+				$other_tables[$table_alias] = $table;
+			}
+		}
+		return $other_tables;
+	}
+
+
+
+	/**
+	 * Finds all the fields that correspond to the given table
+	 *
+	 * @param string $table_alias , array key in EEM_Base::_tables
+	 * @return EE_Model_Field_Base[]
+	 */
+	public function _get_fields_for_table($table_alias)
+	{
+		return $this->_fields[$table_alias];
+	}
+
+
+
+	/**
+	 * Recurses through all the where parameters, and finds all the related models we'll need
+	 * to complete this query. Eg, given where parameters like array('EVT_ID'=>3) from within Event model, we won't
+	 * need any related models. But if the array were array('Registrations.REG_ID'=>3), we'd need the related
+	 * Registration model. If it were array('Registrations.Transactions.Payments.PAY_ID'=>3), then we'd need the
+	 * related Registration, Transaction, and Payment models.
+	 *
+	 * @param array $query_params like EEM_Base::get_all's $query_parameters['where']
+	 * @return EE_Model_Query_Info_Carrier
+	 * @throws \EE_Error
+	 */
+	public function _extract_related_models_from_query($query_params)
+	{
+		$query_info_carrier = new EE_Model_Query_Info_Carrier();
+		if (array_key_exists(0, $query_params)) {
+			$this->_extract_related_models_from_sub_params_array_keys($query_params[0], $query_info_carrier, 0);
+		}
+		if (array_key_exists('group_by', $query_params)) {
+			if (is_array($query_params['group_by'])) {
+				$this->_extract_related_models_from_sub_params_array_values(
+					$query_params['group_by'],
+					$query_info_carrier,
+					'group_by'
+				);
+			} elseif ( ! empty ($query_params['group_by'])) {
+				$this->_extract_related_model_info_from_query_param(
+					$query_params['group_by'],
+					$query_info_carrier,
+					'group_by'
+				);
+			}
+		}
+		if (array_key_exists('having', $query_params)) {
+			$this->_extract_related_models_from_sub_params_array_keys(
+				$query_params[0],
+				$query_info_carrier,
+				'having'
+			);
+		}
+		if (array_key_exists('order_by', $query_params)) {
+			if (is_array($query_params['order_by'])) {
+				$this->_extract_related_models_from_sub_params_array_keys(
+					$query_params['order_by'],
+					$query_info_carrier,
+					'order_by'
+				);
+			} elseif ( ! empty($query_params['order_by'])) {
+				$this->_extract_related_model_info_from_query_param(
+					$query_params['order_by'],
+					$query_info_carrier,
+					'order_by'
+				);
+			}
+		}
+		if (array_key_exists('force_join', $query_params)) {
+			$this->_extract_related_models_from_sub_params_array_values(
+				$query_params['force_join'],
+				$query_info_carrier,
+				'force_join'
+			);
+		}
+		return $query_info_carrier;
+	}
+
+
+
+	/**
+	 * For extracting related models from WHERE (0), HAVING (having), ORDER BY (order_by) or forced joins (force_join)
+	 *
+	 * @param array                       $sub_query_params like EEM_Base::get_all's $query_params[0] or
+	 *                                                      $query_params['having']
+	 * @param EE_Model_Query_Info_Carrier $model_query_info_carrier
+	 * @param string                      $query_param_type one of $this->_allowed_query_params
+	 * @throws EE_Error
+	 * @return \EE_Model_Query_Info_Carrier
+	 */
+	private function _extract_related_models_from_sub_params_array_keys(
+		$sub_query_params,
+		EE_Model_Query_Info_Carrier $model_query_info_carrier,
+		$query_param_type
+	) {
+		if ( ! empty($sub_query_params)) {
+			$sub_query_params = (array)$sub_query_params;
+			foreach ($sub_query_params as $param => $possibly_array_of_params) {
+				//$param could be simply 'EVT_ID', or it could be 'Registrations.REG_ID', or even 'Registrations.Transactions.Payments.PAY_amount'
+				$this->_extract_related_model_info_from_query_param($param, $model_query_info_carrier,
+					$query_param_type);
+				//if $possibly_array_of_params is an array, try recursing into it, searching for keys which
+				//indicate needed joins. Eg, array('NOT'=>array('Registration.TXN_ID'=>23)). In this case, we tried
+				//extracting models out of the 'NOT', which obviously wasn't successful, and then we recurse into the value
+				//of array('Registration.TXN_ID'=>23)
+				$query_param_sans_stars = $this->_remove_stars_and_anything_after_from_condition_query_param_key($param);
+				if (in_array($query_param_sans_stars, $this->_logic_query_param_keys, true)) {
+					if ( ! is_array($possibly_array_of_params)) {
+						throw new EE_Error(sprintf(__("You used a special where query param %s, but the value isn't an array of where query params, it's just %s'. It should be an array, eg array('EVT_ID'=>23,'OR'=>array('Venue.VNU_ID'=>32,'Venue.VNU_name'=>'monkey_land'))",
+							"event_espresso"),
+							$param, $possibly_array_of_params));
+					} else {
+						$this->_extract_related_models_from_sub_params_array_keys($possibly_array_of_params,
+							$model_query_info_carrier, $query_param_type);
+					}
+				} elseif ($query_param_type === 0 //ie WHERE
+						  && is_array($possibly_array_of_params)
+						  && isset($possibly_array_of_params[2])
+						  && $possibly_array_of_params[2] == true
+				) {
+					//then $possible_array_of_params looks something like array('<','DTT_sold',true)
+					//indicating that $possible_array_of_params[1] is actually a field name,
+					//from which we should extract query parameters!
+					if ( ! isset($possibly_array_of_params[0], $possibly_array_of_params[1])) {
+						throw new EE_Error(sprintf(__("Improperly formed query parameter %s. It should be numerically indexed like array('<','DTT_sold',true); but you provided %s",
+							"event_espresso"), $query_param_type, implode(",", $possibly_array_of_params)));
+					}
+					$this->_extract_related_model_info_from_query_param($possibly_array_of_params[1],
+						$model_query_info_carrier, $query_param_type);
+				}
+			}
+		}
+		return $model_query_info_carrier;
+	}
+
+
+
+	/**
+	 * For extracting related models from forced_joins, where the array values contain the info about what
+	 * models to join with. Eg an array like array('Attendee','Price.Price_Type');
+	 *
+	 * @param array                       $sub_query_params like EEM_Base::get_all's $query_params[0] or
+	 *                                                      $query_params['having']
+	 * @param EE_Model_Query_Info_Carrier $model_query_info_carrier
+	 * @param string                      $query_param_type one of $this->_allowed_query_params
+	 * @throws EE_Error
+	 * @return \EE_Model_Query_Info_Carrier
+	 */
+	private function _extract_related_models_from_sub_params_array_values(
+		$sub_query_params,
+		EE_Model_Query_Info_Carrier $model_query_info_carrier,
+		$query_param_type
+	) {
+		if ( ! empty($sub_query_params)) {
+			if ( ! is_array($sub_query_params)) {
+				throw new EE_Error(sprintf(__("Query parameter %s should be an array, but it isn't.", "event_espresso"),
+					$sub_query_params));
+			}
+			foreach ($sub_query_params as $param) {
+				//$param could be simply 'EVT_ID', or it could be 'Registrations.REG_ID', or even 'Registrations.Transactions.Payments.PAY_amount'
+				$this->_extract_related_model_info_from_query_param($param, $model_query_info_carrier,
+					$query_param_type);
+			}
+		}
+		return $model_query_info_carrier;
+	}
+
+
+
+	/**
+	 * Extract all the query parts from $query_params (an array like whats passed to EEM_Base::get_all)
+	 * and put into a EEM_Related_Model_Info_Carrier for easy extraction into a query. We create this object
+	 * instead of directly constructing the SQL because often we need to extract info from the $query_params
+	 * but use them in a different order. Eg, we need to know what models we are querying
+	 * before we know what joins to perform. However, we need to know what data types correspond to which fields on
+	 * other models before we can finalize the where clause SQL.
+	 *
+	 * @param array $query_params
+	 * @throws EE_Error
+	 * @return EE_Model_Query_Info_Carrier
+	 */
+	public function _create_model_query_info_carrier($query_params)
+	{
+		if ( ! is_array($query_params)) {
+			EE_Error::doing_it_wrong(
+				'EEM_Base::_create_model_query_info_carrier',
+				sprintf(
+					__(
+						'$query_params should be an array, you passed a variable of type %s',
+						'event_espresso'
+					),
+					gettype($query_params)
+				),
+				'4.6.0'
+			);
+			$query_params = array();
+		}
+		$where_query_params = isset($query_params[0]) ? $query_params[0] : array();
+		//first check if we should alter the query to account for caps or not
+		//because the caps might require us to do extra joins
+		if (isset($query_params['caps']) && $query_params['caps'] !== 'none') {
+			$query_params[0] = $where_query_params = array_replace_recursive(
+				$where_query_params,
+				$this->caps_where_conditions(
+					$query_params['caps']
+				)
+			);
+		}
+		$query_object = $this->_extract_related_models_from_query($query_params);
+		//verify where_query_params has NO numeric indexes.... that's simply not how you use it!
+		foreach ($where_query_params as $key => $value) {
+			if (is_int($key)) {
+				throw new EE_Error(
+					sprintf(
+						__(
+							"WHERE query params must NOT be numerically-indexed. You provided the array key '%s' for value '%s' while querying model %s. All the query params provided were '%s' Please read documentation on EEM_Base::get_all.",
+							"event_espresso"
+						),
+						$key,
+						var_export($value, true),
+						var_export($query_params, true),
+						get_class($this)
+					)
+				);
+			}
+		}
+		if (
+			array_key_exists('default_where_conditions', $query_params)
+			&& ! empty($query_params['default_where_conditions'])
+		) {
+			$use_default_where_conditions = $query_params['default_where_conditions'];
+		} else {
+			$use_default_where_conditions = 'all';
+		}
+		$where_query_params = array_merge(
+			$this->_get_default_where_conditions_for_models_in_query(
+				$query_object,
+				$use_default_where_conditions,
+				$where_query_params
+			),
+			$where_query_params
+		);
+		$query_object->set_where_sql($this->_construct_where_clause($where_query_params));
+		// if this is a "on_join_limit" then we are limiting on on a specific table in a multi_table join.
+		// So we need to setup a subquery and use that for the main join.
+		// Note for now this only works on the primary table for the model.
+		// So for instance, you could set the limit array like this:
+		// array( 'on_join_limit' => array('Primary_Table_Alias', array(1,10) ) )
+		if (array_key_exists('on_join_limit', $query_params) && ! empty($query_params['on_join_limit'])) {
+			$query_object->set_main_model_join_sql(
+				$this->_construct_limit_join_select(
+					$query_params['on_join_limit'][0],
+					$query_params['on_join_limit'][1]
+				)
+			);
+		}
+		//set limit
+		if (array_key_exists('limit', $query_params)) {
+			if (is_array($query_params['limit'])) {
+				if ( ! isset($query_params['limit'][0], $query_params['limit'][1])) {
+					$e = sprintf(
+						__(
+							"Invalid DB query. You passed '%s' for the LIMIT, but only the following are valid: an integer, string representing an integer, a string like 'int,int', or an array like array(int,int)",
+							"event_espresso"
+						),
+						http_build_query($query_params['limit'])
+					);
+					throw new EE_Error($e . "|" . $e);
+				}
+				//they passed us an array for the limit. Assume it's like array(50,25), meaning offset by 50, and get 25
+				$query_object->set_limit_sql(" LIMIT " . $query_params['limit'][0] . "," . $query_params['limit'][1]);
+			} elseif ( ! empty ($query_params['limit'])) {
+				$query_object->set_limit_sql(" LIMIT " . $query_params['limit']);
+			}
+		}
+		//set order by
+		if (array_key_exists('order_by', $query_params)) {
+			if (is_array($query_params['order_by'])) {
+				//if they're using 'order_by' as an array, they can't use 'order' (because 'order_by' must
+				//specify whether to ascend or descend on each field. Eg 'order_by'=>array('EVT_ID'=>'ASC'). So
+				//including 'order' wouldn't make any sense if 'order_by' has already specified which way to order!
+				if (array_key_exists('order', $query_params)) {
+					throw new EE_Error(
+						sprintf(
+							__(
+								"In querying %s, we are using query parameter 'order_by' as an array (keys:%s,values:%s), and so we can't use query parameter 'order' (value %s). You should just use the 'order_by' parameter ",
+								"event_espresso"
+							),
+							get_class($this),
+							implode(", ", array_keys($query_params['order_by'])),
+							implode(", ", $query_params['order_by']),
+							$query_params['order']
+						)
+					);
+				}
+				$this->_extract_related_models_from_sub_params_array_keys(
+					$query_params['order_by'],
+					$query_object,
+					'order_by'
+				);
+				//assume it's an array of fields to order by
+				$order_array = array();
+				foreach ($query_params['order_by'] as $field_name_to_order_by => $order) {
+					$order = $this->_extract_order($order);
+					$order_array[] = $this->_deduce_column_name_from_query_param($field_name_to_order_by) . SP . $order;
+				}
+				$query_object->set_order_by_sql(" ORDER BY " . implode(",", $order_array));
+			} elseif ( ! empty ($query_params['order_by'])) {
+				$this->_extract_related_model_info_from_query_param(
+					$query_params['order_by'],
+					$query_object,
+					'order',
+					$query_params['order_by']
+				);
+				$order = isset($query_params['order'])
+					? $this->_extract_order($query_params['order'])
+					: 'DESC';
+				$query_object->set_order_by_sql(
+					" ORDER BY " . $this->_deduce_column_name_from_query_param($query_params['order_by']) . SP . $order
+				);
+			}
+		}
+		//if 'order_by' wasn't set, maybe they are just using 'order' on its own?
+		if ( ! array_key_exists('order_by', $query_params)
+			 && array_key_exists('order', $query_params)
+			 && ! empty($query_params['order'])
+		) {
+			$pk_field = $this->get_primary_key_field();
+			$order = $this->_extract_order($query_params['order']);
+			$query_object->set_order_by_sql(" ORDER BY " . $pk_field->get_qualified_column() . SP . $order);
+		}
+		//set group by
+		if (array_key_exists('group_by', $query_params)) {
+			if (is_array($query_params['group_by'])) {
+				//it's an array, so assume we'll be grouping by a bunch of stuff
+				$group_by_array = array();
+				foreach ($query_params['group_by'] as $field_name_to_group_by) {
+					$group_by_array[] = $this->_deduce_column_name_from_query_param($field_name_to_group_by);
+				}
+				$query_object->set_group_by_sql(" GROUP BY " . implode(", ", $group_by_array));
+			} elseif ( ! empty ($query_params['group_by'])) {
+				$query_object->set_group_by_sql(
+					" GROUP BY " . $this->_deduce_column_name_from_query_param($query_params['group_by'])
+				);
+			}
+		}
+		//set having
+		if (array_key_exists('having', $query_params) && $query_params['having']) {
+			$query_object->set_having_sql($this->_construct_having_clause($query_params['having']));
+		}
+		//now, just verify they didn't pass anything wack
+		foreach ($query_params as $query_key => $query_value) {
+			if ( ! in_array($query_key, $this->_allowed_query_params, true)) {
+				throw new EE_Error(
+					sprintf(
+						__(
+							"You passed %s as a query parameter to %s, which is illegal! The allowed query parameters are %s",
+							'event_espresso'
+						),
+						$query_key,
+						get_class($this),
+						//						print_r( $this->_allowed_query_params, TRUE )
+						implode(',', $this->_allowed_query_params)
+					)
+				);
+			}
+		}
+		$main_model_join_sql = $query_object->get_main_model_join_sql();
+		if (empty($main_model_join_sql)) {
+			$query_object->set_main_model_join_sql($this->_construct_internal_join());
+		}
+		return $query_object;
+	}
+
+
+
+	/**
+	 * Gets the where conditions that should be imposed on the query based on the
+	 * context (eg reading frontend, backend, edit or delete).
+	 *
+	 * @param string $context one of EEM_Base::valid_cap_contexts()
+	 * @return array like EEM_Base::get_all() 's $query_params[0]
+	 * @throws \EE_Error
+	 */
+	public function caps_where_conditions($context = self::caps_read)
+	{
+		EEM_Base::verify_is_valid_cap_context($context);
+		$cap_where_conditions = array();
+		$cap_restrictions = $this->caps_missing($context);
+		/**
+		 * @var $cap_restrictions EE_Default_Where_Conditions[]
+		 */
+		foreach ($cap_restrictions as $cap => $restriction_if_no_cap) {
+			$cap_where_conditions = array_replace_recursive($cap_where_conditions,
+				$restriction_if_no_cap->get_default_where_conditions());
+		}
+		return apply_filters('FHEE__EEM_Base__caps_where_conditions__return', $cap_where_conditions, $this, $context,
+			$cap_restrictions);
+	}
+
+
+
+	/**
+	 * Verifies that $should_be_order_string is in $this->_allowed_order_values,
+	 * otherwise throws an exception
+	 *
+	 * @param string $should_be_order_string
+	 * @return string either ASC, asc, DESC or desc
+	 * @throws EE_Error
+	 */
+	private function _extract_order($should_be_order_string)
+	{
+		if (in_array($should_be_order_string, $this->_allowed_order_values)) {
+			return $should_be_order_string;
+		} else {
+			throw new EE_Error(sprintf(__("While performing a query on '%s', tried to use '%s' as an order parameter. ",
+				"event_espresso"), get_class($this), $should_be_order_string));
+		}
+	}
+
+
+
+	/**
+	 * Looks at all the models which are included in this query, and asks each
+	 * for their universal_where_params, and returns them in the same format as $query_params[0] (where),
+	 * so they can be merged
+	 *
+	 * @param EE_Model_Query_Info_Carrier $query_info_carrier
+	 * @param string                      $use_default_where_conditions can be 'none','other_models_only', or 'all'.
+	 *                                                                  'none' means NO default where conditions will
+	 *                                                                  be used AT ALL during this query.
+	 *                                                                  'other_models_only' means default where
+	 *                                                                  conditions from other models will be used, but
+	 *                                                                  not for this primary model. 'all', the default,
+	 *                                                                  means default where conditions will apply as
+	 *                                                                  normal
+	 * @param array                       $where_query_params           like EEM_Base::get_all's $query_params[0]
+	 * @throws EE_Error
+	 * @return array like $query_params[0], see EEM_Base::get_all for documentation
+	 */
+	private function _get_default_where_conditions_for_models_in_query(
+		EE_Model_Query_Info_Carrier $query_info_carrier,
+		$use_default_where_conditions = 'all',
+		$where_query_params = array()
+	) {
+		$allowed_used_default_where_conditions_values = array(
+			'all',
+			'this_model_only',
+			'other_models_only',
+			'minimum',
+			'none',
+		);
+		if ( ! in_array($use_default_where_conditions, $allowed_used_default_where_conditions_values)) {
+			throw new EE_Error(sprintf(__("You passed an invalid value to the query parameter 'default_where_conditions' of '%s'. Allowed values are %s",
+				"event_espresso"), $use_default_where_conditions,
+				implode(", ", $allowed_used_default_where_conditions_values)));
+		}
+		$universal_query_params = array();
+		if ($use_default_where_conditions === 'all' || $use_default_where_conditions === 'this_model_only') {
+			$universal_query_params = $this->_get_default_where_conditions();
+		} else if ($use_default_where_conditions === 'minimum') {
+			$universal_query_params = $this->_get_minimum_where_conditions();
+		}
+		if (in_array($use_default_where_conditions, array('all', 'other_models_only'))) {
+			foreach ($query_info_carrier->get_model_names_included() as $model_relation_path => $model_name) {
+				$related_model = $this->get_related_model_obj($model_name);
+				$related_model_universal_where_params = $related_model->_get_default_where_conditions($model_relation_path);
+				$overrides = $this->_override_defaults_or_make_null_friendly(
+					$related_model_universal_where_params,
+					$where_query_params,
+					$related_model,
+					$model_relation_path
+				);
+				$universal_query_params = EEH_Array::merge_arrays_and_overwrite_keys(
+					$universal_query_params,
+					$overrides
+				);
+			}
+		}
+		return $universal_query_params;
+	}
+
+
+
+	/**
+	 * Checks if any of the defaults have been overridden. If there are any that AREN'T overridden,
+	 * then we also add a special where condition which allows for that model's primary key
+	 * to be null (which is important for JOINs. Eg, if you want to see all Events ordered by Venue's name,
+	 * then Event's with NO Venue won't appear unless you allow VNU_ID to be NULL)
+	 *
+	 * @param array    $default_where_conditions
+	 * @param array    $provided_where_conditions
+	 * @param EEM_Base $model
+	 * @param string   $model_relation_path like 'Transaction.Payment.'
+	 * @return array like EEM_Base::get_all's $query_params[0]
+	 * @throws \EE_Error
+	 */
+	private function _override_defaults_or_make_null_friendly(
+		$default_where_conditions,
+		$provided_where_conditions,
+		$model,
+		$model_relation_path
+	) {
+		$null_friendly_where_conditions = array();
+		$none_overridden = true;
+		$or_condition_key_for_defaults = 'OR*' . get_class($model);
+		foreach ($default_where_conditions as $key => $val) {
+			if (isset($provided_where_conditions[$key])) {
+				$none_overridden = false;
+			} else {
+				$null_friendly_where_conditions[$or_condition_key_for_defaults]['AND'][$key] = $val;
+			}
+		}
+		if ($none_overridden && $default_where_conditions) {
+			if ($model->has_primary_key_field()) {
+				$null_friendly_where_conditions[$or_condition_key_for_defaults][$model_relation_path
+																				. "."
+																				. $model->primary_key_name()] = array('IS NULL');
+			}/*else{
 				//@todo NO PK, use other defaults
 			}*/
-        }
-        return $null_friendly_where_conditions;
-    }
-
-
-
-    /**
-     * Uses the _default_where_conditions_strategy set during __construct() to get
-     * default where conditions on all get_all, update, and delete queries done by this model.
-     * Use the same syntax as client code. Eg on the Event model, use array('Event.EVT_post_type'=>'esp_event'),
-     * NOT array('Event_CPT.post_type'=>'esp_event').
-     *
-     * @param string $model_relation_path eg, path from Event to Payment is "Registration.Transaction.Payment."
-     * @return array like EEM_Base::get_all's $query_params[0] (where conditions)
-     */
-    private function _get_default_where_conditions($model_relation_path = null)
-    {
-        if ($this->_ignore_where_strategy) {
-            return array();
-        }
-        return $this->_default_where_conditions_strategy->get_default_where_conditions($model_relation_path);
-    }
-
-
-
-    /**
-     * Uses the _minimum_where_conditions_strategy set during __construct() to get
-     * minimum where conditions on all get_all, update, and delete queries done by this model.
-     * Use the same syntax as client code. Eg on the Event model, use array('Event.EVT_post_type'=>'esp_event'),
-     * NOT array('Event_CPT.post_type'=>'esp_event').
-     * Similar to _get_default_where_conditions
-     *
-     * @param string $model_relation_path eg, path from Event to Payment is "Registration.Transaction.Payment."
-     * @return array like EEM_Base::get_all's $query_params[0] (where conditions)
-     */
-    protected function _get_minimum_where_conditions($model_relation_path = null)
-    {
-        if ($this->_ignore_where_strategy) {
-            return array();
-        }
-        return $this->_minimum_where_conditions_strategy->get_default_where_conditions($model_relation_path);
-    }
-
-
-
-    /**
-     * Creates the string of SQL for the select part of a select query, everything behind SELECT and before FROM.
-     * Eg, "Event.post_id, Event.post_name,Event_Detail.EVT_ID..."
-     *
-     * @param EE_Model_Query_Info_Carrier $model_query_info
-     * @return string
-     * @throws \EE_Error
-     */
-    private function _construct_default_select_sql(EE_Model_Query_Info_Carrier $model_query_info)
-    {
-        $selects = $this->_get_columns_to_select_for_this_model();
-        foreach (
-            $model_query_info->get_model_names_included() as $model_relation_chain =>
-            $name_of_other_model_included
-        ) {
-            $other_model_included = $this->get_related_model_obj($name_of_other_model_included);
-            $other_model_selects = $other_model_included->_get_columns_to_select_for_this_model($model_relation_chain);
-            foreach ($other_model_selects as $key => $value) {
-                $selects[] = $value;
-            }
-        }
-        return implode(", ", $selects);
-    }
-
-
-
-    /**
-     * Gets an array of columns to select for this model, which are necessary for it to create its objects.
-     * So that's going to be the columns for all the fields on the model
-     *
-     * @param string $model_relation_chain like 'Question.Question_Group.Event'
-     * @return array numerically indexed, values are columns to select and rename, eg "Event.ID AS 'Event.ID'"
-     */
-    public function _get_columns_to_select_for_this_model($model_relation_chain = '')
-    {
-        $fields = $this->field_settings();
-        $selects = array();
-        $table_alias_with_model_relation_chain_prefix = EE_Model_Parser::extract_table_alias_model_relation_chain_prefix($model_relation_chain,
-            $this->get_this_model_name());
-        foreach ($fields as $field_obj) {
-            $selects[] = $table_alias_with_model_relation_chain_prefix
-                         . $field_obj->get_table_alias()
-                         . "."
-                         . $field_obj->get_table_column()
-                         . " AS '"
-                         . $table_alias_with_model_relation_chain_prefix
-                         . $field_obj->get_table_alias()
-                         . "."
-                         . $field_obj->get_table_column()
-                         . "'";
-        }
-        //make sure we are also getting the PKs of each table
-        $tables = $this->get_tables();
-        if (count($tables) > 1) {
-            foreach ($tables as $table_obj) {
-                $qualified_pk_column = $table_alias_with_model_relation_chain_prefix
-                                       . $table_obj->get_fully_qualified_pk_column();
-                if ( ! in_array($qualified_pk_column, $selects)) {
-                    $selects[] = "$qualified_pk_column AS '$qualified_pk_column'";
-                }
-            }
-        }
-        return $selects;
-    }
-
-
-
-    /**
-     * Given a $query_param like 'Registration.Transaction.TXN_ID', pops off 'Registration.',
-     * gets the join statement for it; gets the data types for it; and passes the remaining 'Transaction.TXN_ID'
-     * onto its related Transaction object to do the same. Returns an EE_Join_And_Data_Types object which contains the
-     * SQL for joining, and the data types
-     *
-     * @param null|string                 $original_query_param
-     * @param string                      $query_param          like Registration.Transaction.TXN_ID
-     * @param EE_Model_Query_Info_Carrier $passed_in_query_info
-     * @param    string                   $query_param_type     like Registration.Transaction.TXN_ID
-     *                                                          or 'PAY_ID'. Otherwise, we don't expect there to be a
-     *                                                          column name. We only want model names, eg 'Event.Venue'
-     *                                                          or 'Registration's
-     * @param string                      $original_query_param what it originally was (eg
-     *                                                          Registration.Transaction.TXN_ID). If null, we assume it
-     *                                                          matches $query_param
-     * @throws EE_Error
-     * @return void only modifies the EEM_Related_Model_Info_Carrier passed into it
-     */
-    private function _extract_related_model_info_from_query_param(
-        $query_param,
-        EE_Model_Query_Info_Carrier $passed_in_query_info,
-        $query_param_type,
-        $original_query_param = null
-    ) {
-        if ($original_query_param === null) {
-            $original_query_param = $query_param;
-        }
-        $query_param = $this->_remove_stars_and_anything_after_from_condition_query_param_key($query_param);
-        /** @var $allow_logic_query_params bool whether or not to allow logic_query_params like 'NOT','OR', or 'AND' */
-        $allow_logic_query_params = in_array($query_param_type, array('where', 'having'));
-        $allow_fields = in_array($query_param_type, array('where', 'having', 'order_by', 'group_by', 'order'));
-        //check to see if we have a field on this model
-        $this_model_fields = $this->field_settings(true);
-        if (array_key_exists($query_param, $this_model_fields)) {
-            if ($allow_fields) {
-                return;
-            } else {
-                throw new EE_Error(sprintf(__("Using a field name (%s) on model %s is not allowed on this query param type '%s'. Original query param was %s",
-                    "event_espresso"),
-                    $query_param, get_class($this), $query_param_type, $original_query_param));
-            }
-        } //check if this is a special logic query param
-        elseif (in_array($query_param, $this->_logic_query_param_keys, true)) {
-            if ($allow_logic_query_params) {
-                return;
-            } else {
-                throw new EE_Error(
-                    sprintf(
-                        __('Logic query params ("%1$s") are being used incorrectly with the following query param ("%2$s") on model %3$s. %4$sAdditional Info:%4$s%5$s',
-                            'event_espresso'),
-                        implode('", "', $this->_logic_query_param_keys),
-                        $query_param,
-                        get_class($this),
-                        '<br />',
-                        "\t"
-                        . ' $passed_in_query_info = <pre>'
-                        . print_r($passed_in_query_info, true)
-                        . '</pre>'
-                        . "\n\t"
-                        . ' $query_param_type = '
-                        . $query_param_type
-                        . "\n\t"
-                        . ' $original_query_param = '
-                        . $original_query_param
-                    )
-                );
-            }
-        } //check if it's a custom selection
-        elseif (array_key_exists($query_param, $this->_custom_selections)) {
-            return;
-        }
-        //check if has a model name at the beginning
-        //and
-        //check if it's a field on a related model
-        foreach ($this->_model_relations as $valid_related_model_name => $relation_obj) {
-            if (strpos($query_param, $valid_related_model_name . ".") === 0) {
-                $this->_add_join_to_model($valid_related_model_name, $passed_in_query_info, $original_query_param);
-                $query_param = substr($query_param, strlen($valid_related_model_name . "."));
-                if ($query_param === '') {
-                    //nothing left to $query_param
-                    //we should actually end in a field name, not a model like this!
-                    throw new EE_Error(sprintf(__("Query param '%s' (of type %s on model %s) shouldn't end on a period (.) ",
-                        "event_espresso"),
-                        $query_param, $query_param_type, get_class($this), $valid_related_model_name));
-                } else {
-                    $related_model_obj = $this->get_related_model_obj($valid_related_model_name);
-                    $related_model_obj->_extract_related_model_info_from_query_param($query_param,
-                        $passed_in_query_info, $query_param_type, $original_query_param);
-                    return;
-                }
-            } elseif ($query_param === $valid_related_model_name) {
-                $this->_add_join_to_model($valid_related_model_name, $passed_in_query_info, $original_query_param);
-                return;
-            }
-        }
-        //ok so $query_param didn't start with a model name
-        //and we previously confirmed it wasn't a logic query param or field on the current model
-        //it's wack, that's what it is
-        throw new EE_Error(sprintf(__("There is no model named '%s' related to %s. Query param type is %s and original query param is %s",
-            "event_espresso"),
-            $query_param, get_class($this), $query_param_type, $original_query_param));
-    }
-
-
-
-    /**
-     * Privately used by _extract_related_model_info_from_query_param to add a join to $model_name
-     * and store it on $passed_in_query_info
-     *
-     * @param string                      $model_name
-     * @param EE_Model_Query_Info_Carrier $passed_in_query_info
-     * @param string                      $original_query_param used to extract the relation chain between the queried
-     *                                                          model and $model_name. Eg, if we are querying Event,
-     *                                                          and are adding a join to 'Payment' with the original
-     *                                                          query param key
-     *                                                          'Registration.Transaction.Payment.PAY_amount', we want
-     *                                                          to extract 'Registration.Transaction.Payment', in case
-     *                                                          Payment wants to add default query params so that it
-     *                                                          will know what models to prepend onto its default query
-     *                                                          params or in case it wants to rename tables (in case
-     *                                                          there are multiple joins to the same table)
-     * @return void
-     * @throws \EE_Error
-     */
-    private function _add_join_to_model(
-        $model_name,
-        EE_Model_Query_Info_Carrier $passed_in_query_info,
-        $original_query_param
-    ) {
-        $relation_obj = $this->related_settings_for($model_name);
-        $model_relation_chain = EE_Model_Parser::extract_model_relation_chain($model_name, $original_query_param);
-        //check if the relation is HABTM, because then we're essentially doing two joins
-        //If so, join first to the JOIN table, and add its data types, and then continue as normal
-        if ($relation_obj instanceof EE_HABTM_Relation) {
-            $join_model_obj = $relation_obj->get_join_model();
-            //replace the model specified with the join model for this relation chain, whi
-            $relation_chain_to_join_model = EE_Model_Parser::replace_model_name_with_join_model_name_in_model_relation_chain($model_name,
-                $join_model_obj->get_this_model_name(), $model_relation_chain);
-            $new_query_info = new EE_Model_Query_Info_Carrier(
-                array($relation_chain_to_join_model => $join_model_obj->get_this_model_name()),
-                $relation_obj->get_join_to_intermediate_model_statement($relation_chain_to_join_model));
-            $passed_in_query_info->merge($new_query_info);
-        }
-        //now just join to the other table pointed to by the relation object, and add its data types
-        $new_query_info = new EE_Model_Query_Info_Carrier(
-            array($model_relation_chain => $model_name),
-            $relation_obj->get_join_statement($model_relation_chain));
-        $passed_in_query_info->merge($new_query_info);
-    }
-
-
-
-    /**
-     * Constructs SQL for where clause, like "WHERE Event.ID = 23 AND Transaction.amount > 100" etc.
-     *
-     * @param array $where_params like EEM_Base::get_all
-     * @return string of SQL
-     * @throws \EE_Error
-     */
-    private function _construct_where_clause($where_params)
-    {
-        $SQL = $this->_construct_condition_clause_recursive($where_params, ' AND ');
-        if ($SQL) {
-            return " WHERE " . $SQL;
-        } else {
-            return '';
-        }
-    }
-
-
-
-    /**
-     * Just like the _construct_where_clause, except prepends 'HAVING' instead of 'WHERE',
-     * and should be passed HAVING parameters, not WHERE parameters
-     *
-     * @param array $having_params
-     * @return string
-     * @throws \EE_Error
-     */
-    private function _construct_having_clause($having_params)
-    {
-        $SQL = $this->_construct_condition_clause_recursive($having_params, ' AND ');
-        if ($SQL) {
-            return " HAVING " . $SQL;
-        } else {
-            return '';
-        }
-    }
-
-
-
-    /**
-     * Gets the EE_Model_Field on the model indicated by $model_name and the $field_name.
-     * Eg, if called with _get_field_on_model('ATT_ID','Attendee'), it will return the EE_Primary_Key_Field on
-     * EEM_Attendee.
-     *
-     * @param string $field_name
-     * @param string $model_name
-     * @return EE_Model_Field_Base
-     * @throws EE_Error
-     */
-    protected function _get_field_on_model($field_name, $model_name)
-    {
-        $model_class = 'EEM_' . $model_name;
-        $model_filepath = $model_class . ".model.php";
-        if (is_readable($model_filepath)) {
-            require_once($model_filepath);
-            $model_instance = call_user_func($model_name . "::instance");
-            /* @var $model_instance EEM_Base */
-            return $model_instance->field_settings_for($field_name);
-        } else {
-            throw new EE_Error(sprintf(__('No model named %s exists, with classname %s and filepath %s',
-                'event_espresso'), $model_name, $model_class, $model_filepath));
-        }
-    }
-
-
-
-    /**
-     * Used for creating nested WHERE conditions. Eg "WHERE ! (Event.ID = 3 OR ( Event_Meta.meta_key = 'bob' AND
-     * Event_Meta.meta_value = 'foo'))"
-     *
-     * @param array  $where_params see EEM_Base::get_all for documentation
-     * @param string $glue         joins each subclause together. Should really only be " AND " or " OR "...
-     * @throws EE_Error
-     * @return string of SQL
-     */
-    private function _construct_condition_clause_recursive($where_params, $glue = ' AND')
-    {
-        $where_clauses = array();
-        foreach ($where_params as $query_param => $op_and_value_or_sub_condition) {
-            $query_param = $this->_remove_stars_and_anything_after_from_condition_query_param_key($query_param);//str_replace("*",'',$query_param);
-            if (in_array($query_param, $this->_logic_query_param_keys)) {
-                switch ($query_param) {
-                    case 'not':
-                    case 'NOT':
-                        $where_clauses[] = "! ("
-                                           . $this->_construct_condition_clause_recursive($op_and_value_or_sub_condition,
-                                $glue)
-                                           . ")";
-                        break;
-                    case 'and':
-                    case 'AND':
-                        $where_clauses[] = " ("
-                                           . $this->_construct_condition_clause_recursive($op_and_value_or_sub_condition,
-                                ' AND ')
-                                           . ")";
-                        break;
-                    case 'or':
-                    case 'OR':
-                        $where_clauses[] = " ("
-                                           . $this->_construct_condition_clause_recursive($op_and_value_or_sub_condition,
-                                ' OR ')
-                                           . ")";
-                        break;
-                }
-            } else {
-                $field_obj = $this->_deduce_field_from_query_param($query_param);
-                //if it's not a normal field, maybe it's a custom selection?
-                if ( ! $field_obj) {
-                    if (isset($this->_custom_selections[$query_param][1])) {
-                        $field_obj = $this->_custom_selections[$query_param][1];
-                    } else {
-                        throw new EE_Error(sprintf(__("%s is neither a valid model field name, nor a custom selection",
-                            "event_espresso"), $query_param));
-                    }
-                }
-                $op_and_value_sql = $this->_construct_op_and_value($op_and_value_or_sub_condition, $field_obj);
-                $where_clauses[] = $this->_deduce_column_name_from_query_param($query_param) . SP . $op_and_value_sql;
-            }
-        }
-        return $where_clauses ? implode($glue, $where_clauses) : '';
-    }
-
-
-
-    /**
-     * Takes the input parameter and extract the table name (alias) and column name
-     *
-     * @param array $query_param like Registration.Transaction.TXN_ID, Event.Datetime.start_time, or REG_ID
-     * @throws EE_Error
-     * @return string table alias and column name for SQL, eg "Transaction.TXN_ID"
-     */
-    private function _deduce_column_name_from_query_param($query_param)
-    {
-        $field = $this->_deduce_field_from_query_param($query_param);
-        if ($field) {
-            $table_alias_prefix = EE_Model_Parser::extract_table_alias_model_relation_chain_from_query_param($field->get_model_name(),
-                $query_param);
-            return $table_alias_prefix . $field->get_qualified_column();
-        } elseif (array_key_exists($query_param, $this->_custom_selections)) {
-            //maybe it's custom selection item?
-            //if so, just use it as the "column name"
-            return $query_param;
-        } else {
-            throw new EE_Error(sprintf(__("%s is not a valid field on this model, nor a custom selection (%s)",
-                "event_espresso"), $query_param, implode(",", $this->_custom_selections)));
-        }
-    }
-
-
-
-    /**
-     * Removes the * and anything after it from the condition query param key. It is useful to add the * to condition
-     * query param keys (eg, 'OR*', 'EVT_ID') in order for the array keys to still be unique, so that they don't get
-     * overwritten Takes a string like 'Event.EVT_ID*', 'TXN_total**', 'OR*1st', and 'DTT_reg_start*foobar' to
-     * 'Event.EVT_ID', 'TXN_total', 'OR', and 'DTT_reg_start', respectively.
-     *
-     * @param string $condition_query_param_key
-     * @return string
-     */
-    private function _remove_stars_and_anything_after_from_condition_query_param_key($condition_query_param_key)
-    {
-        $pos_of_star = strpos($condition_query_param_key, '*');
-        if ($pos_of_star === false) {
-            return $condition_query_param_key;
-        } else {
-            $condition_query_param_sans_star = substr($condition_query_param_key, 0, $pos_of_star);
-            return $condition_query_param_sans_star;
-        }
-    }
-
-
-
-    /**
-     * creates the SQL for the operator and the value in a WHERE clause, eg "< 23" or "LIKE '%monkey%'"
-     *
-     * @param                            mixed      array | string    $op_and_value
-     * @param EE_Model_Field_Base|string $field_obj . If string, should be one of EEM_Base::_valid_wpdb_data_types
-     * @throws EE_Error
-     * @return string
-     */
-    private function _construct_op_and_value($op_and_value, $field_obj)
-    {
-        if (is_array($op_and_value)) {
-            $operator = isset($op_and_value[0]) ? $this->_prepare_operator_for_sql($op_and_value[0]) : null;
-            if ( ! $operator) {
-                $php_array_like_string = array();
-                foreach ($op_and_value as $key => $value) {
-                    $php_array_like_string[] = "$key=>$value";
-                }
-                throw new EE_Error(
-                    sprintf(
-                        __(
-                            "You setup a query parameter like you were going to specify an operator, but didn't. You provided '(%s)', but the operator should be at array key index 0 (eg array('>',32))",
-                            "event_espresso"
-                        ),
-                        implode(",", $php_array_like_string)
-                    )
-                );
-            }
-            $value = isset($op_and_value[1]) ? $op_and_value[1] : null;
-        } else {
-            $operator = '=';
-            $value = $op_and_value;
-        }
-        //check to see if the value is actually another field
-        if (is_array($op_and_value) && isset($op_and_value[2]) && $op_and_value[2] == true) {
-            return $operator . SP . $this->_deduce_column_name_from_query_param($value);
-        } elseif (in_array($operator, $this->_in_style_operators) && is_array($value)) {
-            //in this case, the value should be an array, or at least a comma-separated list
-            //it will need to handle a little differently
-            $cleaned_value = $this->_construct_in_value($value, $field_obj);
-            //note: $cleaned_value has already been run through $wpdb->prepare()
-            return $operator . SP . $cleaned_value;
-        } elseif (in_array($operator, $this->_between_style_operators) && is_array($value)) {
-            //the value should be an array with count of two.
-            if (count($value) !== 2) {
-                throw new EE_Error(
-                    sprintf(
-                        __(
-                            "The '%s' operator must be used with an array of values and there must be exactly TWO values in that array.",
-                            'event_espresso'
-                        ),
-                        "BETWEEN"
-                    )
-                );
-            }
-            $cleaned_value = $this->_construct_between_value($value, $field_obj);
-            return $operator . SP . $cleaned_value;
-        } elseif (in_array($operator, $this->_null_style_operators)) {
-            if ($value !== null) {
-                throw new EE_Error(
-                    sprintf(
-                        __(
-                            "You attempted to give a value  (%s) while using a NULL-style operator (%s). That isn't valid",
-                            "event_espresso"
-                        ),
-                        $value,
-                        $operator
-                    )
-                );
-            }
-            return $operator;
-        } elseif ($operator === 'LIKE' && ! is_array($value)) {
-            //if the operator is 'LIKE', we want to allow percent signs (%) and not
-            //remove other junk. So just treat it as a string.
-            return $operator . SP . $this->_wpdb_prepare_using_field($value, '%s');
-        } elseif ( ! in_array($operator, $this->_in_style_operators) && ! is_array($value)) {
-            return $operator . SP . $this->_wpdb_prepare_using_field($value, $field_obj);
-        } elseif (in_array($operator, $this->_in_style_operators) && ! is_array($value)) {
-            throw new EE_Error(
-                sprintf(
-                    __(
-                        "Operator '%s' must be used with an array of values, eg 'Registration.REG_ID' => array('%s',array(1,2,3))",
-                        'event_espresso'
-                    ),
-                    $operator,
-                    $operator
-                )
-            );
-        } elseif ( ! in_array($operator, $this->_in_style_operators) && is_array($value)) {
-            throw new EE_Error(
-                sprintf(
-                    __(
-                        "Operator '%s' must be used with a single value, not an array. Eg 'Registration.REG_ID => array('%s',23))",
-                        'event_espresso'
-                    ),
-                    $operator,
-                    $operator
-                )
-            );
-        } else {
-            throw new EE_Error(
-                sprintf(
-                    __(
-                        "It appears you've provided some totally invalid query parameters. Operator and value were:'%s', which isn't right at all",
-                        "event_espresso"
-                    ),
-                    http_build_query($op_and_value)
-                )
-            );
-        }
-    }
-
-
-
-    /**
-     * Creates the operands to be used in a BETWEEN query, eg "'2014-12-31 20:23:33' AND '2015-01-23 12:32:54'"
-     *
-     * @param array                      $values
-     * @param EE_Model_Field_Base|string $field_obj if string, it should be the datatype to be used when querying, eg
-     *                                              '%s'
-     * @return string
-     * @throws \EE_Error
-     */
-    public function _construct_between_value($values, $field_obj)
-    {
-        $cleaned_values = array();
-        foreach ($values as $value) {
-            $cleaned_values[] = $this->_wpdb_prepare_using_field($value, $field_obj);
-        }
-        return $cleaned_values[0] . " AND " . $cleaned_values[1];
-    }
-
-
-
-    /**
-     * Takes an array or a comma-separated list of $values and cleans them
-     * according to $data_type using $wpdb->prepare, and then makes the list a
-     * string surrounded by ( and ). Eg, _construct_in_value(array(1,2,3),'%d') would
-     * return '(1,2,3)'; _construct_in_value("1,2,hack",'%d') would return '(1,2,1)' (assuming
-     * I'm right that a string, when interpreted as a digit, becomes a 1. It might become a 0)
-     *
-     * @param mixed                      $values    array or comma-separated string
-     * @param EE_Model_Field_Base|string $field_obj if string, it should be a wpdb data type like '%s', or '%d'
-     * @return string of SQL to follow an 'IN' or 'NOT IN' operator
-     * @throws \EE_Error
-     */
-    public function _construct_in_value($values, $field_obj)
-    {
-        //check if the value is a CSV list
-        if (is_string($values)) {
-            //in which case, turn it into an array
-            $values = explode(",", $values);
-        }
-        $cleaned_values = array();
-        foreach ($values as $value) {
-            $cleaned_values[] = $this->_wpdb_prepare_using_field($value, $field_obj);
-        }
-        //we would just LOVE to leave $cleaned_values as an empty array, and return the value as "()",
-        //but unfortunately that's invalid SQL. So instead we return a string which we KNOW will evaluate to be the empty set
-        //which is effectively equivalent to returning "()". We don't return "(0)" because that only works for auto-incrementing columns
-        if (empty($cleaned_values)) {
-            $all_fields = $this->field_settings();
-            $a_field = array_shift($all_fields);
-            $main_table = $this->_get_main_table();
-            $cleaned_values[] = "SELECT "
-                                . $a_field->get_table_column()
-                                . " FROM "
-                                . $main_table->get_table_name()
-                                . " WHERE FALSE";
-        }
-        return "(" . implode(",", $cleaned_values) . ")";
-    }
-
-
-
-    /**
-     * @param mixed                      $value
-     * @param EE_Model_Field_Base|string $field_obj if string it should be a wpdb data type like '%d'
-     * @throws EE_Error
-     * @return false|null|string
-     */
-    private function _wpdb_prepare_using_field($value, $field_obj)
-    {
-        /** @type WPDB $wpdb */
-        global $wpdb;
-        if ($field_obj instanceof EE_Model_Field_Base) {
-            return $wpdb->prepare($field_obj->get_wpdb_data_type(),
-                $this->_prepare_value_for_use_in_db($value, $field_obj));
-        } else {//$field_obj should really just be a data type
-            if ( ! in_array($field_obj, $this->_valid_wpdb_data_types)) {
-                throw new EE_Error(sprintf(__("%s is not a valid wpdb datatype. Valid ones are %s", "event_espresso"),
-                    $field_obj, implode(",", $this->_valid_wpdb_data_types)));
-            }
-            return $wpdb->prepare($field_obj, $value);
-        }
-    }
-
-
-
-    /**
-     * Takes the input parameter and finds the model field that it indicates.
-     *
-     * @param string $query_param_name like Registration.Transaction.TXN_ID, Event.Datetime.start_time, or REG_ID
-     * @throws EE_Error
-     * @return EE_Model_Field_Base
-     */
-    protected function _deduce_field_from_query_param($query_param_name)
-    {
-        //ok, now proceed with deducing which part is the model's name, and which is the field's name
-        //which will help us find the database table and column
-        $query_param_parts = explode(".", $query_param_name);
-        if (empty($query_param_parts)) {
-            throw new EE_Error(sprintf(__("_extract_column_name is empty when trying to extract column and table name from %s",
-                'event_espresso'), $query_param_name));
-        }
-        $number_of_parts = count($query_param_parts);
-        $last_query_param_part = $query_param_parts[count($query_param_parts) - 1];
-        if ($number_of_parts === 1) {
-            $field_name = $last_query_param_part;
-            $model_obj = $this;
-        } else {// $number_of_parts >= 2
-            //the last part is the column name, and there are only 2parts. therefore...
-            $field_name = $last_query_param_part;
-            $model_obj = $this->get_related_model_obj($query_param_parts[$number_of_parts - 2]);
-        }
-        try {
-            return $model_obj->field_settings_for($field_name);
-        } catch (EE_Error $e) {
-            return null;
-        }
-    }
-
-
-
-    /**
-     * Given a field's name (ie, a key in $this->field_settings()), uses the EE_Model_Field object to get the table's
-     * alias and column which corresponds to it
-     *
-     * @param string $field_name
-     * @throws EE_Error
-     * @return string
-     */
-    public function _get_qualified_column_for_field($field_name)
-    {
-        $all_fields = $this->field_settings();
-        $field = isset($all_fields[$field_name]) ? $all_fields[$field_name] : false;
-        if ($field) {
-            return $field->get_qualified_column();
-        } else {
-            throw new EE_Error(sprintf(__("There is no field titled %s on model %s. Either the query trying to use it is bad, or you need to add it to the list of fields on the model.",
-                'event_espresso'), $field_name, get_class($this)));
-        }
-    }
-
-
-
-    /**
-     * constructs the select use on special limit joins
-     * NOTE: for now this has only been tested and will work when the  table alias is for the PRIMARY table. Although
-     * its setup so the select query will be setup on and just doing the special select join off of the primary table
-     * (as that is typically where the limits would be set).
-     *
-     * @param  string       $table_alias The table the select is being built for
-     * @param  mixed|string $limit       The limit for this select
-     * @return string                The final select join element for the query.
-     */
-    public function _construct_limit_join_select($table_alias, $limit)
-    {
-        $SQL = '';
-        foreach ($this->_tables as $table_obj) {
-            if ($table_obj instanceof EE_Primary_Table) {
-                $SQL .= $table_alias === $table_obj->get_table_alias()
-                    ? $table_obj->get_select_join_limit($limit)
-                    : SP . $table_obj->get_table_name() . " AS " . $table_obj->get_table_alias() . SP;
-            } elseif ($table_obj instanceof EE_Secondary_Table) {
-                $SQL .= $table_alias === $table_obj->get_table_alias()
-                    ? $table_obj->get_select_join_limit_join($limit)
-                    : SP . $table_obj->get_join_sql($table_alias) . SP;
-            }
-        }
-        return $SQL;
-    }
-
-
-
-    /**
-     * Constructs the internal join if there are multiple tables, or simply the table's name and alias
-     * Eg "wp_post AS Event" or "wp_post AS Event INNER JOIN wp_postmeta Event_Meta ON Event.ID = Event_Meta.post_id"
-     *
-     * @return string SQL
-     * @throws \EE_Error
-     */
-    public function _construct_internal_join()
-    {
-        $SQL = $this->_get_main_table()->get_table_sql();
-        $SQL .= $this->_construct_internal_join_to_table_with_alias($this->_get_main_table()->get_table_alias());
-        return $SQL;
-    }
-
-
-
-    /**
-     * Constructs the SQL for joining all the tables on this model.
-     * Normally $alias should be the primary table's alias, but in cases where
-     * we have already joined to a secondary table (eg, the secondary table has a foreign key and is joined before the
-     * primary table) then we should provide that secondary table's alias. Eg, with $alias being the primary table's
-     * alias, this will construct SQL like:
-     * " INNER JOIN wp_esp_secondary_table AS Secondary_Table ON Primary_Table.pk = Secondary_Table.fk".
-     * With $alias being a secondary table's alias, this will construct SQL like:
-     * " INNER JOIN wp_esp_primary_table AS Primary_Table ON Primary_Table.pk = Secondary_Table.fk".
-     *
-     * @param string $alias_prefixed table alias to join to (this table should already be in the FROM SQL clause)
-     * @return string
-     */
-    public function _construct_internal_join_to_table_with_alias($alias_prefixed)
-    {
-        $SQL = '';
-        $alias_sans_prefix = EE_Model_Parser::remove_table_alias_model_relation_chain_prefix($alias_prefixed);
-        foreach ($this->_tables as $table_obj) {
-            if ($table_obj instanceof EE_Secondary_Table) {//table is secondary table
-                if ($alias_sans_prefix === $table_obj->get_table_alias()) {
-                    //so we're joining to this table, meaning the table is already in
-                    //the FROM statement, BUT the primary table isn't. So we want
-                    //to add the inverse join sql
-                    $SQL .= $table_obj->get_inverse_join_sql($alias_prefixed);
-                } else {
-                    //just add a regular JOIN to this table from the primary table
-                    $SQL .= $table_obj->get_join_sql($alias_prefixed);
-                }
-            }//if it's a primary table, dont add any SQL. it should already be in the FROM statement
-        }
-        return $SQL;
-    }
-
-
-
-    /**
-     * Gets an array for storing all the data types on the next-to-be-executed-query.
-     * This should be a growing array of keys being table-columns (eg 'EVT_ID' and 'Event.EVT_ID'), and values being
-     * their data type (eg, '%s', '%d', etc)
-     *
-     * @return array
-     */
-    public function _get_data_types()
-    {
-        $data_types = array();
-        foreach ($this->field_settings() as $field_obj) {
-            //$data_types[$field_obj->get_table_column()] = $field_obj->get_wpdb_data_type();
-            /** @var $field_obj EE_Model_Field_Base */
-            $data_types[$field_obj->get_qualified_column()] = $field_obj->get_wpdb_data_type();
-        }
-        return $data_types;
-    }
-
-
-
-    /**
-     * Gets the model object given the relation's name / model's name (eg, 'Event', 'Registration',etc. Always singular)
-     *
-     * @param string $model_name
-     * @throws EE_Error
-     * @return EEM_Base
-     */
-    public function get_related_model_obj($model_name)
-    {
-        $model_classname = "EEM_" . $model_name;
-        if ( ! class_exists($model_classname)) {
-            throw new EE_Error(sprintf(__("You specified a related model named %s in your query. No such model exists, if it did, it would have the classname %s",
-                'event_espresso'), $model_name, $model_classname));
-        }
-        return call_user_func($model_classname . "::instance");
-    }
-
-
-
-    /**
-     * Returns the array of EE_ModelRelations for this model.
-     *
-     * @return EE_Model_Relation_Base[]
-     */
-    public function relation_settings()
-    {
-        return $this->_model_relations;
-    }
-
-
-
-    /**
-     * Gets all related models that this model BELONGS TO. Handy to know sometimes
-     * because without THOSE models, this model probably doesn't have much purpose.
-     * (Eg, without an event, datetimes have little purpose.)
-     *
-     * @return EE_Belongs_To_Relation[]
-     */
-    public function belongs_to_relations()
-    {
-        $belongs_to_relations = array();
-        foreach ($this->relation_settings() as $model_name => $relation_obj) {
-            if ($relation_obj instanceof EE_Belongs_To_Relation) {
-                $belongs_to_relations[$model_name] = $relation_obj;
-            }
-        }
-        return $belongs_to_relations;
-    }
-
-
-
-    /**
-     * Returns the specified EE_Model_Relation, or throws an exception
-     *
-     * @param string $relation_name name of relation, key in $this->_relatedModels
-     * @throws EE_Error
-     * @return EE_Model_Relation_Base
-     */
-    public function related_settings_for($relation_name)
-    {
-        $relatedModels = $this->relation_settings();
-        if ( ! array_key_exists($relation_name, $relatedModels)) {
-            throw new EE_Error(
-                sprintf(
-                    __('Cannot get %s related to %s. There is no model relation of that type. There is, however, %s...',
-                        'event_espresso'),
-                    $relation_name,
-                    $this->_get_class_name(),
-                    implode(', ', array_keys($relatedModels))
-                )
-            );
-        }
-        return $relatedModels[$relation_name];
-    }
-
-
-
-    /**
-     * A convenience method for getting a specific field's settings, instead of getting all field settings for all
-     * fields
-     *
-     * @param string $fieldName
-     * @throws EE_Error
-     * @return EE_Model_Field_Base
-     */
-    public function field_settings_for($fieldName)
-    {
-        $fieldSettings = $this->field_settings(true);
-        if ( ! array_key_exists($fieldName, $fieldSettings)) {
-            throw new EE_Error(sprintf(__("There is no field/column '%s' on '%s'", 'event_espresso'), $fieldName,
-                get_class($this)));
-        }
-        return $fieldSettings[$fieldName];
-    }
-
-
-
-    /**
-     * Checks if this field exists on this model
-     *
-     * @param string $fieldName a key in the model's _field_settings array
-     * @return boolean
-     */
-    public function has_field($fieldName)
-    {
-        $fieldSettings = $this->field_settings(true);
-        if (isset($fieldSettings[$fieldName])) {
-            return true;
-        } else {
-            return false;
-        }
-    }
-
-
-
-    /**
-     * Returns whether or not this model has a relation to the specified model
-     *
-     * @param string $relation_name possibly one of the keys in the relation_settings array
-     * @return boolean
-     */
-    public function has_relation($relation_name)
-    {
-        $relations = $this->relation_settings();
-        if (isset($relations[$relation_name])) {
-            return true;
-        } else {
-            return false;
-        }
-    }
-
-
-
-    /**
-     * gets the field object of type 'primary_key' from the fieldsSettings attribute.
-     * Eg, on EE_Answer that would be ANS_ID field object
-     *
-     * @param $field_obj
-     * @return boolean
-     */
-    public function is_primary_key_field($field_obj)
-    {
-        return $field_obj instanceof EE_Primary_Key_Field_Base ? true : false;
-    }
-
-
-
-    /**
-     * gets the field object of type 'primary_key' from the fieldsSettings attribute.
-     * Eg, on EE_Answer that would be ANS_ID field object
-     *
-     * @return EE_Model_Field_Base
-     * @throws EE_Error
-     */
-    public function get_primary_key_field()
-    {
-        if ($this->_primary_key_field === null) {
-            foreach ($this->field_settings(true) as $field_obj) {
-                if ($this->is_primary_key_field($field_obj)) {
-                    $this->_primary_key_field = $field_obj;
-                    break;
-                }
-            }
-            if ( ! $this->_primary_key_field instanceof EE_Primary_Key_Field_Base) {
-                throw new EE_Error(sprintf(__("There is no Primary Key defined on model %s", 'event_espresso'),
-                    get_class($this)));
-            }
-        }
-        return $this->_primary_key_field;
-    }
-
-
-
-    /**
-     * Returns whether or not not there is a primary key on this model.
-     * Internally does some caching.
-     *
-     * @return boolean
-     */
-    public function has_primary_key_field()
-    {
-        if ($this->_has_primary_key_field === null) {
-            try {
-                $this->get_primary_key_field();
-                $this->_has_primary_key_field = true;
-            } catch (EE_Error $e) {
-                $this->_has_primary_key_field = false;
-            }
-        }
-        return $this->_has_primary_key_field;
-    }
-
-
-
-    /**
-     * Finds the first field of type $field_class_name.
-     *
-     * @param string $field_class_name class name of field that you want to find. Eg, EE_Datetime_Field,
-     *                                 EE_Foreign_Key_Field, etc
-     * @return EE_Model_Field_Base or null if none is found
-     */
-    public function get_a_field_of_type($field_class_name)
-    {
-        foreach ($this->field_settings() as $field) {
-            if ($field instanceof $field_class_name) {
-                return $field;
-            }
-        }
-        return null;
-    }
-
-
-
-    /**
-     * Gets a foreign key field pointing to model.
-     *
-     * @param string $model_name eg Event, Registration, not EEM_Event
-     * @return EE_Foreign_Key_Field_Base
-     * @throws EE_Error
-     */
-    public function get_foreign_key_to($model_name)
-    {
-        if ( ! isset($this->_cache_foreign_key_to_fields[$model_name])) {
-            foreach ($this->field_settings() as $field) {
-                if (
-                    $field instanceof EE_Foreign_Key_Field_Base
-                    && in_array($model_name, $field->get_model_names_pointed_to())
-                ) {
-                    $this->_cache_foreign_key_to_fields[$model_name] = $field;
-                    break;
-                }
-            }
-            if ( ! isset($this->_cache_foreign_key_to_fields[$model_name])) {
-                throw new EE_Error(sprintf(__("There is no foreign key field pointing to model %s on model %s",
-                    'event_espresso'), $model_name, get_class($this)));
-            }
-        }
-        return $this->_cache_foreign_key_to_fields[$model_name];
-    }
-
-
-
-    /**
-     * Gets the actual table for the table alias
-     *
-     * @param string $table_alias eg Event, Event_Meta, Registration, Transaction, but maybe
-     *                            a table alias with a model chain prefix, like 'Venue__Event_Venue___Event_Meta'.
-     *                            Either one works
-     * @return EE_Table_Base
-     */
-    public function get_table_for_alias($table_alias)
-    {
-        $table_alias_sans_model_relation_chain_prefix = EE_Model_Parser::remove_table_alias_model_relation_chain_prefix($table_alias);
-        return $this->_tables[$table_alias_sans_model_relation_chain_prefix]->get_table_name();
-    }
-
-
-
-    /**
-     * Returns a flat array of all field son this model, instead of organizing them
-     * by table_alias as they are in the constructor.
-     *
-     * @param bool $include_db_only_fields flag indicating whether or not to include the db-only fields
-     * @return EE_Model_Field_Base[] where the keys are the field's name
-     */
-    public function field_settings($include_db_only_fields = false)
-    {
-        if ($include_db_only_fields) {
-            if ($this->_cached_fields === null) {
-                $this->_cached_fields = array();
-                foreach ($this->_fields as $fields_corresponding_to_table) {
-                    foreach ($fields_corresponding_to_table as $field_name => $field_obj) {
-                        $this->_cached_fields[$field_name] = $field_obj;
-                    }
-                }
-            }
-            return $this->_cached_fields;
-        } else {
-            if ($this->_cached_fields_non_db_only === null) {
-                $this->_cached_fields_non_db_only = array();
-                foreach ($this->_fields as $fields_corresponding_to_table) {
-                    foreach ($fields_corresponding_to_table as $field_name => $field_obj) {
-                        /** @var $field_obj EE_Model_Field_Base */
-                        if ( ! $field_obj->is_db_only_field()) {
-                            $this->_cached_fields_non_db_only[$field_name] = $field_obj;
-                        }
-                    }
-                }
-            }
-            return $this->_cached_fields_non_db_only;
-        }
-    }
-
-
-
-    /**
-     *        cycle though array of attendees and create objects out of each item
-     *
-     * @access        private
-     * @param        array $rows of results of $wpdb->get_results($query,ARRAY_A)
-     * @return \EE_Base_Class[] array keys are primary keys (if there is a primary key on the model. if not,
-     *                           numerically indexed)
-     * @throws \EE_Error
-     */
-    protected function _create_objects($rows = array())
-    {
-        $array_of_objects = array();
-        if (empty($rows)) {
-            return array();
-        }
-        $count_if_model_has_no_primary_key = 0;
-        $has_primary_key = $this->has_primary_key_field();
-        $primary_key_field = $has_primary_key ? $this->get_primary_key_field() : null;
-        foreach ((array)$rows as $row) {
-            if (empty($row)) {
-                //wp did its weird thing where it returns an array like array(0=>null), which is totally not helpful...
-                return array();
-            }
-            //check if we've already set this object in the results array,
-            //in which case there's no need to process it further (again)
-            if ($has_primary_key) {
-                $table_pk_value = $this->_get_column_value_with_table_alias_or_not(
-                    $row,
-                    $primary_key_field->get_qualified_column(),
-                    $primary_key_field->get_table_column()
-                );
-                if ($table_pk_value && isset($array_of_objects[$table_pk_value])) {
-                    continue;
-                }
-            }
-            $classInstance = $this->instantiate_class_from_array_or_object($row);
-            if ( ! $classInstance) {
-                throw new EE_Error(
-                    sprintf(
-                        __('Could not create instance of class %s from row %s', 'event_espresso'),
-                        $this->get_this_model_name(),
-                        http_build_query($row)
-                    )
-                );
-            }
-            //set the timezone on the instantiated objects
-            $classInstance->set_timezone($this->_timezone);
-            //make sure if there is any timezone setting present that we set the timezone for the object
-            $key = $has_primary_key ? $classInstance->ID() : $count_if_model_has_no_primary_key++;
-            $array_of_objects[$key] = $classInstance;
-            //also, for all the relations of type BelongsTo, see if we can cache
-            //those related models
-            //(we could do this for other relations too, but if there are conditions
-            //that filtered out some fo the results, then we'd be caching an incomplete set
-            //so it requires a little more thought than just caching them immediately...)
-            foreach ($this->_model_relations as $modelName => $relation_obj) {
-                if ($relation_obj instanceof EE_Belongs_To_Relation) {
-                    //check if this model's INFO is present. If so, cache it on the model
-                    $other_model = $relation_obj->get_other_model();
-                    $other_model_obj_maybe = $other_model->instantiate_class_from_array_or_object($row);
-                    //if we managed to make a model object from the results, cache it on the main model object
-                    if ($other_model_obj_maybe) {
-                        //set timezone on these other model objects if they are present
-                        $other_model_obj_maybe->set_timezone($this->_timezone);
-                        $classInstance->cache($modelName, $other_model_obj_maybe);
-                    }
-                }
-            }
-        }
-        return $array_of_objects;
-    }
-
-
-
-    /**
-     * The purpose of this method is to allow us to create a model object that is not in the db that holds default
-     * values. A typical example of where this is used is when creating a new item and the initial load of a form.  We
-     * dont' necessarily want to test for if the object is present but just assume it is BUT load the defaults from the
-     * object (as set in the model_field!).
-     *
-     * @return EE_Base_Class single EE_Base_Class object with default values for the properties.
-     */
-    public function create_default_object()
-    {
-        $this_model_fields_and_values = array();
-        //setup the row using default values;
-        foreach ($this->field_settings() as $field_name => $field_obj) {
-            $this_model_fields_and_values[$field_name] = $field_obj->get_default_value();
-        }
-        $className = $this->_get_class_name();
-        $classInstance = EE_Registry::instance()
-                                    ->load_class($className, array($this_model_fields_and_values), false, false);
-        return $classInstance;
-    }
-
-
-
-    /**
-     * @param mixed $cols_n_values either an array of where each key is the name of a field, and the value is its value
-     *                             or an stdClass where each property is the name of a column,
-     * @return EE_Base_Class
-     * @throws \EE_Error
-     */
-    public function instantiate_class_from_array_or_object($cols_n_values)
-    {
-        if ( ! is_array($cols_n_values) && is_object($cols_n_values)) {
-            $cols_n_values = get_object_vars($cols_n_values);
-        }
-        $primary_key = null;
-        //make sure the array only has keys that are fields/columns on this model
-        $this_model_fields_n_values = $this->_deduce_fields_n_values_from_cols_n_values($cols_n_values);
-        if ($this->has_primary_key_field() && isset($this_model_fields_n_values[$this->primary_key_name()])) {
-            $primary_key = $this_model_fields_n_values[$this->primary_key_name()];
-        }
-        $className = $this->_get_class_name();
-        //check we actually found results that we can use to build our model object
-        //if not, return null
-        if ($this->has_primary_key_field()) {
-            if (empty($this_model_fields_n_values[$this->primary_key_name()])) {
-                return null;
-            }
-        } else if ($this->unique_indexes()) {
-            $first_column = reset($this_model_fields_n_values);
-            if (empty($first_column)) {
-                return null;
-            }
-        }
-        // if there is no primary key or the object doesn't already exist in the entity map, then create a new instance
-        if ($primary_key) {
-            $classInstance = $this->get_from_entity_map($primary_key);
-            if ( ! $classInstance) {
-                $classInstance = EE_Registry::instance()
-                                            ->load_class($className,
-                                                array($this_model_fields_n_values, $this->_timezone), true, false);
-                // add this new object to the entity map
-                $classInstance = $this->add_to_entity_map($classInstance);
-            }
-        } else {
-            $classInstance = EE_Registry::instance()
-                                        ->load_class($className, array($this_model_fields_n_values, $this->_timezone),
-                                            true, false);
-        }
-        //it is entirely possible that the instantiated class object has a set timezone_string db field and has set it's internal _timezone property accordingly (see new_instance_from_db in model objects particularly EE_Event for example).  In this case, we want to make sure the model object doesn't have its timezone string overwritten by any timezone property currently set here on the model so, we intentionally override the model _timezone property with the model_object timezone property.
-        $this->set_timezone($classInstance->get_timezone());
-        return $classInstance;
-    }
-
-
-
-    /**
-     * Gets the model object from the  entity map if it exists
-     *
-     * @param int|string $id the ID of the model object
-     * @return EE_Base_Class
-     */
-    public function get_from_entity_map($id)
-    {
-        return isset($this->_entity_map[EEM_Base::$_model_query_blog_id][$id])
-            ? $this->_entity_map[EEM_Base::$_model_query_blog_id][$id] : null;
-    }
-
-
-
-    /**
-     * add_to_entity_map
-     * Adds the object to the model's entity mappings
-     *        Effectively tells the models "Hey, this model object is the most up-to-date representation of the data,
-     *        and for the remainder of the request, it's even more up-to-date than what's in the database.
-     *        So, if the database doesn't agree with what's in the entity mapper, ignore the database"
-     *        If the database gets updated directly and you want the entity mapper to reflect that change,
-     *        then this method should be called immediately after the update query
-     * Note: The map is indexed by whatever the current blog id is set (via EEM_Base::$_model_query_blog_id).  This is
-     * so on multisite, the entity map is specific to the query being done for a specific site.
-     *
-     * @param    EE_Base_Class $object
-     * @throws EE_Error
-     * @return \EE_Base_Class
-     */
-    public function add_to_entity_map(EE_Base_Class $object)
-    {
-        $className = $this->_get_class_name();
-        if ( ! $object instanceof $className) {
-            throw new EE_Error(sprintf(__("You tried adding a %s to a mapping of %ss", "event_espresso"),
-                is_object($object) ? get_class($object) : $object, $className));
-        }
-        /** @var $object EE_Base_Class */
-        if ( ! $object->ID()) {
-            throw new EE_Error(sprintf(__("You tried storing a model object with NO ID in the %s entity mapper.",
-                "event_espresso"), get_class($this)));
-        }
-        // double check it's not already there
-        $classInstance = $this->get_from_entity_map($object->ID());
-        if ($classInstance) {
-            return $classInstance;
-        } else {
-            $this->_entity_map[EEM_Base::$_model_query_blog_id][$object->ID()] = $object;
-            return $object;
-        }
-    }
-
-
-
-    /**
-     * if a valid identifier is provided, then that entity is unset from the entity map,
-     * if no identifier is provided, then the entire entity map is emptied
-     *
-     * @param int|string $id the ID of the model object
-     * @return boolean
-     */
-    public function clear_entity_map($id = null)
-    {
-        if (empty($id)) {
-            $this->_entity_map[EEM_Base::$_model_query_blog_id] = array();
-            return true;
-        }
-        if (isset($this->_entity_map[EEM_Base::$_model_query_blog_id][$id])) {
-            unset($this->_entity_map[EEM_Base::$_model_query_blog_id][$id]);
-            return true;
-        }
-        return false;
-    }
-
-
-
-    /**
-     * Public wrapper for _deduce_fields_n_values_from_cols_n_values.
-     * Given an array where keys are column (or column alias) names and values,
-     * returns an array of their corresponding field names and database values
-     *
-     * @param array $cols_n_values
-     * @return array
-     */
-    public function deduce_fields_n_values_from_cols_n_values($cols_n_values)
-    {
-        return $this->_deduce_fields_n_values_from_cols_n_values($cols_n_values);
-    }
-
-
-
-    /**
-     * _deduce_fields_n_values_from_cols_n_values
-     * Given an array where keys are column (or column alias) names and values,
-     * returns an array of their corresponding field names and database values
-     *
-     * @param string $cols_n_values
-     * @return array
-     */
-    protected function _deduce_fields_n_values_from_cols_n_values($cols_n_values)
-    {
-        $this_model_fields_n_values = array();
-        foreach ($this->get_tables() as $table_alias => $table_obj) {
-            $table_pk_value = $this->_get_column_value_with_table_alias_or_not($cols_n_values,
-                $table_obj->get_fully_qualified_pk_column(), $table_obj->get_pk_column());
-            //there is a primary key on this table and its not set. Use defaults for all its columns
-            if ($table_pk_value === null && $table_obj->get_pk_column()) {
-                foreach ($this->_get_fields_for_table($table_alias) as $field_name => $field_obj) {
-                    if ( ! $field_obj->is_db_only_field()) {
-                        //prepare field as if its coming from db
-                        $prepared_value = $field_obj->prepare_for_set($field_obj->get_default_value());
-                        $this_model_fields_n_values[$field_name] = $field_obj->prepare_for_use_in_db($prepared_value);
-                    }
-                }
-            } else {
-                //the table's rows existed. Use their values
-                foreach ($this->_get_fields_for_table($table_alias) as $field_name => $field_obj) {
-                    if ( ! $field_obj->is_db_only_field()) {
-                        $this_model_fields_n_values[$field_name] = $this->_get_column_value_with_table_alias_or_not(
-                            $cols_n_values, $field_obj->get_qualified_column(),
-                            $field_obj->get_table_column()
-                        );
-                    }
-                }
-            }
-        }
-        return $this_model_fields_n_values;
-    }
-
-
-
-    /**
-     * @param $cols_n_values
-     * @param $qualified_column
-     * @param $regular_column
-     * @return null
-     */
-    protected function _get_column_value_with_table_alias_or_not($cols_n_values, $qualified_column, $regular_column)
-    {
-        $value = null;
-        //ask the field what it think it's table_name.column_name should be, and call it the "qualified column"
-        //does the field on the model relate to this column retrieved from the db?
-        //or is it a db-only field? (not relating to the model)
-        if (isset($cols_n_values[$qualified_column])) {
-            $value = $cols_n_values[$qualified_column];
-        } elseif (isset($cols_n_values[$regular_column])) {
-            $value = $cols_n_values[$regular_column];
-        }
-        return $value;
-    }
-
-
-
-    /**
-     * refresh_entity_map_from_db
-     * Makes sure the model object in the entity map at $id assumes the values
-     * of the database (opposite of EE_base_Class::save())
-     *
-     * @param int|string $id
-     * @return EE_Base_Class
-     * @throws \EE_Error
-     */
-    public function refresh_entity_map_from_db($id)
-    {
-        $obj_in_map = $this->get_from_entity_map($id);
-        if ($obj_in_map) {
-            $wpdb_results = $this->_get_all_wpdb_results(
-                array(array($this->get_primary_key_field()->get_name() => $id), 'limit' => 1)
-            );
-            if ($wpdb_results && is_array($wpdb_results)) {
-                $one_row = reset($wpdb_results);
-                foreach ($this->_deduce_fields_n_values_from_cols_n_values($one_row) as $field_name => $db_value) {
-                    $obj_in_map->set_from_db($field_name, $db_value);
-                }
-                //clear the cache of related model objects
-                foreach ($this->relation_settings() as $relation_name => $relation_obj) {
-                    $obj_in_map->clear_cache($relation_name, null, true);
-                }
-            }
-            return $obj_in_map;
-        } else {
-            return $this->get_one_by_ID($id);
-        }
-    }
-
-
-
-    /**
-     * refresh_entity_map_with
-     * Leaves the entry in the entity map alone, but updates it to match the provided
-     * $replacing_model_obj (which we assume to be its equivalent but somehow NOT in the entity map).
-     * This is useful if you have a model object you want to make authoritative over what's in the entity map currently.
-     * Note: The old $replacing_model_obj should now be destroyed as it's now un-authoritative
-     *
-     * @param int|string    $id
-     * @param EE_Base_Class $replacing_model_obj
-     * @return \EE_Base_Class
-     * @throws \EE_Error
-     */
-    public function refresh_entity_map_with($id, $replacing_model_obj)
-    {
-        $obj_in_map = $this->get_from_entity_map($id);
-        if ($obj_in_map) {
-            if ($replacing_model_obj instanceof EE_Base_Class) {
-                foreach ($replacing_model_obj->model_field_array() as $field_name => $value) {
-                    $obj_in_map->set($field_name, $value);
-                }
-                //make the model object in the entity map's cache match the $replacing_model_obj
-                foreach ($this->relation_settings() as $relation_name => $relation_obj) {
-                    $obj_in_map->clear_cache($relation_name, null, true);
-                    foreach ($replacing_model_obj->get_all_from_cache($relation_name) as $cache_id => $cached_obj) {
-                        $obj_in_map->cache($relation_name, $cached_obj, $cache_id);
-                    }
-                }
-            }
-            return $obj_in_map;
-        } else {
-            $this->add_to_entity_map($replacing_model_obj);
-            return $replacing_model_obj;
-        }
-    }
-
-
-
-    /**
-     * Gets the EE class that corresponds to this model. Eg, for EEM_Answer that
-     * would be EE_Answer.To import that class, you'd just add ".class.php" to the name, like so
-     * require_once($this->_getClassName().".class.php");
-     *
-     * @return string
-     */
-    private function _get_class_name()
-    {
-        return "EE_" . $this->get_this_model_name();
-    }
-
-
-
-    /**
-     * Get the name of the items this model represents, for the quantity specified. Eg,
-     * if $quantity==1, on EEM_Event, it would 'Event' (internationalized), otherwise
-     * it would be 'Events'.
-     *
-     * @param int $quantity
-     * @return string
-     */
-    public function item_name($quantity = 1)
-    {
-        return (int)$quantity === 1 ? $this->singular_item : $this->plural_item;
-    }
-
-
-
-    /**
-     * Very handy general function to allow for plugins to extend any child of EE_TempBase.
-     * If a method is called on a child of EE_TempBase that doesn't exist, this function is called
-     * (http://www.garfieldtech.com/blog/php-magic-call) and passed the method's name and arguments. Instead of
-     * requiring a plugin to extend the EE_TempBase (which works fine is there's only 1 plugin, but when will that
-     * happen?) they can add a hook onto 'filters_hook_espresso__{className}__{methodName}' (eg,
-     * filters_hook_espresso__EE_Answer__my_great_function) and accepts 2 arguments: the object on which the function
-     * was called, and an array of the original arguments passed to the function. Whatever their callback function
-     * returns will be returned by this function. Example: in functions.php (or in a plugin):
-     * add_filter('FHEE__EE_Answer__my_callback','my_callback',10,3); function
-     * my_callback($previousReturnValue,EE_TempBase $object,$argsArray){
-     * $returnString= "you called my_callback! and passed args:".implode(",",$argsArray);
-     *        return $previousReturnValue.$returnString;
-     * }
-     * require('EEM_Answer.model.php');
-     * $answer=EEM_Answer::instance();
-     * echo $answer->my_callback('monkeys',100);
-     * //will output "you called my_callback! and passed args:monkeys,100"
-     *
-     * @param string $methodName name of method which was called on a child of EE_TempBase, but which
-     * @param array  $args       array of original arguments passed to the function
-     * @throws EE_Error
-     * @return mixed whatever the plugin which calls add_filter decides
-     */
-    public function __call($methodName, $args)
-    {
-        $className = get_class($this);
-        $tagName = "FHEE__{$className}__{$methodName}";
-        if ( ! has_filter($tagName)) {
-            throw new EE_Error(
-                sprintf(
-                    __('Method %1$s on model %2$s does not exist! You can create one with the following code in functions.php or in a plugin: %4$s function my_callback(%4$s \$previousReturnValue, EEM_Base \$object\ $argsArray=NULL ){%4$s     /*function body*/%4$s      return \$whatever;%4$s }%4$s add_filter( \'%3$s\', \'my_callback\', 10, 3 );',
-                        'event_espresso'),
-                    $methodName,
-                    $className,
-                    $tagName,
-                    '<br />'
-                )
-            );
-        }
-        return apply_filters($tagName, null, $this, $args);
-    }
-
-
-
-    /**
-     * Ensures $base_class_obj_or_id is of the EE_Base_Class child that corresponds ot this model.
-     * If not, assumes its an ID, and uses $this->get_one_by_ID() to get the EE_Base_Class.
-     *
-     * @param EE_Base_Class|string|int $base_class_obj_or_id either:
-     *                                                       the EE_Base_Class object that corresponds to this Model,
-     *                                                       the object's class name
-     *                                                       or object's ID
-     * @param boolean                  $ensure_is_in_db      if set, we will also verify this model object
-     *                                                       exists in the database. If it does not, we add it
-     * @throws EE_Error
-     * @return EE_Base_Class
-     */
-    public function ensure_is_obj($base_class_obj_or_id, $ensure_is_in_db = false)
-    {
-        $className = $this->_get_class_name();
-        if ($base_class_obj_or_id instanceof $className) {
-            $model_object = $base_class_obj_or_id;
-        } else {
-            $primary_key_field = $this->get_primary_key_field();
-            if (
-                $primary_key_field instanceof EE_Primary_Key_Int_Field
-                && (
-                    is_int($base_class_obj_or_id)
-                    || is_string($base_class_obj_or_id)
-                )
-            ) {
-                // assume it's an ID.
-                // either a proper integer or a string representing an integer (eg "101" instead of 101)
-                $model_object = $this->get_one_by_ID($base_class_obj_or_id);
-            } else if (
-                $primary_key_field instanceof EE_Primary_Key_String_Field
-                && is_string($base_class_obj_or_id)
-            ) {
-                // assume its a string representation of the object
-                $model_object = $this->get_one_by_ID($base_class_obj_or_id);
-            } else {
-                throw new EE_Error(
-                    sprintf(
-                        __(
-                            "'%s' is neither an object of type %s, nor an ID! Its full value is '%s'",
-                            'event_espresso'
-                        ),
-                        $base_class_obj_or_id,
-                        $this->_get_class_name(),
-                        print_r($base_class_obj_or_id, true)
-                    )
-                );
-            }
-        }
-        if ($ensure_is_in_db && $model_object->ID() !== null) {
-            $model_object->save();
-        }
-        return $model_object;
-    }
-
-
-
-    /**
-     * Similar to ensure_is_obj(), this method makes sure $base_class_obj_or_id
-     * is a value of the this model's primary key. If it's an EE_Base_Class child,
-     * returns it ID.
-     *
-     * @param EE_Base_Class|int|string $base_class_obj_or_id
-     * @return int|string depending on the type of this model object's ID
-     * @throws EE_Error
-     */
-    public function ensure_is_ID($base_class_obj_or_id)
-    {
-        $className = $this->_get_class_name();
-        if ($base_class_obj_or_id instanceof $className) {
-            /** @var $base_class_obj_or_id EE_Base_Class */
-            $id = $base_class_obj_or_id->ID();
-        } elseif (is_int($base_class_obj_or_id)) {
-            //assume it's an ID
-            $id = $base_class_obj_or_id;
-        } elseif (is_string($base_class_obj_or_id)) {
-            //assume its a string representation of the object
-            $id = $base_class_obj_or_id;
-        } else {
-            throw new EE_Error(sprintf(__("'%s' is neither an object of type %s, nor an ID! Its full value is '%s'",
-                'event_espresso'), $base_class_obj_or_id, $this->_get_class_name(),
-                print_r($base_class_obj_or_id, true)));
-        }
-        return $id;
-    }
-
-
-
-    /**
-     * Sets whether the values passed to the model (eg, values in WHERE, values in INSERT, UPDATE, etc)
-     * have already been ran through the appropriate model field's prepare_for_use_in_db method. IE, they have
-     * been sanitized and converted into the appropriate domain.
-     * Usually the only place you'll want to change the default (which is to assume values have NOT been sanitized by
-     * the model object/model field) is when making a method call from WITHIN a model object, which has direct access
-     * to its sanitized values. Note: after changing this setting, you should set it back to its previous value (using
-     * get_assumption_concerning_values_already_prepared_by_model_object()) eg.
-     * $EVT = EEM_Event::instance(); $old_setting =
-     * $EVT->get_assumption_concerning_values_already_prepared_by_model_object();
-     * $EVT->assume_values_already_prepared_by_model_object(true);
-     * $EVT->update(array('foo'=>'bar'),array(array('foo'=>'monkey')));
-     * $EVT->assume_values_already_prepared_by_model_object($old_setting);
-     *
-     * @param int $values_already_prepared like one of the constants on EEM_Base
-     * @return void
-     */
-    public function assume_values_already_prepared_by_model_object(
-        $values_already_prepared = self::not_prepared_by_model_object
-    ) {
-        $this->_values_already_prepared_by_model_object = $values_already_prepared;
-    }
-
-
-
-    /**
-     * Read comments for assume_values_already_prepared_by_model_object()
-     *
-     * @return int
-     */
-    public function get_assumption_concerning_values_already_prepared_by_model_object()
-    {
-        return $this->_values_already_prepared_by_model_object;
-    }
-
-
-
-    /**
-     * Gets all the indexes on this model
-     *
-     * @return EE_Index[]
-     */
-    public function indexes()
-    {
-        return $this->_indexes;
-    }
-
-
-
-    /**
-     * Gets all the Unique Indexes on this model
-     *
-     * @return EE_Unique_Index[]
-     */
-    public function unique_indexes()
-    {
-        $unique_indexes = array();
-        foreach ($this->_indexes as $name => $index) {
-            if ($index instanceof EE_Unique_Index) {
-                $unique_indexes [$name] = $index;
-            }
-        }
-        return $unique_indexes;
-    }
-
-
-
-    /**
-     * Gets all the fields which, when combined, make the primary key.
-     * This is usually just an array with 1 element (the primary key), but in cases
-     * where there is no primary key, it's a combination of fields as defined
-     * on a primary index
-     *
-     * @return EE_Model_Field_Base[] indexed by the field's name
-     * @throws \EE_Error
-     */
-    public function get_combined_primary_key_fields()
-    {
-        foreach ($this->indexes() as $index) {
-            if ($index instanceof EE_Primary_Key_Index) {
-                return $index->fields();
-            }
-        }
-        return array($this->primary_key_name() => $this->get_primary_key_field());
-    }
-
-
-
-    /**
-     * Used to build a primary key string (when the model has no primary key),
-     * which can be used a unique string to identify this model object.
-     *
-     * @param array $cols_n_values keys are field names, values are their values
-     * @return string
-     * @throws \EE_Error
-     */
-    public function get_index_primary_key_string($cols_n_values)
-    {
-        $cols_n_values_for_primary_key_index = array_intersect_key($cols_n_values,
-            $this->get_combined_primary_key_fields());
-        return http_build_query($cols_n_values_for_primary_key_index);
-    }
-
-
-
-    /**
-     * Gets the field values from the primary key string
-     *
-     * @see EEM_Base::get_combined_primary_key_fields() and EEM_Base::get_index_primary_key_string()
-     * @param string $index_primary_key_string
-     * @return null|array
-     * @throws \EE_Error
-     */
-    public function parse_index_primary_key_string($index_primary_key_string)
-    {
-        $key_fields = $this->get_combined_primary_key_fields();
-        //check all of them are in the $id
-        $key_vals_in_combined_pk = array();
-        parse_str($index_primary_key_string, $key_vals_in_combined_pk);
-        foreach ($key_fields as $key_field_name => $field_obj) {
-            if ( ! isset($key_vals_in_combined_pk[$key_field_name])) {
-                return null;
-            }
-        }
-        return $key_vals_in_combined_pk;
-    }
-
-
-
-    /**
-     * verifies that an array of key-value pairs for model fields has a key
-     * for each field comprising the primary key index
-     *
-     * @param array $key_vals
-     * @return boolean
-     * @throws \EE_Error
-     */
-    public function has_all_combined_primary_key_fields($key_vals)
-    {
-        $keys_it_should_have = array_keys($this->get_combined_primary_key_fields());
-        foreach ($keys_it_should_have as $key) {
-            if ( ! isset($key_vals[$key])) {
-                return false;
-            }
-        }
-        return true;
-    }
-
-
-
-    /**
-     * Finds all model objects in the DB that appear to be a copy of $model_object_or_attributes_array.
-     * We consider something to be a copy if all the attributes match (except the ID, of course).
-     *
-     * @param array|EE_Base_Class $model_object_or_attributes_array If its an array, it's field-value pairs
-     * @param array               $query_params                     like EEM_Base::get_all's query_params.
-     * @throws EE_Error
-     * @return \EE_Base_Class[] Array keys are object IDs (if there is a primary key on the model. if not, numerically
-     *                                                              indexed)
-     */
-    public function get_all_copies($model_object_or_attributes_array, $query_params = array())
-    {
-        if ($model_object_or_attributes_array instanceof EE_Base_Class) {
-            $attributes_array = $model_object_or_attributes_array->model_field_array();
-        } elseif (is_array($model_object_or_attributes_array)) {
-            $attributes_array = $model_object_or_attributes_array;
-        } else {
-            throw new EE_Error(sprintf(__("get_all_copies should be provided with either a model object or an array of field-value-pairs, but was given %s",
-                "event_espresso"), $model_object_or_attributes_array));
-        }
-        //even copies obviously won't have the same ID, so remove the primary key
-        //from the WHERE conditions for finding copies (if there is a primary key, of course)
-        if ($this->has_primary_key_field() && isset($attributes_array[$this->primary_key_name()])) {
-            unset($attributes_array[$this->primary_key_name()]);
-        }
-        if (isset($query_params[0])) {
-            $query_params[0] = array_merge($attributes_array, $query_params);
-        } else {
-            $query_params[0] = $attributes_array;
-        }
-        return $this->get_all($query_params);
-    }
-
-
-
-    /**
-     * Gets the first copy we find. See get_all_copies for more details
-     *
-     * @param       mixed EE_Base_Class | array        $model_object_or_attributes_array
-     * @param array $query_params
-     * @return EE_Base_Class
-     * @throws \EE_Error
-     */
-    public function get_one_copy($model_object_or_attributes_array, $query_params = array())
-    {
-        if ( ! is_array($query_params)) {
-            EE_Error::doing_it_wrong('EEM_Base::get_one_copy',
-                sprintf(__('$query_params should be an array, you passed a variable of type %s', 'event_espresso'),
-                    gettype($query_params)), '4.6.0');
-            $query_params = array();
-        }
-        $query_params['limit'] = 1;
-        $copies = $this->get_all_copies($model_object_or_attributes_array, $query_params);
-        if (is_array($copies)) {
-            return array_shift($copies);
-        } else {
-            return null;
-        }
-    }
-
-
-
-    /**
-     * Updates the item with the specified id. Ignores default query parameters because
-     * we have specified the ID, and its assumed we KNOW what we're doing
-     *
-     * @param array      $fields_n_values keys are field names, values are their new values
-     * @param int|string $id              the value of the primary key to update
-     * @return int number of rows updated
-     * @throws \EE_Error
-     */
-    public function update_by_ID($fields_n_values, $id)
-    {
-        $query_params = array(
-            0                          => array($this->get_primary_key_field()->get_name() => $id),
-            'default_where_conditions' => 'other_models_only',
-        );
-        return $this->update($fields_n_values, $query_params);
-    }
-
-
-
-    /**
-     * Changes an operator which was supplied to the models into one usable in SQL
-     *
-     * @param string $operator_supplied
-     * @return string an operator which can be used in SQL
-     * @throws EE_Error
-     */
-    private function _prepare_operator_for_sql($operator_supplied)
-    {
-        $sql_operator = isset($this->_valid_operators[$operator_supplied]) ? $this->_valid_operators[$operator_supplied]
-            : null;
-        if ($sql_operator) {
-            return $sql_operator;
-        } else {
-            throw new EE_Error(sprintf(__("The operator '%s' is not in the list of valid operators: %s",
-                "event_espresso"), $operator_supplied, implode(",", array_keys($this->_valid_operators))));
-        }
-    }
-
-
-
-    /**
-     * Gets an array where keys are the primary keys and values are their 'names'
-     * (as determined by the model object's name() function, which is often overridden)
-     *
-     * @param array $query_params like get_all's
-     * @return string[]
-     * @throws \EE_Error
-     */
-    public function get_all_names($query_params = array())
-    {
-        $objs = $this->get_all($query_params);
-        $names = array();
-        foreach ($objs as $obj) {
-            $names[$obj->ID()] = $obj->name();
-        }
-        return $names;
-    }
-
-
-
-    /**
-     * Gets an array of primary keys from the model objects. If you acquired the model objects
-     * using EEM_Base::get_all() you don't need to call this (and probably shouldn't because
-     * this is duplicated effort and reduces efficiency) you would be better to use
-     * array_keys() on $model_objects.
-     *
-     * @param \EE_Base_Class[] $model_objects
-     * @param boolean          $filter_out_empty_ids if a model object has an ID of '' or 0, don't bother including it
-     *                                               in the returned array
-     * @return array
-     * @throws \EE_Error
-     */
-    public function get_IDs($model_objects, $filter_out_empty_ids = false)
-    {
-        if ( ! $this->has_primary_key_field()) {
-            if (WP_DEBUG) {
-                EE_Error::add_error(
-                    __('Trying to get IDs from a model than has no primary key', 'event_espresso'),
-                    __FILE__,
-                    __FUNCTION__,
-                    __LINE__
-                );
-            }
-        }
-        $IDs = array();
-        foreach ($model_objects as $model_object) {
-            $id = $model_object->ID();
-            if ( ! $id) {
-                if ($filter_out_empty_ids) {
-                    continue;
-                }
-                if (WP_DEBUG) {
-                    EE_Error::add_error(
-                        __(
-                            'Called %1$s on a model object that has no ID and so probably hasn\'t been saved to the database',
-                            'event_espresso'
-                        ),
-                        __FILE__,
-                        __FUNCTION__,
-                        __LINE__
-                    );
-                }
-            }
-            $IDs[] = $id;
-        }
-        return $IDs;
-    }
-
-
-
-    /**
-     * Returns the string used in capabilities relating to this model. If there
-     * are no capabilities that relate to this model returns false
-     *
-     * @return string|false
-     */
-    public function cap_slug()
-    {
-        return apply_filters('FHEE__EEM_Base__cap_slug', $this->_caps_slug, $this);
-    }
-
-
-
-    /**
-     * Returns the capability-restrictions array (@see EEM_Base::_cap_restrictions).
-     * If $context is provided (which should be set to one of EEM_Base::valid_cap_contexts())
-     * only returns the cap restrictions array in that context (ie, the array
-     * at that key)
-     *
-     * @param string $context
-     * @return EE_Default_Where_Conditions[] indexed by associated capability
-     * @throws \EE_Error
-     */
-    public function cap_restrictions($context = EEM_Base::caps_read)
-    {
-        EEM_Base::verify_is_valid_cap_context($context);
-        //check if we ought to run the restriction generator first
-        if (
-            isset($this->_cap_restriction_generators[$context])
-            && $this->_cap_restriction_generators[$context] instanceof EE_Restriction_Generator_Base
-            && ! $this->_cap_restriction_generators[$context]->has_generated_cap_restrictions()
-        ) {
-            $this->_cap_restrictions[$context] = array_merge(
-                $this->_cap_restrictions[$context],
-                $this->_cap_restriction_generators[$context]->generate_restrictions()
-            );
-        }
-        //and make sure we've finalized the construction of each restriction
-        foreach ($this->_cap_restrictions[$context] as $where_conditions_obj) {
-            if ($where_conditions_obj instanceof EE_Default_Where_Conditions) {
-                $where_conditions_obj->_finalize_construct($this);
-            }
-        }
-        return $this->_cap_restrictions[$context];
-    }
-
-
-
-    /**
-     * Indicating whether or not this model thinks its a wp core model
-     *
-     * @return boolean
-     */
-    public function is_wp_core_model()
-    {
-        return $this->_wp_core_model;
-    }
-
-
-
-    /**
-     * Gets all the caps that are missing which impose a restriction on
-     * queries made in this context
-     *
-     * @param string $context one of EEM_Base::caps_ constants
-     * @return EE_Default_Where_Conditions[] indexed by capability name
-     * @throws \EE_Error
-     */
-    public function caps_missing($context = EEM_Base::caps_read)
-    {
-        $missing_caps = array();
-        $cap_restrictions = $this->cap_restrictions($context);
-        foreach ($cap_restrictions as $cap => $restriction_if_no_cap) {
-            if ( ! EE_Capabilities::instance()
-                                  ->current_user_can($cap, $this->get_this_model_name() . '_model_applying_caps')
-            ) {
-                $missing_caps[$cap] = $restriction_if_no_cap;
-            }
-        }
-        return $missing_caps;
-    }
-
-
-
-    /**
-     * Gets the mapping from capability contexts to action strings used in capability names
-     *
-     * @return array keys are one of EEM_Base::valid_cap_contexts(), and values are usually
-     * one of 'read', 'edit', or 'delete'
-     */
-    public function cap_contexts_to_cap_action_map()
-    {
-        return apply_filters('FHEE__EEM_Base__cap_contexts_to_cap_action_map', $this->_cap_contexts_to_cap_action_map,
-            $this);
-    }
-
-
-
-    /**
-     * Gets the action string for the specified capability context
-     *
-     * @param string $context
-     * @return string one of EEM_Base::cap_contexts_to_cap_action_map() values
-     * @throws \EE_Error
-     */
-    public function cap_action_for_context($context)
-    {
-        $mapping = $this->cap_contexts_to_cap_action_map();
-        if (isset($mapping[$context])) {
-            return $mapping[$context];
-        }
-        if ($action = apply_filters('FHEE__EEM_Base__cap_action_for_context', null, $this, $mapping, $context)) {
-            return $action;
-        }
-        throw new EE_Error(
-            sprintf(
-                __('Cannot find capability restrictions for context "%1$s", allowed values are:%2$s', 'event_espresso'),
-                $context,
-                implode(',', array_keys($this->cap_contexts_to_cap_action_map()))
-            )
-        );
-    }
-
-
-
-    /**
-     * Returns all the capability contexts which are valid when querying models
-     *
-     * @return array
-     */
-    static public function valid_cap_contexts()
-    {
-        return apply_filters('FHEE__EEM_Base__valid_cap_contexts', array(
-            self::caps_read,
-            self::caps_read_admin,
-            self::caps_edit,
-            self::caps_delete,
-        ));
-    }
-
-
-
-    /**
-     * Verifies $context is one of EEM_Base::valid_cap_contexts(), if not it throws an exception
-     *
-     * @param string $context
-     * @return bool
-     * @throws \EE_Error
-     */
-    static public function verify_is_valid_cap_context($context)
-    {
-        $valid_cap_contexts = EEM_Base::valid_cap_contexts();
-        if (in_array($context, $valid_cap_contexts)) {
-            return true;
-        } else {
-            throw new EE_Error(
-                sprintf(
-                    __('Context "%1$s" passed into model "%2$s" is not a valid context. They are: %3$s',
-                        'event_espresso'),
-                    $context,
-                    'EEM_Base',
-                    implode(',', $valid_cap_contexts)
-                )
-            );
-        }
-    }
-
-
-
-    /**
-     * Clears all the models field caches. This is only useful when a sub-class
-     * might have added a field or something and these caches might be invalidated
-     */
-    protected function _invalidate_field_caches()
-    {
-        $this->_cache_foreign_key_to_fields = array();
-        $this->_cached_fields = null;
-        $this->_cached_fields_non_db_only = null;
-    }
-
-
-
-    /**
-     * _instantiate_new_instance_from_db
-     *
-     * @param string $class_name
-     * @param array  $arguments
-     * @return \EE_Base_Class
-     * @throws \Exception
-     */
-    public function _instantiate_new_instance_from_db($class_name, $arguments)
-    {
-        if ( ! class_exists($class_name)) {
-            throw new EE_Error(
-                sprintf(
-                    __('The "%s" class does not exist. Please ensure that an autoloader is set.', 'event_espresso'),
-                    $class_name
-                )
-            );
-        }
-        return call_user_func_array(
-            array($class_name, 'new_instance'),
-            array((array)$arguments, $this->_timezone, array(), true)
-        );
-    }
+		}
+		return $null_friendly_where_conditions;
+	}
+
+
+
+	/**
+	 * Uses the _default_where_conditions_strategy set during __construct() to get
+	 * default where conditions on all get_all, update, and delete queries done by this model.
+	 * Use the same syntax as client code. Eg on the Event model, use array('Event.EVT_post_type'=>'esp_event'),
+	 * NOT array('Event_CPT.post_type'=>'esp_event').
+	 *
+	 * @param string $model_relation_path eg, path from Event to Payment is "Registration.Transaction.Payment."
+	 * @return array like EEM_Base::get_all's $query_params[0] (where conditions)
+	 */
+	private function _get_default_where_conditions($model_relation_path = null)
+	{
+		if ($this->_ignore_where_strategy) {
+			return array();
+		}
+		return $this->_default_where_conditions_strategy->get_default_where_conditions($model_relation_path);
+	}
+
+
+
+	/**
+	 * Uses the _minimum_where_conditions_strategy set during __construct() to get
+	 * minimum where conditions on all get_all, update, and delete queries done by this model.
+	 * Use the same syntax as client code. Eg on the Event model, use array('Event.EVT_post_type'=>'esp_event'),
+	 * NOT array('Event_CPT.post_type'=>'esp_event').
+	 * Similar to _get_default_where_conditions
+	 *
+	 * @param string $model_relation_path eg, path from Event to Payment is "Registration.Transaction.Payment."
+	 * @return array like EEM_Base::get_all's $query_params[0] (where conditions)
+	 */
+	protected function _get_minimum_where_conditions($model_relation_path = null)
+	{
+		if ($this->_ignore_where_strategy) {
+			return array();
+		}
+		return $this->_minimum_where_conditions_strategy->get_default_where_conditions($model_relation_path);
+	}
+
+
+
+	/**
+	 * Creates the string of SQL for the select part of a select query, everything behind SELECT and before FROM.
+	 * Eg, "Event.post_id, Event.post_name,Event_Detail.EVT_ID..."
+	 *
+	 * @param EE_Model_Query_Info_Carrier $model_query_info
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	private function _construct_default_select_sql(EE_Model_Query_Info_Carrier $model_query_info)
+	{
+		$selects = $this->_get_columns_to_select_for_this_model();
+		foreach (
+			$model_query_info->get_model_names_included() as $model_relation_chain =>
+			$name_of_other_model_included
+		) {
+			$other_model_included = $this->get_related_model_obj($name_of_other_model_included);
+			$other_model_selects = $other_model_included->_get_columns_to_select_for_this_model($model_relation_chain);
+			foreach ($other_model_selects as $key => $value) {
+				$selects[] = $value;
+			}
+		}
+		return implode(", ", $selects);
+	}
+
+
+
+	/**
+	 * Gets an array of columns to select for this model, which are necessary for it to create its objects.
+	 * So that's going to be the columns for all the fields on the model
+	 *
+	 * @param string $model_relation_chain like 'Question.Question_Group.Event'
+	 * @return array numerically indexed, values are columns to select and rename, eg "Event.ID AS 'Event.ID'"
+	 */
+	public function _get_columns_to_select_for_this_model($model_relation_chain = '')
+	{
+		$fields = $this->field_settings();
+		$selects = array();
+		$table_alias_with_model_relation_chain_prefix = EE_Model_Parser::extract_table_alias_model_relation_chain_prefix($model_relation_chain,
+			$this->get_this_model_name());
+		foreach ($fields as $field_obj) {
+			$selects[] = $table_alias_with_model_relation_chain_prefix
+						 . $field_obj->get_table_alias()
+						 . "."
+						 . $field_obj->get_table_column()
+						 . " AS '"
+						 . $table_alias_with_model_relation_chain_prefix
+						 . $field_obj->get_table_alias()
+						 . "."
+						 . $field_obj->get_table_column()
+						 . "'";
+		}
+		//make sure we are also getting the PKs of each table
+		$tables = $this->get_tables();
+		if (count($tables) > 1) {
+			foreach ($tables as $table_obj) {
+				$qualified_pk_column = $table_alias_with_model_relation_chain_prefix
+									   . $table_obj->get_fully_qualified_pk_column();
+				if ( ! in_array($qualified_pk_column, $selects)) {
+					$selects[] = "$qualified_pk_column AS '$qualified_pk_column'";
+				}
+			}
+		}
+		return $selects;
+	}
+
+
+
+	/**
+	 * Given a $query_param like 'Registration.Transaction.TXN_ID', pops off 'Registration.',
+	 * gets the join statement for it; gets the data types for it; and passes the remaining 'Transaction.TXN_ID'
+	 * onto its related Transaction object to do the same. Returns an EE_Join_And_Data_Types object which contains the
+	 * SQL for joining, and the data types
+	 *
+	 * @param null|string                 $original_query_param
+	 * @param string                      $query_param          like Registration.Transaction.TXN_ID
+	 * @param EE_Model_Query_Info_Carrier $passed_in_query_info
+	 * @param    string                   $query_param_type     like Registration.Transaction.TXN_ID
+	 *                                                          or 'PAY_ID'. Otherwise, we don't expect there to be a
+	 *                                                          column name. We only want model names, eg 'Event.Venue'
+	 *                                                          or 'Registration's
+	 * @param string                      $original_query_param what it originally was (eg
+	 *                                                          Registration.Transaction.TXN_ID). If null, we assume it
+	 *                                                          matches $query_param
+	 * @throws EE_Error
+	 * @return void only modifies the EEM_Related_Model_Info_Carrier passed into it
+	 */
+	private function _extract_related_model_info_from_query_param(
+		$query_param,
+		EE_Model_Query_Info_Carrier $passed_in_query_info,
+		$query_param_type,
+		$original_query_param = null
+	) {
+		if ($original_query_param === null) {
+			$original_query_param = $query_param;
+		}
+		$query_param = $this->_remove_stars_and_anything_after_from_condition_query_param_key($query_param);
+		/** @var $allow_logic_query_params bool whether or not to allow logic_query_params like 'NOT','OR', or 'AND' */
+		$allow_logic_query_params = in_array($query_param_type, array('where', 'having'));
+		$allow_fields = in_array($query_param_type, array('where', 'having', 'order_by', 'group_by', 'order'));
+		//check to see if we have a field on this model
+		$this_model_fields = $this->field_settings(true);
+		if (array_key_exists($query_param, $this_model_fields)) {
+			if ($allow_fields) {
+				return;
+			} else {
+				throw new EE_Error(sprintf(__("Using a field name (%s) on model %s is not allowed on this query param type '%s'. Original query param was %s",
+					"event_espresso"),
+					$query_param, get_class($this), $query_param_type, $original_query_param));
+			}
+		} //check if this is a special logic query param
+		elseif (in_array($query_param, $this->_logic_query_param_keys, true)) {
+			if ($allow_logic_query_params) {
+				return;
+			} else {
+				throw new EE_Error(
+					sprintf(
+						__('Logic query params ("%1$s") are being used incorrectly with the following query param ("%2$s") on model %3$s. %4$sAdditional Info:%4$s%5$s',
+							'event_espresso'),
+						implode('", "', $this->_logic_query_param_keys),
+						$query_param,
+						get_class($this),
+						'<br />',
+						"\t"
+						. ' $passed_in_query_info = <pre>'
+						. print_r($passed_in_query_info, true)
+						. '</pre>'
+						. "\n\t"
+						. ' $query_param_type = '
+						. $query_param_type
+						. "\n\t"
+						. ' $original_query_param = '
+						. $original_query_param
+					)
+				);
+			}
+		} //check if it's a custom selection
+		elseif (array_key_exists($query_param, $this->_custom_selections)) {
+			return;
+		}
+		//check if has a model name at the beginning
+		//and
+		//check if it's a field on a related model
+		foreach ($this->_model_relations as $valid_related_model_name => $relation_obj) {
+			if (strpos($query_param, $valid_related_model_name . ".") === 0) {
+				$this->_add_join_to_model($valid_related_model_name, $passed_in_query_info, $original_query_param);
+				$query_param = substr($query_param, strlen($valid_related_model_name . "."));
+				if ($query_param === '') {
+					//nothing left to $query_param
+					//we should actually end in a field name, not a model like this!
+					throw new EE_Error(sprintf(__("Query param '%s' (of type %s on model %s) shouldn't end on a period (.) ",
+						"event_espresso"),
+						$query_param, $query_param_type, get_class($this), $valid_related_model_name));
+				} else {
+					$related_model_obj = $this->get_related_model_obj($valid_related_model_name);
+					$related_model_obj->_extract_related_model_info_from_query_param($query_param,
+						$passed_in_query_info, $query_param_type, $original_query_param);
+					return;
+				}
+			} elseif ($query_param === $valid_related_model_name) {
+				$this->_add_join_to_model($valid_related_model_name, $passed_in_query_info, $original_query_param);
+				return;
+			}
+		}
+		//ok so $query_param didn't start with a model name
+		//and we previously confirmed it wasn't a logic query param or field on the current model
+		//it's wack, that's what it is
+		throw new EE_Error(sprintf(__("There is no model named '%s' related to %s. Query param type is %s and original query param is %s",
+			"event_espresso"),
+			$query_param, get_class($this), $query_param_type, $original_query_param));
+	}
+
+
+
+	/**
+	 * Privately used by _extract_related_model_info_from_query_param to add a join to $model_name
+	 * and store it on $passed_in_query_info
+	 *
+	 * @param string                      $model_name
+	 * @param EE_Model_Query_Info_Carrier $passed_in_query_info
+	 * @param string                      $original_query_param used to extract the relation chain between the queried
+	 *                                                          model and $model_name. Eg, if we are querying Event,
+	 *                                                          and are adding a join to 'Payment' with the original
+	 *                                                          query param key
+	 *                                                          'Registration.Transaction.Payment.PAY_amount', we want
+	 *                                                          to extract 'Registration.Transaction.Payment', in case
+	 *                                                          Payment wants to add default query params so that it
+	 *                                                          will know what models to prepend onto its default query
+	 *                                                          params or in case it wants to rename tables (in case
+	 *                                                          there are multiple joins to the same table)
+	 * @return void
+	 * @throws \EE_Error
+	 */
+	private function _add_join_to_model(
+		$model_name,
+		EE_Model_Query_Info_Carrier $passed_in_query_info,
+		$original_query_param
+	) {
+		$relation_obj = $this->related_settings_for($model_name);
+		$model_relation_chain = EE_Model_Parser::extract_model_relation_chain($model_name, $original_query_param);
+		//check if the relation is HABTM, because then we're essentially doing two joins
+		//If so, join first to the JOIN table, and add its data types, and then continue as normal
+		if ($relation_obj instanceof EE_HABTM_Relation) {
+			$join_model_obj = $relation_obj->get_join_model();
+			//replace the model specified with the join model for this relation chain, whi
+			$relation_chain_to_join_model = EE_Model_Parser::replace_model_name_with_join_model_name_in_model_relation_chain($model_name,
+				$join_model_obj->get_this_model_name(), $model_relation_chain);
+			$new_query_info = new EE_Model_Query_Info_Carrier(
+				array($relation_chain_to_join_model => $join_model_obj->get_this_model_name()),
+				$relation_obj->get_join_to_intermediate_model_statement($relation_chain_to_join_model));
+			$passed_in_query_info->merge($new_query_info);
+		}
+		//now just join to the other table pointed to by the relation object, and add its data types
+		$new_query_info = new EE_Model_Query_Info_Carrier(
+			array($model_relation_chain => $model_name),
+			$relation_obj->get_join_statement($model_relation_chain));
+		$passed_in_query_info->merge($new_query_info);
+	}
+
+
+
+	/**
+	 * Constructs SQL for where clause, like "WHERE Event.ID = 23 AND Transaction.amount > 100" etc.
+	 *
+	 * @param array $where_params like EEM_Base::get_all
+	 * @return string of SQL
+	 * @throws \EE_Error
+	 */
+	private function _construct_where_clause($where_params)
+	{
+		$SQL = $this->_construct_condition_clause_recursive($where_params, ' AND ');
+		if ($SQL) {
+			return " WHERE " . $SQL;
+		} else {
+			return '';
+		}
+	}
+
+
+
+	/**
+	 * Just like the _construct_where_clause, except prepends 'HAVING' instead of 'WHERE',
+	 * and should be passed HAVING parameters, not WHERE parameters
+	 *
+	 * @param array $having_params
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	private function _construct_having_clause($having_params)
+	{
+		$SQL = $this->_construct_condition_clause_recursive($having_params, ' AND ');
+		if ($SQL) {
+			return " HAVING " . $SQL;
+		} else {
+			return '';
+		}
+	}
+
+
+
+	/**
+	 * Gets the EE_Model_Field on the model indicated by $model_name and the $field_name.
+	 * Eg, if called with _get_field_on_model('ATT_ID','Attendee'), it will return the EE_Primary_Key_Field on
+	 * EEM_Attendee.
+	 *
+	 * @param string $field_name
+	 * @param string $model_name
+	 * @return EE_Model_Field_Base
+	 * @throws EE_Error
+	 */
+	protected function _get_field_on_model($field_name, $model_name)
+	{
+		$model_class = 'EEM_' . $model_name;
+		$model_filepath = $model_class . ".model.php";
+		if (is_readable($model_filepath)) {
+			require_once($model_filepath);
+			$model_instance = call_user_func($model_name . "::instance");
+			/* @var $model_instance EEM_Base */
+			return $model_instance->field_settings_for($field_name);
+		} else {
+			throw new EE_Error(sprintf(__('No model named %s exists, with classname %s and filepath %s',
+				'event_espresso'), $model_name, $model_class, $model_filepath));
+		}
+	}
+
+
+
+	/**
+	 * Used for creating nested WHERE conditions. Eg "WHERE ! (Event.ID = 3 OR ( Event_Meta.meta_key = 'bob' AND
+	 * Event_Meta.meta_value = 'foo'))"
+	 *
+	 * @param array  $where_params see EEM_Base::get_all for documentation
+	 * @param string $glue         joins each subclause together. Should really only be " AND " or " OR "...
+	 * @throws EE_Error
+	 * @return string of SQL
+	 */
+	private function _construct_condition_clause_recursive($where_params, $glue = ' AND')
+	{
+		$where_clauses = array();
+		foreach ($where_params as $query_param => $op_and_value_or_sub_condition) {
+			$query_param = $this->_remove_stars_and_anything_after_from_condition_query_param_key($query_param);//str_replace("*",'',$query_param);
+			if (in_array($query_param, $this->_logic_query_param_keys)) {
+				switch ($query_param) {
+					case 'not':
+					case 'NOT':
+						$where_clauses[] = "! ("
+										   . $this->_construct_condition_clause_recursive($op_and_value_or_sub_condition,
+								$glue)
+										   . ")";
+						break;
+					case 'and':
+					case 'AND':
+						$where_clauses[] = " ("
+										   . $this->_construct_condition_clause_recursive($op_and_value_or_sub_condition,
+								' AND ')
+										   . ")";
+						break;
+					case 'or':
+					case 'OR':
+						$where_clauses[] = " ("
+										   . $this->_construct_condition_clause_recursive($op_and_value_or_sub_condition,
+								' OR ')
+										   . ")";
+						break;
+				}
+			} else {
+				$field_obj = $this->_deduce_field_from_query_param($query_param);
+				//if it's not a normal field, maybe it's a custom selection?
+				if ( ! $field_obj) {
+					if (isset($this->_custom_selections[$query_param][1])) {
+						$field_obj = $this->_custom_selections[$query_param][1];
+					} else {
+						throw new EE_Error(sprintf(__("%s is neither a valid model field name, nor a custom selection",
+							"event_espresso"), $query_param));
+					}
+				}
+				$op_and_value_sql = $this->_construct_op_and_value($op_and_value_or_sub_condition, $field_obj);
+				$where_clauses[] = $this->_deduce_column_name_from_query_param($query_param) . SP . $op_and_value_sql;
+			}
+		}
+		return $where_clauses ? implode($glue, $where_clauses) : '';
+	}
+
+
+
+	/**
+	 * Takes the input parameter and extract the table name (alias) and column name
+	 *
+	 * @param array $query_param like Registration.Transaction.TXN_ID, Event.Datetime.start_time, or REG_ID
+	 * @throws EE_Error
+	 * @return string table alias and column name for SQL, eg "Transaction.TXN_ID"
+	 */
+	private function _deduce_column_name_from_query_param($query_param)
+	{
+		$field = $this->_deduce_field_from_query_param($query_param);
+		if ($field) {
+			$table_alias_prefix = EE_Model_Parser::extract_table_alias_model_relation_chain_from_query_param($field->get_model_name(),
+				$query_param);
+			return $table_alias_prefix . $field->get_qualified_column();
+		} elseif (array_key_exists($query_param, $this->_custom_selections)) {
+			//maybe it's custom selection item?
+			//if so, just use it as the "column name"
+			return $query_param;
+		} else {
+			throw new EE_Error(sprintf(__("%s is not a valid field on this model, nor a custom selection (%s)",
+				"event_espresso"), $query_param, implode(",", $this->_custom_selections)));
+		}
+	}
+
+
+
+	/**
+	 * Removes the * and anything after it from the condition query param key. It is useful to add the * to condition
+	 * query param keys (eg, 'OR*', 'EVT_ID') in order for the array keys to still be unique, so that they don't get
+	 * overwritten Takes a string like 'Event.EVT_ID*', 'TXN_total**', 'OR*1st', and 'DTT_reg_start*foobar' to
+	 * 'Event.EVT_ID', 'TXN_total', 'OR', and 'DTT_reg_start', respectively.
+	 *
+	 * @param string $condition_query_param_key
+	 * @return string
+	 */
+	private function _remove_stars_and_anything_after_from_condition_query_param_key($condition_query_param_key)
+	{
+		$pos_of_star = strpos($condition_query_param_key, '*');
+		if ($pos_of_star === false) {
+			return $condition_query_param_key;
+		} else {
+			$condition_query_param_sans_star = substr($condition_query_param_key, 0, $pos_of_star);
+			return $condition_query_param_sans_star;
+		}
+	}
+
+
+
+	/**
+	 * creates the SQL for the operator and the value in a WHERE clause, eg "< 23" or "LIKE '%monkey%'"
+	 *
+	 * @param                            mixed      array | string    $op_and_value
+	 * @param EE_Model_Field_Base|string $field_obj . If string, should be one of EEM_Base::_valid_wpdb_data_types
+	 * @throws EE_Error
+	 * @return string
+	 */
+	private function _construct_op_and_value($op_and_value, $field_obj)
+	{
+		if (is_array($op_and_value)) {
+			$operator = isset($op_and_value[0]) ? $this->_prepare_operator_for_sql($op_and_value[0]) : null;
+			if ( ! $operator) {
+				$php_array_like_string = array();
+				foreach ($op_and_value as $key => $value) {
+					$php_array_like_string[] = "$key=>$value";
+				}
+				throw new EE_Error(
+					sprintf(
+						__(
+							"You setup a query parameter like you were going to specify an operator, but didn't. You provided '(%s)', but the operator should be at array key index 0 (eg array('>',32))",
+							"event_espresso"
+						),
+						implode(",", $php_array_like_string)
+					)
+				);
+			}
+			$value = isset($op_and_value[1]) ? $op_and_value[1] : null;
+		} else {
+			$operator = '=';
+			$value = $op_and_value;
+		}
+		//check to see if the value is actually another field
+		if (is_array($op_and_value) && isset($op_and_value[2]) && $op_and_value[2] == true) {
+			return $operator . SP . $this->_deduce_column_name_from_query_param($value);
+		} elseif (in_array($operator, $this->_in_style_operators) && is_array($value)) {
+			//in this case, the value should be an array, or at least a comma-separated list
+			//it will need to handle a little differently
+			$cleaned_value = $this->_construct_in_value($value, $field_obj);
+			//note: $cleaned_value has already been run through $wpdb->prepare()
+			return $operator . SP . $cleaned_value;
+		} elseif (in_array($operator, $this->_between_style_operators) && is_array($value)) {
+			//the value should be an array with count of two.
+			if (count($value) !== 2) {
+				throw new EE_Error(
+					sprintf(
+						__(
+							"The '%s' operator must be used with an array of values and there must be exactly TWO values in that array.",
+							'event_espresso'
+						),
+						"BETWEEN"
+					)
+				);
+			}
+			$cleaned_value = $this->_construct_between_value($value, $field_obj);
+			return $operator . SP . $cleaned_value;
+		} elseif (in_array($operator, $this->_null_style_operators)) {
+			if ($value !== null) {
+				throw new EE_Error(
+					sprintf(
+						__(
+							"You attempted to give a value  (%s) while using a NULL-style operator (%s). That isn't valid",
+							"event_espresso"
+						),
+						$value,
+						$operator
+					)
+				);
+			}
+			return $operator;
+		} elseif ($operator === 'LIKE' && ! is_array($value)) {
+			//if the operator is 'LIKE', we want to allow percent signs (%) and not
+			//remove other junk. So just treat it as a string.
+			return $operator . SP . $this->_wpdb_prepare_using_field($value, '%s');
+		} elseif ( ! in_array($operator, $this->_in_style_operators) && ! is_array($value)) {
+			return $operator . SP . $this->_wpdb_prepare_using_field($value, $field_obj);
+		} elseif (in_array($operator, $this->_in_style_operators) && ! is_array($value)) {
+			throw new EE_Error(
+				sprintf(
+					__(
+						"Operator '%s' must be used with an array of values, eg 'Registration.REG_ID' => array('%s',array(1,2,3))",
+						'event_espresso'
+					),
+					$operator,
+					$operator
+				)
+			);
+		} elseif ( ! in_array($operator, $this->_in_style_operators) && is_array($value)) {
+			throw new EE_Error(
+				sprintf(
+					__(
+						"Operator '%s' must be used with a single value, not an array. Eg 'Registration.REG_ID => array('%s',23))",
+						'event_espresso'
+					),
+					$operator,
+					$operator
+				)
+			);
+		} else {
+			throw new EE_Error(
+				sprintf(
+					__(
+						"It appears you've provided some totally invalid query parameters. Operator and value were:'%s', which isn't right at all",
+						"event_espresso"
+					),
+					http_build_query($op_and_value)
+				)
+			);
+		}
+	}
+
+
+
+	/**
+	 * Creates the operands to be used in a BETWEEN query, eg "'2014-12-31 20:23:33' AND '2015-01-23 12:32:54'"
+	 *
+	 * @param array                      $values
+	 * @param EE_Model_Field_Base|string $field_obj if string, it should be the datatype to be used when querying, eg
+	 *                                              '%s'
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function _construct_between_value($values, $field_obj)
+	{
+		$cleaned_values = array();
+		foreach ($values as $value) {
+			$cleaned_values[] = $this->_wpdb_prepare_using_field($value, $field_obj);
+		}
+		return $cleaned_values[0] . " AND " . $cleaned_values[1];
+	}
+
+
+
+	/**
+	 * Takes an array or a comma-separated list of $values and cleans them
+	 * according to $data_type using $wpdb->prepare, and then makes the list a
+	 * string surrounded by ( and ). Eg, _construct_in_value(array(1,2,3),'%d') would
+	 * return '(1,2,3)'; _construct_in_value("1,2,hack",'%d') would return '(1,2,1)' (assuming
+	 * I'm right that a string, when interpreted as a digit, becomes a 1. It might become a 0)
+	 *
+	 * @param mixed                      $values    array or comma-separated string
+	 * @param EE_Model_Field_Base|string $field_obj if string, it should be a wpdb data type like '%s', or '%d'
+	 * @return string of SQL to follow an 'IN' or 'NOT IN' operator
+	 * @throws \EE_Error
+	 */
+	public function _construct_in_value($values, $field_obj)
+	{
+		//check if the value is a CSV list
+		if (is_string($values)) {
+			//in which case, turn it into an array
+			$values = explode(",", $values);
+		}
+		$cleaned_values = array();
+		foreach ($values as $value) {
+			$cleaned_values[] = $this->_wpdb_prepare_using_field($value, $field_obj);
+		}
+		//we would just LOVE to leave $cleaned_values as an empty array, and return the value as "()",
+		//but unfortunately that's invalid SQL. So instead we return a string which we KNOW will evaluate to be the empty set
+		//which is effectively equivalent to returning "()". We don't return "(0)" because that only works for auto-incrementing columns
+		if (empty($cleaned_values)) {
+			$all_fields = $this->field_settings();
+			$a_field = array_shift($all_fields);
+			$main_table = $this->_get_main_table();
+			$cleaned_values[] = "SELECT "
+								. $a_field->get_table_column()
+								. " FROM "
+								. $main_table->get_table_name()
+								. " WHERE FALSE";
+		}
+		return "(" . implode(",", $cleaned_values) . ")";
+	}
+
+
+
+	/**
+	 * @param mixed                      $value
+	 * @param EE_Model_Field_Base|string $field_obj if string it should be a wpdb data type like '%d'
+	 * @throws EE_Error
+	 * @return false|null|string
+	 */
+	private function _wpdb_prepare_using_field($value, $field_obj)
+	{
+		/** @type WPDB $wpdb */
+		global $wpdb;
+		if ($field_obj instanceof EE_Model_Field_Base) {
+			return $wpdb->prepare($field_obj->get_wpdb_data_type(),
+				$this->_prepare_value_for_use_in_db($value, $field_obj));
+		} else {//$field_obj should really just be a data type
+			if ( ! in_array($field_obj, $this->_valid_wpdb_data_types)) {
+				throw new EE_Error(sprintf(__("%s is not a valid wpdb datatype. Valid ones are %s", "event_espresso"),
+					$field_obj, implode(",", $this->_valid_wpdb_data_types)));
+			}
+			return $wpdb->prepare($field_obj, $value);
+		}
+	}
+
+
+
+	/**
+	 * Takes the input parameter and finds the model field that it indicates.
+	 *
+	 * @param string $query_param_name like Registration.Transaction.TXN_ID, Event.Datetime.start_time, or REG_ID
+	 * @throws EE_Error
+	 * @return EE_Model_Field_Base
+	 */
+	protected function _deduce_field_from_query_param($query_param_name)
+	{
+		//ok, now proceed with deducing which part is the model's name, and which is the field's name
+		//which will help us find the database table and column
+		$query_param_parts = explode(".", $query_param_name);
+		if (empty($query_param_parts)) {
+			throw new EE_Error(sprintf(__("_extract_column_name is empty when trying to extract column and table name from %s",
+				'event_espresso'), $query_param_name));
+		}
+		$number_of_parts = count($query_param_parts);
+		$last_query_param_part = $query_param_parts[count($query_param_parts) - 1];
+		if ($number_of_parts === 1) {
+			$field_name = $last_query_param_part;
+			$model_obj = $this;
+		} else {// $number_of_parts >= 2
+			//the last part is the column name, and there are only 2parts. therefore...
+			$field_name = $last_query_param_part;
+			$model_obj = $this->get_related_model_obj($query_param_parts[$number_of_parts - 2]);
+		}
+		try {
+			return $model_obj->field_settings_for($field_name);
+		} catch (EE_Error $e) {
+			return null;
+		}
+	}
+
+
+
+	/**
+	 * Given a field's name (ie, a key in $this->field_settings()), uses the EE_Model_Field object to get the table's
+	 * alias and column which corresponds to it
+	 *
+	 * @param string $field_name
+	 * @throws EE_Error
+	 * @return string
+	 */
+	public function _get_qualified_column_for_field($field_name)
+	{
+		$all_fields = $this->field_settings();
+		$field = isset($all_fields[$field_name]) ? $all_fields[$field_name] : false;
+		if ($field) {
+			return $field->get_qualified_column();
+		} else {
+			throw new EE_Error(sprintf(__("There is no field titled %s on model %s. Either the query trying to use it is bad, or you need to add it to the list of fields on the model.",
+				'event_espresso'), $field_name, get_class($this)));
+		}
+	}
+
+
+
+	/**
+	 * constructs the select use on special limit joins
+	 * NOTE: for now this has only been tested and will work when the  table alias is for the PRIMARY table. Although
+	 * its setup so the select query will be setup on and just doing the special select join off of the primary table
+	 * (as that is typically where the limits would be set).
+	 *
+	 * @param  string       $table_alias The table the select is being built for
+	 * @param  mixed|string $limit       The limit for this select
+	 * @return string                The final select join element for the query.
+	 */
+	public function _construct_limit_join_select($table_alias, $limit)
+	{
+		$SQL = '';
+		foreach ($this->_tables as $table_obj) {
+			if ($table_obj instanceof EE_Primary_Table) {
+				$SQL .= $table_alias === $table_obj->get_table_alias()
+					? $table_obj->get_select_join_limit($limit)
+					: SP . $table_obj->get_table_name() . " AS " . $table_obj->get_table_alias() . SP;
+			} elseif ($table_obj instanceof EE_Secondary_Table) {
+				$SQL .= $table_alias === $table_obj->get_table_alias()
+					? $table_obj->get_select_join_limit_join($limit)
+					: SP . $table_obj->get_join_sql($table_alias) . SP;
+			}
+		}
+		return $SQL;
+	}
+
+
+
+	/**
+	 * Constructs the internal join if there are multiple tables, or simply the table's name and alias
+	 * Eg "wp_post AS Event" or "wp_post AS Event INNER JOIN wp_postmeta Event_Meta ON Event.ID = Event_Meta.post_id"
+	 *
+	 * @return string SQL
+	 * @throws \EE_Error
+	 */
+	public function _construct_internal_join()
+	{
+		$SQL = $this->_get_main_table()->get_table_sql();
+		$SQL .= $this->_construct_internal_join_to_table_with_alias($this->_get_main_table()->get_table_alias());
+		return $SQL;
+	}
+
+
+
+	/**
+	 * Constructs the SQL for joining all the tables on this model.
+	 * Normally $alias should be the primary table's alias, but in cases where
+	 * we have already joined to a secondary table (eg, the secondary table has a foreign key and is joined before the
+	 * primary table) then we should provide that secondary table's alias. Eg, with $alias being the primary table's
+	 * alias, this will construct SQL like:
+	 * " INNER JOIN wp_esp_secondary_table AS Secondary_Table ON Primary_Table.pk = Secondary_Table.fk".
+	 * With $alias being a secondary table's alias, this will construct SQL like:
+	 * " INNER JOIN wp_esp_primary_table AS Primary_Table ON Primary_Table.pk = Secondary_Table.fk".
+	 *
+	 * @param string $alias_prefixed table alias to join to (this table should already be in the FROM SQL clause)
+	 * @return string
+	 */
+	public function _construct_internal_join_to_table_with_alias($alias_prefixed)
+	{
+		$SQL = '';
+		$alias_sans_prefix = EE_Model_Parser::remove_table_alias_model_relation_chain_prefix($alias_prefixed);
+		foreach ($this->_tables as $table_obj) {
+			if ($table_obj instanceof EE_Secondary_Table) {//table is secondary table
+				if ($alias_sans_prefix === $table_obj->get_table_alias()) {
+					//so we're joining to this table, meaning the table is already in
+					//the FROM statement, BUT the primary table isn't. So we want
+					//to add the inverse join sql
+					$SQL .= $table_obj->get_inverse_join_sql($alias_prefixed);
+				} else {
+					//just add a regular JOIN to this table from the primary table
+					$SQL .= $table_obj->get_join_sql($alias_prefixed);
+				}
+			}//if it's a primary table, dont add any SQL. it should already be in the FROM statement
+		}
+		return $SQL;
+	}
+
+
+
+	/**
+	 * Gets an array for storing all the data types on the next-to-be-executed-query.
+	 * This should be a growing array of keys being table-columns (eg 'EVT_ID' and 'Event.EVT_ID'), and values being
+	 * their data type (eg, '%s', '%d', etc)
+	 *
+	 * @return array
+	 */
+	public function _get_data_types()
+	{
+		$data_types = array();
+		foreach ($this->field_settings() as $field_obj) {
+			//$data_types[$field_obj->get_table_column()] = $field_obj->get_wpdb_data_type();
+			/** @var $field_obj EE_Model_Field_Base */
+			$data_types[$field_obj->get_qualified_column()] = $field_obj->get_wpdb_data_type();
+		}
+		return $data_types;
+	}
+
+
+
+	/**
+	 * Gets the model object given the relation's name / model's name (eg, 'Event', 'Registration',etc. Always singular)
+	 *
+	 * @param string $model_name
+	 * @throws EE_Error
+	 * @return EEM_Base
+	 */
+	public function get_related_model_obj($model_name)
+	{
+		$model_classname = "EEM_" . $model_name;
+		if ( ! class_exists($model_classname)) {
+			throw new EE_Error(sprintf(__("You specified a related model named %s in your query. No such model exists, if it did, it would have the classname %s",
+				'event_espresso'), $model_name, $model_classname));
+		}
+		return call_user_func($model_classname . "::instance");
+	}
+
+
+
+	/**
+	 * Returns the array of EE_ModelRelations for this model.
+	 *
+	 * @return EE_Model_Relation_Base[]
+	 */
+	public function relation_settings()
+	{
+		return $this->_model_relations;
+	}
+
+
+
+	/**
+	 * Gets all related models that this model BELONGS TO. Handy to know sometimes
+	 * because without THOSE models, this model probably doesn't have much purpose.
+	 * (Eg, without an event, datetimes have little purpose.)
+	 *
+	 * @return EE_Belongs_To_Relation[]
+	 */
+	public function belongs_to_relations()
+	{
+		$belongs_to_relations = array();
+		foreach ($this->relation_settings() as $model_name => $relation_obj) {
+			if ($relation_obj instanceof EE_Belongs_To_Relation) {
+				$belongs_to_relations[$model_name] = $relation_obj;
+			}
+		}
+		return $belongs_to_relations;
+	}
+
+
+
+	/**
+	 * Returns the specified EE_Model_Relation, or throws an exception
+	 *
+	 * @param string $relation_name name of relation, key in $this->_relatedModels
+	 * @throws EE_Error
+	 * @return EE_Model_Relation_Base
+	 */
+	public function related_settings_for($relation_name)
+	{
+		$relatedModels = $this->relation_settings();
+		if ( ! array_key_exists($relation_name, $relatedModels)) {
+			throw new EE_Error(
+				sprintf(
+					__('Cannot get %s related to %s. There is no model relation of that type. There is, however, %s...',
+						'event_espresso'),
+					$relation_name,
+					$this->_get_class_name(),
+					implode(', ', array_keys($relatedModels))
+				)
+			);
+		}
+		return $relatedModels[$relation_name];
+	}
+
+
+
+	/**
+	 * A convenience method for getting a specific field's settings, instead of getting all field settings for all
+	 * fields
+	 *
+	 * @param string $fieldName
+	 * @throws EE_Error
+	 * @return EE_Model_Field_Base
+	 */
+	public function field_settings_for($fieldName)
+	{
+		$fieldSettings = $this->field_settings(true);
+		if ( ! array_key_exists($fieldName, $fieldSettings)) {
+			throw new EE_Error(sprintf(__("There is no field/column '%s' on '%s'", 'event_espresso'), $fieldName,
+				get_class($this)));
+		}
+		return $fieldSettings[$fieldName];
+	}
+
+
+
+	/**
+	 * Checks if this field exists on this model
+	 *
+	 * @param string $fieldName a key in the model's _field_settings array
+	 * @return boolean
+	 */
+	public function has_field($fieldName)
+	{
+		$fieldSettings = $this->field_settings(true);
+		if (isset($fieldSettings[$fieldName])) {
+			return true;
+		} else {
+			return false;
+		}
+	}
+
+
+
+	/**
+	 * Returns whether or not this model has a relation to the specified model
+	 *
+	 * @param string $relation_name possibly one of the keys in the relation_settings array
+	 * @return boolean
+	 */
+	public function has_relation($relation_name)
+	{
+		$relations = $this->relation_settings();
+		if (isset($relations[$relation_name])) {
+			return true;
+		} else {
+			return false;
+		}
+	}
+
+
+
+	/**
+	 * gets the field object of type 'primary_key' from the fieldsSettings attribute.
+	 * Eg, on EE_Answer that would be ANS_ID field object
+	 *
+	 * @param $field_obj
+	 * @return boolean
+	 */
+	public function is_primary_key_field($field_obj)
+	{
+		return $field_obj instanceof EE_Primary_Key_Field_Base ? true : false;
+	}
+
+
+
+	/**
+	 * gets the field object of type 'primary_key' from the fieldsSettings attribute.
+	 * Eg, on EE_Answer that would be ANS_ID field object
+	 *
+	 * @return EE_Model_Field_Base
+	 * @throws EE_Error
+	 */
+	public function get_primary_key_field()
+	{
+		if ($this->_primary_key_field === null) {
+			foreach ($this->field_settings(true) as $field_obj) {
+				if ($this->is_primary_key_field($field_obj)) {
+					$this->_primary_key_field = $field_obj;
+					break;
+				}
+			}
+			if ( ! $this->_primary_key_field instanceof EE_Primary_Key_Field_Base) {
+				throw new EE_Error(sprintf(__("There is no Primary Key defined on model %s", 'event_espresso'),
+					get_class($this)));
+			}
+		}
+		return $this->_primary_key_field;
+	}
+
+
+
+	/**
+	 * Returns whether or not not there is a primary key on this model.
+	 * Internally does some caching.
+	 *
+	 * @return boolean
+	 */
+	public function has_primary_key_field()
+	{
+		if ($this->_has_primary_key_field === null) {
+			try {
+				$this->get_primary_key_field();
+				$this->_has_primary_key_field = true;
+			} catch (EE_Error $e) {
+				$this->_has_primary_key_field = false;
+			}
+		}
+		return $this->_has_primary_key_field;
+	}
+
+
+
+	/**
+	 * Finds the first field of type $field_class_name.
+	 *
+	 * @param string $field_class_name class name of field that you want to find. Eg, EE_Datetime_Field,
+	 *                                 EE_Foreign_Key_Field, etc
+	 * @return EE_Model_Field_Base or null if none is found
+	 */
+	public function get_a_field_of_type($field_class_name)
+	{
+		foreach ($this->field_settings() as $field) {
+			if ($field instanceof $field_class_name) {
+				return $field;
+			}
+		}
+		return null;
+	}
+
+
+
+	/**
+	 * Gets a foreign key field pointing to model.
+	 *
+	 * @param string $model_name eg Event, Registration, not EEM_Event
+	 * @return EE_Foreign_Key_Field_Base
+	 * @throws EE_Error
+	 */
+	public function get_foreign_key_to($model_name)
+	{
+		if ( ! isset($this->_cache_foreign_key_to_fields[$model_name])) {
+			foreach ($this->field_settings() as $field) {
+				if (
+					$field instanceof EE_Foreign_Key_Field_Base
+					&& in_array($model_name, $field->get_model_names_pointed_to())
+				) {
+					$this->_cache_foreign_key_to_fields[$model_name] = $field;
+					break;
+				}
+			}
+			if ( ! isset($this->_cache_foreign_key_to_fields[$model_name])) {
+				throw new EE_Error(sprintf(__("There is no foreign key field pointing to model %s on model %s",
+					'event_espresso'), $model_name, get_class($this)));
+			}
+		}
+		return $this->_cache_foreign_key_to_fields[$model_name];
+	}
+
+
+
+	/**
+	 * Gets the actual table for the table alias
+	 *
+	 * @param string $table_alias eg Event, Event_Meta, Registration, Transaction, but maybe
+	 *                            a table alias with a model chain prefix, like 'Venue__Event_Venue___Event_Meta'.
+	 *                            Either one works
+	 * @return EE_Table_Base
+	 */
+	public function get_table_for_alias($table_alias)
+	{
+		$table_alias_sans_model_relation_chain_prefix = EE_Model_Parser::remove_table_alias_model_relation_chain_prefix($table_alias);
+		return $this->_tables[$table_alias_sans_model_relation_chain_prefix]->get_table_name();
+	}
+
+
+
+	/**
+	 * Returns a flat array of all field son this model, instead of organizing them
+	 * by table_alias as they are in the constructor.
+	 *
+	 * @param bool $include_db_only_fields flag indicating whether or not to include the db-only fields
+	 * @return EE_Model_Field_Base[] where the keys are the field's name
+	 */
+	public function field_settings($include_db_only_fields = false)
+	{
+		if ($include_db_only_fields) {
+			if ($this->_cached_fields === null) {
+				$this->_cached_fields = array();
+				foreach ($this->_fields as $fields_corresponding_to_table) {
+					foreach ($fields_corresponding_to_table as $field_name => $field_obj) {
+						$this->_cached_fields[$field_name] = $field_obj;
+					}
+				}
+			}
+			return $this->_cached_fields;
+		} else {
+			if ($this->_cached_fields_non_db_only === null) {
+				$this->_cached_fields_non_db_only = array();
+				foreach ($this->_fields as $fields_corresponding_to_table) {
+					foreach ($fields_corresponding_to_table as $field_name => $field_obj) {
+						/** @var $field_obj EE_Model_Field_Base */
+						if ( ! $field_obj->is_db_only_field()) {
+							$this->_cached_fields_non_db_only[$field_name] = $field_obj;
+						}
+					}
+				}
+			}
+			return $this->_cached_fields_non_db_only;
+		}
+	}
+
+
+
+	/**
+	 *        cycle though array of attendees and create objects out of each item
+	 *
+	 * @access        private
+	 * @param        array $rows of results of $wpdb->get_results($query,ARRAY_A)
+	 * @return \EE_Base_Class[] array keys are primary keys (if there is a primary key on the model. if not,
+	 *                           numerically indexed)
+	 * @throws \EE_Error
+	 */
+	protected function _create_objects($rows = array())
+	{
+		$array_of_objects = array();
+		if (empty($rows)) {
+			return array();
+		}
+		$count_if_model_has_no_primary_key = 0;
+		$has_primary_key = $this->has_primary_key_field();
+		$primary_key_field = $has_primary_key ? $this->get_primary_key_field() : null;
+		foreach ((array)$rows as $row) {
+			if (empty($row)) {
+				//wp did its weird thing where it returns an array like array(0=>null), which is totally not helpful...
+				return array();
+			}
+			//check if we've already set this object in the results array,
+			//in which case there's no need to process it further (again)
+			if ($has_primary_key) {
+				$table_pk_value = $this->_get_column_value_with_table_alias_or_not(
+					$row,
+					$primary_key_field->get_qualified_column(),
+					$primary_key_field->get_table_column()
+				);
+				if ($table_pk_value && isset($array_of_objects[$table_pk_value])) {
+					continue;
+				}
+			}
+			$classInstance = $this->instantiate_class_from_array_or_object($row);
+			if ( ! $classInstance) {
+				throw new EE_Error(
+					sprintf(
+						__('Could not create instance of class %s from row %s', 'event_espresso'),
+						$this->get_this_model_name(),
+						http_build_query($row)
+					)
+				);
+			}
+			//set the timezone on the instantiated objects
+			$classInstance->set_timezone($this->_timezone);
+			//make sure if there is any timezone setting present that we set the timezone for the object
+			$key = $has_primary_key ? $classInstance->ID() : $count_if_model_has_no_primary_key++;
+			$array_of_objects[$key] = $classInstance;
+			//also, for all the relations of type BelongsTo, see if we can cache
+			//those related models
+			//(we could do this for other relations too, but if there are conditions
+			//that filtered out some fo the results, then we'd be caching an incomplete set
+			//so it requires a little more thought than just caching them immediately...)
+			foreach ($this->_model_relations as $modelName => $relation_obj) {
+				if ($relation_obj instanceof EE_Belongs_To_Relation) {
+					//check if this model's INFO is present. If so, cache it on the model
+					$other_model = $relation_obj->get_other_model();
+					$other_model_obj_maybe = $other_model->instantiate_class_from_array_or_object($row);
+					//if we managed to make a model object from the results, cache it on the main model object
+					if ($other_model_obj_maybe) {
+						//set timezone on these other model objects if they are present
+						$other_model_obj_maybe->set_timezone($this->_timezone);
+						$classInstance->cache($modelName, $other_model_obj_maybe);
+					}
+				}
+			}
+		}
+		return $array_of_objects;
+	}
+
+
+
+	/**
+	 * The purpose of this method is to allow us to create a model object that is not in the db that holds default
+	 * values. A typical example of where this is used is when creating a new item and the initial load of a form.  We
+	 * dont' necessarily want to test for if the object is present but just assume it is BUT load the defaults from the
+	 * object (as set in the model_field!).
+	 *
+	 * @return EE_Base_Class single EE_Base_Class object with default values for the properties.
+	 */
+	public function create_default_object()
+	{
+		$this_model_fields_and_values = array();
+		//setup the row using default values;
+		foreach ($this->field_settings() as $field_name => $field_obj) {
+			$this_model_fields_and_values[$field_name] = $field_obj->get_default_value();
+		}
+		$className = $this->_get_class_name();
+		$classInstance = EE_Registry::instance()
+									->load_class($className, array($this_model_fields_and_values), false, false);
+		return $classInstance;
+	}
+
+
+
+	/**
+	 * @param mixed $cols_n_values either an array of where each key is the name of a field, and the value is its value
+	 *                             or an stdClass where each property is the name of a column,
+	 * @return EE_Base_Class
+	 * @throws \EE_Error
+	 */
+	public function instantiate_class_from_array_or_object($cols_n_values)
+	{
+		if ( ! is_array($cols_n_values) && is_object($cols_n_values)) {
+			$cols_n_values = get_object_vars($cols_n_values);
+		}
+		$primary_key = null;
+		//make sure the array only has keys that are fields/columns on this model
+		$this_model_fields_n_values = $this->_deduce_fields_n_values_from_cols_n_values($cols_n_values);
+		if ($this->has_primary_key_field() && isset($this_model_fields_n_values[$this->primary_key_name()])) {
+			$primary_key = $this_model_fields_n_values[$this->primary_key_name()];
+		}
+		$className = $this->_get_class_name();
+		//check we actually found results that we can use to build our model object
+		//if not, return null
+		if ($this->has_primary_key_field()) {
+			if (empty($this_model_fields_n_values[$this->primary_key_name()])) {
+				return null;
+			}
+		} else if ($this->unique_indexes()) {
+			$first_column = reset($this_model_fields_n_values);
+			if (empty($first_column)) {
+				return null;
+			}
+		}
+		// if there is no primary key or the object doesn't already exist in the entity map, then create a new instance
+		if ($primary_key) {
+			$classInstance = $this->get_from_entity_map($primary_key);
+			if ( ! $classInstance) {
+				$classInstance = EE_Registry::instance()
+											->load_class($className,
+												array($this_model_fields_n_values, $this->_timezone), true, false);
+				// add this new object to the entity map
+				$classInstance = $this->add_to_entity_map($classInstance);
+			}
+		} else {
+			$classInstance = EE_Registry::instance()
+										->load_class($className, array($this_model_fields_n_values, $this->_timezone),
+											true, false);
+		}
+		//it is entirely possible that the instantiated class object has a set timezone_string db field and has set it's internal _timezone property accordingly (see new_instance_from_db in model objects particularly EE_Event for example).  In this case, we want to make sure the model object doesn't have its timezone string overwritten by any timezone property currently set here on the model so, we intentionally override the model _timezone property with the model_object timezone property.
+		$this->set_timezone($classInstance->get_timezone());
+		return $classInstance;
+	}
+
+
+
+	/**
+	 * Gets the model object from the  entity map if it exists
+	 *
+	 * @param int|string $id the ID of the model object
+	 * @return EE_Base_Class
+	 */
+	public function get_from_entity_map($id)
+	{
+		return isset($this->_entity_map[EEM_Base::$_model_query_blog_id][$id])
+			? $this->_entity_map[EEM_Base::$_model_query_blog_id][$id] : null;
+	}
+
+
+
+	/**
+	 * add_to_entity_map
+	 * Adds the object to the model's entity mappings
+	 *        Effectively tells the models "Hey, this model object is the most up-to-date representation of the data,
+	 *        and for the remainder of the request, it's even more up-to-date than what's in the database.
+	 *        So, if the database doesn't agree with what's in the entity mapper, ignore the database"
+	 *        If the database gets updated directly and you want the entity mapper to reflect that change,
+	 *        then this method should be called immediately after the update query
+	 * Note: The map is indexed by whatever the current blog id is set (via EEM_Base::$_model_query_blog_id).  This is
+	 * so on multisite, the entity map is specific to the query being done for a specific site.
+	 *
+	 * @param    EE_Base_Class $object
+	 * @throws EE_Error
+	 * @return \EE_Base_Class
+	 */
+	public function add_to_entity_map(EE_Base_Class $object)
+	{
+		$className = $this->_get_class_name();
+		if ( ! $object instanceof $className) {
+			throw new EE_Error(sprintf(__("You tried adding a %s to a mapping of %ss", "event_espresso"),
+				is_object($object) ? get_class($object) : $object, $className));
+		}
+		/** @var $object EE_Base_Class */
+		if ( ! $object->ID()) {
+			throw new EE_Error(sprintf(__("You tried storing a model object with NO ID in the %s entity mapper.",
+				"event_espresso"), get_class($this)));
+		}
+		// double check it's not already there
+		$classInstance = $this->get_from_entity_map($object->ID());
+		if ($classInstance) {
+			return $classInstance;
+		} else {
+			$this->_entity_map[EEM_Base::$_model_query_blog_id][$object->ID()] = $object;
+			return $object;
+		}
+	}
+
+
+
+	/**
+	 * if a valid identifier is provided, then that entity is unset from the entity map,
+	 * if no identifier is provided, then the entire entity map is emptied
+	 *
+	 * @param int|string $id the ID of the model object
+	 * @return boolean
+	 */
+	public function clear_entity_map($id = null)
+	{
+		if (empty($id)) {
+			$this->_entity_map[EEM_Base::$_model_query_blog_id] = array();
+			return true;
+		}
+		if (isset($this->_entity_map[EEM_Base::$_model_query_blog_id][$id])) {
+			unset($this->_entity_map[EEM_Base::$_model_query_blog_id][$id]);
+			return true;
+		}
+		return false;
+	}
+
+
+
+	/**
+	 * Public wrapper for _deduce_fields_n_values_from_cols_n_values.
+	 * Given an array where keys are column (or column alias) names and values,
+	 * returns an array of their corresponding field names and database values
+	 *
+	 * @param array $cols_n_values
+	 * @return array
+	 */
+	public function deduce_fields_n_values_from_cols_n_values($cols_n_values)
+	{
+		return $this->_deduce_fields_n_values_from_cols_n_values($cols_n_values);
+	}
+
+
+
+	/**
+	 * _deduce_fields_n_values_from_cols_n_values
+	 * Given an array where keys are column (or column alias) names and values,
+	 * returns an array of their corresponding field names and database values
+	 *
+	 * @param string $cols_n_values
+	 * @return array
+	 */
+	protected function _deduce_fields_n_values_from_cols_n_values($cols_n_values)
+	{
+		$this_model_fields_n_values = array();
+		foreach ($this->get_tables() as $table_alias => $table_obj) {
+			$table_pk_value = $this->_get_column_value_with_table_alias_or_not($cols_n_values,
+				$table_obj->get_fully_qualified_pk_column(), $table_obj->get_pk_column());
+			//there is a primary key on this table and its not set. Use defaults for all its columns
+			if ($table_pk_value === null && $table_obj->get_pk_column()) {
+				foreach ($this->_get_fields_for_table($table_alias) as $field_name => $field_obj) {
+					if ( ! $field_obj->is_db_only_field()) {
+						//prepare field as if its coming from db
+						$prepared_value = $field_obj->prepare_for_set($field_obj->get_default_value());
+						$this_model_fields_n_values[$field_name] = $field_obj->prepare_for_use_in_db($prepared_value);
+					}
+				}
+			} else {
+				//the table's rows existed. Use their values
+				foreach ($this->_get_fields_for_table($table_alias) as $field_name => $field_obj) {
+					if ( ! $field_obj->is_db_only_field()) {
+						$this_model_fields_n_values[$field_name] = $this->_get_column_value_with_table_alias_or_not(
+							$cols_n_values, $field_obj->get_qualified_column(),
+							$field_obj->get_table_column()
+						);
+					}
+				}
+			}
+		}
+		return $this_model_fields_n_values;
+	}
+
+
+
+	/**
+	 * @param $cols_n_values
+	 * @param $qualified_column
+	 * @param $regular_column
+	 * @return null
+	 */
+	protected function _get_column_value_with_table_alias_or_not($cols_n_values, $qualified_column, $regular_column)
+	{
+		$value = null;
+		//ask the field what it think it's table_name.column_name should be, and call it the "qualified column"
+		//does the field on the model relate to this column retrieved from the db?
+		//or is it a db-only field? (not relating to the model)
+		if (isset($cols_n_values[$qualified_column])) {
+			$value = $cols_n_values[$qualified_column];
+		} elseif (isset($cols_n_values[$regular_column])) {
+			$value = $cols_n_values[$regular_column];
+		}
+		return $value;
+	}
+
+
+
+	/**
+	 * refresh_entity_map_from_db
+	 * Makes sure the model object in the entity map at $id assumes the values
+	 * of the database (opposite of EE_base_Class::save())
+	 *
+	 * @param int|string $id
+	 * @return EE_Base_Class
+	 * @throws \EE_Error
+	 */
+	public function refresh_entity_map_from_db($id)
+	{
+		$obj_in_map = $this->get_from_entity_map($id);
+		if ($obj_in_map) {
+			$wpdb_results = $this->_get_all_wpdb_results(
+				array(array($this->get_primary_key_field()->get_name() => $id), 'limit' => 1)
+			);
+			if ($wpdb_results && is_array($wpdb_results)) {
+				$one_row = reset($wpdb_results);
+				foreach ($this->_deduce_fields_n_values_from_cols_n_values($one_row) as $field_name => $db_value) {
+					$obj_in_map->set_from_db($field_name, $db_value);
+				}
+				//clear the cache of related model objects
+				foreach ($this->relation_settings() as $relation_name => $relation_obj) {
+					$obj_in_map->clear_cache($relation_name, null, true);
+				}
+			}
+			return $obj_in_map;
+		} else {
+			return $this->get_one_by_ID($id);
+		}
+	}
+
+
+
+	/**
+	 * refresh_entity_map_with
+	 * Leaves the entry in the entity map alone, but updates it to match the provided
+	 * $replacing_model_obj (which we assume to be its equivalent but somehow NOT in the entity map).
+	 * This is useful if you have a model object you want to make authoritative over what's in the entity map currently.
+	 * Note: The old $replacing_model_obj should now be destroyed as it's now un-authoritative
+	 *
+	 * @param int|string    $id
+	 * @param EE_Base_Class $replacing_model_obj
+	 * @return \EE_Base_Class
+	 * @throws \EE_Error
+	 */
+	public function refresh_entity_map_with($id, $replacing_model_obj)
+	{
+		$obj_in_map = $this->get_from_entity_map($id);
+		if ($obj_in_map) {
+			if ($replacing_model_obj instanceof EE_Base_Class) {
+				foreach ($replacing_model_obj->model_field_array() as $field_name => $value) {
+					$obj_in_map->set($field_name, $value);
+				}
+				//make the model object in the entity map's cache match the $replacing_model_obj
+				foreach ($this->relation_settings() as $relation_name => $relation_obj) {
+					$obj_in_map->clear_cache($relation_name, null, true);
+					foreach ($replacing_model_obj->get_all_from_cache($relation_name) as $cache_id => $cached_obj) {
+						$obj_in_map->cache($relation_name, $cached_obj, $cache_id);
+					}
+				}
+			}
+			return $obj_in_map;
+		} else {
+			$this->add_to_entity_map($replacing_model_obj);
+			return $replacing_model_obj;
+		}
+	}
+
+
+
+	/**
+	 * Gets the EE class that corresponds to this model. Eg, for EEM_Answer that
+	 * would be EE_Answer.To import that class, you'd just add ".class.php" to the name, like so
+	 * require_once($this->_getClassName().".class.php");
+	 *
+	 * @return string
+	 */
+	private function _get_class_name()
+	{
+		return "EE_" . $this->get_this_model_name();
+	}
+
+
+
+	/**
+	 * Get the name of the items this model represents, for the quantity specified. Eg,
+	 * if $quantity==1, on EEM_Event, it would 'Event' (internationalized), otherwise
+	 * it would be 'Events'.
+	 *
+	 * @param int $quantity
+	 * @return string
+	 */
+	public function item_name($quantity = 1)
+	{
+		return (int)$quantity === 1 ? $this->singular_item : $this->plural_item;
+	}
+
+
+
+	/**
+	 * Very handy general function to allow for plugins to extend any child of EE_TempBase.
+	 * If a method is called on a child of EE_TempBase that doesn't exist, this function is called
+	 * (http://www.garfieldtech.com/blog/php-magic-call) and passed the method's name and arguments. Instead of
+	 * requiring a plugin to extend the EE_TempBase (which works fine is there's only 1 plugin, but when will that
+	 * happen?) they can add a hook onto 'filters_hook_espresso__{className}__{methodName}' (eg,
+	 * filters_hook_espresso__EE_Answer__my_great_function) and accepts 2 arguments: the object on which the function
+	 * was called, and an array of the original arguments passed to the function. Whatever their callback function
+	 * returns will be returned by this function. Example: in functions.php (or in a plugin):
+	 * add_filter('FHEE__EE_Answer__my_callback','my_callback',10,3); function
+	 * my_callback($previousReturnValue,EE_TempBase $object,$argsArray){
+	 * $returnString= "you called my_callback! and passed args:".implode(",",$argsArray);
+	 *        return $previousReturnValue.$returnString;
+	 * }
+	 * require('EEM_Answer.model.php');
+	 * $answer=EEM_Answer::instance();
+	 * echo $answer->my_callback('monkeys',100);
+	 * //will output "you called my_callback! and passed args:monkeys,100"
+	 *
+	 * @param string $methodName name of method which was called on a child of EE_TempBase, but which
+	 * @param array  $args       array of original arguments passed to the function
+	 * @throws EE_Error
+	 * @return mixed whatever the plugin which calls add_filter decides
+	 */
+	public function __call($methodName, $args)
+	{
+		$className = get_class($this);
+		$tagName = "FHEE__{$className}__{$methodName}";
+		if ( ! has_filter($tagName)) {
+			throw new EE_Error(
+				sprintf(
+					__('Method %1$s on model %2$s does not exist! You can create one with the following code in functions.php or in a plugin: %4$s function my_callback(%4$s \$previousReturnValue, EEM_Base \$object\ $argsArray=NULL ){%4$s     /*function body*/%4$s      return \$whatever;%4$s }%4$s add_filter( \'%3$s\', \'my_callback\', 10, 3 );',
+						'event_espresso'),
+					$methodName,
+					$className,
+					$tagName,
+					'<br />'
+				)
+			);
+		}
+		return apply_filters($tagName, null, $this, $args);
+	}
+
+
+
+	/**
+	 * Ensures $base_class_obj_or_id is of the EE_Base_Class child that corresponds ot this model.
+	 * If not, assumes its an ID, and uses $this->get_one_by_ID() to get the EE_Base_Class.
+	 *
+	 * @param EE_Base_Class|string|int $base_class_obj_or_id either:
+	 *                                                       the EE_Base_Class object that corresponds to this Model,
+	 *                                                       the object's class name
+	 *                                                       or object's ID
+	 * @param boolean                  $ensure_is_in_db      if set, we will also verify this model object
+	 *                                                       exists in the database. If it does not, we add it
+	 * @throws EE_Error
+	 * @return EE_Base_Class
+	 */
+	public function ensure_is_obj($base_class_obj_or_id, $ensure_is_in_db = false)
+	{
+		$className = $this->_get_class_name();
+		if ($base_class_obj_or_id instanceof $className) {
+			$model_object = $base_class_obj_or_id;
+		} else {
+			$primary_key_field = $this->get_primary_key_field();
+			if (
+				$primary_key_field instanceof EE_Primary_Key_Int_Field
+				&& (
+					is_int($base_class_obj_or_id)
+					|| is_string($base_class_obj_or_id)
+				)
+			) {
+				// assume it's an ID.
+				// either a proper integer or a string representing an integer (eg "101" instead of 101)
+				$model_object = $this->get_one_by_ID($base_class_obj_or_id);
+			} else if (
+				$primary_key_field instanceof EE_Primary_Key_String_Field
+				&& is_string($base_class_obj_or_id)
+			) {
+				// assume its a string representation of the object
+				$model_object = $this->get_one_by_ID($base_class_obj_or_id);
+			} else {
+				throw new EE_Error(
+					sprintf(
+						__(
+							"'%s' is neither an object of type %s, nor an ID! Its full value is '%s'",
+							'event_espresso'
+						),
+						$base_class_obj_or_id,
+						$this->_get_class_name(),
+						print_r($base_class_obj_or_id, true)
+					)
+				);
+			}
+		}
+		if ($ensure_is_in_db && $model_object->ID() !== null) {
+			$model_object->save();
+		}
+		return $model_object;
+	}
+
+
+
+	/**
+	 * Similar to ensure_is_obj(), this method makes sure $base_class_obj_or_id
+	 * is a value of the this model's primary key. If it's an EE_Base_Class child,
+	 * returns it ID.
+	 *
+	 * @param EE_Base_Class|int|string $base_class_obj_or_id
+	 * @return int|string depending on the type of this model object's ID
+	 * @throws EE_Error
+	 */
+	public function ensure_is_ID($base_class_obj_or_id)
+	{
+		$className = $this->_get_class_name();
+		if ($base_class_obj_or_id instanceof $className) {
+			/** @var $base_class_obj_or_id EE_Base_Class */
+			$id = $base_class_obj_or_id->ID();
+		} elseif (is_int($base_class_obj_or_id)) {
+			//assume it's an ID
+			$id = $base_class_obj_or_id;
+		} elseif (is_string($base_class_obj_or_id)) {
+			//assume its a string representation of the object
+			$id = $base_class_obj_or_id;
+		} else {
+			throw new EE_Error(sprintf(__("'%s' is neither an object of type %s, nor an ID! Its full value is '%s'",
+				'event_espresso'), $base_class_obj_or_id, $this->_get_class_name(),
+				print_r($base_class_obj_or_id, true)));
+		}
+		return $id;
+	}
+
+
+
+	/**
+	 * Sets whether the values passed to the model (eg, values in WHERE, values in INSERT, UPDATE, etc)
+	 * have already been ran through the appropriate model field's prepare_for_use_in_db method. IE, they have
+	 * been sanitized and converted into the appropriate domain.
+	 * Usually the only place you'll want to change the default (which is to assume values have NOT been sanitized by
+	 * the model object/model field) is when making a method call from WITHIN a model object, which has direct access
+	 * to its sanitized values. Note: after changing this setting, you should set it back to its previous value (using
+	 * get_assumption_concerning_values_already_prepared_by_model_object()) eg.
+	 * $EVT = EEM_Event::instance(); $old_setting =
+	 * $EVT->get_assumption_concerning_values_already_prepared_by_model_object();
+	 * $EVT->assume_values_already_prepared_by_model_object(true);
+	 * $EVT->update(array('foo'=>'bar'),array(array('foo'=>'monkey')));
+	 * $EVT->assume_values_already_prepared_by_model_object($old_setting);
+	 *
+	 * @param int $values_already_prepared like one of the constants on EEM_Base
+	 * @return void
+	 */
+	public function assume_values_already_prepared_by_model_object(
+		$values_already_prepared = self::not_prepared_by_model_object
+	) {
+		$this->_values_already_prepared_by_model_object = $values_already_prepared;
+	}
+
+
+
+	/**
+	 * Read comments for assume_values_already_prepared_by_model_object()
+	 *
+	 * @return int
+	 */
+	public function get_assumption_concerning_values_already_prepared_by_model_object()
+	{
+		return $this->_values_already_prepared_by_model_object;
+	}
+
+
+
+	/**
+	 * Gets all the indexes on this model
+	 *
+	 * @return EE_Index[]
+	 */
+	public function indexes()
+	{
+		return $this->_indexes;
+	}
+
+
+
+	/**
+	 * Gets all the Unique Indexes on this model
+	 *
+	 * @return EE_Unique_Index[]
+	 */
+	public function unique_indexes()
+	{
+		$unique_indexes = array();
+		foreach ($this->_indexes as $name => $index) {
+			if ($index instanceof EE_Unique_Index) {
+				$unique_indexes [$name] = $index;
+			}
+		}
+		return $unique_indexes;
+	}
+
+
+
+	/**
+	 * Gets all the fields which, when combined, make the primary key.
+	 * This is usually just an array with 1 element (the primary key), but in cases
+	 * where there is no primary key, it's a combination of fields as defined
+	 * on a primary index
+	 *
+	 * @return EE_Model_Field_Base[] indexed by the field's name
+	 * @throws \EE_Error
+	 */
+	public function get_combined_primary_key_fields()
+	{
+		foreach ($this->indexes() as $index) {
+			if ($index instanceof EE_Primary_Key_Index) {
+				return $index->fields();
+			}
+		}
+		return array($this->primary_key_name() => $this->get_primary_key_field());
+	}
+
+
+
+	/**
+	 * Used to build a primary key string (when the model has no primary key),
+	 * which can be used a unique string to identify this model object.
+	 *
+	 * @param array $cols_n_values keys are field names, values are their values
+	 * @return string
+	 * @throws \EE_Error
+	 */
+	public function get_index_primary_key_string($cols_n_values)
+	{
+		$cols_n_values_for_primary_key_index = array_intersect_key($cols_n_values,
+			$this->get_combined_primary_key_fields());
+		return http_build_query($cols_n_values_for_primary_key_index);
+	}
+
+
+
+	/**
+	 * Gets the field values from the primary key string
+	 *
+	 * @see EEM_Base::get_combined_primary_key_fields() and EEM_Base::get_index_primary_key_string()
+	 * @param string $index_primary_key_string
+	 * @return null|array
+	 * @throws \EE_Error
+	 */
+	public function parse_index_primary_key_string($index_primary_key_string)
+	{
+		$key_fields = $this->get_combined_primary_key_fields();
+		//check all of them are in the $id
+		$key_vals_in_combined_pk = array();
+		parse_str($index_primary_key_string, $key_vals_in_combined_pk);
+		foreach ($key_fields as $key_field_name => $field_obj) {
+			if ( ! isset($key_vals_in_combined_pk[$key_field_name])) {
+				return null;
+			}
+		}
+		return $key_vals_in_combined_pk;
+	}
+
+
+
+	/**
+	 * verifies that an array of key-value pairs for model fields has a key
+	 * for each field comprising the primary key index
+	 *
+	 * @param array $key_vals
+	 * @return boolean
+	 * @throws \EE_Error
+	 */
+	public function has_all_combined_primary_key_fields($key_vals)
+	{
+		$keys_it_should_have = array_keys($this->get_combined_primary_key_fields());
+		foreach ($keys_it_should_have as $key) {
+			if ( ! isset($key_vals[$key])) {
+				return false;
+			}
+		}
+		return true;
+	}
+
+
+
+	/**
+	 * Finds all model objects in the DB that appear to be a copy of $model_object_or_attributes_array.
+	 * We consider something to be a copy if all the attributes match (except the ID, of course).
+	 *
+	 * @param array|EE_Base_Class $model_object_or_attributes_array If its an array, it's field-value pairs
+	 * @param array               $query_params                     like EEM_Base::get_all's query_params.
+	 * @throws EE_Error
+	 * @return \EE_Base_Class[] Array keys are object IDs (if there is a primary key on the model. if not, numerically
+	 *                                                              indexed)
+	 */
+	public function get_all_copies($model_object_or_attributes_array, $query_params = array())
+	{
+		if ($model_object_or_attributes_array instanceof EE_Base_Class) {
+			$attributes_array = $model_object_or_attributes_array->model_field_array();
+		} elseif (is_array($model_object_or_attributes_array)) {
+			$attributes_array = $model_object_or_attributes_array;
+		} else {
+			throw new EE_Error(sprintf(__("get_all_copies should be provided with either a model object or an array of field-value-pairs, but was given %s",
+				"event_espresso"), $model_object_or_attributes_array));
+		}
+		//even copies obviously won't have the same ID, so remove the primary key
+		//from the WHERE conditions for finding copies (if there is a primary key, of course)
+		if ($this->has_primary_key_field() && isset($attributes_array[$this->primary_key_name()])) {
+			unset($attributes_array[$this->primary_key_name()]);
+		}
+		if (isset($query_params[0])) {
+			$query_params[0] = array_merge($attributes_array, $query_params);
+		} else {
+			$query_params[0] = $attributes_array;
+		}
+		return $this->get_all($query_params);
+	}
+
+
+
+	/**
+	 * Gets the first copy we find. See get_all_copies for more details
+	 *
+	 * @param       mixed EE_Base_Class | array        $model_object_or_attributes_array
+	 * @param array $query_params
+	 * @return EE_Base_Class
+	 * @throws \EE_Error
+	 */
+	public function get_one_copy($model_object_or_attributes_array, $query_params = array())
+	{
+		if ( ! is_array($query_params)) {
+			EE_Error::doing_it_wrong('EEM_Base::get_one_copy',
+				sprintf(__('$query_params should be an array, you passed a variable of type %s', 'event_espresso'),
+					gettype($query_params)), '4.6.0');
+			$query_params = array();
+		}
+		$query_params['limit'] = 1;
+		$copies = $this->get_all_copies($model_object_or_attributes_array, $query_params);
+		if (is_array($copies)) {
+			return array_shift($copies);
+		} else {
+			return null;
+		}
+	}
+
+
+
+	/**
+	 * Updates the item with the specified id. Ignores default query parameters because
+	 * we have specified the ID, and its assumed we KNOW what we're doing
+	 *
+	 * @param array      $fields_n_values keys are field names, values are their new values
+	 * @param int|string $id              the value of the primary key to update
+	 * @return int number of rows updated
+	 * @throws \EE_Error
+	 */
+	public function update_by_ID($fields_n_values, $id)
+	{
+		$query_params = array(
+			0                          => array($this->get_primary_key_field()->get_name() => $id),
+			'default_where_conditions' => 'other_models_only',
+		);
+		return $this->update($fields_n_values, $query_params);
+	}
+
+
+
+	/**
+	 * Changes an operator which was supplied to the models into one usable in SQL
+	 *
+	 * @param string $operator_supplied
+	 * @return string an operator which can be used in SQL
+	 * @throws EE_Error
+	 */
+	private function _prepare_operator_for_sql($operator_supplied)
+	{
+		$sql_operator = isset($this->_valid_operators[$operator_supplied]) ? $this->_valid_operators[$operator_supplied]
+			: null;
+		if ($sql_operator) {
+			return $sql_operator;
+		} else {
+			throw new EE_Error(sprintf(__("The operator '%s' is not in the list of valid operators: %s",
+				"event_espresso"), $operator_supplied, implode(",", array_keys($this->_valid_operators))));
+		}
+	}
+
+
+
+	/**
+	 * Gets an array where keys are the primary keys and values are their 'names'
+	 * (as determined by the model object's name() function, which is often overridden)
+	 *
+	 * @param array $query_params like get_all's
+	 * @return string[]
+	 * @throws \EE_Error
+	 */
+	public function get_all_names($query_params = array())
+	{
+		$objs = $this->get_all($query_params);
+		$names = array();
+		foreach ($objs as $obj) {
+			$names[$obj->ID()] = $obj->name();
+		}
+		return $names;
+	}
+
+
+
+	/**
+	 * Gets an array of primary keys from the model objects. If you acquired the model objects
+	 * using EEM_Base::get_all() you don't need to call this (and probably shouldn't because
+	 * this is duplicated effort and reduces efficiency) you would be better to use
+	 * array_keys() on $model_objects.
+	 *
+	 * @param \EE_Base_Class[] $model_objects
+	 * @param boolean          $filter_out_empty_ids if a model object has an ID of '' or 0, don't bother including it
+	 *                                               in the returned array
+	 * @return array
+	 * @throws \EE_Error
+	 */
+	public function get_IDs($model_objects, $filter_out_empty_ids = false)
+	{
+		if ( ! $this->has_primary_key_field()) {
+			if (WP_DEBUG) {
+				EE_Error::add_error(
+					__('Trying to get IDs from a model than has no primary key', 'event_espresso'),
+					__FILE__,
+					__FUNCTION__,
+					__LINE__
+				);
+			}
+		}
+		$IDs = array();
+		foreach ($model_objects as $model_object) {
+			$id = $model_object->ID();
+			if ( ! $id) {
+				if ($filter_out_empty_ids) {
+					continue;
+				}
+				if (WP_DEBUG) {
+					EE_Error::add_error(
+						__(
+							'Called %1$s on a model object that has no ID and so probably hasn\'t been saved to the database',
+							'event_espresso'
+						),
+						__FILE__,
+						__FUNCTION__,
+						__LINE__
+					);
+				}
+			}
+			$IDs[] = $id;
+		}
+		return $IDs;
+	}
+
+
+
+	/**
+	 * Returns the string used in capabilities relating to this model. If there
+	 * are no capabilities that relate to this model returns false
+	 *
+	 * @return string|false
+	 */
+	public function cap_slug()
+	{
+		return apply_filters('FHEE__EEM_Base__cap_slug', $this->_caps_slug, $this);
+	}
+
+
+
+	/**
+	 * Returns the capability-restrictions array (@see EEM_Base::_cap_restrictions).
+	 * If $context is provided (which should be set to one of EEM_Base::valid_cap_contexts())
+	 * only returns the cap restrictions array in that context (ie, the array
+	 * at that key)
+	 *
+	 * @param string $context
+	 * @return EE_Default_Where_Conditions[] indexed by associated capability
+	 * @throws \EE_Error
+	 */
+	public function cap_restrictions($context = EEM_Base::caps_read)
+	{
+		EEM_Base::verify_is_valid_cap_context($context);
+		//check if we ought to run the restriction generator first
+		if (
+			isset($this->_cap_restriction_generators[$context])
+			&& $this->_cap_restriction_generators[$context] instanceof EE_Restriction_Generator_Base
+			&& ! $this->_cap_restriction_generators[$context]->has_generated_cap_restrictions()
+		) {
+			$this->_cap_restrictions[$context] = array_merge(
+				$this->_cap_restrictions[$context],
+				$this->_cap_restriction_generators[$context]->generate_restrictions()
+			);
+		}
+		//and make sure we've finalized the construction of each restriction
+		foreach ($this->_cap_restrictions[$context] as $where_conditions_obj) {
+			if ($where_conditions_obj instanceof EE_Default_Where_Conditions) {
+				$where_conditions_obj->_finalize_construct($this);
+			}
+		}
+		return $this->_cap_restrictions[$context];
+	}
+
+
+
+	/**
+	 * Indicating whether or not this model thinks its a wp core model
+	 *
+	 * @return boolean
+	 */
+	public function is_wp_core_model()
+	{
+		return $this->_wp_core_model;
+	}
+
+
+
+	/**
+	 * Gets all the caps that are missing which impose a restriction on
+	 * queries made in this context
+	 *
+	 * @param string $context one of EEM_Base::caps_ constants
+	 * @return EE_Default_Where_Conditions[] indexed by capability name
+	 * @throws \EE_Error
+	 */
+	public function caps_missing($context = EEM_Base::caps_read)
+	{
+		$missing_caps = array();
+		$cap_restrictions = $this->cap_restrictions($context);
+		foreach ($cap_restrictions as $cap => $restriction_if_no_cap) {
+			if ( ! EE_Capabilities::instance()
+								  ->current_user_can($cap, $this->get_this_model_name() . '_model_applying_caps')
+			) {
+				$missing_caps[$cap] = $restriction_if_no_cap;
+			}
+		}
+		return $missing_caps;
+	}
+
+
+
+	/**
+	 * Gets the mapping from capability contexts to action strings used in capability names
+	 *
+	 * @return array keys are one of EEM_Base::valid_cap_contexts(), and values are usually
+	 * one of 'read', 'edit', or 'delete'
+	 */
+	public function cap_contexts_to_cap_action_map()
+	{
+		return apply_filters('FHEE__EEM_Base__cap_contexts_to_cap_action_map', $this->_cap_contexts_to_cap_action_map,
+			$this);
+	}
+
+
+
+	/**
+	 * Gets the action string for the specified capability context
+	 *
+	 * @param string $context
+	 * @return string one of EEM_Base::cap_contexts_to_cap_action_map() values
+	 * @throws \EE_Error
+	 */
+	public function cap_action_for_context($context)
+	{
+		$mapping = $this->cap_contexts_to_cap_action_map();
+		if (isset($mapping[$context])) {
+			return $mapping[$context];
+		}
+		if ($action = apply_filters('FHEE__EEM_Base__cap_action_for_context', null, $this, $mapping, $context)) {
+			return $action;
+		}
+		throw new EE_Error(
+			sprintf(
+				__('Cannot find capability restrictions for context "%1$s", allowed values are:%2$s', 'event_espresso'),
+				$context,
+				implode(',', array_keys($this->cap_contexts_to_cap_action_map()))
+			)
+		);
+	}
+
+
+
+	/**
+	 * Returns all the capability contexts which are valid when querying models
+	 *
+	 * @return array
+	 */
+	static public function valid_cap_contexts()
+	{
+		return apply_filters('FHEE__EEM_Base__valid_cap_contexts', array(
+			self::caps_read,
+			self::caps_read_admin,
+			self::caps_edit,
+			self::caps_delete,
+		));
+	}
+
+
+
+	/**
+	 * Verifies $context is one of EEM_Base::valid_cap_contexts(), if not it throws an exception
+	 *
+	 * @param string $context
+	 * @return bool
+	 * @throws \EE_Error
+	 */
+	static public function verify_is_valid_cap_context($context)
+	{
+		$valid_cap_contexts = EEM_Base::valid_cap_contexts();
+		if (in_array($context, $valid_cap_contexts)) {
+			return true;
+		} else {
+			throw new EE_Error(
+				sprintf(
+					__('Context "%1$s" passed into model "%2$s" is not a valid context. They are: %3$s',
+						'event_espresso'),
+					$context,
+					'EEM_Base',
+					implode(',', $valid_cap_contexts)
+				)
+			);
+		}
+	}
+
+
+
+	/**
+	 * Clears all the models field caches. This is only useful when a sub-class
+	 * might have added a field or something and these caches might be invalidated
+	 */
+	protected function _invalidate_field_caches()
+	{
+		$this->_cache_foreign_key_to_fields = array();
+		$this->_cached_fields = null;
+		$this->_cached_fields_non_db_only = null;
+	}
+
+
+
+	/**
+	 * _instantiate_new_instance_from_db
+	 *
+	 * @param string $class_name
+	 * @param array  $arguments
+	 * @return \EE_Base_Class
+	 * @throws \Exception
+	 */
+	public function _instantiate_new_instance_from_db($class_name, $arguments)
+	{
+		if ( ! class_exists($class_name)) {
+			throw new EE_Error(
+				sprintf(
+					__('The "%s" class does not exist. Please ensure that an autoloader is set.', 'event_espresso'),
+					$class_name
+				)
+			);
+		}
+		return call_user_func_array(
+			array($class_name, 'new_instance'),
+			array((array)$arguments, $this->_timezone, array(), true)
+		);
+	}
 
 
 }

Spacing +73 added lines, -73 removed lines

@@ -467,7 +467,7 @@ 
     {
         // check that the model has not been loaded too soon
         if ( ! did_action('AHEE__EE_System__load_espresso_addons')) {
-            throw new EE_Error (
+            throw new EE_Error(
                 sprintf(
                     __('The %1$s model can not be loaded before the "AHEE__EE_System__load_espresso_addons" hook has been called. This gives other addons a chance to extend this model.',
                         'event_espresso'),
@@ -487,7 +487,7 @@ 
          *
          * @var EE_Table_Base[] $_tables
          */
-        $this->_tables = apply_filters('FHEE__' . get_class($this) . '__construct__tables', $this->_tables);
+        $this->_tables = apply_filters('FHEE__'.get_class($this).'__construct__tables', $this->_tables);
         foreach ($this->_tables as $table_alias => $table_obj) {
             /** @var $table_obj EE_Table_Base */
             $table_obj->_construct_finalize_with_alias($table_alias);
@@ -502,7 +502,7 @@ 
          *
          * @param EE_Model_Field_Base[] $_fields
          */
-        $this->_fields = apply_filters('FHEE__' . get_class($this) . '__construct__fields', $this->_fields);
+        $this->_fields = apply_filters('FHEE__'.get_class($this).'__construct__fields', $this->_fields);
         $this->_invalidate_field_caches();
         foreach ($this->_fields as $table_alias => $fields_for_table) {
             if ( ! array_key_exists($table_alias, $this->_tables)) {
@@ -533,7 +533,7 @@ 
          *
          * @param EE_Model_Relation_Base[] $_model_relations
          */
-        $this->_model_relations = apply_filters('FHEE__' . get_class($this) . '__construct__model_relations',
+        $this->_model_relations = apply_filters('FHEE__'.get_class($this).'__construct__model_relations',
             $this->_model_relations);
         foreach ($this->_model_relations as $model_name => $relation_obj) {
             /** @var $relation_obj EE_Model_Relation_Base */
@@ -595,7 +595,7 @@ 
                 }
             }
         }
-        do_action('AHEE__' . get_class($this) . '__construct__end');
+        do_action('AHEE__'.get_class($this).'__construct__end');
     }
 
 
@@ -630,7 +630,7 @@ 
      */
     public static function set_model_query_blog_id($blog_id = 0)
     {
-        EEM_Base::$_model_query_blog_id = $blog_id > 0 ? (int)$blog_id : get_current_blog_id();
+        EEM_Base::$_model_query_blog_id = $blog_id > 0 ? (int) $blog_id : get_current_blog_id();
     }
 
 
@@ -889,13 +889,13 @@ 
                 $models_to_follow_to_wp_users = explode('.', $this->_model_chain_to_wp_user);
                 $last_model_name = end($models_to_follow_to_wp_users);
                 $model_with_fk_to_wp_users = EE_Registry::instance()->load_model($last_model_name);
-                $model_chain_to_wp_user = $this->_model_chain_to_wp_user . '.';
+                $model_chain_to_wp_user = $this->_model_chain_to_wp_user.'.';
             } else {
                 $model_with_fk_to_wp_users = $this;
                 $model_chain_to_wp_user = '';
             }
             $wp_user_field = $model_with_fk_to_wp_users->get_foreign_key_to('WP_User');
-            return $model_chain_to_wp_user . $wp_user_field->get_name();
+            return $model_chain_to_wp_user.$wp_user_field->get_name();
         } catch (EE_Error $e) {
             return false;
         }
@@ -967,12 +967,12 @@ 
         // remember the custom selections, if any, and type cast as array
         // (unless $columns_to_select is an object, then just set as an empty array)
         // Note: (array) 'some string' === array( 'some string' )
-        $this->_custom_selections = ! is_object($columns_to_select) ? (array)$columns_to_select : array();
+        $this->_custom_selections = ! is_object($columns_to_select) ? (array) $columns_to_select : array();
         $model_query_info = $this->_create_model_query_info_carrier($query_params);
         $select_expressions = $columns_to_select !== null
             ? $this->_construct_select_from_input($columns_to_select)
             : $this->_construct_default_select_sql($model_query_info);
-        $SQL = "SELECT $select_expressions " . $this->_construct_2nd_half_of_select_query($model_query_info);
+        $SQL = "SELECT $select_expressions ".$this->_construct_2nd_half_of_select_query($model_query_info);
         return $this->_do_wpdb_query('get_results', array($SQL, $output));
     }
 
@@ -1304,7 +1304,7 @@ 
         $query_params[0][$field_to_order_by] = array($operand, $current_field_value);
         $query_params['limit'] = $limit;
         //set direction
-        $incoming_orderby = isset($query_params['order_by']) ? (array)$query_params['order_by'] : array();
+        $incoming_orderby = isset($query_params['order_by']) ? (array) $query_params['order_by'] : array();
         $query_params['order_by'] = $operand === '>'
             ? array($field_to_order_by => 'ASC') + $incoming_orderby
             : array($field_to_order_by => 'DESC') + $incoming_orderby;
@@ -1545,7 +1545,7 @@ 
          * @param EEM_Base $model           the model being queried
          * @param array    $query_params    see EEM_Base::get_all()
          */
-        $fields_n_values = (array)apply_filters('FHEE__EEM_Base__update__fields_n_values', $fields_n_values, $this,
+        $fields_n_values = (array) apply_filters('FHEE__EEM_Base__update__fields_n_values', $fields_n_values, $this,
             $query_params);
         //need to verify that, for any entry we want to update, there are entries in each secondary table.
         //to do that, for each table, verify that it's PK isn't null.
@@ -1559,7 +1559,7 @@ 
         $wpdb_select_results = $this->_get_all_wpdb_results($query_params);
         foreach ($wpdb_select_results as $wpdb_result) {
             // type cast stdClass as array
-            $wpdb_result = (array)$wpdb_result;
+            $wpdb_result = (array) $wpdb_result;
             //get the model object's PK, as we'll want this if we need to insert a row into secondary tables
             if ($this->has_primary_key_field()) {
                 $main_table_pk_value = $wpdb_result[$this->get_primary_key_field()->get_qualified_column()];
@@ -1640,7 +1640,7 @@ 
                . $model_query_info->get_full_join_sql()
                . " SET "
                . $this->_construct_update_sql($fields_n_values)
-               . $model_query_info->get_where_sql();//note: doesn't use _construct_2nd_half_of_select_query() because doesn't accept LIMIT, ORDER BY, etc.
+               . $model_query_info->get_where_sql(); //note: doesn't use _construct_2nd_half_of_select_query() because doesn't accept LIMIT, ORDER BY, etc.
         $rows_affected = $this->_do_wpdb_query('query', array($SQL));
         /**
          * Action called after a model update call has been made.
@@ -1651,7 +1651,7 @@ 
          * @param int      $rows_affected
          */
         do_action('AHEE__EEM_Base__update__end', $this, $fields_n_values, $query_params, $rows_affected);
-        return $rows_affected;//how many supposedly got updated
+        return $rows_affected; //how many supposedly got updated
     }
 
 
@@ -1679,7 +1679,7 @@ 
         }
         $model_query_info = $this->_create_model_query_info_carrier($query_params);
         $select_expressions = $field->get_qualified_column();
-        $SQL = "SELECT $select_expressions " . $this->_construct_2nd_half_of_select_query($model_query_info);
+        $SQL = "SELECT $select_expressions ".$this->_construct_2nd_half_of_select_query($model_query_info);
         return $this->_do_wpdb_query('get_col', array($SQL));
     }
 
@@ -1729,7 +1729,7 @@ 
             $prepared_value = $this->_prepare_value_or_use_default($field_obj, $fields_n_values);
             $value_sql = $prepared_value === null ? 'NULL'
                 : $wpdb->prepare($field_obj->get_wpdb_data_type(), $prepared_value);
-            $cols_n_values[] = $field_obj->get_qualified_column() . "=" . $value_sql;
+            $cols_n_values[] = $field_obj->get_qualified_column()."=".$value_sql;
         }
         return implode(",", $cols_n_values);
     }
@@ -1861,7 +1861,7 @@ 
          * @param int      $rows_deleted
          */
         do_action('AHEE__EEM_Base__delete__end', $this, $query_params, $rows_deleted);
-        return $rows_deleted;//how many supposedly got deleted
+        return $rows_deleted; //how many supposedly got deleted
     }
 
 
@@ -1977,7 +1977,7 @@ 
             foreach ($deletes as $column => $values) {
                 //make sure we have unique $values;
                 $values = array_unique($values);
-                $query[] = $column . ' IN(' . implode(",", $values) . ')';
+                $query[] = $column.' IN('.implode(",", $values).')';
             }
             return ! empty($query) ? implode(' AND ', $query) : '';
         } elseif (count($this->get_combined_primary_key_fields()) > 1) {
@@ -1993,7 +1993,7 @@ 
                                                            . $delete_object[$cpk_field->get_qualified_column()];
                     }
                 }
-                $ways_to_identify_a_row[] = "(" . implode(" AND ", $values_for_each_cpk_for_a_row) . ")";
+                $ways_to_identify_a_row[] = "(".implode(" AND ", $values_for_each_cpk_for_a_row).")";
             }
             return implode(" OR ", $ways_to_identify_a_row);
         } else {
@@ -2042,9 +2042,9 @@ 
                 $column_to_count = '*';
             }
         }
-        $column_to_count = $distinct ? "DISTINCT " . $column_to_count : $column_to_count;
-        $SQL = "SELECT COUNT(" . $column_to_count . ")" . $this->_construct_2nd_half_of_select_query($model_query_info);
-        return (int)$this->_do_wpdb_query('get_var', array($SQL));
+        $column_to_count = $distinct ? "DISTINCT ".$column_to_count : $column_to_count;
+        $SQL = "SELECT COUNT(".$column_to_count.")".$this->_construct_2nd_half_of_select_query($model_query_info);
+        return (int) $this->_do_wpdb_query('get_var', array($SQL));
     }
 
 
@@ -2066,13 +2066,13 @@ 
             $field_obj = $this->get_primary_key_field();
         }
         $column_to_count = $field_obj->get_qualified_column();
-        $SQL = "SELECT SUM(" . $column_to_count . ")" . $this->_construct_2nd_half_of_select_query($model_query_info);
+        $SQL = "SELECT SUM(".$column_to_count.")".$this->_construct_2nd_half_of_select_query($model_query_info);
         $return_value = $this->_do_wpdb_query('get_var', array($SQL));
         $data_type = $field_obj->get_wpdb_data_type();
         if ($data_type === '%d' || $data_type === '%s') {
-            return (float)$return_value;
+            return (float) $return_value;
         } else {//must be %f
-            return (float)$return_value;
+            return (float) $return_value;
         }
     }
 
@@ -2247,11 +2247,11 @@ 
      */
     private function _construct_2nd_half_of_select_query(EE_Model_Query_Info_Carrier $model_query_info)
     {
-        return " FROM " . $model_query_info->get_full_join_sql() .
-               $model_query_info->get_where_sql() .
-               $model_query_info->get_group_by_sql() .
-               $model_query_info->get_having_sql() .
-               $model_query_info->get_order_by_sql() .
+        return " FROM ".$model_query_info->get_full_join_sql().
+               $model_query_info->get_where_sql().
+               $model_query_info->get_group_by_sql().
+               $model_query_info->get_having_sql().
+               $model_query_info->get_order_by_sql().
                $model_query_info->get_limit_sql();
     }
 
@@ -2452,7 +2452,7 @@ 
         }
         $this_model_name = $this->get_this_model_name();
         $this_pk_field_name = $this->get_primary_key_field()->get_name();
-        $query_params[0][$this_model_name . "." . $this_pk_field_name] = $id_or_obj;
+        $query_params[0][$this_model_name.".".$this_pk_field_name] = $id_or_obj;
         return $related_model->count($query_params, $field_to_count, $distinct);
     }
 
@@ -2485,7 +2485,7 @@ 
         }
         $this_model_name = $this->get_this_model_name();
         $this_pk_field_name = $this->get_primary_key_field()->get_name();
-        $query_params[0][$this_model_name . "." . $this_pk_field_name] = $id_or_obj;
+        $query_params[0][$this_model_name.".".$this_pk_field_name] = $id_or_obj;
         return $related_model->sum($query_params, $field_to_sum);
     }
 
@@ -2572,7 +2572,7 @@ 
          * @param array    $fields_n_values keys are the fields and values are their new values
          * @param EEM_Base $model           the model used
          */
-        $field_n_values = (array)apply_filters('FHEE__EEM_Base__insert__fields_n_values', $field_n_values, $this);
+        $field_n_values = (array) apply_filters('FHEE__EEM_Base__insert__fields_n_values', $field_n_values, $this);
         if ($this->_satisfies_unique_indexes($field_n_values)) {
             $main_table = $this->_get_main_table();
             $new_id = $this->_insert_into_specific_table($main_table, $field_n_values, false);
@@ -2680,7 +2680,7 @@ 
         }
         foreach ($this->unique_indexes() as $unique_index_name => $unique_index) {
             $uniqueness_where_params = array_intersect_key($fields_n_values, $unique_index->fields());
-            $query_params[0]['OR']['AND*' . $unique_index_name] = $uniqueness_where_params;
+            $query_params[0]['OR']['AND*'.$unique_index_name] = $uniqueness_where_params;
         }
         //if there is nothing to base this search on, then we shouldn't find anything
         if (empty($query_params)) {
@@ -2760,7 +2760,7 @@ 
             //its not the main table, so we should have already saved the main table's PK which we just inserted
             //so add the fk to the main table as a column
             $insertion_col_n_values[$table->get_fk_on_table()] = $new_id;
-            $format_for_insertion[] = '%d';//yes right now we're only allowing these foreign keys to be INTs
+            $format_for_insertion[] = '%d'; //yes right now we're only allowing these foreign keys to be INTs
         }
         //insert the new entry
         $result = $this->_do_wpdb_query('insert',
@@ -3020,7 +3020,7 @@ 
         $query_param_type
     ) {
         if ( ! empty($sub_query_params)) {
-            $sub_query_params = (array)$sub_query_params;
+            $sub_query_params = (array) $sub_query_params;
             foreach ($sub_query_params as $param => $possibly_array_of_params) {
                 //$param could be simply 'EVT_ID', or it could be 'Registrations.REG_ID', or even 'Registrations.Transactions.Payments.PAY_amount'
                 $this->_extract_related_model_info_from_query_param($param, $model_query_info_carrier,
@@ -3191,12 +3191,12 @@ 
                         ),
                         http_build_query($query_params['limit'])
                     );
-                    throw new EE_Error($e . "|" . $e);
+                    throw new EE_Error($e."|".$e);
                 }
                 //they passed us an array for the limit. Assume it's like array(50,25), meaning offset by 50, and get 25
-                $query_object->set_limit_sql(" LIMIT " . $query_params['limit'][0] . "," . $query_params['limit'][1]);
+                $query_object->set_limit_sql(" LIMIT ".$query_params['limit'][0].",".$query_params['limit'][1]);
             } elseif ( ! empty ($query_params['limit'])) {
-                $query_object->set_limit_sql(" LIMIT " . $query_params['limit']);
+                $query_object->set_limit_sql(" LIMIT ".$query_params['limit']);
             }
         }
         //set order by
@@ -3228,9 +3228,9 @@ 
                 $order_array = array();
                 foreach ($query_params['order_by'] as $field_name_to_order_by => $order) {
                     $order = $this->_extract_order($order);
-                    $order_array[] = $this->_deduce_column_name_from_query_param($field_name_to_order_by) . SP . $order;
+                    $order_array[] = $this->_deduce_column_name_from_query_param($field_name_to_order_by).SP.$order;
                 }
-                $query_object->set_order_by_sql(" ORDER BY " . implode(",", $order_array));
+                $query_object->set_order_by_sql(" ORDER BY ".implode(",", $order_array));
             } elseif ( ! empty ($query_params['order_by'])) {
                 $this->_extract_related_model_info_from_query_param(
                     $query_params['order_by'],
@@ -3242,7 +3242,7 @@ 
                     ? $this->_extract_order($query_params['order'])
                     : 'DESC';
                 $query_object->set_order_by_sql(
-                    " ORDER BY " . $this->_deduce_column_name_from_query_param($query_params['order_by']) . SP . $order
+                    " ORDER BY ".$this->_deduce_column_name_from_query_param($query_params['order_by']).SP.$order
                 );
             }
         }
@@ -3253,7 +3253,7 @@ 
         ) {
             $pk_field = $this->get_primary_key_field();
             $order = $this->_extract_order($query_params['order']);
-            $query_object->set_order_by_sql(" ORDER BY " . $pk_field->get_qualified_column() . SP . $order);
+            $query_object->set_order_by_sql(" ORDER BY ".$pk_field->get_qualified_column().SP.$order);
         }
         //set group by
         if (array_key_exists('group_by', $query_params)) {
@@ -3263,10 +3263,10 @@ 
                 foreach ($query_params['group_by'] as $field_name_to_group_by) {
                     $group_by_array[] = $this->_deduce_column_name_from_query_param($field_name_to_group_by);
                 }
-                $query_object->set_group_by_sql(" GROUP BY " . implode(", ", $group_by_array));
+                $query_object->set_group_by_sql(" GROUP BY ".implode(", ", $group_by_array));
             } elseif ( ! empty ($query_params['group_by'])) {
                 $query_object->set_group_by_sql(
-                    " GROUP BY " . $this->_deduce_column_name_from_query_param($query_params['group_by'])
+                    " GROUP BY ".$this->_deduce_column_name_from_query_param($query_params['group_by'])
                 );
             }
         }
@@ -3429,7 +3429,7 @@ 
     ) {
         $null_friendly_where_conditions = array();
         $none_overridden = true;
-        $or_condition_key_for_defaults = 'OR*' . get_class($model);
+        $or_condition_key_for_defaults = 'OR*'.get_class($model);
         foreach ($default_where_conditions as $key => $val) {
             if (isset($provided_where_conditions[$key])) {
                 $none_overridden = false;
@@ -3633,9 +3633,9 @@ 
         //and
         //check if it's a field on a related model
         foreach ($this->_model_relations as $valid_related_model_name => $relation_obj) {
-            if (strpos($query_param, $valid_related_model_name . ".") === 0) {
+            if (strpos($query_param, $valid_related_model_name.".") === 0) {
                 $this->_add_join_to_model($valid_related_model_name, $passed_in_query_info, $original_query_param);
-                $query_param = substr($query_param, strlen($valid_related_model_name . "."));
+                $query_param = substr($query_param, strlen($valid_related_model_name."."));
                 if ($query_param === '') {
                     //nothing left to $query_param
                     //we should actually end in a field name, not a model like this!
@@ -3721,7 +3721,7 @@ 
     {
         $SQL = $this->_construct_condition_clause_recursive($where_params, ' AND ');
         if ($SQL) {
-            return " WHERE " . $SQL;
+            return " WHERE ".$SQL;
         } else {
             return '';
         }
@@ -3741,7 +3741,7 @@ 
     {
         $SQL = $this->_construct_condition_clause_recursive($having_params, ' AND ');
         if ($SQL) {
-            return " HAVING " . $SQL;
+            return " HAVING ".$SQL;
         } else {
             return '';
         }
@@ -3761,11 +3761,11 @@ 
      */
     protected function _get_field_on_model($field_name, $model_name)
     {
-        $model_class = 'EEM_' . $model_name;
-        $model_filepath = $model_class . ".model.php";
+        $model_class = 'EEM_'.$model_name;
+        $model_filepath = $model_class.".model.php";
         if (is_readable($model_filepath)) {
             require_once($model_filepath);
-            $model_instance = call_user_func($model_name . "::instance");
+            $model_instance = call_user_func($model_name."::instance");
             /* @var $model_instance EEM_Base */
             return $model_instance->field_settings_for($field_name);
         } else {
@@ -3789,7 +3789,7 @@ 
     {
         $where_clauses = array();
         foreach ($where_params as $query_param => $op_and_value_or_sub_condition) {
-            $query_param = $this->_remove_stars_and_anything_after_from_condition_query_param_key($query_param);//str_replace("*",'',$query_param);
+            $query_param = $this->_remove_stars_and_anything_after_from_condition_query_param_key($query_param); //str_replace("*",'',$query_param);
             if (in_array($query_param, $this->_logic_query_param_keys)) {
                 switch ($query_param) {
                     case 'not':
@@ -3826,7 +3826,7 @@ 
                     }
                 }
                 $op_and_value_sql = $this->_construct_op_and_value($op_and_value_or_sub_condition, $field_obj);
-                $where_clauses[] = $this->_deduce_column_name_from_query_param($query_param) . SP . $op_and_value_sql;
+                $where_clauses[] = $this->_deduce_column_name_from_query_param($query_param).SP.$op_and_value_sql;
             }
         }
         return $where_clauses ? implode($glue, $where_clauses) : '';
@@ -3847,7 +3847,7 @@ 
         if ($field) {
             $table_alias_prefix = EE_Model_Parser::extract_table_alias_model_relation_chain_from_query_param($field->get_model_name(),
                 $query_param);
-            return $table_alias_prefix . $field->get_qualified_column();
+            return $table_alias_prefix.$field->get_qualified_column();
         } elseif (array_key_exists($query_param, $this->_custom_selections)) {
             //maybe it's custom selection item?
             //if so, just use it as the "column name"
@@ -3916,13 +3916,13 @@ 
         }
         //check to see if the value is actually another field
         if (is_array($op_and_value) && isset($op_and_value[2]) && $op_and_value[2] == true) {
-            return $operator . SP . $this->_deduce_column_name_from_query_param($value);
+            return $operator.SP.$this->_deduce_column_name_from_query_param($value);
         } elseif (in_array($operator, $this->_in_style_operators) && is_array($value)) {
             //in this case, the value should be an array, or at least a comma-separated list
             //it will need to handle a little differently
             $cleaned_value = $this->_construct_in_value($value, $field_obj);
             //note: $cleaned_value has already been run through $wpdb->prepare()
-            return $operator . SP . $cleaned_value;
+            return $operator.SP.$cleaned_value;
         } elseif (in_array($operator, $this->_between_style_operators) && is_array($value)) {
             //the value should be an array with count of two.
             if (count($value) !== 2) {
@@ -3937,7 +3937,7 @@ 
                 );
             }
             $cleaned_value = $this->_construct_between_value($value, $field_obj);
-            return $operator . SP . $cleaned_value;
+            return $operator.SP.$cleaned_value;
         } elseif (in_array($operator, $this->_null_style_operators)) {
             if ($value !== null) {
                 throw new EE_Error(
@@ -3955,9 +3955,9 @@ 
         } elseif ($operator === 'LIKE' && ! is_array($value)) {
             //if the operator is 'LIKE', we want to allow percent signs (%) and not
             //remove other junk. So just treat it as a string.
-            return $operator . SP . $this->_wpdb_prepare_using_field($value, '%s');
+            return $operator.SP.$this->_wpdb_prepare_using_field($value, '%s');
         } elseif ( ! in_array($operator, $this->_in_style_operators) && ! is_array($value)) {
-            return $operator . SP . $this->_wpdb_prepare_using_field($value, $field_obj);
+            return $operator.SP.$this->_wpdb_prepare_using_field($value, $field_obj);
         } elseif (in_array($operator, $this->_in_style_operators) && ! is_array($value)) {
             throw new EE_Error(
                 sprintf(
@@ -4010,7 +4010,7 @@ 
         foreach ($values as $value) {
             $cleaned_values[] = $this->_wpdb_prepare_using_field($value, $field_obj);
         }
-        return $cleaned_values[0] . " AND " . $cleaned_values[1];
+        return $cleaned_values[0]." AND ".$cleaned_values[1];
     }
 
 
@@ -4051,7 +4051,7 @@ 
                                 . $main_table->get_table_name()
                                 . " WHERE FALSE";
         }
-        return "(" . implode(",", $cleaned_values) . ")";
+        return "(".implode(",", $cleaned_values).")";
     }
 
 
@@ -4154,11 +4154,11 @@ 
             if ($table_obj instanceof EE_Primary_Table) {
                 $SQL .= $table_alias === $table_obj->get_table_alias()
                     ? $table_obj->get_select_join_limit($limit)
-                    : SP . $table_obj->get_table_name() . " AS " . $table_obj->get_table_alias() . SP;
+                    : SP.$table_obj->get_table_name()." AS ".$table_obj->get_table_alias().SP;
             } elseif ($table_obj instanceof EE_Secondary_Table) {
                 $SQL .= $table_alias === $table_obj->get_table_alias()
                     ? $table_obj->get_select_join_limit_join($limit)
-                    : SP . $table_obj->get_join_sql($table_alias) . SP;
+                    : SP.$table_obj->get_join_sql($table_alias).SP;
             }
         }
         return $SQL;
@@ -4246,12 +4246,12 @@ 
      */
     public function get_related_model_obj($model_name)
     {
-        $model_classname = "EEM_" . $model_name;
+        $model_classname = "EEM_".$model_name;
         if ( ! class_exists($model_classname)) {
             throw new EE_Error(sprintf(__("You specified a related model named %s in your query. No such model exists, if it did, it would have the classname %s",
                 'event_espresso'), $model_name, $model_classname));
         }
-        return call_user_func($model_classname . "::instance");
+        return call_user_func($model_classname."::instance");
     }
 
 
@@ -4550,7 +4550,7 @@ 
         $count_if_model_has_no_primary_key = 0;
         $has_primary_key = $this->has_primary_key_field();
         $primary_key_field = $has_primary_key ? $this->get_primary_key_field() : null;
-        foreach ((array)$rows as $row) {
+        foreach ((array) $rows as $row) {
             if (empty($row)) {
                 //wp did its weird thing where it returns an array like array(0=>null), which is totally not helpful...
                 return array();
@@ -4913,7 +4913,7 @@ 
      */
     private function _get_class_name()
     {
-        return "EE_" . $this->get_this_model_name();
+        return "EE_".$this->get_this_model_name();
     }
 
 
@@ -4928,7 +4928,7 @@ 
      */
     public function item_name($quantity = 1)
     {
-        return (int)$quantity === 1 ? $this->singular_item : $this->plural_item;
+        return (int) $quantity === 1 ? $this->singular_item : $this->plural_item;
     }
 
 
@@ -5464,7 +5464,7 @@ 
         $cap_restrictions = $this->cap_restrictions($context);
         foreach ($cap_restrictions as $cap => $restriction_if_no_cap) {
             if ( ! EE_Capabilities::instance()
-                                  ->current_user_can($cap, $this->get_this_model_name() . '_model_applying_caps')
+                                  ->current_user_can($cap, $this->get_this_model_name().'_model_applying_caps')
             ) {
                 $missing_caps[$cap] = $restriction_if_no_cap;
             }
@@ -5592,7 +5592,7 @@ 
         }
         return call_user_func_array(
             array($class_name, 'new_instance'),
-            array((array)$arguments, $this->_timezone, array(), true)
+            array((array) $arguments, $this->_timezone, array(), true)
         );
     }
 

core/helpers/EEH_Event_Query.helper.php

Spacing +118 added lines, -118 removed lines

@@ -1,5 +1,5 @@ 
-<?php if ( ! defined( 'EVENT_ESPRESSO_VERSION' ) ) {
-	exit( 'No direct script access allowed' );
+<?php if ( ! defined('EVENT_ESPRESSO_VERSION')) {
+	exit('No direct script access allowed');
 }
 /**
  * Event Espresso
@@ -85,7 +85,7 @@ 
 	 */
 	public static function add_query_filters() {
 		//add query filters
-		add_action( 'pre_get_posts', array( 'EEH_Event_Query', 'filter_query_parts' ), 10, 1 );
+		add_action('pre_get_posts', array('EEH_Event_Query', 'filter_query_parts'), 10, 1);
 	}
 
 
@@ -97,8 +97,8 @@ 
 	 * @param \WP_Query $WP_Query
 	 * @return bool
 	 */
-	public static function apply_query_filters( WP_Query $WP_Query ) {
-		return ( isset( $WP_Query->query, $WP_Query->query['post_type'] ) && $WP_Query->query['post_type'] == 'espresso_events' ) ||  apply_filters( 'FHEE__EEH_Event_Query__apply_query_filters', false ) ? true : false;
+	public static function apply_query_filters(WP_Query $WP_Query) {
+		return (isset($WP_Query->query, $WP_Query->query['post_type']) && $WP_Query->query['post_type'] == 'espresso_events') || apply_filters('FHEE__EEH_Event_Query__apply_query_filters', false) ? true : false;
 	}
 
 
@@ -108,15 +108,15 @@ 
 	 * @access    public
 	 * @param \WP_Query $WP_Query
 	 */
-	public static function filter_query_parts( WP_Query $WP_Query ) {
+	public static function filter_query_parts(WP_Query $WP_Query) {
 		//ONLY add our filters if this isn't the main wp_query, because if this is the main wp_query we already have our cpt strategies take care of adding things in.
-		if ( $WP_Query instanceof WP_Query && ! $WP_Query->is_main_query() ) {
+		if ($WP_Query instanceof WP_Query && ! $WP_Query->is_main_query()) {
 			// build event list query
-			add_filter( 'posts_fields', array( 'EEH_Event_Query', 'posts_fields' ), 10, 2 );
-			add_filter( 'posts_join', array( 'EEH_Event_Query', 'posts_join' ), 10, 2 );
-			add_filter( 'posts_where', array( 'EEH_Event_Query', 'posts_where' ), 10, 2 );
-			add_filter( 'posts_orderby', array( 'EEH_Event_Query', 'posts_orderby' ), 10, 2 );
-			add_filter( 'posts_clauses_request', array( 'EEH_Event_Query', 'posts_clauses' ), 10, 2 );
+			add_filter('posts_fields', array('EEH_Event_Query', 'posts_fields'), 10, 2);
+			add_filter('posts_join', array('EEH_Event_Query', 'posts_join'), 10, 2);
+			add_filter('posts_where', array('EEH_Event_Query', 'posts_where'), 10, 2);
+			add_filter('posts_orderby', array('EEH_Event_Query', 'posts_orderby'), 10, 2);
+			add_filter('posts_clauses_request', array('EEH_Event_Query', 'posts_clauses'), 10, 2);
 		}
 	}
 
@@ -131,13 +131,13 @@ 
 	 * @param string $orderby
 	 * @param string $sort
 	 */
-	public static function set_query_params( $month = '', $category = '', $show_expired = FALSE, $orderby = 'start_date', $sort = 'ASC' ) {
+	public static function set_query_params($month = '', $category = '', $show_expired = FALSE, $orderby = 'start_date', $sort = 'ASC') {
 		self::$_query_params = array();
-		EEH_Event_Query::$_event_query_month = EEH_Event_Query::_display_month( $month );
-		EEH_Event_Query::$_event_query_category = EEH_Event_Query::_event_category_slug( $category );
-		EEH_Event_Query::$_event_query_show_expired = EEH_Event_Query::_show_expired( $show_expired );
-		EEH_Event_Query::$_event_query_orderby = EEH_Event_Query::_orderby( $orderby );
-		EEH_Event_Query::$_event_query_sort = EEH_Event_Query::_sort( $sort );
+		EEH_Event_Query::$_event_query_month = EEH_Event_Query::_display_month($month);
+		EEH_Event_Query::$_event_query_category = EEH_Event_Query::_event_category_slug($category);
+		EEH_Event_Query::$_event_query_show_expired = EEH_Event_Query::_show_expired($show_expired);
+		EEH_Event_Query::$_event_query_orderby = EEH_Event_Query::_orderby($orderby);
+		EEH_Event_Query::$_event_query_sort = EEH_Event_Query::_sort($sort);
 	}
 
 
@@ -149,8 +149,8 @@ 
 	 * @param string $month
 	 * @return    string
 	 */
-	private static function _display_month( $month = '' ) {
-		return EE_Registry::instance()->REQ->is_set( 'event_query_month' ) ? sanitize_text_field( EE_Registry::instance()->REQ->get( 'event_query_month' ) ) : $month;
+	private static function _display_month($month = '') {
+		return EE_Registry::instance()->REQ->is_set('event_query_month') ? sanitize_text_field(EE_Registry::instance()->REQ->get('event_query_month')) : $month;
 	}
 
 
@@ -162,8 +162,8 @@ 
 	 * @param string $category
 	 * @return    string
 	 */
-	private static function _event_category_slug( $category = '' ) {
-		return EE_Registry::instance()->REQ->is_set( 'event_query_category' ) ? sanitize_text_field( EE_Registry::instance()->REQ->get( 'event_query_category' ) ) : $category;
+	private static function _event_category_slug($category = '') {
+		return EE_Registry::instance()->REQ->is_set('event_query_category') ? sanitize_text_field(EE_Registry::instance()->REQ->get('event_query_category')) : $category;
 	}
 
 
@@ -175,10 +175,10 @@ 
 	 * @param bool $show_expired
 	 * @return    boolean
 	 */
-	private static function _show_expired( $show_expired = FALSE ) {
+	private static function _show_expired($show_expired = FALSE) {
 		// override default expired option if set via filter
-		$_event_query_show_expired =EE_Registry::instance()->REQ->is_set( 'event_query_show_expired' ) ? EE_Registry::instance()->REQ->get( 'event_query_show_expired' ) : $show_expired;
-		return filter_var( $_event_query_show_expired, FILTER_VALIDATE_BOOLEAN );
+		$_event_query_show_expired = EE_Registry::instance()->REQ->is_set('event_query_show_expired') ? EE_Registry::instance()->REQ->get('event_query_show_expired') : $show_expired;
+		return filter_var($_event_query_show_expired, FILTER_VALIDATE_BOOLEAN);
 	}
 
 
@@ -190,10 +190,10 @@ 
 	 * @param    string $orderby
 	 * @return    array
 	 */
-	private static function _orderby( $orderby = 'start_date' ) {
-		$event_query_orderby = EE_Registry::instance()->REQ->is_set( 'event_query_orderby' ) ? sanitize_text_field( EE_Registry::instance()->REQ->get( 'event_query_orderby' ) ) : $orderby;
-		$event_query_orderby = is_array( $event_query_orderby ) ? $event_query_orderby : explode( ',', $event_query_orderby );
-		$event_query_orderby = array_map( 'trim', $event_query_orderby );
+	private static function _orderby($orderby = 'start_date') {
+		$event_query_orderby = EE_Registry::instance()->REQ->is_set('event_query_orderby') ? sanitize_text_field(EE_Registry::instance()->REQ->get('event_query_orderby')) : $orderby;
+		$event_query_orderby = is_array($event_query_orderby) ? $event_query_orderby : explode(',', $event_query_orderby);
+		$event_query_orderby = array_map('trim', $event_query_orderby);
 		return $event_query_orderby;
 	}
 
@@ -206,9 +206,9 @@ 
 	 * @param string $sort
 	 * @return    array
 	 */
-	private static function _sort( $sort = 'ASC' ) {
-		$sort = EE_Registry::instance()->REQ->is_set( 'event_query_sort' ) ? sanitize_text_field( EE_Registry::instance()->REQ->get( 'event_query_sort' ) ) : $sort;
-		return in_array( $sort, array( 'ASC', 'asc', 'DESC', 'desc' )) ? strtoupper( $sort ) : 'ASC';
+	private static function _sort($sort = 'ASC') {
+		$sort = EE_Registry::instance()->REQ->is_set('event_query_sort') ? sanitize_text_field(EE_Registry::instance()->REQ->get('event_query_sort')) : $sort;
+		return in_array($sort, array('ASC', 'asc', 'DESC', 'desc')) ? strtoupper($sort) : 'ASC';
 	}
 
 
@@ -221,10 +221,10 @@ 
 	 *
 	 * @return array   array of clauses
 	 */
-	public static function posts_clauses( $clauses, WP_Query $wp_query ) {
-		if ( EEH_Event_Query::apply_query_filters( $wp_query ) ) {
+	public static function posts_clauses($clauses, WP_Query $wp_query) {
+		if (EEH_Event_Query::apply_query_filters($wp_query)) {
 			global $wpdb;
-			$clauses['groupby'] = $wpdb->posts . '.ID ';
+			$clauses['groupby'] = $wpdb->posts.'.ID ';
 		}
 		return $clauses;
 	}
@@ -239,10 +239,10 @@ 
 	 * @param WP_Query $wp_query
 	 * @return    string
 	 */
-	public static function posts_fields( $SQL, WP_Query $wp_query ) {
-		if ( EEH_Event_Query::apply_query_filters( $wp_query ) ) {
+	public static function posts_fields($SQL, WP_Query $wp_query) {
+		if (EEH_Event_Query::apply_query_filters($wp_query)) {
 			// adds something like ", wp_esp_datetime.* " to WP Query SELECT statement
-			$SQL .= EEH_Event_Query::posts_fields_sql_for_orderby( EEH_Event_Query::$_event_query_orderby );
+			$SQL .= EEH_Event_Query::posts_fields_sql_for_orderby(EEH_Event_Query::$_event_query_orderby);
 		}
 		return $SQL;
 	}
@@ -257,29 +257,29 @@ 
 	 * @internal  param bool|string $mixed $join_terms pass TRUE or term string, doesn't really matter since this value doesn't really get used for anything yet
 	 * @return    string
 	 */
-	public static function posts_fields_sql_for_orderby( $orderby_params = array() ) {
-		$SQL = ', MIN( ' . EEM_Datetime::instance()->table() . '.DTT_EVT_start ) as event_start_date ' ;
-		foreach( (array)$orderby_params as $orderby ) {
-			switch ( $orderby ) {
+	public static function posts_fields_sql_for_orderby($orderby_params = array()) {
+		$SQL = ', MIN( '.EEM_Datetime::instance()->table().'.DTT_EVT_start ) as event_start_date ';
+		foreach ((array) $orderby_params as $orderby) {
+			switch ($orderby) {
 
 				case 'ticket_start' :
-					$SQL .= ', ' . EEM_Ticket::instance()->table() . '.TKT_start_date' ;
+					$SQL .= ', '.EEM_Ticket::instance()->table().'.TKT_start_date';
 					break;
 
 				case 'ticket_end' :
-					$SQL .= ', ' . EEM_Ticket::instance()->table() . '.TKT_end_date' ;
+					$SQL .= ', '.EEM_Ticket::instance()->table().'.TKT_end_date';
 					break;
 
 				case 'venue_title' :
-					$SQL .= ', Venue.post_title AS venue_title' ;
+					$SQL .= ', Venue.post_title AS venue_title';
 					break;
 
 				case 'city' :
-					$SQL .= ', ' . EEM_Venue::instance()->second_table() . '.VNU_city' ;
+					$SQL .= ', '.EEM_Venue::instance()->second_table().'.VNU_city';
 					break;
 
 				case 'state' :
-					$SQL .= ', ' . EEM_State::instance()->table() . '.STA_name' ;
+					$SQL .= ', '.EEM_State::instance()->table().'.STA_name';
 					break;
 
 			}
@@ -297,12 +297,12 @@ 
 	 * @param WP_Query $wp_query
 	 * @return    string
 	 */
-	public static function posts_join( $SQL = '', WP_Query $wp_query ) {
-		if ( EEH_Event_Query::apply_query_filters( $wp_query ) ) {
+	public static function posts_join($SQL = '', WP_Query $wp_query) {
+		if (EEH_Event_Query::apply_query_filters($wp_query)) {
 			// Category
-			$SQL = EEH_Event_Query::posts_join_sql_for_show_expired( $SQL, EEH_Event_Query::$_event_query_show_expired );
-			$SQL = EEH_Event_Query::posts_join_sql_for_terms( $SQL, EEH_Event_Query::$_event_query_category );
-			$SQL = EEH_Event_Query::posts_join_for_orderby( $SQL, EEH_Event_Query::$_event_query_orderby );
+			$SQL = EEH_Event_Query::posts_join_sql_for_show_expired($SQL, EEH_Event_Query::$_event_query_show_expired);
+			$SQL = EEH_Event_Query::posts_join_sql_for_terms($SQL, EEH_Event_Query::$_event_query_category);
+			$SQL = EEH_Event_Query::posts_join_for_orderby($SQL, EEH_Event_Query::$_event_query_orderby);
 		}
 		return $SQL;
 	}
@@ -317,11 +317,11 @@ 
 	 * @param    boolean $show_expired if TRUE, then displayed past events
 	 * @return string
 	 */
-	public static function posts_join_sql_for_show_expired( $SQL = '', $show_expired = FALSE ) {
-		if ( ! $show_expired ) {
-			$join = EEM_Event::instance()->table() . '.ID = ' . EEM_Datetime::instance()->table() . '.' . EEM_Event::instance()->primary_key_name();
-			if ( strpos( $SQL, $join ) === FALSE ) {
-				$SQL .= ' INNER JOIN ' . EEM_Datetime::instance()->table() . ' ON ( ' . $join . ' ) ';
+	public static function posts_join_sql_for_show_expired($SQL = '', $show_expired = FALSE) {
+		if ( ! $show_expired) {
+			$join = EEM_Event::instance()->table().'.ID = '.EEM_Datetime::instance()->table().'.'.EEM_Event::instance()->primary_key_name();
+			if (strpos($SQL, $join) === FALSE) {
+				$SQL .= ' INNER JOIN '.EEM_Datetime::instance()->table().' ON ( '.$join.' ) ';
 			}
 		}
 		return $SQL;
@@ -337,8 +337,8 @@ 
 	 * @param 	string $join_terms pass TRUE or term string, doesn't really matter since this value doesn't really get used for anything yet
 	 * @return 	string
 	 */
-	public static function posts_join_sql_for_terms( $SQL = '', $join_terms = '' ) {
-		if ( ! empty( $join_terms ) ) {
+	public static function posts_join_sql_for_terms($SQL = '', $join_terms = '') {
+		if ( ! empty($join_terms)) {
 			global $wpdb;
 			$SQL .= " LEFT JOIN $wpdb->term_relationships ON ($wpdb->posts.ID = $wpdb->term_relationships.object_id)";
 			$SQL .= " LEFT JOIN $wpdb->term_taxonomy ON ($wpdb->term_relationships.term_taxonomy_id = $wpdb->term_taxonomy.term_taxonomy_id)";
@@ -358,25 +358,25 @@ 
 	 * @param 	array $orderby_params
 	 * @return 	string
 	 */
-	public static function posts_join_for_orderby( $SQL = '', $orderby_params = array() ) {
-		foreach ( (array)$orderby_params as $orderby ) {
-			switch ( $orderby ) {
+	public static function posts_join_for_orderby($SQL = '', $orderby_params = array()) {
+		foreach ((array) $orderby_params as $orderby) {
+			switch ($orderby) {
 				case 'ticket_start' :
 				case 'ticket_end' :
-					$SQL .= EEH_Event_Query::_posts_join_for_datetime( $SQL, EEM_Datetime_Ticket::instance()->table() . '.' . EEM_Datetime::instance()->primary_key_name() );
-					$SQL .= ' LEFT JOIN ' . EEM_Ticket::instance()->table() . ' ON (' . EEM_Datetime_Ticket::instance()->table() . '.' . EEM_Ticket::instance()->primary_key_name() . ' = ' . EEM_Ticket::instance()->table() . '.' . EEM_Ticket::instance()->primary_key_name() . ' )';
+					$SQL .= EEH_Event_Query::_posts_join_for_datetime($SQL, EEM_Datetime_Ticket::instance()->table().'.'.EEM_Datetime::instance()->primary_key_name());
+					$SQL .= ' LEFT JOIN '.EEM_Ticket::instance()->table().' ON ('.EEM_Datetime_Ticket::instance()->table().'.'.EEM_Ticket::instance()->primary_key_name().' = '.EEM_Ticket::instance()->table().'.'.EEM_Ticket::instance()->primary_key_name().' )';
 					break;
 				case 'venue_title' :
 				case 'city' :
-					$SQL .= EEH_Event_Query::_posts_join_for_event_venue( $SQL );
+					$SQL .= EEH_Event_Query::_posts_join_for_event_venue($SQL);
 					break;
 				case 'state' :
-					$SQL .= EEH_Event_Query::_posts_join_for_event_venue( $SQL );
-					$SQL .= EEH_Event_Query::_posts_join_for_venue_state( $SQL );
+					$SQL .= EEH_Event_Query::_posts_join_for_event_venue($SQL);
+					$SQL .= EEH_Event_Query::_posts_join_for_venue_state($SQL);
 					break;
 				case 'start_date' :
 				default :
-					$SQL .= EEH_Event_Query::_posts_join_for_datetime( $SQL, EEM_Event::instance()->table() . '.ID' );
+					$SQL .= EEH_Event_Query::_posts_join_for_datetime($SQL, EEM_Event::instance()->table().'.ID');
 					break;
 
 			}
@@ -394,11 +394,11 @@ 
 	 * @param string $join
 	 * @return string
 	 */
-	protected static function _posts_join_for_datetime( $SQL = '', $join = '' ) {
-		if ( ! empty( $join )) {
-			$join .= ' = ' . EEM_Datetime::instance()->table() . '.' . EEM_Event::instance()->primary_key_name();
-			if ( strpos( $SQL, $join ) === FALSE ) {
-				return ' INNER JOIN ' . EEM_Datetime::instance()->table() . ' ON ( ' . $join . ' )';
+	protected static function _posts_join_for_datetime($SQL = '', $join = '') {
+		if ( ! empty($join)) {
+			$join .= ' = '.EEM_Datetime::instance()->table().'.'.EEM_Event::instance()->primary_key_name();
+			if (strpos($SQL, $join) === FALSE) {
+				return ' INNER JOIN '.EEM_Datetime::instance()->table().' ON ( '.$join.' )';
 			}
 		}
 		return '';
@@ -413,13 +413,13 @@ 
 	 * @param string $SQL
 	 * @return string
 	 */
-	protected static function _posts_join_for_event_venue( $SQL = '' ) {
+	protected static function _posts_join_for_event_venue($SQL = '') {
 		// Event Venue table name
 		$event_venue_table = EEM_Event_Venue::instance()->table();
 		// generate conditions for:  Event <=> Event Venue  JOIN clause
-		$event_to_event_venue_join = EEM_Event::instance()->table() . '.ID = ' . $event_venue_table . '.' . EEM_Event::instance()->primary_key_name();
+		$event_to_event_venue_join = EEM_Event::instance()->table().'.ID = '.$event_venue_table.'.'.EEM_Event::instance()->primary_key_name();
 		// don't add joins if they have already been added
-		if ( strpos( $SQL, $event_to_event_venue_join ) === FALSE ) {
+		if (strpos($SQL, $event_to_event_venue_join) === FALSE) {
 			// Venue table name
 			$venue_table = EEM_Venue::instance()->table();
 			// Venue table pk
@@ -432,10 +432,10 @@ 
 			$venue_SQL .= " LEFT JOIN $venue_table as Venue ON ( $event_venue_table.$venue_table_pk = Venue.ID )";
 			// generate JOIN clause for: Venue <=> Venue Meta
 			$venue_SQL .= " LEFT JOIN $venue_meta_table ON ( Venue.ID = $venue_meta_table.$venue_table_pk )";
-			unset( $event_venue_table, $event_to_event_venue_join, $venue_table, $venue_table_pk, $venue_meta_table );
+			unset($event_venue_table, $event_to_event_venue_join, $venue_table, $venue_table_pk, $venue_meta_table);
 			return $venue_SQL;
 		}
-		unset( $event_venue_table, $event_to_event_venue_join );
+		unset($event_venue_table, $event_to_event_venue_join);
 		return '';
 	}
 
@@ -448,7 +448,7 @@ 
 	 * @param string $SQL
 	 * @return string
 	 */
-	protected static function _posts_join_for_venue_state( $SQL = '' ) {
+	protected static function _posts_join_for_venue_state($SQL = '') {
 		// Venue Meta table name
 		$venue_meta_table = EEM_Venue::instance()->second_table();
 		// State table name
@@ -456,16 +456,16 @@ 
 		// State table pk
 		$state_table_pk = EEM_State::instance()->primary_key_name();
 		// verify vars
-		if ( $venue_meta_table && $state_table && $state_table_pk ) {
+		if ($venue_meta_table && $state_table && $state_table_pk) {
 			// like: wp_esp_venue_meta.STA_ID = wp_esp_state.STA_ID
 			$join = "$venue_meta_table.$state_table_pk = $state_table.$state_table_pk";
 			// don't add join if it has already been added
-			if ( strpos( $SQL, $join ) === FALSE ) {
-				unset( $state_table_pk, $venue_meta_table, $venue_table_pk );
+			if (strpos($SQL, $join) === FALSE) {
+				unset($state_table_pk, $venue_meta_table, $venue_table_pk);
 				return " LEFT JOIN $state_table ON ( $join )";
 			}
 		}
-		unset( $join, $state_table, $state_table_pk, $venue_meta_table, $venue_table_pk );
+		unset($join, $state_table, $state_table_pk, $venue_meta_table, $venue_table_pk);
 		return '';
 	}
 
@@ -479,14 +479,14 @@ 
 	 * @param WP_Query $wp_query
 	 * @return    string
 	 */
-	public static function posts_where( $SQL = '', WP_Query $wp_query ) {
-		if ( EEH_Event_Query::apply_query_filters( $wp_query ) ) {
+	public static function posts_where($SQL = '', WP_Query $wp_query) {
+		if (EEH_Event_Query::apply_query_filters($wp_query)) {
 			// Show Expired ?
-			$SQL .= EEH_Event_Query::posts_where_sql_for_show_expired( EEH_Event_Query::$_event_query_show_expired  );
+			$SQL .= EEH_Event_Query::posts_where_sql_for_show_expired(EEH_Event_Query::$_event_query_show_expired);
 			// Category
-			$SQL .= EEH_Event_Query::posts_where_sql_for_event_category_slug( EEH_Event_Query::$_event_query_category  );
+			$SQL .= EEH_Event_Query::posts_where_sql_for_event_category_slug(EEH_Event_Query::$_event_query_category);
 			// Start Date
-			$SQL .= EEH_Event_Query::posts_where_sql_for_event_list_month( EEH_Event_Query::$_event_query_month );
+			$SQL .= EEH_Event_Query::posts_where_sql_for_event_list_month(EEH_Event_Query::$_event_query_month);
 		}
 		return $SQL;
 	}
@@ -500,8 +500,8 @@ 
 	 * @param    boolean $show_expired if TRUE, then displayed past events
 	 * @return    string
 	 */
-	public static function posts_where_sql_for_show_expired( $show_expired = FALSE ) {
-		return ! $show_expired ? ' AND ' . EEM_Datetime::instance()->table() . '.DTT_EVT_end > \'' . current_time( 'mysql', TRUE ) . '\' ' : '';
+	public static function posts_where_sql_for_show_expired($show_expired = FALSE) {
+		return ! $show_expired ? ' AND '.EEM_Datetime::instance()->table().'.DTT_EVT_end > \''.current_time('mysql', TRUE).'\' ' : '';
 	}
 
 
@@ -513,9 +513,9 @@ 
 	 * @param    boolean $event_category_slug
 	 * @return    string
 	 */
-	public static function posts_where_sql_for_event_category_slug( $event_category_slug = NULL ) {
+	public static function posts_where_sql_for_event_category_slug($event_category_slug = NULL) {
 		global $wpdb;
-		return ! empty( $event_category_slug ) ? " AND {$wpdb->terms}.slug = '{$event_category_slug}' " : '';
+		return ! empty($event_category_slug) ? " AND {$wpdb->terms}.slug = '{$event_category_slug}' " : '';
 	}
 
 
@@ -527,14 +527,14 @@ 
 	 * @param    boolean $month
 	 * @return    string
 	 */
-	public static function posts_where_sql_for_event_list_month( $month = NULL ) {
+	public static function posts_where_sql_for_event_list_month($month = NULL) {
 		$SQL = '';
-		if ( ! empty( $month ) ) {
+		if ( ! empty($month)) {
 			$datetime_table = EEM_Datetime::instance()->table();
 			// event start date is LESS than the end of the month ( so nothing that doesn't start until next month )
-			$SQL = " AND {$datetime_table}.DTT_EVT_start <= '" . date( 'Y-m-t 23:59:59', strtotime( $month ) ) . "'";
+			$SQL = " AND {$datetime_table}.DTT_EVT_start <= '".date('Y-m-t 23:59:59', strtotime($month))."'";
 			// event end date is GREATER than the start of the month ( so nothing that ended before this month )
-			$SQL .= " AND {$datetime_table}.DTT_EVT_end >= '" . date( 'Y-m-01 0:0:00', strtotime( $month ) ) . "' ";
+			$SQL .= " AND {$datetime_table}.DTT_EVT_end >= '".date('Y-m-01 0:0:00', strtotime($month))."' ";
 		}
 		return $SQL;
 	}
@@ -549,9 +549,9 @@ 
 	 * @param WP_Query $wp_query
 	 * @return    string
 	 */
-	public static function posts_orderby( $SQL = '', WP_Query $wp_query ) {
-		if ( EEH_Event_Query::apply_query_filters( $wp_query ) ) {
-			$SQL = EEH_Event_Query::posts_orderby_sql( EEH_Event_Query::$_event_query_orderby, EEH_Event_Query::$_event_query_sort );
+	public static function posts_orderby($SQL = '', WP_Query $wp_query) {
+		if (EEH_Event_Query::apply_query_filters($wp_query)) {
+			$SQL = EEH_Event_Query::posts_orderby_sql(EEH_Event_Query::$_event_query_orderby, EEH_Event_Query::$_event_query_sort);
 		}
 		return $SQL;
 	}
@@ -582,63 +582,63 @@ 
 	 * @param string     $sort
 	 * @return string
 	 */
-	public static function posts_orderby_sql( $orderby_params = array(), $sort = 'ASC' ) {
+	public static function posts_orderby_sql($orderby_params = array(), $sort = 'ASC') {
 		global $wpdb;
 		$SQL = '';
 		$counter = 0;
 		//make sure 'orderby' is set in query params
-		if ( ! isset( self::$_query_params['orderby'] )) {
+		if ( ! isset(self::$_query_params['orderby'])) {
 			self::$_query_params['orderby'] = array();
 		}
 		// loop thru $orderby_params (type cast as array)
-		foreach ( (array)$orderby_params as $orderby ) {
+		foreach ((array) $orderby_params as $orderby) {
 			// check if we have already added this param
-			if ( isset( self::$_query_params['orderby'][ $orderby ] )) {
+			if (isset(self::$_query_params['orderby'][$orderby])) {
 				// if so then remove from the $orderby_params so that the count() method below is accurate
-				unset( $orderby_params[ $orderby ] );
+				unset($orderby_params[$orderby]);
 				// then bump ahead to the next param
 				continue;
 			}
 			// this will ad a comma depending on whether this is the first or last param
-			$glue = $counter == 0 || $counter == count( $orderby_params ) ? ' ' : ', ';
+			$glue = $counter == 0 || $counter == count($orderby_params) ? ' ' : ', ';
 			// ok what's we dealing with?
-			switch ( $orderby ) {
+			switch ($orderby) {
 				case 'id' :
 				case 'ID' :
-					$SQL .= $glue . $wpdb->posts . '.ID ' . $sort;
+					$SQL .= $glue.$wpdb->posts.'.ID '.$sort;
 					break;
 				case 'end_date' :
-					$SQL .= $glue . EEM_Datetime::instance()->table() . '.DTT_EVT_end ' . $sort;
+					$SQL .= $glue.EEM_Datetime::instance()->table().'.DTT_EVT_end '.$sort;
 					break;
 				case 'event_name' :
-					$SQL .= $glue . $wpdb->posts . '.post_title ' . $sort;
+					$SQL .= $glue.$wpdb->posts.'.post_title '.$sort;
 					break;
 				case 'category_slug' :
-					$SQL .= $glue . $wpdb->terms . '.slug ' . $sort;
+					$SQL .= $glue.$wpdb->terms.'.slug '.$sort;
 					break;
 				case 'ticket_start' :
-					$SQL .= $glue . EEM_Ticket::instance()->table() . '.TKT_start_date ' . $sort;
+					$SQL .= $glue.EEM_Ticket::instance()->table().'.TKT_start_date '.$sort;
 					break;
 				case 'ticket_end' :
-					$SQL .= $glue . EEM_Ticket::instance()->table() . '.TKT_end_date ' . $sort;
+					$SQL .= $glue.EEM_Ticket::instance()->table().'.TKT_end_date '.$sort;
 					break;
 				case 'venue_title' :
-					$SQL .= $glue . 'venue_title ' . $sort;
+					$SQL .= $glue.'venue_title '.$sort;
 					break;
 				case 'city' :
-					$SQL .= $glue . EEM_Venue::instance()->second_table() . '.VNU_city ' . $sort;
+					$SQL .= $glue.EEM_Venue::instance()->second_table().'.VNU_city '.$sort;
 					break;
 				case 'state' :
-					$SQL .= $glue . EEM_State::instance()->table() . '.STA_name ' . $sort;
+					$SQL .= $glue.EEM_State::instance()->table().'.STA_name '.$sort;
 					break;
 				case 'start_date' :
 				default :
-					$SQL .= $glue . ' event_start_date ' . $sort;
+					$SQL .= $glue.' event_start_date '.$sort;
 					break;
 			}
 			// add to array of orderby params that have been added
-			self::$_query_params['orderby'][ $orderby ] = TRUE;
-			$counter ++;
+			self::$_query_params['orderby'][$orderby] = TRUE;
+			$counter++;
 		}
 		return $SQL;
 	}

core/EE_System.core.php

Spacing +10 added lines, -10 removed lines

@@ -175,7 +175,7 @@ 
     {
         // set autoloaders for all of the classes implementing EEI_Plugin_API
         // which provide helpers for EE plugin authors to more easily register certain components with EE.
-        EEH_Autoloader::instance()->register_autoloaders_for_each_file_in_folder(EE_LIBRARIES . 'plugin_api');
+        EEH_Autoloader::instance()->register_autoloaders_for_each_file_in_folder(EE_LIBRARIES.'plugin_api');
         //load and setup EE_Capabilities
         $this->registry->load_core('Capabilities');
         //caps need to be initialized on every request so that capability maps are set.
@@ -198,7 +198,7 @@ 
                 && $_GET['activate'] === 'true'
             )
         ) {
-            include_once EE_THIRD_PARTY . 'wp-api-basic-auth' . DS . 'basic-auth.php';
+            include_once EE_THIRD_PARTY.'wp-api-basic-auth'.DS.'basic-auth.php';
         }
     }
 
@@ -621,7 +621,7 @@ 
     private function _parse_model_names()
     {
         //get all the files in the EE_MODELS folder that end in .model.php
-        $models = glob(EE_MODELS . '*.model.php');
+        $models = glob(EE_MODELS.'*.model.php');
         $model_names = array();
         $non_abstract_db_models = array();
         foreach ($models as $model) {
@@ -649,8 +649,8 @@ 
      */
     private function _maybe_brew_regular()
     {
-        if (( ! defined('EE_DECAF') || EE_DECAF !== true) && is_readable(EE_CAFF_PATH . 'brewing_regular.php')) {
-            require_once EE_CAFF_PATH . 'brewing_regular.php';
+        if (( ! defined('EE_DECAF') || EE_DECAF !== true) && is_readable(EE_CAFF_PATH.'brewing_regular.php')) {
+            require_once EE_CAFF_PATH.'brewing_regular.php';
         }
     }
 
@@ -691,8 +691,8 @@ 
                 'event_espresso');
             $msg .= '<ul>';
             foreach ($class_names as $class_name) {
-                $msg .= '<li><b>Event Espresso - ' . str_replace(array('EE_', 'EEM_', 'EED_', 'EES_', 'EEW_'), '',
-                        $class_name) . '</b></li>';
+                $msg .= '<li><b>Event Espresso - '.str_replace(array('EE_', 'EEM_', 'EED_', 'EES_', 'EEW_'), '',
+                        $class_name).'</b></li>';
             }
             $msg .= '</ul>';
             $msg .= __('Compatibility issues can be avoided and/or resolved by keeping addons and plugins updated to the latest version.',
@@ -987,7 +987,7 @@ 
             'href'  => $events_admin_url,
             'meta'  => array(
                 'title' => __('Event Espresso', 'event_espresso'),
-                'class' => $menu_class . 'first',
+                'class' => $menu_class.'first',
             ),
         ));
         //Events
@@ -1364,10 +1364,10 @@ 
             // jquery_validate loading is turned OFF by default, but prior to the wp_enqueue_scripts hook, can be turned back on again via:  add_filter( 'FHEE_load_jquery_validate', '__return_true' );
             if (apply_filters('FHEE_load_jquery_validate', false)) {
                 // register jQuery Validate and additional methods
-                wp_register_script('jquery-validate', EE_GLOBAL_ASSETS_URL . 'scripts/jquery.validate.min.js',
+                wp_register_script('jquery-validate', EE_GLOBAL_ASSETS_URL.'scripts/jquery.validate.min.js',
                     array('jquery'), '1.15.0', true);
                 wp_register_script('jquery-validate-extra-methods',
-                    EE_GLOBAL_ASSETS_URL . 'scripts/jquery.validate.additional-methods.min.js',
+                    EE_GLOBAL_ASSETS_URL.'scripts/jquery.validate.additional-methods.min.js',
                     array('jquery', 'jquery-validate'), '1.15.0', true);
             }
         }

Indentation +1423 added lines, -1423 removed lines

@@ -1,5 +1,5 @@ 
 <?php if ( ! defined('EVENT_ESPRESSO_VERSION')) {
-    exit('No direct script access allowed');
+	exit('No direct script access allowed');
 }
 
 
@@ -16,1428 +16,1428 @@ 
 {
 
 
-    /**
-     * indicates this is a 'normal' request. Ie, not activation, nor upgrade, nor activation.
-     * So examples of this would be a normal GET request on the frontend or backend, or a POST, etc
-     */
-    const req_type_normal = 0;
-
-    /**
-     * Indicates this is a brand new installation of EE so we should install
-     * tables and default data etc
-     */
-    const req_type_new_activation = 1;
-
-    /**
-     * we've detected that EE has been reactivated (or EE was activated during maintenance mode,
-     * and we just exited maintenance mode). We MUST check the database is setup properly
-     * and that default data is setup too
-     */
-    const req_type_reactivation = 2;
-
-    /**
-     * indicates that EE has been upgraded since its previous request.
-     * We may have data migration scripts to call and will want to trigger maintenance mode
-     */
-    const req_type_upgrade = 3;
-
-    /**
-     * TODO  will detect that EE has been DOWNGRADED. We probably don't want to run in this case...
-     */
-    const req_type_downgrade = 4;
-
-    /**
-     * @deprecated since version 4.6.0.dev.006
-     * Now whenever a new_activation is detected the request type is still just
-     * new_activation (same for reactivation, upgrade, downgrade etc), but if we'r ein maintenance mode
-     * EE_System::initialize_db_if_no_migrations_required and EE_Addon::initialize_db_if_no_migrations_required
-     * will instead enqueue that EE plugin's db initialization for when we're taken out of maintenance mode.
-     * (Specifically, when the migration manager indicates migrations are finished
-     * EE_Data_Migration_Manager::initialize_db_for_enqueued_ee_plugins() will be called)
-     */
-    const req_type_activation_but_not_installed = 5;
-
-    /**
-     * option prefix for recording the activation history (like core's "espresso_db_update") of addons
-     */
-    const addon_activation_history_option_prefix = 'ee_addon_activation_history_';
-
-
-    /**
-     *    instance of the EE_System object
-     *
-     * @var    $_instance
-     * @access    private
-     */
-    private static $_instance = null;
-
-    /**
-     * @type  EE_Registry $Registry
-     * @access    protected
-     */
-    protected $registry;
-
-    /**
-     * Stores which type of request this is, options being one of the constants on EE_System starting with req_type_*.
-     * It can be a brand-new activation, a reactivation, an upgrade, a downgrade, or a normal request.
-     *
-     * @var int
-     */
-    private $_req_type;
-
-    /**
-     * Whether or not there was a non-micro version change in EE core version during this request
-     *
-     * @var boolean
-     */
-    private $_major_version_change = false;
-
-
-
-    /**
-     * @singleton method used to instantiate class object
-     * @access    public
-     * @param  \EE_Registry $Registry
-     * @return \EE_System
-     */
-    public static function instance(EE_Registry $Registry = null)
-    {
-        // check if class object is instantiated
-        if ( ! self::$_instance instanceof EE_System) {
-            self::$_instance = new self($Registry);
-        }
-        return self::$_instance;
-    }
-
-
-
-    /**
-     * resets the instance and returns it
-     *
-     * @return EE_System
-     */
-    public static function reset()
-    {
-        self::$_instance->_req_type = null;
-        //make sure none of the old hooks are left hanging around
-        remove_all_actions('AHEE__EE_System__perform_activations_upgrades_and_migrations');
-        //we need to reset the migration manager in order for it to detect DMSs properly
-        EE_Data_Migration_Manager::reset();
-        self::instance()->detect_activations_or_upgrades();
-        self::instance()->perform_activations_upgrades_and_migrations();
-        return self::instance();
-    }
-
-
-
-    /**
-     *    sets hooks for running rest of system
-     *    provides "AHEE__EE_System__construct__complete" hook for EE Addons to use as their starting point
-     *    starting EE Addons from any other point may lead to problems
-     *
-     * @access private
-     * @param  \EE_Registry $Registry
-     */
-    private function __construct(EE_Registry $Registry)
-    {
-        $this->registry = $Registry;
-        do_action('AHEE__EE_System__construct__begin', $this);
-        // allow addons to load first so that they can register autoloaders, set hooks for running DMS's, etc
-        add_action('AHEE__EE_Bootstrap__load_espresso_addons', array($this, 'load_espresso_addons'));
-        // when an ee addon is activated, we want to call the core hook(s) again
-        // because the newly-activated addon didn't get a chance to run at all
-        add_action('activate_plugin', array($this, 'load_espresso_addons'), 1);
-        // detect whether install or upgrade
-        add_action('AHEE__EE_Bootstrap__detect_activations_or_upgrades', array($this, 'detect_activations_or_upgrades'),
-            3);
-        // load EE_Config, EE_Textdomain, etc
-        add_action('AHEE__EE_Bootstrap__load_core_configuration', array($this, 'load_core_configuration'), 5);
-        // load EE_Config, EE_Textdomain, etc
-        add_action('AHEE__EE_Bootstrap__register_shortcodes_modules_and_widgets',
-            array($this, 'register_shortcodes_modules_and_widgets'), 7);
-        // you wanna get going? I wanna get going... let's get going!
-        add_action('AHEE__EE_Bootstrap__brew_espresso', array($this, 'brew_espresso'), 9);
-        //other housekeeping
-        //exclude EE critical pages from wp_list_pages
-        add_filter('wp_list_pages_excludes', array($this, 'remove_pages_from_wp_list_pages'), 10);
-        // ALL EE Addons should use the following hook point to attach their initial setup too
-        // it's extremely important for EE Addons to register any class autoloaders so that they can be available when the EE_Config loads
-        do_action('AHEE__EE_System__construct__complete', $this);
-    }
-
-
-
-    /**
-     * load_espresso_addons
-     * allow addons to load first so that they can set hooks for running DMS's, etc
-     * this is hooked into both:
-     *    'AHEE__EE_Bootstrap__load_core_configuration'
-     *        which runs during the WP 'plugins_loaded' action at priority 5
-     *    and the WP 'activate_plugin' hookpoint
-     *
-     * @access public
-     * @return void
-     */
-    public function load_espresso_addons()
-    {
-        // set autoloaders for all of the classes implementing EEI_Plugin_API
-        // which provide helpers for EE plugin authors to more easily register certain components with EE.
-        EEH_Autoloader::instance()->register_autoloaders_for_each_file_in_folder(EE_LIBRARIES . 'plugin_api');
-        //load and setup EE_Capabilities
-        $this->registry->load_core('Capabilities');
-        //caps need to be initialized on every request so that capability maps are set.
-        //@see https://events.codebasehq.com/projects/event-espresso/tickets/8674
-        $this->registry->CAP->init_caps();
-        do_action('AHEE__EE_System__load_espresso_addons');
-        //if the WP API basic auth plugin isn't already loaded, load it now.
-        //We want it for mobile apps. Just include the entire plugin
-        //also, don't load the basic auth when a plugin is getting activated, because
-        //it could be the basic auth plugin, and it doesn't check if its methods are already defined
-        //and causes a fatal error
-        if ( ! function_exists('json_basic_auth_handler')
-             && ! function_exists('json_basic_auth_error')
-             && ! (
-                isset($_GET['action'])
-                && in_array($_GET['action'], array('activate', 'activate-selected'))
-            )
-             && ! (
-                isset($_GET['activate'])
-                && $_GET['activate'] === 'true'
-            )
-        ) {
-            include_once EE_THIRD_PARTY . 'wp-api-basic-auth' . DS . 'basic-auth.php';
-        }
-        do_action('AHEE__EE_System__load_espresso_addons__complete');
-    }
-
-
-
-    /**
-     * detect_activations_or_upgrades
-     * Checks for activation or upgrade of core first;
-     * then also checks if any registered addons have been activated or upgraded
-     * This is hooked into 'AHEE__EE_Bootstrap__detect_activations_or_upgrades'
-     * which runs during the WP 'plugins_loaded' action at priority 3
-     *
-     * @access public
-     * @return void
-     */
-    public function detect_activations_or_upgrades()
-    {
-        //first off: let's make sure to handle core
-        $this->detect_if_activation_or_upgrade();
-        foreach ($this->registry->addons as $addon) {
-            //detect teh request type for that addon
-            $addon->detect_activation_or_upgrade();
-        }
-    }
-
-
-
-    /**
-     * detect_if_activation_or_upgrade
-     * Takes care of detecting whether this is a brand new install or code upgrade,
-     * and either setting up the DB or setting up maintenance mode etc.
-     *
-     * @access public
-     * @return void
-     */
-    public function detect_if_activation_or_upgrade()
-    {
-        do_action('AHEE__EE_System___detect_if_activation_or_upgrade__begin');
-        // load M-Mode class
-        $this->registry->load_core('Maintenance_Mode');
-        // check if db has been updated, or if its a brand-new installation
-        $espresso_db_update = $this->fix_espresso_db_upgrade_option();
-        $request_type = $this->detect_req_type($espresso_db_update);
-        //EEH_Debug_Tools::printr( $request_type, '$request_type', __FILE__, __LINE__ );
-        switch ($request_type) {
-            case EE_System::req_type_new_activation:
-                do_action('AHEE__EE_System__detect_if_activation_or_upgrade__new_activation');
-                $this->_handle_core_version_change($espresso_db_update);
-                break;
-            case EE_System::req_type_reactivation:
-                do_action('AHEE__EE_System__detect_if_activation_or_upgrade__reactivation');
-                $this->_handle_core_version_change($espresso_db_update);
-                break;
-            case EE_System::req_type_upgrade:
-                do_action('AHEE__EE_System__detect_if_activation_or_upgrade__upgrade');
-                //migrations may be required now that we've upgraded
-                EE_Maintenance_Mode::instance()->set_maintenance_mode_if_db_old();
-                $this->_handle_core_version_change($espresso_db_update);
-                //				echo "done upgrade";die;
-                break;
-            case EE_System::req_type_downgrade:
-                do_action('AHEE__EE_System__detect_if_activation_or_upgrade__downgrade');
-                //its possible migrations are no longer required
-                EE_Maintenance_Mode::instance()->set_maintenance_mode_if_db_old();
-                $this->_handle_core_version_change($espresso_db_update);
-                break;
-            case EE_System::req_type_normal:
-            default:
-                //				$this->_maybe_redirect_to_ee_about();
-                break;
-        }
-        do_action('AHEE__EE_System__detect_if_activation_or_upgrade__complete');
-    }
-
-
-
-    /**
-     * Updates the list of installed versions and sets hooks for
-     * initializing the database later during the request
-     *
-     * @param array $espresso_db_update
-     */
-    protected function _handle_core_version_change($espresso_db_update)
-    {
-        $this->update_list_of_installed_versions($espresso_db_update);
-        //get ready to verify the DB is ok (provided we aren't in maintenance mode, of course)
-        add_action('AHEE__EE_System__perform_activations_upgrades_and_migrations',
-            array($this, 'initialize_db_if_no_migrations_required'));
-    }
-
-
-
-    /**
-     * standardizes the wp option 'espresso_db_upgrade' which actually stores
-     * information about what versions of EE have been installed and activated,
-     * NOT necessarily the state of the database
-     *
-     * @param null $espresso_db_update
-     * @internal param array $espresso_db_update_value the value of the WordPress option. If not supplied, fetches it
-     *           from the options table
-     * @return array the correct value of 'espresso_db_upgrade', after saving it, if it needed correction
-     */
-    private function fix_espresso_db_upgrade_option($espresso_db_update = null)
-    {
-        do_action('FHEE__EE_System__manage_fix_espresso_db_upgrade_option__begin', $espresso_db_update);
-        if ( ! $espresso_db_update) {
-            $espresso_db_update = get_option('espresso_db_update');
-        }
-        // check that option is an array
-        if ( ! is_array($espresso_db_update)) {
-            // if option is FALSE, then it never existed
-            if ($espresso_db_update === false) {
-                // make $espresso_db_update an array and save option with autoload OFF
-                $espresso_db_update = array();
-                add_option('espresso_db_update', $espresso_db_update, '', 'no');
-            } else {
-                // option is NOT FALSE but also is NOT an array, so make it an array and save it
-                $espresso_db_update = array($espresso_db_update => array());
-                update_option('espresso_db_update', $espresso_db_update);
-            }
-        } else {
-            $corrected_db_update = array();
-            //if IS an array, but is it an array where KEYS are version numbers, and values are arrays?
-            foreach ($espresso_db_update as $should_be_version_string => $should_be_array) {
-                if (is_int($should_be_version_string) && ! is_array($should_be_array)) {
-                    //the key is an int, and the value IS NOT an array
-                    //so it must be numerically-indexed, where values are versions installed...
-                    //fix it!
-                    $version_string = $should_be_array;
-                    $corrected_db_update[$version_string] = array('unknown-date');
-                } else {
-                    //ok it checks out
-                    $corrected_db_update[$should_be_version_string] = $should_be_array;
-                }
-            }
-            $espresso_db_update = $corrected_db_update;
-            update_option('espresso_db_update', $espresso_db_update);
-        }
-        do_action('FHEE__EE_System__manage_fix_espresso_db_upgrade_option__complete', $espresso_db_update);
-        return $espresso_db_update;
-    }
-
-
-
-    /**
-     * Does the traditional work of setting up the plugin's database and adding default data.
-     * If migration script/process did not exist, this is what would happen on every activation/reactivation/upgrade.
-     * NOTE: if we're in maintenance mode (which would be the case if we detect there are data
-     * migration scripts that need to be run and a version change happens), enqueues core for database initialization,
-     * so that it will be done when migrations are finished
-     *
-     * @param boolean $initialize_addons_too if true, we double-check addons' database tables etc too;
-     * @param boolean $verify_schema         if true will re-check the database tables have the correct schema.
-     *                                       This is a resource-intensive job
-     *                                       so we prefer to only do it when necessary
-     * @return void
-     */
-    public function initialize_db_if_no_migrations_required($initialize_addons_too = false, $verify_schema = true)
-    {
-        $request_type = $this->detect_req_type();
-        //only initialize system if we're not in maintenance mode.
-        if (EE_Maintenance_Mode::instance()->level() != EE_Maintenance_Mode::level_2_complete_maintenance) {
-            update_option('ee_flush_rewrite_rules', true);
-            if ($verify_schema) {
-                EEH_Activation::initialize_db_and_folders();
-            }
-            EEH_Activation::initialize_db_content();
-            EEH_Activation::system_initialization();
-            if ($initialize_addons_too) {
-                $this->initialize_addons();
-            }
-        } else {
-            EE_Data_Migration_Manager::instance()->enqueue_db_initialization_for('Core');
-        }
-        if ($request_type === EE_System::req_type_new_activation
-            || $request_type === EE_System::req_type_reactivation
-            || (
-                $request_type === EE_System::req_type_upgrade
-                && $this->is_major_version_change()
-            )
-        ) {
-            add_action('AHEE__EE_System__initialize_last', array($this, 'redirect_to_about_ee'), 9);
-        }
-    }
-
-
-
-    /**
-     * Initializes the db for all registered addons
-     */
-    public function initialize_addons()
-    {
-        //foreach registered addon, make sure its db is up-to-date too
-        foreach ($this->registry->addons as $addon) {
-            $addon->initialize_db_if_no_migrations_required();
-        }
-    }
-
-
-
-    /**
-     * Adds the current code version to the saved wp option which stores a list of all ee versions ever installed.
-     *
-     * @param    array  $version_history
-     * @param    string $current_version_to_add version to be added to the version history
-     * @return    boolean success as to whether or not this option was changed
-     */
-    public function update_list_of_installed_versions($version_history = null, $current_version_to_add = null)
-    {
-        if ( ! $version_history) {
-            $version_history = $this->fix_espresso_db_upgrade_option($version_history);
-        }
-        if ($current_version_to_add == null) {
-            $current_version_to_add = espresso_version();
-        }
-        $version_history[$current_version_to_add][] = date('Y-m-d H:i:s', time());
-        // re-save
-        return update_option('espresso_db_update', $version_history);
-    }
-
-
-
-    /**
-     * Detects if the current version indicated in the has existed in the list of
-     * previously-installed versions of EE (espresso_db_update). Does NOT modify it (ie, no side-effect)
-     *
-     * @param array $espresso_db_update array from the wp option stored under the name 'espresso_db_update'.
-     *                                  If not supplied, fetches it from the options table.
-     *                                  Also, caches its result so later parts of the code can also know whether
-     *                                  there's been an update or not. This way we can add the current version to
-     *                                  espresso_db_update, but still know if this is a new install or not
-     * @return int one of the constants on EE_System::req_type_
-     */
-    public function detect_req_type($espresso_db_update = null)
-    {
-        if ($this->_req_type === null) {
-            $espresso_db_update = ! empty($espresso_db_update) ? $espresso_db_update
-                : $this->fix_espresso_db_upgrade_option();
-            $this->_req_type = $this->detect_req_type_given_activation_history($espresso_db_update,
-                'ee_espresso_activation', espresso_version());
-            $this->_major_version_change = $this->_detect_major_version_change($espresso_db_update);
-        }
-        return $this->_req_type;
-    }
-
-
-
-    /**
-     * Returns whether or not there was a non-micro version change (ie, change in either
-     * the first or second number in the version. Eg 4.9.0.rc.001 to 4.10.0.rc.000,
-     * but not 4.9.0.rc.0001 to 4.9.1.rc.0001
-     *
-     * @param $activation_history
-     * @return bool
-     */
-    protected function _detect_major_version_change($activation_history)
-    {
-        $previous_version = EE_System::_get_most_recently_active_version_from_activation_history($activation_history);
-        $previous_version_parts = explode('.', $previous_version);
-        $current_version_parts = explode('.', espresso_version());
-        return isset($previous_version_parts[0], $previous_version_parts[1], $current_version_parts[0], $current_version_parts[1])
-               && ($previous_version_parts[0] !== $current_version_parts[0]
-                   || $previous_version_parts[1] !== $current_version_parts[1]
-               );
-    }
-
-
-
-    /**
-     * Returns true if either the major or minor version of EE changed during this request.
-     * Eg 4.9.0.rc.001 to 4.10.0.rc.000, but not 4.9.0.rc.0001 to 4.9.1.rc.0001
-     *
-     * @return bool
-     */
-    public function is_major_version_change()
-    {
-        return $this->_major_version_change;
-    }
-
-
-
-    /**
-     * Determines the request type for any ee addon, given three piece of info: the current array of activation
-     * histories (for core that' 'espresso_db_update' wp option); the name of the wordpress option which is temporarily
-     * set upon activation of the plugin (for core it's 'ee_espresso_activation'); and the version that this plugin was
-     * just activated to (for core that will always be espresso_version())
-     *
-     * @param array  $activation_history_for_addon     the option's value which stores the activation history for this
-     *                                                 ee plugin. for core that's 'espresso_db_update'
-     * @param string $activation_indicator_option_name the name of the wordpress option that is temporarily set to
-     *                                                 indicate that this plugin was just activated
-     * @param string $version_to_upgrade_to            the version that was just upgraded to (for core that will be
-     *                                                 espresso_version())
-     * @return int one of the constants on EE_System::req_type_*
-     */
-    public static function detect_req_type_given_activation_history(
-        $activation_history_for_addon,
-        $activation_indicator_option_name,
-        $version_to_upgrade_to
-    ) {
-        $version_is_higher = self::_new_version_is_higher($activation_history_for_addon, $version_to_upgrade_to);
-        if ($activation_history_for_addon) {
-            //it exists, so this isn't a completely new install
-            //check if this version already in that list of previously installed versions
-            if ( ! isset($activation_history_for_addon[$version_to_upgrade_to])) {
-                //it a version we haven't seen before
-                if ($version_is_higher === 1) {
-                    $req_type = EE_System::req_type_upgrade;
-                } else {
-                    $req_type = EE_System::req_type_downgrade;
-                }
-                delete_option($activation_indicator_option_name);
-            } else {
-                // its not an update. maybe a reactivation?
-                if (get_option($activation_indicator_option_name, false)) {
-                    if ($version_is_higher === -1) {
-                        $req_type = EE_System::req_type_downgrade;
-                    } elseif ($version_is_higher === 0) {
-                        //we've seen this version before, but it's an activation. must be a reactivation
-                        $req_type = EE_System::req_type_reactivation;
-                    } else {//$version_is_higher === 1
-                        $req_type = EE_System::req_type_upgrade;
-                    }
-                    delete_option($activation_indicator_option_name);
-                } else {
-                    //we've seen this version before and the activation indicate doesn't show it was just activated
-                    if ($version_is_higher === -1) {
-                        $req_type = EE_System::req_type_downgrade;
-                    } elseif ($version_is_higher === 0) {
-                        //we've seen this version before and it's not an activation. its normal request
-                        $req_type = EE_System::req_type_normal;
-                    } else {//$version_is_higher === 1
-                        $req_type = EE_System::req_type_upgrade;
-                    }
-                }
-            }
-        } else {
-            //brand new install
-            $req_type = EE_System::req_type_new_activation;
-            delete_option($activation_indicator_option_name);
-        }
-        return $req_type;
-    }
-
-
-
-    /**
-     * Detects if the $version_to_upgrade_to is higher than the most recent version in
-     * the $activation_history_for_addon
-     *
-     * @param array  $activation_history_for_addon (keys are versions, values are arrays of times activated,
-     *                                             sometimes containing 'unknown-date'
-     * @param string $version_to_upgrade_to        (current version)
-     * @return int results of version_compare( $version_to_upgrade_to, $most_recently_active_version ).
-     *                                             ie, -1 if $version_to_upgrade_to is LOWER (downgrade);
-     *                                             0 if $version_to_upgrade_to MATCHES (reactivation or normal request);
-     *                                             1 if $version_to_upgrade_to is HIGHER (upgrade) ;
-     */
-    protected static function _new_version_is_higher($activation_history_for_addon, $version_to_upgrade_to)
-    {
-        //find the most recently-activated version
-        $most_recently_active_version = EE_System::_get_most_recently_active_version_from_activation_history($activation_history_for_addon);
-        return version_compare($version_to_upgrade_to, $most_recently_active_version);
-    }
-
-
-
-    /**
-     * Gets the most recently active version listed in the activation history,
-     * and if none are found (ie, it's a brand new install) returns '0.0.0.dev.000'.
-     *
-     * @param array $activation_history  (keys are versions, values are arrays of times activated,
-     *                                   sometimes containing 'unknown-date'
-     * @return string
-     */
-    protected static function _get_most_recently_active_version_from_activation_history($activation_history)
-    {
-        $most_recently_active_version_activation = '1970-01-01 00:00:00';
-        $most_recently_active_version = '0.0.0.dev.000';
-        if (is_array($activation_history)) {
-            foreach ($activation_history as $version => $times_activated) {
-                //check there is a record of when this version was activated. Otherwise,
-                //mark it as unknown
-                if ( ! $times_activated) {
-                    $times_activated = array('unknown-date');
-                }
-                if (is_string($times_activated)) {
-                    $times_activated = array($times_activated);
-                }
-                foreach ($times_activated as $an_activation) {
-                    if ($an_activation != 'unknown-date' && $an_activation > $most_recently_active_version_activation) {
-                        $most_recently_active_version = $version;
-                        $most_recently_active_version_activation = $an_activation == 'unknown-date'
-                            ? '1970-01-01 00:00:00' : $an_activation;
-                    }
-                }
-            }
-        }
-        return $most_recently_active_version;
-    }
-
-
-
-    /**
-     * This redirects to the about EE page after activation
-     *
-     * @return void
-     */
-    public function redirect_to_about_ee()
-    {
-        $notices = EE_Error::get_notices(false);
-        //if current user is an admin and it's not an ajax or rest request
-        if (
-            ! (defined('DOING_AJAX') && DOING_AJAX)
-            && ! (defined('REST_REQUEST') && REST_REQUEST)
-            && ! isset($notices['errors'])
-            && apply_filters(
-                'FHEE__EE_System__redirect_to_about_ee__do_redirect',
-                $this->registry->CAP->current_user_can('manage_options', 'espresso_about_default')
-            )
-        ) {
-            $query_params = array('page' => 'espresso_about');
-            if (EE_System::instance()->detect_req_type() == EE_System::req_type_new_activation) {
-                $query_params['new_activation'] = true;
-            }
-            if (EE_System::instance()->detect_req_type() == EE_System::req_type_reactivation) {
-                $query_params['reactivation'] = true;
-            }
-            $url = add_query_arg($query_params, admin_url('admin.php'));
-            wp_safe_redirect($url);
-            exit();
-        }
-    }
-
-
-
-    /**
-     * load_core_configuration
-     * this is hooked into 'AHEE__EE_Bootstrap__load_core_configuration'
-     * which runs during the WP 'plugins_loaded' action at priority 5
-     *
-     * @return void
-     */
-    public function load_core_configuration()
-    {
-        do_action('AHEE__EE_System__load_core_configuration__begin', $this);
-        $this->registry->load_core('EE_Load_Textdomain');
-        //load textdomain
-        EE_Load_Textdomain::load_textdomain();
-        // load and setup EE_Config and EE_Network_Config
-        $this->registry->load_core('Config');
-        $this->registry->load_core('Network_Config');
-        // setup autoloaders
-        // enable logging?
-        if ($this->registry->CFG->admin->use_full_logging) {
-            $this->registry->load_core('Log');
-        }
-        // check for activation errors
-        $activation_errors = get_option('ee_plugin_activation_errors', false);
-        if ($activation_errors) {
-            EE_Error::add_error($activation_errors, __FILE__, __FUNCTION__, __LINE__);
-            update_option('ee_plugin_activation_errors', false);
-        }
-        // get model names
-        $this->_parse_model_names();
-        //load caf stuff a chance to play during the activation process too.
-        $this->_maybe_brew_regular();
-        do_action('AHEE__EE_System__load_core_configuration__complete', $this);
-    }
-
-
-
-    /**
-     * cycles through all of the models/*.model.php files, and assembles an array of model names
-     *
-     * @return void
-     */
-    private function _parse_model_names()
-    {
-        //get all the files in the EE_MODELS folder that end in .model.php
-        $models = glob(EE_MODELS . '*.model.php');
-        $model_names = array();
-        $non_abstract_db_models = array();
-        foreach ($models as $model) {
-            // get model classname
-            $classname = EEH_File::get_classname_from_filepath_with_standard_filename($model);
-            $short_name = str_replace('EEM_', '', $classname);
-            $reflectionClass = new ReflectionClass($classname);
-            if ($reflectionClass->isSubclassOf('EEM_Base') && ! $reflectionClass->isAbstract()) {
-                $non_abstract_db_models[$short_name] = $classname;
-            }
-            $model_names[$short_name] = $classname;
-        }
-        $this->registry->models = apply_filters('FHEE__EE_System__parse_model_names', $model_names);
-        $this->registry->non_abstract_db_models = apply_filters('FHEE__EE_System__parse_implemented_model_names',
-            $non_abstract_db_models);
-    }
-
-
-
-    /**
-     * The purpose of this method is to simply check for a file named "caffeinated/brewing_regular.php" for any hooks
-     * that need to be setup before our EE_System launches.
-     *
-     * @return void
-     */
-    private function _maybe_brew_regular()
-    {
-        if (( ! defined('EE_DECAF') || EE_DECAF !== true) && is_readable(EE_CAFF_PATH . 'brewing_regular.php')) {
-            require_once EE_CAFF_PATH . 'brewing_regular.php';
-        }
-    }
-
-
-
-    /**
-     * register_shortcodes_modules_and_widgets
-     * generate lists of shortcodes and modules, then verify paths and classes
-     * This is hooked into 'AHEE__EE_Bootstrap__register_shortcodes_modules_and_widgets'
-     * which runs during the WP 'plugins_loaded' action at priority 7
-     *
-     * @access public
-     * @return void
-     */
-    public function register_shortcodes_modules_and_widgets()
-    {
-        do_action('AHEE__EE_System__register_shortcodes_modules_and_widgets');
-        // check for addons using old hookpoint
-        if (has_action('AHEE__EE_System__register_shortcodes_modules_and_addons')) {
-            $this->_incompatible_addon_error();
-        }
-    }
-
-
-
-    /**
-     * _incompatible_addon_error
-     *
-     * @access public
-     * @return void
-     */
-    private function _incompatible_addon_error()
-    {
-        // get array of classes hooking into here
-        $class_names = EEH_Class_Tools::get_class_names_for_all_callbacks_on_hook('AHEE__EE_System__register_shortcodes_modules_and_addons');
-        if ( ! empty($class_names)) {
-            $msg = __('The following plugins, addons, or modules appear to be incompatible with this version of Event Espresso and were automatically deactivated to avoid fatal errors:',
-                'event_espresso');
-            $msg .= '<ul>';
-            foreach ($class_names as $class_name) {
-                $msg .= '<li><b>Event Espresso - ' . str_replace(array('EE_', 'EEM_', 'EED_', 'EES_', 'EEW_'), '',
-                        $class_name) . '</b></li>';
-            }
-            $msg .= '</ul>';
-            $msg .= __('Compatibility issues can be avoided and/or resolved by keeping addons and plugins updated to the latest version.',
-                'event_espresso');
-            // save list of incompatible addons to wp-options for later use
-            add_option('ee_incompatible_addons', $class_names, '', 'no');
-            if (is_admin()) {
-                EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
-            }
-        }
-    }
-
-
-
-    /**
-     * brew_espresso
-     * begins the process of setting hooks for initializing EE in the correct order
-     * This is happening on the 'AHEE__EE_Bootstrap__brew_espresso' hookpoint
-     * which runs during the WP 'plugins_loaded' action at priority 9
-     *
-     * @return void
-     */
-    public function brew_espresso()
-    {
-        do_action('AHEE__EE_System__brew_espresso__begin', $this);
-        // load some final core systems
-        add_action('init', array($this, 'set_hooks_for_core'), 1);
-        add_action('init', array($this, 'perform_activations_upgrades_and_migrations'), 3);
-        add_action('init', array($this, 'load_CPTs_and_session'), 5);
-        add_action('init', array($this, 'load_controllers'), 7);
-        add_action('init', array($this, 'core_loaded_and_ready'), 9);
-        add_action('init', array($this, 'initialize'), 10);
-        add_action('init', array($this, 'initialize_last'), 100);
-        add_action('wp_enqueue_scripts', array($this, 'wp_enqueue_scripts'), 25);
-        add_action('admin_enqueue_scripts', array($this, 'wp_enqueue_scripts'), 25);
-        add_action('admin_bar_menu', array($this, 'espresso_toolbar_items'), 100);
-        if (is_admin() && apply_filters('FHEE__EE_System__brew_espresso__load_pue', true)) {
-            // pew pew pew
-            $this->registry->load_core('PUE');
-            do_action('AHEE__EE_System__brew_espresso__after_pue_init');
-        }
-        do_action('AHEE__EE_System__brew_espresso__complete', $this);
-    }
-
-
-
-    /**
-     *    set_hooks_for_core
-     *
-     * @access public
-     * @return    void
-     */
-    public function set_hooks_for_core()
-    {
-        $this->_deactivate_incompatible_addons();
-        do_action('AHEE__EE_System__set_hooks_for_core');
-    }
-
-
-
-    /**
-     * Using the information gathered in EE_System::_incompatible_addon_error,
-     * deactivates any addons considered incompatible with the current version of EE
-     */
-    private function _deactivate_incompatible_addons()
-    {
-        $incompatible_addons = get_option('ee_incompatible_addons', array());
-        if ( ! empty($incompatible_addons)) {
-            $active_plugins = get_option('active_plugins', array());
-            foreach ($active_plugins as $active_plugin) {
-                foreach ($incompatible_addons as $incompatible_addon) {
-                    if (strpos($active_plugin, $incompatible_addon) !== false) {
-                        unset($_GET['activate']);
-                        espresso_deactivate_plugin($active_plugin);
-                    }
-                }
-            }
-        }
-    }
-
-
-
-    /**
-     *    perform_activations_upgrades_and_migrations
-     *
-     * @access public
-     * @return    void
-     */
-    public function perform_activations_upgrades_and_migrations()
-    {
-        //first check if we had previously attempted to setup EE's directories but failed
-        if (EEH_Activation::upload_directories_incomplete()) {
-            EEH_Activation::create_upload_directories();
-        }
-        do_action('AHEE__EE_System__perform_activations_upgrades_and_migrations');
-    }
-
-
-
-    /**
-     *    load_CPTs_and_session
-     *
-     * @access public
-     * @return    void
-     */
-    public function load_CPTs_and_session()
-    {
-        do_action('AHEE__EE_System__load_CPTs_and_session__start');
-        // register Custom Post Types
-        $this->registry->load_core('Register_CPTs');
-        do_action('AHEE__EE_System__load_CPTs_and_session__complete');
-    }
-
-
-
-    /**
-     * load_controllers
-     * this is the best place to load any additional controllers that needs access to EE core.
-     * it is expected that all basic core EE systems, that are not dependant on the current request are loaded at this
-     * time
-     *
-     * @access public
-     * @return void
-     */
-    public function load_controllers()
-    {
-        do_action('AHEE__EE_System__load_controllers__start');
-        // let's get it started
-        if ( ! is_admin() && ! EE_Maintenance_Mode::instance()->level()) {
-            do_action('AHEE__EE_System__load_controllers__load_front_controllers');
-            $this->registry->load_core('Front_Controller', array(), false, true);
-        } else if ( ! EE_FRONT_AJAX) {
-            do_action('AHEE__EE_System__load_controllers__load_admin_controllers');
-            EE_Registry::instance()->load_core('Admin');
-        }
-        do_action('AHEE__EE_System__load_controllers__complete');
-    }
-
-
-
-    /**
-     * core_loaded_and_ready
-     * all of the basic EE core should be loaded at this point and available regardless of M-Mode
-     *
-     * @access public
-     * @return void
-     */
-    public function core_loaded_and_ready()
-    {
-        do_action('AHEE__EE_System__core_loaded_and_ready');
-        do_action('AHEE__EE_System__set_hooks_for_shortcodes_modules_and_addons');
-        $this->registry->load_core('Session');
-        //		add_action( 'wp_loaded', array( $this, 'set_hooks_for_shortcodes_modules_and_addons' ), 1 );
-    }
-
-
-
-    /**
-     * initialize
-     * this is the best place to begin initializing client code
-     *
-     * @access public
-     * @return void
-     */
-    public function initialize()
-    {
-        do_action('AHEE__EE_System__initialize');
-    }
-
-
-
-    /**
-     * initialize_last
-     * this is run really late during the WP init hookpoint, and ensures that mostly everything else that needs to
-     * initialize has done so
-     *
-     * @access public
-     * @return void
-     */
-    public function initialize_last()
-    {
-        do_action('AHEE__EE_System__initialize_last');
-    }
-
-
-
-    /**
-     * set_hooks_for_shortcodes_modules_and_addons
-     * this is the best place for other systems to set callbacks for hooking into other parts of EE
-     * this happens at the very beginning of the wp_loaded hookpoint
-     *
-     * @access public
-     * @return void
-     */
-    public function set_hooks_for_shortcodes_modules_and_addons()
-    {
-        //		do_action( 'AHEE__EE_System__set_hooks_for_shortcodes_modules_and_addons' );
-    }
-
-
-
-    /**
-     * do_not_cache
-     * sets no cache headers and defines no cache constants for WP plugins
-     *
-     * @access public
-     * @return void
-     */
-    public static function do_not_cache()
-    {
-        // set no cache constants
-        if ( ! defined('DONOTCACHEPAGE')) {
-            define('DONOTCACHEPAGE', true);
-        }
-        if ( ! defined('DONOTCACHCEOBJECT')) {
-            define('DONOTCACHCEOBJECT', true);
-        }
-        if ( ! defined('DONOTCACHEDB')) {
-            define('DONOTCACHEDB', true);
-        }
-        // add no cache headers
-        add_action('send_headers', array('EE_System', 'nocache_headers'), 10);
-        // plus a little extra for nginx and Google Chrome
-        add_filter('nocache_headers', array('EE_System', 'extra_nocache_headers'), 10, 1);
-        // prevent browsers from prefetching of the rel='next' link, because it may contain content that interferes with the registration process
-        remove_action('wp_head', 'adjacent_posts_rel_link_wp_head');
-    }
-
-
-
-    /**
-     *    extra_nocache_headers
-     *
-     * @access    public
-     * @param $headers
-     * @return    array
-     */
-    public static function extra_nocache_headers($headers)
-    {
-        // for NGINX
-        $headers['X-Accel-Expires'] = 0;
-        // plus extra for Google Chrome since it doesn't seem to respect "no-cache", but WILL respect "no-store"
-        $headers['Cache-Control'] = 'no-store, no-cache, must-revalidate, max-age=0';
-        return $headers;
-    }
-
-
-
-    /**
-     *    nocache_headers
-     *
-     * @access    public
-     * @return    void
-     */
-    public static function nocache_headers()
-    {
-        nocache_headers();
-    }
-
-
-
-    /**
-     *    espresso_toolbar_items
-     *
-     * @access public
-     * @param  WP_Admin_Bar $admin_bar
-     * @return void
-     */
-    public function espresso_toolbar_items(WP_Admin_Bar $admin_bar)
-    {
-        // if in full M-Mode, or its an AJAX request, or user is NOT an admin
-        if (EE_Maintenance_Mode::instance()->level() == EE_Maintenance_Mode::level_2_complete_maintenance
-            || defined('DOING_AJAX')
-            || ! $this->registry->CAP->current_user_can('ee_read_ee', 'ee_admin_bar_menu_top_level')
-        ) {
-            return;
-        }
-        do_action('AHEE_log', __FILE__, __FUNCTION__, '');
-        $menu_class = 'espresso_menu_item_class';
-        //we don't use the constants EVENTS_ADMIN_URL or REG_ADMIN_URL
-        //because they're only defined in each of their respective constructors
-        //and this might be a frontend request, in which case they aren't available
-        $events_admin_url = admin_url("admin.php?page=espresso_events");
-        $reg_admin_url = admin_url("admin.php?page=espresso_registrations");
-        $extensions_admin_url = admin_url("admin.php?page=espresso_packages");
-        //Top Level
-        $admin_bar->add_menu(array(
-            'id'    => 'espresso-toolbar',
-            'title' => '<span class="ee-icon ee-icon-ee-cup-thick ee-icon-size-20"></span><span class="ab-label">'
-                       . _x('Event Espresso', 'admin bar menu group label', 'event_espresso')
-                       . '</span>',
-            'href'  => $events_admin_url,
-            'meta'  => array(
-                'title' => __('Event Espresso', 'event_espresso'),
-                'class' => $menu_class . 'first',
-            ),
-        ));
-        //Events
-        if ($this->registry->CAP->current_user_can('ee_read_events', 'ee_admin_bar_menu_espresso-toolbar-events')) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-events',
-                'parent' => 'espresso-toolbar',
-                'title'  => __('Events', 'event_espresso'),
-                'href'   => $events_admin_url,
-                'meta'   => array(
-                    'title'  => __('Events', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        if ($this->registry->CAP->current_user_can('ee_edit_events', 'ee_admin_bar_menu_espresso-toolbar-events-new')) {
-            //Events Add New
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-events-new',
-                'parent' => 'espresso-toolbar-events',
-                'title'  => __('Add New', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'create_new'), $events_admin_url),
-                'meta'   => array(
-                    'title'  => __('Add New', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        if (is_single() && (get_post_type() == 'espresso_events')) {
-            //Current post
-            global $post;
-            if ($this->registry->CAP->current_user_can('ee_edit_event',
-                'ee_admin_bar_menu_espresso-toolbar-events-edit', $post->ID)
-            ) {
-                //Events Edit Current Event
-                $admin_bar->add_menu(array(
-                    'id'     => 'espresso-toolbar-events-edit',
-                    'parent' => 'espresso-toolbar-events',
-                    'title'  => __('Edit Event', 'event_espresso'),
-                    'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'edit', 'post' => $post->ID),
-                        $events_admin_url),
-                    'meta'   => array(
-                        'title'  => __('Edit Event', 'event_espresso'),
-                        'target' => '',
-                        'class'  => $menu_class,
-                    ),
-                ));
-            }
-        }
-        //Events View
-        if ($this->registry->CAP->current_user_can('ee_read_events',
-            'ee_admin_bar_menu_espresso-toolbar-events-view')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-events-view',
-                'parent' => 'espresso-toolbar-events',
-                'title'  => __('View', 'event_espresso'),
-                'href'   => $events_admin_url,
-                'meta'   => array(
-                    'title'  => __('View', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        if ($this->registry->CAP->current_user_can('ee_read_events', 'ee_admin_bar_menu_espresso-toolbar-events-all')) {
-            //Events View All
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-events-all',
-                'parent' => 'espresso-toolbar-events-view',
-                'title'  => __('All', 'event_espresso'),
-                'href'   => $events_admin_url,
-                'meta'   => array(
-                    'title'  => __('All', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        if ($this->registry->CAP->current_user_can('ee_read_events',
-            'ee_admin_bar_menu_espresso-toolbar-events-today')
-        ) {
-            //Events View Today
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-events-today',
-                'parent' => 'espresso-toolbar-events-view',
-                'title'  => __('Today', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'default', 'status' => 'today'),
-                    $events_admin_url),
-                'meta'   => array(
-                    'title'  => __('Today', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        if ($this->registry->CAP->current_user_can('ee_read_events',
-            'ee_admin_bar_menu_espresso-toolbar-events-month')
-        ) {
-            //Events View This Month
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-events-month',
-                'parent' => 'espresso-toolbar-events-view',
-                'title'  => __('This Month', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'default', 'status' => 'month'),
-                    $events_admin_url),
-                'meta'   => array(
-                    'title'  => __('This Month', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Registration Overview
-        if ($this->registry->CAP->current_user_can('ee_read_registrations',
-            'ee_admin_bar_menu_espresso-toolbar-registrations')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-registrations',
-                'parent' => 'espresso-toolbar',
-                'title'  => __('Registrations', 'event_espresso'),
-                'href'   => $reg_admin_url,
-                'meta'   => array(
-                    'title'  => __('Registrations', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Registration Overview Today
-        if ($this->registry->CAP->current_user_can('ee_read_registrations',
-            'ee_admin_bar_menu_espresso-toolbar-registrations-today')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-registrations-today',
-                'parent' => 'espresso-toolbar-registrations',
-                'title'  => __('Today', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'default', 'status' => 'today'),
-                    $reg_admin_url),
-                'meta'   => array(
-                    'title'  => __('Today', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Registration Overview Today Completed
-        if ($this->registry->CAP->current_user_can('ee_read_registrations',
-            'ee_admin_bar_menu_espresso-toolbar-registrations-today-approved')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-registrations-today-approved',
-                'parent' => 'espresso-toolbar-registrations-today',
-                'title'  => __('Approved', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array(
-                    'action'      => 'default',
-                    'status'      => 'today',
-                    '_reg_status' => EEM_Registration::status_id_approved,
-                ), $reg_admin_url),
-                'meta'   => array(
-                    'title'  => __('Approved', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Registration Overview Today Pending\
-        if ($this->registry->CAP->current_user_can('ee_read_registrations',
-            'ee_admin_bar_menu_espresso-toolbar-registrations-today-pending')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-registrations-today-pending',
-                'parent' => 'espresso-toolbar-registrations-today',
-                'title'  => __('Pending', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array(
-                    'action'     => 'default',
-                    'status'     => 'today',
-                    'reg_status' => EEM_Registration::status_id_pending_payment,
-                ), $reg_admin_url),
-                'meta'   => array(
-                    'title'  => __('Pending Payment', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Registration Overview Today Incomplete
-        if ($this->registry->CAP->current_user_can('ee_read_registrations',
-            'ee_admin_bar_menu_espresso-toolbar-registrations-today-not-approved')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-registrations-today-not-approved',
-                'parent' => 'espresso-toolbar-registrations-today',
-                'title'  => __('Not Approved', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array(
-                    'action'      => 'default',
-                    'status'      => 'today',
-                    '_reg_status' => EEM_Registration::status_id_not_approved,
-                ), $reg_admin_url),
-                'meta'   => array(
-                    'title'  => __('Not Approved', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Registration Overview Today Incomplete
-        if ($this->registry->CAP->current_user_can('ee_read_registrations',
-            'ee_admin_bar_menu_espresso-toolbar-registrations-today-cancelled')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-registrations-today-cancelled',
-                'parent' => 'espresso-toolbar-registrations-today',
-                'title'  => __('Cancelled', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array(
-                    'action'      => 'default',
-                    'status'      => 'today',
-                    '_reg_status' => EEM_Registration::status_id_cancelled,
-                ), $reg_admin_url),
-                'meta'   => array(
-                    'title'  => __('Cancelled', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Registration Overview This Month
-        if ($this->registry->CAP->current_user_can('ee_read_registrations',
-            'ee_admin_bar_menu_espresso-toolbar-registrations-month')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-registrations-month',
-                'parent' => 'espresso-toolbar-registrations',
-                'title'  => __('This Month', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'default', 'status' => 'month'),
-                    $reg_admin_url),
-                'meta'   => array(
-                    'title'  => __('This Month', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Registration Overview This Month Approved
-        if ($this->registry->CAP->current_user_can('ee_read_registrations',
-            'ee_admin_bar_menu_espresso-toolbar-registrations-month-approved')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-registrations-month-approved',
-                'parent' => 'espresso-toolbar-registrations-month',
-                'title'  => __('Approved', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array(
-                    'action'      => 'default',
-                    'status'      => 'month',
-                    '_reg_status' => EEM_Registration::status_id_approved,
-                ), $reg_admin_url),
-                'meta'   => array(
-                    'title'  => __('Approved', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Registration Overview This Month Pending
-        if ($this->registry->CAP->current_user_can('ee_read_registrations',
-            'ee_admin_bar_menu_espresso-toolbar-registrations-month-pending')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-registrations-month-pending',
-                'parent' => 'espresso-toolbar-registrations-month',
-                'title'  => __('Pending', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array(
-                    'action'      => 'default',
-                    'status'      => 'month',
-                    '_reg_status' => EEM_Registration::status_id_pending_payment,
-                ), $reg_admin_url),
-                'meta'   => array(
-                    'title'  => __('Pending', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Registration Overview This Month Not Approved
-        if ($this->registry->CAP->current_user_can('ee_read_registrations',
-            'ee_admin_bar_menu_espresso-toolbar-registrations-month-not-approved')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-registrations-month-not-approved',
-                'parent' => 'espresso-toolbar-registrations-month',
-                'title'  => __('Not Approved', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array(
-                    'action'      => 'default',
-                    'status'      => 'month',
-                    '_reg_status' => EEM_Registration::status_id_not_approved,
-                ), $reg_admin_url),
-                'meta'   => array(
-                    'title'  => __('Not Approved', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Registration Overview This Month Cancelled
-        if ($this->registry->CAP->current_user_can('ee_read_registrations',
-            'ee_admin_bar_menu_espresso-toolbar-registrations-month-cancelled')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-registrations-month-cancelled',
-                'parent' => 'espresso-toolbar-registrations-month',
-                'title'  => __('Cancelled', 'event_espresso'),
-                'href'   => EEH_URL::add_query_args_and_nonce(array(
-                    'action'      => 'default',
-                    'status'      => 'month',
-                    '_reg_status' => EEM_Registration::status_id_cancelled,
-                ), $reg_admin_url),
-                'meta'   => array(
-                    'title'  => __('Cancelled', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-        //Extensions & Services
-        if ($this->registry->CAP->current_user_can('ee_read_ee',
-            'ee_admin_bar_menu_espresso-toolbar-extensions-and-services')
-        ) {
-            $admin_bar->add_menu(array(
-                'id'     => 'espresso-toolbar-extensions-and-services',
-                'parent' => 'espresso-toolbar',
-                'title'  => __('Extensions & Services', 'event_espresso'),
-                'href'   => $extensions_admin_url,
-                'meta'   => array(
-                    'title'  => __('Extensions & Services', 'event_espresso'),
-                    'target' => '',
-                    'class'  => $menu_class,
-                ),
-            ));
-        }
-    }
-
-
-
-    /**
-     * simply hooks into "wp_list_pages_exclude" filter (for wp_list_pages method) and makes sure EE critical pages are
-     * never returned with the function.
-     *
-     * @param  array $exclude_array any existing pages being excluded are in this array.
-     * @return array
-     */
-    public function remove_pages_from_wp_list_pages($exclude_array)
-    {
-        return array_merge($exclude_array, $this->registry->CFG->core->get_critical_pages_array());
-    }
-
-
-
-
-
-
-    /***********************************************        WP_ENQUEUE_SCRIPTS HOOK         ***********************************************/
-    /**
-     *    wp_enqueue_scripts
-     *
-     * @access    public
-     * @return    void
-     */
-    public function wp_enqueue_scripts()
-    {
-        // unlike other systems, EE_System_scripts loading is turned ON by default, but prior to the init hook, can be turned off via: add_filter( 'FHEE_load_EE_System_scripts', '__return_false' );
-        if (apply_filters('FHEE_load_EE_System_scripts', true)) {
-            // jquery_validate loading is turned OFF by default, but prior to the wp_enqueue_scripts hook, can be turned back on again via:  add_filter( 'FHEE_load_jquery_validate', '__return_true' );
-            if (apply_filters('FHEE_load_jquery_validate', false)) {
-                // register jQuery Validate and additional methods
-                wp_register_script('jquery-validate', EE_GLOBAL_ASSETS_URL . 'scripts/jquery.validate.min.js',
-                    array('jquery'), '1.15.0', true);
-                wp_register_script('jquery-validate-extra-methods',
-                    EE_GLOBAL_ASSETS_URL . 'scripts/jquery.validate.additional-methods.min.js',
-                    array('jquery', 'jquery-validate'), '1.15.0', true);
-            }
-        }
-    }
+	/**
+	 * indicates this is a 'normal' request. Ie, not activation, nor upgrade, nor activation.
+	 * So examples of this would be a normal GET request on the frontend or backend, or a POST, etc
+	 */
+	const req_type_normal = 0;
+
+	/**
+	 * Indicates this is a brand new installation of EE so we should install
+	 * tables and default data etc
+	 */
+	const req_type_new_activation = 1;
+
+	/**
+	 * we've detected that EE has been reactivated (or EE was activated during maintenance mode,
+	 * and we just exited maintenance mode). We MUST check the database is setup properly
+	 * and that default data is setup too
+	 */
+	const req_type_reactivation = 2;
+
+	/**
+	 * indicates that EE has been upgraded since its previous request.
+	 * We may have data migration scripts to call and will want to trigger maintenance mode
+	 */
+	const req_type_upgrade = 3;
+
+	/**
+	 * TODO  will detect that EE has been DOWNGRADED. We probably don't want to run in this case...
+	 */
+	const req_type_downgrade = 4;
+
+	/**
+	 * @deprecated since version 4.6.0.dev.006
+	 * Now whenever a new_activation is detected the request type is still just
+	 * new_activation (same for reactivation, upgrade, downgrade etc), but if we'r ein maintenance mode
+	 * EE_System::initialize_db_if_no_migrations_required and EE_Addon::initialize_db_if_no_migrations_required
+	 * will instead enqueue that EE plugin's db initialization for when we're taken out of maintenance mode.
+	 * (Specifically, when the migration manager indicates migrations are finished
+	 * EE_Data_Migration_Manager::initialize_db_for_enqueued_ee_plugins() will be called)
+	 */
+	const req_type_activation_but_not_installed = 5;
+
+	/**
+	 * option prefix for recording the activation history (like core's "espresso_db_update") of addons
+	 */
+	const addon_activation_history_option_prefix = 'ee_addon_activation_history_';
+
+
+	/**
+	 *    instance of the EE_System object
+	 *
+	 * @var    $_instance
+	 * @access    private
+	 */
+	private static $_instance = null;
+
+	/**
+	 * @type  EE_Registry $Registry
+	 * @access    protected
+	 */
+	protected $registry;
+
+	/**
+	 * Stores which type of request this is, options being one of the constants on EE_System starting with req_type_*.
+	 * It can be a brand-new activation, a reactivation, an upgrade, a downgrade, or a normal request.
+	 *
+	 * @var int
+	 */
+	private $_req_type;
+
+	/**
+	 * Whether or not there was a non-micro version change in EE core version during this request
+	 *
+	 * @var boolean
+	 */
+	private $_major_version_change = false;
+
+
+
+	/**
+	 * @singleton method used to instantiate class object
+	 * @access    public
+	 * @param  \EE_Registry $Registry
+	 * @return \EE_System
+	 */
+	public static function instance(EE_Registry $Registry = null)
+	{
+		// check if class object is instantiated
+		if ( ! self::$_instance instanceof EE_System) {
+			self::$_instance = new self($Registry);
+		}
+		return self::$_instance;
+	}
+
+
+
+	/**
+	 * resets the instance and returns it
+	 *
+	 * @return EE_System
+	 */
+	public static function reset()
+	{
+		self::$_instance->_req_type = null;
+		//make sure none of the old hooks are left hanging around
+		remove_all_actions('AHEE__EE_System__perform_activations_upgrades_and_migrations');
+		//we need to reset the migration manager in order for it to detect DMSs properly
+		EE_Data_Migration_Manager::reset();
+		self::instance()->detect_activations_or_upgrades();
+		self::instance()->perform_activations_upgrades_and_migrations();
+		return self::instance();
+	}
+
+
+
+	/**
+	 *    sets hooks for running rest of system
+	 *    provides "AHEE__EE_System__construct__complete" hook for EE Addons to use as their starting point
+	 *    starting EE Addons from any other point may lead to problems
+	 *
+	 * @access private
+	 * @param  \EE_Registry $Registry
+	 */
+	private function __construct(EE_Registry $Registry)
+	{
+		$this->registry = $Registry;
+		do_action('AHEE__EE_System__construct__begin', $this);
+		// allow addons to load first so that they can register autoloaders, set hooks for running DMS's, etc
+		add_action('AHEE__EE_Bootstrap__load_espresso_addons', array($this, 'load_espresso_addons'));
+		// when an ee addon is activated, we want to call the core hook(s) again
+		// because the newly-activated addon didn't get a chance to run at all
+		add_action('activate_plugin', array($this, 'load_espresso_addons'), 1);
+		// detect whether install or upgrade
+		add_action('AHEE__EE_Bootstrap__detect_activations_or_upgrades', array($this, 'detect_activations_or_upgrades'),
+			3);
+		// load EE_Config, EE_Textdomain, etc
+		add_action('AHEE__EE_Bootstrap__load_core_configuration', array($this, 'load_core_configuration'), 5);
+		// load EE_Config, EE_Textdomain, etc
+		add_action('AHEE__EE_Bootstrap__register_shortcodes_modules_and_widgets',
+			array($this, 'register_shortcodes_modules_and_widgets'), 7);
+		// you wanna get going? I wanna get going... let's get going!
+		add_action('AHEE__EE_Bootstrap__brew_espresso', array($this, 'brew_espresso'), 9);
+		//other housekeeping
+		//exclude EE critical pages from wp_list_pages
+		add_filter('wp_list_pages_excludes', array($this, 'remove_pages_from_wp_list_pages'), 10);
+		// ALL EE Addons should use the following hook point to attach their initial setup too
+		// it's extremely important for EE Addons to register any class autoloaders so that they can be available when the EE_Config loads
+		do_action('AHEE__EE_System__construct__complete', $this);
+	}
+
+
+
+	/**
+	 * load_espresso_addons
+	 * allow addons to load first so that they can set hooks for running DMS's, etc
+	 * this is hooked into both:
+	 *    'AHEE__EE_Bootstrap__load_core_configuration'
+	 *        which runs during the WP 'plugins_loaded' action at priority 5
+	 *    and the WP 'activate_plugin' hookpoint
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function load_espresso_addons()
+	{
+		// set autoloaders for all of the classes implementing EEI_Plugin_API
+		// which provide helpers for EE plugin authors to more easily register certain components with EE.
+		EEH_Autoloader::instance()->register_autoloaders_for_each_file_in_folder(EE_LIBRARIES . 'plugin_api');
+		//load and setup EE_Capabilities
+		$this->registry->load_core('Capabilities');
+		//caps need to be initialized on every request so that capability maps are set.
+		//@see https://events.codebasehq.com/projects/event-espresso/tickets/8674
+		$this->registry->CAP->init_caps();
+		do_action('AHEE__EE_System__load_espresso_addons');
+		//if the WP API basic auth plugin isn't already loaded, load it now.
+		//We want it for mobile apps. Just include the entire plugin
+		//also, don't load the basic auth when a plugin is getting activated, because
+		//it could be the basic auth plugin, and it doesn't check if its methods are already defined
+		//and causes a fatal error
+		if ( ! function_exists('json_basic_auth_handler')
+			 && ! function_exists('json_basic_auth_error')
+			 && ! (
+				isset($_GET['action'])
+				&& in_array($_GET['action'], array('activate', 'activate-selected'))
+			)
+			 && ! (
+				isset($_GET['activate'])
+				&& $_GET['activate'] === 'true'
+			)
+		) {
+			include_once EE_THIRD_PARTY . 'wp-api-basic-auth' . DS . 'basic-auth.php';
+		}
+		do_action('AHEE__EE_System__load_espresso_addons__complete');
+	}
+
+
+
+	/**
+	 * detect_activations_or_upgrades
+	 * Checks for activation or upgrade of core first;
+	 * then also checks if any registered addons have been activated or upgraded
+	 * This is hooked into 'AHEE__EE_Bootstrap__detect_activations_or_upgrades'
+	 * which runs during the WP 'plugins_loaded' action at priority 3
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function detect_activations_or_upgrades()
+	{
+		//first off: let's make sure to handle core
+		$this->detect_if_activation_or_upgrade();
+		foreach ($this->registry->addons as $addon) {
+			//detect teh request type for that addon
+			$addon->detect_activation_or_upgrade();
+		}
+	}
+
+
+
+	/**
+	 * detect_if_activation_or_upgrade
+	 * Takes care of detecting whether this is a brand new install or code upgrade,
+	 * and either setting up the DB or setting up maintenance mode etc.
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function detect_if_activation_or_upgrade()
+	{
+		do_action('AHEE__EE_System___detect_if_activation_or_upgrade__begin');
+		// load M-Mode class
+		$this->registry->load_core('Maintenance_Mode');
+		// check if db has been updated, or if its a brand-new installation
+		$espresso_db_update = $this->fix_espresso_db_upgrade_option();
+		$request_type = $this->detect_req_type($espresso_db_update);
+		//EEH_Debug_Tools::printr( $request_type, '$request_type', __FILE__, __LINE__ );
+		switch ($request_type) {
+			case EE_System::req_type_new_activation:
+				do_action('AHEE__EE_System__detect_if_activation_or_upgrade__new_activation');
+				$this->_handle_core_version_change($espresso_db_update);
+				break;
+			case EE_System::req_type_reactivation:
+				do_action('AHEE__EE_System__detect_if_activation_or_upgrade__reactivation');
+				$this->_handle_core_version_change($espresso_db_update);
+				break;
+			case EE_System::req_type_upgrade:
+				do_action('AHEE__EE_System__detect_if_activation_or_upgrade__upgrade');
+				//migrations may be required now that we've upgraded
+				EE_Maintenance_Mode::instance()->set_maintenance_mode_if_db_old();
+				$this->_handle_core_version_change($espresso_db_update);
+				//				echo "done upgrade";die;
+				break;
+			case EE_System::req_type_downgrade:
+				do_action('AHEE__EE_System__detect_if_activation_or_upgrade__downgrade');
+				//its possible migrations are no longer required
+				EE_Maintenance_Mode::instance()->set_maintenance_mode_if_db_old();
+				$this->_handle_core_version_change($espresso_db_update);
+				break;
+			case EE_System::req_type_normal:
+			default:
+				//				$this->_maybe_redirect_to_ee_about();
+				break;
+		}
+		do_action('AHEE__EE_System__detect_if_activation_or_upgrade__complete');
+	}
+
+
+
+	/**
+	 * Updates the list of installed versions and sets hooks for
+	 * initializing the database later during the request
+	 *
+	 * @param array $espresso_db_update
+	 */
+	protected function _handle_core_version_change($espresso_db_update)
+	{
+		$this->update_list_of_installed_versions($espresso_db_update);
+		//get ready to verify the DB is ok (provided we aren't in maintenance mode, of course)
+		add_action('AHEE__EE_System__perform_activations_upgrades_and_migrations',
+			array($this, 'initialize_db_if_no_migrations_required'));
+	}
+
+
+
+	/**
+	 * standardizes the wp option 'espresso_db_upgrade' which actually stores
+	 * information about what versions of EE have been installed and activated,
+	 * NOT necessarily the state of the database
+	 *
+	 * @param null $espresso_db_update
+	 * @internal param array $espresso_db_update_value the value of the WordPress option. If not supplied, fetches it
+	 *           from the options table
+	 * @return array the correct value of 'espresso_db_upgrade', after saving it, if it needed correction
+	 */
+	private function fix_espresso_db_upgrade_option($espresso_db_update = null)
+	{
+		do_action('FHEE__EE_System__manage_fix_espresso_db_upgrade_option__begin', $espresso_db_update);
+		if ( ! $espresso_db_update) {
+			$espresso_db_update = get_option('espresso_db_update');
+		}
+		// check that option is an array
+		if ( ! is_array($espresso_db_update)) {
+			// if option is FALSE, then it never existed
+			if ($espresso_db_update === false) {
+				// make $espresso_db_update an array and save option with autoload OFF
+				$espresso_db_update = array();
+				add_option('espresso_db_update', $espresso_db_update, '', 'no');
+			} else {
+				// option is NOT FALSE but also is NOT an array, so make it an array and save it
+				$espresso_db_update = array($espresso_db_update => array());
+				update_option('espresso_db_update', $espresso_db_update);
+			}
+		} else {
+			$corrected_db_update = array();
+			//if IS an array, but is it an array where KEYS are version numbers, and values are arrays?
+			foreach ($espresso_db_update as $should_be_version_string => $should_be_array) {
+				if (is_int($should_be_version_string) && ! is_array($should_be_array)) {
+					//the key is an int, and the value IS NOT an array
+					//so it must be numerically-indexed, where values are versions installed...
+					//fix it!
+					$version_string = $should_be_array;
+					$corrected_db_update[$version_string] = array('unknown-date');
+				} else {
+					//ok it checks out
+					$corrected_db_update[$should_be_version_string] = $should_be_array;
+				}
+			}
+			$espresso_db_update = $corrected_db_update;
+			update_option('espresso_db_update', $espresso_db_update);
+		}
+		do_action('FHEE__EE_System__manage_fix_espresso_db_upgrade_option__complete', $espresso_db_update);
+		return $espresso_db_update;
+	}
+
+
+
+	/**
+	 * Does the traditional work of setting up the plugin's database and adding default data.
+	 * If migration script/process did not exist, this is what would happen on every activation/reactivation/upgrade.
+	 * NOTE: if we're in maintenance mode (which would be the case if we detect there are data
+	 * migration scripts that need to be run and a version change happens), enqueues core for database initialization,
+	 * so that it will be done when migrations are finished
+	 *
+	 * @param boolean $initialize_addons_too if true, we double-check addons' database tables etc too;
+	 * @param boolean $verify_schema         if true will re-check the database tables have the correct schema.
+	 *                                       This is a resource-intensive job
+	 *                                       so we prefer to only do it when necessary
+	 * @return void
+	 */
+	public function initialize_db_if_no_migrations_required($initialize_addons_too = false, $verify_schema = true)
+	{
+		$request_type = $this->detect_req_type();
+		//only initialize system if we're not in maintenance mode.
+		if (EE_Maintenance_Mode::instance()->level() != EE_Maintenance_Mode::level_2_complete_maintenance) {
+			update_option('ee_flush_rewrite_rules', true);
+			if ($verify_schema) {
+				EEH_Activation::initialize_db_and_folders();
+			}
+			EEH_Activation::initialize_db_content();
+			EEH_Activation::system_initialization();
+			if ($initialize_addons_too) {
+				$this->initialize_addons();
+			}
+		} else {
+			EE_Data_Migration_Manager::instance()->enqueue_db_initialization_for('Core');
+		}
+		if ($request_type === EE_System::req_type_new_activation
+			|| $request_type === EE_System::req_type_reactivation
+			|| (
+				$request_type === EE_System::req_type_upgrade
+				&& $this->is_major_version_change()
+			)
+		) {
+			add_action('AHEE__EE_System__initialize_last', array($this, 'redirect_to_about_ee'), 9);
+		}
+	}
+
+
+
+	/**
+	 * Initializes the db for all registered addons
+	 */
+	public function initialize_addons()
+	{
+		//foreach registered addon, make sure its db is up-to-date too
+		foreach ($this->registry->addons as $addon) {
+			$addon->initialize_db_if_no_migrations_required();
+		}
+	}
+
+
+
+	/**
+	 * Adds the current code version to the saved wp option which stores a list of all ee versions ever installed.
+	 *
+	 * @param    array  $version_history
+	 * @param    string $current_version_to_add version to be added to the version history
+	 * @return    boolean success as to whether or not this option was changed
+	 */
+	public function update_list_of_installed_versions($version_history = null, $current_version_to_add = null)
+	{
+		if ( ! $version_history) {
+			$version_history = $this->fix_espresso_db_upgrade_option($version_history);
+		}
+		if ($current_version_to_add == null) {
+			$current_version_to_add = espresso_version();
+		}
+		$version_history[$current_version_to_add][] = date('Y-m-d H:i:s', time());
+		// re-save
+		return update_option('espresso_db_update', $version_history);
+	}
+
+
+
+	/**
+	 * Detects if the current version indicated in the has existed in the list of
+	 * previously-installed versions of EE (espresso_db_update). Does NOT modify it (ie, no side-effect)
+	 *
+	 * @param array $espresso_db_update array from the wp option stored under the name 'espresso_db_update'.
+	 *                                  If not supplied, fetches it from the options table.
+	 *                                  Also, caches its result so later parts of the code can also know whether
+	 *                                  there's been an update or not. This way we can add the current version to
+	 *                                  espresso_db_update, but still know if this is a new install or not
+	 * @return int one of the constants on EE_System::req_type_
+	 */
+	public function detect_req_type($espresso_db_update = null)
+	{
+		if ($this->_req_type === null) {
+			$espresso_db_update = ! empty($espresso_db_update) ? $espresso_db_update
+				: $this->fix_espresso_db_upgrade_option();
+			$this->_req_type = $this->detect_req_type_given_activation_history($espresso_db_update,
+				'ee_espresso_activation', espresso_version());
+			$this->_major_version_change = $this->_detect_major_version_change($espresso_db_update);
+		}
+		return $this->_req_type;
+	}
+
+
+
+	/**
+	 * Returns whether or not there was a non-micro version change (ie, change in either
+	 * the first or second number in the version. Eg 4.9.0.rc.001 to 4.10.0.rc.000,
+	 * but not 4.9.0.rc.0001 to 4.9.1.rc.0001
+	 *
+	 * @param $activation_history
+	 * @return bool
+	 */
+	protected function _detect_major_version_change($activation_history)
+	{
+		$previous_version = EE_System::_get_most_recently_active_version_from_activation_history($activation_history);
+		$previous_version_parts = explode('.', $previous_version);
+		$current_version_parts = explode('.', espresso_version());
+		return isset($previous_version_parts[0], $previous_version_parts[1], $current_version_parts[0], $current_version_parts[1])
+			   && ($previous_version_parts[0] !== $current_version_parts[0]
+				   || $previous_version_parts[1] !== $current_version_parts[1]
+			   );
+	}
+
+
+
+	/**
+	 * Returns true if either the major or minor version of EE changed during this request.
+	 * Eg 4.9.0.rc.001 to 4.10.0.rc.000, but not 4.9.0.rc.0001 to 4.9.1.rc.0001
+	 *
+	 * @return bool
+	 */
+	public function is_major_version_change()
+	{
+		return $this->_major_version_change;
+	}
+
+
+
+	/**
+	 * Determines the request type for any ee addon, given three piece of info: the current array of activation
+	 * histories (for core that' 'espresso_db_update' wp option); the name of the wordpress option which is temporarily
+	 * set upon activation of the plugin (for core it's 'ee_espresso_activation'); and the version that this plugin was
+	 * just activated to (for core that will always be espresso_version())
+	 *
+	 * @param array  $activation_history_for_addon     the option's value which stores the activation history for this
+	 *                                                 ee plugin. for core that's 'espresso_db_update'
+	 * @param string $activation_indicator_option_name the name of the wordpress option that is temporarily set to
+	 *                                                 indicate that this plugin was just activated
+	 * @param string $version_to_upgrade_to            the version that was just upgraded to (for core that will be
+	 *                                                 espresso_version())
+	 * @return int one of the constants on EE_System::req_type_*
+	 */
+	public static function detect_req_type_given_activation_history(
+		$activation_history_for_addon,
+		$activation_indicator_option_name,
+		$version_to_upgrade_to
+	) {
+		$version_is_higher = self::_new_version_is_higher($activation_history_for_addon, $version_to_upgrade_to);
+		if ($activation_history_for_addon) {
+			//it exists, so this isn't a completely new install
+			//check if this version already in that list of previously installed versions
+			if ( ! isset($activation_history_for_addon[$version_to_upgrade_to])) {
+				//it a version we haven't seen before
+				if ($version_is_higher === 1) {
+					$req_type = EE_System::req_type_upgrade;
+				} else {
+					$req_type = EE_System::req_type_downgrade;
+				}
+				delete_option($activation_indicator_option_name);
+			} else {
+				// its not an update. maybe a reactivation?
+				if (get_option($activation_indicator_option_name, false)) {
+					if ($version_is_higher === -1) {
+						$req_type = EE_System::req_type_downgrade;
+					} elseif ($version_is_higher === 0) {
+						//we've seen this version before, but it's an activation. must be a reactivation
+						$req_type = EE_System::req_type_reactivation;
+					} else {//$version_is_higher === 1
+						$req_type = EE_System::req_type_upgrade;
+					}
+					delete_option($activation_indicator_option_name);
+				} else {
+					//we've seen this version before and the activation indicate doesn't show it was just activated
+					if ($version_is_higher === -1) {
+						$req_type = EE_System::req_type_downgrade;
+					} elseif ($version_is_higher === 0) {
+						//we've seen this version before and it's not an activation. its normal request
+						$req_type = EE_System::req_type_normal;
+					} else {//$version_is_higher === 1
+						$req_type = EE_System::req_type_upgrade;
+					}
+				}
+			}
+		} else {
+			//brand new install
+			$req_type = EE_System::req_type_new_activation;
+			delete_option($activation_indicator_option_name);
+		}
+		return $req_type;
+	}
+
+
+
+	/**
+	 * Detects if the $version_to_upgrade_to is higher than the most recent version in
+	 * the $activation_history_for_addon
+	 *
+	 * @param array  $activation_history_for_addon (keys are versions, values are arrays of times activated,
+	 *                                             sometimes containing 'unknown-date'
+	 * @param string $version_to_upgrade_to        (current version)
+	 * @return int results of version_compare( $version_to_upgrade_to, $most_recently_active_version ).
+	 *                                             ie, -1 if $version_to_upgrade_to is LOWER (downgrade);
+	 *                                             0 if $version_to_upgrade_to MATCHES (reactivation or normal request);
+	 *                                             1 if $version_to_upgrade_to is HIGHER (upgrade) ;
+	 */
+	protected static function _new_version_is_higher($activation_history_for_addon, $version_to_upgrade_to)
+	{
+		//find the most recently-activated version
+		$most_recently_active_version = EE_System::_get_most_recently_active_version_from_activation_history($activation_history_for_addon);
+		return version_compare($version_to_upgrade_to, $most_recently_active_version);
+	}
+
+
+
+	/**
+	 * Gets the most recently active version listed in the activation history,
+	 * and if none are found (ie, it's a brand new install) returns '0.0.0.dev.000'.
+	 *
+	 * @param array $activation_history  (keys are versions, values are arrays of times activated,
+	 *                                   sometimes containing 'unknown-date'
+	 * @return string
+	 */
+	protected static function _get_most_recently_active_version_from_activation_history($activation_history)
+	{
+		$most_recently_active_version_activation = '1970-01-01 00:00:00';
+		$most_recently_active_version = '0.0.0.dev.000';
+		if (is_array($activation_history)) {
+			foreach ($activation_history as $version => $times_activated) {
+				//check there is a record of when this version was activated. Otherwise,
+				//mark it as unknown
+				if ( ! $times_activated) {
+					$times_activated = array('unknown-date');
+				}
+				if (is_string($times_activated)) {
+					$times_activated = array($times_activated);
+				}
+				foreach ($times_activated as $an_activation) {
+					if ($an_activation != 'unknown-date' && $an_activation > $most_recently_active_version_activation) {
+						$most_recently_active_version = $version;
+						$most_recently_active_version_activation = $an_activation == 'unknown-date'
+							? '1970-01-01 00:00:00' : $an_activation;
+					}
+				}
+			}
+		}
+		return $most_recently_active_version;
+	}
+
+
+
+	/**
+	 * This redirects to the about EE page after activation
+	 *
+	 * @return void
+	 */
+	public function redirect_to_about_ee()
+	{
+		$notices = EE_Error::get_notices(false);
+		//if current user is an admin and it's not an ajax or rest request
+		if (
+			! (defined('DOING_AJAX') && DOING_AJAX)
+			&& ! (defined('REST_REQUEST') && REST_REQUEST)
+			&& ! isset($notices['errors'])
+			&& apply_filters(
+				'FHEE__EE_System__redirect_to_about_ee__do_redirect',
+				$this->registry->CAP->current_user_can('manage_options', 'espresso_about_default')
+			)
+		) {
+			$query_params = array('page' => 'espresso_about');
+			if (EE_System::instance()->detect_req_type() == EE_System::req_type_new_activation) {
+				$query_params['new_activation'] = true;
+			}
+			if (EE_System::instance()->detect_req_type() == EE_System::req_type_reactivation) {
+				$query_params['reactivation'] = true;
+			}
+			$url = add_query_arg($query_params, admin_url('admin.php'));
+			wp_safe_redirect($url);
+			exit();
+		}
+	}
+
+
+
+	/**
+	 * load_core_configuration
+	 * this is hooked into 'AHEE__EE_Bootstrap__load_core_configuration'
+	 * which runs during the WP 'plugins_loaded' action at priority 5
+	 *
+	 * @return void
+	 */
+	public function load_core_configuration()
+	{
+		do_action('AHEE__EE_System__load_core_configuration__begin', $this);
+		$this->registry->load_core('EE_Load_Textdomain');
+		//load textdomain
+		EE_Load_Textdomain::load_textdomain();
+		// load and setup EE_Config and EE_Network_Config
+		$this->registry->load_core('Config');
+		$this->registry->load_core('Network_Config');
+		// setup autoloaders
+		// enable logging?
+		if ($this->registry->CFG->admin->use_full_logging) {
+			$this->registry->load_core('Log');
+		}
+		// check for activation errors
+		$activation_errors = get_option('ee_plugin_activation_errors', false);
+		if ($activation_errors) {
+			EE_Error::add_error($activation_errors, __FILE__, __FUNCTION__, __LINE__);
+			update_option('ee_plugin_activation_errors', false);
+		}
+		// get model names
+		$this->_parse_model_names();
+		//load caf stuff a chance to play during the activation process too.
+		$this->_maybe_brew_regular();
+		do_action('AHEE__EE_System__load_core_configuration__complete', $this);
+	}
+
+
+
+	/**
+	 * cycles through all of the models/*.model.php files, and assembles an array of model names
+	 *
+	 * @return void
+	 */
+	private function _parse_model_names()
+	{
+		//get all the files in the EE_MODELS folder that end in .model.php
+		$models = glob(EE_MODELS . '*.model.php');
+		$model_names = array();
+		$non_abstract_db_models = array();
+		foreach ($models as $model) {
+			// get model classname
+			$classname = EEH_File::get_classname_from_filepath_with_standard_filename($model);
+			$short_name = str_replace('EEM_', '', $classname);
+			$reflectionClass = new ReflectionClass($classname);
+			if ($reflectionClass->isSubclassOf('EEM_Base') && ! $reflectionClass->isAbstract()) {
+				$non_abstract_db_models[$short_name] = $classname;
+			}
+			$model_names[$short_name] = $classname;
+		}
+		$this->registry->models = apply_filters('FHEE__EE_System__parse_model_names', $model_names);
+		$this->registry->non_abstract_db_models = apply_filters('FHEE__EE_System__parse_implemented_model_names',
+			$non_abstract_db_models);
+	}
+
+
+
+	/**
+	 * The purpose of this method is to simply check for a file named "caffeinated/brewing_regular.php" for any hooks
+	 * that need to be setup before our EE_System launches.
+	 *
+	 * @return void
+	 */
+	private function _maybe_brew_regular()
+	{
+		if (( ! defined('EE_DECAF') || EE_DECAF !== true) && is_readable(EE_CAFF_PATH . 'brewing_regular.php')) {
+			require_once EE_CAFF_PATH . 'brewing_regular.php';
+		}
+	}
+
+
+
+	/**
+	 * register_shortcodes_modules_and_widgets
+	 * generate lists of shortcodes and modules, then verify paths and classes
+	 * This is hooked into 'AHEE__EE_Bootstrap__register_shortcodes_modules_and_widgets'
+	 * which runs during the WP 'plugins_loaded' action at priority 7
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function register_shortcodes_modules_and_widgets()
+	{
+		do_action('AHEE__EE_System__register_shortcodes_modules_and_widgets');
+		// check for addons using old hookpoint
+		if (has_action('AHEE__EE_System__register_shortcodes_modules_and_addons')) {
+			$this->_incompatible_addon_error();
+		}
+	}
+
+
+
+	/**
+	 * _incompatible_addon_error
+	 *
+	 * @access public
+	 * @return void
+	 */
+	private function _incompatible_addon_error()
+	{
+		// get array of classes hooking into here
+		$class_names = EEH_Class_Tools::get_class_names_for_all_callbacks_on_hook('AHEE__EE_System__register_shortcodes_modules_and_addons');
+		if ( ! empty($class_names)) {
+			$msg = __('The following plugins, addons, or modules appear to be incompatible with this version of Event Espresso and were automatically deactivated to avoid fatal errors:',
+				'event_espresso');
+			$msg .= '<ul>';
+			foreach ($class_names as $class_name) {
+				$msg .= '<li><b>Event Espresso - ' . str_replace(array('EE_', 'EEM_', 'EED_', 'EES_', 'EEW_'), '',
+						$class_name) . '</b></li>';
+			}
+			$msg .= '</ul>';
+			$msg .= __('Compatibility issues can be avoided and/or resolved by keeping addons and plugins updated to the latest version.',
+				'event_espresso');
+			// save list of incompatible addons to wp-options for later use
+			add_option('ee_incompatible_addons', $class_names, '', 'no');
+			if (is_admin()) {
+				EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);
+			}
+		}
+	}
+
+
+
+	/**
+	 * brew_espresso
+	 * begins the process of setting hooks for initializing EE in the correct order
+	 * This is happening on the 'AHEE__EE_Bootstrap__brew_espresso' hookpoint
+	 * which runs during the WP 'plugins_loaded' action at priority 9
+	 *
+	 * @return void
+	 */
+	public function brew_espresso()
+	{
+		do_action('AHEE__EE_System__brew_espresso__begin', $this);
+		// load some final core systems
+		add_action('init', array($this, 'set_hooks_for_core'), 1);
+		add_action('init', array($this, 'perform_activations_upgrades_and_migrations'), 3);
+		add_action('init', array($this, 'load_CPTs_and_session'), 5);
+		add_action('init', array($this, 'load_controllers'), 7);
+		add_action('init', array($this, 'core_loaded_and_ready'), 9);
+		add_action('init', array($this, 'initialize'), 10);
+		add_action('init', array($this, 'initialize_last'), 100);
+		add_action('wp_enqueue_scripts', array($this, 'wp_enqueue_scripts'), 25);
+		add_action('admin_enqueue_scripts', array($this, 'wp_enqueue_scripts'), 25);
+		add_action('admin_bar_menu', array($this, 'espresso_toolbar_items'), 100);
+		if (is_admin() && apply_filters('FHEE__EE_System__brew_espresso__load_pue', true)) {
+			// pew pew pew
+			$this->registry->load_core('PUE');
+			do_action('AHEE__EE_System__brew_espresso__after_pue_init');
+		}
+		do_action('AHEE__EE_System__brew_espresso__complete', $this);
+	}
+
+
+
+	/**
+	 *    set_hooks_for_core
+	 *
+	 * @access public
+	 * @return    void
+	 */
+	public function set_hooks_for_core()
+	{
+		$this->_deactivate_incompatible_addons();
+		do_action('AHEE__EE_System__set_hooks_for_core');
+	}
+
+
+
+	/**
+	 * Using the information gathered in EE_System::_incompatible_addon_error,
+	 * deactivates any addons considered incompatible with the current version of EE
+	 */
+	private function _deactivate_incompatible_addons()
+	{
+		$incompatible_addons = get_option('ee_incompatible_addons', array());
+		if ( ! empty($incompatible_addons)) {
+			$active_plugins = get_option('active_plugins', array());
+			foreach ($active_plugins as $active_plugin) {
+				foreach ($incompatible_addons as $incompatible_addon) {
+					if (strpos($active_plugin, $incompatible_addon) !== false) {
+						unset($_GET['activate']);
+						espresso_deactivate_plugin($active_plugin);
+					}
+				}
+			}
+		}
+	}
+
+
+
+	/**
+	 *    perform_activations_upgrades_and_migrations
+	 *
+	 * @access public
+	 * @return    void
+	 */
+	public function perform_activations_upgrades_and_migrations()
+	{
+		//first check if we had previously attempted to setup EE's directories but failed
+		if (EEH_Activation::upload_directories_incomplete()) {
+			EEH_Activation::create_upload_directories();
+		}
+		do_action('AHEE__EE_System__perform_activations_upgrades_and_migrations');
+	}
+
+
+
+	/**
+	 *    load_CPTs_and_session
+	 *
+	 * @access public
+	 * @return    void
+	 */
+	public function load_CPTs_and_session()
+	{
+		do_action('AHEE__EE_System__load_CPTs_and_session__start');
+		// register Custom Post Types
+		$this->registry->load_core('Register_CPTs');
+		do_action('AHEE__EE_System__load_CPTs_and_session__complete');
+	}
+
+
+
+	/**
+	 * load_controllers
+	 * this is the best place to load any additional controllers that needs access to EE core.
+	 * it is expected that all basic core EE systems, that are not dependant on the current request are loaded at this
+	 * time
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function load_controllers()
+	{
+		do_action('AHEE__EE_System__load_controllers__start');
+		// let's get it started
+		if ( ! is_admin() && ! EE_Maintenance_Mode::instance()->level()) {
+			do_action('AHEE__EE_System__load_controllers__load_front_controllers');
+			$this->registry->load_core('Front_Controller', array(), false, true);
+		} else if ( ! EE_FRONT_AJAX) {
+			do_action('AHEE__EE_System__load_controllers__load_admin_controllers');
+			EE_Registry::instance()->load_core('Admin');
+		}
+		do_action('AHEE__EE_System__load_controllers__complete');
+	}
+
+
+
+	/**
+	 * core_loaded_and_ready
+	 * all of the basic EE core should be loaded at this point and available regardless of M-Mode
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function core_loaded_and_ready()
+	{
+		do_action('AHEE__EE_System__core_loaded_and_ready');
+		do_action('AHEE__EE_System__set_hooks_for_shortcodes_modules_and_addons');
+		$this->registry->load_core('Session');
+		//		add_action( 'wp_loaded', array( $this, 'set_hooks_for_shortcodes_modules_and_addons' ), 1 );
+	}
+
+
+
+	/**
+	 * initialize
+	 * this is the best place to begin initializing client code
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function initialize()
+	{
+		do_action('AHEE__EE_System__initialize');
+	}
+
+
+
+	/**
+	 * initialize_last
+	 * this is run really late during the WP init hookpoint, and ensures that mostly everything else that needs to
+	 * initialize has done so
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function initialize_last()
+	{
+		do_action('AHEE__EE_System__initialize_last');
+	}
+
+
+
+	/**
+	 * set_hooks_for_shortcodes_modules_and_addons
+	 * this is the best place for other systems to set callbacks for hooking into other parts of EE
+	 * this happens at the very beginning of the wp_loaded hookpoint
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public function set_hooks_for_shortcodes_modules_and_addons()
+	{
+		//		do_action( 'AHEE__EE_System__set_hooks_for_shortcodes_modules_and_addons' );
+	}
+
+
+
+	/**
+	 * do_not_cache
+	 * sets no cache headers and defines no cache constants for WP plugins
+	 *
+	 * @access public
+	 * @return void
+	 */
+	public static function do_not_cache()
+	{
+		// set no cache constants
+		if ( ! defined('DONOTCACHEPAGE')) {
+			define('DONOTCACHEPAGE', true);
+		}
+		if ( ! defined('DONOTCACHCEOBJECT')) {
+			define('DONOTCACHCEOBJECT', true);
+		}
+		if ( ! defined('DONOTCACHEDB')) {
+			define('DONOTCACHEDB', true);
+		}
+		// add no cache headers
+		add_action('send_headers', array('EE_System', 'nocache_headers'), 10);
+		// plus a little extra for nginx and Google Chrome
+		add_filter('nocache_headers', array('EE_System', 'extra_nocache_headers'), 10, 1);
+		// prevent browsers from prefetching of the rel='next' link, because it may contain content that interferes with the registration process
+		remove_action('wp_head', 'adjacent_posts_rel_link_wp_head');
+	}
+
+
+
+	/**
+	 *    extra_nocache_headers
+	 *
+	 * @access    public
+	 * @param $headers
+	 * @return    array
+	 */
+	public static function extra_nocache_headers($headers)
+	{
+		// for NGINX
+		$headers['X-Accel-Expires'] = 0;
+		// plus extra for Google Chrome since it doesn't seem to respect "no-cache", but WILL respect "no-store"
+		$headers['Cache-Control'] = 'no-store, no-cache, must-revalidate, max-age=0';
+		return $headers;
+	}
+
+
+
+	/**
+	 *    nocache_headers
+	 *
+	 * @access    public
+	 * @return    void
+	 */
+	public static function nocache_headers()
+	{
+		nocache_headers();
+	}
+
+
+
+	/**
+	 *    espresso_toolbar_items
+	 *
+	 * @access public
+	 * @param  WP_Admin_Bar $admin_bar
+	 * @return void
+	 */
+	public function espresso_toolbar_items(WP_Admin_Bar $admin_bar)
+	{
+		// if in full M-Mode, or its an AJAX request, or user is NOT an admin
+		if (EE_Maintenance_Mode::instance()->level() == EE_Maintenance_Mode::level_2_complete_maintenance
+			|| defined('DOING_AJAX')
+			|| ! $this->registry->CAP->current_user_can('ee_read_ee', 'ee_admin_bar_menu_top_level')
+		) {
+			return;
+		}
+		do_action('AHEE_log', __FILE__, __FUNCTION__, '');
+		$menu_class = 'espresso_menu_item_class';
+		//we don't use the constants EVENTS_ADMIN_URL or REG_ADMIN_URL
+		//because they're only defined in each of their respective constructors
+		//and this might be a frontend request, in which case they aren't available
+		$events_admin_url = admin_url("admin.php?page=espresso_events");
+		$reg_admin_url = admin_url("admin.php?page=espresso_registrations");
+		$extensions_admin_url = admin_url("admin.php?page=espresso_packages");
+		//Top Level
+		$admin_bar->add_menu(array(
+			'id'    => 'espresso-toolbar',
+			'title' => '<span class="ee-icon ee-icon-ee-cup-thick ee-icon-size-20"></span><span class="ab-label">'
+					   . _x('Event Espresso', 'admin bar menu group label', 'event_espresso')
+					   . '</span>',
+			'href'  => $events_admin_url,
+			'meta'  => array(
+				'title' => __('Event Espresso', 'event_espresso'),
+				'class' => $menu_class . 'first',
+			),
+		));
+		//Events
+		if ($this->registry->CAP->current_user_can('ee_read_events', 'ee_admin_bar_menu_espresso-toolbar-events')) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-events',
+				'parent' => 'espresso-toolbar',
+				'title'  => __('Events', 'event_espresso'),
+				'href'   => $events_admin_url,
+				'meta'   => array(
+					'title'  => __('Events', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		if ($this->registry->CAP->current_user_can('ee_edit_events', 'ee_admin_bar_menu_espresso-toolbar-events-new')) {
+			//Events Add New
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-events-new',
+				'parent' => 'espresso-toolbar-events',
+				'title'  => __('Add New', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'create_new'), $events_admin_url),
+				'meta'   => array(
+					'title'  => __('Add New', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		if (is_single() && (get_post_type() == 'espresso_events')) {
+			//Current post
+			global $post;
+			if ($this->registry->CAP->current_user_can('ee_edit_event',
+				'ee_admin_bar_menu_espresso-toolbar-events-edit', $post->ID)
+			) {
+				//Events Edit Current Event
+				$admin_bar->add_menu(array(
+					'id'     => 'espresso-toolbar-events-edit',
+					'parent' => 'espresso-toolbar-events',
+					'title'  => __('Edit Event', 'event_espresso'),
+					'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'edit', 'post' => $post->ID),
+						$events_admin_url),
+					'meta'   => array(
+						'title'  => __('Edit Event', 'event_espresso'),
+						'target' => '',
+						'class'  => $menu_class,
+					),
+				));
+			}
+		}
+		//Events View
+		if ($this->registry->CAP->current_user_can('ee_read_events',
+			'ee_admin_bar_menu_espresso-toolbar-events-view')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-events-view',
+				'parent' => 'espresso-toolbar-events',
+				'title'  => __('View', 'event_espresso'),
+				'href'   => $events_admin_url,
+				'meta'   => array(
+					'title'  => __('View', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		if ($this->registry->CAP->current_user_can('ee_read_events', 'ee_admin_bar_menu_espresso-toolbar-events-all')) {
+			//Events View All
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-events-all',
+				'parent' => 'espresso-toolbar-events-view',
+				'title'  => __('All', 'event_espresso'),
+				'href'   => $events_admin_url,
+				'meta'   => array(
+					'title'  => __('All', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		if ($this->registry->CAP->current_user_can('ee_read_events',
+			'ee_admin_bar_menu_espresso-toolbar-events-today')
+		) {
+			//Events View Today
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-events-today',
+				'parent' => 'espresso-toolbar-events-view',
+				'title'  => __('Today', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'default', 'status' => 'today'),
+					$events_admin_url),
+				'meta'   => array(
+					'title'  => __('Today', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		if ($this->registry->CAP->current_user_can('ee_read_events',
+			'ee_admin_bar_menu_espresso-toolbar-events-month')
+		) {
+			//Events View This Month
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-events-month',
+				'parent' => 'espresso-toolbar-events-view',
+				'title'  => __('This Month', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'default', 'status' => 'month'),
+					$events_admin_url),
+				'meta'   => array(
+					'title'  => __('This Month', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Registration Overview
+		if ($this->registry->CAP->current_user_can('ee_read_registrations',
+			'ee_admin_bar_menu_espresso-toolbar-registrations')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-registrations',
+				'parent' => 'espresso-toolbar',
+				'title'  => __('Registrations', 'event_espresso'),
+				'href'   => $reg_admin_url,
+				'meta'   => array(
+					'title'  => __('Registrations', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Registration Overview Today
+		if ($this->registry->CAP->current_user_can('ee_read_registrations',
+			'ee_admin_bar_menu_espresso-toolbar-registrations-today')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-registrations-today',
+				'parent' => 'espresso-toolbar-registrations',
+				'title'  => __('Today', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'default', 'status' => 'today'),
+					$reg_admin_url),
+				'meta'   => array(
+					'title'  => __('Today', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Registration Overview Today Completed
+		if ($this->registry->CAP->current_user_can('ee_read_registrations',
+			'ee_admin_bar_menu_espresso-toolbar-registrations-today-approved')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-registrations-today-approved',
+				'parent' => 'espresso-toolbar-registrations-today',
+				'title'  => __('Approved', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array(
+					'action'      => 'default',
+					'status'      => 'today',
+					'_reg_status' => EEM_Registration::status_id_approved,
+				), $reg_admin_url),
+				'meta'   => array(
+					'title'  => __('Approved', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Registration Overview Today Pending\
+		if ($this->registry->CAP->current_user_can('ee_read_registrations',
+			'ee_admin_bar_menu_espresso-toolbar-registrations-today-pending')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-registrations-today-pending',
+				'parent' => 'espresso-toolbar-registrations-today',
+				'title'  => __('Pending', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array(
+					'action'     => 'default',
+					'status'     => 'today',
+					'reg_status' => EEM_Registration::status_id_pending_payment,
+				), $reg_admin_url),
+				'meta'   => array(
+					'title'  => __('Pending Payment', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Registration Overview Today Incomplete
+		if ($this->registry->CAP->current_user_can('ee_read_registrations',
+			'ee_admin_bar_menu_espresso-toolbar-registrations-today-not-approved')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-registrations-today-not-approved',
+				'parent' => 'espresso-toolbar-registrations-today',
+				'title'  => __('Not Approved', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array(
+					'action'      => 'default',
+					'status'      => 'today',
+					'_reg_status' => EEM_Registration::status_id_not_approved,
+				), $reg_admin_url),
+				'meta'   => array(
+					'title'  => __('Not Approved', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Registration Overview Today Incomplete
+		if ($this->registry->CAP->current_user_can('ee_read_registrations',
+			'ee_admin_bar_menu_espresso-toolbar-registrations-today-cancelled')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-registrations-today-cancelled',
+				'parent' => 'espresso-toolbar-registrations-today',
+				'title'  => __('Cancelled', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array(
+					'action'      => 'default',
+					'status'      => 'today',
+					'_reg_status' => EEM_Registration::status_id_cancelled,
+				), $reg_admin_url),
+				'meta'   => array(
+					'title'  => __('Cancelled', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Registration Overview This Month
+		if ($this->registry->CAP->current_user_can('ee_read_registrations',
+			'ee_admin_bar_menu_espresso-toolbar-registrations-month')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-registrations-month',
+				'parent' => 'espresso-toolbar-registrations',
+				'title'  => __('This Month', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array('action' => 'default', 'status' => 'month'),
+					$reg_admin_url),
+				'meta'   => array(
+					'title'  => __('This Month', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Registration Overview This Month Approved
+		if ($this->registry->CAP->current_user_can('ee_read_registrations',
+			'ee_admin_bar_menu_espresso-toolbar-registrations-month-approved')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-registrations-month-approved',
+				'parent' => 'espresso-toolbar-registrations-month',
+				'title'  => __('Approved', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array(
+					'action'      => 'default',
+					'status'      => 'month',
+					'_reg_status' => EEM_Registration::status_id_approved,
+				), $reg_admin_url),
+				'meta'   => array(
+					'title'  => __('Approved', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Registration Overview This Month Pending
+		if ($this->registry->CAP->current_user_can('ee_read_registrations',
+			'ee_admin_bar_menu_espresso-toolbar-registrations-month-pending')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-registrations-month-pending',
+				'parent' => 'espresso-toolbar-registrations-month',
+				'title'  => __('Pending', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array(
+					'action'      => 'default',
+					'status'      => 'month',
+					'_reg_status' => EEM_Registration::status_id_pending_payment,
+				), $reg_admin_url),
+				'meta'   => array(
+					'title'  => __('Pending', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Registration Overview This Month Not Approved
+		if ($this->registry->CAP->current_user_can('ee_read_registrations',
+			'ee_admin_bar_menu_espresso-toolbar-registrations-month-not-approved')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-registrations-month-not-approved',
+				'parent' => 'espresso-toolbar-registrations-month',
+				'title'  => __('Not Approved', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array(
+					'action'      => 'default',
+					'status'      => 'month',
+					'_reg_status' => EEM_Registration::status_id_not_approved,
+				), $reg_admin_url),
+				'meta'   => array(
+					'title'  => __('Not Approved', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Registration Overview This Month Cancelled
+		if ($this->registry->CAP->current_user_can('ee_read_registrations',
+			'ee_admin_bar_menu_espresso-toolbar-registrations-month-cancelled')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-registrations-month-cancelled',
+				'parent' => 'espresso-toolbar-registrations-month',
+				'title'  => __('Cancelled', 'event_espresso'),
+				'href'   => EEH_URL::add_query_args_and_nonce(array(
+					'action'      => 'default',
+					'status'      => 'month',
+					'_reg_status' => EEM_Registration::status_id_cancelled,
+				), $reg_admin_url),
+				'meta'   => array(
+					'title'  => __('Cancelled', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+		//Extensions & Services
+		if ($this->registry->CAP->current_user_can('ee_read_ee',
+			'ee_admin_bar_menu_espresso-toolbar-extensions-and-services')
+		) {
+			$admin_bar->add_menu(array(
+				'id'     => 'espresso-toolbar-extensions-and-services',
+				'parent' => 'espresso-toolbar',
+				'title'  => __('Extensions & Services', 'event_espresso'),
+				'href'   => $extensions_admin_url,
+				'meta'   => array(
+					'title'  => __('Extensions & Services', 'event_espresso'),
+					'target' => '',
+					'class'  => $menu_class,
+				),
+			));
+		}
+	}
+
+
+
+	/**
+	 * simply hooks into "wp_list_pages_exclude" filter (for wp_list_pages method) and makes sure EE critical pages are
+	 * never returned with the function.
+	 *
+	 * @param  array $exclude_array any existing pages being excluded are in this array.
+	 * @return array
+	 */
+	public function remove_pages_from_wp_list_pages($exclude_array)
+	{
+		return array_merge($exclude_array, $this->registry->CFG->core->get_critical_pages_array());
+	}
+
+
+
+
+
+
+	/***********************************************        WP_ENQUEUE_SCRIPTS HOOK         ***********************************************/
+	/**
+	 *    wp_enqueue_scripts
+	 *
+	 * @access    public
+	 * @return    void
+	 */
+	public function wp_enqueue_scripts()
+	{
+		// unlike other systems, EE_System_scripts loading is turned ON by default, but prior to the init hook, can be turned off via: add_filter( 'FHEE_load_EE_System_scripts', '__return_false' );
+		if (apply_filters('FHEE_load_EE_System_scripts', true)) {
+			// jquery_validate loading is turned OFF by default, but prior to the wp_enqueue_scripts hook, can be turned back on again via:  add_filter( 'FHEE_load_jquery_validate', '__return_true' );
+			if (apply_filters('FHEE_load_jquery_validate', false)) {
+				// register jQuery Validate and additional methods
+				wp_register_script('jquery-validate', EE_GLOBAL_ASSETS_URL . 'scripts/jquery.validate.min.js',
+					array('jquery'), '1.15.0', true);
+				wp_register_script('jquery-validate-extra-methods',
+					EE_GLOBAL_ASSETS_URL . 'scripts/jquery.validate.additional-methods.min.js',
+					array('jquery', 'jquery-validate'), '1.15.0', true);
+			}
+		}
+	}
 
 
 

core/EE_Encryption.core.php

Indentation +51 added lines, -51 removed lines

@@ -1,6 +1,6 @@ 
 <?php
 if ( ! defined('EVENT_ESPRESSO_VERSION')) {
-    exit('No direct script access allowed');
+	exit('No direct script access allowed');
 }
 
 
@@ -28,7 +28,7 @@ 
 
 	/**
 	 * 	private constructor to prevent direct creation
-     *
+	 *
 	 */
   private function __construct() {
 		define( 'ESPRESSO_ENCRYPT', true );
@@ -124,7 +124,7 @@ 
 
 	/**
 	 * encodes string with PHP's base64 encoding
-     *
+	 *
 	 * @source  http://php.net/manual/en/function.base64-encode.php
 	 * @param string $text_string
 	 * @internal param $string - the text to be encoded
@@ -136,14 +136,14 @@ 
 			return $text_string;
 		}
 		// encode
-        return base64_encode ( $text_string );
+		return base64_encode ( $text_string );
 	}
 
 
 
 	/**
 	 * decodes string that has been encoded with PHP's base64 encoding
-     *
+	 *
 	 * @source  http://php.net/manual/en/function.base64-encode.php
 	 * @param string $encoded_string
 	 * @internal param $string - the text to be decoded
@@ -155,7 +155,7 @@ 
 			return $encoded_string;
 		}
 		// decode
-        return base64_decode ( $encoded_string );
+		return base64_decode ( $encoded_string );
 	}
 
 
@@ -176,7 +176,7 @@ 
 		// encode
 		$encoded_string = base64_encode ( $text_string );
 		// remove chars to make encoding more URL friendly
-        return strtr ( $encoded_string, '+/=', '-_,' );
+		return strtr ( $encoded_string, '+/=', '-_,' );
 	}
 
 
@@ -197,7 +197,7 @@ 
 		// replace previously removed characters
 		$encoded_string = strtr ( $encoded_string, '-_,', '+/=' );
 		// decode
-        return base64_decode ( $encoded_string );
+		return base64_decode ( $encoded_string );
 	}
 
 
@@ -211,8 +211,8 @@ 
 	 */
 	private function m_encrypt  ( $text_string = '' ) {
 		// you give me nothing??? GET OUT !
-        if (empty($text_string)) {
-            return $text_string;
+		if (empty($text_string)) {
+			return $text_string;
 		}
 		// get the initialization vector size
 		$iv_size = mcrypt_get_iv_size ( MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB );
@@ -220,7 +220,7 @@ 
 		$iv = mcrypt_create_iv ( $iv_size, MCRYPT_RAND );
 		// encrypt it
 		$encrypted_text = mcrypt_encrypt ( MCRYPT_RIJNDAEL_256, $this->get_encryption_key(), $text_string, MCRYPT_MODE_ECB, $iv );
-        // trim and maybe encode
+		// trim and maybe encode
 		return function_exists('base64_encode') ? trim(base64_encode($encrypted_text)) : trim($encrypted_text);
 	}
 
@@ -235,12 +235,12 @@ 
 	 */
 	private function m_decrypt  ( $encrypted_text = '' )  {
 		// you give me nothing??? GET OUT !
-        if (empty($encrypted_text)) {
-            return $encrypted_text;
+		if (empty($encrypted_text)) {
+			return $encrypted_text;
 		}
 		// decode
-        $encrypted_text = $this->valid_base_64($encrypted_text) ? base64_decode($encrypted_text) : $encrypted_text;
-        // get the initialization vector size
+		$encrypted_text = $this->valid_base_64($encrypted_text) ? base64_decode($encrypted_text) : $encrypted_text;
+		// get the initialization vector size
 		$iv_size = mcrypt_get_iv_size ( MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB );
 		$iv = mcrypt_create_iv ( $iv_size, MCRYPT_RAND );
 		// decrypt it
@@ -261,8 +261,8 @@ 
 	 */
 	private function acme_encrypt ( $text_string = '' ) {
 		// you give me nothing??? GET OUT !
-        if (empty($text_string)) {
-            return $text_string;
+		if (empty($text_string)) {
+			return $text_string;
 		}
 		$key_bits = str_split ( str_pad ( '', strlen( $text_string ), $this->get_encryption_key(), STR_PAD_RIGHT ));
 		$string_bits = str_split( $text_string );
@@ -270,15 +270,15 @@ 
 			$temp = ord( $v ) + ord ( $key_bits[$k] );
 			$string_bits[$k] = chr ( $temp > 255 ? ( $temp - 256 ) : $temp );
 		}
-        return function_exists('base64_encode') ? base64_encode( implode( '', $string_bits ) ) : implode('', $string_bits);
+		return function_exists('base64_encode') ? base64_encode( implode( '', $string_bits ) ) : implode('', $string_bits);
 	}
 
 
 
 	/**
-     * decrypts data for acme servers that didn't bother to install PHP mcrypt
-     *
-     * @source   : http://stackoverflow.com/questions/800922/how-to-encrypt-string-without-mcrypt-library-in-php
+	 * decrypts data for acme servers that didn't bother to install PHP mcrypt
+	 *
+	 * @source   : http://stackoverflow.com/questions/800922/how-to-encrypt-string-without-mcrypt-library-in-php
 	 * @param string $encrypted_text the text to be decrypted
 	 * @return string
 	 */
@@ -287,46 +287,46 @@ 
 		if  ( empty($encrypted_text))  {
 			return $encrypted_text;
 		}
-        // decode the data ?
-        $encrypted_text = $this->valid_base_64($encrypted_text) ? base64_decode($encrypted_text) : $encrypted_text;
+		// decode the data ?
+		$encrypted_text = $this->valid_base_64($encrypted_text) ? base64_decode($encrypted_text) : $encrypted_text;
 		$key_bits = str_split ( str_pad ( '', strlen ( $encrypted_text ), $this->get_encryption_key(), STR_PAD_RIGHT ));
 		$string_bits = str_split ( $encrypted_text );
 		foreach ( $string_bits as $k => $v ) {
 			$temp = ord ( $v ) - ord ( $key_bits[$k] );
 			$string_bits[$k] = chr ( $temp < 0 ? ( $temp + 256 ) : $temp );
 		}
-        return implode( '', $string_bits );
+		return implode( '', $string_bits );
 	}
 
 
 
-    /**
-     * @see http://stackoverflow.com/questions/2556345/detect-base64-encoding-in-php#30231906
-     * @param $string
-     * @return bool
-     */
-    private function valid_base_64($string)
-    {
-        // ensure data is a string
-        if ( ! is_string($string) || ! function_exists('base64_decode')) {
-            return false;
-        }
-        $decoded = base64_decode($string, true);
-        // Check if there is no invalid character in string
-        if ( ! preg_match('/^[a-zA-Z0-9\/\r\n+]*={0,2}$/', $string)) {
-            return false;
-        }
-        // Decode the string in strict mode and send the response
-        if ( ! base64_decode($string, true)) {
-            return false;
-        }
-        // Encode and compare it to original one
-        return base64_encode($decoded) === $string;
-    }
-
-
-
-    /**
+	/**
+	 * @see http://stackoverflow.com/questions/2556345/detect-base64-encoding-in-php#30231906
+	 * @param $string
+	 * @return bool
+	 */
+	private function valid_base_64($string)
+	{
+		// ensure data is a string
+		if ( ! is_string($string) || ! function_exists('base64_decode')) {
+			return false;
+		}
+		$decoded = base64_decode($string, true);
+		// Check if there is no invalid character in string
+		if ( ! preg_match('/^[a-zA-Z0-9\/\r\n+]*={0,2}$/', $string)) {
+			return false;
+		}
+		// Decode the string in strict mode and send the response
+		if ( ! base64_decode($string, true)) {
+			return false;
+		}
+		// Encode and compare it to original one
+		return base64_encode($decoded) === $string;
+	}
+
+
+
+	/**
 	 * generate random string
 	 * @source   : http://stackoverflow.com/questions/637278/what-is-the-best-way-to-generate-a-random-key-within-php
 	 * @access   public

Spacing +62 added lines, -62 removed lines

@@ -31,8 +31,8 @@ 
      *
 	 */
   private function __construct() {
-		define( 'ESPRESSO_ENCRYPT', true );
-		if ( ! function_exists( 'mcrypt_encrypt' ) ) {
+		define('ESPRESSO_ENCRYPT', true);
+		if ( ! function_exists('mcrypt_encrypt')) {
 			$this->_use_mcrypt = false;
 		}
 	}
@@ -44,9 +44,9 @@ 
 	 *	@access public
 	 * @return \EE_Encryption
 	 */
-	public static function instance ( ) {
+	public static function instance( ) {
 		// check if class object is instantiated
-		if ( ! self::$_instance instanceof EE_Encryption ) {
+		if ( ! self::$_instance instanceof EE_Encryption) {
 			self::$_instance = new self();
 		}
 		return self::$_instance;
@@ -61,15 +61,15 @@ 
 	 */
 	public  function get_encryption_key() {
 		// if encryption key has not been set
-		if ( empty( $this->_encryption_key )) {
+		if (empty($this->_encryption_key)) {
 			// retrieve encryption_key from db
-			$this->_encryption_key = get_option( 'ee_encryption_key', '' );
+			$this->_encryption_key = get_option('ee_encryption_key', '');
 			// WHAT?? No encryption_key in the db ??
-			if ( $this->_encryption_key === '' ) {
+			if ($this->_encryption_key === '') {
 				// let's make one. And md5 it to make it just the right size for a key
-				$new_key =  md5($this->generate_random_string());
+				$new_key = md5($this->generate_random_string());
 				// now save it to the db for later
-				add_option( 'ee_encryption_key', $new_key );
+				add_option('ee_encryption_key', $new_key);
 				// here's the key - FINALLY !
 				$this->_encryption_key = $new_key;
 			}
@@ -85,15 +85,15 @@ 
 	 * @param string $text_string  - the text to be encrypted
 	 * @return string
 	 */
-	public function encrypt ( $text_string = '' ) {
+	public function encrypt($text_string = '') {
 		// you give me nothing??? GET OUT !
-		if  ( empty( $text_string ))  {
+		if (empty($text_string)) {
 			return $text_string;
 		}
-		if ( $this->_use_mcrypt ) {
-			$encrypted_text = $this->m_encrypt( $text_string );
+		if ($this->_use_mcrypt) {
+			$encrypted_text = $this->m_encrypt($text_string);
 		} else {
-			$encrypted_text = $this->acme_encrypt( $text_string );
+			$encrypted_text = $this->acme_encrypt($text_string);
 		}
 		return $encrypted_text;
 	}
@@ -106,16 +106,16 @@ 
 	 * @param string $encrypted_text - the text to be decrypted
 	 * @return string
 	 */
-	public function decrypt  ( $encrypted_text = '' )  {
+	public function decrypt($encrypted_text = '') {
 		// you give me nothing??? GET OUT !
-		if  ( empty( $encrypted_text ))  {
+		if (empty($encrypted_text)) {
 			return $encrypted_text;
 		}
 		// if PHP's mcrypt functions are installed then we'll use them
-		if ( $this->_use_mcrypt ) {
-			$decrypted_text = $this->m_decrypt( $encrypted_text );
+		if ($this->_use_mcrypt) {
+			$decrypted_text = $this->m_decrypt($encrypted_text);
 		} else {
-			$decrypted_text = $this->acme_decrypt( $encrypted_text );
+			$decrypted_text = $this->acme_decrypt($encrypted_text);
 		}
 		return $decrypted_text;
  	}
@@ -130,13 +130,13 @@ 
 	 * @internal param $string - the text to be encoded
 	 * @return string
 	 */
-	public function base64_string_encode ( $text_string = '' ) {
+	public function base64_string_encode($text_string = '') {
 		// you give me nothing??? GET OUT !
-		if  (empty($text_string) || ! function_exists('base64_encode'))  {
+		if (empty($text_string) || ! function_exists('base64_encode')) {
 			return $text_string;
 		}
 		// encode
-        return base64_encode ( $text_string );
+        return base64_encode($text_string);
 	}
 
 
@@ -149,13 +149,13 @@ 
 	 * @internal param $string - the text to be decoded
 	 * @return string
 	 */
-	public function base64_string_decode ( $encoded_string = '' ) {
+	public function base64_string_decode($encoded_string = '') {
 		// you give me nothing??? GET OUT !
-		if  (empty($encoded_string) || ! $this->valid_base_64($encoded_string))  {
+		if (empty($encoded_string) || ! $this->valid_base_64($encoded_string)) {
 			return $encoded_string;
 		}
 		// decode
-        return base64_decode ( $encoded_string );
+        return base64_decode($encoded_string);
 	}
 
 
@@ -168,15 +168,15 @@ 
 	 * @internal param $string - the text to be encoded
 	 * @return string
 	 */
-	public function base64_url_encode ( $text_string = '' ) {
+	public function base64_url_encode($text_string = '') {
 		// you give me nothing??? GET OUT !
-		if  (empty($text_string) || ! function_exists('base64_encode'))  {
+		if (empty($text_string) || ! function_exists('base64_encode')) {
 			return $text_string;
 		}
 		// encode
-		$encoded_string = base64_encode ( $text_string );
+		$encoded_string = base64_encode($text_string);
 		// remove chars to make encoding more URL friendly
-        return strtr ( $encoded_string, '+/=', '-_,' );
+        return strtr($encoded_string, '+/=', '-_,');
 	}
 
 
@@ -189,15 +189,15 @@ 
 	 * @internal param $string - the text to be decoded
 	 * @return string
 	 */
-	public function base64_url_decode ( $encoded_string = '' ) {
+	public function base64_url_decode($encoded_string = '') {
 		// you give me nothing??? GET OUT !
-		if  (empty($encoded_string) || ! $this->valid_base_64($encoded_string))  {
+		if (empty($encoded_string) || ! $this->valid_base_64($encoded_string)) {
 			return $encoded_string;
 		}
 		// replace previously removed characters
-		$encoded_string = strtr ( $encoded_string, '-_,', '+/=' );
+		$encoded_string = strtr($encoded_string, '-_,', '+/=');
 		// decode
-        return base64_decode ( $encoded_string );
+        return base64_decode($encoded_string);
 	}
 
 
@@ -209,17 +209,17 @@ 
 	 * @internal param $string - the text to be encrypted
 	 * @return string
 	 */
-	private function m_encrypt  ( $text_string = '' ) {
+	private function m_encrypt($text_string = '') {
 		// you give me nothing??? GET OUT !
         if (empty($text_string)) {
             return $text_string;
 		}
 		// get the initialization vector size
-		$iv_size = mcrypt_get_iv_size ( MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB );
+		$iv_size = mcrypt_get_iv_size(MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB);
 		// initialization vector
-		$iv = mcrypt_create_iv ( $iv_size, MCRYPT_RAND );
+		$iv = mcrypt_create_iv($iv_size, MCRYPT_RAND);
 		// encrypt it
-		$encrypted_text = mcrypt_encrypt ( MCRYPT_RIJNDAEL_256, $this->get_encryption_key(), $text_string, MCRYPT_MODE_ECB, $iv );
+		$encrypted_text = mcrypt_encrypt(MCRYPT_RIJNDAEL_256, $this->get_encryption_key(), $text_string, MCRYPT_MODE_ECB, $iv);
         // trim and maybe encode
 		return function_exists('base64_encode') ? trim(base64_encode($encrypted_text)) : trim($encrypted_text);
 	}
@@ -233,7 +233,7 @@ 
 	 * @internal param $string - the text to be decrypted
 	 * @return string
 	 */
-	private function m_decrypt  ( $encrypted_text = '' )  {
+	private function m_decrypt($encrypted_text = '') {
 		// you give me nothing??? GET OUT !
         if (empty($encrypted_text)) {
             return $encrypted_text;
@@ -241,11 +241,11 @@ 
 		// decode
         $encrypted_text = $this->valid_base_64($encrypted_text) ? base64_decode($encrypted_text) : $encrypted_text;
         // get the initialization vector size
-		$iv_size = mcrypt_get_iv_size ( MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB );
-		$iv = mcrypt_create_iv ( $iv_size, MCRYPT_RAND );
+		$iv_size = mcrypt_get_iv_size(MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB);
+		$iv = mcrypt_create_iv($iv_size, MCRYPT_RAND);
 		// decrypt it
-		$decrypted_text = mcrypt_decrypt ( MCRYPT_RIJNDAEL_256, $this->get_encryption_key(), $encrypted_text, MCRYPT_MODE_ECB, $iv );
-		$decrypted_text = trim ( $decrypted_text );
+		$decrypted_text = mcrypt_decrypt(MCRYPT_RIJNDAEL_256, $this->get_encryption_key(), $encrypted_text, MCRYPT_MODE_ECB, $iv);
+		$decrypted_text = trim($decrypted_text);
 		return $decrypted_text;
 	}
 
@@ -259,18 +259,18 @@ 
 	 * @internal param $string - the text to be decrypted
 	 * @return string
 	 */
-	private function acme_encrypt ( $text_string = '' ) {
+	private function acme_encrypt($text_string = '') {
 		// you give me nothing??? GET OUT !
         if (empty($text_string)) {
             return $text_string;
 		}
-		$key_bits = str_split ( str_pad ( '', strlen( $text_string ), $this->get_encryption_key(), STR_PAD_RIGHT ));
-		$string_bits = str_split( $text_string );
-		foreach ( $string_bits as $k =>$v ) {
-			$temp = ord( $v ) + ord ( $key_bits[$k] );
-			$string_bits[$k] = chr ( $temp > 255 ? ( $temp - 256 ) : $temp );
+		$key_bits = str_split(str_pad('', strlen($text_string), $this->get_encryption_key(), STR_PAD_RIGHT));
+		$string_bits = str_split($text_string);
+		foreach ($string_bits as $k =>$v) {
+			$temp = ord($v) + ord($key_bits[$k]);
+			$string_bits[$k] = chr($temp > 255 ? ($temp - 256) : $temp);
 		}
-        return function_exists('base64_encode') ? base64_encode( implode( '', $string_bits ) ) : implode('', $string_bits);
+        return function_exists('base64_encode') ? base64_encode(implode('', $string_bits)) : implode('', $string_bits);
 	}
 
 
@@ -282,20 +282,20 @@ 
 	 * @param string $encrypted_text the text to be decrypted
 	 * @return string
 	 */
-	private function acme_decrypt ( $encrypted_text = '' ) {
+	private function acme_decrypt($encrypted_text = '') {
 		// you give me nothing??? GET OUT !
-		if  ( empty($encrypted_text))  {
+		if (empty($encrypted_text)) {
 			return $encrypted_text;
 		}
         // decode the data ?
         $encrypted_text = $this->valid_base_64($encrypted_text) ? base64_decode($encrypted_text) : $encrypted_text;
-		$key_bits = str_split ( str_pad ( '', strlen ( $encrypted_text ), $this->get_encryption_key(), STR_PAD_RIGHT ));
-		$string_bits = str_split ( $encrypted_text );
-		foreach ( $string_bits as $k => $v ) {
-			$temp = ord ( $v ) - ord ( $key_bits[$k] );
-			$string_bits[$k] = chr ( $temp < 0 ? ( $temp + 256 ) : $temp );
+		$key_bits = str_split(str_pad('', strlen($encrypted_text), $this->get_encryption_key(), STR_PAD_RIGHT));
+		$string_bits = str_split($encrypted_text);
+		foreach ($string_bits as $k => $v) {
+			$temp = ord($v) - ord($key_bits[$k]);
+			$string_bits[$k] = chr($temp < 0 ? ($temp + 256) : $temp);
 		}
-        return implode( '', $string_bits );
+        return implode('', $string_bits);
 	}
 
 
@@ -334,13 +334,13 @@ 
 	 * @internal param $string - number of characters for random string
 	 * @return string
 	 */
-	public function generate_random_string ( $length = 40 ) {
-		$iterations = ceil ( $length / 40 );
+	public function generate_random_string($length = 40) {
+		$iterations = ceil($length / 40);
 		$random_string = '';
-		for ($i = 0; $i < $iterations; $i ++) {
-			$random_string .= sha1( microtime(TRUE) . mt_rand( 10000, 90000 ));
+		for ($i = 0; $i < $iterations; $i++) {
+			$random_string .= sha1(microtime(TRUE).mt_rand(10000, 90000));
 		}
-		$random_string =  substr( $random_string, 0, $length );
+		$random_string = substr($random_string, 0, $length);
 		return $random_string;
 	}
 

admin_pages/maintenance/Maintenance_Admin_Page.core.php

Indentation +542 added lines, -542 removed lines

@@ -1,6 +1,6 @@ 
 <?php
 if ( ! defined('EVENT_ESPRESSO_VERSION')) {
-    exit('NO direct script access allowed');
+	exit('NO direct script access allowed');
 }
 
 
@@ -28,562 +28,562 @@ 
 {
 
 
-    public function __construct($routing = true)
-    {
-        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()
-    {
-        add_action('wp_ajax_migration_step', array($this, 'migration_step'));
-        add_action('wp_ajax_add_error_to_migrations_ran', array($this, 'add_error_to_migrations_ran'));
-    }
-
-
-
-    protected function _define_page_props()
-    {
-        $this->_admin_page_title = EE_MAINTENANCE_LABEL;
-        $this->_labels = array(
-            'buttons' => array(
-                'reset_capabilities' => __('Reset Event Espresso Capabilities', 'event_espresso'),
-            ),
-        );
-    }
-
-
-
-    protected function _set_page_routes()
-    {
-        $this->_page_routes = array(
-            'default'                             => array(
-                'func'       => '_maintenance',
-                'capability' => 'manage_options',
-            ),
-            'change_maintenance_level'            => array(
-                'func'       => '_change_maintenance_level',
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ),
-            'system_status'                       => array(
-                'func'       => '_system_status',
-                'capability' => 'manage_options',
-            ),
-            'send_migration_crash_report'         => array(
-                'func'       => '_send_migration_crash_report',
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ),
-            'confirm_migration_crash_report_sent' => array(
-                'func'       => '_confirm_migration_crash_report_sent',
-                'capability' => 'manage_options',
-            ),
-            'data_reset'                          => array(
-                'func'       => '_data_reset_and_delete',
-                'capability' => 'manage_options',
-            ),
-            'reset_db'                            => array(
-                'func'       => '_reset_db',
-                'capability' => 'manage_options',
-                'noheader'   => true,
-                'args'       => array('nuke_old_ee4_data' => true),
-            ),
-            'start_with_fresh_ee4_db'             => array(
-                'func'       => '_reset_db',
-                'capability' => 'manage_options',
-                'noheader'   => true,
-                'args'       => array('nuke_old_ee4_data' => false),
-            ),
-            'delete_db'                           => array(
-                'func'       => '_delete_db',
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ),
-            'rerun_migration_from_ee3'            => array(
-                'func'       => '_rerun_migration_from_ee3',
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ),
-            'reset_capabilities'                  => array(
-                'func'       => '_reset_capabilities',
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ),
-            'reattempt_migration'                 => array(
-                'func'       => '_reattempt_migration',
-                'capability' => 'manage_options',
-                'noheader'   => true,
-            ),
-        );
-    }
-
-
-
-    protected function _set_page_config()
-    {
-        $this->_page_config = array(
-            'default'       => array(
-                'nav'           => array(
-                    'label' => __('Maintenance', 'event_espresso'),
-                    'order' => 10,
-                ),
-                'require_nonce' => false,
-            ),
-            'data_reset'    => array(
-                'nav'           => array(
-                    'label' => __('Reset/Delete Data', 'event_espresso'),
-                    'order' => 20,
-                ),
-                'require_nonce' => false,
-            ),
-            'system_status' => array(
-                'nav'           => array(
-                    'label' => __("System Information", "event_espresso"),
-                    '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.
-     */
-    public function _maintenance()
-    {
-        //it all depends 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
-            $mm = EE_Maintenance_Mode::instance()->level();
-            $placed_in_mm = EE_Maintenance_Mode::instance()->set_maintenance_mode_if_db_old();
-            if ($mm == EE_Maintenance_Mode::level_2_complete_maintenance && ! $placed_in_mm) {
-                //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(__('Site taken out of maintenance mode because no data migration scripts are required',
-                    'event_espresso'));
-                $this->_process_notices(array('page' => 'espresso_maintenance_settings'), false);
-            }
-            //in case an exception is thrown while trying to handle migrations
-            switch (EE_Maintenance_Mode::instance()->level()) {
-                case EE_Maintenance_Mode::level_0_not_in_maintenance:
-                case EE_Maintenance_Mode::level_1_frontend_only_maintenance:
-                    $show_maintenance_switch = true;
-                    $show_backup_db_text = false;
-                    $show_migration_progress = false;
-                    $script_names = array();
-                    $addons_should_be_upgraded_first = false;
-                    break;
-                case EE_Maintenance_Mode::level_2_complete_maintenance:
-                    $show_maintenance_switch = false;
-                    $show_migration_progress = true;
-                    if (isset($this->_req_data['continue_migration'])) {
-                        $show_backup_db_text = false;
-                    } else {
-                        $show_backup_db_text = true;
-                    }
-                    $scripts_needing_to_run = EE_Data_Migration_Manager::instance()
-                                                                       ->check_for_applicable_data_migration_scripts();
-                    $addons_should_be_upgraded_first = EE_Data_Migration_Manager::instance()->addons_need_updating();
-                    $script_names = array();
-                    $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();
-                        }
-                    }
-                    break;
-            }
-            $most_recent_migration = EE_Data_Migration_Manager::instance()->get_last_ran_script(true);
-            $exception_thrown = false;
-        } catch (EE_Error $e) {
-            EE_Data_Migration_Manager::instance()->add_error_to_migrations_ran($e->getMessage());
-            //now, just so we can display the page correctly, make a 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 = EE_Data_Migration_Manager::instance()->ensure_current_database_state_is_set();
-        $current_db_state = str_replace('.decaf', '', $current_db_state);
-        if ($exception_thrown
-            || ($most_recent_migration
-                && $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'] = 'http://eventespresso.com/support/forums/';
-            $this->_template_args['next_url'] = EEH_URL::add_query_args_and_nonce(array('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
-                && $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, array(
-                    'current_db_state' => sprintf(__("EE%s (%s)", "event_espresso"),
-                        isset($current_db_state[$plugin_slug]) ? $current_db_state[$plugin_slug] : 3, $plugin_slug),
-                    'next_db_state'    => isset($current_script) ? sprintf(__("EE%s (%s)", 'event_espresso'),
-                        $new_version, $plugin_slug) : null,
-                ));
-            }
-            $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_migration_page.template.php';
-            $this->_template_args = array_merge(
-                $this->_template_args,
-                array(
-                    '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 backup 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(array('action' => 'reset_db'),
-                        EE_MAINTENANCE_ADMIN_URL),
-                    'update_migration_script_page_link'      => EE_Admin_Page::add_query_args_and_nonce(array('action' => 'change_maintenance_level'),
-                        EE_MAINTENANCE_ADMIN_URL),
-                    'ultimate_db_state'                      => sprintf(__("EE%s", 'event_espresso'),
-                        espresso_version()),
-                )
-            );
-            //make sure we have the form fields helper available. It usually is, but sometimes it isn't
-            //localize script stuff
-            wp_localize_script('ee-maintenance', 'ee_maintenance', array(
-                'migrating'                        => __("Migrating...", "event_espresso"),
-                'next'                             => __("Next", "event_espresso"),
-                'fatal_error'                      => __("A Fatal Error Has Occurred", "event_espresso"),
-                'click_next_when_ready'            => __("The current Migration 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,
-            ));
-        }
-        $this->_template_args['most_recent_migration'] = $most_recent_migration;//the actual most recently ran migration
-        $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)
-     */
-    public function migration_step()
-    {
-        $this->_template_args['data'] = EE_Data_Migration_Manager::instance()->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
-     */
-    public function add_error_to_migrations_ran()
-    {
-        EE_Data_Migration_Manager::instance()->add_error_to_migrations_ran($this->_req_data['message']);
-        $this->_template_args['data'] = array('ok' => true);
-        $this->_return_json();
-    }
-
-
-
-    /**
-     * changes the maintenance level, provided there are still no migration scripts that shoudl run
-     */
-    public function _change_maintenance_level()
-    {
-        $new_level = intval($this->_req_data['maintenance_mode_level']);
-        if ( ! EE_Data_Migration_Manager::instance()->check_for_applicable_data_migration_scripts()) {
-            EE_Maintenance_Mode::instance()->set_maintenance_level($new_level);
-            $success = true;
-        } else {
-            EE_Maintenance_Mode::instance()->set_maintenance_mode_if_db_old();
-            $success = false;
-        }
-        $this->_redirect_after_action($success, 'Maintenance Mode', __("Updated", "event_espresso"));
-    }
-
-
-
-    /**
-     * a tab with options for resetting and/or deleting EE data
-     *
-     * @throws \EE_Error
-     */
-    public function _data_reset_and_delete()
-    {
-        $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_data_reset_and_delete.template.php';
-        $this->_template_args['reset_capabilities_button'] = $this->get_action_link_or_button(
-            'reset_capabilities',
-            'reset_capabilities',
-            array(),
-            'button button-primary',
-            '',
-            false
-        );
-        $this->_template_args['delete_db_url'] = EE_Admin_Page::add_query_args_and_nonce(
-            array('action' => 'delete_db'),
-            EE_MAINTENANCE_ADMIN_URL
-        );
-        $this->_template_args['reset_db_url'] = EE_Admin_Page::add_query_args_and_nonce(
-            array('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_sidebar();
-    }
-
-
-
-    protected function _reset_capabilities()
-    {
-        EE_Registry::instance()->CAP->init_caps(true);
-        EE_Error::add_success(__('Default Event Espresso capabilities have been restored for all current roles.',
-            'event_espresso'));
-        $this->_redirect_after_action(false, '', '', array('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)
-     */
-    protected function _reattempt_migration()
-    {
-        EE_Data_Migration_Manager::instance()->reattempt();
-        $this->_redirect_after_action(false, '', '', array('action' => 'default'), true);
-    }
-
-
-
-    /**
-     * shows the big ol' System Information page
-     */
-    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['admin_page_content'] = EEH_Template::display_template($this->_template_path,
-            $this->_template_args, true);
-        $this->display_admin_page_with_sidebar();
-    }
-
-
-
-    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),
-                array(
-                    "from:$from_name<$from>",
-                    //					'content-type:text/html charset=UTF-8'
-                ));
-        } catch (Exception $e) {
-            $success = false;
-        }
-        $this->_redirect_after_action($success, __("Migration Crash Report", "event_espresso"),
-            __("sent", "event_espresso"),
-            array('success' => $success, 'action' => 'confirm_migration_crash_report_sent'));
-    }
-
-
-
-    public function _confirm_migration_crash_report_sent()
-    {
-        try {
-            $most_recent_migration = EE_Data_Migration_Manager::instance()->get_last_ran_script(true);
-        } catch (EE_Error $e) {
-            EE_Data_Migration_Manager::instance()->add_error_to_migrations_ran($e->getMessage());
-            //now, just so we can display the page correctly, make a 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' ? true : false;
-        $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(array('action' => 'reset_db'),
-            EE_MAINTENANCE_ADMIN_URL);
-        $this->_template_args['reset_db_page_url'] = EE_Admin_Page::add_query_args_and_nonce(array('action' => 'data_reset'),
-            EE_MAINTENANCE_ADMIN_URL);
-        $this->_template_args['reattempt_action_url'] = EE_Admin_Page::add_query_args_and_nonce(array('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.
-     * Currently basically only sets up ee4 database for a fresh install- doesn't
-     * actually clean out the old wp options, or cpts (although does erase old ee table data)
-     *
-     * @param boolean $nuke_old_ee4_data controls whether or not we
-     *                                   destroy the old ee4 data, or just try initializing ee4 default data
-     */
-    public function _reset_db($nuke_old_ee4_data = true)
-    {
-        EE_Maintenance_Mode::instance()->set_maintenance_level(EE_Maintenance_Mode::level_0_not_in_maintenance);
-        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.
-     */
-    public function _delete_db()
-    {
-        EE_Maintenance_Mode::instance()->set_maintenance_level(EE_Maintenance_Mode::level_0_not_in_maintenance);
-        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
-     */
-    public function _rerun_migration_from_ee3()
-    {
-        EE_Maintenance_Mode::instance()->set_maintenance_level(EE_Maintenance_Mode::level_0_not_in_maintenance);
-        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');
-        EE_Maintenance_Mode::instance()->set_maintenance_level(EE_Maintenance_Mode::level_2_complete_maintenance);
-        $this->_redirect_after_action(true, __("Database", 'event_espresso'), __("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 __construct($routing = true)
+	{
+		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()
+	{
+		add_action('wp_ajax_migration_step', array($this, 'migration_step'));
+		add_action('wp_ajax_add_error_to_migrations_ran', array($this, 'add_error_to_migrations_ran'));
+	}
+
+
+
+	protected function _define_page_props()
+	{
+		$this->_admin_page_title = EE_MAINTENANCE_LABEL;
+		$this->_labels = array(
+			'buttons' => array(
+				'reset_capabilities' => __('Reset Event Espresso Capabilities', 'event_espresso'),
+			),
+		);
+	}
+
+
+
+	protected function _set_page_routes()
+	{
+		$this->_page_routes = array(
+			'default'                             => array(
+				'func'       => '_maintenance',
+				'capability' => 'manage_options',
+			),
+			'change_maintenance_level'            => array(
+				'func'       => '_change_maintenance_level',
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			),
+			'system_status'                       => array(
+				'func'       => '_system_status',
+				'capability' => 'manage_options',
+			),
+			'send_migration_crash_report'         => array(
+				'func'       => '_send_migration_crash_report',
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			),
+			'confirm_migration_crash_report_sent' => array(
+				'func'       => '_confirm_migration_crash_report_sent',
+				'capability' => 'manage_options',
+			),
+			'data_reset'                          => array(
+				'func'       => '_data_reset_and_delete',
+				'capability' => 'manage_options',
+			),
+			'reset_db'                            => array(
+				'func'       => '_reset_db',
+				'capability' => 'manage_options',
+				'noheader'   => true,
+				'args'       => array('nuke_old_ee4_data' => true),
+			),
+			'start_with_fresh_ee4_db'             => array(
+				'func'       => '_reset_db',
+				'capability' => 'manage_options',
+				'noheader'   => true,
+				'args'       => array('nuke_old_ee4_data' => false),
+			),
+			'delete_db'                           => array(
+				'func'       => '_delete_db',
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			),
+			'rerun_migration_from_ee3'            => array(
+				'func'       => '_rerun_migration_from_ee3',
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			),
+			'reset_capabilities'                  => array(
+				'func'       => '_reset_capabilities',
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			),
+			'reattempt_migration'                 => array(
+				'func'       => '_reattempt_migration',
+				'capability' => 'manage_options',
+				'noheader'   => true,
+			),
+		);
+	}
+
+
+
+	protected function _set_page_config()
+	{
+		$this->_page_config = array(
+			'default'       => array(
+				'nav'           => array(
+					'label' => __('Maintenance', 'event_espresso'),
+					'order' => 10,
+				),
+				'require_nonce' => false,
+			),
+			'data_reset'    => array(
+				'nav'           => array(
+					'label' => __('Reset/Delete Data', 'event_espresso'),
+					'order' => 20,
+				),
+				'require_nonce' => false,
+			),
+			'system_status' => array(
+				'nav'           => array(
+					'label' => __("System Information", "event_espresso"),
+					'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.
+	 */
+	public function _maintenance()
+	{
+		//it all depends 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
+			$mm = EE_Maintenance_Mode::instance()->level();
+			$placed_in_mm = EE_Maintenance_Mode::instance()->set_maintenance_mode_if_db_old();
+			if ($mm == EE_Maintenance_Mode::level_2_complete_maintenance && ! $placed_in_mm) {
+				//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(__('Site taken out of maintenance mode because no data migration scripts are required',
+					'event_espresso'));
+				$this->_process_notices(array('page' => 'espresso_maintenance_settings'), false);
+			}
+			//in case an exception is thrown while trying to handle migrations
+			switch (EE_Maintenance_Mode::instance()->level()) {
+				case EE_Maintenance_Mode::level_0_not_in_maintenance:
+				case EE_Maintenance_Mode::level_1_frontend_only_maintenance:
+					$show_maintenance_switch = true;
+					$show_backup_db_text = false;
+					$show_migration_progress = false;
+					$script_names = array();
+					$addons_should_be_upgraded_first = false;
+					break;
+				case EE_Maintenance_Mode::level_2_complete_maintenance:
+					$show_maintenance_switch = false;
+					$show_migration_progress = true;
+					if (isset($this->_req_data['continue_migration'])) {
+						$show_backup_db_text = false;
+					} else {
+						$show_backup_db_text = true;
+					}
+					$scripts_needing_to_run = EE_Data_Migration_Manager::instance()
+																	   ->check_for_applicable_data_migration_scripts();
+					$addons_should_be_upgraded_first = EE_Data_Migration_Manager::instance()->addons_need_updating();
+					$script_names = array();
+					$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();
+						}
+					}
+					break;
+			}
+			$most_recent_migration = EE_Data_Migration_Manager::instance()->get_last_ran_script(true);
+			$exception_thrown = false;
+		} catch (EE_Error $e) {
+			EE_Data_Migration_Manager::instance()->add_error_to_migrations_ran($e->getMessage());
+			//now, just so we can display the page correctly, make a 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 = EE_Data_Migration_Manager::instance()->ensure_current_database_state_is_set();
+		$current_db_state = str_replace('.decaf', '', $current_db_state);
+		if ($exception_thrown
+			|| ($most_recent_migration
+				&& $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'] = 'http://eventespresso.com/support/forums/';
+			$this->_template_args['next_url'] = EEH_URL::add_query_args_and_nonce(array('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
+				&& $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, array(
+					'current_db_state' => sprintf(__("EE%s (%s)", "event_espresso"),
+						isset($current_db_state[$plugin_slug]) ? $current_db_state[$plugin_slug] : 3, $plugin_slug),
+					'next_db_state'    => isset($current_script) ? sprintf(__("EE%s (%s)", 'event_espresso'),
+						$new_version, $plugin_slug) : null,
+				));
+			}
+			$this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_migration_page.template.php';
+			$this->_template_args = array_merge(
+				$this->_template_args,
+				array(
+					'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 backup 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(array('action' => 'reset_db'),
+						EE_MAINTENANCE_ADMIN_URL),
+					'update_migration_script_page_link'      => EE_Admin_Page::add_query_args_and_nonce(array('action' => 'change_maintenance_level'),
+						EE_MAINTENANCE_ADMIN_URL),
+					'ultimate_db_state'                      => sprintf(__("EE%s", 'event_espresso'),
+						espresso_version()),
+				)
+			);
+			//make sure we have the form fields helper available. It usually is, but sometimes it isn't
+			//localize script stuff
+			wp_localize_script('ee-maintenance', 'ee_maintenance', array(
+				'migrating'                        => __("Migrating...", "event_espresso"),
+				'next'                             => __("Next", "event_espresso"),
+				'fatal_error'                      => __("A Fatal Error Has Occurred", "event_espresso"),
+				'click_next_when_ready'            => __("The current Migration 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,
+			));
+		}
+		$this->_template_args['most_recent_migration'] = $most_recent_migration;//the actual most recently ran migration
+		$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)
+	 */
+	public function migration_step()
+	{
+		$this->_template_args['data'] = EE_Data_Migration_Manager::instance()->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
+	 */
+	public function add_error_to_migrations_ran()
+	{
+		EE_Data_Migration_Manager::instance()->add_error_to_migrations_ran($this->_req_data['message']);
+		$this->_template_args['data'] = array('ok' => true);
+		$this->_return_json();
+	}
+
+
+
+	/**
+	 * changes the maintenance level, provided there are still no migration scripts that shoudl run
+	 */
+	public function _change_maintenance_level()
+	{
+		$new_level = intval($this->_req_data['maintenance_mode_level']);
+		if ( ! EE_Data_Migration_Manager::instance()->check_for_applicable_data_migration_scripts()) {
+			EE_Maintenance_Mode::instance()->set_maintenance_level($new_level);
+			$success = true;
+		} else {
+			EE_Maintenance_Mode::instance()->set_maintenance_mode_if_db_old();
+			$success = false;
+		}
+		$this->_redirect_after_action($success, 'Maintenance Mode', __("Updated", "event_espresso"));
+	}
+
+
+
+	/**
+	 * a tab with options for resetting and/or deleting EE data
+	 *
+	 * @throws \EE_Error
+	 */
+	public function _data_reset_and_delete()
+	{
+		$this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_data_reset_and_delete.template.php';
+		$this->_template_args['reset_capabilities_button'] = $this->get_action_link_or_button(
+			'reset_capabilities',
+			'reset_capabilities',
+			array(),
+			'button button-primary',
+			'',
+			false
+		);
+		$this->_template_args['delete_db_url'] = EE_Admin_Page::add_query_args_and_nonce(
+			array('action' => 'delete_db'),
+			EE_MAINTENANCE_ADMIN_URL
+		);
+		$this->_template_args['reset_db_url'] = EE_Admin_Page::add_query_args_and_nonce(
+			array('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_sidebar();
+	}
+
+
+
+	protected function _reset_capabilities()
+	{
+		EE_Registry::instance()->CAP->init_caps(true);
+		EE_Error::add_success(__('Default Event Espresso capabilities have been restored for all current roles.',
+			'event_espresso'));
+		$this->_redirect_after_action(false, '', '', array('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)
+	 */
+	protected function _reattempt_migration()
+	{
+		EE_Data_Migration_Manager::instance()->reattempt();
+		$this->_redirect_after_action(false, '', '', array('action' => 'default'), true);
+	}
+
+
+
+	/**
+	 * shows the big ol' System Information page
+	 */
+	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['admin_page_content'] = EEH_Template::display_template($this->_template_path,
+			$this->_template_args, true);
+		$this->display_admin_page_with_sidebar();
+	}
+
+
+
+	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),
+				array(
+					"from:$from_name<$from>",
+					//					'content-type:text/html charset=UTF-8'
+				));
+		} catch (Exception $e) {
+			$success = false;
+		}
+		$this->_redirect_after_action($success, __("Migration Crash Report", "event_espresso"),
+			__("sent", "event_espresso"),
+			array('success' => $success, 'action' => 'confirm_migration_crash_report_sent'));
+	}
+
+
+
+	public function _confirm_migration_crash_report_sent()
+	{
+		try {
+			$most_recent_migration = EE_Data_Migration_Manager::instance()->get_last_ran_script(true);
+		} catch (EE_Error $e) {
+			EE_Data_Migration_Manager::instance()->add_error_to_migrations_ran($e->getMessage());
+			//now, just so we can display the page correctly, make a 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' ? true : false;
+		$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(array('action' => 'reset_db'),
+			EE_MAINTENANCE_ADMIN_URL);
+		$this->_template_args['reset_db_page_url'] = EE_Admin_Page::add_query_args_and_nonce(array('action' => 'data_reset'),
+			EE_MAINTENANCE_ADMIN_URL);
+		$this->_template_args['reattempt_action_url'] = EE_Admin_Page::add_query_args_and_nonce(array('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.
+	 * Currently basically only sets up ee4 database for a fresh install- doesn't
+	 * actually clean out the old wp options, or cpts (although does erase old ee table data)
+	 *
+	 * @param boolean $nuke_old_ee4_data controls whether or not we
+	 *                                   destroy the old ee4 data, or just try initializing ee4 default data
+	 */
+	public function _reset_db($nuke_old_ee4_data = true)
+	{
+		EE_Maintenance_Mode::instance()->set_maintenance_level(EE_Maintenance_Mode::level_0_not_in_maintenance);
+		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.
+	 */
+	public function _delete_db()
+	{
+		EE_Maintenance_Mode::instance()->set_maintenance_level(EE_Maintenance_Mode::level_0_not_in_maintenance);
+		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
+	 */
+	public function _rerun_migration_from_ee3()
+	{
+		EE_Maintenance_Mode::instance()->set_maintenance_level(EE_Maintenance_Mode::level_0_not_in_maintenance);
+		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');
+		EE_Maintenance_Mode::instance()->set_maintenance_level(EE_Maintenance_Mode::level_2_complete_maintenance);
+		$this->_redirect_after_action(true, __("Database", 'event_espresso'), __("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_init()
+	{
+	}
+
+
+
+	public function admin_notices()
+	{
+	}
+
 
 
-    public function admin_footer_scripts()
-    {
-    }
+	public function admin_footer_scripts()
+	{
+	}
 
 
 
-    public function load_scripts_styles()
-    {
-        wp_enqueue_script('ee_admin_js');
+	public function load_scripts_styles()
+	{
+		wp_enqueue_script('ee_admin_js');
 //		wp_enqueue_media();
 //		wp_enqueue_script('media-upload');
-        wp_enqueue_script('ee-maintenance', EE_MAINTENANCE_ASSETS_URL . '/ee-maintenance.js', array('jquery'),
-            EVENT_ESPRESSO_VERSION, true);
-        wp_register_style('espresso_maintenance', EE_MAINTENANCE_ASSETS_URL . 'ee-maintenance.css', array(),
-            EVENT_ESPRESSO_VERSION);
-        wp_enqueue_style('espresso_maintenance');
-    }
+		wp_enqueue_script('ee-maintenance', EE_MAINTENANCE_ASSETS_URL . '/ee-maintenance.js', array('jquery'),
+			EVENT_ESPRESSO_VERSION, true);
+		wp_register_style('espresso_maintenance', EE_MAINTENANCE_ASSETS_URL . 'ee-maintenance.css', array(),
+			EVENT_ESPRESSO_VERSION);
+		wp_enqueue_style('espresso_maintenance');
+	}
 
 
 
-    public function load_scripts_styles_default()
-    {
-        //styles
+	public function load_scripts_styles_default()
+	{
+		//styles
 //		wp_enqueue_style('ee-text-links');
 //		//scripts
 //		wp_enqueue_script('ee-text-links');
-    }
+	}
 
 
 

Spacing +10 added lines, -10 removed lines

@@ -233,13 +233,13 @@ 
                 && $most_recent_migration->is_broken()
             )
         ) {
-            $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_migration_was_borked_page.template.php';
+            $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH.'ee_migration_was_borked_page.template.php';
             $this->_template_args['support_url'] = 'http://eventespresso.com/support/forums/';
             $this->_template_args['next_url'] = EEH_URL::add_query_args_and_nonce(array('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';
+            $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH.'ee_upgrade_addons_before_migrating.template.php';
         } else {
             if ($most_recent_migration
                 && $most_recent_migration instanceof EE_Data_Migration_Script_Base
@@ -266,7 +266,7 @@ 
                         $new_version, $plugin_slug) : null,
                 ));
             }
-            $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_migration_page.template.php';
+            $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH.'ee_migration_page.template.php';
             $this->_template_args = array_merge(
                 $this->_template_args,
                 array(
@@ -303,7 +303,7 @@ 
                 'status_completed'                 => EE_Data_Migration_Manager::status_completed,
             ));
         }
-        $this->_template_args['most_recent_migration'] = $most_recent_migration;//the actual most recently ran migration
+        $this->_template_args['most_recent_migration'] = $most_recent_migration; //the actual most recently ran migration
         $this->_template_args['admin_page_content'] = EEH_Template::display_template($this->_template_path,
             $this->_template_args, true);
         $this->display_admin_page_with_sidebar();
@@ -360,7 +360,7 @@ 
      */
     public function _data_reset_and_delete()
     {
-        $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_data_reset_and_delete.template.php';
+        $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH.'ee_data_reset_and_delete.template.php';
         $this->_template_args['reset_capabilities_button'] = $this->get_action_link_or_button(
             'reset_capabilities',
             'reset_capabilities',
@@ -415,7 +415,7 @@ 
      */
     public function _system_status()
     {
-        $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_system_stati_page.template.php';
+        $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['admin_page_content'] = EEH_Template::display_template($this->_template_path,
             $this->_template_args, true);
@@ -432,7 +432,7 @@ 
         try {
             $success = wp_mail(EE_SUPPORT_EMAIL,
                 'Migration Crash Report',
-                $body . "/r/n<br>" . print_r(EEM_System_Status::instance()->get_system_stati(), true),
+                $body."/r/n<br>".print_r(EEM_System_Status::instance()->get_system_stati(), true),
                 array(
                     "from:$from_name<$from>",
                     //					'content-type:text/html charset=UTF-8'
@@ -467,7 +467,7 @@ 
             EE_MAINTENANCE_ADMIN_URL);
         $this->_template_args['reattempt_action_url'] = EE_Admin_Page::add_query_args_and_nonce(array('action' => 'reattempt_migration'),
             EE_MAINTENANCE_ADMIN_URL);
-        $this->_template_path = EE_MAINTENANCE_TEMPLATE_PATH . 'ee_confirm_migration_crash_report_sent.template.php';
+        $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();
@@ -568,9 +568,9 @@ 
         wp_enqueue_script('ee_admin_js');
 //		wp_enqueue_media();
 //		wp_enqueue_script('media-upload');
-        wp_enqueue_script('ee-maintenance', EE_MAINTENANCE_ASSETS_URL . '/ee-maintenance.js', array('jquery'),
+        wp_enqueue_script('ee-maintenance', EE_MAINTENANCE_ASSETS_URL.'/ee-maintenance.js', array('jquery'),
             EVENT_ESPRESSO_VERSION, true);
-        wp_register_style('espresso_maintenance', EE_MAINTENANCE_ASSETS_URL . 'ee-maintenance.css', array(),
+        wp_register_style('espresso_maintenance', EE_MAINTENANCE_ASSETS_URL.'ee-maintenance.css', array(),
             EVENT_ESPRESSO_VERSION);
         wp_enqueue_style('espresso_maintenance');
     }