URL of the form: | |
---|---|
Error message: |
Thank you for your patience, and sorry for any inconvenience.
Please use your browser's [Back] button to return to the form and correct any errors.
Welcome to SimpleMail administration. You may choose from the following:
Create a new form database
Delete an existing form database
Change the administrator name and/or password
If you are happy with the attributes of the form as listed, you can push the "Go to the main administration menu" button at the bottom of the form and no changes will be made.
If you change the name of a variable in your form, you must recreate the database for that form.
If you plan to use a customized response page make sure that you specify
the complete URL, including
Response URL:
By default SimpleMail will use a META "refresh" tag to send users to your response page if you include one. Very old browsers do not know how to process that tag, so they will see the standard SimpleMail response page instead of your custom one. If you would rather not use the "refresh" tag, check this box.
Do not use META "refresh" to show my custom response page |
|
---|
If you would like to specify a URL for an error reply to your users, enter it here. If there is no page specified, the default error form will be used as described in the form creation help file.
If you plan to use a customized error page make sure that you specify
the complete URL, including
Error URL:
SimpleMail can customize the value of the From: e-mail address and Subject: line in the e-mail that you receive after users POST mail from your form. Either or both lines can be plain text that you specify here, variables that you use in your form, or in the Subject: a combination of both. If you would like to use a plain text string, you can enter it directly into this form below. You can use the value of a variable from your form by putting an ampersand (&) before the variable name. For example if you want the From: e-mail address to be the variable called "users_email" from your form, you would put this in the form below:
&users_email
Please be aware that the From: e-mail field can only have ONE e-mail address, and no additional plain text. If you use a variable from your form make sure to add the "E-mail" and "Mandatory" attributes to that variable in the attributes section below. Otherwise Miva will not send mail from your form.
The From: and Subject: lines must be filled in with something in order
for Miva to send your mail. If you are not concerned with what appears in
those fields on the e-mail you receive the following default text will be
filled in for you.
E-mail "From:" address:
E-mail "Subject:" line:
In addition to sending e-mail to the account you specify SimpleMail can
save a copy of each mail it sends to a file. The files for this form will be
saved in the
Save mail to a file: |
|
---|
The individual variables from your form can have the following attributes. Is the variable Mandatory? Is the variable a Numeric field? Is it an E-mail address? And does that field contain an IP address? Specifying that a variable is both an e-mail address and a number would not be very useful. :)
If a user of your form enters information which does not match the attributes for that field specified here SimpleMail will send that user an error indicating what information needs to be changed, either through the default error form or through a form that you specify above.
Form variable | Mandatory | Numeric | IP | |||||
---|---|---|---|---|---|---|---|---|
Below is the existing format for the e-mail that will be sent when
the form at
&your_variable_name
SimpleMail will convert that to the value of the variable with that name. For instance, if your variable had the name "product_line," which contains the name of -- you guessed it -- one of your product lines, you would use a line like this:
Product line: &product_line
This will display the following text in the e-mail you receive if the user filling out your form enters "Long handled brushes" as the product line he or she is interested in:
Product line: Long handled brushes
Caution: Miva uses an XML (eXtensible Markup Language) script interpreter that works like HTML. Therefore you must make sure that any plain text you enter does not contain the HTML formatting characters <, >, &, or ". You should also use caution with characters like ( ), and { } because Miva uses them internally.
Edit your formatting here:
Then you should be able to resume the operation you were attempting when this error occured.
If you need assistance please feel free to contact Customer Support.
If you need assistance please feel free to contact Customer Support.
Please change the name of this variable, and any others that have invalid characters and return to the form database creation process.
More help is available at the
form creation help file.
If you need assistance please feel free to contact Customer Support.
If you have not yet set up a mail form for use with SimpleMail,
please take a moment to look at the help file to familiarize yourself
with the basics. Next, you need to know the e-mail address or addresses to which your mail
from this form will be sent. You MUST set the e-mail destination
for this form in the database. Creating a form that sends mail to random
destinations is a violation of our Acceptable Use Policy for your account.
If you are ready to start the process of creating a database for your form,
enter the URL here. Because of the way that certain browsers handle the
'http_referer' variable it is highly recommended that you not put
your form on the index page in any document directory. It is better to put a link
from the index page to the page which will have your form.
URL of your form:
Destination E-mail:
Your FORM tag must look EXACTLY like this. If you use something different it will not work.
<FORM method="POST" action="&[SM_documenturl]">
You can use almost any label for the name=" " variables in your HTML form; however your variable names must not begin with the characters, "SM_" or they will conflict with the internal SimpleMail variables. Also, Miva requires that all variable names contain only the characters A-Z, a-z, 0-9, and '_' (underscore).
Unfortunately, due to limitations in Miva you cannot use CGI tags where the input type is an image or a file, and if you use a <select> tag you cannot use the "multiple" attribute in that tag.
Because of the way that certain browsers handle the 'http_referer' variable it is highly recommended that you not put your form on the index page in any document directory. It is better to put a link from the index page to the page which will have your form. Also, you will get better results if you use only one form per HTML page.
If you change the name of a variable in your form, you must recreate the database for that form.
<HTML>
<HEAD>
<TITLE>Very Simple Mail Form</TITLE>
</HEAD>
<BODY>
This is my very simple mail form
<!-- The line below is essential and must be included -->
<FORM method="POST" action="&[SM_documenturl]">
<P>Put your From: e-mail address here:<BR>
<input type="text" name="users_email"
value="me@me.com" maxlength="50"
size="50">
<P>Put your message here:<BR>
<textarea name="users_message" cols="70"
rows="10"></textarea>
<P><input type="submit" value="Send my mail">
</FORM>
</BODY>
</HTML>
You can copy the above text and paste it into a file which you can upload to your account. This will give you a basic idea of how the form works together with SimpleMail. Make sure that you save your file as plain text, sometimes called ASCII text.
<HTML>
<HEAD>
<TITLE>Form Error</TITLE>
</HEAD>
<BODY bgcolor="#FFFFFF">
<Center><H1><font color="#FF0000">Form Error</font></H1></Center>
One or more of the fields that you entered into the form was not correct.
Here is a summary of the errors:
<P><blockquote>
##List of errors here##
</blockquote>
Please use your browser's [Back] button to return to the form
and correct any errors.
</BODY>
</HTML>
If you would like to specify that your user receive a customized error message you can create a page with source similar to the one above and specify the URL in your form database. Wherever you place the "##List of errors here##" pseudo-tag it will be replaced with the actual list of errors generated by the user's input.
If you choose to make a field mandatory, you should give special attention to the name of that field. Your user will receive an error message similar to:
This field is mandatory: users_emailIf the name of the field is not fairly self-explanatory your user may become confused as to which field was not filled in properly.
You can use this error form as a sample like the sample mail form above if you would like to see how it works. However an error URL is not mandatory if the simple message above is sufficient for your needs.