=== Caldera Forms - More Than Contact Forms ===
Contributors: Shelob9, Desertsnowman, christiechirinos, andrewza, nahuelmahe
Tags: form, contact form, forms, form creator, form manager, mailchimp, paypal, stripe, login, payment, forms manager, forms creation
Requires at least: 6.2
Tested up to: 6.4.1
Stable tag: 1.9.8
License: GPLv2
Requires PHP: 7.4

Responsive form builder for contact forms, user registration and login forms, Mailchimp, PayPal Express and more.

== Description ==
Caldera Form is a free and powerful WordPress plugin that creates responsive forms with a simple drag and drop editor. Caldera Forms has many free user-friendly add-ons for both beginners and web developers. Learn more about Caldera Forms at <a href="https://lab.civicrm.org/extensions/caldera-civicrm/caldera-forms">Caldera Forms CiviCRM Community</a>.

Caldera Forms' visual editor simplifies form building for WordPress. Set up your form with multiple columns, add additional pages, and funnel user responses with conditional logic to get more robust data and relevant information from your customers and site visitors. Anti-spam, AJAX, notification emails, and database entry tracking are enabled by default.

Caldera Forms is a free WordPress plugin by <a href="http://CalderaLabs.org?utm_source=dotOrg&utm_medium=plugins&utm_campaign=caldera-forms" title="Caldera : Makers of fine WordPress">Caldera Labs</a>.

> 5 Stars! "Exceptionally well thought out and executed."
>
> -Pippin Williamson: Developer of Easy Digital Downloads, Restrict Content Pro and AffiliateWP.

[youtube https://www.youtube.com/watch?v=O1pY_ZMMWUw]


== Top Features ==
* Intuitive user interface !
* Easy to use - drag and drop !
* Tons of great field types - calculation, dropdown select, radio, file upload
* Conditional logic for form fields, processors and auto-responder recipients!
* Front-end post submissions and post editing with the free Caldera Custom Fields add-on
* NO LIMITATIONS on the number of forms or fields or submissions!
* Unlimited auto-responders!
* Anti-spam by default to stop those bots!
* Export entries to CSV!
* Responsive and accessible by default!


= Responsive By Design =

Caldera Forms is a different kind of WordPress form builder. With its intuitive drag and drop interface, it's never been easier and less stressful to create forms for your WordPress site that look awesome on any device. The visual editor simplifies form building for WordPress. Set up your form with multiple columns, add additional pages, and funnel user responses with conditional logic to get more robust data and relevant information from your customers and visitors.

Whether you are creating a simple contact form or a complex system, you'll love the drag and drop editor. Your site's visitors will love the totally responsive, live-updating forms.

> "Caldera Forms does a thing well, letâ€™s you build forms on your website quickly... I ship it with just about every site these days."
>
> - Alex Vasquez: Owner of the DigiSavvy agency.

= Get Started Quickly With Form Templates =
Caldera Forms ships with form templates that help you create beautiful, responsive forms quickly. With our powerful grid-base form builder, you can add new fields or modify the layout quickly.

Quickly configure the email notification, to let you know when a form has been submitted. Add one or more auto-responder processors to your forms to send emails to your lead.

= Anti-Spam By Default =
Spam is annoying. No form builder is complete without a robust anti-spam system.

 Anti-spam is not an add-on with Caldera Forms, your forms will repel spam using a highly-effective honey pot. Anti-spam does not require configuration or adding a Captcha that will hurt your conversions.

= All The Fields You Need =
Caldera Forms has tons of field types to make a great form that will help your website succeed for you. You can set field defaults using the power of Caldera Forms magic tags. Impress your site's visitors when you take advantage of field sync!

Caldera Forms field types include:

* Text
* Credit Card Number
* Credit Card Expiration
* Credit Card Secret Code
* Auto-complete
* URL
* Calculation
* Range Slider
* Star Rating
* Summary
* WYSIWYG - rich text editor
* Phone
* Text
* File Upload
* HTML
* Hidden
* Button
* Email
* Paragraph
* Toggle Switch
* Dropdown Select
* Checkbox
* Radio
* Date Picker
* Color Picker

All of these field types are included in the free version! We don't call basic field types like URL or hidden fancy and charge extra. We even throw in the fancy field types like calculation and and phone fields!

> "WordPress should have more plugins like this. Adding new forms, editing their settings and stuff is fun."
>
> - Ahmad Awais: Full Stack WordPress Developer

= Awesome Conditional Logic =
Caldera Forms provides a visual editor for conditional logic. Show only the fields you need to make your forms easy, and maximize conversions.

When creating a form, you want to make sure to only show and only require the necessary information. Forms with fields that are not always needed can be confusing. Conditional groups, applied to fields allow your forms to adapt to user input, as it is entered.

= Track, Edit and View Your Form Submissions =
Caldera Forms tracks all of your form submission data in the WordPress database. The entry viewer is fast, dynamic and responsive. You can choose to create sub-menu pages for viewing form submissions and chose which users roles are allowed to view those pages.

Entry editing is a core feature of Caldera Forms. When editing entries, click the "Edit Entry" button to edit your saved data. Display your form entries with the Front-End Entry Viewer!

== Installation ==

Upload the caldera-forms folder to /wp-content/plugins/
Activate the plugin through the 'Plugins' menu in WordPress
Navigate to 'Caldera Forms' in wp-admin.

Once you have created a form using the Caldera Forms form builder, insert it in a page or post via the Shortcode inserter button in the post editor or use

== Frequently Asked Questions ==

= Are My Caldera Forms Going to Display Properly on All Types of Devices? =

Yes. Caldera forms is responsive by design. With Caldera Forms' drag and drop layout editor, you can easily create multi-column layouts for desktop that will display properly on mobile devices thanks to our responsive bootstrap-driven design.

= Is Caldera Forms Protected Against Spam? =

Yes your forms are protected against spam submissions by default. We use a honeypot instead of a captcha because captchas are less effective than honeypots and captchas are bad for conversions. Â  You can also use our [Akismet](https://akismet.com/) processor for anti-spam, which is available when Akismet is active on your site. You can also use [Spam Shield](https://wordpress.org/plugins/wp-spamshield/). Â  On our own sites, we just use the default anti-spam and we find this to be over 99% effective.

= Can I Send One or More Emails With Each Form Submission? =

Yes, we have many options for sending emails on each submission of your form. Caldera Forms provides an email notification to your forms.

= How Can I Get Support for Caldera Forms? =

Â [Need help form the community?](https://chat.civicrm.org/civicrm/channels/caldera-forms).

= What Types Of Forms Can I Build With Caldera Forms? =

Caldera Forms in one of the most robust WordPress form builders currently available, and, in combination with some of our extensions, can allow you to create a wide variety of forms using our drag and drop form builder. Here are sometimes of forms you can create:

* Standard Contact Forms
* Fancy Contact Forms
* Custom Contact Forms
* Registration & Login Forms
* Dynamic Forms â€“ where fields can change based on the users answers
* Customer Application Forms
* Product Purchase Forms
* Support Ticket Forms
* Newsletter Sign-Up Forms
* Lead Capture Forms
* Interest rate calculation forms
* Various types of Calculators
* Feedback Survey Forms
* Credit Card Payment Form
* PayPal Payment Form
* Stripe Payment Form
* Authorize.net Payment Form
* Braintree Payment Form
* MailChimp Form
* AWeber Form
* Converktit Form
* Sell Memberships
* Sell Courses
* eCheck payment Forms

Once you finish creating your form using the Caldera Forms form builder system, the next step is to embed the forms into your WordPress website. Our shortcode system makes this process extremely quick and easy.

Steps To Add A Form Automatically

Step 1 : Go To A Page Or Post

Add or edit your website content by clicking on **Pages** or **Posts** in the WordPress left menu. Create a new page / post, or edit an existing page / post.

#### Step 2 : Inserting The Caldera Forms Shortcode

Insert a formâ€™s shortcode by clicking on the **Caldera Forms** icon in the WordPress text editor and then select a form from the list.

Under the **Options** section, you can choose to have your form display with a modal (pop-up) window and to do this, check the box beside **Set As Modal.**
Modal setting configuration has 3 options:

*   Open Modal Trigger Type â€“ This allows you to choose the element that triggers the Modal. Select either **Link** or **Button.**
*   Open Modal Text â€“ This is the text that appears in either the Link or Button.
*   Modal Width â€“ This allows you set the width of your Modal window.

Once you have selected a form and configure the options, click on **Insert Form.**

Steps To Add A Form Manually

Step 1 : Go To The Caldera Forms Admin Page

Starting from the WordPress Dashboard, you can navigate to the Caldera Forms Admin Page by hovering over the Caldera Forms icon and in the drop-down menu clicking on **Forms.**

#### Step 2 : Get The Form Shortcode

*   Option 1:

Copy the shortcode by hovering over 1 form from the list of built forms and clicking on **Get Shortcode.** The shortcode for the specific form displays in the Get Shortcode section you click on and you must copy the entire shortcode string.

*   Option 2 :

    You can navigate to the form settings tab by clicking on **Form Settings** in the top Caldera Forms menu bar and copying the entire shortcode string.

Step 4 : Go To A Page Or Post

Add or edit your website content by clicking on **Pages** or **Posts** in the WordPress left menu. Create a new page / post, or edit an existing page / post.

Step 5 : Inserting The Caldera Forms Shortcode

Insert a formâ€™s shortcode by **pasting the shortcode** in the WordPress text editor.



= How Do I Create A New Form From A Template For My WordPress Site ? =

If you are unfamiliar with building a form, using one of our pre-configured templates is a great way to learn our Caldera Forms as your form builder. Caldera Forms is an excellent way to quickly get a form up and running on your WordPress website.

Steps To Create A Form From A Template

Step 1 : Go To The Caldera Forms Admin Page

Starting from the WordPress Dashboard, you can navigate to the Caldera Forms Admin Page by hovering over the Caldera Forms icon and in the drop-down menu clicking on Forms.

Step 2 : Create A New Form

Create a new form by clicking on New Form in the top Caldera Forms menu bar. This launches the Create New Form pop-up window.

Step 3 : Select a Template And Enter Form Details

In the pop-up window, click on any of the form templates. Caldera Forms ships with many helpful templates. Many Caldera Forms extensions provide additional templates. Clicking on Change Template will allow you to choose either a different template or a blank form. Once you have selected a form, enter a Form Name, then click on Create Form. You are now in the Caldera Forms Layout Builder, and can start building your new form.

You can now go to the form builder to layout your form.

= What If I Want To Start From A Blank Form? =

If your project requires you to develop a specific form for your WordPress website, and youâ€™re comfortable with building forms, our blank template gives you a fresh canvas to create any type of form youâ€™d need.

Steps To Create A Blank Form

Step 1 : Go To The Caldera Forms Admin Page

Starting from the WordPress Dashboard, you can navigate to the Caldera Forms Admin Page by hovering over the Caldera Forms icon and in the drop-down menu clicking on Forms.

Step 2 : Create A New Form

Create a new form by clicking on New Form in the top Caldera Forms menu bar. This launches the Create New Form pop-up window.

Step 3 : Select Blank Form And Enter Form Details

In the pop-up window, click on Blank Form and enter a name in the Form Name field, then click on the Create Form button. You are now in the Caldera Forms Layout Builder, and can start building your new form.

You can now go to the form builder to layout your form.


= How Do I Export or Import A Caldera Form ? =

  Creating a JSON export of your form is an easy way to copy a form from one WordPress website to another. It is also a good way to backup a form. It also is a good way to use one form and the basis for a new form that you then edit using the Caldera Forms form builder.

  Steps To Export A JSON Form Backup File

  Step 1 : Go To The Caldera Forms Admin Page

  Starting from the WordPress Dashboard, you can navigate to the Caldera Forms Admin Page by hovering over the Caldera Forms icon and in the drop-down menu clicking on Forms.

  Step 2: Export The Form

  backup-jsonExport the form by hovering over 1 form from the list of built forms and clicking on Export. This launches the Export Form pop-up window. Download the JSON file by selecting Backup/Importable (JSON) from the Export Type drop-down menu. Start exporting by clicking on Export Form. You receive a prompt to Save the file to your local computer.

  Steps To Import A JSON Form Backup File

  Step 1 : Go To The Caldera Forms Admin Page

  Starting from the WordPress Dashboard, you can navigate to the Caldera Forms Admin Page by hovering over the Caldera Forms icon and in the drop-down menu clicking on Forms.

  Step 2 : Start The Import

  Importing a JSON Caldera Form fileImport the JSON file by clicking on Import in the top Caldera Forms menu bar. This launches the Import Form pop-up window where you enter a Form Name, then continue by clicking on Choose File. You receive a prompt to find and open the JSON file from your local computer. Start importing by clicking on Import Form.

  You can not go to the Caldera Forms form builder and edit the form.

  = How Do I Configure Caldera Forms Global Email Settings? =

  These Global Email Settings control how the form submissions are sent from your WordPress website to your email address. They affect the email notification and the auto-responder processor.

  Steps To Configure Global Email Settings

  Step 1 : Go To The Caldera Forms Admin Page

  Starting from the WordPress Dashboard, you can navigate to the Caldera Forms Admin Page by hovering over the Caldera Forms icon and in the drop-down menu clicking on Forms.

  Step 2 : Go To The Caldera Forms Email Settings Tab

  You can navigate to the Email Settings tab by clicking on Email Settings in the top Caldera Forms menu bar.

  Step 3 : Configure The Email Settings And Save The Form

  Email setting page displaying options and inputsEmail setting configuration has 2 settings:

  WordPress: By default Caldera Forms uses WordPress to send emails. This is often not reliable.
  SendGrid: SendGrid is a 3rd party service that when properly configured will deliver emails reliably.
  Creating a SendGrid key and more information on how and why to setup SendGrid documentation is here.
  Selected an Email Gateway and click on Save Email Settings.

  Configuring Caldera Forms Global General Settings

  Most of the time these settings should not change. They can be used to prevent loading of different CSS stylesheets in the front-end when your form is rendered. If you turn these settings off it is up to you to style the form in the front-end.

  Step 1 : Go To The Caldera Forms Admin Page

  Starting from the WordPress Dashboard, you can navigate to the Caldera Forms Admin Page by hovering over the Caldera Forms icon and in the drop-down menu clicking on Forms.

  Step 2 : Go To The Caldera Forms General Settings Tab

  You can navigate to the General Settings tab by clicking on General Settings in the top Caldera Forms menu bar. This launches the General Settings pop-up window.

  Step 3 : Configure The General Settings And Save The Form

  Configure general settings by clicking on the toggle switches to turn the setting ON or OFF.

  General setting configuration has 3 options:

  Alert Style: Turn this ON includes Bootstrap 3 styles on the frontend for form alert notices.

  Form Styles: Turn this ON includes Bootstrap 3 styles on the frontend for form fields and buttons.

  Grid Structure: Turn this ON includes Bootstrap 3 styles on the frontend for form grid layouts. Get more information by visiting the official Bootstrap website http://getbootstrap.com/css/.

  Exit the pop-up window by clicking on the X in the top right corner, then, click on Save Form.

   = How Do I Save And Preview A Form ? =
  The Caldera Forms form builder lets you layout your forms on a responsive grid. You can preview what you create in the form builder edit screen by using the preview button at the top of the form builer screen.

  Steps To Saving And Previewing A New Form

  Step 1 : Go To The Caldera Forms Admin Page

  Starting from the WordPress Dashboard, you can navigate to the Caldera Forms Admin Page by hovering over the Caldera Forms icon and in the drop-down menu clicking on Forms.

  Step 2 : Creating A New Form

  Create a new form by clicking on New Form in the top Caldera Forms menu bar.

  Step 3 : Saving The Form

  Save a form by clicking on Save Form in the top Caldera Forms menu bar. If successful, a pop-down notice appears and states â€œUpdated Successfullyâ€.

  Step 4 : Previewing The Form

  Preview a form by clicking on Preview Form in the top Caldera Forms menu bar. A new browser tab automatically opens while the current form displays on the page.

  Please note:

 *  Previewing a form is only available to the website administrator.
 *  Being in preview mode does not change form behavior. All emails will be sent, all processors will be processed.
 * We recommend that you do your final form testing on a published page using the formâ€™s shortcode while logged out.

= How Do I Configure Form Settings? =


Step 1 : Go To The Caldera Forms Admin Page And Create Or Edit A Form

Starting from the WordPress Dashboard, you can navigate to the Caldera Forms Admin Page by hovering over the Caldera Forms icon and in the drop-down menu clicking on **Forms.** Create a new form by clicking on **New Form** in the top Caldera Forms menu bar. Edit an existing form by hovering over 1 form from the list of built forms and clicking on **Edit.** You are now experiencing the Caldera Forms responsive drag and drop form builder.

Step 2 : Go To The Form Settings Tab

You can navigate to the Form Settings tab by clicking on **Form Settings** in the top Caldera Forms menu bar.

Step 3 : Configuring The Form Settings And Saving The Form

*   Form Name â€“ This gives your individual form a unique name.
*   Shortcode â€“ This is not an option you can change, however you need this shortcode to integrate the form into a page or post.
*   Form Description â€“ This gives your form a unique description.
*   State â€“ If checked, this deactivates the current form.
*   Capture Entries â€“ If enabled, form entries are saved. If disabled, no entries are saved.
*   Show Entry View Page? â€“ If enabled, this option creates a sub-menu item of the Caldera Forms menu and a page to show entries.
*   Hide Form â€“ If enabled, this option hides the form after successful submission.
*   Honeypot â€“ If enabled, this option places an invisible field in the form to trick spambots.
*   Success Message â€“ This sets the message displayed after a user submits a form.
*   Gravatar Field â€“ This sets the Gravatar when viewing an entry from a non-logged in user.
*   AJAX Submissions â€“ If enabled, this option ensures that the page does not reload after a user submits a form.
*   Custom Callback â€“ If enabled, this option adds a custom Javascript callback handler on submission.
*   Multiple Ajax Submissions â€“ If enabled, the form submits multiple times with out a new page load.

Finish entering all of your form settings and click on **Save Form.**

= How Do I Configure The Responsive Settings Of My Form? =

Step 1 : Go To The Caldera Forms Admin Page And Create Or Edit A Form

Starting from the WordPress Dashboard, you can navigate to the Caldera Forms Admin Page by hovering over the Caldera Forms icon and in the drop-down menu clicking on Forms. Create a new form by clicking on New Form in the top Caldera Forms menu bar. Edit an existing form by hovering over 1 form from the list of built forms and clicking on Edit. You have reached the Caldera Forms form builder page - enjoy!

Step 2 : Go To The Responsive Settings Tab

You can navigate to the Responsive Settings tab by clicking on Responsive in the Caldera Forms sub-menu bar.

Step 3 : Configure The Responsive Settings And Save The Form

The different screen width options are the specific â€œbreakpointsâ€ you can set your grid to collapse at. Collapsing a grid essentially means moving from a 2 column grid to a 1 column grid.
Once you select a screen size, click on Save Form.

= How Do I Set Up The Form Email Notification For My Contact Form ? =

Configuring Caldera Forms Email Notification Settings

These settings control who the form submissions send to as well as what information sends.

Step 1 : Go To The Caldera Forms Admin Page And Create Or Edit A Form
Starting from the WordPress Dashboard, you can navigate to the Caldera Forms Admin Page by hovering over the Caldera Forms icon and in the drop-down menu clicking on **Forms.** Create a new form by clicking on **New Form** in the top Caldera Forms menu bar. Edit an existing form by hovering over 1 form from the list of built forms and clicking on **Edit.** You are now in the Caldera Forms Layout Builder.

 Step 2 : Go To The Email Notification Settings Tab

You can navigate to the Email Notification tab by clicking on **Email** in the Caldera Forms sub-menu bar.

Step 3 : Configure The Settings And Save The Form

You can fill in the notification settings here.

Once you enter your settings, click on **Save Form.**

= Does Caldera Forms Have File Upload Fields? =
The Caldera Forms form builder has two types of file upload fields. Basic file fields let you add file uploads to your WordPress forms using the browser's native form file fields. Advanced File Upload Fields are fancier form fields that you can add with our form builder. These form fields have a btter user interface.

 The basic File Upload Field pptions in Caldera Forms let visitors to your WordPress site upload fields allow your users to add one or more files. Multiple uploads can be enabled with the â€œAllow Multipleâ€ option.

 These files become attachments in the WordPress media library, and can optionally be attached to emails sent with the Caldera Forms mailer. Attaching to emails is enabled with the â€œAttach To Mailerâ€ option.

 If your form allows public submissions, care should be used with what file types are allowed. Allowed extensions can be entered into the â€œAllowed Typesâ€ option field, as a comma separated list of allowed extensions. For example, â€œjpg,png,gifâ€ would limit to images of those types, while â€œpdfâ€ would only allow PDFs.

 Native file upload fields are impossible to add custom CSS to. Also, while they do handle multiple file uploads, their handling off multiple files is not graceful. With a regular file field that is set to accept multiple files, all files must be added using the same file upload window, which is not good.

 Caldera Forms file fields can only use the file types that are allowed by WordPress and your server configuration. For more information on how to modify which file types WordPress allows, [see this article](http://www.wpbeginner.com/wp-tutorials/how-to-add-additional-file-types-to-be-uploaded-in-wordpress/).

 These limitations can be avoided by switching to an Advanced File Upload Field.

 The advanced file upload field available in the Caldera Forms form builder is an alternative to our regular file field upload fields. Â WhileÂ the regularÂ file fields use the native HTML file uploader â€” the advanced file upload fields have a custom, and a better user interface. They also can be targeted with custom CSS.

 While regular file upload fields support multiple file uploads, we strongly recommend you use an advanced file field if you need multiple file uploads from the same field in your form.

 Advanced fields upload fields allow your users to add one or more files. Multiple uploads can be enabled with the â€œAllow Multipleâ€ option.

 These files become attachments in the WordPress media library, and can optionally be attached to emails sent with the Caldera Forms mailer. Attaching to emails is enabled with the â€œAttach To Mailerâ€ option.

= Does Caldera Forms Have Gravatar Fields? =
The Gravatar field displays a users universal avatar based on their input to an email field. This field type binds to an email address field and dynamically shows the Gravatar for the email address. You can add these fields to your form from the form builder interface with a simple drag and drop. These form fields provide a nice bit of "wow" to your WordPress form as they automatically display the user's gravatar when they enter an email in an email field that matches their Gravatar user name.

= Does Caldera Forms Have HTML Fields With Dynamic Fields ? =

Caldera Forms comes with an HMTL field type. This is not an input field but rather a content block for displaying HTML on the form. This is useful for adding instructions, creating breaks or simply making the form look a little better.

One of the nicest features about the HTML block is that it supports dynamic field binding. This allows you to use field references as %field_slug% in the HTML block. These references are then dynamically updated as the form is filled in.

This is a very cool feature of the Caldera Forms form builder. With this you can create a field that shows a preview of form submissions that is updated dynamically with values from one, some or all of the fields you have added to your form using the form builder.

= Does Caldera Forms Have Radio Button Fields? =
Yes, the Caldera Forms form builder has radio button fields and a variety of other types of select fields.

The radio field, like the Dropdown Select Field, allows for a user to select aÂ singleÂ option while seeing all options at once. The â€œinlineâ€ option in the field configuration can be used to make the options show in a horizontal, instead of a vertical list. Options are added to your WordPress form one option at a time, or many at a time using the bulk inserter. Bulk inserting opens a textarea. Each line is an option. Clicking insert options creates the list.

You can auto-populate field options with just a few clicks in our form builder. The built in sources are:

*   Post-Type : This willÂ create an option for every postÂ of the selected type
*   Taxonomy : This will create an option for every term of the selected type

The auto-populate can be extended using the `caldera_forms_render_get_field_type-checkbox` filter.

= Does Caldera Forms Have Calculation Fields ? =
Yep, and they are one fo the coolest features of our form builder. Caldera Forms calculation fields are mainly used for calculating and displaying total prices based on form input. Calculation fields have two modes: visualÂ and manual. The visual editor is a simple way to add, subtract, multiply and divide the values of fields or variables.

In manual mode, you can create complex formulas. In manual mode, you can use any valid [JavaScript arithmetic operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators). Field or variable values can be used via magic tags.

For security reasons, calculation fields are processed both in the browser and then again on the server during submission. The calculations are processedÂ in the browser so their results can be update live providing a great experience to your customers. The calculations are re-run during submission to prevent tampering.

For this reason, it is important that when using magic tags based on GET variablesÂ to not use them directly in the calculation. Instead, create a hidden field, set its value with the magic tag and then use that hidden field in the calculation.


* Notes On Manual Calculations

Manual calculations are use JavaScript math functions. You should not use Math. In front of your functions or you will create an error. For example, to multiply the value of a field with the slug field_1 by the value of a field with the slug field_2 raised to the second power, you would use `%field_1% * pow(%field_2%, 2 )`.

Also keep in mind that you should not end your formula with a semicolon. You also can not use any variables or call other types of functions.

= What Kind Of Cool Button Fields Does Caldera Forms Have ? =
The Caldera Forms form builder supports 5 button types for use in your WordPress forms.

TheÂ primary use for the Button field it to trigger the form submission. Buttons can also be used to move to the next, or previous page of a multi-page form.

A form intended for user submission requires a button of the type â€œsubmitâ€Â Without one, a form cannot be submitted.Â The button config panel is fairly simple, allowing you to set the name, slug, custom class (wrapper class), type and class (actual button class)

**Button Types**

A button can be set as a Submit, Button, Next Page, Previous Page & Reset.

*   Submit  - On click, will trigger the form to be submitted. If any required fields are not filled in, User will be prompted to fill them in.
*   Button - Used for more custom uses like javascriptÂ triggers.
*   Next Page - Triggers pagination to the next available page in a multi-page form.
*   Previous Page - Triggers pagination to the previous page in a multi-page form.
*   Reset - Resets the form to its load state. If returned to the form due to an invalid data, the reset will return it to this state, not an empty state.

Classes

A button config canÂ be given 2 custom classes:

*   Custom Class - ThisÂ class name is added to the div around the actual button element
*   Class - This class name is added to the actual button element

Since the form is based on [Bootstrap 3](http://getbootstrap.com/), built in [button classes](http://getbootstrap.com/css/#buttons) do apply (provided style includes are enabled)

CSS Tips For Buttons

Buttons in a Caldera Form default to carrying the class â€œbtnâ€ and all Caldera Forms are wrapped in an element with the class â€œcaldera-gridâ€. Therefore you can target all buttons in your form with â€œ.caldera-grid .btnâ€

[Here are some examples for changing Caldera Forms button - including submit button - color, width or centering the button](https://assets-cdn.github.com/assets/gist-embed-9ec60d02ee0eb30530c9c2d12055b82db581fbb13b64b807fd63df9cd276d21b.css)

Note that these examplesÂ will changeÂ all buttons in the form. If you want to target one button, you will need to switch to using the button ID.

= Does Caldera Forms Have A WYSIWYG / Rich Editor Field ? =

**Rich Editor WYSIWYG Fields are available in the form builder new feature in Caldera Forms 1.5.0.**
Caldera Forms offers Rich Editor fields that offer a What You See Is What You Get fields (WYSIWYG) experience. These fields allow those interacting with your WordPress form to easily craft HTML with out writing any code. But they can if they want.

These fields are excellent for creating or editing post content using the Caldera Custom Fields add-on to create a front-end editor.

These fields are powered by theÂ [Trumbowyg](https://alex-d.github.io/Trumbowyg/) JavaScript library.

Setting Up The Field

User Interface Options

Rich editor fields have the standard form field options of other forms fields in the Caldera Forms form builder. In addition they have these three fields:

*   **DefaultÂ **: This is a text area, for the default value of the field. It is magic tag enabled.
*   **Language CodeÂ **: By default, this fieldâ€™s interface is in English. You can enter a supported language code here to change the language.
    *   [Click here for documentation on creating your own translation](https://alex-d.github.io/Trumbowyg/documentation.html#add-localization).
    *   **Sanitization LevelÂ **:Â This sets the type of HTML tags that are allowed. Developers should [see this section](#developer-info) for more information.

### Language Codes

The following language codes are supported:

*   ar
*   ca
*   cs
*   da
*   de
*   el
*   es
*   es_ar
*   fa
*   fi
*   fr
*   he
*   hr
*   hu
*   id
*   it
*   ja
*   ko
*   my
*   ph
*   pl
*   pt
*   ro
*   rs
*   rs_latin
*   ru
*   sk
*   sv
*   tr
*   ua
*   vi
*   zh_cn
*   zh_tw

### Additional Information For Developers

Before saving to the database, the fieldâ€™s value is sanitized using [wp_kses](https://codex.wordpress.org/Function_Reference/wp_kses). TheÂ â€œpermissiveâ€ setting forÂ **Sanitization Level** will cause the â€œpostâ€ context to be used via [wp_kses_allowed_html](https://codex.wordpress.org/Function_Reference/wp_kses_allowed_html). The â€œrestrictiveâ€ option will caused the â€œdataâ€ context to be used. You can filter allowed tags using [theÂ wp_kses_allowed_html filter](https://codex.wordpress.org/Function_Reference/wp_kses_allowed_html).

TheÂ [Trumbowyg](https://alex-d.github.io/Trumbowyg/) JavaScript library is used for WYSIWYG fields created using the Caldera Forms form builder. The options passed toÂ [Trumbowyg](https://alex-d.github.io/Trumbowyg/)Â when instantiating it on the field can be modified using theÂ caldera_forms_wysiwyg_options filter.

= What Does The Error ' Submission rejected, token invalid ' Mean?
This happens because the validation token -- a WordPress nonce -- could not be verified. This happens mainly because a caching plugin or CDN, such as Cloudflare is in use and caches the pages for longer than the WordPress nonce life -- by default 12 hours.

To fix this issue, set a cache exclusion for the page with your form or set a cache life of less than 12 hours.

This could also be a sign of a more serious issue on your server, but is probably cache related.
