Account Registration page

The Account Registration page is a portal page where portal members can register themselves on the portal using the Sign up link on the login page.

Note

This page is normally shipped as a data package along with the solution, so it is probably already available on your portal.

To create an Account Registration page for your portal

In CMS, go to Content.

Select the

icon next to the node with the

icon (or select and hold (or right-click) the node, and then select Create).

Note

The icon identifies the My Account page. The name of the page, which is also displayed as the node name, is customizable and can be different in your case.

In the Create pane, select Account Registration page.
On the header, type the name of the page, which will also be displayed as the node name in the site localization tree.
On the General tab, configure the settings as described below.
1. Title - Specifies the title that will be displayed in the header of the Account Registration page.
2. Subtitle - Specifies the subtitle that will be displayed in the header of the Account Registration page.
3. Browser tab title - Specifies the title of the web browser tab that will be displayed when the Account Registration page is opened and the member point to the browser tab.
4. Content-from page - Specifies the portal page that will be displayed instead of the created page. The path on the address bar will be that of the original page. Use this setting only if you want to redirect the member to another existing portal page. Select Add to add a page that will be displayed instead of the source page.
5. Redirect-to page - Specifies the portal page that will be displayed instead of the created page. The path on the address bar will be that of the target page. Use this setting only if you want to redirect the member to another existing portal page. Select Add to add a page that will be displayed instead of the source page.
6. Menu settings:
  1. Menu item title -Specifies the title of the menu item, which will be displayed in the navigation pane for this page.
  2. Hide menu item - Specifies whether the menu item for this page will be hidden, and for which member groups. Only members that were added to the members groups that you select here will have this menu item available in their navigation pane. If you leave this check box cleared, the menu item will be visible to all member groups.
  3. Hide breadcrumb - Use this switch to hide or make visible again the page breadcrumb trail at the bottom of the page. A breadcrumb trail is used as a navigational aid to help portal members keep track and maintain awareness of their locations within the portal.
  4. Menu item icon - Specifies the icon of the menu item for this page. Select the square and browse to the icon in the portal media library.
  5. Menu item title color - Specifies the color of the menu item for this page.
  6. Split menu - Specifies whether a split line will be displayed after the menu item of this page.
  7. Compact menu - Specifies whether menu items will be displayed as icons in the main menu (navigation pane) for this page.
  8. Hidden menu - Specifies whether the main menu (navigation pane) will be hidden when this page is opened. The navigation can always be accessed by selecting the corresponding icon at the top of the page.
On the Data source tab, in the Entity field, select the PortalMemberRegistrationRequests entity.

On the Permissions tab, configure member group permissions for this page. These permissions define visibility of fields, action (same as actions on a detail page) and JavaScript events that will be available on the page for members depending on the member group(s) they belong to. Select the

icon to create a new permissions set. You can create several permissions sets for these page settings tailored to specific member groups according to your business needs. A portal member will have access to a page feature only if this member is assigned to a member group for which this feature is enabled and allowed.

Note

For the Account Registration page, we recommend granting access to this page for the Anonymous role (so that new portal visitors could send a member registration request) as well as admin roles.

Within a permission set, under Toolbar commands, configure at least the Submit action that visitors will use to submit their member registration requests. For this purpose, you can use the Save action with the following settings (action settings not mentioned below can be configured according to your preferences):
1. Command title = Submit
2. Show command title = Yes
3. Dialog window settings (Popup settings) - Specifies settings for the messages that are shown if the save is successful or unsuccessful. We recommend setting a message for a successful save: "Your registration request has been submitted. Please check [[MemberUserEmail]] inbox and verify your email by following the link in the email."
4. Redirect-to page = (login page on your portal)
5. Base dictionary key = XPortal.Frontend.SubmitSignUpRequest
On the Account Registration page tab, configure the settings as described below:
1. Member registration request confirmation page - Specifies a page that is used to show a message that informs the portal admin that a member's request to sign up has been confirmed. For such a page, you can create a child simple content page with the following message in the Description field on the Content tab, and then specify that page here: "Dear admin, a new member account has been confirmed."
2. Guest email confirmation page - Specifies a page that is used to show a message that informs a portal guest that their email has been confirmed. For such a page, you can create a child simple content page with the following message in the Description field on the Content tab, and then specify that page here: "Dear new member, your email has been confirmed successfully."
3. Enabled – Use this switch to enable or disable the ability of members to sign up (send a registration request to create a member account on the portal using the Sign up link on the login page).
4. New member verification email address template - Specifies the email template that will be used as a basis for the email, which contains the email confirmation link, which will be sent to a portal member to notify that portal member account has been created and email address confirmation is required. Select an email template from one of the email templates created in the site localization page settings on the Settings tab. You can leave this field empty and create the body of the email manually.
  
  Example of the code of the email body:
  <p><img alt="" src="/media/1977/xpand-logo-small.png?width=119&height=19" data-udi="umb://media/a736fc58d375414e9492251f3e436d16" style="width: 119px; height: 19px;" /></p>
  <p>Dear [[MemberName]],<br /><br /><span>Thank you for choosing to register on our portal! To ensure the security of your account and complete the registration process, we kindly request you to verify your email address by following the link below:<br /></span><br /><a href="##emailverifictionlink##">Verify my email</a><br /><br /></p>
  <div>If you did not create an account or did not initiate this sign-up process, please disregard this email. Your account will not be activated unless you verify your email address.</div>
  <div></div>
  <div>Please note that this is an automatic email, and we kindly ask you not to reply to it.</div>
  <div></div>
  <div>We look forward to seeing you on the portal!</div>
  <div></div>
  <div>Best regards!</div>
5. Member registration request approval email template - Specifies the email template that will be used as a basis for the email, which will be sent to the administrator when a new sign up request is created. The email should contain a link to approve the request. Select an email template from one of the email templates created in the site localization page settings on the Settings tab. You can leave this field empty and create the body of the email manually.
  
  Example of code of the email body:
  <p><img alt="" src="/media/1977/xpand-logo-small.png?width=119&height=19" data-udi="umb://media/a736fc58d375414e9492251f3e436d16" style="width: 119px; height: 19px;" /></p>
  <div>Dear portal administrator,</div>
  <div></div>
  <div>A new member registration request is currently pending approval. To approve the request, please follow the link below:</div>
  <div></div>
  <p><a href="#https://xp-rew-latest.xpt-acc01.xpand.local/blue/signuprequests/registration-request-card/?id=[[UniqueId]]">Approve Member Registration Request</a><br /> </p>
  <div>Please note that this is an automatic email, and we kindly ask you not to reply to it.</div>
  <div></div>
  <div>We look forward to seeing you on the portal!</div>
  <div></div>
  <div>Best regards,<br />Portal Team</div>
6. Member registration notification email - Specifies an email template that is used to inform a portal guest that their member registration request has been approved or rejected. Select an email template from one of the email templates created in the site localization page settings on the Settings tab. You can leave this field empty and create the body of the email manually.
  
  Example of code of the email body:
  <p><img alt="" src="/media/1977/xpand-logo-small.png?width=119&height=19" data-udi="umb://media/a736fc58d375414e9492251f3e436d16" style="width: 119px; height: 19px;" /></p>
  <p>Dear [[MemberName]],</p>
  <p><br /><span>Your member account registration request has been</span> [[verificationstatus]]</p>
  <p></p>
  <p>Please find the link to the portal below:</p>
  <p><a href="##site.url##"> [[site.url]]</a></p>
  <p></p>
  <div>Please note that this is an automatic email, and we kindly ask you not to reply to it.</div>
  <div></div>
  <div><span>Best regards,</span></div>
  <div>Portal Team</div>
7. Invitation email template - Specifies the name of the email template that will be used as a basis for the email that will be sent to a portal member to notify him or her that their portal member account has been created. Select an email template from one of the email templates created in the site localization page settings on the Settings tab. You can leave this field empty and create the body of the email manually.
  1. Email template – Specifies the email template that will be used for invitation emails. You can select a previously configured email, which is created in the site localization settings. Alternatively, you can create an email template here by filling the Email subject and Email body fields.
  2. Email subject – Specifies the subject of the email template that will be used to send invitation emails. Fill in this field only if you left the Email template field empty.
  3. Email body – Specifies the body of the email template that will be used to send invitation emails. Fill in this field only if you left the Email template field empty. Example of code of the email body:
  4. Example of code of the email body:
    <p>Dear [[MemberUserName]],</p>
    <p></p>
    <p>We are delighted to welcome you as a new member of our <a href="##site.url##">[[site.url]]</a>! Your account has been successfully created, and we are excited to have you on board. Here are the details you need to access your account:</p>
    <p></p>
    <p>Login: [[username]]</p>
    <p></p>
    <p>Please <a href="#=url#" title="confirmation page">set your password</a> to gain access to your account.</p>
    <p></p>
    <p>Thank you for choosing to be a part of our community. We look forward to your active participation and hope you find our portal a valuable resource.</p>
    <p></p>
    <p>Best regards,</p>
    <p></p>
    <p>The portal team</p>
8. Member registration rejection message page - Specifies a page that is used to show a message that informs a portal guest that their member registration request has been rejected. For such a page, you can create a child simple content page with the following message in the Description field on the Content tab, and then specify that page here: "Dear admin, a new member account has been rejected."
9. Sign-up approver emails - Specifies email(s) of CMS users who receive and approve sign-up requests from new members.
10. Email verification link token validation message page - Specifies a page that is used to show a message that informs a portal guest that the token of an email verification link is already used, which means that their email has already been confirmed using that link. For such a page, you can create a child simple content page with the following message in the Description field on the Content tab, and then specify that page here: "Dear guest, your email has already been verified with this link."
11. Email verification link token expiration message page - Specifies a page that is used to show a message that informs a portal guest that the token of an email verification link has already expired, which means that more time has passed than configured in the Email link lifetime setting before the verification attempt. For such a page, you can create a child simple content page with the following message in the Description field on the Content tab, and then specify that page here: "Dear guest, The link has already expired."
12. Email link lifetime – Specifies how many minutes the link in the invitation email to update password will be active.
Select Save and publish to save the changes and publish the created page. Optionally, you can select Preview to preview how the page will look like in the front end.
Specify the created Account Registration page on the My account page in the Account registration page field.

Enable/disable the ability to sign up

If the Account Registration page as well as related child pages is configured as described above, the portal administrators can enable/disable the ability to sign up for portal visitors by toggling the Enabled switch on the Account registration page tab of the Account Registration page settings. When this switch is disabled, the Sign up link is not available on the sign-in page.

Set up Google reCAPTCHA

On the Account Registration page, we recommend configuring a field with reCAPTURE (which is a form of CAPTCHA (Complete Automated Public Turing test to tell Computers and Humans Apart)). This is a service by Google that aims to protect your website and forms from abuse including spam.

To set up reCAPTCHA:

Follow this guide to create a reCAPTCHA account and get your Site Key and Secret Key (you'll need them later during setup).
Add a new field on the Account Registration page. In the Name setting, specify the GoogleRecaptcha field from the PortalMemberRegistrationRequests entity.
In the Value validation setting for this field, select the icon to add a new validation, and then select Google reCAPTCHA. Configure validation settings:
1. Enabled - Specifies that validation is enabled. Enable this switch for the reCAPTCHA field.
2. Validation message - Specifies the message that will be displayed if the validation is not fulfilled. For example: reCAPTCHA validation failed. Please try again.
3. Validation message title - Specifies the title that will be displayed on the validation message. For example: Google reCAPTCHA.
4. Google reCAPTCHA version - Specifies the version of the Google reCAPTCHA that is used for this validation. Select the version for which the site key and secret key were obtained during reCAPTCHA account registration and which are specified in the site localization additional settings.
Save and publish the changes.
Go to the site localization settings and, on the Settings tab, in Additional settings, add a setting with Additional setting name = Google reCAPTCHA private key (secret key). In the Value field for this setting, specify the secret key that was generated when you were configuring your reCAPTCHA account.
In Additional settings, add a setting with Additional setting name = Google reCAPTCHA public key (site key). In the Value field for this setting, specify the site key that was generated when you were configuring your reCAPTCHA account.
Save and publish the changes.
Go to Content and, on the Portal license tab, select clear to clear the cached data.