Customizing the Login Page

This documentation is an older version of JasperReports Server Ultimate Guide. View the latest documentation.

If you want to replace the TIBCO Jaspersoft branding, the login page requires extensive changes. Rebranding with a new theme and with the SiteMesh decorators are necessary but not sufficient. To completely customize the login page, you also need to edit the following files that define the content on the page:

•

The page title can be changed through the SiteMesh decorators, as described in Editing decorator.jsp for Rebranding.

•

There are several specific CSS rules for the login page that you may customize in a theme.

•

The content of the login page is located in a JSP file that you can edit to remove sections of the login page.

•

The URL for a button you need to keep is located in a JavaScript page.

•

All strings on the login page are stored in properties files. Most of these don’t need to change, but several do mention TIBCO Jaspersoft.

The following example shows how the CSS, JSP, JavaScript, and properties files all need to be modified together to make a uniform change such as removing the branding from the login page.

To change the branding on the login page:

Create a new theme or modify an existing one.

If necessary, copy the overrides_custom.css file from the default theme to the main folder of your theme.

Edit the overrides_custom.css file and add the following CSS rules:

This example swaps the login form and information panel left and right, respectively. You could also change the size and vertical position of the panels.

If you want to change the image on the login page, create an images folder if necessary, and save your image in the JPG format with the following name. Your image should be the same size, approximately 700 pixels wide and 240 pixels high, otherwise you may need to adjust the spacing on the login page through the theme as well:

Community Project:	images/login_welcome_ce_bkgd.jpg
Commercial Editions:	images/login_welcome_bkgd.jpg

The picture below shows the standard image replaced by an image of a fictional MyCompany logo.

Upload and activate the new theme with your image and CSS file, then click your browser’s Refresh button.

In commercial editions with the organizations architecture, you must upload and activate the theme at the root level. The theme at the root level applies to the login page for all users, regardless of the users’ organization. You must login as system admin (superuser) to set the theme at the root level.

To change or remove the links under the image, edit the correct file for your version:
<js-webapp>/WEB-INF/jsp/modules/login/rotating/login_rotating_pro_0.jsp
or login_rotating_community_0.jsp.

Edit the file <js-webapp>/WEB-INF/bundles/jasperserver_messages.properties.

Change the following string to customize your login page:

If you support multiple locales, modify the same message keys in the other language bundles:

jasperserver_messages_de.properties

jasperserver_messages_es.properties

jasperserver_messages_fr.properties

jasperserver_messages_ja.properties

jasperserver_messages_zh_CN.properties

10.

Restart the app server or reload the JasperReports Server web app as shown in the following section.

11.

When combining these customizations with those in Customizing the Branding with SiteMesh, the login page has a new appearance that removes all TIBCO Jaspersoft branding, as shown in the following figure:

Custom Layout and Rebranding of Login Page