Page History

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Anchor
email_verification
email_verification
Email Verification

When the user registers to a site that requires email verification, they are sent an email to verify their address. The link appearing in the verification email automatically redirects to the landing page, which in turn, finalizes the registration process and logs the user in to the site.

Check this box to require users to verify their email addresses:

 

Email verification is done by sending a verification link to the email address registered to the user. You can specify the format of the verification email using the Email Templates  page in Gigya's website. For more information, see Email Templates.

Once Require Email Verification is enabled, you must enable users to be able to complete registration. To do this, you must first ensure that you have an email field on the Complete Registration screen of your site's Screen-Set. You must also make sure that this field is set as Required in the site's schema. If you are using Gigya Default Screen-Sets, you can accomplish this by opening the Complete Registration screen in the UI Builder, selecting the Email field and checking the Required checkbox under the Schema tab of the Properties menu. Not doing this will result in users being unable to complete registration if their social network does not provide an email address, i.e., Twitter.

 

Panel
borderColor#81C0FC
bgColor#F4F7FC
borderWidth1
borderStylesolid

Note: When using site groups , Child sites automatically inherit email verification policy from their master site. To override email verification settings per child site, select  
For more information regarding the SSO implications of overriding email verification settings when using site groups, see SSO - Member Site Policy Override.

 

Verification Options

The following options are available once email verification has been selected:

  • Customize redirection URL - The page to which the user will be redirected after verifying their email.
  • Customize verification link expiration time - The number of hours that verification emails are valid.
  • Automatically login users upon email verification - When selected, users will be logged in automatically once their email address is verified.
    • When this option is selected, you must specify a customized redirection URL (i.e., a landing page) on your site to handle the logged-in user. The landing page must contain the Gigya Javascript library, and will automatically fire the onLogin global event. See Policies - Advanced for more information.

 

Activating Automatic Login

In order to use the Automatically login users upon email verification option, make sure to specify a Customize redirection URL.

 

The page at this url must contain a reference to Gigya's Javascript library. In addition, the onLogin event is automatically fired and may be used in your client-side code.

A sample html page can be found below.

Code Block
<!DOCTYPE html>
<html>
<head>
<!-- mydomain.com/LandingPage.html -->
<title>Email verification custom landing page</title>
    <!-- gigya.js script should only be included once -->
    <script type="text/javascript" src="http://cdn.gigya.com/js/gigya.js?apiKey=[YOUR_API_KEY]"></script>
</head>
<body>

<script type="text/javascript">

// This function is called when the onLogin event is fired
function loggedIn(){
document.getElementById('successDiv').style.display = "";
document.getElementById('successDiv').innerHTML = "This is awesome, I am already logged in!";
}

// Register for Login event
gigya.socialize.addEventHandlers({ onLogin: loggedIn });
</script>

<div id="successDiv" style="display:none">Logged In!</div>

</body>
</html>

 

Verification Options

The following options are available once email verification has been selected:

Customize redirection URL

 

- The page to which the user will be redirected after verifying their email.

  • Customize verification link expiration time - The number of hours that verification emails are valid.
  • Automatically login users upon email verification - When selected, users will be logged in automatically once their email address is verified.
    • When this option is selected, you must specify a customized redirection URL (i.e., a landing page) on your site to handle the logged-in user. The landing page must contain the Gigya Javascript library, and will automatically fire the onLogin global event. See Policies - Advanced for more information.
  •  

    Default Verification Flows

    Partners can define basic sets of policies through their account console on the Gigya website. Advanced configuration can be achieved using the account.setPolicies method.
    When activating the email verification policy, new users encounter the following default login behavior:

    • For site users - When a user registers using the site's registration form, the user will be prompted to verify the registered email address by clicking the link in the verification email sent to the specified address.
      Note: The verification email can be customized. More details in the email templates section.
    • For social users - When a user registers using a social network account - the email address obtained from the social provider is considered a verified email address.
      This setting can be overridden by setting the ' verifyProviderEmail'  parameter to true  when calling the accounts.setPolicies method. If 'verifyProviderEmail' == true, the email address obtained from the social provider is considered an unverified email, until the user verifies it. 
    • If no email was obtained from the social provider - the user will be asked to enter their email address, and verify it through the authentication link. To see which providers deliver the users email address on login, visit the data availability table on the user object page.

    ...