Email Form

The Email Form feature sends email to an administrator or registered user of the site containing information a visitor has entered into a form. You can create an HTML form on your site with any fields that you like; information entered into the form will be formatted into an email message and sent to the specified user.

The Email Form feature accepts form posts to http://YOURSITE.editme.com/_EmailForm along with some special hidden fields that specify settings. All special fields have names beginning with an underscore ( _ ). All fields submitted with the form that do not begin with an underscore are emailed to the specified user(s).

This feature is designed for EditMe administrators and users to collect information from site visitors. It is not a mass email feature. Since a valid EditMe username must be specified in the form as a hidden field, and not an email address, this feature cannot be misused to send spam to arbitrary email addresses.

Settings Fields 

The following hidden fields can be included in the form to configure the behavior of the Email Form:

 _sendto

Specifies an EditMe user name that should receive form posts as email. An EditMe username must be used; entering an email address will not work. This field can be specified multiple times to send to multiple users. If no _sendto fields exist, no emails will be sent and form posts will be lost. If a _sendto field contains an invalid or non-existant username, it is ignored.

 _redirect

Specifies the URL that visitors will be sent to after submitting the form. You can specify a full URL, or just a page name on the site. If no redirect is specified, visitors will be sent to the site's default page.

 _from

Specifies the "from address" of the email sent containing the form data. If not specified, noreply@editme.com is used.

_fromname

Specifieds the "from name" of the email sent containing the form data. This field is optional.

_subject

Specifies the email subject. If unspecified, "EditMe Form Post" is used.

_nousername

By default, a special field is included in the email containing the username or IP address of the visitor who submitted the form. If you don't want to include this data in the email, include this field with any value. Otherwise, do not include this field.

_fields

Optionally contains a list of field names to include in the email. This field is useful if there are form fields that don't begin with an underscore that you do not want to include in the email, or to specify a specific order of fields in the email. If this field is not specified, all form fields that don't begin with an underscore are included in the message text in an unspecified order. Field names specified in the value of this field must be separated by a semi-colon ( ; ).

Sample HTML Form Code

The following HTML code specifies a simple form that collects a subject and message from a visitor and sends it to the "admin" user of the site.

  <form action="/_EmailForm" method="post">
    <input type="hidden" name="_sendto"
        value="admin">
    <input type="hidden" name="_redirect"
        value="ThankYou">
    <input type="hidden" name="_from"
        value="noreply@editme.com">
    <input type="hidden" name="_fields"
        value="Visitor Name;Visitor Email;Message">

    <p>Full Name:<br/>
        <input type="text" name="Visitor Name"></p>
    <p>Email Address:<br/>
        <input type="text" name="Visitor Email"></p>
    <p>Subject:<br/>
        <input type="text" name="_subject"></p>
    <p>Enter a message: <br>
        <textarea name="Message"></textarea>
    </p>
    <p><input type="submit" value="Send"></p>
</form>

The easiest way to use this sample is to:

1. Create a page on your site and enter the Edit screen.
2. Click the "Plain Text" checkbox and click Save.
3. Paste the code sample above into the plain text editor; modifying values to suit your preferences.
4. Click Save.
5. This page can now be included in other pages using the [[include:PageName]] tag.
   

This specific method is recommended because EditMe's editor does not allow TEXTAREA form fields to be saved.