Test Newsletter

Test Newsletter

A subscriber may sign up for a newsletter on approval. By using this function, BACKCLICK guarantees that in the approval period, no data for that subscriber will be saved in the system’s database. After the approval period, the subscriber may decide to subscribe permanently to one or more mailing lists or newsletter(s). If there is an HTML-page designed according to your requirements, you may now create the template by filling in the BACKCLICK-specific TAGs for the input boxes where the subscribers may fill in their data. For better comprehension, you should open the template while reading this documentation. We will only describe the TAGs that are needed for the template ID 5.

Abb. 8.4.7 - WebInterface Templates (Beispiel ID 5)

between the <HEAD>-</HEAD>-TAG will always return the subscriber to the page you defined in your template link after having subscribed successfully.

<!--REFRESH:30-->

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.

Definition of Form-Fields:

<FORM method="post" action="web.testletter?tid=5" name="testletter"></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-->
You may subscribe on approval 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. If a subscriber requests a test newsletter, the system will send out the last newsletter that was put into the database. You should define an error message, in case there is no newsletter found in the system’s database. The error message may look like this:

<!--ERROR:NO-ARCHIVE-1-->
  <TR>
    <TD><FONT face="verdana" size="1">There is no Stock-Newsletter found in our archives at present. </FONT></TD>
  </TR>
<!--/ERROR:NO-ARCHIVE-1-->

NO-ARCHIVE-1 refers to a newsletter defined on the mailing list ID 1.

Note: Newsletters will only be saved in the system after the sending has been completed

This is a common success message. BACKCLICK lets you define a success message for every mailing list existing in your system. To do this, add the ID of the mailing list separated by “-“.

Example: 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 newsletter!</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: The subscriber entered a wrong e-mail address:

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

In between these messages, you may use any HTML code (if needed).

The subscriber did not enter an e-mail address:

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

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.” The TAGs need to be placed within the -TAGs.

<!--TEST-LETTER-->.................<!--/TEST-LETTER-->

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. You may use the short <GIS>-TAGs here because all of the other appropriate definitions have already been made in your database designer, and these TAGs will display the entries.

<TR>
  <TD><?GIS NEWSLETTER 1?><FONT face="verdana" size="1"><STRONG>Stock-Newsletter</STRONG></FONT></TD>
</TR>
<TR>
  <TD><?GIS NEWSLETTER 2?><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>

BACKCLICK lets you send out a sample newsletter to a subscriber who requests it. The subscriber must not select the sample. Write the following information into your template:

<TR>
  <TD><?GIS NEWSLETTER 1 "hidden=1"?><FONT face="verdana" size="1"><STRONG>Stock-Newsletter</STRONG></FONT></TD>
</TR>

Beispiel Email:

<?GIS EMAIL?>

Success messages

To define a success message for subscribers that tells them that the test newsletter has been sent, write the following TAG into your template:

<!--SUCCESS-->
  <TR>
    <TD>
    <FONT face="verdana" size="2"><STRONG>Congratulations!</STRONG></FONT><P>
    <FONT face="verdana" size="1">The following newsletter will be
    sent to the following e-mail address:
    <BR>
    <UL>
      <STRONG>'<?GIS name="EMAIL" content="form"?>'</STRONG>
    </UL>
    <BR><BR></FONT>
    </TD>
  </TR>
<!--/SUCCESS-->

Example for the mailing list ID 1:

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

After you have finished the -TAG, you may now use the template.

Links

The Templates

What do you think about this topic? Send feedback!