Codex

Function Reference/email exists

Contents

Description

This function will check whether or not a given email address ($email) has already been registered to a username, and returns that users ID (or false if none exists). See also username_exists.

Note: To execute this function you will need to add this line of code: require_once(ABSPATH . WPINC . '/registration.php'); in order to define the function.

Examples

Default Usage

This function is normally used when a user is registering, to ensure that the E-mail address the user is attempting to register with has not already been registered. 

<?php if ( email_exists($email) ) { . . . } ?>

Detailed Example

If the E-mail exists, echo the ID number to which the E-mail is registered. Otherwise, tell the viewer that it does not exist. 

<?php
  $email = '[email protected]';
  if ( email_exists($email) )
    echo "That E-mail is registered to user number " . email_exists($email);
  else
    echo "That E-mail doesn't belong to any registered users on this site";
?>

Parameter

$email
(string) (required) The E-mail address to check
Default: None

Return

  • If the E-mail exists, function returns the ID of the user to whom the E-mail is registered.
  • If the E-mail does not exist, function returns false.

Related

Conditional Tags: comments_open(), is_404(), is_admin(), is_archive(), is_attachment(), is_author(), is_category(), is_comments_popup(), is_date(), is_day(), is_feed(), is_front_page(), is_home(), is_local_attachment(), is_multi_author, is_month(), is_new_day(), is_page(), is_page_template(), is_paged(), is_plugin_active(), is_plugin_active_for_network(), is_plugin_inactive(), is_plugin_page(), is_post_type_archive(), is_preview(), is_search(), is_single(), is_singular(), is_sticky(), is_tag(), is_tax(), is_taxonomy_hierarchical(), is_time(), is_trackback(), is_year(), in_category(), in_the_loop(), is_active_sidebar(), is_active_widget(), is_blog_installed(), is_rtl(), is_dynamic_sidebar(), is_user_logged_in(), has_excerpt(), has_post_thumbnail(), has_tag(), pings_open(), email exists(), post_type_exists(), taxonomy_exists(), term_exists(), username exists(), wp_attachment_is_image()

See also index of Function Reference and index of Template Tags.
Retrieved from "http://codex.wordpress.org/Function_Reference/email_exists"

Codex Resources