Creating new forms
The first form calls up an HTML form with two buttons, one for canceling the action and one for confirming the unsubscribe action. This security check gives the recipient the possibility of changing his mind or canceling the process in case he or she clicked the link by mistake.
1. | Create a new form entitled UnsubscribeQuery. |
2. | Enter the code below in the Success form entry field. It is up to you how to arrange the HTML form and what layout to choose. The Error form contains a short message telling the recipient that the unsubscribe process was unsuccessful. It is advisable to offer more detailed instructions here, possibly including a link pointing to your website’s support section or giving a hotline phone number the recipient can call for help. |
3. | Save the form by clicking on the Save button. |
HTML code for the web form is rather short:
<form action="form.do" method="post">
<input type="hidden" name="agnCI" value="XX">
<input type="hidden" name="agnFN" value="OptOutConfirm">
<input type="hidden" name="agnUID" value="$!agnUID">
Do you really want to unsubscribe?<br>
<input type="reset" value="Cancel">
<input type="submit" value="Unsubscribe">
</form>
The hidden fields in lines two to four are required and make sure the important customer ID (agnCI) and user ID (agnUID) parameters are transmitted to the next form (agnFN). The company ID in OpenEMM is 1.
Fig. 8.18: The form displays a security check before finally unsubscribing the recipient from that particular mailing list.
The two buttons for cancelling (type="reset") and unsubscribing (type="submit") are HTML standard. Only clicking on the submit-type button (unsubscribe) will cause the web browser to call up the form.do script for evaluation by the OpenEMM server.
1. | Create a new form named OptOutConfirm. Please note: This name must be exactly the same as that entered as an agnFN value in the HTML code for the first form. |
2. | Select the Unsubscribe action defined earlier as a starting action. The Success form contains a short confirmation message telling the recipient that the unsubscribe process was successful. The Error form should feature a short message telling the recipient that the unsubscribe process was unsuccessful. |
3. | Conclude the form definition by clicking on the Save button. |