Die White Label Konfiguration bzw. das Branding 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.

Die Konfiguration von Benno Web wird in der Voreinstellung aus der Datei /etc/benno-web/benno.conf gelesen. Für individuelle Einstellungen Subdomains kann die Konfigurationsdatei mittels Umgebungsvarible BENNOWEB_CONFIG in der VirtualHost Umgebung des Webservers festgelegt werden.

Beispielkonfiguration Apache Webserver:

 SetEnv BENNOWEB_CONFIG /etc/benno-web/benno-web-customer1.conf

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
THEME_DIR  = /etc/benno-web/theme

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;
}
 
/* Anpassen der Farben */
 
/* Farbe für Buttons (nicht hervorgehoben, Standard: Dunkleres Rot) */
.form_button_big {background:#0059A1;}
.input_button {background:#0059A1;}
.label_active {background:#0059A1;}
.ui-widget-header {background:#0059A1 !important;}
a.mail_content_button {background:#0059A1;}
a.modal_button {background:#0059A1;}
 
/* Farbe für Hervorhebungen (Hover-Effekt für Buttons etc., Standard: Helleres Rot) */
.no-touchevents .input_button:hover {background:#FE8300;}
.no-touchevents a.mail_content_button:hover {background:#FE8300;}
.no-touchevents #EMail_Attachments a:hover {background:#FE8300;}
.no-touchevents a.modal_button:hover {background:#FE8300;}
.no-touchevents .form_button_big:hover { background: #FE8300;}
.form_notification {background: #FE8300;}
table.jCalendar th { background: #FE8300;}
table.jCalendar td.today { background: #FE8300;}
table.jCalendar td.selected { background: #FE8300;}
div.dp-popup a:hover { color: #FE8300;}
 
/* Schriftfarbe des Login-Buttons (Standard: Sehr helles Rot) */
.form_button_big {color: white;}

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

Das Info-Fenster wird per Default aus dem Template /srv/benno/bennoweb/templates/infotext.tpl gelesen. Ein angepasstes Template kann mit dem Konfigurationsparameter

INFOTEXT_TPL = /pfad/zur/infotext.tpl

festgelegt werden.

Die Texte der Oberfläche des Web-Interfaces können individuell angepasst werden. Hierfür werden unterhalb des Unterhalb des im Parameters „THEME_DIR“ festgelegten Verzeichnisses Dateien entsprechend der Lokalisierung erstellt. Die in diesen Dateien gesetzten Werte überschreiben die in den Dateien /srv/benno/bennoweb/templates/*.txt festgelegten Werte.

In der Datei /etc/benno-web/benno.conf wird der /THEME_DIR = /etc/benno-web/theme gesetzt. Im Verzeichnis werden die Dateien de.txt' und en.txt'' angelegt (s.u.).

Für die deutsche Lokalisierung werden der Titel der Seite sowie die Willkommensnachricht angepasst, während für die englische Lokalisierung ausschließlich der Titel überschrieben wird.

PAGE_TITLE = "CLOUD HOSTING MailArchiv"
PAGE_TITLE_LOGIN = "CLOUD HOSTING MailArchiv - Login"

SEARCH_SUBMIT = "Finden"

GREETING_CONTENT = """<div class="scroll-panel2">
<br/><br/><br/>
<div style="padding-left:20px">
<strong>Herzlich Willkommen in Ihrem Mailarchiv von CLOUD Hosting</strong>
<br/><br/>
Um E-Mails im CLOUD Hosting MailArchiv zu finden, geben Sie oben im<br/>
Suchfeld einen beliebigen Suchbegriff ein oder verwenden Sie<br/>
die Schaltfläche "Erweiterte Suche", wenn Sie eine Suche mit<br/>
detaillierten Kriterien vornehmen möchten.

<br/><br/>
Wenn Sie mehr über die vielfältigen Suchmöglichkeiten von<br/>
CLOUD Hosting MailArchiv erfahren wollen, schauen Sie im Tutorial<br/>
"E-Mails schnell und einfach finden mit CLOUD Hosting MailArchiv" nach.
<br/><br/><br/>
Aktuelle Informationen rund um CLOUD Hosting MailArchiv finden Sie<br/>
jederzeit auf unserer Homepage</a>.
<br/><br/>  
</div>
</div>
"""

PAGE_TITLE = "CLOUD HOSTING MAILARCHIVE"
PAGE_TITLE_LOGIN = "LOGIN TO CLOUD HOSTING MAILARCHIVE"