API16:JFormRuleEmail/test - Revision history

JoomlaWikiBot: preparing for archive only

2017-03-25T01:43:46Z

preparing for archive only

← Older revision		Revision as of 01:43, 25 March 2017
Line 94:		Line 94:

	===Examples===		===Examples===
	~~<CodeExamplesForm />~~		=== Code Examples ===
	<dpl>		<dpl>
	noresultsheader=\n		noresultsheader=\n
	category=test		category=test
	category=JFormRuleEmail		category=JFormRuleEmail
	~~category~~=CodeExample		namespace=CodeExample
	category=MethodExample		category=MethodExample
	include=*		include=*

JoomlaWikiBot: clean up

2017-03-24T14:03:40Z

clean up

← Older revision		Revision as of 14:03, 24 March 2017
Line 2:		Line 2:
	Method to test if an e-mail address is unique.		Method to test if an e-mail address is unique.

	~~<span class="editsection" style="font-size:76%;">~~
	~~<nowiki>[<! removed edit link to red link >]</nowiki>~~
	~~</span>~~

	<! removed transcluded page call, red link never existed >		<! removed transcluded page call, red link never existed >
Line 92:		Line 90:
	</source>		</source>

	~~<span class="editsection" style="font-size:76%;">~~
	~~<nowiki>[<! removed edit link to red link >]</nowiki>~~
	~~</span>~~
	<! removed transcluded page call, red link never existed >		<! removed transcluded page call, red link never existed >

JoomlaWikiBot: removing red link to edit, no existant pages

2013-05-14T02:53:55Z

removing red link to edit, no existant pages

← Older revision		Revision as of 02:53, 14 May 2013
Line 3:		Line 3:

	<span class="editsection" style="font-size:76%;">		<span class="editsection" style="font-size:76%;">
	<nowiki>[<~~/nowiki>[[Description:JFormRuleEmail/test\|Edit Descripton]]<nowiki~~>]</nowiki>		<nowiki>[<! removed edit link to red link >]</nowiki>
	</span>		</span>

	~~{{Description:JFormRuleEmail/test}}~~		<! removed transcluded page call, red link never existed >

	===Syntax===		===Syntax===
Line 93:		Line 93:

	<span class="editsection" style="font-size:76%;">		<span class="editsection" style="font-size:76%;">
	<nowiki>[<~~/nowiki>[[SeeAlso:JFormRuleEmail/test\|Edit See Also]]<nowiki~~>]</nowiki>		<nowiki>[<! removed edit link to red link >]</nowiki>
	</span>		</span>
	~~{{SeeAlso:JFormRuleEmail/test}}~~		<! removed transcluded page call, red link never existed >

	===Examples===		===Examples===
Line 108:		Line 108:
	format= ,,,		format= ,,,
	</dpl>		</dpl>
			[[Category:Archived pages API16]]

Doxiki at 10:15, 30 March 2010

2010-03-30T10:15:08Z

← Older revision		Revision as of 10:15, 30 March 2010
Line 17:		Line 17:
	!Description		!Description
	\|-		\|-
	\|		\| &$field
	\|		\|
	\| $field A reference to the form field.		\| $field A reference to the form field.
	\|-		\|-
	\|		\| &$values
	\|		\|
	\| $values The values to test for validiaty.		\| $values The values to test for validiaty.

Doxiki: New page: ===Description=== Method to test if an e-mail address is unique. [[[Description:JFormRuleEmail/test|Edit Descripton]...

2010-03-22T22:51:14Z

New page: ===Description=== Method to test if an e-mail address is unique. <nowiki>[</nowiki>[[Description:JFormRuleEmail/test|Edit Descripton]...

New page

===Description===
Method to test if an e-mail address is unique.


<nowiki>[</nowiki>[[Description:JFormRuleEmail/test|Edit Descripton]]<nowiki>]</nowiki>


{{Description:JFormRuleEmail/test}}

===Syntax===
<source lang="php">test(&$field, &$values)</source>

{| class="wikitable"
|-
!Parameter Name
!Default Value
!Description
|-
|
|
| $field A reference to the form field.
|-
|
|
| $values The values to test for validiaty.
|}

===Returns===
mixed on invalid rule, true if the value is valid, false otherwise.

===Defined in===
libraries/joomla/form/rules/email.php
===Importing===
<source lang="php">jimport( 'joomla.form.rules.email' );</source>

===Source Body===
<source lang="php">
public function test(&$field, &$values)
{
$return = false;
$name = (string)$field->attributes()->name;
$check = ((string)$field->attributes()->unique == 'true' || (string)$field->attributes()->unique == 'unique');

// If the field is empty and not required, the field is valid.
if ((string)$field->attributes()->required != 'true') {
// Get the data for the field.
$value = array_key_exists($name, $values) ? $values[$name] : null;

// If the data is empty, return valid.
if ($value == null) {
return true;
}
}

// Check if we should test for uniqueness.
if ($check) {
$key = (string)$field->attributes()->field;
$value = isset($values[$key]) ? $values[$key] : 0;

// Check the rule.
if (!$key) {
return new JException('Invalid Form Rule :: '.get_class($this));
}

// Check if the username is unique.
$db = &JFactory::getDbo();
$db->setQuery(
'SELECT count(*) FROM `#__users`' .
' WHERE `email` = '.$db->Quote($values[$name]) .
' AND '.$db->nameQuote($key).' != '.$db->Quote($value)
);
$duplicate = (bool)$db->loadResult();

// Check for a database error.
if ($db->getErrorNum()) {
return new JException('Database Error :: '.$db->getErrorMsg());
}

// Test the value against the regular expression.
if (parent::test($field, $values) && !$duplicate) {
$return = true;
}
} else {
// Test the value against the regular expression.
if (parent::test($field, $values)) {
$return = true;
}
}

return $return;
}
</source>


<nowiki>[</nowiki>[[SeeAlso:JFormRuleEmail/test|Edit See Also]]<nowiki>]</nowiki>

{{SeeAlso:JFormRuleEmail/test}}

===Examples===
<CodeExamplesForm />
<dpl>
noresultsheader=\n
category=test
category=JFormRuleEmail
category=CodeExample
category=MethodExample
include=*
format= ,,,
</dpl>