Working with the Contact form

Last updated April 30, 2011. Created by O Govinda on May 9, 2005.
Edited by arianek, LeeHunter, Dave Reid, peterx. Log in to edit this page.

The Contact module allows site visitors to send emails to other authenticated users and to the site administrator.

Uses

Through personal contact forms users can send one another e-mail. And through site-wide contact forms, users can send e-mail to arbitrary email addresses, such as the site maintainers.

With either form, users can specify a subject, write their message, and also have a copy of their e-mail sent to their own address. Through contact forms, users allow themselves to be contacted yet keep their own e-mail addresses private until the message is replied to. As an administrator, you can enable or disable the contact module altogether.

As a user, you can also enable or disable your personal contact form if that option has been provided. When the form is enabled, a contact tab is displayed in your user profile, for everyone to see. (Privileged users such as site administrators can contact users who have turned their forms off, as they can access their user account email addresses.) When you visit your own profile, the contact tab is not displayed. However, it is displayed to other users (if it has been enabled).

You can set up "categories" for the site-wide contact form, to allow for multiple recipient options. For example, one category might be "website feedback," and another might be "product information." For each category, you can specify one or more email addresses to which the form will be sent. You can also specify whether or not the user will receive an automatic reply.

You can specify the text to display on your site-wide contact page and you can optionally limit how many times a user can submit a contact form in an hour.

Configuration

Enabling Contact module

To enable the Contact module:

1. Navigate to the Modules administration page (Administration > Modules or http://example.com/admin/modules in Drupal 7; Administer > Site building > Modules or http://example.com/admin/build/modules in Drupal 6).
2. In the Core module section, enable the Contact module.
3. Click Save configuration.

Configuring the site-wide Contact form

1. Navigate to the Contact Form administration page. (Administration > Structure > Contact or http://example.com/admin/structure/contact in Drupal 7; Administer > Site building > Contact form or http://example.com/admin/build/contact in Drupal 6).
2. Click "Add a Category" and enter the following information:
• Category: Enter a title.
• Recipients: Enter one or more email addresses. Separate each address with a comma.
• Auto-Reply: Enter an optional response such as an acknowledgement of receipt. Leave this field empty if you do not want to send an automated response.
• Weights: Set the order in which categories will be displayed.
• Selected: Specify whether you want this category selected by default.
3. Click "Save".

In Drupal 6, you can specify further settings:

1. Navigate to the Contact Form settings page (http://example.com/admin/build/contact/settings)
2. In the "Additional Information" section, enter the text to display with the contact form.
3. In the "Hourly Threshold" list, select the maximum number of submissions that a user can make per hour.

Configure the user Contact form

1. Navigate to the Account Settings page (Administration > Configuration > People > Accounts or http://example.com/admin/config/people/accounts in Drupal 7; Administer > Site building > Contact form > Settings or http://example.com/admin/build/contact/settings in Drupal 6).
2. In the Contact settings section, specify whether the contact form is enabled for users by default. Changing this form does not affect existing users.
3. Click "Save configuration."

Permissions

Drupal 7

1. Navigate to the Permissions page (Administration > People > Permissions or http://example.com/admin/people/permissions).
2. In the Contact section, specify whether a user role has the following permissions:
   • Administer contact forms and contact settings: Only administrators should be granted this permission.
   • Use the site wide contact form: Users with this permission can send messages to specific addresses that you specify.
   • Use users' personal contact forms: Users with this permission can send messages to any authenticated user who has enabled the contact form in their user settings. Granting this permission to unauthenticated users may not be desirable.
3. Click "Save Permissions."

Drupal 6

1. Navigate to the Permissions page (Administer > User management > Permissions or http://example.com/admin/user/permissions).
2. In the Contact section, specify whether a user role has the following permissions:
   • Access Site Wide Contact Form: Users with this permission can send messages to specific addresses that you specify.
   • Administer Site Wide Contact Form: Only administrators should be granted this permission.
3. Click "Save Permissions."

Module development

How can you get involved?

• Contact community initiatives page
• Contact module issue queue

Maintainer

The current maintainer of core's Contact module is Dave Reid.