Web Client Customizations
The HTTP/S web client can be customized in several ways. Options for changing the default settings are discussed in the following sections.
Changing the Company Logo and Login Image
You can easily change the company logo displayed on the web client by specifying your own logo file.
- Go to the Listeners page of the Server Manager (pictured above)
- Select the HTTP/S interface you wish to change (not the default interface)
- Press the file selection button across from the Logo Image edit box
- Select the image file you wish to use and press Ok. The preferred image size is 230 x 70.
The login image displayed on the login page is also customizable using the same procedure as for the company logo. The preferred login image size is 70 x 70 pixels.
The image format for both logos should be one that is supported by all web browsers. We recommend PNG, GIF, or JPEG.
Changing the Favicon
A favicon, also known as a shortcut icon, website icon, tab icon, URL icon, or bookmark icon, can be modified by replacing the current favicon.ico.
For the customer facing web interface, you will need to replace the file:
C:\Program Files\Cerberus LLC\Cerberus FTP Server\webadmin\client\favicon.ico
For the web administrator interface, you will need to replace the file:
C:\Program Files\Cerberus LLC\Cerberus FTP Server\webadmin\admin\favicon.ico
Once you've replaced the favicons, you'll need to restart the Cerberus service in Windows Services.
NOTE!: These files will get replaced on every Cerberus upgrade, so make sure you keep a copy of your branded favicon handy outside the Cerberus file tree to put back after the upgrade. Upgrades are released every few weeks.
Also, in order to see the change in your browser, make sure you clear cache before accessing the web client. Browsers cache the favicon.
Changing the Login Welcome Message
If you select the Show Welcome Message option for the HTTP/S listener then the server welcome message is displayed next to the login credentials box when a client logs in on that listener. This message can be customized from the Messages page of the Server Manager.
Custom Web Client Themes
The HTTPS web client comes installed with several themes, but administrators can easily adapt and add their own. The web client was redesigned in version 7.0 to use the popular Bootstrap 3 framework. You can develop your own custom CSS theme file and drop it in:
C:\Program Files\Cerberus LLC\Cerberus FTP Server\webadmin\client\custom
Then, restart the Cerberus FTP Server Windows Service to have it automatically detect and make available the new theme.
A theme file is simply a CSS file that contains your own custom overrides of the default Bootstrap 3 theme. Any files your CSS file references should be relative to the custom folder. Cerberus will detect the new CSS file during startup and make it available as a theme (the theme name is based on the file name) on the Accounts page of the web client.
Further Web Client Customizations
The HTTP/S web client can be further customized by modifying the underlying template files. However, any changes made to those template files will be overwritten whenever Cerberus FTP Server is upgraded. We are working on ways to allow more permanent and lasting changes to the web client. The relevant template files are in:
C:\Program Files\Cerberus LLC\Cerberus FTP Server\webadmin
C:\Program Files\Cerberus LLC\Cerberus FTP Server\webadmin\client
The client-index.tpl file is probably the best place to start for modifying the overall look of the web client. The template files are cached in memory in Cerberus after the first time they are read, so a restart of the underlying Cerberus FTP Server Windows Service is required before any changes to these files will take effect.