<?xml version="1.0" encoding="iso-8859-1"?>
<chapter id="modules_webmail2">
  <title>The webmail module</title>
  
  <para>This is a small manual that should help you using the
    Webmail-Module. It is shown as the first email in the webmail module
    after setup, and can be found as a PDF file in
    <filename>modules/webmail/docu/</filename> as well. Written by Thomas
    Bley.
  </para>
  
  <para>The webmail module gives you access to your email. It can handle
    multiple accounts (both POP3 and IMAP), fully supports MIME, virus scanning
    and multiple folders. You can send messages to other moregroupware users
    directly (internal), can set up shared mail folders and more.
    Using the adress data from the contacts module you can send messages to
    your clients, friends, etc.
    Since version 0.68 you can access your imap account directly (without
    downloading all messages). You can even manage all your imap folders
    (including create, delete and rename functions)
  </para>
  
  <section id="modules_webmail2_maillist">
    <title>The mail list</title>
    
    <para>The maillist shows a list of all emails in the current
      folder. Opening the webmail-module the maillist shows your
      inbox.
    </para>
    
    <figure>
      <title>The mail list</title>
      <graphic fileref="images/modules/webmail2/maillist.png"/>
    </figure>
    
    <para>Important messages are flagged red, unread messages bold.</para>
    
    <para>The top line contains the username and the name of the folder on
      the left, the number of messages in the list plus the total number of
      messages are shown on the right. The middle is filled by the search
      form and "next", "previous"-links for navigating to the next or
      previous page of mails.
    </para>
    
    <para>The search function tries to find the entered term in the
      columns subject, from and to. Select "local folders" to search for the
      entered term in all local folders, choose "public folders" to search
      in all public folders or "this folder" in order to search only in the
      current folder. To get a regular view of all emails in a folder, click
      "Cancel". (Note: the search function is not available for imap-only access)
    </para>
    
    <para>The message that is currently displayed is marked by a lightgreen background-color:
      <graphic fileref="images/modules/webmail2/mes1.png"/>
    </para>
    
    <para>Clicking on the subject or the sender displays a message. Clicking
      on the background selects a message.
      <graphic fileref="images/modules/webmail2/mes2.png"/>
      When selecting this is indicated by a different background color:
      <graphic fileref="images/modules/webmail2/mes3.png"/>
    </para>
    
    <variablelist>
      <title>Symbols for emails</title>
      <varlistentry>
        <listitem>
        <para><inlinegraphic fileref="images/modules/webmail2/mail_0_0_0.png" /> A normal email</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para><inlinegraphic fileref="images/modules/webmail2/mail_1_0_0.png"/> An email with one or more attachments</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para><inlinegraphic fileref="images/modules/webmail2/mail_0_0_1.png"/> You've replied to this email</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para><inlinegraphic fileref="images/modules/webmail2/mail_0_1_0.png"/> You've forwarded this email</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para><inlinegraphic fileref="images/modules/webmail2/mail_1_1_1.png"/> This mail has an attachment and you've replied and forwarded it</para>
        </listitem>
      </varlistentry>
    </variablelist>
    
    <variablelist>
      <title>Other symbols</title>
      <varlistentry>
        <listitem>
          <para><inlinegraphic fileref="images/modules/webmail2/mes5.png"/> Click on this to mark an email as read / unread</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para><inlinegraphic fileref="images/modules/webmail2/mes6.png"/> Flags an email as important / unimportant</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para><inlinegraphic fileref="images/modules/webmail2/mes7.png"/> Only available for drafts: edit an email</para>
        </listitem>
      </varlistentry>
    </variablelist>
    
  </section>
  
  <section id="modules_webmail2_toolbar">
    <title>The toolbar</title>
    
    <para>Functions of the symbols at the top of the screen:
      <figure>
        <title>The submenu bar</title>
        <graphic fileref="images/modules/webmail2/topline.png"/>
      </figure>
    </para>
    
    <variablelist>
      <title>Functions in detail</title>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_mini_new.png"/> Compose an email (see <link linkend="modules_webmail2_compose">Compose an email</link>)
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para><inlinegraphic fileref="images/modules/webmail2/n_mini_print.png"/> Print the mail that is currently displayed in the preview pane</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para><inlinegraphic fileref="images/modules/webmail2/n_mini_delete.png"/> Delete all mails that are marked in the maillist (how to mark,
            see <link linkend="modules_webmail2_maillist">Maillist</link>). Mails
            are first moved to the trash, deleting them in the trash removes them
            from the system
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para><inlinegraphic fileref="images/modules/webmail2/n_mini_reply.png"/>
            Reply to the mail shown in the preview pane (The text of the
            mail gets included to the new mail, not the attachments)
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para><inlinegraphic fileref="images/modules/webmail2/n_mini_reply2.png"/>
            Reply to all persons (Cc,To) to the mail shown in the preview pane
            (The text of the mail gets included to the new mail, not the attachments)
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_mini_forward.png"/>
            Perform an (inline) forward of the mail (The text of the mail is
            attached to the new mail, not the attached files)
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_mini_forward2.png"/>
            Completely forward the mail (The whole mail [inclusing all attachments !]
            is included as one attachment to the new mail) 
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_mini_receive.png"/>
            Receive new messages (This requires an account to be set up, see
            <link linkend="modules_webmail2_accounts">Email Accounts</link>)
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_settings.png"/>
            Open the tab for settings (see <link linkend="modules_webmail2_settings">General Settings</link>)
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_accounts.png"/>
            Open the tab for account settings (see <link linkend="modules_webmail2_accounts">Email Accounts</link>)
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
    
    <para>
      <figure>
        <title>View customization</title>
        <graphic fileref="images/modules/webmail2/topline2.png"/>
      </figure>
    </para>
    
    <variablelist>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_settings6.png"/>
            Minimize the sidebar. When clicking again the sidebar gets maximized.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_settings5.png"/>
            Hide the tree. When clicking twice the tree is visible again.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_settings7.png"/>
            When working with a smaller screen-resolution it may be helpful to
            hide the top navigation bar. Click again to display the top navigation
            bar and navigate to other modules.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
    
  </section>
  
  <section id="modules_webmail2_sidebar">
    <title>The sidebar</title>
    
    <variablelist>
      <title>Sidebar symbols</title>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_mail-newmail.png"/>
            <link linkend="modules_webmail2_compose">Compose</link> a new message
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_mail-inbox.png"/>
            See what's in your Inbox (All messages that are downloaded from
            a POP3/IMAP server are stored here.)
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_mail-ordner2.png"/>
            Manage your Local <link linkend="modules_webmail2_folders">Folders</link>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_mail-drafts.png"/>
            Drafts (Messages being saved for modifying/sending them later)
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
              <inlinegraphic fileref="images/modules/webmail2/n_mail-sent.png"/> 
              Sent (All messages sent by you)
            </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
        </term>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_mail-deleted.png"/>
            Trash (Deleted messages, deleting messages inside the trash removes them completely)
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <listitem>
          <para>
            <inlinegraphic fileref="images/modules/webmail2/n_mail-ordner.png"/>
            Public Folders
            (every user of moregroupware can access these folders)
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
    
  </section>
  
  <section id="modules_webmail2_tree">
    <title>The tree</title>
    
    <figure>
      <title>The intial tree view</title>
      <graphic fileref="images/modules/webmail2/tree1.png"/>
    </figure>
    
    <para>When viewing the tree for the first time it looks like this.
      All folders are listed hierarchical in the tree.
      All special folders have special icons.
      The folder that is currently shown in the maillist is
      marked with a blue background.
      At the end of the title the total number of mails
      (in this folder) is presented in brackets, e.g. "(1)"
    </para>
    
    <figure>
      <title>Unread mails in the tree view</title>
      <graphic fileref="images/modules/webmail2/tree2.png"/>
    </figure>
    
    <para>When the folder contains unread mails then the total
      number of unread mails is shown before the number
      of read mails, e.g. (4 / 50) means 4 unread mails
    </para>
    
    <figure>
      <title>Folder actions in the tree view</title>
      <graphic fileref="images/modules/webmail2/tree3.png"/>
    </figure>
    
    <para>To open a folder in the maillist view
      simply click on its title.
      To open the function-menu click on a folder's icon.
    </para>
    
    <para>The function menu gives you the following possibilities:</para>
    
    <para>
      <command>Open</command> opens the folder in the maillist view.
    </para>
    <para>
      <command>Add to sidebar</command> shows the folder in the sidebar. ("Favorites")
    </para>
    <para>
      <command>Remove from sidebar</command> removes the folders from the sidebar.
    </para>
    <para>
      <command>Cut / Copy / Paste</command> (not yet implemented)
    </para>
    <para>
      <command>Delete</command> moves the folder and all its subfolders to the trash.
      If the folder is already in the trash it is deleted from the tree.
    </para>
    
    <figure>
      <title>Mail actions in the tree view</title>
      <graphic fileref="images/modules/webmail2/tree4.png"/>
    </figure>
    
    <para>
      <command>Copy / Move mails:</command>
      To copy / move mails go to the source folder, e.g. "Inbox".
      Mark the mails you'd like to copy / move in the maillist
      (Note: this function is not available in imap-only mode)
    </para>
    <para>Click on the icon of the target folder and click
      "Copy mails" for copying or "Move mails" for moving
      the mails to the target folder.
    </para>
    
    <para>
      <command>Rename a folder:</command>
      Click on icon of the folder you'd like to rename.
      Click "Rename" and a small box opens below containing
      the old name. Type in the new name and click "OK".
    </para>
    
    <para>
      <command>Create a new folder:</command>
      Click on an icon of a folder (e.g. "Inbox").
      Next click on "New Folder". A small box opens below.
      Type in the name of the new folder and click "OK".
      (e.g. a new subfolder of "Inbox" is created.)
    </para>
    
    <para>
      <command>Properties:</command>
      Shows information about the folder and its subfolders.
    </para>
    
    <para>
      <command>Empty (public) trash:</command>
      This option is only available for your local and public trash.
      It deletes all folders and emails inside the (public) trash with no
      option to recover the deleted items.
    </para>

    <para>
      <command>Open:</command>
      Opens the whole tree.
    </para>
    
    <para>
      <command>Close:</command>
      Closes the whole tree.
    </para>

    <para>
      <command>Reload:</command>
      Reload refreshes the tree (important for imap-only mode).
    </para>
    
    
  </section>
  
  <section id="modules_webmail2_compose">
    <title>Compose an email</title>
    
    <note>
      <para>Composing an email requires an account to be set up. (see
        <link linkend="modules_webmail2_accounts">Email
          accounts
        </link>
        )
      </para>
    </note>
    
    <section>
      <title>Search for users and contacts</title>
      
      <para>To search for a special user you can type in the firstname,
        lastname or username.
      </para>
      <para>To search for a contact you can type in firstname, lastname or
        email-address.  You can even search for groups or companies.
      </para>
      <para>To copy an item of the search-box into the to-field click on
        "&lt;&lt;" (same with cc-, bcc-field)
      </para>
    </section>
    
    <section>
      <title>Sending a message internally</title>
      
      <para>To send an email to a user simply type in the username in the
        to-field (or cc- / bcc-field)
      </para>
      <para>To send an email to a group (defined in the group-manager)
        simply add a "@" to the beginning of a group
        name. (e.g. @default)
      </para>
    </section>
    
    <note>
      <para>To send an email to more than one recipient, seperate each
        one with a komma.
      </para>
    </note>
    
    <note>
      <para>To send a copy or a blind copy click on "more" and fill in
        the fields "cc" and "bcc".
      </para>
    </note>
    
    <section>
      <title>Attachments</title>
      <para>To add a file to the mail click on "Attachments".</para>
      <para>In the next page click on "Browse ...", select a file, click on
        "Add to List".
      </para>
      <important>
        <para>To attach a file bigger than 2 MB, you need to
          increase "upload_max_filesize" in your php.ini, default is "2M".
          Btw. "file_uploads" must be set on "on" in your
          php.ini
        </para>
      </important>
    </section>
    
    <para>To store a mail for sending it later, click on "Save as Draft"
      instead of "Send E-mail".
    </para>
    
    <important>
      <para>To compose big mails it may be neccessary to increase
        "memory_limit" in your php.ini (default is "8M")
      </para>
    </important>
    
    <section>
      <title>Add Signature</title>
      <para>If you want your signature to be added to the end of the email, enable this oprion.</para>
    </section>
  
    <section>
      <title>Return receipt</title>
      <para>When return receipt is enabled the recipient gets asked to send you a notification when he reads the mail.</para>
    </section>

    <note>
      <para>It depends on the user and on his' email program if he sends you this notification.
      </para>
    </note>
    
    <section>
      <title>Send as draft</title>
      <para>The email will not be sent to the recipient(s). Instead it is placed in the "drafts"-folder for later usage.</para>
    </section>
  
    <section>
      <title>Search for</title>
      <para>If you want to search for a word in a dictionary like Thesaurus or perform a web search in google, type in a word and click "Ok".</para>
    </section>
  
  </section>

  <section id="modules_webmail2_folders">
    <title>Folders</title>
    
    <para>The "Folders" and "Public Folders" are used to get a small overview of all local or public folders.
      In later versions you used this to create / rename / delete folders.
      These functions have been moved to the tree. (see <link linkend="modules_webmail2_tree">Tree</link>)
    </para>
    
    <section>
      <title>Select a folder</title>
      <para>
        <graphic fileref="images/modules/webmail2/markfolder.png"/>
        To open the folder in the maillist-view, click the underlined folder title.
      </para>
    </section>
    
    <section>
      <title>Public Folders</title>
      <para>Public folders are the same as normal folders, except they are
        accessable (and writeable) by every user.
      </para>
      <para>Deleting emails / folders inside the public folders moves them
        to the public trash.
      </para>
      <para>A public folder is automatically created for every user. (public
        folders/$username)
      </para>
    </section>
    
  </section>
  
  <section id="modules_webmail2_settings">
    <title>General settings</title>
    
    <para>You reach "General Settings" by clicking on Settings in the
      webmail-module, then click on "General Settings"
    </para>
    
    <variablelist>
      <varlistentry>
        <term>Sort E-mails by:
        </term>
        <listitem>
          <para>Control how emails in the maillist are sorted.
            <itemizedlist>
              <listitem>
                <para>Sorting them by the "Message-ID" lists
                  all mails in the order they were fetched, latest
                  first.
                </para>
              </listitem>
              <listitem>
                <para>Sort by "Sender": all mails are sorted
                  by the sender, alphabetical, beginning with 'a'
                </para>
              </listitem>
              <listitem>
                <para>Sort by "Subject": (same as "Sender")
                  alphabetical, starting with 'a'
                </para>
              </listitem>
            </itemizedlist>
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Sort by Account ?</term><listitem>
          <para>Check this to sort all mails by the account from which they were fetched.</para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Short view in maillist for columns from/to:</term><listitem>
          <para>The columns "from" and "to" are listed in a short way.
            (e.g. long: Name &lt;name@name.com&gt;, short: Name)
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Show the size of the mails in the maillist:</term><listitem>
          <para>Display the size of each mail in the maillist
            (if this is not checked: Then the size of the mail is displayed in the preview pane)
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Number of E-mails to show per page:</term><listitem>
          <para>Number of mails that are shown in the maillist on one page.</para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Time to wait after downloading/sending messages:</term><listitem>
          <para>The time in seconds to wait after sending or receiving mails</para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Always hide sidebar:</term><listitem>
          <para>Automatically hides sidebar. This is useful when working with 800x600.</para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Minimize sidebar when viewing other websites:</term><listitem>
          <para>This minimizes the sidebar when klicking on links in the tree / sidebar (currently unused)</para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Sidebar width [pixel]:</term><listitem>
          <para>Controls the sidebar width. (default: 100)</para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Tree width [pixel]:</term><listitem>
          <para>mpacts the width of the tree. When using large directory structures you may need to increase this value. (default: 200)</para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Notify me when new mails are available:</term><listitem>
          <para>When new mails are available on one of the accounts, a special
            symbol (<inlinegraphic fileref="images/modules/webmail2/email-icon-big-new.png"/>) appears in
            the toolbar. Clicking on it, a list of new mails is displayed.  Then
            you are able to delete unwished mails before downloading them.
          </para>
          <important>
            <para>Notifying is only active when the webmail module is
              opened in the browser
            </para>
          </important>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Time in seconds to look for new mails:</term><listitem>
          <para>Defines how many seconds to wait until performing a new check.</para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Always compose E-mails in HTML:</term><listitem>
          <para>Setting this a java-applet is loaded everytime you compose a new
            mail. (requires Sun Java Runtime Edition)
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Always add signature to new E-Mails:</term><listitem>
          <para>The "Add Signature" checkbox is automatically enabled when composing mails.
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Signature:</term><listitem>
          <para>Define your signature (this is a special text you can always add
            at the end of your mails)
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Don't fetch E-mails bigger than [size in kb]:</term><listitem>
          <para>Enter here the maximum size of emails to fetch. "Oversize mails"
            are left on the account and don't get deleted
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Anti-Spam Functionality:</term><listitem>
          <para>In order to protect you from spam you can define some rules to
            detect spam.  Those mails that are detected as spam are moved to the
            "Undesired"-folder (subfolder of trash).
          </para>
          <para>Defining rules: Every rule is written in one line.
            <itemizedlist>
              <listitem>
                <para>If you want to block a special sender type: name@domain</para>
              </listitem>
              <listitem>
                <para>To block a whole domain type this: %@domain</para>
              </listitem>
              <listitem>
                <para>Some spammers are using many different
                  subdomains, to block all mails from "domain", "www.domain",
                  "dns.domain", etc. use: %domain
                </para>
              </listitem>
            </itemizedlist>
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Always recache E-mails (slower):</term><listitem>
          <para>Parsing emails can take a long time (especially for
            html-newsletters with many attached inline images). To parse big mails
            it may be neccessary to increase "memory_limit" in your php.ini
            (default is 8M = 8 MByte).
          </para>
          <para>Therefore all emails are cached. In the first step of the
            caching-process all attachments are extracted from the mail and stored
            at cache/attachments (for normal attachments) or at cache/img (for
            images).
          </para>
          <para>In the second step the rest of the mail is filtered by some
            criteria (see next two options for this) and stored at
            cache/readmessage.
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Display emoticons as graphics:</term><listitem>
          <para>Displays emoticons as graphics in the preview pane. (e.g. :), :-), :-(, :(, ;-), :-P, :-D, :-[, :-\\ ) 
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Enable inline display of attachments such as
          images, text files, etc.:
        </term>
        <listitem>
          <para>Using this option some attachments are displayed directly in the mail.
            This happens to images and text-files.
          </para>
          <note>
            <para>All known file-types are listed in
              <filename>/webmail2/inc/mime_types.php</filename>, all unknown
              file-types are treated as prossible viruses and a warning message is
              displayed when downloading)
            </para>
          </note>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Show the Structure of an E-Mail:</term><listitem>
          <para>Display the structure of a mail in the preview pane.</para>
        </listitem>
      </varlistentry>

    </variablelist>
  </section>

  <section id="modules_webmail2_settings_admin">
    <title>Admin settings</title>
    
    <para>You reach Admin settings by clicking on "General settings (Admin only)"
      in the webmail-module, then click on "General Settings"
    </para>
    
    <variablelist>
      
      <varlistentry>
        <term>Don't allow users to create new accounts:</term><listitem>
          <para>Use this option to prevent users from creating their own accounts.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Disable public folders:</term><listitem>
          <para>Enabling this option makes users unable to use public folders.
          (This option may be needed for service providers that don't want every client
           to share emails)
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Secure HTML E-mails:</term><listitem>
          <para>Filters all emails with inline html-content. Most viruses
            contain javascript-code or redirect using iframes, etc. That's why
            some tags are simply filtered with this option:
            <itemizedlist>
              <listitem>
                <para>All &lt;script&gt;*&lt;/script&gt;, &lt;applet&gt;*&lt;/applet&gt;, &lt;object&gt;*&lt;/object&gt;</para>
              </listitem>
              <listitem>
                <para>also &lt;iframe&gt;*&lt;/iframe&gt;, &lt;frame&gt;, &lt;frameset&gt;*&lt;/frameset&gt;</para>
              </listitem>
              <listitem>
                <para>and &lt;base&gt; and &lt;link&gt;</para>
              </listitem>
            </itemizedlist>
          </para>
          <para>If you are programming viruses and want to test them, please
            unset this option or use M$ Outlook (Express).
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Don't download external images:</term><listitem>
          <para>When viewing html-mails (e.g. newsletters) external images are not downloaded. Most companies use
            these images to implement a disposition notification for their spam mails.
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Enable Downloading a mail as .eml file:</term><listitem>
          <para>This enables th ecomplete download of an email as .eml-file in the preview pane.
            (by clicking on structure inside the preview pane)
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Disabled file extensions:</term><listitem>
          <para>Most viruses are sent via email including infected
            attachments. To block attachments you don't need, you can define its
            extensions.  e.g. to block all .exe and .vbs-files type: .exe, .vbs
          </para>
          <para>Be aware the whole email is still fetched from your mail-server
            to the mgw-server, the unwanted attachments are only blocked for
            downloading to your computer.
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Scan all ciritical attachments for viruses:</term><listitem>
          <para>Perform a scan for viruses of all critical attachments before
            downloading them.  (Those attachments that are critical or not are
            listed in <filename>modules/webmail2/inc/mime_types.php</filename>)
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>System-path of your virus scanner:</term><listitem>
          <para>When scanning attachments for viruses you need to define the location of your virus-scanner.
            (e.g. <filename>/usr/local/f-prot/f-prot</filename> for Windows &amp; F-Prot
            or <filename>c:/scan/scan.exe</filename> for McAfee-Commandline-Scanner for Windows)
          </para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>Virus Scanner:</term><listitem>
          <para>Defines the type of your virus-scanner.
            <itemizedlist>
              <listitem>
                <para>Supported Virus-Scanners are: F-Prot for Linux (executable: f-prot)</para>
              </listitem>
              <listitem>
                <para>F-Prot for Windows (executable: fpcmd.exe)</para>
              </listitem>
              <listitem>
                <para>McAfee for Linux (executable: uvscan)</para>
              </listitem>
              <listitem>
                <para>McAfee for Windows (executable: scan.exe)</para>
              </listitem>
              <listitem>
                <para>Kaspersky AV Linux (executable: kavscanner)</para>
              </listitem>
            </itemizedlist>
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
    
  </section>
  
  <section id="modules_webmail2_accounts">
    <title>Email accounts</title>
    
    <section>
      <title>Display a list of all accounts</title>
      
      <para>Inside the webmail-module, click on Settings, then click on
        "Accounts".
      </para>
      <para>To edit an account click on "edit" (if there is no edit- or
        delete-link contact your sysadmin)
      </para>
      <para>For deleting an account, click on "delete".</para>
      <para>If you want to verify your smtp-settings click on "Test SMTP".</para>
    </section>
    
    <section>
      <title>Create a new account</title>
      
      <para>Inside the webmail-module, click on Settings, then click on "New
        Account"
      </para>
      
      <variablelist>
        <varlistentry>
          <term>New account (imap-only)
          </term>
          <listitem>
            <para>Create a new account for fetching emails from imap or pop3 to the database.</para>
          </listitem>
          <term>New account (fetch from imap or pop3)
          </term>
          <listitem>
            <para>Create a new account for imap-only access. Emails are downloaded by demand.
            The imap-folders can be found in the tree (a new node with the account name is shown).
            </para>
          </listitem>

          <term>Activate Account
          </term>
          <listitem>
            <para>Activate this option to fetch mails from this account</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Account Name
          </term>
          <listitem>
            <para>Enter the name of the account, should be unique.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Fetch all E-mails to folder
          </term>
          <listitem>
            <para>Select the folder where new E-mails are placed after downloading. (default: Inbox)
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Place a copy of each E-mail in
          </term>
          <listitem>
            <para>Use this option to place a copy in a special folder,
              normally public folder (the mail is only stored once on hard-disk)
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Mailserver Type
          </term>
          <listitem>
            <para>Use POP3 for fetching mails from a POP3 server
              or IMAP for fetching from an IMAP inbox
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>POP3/IMAP Host
          </term>
          <listitem>
            <para>Specify the hostname or IP address of the server
              to fetch mails from
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Username
          </term>
          <listitem>
            <para>When fetching mails authenticate with this username</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Password
          </term>
          <listitem>
            <para>When fetching mails authenticate with this password</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Leave messages on server
          </term>
          <listitem>
            <para>Activate this to leave all messages on the mail server
              instead of deleteing them (recommended for IMAP)
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>From Name
          </term>
          <listitem>
            <para>This name appears when sending mails
              e.g. name for "name" &lt;email@gmx.de&gt;
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Reply-to Address
          </term>
          <listitem>
            <para>This address appears when sending mails
              e.g. email@gmx.de for "name" &lt;email@gmx.de&gt;
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Use mail-function
          </term>
          <listitem>
            <para>PHP offers a mail() function that calls sendmail (Linux)
              or SMTP (Windows) as configured in php.ini
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>SMTP Host
          </term>
          <listitem>
            <para>Instead of using the mail() function you can specify
              a SMTP-hostname for sending mails
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>POP before SMTP
          </term>
          <listitem>
            <para>Some SMTP servers require a successful
              POP3 authentication before sending mails
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>SMTP needs authentication
          </term>
          <listitem>
            <para>Instead of authenticating via POP-before-SMTP
              you can use an extra username and password
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Username
          </term>
          <listitem>
            <para>Specify a username for SMTP authentication</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Password
          </term>
          <listitem>
            <para>Specify a password for SMTP authentication</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Authenticate with POP3-username + Password
          </term>
          <listitem>
            <para>Instead of using an extra username/password
              for SMTP authentication you can use the
              username/password for POP3/IMAP-authentication
            </para>
          </listitem>
        </varlistentry>
      </variablelist>
      
      <section>
        <title>Additional options for user "admin"</title>
        <para>As "admin" you can create accounts for other users and allow /
          disallow them to edit these accounts. To create a new account for
          another user simply choose the username above "account name". To
          restrict editing uncheck "User can edit this account".
        </para>
        
        <para>When creating users as "admin":
          <itemizedlist>
            <listitem>
              <para>using $username gets automatically replaced with mgw-username.</para>
            </listitem>
            <listitem>
              <para>using $email is replaced with mgw-email</para>
            </listitem>
            <listitem>
              <para>using $fullusername is replaced with "Firstname Lastname"</para>
            </listitem>
          </itemizedlist>
        </para>
        
        <para>For changing moregroupware username, email and fullusername take
          a look at the admin-module (esp. user-manager)
        </para>
        
      </section>
    </section>
  </section>
  
  <section id="modules_webmail2_backup">
    <title>Backup Webmail (for Admins only)</title>
    
    <section>
      <title>Backup your database</title>
      <para>When you only want to backup the webmail-module these tables are important.
        How to backup? Using a shell command:
        <literal>mysqldump -c -r &lt;backup_filename.sql&gt; -h &lt;hostname&gt; -u &lt;username&gt; -p%lt;password&gt; &lt;database&gt; &lt;table_name&gt;</literal>
        <itemizedlist>
          <listitem>
            <para>mgw_webmail_accounts - contains every user's account settings</para>
          </listitem>
          <listitem>
            <para>mgw_webmail_links - contains all external links (not used at the moment)</para>
          </listitem>
          <listitem>
            <para>mgw_webmail_mailboxes - contains all folders</para>
          </listitem>
          <listitem>
            <para>mgw_webmail_messages - contains all emails (only the headers)</para>
          </listitem>
          <listitem>
            <para>mgw_webmail_sidebar - contains the favorites (folders in sidebar/favorites)</para>
          </listitem>
        </itemizedlist>
      </para>
      
      <para>Also important: (not webmail-module directly but neccessary for it):
        <itemizedlist>
          <listitem>
            <para>mgw_users - contains all users, usernames, userids</para>
          </listitem>
          <listitem>
            <para>mgw_groups, mgw_groups_members - contains all users, usernames, userids</para>
          </listitem>
          <listitem>
            <para>mgw_contacts, mgw_companies, mgw_contacts_groups - contains contacts (persons, companies)</para>
          </listitem>
        </itemizedlist>
      </para>
    </section>
    
    <section>
      <title>Backup you hard-disk</title>
      
      <para>When you only want to backup the webmail-module these folders + subfolders are important:
        <itemizedlist>
          <listitem>
            <para>/mgw/modules/webmail2/store - contains all emails (full mails stored as .eml)</para>
          </listitem>
          <listitem>
            <para>/mgw/modules/webmail2/cache - not neccessary (should only exist)</para>
          </listitem>
          <listitem>
            <para>/mgw/modules/webmail2/home - not used at the moment</para>
          </listitem>
        </itemizedlist>
      </para>
    </section>
  </section>
</chapter>
