The Maestro User Interface and the Administration Hub components permit limited user interface branding by allowing the administrator the choice of using institutional or company logo images instead of the LISTSERV® Maestro logos, and by adding a few text strings at prominent locations, like in the header and footer of each page.
To do this, the administrator must create a text file called "custom.properties" that must be located in the folder
\Program Files\L-Soft\Application Server\lui
to customize the Maestro User Interface component and/or
\Program Files\L-Soft\Application Server\hub
to customize the Administration Hub component. This file must be a text file that follows the rule of LISTSERV® Maestro INI files (see Section 14 for more information). This means that the file must consist of entries of the form "key=value", with which the administrator can define customized text strings or point to customized logo image files.
Each custom text string consists of a "key=value" pair, where the key is as listed below, and the value is the text that is supposed to appear in the user interface (and follows the INI file rules). The following text string keys are currently available for customization:
In order to replace the LISTSERV® Maestro logo image files, prepare the customized image files and save them in either GIF or JPG format. There are size restrictions for the files, which are detailed below. Create a folder named "custom" in the directories below. Save the image files in these "custom" folders so that the files are accessible to LISTSERV® Maestro and so that the files will not be changed or deleted by LISTSERV® Maestro's upgrade routine (although the folders may be deleted during a full uninstallation of LISTSERV® Maestro).
For the Maestro User Interface component, create a "custom" folder so that the path to save the image files reads:
\Program Files\L-Soft\Application Server\webapps\lui\custom
For the Administration Hub component, a "custom" folder so that the path to save the image files reads:
\Program Files\L-Soft\Application Server\webapps\hub\custom
Storing image files anywhere else will either have the effect that LISTSERV® Maestro will not be able to find them, or they may be lost during an upgrade.
Once the images are saved in the "custom" folder, LISTSERV® Maestro needs to know about them. Do so with the same sort of "key=value" entries in the "custom.properties" file(s) as described above. Each key's value must be a relative filename starting with a forward slash "/" and including the name of the "custom" folder itself as the first path element, using the forward slash as the separator (not backslash).
For example: "/custom/myImage.gif".
The following image file keys are currently available:
Uses the image file with the name "FILENAME" from the "custom" folder to replace the LISTSERV® Maestro logo image that is shown at the right of the header bar that appears at the top of each page. This logo also a clickable link that may be customized as well. Set the target URL with the "app.url.companyURL" key (see above). This image must be 60 x 60 pixels in size. If this key is not included, the LISTSERV® Maestro logo will be used.