# Email Listener Plugin Readme

## Overview

The email listener plugin is a service that connects to an email server using IMAP and forwards new email messages to specified users.

## Installation

Copy emailListener.jar into the plugins directory of your Openfire installation. The plugin will then be automatically deployed. To upgrade to a new version, copy the new emailListener.jar file over the existing file or upgrade from the admin console.

## Configuration

The email listener plugin can be configured via the Openfire Admin Console. Use the configuration page to specify the email server and user to use to connect to the server. The list of users to notify of new email messages should be comma delimited and the bare JID (e.g. john@server.com) should be used. Once the service has been configued it will automatically connect and start monitoring for new email messages.

## Using the Plugin

Once Openfire is started the plugin will connect to the email server and start to monitor for new email messages. New email message will be sent to specified users. Every time the configuration of the email listener service is updated the service will be automatically restarted.