Actions

API16

Difference between revisions of "JForm/validate"

From Joomla! Documentation

< API16:JForm
(New page: ===Description=== Method to validate form data. <span class="editsection" style="font-size:76%;"> <nowiki>[</nowiki>Edit Descripton<nowiki>]</nowiki> <...)
 
m (removing red link to edit, no existant pages)
 
Line 3: Line 3:
  
 
<span class="editsection" style="font-size:76%;">
 
<span class="editsection" style="font-size:76%;">
<nowiki>[</nowiki>[[Description:JForm/validate|Edit Descripton]]<nowiki>]</nowiki>
+
<nowiki>[<! removed edit link to red link >]</nowiki>
 
</span>
 
</span>
  
{{Description:JForm/validate}}
+
<! removed transcluded page call, red link never existed >
  
 
===Syntax===
 
===Syntax===
Line 86: Line 86:
  
 
<span class="editsection" style="font-size:76%;">
 
<span class="editsection" style="font-size:76%;">
<nowiki>[</nowiki>[[SeeAlso:JForm/validate|Edit See Also]]<nowiki>]</nowiki>
+
<nowiki>[<! removed edit link to red link >]</nowiki>
 
</span>
 
</span>
{{SeeAlso:JForm/validate}}
+
<! removed transcluded page call, red link never existed >
  
 
===Examples===
 
===Examples===
Line 101: Line 101:
 
  format= ,,,
 
  format= ,,,
 
</dpl>
 
</dpl>
 +
[[Category:Archived pages API16]]

Latest revision as of 21:53, 13 May 2013

Replacement filing cabinet.png
This Namespace has been archived - Please Do Not Edit or Create Pages in this namespace. Pages contain information for a Joomla! version which is no longer supported. It exists only as a historical reference, will not be improved and its content may be incomplete.

Contents

Description

Method to validate form data.

[<! removed edit link to red link >]

<! removed transcluded page call, red link never existed >

Syntax

validate($data, $limit=null)
Parameter Name Default Value Description
$data $data An array of field values to validate.
$limit null $limit An option group to limit the validation to.

Returns

mixed Boolean on success, on error.

Defined in

libraries/joomla/form/form.php

Importing

jimport( 'joomla.form.form' );

Source Body

public function validate($data, $limit = null)
{
        $return = true;
        $data   = (array)$data;
 
        // Check if the group exists.
        if ($limit !== null && !isset($this->_groups[$limit])) {
                // The group that was supposed to be filtered does not exist.
                return new JException(JText::sprintf('LIBRARIES FORM VALIDATOR GROUP NOT FOUND', $limit), 0, E_ERROR);
        }
 
        // Get a validator object.
        jimport('joomla.form.formvalidator');
        $validator = new JFormValidator();
 
        // Iterate through the groups.
        foreach ($this->_groups as $group => $fields) {
                // Filter if no group is specified or if the group matches the current group.
                if ($limit === null || ($limit !== null && $group === $limit)) {
                        // If the group name matches the name of a group in the data and the value is not scalar, pass the group.
                        if (isset($data[$group]) && !is_scalar($data[$group]) && !is_resource($data[$group])) {
                                $results = $validator->validate($this->_groups[$group], $data[$group]);
                        } else {
                                // Run the validator over the group.
                                $results = $validator->validate($this->_groups[$group], $data);
                        }
 
                        // Check for a error.
                        if (JError::isError($results)) {
                                return new JException($results->getMessage(), 0, E_ERROR);
                        }
 
                        // Check the validation results.
                        if (count($results)) {
                                // Get the validation messages.
                                foreach ($results as $result) {
                                        if (JError::isError($result) && $result->get('level') === E_WARNING) {
                                                $this->setError($result);
                                                $return = false;
                                        }
                                }
                        }
                }
        }
 
        return $return;
}

[<! removed edit link to red link >] <! removed transcluded page call, red link never existed >

Examples

<CodeExamplesForm />