The form parser parses data from HTML forms and adds new records to the BulkMailer address database.
- You have a HTML form on your website
- Your webserver sends a email in a defined format using a CGI script
- The BulkMailer Feedback Module receives this mail and adds the data to the address database
Specifications according the HTML-Form
Your HTML-Form contains (some of) the following Fields:
| Name of the Form-Field | Description | Type | Required |
|---|---|---|---|
| EMail Address | text | X | |
| UNSUBSCRIBE | Button 'Unsubscribe' | submit | X |
| SUBSCRIBE | Button 'Subscribe' | submit | X |
| GROUP | Group-ID, see ID-Column in 'Edit Groups' | hidden, select | |
| PREFERENCE | Preference: HTML (H) or Text (T) | hidden, select | |
| GENDER | Gender: F or M | select | |
| TITLE | ... | text | |
| FIRSTNAME | ... | text | |
| SECONDNAME | ... | text | |
| LASTNAME | ... | text | |
| NICKNAME | ... | text | |
| PRIVATE_COUNTRY | ... | text | |
| PRIVATE_STATE | ... | text | |
| PRIVATE_POSTALCODE | ZIP Code | text | |
| PRIVATE_CITY | ... | text | |
| PRIVATE_STREET | ... | text | |
| PRIVATE_PHONE | ... | text | |
| PRIVATE_FAX | ... | text | |
| PRIVATE_MOBILE | ... | text | |
| PRIVATE_HOMEPAGE | ... | text | |
| BUSINESS_COMPANY | Company Name | text | |
| BUSINESS_TITLE | ... | text | |
| BUSINESS_DEPARTMENT | ... | text | |
| BUSINESS_OFFICE | ... | text | |
| BUSINESS_COUNTRY | ... | text | |
| BUSINESS_STATE | ... | text | |
| BUSINESS_POSTALCODE | ... | text | |
| BUSINESS_CITY | ... | text | |
| BUSINESS_STREET | ... | text | |
| BUSINESS_PHONE | ... | text | |
| BUSINESS_FAX | ... | text | |
| BUSINESS_PAGER | ... | text | |
| BUSINESS_IP_PHONE | ... | text | |
| BUSINESS_HOMEPAGE | ... | text | |
| USER1 | User Defined Field 1 | text | |
| USER2 | User Defined Field 2 | text | |
| USER3 | User Defined Field 3 | text | |
| USER4 | User Defined Field 4 | text | |
| USER5 | User Defined Field 5 | text | |
| INTEREST | Interests (multi) | text, Comma-separated | |
| DISTRIBUTION | Distribution List (multi) | text, Comma-separated |
Specifications according the serverside sent email
Your web-server sends an email by CGI-Script with the following message body:
FIELDNAME: Value
FIELDNAME: Value
[..]
*) Attention: Line breaks in emails must be \r\n. Some PHP scripts will only add a line-feed \n which is wrong and will not work.
Most web-hosting providers offer a form-template script, which sends an email formatted exactly this way. Or the script can be easily configured to do so. All you have to do then, is to include this script with your form and to name your form fields according to the list above.
You choose a subject line for the outgoing emails, which can be easily filtered later by the Feedback Module.
Configuring the Feedback Module
Condition: Subject contains string [Your Subject Line]
Action: Form Parser