Help

Help

Formidable in your Dashboard
Go to Concrete 5 Full Dashboard. Check the Formidable section in the Dashboard. Click on "Forms" within the Formidable section of the Dashboard to see the created forms. Click on "Results" to show the results from any of the forms created with Formidable. Note that we also created a page in the "Reports" section of the Dashboard. This also will lead to the "Results"-page of Formidable.

Create a form
Click on the green "Create a new FormidableForm"-button.
The new FormidableForm shows you the properties of this form. When adding a new FormidableForm, some fields are filled by default. Just walk through the form and select or fill where needed.
If you'r done, check your input and click on "Save" on the bottom of the page. Your form is created! If all values are correct you are redirected to the "Elements" of your new FormidableForm. Note that the gray buttons on the top left of the page are now enabled. You can easily jump from form properties to the form elements.

Duplicating forms
Duplicates forms with all the elements and mailings.

Add layout and elements
In the "Layout and elements"-tab of your form you can create the from itself. Within rows you can add columns and elements. This way you can easily create any form with any layout you like. Click on a column allows you to add elements in the column. In the popup you can select the element you would like to add to your form. You can also quicksearch your element if you like. When you found your element just click on it and fillout the element details in the new popup. When you are done, just click save. The new element is added to your form.

Editing layout and elements
You can easily drag elements to sort them out. But you can also move columns and rows if you like. Any changes will be saved automatically. If you need to change an element just click on the name and choose "edit".

Element options
For each element you have a list of options or properties available. Not every element is the same, so they can vary for each element. Label/Name: is the elements label, this label is shown in the forntend of your form.
Hide label / name: If you want to hide the label in the form.
Required: required for the submitter or not.
Confirmation: allows the submitter to enter the value twice. Both values need to match.
Placeholder: nice placeholder for the element.
Element Options: adding values to selector elements (checkbox, radio, select, etc)
Default value: when viewed for the first time the element can have a value already inserted.
Minimum / Maximum: limit the amount of chars, words, values or selections
Masking: mask the input of the element so you always get formatted data.
Tooltip / Description: help the submitted with a tooltip
Appearance: change the appearence of an element or layout.
CSS class: add a custom class to the element. Usefull for theming.

Deleting elements
If you have no need for a certain element you can delete the element. Note that all corresponding submitted data will also be deleted.

Duplicating elements
Just do it! See what happens...

Mail after submission
With Formidable you can create different mailings for each Formidable Form. On every submission all the mailings that are created for this form will be submitted. It's not required to have a mailing.

Add or edit mailings
Go to the mailing page of the form you wish to edit. Click on the green "Create a new mail"-button.
The new FormidableForm shows you the properties of the mail you are about to create. First we need to provide a sender. The sender of the mail can be a custom sender (use the selectbox and select "Send from custom sender"). Insert "Name" and "Email Address" in the inputfields. If you have an "Email Address"- or a "Recipient Selector"-field in your form you are able to select it here. So the sender of the mail could easily be a form submitter. Note that in case of multiple submitters (only with multiple Recipient Selector) the sender of the form is always the first selected. Now we need to set the recipients. There are multiple options here. If you have an "Email Address"- or a "Recipient Selector"-field in your form you are able to select them here (use CTRL-key to select multiple). In case you don't want to select any you can also send to a custom email address. After that the hard part is over. Add a "Subject" to your mailing and add a "Message". Formidable is able to send HTML-mailings, so use the WYSIWYG-block to add HTML. You can also use images from the Filemanager or add links to pages within you Concrete5 website. Also available in the WYSIWYG-block is the use of form-elements in you mailing. In the Editbar above the WYSIWYG-block you see four links ("Add Image", "Add File", "Insert Link to Page" and "Insert Formidable Element"). Click on "Insert Formidable Element" and a popup appears with the the form elements from you form. There are serveral options here. When adding the "All form elements" tag in the message, Formidable will generate a list of labels and values in the mail. You also can add individually labels and values of form elements. The button "Both" will insert a string with label and value split by a colon (:). After setting up your message you can add multiple attachments to the mail. There will be send to the recipients along with the mail. Note that the attachments are loaded from the filemanager.

Deleting mailings
Just click on the "Delete"-button to delete the mail. You'll be asked to confirm.

Duplicating mailings
Just do it! See what happens...

Results
Formidable adds a page in the "Reports"-section of the Concrete5 Dashboard. It also has it's own result page in the "Formidable"-section. Both pages are the same. You can customize the results and offcourse export the results to an Excel-file (xls)

Adding a form to a page
When you are done building your form, you can add this to a page or stack. Just go to the page you want to have your form in. Click on "Add to YourAreaName" in the page and select "Formidable Form" in the blocks list. Select the form you want to show on the page.

Translations

In some cases you want to translate the values for the elements. For example the address-field. In USA it's called Province/State, but in the UK it's called Counties. The best solution for this is to use the default language handler of Concrete5. To do this you have to create a languagefile for the specific language you are using. If the languagefile is created you can upload this in the folder /languages/. Then go to the System and Settings page in the Dashboard and change the default language of your C5 website to the language you just added. This way the form field will be translated. To help you on your way we created a number of different versions for Formidable. You can download it at: http://www.concrete5-addons.nl/addons/formidable/languages/

For the date element you could use a language-file but you don't need to. When you are using the datepicker you can check the "advanced"-checkbox. This way you can easily add your own values to the datepicker.
For example:

[code] dayNamesMin:[ "Su", "Mo", "Tu", "We", "Th", "Fr", "Sa" ], dayNamesShort:[ "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" ], dayNames:[ "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" ], monthNames:[ "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" ] monthNamesShort: [ "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec" ] [/code]