You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Chris Smith d2fc19e919
Use production values for cookies not dev
4 years ago
Dockerfile Initial version 5 years ago
LICENCE.adoc Initial version 5 years ago
README.adoc Add captcha support. 4 years ago
captcha.go Add captcha support. 4 years ago
captcha.html Add captcha support. 4 years ago
example-email.png Credits and screenshots 5 years ago
example-form.png Credits and screenshots 5 years ago
failure.html Initial version 5 years ago
form.html Query parameters create hidden form elements 4 years ago
go.mod Add captcha support. 4 years ago
go.sum Add captcha support. 4 years ago
main.go Use production values for cookies not dev 4 years ago
success.html Initial version 5 years ago

README.adoc

= Go contact form

== About

Provides a simple, tiny webservice that serves a contact form and sends responses
via e-mail.

image:example-form.png[Example contact form] ->
image:example-email.png[Example email message]

== Usage

The simplest way to use this is via docker:

docker run -d csmith/contact-form -from form@server.com -to me@email.com .....

You should place this service behind an TLS-terminating proxy, and ensure it
is requested over a secure connection.

== Parameters

The application can be configured either using command line arguments
or environmental variables (shown in square brackets, below).
_from_, _to_, _smtp-host_, _smtp-user_, and _smtp-pass_ are required;
other options have vaguely sensible fallbacks.

----
-crsf-key string
CRSF key to use [CONTACT_CRSF_KEY]
-enable-captcha
Whether to require captchas to be completed [CONTACT_ENABLE_CAPTCHA]
-from string
address to send e-mail from [CONTACT_FROM]
-port int
port to listen on for connections [CONTACT_PORT] (default 8080)
-session-key string
Session key to use (for captcha support) [CONTACT_SESSION_KEY]
-smtp-host string
SMTP server to connect to [CONTACT_SMTP_HOST]
-smtp-pass string
password to supply to the SMTP server [CONTACT_SMTP_PASS]
-smtp-port int
port to use when connecting to the SMTP server [CONTACT_SMTP_PORT] (default 25)
-smtp-user string
username to supply to the SMTP server [CONTACT_SMTP_USER]
-subject string
e-mail subject [CONTACT_SUBJECT] (default "Contact form submission")
-to string
address to send e-mail to [CONTACT_TO]
----

You can use any SMTP server; however I recommend using a dedicated service
such as https://www.mailgun.com/[mailgun] or
https://aws.amazon.com/ses/[AWS SES], both of which you can access over SMTP.

== Templates

The form itself is loaded from `form.html` in the working directory; success and failure pages from `success.html`
and `failure.html` respectively. If captcha support is enabled, the captcha page is loaded from `captcha.html`.
Each page is loaded as a https://golang.org/pkg/html/template/[go html.template] and
can use the templating syntax described there. Forms must contain the `{{ .csrfField }}` template field, which
will automatically insert the CSRF token for the request.

Any query parameters passed to the form will be accessible through the `{{ .params }}` template field. The
default template will include all parameters as hidden fields in the form.

If the form contains a field named `from`, it will be used in the `Reply-To` header. Otherwise, no
special processing is applied to any field; they are all simply written out to the message body.
No server-side validation is performed.

When running from the docker image, templates are stored in `/templates`; you can
replace this with a volume to supply custom templates.

== Credits

Developed by https://chameth.com[Chris Smith]; CSS heavily based on the login form in
https://github.com/greboid/ig[ig] by https://greboid.com[Greg Holmes].

Captchas are implemented using the https://github.com/dchest/captcha[dchest/captcha]
library, and most functionality utilises libraries from the https://www.gorillatoolkit.org/[Gorilla web toolkit].

== Licence

This software is licensed under the MIT licence. See the LICENCE.adoc file for the full text.