Help Docs

FormSnap Help Page

Help Docs | Stack Elements | FormSnap Product Page

FormSnap Base

This Stack Element must be on all pages that contain a FormSnap form. This stack sets the forms basic parameters including the receipt email template and text for the form's error messages. Note that this stack contains settings in both the body are of the stack as well as the Stacks HUD. ALL other form stacks must be placed INSIDE the FormSnap Base stack.

Stack Content Settings (Extended Controls):

Email Template
This field contains the template for the email that will be sent to the FORM RECIPIENT upon successful submission. Customize the text in the template field to meet your needs meet your needs. This is a styled text field. You can add images to your template and style text with RapidWeaver's styling tools. Simply drag in appropriately sized 72dpi images - they'll be sent as part of your receipt. You can also include field values from the form in the template. We strongly recommend keeping your form item names VERY SIMPLE for this reason. Trust us, simple item names make for MUCH easier template design. Note that item names are only used INTERNALLY on the form. Your visitors will never see them. Get wild with your field labels (the text on the form adjacent to the entry field) but KEEP ITEM NAMES SIMPLE. If you have a field with an item named: email then you'd reference it your template as #email#. If you look at the content area of any form item stack, the item name is displayed at the bottom. Items with spaces will generally have the space replaced with an underscore (ie, your name becomes #your_name# ).Do not use non alphanumeric characters as part of your item name. Keep it simple. A-Z and 0-9. You can also use the following placeholders to collect ip, browser and date info from the sender:
#ip#
#browser#
#page#
#date#
Receipt Template
The receipt template works just like the email template field. However, this template will be used to send a form submission receipt to the form sender. If you DO want to send receipts, make sure you have the Send Receipt checkbox enabled in the FormSnap Base HUD (under Optional Settings).
General Error
The message you enter here will be displayed if there is a general error that the form script can not provide further details on.
Success Message
This text will be displayed when a form is successfully submitted and all emails have been generated and sent. If your form is submitting successfully but you don't appear to be receiving any emails, try sending to a local email address - - one that is hosted by the same provider hosting the form page. This will help eliminate spam filtering or DNS issues.
reCaptcha Error
This text will be displayed if you have reCaptcha enabled and the user fails to provide valid answers to the reCaptcha challenge.
File Size Error
If you have a File Upload stack on your form, FormSnap will limit files to the size you specify in the HUD for FormSnap Base ->Security Settings. By default this is 10K. The text you enter here will be displayed if a user tries to submit a form with a size larger than your file limit.
File Type Error
If you have a File Upload stack on your form, FormSnap will limit files to the size you specify in the HUD for FormSnap Base ->Security Settings -> Allowed File Type. Users may ONLY submit files of the type you specify. The text you enter here will be displayed if a user tries to submit a form with a non-allowed file type.
Required Field Missing
The text entered here will be displayed when you have a field(s) marked as required and no value has been supplied by the sender.
Invalid Email
Email address formatting validation is built into FormSnap. On an input field selected as the REPLY TO item in the HUD of this stack, FormSnap will verify that the input is formatted as an email address (including @ and acceptable TLD extension).
OK Button Text
Test for the dismissal button displayed when a form success/error message is generated.
Redirect Message
If you redirect to success/fail pages, the text provided here will be displayed while the form processes and the redirect is initiated.
PHP Custom Code ( Advanced )
This field is self-exlanatory to users with php skills required to customize the FormSnap processing script. We can not supply or support custom php code. If you're not sure what this field is for......LEAVE IT BLANK.

Controls

Required Settings

From Name
The name that will be displayed as the FROM name on the form based email. This is a STATIC VALUE. Field Names not allowed.
From Email
The email address that will be displayed as the FROM address on the form based email. This is a STATIC VALUE. Field Names not allowed.
ReplyTo Item
The item name that will receive the value for the reply-to email address. NOTE: This is JUST the ITEM NAME - NO # symbols required here. JUST the item name of the field that solicits your viewers email address.
Subject Item
The item name that will be the email's subject. NOTE: This is JUST the ITEM NAME - NO # symbols required here. If you want to use a static subject value, add a text input of type HIDDEN and give it a default value of your desired subject.
To
Comma separated list of email addresses to send to.

Optional Settings

CC
Comma separated list of email addresses to send carbon copy (cc) to.
BCC
Comma separated list of email addresses to send blind carbon copy (bcc) to.
Email Encoding
If you have a specific encoding requirement or are connecting to an BITMIME SMTP server, you may need to update your encoding selection. The default will work for most users. If your mail host or an application you'll be working with to manage mail specifies alternate encoding, you can select your desired method here.
Email Charset
If your language utilizes characters not supported by uft-8, which is the default setting, choose a compatible character set from the pulldown menu.
Send Receipt
If you want to send a receipt to the form sender, enable this checkbox. Make sure you've setup a receipt template in the content area of the FormSnap base stack and have entered a valid item name in the Reply To Item setting in the FormSnap Base HUD.
Receipt Prefix This will be added to the beginning of the email's subject line. This setting is generally only modified if changing the form to a non-English language.

Security Settings

Allowed File Type
A pipe separated list of the types of files you WILL allow users to send if you have a file attachment field on the form. Use universally recognized file extensions.
Word Filter
A comma-delimited list of words ( or strings ) to be filtered out of any form submission. This is good for removing any spam injection related strings like "bcc:" or "to:".
Max File Size
The max allowable size of each SEPARATE attachment here. (Note, if you have 3 file attachment fields and specify 10MB as your Max Attachment Size, that means each file may be up to 10MB - - or a total of 30MB for your form. Check with your host or ISP to make sure you don't exceed their maximum attachment size). Keep it reasonable, some hosts will have limitations on file size or # of files that may be attached to script generated mail. If you are receiving form submissions without their attachments, check with your host to see if you can customize the max_post_size in your php.ini

reCaptcha Settings

Use reCaptcha
If you've signed up for your own Google reCaptcha API keys, you can utilize them here. They are not required, if you do not provide key values here, our keys will be used by default.
Public Key
If you need to use your own key, see: http://code.google.com/apis/recaptcha/docs/php.html
Private Key
If you need to use your own key, see: http://code.google.com/apis/recaptcha/docs/php.html

SMTP Settings

Use SMTP
FormSnap can send directly via php mail() (default) or optionally, via SMTP. Check this box to enable SMTP and provide credentials below.
Host Name
Your SMTP server's host name [Ex: mail.yourdomain.com]
Host Port
The port your SMTP server accepts connections on. This will probably vary depending on whether or not you are using a secure protocol (see below)
Send Secure
If your host supports secure mail connections enable this checkbox and provide prefix information in the next field
Secure Prefix
If your host supports secure mail connections, select the proper protocol (SSL or TLS).
Use Authentication
If using SMTP, Authentication must generally be enabled, check this box to enable and provide username/password below.
Username
Email account username authorized to send mail on the host name provided above
Password
Password for this email account.

Redirect Settings

After form submission, FormSnap will display an on-page message letting the user know if the form has been successfully sent or not. If you would rather redirect to a static success or fail page, enable redirects and choose a page. The page can either be a page selected as part of your site , the form will display on on-page test message

MySQL Settings

Save to MySQL
Enable this checkbox if you want to save user submitted data to a MySQL database. Note that FormSnap does NOT create your database, table or fields. Most hosts provide phpmyadmin to allow you to create and manage your hosted databases. You will need to use phpmyadmin to create your database, at least one table and fields for each form item that needs to be saved. You will map individual form items to MySQL fields on each Stack element's info pane. The settings in the base element provide general information about your database. If you do not have or can not locate this information you will need to obtain it from your host.
Host
Your host's MySQL database host name. This is almost always 'localhost' , but could be different for some web hosts ( i.e. db.yourhost.com ).
Database
Your MySQL database name ( case sensitive ).
Table
The table you've created within your MySQL database to store data.
Username
Username used to login to your MySQL database host.
Password
Password used to login to your MySQL database host.
Do Not Send Email
Enable this to prevent form from emailing the data submitted to it. Great forms that collect data in MySQL, but don't want email sent.

Style Settings

Label Size
The default size in pixels for all field labels on the form. Larger value = bigger text labels.
Labels Color
Sets the default color for all standard (non-required) fields.
Required Label (color)
Sets the default text color for all required field labels.
Label On Top
Enabling this checkbox will place your form labels ABOVE their field instead of to the left. This is generally recommended if you want to keep uniform left margin field alignment.
Bold Label
Enabling this checkbox will apply bold styling to your labels.
Apply Uniform
Enable this checkbox to apply uniformjs to your form. This is an enhanced appearance package that adds an enhanced appearance package to your form.
Learn more at: http://www.uniformjs.com

FormSnap Button

Add the FormSnap Button Stack wherever you'd like to place a form Submit or Reset button.

Button Type
Select the action the button should perform (Submit the form or Reset/Clear the form).
Value / Title
The text that will appear on the button. For example "Submit Form" or "Send".
Custom Image
Select your appropriately sized custom image for this button in jpg, gif or png format.

File Upload

Item Name:
This item's name. The item name is used INTERNALLY on the form and templates and should be be alphanumeric ONLY (no symbols/punctuation/mathematical operators).
Item Label
The label the user will see on the published form adjacent to the input.
Default Text
*Text used with File Upload input.
Button Text
*Text used on Choose button.
Required
If the user MUST attach a file to submit the form, enable this checkbox.
Display Label
If you do not wish to display the field's name next to the file selection button, disable this checkbox.

* You must have Uniform enabled in the style settings of the base stack.

Input Field

Input Type
There are three field types supported with the Text Input Field:
- Text: A standard text entry field. Users can enter and view text into this field type.
- Hidden: This field type is hidden and not shown to the user.
- Password: Treated just like a normal text field internally but user input is hidden on the form and only solid bullets are displayed.
Item Name
This item's name. The item name is used INTERNALLY on the form and templates and should be be alphanumeric ONLY (no symbols/punctuation/mathematical operators).
Item Label
The label the user will see on the published form adjacent to the input.
Width
The width (in pixels) of the Text field input.
Required
If the user MUST provide data in this field to submit the form, enable this checkbox.
Display Label
If you do not wish to display the field's name next to the input selection, disable this checkbox.
Save to MySQL
If you will be saving your form data to a MySQL database, enter the MySQL field name in your database that corresponds to this input. Note that radio and checkbox items are an array of values.

Radio / Checkbox Input

Input Type
The type of item you'd like to add. This stack can be either a Radio button or Checkbox form item.
Item Name
This item's name. The item name is used INTERNALLY on the form and templates and should be be alphanumeric ONLY (no symbols/punctuation/mathematical operators).
Item Label
The label the user will see on the published form adjacent to the input.
Required
If the user MUST provide data in this field to submit the form, enable this checkbox.
Option Count:
The number of options this checkbox or radio item will have. Use the slider to create the desired number of inputs.
List Horizontal
By default, radio button and checkbox items are displayed vertically. If you'd like to display them horizontally (adjacent to each other), enable this checkbox.
Display Label
If you do not wish to display the field's name next to the input selection, disable this checkbox.
Save to MySQL
If you will be saving your form data to a MySQL database, enter the MySQL field name in your database that corresponds to this input. Note that radio and checkbox items are an array of values.

reCaptcha Test

Note that reCaptcha should be enabled in FormSnap Base if you will be adding this element to your form.

Item Label
The label the user will see on the published form adjacent to the input.
Refresh Text
Label text for the button that requests a new reCaptcha challenge if the user is unable to complete the one presented when the form loads on the page.
Required
In most cases, reCaptcha fields will be REQUIRED fields. Enable this checkbox so that the Form can not be submitted without completing valid reCaptcha challenge.
Display Label
If you do not wish to display the field's name next to the input selection, disable this checkbox.

Select ( Popup ) Input

Item Name
This item's name. The item name is used INTERNALLY on the form and templates and should be be alphanumeric ONLY (no symbols/punctuation/mathematical operators).
Item Label
The label the user will see on the published form adjacent to the input.
Required
If the user MUST provide data in this field to submit the form, enable this checkbox.
Option Count
The number of options (lines) this popup menu will contain. Use the slider to create the desired number of inputs.
Display Label
If you do not wish to display the field's name next to the input selection, disable this checkbox.
Save to MySQL
If you will be saving your form data to a MySQL database, enter the MySQL field name in your database that corresponds to this input. Note that radio and checkbox items are an array of values.

Text Area

Item Name
This item's name. The item name is used INTERNALLY on the form and templates and should be be alphanumeric ONLY (no symbols/punctuation/mathematical operators).
Item Label
The label the user will see on the published form adjacent to the input.
Width
The width (in pixels) of the Text Area.
Height:
The height (in pixels) of the Text Area.
Required
If the user MUST provide data in this field to submit the form, enable this checkbox.
Display Label
If you do not wish to display the field's name next to the input selection, disable this checkbox.
Save to MySQL
If you will be saving your form data to a MySQL database, enter the MySQL field name in your database that corresponds to this input. Note that radio and checkbox items are an array of values.

Yabdab Inc.