mod_contact

An Apache httpd module that implements a contact us form with file upload.

Acts as a gateway between a form submission and email.

example

For an example of how the module is deployed, see the examples directory.

<IfModule !multipart_module>
  LoadModule multipart_module modules/mod_multipart.so
</IfModule>
<IfModule !contact_module>
  LoadModule contact_module modules/mod_contact.so
</IfModule>

<Location /contact/hello/>
  SetHandler contact
  SetInputFilter CONTACT;MULTIPART
  ContactStylesheet /contact/contact.xsl
#  ContactToMatch ^hello@example.com$
#  ContactFromMatch ^webmaster@hostingprovider.com$
  ContactTo hello@example.com
  ContactFrom webmaster@hostingprovider.com
</Location>

binaries

RPMs for Fedora/Redhat derivatives are available through COPR.

Ubuntu packages are available through PPA.

directives

ContactStylesheet : Set the XSLT stylesheet to be used when rendering the output.

ContactCommand : Set to the name and path of the sendmail binary.

ContactArguments : Set to arguments to pass to the sendmail binary.

ContactTo : Expression resolving to the To address. Overridden by 'contact-header-to' in a form.

ContactToMatch : Set to a regular expression that the To address must match.

ContactFrom : Expression resolving to the From address. Overridden by 'contact-header-from' in a form.

ContactFromMatch : Set to a regular expression that the From address must match.

ContactSender : Expression resolving to the Sender email address. Overridden by 'contact-header-sender' in a form.

ContactReplyTo : Expression resolving to the Reply-To email address. Overridden by 'contact-header-replyto' in a form.

form fields

The order of form fields are significant. Headers fields must be sent first, followed by body fields, followed by attachment/inline fields. Fields sent out of order are ignored.

headers

contact-header-to : Set to the To address. If set in a form, this address must match the regex in ContactToMatch.

contact-header-from : Set to the From address. If set in a form, this address must match the regex in ContactFromMatch.

contact-header-sender : Set to the Sender address.

contact-header-replyto : Set to the Reply-To address.

contact-header-subject : Set to the Subject of the message.

body

contact-body-* : Set to any field you want to appear in the body of the message. May be specified many times.

attachments

contact-attachment-* : Set to any file you want to upload and add to the email as an attachment.

contact-inline-* : Set to any file you want to upload and add to the email as an inline attachment.

spam / forgery

To avoid sent emails being marked as either spam or forged, the following rules need to be followed.

• The person using the browser "sending" the mail must be placed in the Reply-To header. The webserver typically will have no permission to send email on behalf of the person using the browser, and so this address must not appear in the To header.

• The email account receiving the email must be set using either ContactTo, or a combination of ContactToMatch and contact-header-to. The ContactToMatch directive ensures the gateway does not become an open relay.

• The email account sending the email must be set using either ContactFrom, or a combination of ContactFromMatch and contact-header-from. The From address must be an email address that is allowed to send mail from your webserver. This might be your hosting provider, or an address you have configured with your hosting provider. Setting the From address to an address that is not allowed to send mail from your webserver will see mail marked as forged.