Checkout

Template for unsubscribing

This template makes it possible to check out for a subscriber. The programming of templates is based on the data fields that you defined by using the database designer. These data fields contain information on the layout and the content of the single fields. The names of the data fields in your database (like NAME, JOB, TITLE, etc.) are called field names. Those field names will be integrated into the templates by using BACKCLICK-specific tags, and will always be written in capital letters. The information the subscriber enters while subscribing or checking out will be saved in your database automatically. How to create these data fields is described in chapter

“System administration” (Main Menu) -> “Data base designer” (submenu).

The figure shown below can be found in your WebInterface template ID 3:

Abb. 8.4.3 - Webinterface Templates (Beispiel ID 3)

If you write  between the <HEAD>-</HEAD>-TAG, the subscriber will always return to the page you defined in your template link after having subscribed successfully. The number “10” defines the number of seconds it will take until the subscriber will be returned to the starting page. This is an optional TAG.

<!--REFRESH:10-->

Within the HTML-template, you will now fill in a form field where all the necessary variables will be saved. All the required information for your system — such as introduction sentences, error or success messages, and the information for the input boxes — should be inserted between the <FORM>-</FORM>-TAGs. To create this form field, you will need to write the following code into your source code at the proper place:

<FORM method="post" action="web.unsubscribe?tid=3" name="remove_reader"></FORM>

Add introduction sentences

These sentences will only be shown at the first call of the subscription mask and to welcome new subscribers. They will not be shown again when there are error or success messages. To mark the sentences, you need to write the following:

<!--ENTRY-->
Please check out receiving this newsletter here.
<!--/ENTRY-->

Error messages

BACKCLICK can show several error messages, in case of wrong information provided by the subscriber, any input box left empty, or any system error. You will define whether any field is optional or required when you are creating the data field. In order to define the error messages the subscriber will see if there is an error, you need to write the following TAGs to your HTML-site.

Example: The subscriber did not subscribe on mailing list ID 1:

<!--ERROR:NOABO-1-->
  <TR>
    <TD><FONT face="verdana" size="1">You have not subscribed to the Stock Newsletter.</FONT></TD>
  </TR>
<!--/ERROR:NOABO-1-->

The subscriber did not subscribe to mailing list ID 2:

<!--ERROR:NOABO-2-->
  <TR>
    <TD><FONT face="verdana" size="1">You have not subscribed to the New Market Newsletter.</FONT></TD>
  </TR>
<!--/ERROR:NOABO-2-->

You should define an error message in your template for every mailing list that exists in your system. Where and how often you write it into your HTML code is not limited by BACKCLICK.

More error messages may be displayed as follows:

The subscriber did not select a mailing list:

<!--ERROR:NO-NEWSLETTER-->
  <TR>
    <TD><FONT face="verdana" size="1">You need to select at least one mailing list. </FONT></TD>
  </TR>
<!--/ERROR:NO-NEWSLETTER-->

If you write the following error message into your HTML code, BACKCLICK will display a configuration error. If you then see this error message, there is a mistake in your template, and you need to check the HTML code and the defined data fields. Additionally, you may check the configuration of the newsletter that has been used.

<!--ERROR:CONFIGURATION-->
  <TR>
    <TD><FONT face="verdana" size="1">There is an error in configuration.</FONT></TD>
  </TR>
<!--/ERROR:CONFIGURATION-->

Example: Incorrect e-mail address

<!--ERROR:INCORRECT-EMAIL-->
  <TR>
    <TD><FONT face="verdana" size="1">Please enter a correct e-mail address.
      <BR>The e-mail address: <?GIS name="EMAIL" content="form"?>' is incorrect.</FONT></TD>
  </TR>
<!--/ERROR:INCORRECT-EMAIL-->

The subscriber failed to enter an e-mail address:

<!--ERROR:NO-EMAIL-->
  <TR>
    <TD><FONT face="verdana" size="1">Please enter a correct e-mail address.</FONT></TD>
  </TR>
<!--/ERROR:NO-EMAIL-->

You may define error messages for all of the data fields you defined in your database designer.

<!--ERROR:DATENBANKFELD-->
  <TR>
    <TD><FONT face="verdana" size="1">Please enter data in the field "DATABASEFIELD".</FONT></TD>
  </TR>
<!--/ERROR:DATENBANKFELD-->

Inserting input boxes

The following section describes how to add the input boxes that the subscriber must fill in with information. How to define whether these fields are to be filled in as either required or optional fields is described in chapter “Database Designer.”

For starting to insert the input boxes:

<!--REMOVE-USER-->

After you have finished inserting them, please close this entry with the finishing TAG:

End of inserting input boxes:

<!--/REMOVE-USER-->

Between these TAGs, you may write any HTML code. Next we will describe the TAGs for laying out the input boxes in your template. These may be defined in any order.

Example for the input box “e-mail”:

<?GIS EMAIL?>

The default values of the database designer may also be arranged individually for every input box by including the HTML parameter in the BACKCLICK special TAG. In this example, the input box for e-mail address should include 50 characters.

Example for the individual layout of the input box “e-mail”:

<?GIS EMAIL params="size=50"?>

Input box for selection of the mailing list

If you offer more than one newsletter, you need to include the following TAGs:

Example Newsletter:

<?GIS NEWSLETTER 1?>

You should specify this TAG for every mailing list that exists in your system, and that may be selected by the subscriber. Behind the word “Newsletter,” you need to define the ID of the mailing list that will be found in the overview of the mailing lists (under Mailing List Management). The form fields for subscribing to mailing lists are predefined as check boxes, so that subscribers can sign up for more than one mailing list. It is also possible to predefine the mailing list that the user should be subscribed on without offering the option of checking out. In this case, all of the other check boxes will be invisible.

Example:

<?GIS NEWSLETTER hidden=1?>

This TAG will then be changed in the source code of the template into a “hidden field.” If you want the subscriber to see all of the mailing lists he or she may subscribe to while only letting them subscribe to one of them, you need to define a “radio” button here.

The TAG will then look like this:

<?GIS NEWSLETTER 1 radio?>
<?GIS NEWSLETTER 2 radio?>
<?GIS NEWSLETTER 3 radio?>

Please consider adding the “radio” button to all of the NEWSLETTER fields. If you want to define a default newsletter, add the following:

Example:

<?GIS NEWSLETTER 1 radio checked?>

Extract of the HTML code of the sample template:

Example Newsletter:

<TR>
  <TD><?GIS NEWSLETTER 1 checked?><FONT face="verdana" size="1"><STRONG>Stock-Newsletter</STRONG></FONT></TD>
</TR>
<TR>
  <TD><?GIS NEWSLETTER 2 checked?><FONT face="verdana" size="1"><STRONG>New Market </STRONG></FONT</TD>
</TR>
<TR>
  <TD><?GIS NEWSLETTER 3?><FONT face="verdana" size="1"><STRONG>Investmentfunds </STRONG></FONT></TD>
</TR>
<TR>
  <TD><?GIS NEWSLETTER 4?><FONT face="verdana" size="1"><STRONG>IPO-Newsletter </STRONG></FONT></TD>
</TR>

Input boxes for passwords

If the subscriber must insert his or her password before he or she may unsubscribe from one or more mailing lists, you need to define the data field PASSWORD as a mandatory filed. This will be defined in the database designer. Add the following information to your template to layout

an input box for passwords:

Password:
<?GIS PASSWORD?>
Repeat Password:
<?GIS PASSWORD?>

If you add two of these input boxes for passwords, BACKCLICK will automatically check to see if they match. This will prevent spelling mistakes.

Success messages

You may define a success message that will display a subscriber’s successful unsubscription from a mailing list.

Example:

<!--SUCCESS-->
  <TR>
    <TD>
      <FONT face="verdana" size="2"><STRONG>Congratulations! </STRONG></FONT><BR>
      <FONT face="verdana" size="1">You have been successfully unsubscribed from the mailing list!<BR></FONT>
    </TD>
  </TR>
<!--/SUCCESS-->

To display the name of the mailing list the subscriber unsubscribed from, enter the following TAG:

Example: Mailing list 1

<!--SUCCESS:REMOVED-NEWSLETTER-1-->
  <TR>
    <TD><FONT face="verdana" size="1">Stock-Newsletter</FONT></TD>
  </TR>
<!--/SUCCESS:REMOVED-NEWSLETTER-1-->

Example: Mailing list 2

<!--SUCCESS:REMOVED-NEWSLETTER-2-->
  <TR>
    <TD><FONT face="verdana" size="1">New Market Newsletter</FONT></TD>
  </TR>
<!--/SUCCESS:REMOVED-NEWSLETTER-2-->

By using the -TAG, you can create a link that will lead the subscriber to the starting page.

<A href="<!--RETURN2-->">Please click here to return to the starting page.</A>

If you have finished the -TAG, the template for unsubscribing from a mailing list is ready to use.

Links

The Templates

What do you think about this topic? Send feedback!