Configuring the New Customer Registration Page

The DNN Web Site can be configured to use the new Dot Net control for customer registration.  This can be achieved by dropping the Personify.WebControls.Common.UI.Registration control on the Register Page of your web site. In addition to the Registration Control, the page should also have the LoginRequestControl. The Login Request Control is actually responsible for logging the user into the DNN Web Site.

Note.png For CMS’s other than DotNetNuke, the client will have to customize the LoginRequestControl module to log the user into the respective CMS.

Note.png Follow the instructions in the order mentioned below.

This control needs to be dropped on a web page. It is up to each client to determine the appropriate location of this page. The section below details how to set up the control on your website. The instructions are intended for a user with web admin/host privileges.

Configuring the Web Settings for the New Customer Registartion Page

To configure the New Customer Registration control:

1.    Log into your e-Business site as host.

2.    Create a new page on your site to add the control.
See Adding and Managing Pages for information on how to add a page to your website.

3.    Add the Personify- DNN Web Control Container module to the page.
See Installing .NET Controls for more information.

4.    Select the Edit Web Control Container option from the downward arrow icon, as highlighted below.
Edit_Web_Control_Container.png
The Select A Web Control window displays.

5.    From the Assembly drop-down, select "Personify.WebControls.Common.UI ", as highlighted below.
Common_dropdown_image.png

6.    In the Control Name field, enter "RegistrationControl" and click Search.

7.    Click Select next to the "RegistrationControl", as highlighted below.
Reg_COntrol.png

8.    The Control Settings for this control display, as highlighted below.
Settings_for_reG_cONTROL.png

9.    In the Additional CSS Class for Control field, enter the CSS class, if necessary.
This option allows you to add additional layout to the skin by developing a new DOTNETNUKE style, which requires an advanced understanding of HTML and CSS. See Using Skins for more information.

10.  From the Cancel Return URL line, click edit.
The Select/Edit Personify Web Parameter screen displays.

a.    Click the select link next to the appropriate PWF parameter.
You should set the PWF parameter to a value that will take the constituent to that URL in DNN when he/she selects "Cancel".

b.    If this PWF Parameter does not exist or you would like to create a new one, see Setting up PWF Parameters for more information.

11.  From the Continue URL line, click edit.
The Select/Edit Personify Web Parameter screen displays.

a.    Click the select link next to the appropriate PWF parameter.
You should set the PWF parameter to a value that will take the user to the URL in DNN when his/her registration is complete.

b.    If this PWF Parameter does not exist or you would like to create a new one, see Setting up PWF Parameters for more information.

12.  Check the Enable Company Address Linking checkbox.
When checked, will allow users link his/her address to a company address from the records you created in the back office.

13.  Check the Enable Company Search checkbox.
When checked, will allow users to search for his/her work address from the records you created in the back office.

14.  Optional: select or create a new Error Message.

a.    If left blank and the "PersonifyErrorMessage" do not return a result, the default error message, "An error occurred while performing [Insert Action]. If the problem persists, please contact the site administrator", will display. [Insert Action] will be substituted with the action the control was performing at the time of the error.

b.    If you wish to change the default error message, customize it with a PWF Parameter. See Setting up PWF Parameters for more information.

15.  In the QueryString Parameters to Preserve field, enter "ProductID, RateCode".
This is the default name of the parameter to read the product’s ID, but if the environment's redirection logic uses a different Query String name set it here.
If this PWF Parameter does not exist or you would like to create a new one, see Setting up PWF Parameters for more information.

16.  From the User Already Exists URL line, click edit.
The Select/Edit Personify Web Parameter screen displays.

a.    Click the select link next to the appropriate PWF parameter.
You should set the PWF parameter to a value that will take the user to the URL in DNN if his/her email address entered in the first step of registration process is already in the system. This page should hold the control – Personify.WebControls.Common.UI.UserAlreadyExistsControl.

b.    If this PWF Parameter does not exist or you would like to create a new one, see Setting up PWF Parameters for more information.

17.  Click Save.

18.  Navigate to the same page that has the Registration control, as shown below.
Reg_control_page.png

19.  Add the Personify- DNN Web Control Container module to this page after the Registration control.
See Installing .NET Web Controls for more information.

20.  Select the Edit Web Control Container option from the downward arrow icon, as highlighted below.
Edit_Web_Control_Container.png
The Select A Web Control window displays.

21.  From the Assembly drop-down, select "Personify.WebControls.Common.UI ", as highlighted below.
Common_dropdown_image.png

22.  In the Control Name field, enter "LoginRequestControl" and click Search.

23.  Click Select next to the "LoginRequestControl", as highlighted below.
Login_Request.png

24.  The Control Settings for this control display, as highlighted below.
WebSettings_Login_Request_Control.png

25.  Optional: in the Additional CSS Class for Control field, enter the CSS class.
This option allows you to add additional layout to the skin by developing a new DOTNETNUKE style, which requires an advanced understanding of HTML and CSS. See Using Skins for more information.

26.  Optional: select or create a new Error Message.

a.    If left blank and the "PersonifyErrorMessage" do not return a result, the default error message, "An error occurred while performing [Insert Action]. If the problem persists, please contact the site administrator", will display. [Insert Action] will be substituted with the action the control was performing at the time of the error.

b.    If you wish to change the default error message, customize it with a PWF Parameter. See Setting up PWF Parameters for more information.

27.  In the Query String Name for Return URL field, enter "returnURL".
This is the default name of the parameter. However, if the environment's redirection logic uses a different direct Query String name, enter it here. See Setting up PWF Parameters for more information.

28.  Click Save.

29.  Create a new page on your website called Redirect Customer.
See Adding and Managing Pages for information on how to add a page to your website.

30.  Do NOT drop any modules on this page.

31.  From the menu bar, select Admin>Site Settings, as highlighted below.
Admin_Site_Settings.png

32.  Alternatively, from the menu bar, select Admin, as highlighted below.
Admin_pic.png
The Portal Administration page displays, as shown below.
Port_Admin.png

33.  Click on the Site Settings icon, as displayed below.
Site_Settings.png

34.  The Site Settings window displays, as shown below.
Site_Settings_Window.png

35.  Expand the Advanced Settings options, as highlighted below.
Advanced_Settings.png

36.  From the Registration Page field, set this field to the Redirect Customer page, as highlighted below.
Reg_Page.png

37.  Navigate to the page on your website where the Loging control is located and complete the following for each page on your website that has the Loging control on it:  

a.    Select the Edit Login option from the downward arrow icon, as highlighted below.
edit_login.png
The Login window displays, as shown below.
Login_Window.png

b.    From the Customer Registration Action URL drop-down, select the Redirect Customer page, as highlighted below.
redirect_customers.png

c.    Click Update.

Note.png Make sure to repeat the above steps for every page that has the Login control on it.

38.  Navigate to the Redirect Customer page.

39.  In the Mode section, select the Edit radio button, as highlighted below (see Using the Personify e-Business Control Panel for more information about the functionality of the Mode radio buttons).
edit_mode.png

40.  From the In the Page Functions section, select Settings, as highlighted below.
Settings_Page.png
The Page Settings screen displays, as shown below.
Page_Setti_ng_screen.png

41.  Expand the Advanced Settings option.

42.  From the Link URL field, select the Page (A Page on Your Site) radio button, as highlighted below.
A_page_on_your_site.png
The Select A Web Page From Your Site drop-down displays.

43.  From the Select A Web Page From Your Site drop-down, select the Register Customer page, as highlighted below.
Reg_Customer_dropdoen.png

44.  Click Update.

Note.pngThis implementation works fine in Chrome and Firefox. In Internet Explorer, the Registration Module throws a javascript error. The issue is in the way DNN calls the registration page when the user clicks on the Register Link on the web site. See Technical Details of DotNetNuke Error for more information.

Note.png The interim Redirect page is a work around to avoid this error and this page will redirect the user to the Registration Page. 

Technical Details of the DotNetNuke Error

Issue Analysis

When a user clicks on the Register link the on Default.aspx, the download of associated javascript files are failing. This appears to be the primary cause of the issue.


Content type of the highlighted request should ideally be "text/javascript" instead of "text/html", as highlighted below.
java_error.jpg

 

The following describes why a browser generate the errors displayed in the image below:
Generated_error_message.jpg

·            Root cause of this behavior lies in the request URL :
http://localhost/DEMO_OLS/MyAccount/RegisterCustomer/tabid/356/HttpCombiner.axd?s=Personify.WebControls.Base-*-c*-_Personify.WebControls.Base.JS.*-_crequireJQuery.js_-_cjquery.gritter.min.js_-_cjson2.js_-_cjquery.ba-bbq.min.js_-_cmanager.js&t=text/javascript&v=634927963344970000

·            Highlighted segments fools DNN into serving HTML markup for Registration control, instead of javascript content. There are several areas within the web application where a request does not contain these segments (e.g., click "Store’" tab menu).
http://localhost/DEMO_OLS/HttpCombiner.axd?s=Personify.WebControls.Base-*-k*-_Personify.WebControls.Base.JS.*-_krequireJQuery.js_-_kjquery.gritter.min.js_-_kjson2.js_-_kjquery.ba-bbq.min.js_-_kmanager.js-*-Personify.WebControls.Store-*-k*-_Personify.WebControls.Store.JS.*-_ksearchcontrol.js_-_kpersonifyPager.js_-_kproductlistcontrol.js_-_knavigationbar.js_-_kbreadcrumb.js&t=text/javascript&v=634921268991627563

·            The URL is auto-generated by DNN. cmdRegister_Click event handler invokes DotNetNuke.Common.Globals.NavigateURL() to generate redirect URL. We have to configure DNN to use localhost/DEMO_OLS/MyAccount/RegisterCustomer.aspx instead of localhost/DEMO_OLS/MyAccount/RegisterCustomer/tabid/356/Default.aspx.