Customization

From ProVide DocWiki
Jump to: navigation, search

It is possible to change the styling of some html tags, the logo and URL for HTTPS. You can change this as described below. Every aspect of the web interface is customizable, but it´s not recommended to alter the html/js/css files that are not part of the official customize.zip-package as it could break future updates. Please observe that once the official support for altering the HTTPS layout has been implemented into GUI it might be necessary for you to migrate your changes into the new layout.

These files are made for the current version of ProVide, installing these on an older version of ProVide may cause issues.

As ProVide uses a CSRF (Cross-site request forgery) token to mitigate session riding you might need to merge the CSRF-code found in browse.html if you downloaded and are using an older version of customize.zip.

You can download templates at customize.zip. These should be placed as described below and modified to your needs:

ProVide\
    customize\
        css\
            customize.css
        htm\
            browse.html                                                                                                                   
            logout.html                                                            
            login.html            
        img\                                     
            logo.png

Modification of the graphic design should be in customize.css to prevent problems with future upgrades. All changes you do to these files will be immediately reflected on the published HTTPS interface, and if you simply remove these files ProVide will automatically revert to the original. It is always a good idea to remove the custom files you have not modified as that will ensure you get the latest version automatically in the future.

There are also a number of internal variables in the Settings.ini-file listed below, that can be changed in order to brand the WebGUI to your liking:

[Low level server identifier]
“ProVide”
[Low level server company]
"Your Company"
[Low level server vendor]
"https://www.your-company.com"
[MsgOnConnect]
"Welcome to Your Company"
[HTTPS Site Title]
"Your Company Portal"

To make these changes in the settings.ini, stop the system service, make the changes, and then start the service again.