Die White Label Konfiguration von Benno MailArchiv ermöglicht eine einfache Anpassung des Web-Interfaces an das unternehmenseigene Corporate Design. Für die Anpassung werden ein überarbeitetes Stylesheet sowie ein Logo und ein zugehöriges Favicon benötigt.

Diese drei Dateien werden unter einem gesonderten Pfad gespeichert, so daß sie bei Updates des Systems nicht überschrieben werden.

Im Webserver wird ein Alias zum Pfad der Konfigurationsdateien angelegt. In der Konfiguration für den Apache Webserver ist hierfür ein auskommentiertes Beispiel enthalten.

## Theme Path
#Alias /benno/theme /etc/benno-web/theme
#<Directory /etc/benno-web/theme>
#    Require all granted
#</Directory>

Alias /benno  /srv/benno/bennoweb/htdocs
<Directory /srv/benno/bennoweb/htdocs>
    Require all granted
</Directory>

Zur Aktivierung werden die Kommentarzeichen entfernt und die Konfiguration mittels service apache2 reload neu geladen.

Das Verzeichnis wird angelegt und die angepassten Dateien für Stylesheet, Logo und Favicon werden hierher kopiert.

mkdir /etc/benno-web/theme
chmod 0755 /etc/benno-web/theme
chgrp www-data /etc/benno-web/theme

In der Konfigurationsdatei von Benno Web (/etc/benno-web/benno.conf) werden die URL- Pfade zu den einzelnen Dateien konfiguiert.

THEME_PATH = /benno/theme
THEME_LOGO = /benno/theme/custom_logo.png

Die custom.css Datei sollte einen Verweis auf das Hintergrund-Logo der Login-Maske enthalten.

/* Customized Stylesheet */
#b_login_form_logo {
    background-image:url(custom_logo.png);
    width: 86%;
    margin: 20px 7%;
}
#header_logo {
    width: 100px;
    height: 20px;
    margin: 17px 10px 10px;
}
 
/* ... */

Sobald diese Einstellungen aktiv sind, werden die entsprechenden Dateien bei der Anzeige ausgeliefert.

Ein angepasstes Theme muss die folgenden Dateien enthalten.

Das Stylesheet mit dem vorgegebenen Namen

• /etc/benno-web/theme/custom.css

Icon Dateien mit den vorgegebenen Namen:

• /etc/benno-web/theme/favicon.ico
• /etc/benno-web/theme/apple-touch-icon.png

Die Logo Datei mit beliebigem Namen:

• /etc/benno-web/theme/unser-cd-logo.jpeg