update forms documentation

This commit is contained in:
Matthias Kretschmann 2018-05-11 13:22:44 +02:00
parent 3ad74f850f
commit af22917e4c
Signed by: m
GPG Key ID: 606EEEF3C479A91F
1 changed files with 14 additions and 9 deletions

View File

@ -1,19 +1,24 @@
# Forms
We have multiple forms in use throughout the whole site doing the following:
We have multiple forms collecting and processing data throughout the whole site doing the following:
| Form | Actions |
| ------------|-------------|
| `/contact` | send to CC emails, Slack message |
| `/services` | send to CC emails, Slack message, add new row to Google Sheets |
| `/cla` | 2 different forms, send to CC emails |
Form | Actions
------------ |-------------
`/newsletter` | send data to MailChimp and subscribe to newsletter list (double opt-in)
`/contact` | send data to CC emails, Slack message
`/services` | send data to CC emails, Slack message, add new row to Google Sheets
`/cla` | 2 different forms, send data to CC emails
Initial form sending is handled via formspree.io with a Gold account. As form submissions arrive there, Formspree sends out the received submissions to the email addresses setup as CC in [our site config](../_config.yml).
Initial form sending, except for newsletter, is handled via formspree.io with a Gold account. As form submissions arrive there, Formspree sends out the received data to the email addresses setup as CC in [our site config](../_config.yml).
Submissions are processed further like so:
_Formspree -> Zapier Email Parser -> Zapier -> Slack & Google Sheets_
The Zapier email parser is a special mailbox provided by Zapier which receives form submissions from Formspree, parses the content of those emails and extracts data fields out of it.
The Zapier email parser is a special mailbox provided by Zapier which receives form submissions from Formspree, parses the content of those emails and extracts data fields out of it. The parser as a source then provides the structured data to our Zapier tasks.
The parser as a source then provides the structured data to our Zapier tasks.
The Slack message never contains personally identifiable information. Name and email are not transmitted.
## Newsletter
Newsletter submissions are sent directly to MailChimp via their undocumented `jsonp` functionality, NOT the MailChimp API. We use a local copy of [ajaxChimp](https://github.com/scdoshi/jquery-ajaxchimp) to send the data. Library is old and jQuery but it just works across a wide range of browsers, even older ones.