eventespresso / event-espresso-core

core/libraries/form_sections/strategies/validation/EE_Model_Matching_Query_Validation_Strategy.strategy.php

Spacing +3 added lines, -3 removed lines

@@ -32,7 +32,7 @@ 
      */
     public function __construct($validation_error_message = null, $model_name = '', $query_params = array(), $input_field_name = '')
     {
-        if (! EE_Registry::instance()->is_model_name($model_name)) {
+        if ( ! EE_Registry::instance()->is_model_name($model_name)) {
             throw new EE_Error(sprintf(__('You must provide a valid model object ', 'event_espresso'), $model_name));
         }
         $this->_model = EE_Registry::instance()->load_model($model_name);
@@ -58,8 +58,8 @@ 
             return true;
         }
         $combined_query_params = $this->get_query_params();
-        $combined_query_params[0][ $this->treat_input_as_field() ] = $normalized_value;
-        if (! $this->get_model()->exists($combined_query_params)) {
+        $combined_query_params[0][$this->treat_input_as_field()] = $normalized_value;
+        if ( ! $this->get_model()->exists($combined_query_params)) {
             throw new EE_Validation_Error($this->get_validation_error_message(), 'no_matching_model_object');
         }
     }

Indentation +71 added lines, -71 removed lines

@@ -13,86 +13,86 @@
 class EE_Model_Matching_Query_Validation_Strategy extends EE_Validation_Strategy_Base
 {
 
-    /**
-     *
-     * @var EEM_Base
-     */
-    protected $_model;
-    protected $_query_params;
-    protected $_input_field_name;
+	/**
+	 *
+	 * @var EEM_Base
+	 */
+	protected $_model;
+	protected $_query_params;
+	protected $_input_field_name;
 
 
 
-    /**
-     * @param string $validation_error_message
-     * @param string $model_name  name of an EEM_Base model
-     * @param array  $query_params     @see https://github.com/eventespresso/event-espresso-core/tree/master/docs/G--Model-System/model-query-params.md
-     * @param string $input_field_name the input will be treated as this field's value
-     * @throws \EE_Error
-     */
-    public function __construct($validation_error_message = null, $model_name = '', $query_params = array(), $input_field_name = '')
-    {
-        if (! EE_Registry::instance()->is_model_name($model_name)) {
-            throw new EE_Error(sprintf(__('You must provide a valid model object ', 'event_espresso'), $model_name));
-        }
-        $this->_model = EE_Registry::instance()->load_model($model_name);
-        $this->_query_params = $query_params;
-        if (empty($input_field_name)) {
-            $input_field_name = $this->_model->primary_key_name();
-        }
-        $this->_input_field_name = $input_field_name;
-        parent::__construct($validation_error_message);
-    }
+	/**
+	 * @param string $validation_error_message
+	 * @param string $model_name  name of an EEM_Base model
+	 * @param array  $query_params     @see https://github.com/eventespresso/event-espresso-core/tree/master/docs/G--Model-System/model-query-params.md
+	 * @param string $input_field_name the input will be treated as this field's value
+	 * @throws \EE_Error
+	 */
+	public function __construct($validation_error_message = null, $model_name = '', $query_params = array(), $input_field_name = '')
+	{
+		if (! EE_Registry::instance()->is_model_name($model_name)) {
+			throw new EE_Error(sprintf(__('You must provide a valid model object ', 'event_espresso'), $model_name));
+		}
+		$this->_model = EE_Registry::instance()->load_model($model_name);
+		$this->_query_params = $query_params;
+		if (empty($input_field_name)) {
+			$input_field_name = $this->_model->primary_key_name();
+		}
+		$this->_input_field_name = $input_field_name;
+		parent::__construct($validation_error_message);
+	}
 
 
 
-    /**
-     * @param $normalized_value
-     * @return bool|void
-     * @throws \EE_Error
-     * @throws \EE_Validation_Error
-     */
-    public function validate($normalized_value)
-    {
-        if (empty($normalized_value)) {
-            return true;
-        }
-        $combined_query_params = $this->get_query_params();
-        $combined_query_params[0][ $this->treat_input_as_field() ] = $normalized_value;
-        if (! $this->get_model()->exists($combined_query_params)) {
-            throw new EE_Validation_Error($this->get_validation_error_message(), 'no_matching_model_object');
-        }
-    }
+	/**
+	 * @param $normalized_value
+	 * @return bool|void
+	 * @throws \EE_Error
+	 * @throws \EE_Validation_Error
+	 */
+	public function validate($normalized_value)
+	{
+		if (empty($normalized_value)) {
+			return true;
+		}
+		$combined_query_params = $this->get_query_params();
+		$combined_query_params[0][ $this->treat_input_as_field() ] = $normalized_value;
+		if (! $this->get_model()->exists($combined_query_params)) {
+			throw new EE_Validation_Error($this->get_validation_error_message(), 'no_matching_model_object');
+		}
+	}
 
-    /**
-     * Gets the model used for querying
-     * @return EEM_Base
-     */
-    public function get_model()
-    {
-        return $this->_model;
-    }
+	/**
+	 * Gets the model used for querying
+	 * @return EEM_Base
+	 */
+	public function get_model()
+	{
+		return $this->_model;
+	}
 
-    /**
-     * Returns query params used for model query
-     * @return array
-     */
-    public function get_query_params()
-    {
-        return (array) $this->_query_params;
-    }
+	/**
+	 * Returns query params used for model query
+	 * @return array
+	 */
+	public function get_query_params()
+	{
+		return (array) $this->_query_params;
+	}
 
-    /**
-     * Gets the name of the field that will be used for lookup.
-     * eg it could be "EVT_name", meaning that if there is a model object in
-     * the database that has that event name, and matching the other query parameters
-     * on this strategy, the input will pass validation server-side
-     * @return string
-     */
-    public function treat_input_as_field()
-    {
-        return $this->_input_field_name;
-    }
+	/**
+	 * Gets the name of the field that will be used for lookup.
+	 * eg it could be "EVT_name", meaning that if there is a model object in
+	 * the database that has that event name, and matching the other query parameters
+	 * on this strategy, the input will pass validation server-side
+	 * @return string
+	 */
+	public function treat_input_as_field()
+	{
+		return $this->_input_field_name;
+	}
 }
 
 // End of file EE_FUll_HTML_Validation_Strategy.strategy.php

core/libraries/form_sections/strategies/validation/EE_Many_Valued_Validation_Strategy.strategy.php

Indentation +48 added lines, -48 removed lines

@@ -13,58 +13,58 @@
  */
 class EE_Many_Valued_Validation_Strategy extends EE_Validation_Strategy_Base
 {
-    protected $_individual_item_validation_strategies = array();
-    /**
-     *
-     * @param EE_Validation_Strategy_Base[] $individual_item_validation_strategies (or a single EE_Validation_Strategy_Base)
-     */
-    public function __construct($individual_item_validation_strategies)
-    {
-        if (! is_array($individual_item_validation_strategies)) {
-            $individual_item_validation_strategies = array($individual_item_validation_strategies);
-        }
-        $this->_individual_item_validation_strategies = $individual_item_validation_strategies;
-        parent::__construct();
-    }
+	protected $_individual_item_validation_strategies = array();
+	/**
+	 *
+	 * @param EE_Validation_Strategy_Base[] $individual_item_validation_strategies (or a single EE_Validation_Strategy_Base)
+	 */
+	public function __construct($individual_item_validation_strategies)
+	{
+		if (! is_array($individual_item_validation_strategies)) {
+			$individual_item_validation_strategies = array($individual_item_validation_strategies);
+		}
+		$this->_individual_item_validation_strategies = $individual_item_validation_strategies;
+		parent::__construct();
+	}
 
 
 
-    /**
-     * Applies all teh individual item validation strategies on each item in the array
-     * @param array $normalized_value
-     * @return boolean
-     */
-    public function validate($normalized_value)
-    {
-        if (is_array($normalized_value)) {
-            $items_to_validate = $normalized_value;
-        } else {
-            $items_to_validate = array($normalized_value);
-        }
-        foreach ($items_to_validate as $individual_item) {
-            foreach ($this->_individual_item_validation_strategies as $validation_strategy) {
-                if ($validation_strategy instanceof EE_Validation_Strategy_Base) {
-                    $validation_strategy->validate($individual_item);
-                }
-            }
-        }
-        return true;
-    }
+	/**
+	 * Applies all teh individual item validation strategies on each item in the array
+	 * @param array $normalized_value
+	 * @return boolean
+	 */
+	public function validate($normalized_value)
+	{
+		if (is_array($normalized_value)) {
+			$items_to_validate = $normalized_value;
+		} else {
+			$items_to_validate = array($normalized_value);
+		}
+		foreach ($items_to_validate as $individual_item) {
+			foreach ($this->_individual_item_validation_strategies as $validation_strategy) {
+				if ($validation_strategy instanceof EE_Validation_Strategy_Base) {
+					$validation_strategy->validate($individual_item);
+				}
+			}
+		}
+		return true;
+	}
 
 
 
-    /**
-     * Extends parent's _construct_finalize so we ALSO set the input
-     * on each sub-validation-strategy
-     * @param \EE_Form_Input_Base $form_input
-     */
-    public function _construct_finalize(\EE_Form_Input_Base $form_input)
-    {
-        parent::_construct_finalize($form_input);
-        foreach ($this->_individual_item_validation_strategies as $item_validation_strategy) {
-            if ($item_validation_strategy instanceof EE_Validation_Strategy_Base) {
-                $item_validation_strategy->_construct_finalize($form_input);
-            }
-        }
-    }
+	/**
+	 * Extends parent's _construct_finalize so we ALSO set the input
+	 * on each sub-validation-strategy
+	 * @param \EE_Form_Input_Base $form_input
+	 */
+	public function _construct_finalize(\EE_Form_Input_Base $form_input)
+	{
+		parent::_construct_finalize($form_input);
+		foreach ($this->_individual_item_validation_strategies as $item_validation_strategy) {
+			if ($item_validation_strategy instanceof EE_Validation_Strategy_Base) {
+				$item_validation_strategy->_construct_finalize($form_input);
+			}
+		}
+	}
 }

Spacing +1 added lines, -1 removed lines

@@ -20,7 +20,7 @@
      */
     public function __construct($individual_item_validation_strategies)
     {
-        if (! is_array($individual_item_validation_strategies)) {
+        if ( ! is_array($individual_item_validation_strategies)) {
             $individual_item_validation_strategies = array($individual_item_validation_strategies);
         }
         $this->_individual_item_validation_strategies = $individual_item_validation_strategies;

core/libraries/form_sections/strategies/validation/EE_Enum_Validation_Strategy.strategy.php

Indentation +46 added lines, -46 removed lines

@@ -11,51 +11,51 @@
 class EE_Enum_Validation_Strategy extends EE_Validation_Strategy_Base
 {
 
-    /**
-     * Check that the value is in the allowed list
-     * @param $normalized_value
-     * @throws EE_Error
-     * @throws EE_Validation_Error
-     * @return boolean
-     */
-    public function validate($normalized_value)
-    {
-        parent::validate($normalized_value);
-        if (! $this->_input instanceof EE_Form_Input_With_Options_Base) {
-            throw new EE_Error(sprintf(__("Cannot use Enum Validation Strategy with an input that doesn't have options", "event_espresso")));
-        }
-        $enum_options = $this->_input->flat_options();
-        if ($normalized_value === true) {
-            $normalized_value = 1;
-        } elseif ($normalized_value === false) {
-            $normalized_value = 0;
-        }
-        if ($normalized_value !== null && ! array_key_exists($normalized_value, $enum_options)) {
-            throw new EE_Validation_Error(
-                $this->get_validation_error_message(),
-                'invalid_enum_value'
-            );
-        } else {
-            return true;
-        }
-    }
+	/**
+	 * Check that the value is in the allowed list
+	 * @param $normalized_value
+	 * @throws EE_Error
+	 * @throws EE_Validation_Error
+	 * @return boolean
+	 */
+	public function validate($normalized_value)
+	{
+		parent::validate($normalized_value);
+		if (! $this->_input instanceof EE_Form_Input_With_Options_Base) {
+			throw new EE_Error(sprintf(__("Cannot use Enum Validation Strategy with an input that doesn't have options", "event_espresso")));
+		}
+		$enum_options = $this->_input->flat_options();
+		if ($normalized_value === true) {
+			$normalized_value = 1;
+		} elseif ($normalized_value === false) {
+			$normalized_value = 0;
+		}
+		if ($normalized_value !== null && ! array_key_exists($normalized_value, $enum_options)) {
+			throw new EE_Validation_Error(
+				$this->get_validation_error_message(),
+				'invalid_enum_value'
+			);
+		} else {
+			return true;
+		}
+	}
 
-    /**
-     * If we are using the default validation error message, make it dynamic based
-     * on the allowed options.
-     * @return string
-     */
-    public function get_validation_error_message()
-    {
-        $parent_validation_error_message = parent::get_validation_error_message();
-        if (! $parent_validation_error_message) {
-            $enum_options = $this->_input instanceof EE_Form_Input_With_Options_Base ? $this->_input->flat_options() : '';
-            return sprintf(
-                __("This is not allowed option. Allowed options are %s.", "event_espresso"),
-                implode(', ', $enum_options)
-            );
-        } else {
-            return $parent_validation_error_message;
-        }
-    }
+	/**
+	 * If we are using the default validation error message, make it dynamic based
+	 * on the allowed options.
+	 * @return string
+	 */
+	public function get_validation_error_message()
+	{
+		$parent_validation_error_message = parent::get_validation_error_message();
+		if (! $parent_validation_error_message) {
+			$enum_options = $this->_input instanceof EE_Form_Input_With_Options_Base ? $this->_input->flat_options() : '';
+			return sprintf(
+				__("This is not allowed option. Allowed options are %s.", "event_espresso"),
+				implode(', ', $enum_options)
+			);
+		} else {
+			return $parent_validation_error_message;
+		}
+	}
 }

Spacing +2 added lines, -2 removed lines

@@ -21,7 +21,7 @@ 
     public function validate($normalized_value)
     {
         parent::validate($normalized_value);
-        if (! $this->_input instanceof EE_Form_Input_With_Options_Base) {
+        if ( ! $this->_input instanceof EE_Form_Input_With_Options_Base) {
             throw new EE_Error(sprintf(__("Cannot use Enum Validation Strategy with an input that doesn't have options", "event_espresso")));
         }
         $enum_options = $this->_input->flat_options();
@@ -48,7 +48,7 @@ 
     public function get_validation_error_message()
     {
         $parent_validation_error_message = parent::get_validation_error_message();
-        if (! $parent_validation_error_message) {
+        if ( ! $parent_validation_error_message) {
             $enum_options = $this->_input instanceof EE_Form_Input_With_Options_Base ? $this->_input->flat_options() : '';
             return sprintf(
                 __("This is not allowed option. Allowed options are %s.", "event_espresso"),

core/libraries/form_sections/strategies/sensitive_data_removal/EE_Sensitive_Data_Removal_Base.strategy.php

Indentation +12 added lines, -12 removed lines

@@ -11,16 +11,16 @@
  */
 abstract class EE_Sensitive_Data_Removal_Base extends EE_Form_Input_Strategy_Base
 {
-    /**
-     * Removes all the sensitive data from this normalized value.
-     * For example, should could 'mask' a credit card from
-     * '1234 1234 1234 1234' TO '**** **** **** 1234'.
-     * Or turn a ccv number from
-     * '123' to '***',
-     * or turn a password from
-     * 'CantHac7Th15' to '*************',
-     * or just leave htevalue as-is
-     * @return mixed
-     */
-    abstract public function remove_sensitive_data($normalized_value);
+	/**
+	 * Removes all the sensitive data from this normalized value.
+	 * For example, should could 'mask' a credit card from
+	 * '1234 1234 1234 1234' TO '**** **** **** 1234'.
+	 * Or turn a ccv number from
+	 * '123' to '***',
+	 * or turn a password from
+	 * 'CantHac7Th15' to '*************',
+	 * or just leave htevalue as-is
+	 * @return mixed
+	 */
+	abstract public function remove_sensitive_data($normalized_value);
 }

core/libraries/form_sections/strategies/sensitive_data_removal/EE_All_Sensitive_Data_Removal.strategy.php

Indentation +19 added lines, -19 removed lines

@@ -11,23 +11,23 @@
  */
 class EE_All_Sensitive_Data_Removal extends EE_Sensitive_Data_Removal_Base
 {
-    public function remove_sensitive_data($normalized_value)
-    {
-        switch (gettype($normalized_value)) {
-            case "boolean":
-                return false;
-            case "integer":
-            case "double":
-                return 0;
-            case "string":
-                return '';
-            case "array":
-                return array();
-            case "object":
-            case "resource":
-            case "NULL":
-            default:
-                return null;
-        }
-    }
+	public function remove_sensitive_data($normalized_value)
+	{
+		switch (gettype($normalized_value)) {
+			case "boolean":
+				return false;
+			case "integer":
+			case "double":
+				return 0;
+			case "string":
+				return '';
+			case "array":
+				return array();
+			case "object":
+			case "resource":
+			case "NULL":
+			default:
+				return null;
+		}
+	}
 }

core/libraries/form_sections/strategies/sensitive_data_removal/EE_No_Sensitive_Data_Removal.strategy.php

Indentation +4 added lines, -4 removed lines

@@ -11,8 +11,8 @@
  */
 class EE_No_Sensitive_Data_Removal extends EE_Sensitive_Data_Removal_Base
 {
-    public function remove_sensitive_data($normalized_value)
-    {
-        return $normalized_value;
-    }
+	public function remove_sensitive_data($normalized_value)
+	{
+		return $normalized_value;
+	}
 }

core/libraries/form_sections/base/EE_Form_Section_HTML.form.php

Indentation +18 added lines, -18 removed lines

@@ -14,30 +14,30 @@
 class EE_Form_Section_HTML extends EE_Form_Section_Base
 {
 
-    protected $_html = '';
+	protected $_html = '';
 
 
 
-    /**
-     * @param string $html
-     * @param array $options_array
-     */
-    public function __construct($html = '', $options_array = array())
-    {
-        $this->_html = $html;
-        parent::__construct($options_array);
-    }
+	/**
+	 * @param string $html
+	 * @param array $options_array
+	 */
+	public function __construct($html = '', $options_array = array())
+	{
+		$this->_html = $html;
+		parent::__construct($options_array);
+	}
 
 
 
-    /**
-     * Returns the HTML
-     * @return string
-     */
-    public function get_html()
-    {
-        return $this->_html;
-    }
+	/**
+	 * Returns the HTML
+	 * @return string
+	 */
+	public function get_html()
+	{
+		return $this->_html;
+	}
 }
 
 // End of file EE_Form_Section_HTML.form.php

core/libraries/form_sections/base/EE_Form_Section_HTML_From_Template.form.php

Indentation +5 added lines, -5 removed lines

@@ -11,11 +11,11 @@
  */
 class EE_Form_Section_HTML_From_Template extends EE_Form_Section_HTML
 {
-    public function __construct($template_file, $args = array(), $options_array = array())
-    {
-        $html = EEH_Template::locate_template($template_file, $args);
+	public function __construct($template_file, $args = array(), $options_array = array())
+	{
+		$html = EEH_Template::locate_template($template_file, $args);
 
 //      echo " filepath:$template_file html $html";
-        parent::__construct($html, $options_array);
-    }
+		parent::__construct($html, $options_array);
+	}
 }

core/libraries/form_sections/base/EE_Form_Section_Validatable.form.php

Indentation +146 added lines, -146 removed lines

@@ -21,150 +21,150 @@
 abstract class EE_Form_Section_Validatable extends EE_Form_Section_Base
 {
 
-    /**
-     * Array of validation errors in this section. Does not contain validation errors in subsections, however.
-     * Those are stored individually on each subsection.
-     *
-     * @var EE_Validation_Error[]
-     */
-    protected $_validation_errors = array();
-
-
-
-    /**
-     * Errors on this form section. Note: EE_Form_Section_Proper
-     * has another function for getting all errors in this form section and subsections
-     * called get_validation_errors_accumulated
-     *
-     * @return EE_Validation_Error[]
-     */
-    public function get_validation_errors()
-    {
-        return $this->_validation_errors;
-    }
-
-
-
-    /**
-     * returns a comma-separated list of all the validation errors in it.
-     * If we want this to be customizable, we may decide to create a strategy for displaying it
-     *
-     * @return string
-     */
-    public function get_validation_error_string()
-    {
-        $validation_error_messages = array();
-        if ($this->get_validation_errors()) {
-            foreach ($this->get_validation_errors() as $validation_error) {
-                if ($validation_error instanceof EE_Validation_Error) {
-                    $validation_error_messages[] = $validation_error->getMessage();
-                }
-            }
-        }
-        return implode(", ", $validation_error_messages);
-    }
-
-
-
-    /**
-     * Performs validation on this form section (and subsections). Should be called after _normalize()
-     *
-     * @return boolean of whether or not the form section is valid
-     */
-    abstract protected function _validate();
-
-
-
-    /**
-     * Checks if this field has any validation errors
-     *
-     * @return boolean
-     */
-    public function is_valid()
-    {
-        if (count($this->_validation_errors)) {
-            return false;
-        } else {
-            return true;
-        }
-    }
-
-
-
-    /**
-     * Sanitizes input for this form section
-     *
-     * @param array $req_data is the full request data like $_POST
-     * @return boolean of whether a normalization error occurred
-     */
-    abstract protected function _normalize($req_data);
-
-
-
-    /**
-     * Creates a validation error from the arguments provided, and adds it to the form section's list.
-     * If such an EE_Validation_Error object is passed in as the first arg, simply sets this as its form section, and
-     * adds it to the list of validation errors of errors
-     *
-     * @param mixed     $message_or_object  internationalized string describing the validation error; or it could be a
-     *                                      proper EE_Validation_Error object
-     * @param string    $error_code         a short key which can be used to uniquely identify the error
-     * @param Exception $previous_exception if there was an exception that caused the error, that exception
-     * @return void
-     */
-    public function add_validation_error($message_or_object, $error_code = null, $previous_exception = null)
-    {
-        if ($message_or_object instanceof EE_Validation_Error) {
-            $validation_error = $message_or_object;
-            $validation_error->set_form_section($this);
-        } else {
-            $validation_error = new EE_Validation_Error($message_or_object, $error_code, $this, $previous_exception);
-        }
-        $this->_validation_errors[] = $validation_error;
-    }
-
-
-
-    /**
-     * When generating the JS for the jquery validation rules like<br>
-     * <code>$( "#myform" ).validate({
-     * rules: {
-     * password: "required",
-     * password_again: {
-     * equalTo: "#password"
-     * }
-     * }
-     * });</code>
-     * gets the sections like
-     * <br><code>password: "required",
-     * password_again: {
-     * equalTo: "#password"
-     * }</code>
-     * except we leave it as a PHP object, and leave wp_localize_script to
-     * turn it into a JSON object which can be used by the js
-     *
-     * @return array
-     */
-    abstract public function get_jquery_validation_rules();
-
-
-
-    /**
-     * Checks if this form section's data is present in the req data specified
-     *
-     * @param array $req_data usually $_POST, if null that's what's used
-     * @return boolean
-     */
-    abstract public function form_data_present_in($req_data = null);
-
-
-
-    /**
-     * Removes teh sensitive data from this form section (usually done after
-     * utilizing the data business function, but before saving it somewhere. Eg,
-     * may remove a password from the form after verifying it was correct)
-     *
-     * @return void
-     */
-    abstract public function clean_sensitive_data();
+	/**
+	 * Array of validation errors in this section. Does not contain validation errors in subsections, however.
+	 * Those are stored individually on each subsection.
+	 *
+	 * @var EE_Validation_Error[]
+	 */
+	protected $_validation_errors = array();
+
+
+
+	/**
+	 * Errors on this form section. Note: EE_Form_Section_Proper
+	 * has another function for getting all errors in this form section and subsections
+	 * called get_validation_errors_accumulated
+	 *
+	 * @return EE_Validation_Error[]
+	 */
+	public function get_validation_errors()
+	{
+		return $this->_validation_errors;
+	}
+
+
+
+	/**
+	 * returns a comma-separated list of all the validation errors in it.
+	 * If we want this to be customizable, we may decide to create a strategy for displaying it
+	 *
+	 * @return string
+	 */
+	public function get_validation_error_string()
+	{
+		$validation_error_messages = array();
+		if ($this->get_validation_errors()) {
+			foreach ($this->get_validation_errors() as $validation_error) {
+				if ($validation_error instanceof EE_Validation_Error) {
+					$validation_error_messages[] = $validation_error->getMessage();
+				}
+			}
+		}
+		return implode(", ", $validation_error_messages);
+	}
+
+
+
+	/**
+	 * Performs validation on this form section (and subsections). Should be called after _normalize()
+	 *
+	 * @return boolean of whether or not the form section is valid
+	 */
+	abstract protected function _validate();
+
+
+
+	/**
+	 * Checks if this field has any validation errors
+	 *
+	 * @return boolean
+	 */
+	public function is_valid()
+	{
+		if (count($this->_validation_errors)) {
+			return false;
+		} else {
+			return true;
+		}
+	}
+
+
+
+	/**
+	 * Sanitizes input for this form section
+	 *
+	 * @param array $req_data is the full request data like $_POST
+	 * @return boolean of whether a normalization error occurred
+	 */
+	abstract protected function _normalize($req_data);
+
+
+
+	/**
+	 * Creates a validation error from the arguments provided, and adds it to the form section's list.
+	 * If such an EE_Validation_Error object is passed in as the first arg, simply sets this as its form section, and
+	 * adds it to the list of validation errors of errors
+	 *
+	 * @param mixed     $message_or_object  internationalized string describing the validation error; or it could be a
+	 *                                      proper EE_Validation_Error object
+	 * @param string    $error_code         a short key which can be used to uniquely identify the error
+	 * @param Exception $previous_exception if there was an exception that caused the error, that exception
+	 * @return void
+	 */
+	public function add_validation_error($message_or_object, $error_code = null, $previous_exception = null)
+	{
+		if ($message_or_object instanceof EE_Validation_Error) {
+			$validation_error = $message_or_object;
+			$validation_error->set_form_section($this);
+		} else {
+			$validation_error = new EE_Validation_Error($message_or_object, $error_code, $this, $previous_exception);
+		}
+		$this->_validation_errors[] = $validation_error;
+	}
+
+
+
+	/**
+	 * When generating the JS for the jquery validation rules like<br>
+	 * <code>$( "#myform" ).validate({
+	 * rules: {
+	 * password: "required",
+	 * password_again: {
+	 * equalTo: "#password"
+	 * }
+	 * }
+	 * });</code>
+	 * gets the sections like
+	 * <br><code>password: "required",
+	 * password_again: {
+	 * equalTo: "#password"
+	 * }</code>
+	 * except we leave it as a PHP object, and leave wp_localize_script to
+	 * turn it into a JSON object which can be used by the js
+	 *
+	 * @return array
+	 */
+	abstract public function get_jquery_validation_rules();
+
+
+
+	/**
+	 * Checks if this form section's data is present in the req data specified
+	 *
+	 * @param array $req_data usually $_POST, if null that's what's used
+	 * @return boolean
+	 */
+	abstract public function form_data_present_in($req_data = null);
+
+
+
+	/**
+	 * Removes teh sensitive data from this form section (usually done after
+	 * utilizing the data business function, but before saving it somewhere. Eg,
+	 * may remove a password from the form after verifying it was correct)
+	 *
+	 * @return void
+	 */
+	abstract public function clean_sensitive_data();
 }