Page Comparison

Preparing branding

1. Prepare themes as described in Abiquo Branding Guide

2. Back up Abiquo system elements: In addition to regular backups, we recommend that you make a quick backup of the UI before enabling branding
   Log in to a shell on the Abiquo server with a user with root permissions and make a copy of the UI folder

   Code Block
   mkdir /opt/abiquo/quick_ui_backup tar cvfz /opt/abiquo/quick_ui_backup/ui_`date +%Y%m%d`.tar.gz /var/www/html/ui/

   
   

3. Optionally assign branding privileges in Abiquo, if the users managing enterprises are not cloud administrators.
   In Users View, check that the users have the "Manage enterprises" and "Modify enterprise theme" privileges.

   Expand

   
   

...

1. Compress your theme folder
2. Log in to the Abiquo Server and copy your theme to theme folder
   
   • The theme folder is /var/www/html/ui/theme

   • For example, using wget from the Abiquo Server to a Linux machine

     Code Block
     wget myuser@mymachine:~/Downloads/mytheme_base_theme.tar.gz /var/www/html/ui/theme

     
     

3. Move or copy any existing theme with this name to another folder name

   Code Block
   cd /var/www/html/ui/theme mv my_custom_theme my_custom_theme_backup

   
   

4. Extract the theme (which will OVERWRITE any theme with the same name). For example, when the theme was compressed with tar and gzip

   Code Block
   tar -zxvf my_custom_theme.tar.gz

   Remember to check the file ownership and access settings, because the Abiquo Tomcat server will need to access the branding files.

Set a default theme for login and enterprises without themes

You can set a default theme that Abiquo will use to style the login zone, as well as the enterprises without themes.

• When you set a default theme, Abiquo still requires the abicloudDefault theme as before because it is the base theme. 
• You do not need to add the default theme to the list of themes in client-config-custom.json unless it will be used by tenants

To set a default theme that will persist after upgrades, do one of the following steps:

...

In the theme folder, create a symbolic link, named 'default', which points to the desired theme to mark it as the default:

> theme/ ln -s sample_theme_2 default

Note that Tomcat does not allow access to symbolic links by default and you will need to enable the allowLinking property. See https://tomcat.apache.org/tomcat-8.0-doc/config/resources.html#Common_Attributes

...

1. Remember to check the file ownership and access settings, because the Abiquo Tomcat server will need to access the branding files.

Edit UI configuration to add new themes to Enterprise menu

...