Forgotten password

Forgotten password

If you want to make it possible for subscribers to change their profiles themselves, you should define an input box for entering a password. This ensures that only the subscriber who knows the password will be able to change his or her profile data. On the site where the examples are shown (http://www.yourdomain.de/bc/web.html), you can see how to create an input box for passwords. If a subscriber forgot his or her password, they may ask the system to send it out again. We will now describe how to program this template in case of forgotten passwords.

Abb. 8.4.6 - WebInterface Templates (Beispiel ID 6)

between the <HEAD>-</HEAD>-TAG: The subscriber will always return to the page you defined in your template link after having received the password. The number “30” defines the number of seconds it will take until the subscriber is returned to the starting page. This is an optional TAG.

<!--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 put in inserted between the <FORM>-</FORM>-TAGs. To create this form field, you need to write the following code into your source code after the HTML TAG <BODY>.

Introduction Form-Field:

<FORM method="post" action="web.change_profile?tid=7" name="change_profile"></FORM>

Add introduction sentences

You may define introduction sentences for the “Change profile” template. 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 click here to receive a password!
<!--/ENTRY-->

Error messages

BACKCLICK is able to show several error messages in case of wrong information provided by the subscriber, any input box left empty, or any system error. To define the error messages, the subscriber will see if he or she entered a wrong e-mail address. If BACKCLICK cannot find the entered e-mail address in the database, you will need to write the following TAGs for your HTML-site:

<!--ERROR:EMAIL-->
Please enter the correct e-mail address!
The e-mail address '<?GIS name="EMAIL" content="form"?>' is either wrong or you are subscribed
in our system with another e-mail address.
<! --/ERROR:EMAIL-->

There is no password defined for this account:

<!--ERROR:NOPASSWORD-->
<TR>
<TD><FONT face="verdana" size="1"><P>You did not define a password.</FONT></TD>
</TR>
<!--/ERROR:NOPASSWORD-->

The subscriber is unknown with this e-mail address:

<!--ERROR:SUBSCRIBER-->
  <TR>
    <TD><FONT face="verdana" size="1">You are not subscribed in our system. </FONT></TD>
  </TR>
<!--/ERROR:SUBSCRIBER-->

Inserting input boxes

You only need to insert the input box for the e-mail address within the following TAG:

<!--NEW-USER-->

The definition for the input box should be:

<?GIS EMAIL?>

The definition for the input box should be:

<!--/NEW-USER-->

Success messages

If the e-mail address exists in your system, the following success message will be displayed:

<!--/SUCCESS-->
    You will soon receive your password. The password will be
    sent to: '<?GIS name="EMAIL" content="form"?>'
<!--/SUCCESS-->

Layout and content of the password e-mail

The content and the layout may be defined freely. The content of the e-mail reminding subscribers of their password will be defined at a later stage, while you are programming the template. All definitions that are necessary for this template should be added after the HTML code.

The example of template ID7:

<!--FORGOT-PW-EMAIL-->
<!--SENDER-NAME-->PASSWORD MASTER<!--/SENDER-NAME-->
<!--PRIORITY-->3<!--/PRIORITY-->
<!--TO-->$$FIRSTNAME$$ $$LASTNAME$$<!--/TO-->
<!--SUBJECT-->Your question for a password reminder. <!--/SUBJECT-->
<!--BODY-->
Dear $$TITLE$$ $$LASTNAME$$, please keep this e-mail.

You will need the password whenever you want to change the data in your profile.

Please open the following link:

http://domain.of.the.backclick.installation/bc/servlet/change_profile?tid=ID.des.Templates&EMAIL=$$EMAIL$$&PASSWORD=$$PASSWOR
D$$


Your password is:
-------------------------------------------------
$$PASSWORD$$
-------------------------------------------------


Sincerely yours,
The BACKCLICK Editorial Team


<!--/BODY-->
<!--/FORGOT-PW-EMAIL-->

You will define the layout of the password e-mail by using these TAGs. Here you may decide whether you want to set another sender name or another subject.

Sender’s name within the EMAIL:

<!--SENDER-NAME--> Sender's name <!--/SENDER-NAME-->

The  TAG contains the name that will be displayed in the e-mail client of the subscriber, instead of the e-mail address of the sender defined in the system.

Priority within the EMAIL:

<! --PRIORITY--> 1 <!--/PRIORITY-->

You may define priority for the confirmation e-mail. Selectable values are: 1 (Highest Priority), 2 (High Priority), 3 (Normal Priority), 4 (Low Priority), 5 (Lowest Priority).

Receiver’s name within the EMAIL:

<!--TO-->$$FIRSTNAME$$ $$LASTNAME$$<!--/TO-->

By using the -TAGs, you may define an optional name for the receiver of the e-mail. Within these TAGs, you may access all the personalized fields that exist in your system. Do not use line breaks!

Subject-TAG within the EMAIL:

<!--SUBJECT-->Your confirmation is necessary, $$TITLE$$ $$LASTNAME$$<!--/SUBJECT-->

The subject of the password e-mail must be inserted in this TAG, and will be displayed in the subject line of the recipient’s e-mail client. All of the personalized fields may be accessed here as well. Do not use line breaks!

The actual content of the e-mail is written in between the -TAG and the -TAG. You may use HTML code here.

Links

The Templates

What do you think about this topic? Send feedback!