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

= Prepare email addresses for notification emails

== Description

This plugin was developed to help local project admins to create information needed before sending notification emails.

Until now it was not possible to change the email address of users or to create information for users without adding the user to a credentials file, eg when you use LDAP to manage Trac permissions. 

The Notice Manager allows to retrieve all information needed either from an LDAP directory - in this case, the methods provided by the LDAP plugin - or a local text file. 

Go to the Admin page, General, E-Mail. This will show a list of accounts, which are either:

 * already registered, or
 * mentioned in the Trac-permissions

On the right side, you can fill in information, either by entering them manually (Add/Change Notice Info), by getting them from an LDAP directory (Information gathering ... from LDAP) or by retrieving the information from a local file (Information gathering ... local file).

The file follows a simple syntax, on one line, list the id, the name and the email address, divided by the ':' sign:
{{{
foo:Test Account:bar@localhost.localdomain
}}}

'''Note''': To use LDAP groups for assigning tickets, the LDAP group prefix has to be changed from "@" to "*". If you don't change the prefix, you will not be able to send emails to the LDAP group when assigning ticket responsibilities.

This plugin was developed for internal use. Feel free to add, change or delete to make it fit for your purposes.

'''Note''': This plugin requires the LdapPlugin to be installed - even if you only want the "local text file" variant. This plugin doesn't install without it.

== Bugs/Feature Requests

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

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

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

== Download

Download the [export:noticemanagerplugin zipped source].

== Source

Check out [/svn/noticemanagerplugin using Subversion], or [source:noticemanagerplugin browse the source] with Trac.

== Installation

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

== Recent Changes

[[ChangeLog(noticemanagerplugin, 3)]]

== Author/Contributors

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