Customisation of the standard Yellowfin Login Page can be performed two ways:
If you wish to create a quick, temporary custom login page, simply replace the following images, by placing new versions with the same file name in the Yellowfin ROOT customimages directory ({{Yellowfin\appserver\webapps\ROOT\customimages\ }}) with your customised versions:
You will need to clear your browser cache once replacing these images in order for them to appear.
Note: the images you wish to use as replacements will need to have the same name as the files listed above in order for the page to pick them up. You no longer have to overwrite the originals, simply place your new images in the custom directory. This will mean that they will not be overwritten during the upgrade process.
Component |
Standard Login |
Custom Login |
---|---|---|
Full Page |
||
logo.png |
||
yellowfin_welcome.png |
||
logoFooter.png |
||
nav_bkg.png |
Instead of starting completely from scratch, a copy of the current login page jsp can be found in the development examples directory of your Yellowfin installation (Yellowfin\development\examples\index_mi.jsp
). This will give you a starting point, providing the javascript required for the login itself, and allowing you to change the layout however required.
Firstly, you will need to rename the login file to something other than index_mi.jsp
, for example login_companyName.jsp
. You will then need to place your login file in the Yellowfin ROOT directory (Yellowfin\appserver\webapps\ROOT
).
In order to ensure Yellowfin uses this file instead of the standard option, you will need to complete the following while Yellowfin is not running:
web.xml
file found in Yellowfin\appserver\webapps\ROOT\WEB-INF
and locate the following:
<!-- The Welcome File List --> <welcome-file-list> <welcome-file>index_mi.jsp</welcome-file> </welcome-file-list> |
welcome-file
node to reference your new login page's name. For example:
<!-- The Welcome File List --> <welcome-file-list> <welcome-file>login_companyName.jsp</welcome-file> </welcome-file-list> |
web.xml
.index_mi.jsp
and update to your login page name. For example:
<input type="hidden" name="<%=Const.INDEX_PAGE%>" value="/index_mi.jsp" /> |
<input type="hidden" name="<%=Const.INDEX_PAGE%>" value="/login_companyName.jsp" /> |
Const.INDEX_PAGE +"=/index_mi.jsp" |
Const.INDEX_PAGE +"=/login_companyName.jsp" |
Configuration
table, locate the record where ConfigCode = 'LOGONPAGE'
and update the ConfigData = 'login_companyName.jsp'
using:
UPDATE dbo.Configuration SET ConfigData = 'login_companyName.jsp' WHERE ConfigCode = 'LOGONPAGE' |
Component |
Standard Login |
Custom Login |
---|---|---|
Full Page |