The email verification page type is used as a landing page for when a user receives an email asking to verify the user's email address. When at the email verification page, the user enters the password given during the user registration process. If the password matches, the user is is redirected to a configurable location.
A standard email verification page may look like this:
There is a single main token for the Email Verification Page Type's Content Skin:
Additionally, the Email Verification Page Type uses one InvalidText token, and three Error tokens. They are:
All error messages can be customized in the Security settings section of Admin.
An <input type="submit"> should also be present on the page (or another method to submit the form), so that the user may submit the form and verify their email.
To create an email verification page, first a page type must be created. Enter the area of Admin and proceed to the Page Types tab. Click Add New Page Type, enter the name of the page type (such as "Email Verification"), and select the base type as Email Verification. Click to create the new page type.
Next, click the pencil of the new page type to edit it. Enter the skins tab, and enter the Content Skin. Note that although a [[Content]] token is present in the skin by default, a [[Content]] token has no behavior in an Email Verification page type. If you would like an editable content area above or below the content skin, use an editable webbox.
In the content skin you may skin your page as desired. The above example is skinned as the following:
<h1>Email Verification</h1> <p>Please enter your password to verify your email.</p> <div> <label for="Password">Password:</label><span>[[Password]]</span> </div> <input type="submit" value="Submit" /> <p> <ins class="error">[[PasswordInvalidText]]</ins> <ins class="error">[[PageUsedMessage]]</ins> <ins class="error">[[PageExpiredMessage]]</ins> <ins class="error">[[UserIsLocked]]</ins> </p>
As with all pixelsilk forms, there is no <form> tag, but the is an <input type="submit"> tag present.
Finally, an actual page needs to be created with the Email Verification page type chosen. This page can be named whatever you wish. The URL for this page is what will be generated in the email to the user (see below), and this page will be the actual page that the user visits to verify their email address.
For example, a page named Email Verification could be created under the Home page. The URL for this page would be /email-verification/.
Generally, it is recommended to enable the page, but disable viewing the page in the menu and sitemap.
When the submit button is clicked, either the user will stay on the same page, with error message tokens populated, or they will be logged in and redirected to a configurable URL. The Email Verification page type shares the redirect settings of list sections. To change the redirect location for the email verification page, first enter the [Pages] section, and open the properties [p] for the email verification page. Navigate to the Form Submit tab, and open the properties of Redirect After Submit.
Make sure Redirect to is checked (so that you may edit the value, note that Show item detail page does nothing for an Email Verification page type). Enter the redirect location you would like for the email verification page, then click and to save your changes.
Now, when users verify their email address, they will be redirected to the URL which was configured above.
To enable Email Verification, see the Email Verification section of the User Registration Page Type section.
There are two aspects to successfully configuring email verification on a Pixelsilk website. Setting the location of the email verification page described above, and configuring the email which is sent to the user.
When a user finishes user registration, they will be sent an email with a link to the Email Verification page type. The URL of the page must be set in the Pixelsilk Admin so that the email will have the correct link address.
Enter the area of Admin and enter the Config tab. Click Add New Setting. For the Name, enter
EmailVerificationUrl. For the value, enter the relative URL of the email verification page type that was created above. Click to save the new setting.
EmailVerificationUrl- The relative URL of the page for an Email Verification email to link to, in the [[EmailVerificationUrl]] token.
Next, the actual email which is sent to the user must be configured. If you have not done so already, see Configuring Default Email Settings to set up defaults required for the Email Verification page type.
To start, enter the area of Admin, and enter the Emails tab. Open the Email Address Verification URL bar. To set up a full email:
Additionally, there are several additional configuration settings which can be set for Email Verification. Each is configurable in the , Config area of Admin.
PasswordRecoveryUsedMessage- Despite the name, the value of this setting is what will appear in the [[PageUsedMessage]] token on the page when the page has already been used to verify an email.
PasswordRecoveryExpiredMessage- Despite the name, the value of this setting is what will appear in the [[PageExpiredMessage]] token on the page, when the page has expired and cannot be used.
EmailVerificationExpirationDays- (Default: 2) If set, the number of days before email verification pages will expire.