The Abiquo branding system has been changed to enable customers to easily perform their own branding of the Abiquo user interface.
Branding now uses cascading style sheets (CSS). Customers can edit and personalize a .css file to apply branding changes.
This section contains a brief description of the new system for advanced users.
Branding now has a different structure. The branding files are located in the theme folder under the main UI folder (by default this is /var/www/html/ui)
The abicloudDefault theme is the basic Abiquo theme. Do not edit this theme.
DO NOT EDIT abicloudDefault. When Abiquo makes changes in future versions, this file will be overwritten during the upgrade and your changes will be lost.
The sample_theme is a template that Abiquo will overwrite in each new release.
The sample_theme contains a list of classes that you can use to customize the branding data.
This theme is not suitable for using directly in Abiquo. To create your own theme, you must copy and rename this theme, customize it and add it to Abiquo following the Abiquo instructions.
The sample theme folder structure is as follows.
You can easily create your own themes as described below.
To create a theme:
alternatively, create a new folder and create your own CSS files
To add the theme to Abiquo (i.e. to make the theme selectable on the Create or Edit enterprise dialog), edit the client-config-custom.json file. Add the theme name into the "client.themes" variable
The enterprise theme will be available for selection by a user with the appropriate privileges (Manage enterprises and Modify enterprise theme)
To load the unsecured theme, edit index.html and add the CSS link
You MUST add this as the LAST CSS to load, so that it has priority over the default Abiquo theme
Abiquo will load the secured CSS after the unsecured CSS, so the secured CSS will have priority
The procedure to upgrade Branding when upgrading the Abiquo UI client is: