Home » Support » Knowledge Base » Organisational Units » Adding Brands using Organisational Units

Adding Brands using Organisational Units

This article contains step-by-step instructions for adding a new 'brand' to Asset Bank.

Introduction

This article contains step-by-step instructions for adding a new 'brand' to Asset Bank. A brand consists of an organisational unit which forms a sub-section within Asset Bank. The brand functionality allows an org unit to have a unique look and feel (logo, colour scheme etc) associated with it.

Instructions

Create the colour scheme and logo

• When creating a logo for the brand, we recommend you save the image file as a gif and ensure it is less than 300px wide and around 60px high. (For reference, the Asset Bank logo is 140px by 57px). Save the logo file into the the following location on the server (i.e. the computer on which asset bank is installed):

  [tomcat]/webapps/asset-bank/WEB-INF/manager-config/updater/customise/images/standard/

• Now navigate to the css folder:

  [tomcat]/webapps/asset-bank/WEB-INF/manager-config/updater/customise/css/standard/)

  and create a new stylesheet by taking a copy of colour-scheme.css and renaming it to something relevant (e.g. scheme-acme.css). 

• Using a text editor or a css editor you can now edit your new stylesheet to reflect the colour scheme of your new brand (Note you will need to know the HEX values of the colours you want to use).

• The css rules will have a comment describing what they apply to, so just insert your new colours into whichever rules you choose until you are happy with the results.

• If you need to use a logo more than 60px tall you may need to increase the height of the header section to accommodate it. This can be done by changing the height value in the following chunk of css (below I have changed the height of the header to 100px):

  #header {
  background-color: #fff;
  height:100px;
  }

• Once you have a logo and css file in place, then you are ready to put them live! In your browser, log into Asset Bank as an Admin user, then go to Admin > System > Developer and click the Overwrite button.

• Note: At this stage you wont be able to actually see your new stylesheet and logo in action until you have completed the following steps to set up the new brand in the system.

Set up an organisational unit

• In your browser, login to Asset Bank as an admin user

• Select 'Org Units' from the admin menu

• Click to add a new org unit

• The name of the org unit should be something descriptive such as the company name of the client

• A storage quota can also be set should you wish to restrict the amount of space that the client can use

Set up the brand in the database

• Using a database editing tool connect to the Asset Bank database and open the 'Brand' table.

• Add a new row to it (using the plus button), and specifying the following for each column:

• Id - this should be sequential, so should be 1 higher than the previous highest id.

• Name - the name of the client e.g. New Client

• Code - an abbreviation for the name containing no spaces e.g. new_client

• CssFile - the name of the CSS file created in step 1 e.g. scheme-acme.css

• LogoFile - the name of the logo file created in step 1 e.g. new_logo.gif

• LogoWidth - the width of the logo in pixels e.g. 80

• LogoHeight - the height of the logo in pixels e.g. 80

• LogoAlt - Alternative text for the logo e.g. Logo for new client

• ContentListIdentifier - leave this as null as it is no longer supported

Link the new organisational unit to the new brand

• In your browser, login to Asset Bank as an admin user

• Select groups from the admin menu

• Locate the two groups associated with the new org unit

• Click edit besides the group for admin users of the new org unit

• From the brand drop down select the newly created brand

• Repeat this for the second group for users of the new org unit

Test the new brand

• Create a new user (Admin -> Users -> Add a new user) and assign them to the new org unit by adding them to one of the two new groups.

• Login as the new user

• Verify that the new look and feel is displayed

• You can go back and edit your new stylesheet again, but remember to put any changes live by going to Admin -> System -> Developer and clicking the Overwrite button.

« Back