Brands are linked to Asset Bank Groups. When activated, the Multiple Brands functionality allows you to have a different logo and colour scheme for different groups. When a user logs in, the brand they see will reflect the group they are a member of.
Please note, you cannot have different watermarks per brand. If this is an issue, then you can generate a 'generic' watermark to replace one based on a specific logo.
Also note that after setting up brands, users will see the default logo and colour scheme unless they are a member of a group for which brands are set up. Admin user accounts are unaffected by group memberships so they will always see the default look and feel.
Creating your colour scheme and logo
To ensure that styling changes are not overwritten when the app is updated, any changes to CSS or logos should always be made within the customise directory found in:
Logos should be in a .png format and should be at least 300px wide and 80px high. Give it a sensible name and save it in the following location in the customise directory:
For page styling, you will need to take a copy of the existing colour-scheme-override.css file and rename it something sensible to reflect your brand, eg. brand-colour-scheme-override.css. This can be found in the following directory:
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).
Once you have a logo and CSS file in place, you can push them to the application. In the Admin > System > Developer area of Asset Bank, click the 'Overwrite' button which will push the changes made in the customise directory to the main application.
Set up the brand in the database
In the database, you will see a "Brand" table. Add a new row to this and fill in the information in each column. The columns are:
- Id - This will be generated automatically.
- Name - The name of the client as it will appear in Asset Bank 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. new_client_scheme.css.
- LogoFile - The name of the logo file created in step 1 e.g. new__client_logo.png.
- LogoWidth - The width of the logo in pixels e.g. 300.
- LogoHeight - The height of the logo in pixels e.g. 80.
- LogoAlt - Alternative text for the logo e.g. Logo for new client.
- ContentListIdentifier - Set this as NULL as it is no longer supported.
- EmailDomains - Again, set this as NULL
If you are using MySQL, this query would look something like:
INSERT INTO Brand (Name,Code,CssFile,LogoFile,LogoWidth,LogoHeight,LogoAlt,ContentListIdentifier)
VALUES ("New Client", "new_client", "new_client_scheme.css", "new_client_logo.png", "300", "80", "new client brand logo", NULL);
Set up a group for your brand
First, you'll need to enable the Multiple Brands functionality in the application by setting the multiple-brands setting to "true" in the ApplicationSettings.properties file.
As an admin user, log in to Asset Bank and navigate to the Admin > Groups area. Create your group for the brand or edit an existing group. You should see a "Brand" dropdown from which you can select the brand that you have set up.
Test the new brand
To test the brand simply create a new user, add them to the group and login as the user to see how your brand looks.