Serv-U Custom HTML and CSS (Advanced Branding) - KB Article #2054Related Articles -- 1781, 2078
Serv-U supports both basic branding (custom logo and some custom text) and advanced branding (custom CSS and templates) in its web and mobile client interfaces. These features are only available in Serv-U MFT Server
This article covers ADVANCED branding - see KB #1781 for basic branding.
Serv-U creates a directory full of advanced branding samples when you install the software. To view these samples, navigate to
C:\Program Files\RhinoSoft\Serv-U\Custom HTML Samples (or a similar folder) on the computer Serv-U is installed on.
"Serv-U Chrome" Sample
"Serv-U Gray" Sample
Applying the "Photography" Branding Sample
- Open a browser, and then navigate to your Serv-U Web Client.
- Open the Serv-U Management Console, and then navigate to Domain Limits & Settings > Custom HTML.
- Click Browse next to the Custom HTML Container Directory field, and then select the Photography folder within your Serv-U branding samples folder (for example:
/C:/Program Files/RhinoSoft/Serv-U/Custom HTML Samples/Photography)
- Browse for the CSS File, and then select Style.css.
- Browse for the Header File, and then select Header.htm.
- Browse for the Footer File, and then select Footer.htm.
- Select Enable Custom HTML, and then click Save.
- Press F5 to refresh the browser with your Serv-U web client to see the changes. Notice also that the "favicon.ico" file was applied.
Developing and Testing Your Own Branding
Follow these guidelines to develop and test your own branding.
- Copy an existing folder from Custom HTML Samples, or copy one of your existing brand folders rather than starting from scratch.
- Create a separate test domain and http/https listener to test your new branding.
- To promote your new branding into production, make a complete copy of the folder you developed the branding in, and point your production domain to the copy of your work. (This way you can continue to develop your brand on your test domain without disturbing anything.)
- Remember to use "target='Top'" (or a similar attribute) on any custom links you add to avoid breaking current web transfer sessions.
Changing the Page Title
You can change the page title in Domain Limits & Settings > Domain Settings in the HTTP Login Title Text field. See KB #1781 for more information.
The "%25CUSTOM_HTML_DIR%25" Macro
Using "%25CUSTOM_HTML_DIR%25" (without the quotes) in your templates tells Serv-U to get media from the configured value of the Custom HTML Container Directory. For example, the following reference:
img src="/%25CUSTOM_HTML_DIR%25/images/image.png" alt="My Image"
...in a custom template would download and display
C:/Program Files/RhinoSoft/Serv-U/Custom HTML Samples/Photography/images/image.png if the Custom HTML Container Directory was currently set to
/C:/Program Files/RhinoSoft/Serv-U/Custom HTML Samples/Photography.