White Labelling
Carbonio enables White Labelling, allowing users to swiftly personalise many different aspects of their web interface to reflect their own corporate brand.
To enable White Labelling on a domain and begin customising Carbonio’s design, you must first provide a value for options.
Public Service Host Name aphostname in the domain’s General Settings section
Virtual Host Name apvhost in the domain’s Virtual Hosts & Certificates section
All White Labelling options may be found in the Carbonio Admin Panel under Domains- Global- Theme (global customizations that apply to all defined domains) or Domains- Details- Theme (to override global settings and alter them just for one domain).
White Labelling resources must have a valid URI and be accessible via Carbonio.
If the resources are hosted on a server that is not part of the Carbonio infrastructure, ensure that the server’s SSL certificate is current and has not expired, and that its FQDN is valid and resolvable from Carbonio (through the Proxy Node in the case of a Multi-Server).
You can safely expose those resources through Carbonio’s Proxy Node by uploading them to a directory called /opt/zextras/web/custom/ (create it if it does not already exist) and using the URL https://<Carbonio_hostname>/static/custom/, where <Carbonio_hostname> is the FQDN of the Single-Server or the Proxy Node in a Multi-Server.
Furthermore, in a Multi-Server with many Proxy Nodes, it is necessary to maintain the resources on all Proxies instances in sync.
The light mode features a white-based colour combination for the Carbonio login page and GUI, while the dark mode has a black-based colour combination.
Select the primary colour that will used in either Light or Dark mode, using an HEX (HTML) value. The secondary colour will be automatically computed.
The title is the string that will appear on the client’s tab, while the copyrights information will appear at the bottom of the panel in the login page.
This is the logo that appears on the login mask of Carbonio at the top of the panel in the login page. There are different dimensions and ratios for the Admin and End User logos.
Requirements:
Each login logo must adhere to the following suggested requirements.
The preferred format is SVG
The logo must have a transparent background
For a correct display of the logos, please respect the aspect ratio indicated and (in the case of raster images) respect dimensions as close as possible to the default ones
Admin: ratio 7:1, default 340×47 pixel
End user: ratio 4:1, default 340×85 pixel
This logo appears:
on the main page after a successful login, is displayed on the upper left corner.
in video calls: before starting and after terminating the call and during the call, in the top right corner
There are different dimensions and ratios for the Admin and End User logos.
Requirements:
Each WebUiApp logo must adhere to the following suggested requirements.
The preferred format is SVG
The logo must have a transparent background
For a correct display of the logos, please respect the aspect ratio indicated and (in the case of raster images) respect dimensions as close as possible to the default ones
Admin: ratio 5:1, default 150×30 pixel
End user: ratio 8:1, default 250×31 pixel
The favicon will be displayed next to the tab’s name and in browser notifications, if they have been activated in your browser.
Requirements:
The favicon must adhere to the following maximum requirements.
The format must be ICO
The dimensions must be 64×64 pixel, with ratio 1:1 (i.e., it must be square)
The background image for the login page is displayed behind the login panel during the login phase, You can choose one image for the light mode and one for the dark mode.
Requirements:
The images used for the background must adhere to the following maximum requirements.
The format must be JPG
The dimensions must be at least 1920×1050 pixel, with ratio 16:9
The size must be 800 Kb
By selecting the RESET button, all customizations can be deleted at once.