How to Set Up a Custom Login Page
The portal allows you to create a custom-developed login page to use instead of the out-of-the-box login page.
Note: In order to ensure login security, we recommend that all custom login pages be developed by our Professional Services team.
To create the login page, navigate to Develop > Pages, click on "New" and select "Active Pages".
Please refer to our development guides below for more information on how to develop the custom login page.
Active Pages Documentation:
https://help.magentrix.com/wikis/help/creating-and-managing-active-pages
Magentrix Developer Guide:
https://help.magentrix.com/wikis/devguide/about-magentrix-developer-guide
Portal Manager Method Guide:
https://help.magentrix.com/wikis/devguide/portalmanager
Including Login Option on Public Landing Pages:
https://help.magentrix.com/wikis/devguide/login-option-on-public-pages
Please note that Magentrix Support is unable to assist with custom coding inquiries.
Once the login page has been created, it must be selected in the “Custom Login Page” configuration, under the "Company Preferences" settings.
In order to access the setting, navigate to Manage > Company Preferences, and click on “Member Settings”.
- In order to create the new Menu Item, navigate to Create > Navigation Menu >Menu Items > + New Menu Item. Select "Active Page Menu Item" > Next
Fill in the Label Name and select the custom page that was previously created under the Active Page option. Select an Icon for the Menu Item. The Tool Tip and Description fields are optional. Click on "Create".
- Next, we will create a new APP for "Guest" users and assign the newly created Menu Item.
In order to create a new APP, navigate to Create > Navigation Menu > Apps. Click on + New App. Add a name and click Save.
Drag and drop the Menu Item created for the login page from "Available Menu Items" to "App menu structure" Enable the page as Landing Page. Click on Save.
For more information on how to create a new App, please see the documentation below:
https://help.magentrix.com/wikis/help/managing-apps
Allowing Guest users to access the new Login Page
To allow guest users to access the new Login Page, it is important to grant access to the "Guest" Security Role and set the App as default.
- In order to grant access to the page for the "Guest" role, navigate to Security > Security Role and click on "Guest" security role.
- Then, click on “Edit”, navigate to “Active Pages/Classes” and under the “Active Pages” section add the new Login Page designed for the login.
If the page has a Controller/Class, grant permission by adding it to the right.
- Under “App Settings”, Select the “Custom Login Page” as the default App for the “Guest” role.
This process is required for the Guest user to be redirected to the App that has the "Custom Login Page" set as the landing page when trying to log in.
Click “Save and Close” and the configuration is ready to be used.
After completing the steps above, Guest users will see the Custom Login Page upon accessing the portal.
After performing the above steps, if the custom login page is not visible to Guest users, please contact Magentrix Support.