Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Subscribe.aspx

 

 

This function is contained in predefined subscription forms: it allows users to sign up to a newsletter using a double opt-in method.

...

Subscription form action:

...

 

Code Block
languagehtml/xml
<form method="post" action="http://esempio.emailsp.net/frontend/subscribe.aspx">

 

 

Action address is linked to the console address. If the console address is xyzw.espsrv.com, correct action is http://xyzw.espsrv.com/frontend/subscribe.aspx. Parameters for calling subscribe.aspx function are described below

 

Email field (mandatory):

 

Code Block
languagehtml/xml
<input name="email" type="text" size="60" maxlength="100"> 

...

If you wish to let the user choose more than one list, it is possible to list them using the same name every time, for example:

 

Code Block
languagehtml/xml
<input name="list" type="checkbox" value="2">Seconda lista <br>


<input name="list" type="checkbox" value="3">Terza lista <br> 

...

Please note that the field “prefix” (international prefix) needs not be entered as a separate field, it can also be inserted in the field “number”. Anyway we suggest that it should be kept separated for clarity’s sake.


Groups (optional):  

Code Block
languagehtml/xml
<input name="group" type="checkbox" value="1"> First group <br>
<input name="group" type="checkbox" value="2"> Second group <br> 

...

If you want the user to be subscribed to different groups, without choice, type must be “hidden”, as in the example given below:

 

Code Block
languagehtml/xml
<input name="group" type="hidden" value="2,8,10"> 

 

This way, the user is automatically subscribed to groups 2,8 and 10. Group IDs are listed at the page Settings > Codes table in the MailUp console.

...

Code Block
languagehtml/xml
<input name="campo1" type="text" size="60" maxlength="100"> Name
<input name="campo2" type="text" size="60" maxlength="100"> Surname 

 

 

In the form it is the customer’s responsibility to set the fields, dropdown menus, colors, styles, checkboxes, controls, freely based on one’s needs. The fields which are not necessary can be removed from the registration form. Standard MailUp nomenclature “field1”, “field2”,… “fieldN” must be used. If there are extra fields with names which are not recognized, they will be ignored.

...


Fields to be inserted to modify sender name and/or email address: 

Code Block
languagehtml/xml
<input type="hidden" name="dynsndmail" value="email@example.com" > 
<input type="hidden" name="dynsndname" value="Name Surname"> 

...

It is possible to specify the fields above in case you should want to replace the default values for the list.

...

Xmlsubscribe.aspx (User subscription)

 

This function is similar to the previous one, the main differences lie in the format with which the parameters are defined, and in the fact that "xmlSubscribe" returns an output code with information about the outcome of the operation. 
If you wish to create a form that subscribes the user to more than one list at the same time, and sends only one confirmation email, use "subscribe.aspx" API described above.

...



(1) either email or sms parameter must be specified
(2) if blank, default value for the list will be used
(3) for further details on how to use these fields, please see the section about the "subscribe.aspx" function 



RETURNED VALUES:

 

CODE

DESCRIPTION

0

Operation completed successfully / User already subscribed

1

Generic error

2

Invalid email address or mobile number

  

...


Third level domain name for a console 

Xmlchksubscriber.aspx (User subscription check)

...

This function performs a check on a user subscription status 

...


NOTE:
Code 1 is given as output value both in case of error (e.g. when ListGuid code does not match ListID) and when the user is not subscribed.  

Xmlunsubscribe.aspx (User unsubscription)

 

This function forces the unsubscription of a user from a list. 

...


(1) either email or sms parameter must be specified
(2) if blank, international code for Italy will be used (0039) 


RETURNED VALUES:

 

CODE

DESCRIPTION

0

User unsubscribed successfully

1

Generic error

3

User unknown / already unsubscribed


NOTE:
If successfully unsubscribed, the user will be moved to unsubscribed and will receive an unsubscription confirmation email, if this option has been selectedselecte 

Updsubscriber.aspx (User update)

...