Home » Support » Documentation » Configuration

Configuration

Note: When customising your Asset Bank, it is important to copy any jsp, image or css files that you have modified (with their existing directory structure) into the '[tomcat]/webapps/asset-bank/WEB-INF/manager-config/updater/customise/' directory. This ensures that when you perform a system update, your own customised files are not overwritten.

However, any changes to AppSettings and components.xconf should not be placed in the customise directory as they are merged automatically by the system during an upgrade.

For a detailed explanation of what you can customise in Asset Bank please read our customisable features page.

1. General Configuration

Most configuration changes can be made by editing the config file: [tomcat]/webapps/asset-bank/WEB-INF/classes/ApplicationSettings.properties.
This file contains comments, which explain what each of the settings means, and how to change it.

2. Changing the Copy

You can change the copy (i.e. text) that appears on many of the pages by using the content manager in the Content section of the Admin area.

Within the content section is a button to 'turn edit mode on'. When this is switched on you can browse the application in the normal way and select specific pieces of text to edit by clicking on the accompanying edit icon ( ).

There are some items such as button text and javascript messages that cannot be edited in this way. These can be found and edited via the content areas list in the content section.

If the copy in question is not available for editing, then you can (as a last resort) edit the text in the JSP page itself (see section 7)

3. Changing the Look & Feel

You can change the look & feel of Asset Bank by editing the style sheets. These are located in [tomcat]/webapps/asset-bank/css/standard.
To aid customisation, a special style sheet has been created, called colour-scheme.css, that enables users to easily modify the appearance of Asset Bank.

If you change any of the stylesheets, then make sure you copy them into the '[tomcat]/webapps/asset-bank/WEB-INF/manager- config/updater/customise/css/standard/' directory so that your changes are not overwritten during a system update.

Note: We do not advise that you change the CSS style sheets unless you have some experience of HTML and CSS.

4. Changing the Logo

To change the logo:

1. Overwrite the following file: [tomcat]/webapps/asset-bank/WEB-INF/manager- config/updater/customise/images/standard/asset_bank_logo.gif with your own logo.
2. Open the following file in a text editor:
   [tomcat]/webapps/asset-bank/WEB-INF/manager- config/updater/customise/jsp/standard/en/customisation/logo_link.jsp;
   Then simply update the <img> tag accordingly.
3. Apply your changes using the system developer tool.

5. Changing the watermark

To change the watermark:

1. Create your new watermark with a transparent background and a solid white foreground.
2. Save it as a png file, called 'watermark.png'.
3. Copy this file into the following location, overwriting the existing watermark.png:
   [tomcat]/webapps/asset-bank/WEB-INF/manager- config/updater/customise/images/standard/
4. Apply your changes using the system developer tool.

6. Editing the system generated emails

Asset Bank uses templates to define the contents of the emails that it sends. To edit the templates, login in to your Asset Bank as an administrator and go to Admin->Content (in the menu). Then click on the link 'Email Templates'.

7. Advanced Customisation

The Asset Bank user interface is developed using JSP technology. JSPs are a mix of logic elements and HTML code. It is possible to make more advanced customisations (such as adjusting the layout) to the JSP pages themselves.

Before making any changes, copy any JSPs that you want to customise to:
[tomcat]/webapps/asset-bank/WEB-INF/manager- config/updater/customise/jsp/
making sure you preserve the directory structure. When you have made the edits, apply them by following the steps in section 8 below.

Note: direct editing of JSP pages carries the risk of introducing defects if logic elements are affected. Furthermore, we advise against extensive Customisation of JSP pages from a support point of view, since Asset Bank upgrades may contain changes to the JSP logic which would need to be merged into the Customised copies where appropriate.

8. Applying your changes

Assuming you have made your changes within the customise directory of asset bank ([tomcat]/webapps/asset-bank/WEB-INF/manager- config/updater/customise/) then you can apply them as follows:

1. Login in to Asset Bank as an admin user.
2. Go to Admin -> System -> Developer
3. Click the 'Overwrite' button to copy across your customised files into the main application.
4. Go to the home page and refresh your browser. Your customisations have been applied.