eventespresso / event-espresso-core

	 */

	public function calculate_total_payments_and_update_status( EE_Transaction $transaction, $update_txn = true ){

		// verify transaction

		if ( ! $transaction instanceof EE_Transaction ) {

			EE_Error::add_error( __( 'Please provide a valid EE_Transaction object.', 'event_espresso' ), __FILE__, __FUNCTION__, __LINE__ );

			return false;

		}

		// calculate total paid

		$total_paid = $this->recalculate_total_payments_for_transaction( $transaction );

		// if total paid has changed

	 */

	public function recalculate_total_payments_for_transaction( EE_Transaction $transaction, $payment_status = EEM_Payment::status_id_approved ) {

		// verify transaction

		if ( ! $transaction instanceof EE_Transaction ) {

			EE_Error::add_error( __( 'Please provide a valid EE_Transaction object.', 'event_espresso' ), __FILE__, __FUNCTION__, __LINE__ );

			return false;

		}

		// ensure Payment model is loaded

		EE_Registry::instance()->load_model( 'Payment' );

		// calls EEM_Base::sum()

			'5.0.0'

		);

		// verify transaction

		if ( ! $transaction instanceof EE_Transaction) {

			EE_Error::add_error(

				__('Please provide a valid EE_Transaction object.', 'event_espresso'),

				__FILE__, __FUNCTION__, __LINE__

			);

			return false;

		}

		// set transaction status based on comparison of TXN_paid vs TXN_total

		return $transaction->update_status_based_on_total_paid($update_txn);

	}

	 */

	public function recalculate_transaction_total( EE_Transaction $transaction, $update_txn = true ) {

		$total_line_item = $transaction->total_line_item();

		if ( ! $total_line_item instanceof EE_Line_Item ) {

			EE_Error::add_error(

				sprintf( __( 'The Total Line Item for Transaction %1$d\'s was not found or is invalid.', 'event_espresso' ), $transaction->ID() ),

				__FILE__, __FUNCTION__, __LINE__

			);

			return false;

		}

		$new_total = $total_line_item->recalculate_total_including_taxes();

		$transaction->set_total( $new_total );

		if ( $update_txn ) {

    public function get_DateTime_object($field_name)

    {

        $field_settings = $this->get_model()->field_settings_for($field_name);

        if ( ! $field_settings instanceof EE_Datetime_Field) {

            EE_Error::add_error(

                sprintf(

                    __(

                        'The field %s is not an EE_Datetime_Field field.  There is no DateTime object stored on this field type.',

                        'event_espresso'

                    ),

                    $field_name

                ),

                __FILE__,

                __FUNCTION__,

                __LINE__

            );

            return false;

        }

        return $this->_fields[$field_name];

    }

        // instantiate module class

        $module = new $module_name();

        // ensure that class is actually a module

        if (! $module instanceof EED_Module) {

            EE_Error::add_error(

                sprintf(__('The requested %s module is not of the class EED_Module.', 'event_espresso'), $module_name),

                __FILE__, __FUNCTION__, __LINE__

            );

            return null;

        }

        return $module;

    }

     */

    public static function module_factory($module_name)

    {

        if ($module_name === 'EED_Module') {

            EE_Error::add_error(

                sprintf(

                    __(

                        'EED_Module is an abstract parent class an can not be instantiated. Please provide a proper module name.',

                        'event_espresso'

                    ), $module_name

                ), __FILE__, __FUNCTION__, __LINE__

            );

            return null;

        }

        // instantiate module class

        $module = new $module_name();

        // ensure that class is actually a module

     */

    protected function _save_billing_info_to_attendee($billing_form, $transaction)

    {

        if (!$transaction || !$transaction instanceof EE_Transaction) {

            EE_Error::add_error(__("Cannot save billing info because no transaction was specified", "event_espresso"), __FILE__, __FUNCTION__, __LINE__);

            return false;

        }

        $primary_reg = $transaction->primary_registration();

        if (!$primary_reg) {

            EE_Error::add_error(__("Cannot save billing info because the transaction has no primary registration", "event_espresso"), __FILE__, __FUNCTION__, __LINE__);