%
% webmail-v1.10.x.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%% Kapitel Webmail-v1.10.x %%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Achtung: Dateien muessen mit latin1-Encoding gespeichert werden!
% Attention: Files must be saved using latin1 encoding!
%

\chapter{Das Webmail-Paket}

    Dieses Paket ist als Zusatzpaket zum Mail-Paket zu verstehen und erm"oglicht den
    komfortablen Zugriff auf die E-Mail-Postf"acher "uber eine Web-Oberfl"ache.


\section{Die Einleitung}

    In diesem Paket wurden verschiedenste Komponenten zusammengestellt, die zusammen
    ein komplettes Webmail-Paket ergeben. Als Web-Frontend-Anwendung wird hierbei
    SquirrelMail verwendet, welches komplett auf PHP5 basiert.


\section{Die Funktionen}

    Das Webmail-Paket besteht aus folgenden Komponenten:

    \begin{itemize}
         \item SquirrelMail - Der Web-Frontend f"ur den Zugriff auf das IMAP-Postfach \\
             (\url{http://www.squirrelmail.org/})

         \item SquirrelMail-Plugins - Stellen zus"atzliche Programmfunktionen zur Verf"ugung \\
             (\url{http://www.squirrelmail.org/})
    \end{itemize}

\section{Die Voraussetzungen}

    Dieses Paket ben"otigt das Mail-Paket mit aktiviertem IMAP-Server,
    sowie die Apache2- und Apache2\_php5-Pakete um funktionieren zu k"onnen.


\section{Die Installation}

    Das Webmail-Paket wird "uber das Setup-Men"u installiert. Wird eine
    "altere Paketversion vorgefunden, so wird diese deinstalliert bevor
    die neuen Programmdateien installiert werden. Nach dem Installieren der
    Programmdateien wird direkt der Konfigurations-Editor gestartet um die
    Konfiguration anzupassen. Nach Beendigung dieses Schrittes werden die
    Konfigurationsdateien generiert und alle ben"otigten Programme gestartet.
    Danach kann "uber einen Webbrowser, durch Eingabe von
    `http://<Name des eisfair-Servers>/webmail/`, auf die Anwendung zugegriffen
    werden.


\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm wird "uber `Mail Services' -> `Goto mail modules' angesprochen
    und ist wie folgt aufgebaut:

    \begin{itemize}
        \item Webmail interface
        \begin{itemize}
            \item View documentation: Anzeigen der Dokumentation
            \item Edit configuration: Bearbeiten der Konfiguration
            \item Advanced configuration file handling: Konfigurationen verwalten
            \item View configuration log file: Die Konfigurations-Logmeldungen anzeigen
            \item List installed locale(s): Installierte Sprachpakete anzeigen
            \item Install additional locale(s): Neues Sprachpaket installieren
            \item Remove installed locale(s): Installiertes Sprachpaket entfernen
            \item Exit: Untermen"u verlassen
        \end{itemize}
    \end{itemize}

    Die Men"upunkte d"urften selbsterkl"arend sein, da sie keinerlei weitere
    Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter
    eingegangen.


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt `Edit configuration' ge"andert
    werden. Standardm"a"sig wird der Editor aufgerufen, der in der Environment-
    Konfiguration "uber die Variable 'EDITOR' festgelegt wurde. Nachdem der
    Editor beendet wurde wird abgefragt, ob die Konfiguration aktiviert werden
    soll. Wird dies best"atigt, werden "uber ein Skript die Anpassungen
    umgehend wirksam gemacht.\\
    \hinweis{Es ist zu beachten, dass einige Programme eigenst"andig bei
        erneuter Aktivierung die Konfigurationsdatei neu einlesen, somit
        f"uhrt ein Beantwortung dieser Abfrage mit 'Nein' nur zu einem
        kurzen Aufschub der Aktivierung.}


\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind folgende
    Parameter vorhanden; wer sie von Hand editieren will findet sie unter
    \texttt{/etc/config.d/webmail}.

\section{Die Parameter}

\begin{description}
    \config{START\_WEBMAIL}{START\_WEBMAIL}{STARTWEBMAIL}
        F"ur die Aktivierung des Webmail-Programms muss dieser Parameter
        lediglich auf den Wert `yes' gestellt werden. Die Einstellung `no'
        deaktiviert das Webmail-Programm.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{START\_WEBMAIL='no'}

    \config{WEBMAIL\_N}{WEBMAIL\_N}{WEBMAILN}
        "Uber diesen Parameter wird die Anzahl der webmail-Instanzen angegeben,
        die eingerichtet werden sollen.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_N='1'}

    \config{WEBMAIL\_x\_ACTIVE}{WEBMAIL\_x\_ACTIVE}{WEBMAILxACTIVE}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird die zugeh"orige
        webmail-Instanz aktiviert, `no' deaktiviert sie.

        G"ultige Werte: yes oder no

        Beispiel: \texttt{WEBMAIL\_1\_ACTIVE='no'}

    \config{WEBMAIL\_x\_DOCUMENT\_ROOT}{WEBMAIL\_x\_DOCUMENT\_ROOT}{WEBMAILxDOCUMENTROOT}
        "Uber diesen Parameter wird das Dokumentenstammverzeichnis festgelegt.

        G"ultige Werte: absolute Pfadangabe

        Standardeinstellung: \texttt{WEBMAIL\_1\_DOCUMENT\_ROOT='/var/www/htdocs/webmail'}

    \config{WEBMAIL\_x\_SERVER\_DOMAIN}{WEBMAIL\_x\_SERVER\_DOMAIN}{WEBMAILxSERVERDOMAIN}
        "Uber diesen Parameter wird der Domainname der lokalen Domain
        festgelegt, f"ur welche SquirrelMail zust"andig sein soll. Sie sollte
        identisch mit der Variable SMTP\_QUALIFY\_DOMAIN aus dem Mail-Paket
        sein.

        G"ultige Werte: Domain-Name

        Beispiel: \texttt{WEBMAIL\_1\_SERVER\_DOMAIN='domain.de'}

    \config{WEBMAIL\_x\_SERVER\_DOMAIN\_CHECK}{WEBMAIL\_x\_SERVER\_DOMAIN\_CHECK}{WEBMAILxSERVERDOMAINCHECK}
        "Uber diesen Parameter kann die Pr"ufung der Zugriffsdomain
        beim Zugriff auf alle SquirrelMail Seiten aktiviert werden.
        Dies kann helfen sicher zu stellen, dass die Seitenzugriffe
        vom selben Server und nicht von einem Fremdserver kommen
        (Dies passiert "ublicherweise bei XSS oder Phishing-Attacken).
        Weicht die beim Zugriff verwendete Domain von der "uber den
        Parameter \jump{WEBMAILxSERVERDOMAIN}{WEBMAIL\_x\_SERVER\_DOMAIN}
        festgelegten Domain ab, so wird der Zugriff nach Ausgabe einer
        Meldung verweigert.\\
        \achtung{Diese Pr"ufungen sind nicht narrensicher und manche
        Browser k"onnen diese umgehen oder absichtlich keine
        Referal-Informationen senden (In diesem Fall wird die Pr"ufung
        der Zugriffsdomain stillschweigend "ubersprungen).
        Wird der Parameter auf den Wert `no' gesetzt, so wird diese
        zus"atzliche Pr"ufung deaktiviert.}

        G"ultige Werte: yes oder no

        Standardeinstellung: \texttt{WEBMAIL\_1\_SERVER\_DOMAIN\_CHECK='yes'}
\end{description}


    Die folgenden WEBMAIL\_x\_SERVER\_..-Parameter werden nur dann ausgewertet,
    wenn auf dem lokalen Rechner kein installiertes Mail- oder Vmail-Paket gefunden
    wird. Sie erm"oglichen den Zugriff auf einen Mailserver, welcher auf einem
    anderen Rechner betrieben wird.


\begin{description}
    \config{WEBMAIL\_x\_SERVER\_IMAP\_HOST}{WEBMAIL\_x\_SERVER\_IMAP\_HOST}{WEBMAILxSERVERIMAPHOST}
        "Uber diesen Parameter wird der Servername des Rechners festgelegt
        welcher die IMAP-Postf"acher verwaltet. Optional kann, durch einen
        Doppelpunkt getrennt, ein vom Standard abweichender tcp-Port
        konfiguriert werden.

        G"ultige Werte: Domain-Name zzgl. optionalem tcp-Port

        Standardeinstellung: \texttt{WEBMAIL\_1\_SERVER\_IMAP\_HOST='localhost'}

    \config{WEBMAIL\_x\_SERVER\_IMAP\_AUTH}{WEBMAIL\_x\_SERVER\_IMAP\_AUTH}{WEBMAILxSERVERIMAPAUTH}
        "Uber diesen Parameter kann die Authentifizierungsmethode festgelegt
        werden, welche beim Zugriff auf einen entfernten IMAP-Server verwendet
        werden soll.\\
        \hinweis{Ist auf dem entfernten Mailserver das mail-Paket installiert
            und wurde dort der Parameter MAIL\_USER\_USE\_MAILONLY\_PASSWORDS='yes'
            gesetzt, so muss hier `md5' (cram-md5), ansonsten `login' eingestellt
            werden.}

        \hinweis{Ist auf dem entfernten Mailserver das vmail-Paket installiert
            so muss hier `login' eingestellt werden.}

        G"ultige Werte: md5, digest, login

        Standardeinstellung: \texttt{WEBMAIL\_1\_SERVER\_IMAP\_AUTH='md5'}

    \config{WEBMAIL\_x\_SERVER\_IMAP\_TYPE}{WEBMAIL\_x\_SERVER\_IMAP\_TYPE}{WEBMAILxSERVERIMAPTYPE}
        "Uber diesen Parameter kann der IMAP-Servertyp eingestellt werden, zu
        welchem sich verbunden werden soll. Es kann zwischen den Typen `uw'
        (Mail-Paket) und `courier' (Vmail-Paket f"ur eisfair-1) bzw. `dovecot'
        (Vmail-Paket f"ur eisfair-2) gew"ahlt werden.

        G"ultige Werte: uw, courier oder dovecot

        Standardeinstellung: \texttt{WEBMAIL\_1\_SERVER\_IMAP\_TYPE='uw'}

     \config{WEBMAIL\_x\_SERVER\_IMAP\_TRANSPORT}{WEBMAIL\_x\_SERVER\_IMAP\_TRANSPORT}{WEBMAILxSERVERIMAPTRANSPORT}
        "Uber diesen Parameter kann die verschl"usselte Kommunikation mit dem
        IMAP-Prozess aktiviert werden. Wird der Parameter auf den Wert `default'
        gesetzt, so wird "uber eine unverschl"usselte Verbindung kommuniziert.

        G"ultige Werte: tls oder default

        Standardeinstellung: \texttt{WEBMAIL\_1\_SERVER\_IMAP\_TRANSPORT='default'}

    \config{WEBMAIL\_x\_SERVER\_SMTP\_HOST}{WEBMAIL\_x\_SERVER\_SMTP\_HOST}{WEBMAILxSERVERSMTPHOST}
        "Uber diesen Parameter wird der Servername des Rechners festgelegt auf welchem
        der SMTP-Server l"auft. Optional kann, durch einen Doppelpunkt getrennt, ein
        vom Standard abweichender tcp-Port konfiguriert werden.

        G"ultige Werte: Domain-Name zzgl. optionalem tcp-Port

        Standardeinstellung: \texttt{WEBMAIL\_1\_SERVER\_SMTP\_HOST='localhost'}

    \config{WEBMAIL\_x\_SERVER\_SMTP\_TYPE}{WEBMAIL\_x\_SERVER\_SMTP\_TYPE}{WEBMAILxSERVERSMTPTYPE}
        "Uber diesen Parameter kann die Authentifizierungsmethode festgelegt werden,
        welche beim Zugriff auf einen entfernten SMTP-Server verwendet werden soll.\\
        \hinweis{Ist auf dem entfernten Mailserver das mail-Paket installiert
            und wurde dort der Parameter SMTP\_AUTH\_TYPE='none' gesetzt, so muss hier
            ebenfalls der Wert 'none' eingestellt werden. Wurde der Parameter
            SMTP\_AUTH\_TYPE='user' oder 'user\_light' gesetzt, so muss bei gesetztem
            MAIL\_USER\_USE\_MAILONLY\_PASSWORDS='yes' `md5' (cram-md5), ansonsten
            `login' eingestellt werden.}
        \hinweis{Ist auf dem entfernten Mailserver das vmail-Paket installiert
            so muss hier `login' eingestellt werden.}

        G"ultige Werte: md5, digest, login, none

        Standardeinstellung: \texttt{WEBMAIL\_1\_SERVER\_SMTP\_AUTH='md5'}

     \config{WEBMAIL\_x\_SERVER\_SMTP\_TRANSPORT}{WEBMAIL\_x\_SERVER\_SMTP\_TRANSPORT}{WEBMAILxSERVERSMTPTRANSPORT}
        "Uber diesen Parameter kann die verschl"usselte Kommunikation mit dem
        SMTP-Server aktiviert werden. Wird der Parameter auf den Wert `default'
        gesetzt, so wird "uber eine unverschl"usselte Verbindung kommuniziert.

        G"ultige Werte: tls oder default

        Standardeinstellung: \texttt{WEBMAIL\_1\_SERVER\_SMTP\_TRANSPORT='default'}

    \config{WEBMAIL\_x\_ORGA\_NAME}{WEBMAIL\_x\_ORGA\_NAME}{WEBMAILxORGANAME}
        "Uber diesen Parameter kann an verschiedenen Stellen in der Webmail-Oberfl"ache der
        Firmenname, an Stelle von `eisfair-Webmail', eingeblendet werden.

        G"ultige Werte: Text

        Standardeinstellung: \texttt{WEBMAIL\_1\_ORGA\_NAME='eisfair-Webmail'}

    \config{WEBMAIL\_x\_ORGA\_TITLE}{WEBMAIL\_x\_ORGA\_TITLE}{WEBMAILxORGATITLE}
        "Uber diesen Parameter kann festgelegt werden, was im Browser-Titel, an Stelle
        von `eisfair-Webmail', angezeigt werden soll.

        G"ultige Werte: Text und Variablen

        Standardeinstellung: \texttt{WEBMAIL\_1\_ORGA\_TITLE='eisfair-Webmail'}

    \config{WEBMAIL\_x\_ORGA\_LOGO}{WEBMAIL\_x\_ORGA\_LOGO}{WEBMAILxORGALOGO}
        "Uber diesen Parameter wird das Firmen-Logo festgelegt, welches an verschiedenen
        Stellen der Webmail-Oberfl"ache angezeigt wird. Es kann entweder ein relativer
        oder ein absoluter Verzeichnispfad angegeben werden.

        G"ultige Werte: Pfad- und Dateiname

        Standardeinstellung: \texttt{WEBMAIL\_1\_ORGA\_LOGO='images/eisfair\_logo\_gross.png'}

    \config{WEBMAIL\_x\_ORGA\_LOGO\_WIDTH}{WEBMAIL\_x\_ORGA\_LOGO\_WIDTH}{WEBMAILxORGALOGOWIDTH}
        Dieser Parameter legt fest, mit welcher Breite das "uber \jump{WEBMAILxORGALOGO}{WEBMAIL\_x\_ORGA\_LOGO}
        festgelegte Logo angezeigt werden soll.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_1\_ORGA\_LOGO\_WIDTH='435'}

    \config{WEBMAIL\_x\_ORGA\_LOGO\_HEIGHT}{WEBMAIL\_x\_ORGA\_LOGO\_HEIGHT}{WEBMAILxORGALOGOHEIGHT}
        Dieser Parameter legt fest, mit welcher H"ohe das "uber \jump{WEBMAILxORGALOGO}{WEBMAIL\_x\_ORGA\_LOGO}
        festgelegte Logo angezeigt werden soll.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_1\_ORGA\_LOGO\_HEIGHT='168'}

     \config{WEBMAIL\_x\_ORGA\_SIGNOUT\_PAGE}{WEBMAIL\_x\_ORGA\_SIGNOUT\_PAGE}{WEBMAILxORGASIGNOUTPAGE}
        Dieser Parameter legt fest auf welche Seite der Anwender, nach Bet"atigen des
        `Abmelde'-Knopfes umgelenkt werden soll. Wird der Parameter leer gelassen, so
        wird die Standardabmeldeseite verwendet.

        G"ultige Werte: Pfad- und Dateiname

        Standardeinstellung: \texttt{WEBMAIL\_1\_ORGA\_SIGNOUT\_PAGE=$''$}

    \config{WEBMAIL\_x\_ORGA\_DEF\_LANGUAGE}{WEBMAIL\_x\_ORGA\_DEF\_LANGUAGE}{WEBMAILxORGADEFLANGUAGE}
        Dieser Parameter legt fest, welche Standardsprache verwendet werden soll, wenn
        dies von SquirrelMail nicht automatisch, z.B. "Uber die Browser-Konfiguration,
        erkannt wird. Bitte den korrekten L"anderkode f"ur die gew"unschte Sprache verwenden.
        Der Wert `de\_DE' steht hierbei f"ur die deutsche Sprache.  Es kann zur Zeit
        zwischen folgenden L"anderkodes gew"ahlt werden:\\
        ar, bg\_BG, ca\_ES, cs\_CZ, cy\_GB, da\_DK, de\_DE, el\_GR, es\_ES,
        et\_EE, fi\_FI, fo\_FO, fr\_FR, he\_IL, hr\_HR, hu\_HU, id\_ID, is\_IS,
        it\_IT, ja\_JP, ko\_KR, lt\_LT, ms\_MY, nl\_NL, nn\_NO, no\_NO, pl\_PL,
        pt\_BR, pt\_PT, ro\_RO, ru\_RU, sk\_SK, sl\_SI, sr\_YU, sv\_SE, th\_TH,
        tr\_TR, uk\_UA, vi\_VN, zh\_CN, zh\_TW

        G"ultige Werte: Locale-Kennung

        Standardeinstellung: \texttt{WEBMAIL\_1\_ORGA\_DEF\_LANGUAGE='de\_DE'}

    \config{WEBMAIL\_x\_ORGA\_TOP\_FRAME}{WEBMAIL\_x\_ORGA\_TOP\_FRAME}{WEBMAILxORGATOPFRAME}
        Standardm"a"sig wird SquirrelMail im kompletten Browser-Fenster angezeigt. Soll die
        Bildschirmausgabe in einen bestimmten Rahmen einer HTML-Seite angezeigt werden,
        so wird der Rahmenname "uber diesen Parameter festgelegt.

        G"ultige Werte: Rahmenname

        Standardeinstellung: \texttt{WEBMAIL\_1\_ORGA\_TOP\_FRAME='\_top'}

    \config{WEBMAIL\_x\_ORGA\_PROVIDER\_NAME}{WEBMAIL\_x\_ORGA\_PROVIDER\_NAME}{WEBMAILxORGAPROVIDERNAME}
        "Uber diesen Parameter wird der Name des Providers konfiguriert, dessen Link im
        Men"u von Squirrelmail angezeigt werden soll.

        G"ultige Werte: Provider Name

        Standardeinstellung: \texttt{WEBMAIL\_1\_ORGA\_PROVIDER\_NAME='eisfair'}

     \config{WEBMAIL\_x\_ORGA\_PROVIDER\_URL}{WEBMAIL\_x\_ORGA\_PROVIDER\_URL}{WEBMAILxORGAPROVIDERURL}
        "Uber diesen Parameter wird die URL des Providers konfiguriert, dessen Name "uber
        den Parameter \jump{WEBMAILxORGAPROVIDERNAME}{WEBMAIL\_x\_ORGA\_PROVIDER\_NAME} festgelegt wurde.

        G"ultige Werte: URL

        Standardeinstellung: \texttt{WEBMAIL\_1\_ORGA\_PROVIDER\_URL='https://www.eisfair.org/'}

    \config{WEBMAIL\_x\_FOLDER\_MOVE\_MSGS\_TO\_TRASH}{WEBMAIL\_x\_FOLDER\_MOVE\_MSGS\_TO\_TRASH}{WEBMAILxFOLDERMOVEMSGSTOTRASH}
        Wird dieser Parameter auf `yes' gestellt, so werden Nachrichten beim L"oschen in
        den Papierkorb verschoben und nicht direkt gel"oscht.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_FOLDER\_MOVE\_MSGS\_TO\_TRASH='yes'}

    \config{WEBMAIL\_x\_FOLDER\_MOVE\_MSGS\_TO\_SEND}{WEBMAIL\_x\_FOLDER\_MOVE\_MSGS\_TO\_SEND}{WEBMAILxFOLDERMOVEMSGSTOSEND}
        Wird dieser Parameter auf `yes' gestellt, so werden Nachrichten nach dem Versand
        in den Gesendet-Ordner verschoben und nicht direkt gel"oscht.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_FOLDER\_MOVE\_MSGS\_TO\_SEND='yes'}

     \config{WEBMAIL\_x\_FOLDER\_MOVE\_MSGS\_TO\_DRAFT}{WEBMAIL\_x\_FOLDER\_MOVE\_MSGS\_TO\_DRAFT}{WEBMAILxFOLDERMOVEMSGSTODRAFT}
        Wird dieser Parameter auf `yes' gestellt, so wird beim Abbrechen der
        Nachrichtenbearbeitung abgefragt, ob diese im Entw"urfe-Ordner gespeichert werden
        soll.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_FOLDER\_MOVE\_MSGS\_TO\_DRAFT='yes'}

    \config{WEBMAIL\_x\_FOLDER\_SPECIAL\_LIST\_FIRST}{WEBMAIL\_x\_FOLDER\_SPECIAL\_LIST\_FIRST}{WEBMAILxFOLDERSPECIALLISTFIRST}
        Wird dieser Parameter auf `yes' gestellt, so werden die `speziellen' Mail-Ordner,
        wie z.B. INBOX-, Gesendet- oder Entw"urfe-Ordner, am Anfang der Ordnerliste angezeigt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_FOLDER\_SPECIAL\_LIST\_FIRST='yes'}

    \config{WEBMAIL\_x\_FOLDER\_SPECIAL\_USE\_COLOR}{WEBMAIL\_x\_FOLDER\_SPECIAL\_USE\_COLOR}{WEBMAILxFOLDERSPECIALUSECOLOR}
        Wird dieser Parameter auf `yes' gestellt, so werden die `speziellen' Mail-Ordner,
        wie z.B. INBOX-, Gesendet- oder Entw"urfe-Ordner, in einer gesonderten Farbe angezeigt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_FOLDER\_SPECIAL\_USE\_COLOR='yes'}

    \config{WEBMAIL\_x\_FOLDER\_AUTO\_EXPUNGE}{WEBMAIL\_x\_FOLDER\_AUTO\_EXPUNGE}{WEBMAILxFOLDERAUTOEXPUNGE}
        Ein IMAP-Server handhabt das L"oschen von Nachrichten wie folgt: Erst wird die Nachricht
        nur zum L"oschen markiert, anschliessend endg"ultig gel"oscht. Wird dieser Parameter auf
        `yes' gesetzt, so werden Nachrichten von SquirrelMail direkt gel"oscht. Wird 'no' eingestellt,
        so werden diese nur zum L"oschen markiert.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_FOLDER\_AUTO\_EXPUNGE='yes'}

    \config{WEBMAIL\_x\_FOLDER\_UNSEEN\_NOTIFY}{WEBMAIL\_x\_FOLDER\_UNSEEN\_NOTIFY}{WEBMAILxFOLDERUNSEENNOTIFY}
        "Uber diesen Parameter wird festgelegt, in welchem Fall ein Anwender standardm"a"sig "uber
        neue Nachrichten informiert werden soll. Zur Auswahl stehen folgende Optionen:

        `none'  - keine Benachrichtigung. \\
        `inbox' - nur bei neuen Nachrichten im INBOX-Ordner benachrichtigen. \\
        `all'   - bei neuen Nachrichten in allen Ordnern benachrichtigen. \\

        Diese Einstellung kann von jedem Anwender individuell angepasst werden.

        G"ultige Werte: none, inbox, all

        Standardeinstellung: \texttt{WEBMAIL\_1\_FOLDER\_UNSEEN\_NOTIFY='inbox'}

    \config{WEBMAIL\_x\_FOLDER\_UNSEEN\_TYPE}{WEBMAIL\_x\_FOLDER\_UNSEEN\_TYPE}{WEBMAILxFOLDERUNSEENTYPE}
        "Uber diesen Parameter wird eingestellt, wie ungelesenen Nachrichten im linken Rahmen
        angezeigt werden sollen. Zur Auswahl stehen:

        `unseen' - nur ungelesene Nachrichten zeigen, z.B. (4) \\
        `both'   - ungelesene und gesamte Anzahl Nachrichten zeigen, z.B. (4/27) \\

        G"ultige Werte: unseen, both

        Standardeinstellung: \texttt{WEBMAIL\_1\_FOLDER\_UNSEEN\_TYPE='both'}

    \config{WEBMAIL\_x\_GENERAL\_DEF\_CHARSET}{WEBMAIL\_x\_GENERAL\_DEF\_CHARSET}{WEBMAILxGENERALDEFCHARSET}
        Dieser Parameter legt fest welcher Zeichensatz beim Versenden von Nachrichten und
        bei der HTML-Anzeige verwendet werden soll. Verwenden Sie an Stelle von `US\_ASCII'
        auf jeden Fall `UTF-8'. Um kyrillischen Text anzuzeigen stellen Sie `KOI8-R'
        ein, dies f"uhrt zu einer eindeutigen Geschwindigkeitssteigerung.

        G"ultige Werte: utf-8, iso-8859-1, koi8-r, ...

        Standardeinstellung: \texttt{WEBMAIL\_1\_GENERAL\_DEF\_CHARSET='utf-8'}

     \config{WEBMAIL\_x\_GENERAL\_LEFT\_FRAME\_WIDTH}{WEBMAIL\_x\_GENERAL\_LEFT\_FRAME\_WIDTH}{WEBMAILxGENERALLEFTFRAMEWIDTH}
        "Uber diesen Parameter wird die Breite des linken Ordnerrahmens, in Pixel, festgelegt.
        Diese Einstellung kann von jedem Anwender individuell angepasst werden.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_1\_GENERAL\_LEFT\_FRAME\_WIDTH='200'}

    \config{WEBMAIL\_x\_GENERAL\_ALLOW\_PRIORITY\_USE}{WEBMAIL\_x\_GENERAL\_ALLOW\_PRIORITY\_USE}{WEBMAILxGENERALALLOWPRIORITYUSE}
        Wird dieser Parameter auf `yes' gesetzt, so kann jeder Anwender die Priorit"at von zu
        versendenden Nachrichten vorgeben.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_GENERAL\_ALLOW\_PRIORITY\_USE='yes'}

    \config{WEBMAIL\_x\_GENERAL\_ALLOW\_RECEIPTS\_USE}{WEBMAIL\_x\_GENERAL\_ALLOW\_RECEIPTS\_USE}{WEBMAILxGENERALALLOWRECEIPTSUSE}
        Wird dieser Parameter auf `yes' gesetzt, so kann jeder Anwender Lese- und
        Zustellbenachrichtigungen f"ur gesendete Nachrichten anfordern.

        G"ultige Werte: yes, no

        Standardeinstellung:  \texttt{WEBMAIL\_1\_GENERAL\_ALLOW\_RECEIPTS\_USE='yes'}

     \config{WEBMAIL\_x\_GENERAL\_ALLOW\_IDENTITY\_EDIT}{WEBMAIL\_x\_GENERAL\_ALLOW\_IDENTITY\_EDIT}{WEBMAILxGENERALALLOWIDENTITYEDIT}
        Wird dieser Parameter auf `yes' gesetzt, so ist es dem Anwender gestattet seinen
        Anwendernamen und seine E-Mail-Adresse zu bearbeiten.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_GENERAL\_ALLOW\_IDENTITY\_EDIT='yes'}

    \config{WEBMAIL\_x\_FONTSETS\_DEFAULT}{WEBMAIL\_x\_FONTSETS\_DEFAULT}{WEBMAILxFONTSETSDEFAULT}
        "Uber diesen Parameter kann man das Schriftartenset festlegen,
        welches standardm"a"sig von den Anwendern genutzt werden soll.

        G"ultige Werte: Schriftart

        Standardeinstellung: \texttt{WEBMAIL\_1\_FONTSETS\_DEFAULT='???'}

    \index{WEBMAIL\_x\_FONTSETS\_y\_NAME}
    \index{WEBMAIL\_x\_FONTSETS\_y\_FONTS}
    \config{WEBMAIL\_x\_FONTSETS\_N / WEBMAIL\_x\_FONTSETS\_y\_NAME / WEBMAIL\_x\_FONTSETS\_y\_FONTS}{WEBMAIL\_x\_FONTSETS\_N}{WEBMAILxFONTSETSN}
        "Uber diesen Parameter wird die Anzahl der verf"ugbaren Schriftartensets,
        deren Name und die in den Sets enthaltenen Schriften festgelegt.

        G"ultige Werte: Zahl

        Beispiel:

        \texttt{WEBMAIL\_1\_FONTSETS\_N='1'\\
                WEBMAIL\_1\_FONTSETS\_1\_NAME='tahoma'\\
                WEBMAIL\_1\_FONTSETS\_1\_FONTS='tahoma,sans-serif'}

    \config{WEBMAIL\_x\_ICONS\_USE\_ALL}{WEBMAIL\_x\_ICONS\_USE\_ALL}{WEBMAILxICONSUSEALL}
        Wird dieser Parameter auf `yes' gesetzt, so werden alle zur Verf"ugung
        stehenden Icon-Themen aktiviert. Wird dieser Parameter auf `no' gesetzt,
        so k"onnen "uber die Parameter WEBMAIL\_x\_ICONS\_N bzw. WEBMAIL\_x\_ICONS\_y\_DIRNAME
        Themen individuell aktiviert werden.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_ICONS\_USE\_ALL='yes'}

    \config{WEBMAIL\_x\_ICONS\_DEFAULT}{WEBMAIL\_x\_ICONS\_DEFAULT}{WEBMAILxICONSDEFAULT}
        "Uber diesen Parameter kann man das Icon-Thema festlegen, welches
        standardm"a"sig von einem Anwender verwendet werden soll, wenn dieser
        kein individuelles Thema festgelegt hat.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_1\_ICONS\_DEFAULT='1'}

    \config{WEBMAIL\_x\_ICONS\_FALLBACK}{WEBMAIL\_x\_ICONS\_FALLBACK}{WEBMAILxICONSFALLBACK}
        "Uber diesen Parameter kann man das Icon-Thema festlegen, welches
        von einem Anwender verwendet werden soll, wenn ein Icon nicht im
        aktuellen Thema gefunden wird.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_1\_ICONS\_FALLBACK='3'}

    \index{WEBMAIL\_x\_ICONS\_y\_DIRNAME}
    \config{WEBMAIL\_x\_ICONS\_N / WEBMAIL\_x\_ICONS\_y\_DIRNAME}{WEBMAIL\_x\_ICONS\_N}{WEBMAILxICONSN}
        "Uber diesen Parameter wird die Anzahl der verf"ugbaren Icon-Themen
        und der Verzeichnisname festgelegt in welchem sich diese befinden.
        Der Verzeichnispfad wird immer ausgehend vom Squirellmail-Stammverzeichnis
        angegeben.

        G"ultige Werte: Zahl

        Beispiel:
        \texttt{WEBMAIL\_1\_ICONS\_N='1'\\
                WEBMAIL\_1\_ICONS\_1\_DIRNAME='images/themes/xp/'}

    \config{WEBMAIL\_x\_TMPLSETS\_USE\_ALL}{WEBMAIL\_x\_TMPLSETS\_USE\_ALL}{WEBMAILxTMPLSETSUSEALL}
        Wird dieser Parameter auf `yes' gesetzt, so werden alle zur
        Verf"ugung stehenden Skin-Themen aktiviert. Wird dieser
        Parameter auf `no' gesetzt, so k"onnen "uber die Parameter
        WEBMAIL\_x\_TMPLSETS\_N bzw. WEBMAIL\_x\_TMPLSETS\_y\_DIRNAME
        Themen individuell aktiviert werden.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_TMPLSETS\_USE\_ALL='yes'}

    \config{WEBMAIL\_x\_TMPLSETS\_DEFAULT}{WEBMAIL\_x\_TMPLSETS\_DEFAULT}{WEBMAILxTMPLSETSDEFAULT}
        "Uber diesen Parameter kann man das Skin-Thema festlegen, welches
        standardm"a"sig von einem Anwender verwendet werden soll, wenn dieser
        kein individuelles Thema festgelegt hat.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_1\_TMPLSETS\_DEFAULT='1'}

    \config{WEBMAIL\_x\_TMPLSETS\_FALLBACK}{WEBMAIL\_x\_TMPLSETS\_FALLBACK}{WEBMAILxTMPLSETSFALLBACK}
        "Uber diesen Parameter kann man das Skin-Thema festlegen, welches
        von einem Anwender verwendet werden soll, wenn ein Skin nicht im
        aktuellen Thema gefunden wird.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_1\_TMPLSETS\_FALLBACK='3'}

    \index{WEBMAIL\_x\_TMPLSETS\_y\_DIRNAME}
    \config{WEBMAIL\_x\_TMPLSETS\_N / WEBMAIL\_x\_TMPLSETS\_y\_DIRNAME}{WEBMAIL\_x\_TMPLSETS\_N}{WEBMAILxTMPLSETSN}
        "Uber diesen Parameter wird die Anzahl der verf"ugbaren Skin-Themen
        und der Verzeichnisname festgelegt in welchem sich diese befinden.
        Der Verzeichnispfad wird immer ausgehend vom Squirellmail-Stammverzeichnis
        angegeben.

        G"ultige Werte: Zahl

        Beispiel:

        \texttt{WEBMAIL\_1\_TMPLSETS\_N='1'\\
                WEBMAIL\_1\_TMPLSETS\_1\_DIRNAME='default'}

    \config{WEBMAIL\_x\_USERTHEMES\_USE\_ALL}{WEBMAIL\_x\_USERTHEMES\_USE\_ALL}{WEBMAILxUSERTHEMESUSEALL}
        Wird dieser Parameter auf `yes' gesetzt, so werden alle zur
        Verf"ugung stehenden SquirrelMail-Themen aktiviert. Wird dieser
        Parameter auf `no' gesetzt, so k"onnen "uber die Parameter
        WEBMAIL\_x\_USERTHEMES\_N bzw. WEBMAIL\_x\_USERTHEMES\_y\_FILENAME
        Themen individuell aktiviert werden.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_USERTHEMES\_USE\_ALL='yes'}

    \config{WEBMAIL\_x\_USERTHEMES\_DEFAULT}{WEBMAIL\_x\_USERTHEMES\_DEFAULT}{WEBMAILxUSERTHEMESDEFAULT}
        "Uber diesen Parameter kann das Standardthema festgelegt werden
        welches in Squirrelmail verwendet werden soll. Ein Anwender kann
        diese Einstellung individuell "andern. Wird als Wert `0'
        eingegeben, so wird das interne `Standardthema' von
        Squirrelmail verwendet.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_1\_USERTHEMES\_DEFAULT='0'}

    \config{WEBMAIL\_x\_USERTHEMES\_N / WEBMAIL\_x\_USERTHEMES\_y\_DIRNAME}{WEBMAIL\_x\_USERTHEMES\_N}{WEBMAILxUSERTHEMESN}
        "Ueber den Parameter WEBMAIL\_x\_USERTHEMES\_N wird die Anzahl
        der zu aktivierenden SquirrelMail-Themen eingestellt. "Uber
        WEBMAIL\_x\_USERTHEMES\_x\_DIRNAME werden die Namen der zu
        aktivierenden Themen festgelegt. Der Verzeichnispfad wird immer
        ausgehend vom Squirellmail-Stammverzeichnis/css angegeben.

        G"ultige Werte: Zahl bzw. Dateiname

        Beispiel:

        \texttt{WEBMAIL\_1\_USERTHEMES\_N='0'\\
                WEBMAIL\_1\_USERTHEMES\_1\_DIRNAME='default\_theme'\\
                WEBMAIL\_1\_USERTHEMES\_2\_DIRNAME='alien\_glow'\\
                WEBMAIL\_1\_USERTHEMES\_3\_DIRNAME='black\_bean\_burrito\_theme'\\
                WEBMAIL\_1\_USERTHEMES\_4\_DIRNAME='blue\_grey\_theme'}

     \config{WEBMAIL\_PLUGINS\_x\_USE\_ALL}{WEBMAIL\_x\_PLUGINS\_USE\_ALL}{WEBMAILxPLUGINSUSEALL}
        Wird dieser Parameter auf `yes' gesetzt, so werden alle zur Verf"ugung stehenden
        SquirrelMail-Plugins aktiviert. Wird dieser Parameter auf `no' gesetzt, so k"onnen
        "uber den Parameter \jump{WEBMAILxPLUGINSN}{WEBMAIL\_x\_PLUGINS\_N} bzw. \jump{WEBMAILxPLUGINSN}{WEBMAIL\_x\_PLUGINS\_y\_DIRNAME} Plugins
        individuell aktiviert werden.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_x\_PLUGINS\_USE\_ALL='no'}

    \config{WEBMAIL\_x\_PLUGINS\_N / WEBMAIL\_x\_PLUGINS\_y\_DIRNAME}{WEBMAIL\_x\_PLUGINS\_N / WEBMAIL\_x\_PLUGINS\_y\_DIRNAME}{WEBMAILxPLUGINSN}
        "Uber den Parameter WEBMAIL\_x\_PLUGINS\_N wird die Anzahl der zu aktivierenden
        SquirrelMail-Plugins eingestellt. "Uber WEBMAIL\_x\_PLUGINS\_y\_DIRNAME werden die Namen
        der zu aktivierenden Plugins festgelegt.  Neue Plugins m"ussen unter dem Verzeichnis\\
        `/var/www/htdocs/webmail/plugins' abgelegt werden.

        G"ultige Werte: Zahl bzw. Verzeichnisname

        Beispiel:

        \texttt{WEBMAIL\_1\_PLUGINS\_N='5' \\
                WEBMAIL\_1\_PLUGINS\_1\_DIRNAME='calendar' \\
                WEBMAIL\_1\_PLUGINS\_2\_DIRNAME='newmail' \\
                WEBMAIL\_1\_PLUGINS\_3\_DIRNAME='squirrel\_logger' \\
                WEBMAIL\_1\_PLUGINS\_4\_DIRNAME='show\_user\_and\_ip' \\
                WEBMAIL\_1\_PLUGINS\_5\_DIRNAME='wetteronline'}

    \config{WEBMAIL\_x\_PLUGINS\_ADMINUSER}{WEBMAIL\_x\_PLUGINS\_ADMINUSER}{WEBMAILxPLUGINSADMINUSER}
        "Uber diesen Parameter wird der f"ur das Administrator-Plugin ben"otigte Name des
        Administrator festgelegt, welcher aus der Entfernung die Webmail-Konfiguration
        "andern k"onnen soll.

        G"ultige Werte: leer, Username

        Standardeinstellung: \texttt{WEBMAIL\_1\_PLUGINS\_ADMINUSER=$''$}

    \config{WEBMAIL\_x\_GLOBADDR\_FILE\_WRITEABLE}{WEBMAIL\_x\_GLOBADDR\_FILE\_WRITEABLE}{WEBMAILxGLOBADDRFILEWRITEABLE}
        Wird dieser Parameter auf `yes' gesetzt, so wird das "Andern des globalen
        Adressbuchs zugelassen. Wird der Parameter auf `no' gesetzt, so wird das
        Bearbeiten des Adressbuchs unterbunden.
        \hinweis{Um das globale Adressbuch bearbeiten zu k"onnen, erh"alt der
            Apache-Systembenutzer 'wwwrun' Schreibrechte auf die Adressdatei!}

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{WEBMAIL\_1\_GLOBADDR\_FILE\_WRITEABLE='no'}

    \config{WEBMAIL\_x\_GLOBADDR\_FILE\_N}{WEBMAIL\_x\_GLOBADDR\_FILE\_N}{WEBMAILxGLOBADDRFILEN}
        "Uber diesen Parameter wird die Anzahl der vorgegebenen Eintr"age f"ur das globale
        Adressbuch eingestellt. Wird dieser Wert auf `0' gesetzt, so wird kein globales
        Adressbuch verwendet.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_1\_GLOBADDR\_FILE\_N='0'}

    \config{WEBMAIL\_x\_GLOBADDR\_FILE\_x\_NICKNAME}{WEBMAIL\_x\_GLOBADDR\_FILE\_y\_NICKNAME}{WEBMAILxGLOBADDRFILEyNICKNAME}
        "Uber diesen Parameter wird das K"urzel eines globalen Adressbucheintrages festgelegt.

        G"ultige Werte: K"urzel

        Beispiel: \texttt{WEBMAIL\_1\_GLOBADDR\_FILE\_1\_NICKNAME='tommy'}

    \config{WEBMAIL\_x\_GLOBADDR\_FILE\_y\_FIRSTNAME}{WEBMAIL\_x\_GLOBADDR\_FILE\_y\_FIRSTNAME}{WEBMAILxGLOBADDRFILEyFIRSTNAME}
        "Uber diesen Parameter wird der Vorname eines globalen Adressbucheintrages festgelegt.

        G"ultige Werte: Vorname

        Beispiel: \texttt{WEBMAIL\_1\_GLOBADDR\_FILE\_1\_FIRSTNAME='Thomas'}

    \config{WEBMAIL\_x\_GLOBADDR\_FILE\_y\_LASTNAME}{WEBMAIL\_x\_GLOBADDR\_FILE\_y\_LASTNAME}{WEBMAILxGLOBADDRFILEyLASTNAME}
        "Uber diesen Parameter wird der Nachname eines globalen Adressbucheintrages festgelegt.

        G"ultige Werte: Nachname

        Beispiel: \texttt{WEBMAIL\_1\_GLOBADDR\_FILE\_1\_LASTNAME='Mueller'}

    \config{WEBMAIL\_x\_GLOBADDR\_FILE\_y\_EMAIL}{WEBMAIL\_x\_GLOBADDR\_FILE\_y\_EMAIL}{WEBMAILxGLOBADDRFILEyEMAIL}
        "Uber diesen Parameter wird die E-Mail-Adresse eines globalen Adressbucheintrages festgelegt.

        G"ultige Werte: E-Mail-Adresse

        Beispiel: \texttt{WEBMAIL\_1\_GLOBADDR\_FILE\_1\_EMAIL='tommy@domain.de'}

    \config{WEBMAIL\_x\_GLOBADDR\_FILE\_y\_INFO}{WEBMAIL\_x\_GLOBADDR\_FILE\_y\_INFO}{WEBMAILxGLOBADDRFILEyINFO}
        "Uber diesen Parameter werden zus"atzliche Informationen eines globalen Adressbucheintrages festgelegt.

        G"ultige Werte: Text

        Beispiel: \texttt{WEBMAIL\_1\_GLOBADDR\_FILE\_1\_INFO='WebAdmin'}

        \hinweis{Will man eine gro"se Anzahl von Eintr"agen anlegen, so ist
            es m"oglich diese "uber eine csv-Datei der aktuellen Konfigurationsdatei
            hinzuzuf"ugen. Hierzu kopiert man eine Datei `global\_addresses.csv' in
            das Verzeichnis /var/webmail und ruft das Programm
            `/var/install/bin/webmail-update import' auf.\\
            Eine bestehende User-Liste kann in eine Datei `global\_addresses.csv'
            im Verzeichnis /var/webmail exportiert werden, indem man das Programm
            `/var/install/bin/webmail-update export' aufruft.}

        Die csv-Datei muss wie folgt aufgebaut sein:\\\\
        \texttt{\#nick,firstname,lastname,email address,comment\\
                nick1,firstname1,lastname1,email address1,comment1\\
                nick2,firstname2,lastname2,email address2,comment2}

    \config{WEBMAIL\_x\_GLOBADDR\_LDAP\_N}{WEBMAIL\_x\_GLOBADDR\_LDAP\_N}{WEBMAILxGLOBADDRLDAPN}
        "Uber diesen Parameter wird die Anzahl der globalen LDAP-Adressb"ucher angegeben
        auf welche zugegriffen werden soll. Wird dieser Wert auf `0' gesetzt, so werden
        keine globalen LDAP-Adressb"ucher verwendet.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_1\_GLOBADDR\_LDAP\_N='0'}

    \config{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_ACTIVE}{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_ACTIVE}{WEBMAILxGLOBADDRLDAPyACTIVE}
        F"ur die Aktivierung des LDAP-basierten, globalen Adressbuches muss diese
        Variable lediglich auf den Wert `yes' gestellt werden. Die Einstellung
        `no' deaktiviert das Adressbuch.

        G"ultige Werte: yes, no

        Standardwert: \texttt{WEBMAIL\_1\_GLOBADDR\_LDAP\_1\_ACTIVE='no'}

    \config{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_INFO}{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_INFO}{WEBMAILxGLOBADDRLDAPyINFO}
        "Uber diesen Parameter kann ein beschreibender Text zum LDAP-Adressbuch
        festgelegt werden.

        G"ultige Werte: Text

        Beispiel: \texttt{WEBMAIL\_1\_GLOBADDR\_LDAP\_1\_INFO='My LDAP directory'}

    \config{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_BASEDN}{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_BASEDN}{WEBMAILxGLOBADDRLDAPBASEDyN}
        "Uber diesen Parameter wird die base-dn f"ur den Zugriff auf das globale
        LDAP-Adressbuch festgelegt.

        G"ultige Werte: base-dn

        Beispiel: \texttt{WEBMAIL\_1\_GLOBADDR\_LDAP\_1\_BASEDN='ou=contacts,ou=addressbook,dc=domain,dc=lan'}

    \config{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_HOST}{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_HOST}{WEBMAILxGLOBADDRLDAPyHOST}
        "Uber diesen Parameter wird der Name des Rechners festgelegt auf welchem
        der LDAP-Server l"auft.

        G"ultige Werte: Hostname oder IP-Adresse

        Standardwert: \texttt{WEBMAIL\_1\_GLOBADDR\_LDAP\_1\_HOST='localhost'}

        Beispiel:\\
        \texttt{WEBMAIL\_1\_GLOBADDR\_LDAP\_1\_HOST='ldap://myldap.local.lan:389'\\
                WEBMAIL\_1\_GLOBADDR\_LDAP\_1\_HOST='ldaps://myldap.local.lan'}

    \config{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_AUTH}{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_AUTH}{WEBMAILxGLOBADDRLDAPyAUTH}
        Falls eine Authentifikation gegen"uber des LDAP-Servers erforderlich ist,
        so muss diese Variable lediglich auf den Wert `yes' gestellt werden. Bei
        der Einstellung `no' wird keine Authentifizierung durchgef"uhrt.

        G"ultige Werte: yes, no

        Standardwert: \texttt{WEBMAIL\_1\_GLOBADDR\_LDAP\_1\_AUTH='no'}

    \config{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_BINDDN}{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_BINDDN}{WEBMAILxGLOBADDRLDAPyBINDDN}
        "Uber diesen Parameter wird die bind-dn f"ur die Authentifizierung am
        LDAP-Server festgelegt.

        G"ultige Werte: bind-dn

        Beispiel: \texttt{WEBMAIL\_1\_GLOBADDR\_LDAP\_1\_BINDDN='cn=ldapadmin,dc=domain,dc=lan'}

    \config{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_BINDPASS}{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_BINDPASS}{WEBMAILxGLOBADDRLDAPyBINDPASS}
        "Uber diesen Parameter wird das bind-Kennwort f"ur die Authentifizierung am
        LDAP-Server festgelegt.

        G"ultige Werte: Kennwort

        Beispiel: \texttt{WEBMAIL\_1\_GLOBADDR\_LDAP\_1\_BINDPASS='my-secret'}

    \config{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_PORT (Optionaler Parameter)}{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_PORT}{WEBMAILxGLOBADDRLDAPyPORT}
        "Uber diesen Parameter kann ein vom Standardport (389/tcp) abweichender
        tcp-Port f"ur den Zugriff auf den LDAP-Server festgelegt werden.

        Beispiel: \texttt{WEBMAIL\_1\_GLOBADDR\_LDAP\_1\_PORT='10389'}

    \config{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_CHARSET (Optionaler Parameter)}{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_CHARSET}{WEBMAILxGLOBADDRLDAPyCHARSET}
        "Uber diesen Parameter kann ein vom Standardzeichensatz, welcher "uber
        den Parameter \jump{WEBMAILxGENERALDEFCHARSET}{WEBMAIL\_x\_GENERAL\_DEF\_CHARSET}
        definiert wurde, abweichender Zeichensatz festgelegt werden.

        Beispiel: \texttt{WEBMAIL\_1\_GENERAL\_DEF\_CHARSET='utf-8'}

    \config{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_MAXROWS (Optionaler Parameter)}{WEBMAIL\_x\_GLOBADDR\_LDAP\_y\_MAXROWS}{WEBMAILxGLOBADDRLDAPyMAXROWS}
        "Uber diesen Parameter wird die maximale Anzahl von Antwortzeilen
        definiert die f"ur die Anzeige des Suchergebnisses genutzt werden,
        ansonsten wird der Standardwert '150' verwendet.

        Beispiel: \texttt{WEBMAIL\_1\_GLOBADDR\_LDAP\_1\_MAXROWS='200'}

    \config{WEBMAIL\_ATTACH\_CRON\_SCHEDULE}{WEBMAIL\_ATTACH\_CRON\_SCHEDULE}{WEBMAILATTACHCRONSCHEDULE}
        Hier wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall zur"uckgelassene
        Dateianh"ange aus dem Verzeichnis \\`/var/webmail/attach' gel"oscht werden sollen. Es werden
        grunds"atzlich nur Dateien, die "alter als 24 Stunden sind gel"oscht. Die f"unf Teilparameter
        haben dabei folgende Bedeutung:\\

        1 - Minuten, 2 - Stunden, 3 - Tag des Monats, 4 - Monat, 5 - Wochentag.

        D.h. bei Verwendung der Standardeinstellung wird jeden Tag um 03:07h
        die Bereinigung des Verzeichnisses durchgef"uhrt. Wer N"aheres "uber
        die verwendete Befehlssyntax erfahren m"ochte, sollte "uber eine
        Internet-Suchmaschine nach `man' und `crontab' suchen.

        G"ultige Werte: Crontab-spezifischer Parametereintrag

        Standardeinstellung: \texttt{WEBMAIL\_ATTACH\_CRON\_SCHEDULE='7 3 * * *'}

    \config{WEBMAIL\_LOG\_COUNT}{WEBMAIL\_LOG\_COUNT}{WEBMAILLOGCOUNT}
        "Uber diesen Parameter wird eingestellt, wie viele Logdateien
        vorgehalten werden sollen. Wird dieser Wert "uberschritten, so
        wird die "alteste Logdatei gel"oscht.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{WEBMAIL\_LOG\_COUNT='6'}

    \config{WEBMAIL\_LOG\_INTERVAL}{WEBMAIL\_LOG\_INTERVAL}{WEBMAILLOGINTERVAL}
        Dieser Parameter bestimmt in welchen Intervallen die Logdateien
        archiviert werden sollen. Zur Auswahl stehen die Schl"usselw"orter
        `daily' - t"aglich, `weekly' - w"ochentlich und `monthly - monatlich.

        G"ultige Werte: daily, weekly, monthly

        Standardeinstellung: \texttt{WEBMAIL\_LOG\_INTERVAL='weekly'}
\end{description}


\section{Die Plugins}

    "Uber SquirrelMail-Plugins k"onnen zus"atzliche Funktionen in das Webmail-Paket eingebunden
    werden. Hierbei obliegt es jedem Einzelnen zu entscheiden ob er ein Plugin, trotz eventueller
    Sicherheitsrisiken, aktivieren m"ochte oder nicht. Abh"angig von den jeweiligen Plugins kann
    es notwendig sein, dass zuvor andere Programme installiert werden m"ussen, die "uber das
    Webmail-Paket bzw. den \eisfair-Server nicht zur Verf"ugung gestellt werden.
    Es wird empfohlen, vor einer Aktivierung eines Plugins, die im jeweiligen Plugin-Verzeichnis
    vorhandene Dokumentation zu lesen und sich "uber die SquirrelMail-Webseite (\url{http://www.squirrelmail.org})
    weiter zu informieren. \\
    Standardm"a"sig werden einige Plugins mitgeliefert, deren Funktion hier kurz beschrieben wird.

\begin{description}
    \config{address\_add-Plugin}{address\_add-Plugin}{addressaddPlugin}
        Dieses Plugin erlaubt es auf einfache Weise den Absender einer Nachricht zum eigene
        Adressbuch hinzuzuf"ugen.

    \config{administrator-Plugin}{administrator-Plugin}{administratorPlugin}
        Dieses Plugin erlaubt es einem Administrator, dessen Login "uber den Parameter
        \jump{WEBMAILxPLUGINSADMINUSER}{WEBMAIL\_x\_PLUGINS\_ADMINUSER} festgelegt werden muss,
        die Konfiguration von Squirrelmail aus der Entfernung zu modifizieren. Bedenken Sie,
        dass die Verwendung dieses Plugins gewissen Sicherheitsrisiken mit sich bringen kann.

    \config{bug\_report-Plugin}{bug\_report-Plugin}{bugreportPlugin}
        Diese Plugin erm"oglicht es einem Anwender einen gefundenen Fehler, inklusiv zus"atzlicher
        Systeminformationen direkt an die SquirrelMail-Entwickler zu "ubermitteln.

    \config{calendar-Plugin}{calendar-Plugin}{calendar-Plugin}
        Dieses Plugin stellt einen einfachen Kalender mit Tages- und Monatsansicht zur Verf"ugung.
        Es ist m"oglich Termine anzulegen, zu l"oschen bzw. zu aktualisieren.

    \config{compatibility-Plugin}{compatibility-Plugin}{compatibilityPlugin}
        Dieses Plugin stellt Funktionen zur Verf"ugung, die es erm"oglichen auch Plugins
        zu verwenden, die f"ur fr"uhere Squirrelmail-Versionen geschrieben wurden. Es ist
        nicht notwendig dieses Plugin zur Auswahl hinzuzuf"ugen.

    \config{delete\_move\_next-Plugin}{delete\_move\_next-Plugin}{deletemovenextPlugin}
        Dieses Plugin erm"oglicht ein direkter Weiterbl"attern zur n"achsten Nachricht, ohne zuvor
        an den Nachrichtenanfang zur"uckspringen zu m"ussen. Au"serdem ist es m"oglich, direkt nach
        dem L"oschen oder Verschieben einer Nachricht die n"achste Nachricht anzusehen.

    \config{filters-Plugin}{filters-Plugin}{filtersPlugin}
        Dieses Plugin erm"oglicht es Filter-Regeln f"ur eingehende Nachrichten zu definieren.

    \config{info-Plugin}{info-Plugin}{infoPlugin}
        Dieses Plugin f"ugt dem Optionsmen"u eine `IMAP server information'-Seite hinzu. Ein
        Administrator kann "uber die vorgegebenen oder auch eigens einzugebende Befehle pr"ufen,
        welche Kommandos vom IMAP-Server akzeptiert werden bzw. welche Antworten von diesem
        angezeigt werden.

    \config{listcommands-Plugin}{listcommands-Plugin}{listcommandsPlugin}
        Dieses Plugin erg"anzt im Men"u zus"atzliche Befehle, die die Benutzung von Mailinglisten
        erleichtern.

    \config{message\_details-Plugin}{message\_details-Plugin}{messagedetailsPlugin}
        Dieses Plugin erm"oglicht es eine Nachrichten im Rohformat (RFC822) anzeigen zu lassen.

    \config{newmail-Plugin}{newmail-Plugin}{newmailPlugin}
        Dieses Plugin erm"oglicht eine akustische Benachrichtigung bei ungelesenen Nachrichten.

    \config{show\_user\_and\_ip-Plugin}{show\_user\_and\_ip-Plugin}{showuserandipPlugin}
        Dieses Plugin erm"oglicht die Anzeige des Benutzernamens und der aktuellen IP-Adresse
        im linken Ordnerrahmen.

    \config{squirrel\_logger-Plugin}{squirrel\_logger-Plugin}{squirrelloggerPlugin}
        Dieses Plugin schreibt Informationen "uber Anwender-Logins und Logouts in die Datei
        `/var/webmail/log/access\_log'. Bei Aktivierung dieses Plugins wird automatisch ein
        Logrotate-Eintrag angelegt, der die Datei in regelm"a"sigen Abst"anden archiviert.
        Siehe hierzu auch `\jump{WEBMAILLOGCOUNT}{WEBMAIL\_LOG\_COUNT}' und `\jump{WEBMAILLOGINTERVAL}{WEBMAIL\_LOG\_INTERVAL}'.

    \config{timeout\_user-Plugin}{timeout\_user-Plugin}{timeoutuserPlugin}
        Dieses Plugin erm"oglicht das automatisierte Ausloggen einen Anwenders
        nach Ablauf einer vorgegebenen Zeitspanne.

    \config{translate-Plugin}{translate-Plugin}{translatePlugin}
        Dieses Plugin erm"oglicht es, fremdsprachliche Nachrichten "uber "offentliche
        "Ubersetzungsdienste im Internet "ubersetzen zu lassen.

    \config{uw\_folders-Plugin}{uw\_folders-Plugin}{uwfoldersPlugin}
        Diese Plugin erm"oglicht die Anzeige der Shared- und Public-Ordner.

    \config{wetteronline-Plugin}{wetteronline-Plugin}{wetteronlinePlugin}
        Dieses Plugin erm"oglicht die Anzeige der voraussichtlichen Wetterlage im linken Ordnerrahmen.
\end{description}

\section{Die Sprachpakete}

    Es ist m"oglich bei Bedarf "uber das Men"u weitere Sprachdateien zu
    installieren bzw. bereits installierte Sprachdateien zu entfernen.
    Hierzu geht man wie folgt vor:\\

    \begin{itemize}
        \item 1. Herunterladen der gew"unschten Sprachdatei, im gz-Format, f"ur die
           aktuell verwendete Squirrelmail-Version und Ablage der Datei im
           Ordner /var/webmail.\\

           Beispiel: Download der Datei 'da\_DK-1.4.7-20060702.tar.gz'
                     oder 'all\_locales-1.4.7-20060702.tar.gz' von
                     \url{http://www.squirrelmail.org/download.php}\\

        \item 2. Aufruf der Men"ufunktion 'Install additional locale(s)', Auswahl
           des zu installierenden Sprachpaketes und Start der Installation.\\
    \end{itemize}

    F"ur die Deinstallation eines Sprachdatei w"ahlt man den entsprechenden
    Men"ueintrag 'Remove installed locale(s).\\


\section{Verschiedenes}

\begin{description}
    \config{PHP-Fehlermeldungen}{PHP\_Fehlermeldungen}{PHPFehlermeldungen}
        Werden z.B. in der Ordner-Funktion Meldungen "uber nicht initialisierte
        Variablen angezeigt, so sollte man pr"ufen, ob in der Datei `/etc/php.ini'
        der folgende Parameter gesetzt wurde:\\

    \begin{verbatim}
;error_reporting  =  E_ALL                               # alt
error_reporting  =  E_ALL & ~E_NOTICE & ~E_USER_NOTICE   # neu
    \end{verbatim}

    \config{PHP-LDAP-Zugriff}{PHP-LDAP-Zugriff}{PHPLDAPZugriffWEBMAIL110}
        Um verschl"usselt auf ein LDAP-Verzeichnis zugreifen zu k"onnen muss
        zuvor das ldapclient-Paket installiert werden.\\
        Wurde f"ur den LDAP-Server ein selbstsigniertes Zertifikat verwendet,
        so ist in der Konfiguration des ldapclient-Paketes sicher zu stellen,
        dass der Parameter LDAPCLIENT\_SERVER\_CERT\_CHECK dessen Verwendung
        nicht verweigert.  Wird des Wert des Parameters z.B. auf 'never'
        gesetzt, so erfolgt keine Pr"ufung der Zertifikatskette.
        Mittels des im Verzeichnis \texttt{/usr/share/doc/webmail}
        mitgelieferten PHP-Skripts 'test-ldap.php' kann der Zugriff auf einen
        LDAP-Server getestet werden. Das Skript ist hierzu in den Webserverpfad
        zu kopieren, die Zugriffsrechte und Skriptparameter anzupassen und dann
        "uber einen Webbrowser aufzurufen.
\end{description}
