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

= Add contact form to Trac site

== Description

How often did you have a question about a software project and had no way to contact one of the developers? This is where this plugin comes into play. It provides a contact form to allow users to contact the project team members. The contact form is very basic: it consists of the necessary fields (name, email, subject, message). It is supposed to be a simple contact form for small (or new) projects that didn't have the time (yet) to setup a more advanced contact form. Other fields are currently outside the scope of this plugin.

The contact form is available through an entry in the main navigation or under `/contactform`:

[[Image(screenshot.png, border=2)]]

There are two configuration settings that drive the behavior of this plugin. Both can be found in the `[contactform]` section in your `trac.ini` file:

 * `recipients` - a comma separated list containing all users that shall receive the contact mail. This list may contain usernames as well as plain email addresses.
 * `intro_text` - a text that is displayed above the contact form.
displays a list of all users that will be informed about ticket changes of a certain ticket. Additionally it informs the user about the current notification.

Both settings can also be set using the webadmin interface.

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Installation

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

== Recent Changes

[[ChangeLog(contactformplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:manski Sebastian Krysmanski] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''