User-defined Login Pages

Along with the login pages created by the Encodify staff, the user can create their own login pages and apply them to the sites in the system. The functionality of the custom login pages gives users the possibility to create login pages by configuring different login page elements such as: logo, colors, welcome text. Custom elements and styling can be added as well.

Login Page Settings

In order to create a new login page, follow the steps described below:

1. Go to System Configuration > Sites > Appearance > Login Pages.

2. On the toolbar, click New Login Page. 

Default View: 

As soon as the new login page is configured, you can click the Preview Login Page button, to see the configurations applied.

Click Save to save the created login page.

On the Login Pages screen, you can see the list of all created login pages and the ellipsis menu icon next to each.

To see the preview click the ellipsis dropdown and select Preview to see how the login page will look.

To edit the created login page:

1. Click the ellipsis dropdown and select Edit for the desired login page.

2. In the Edit Login Page window, make the necessary changes and click Save.

You can delete the login page by clicking the Delete in the ellipsis dropdown.

Apply Login Pages to Sites

After you have created and configured a login page, you can apply it in the system. Login pages are site specific, and therefore you can assign different login pages to different sites.

To assign login page to the site, perform the following steps:

1. Go to System Configuration > Site List and click the Edit icon for the site you want to assign the login page to.

2. In the Edit Site window click the Appearance tab.

3. Click the Login Page drop-down arrow — the list of all the created login pages will be displayed.

4. Select the needed login page from the list and click OK.
   

5. Go to the site you’ve assigned the login page to and click Log Out. You will be redirected to the login page. Login page appearance corresponds to the login page assigned in Site Edit.

User defined login pages are accessible via URL as well. For example:

In the following URL, http://qa.test.com/qa/common/login/ebms?LoginPage=user_defined_5, — ?LoginPage parameter specifies the login page that will be used. You can specify the desired login page in the URL by typing its name after ?LoginPage=user_defined_{id of the login page}.

You can make user-defined login page a default one by specifying it in System.properties file. The default login page will be used for all the sites for which login pages have not been specified, or the site was set up to use the default login page. To specify the user-defined login page as a default one, add the following to your System.properties file:

loginPage=user_defined_{id of the login page}

Request Access to the System

Users that do not have accounts in the system have the possibility to request the access to the system from the login page.

Configuration of the New User Request Functionality

In order to make the Request Access functionality available, the following configuration should be performed:

1. If user-defined login page is used, make sure the Enable “New User Request” option is enabled for the login page used. This will make the “New User Request” link available on this very login page.

   Note! For login pages provided by Encodify, the link will be made available by request.

2. Add the following parameters with corresponding values to the System.properties file:

   • new.user.request.mailto — list of emails to which the request email will be sent. This setting is required.

   • new.user.request.subject — subject of the User Request email. If nothing is specified, the default “New User Request” subject will be used.

   • new.user.request.templateFile — path to the file containing template for the User Request email body. The path is relative to ../WEB-INF/common directory. If nothing is specified, the following file is used: ../properties/common/new_user_request.template. Presence of the template file is required.

3. Save the System.properties files and restart the Application server in order to apply the settings.

Request access from the login page

To request access to the system perform the following steps:

1. On the Login page, click the New User Request link,

2. In the New User Request window, fill in the fields with corresponding information. Note, that the following fields are required to be filled in: Full Name, Email Address and Company.

3. Click Send Request.

Submitted request will be sent to the email specified in System.properties.