[[PageOutline(2-5,Contents,pullout)]]

= XMailPlugin allows to send periodically user-specific mails of new or changed tickets

== Description

This is an Extended Mail Plugin. XMail provides extensive user specific mail options, including periodic mail deliveries. This plugin can for example be used to send mails every week of new or changed tickets of a milestone.

There are the following kinds of filtered mail delivery:
 - periodic mails, eg !daily, weekly, etc.
 - immediate mail, but with a user-specific filter, for example only high-prio tickets.

Create new filter for sending by mail:

[[Image(new_filter.png, width=80%, border=2)]]

Overview of preferences:

[[Image(overview.png, width=80%, border=2)]]

Tested with:
 - Ubuntu and Windows (Python 2.6.5)
 - PostgreSQL 8.1 and 8.4

See also: AnnouncerPlugin

== Bugs/Feature Requests

Existing bugs and feature requests for MailPlugin are 
[report:9?COMPONENT=MailPlugin here].

If you have any issues, create a 
[/newticket?component=MailPlugin new ticket].

[[TicketQuery(component=MailPlugin&group=type,format=progress)]]

=== Known Bugs / Issues

This plugin needs some improvement (ideally merging with AnnouncerPlugin):

 - Using reports instead of pure SQL-Where-Clause.
 - Upon changing a ticket, see the change to the ticket immediately.
 - At the moment normal SQL is saved in XMail-View. It would be better if it were reports instead, then it would be more flexible and other users could take the same report for their email notification.

Other known issues:
 - thread for sending mails is only starting when first Trac-Page was retrieved
 - database table is only initialized when main view of XMail is displayed

== Download

Download the zipped source from [export:mailplugin here].

== Source

You can check out MailPlugin from [/svn/mailplugin here] using Subversion, or [source:mailplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Recent Changes

[[ChangeLog(mailplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:framay] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''