Customizing the login page
Customize the login page in HCL Connections™ to have the appropriate style and content for your organization.
About this task
Procedure
- Optional: Turn on the customization debugging capability. For more information, see Enabling live user interface customization editing mode.
- Copy the login.jsp file from the WAR
file of one of the applications. You can access the file from the
following directory:
WAS_HOME/profiles/profile_name/installedApps/cell_name/ application_name.ear/application_name.war/nav/templates
Where:- WAS_HOME is the directory where IBM® WebSphere® Application Server is installed.
- profile_name is the profile where you installed Connections.
- cell_name is the cell where you installed the application.
- application_name.ear is the name of the application EAR file. To customize interface styles that are common to all applications, use the Common.ear file.
- application_name.war is the name of the application WAR file.Tip: For a list of the web application source directories that are packaged with Connections, see Application WAR files and OSGi bundles.
- version is the version number of the Connections release plus the date and build number of the JAR file.
The login.jsp file is the same for each application. You only need to make a copy of one instance of the file.
- Paste the login.jsp file into the
appropriate subdirectory of the customizationDir directory.
- To use the same login page for all of the applications, copy
it into the common directory:
customizationDir/common/nav/templates/login.jsp
- To create a different login page per application, copy the
file into the appropriate subdirectory for each application:
customizationDir/application_name/nav/templates/login.jsp
See Determining where to save your customizations for more information about locating your base customization directory. - To use the same login page for all of the applications, copy
it into the common directory:
- Edit the login.jsp file or files to
contain the information you want.Note: For information on how to replace the logo on the login page, refer to the steps covered in Changing the HCL Connections logo.
- Save and close the login page.
- To test your changes, log out of the product. Refresh the web browser, and then go to a login page.
- Optional:
Connections allows you to restrict the allowed domains that the login page redirect
url
parameter will permit as destinations (by allowing you to whitelist those domains). See Customizing the login page redirect parameter for details. - Optional: If you enabled custom debugging, turn off the debugging capability when you are ready to publish your changes. For more information, see Enabling live user interface customization editing mode.
- See Post-customization step for details about how to apply your changes permanently.