Technical

How do I apply a custom skin?

Follow

A 'custom skin' is a collection of files that define the look and feel of your Asset Bank. Usually your custom skin will be applied by us at the start of a project, but if you are installing the application yourselves then we may send you one as an email attachment (usually called customise.zip)

If you have been provided with a new 'custom skin' for your Asset Bank, then the following steps detail how to apply it:

Extract the contents of the zipped folder into the following location on the server where your Asset Bank is hosted: [tomcat]/webapps/asset-bank/WEB-INF/manager- config/updater/customise/

Note: if this directory already has files in it then it is a good idea to take a backup of the existing files in case you want to revert back to them.

Then do the following:

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


If you want to make changes to the look and feel of your on-premise instance of Asset Bank there are a couple options. If you have an idea of what you would like to change, then please get in contact with support and we can discuss potential options which will be charged on an hourly time and material basis.

If you would like to make CSS or logo changes yourself, then here are details on how to edit the look & feel of your instance:
N.B. If you apply breaking changes to your own instance this falls outside of our customer service agreement and we will have to charge to fix any issues you may have created.

1. You should find the 'customise' directory on your server, it should be located here (but don't worry if it's not):
[tomcat]/webapps/asset-bank/WEB-INF/manager- config/updater/customise/

2. Make a backup of the customise directory if present. 
- If the folder does not exist, make a copy of the following files:
[tomcat]/webapps/asset-bank/css/standard/colour-scheme.css
[tomcat]/webapps/asset-bank/css/standard/colour-scheme-override.css
[tomcat]/webapps/asset-bank/images/standard/logo.png

3. The customise directory should include the following:

[customise]/css/standard/colour-scheme.css (Main css file to apply styling to your instance)
[customise]/css/standard/colour-scheme-override.css (Might be blank and that's okay)
[customise]/images/standard/logo.png (Main logo for the application)
[customise]/images/assetbox/logo.png (Logo used for published lightboxes)


The customise directory might also include the following but it's optional:
[customise]/jsp/standard/en/logo_link.jsp (Specifies the logo file to use within the application)

4. Once making changes to the files within the customise directory do the following:

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

Related articles

Comments

0 comments

Please sign in to leave a comment.