Modifying the Logon Page

Logon Page FAQ

In responding to a recent query raised someone asked Senthil Murugan Muthuvelu to post the same in Portal Wiki and hence this.

He agreed to do so since there have been many questions about customising SAP Netweaver Portal logon page; what options we have, what are the associated files in customising the logon page and how they can be modified. To share my thoughts on this and answer, took this attempt and sure will be helpful to all.

It was moved by Michael Nicholls to live under the Portal wiki area.

This post will explain the steps involved for each element.

1. What is the associated par file for portal login Page?
Answer : The par file related to login page of Netweaver Portal is com.sap.portal.runtime.logon.par. This is the standard
logon component containing the code and resources used by the logon screens is shipped in a portal archive (PAR) file named com.sap.portal.runtime.logon.par.

2. How to import the PAR file into Netweaver Developer Studio?
Answer :   - Select File>Import .
- Choose the option PAR file. Select Next and a popup window appears.
- Select File>Import .
- Choose the option PAR file. Select Next and a popup window appears.
- In the window you have 3 text fields:
* The location of the par file,
* Project name (same as new par file name, preferably) and
* location for project to be saved

3. What are the different pages and their associated files in logon.par?
Answer :
Logon page : umLogonPage.jsp
Problem page : umLogonProblemPage.jsp
Help (PW reset) page  : umHelpPage.jsp
Reset Password : umResetPasswordPage.jsp
Change Password Page: changePasswordPage.jsp
Certificate Logon : umLogonCertPage.jsp

4. How to change text seen in the logon page ?   
The text seen on the logon page is not in the JSP page, but in properties files which are called by tags like the
Welcome text : <%=logonLocale.get("xtit_WELCOME")%>
In order to change "Welcome" to "Welcome to MyTravel" you have to :
           - Unzip the file umelogonbase.jar which you can find under dist\PORTAL-INF\lib
           - Find the file "logonLabels_" which contains your language;
                                       e.g. logonLabels_de.properties for german language,  *_en for English etc.,

The default is in the file logonLabels.properties .
- Find the key which is used in the tag and change the text after the equal sign.
- Save the changed file and create a updated JAR file using a zip program. The file needs to be named exactly umelogonbase.jar
- Put the JAR file back to location - dist\PORTAL-INF\lib
You are done on this now.

5. What is authschemes.xml file ? Do we need to change this file also ?
Changing the Authschemes.xml file is required only if you want to change com.sap.portal.runtime.logon.par.bak file and point it to different par file. This is more for anonymous logon with named anonymous users and using anonymous as the authentication scheme. The anonymous users are not issued a SAP logon ticket.

6. How to remove standard links like support, Register ...?
The standard links are controlled with the UM settings
       - ume.logon.logon_help 
       
- ume.logon.selfreg
You could also just comment out the lines if you want to hide.

7. How to change or add new images ?
To exchange the two images, which are by default on the logon page, do the following steps:
                      a. Copy the image(s) you want to use in your project in the the folder dist/layout
                      b. Find the < img src=""   > you want to work on in the umBotArea.txt

Change the src attribute in the img tag to src="<%=webpath + "layout/myPic.gif" %>". The webpath is already defined in the file logon_proxy.txt and ready to use. In the Netweaver portal 6.0 SP9 and higher you have 2 images on the right side.

8. How to change only the branding image displayed in the logon screen of the Portal ?
If you want to change only the branding image displayed in the logon screen, you can configure this using the user management property ume.logon.branding_image

Hope this helps the community in the launch of this ver 1.0, future versions could contain more changes and updations covering all other aspects of Netweaver Portal.