[[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.

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)]]

See also: AnnouncerPlugin

=== Wish list / next to do

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.

== Bugs/Feature Requests

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

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=MailPlugin&owner=framay new ticket].

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

=== 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.

=== Known Bugs / Issues

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

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

== Download

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

Or download the pre-compiled [raw-attachment:XMailPlugin-0.4.0-py2.6.egg Python egg].

== Source

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

== Example

Send mails every week of new or changed tickets of a milestone.

== Recent Changes

[[ChangeLog(mailplugin, 3)]]

== Author/Contributors

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