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

= Integrate contacts list in Trac

== Description

This plugin allows you to add contacts to the system. Contacts have a first and last name as well as a phone number and an email address. Out of the box, these contacts are completely unrelated to the rest of Trac, but this plugin is designed to allow other plugins to add associated contacts as needed. Contacts are stored with the following characteristics:
 * Name as consisting of first name and last name
 * Position, within the organisation
 * Phone
 * E-mail

This provides two permissions, one for viewing: `CONTACTS_VIEW`, and one for adding/editing contacts: `CONTACTS_ADMIN`.

Note that email addresses are not sanitised.

See also: GuestbookPlugin

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Installation

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

== Configuration

To load a contact, go to `/contact?redirect=/your/redirect/handler/url` as soon as the user has added or edited a contact. Your redirect handler will be called with the contact_id set in the url. You can then edit this contact.

== Recent Changes

[[ChangeLog(contactsplugin, 3)]]

== Author/Contributors

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