# ARForms - Exclusive WordPress Form Builder Plugin ( Version: 4.0 )

Created:20/01/2020

By: Repute Infosystems

Email: info@reputeinfosystems.com

Thank you for purchasing ARForms plugin. If you have any questions that are beyond the scope of this help file, please feel free to email us via the contact form here. Thank you so much!

## What is ARForms?

ARForms is a premium WordPress form builder plugin with inbuilt support of multiple Email Marketing Tools integration. It has support of 12 Email Marketing Tools which are AWeber, Mailchimp, GetResponse, iContact, Constant Contact, Madmimi, eBizAC, GVO, MailerLite, Hubspot, Convertkit, Sendinblue. ARForms is a complete bundle and a very user-friendly form builder to create any complex forms in just a few clicks without any advanced knowledge required. It supports all popular WordPress versions from 4.5 to the latest version of WordPress.

ARForms has a very powerful realtime editor with which you can build any complex form in few minutes. ARForms gives lots of styling options in an editor which allows you to create beautiful forms that will suit any theme design. The Real Beauty of ARForms is, you can find ARForms in your native language. YES! Whatever you have just read is a reality. ARForms is supporting inbuilt 12 languages like English, Arabic, French, German, Portuguese, Russian, Spanish, Japanese, Korean, Turkish, Chinese, Dutch languages by default.

## ARForms Key Features:

- Exclusive Form Builder plugin with multiple `Email Marketing Tools` support.
- `Multiple column layout` support. Now build your forms beautifully with up to 6 columns.
- A very unique and very rich `Form Styling Tool` with Google Font support.
- Multiple Form Steps facility to build `Survey style forms` and `Wizard style forms`
- Support for adding Beautiful `Prefix/Suffix` icons at fields
- `Flying Forms` and `Sticky Forms` to enhance your representation of forms
- Facility to load modal forms on page load
- Transparent Modal Forms facility to make your form even richer
- To avoid spamming, ARForms has `Inbuilt Captcha Mechanism`
- Dynamic field setting using `Conditional laws`. You can Hide, Show, Enable or Disable fields based on rules applied on the field.
- Ability to display `running total` based on the calculation on fields' value.
- Ajax-enabled forms to give a smooth experience to users.
- Ability to display any external images on the form with Image control.
- Awesome feature of Conditional redirect to URL after form submit.
- Provides facility to Send data to Custom URL
- `Fancy checkbox and radio buttons` with multiple color options.
- Fully Customizable `Email notifications` to users and admin.
- Form `Analytics`.
- `Responsive` forms.
- Ready form templates for free. e.g. Contact Us Form, Subscription Form, Job Application Form, Feedback Form, RSVP Form and many more.
- `Data Migration` is another very awesome feature of ARForms. You can `Import / Export` your Forms and Form Entries.
- `Visual Composer` supported
- No programming skills required.
- Dedicated support.

# ARForms - Exclusive WordPress Form Builder Plugin ( Version: 4.0 )

Created:20/01/2020

By: Repute Infosystems

Email: info@reputeinfosystems.com

Thank you for purchasing ARForms plugin. If you have any questions that are beyond the scope of this help file, please feel free to email via the contact form here. Thank you so much!

## What is ARForms?

ARForms is premium WordPress form builder plugin with inbuilt support of multiple Email Marketing Tools integration. It has support of 9 Email Marketing Tools which are AWeber, Mailchimp, GetResponse, iContact, Constant Contact, Madmimi, eBizAC, GVO, MailerLite, Hubspot, ConvertKit, Sendinblue. ARForms is complete bundle and a very user friendly form builder to create any complex forms in just few clicks without any advanced knowledge required. It supports all popular WordPress versions from 4.5 to latest version of WordPress.

ARForms has very powerful realtime editor with which you can build any complex form in few minutes. ARForms gives lots of styling options in editor which allows you to create beautiful forms which will suit with any theme design. The Real Beauty of ARForms is, you can find ARForms in your native language. YES! Whatever you have just read is reality. ARForms is supporting inbuilt 12 languages like English, Arabic, French, German, Portuguese, Russian, Spanish, Japanese, Korean, Turkish, Chinese, Dutch languages by default.

## ARForms Key Features:

- Exclusive Form Builder plugin with multiple `Email Marketing Tools` support.
- `Multiple column layout` support. Now build your forms beautifully with upto 6 columns.
- A very unique and very rich `Form Styling Tool` with Google Font support.
- Multiple Form Steps facility to build `Survey style forms` and `Wizard style forms`
- Support for adding Beautiful `Prefix/Suffix` icons at fields
- `Flying Forms` and `Sticky Forms` to enhance your representation of forms
- Facility to load modal forms on page load
- Transparent Modal Forms facility to make your form even richer
- To avoid spamming, ARForms has `Inbuilt Captcha Mechanism`
- Dynamic field setting using `Conditional laws`. You can Hide, Show, Enable or Disable fields based on rules applied on field.
- Ability to display `running total` based on calculation on fields' value.
- Ajax-enabled forms to give smooth experience to users.
- Ability to display any external images on the form with Image control.
- Awesome feature of Conditional redirect to URL after form submit.
- Provides facility to Send data to Custom URL
- `Fancy checkbox and radio buttons` with multiple color options.
- Fully Customizable `Email notifications` to users and admin.
- Form `Analytics`.
- `Responsive` forms.
- Ready form templates for free. e.g. Contact Us Form, Subscription Form, Job Application Form, Feedback Form, RSVP Form and many more.
- `Data Migration` is another very awesome feature of ARForms. You can `Import / Export` your Forms and Form Entries.
- `Visual Composer` supported
- No programming skills required.
- Dedicated support.

# Installation, Activation & Update

## Steps For Installation And Activation

You can install plugin either of these two methods.

### New install viaFTP

1. Download the plugin from `CodeCanyon`, and extract it. You should find a directory arforms.
2. In your WordPress installation, upload arforms to `wp-content/plugins/`
3. Activate the `ARForms` plugin through the `Plugins` menu from WordPress admin panel.

### New install via the WordPress Uploader

1. Download the plugin from `CodeCanyon`
2. Log in to your WordPress admin panel
3. Go to `Plugins` -> `Add New` -> `Upload`
4. Click on choose file and browse the download package from `CodeCanyon`. When the plugin uploads successfully, click on `Activate Plugin`.

After activating the plugin, you will be able to see ARForms menu in admin left menu.

After activating the plugin, you need to activate your license for support and enables automatic upgrades. A license key only be used for one installation of WordPress at a time.

Click on `General Settings` link to activate your license. You will see below section there on that page. To activate your license, you need to enter your Name, Email address and `purchase code`( `Unique code` obtained while purchased this product).

### Steps for Manual Update

1. Download the plugin from `CodeCanyon`, and extract it. You should find a directory arforms.
2. In your WordPress installation, replace existing arforms directory with latest downloaded arforms directory to `wp-content/plugins/` folder.
3. After replacing folder, Click on `ARForms` Menu from WordPress admin panel and plugin will be updated with latest changes.

# Sources & Credits

1. FontAwesome
2. Bootstrap
3. HighCharts
4. Materialize
5. DataTable
6. Aweber API
7. MailChimp API
8. Get Response API
9. Ebizac.com API
10. iContact API
11. Gvo API
12. Constant Contact API
13. MadMimi API
14. MailerLite API
15. HubSpot API
16. ConvertKit API
17. Sendinblue API
18. Google Fonts API
19. JSColor
20. PHPMailer API
21. Maxmind GeoIP
22. International Telephone Input

Please follow us on,

- Facebook
- Twitter

Thanks, ReputeInfosystems

# Changelog

## Version 4.0 (20 January 2020)

- Introducing new control: Repeater Field
- Added facility to save partially filled form data to the database
- Added new email marketers: Hubspot, Convertkit, and Sendinblue
- Added facility to disable built-in anti-spam feature
- Added facility to enable the multi-column form on widget forms
- Added options for button shadow
- Enable hidden field for conditional logic for 'set value of' action
- Added new option for popup form to hide/show popup form for logged in user
- Added facility to rename key for submitted fields while using 'Send data to redirected page/post using POST or GET method' option
- Added new option to send data only in an email without storing it to database
- Improved Form Editor
- Improved Section Field Control
- Improved add new form popup to install ARForms samples in one click
- Added new Font Awesome icons
- Improved Site-wide popup to display popup form once per browser session
- Improved Number field validation for different language keyboard
- Prevent form submission while file upload is in progress
- Fixed special characters issue with import/export
- Fixed spam detected message with WP-Rocket plugin
- Fixed signature field issue with model forms
- Fixed file upload drag & drop control issue with modal forms
- Fixed site-health loopback request fail error
- Other bug fixes

## Version 3.7.1 (05 April 2019)

- Minor bug fixes

## Version 3.7 (04 April 2019)

- Introduced new field - Credit Card
- Introduced Site-wide Popups
- Added facility to install readymade samples with just one click
- Added in-built support for Elementor page builder
- Updated MailChimp API to version 3
- Updated Aweber authorization method
- Added CC and BCC option for admin email notification
- Added new shortcode for input fields for display current logged in user details
- Added new argument in popup shortcode to pre-populate popup forms without passing value in URL
- Added facility to make fields read-only
- Added an option to round up running total
- Added facility to delete uploaded file from view entry modal
- Added widgets in WordPress dashboard for quick analytics and available add-ons of ARForms
- Improvement in conditional logic
- Other bug fixes

## Version 3.6.1 (06 March 2019)

- Minor bug fixes

## Version 3.6 (11 December 2018)

- Added compatibility with Gutenberg Editor
- Added support of country flag for the phone number field
- Improved spam filter captcha mechanism
- Updated PHPMailer Version
- Added new shortcode for email to display the page URL where the form is placed
- Fixed Elementor Plugin Conflict
- Improved conditional logic
- Other minor bug fixes

## Version 3.5.2 (03 October 2018)

- Minor bug fixes

## Version 3.5.1 (14 August 2018)

- Minor bug fixes

## Version 3.5 (03 July 2018)

- Introducing new field: Switch
- Added new font awesome icons
- Other minor bug fixes

## Version 3.4.3 (09 June 2018)

- Minor Bug Fixes

## Version 3.4.2 (30 May 2018)

- Minor Bug Fixes

## Version 3.4.1 (26 May 2018)

- Minor Bug Fixes

## Version 3.4 (22 May 2018)

- Introducing new Opt-in: MailerLite
- Added option to prevent storing visitor analytics data
- Added an option to add GDPR privacy policy guide-line
- Minor Bug Fixes

## Version 3.3.2 (07 May 2018)

- Minor Bug Fixes

## Version 3.3.1 (23 April 2018)

- Minor Bug Fixes

## Version 3.3 (16 April 2018)

- Added feature to change field type without losing the entry data.
- Added option to change the file upload path.
- Added facility to send form submission data along with redirect URL.
- Added facility to reset default checked radio button option from form editor.
- Added some ready-made clickable regular expression validation patterns at field options.
- Separate "Reply to Email" and "From Email" options at email notification.
- Added image control options to change image position, height and width at the mobile device.
- Added styling option for placeholder opacity.
- Other bug fixes

## Version 3.2 (21 March 2018)

- Added facility to display confirmation (summary) after form submission.
- Added option to load a form in Right to Left / Left to Right in RTL site.
- Added facility to export form in the form editor.
- Fixed CSS for prefix/suffix icons in fields in RTL.
- Other bug fixes

## Version 3.1 (10 March 2018)

- Added facility to upload multiple files
- Added facility to display confirmation summary before form submission
- Added facility to hide survey/wizard tabs from multi-steps form
- Added facility to allow maximum options for checkbox control
- Fixed an issue for Conditional Logic and Running Total on the same field
- Fixed an issue regarding field order in exported CSV
- Fixed Different Language issues due to the special characters
- Other minor bug fixes

## Version 3.0 (15 February 2018)

- Added new form creation styles: Material Style and Rounded Style
- Added new very powerful In-build captcha mechanism so you do not need to add ReCaptcha in form.
- Improved performance for Editor. Major improvement in form editor to load forms faster.
- Added new resizable facility with multicolumn. Now you will be able to adjust column size with mouse drag.
- Improved Conditional Logic.
- Improved Running Total.
- Added Two new fields: smiley and autocomplete
- Multi-column up to 6 column
- Added Conditional Redirect after form submission
- Added Conditional Email to User after form submission
- Introducing new Email marketer: Madmimi
- Improved performance of Front end form rendering.
- Query Optimization to reduce database interaction.
- Save partial form data from an abandoned form
- Post form data to custom URL
- Added facility to Prevent Duplicate entries
- Added facility to limit Form submission.
- Added PHP mailer support to send mail.
- Added new Email format support ( HTML or Plain text ).
- Added new Option to load JS or CSS in all pages.
- Added a new way to import form.
- Export form and entries in one file and import them as well.
- Given CSS based checkbox and radio in forms.
- Added new facility to set Custom icon for Checkbox and radio.
- Added new facility to set Image over checkbox and radio.
- Introducing new chart types for analytics ( line chart and country-wise chart ).
- Fix minor bug related to MailChimpList Field for First Name & Last Name merge.
- Other bug fixes
- CSS fixes

## Version 2.7.8 (19 January 2017)

- Fixed PHPMailer Vulnerability.
- Added new facility to select double opt-in OR single opt-in method for MailChimp Email Marketer.
- Added new facility to select 24/48 hours format for date picker field.
- Added new shortcode for the hidden field to set current date value dynamically.
- Added Confirmation for reset styling in the form editor.
- Minor bug fixes.

## Version 2.7.7 (26 October 2016)

- Added New Font Awesome Icons.
- Improved plugin loading performance.
- Minor bug fixes.
- CSS fixes.

## Version 2.7.6 (29 December 2015)

- Added New Google Fonts.
- Added New Font Awesome Icons.
- Added Facility to get value of Current User Id, User Name and User Email who submitted the form in the email notification.
- Added Authentication option for SMTP mail functionality.
- Added Maximum length option for textarea.
- Added facility to set the current date on the minimum and maximum range.
- Minor CSS Fix related to WordPress version 4.4.
- Other minor bug fixes.

## Version 2.7.5 (29 September 2015)

- Minor bug fixes.

## Version 2.7.4 (22 September 2015)

- Added new facility to send test mail with SMTP setting.
- Added auto-update facility. ( Will work from next version )
- Change adding subscriber methods according to new constant contact API changes.
- Added Bootstrap Date / Time picker.
- Added New Font Awesome Icons.
- Added new input masks for a Phone Number format.
- Improved Popup for responsivity.
- Added Extended Fonts support to google fonts ( Font Subset ).
- Implemented New Google Recaptcha Method.
- Other minor bug fixes.
- CSS Fixes.

## Version 2.7.3 (26 May 2015)

- Minor bug fixes.

## Version 2.7.2 (09 May 2015)

- Added support of change background color and text color of Fly and Sticky
- Added new setting to set success message duration. ( For how many seconds it should stay on a page after submitting a form )
- Added CSS fixes for WordPress latest version 4.2
- Other bug fixes.

## Version 2.7.1 (10 April 2015)

- Added support of AWeber's new fields in the webform method.
- Other Minor bug fixes.

## Version 2.7 (04 April 2015)

- Added prefix/suffix font awesome icons support
- Added Visual Composer support
- added New Add-On page for all add-on listing
- Improved ajax form saving in admin side with respect to max_input_vars
- Improved form submission from frontend with respect to jQuery conflict
- Improved Admin editor - more lightweight now
- Added New facility for confirm Email same as confirm password
- Given Server-side validation ( required field PHP side validation to prevent spam )
- Now the sticky menu is also available for left and right position
- Improved Import/Export functionality
- Given facility to customize admin email with some useful predefined shortcodes
- Added new 4 CSS cloud to place custom CSS for popup ( Link / Link - Hover / Button / Button - Hover )
- Better UI implementation for field options
- Give image upload facility for submit button hover
- Other minor bug fixes.

## Version 2.6.3 (15 December 2014)

- Added RESPONSIVE MODAL WINDOW facility
- Getresponse API is changed according to the new version.
- Give the facility to add transparent form background in normal forms ( without modal window ).
- Added "media" selector for select image source ( wp media uploader) for IMAGE FIELD
- Changed Tab Index for RTL
- Added min length for textbox, textarea, Number and password field
- Added facility to set a default value for Time Picker
- Other Minor bug fixes.

## Version 2.6.2 (31 October 2014)

- Added support of checkbox multiple values with Match Logic / Running Total.
- Added facility to add placeholder text for confirm password.
- Other Minor bug fixes.

## Version 2.6.1 (08 October 2014)

- Minor bug fixes.

## Version 2.6 (27 September 2014)

- Added Color Picker Control.
- Added Image Control.
- Added Running Total Facility.
- Added SMTP mail functionality.
- Upgraded the Bootstrap version.
- Added input mask in a phone number field.
- Added styling options for Survey "Progress Bar".
- Added support of WordPress 4.0 (CSS fixes).
- Added month/year changeable in date picker.
- Other minor bug fixes.

## Version 2.5.4 (11 August 2014)

- Added Conditional Logic on the submit button.
- Added New preset field choice for "Telephone Country Codes" for select box, checkbox and radio button options.
- Improved CSS concerning Responsive forms.
- Improved Password strength indicator validations.
- Other minor changes related to CSS classes and fonts.

## Version 2.5.3 (31 July 2014)

- Small bug fixes related to CSS styling.
- Improved JS/CSS loading speed while display form in front-end.
- Other minor changes related to CSS classes and fonts.

## Version 2.5.2 (19 July 2014)

- Small bug fixes related to editor width.
- Improved js / css loading speed while display form in front-end.
- Improved loading speed while a preview of form.
- Improved all popup forms' view. ( Popup Form / Fly Form / Sticky Form ) .

## Version 2.5.1 (12 July 2014)

- Small bug fixes related to display Form title and description.
- Small bug fixes related to import/export forms.

## Version 2.5 (10 July 2014)

- Complete new admin interface
- Added like and slider control
- Added Confirm Password facility
- Added facility to duplicate fields
- Added new option "Onload" for display form in modal while page load
- Added new template for the job application form
- Added new color picker
- Added new validation error message style ( normal / advanced )
- Added new preview style with 3 different resolution
- Improved RTL
- Improved form submission ( concerning max_input_vars)
- Added new phone number formats to validate the field
- Added New tooltip style
- Checkbox, radio, and select box options are now sortable
- IP Address column added in form entries
- Submit button text can change from field editor
- Form background Color + form background image both supported.

## Version 2.0.5 (28 April 2014)

- Added facility to change the subject of email sending out to the Administrator.
- Added facility to duplicate the fields.
- Added facility to change file upload text color.
- CSS fixes related to WordPress 3.9.
- Small bug fixes related to bootstrap error message classes.
- Small bug fixes related to conditional logic rules.

## Version 2.0.4 (11 March 2014)

- Small bug fixes related to file upload.
- Small bug fixes related to conditional logic rules.

## Version 2.0.3 (27 February 2014)

- Small bug fixes related to IE 8 And IE 9.
- Small bug fixes related to form styling.
- Small bug fixes related to Import / Export.
- Made compatible with the GeoIP PHP extension.

## Version 2.0.2 (15 February 2014)

- Small bug fixes related to Email Attachment.
- Small bug fixes related to Localization.
- Small bug fixes related to CSS in different browsers.

## Version 2.0.1 (07 February 2014)

- Added more options to property/styling at field level.
- Improved Site loading speed.
- Small bug fixes related to File upload in IE 8, IE 9, Star rating.
- Small bug fixes related to Import/Export (Forms / Entries).

## Version 2.0 (01 February 2014)

- Simple captcha
- Conditional laws
- Import/export
- Flying/sticky forms
- Change editor's look and feel
- Google fonts support.
- Form/field level CSS implementation (property styling).
- File upload control improvement.
- Code cleanup and reduced external JS/CSS usage.
- Loader image improvement.
- Better documentation.
- The email notification part improved.
- Few additional options on the styling tool.
- New fancy checkbox/radio buttons set.
- Bugfix: small bug fixes related to different theme compatibility.
- Bugfix: small bug fixes related to different theme compatibility.

## Version 1.2.2 (17 December 2013)

- Bugfix: small bug fixes related to different theme compatibility.
- Bugfix: WordPress version 3.8 compatibility issues fixed.

## Version 1.2.1 (13 December 2013)

- Bugfix: small CSS based bug fix for dropdown, file upload, and other general formats, etc.
- Bugfix: invalid file style upload message.
- Bugfix: CSS changes conflict with various themes.
- Bugfix: admin email message after form submission.
- Bugfix: WordPress version 3.8 compatibility issues fixed.

## Version 1.2 (6 December 2013)

- Bugfix: small CSS based bug fix for star rating, dropdown, and other general formats, etc.
- Bugfix: reCaptcha focus.
- Added option for place form with link/button for modal window
- Added support for dynamic modal height and width
- Added support for transparent modal window
- Added background image support for form
- Added option for adding transparent fields over the form

## Version 1.1.1 (28 November 2013)

- Bugfix: small css based bug fix for checkbox, dropdown, and other general formats, etc.
- Add default option for checkbox/radio button to inherit style from theme
- Add options in the shortcode

## Version 1.1 (27 November 2013)

- Multi-column support added.
- Multi steps wizard style form support.
- The star rating element is added.
- Multi-lingual support for the admin section.
- The new set of additional checkboxes and radio buttons.
- Optional email setup for admin notification.
- Better data about browser etc in form entries.
- Small bug fixes and text changes.

If you require any assistance with using this plugin or would like personal customization, you can email me at info@reputeinfosystems.com Or from the profile on CodeCanyon.

If you have the time, please follow me on,

- Facebook
- Twitter

Once again, thank you so much for purchasing this plugin. I will be glad to help you if you have any questions relating to my plugin. You will get 24 / 7 support at : Support

Thanks,
ReputeInfosystems

# ARForms Setup Wizard

## Steps to Create a form using ARForms

- Add New Form (using template or from scratch).

  First of all, you have to add new form in newly configured ARForm, here you will get options for templates also can build from scratch by adding the field to form.

- After Creating a form there are different ways of embedding form.

  To display a form at front-end, you just need to add a shortcode of that form into your page and this can be done simply by using Add ARForms button in Add New/Edit Pages.

  Further from this Modal Popup, you can choose how you want to display form in a page i.e. Form as Popup, open form on Page Load, Sticky Form and many more.

  1. Page.
  2. Post.
  3. Link.
  4. Button.
  5. Direct Navigation.
  6. Form in Widget
  7. Click here to get More Details
- Entries and Analytics. After the successful submission of a form, all data entered by the user will get saved, the submitted data for all forms can be viewed in the `Form Entries > Entries List` List tab. You can search List of entries Form-wise & Entry Date-wise

# ARForms Dashboard Widgets

There are two widgets available on the dashboard of ARForms.

- #### ARForms Add-Ons

  Here you can see all add-ons available for ARForms, on click any of them you can redirect to the add-on detail page.

- #### Recent ARForms Entries

  Here you have quick analytics available for your recent form entries in ARForms. Click on `View Complete Analytics` to redirect to the ARForms Form Entries Analytics page.

# Ways to display a form

ARForms gives an awesome ways to display forms on a page or a post, this different ways of displaying from has been achieved by displaying form in popup with various types of animations, buttons, position of button to open a form and much more.Lets see all these in details ,

1. Simple

   These display form in full page.

2. Link

   These shows a link on page or post with a caption we given in desc apart from these other arguments can be given.

3. Button

   These show a button with text which we gave in shortcode in desc argument or default text provide in it.

4. Navigation Menu

   This is an extraordinary feature provided by ARForms to display a form in navigation menu as a link.

   > To avail this feature your theme must support this.

5. Widget

   Using this feature you can put your form into a widget.

# Building a Form

## 1.Begin to Create a Form

To create a new form, just click on ‘Add New Form’. It will show a popup menu. This popup menu will allow you to add a different kind of form templates. Steps to add new form:

Now ARForms Provide three methods to create a new form.

- Blank Form
- Template
- Sample Form

#### 1. Blank Form

Steps to create a new blank form.

1. Select Blank form
2. Enter Form name
3. Select Theme
4. Click on Continue button

If you want to create form from scratch according to your requirement then select ‘Blank Form’.

#### 2. Template

Steps to create a new Template form.

1. Select Templates
2. Enter Form name
3. Select Theme
4. Select any one Template
5. Click on Continue button

ARForms provides 11 readymade templates by which you can build your form. The list is given below:

- Contact Us Form
- Feedback Form
- Registration Form
- RSVP Form
- Subscription Form
- Survey Form
- Job Application Form
- Donation Form
- Request a Quote Form
- Member Login Form
- Order Form

#### 3. Sample Form

ARForms provides lots of Readymade sample forms that you can browse and install directly on your site.

Steps to create a new Sample form.

1. Select Sample Forms
2. Select any one Sample
3. Click on Continue button

Please note that sample forms will be installed directly only if ARForms license is activated and valid on your site

Now you can drag-and-drop any of control on to your canvas as per your need and SAVE it. Now your form is ready to use.

#### Input Direction (Available only for RTL Site):

This option is available if your site is RTL. Here you have options to select either Left to Right or Right to Left which helps you to change all required direction in once instead to change the individual option from styling options like Label Align, Text Direction, etc.

## 2.Form Editor

In ARForms, form builder allows you to edit your form according to your requirement. You can arrange a field order as per your design. Apart from this, it provides basic elements and advanced elements to create any kind of simple as well as complex form. You can add an element as per your needs. To add an element you have to just drag-and-drop it or you can just simply click on it. With ARForms, you can create multi-column forms with resizing facility. You can resize to any field according to your needs and design any complex form in minutes!
Further to all these, all form you made in ARForms are by default responsive you never have to bother about the responsiveness of your form. In the preview, we provide an option for Mobile & Tablet view so you can switch on it to see how your form will appear in it.

ARForms provide two types of fields to create a form,

- Input FieldsNew
- Other FieldsNew

After adding a field, you can set up a particular field property according to your needs. There are the following options for the field:

- Move Field – you can change the order of fields in the form, by dragging field with this icon.
- Required Field - By clicking this option, you can make field mandatory or non-mandatory
- Settings - by clicking this option, you can get a list of property settings related to the selected field.
- Duplicate Field - by clicking this option, you can create a clone of a particular field.
- Delete Field – by clicking this option, you can delete the particular field from the form.

## 3. Save your time by just Duplicate the existing form.

Duplication of any form can be achieved by just a single click on Duplicate Form icon in `ARForms > Manage Form`.

On duplicating any form you will get the same form open in your editor and you can alter fields or field options or form style options and can easily get a new form. This functionality gives you form re-usability which saves your precise time by inheriting Form and its style options, fields, field options, etc of already created form.

# Input Field Types

There are numbers of input field types provided by ARForms to make its form a superior and fully functioned in its class of other Form Builders as well as many Advance Element has also been provided by ARForms.

Let's have a look various Input Field Types:

1. Single Line Input

   Single Line Text fields are the most commonly used field type. The Single Line Text field allows users to submit a single line of text. They are typically used to insert a small amount of text, such as a First Name, Last Name, city, etc.

   Here you can see the Prefix / Suffix Icon option which allows you to an icon into your field which makes form appearance more attractive and leads to Iconic Form.

2. Multi Line Input.

   Multi-Line Input fields are used to insert multiple lines of text, such as a description or address. The Multiline Input allows a user to enter text in a textarea form field and for more options regarding Multi-Line Input, you can set it from Field Option popup.

3. Checkboxes.

   Checkbox button is also another most commonly used field, it's used where we want to allow the user to choose multiple options from a list of options. some predefined list of options is given over here and a user can also add more manually or by. CSV file and use for future use.
   You are also able to allow your user to check the limited number of options and show a message to a user when he/she checks options more then you have allowed. For that, you need to set Max Option Selected and enter Max Option Selected Message at field options for the checkbox.

   As we all know the use of checkbox but here ARForms extend its UI from simple checkbox to Image Over Checkbox, users can also add different images as well as maintain their values separating.

4. Radio Buttons.

   A Radio button is also another most commonly used field, it's used where we want to give only one choice to select from list options. some predefined list of options is given over here and a user can also add more manually or by. CSV file and use for future use Like, Checkbox Radio button of ARForms also provides the facility of Image over a radio. If you have checked the default radio button option and you may no need of that then click on reset icon at Edit options popup.

5. Drop Down.

   The dropdown field gives a combo box with lists of options from which the user can select anyone. User Manage Option to add more option to list. Some predefined list of options is given over here and a user can also add more manually or by. CSV file and use for future use.

6. File Upload.

   File Upload is used to give upload field control to user ie. if we want some file from the user / we want to get some documents then this control is used.

   To manage the file upload button various field option are provided like Allowed File type, Attach the file in emails, dragging a file, enable multiple file upload.
   Enable Multiple File Upload
   Allow users to upload multiple files by enabling this option from file upload field options. Multiple File upload allows to select or Drop (if Enable Droppable Area) multiple files in a single time.

7. Email Address.

   This field is mainly used when a user has to enter email, with ARForms you can add icons to field and also Confirm Email is also managed automatically you don't have to manage field separately for it, you just have to switch on confirm email from field options.

8. Number.

   The number field allows a user to enter only numbers rather than entering any alphabetic values. The number field in ARForms allows number rang which can be managed by field-option of a number field.

9. Phone Number.

   Phone Number field allows a user to enter only numbers, restricting entering any alphabetic values. Phone field provides various number formats like 111-123-4567, (111) 123-456 and many more formats are provided inside Phone Number Field Option.
   ARForms also allows enabling country flag where you can handle to include/exclude country codes in phone number field by just check/uncheck countries. If this option is enabled you will have another option to enable Country-wise number validation to validate entered phone number country wise.

10. Date.

    Date field provides a calendar interface to the user to select a particular date. Here you can manage Off days, calendar localization (a kind of different calendar format depending on languages), date range so a user can't select any other date beyond that and much other functionality to the calendar from field option of date.

11. Time.

    Like date field time field allows the user to select a particular time as input directly from a time picker. Here you can select the 24-hour or 12-hour format, icons for field and other settings from field option.

12. Website /URL.

    This field is used to enter URL of user website /other websites, this field validates website URL enter by a user and like other fields, this field also has various field options to manage the field.

13. Image URL.

    Unlike Website URL, Image URL is used by a user when he doesn't want to upload an image just want directly load from other URL here also you can field option manage Image URL field.

14. Password.

    Password field is used when you want some credentials to be entered by users these may be a user's password. ARForms facilitate with Confirm Password option in field option of password field so you don't require to manage to confirm password field separately, apart from this there will be many more options to manage the password field.

15. Star Rating.

    Star Rating is an exclusive field provided by ARForms which represents stars as an input, the user has to select start on focus/hover the color of starts get changes which represent user input. This field is used in many cases like Feedback in several stars.

    You can manage start field's number of stars to be appeared on the front end, size of star and color of stars.

16. Like Button.

    ARForms provides a kind of field whose value is either true or false, ie. Like or Dislike. This field can be used to get input from a user in like or dislike. Here you can change the label of Like/ Dislike and color of either.

17. Slider.

    The slider field allows users to enter input by sliding a handle along with the slider. You can also make this slider as range slider where you will observe that user gets two handles on a slider to select a range of value.

    Other options are available to manage this field inside the field option as mention in the image.

18. Color Picker.

    Color Pickers allows a user to select unlimited colors from a color palette, ARForms provide two types of color palettes Basic and Advance. The basic color palette has limited color selection options. It has a predefined list of colors, while the Advance color palette allows a user to select an unlimited color option.

19. Smiley.

    Smiley field provides the user an emojis interface which on selecting return data as mention in field-option. Smiley field is an exclusive feature of ARForms more over predefined Smiley you can add images or icons as smiley to extend this exciting feature.

20. Autocomplete.

    Autocomplete field gives users form filling experience much higher as it gives lists of suggestions on typing data in a field, this list of suggestions gets from the list you manage in Autocomplete field option.

    A list of options of Autocomplete can be uploaded by. CSV field or even can write manually.

21. Switch.

    The Switch field is mostly used to get binary value from users. ARForms Provide switch field with different options like, set label name, set right label and value, set left label and value, etc.

22. Credit Card.

    You may require to get payment on submitting the form for which you need to add fields like `Cardholder Name, Card Number, Expiration Month, Expiration Year, CVC` and change fields options and settings.
    ARForms provides the Credit Card field to reduce your lots of work in just one click. When you add the Credit Card field in your form it will add 5 individual fields with pre-defined settings which can be managed separately.

### [arf_current_user_detail field="USER_META_KEY"]

Place this shortcode in any fields like single-line text, multi-line text, Email, Number, etc.. which will be replaced by the value of entered user meta key of currently logged in user in front-end, if a user is not logged in or meta key is not available then it will be replaced with a blank.

`USER_META_KEY` - Enter user meta key here like user_login, user_email.

##### For Example

    [arf_current_user_detail field="user_email"]

    will return user's email address like,

    user@mail.com

# Other Field Types

There are numbers of other field types provided by ARForms to make its form a superior and fully functioned in its class of other Form Builders as well as many Advance Element has also been provided by ARForms.

This fields help to create a more dynamic form and fully function. Let's have a look on various Field Types:

1. HTML.

   HTML field allows to add any HTML content in your form ie. you can use HTML tags to make form's UI more pleasing. eg to add <marquee> or <table> ,etc you can use HTML field.

   Apart from HTML tags, this field also gives the functionality of running total (Math Logic) for more details on Running Total click here. If you use running total in this field then a sigma symbol will start appearing.

2. Section.

   Section field enables you to make a list of fields inside on the section to manage all that field together and also apply many operations on this group of the field.

   A section creates when you put section field now you can Drag and Drop field inside section which you want in the same section. For more options, you can refer to the section field option.

   Using Conditional Logic you can show/hide all element under one condition and also you can add a background color to the full section.

   Using Field Options you can change section title and hide section title in frontend.

3. Page Break.

   Page break provides multipart form functionality ie.making form in multi-pages and each page has the next button which shows the next part of form. The multipart form can be managed easily just by adding Page Break field in between fields all fields above and below Page Break will show in separate pages. You can also conditionally show/hide this field by Conditional Logic then the whole page will be shown/hide using this functionality.
   You may need to hide survey bar(progress bar) or top bar(for wizard style) in your multipart form which can be done by hiding Survey Bar / Tab Belt field option at page break field options popup.
   Another option is available here is Multistep Position where you can change the position of survey bar/tab belt to Top position or Bottom position in your form.

4. Image.

   Images control allows you to add attractive images on your forms, to make User-Interface of your form more delightful. This field has the option to place the image at any part of the form, just by dragging or by entering the X-axis or Y-axis points of the form where you want an image, there are another options for image position, height, and width if you need to change at a mobile device.

5. Repeater.New
   Repeater field is use to repeat the field(s) inside it. ARForms provide the Repeater field which helps users to add dynamic field(s) from front-end. more details

# Multicolumn & Resizable

## Multi Column

ARForms provide excellent functionality to arrange the field in multiple columns. You have options to select several columns you want in a row. You can arrange fields up to six columns. By default field is arranged in one column, you have to arrange it into required columns.
Illustration of Multi Columns,
1. One Column: by default, all elements are arranged in one column.
2. Two Column: while clicking on a two-column icon, as shown below the row will divide into two equal columns.

3. Three Column: Similarly as two-column we can also generate three equal columns by clicking in three column's icon as shown below.

4. Four, Five and Six columns: Similarly we can get up to six columns in a row by clicking respective icons.

## Resizable Column

Apart from multi-column, ARForms also provides resizing of each column with appealing to the sense UI, here you must aware that resizing of each column can be limit to some maximum and minimum limit up to which any field can be minimized to 15% of its column.

Using resizable, each field can resize up to the required size and arrangement can be achieved as desired. Like you can see below, from which has been arranged as per the requirement of the size of each field, which makes forms design more pleasing.

# Running Total ( Match Logic )

## Creating a Running Total / Math Logic

Running Total in ARForms provides math logic or in simple language, you can say that when we need calculation of two or more field then this can be achieved by using Running Total. Running Total is performed in the HTML field inside field-options, steps to perform Running Total are as shown below.

When you want to add formulas for math logic, you need to check this checkbox (Enable Running Total). When you will check this checkbox, it will automatically add a pair of tag <arftotal></arftotal> (Opening and closing tag). You will be able to see a sample formula as displayed. Here, you will be able to see 'Add Field' dropdown from where you can add form fields for calculation and list of an operand to do a calculation. Even there is a facility to check formula whether it is valid or not just by clicking on Validate Formula.
Sigma IconAfter adding required running total you will find that a sigma icon will be enabled in the HTML field, this "Sigma Icon" specifies that the HTML field has "Running Total Enabled".

## Displaying the Calculation in Your Form

Displaying a calculation in your form is very easy, with ARForms, it will be displayed where you have added an HTML field in which you wrote whole formula or math logic and you can add prefix as per your need before <arftotal></arftotal> tags.let's illustrate a case in which we add running total to field

## Enable Running Total:

When you want to add formulas for math logic, you have to check to enable Running Total checkbox. When you check this checkbox, it will automatically add a pair of `<arftotal>``</arftotal>` tag. ( Opening and closing tag. ) where your cursor is pointing.

After checked the Enable Running Total, Please confirm that your cursor is pointing between the `<arftotal>` tag. You need to add a formula between opening and closing tags.

After enabling the running total, you will get form fields to add in the formula along with math operators for calculation.

#### Add Field:

This is the list of all fields which you have already added in the editor for your form. Select any field which you want to use for calculation. By selecting a field, it will be added to your formula which you can see in the HTML content area. Here some inputs will not be included such as Range slider, Page Break, Captcha.

#### Math Operators:

`{ + } Sign:`

It will perform addition operation between fields(operands). Just simply click on the button and it will be added to your formula where your cursor is pointing.

`{ - }Sign:`

It will perform subtraction operation between fields(operands). Just simply click on the button and it will be added to your formula where your cursor is pointing.

`{ * } Sign:`

It will perform multiplication operation between fields(operands). Just simply click on the button and it will be added to your formula where your cursor is pointing.

`{ / } Sign:`

It will perform division operation between fields(operands). Just simply click on the button and it will be added to your formula where your cursor is pointing.

`{ ( ) } Brackets:`

Starting and closing bracket used to differentiates and give high priority to particular operation between formulas.

##### example

    ([Product:123]*[Qty:125]) + 5

#### Validate Formula:

After adding the required fields and operators to the formula, you may want to check that this formula is valid or not. So, this button will check whether your formula is valid or not. If your formula contains any incorrect expression, then it will show you an error message.

## Round-Up Total

Enable this option if you want to round up the total value of the calculation.
For example, if the total is 12.49 then it will round up with 12 and if the total is 12.50 then it will round up with 13.

## Running Total with Payment Addon

Running Total widely used to add the final amount (the result of running total) as a Price in Payment Addon, ie. maybe product of amount and quantity or simply sum of two fields much can be explained by illustrating an example. let's consider the above-illustrated form and sum of two field 'price' & 'charges' as the final amount to be paid by the user.

# Repeater (Add More)

## Creating a Repeater / Add More Field

Repeater in ARForms provides the facility to add Dynamic Field(s) from front-end, it means a user can enter multiple data for the same field. You can drag other fields inside repeater which you want repeatable with all its individual options.

Repeater field provides an option to set the maximum repeatable limit for front-end users.

Repeater field in front-end provides the `'+'` button for users to repeat fields and `'-'` button to remove the repeated field.

Repeater field not supported the following fields

- File Upload
- Password
- HTML
- Section
- Page Break
- Credit Card
- Signature
- Download
- Captcha

Repeater Field entries display same as other fields in the Form Entries page, after clicking View Data you can show all entries of fields that are inside the repeater field.

# Conditional Logic

ARForms allow you to set a condition on the field. Using conditional logic, you can show or hide fields, page, section or can disable/enable fields or even can set values of the particular field.

ARForms Conditional Logic facilitates,

- Multiple Conditions.
- Multiple Results.

Which allow a user to add a Combination of condition to perform any operation on any one field and vice-versa. We can set Conditional Logic to apply the following operation on fields, we have added new operation than our previous version

- Show Field.
- Hide Field.
- Enable Field.New
- Disable Field.New
- Set Value of Field.New

You can put conditional logic on any field, but for that, you need at least one field for conditional logic. Even you can apply conditional logic to a section as well as on Page Break. Unlike our previous version, Now Conditional Logic has been upgraded to Form-wise rather than that of Field-wise, So users can easily manage Conditional Logic of many fields and it is also very easy to maintain & modify it.

- Show/Hide: There is a drop-down for show or hide the field, select one of them which you want to apply on the field.
  Show: On selection of this option, the target field will be displayed on specific conditions is fulfilled.
  Hide: On the selection of this option, the targeted field will hide in the specified condition is fulfilled.
- Enable/ Disable :
  Enable: On selection of this option, the targeted field will be disabled false, if the field is disabled then it will be enabled.
  Disable: On selection of this option, the target field will be disabled true, the field will be disabled.
- Set Value of: On selection of this option, the target field will be populated with the value which has been set by the user. Now you can Set Value of hidden field for conditional logic.
- All/Any: There is another dropdown to handle the behavior of condition when more than one condition applied to a single field.
  All- When you have applied more than one condition on the target field. And you want that each condition should be fulfilled, at that time this option is used.
  Any - When you have applied more than one condition on the target field. And you want that any of the conditions should be fulfilled, at that time this option is used.
- Condition Field:
  Field- This dropdown box allows you to map your field for the condition.
  Operator - This field will determine that value is evaluated as true or false. You can set operator like equals to, not equals to, greater than, less than, contains, not contains.
  Value - This field will accept the value of the above conditional field. This value will be checked for condition.

### Conditional Logic on Multi-part Form & Section of Form

ARForms exclusively provides Conditional Logic to Show or Hide 'Multi-part ' form or even a 'Section' of a form. These features help in providing instant section/Multipage of form to user on the checkbox, radio, single line text, etc.
Conditional Logic on Section: All fields inside a section of the form will get affected by Conditional Action defined to section.

Conditional Logic on Multipart: here full page of form can be shown/hide by using conditional logic on the 'Pagebreak' field.

# Multi-Parts / Multi Pages Form

### Page Break with ARForms

Page Break or Multipart form is another important functionality provided by any page builder plugins. ARForms allows you to create a multi-step form by a very easy method, just by adding Page Break element inside form editor just after field where you want to end that part of the form.

Here you can set conditional logic on this field when you want to hide or show the next step on user's selection. When you applied conditional logic on the page break, it will apply to all fields within that page. For a multi-step form, there are two ways to represent it, that is by Wizard form and by Survey form.
Wizard Form: When a form is lengthy, at that time it would be unwieldy to submit the form from a single page. So at that time use wizard form, in which the first form asks important detail, the second one asks less important detail, etc.

Survey Form: By selecting this option, steps are displayed as a progress bar in a multi-step form. You can see the following form.

Survey bar / Wizard tabs can be moved to the bottom position in your Wizard form / Survey form as you can see in the following form.

# Email Notification

### Email Setting Globally

To send Emails to users and admin firstly we have to configure Email Setting globally.
ARForms allows you to set Email Configuration globally for Auto-Response Email. You can set the default setting for email. Even you will be able to choose the server which you want to use to send the email. If you want to set different Email settings for each form then you can manage it also from 'Email Settings' inside the Form 'General Settings' tab.

ARForms Provides various email sending mechanism like SMTP Mail, WordPress Server or PHP Mailer. Also, many other setting is provided to configure email globally. For more details visit document `Global Settings > Email Configuration`.

### Email Notification( Form Level Configuration )

If you want to send an automatic response email to the user as well as administrator after submitting the form, you have to configure option separately for user and admin. ARForms allows you to customize email content for both user and admin. Here you can fully customize email content, you can add a form field data by selecting the particular field. You have to set the receiver email id, a subject of an email, and message content. You can configure the sender email id, name and also add form field content with the message, email id, and subject. ARForms also provides shortcodes, which you can use anywhere in the message content.
1. Configuring User Email Notification. In Email Notification popup, by checking to Send an Automatic Response to users after submitting form checkbox user will get a notification after successful form submission.

Conditional User Email Notification Sending email notification to a user can be specified Conditionally ie. to send an Automatic Response only if some condition gets fulfilled like if the email field does not equal to blank the send email.

2. Configuring Admin Email Notification. In Email Notification popup, by checking to Send an Automatic Response to admin after submitting form checkbox Administrator will get a notification after successful form submission. Default admin Email Address automatically retrieves from its profile and From/Reply to Email will be as defined in global settings. ARForms also provides `CC` and `BCC` Email at Admin Email Notification.

# Form Submit Action

### Submit Action

ARForms provides various action just after submitting a form which helps the user to manage the submission process adequately. The immediate action that can be taken after Form Submission like Displaying Message, Redirect to URL or Conditional Operation on Submit Button.

Various actions that can be managed by Submit Action popup are mentioned below.

- Display Message.
- Redirect URL.
- Display content from another page.
- Set Conditional Submit Button.
- Hide form after successfully submitted.
- Send Form Data internally to Custom URL (Webhook).
- Show confirmation (Summary).

Display Message: You can customize the message which gets displayed on successful Form Submission.

Redirect URL: ARForms provide redirection to another URL after successful Form Submission, ARForms exclusively provide Conditional Redirection that is, on the particular condition you can set the redirect to a specific URL either you can Set Static Redirection.
ARForms provides a facility to send form submission data along with redirect URL using the GET or POST method.
ARForms also provide the Facility to change Field name for submitted data, by default it set item_meta_{field_id}.New

Display content from another page: After successful Form Submission you can get data from any other pages of that site to Current Page. Please note, that only static content of that page can be displayed regardless of another Form of ARForms or any other dynamic content of other plugins.

Set Conditional Submit Button: ARForms exclusively provides Conditional Logic upon Form Submission to Enable/Disable Submit button. You can set a condition on Form Field with various operators to match your needs before form gets submit if the condition doesn't match then submit button get Disable /Enable.
Disable/Enable - On selection of this option, submit button will be disabled or Enable vice-versa
All/Any - When you have applied more than one condition on the submit button and you want that each or any of the conditions should be fulfilled, at that time this option is used.

##### Example

    Lets set a condition that, if First Name & Last Name equal to blank then the submit button will remain disabled, this condition has been illustrated below showing the front-end submit button & condition setup in the back-end.

Hide form after successfully submitted After success form submission if you want to hide the form from that page you just need to check this checkbox residing inside `Other Options`

This feature is usable in one or many ways if you want to add/show some content to a user after submission of the form the whole form acquired many spaces of the page unnecessarily even after no use as it was submitted. So you can hide it after submission and have a full page to utilize to put.
Send Form Data internally to Custom URL (Webhook) ARForms provides another useful facility to post your form data at a custom URL after successful form submission. In another words, you can also say Post form data to custom URL.
This option will let you enter the custom URL where you need to post form data after successful form submission. Here form data will be submitted to entered submitted URL with the POST method

Retrieve post data at custom URL -

At your custom URL, each field values can be retrieved by `Field ID`. After saving the form, you will be able to get field id at edit field options popup header at form editor as shown below.

Show confirmation (Summary): ARForms provide another awesome feature which is very useful for your users to confirm their entered data before submit in your site or to display all submitted data after form submission successfully. For more detail regarding enable this action in your form click here.

# Form Other Options

We provide other important and useful features that can be achieved in ARForms by selecting `Add/edit Form > Other Options`. Here is described other options.

## General Options

Various useful options that can be managed by General Options popup are mentioned below.

Autosave form progress: Autosave form progress provides a facility to save form progress until the form is not submitted, save data typed by the user on their machine, so they can come back to the form later on, and will be able to continue the from. For More details click here.
Save partial form data: This option will store the partially filled form data to the database. You can track the partially filled the data from ARForms > Form Entries > Partially Filled Form entries sectionNew
Prevent Duplicate Form Entries: We can prevent duplicate entries of any field of a form, ie. we can make any field unique moreover ARForms also facilitate with the built-in option of preventing duplication of IP Address and Current Logged In User. For More details click here.
Restrict Submission of a Form: These help in Restrict Form Entries using restriction methods provided by ARForms through which the user will be unable to see a form by showing a relevant message as mentioned by admin. There are various kinds of restrictions for form submission namely After Maximum Entries, Before and After Specified Date and between two dates. For more details click here
Prevent Storing Visitor Analytics Data: By default, ARForms will store visitor personal data like ip_address, country, etc for the purpose of visitor analytics. This option will prevent storing these data into the database. This will useful for European countries to prevent storing visitor personal data without informing them.
Don't store entry in database: After enabling this option, form entries data will not be stored in the database. If email notification is enabled then data will be sent through email. For more details click here

## Hidden Input Fields

ARForms let you add a number of hidden fields in the form which are similar to single line text fields but do not show in the form and value is not entered from the front-end side.

Here you have the shortcodes listed which can be used to place in hidden field value which will be replaced by respective values in front-end.

[ARF_current_user_id]

Place this shortcode in hidden field value which will be replaced by user id of currently logged in user in front-end.

[ARF_current_user_name]

Place this shortcode in hidden field value which will be replaced by user name of currently logged in the user in front-end.

[ARF_current_user_email]

Place this shortcode in hidden field value which will be replaced by user email of currently logged in the user in front-end.

[ARF_current_date]

Place this shortcode in hidden field value which will be replaced by current date in front-end.

## Submit Tracking Script

ARForms provides another useful feature to execute form submission tracking script from Submit Tracking Script popup ie. you can add google tracking code here.

Here is the multi line text input between a pair of tag `<script type="text/javascript"></script>` (Opening and closing tag) where you can add your form submission tracking script.

Please note, that it does not insert script tag (<script>) inside code.

## Export Form

To export form structure is so easy now. Go to `Add/Edit Form > Other Options` and click on Export Form you will get a Text File (.txt). This exported .txt file can be saved for future use.

Please don't change the name of Exported .txt file, else you will be unable to import these files.

# Convert Field Type

ARForms provides a facility to change field type for existing fields in the form. This can be helpful if you have a big amount of entries in a particular form and you want to change the particular field type without losing the entry data for that field.

Go to `Add/Edit Form > Other Options` and click on Convert Field Type you will get a popup where you need to select the current field that exists in the form and field type to convert.

Note: Field type you are converting to may have different field options so please check and do needful after changing the field type. Also, you need to verify all settings like email notification, conditional rule, payment gateways configuration, and other add-ons configuration after changing the field type.

This option will be available after saving form successfully.

# Form Styling Options

We provide a wide variety of customization of a form So, users can achieve the style & design which they had illustrated in there mind.

## 1.Form Level Styling

The ARForms exclusively provides three different form input styles namely Material Style Form, Rounded Style Form, and Standard Style Form. The pre-defined color scheme with which the whole form gets a unique manually selected color to forms different elements like input border, submit button, radio, checkbox, etc. Font Option, allows you to choose font family from predefined as well as Google fonts. You can also change Font Size and different Font Style too.

Apart from these Advance Form Options gives you a facility to show/hide Form Title and Description with another small styling option to Title & Descriptions. Here you can change Form Alignment, background image, background image position, the opacity of a form, Border options and much more.

## 2.Field Level Styling

As we know that fields of a form are its core part so ARForms gives a precise value to fields and hence loaded with many different Field Level Styling Option from here you can manage Styling of Fields' Label Field Label: Position of Label over the field (top) or left or right side of a field. Alignment of Label Left or Right. Label Width. Further, you can also Hide Labels.

Field Styling Options: Width of Field can be managed by you in Percent or Pixel as required Facility of RTL, users of ARForms can anytime change text direction from Right-to-Left or Left-to-Right. More Field Styling options transparent field, adjust the distance in between, Field inner spaces, Field Border styles, Date format for Date Field, Checkbox 'n' Radio Styles, adjust placeholder opacity.

## 3.Submit Button Styling

Managing a Submit button style is easy with ARForms styling options, which has many pre-defined options to beautify, your submit button. You can change button Alignment, width, height, button text moreover you can add images to the submit button and much more.

You can apply a shadow effect in the submit button by using button shadow settings.New

## 4.Error Validation Styling

You can manage error validation font styling, message color, as well as message background color and you, also have two different ways in which you can display a validation message.

Validation Message Style: Modern and Standard.Validation Message Position: Top, Left, Right, and Bottom. Validation Message Color: you can choose from an unlimited color option for a message and its background. Validation Font: From custom font option in styling tools which provides google font as well as some predefined fonts option and also font-size from there only.

## 5.Custom CSS

If all options above are unable to meet your expectations then this option can help you out by providing you the customize CSS where users can write their styling code/CSS.

## Reset Style

Apart from all these for form styling tools, ARForms also provides RESET Button to remove all changes whatever you have set in Form Styling.
Note: After saving the form, Reset Button can't help you out roll-backing your styling.

# Opt-ins : Integrate Email Marketing Tools

ARForms supports inbuilt 12 email marketing tools. Email marketing is popular with companies as it is a significantly cheaper and faster way to be in the market by sending emails to your users.

- AWeber
- MailChimp
- GetResponse
- iContact
- Constant Contact
- GVO
- eBizAC.Com
- Madmimi New
- MailerLite New
- ActiveCampaign New
- Zapier New
- Sendinblue New
- HubSpot New
- ConvertKit New

By using this, your mailing lists will be kept up-to-date automatically when users submit a form. It is an efficient way to grow your mailing list. Let us discuss, how you can configure Email Marketing Tools with any form? From this option of `Opt-ins`, you can integrate these tools through API method or Web form method.

Steps to configure Marketing Tools with any form

- Firstly you have to configure it in `Global Settings > Email Marketing` Tool tab. more details
- After that to use it in a form you have to configure the required plugin inside the Opt-ins toolbar, where you will find a list of Marketing Tools.
- Map form field which you need with your Marketing Tool.
- Now you just need to switch enable the required marketing tool, you can enable as many as marketing tools you want for a single form. Here you have to partially configured your Marketing Tools. Here you have to select a list of contact for that marketing tools which derived from API or Web form method you entered in Global Setting.
- ARForms also provides a Conditional Subscription for Marketing Tools. For Example, if you want to add a user to MailChimp only if they have Email Address of Gmail, Condition over Marketing tool is illustrated below.

# SPAM PROTECTED FORMS

New ARForms has been loaded with a Powerful built-in captcha mechanism.
ARForms protect your form with an inbuilt spam protection method which prevents spamming of entries and this built-in captcha is that much powerful that you don’t even need to add Google ReCaptcha to your form OR don’t need to use any other captcha.

### Disable Hidden CaptchaNew

This option is available in `General Settings > Other Settings` by checking this option, you can disable hidden captcha.

# Auto save partial form data

While filling the form if there is any interruption due to which form gets abandoned without submitting it, then this will retrieve all form data when you again start fill that form. To use this functionality in any form you just need to check this checkbox residing inside `Other Options > General options`.

There are many reasons a user might abandon your form. A question could be confusing, or you may have included too many fields. ARForms Save Partial Form data feature captures real-time form data even if those forms are never submitted. You can even reach out to lost leads and get a second chance to connect and fill the form.
Note: this is browser-specific, will not work in private browsing.

# Don't store entry in databaseNew

If you enable this option, form entries will not be stored in the database hence the entries will not be displayed in the form entries section. If email notification is enabled then data will be sent through email.

Note: If any of the form fields are mapped with any ARForms add-on then this feature will not work.

# Pre Populated Forms

ARForms provide a facility to pre-populate form fields or you can also say as setting a default value, with ARForms is very easy to make any form Pre Populate just by adding query string to URL of your form. Let's see these in some brief with an example, to populate a form field like 'City' and you want to populate that field as 'New York' then you have to add a query string to your URL, this query string follows a pattern like "item_meta[{field_id}] = {reuired data to add}".

# Pre Populated Popup Forms

ARForms provides a facility to pre-populate popup form fields. You can achieve it without using the query string to the URL of your form.
Let's see in detail with an example.
For example, you have a field labeled as 'City' and you want this field populated as 'New York' in your modal(popup) form then you just need to add one more parameter in the shortcode for ARForms popup which is preset_data.
Following is a pattern to pre-populate specific field in a popup,

    preset_data="item_meta_{FIELD_ID}||{VALUE}"

`FIELD_ID` - replace this with your specific form field id.
`VALUE` - replace this with value for specific form field you want to populate with.
Now your shortcode will be like,
[ARForms_popup id=123 desc='Click here to open Form' type='link' width='800' modaleffect='fade_in' is_fullscreen='no' overlay='0.6' is_close_link='yes' modal_bgcolor='#000000' preset_data="item_meta_1000||New York"]

### Pre Populate Multiple Fields

You can pre-populate multiple fields of your form in popup using `~!~` separator.

Following is a pattern to prepopulate specific field in popup,

    preset_data="item_meta_1000||New York~!~item_meta_1001||USA"

### Pre Populate Checkbox Fields

You can prepopulate the checkbox field too. To check multiple options of your checkbox field in the popup you need to add values using `^!^` separator just like following,

    preset_data="item_meta_1002||opt1^!^opt2^!^opt3~!~item_meta_1003||{VALUE}"

# Styles to display a forms

ARForms gives awesome ways to display forms on a page or a post, this different ways of displaying form have been achieved by displaying form in popup with various types of animations, buttons, the position of button to open a form and much more.

Let's see all these in details,

1. Link

   `[ARForms_popup id={form_id} desc='{caption of a link}' type='link' height='auto' width='800' overlay='0.6' is_close_link='yes' modal_bgcolor='#000000' modaleffect='fade_in' is_fullscreen='no'].`

2. Button

   `[ARForms_popup id={form_id} desc='Click here to open Form' type='button' height='auto' width='800' overlay='0.6' is_close_link='yes' bgcolor='#808080' txtcolor='#FFFFFF' modal_bgcolor='#000000' modaleffect='fade_in' is_fullscreen='no'].`

3. Sticky

   `[ARForms_popup id={form_id} desc='Customize Text on From Button' type='sticky' position='bottom' height='auto' width='800' bgcolor='#1bbae1' txtcolor='#1119FF' ].`

4. FLY

   `[ARForms_popup id={form_id} desc='Click here to open Form' type='fly' position='left' height='auto' width='800' angle='0' bgcolor='#2d6dae' txtcolor='#FFFFFF'].`

5. On Page Load

   `[ARForms_popup id={form_id} type='onload' height='auto' width='800' on_delay='0' overlay='0.6' is_close_link='yes' modal_bgcolor='#000000' modaleffect='fade_in' is_fullscreen='no']`

6. On Page Scroll

   `[ARForms_popup id={form_id} type='scroll' height='auto' width='800' modaleffect='fade_in' is_fullscreen='no' on_scroll='10' overlay='0.6' is_close_link='yes' modal_bgcolor='#000000' ]`

7. On Timer(Scheduled)

   `[ARForms_popup id={form_id} on_delay='0' type='timer' height='auto' width='800' modaleffect='fade_in' is_fullscreen='no' overlay='0.6' is_close_link='yes' bgcolor='#FFFFFF' txtcolor='#FFFFFF' modal_bgcolor='#000000']`

8. On Exit(Exit Intent)

   `[ARForms_popup id={form_id} type='on_exit' height='auto' width='800' modaleffect='fade_in' is_fullscreen='no' is_close_link='yes' modal_bgcolor='#000000' ]`

9. On Idle

   `[ARForms_popup id={form_id} type='on_idle' height='auto' width='800' modaleffect='fade_in' is_fullscreen='no' inactive_min='1' overlay='0.6' is_close_link='yes' bgcolor='#FFFFFF' txtcolor='#FFFFFF' modal_bgcolor='#000000']`

# Shortcode

ARForms provide several ways to add your form anywhere on your site in an easy way. You can add the form to page, post, widget, text, widget as well as in template by just simply insert the shortcode.

Let's see simple ARForms shortcode that adds Form as the content of a page.

## Using Shortcode Insert a Form into page/post

`[ARForms id={form_id}]`
ARForms allow
a) go to "Add New" from the "Pages" menu. Or "Add New" from the "Posts" menu.
b) Add page / post title.
c) You can see the ARForms icon near the "Add Media" button above the editor. By clicking on that icon you will able to see a popup.

d) From that popup, you can select the form from the drop-down which you wish to add to that page. Also, you can select how you want to add this form to a page. That means whether you want to add form in the page itself (Normal Form) or want to open in a popup window.

# ARForms with Gutenberg

ARForms supports WordPress Gutenberg. If your WordPress version is 5.0 or higher and using WordPress Gutenberg page editor then you have ARForms block to add easily in page from Common Blocks. When you click on ARForms block you will see the same popup as in classic editor from where you can select the form and other options of including a form on your page.

# ARForms with Visual Composer

## Embedding Form with Visual Composer

ARForms exclusively add Element in Visual Composer Page Builder, which facilitates to add form in a page just like an element. Even ARForms give predefined styles to display a form.

With Visual Composer page can be built using Classic Mode or Frontend Editor, unlike both these ARForms have a common method in both to add form. Let us understand step-wise how to add a form using Visual Composer.

1. Select Classic or Frontend Editor with which you want to build a page.
2. After that click on `Add Element` and you will see a popup with numerous elements, you need to`click on ARForms icon`.
3. On click ARForms icon you will get a popup window as shown below, to select the required form and style to display that form on a page.

# ARForms with Cornerstone

## Embedding Form with Cornerstone

ARForms exclusively equipped as an Element in Cornerstone Page Builder, these facilitate to add form in a page just like an element. Even ARForms gives many options/styles to display a form & various style (as discussed in Style to Display a form sections)

.

Let us see illustration and understand each step :

1. You need to add an element of ARForms in any row/column of a page.
2. Then clicking on the element icon placed in a page you will get a list of an option of ARForms in the sidebar.
3. The List of Arguments listed under ARForms allows you to select Form you want in a page as well as the styling of that form, link types and much more.
4. After selection of Form and required arguments you just need to save the setting and all done.

# ARForms with Elementor

## Embedding Form with Elementor

ARForms exclusively add Element in Elementor Page Builder, which facilitates to add form in a page just like an element. When you edit your page with Elementor you will have ARForms widget with general elements of Elementor.

Let us see illustration and understand each step :

1. You need to drag and drop the ARForms element in any row/column of the Elementor section on a page.
2. You will have ARForms Shortcode block in the Elementor sidebar from where you can select/change form from your saved forms in ARForms.
3. You can also change the form type whether you want `Internal` form in a page or `Modal(popup) Window`. Other styling and settings options will be available on select Modal(popup) Window form type.
4. After complete the selection of form and changes of styling and settings you just need to save by click on the PUBLISH/UPDATE button and all done.

# ARForms in Widget

With ARForms, you can display your form not only from page or post but also in a sidebar of your website pages. ARForms has a ready widget that you need to just drag into a sidebar and you are ready to publish your form !!.

1. go to "Appearance" => "widgets" from admin panel.
2. You will find the "ARForms Form" widget in the widget list.
3. Drag that widget into any sidebar.
4. Give the title of the widget, select the form you wish to display and its relevant options in a sidebar and click on the "Save" button.
5. You can Enable/Disable multicolumn in the form in the widget by check/uncheck Disable Multicolumn in Form option.New

Here, also you can give all possible styles to your form that will reside as a widget on our page.

# ARForms in Navigation Menu

ARForms provides a link to form in Navigation Menu, but this is totally dependent on the theme as there must have `'WordPress navigation core hooks'` provided in`` the theme. These provide support in many popular themes like Avada, Dante, xtheme, etc.

You can change the label of Navigation Link which will be seen on Menu Bar, apart from these all form under these open as popup you can just customize few arguments only like `is_close_link, modal_bg_color, on_delay,` etc

# ARForms in Theme Templates

ARForms provide such a facility that you can use any form directly into your theme templates by just using the functions mentioned below.
`" get_form_shortcode() " and by using different arguments in this function you can achieve different views & styles to display a form.`

Normal View

<?php echo $maincontroller->get_form_shortcode(array('id' => {form_id})); ?>

Pop-up View

<?php echo $maincontroller->get_form_shortcode_popup(array('id' => {form_id}, 'desc'=>'Click here to open Form', 'type'=>'link', 'height'=>'auto', 'width'=>'800'));?>

Fly View

<?php echo $maincontroller->get_form_shortcode_popup(array('id' => {form_id}, 'desc'=>'Click here to open Form', 'type'=>'fly', 'position'=>'left', 'height'=>'auto', 'width'=>'800', 'bgcolor'=>'#2d6dae', 'txtcolor'=>'#ffffff'));?>

Sticky view

<?php echo $maincontroller->get_form_shortcode_popup(array('id' => {form_id}, 'desc'=>'Click here to open Form', 'type'=>'sticky', 'position'=>'top', 'height'=>'auto', 'width'=>'800', 'bgcolor'=>'#93979d', 'txtcolor'=>'#ffffff'));?>

# Site Wide Popup

ARForms introduce the best and unique feature which is Site wide popup. You may want to show modal forms like subscription form, contact form in your site at all/specific pages or posts. You can that modal forms easily in ARForms.

Please go to the Site-wide Popup page from `ARForms > Site-wide Popup`. Here you can manage all your site-wide popups. On hover on any record of you will get action buttons visible like edit/duplicate/delete popup and Analytics.
Click on `Add new site-wide popup` button to add new site-wide popup for your saved forms in ARForms. You will get a popup visible as you can see in the following screenshot.

Now here you need to select a form of ARForms for which you want to display popup in your site. You can see other options are there to enable/disable which are following,

- Display form popup on all posts
- Display form popup on all pages
- Hide the form popup on the Archive page
- Hide the form popup on 404 page
- Hide the form popup on Frontpage
- Hide the form popup on Search Result page
- Hide the form popup on Logged in user

When you enable Display form popup on all posts/pages you will have other options visible like `Modal Trigger Type`, `Caption`, `Click Types(Sticky/Fly)`, `Size(in px)`, `Colors`, `Link Position`.
You may need some pages/posts to exclude from displaying your popup. For that, there is an option for `Exclude Page/Post`. Here is an auto-complete input where you can search your pages/posts and add multiple pages/posts.

After complete save your settings for the popup and its done.

Note: Form popup should be displayed once per session (except on click trigger type form popup).

# Manage Entries

## Form Entries Data

ARForms allow you to view each entry of a particular form. It will show you all the details which reside within a form. Even you can hide fields from the list which you want. To get a list of entries goto `Form Entries` page. You can also view entries of any form from the `Manage Form > Form Entry icon.`

You can perform bulk actions to delete entries, and also on export entries.

## Filtering Entries

Submissions can be filtered by date as well as a search query.

1. To search entries you must select the form for which you want entries, it's compulsory.
2. To search in a date range, enter your beginning and ending dates in the filter.
3. You can also search entries by any keyword from the entry list.
4. Even you can hide fields from the list which you want, you can select a field as illustrated below.

## Editing and Deleting Entries

Apart from Searching & Viewing entries ARForms also gives facility to Edit as well as Delete an entry. Deleting of entry can be done for more than one entry at a time by using Bulk Action - delete. To perform edit operation you first need to click on eye symbol appears on hover of that particular entry or row of a table, on click that icon a popup of entry will be visible where you can edit any data just by clicking on entry data.

For file upload field if you have files uploaded then on hover on that you will get icon visible to delete your uploaded file in particular entry.
While deletion of entries can be performed on multi as well as a single entry, to delete any one entry you just need to click on the trash icon a confirmation popup will appear which on confirms delete that entry permanently. Another way to delete entries is by selection entry by checkbox, after that goto Bulk Action combo and select delete, then you will get confirmation popup which deletes all selected entries permanently on your confirmation.

# Manage Incomplete Entries

## Partial Filled Form EntriesNew

ARForms allow you to view the incomplete entry of a particular form. It will show you all the details which reside within a form. Even you can hide fields from the list which you want. To get a list of Partial filled form entries goto `Form Entries` page.

## Filtering Partial Filled Form Entries

Incomplete submissions can be filtered by date as well as a search query.

1. To search entries you must select the form for which you want incomplete entries, it's mandatory.
2. To search in a date range, enter your beginning and ending dates in the filter.
3. You can also search for incomplete entries by any keyword from the incomplete entry list.
4. Even you can hide fields from the list which you want, you can select field as illustrated below.

Move to Entries List by click this icon you can move incomplete entries into form Entries list.

Deletion of incomplete entries can be performed on multi as well as a single entry, to delete any single incomplete entry you just need to click on the trash icon a confirmation popup will appear which on confirms delete that incomplete entry permanently. Another way to delete incomplete entries is by selection entry by checkbox, after that goto Bulk Action combo and select delete, then you will get confirmation popup which deletes all selected entries permanently on your confirmation.

You can perform bulk actions to delete entries, export entries, and also move to entries list.

# Entries Analytics / Chart

ARForms facilitate you to display entries ratio in the form of analytics. This functionality is displays analytics of all forms or specified form.

You can view entries ratio in three ways:
1) Daily
2) Monthly
3) Yearly
By clicking any of this tab, you can view analytics according to the selected option.

Apart from these ARForms gives you three different Graphical/Statistics Representation namely :

1.Bar Chart.

The bar chart is a graphical presentation of views and entries with rectangular bars with heights or lengths proportional to the values that they represent. This is used to show comparisons among views and entries. Here you will see two different rectangular bar that represents Entries & view separately.

2.Line Chart.

Line Chart is a graphical representation that displays views and entries as a series of data points called 'markers' connected by straight line segments. This is used to visualize a trend in views and entries over intervals of time.

3.World Wide Entries & Views.

It is also referred to as a map chart, this illustrates the relative views & entries of the selected form in different countries of the world.

# Export Form Entries

Using ARForms, you will be able to export entries from the 'Form Entries' page. Even you can able to choose whether you want to export a particular entry or more than one. you can export entries of your search results.

You can export as many entries, but all entries will be exported in CSV format.

1.Export Entries from 'Form Entries' Page

You can select entries manually which is required by you. After that you have to select "Export to CSV " action from Bulk Actions dropdown list and then click on apply, you will get a CSV file with your entries.

2.From the Import/Export Page

While exporting entries from here, you will get an option to select separator for Entries to be exported in CSV, but from here you have to export full entries of a particular form you can't select entries manually. Just select separator and form from dropdown and press export button to get entries.

# Default Messages for forms

## Customize Default Messages over a Form

In global settings, we provide customization of different common messages which general use by form. The customization of various messages allows you to show preferred messages where you required.

Some common messages can be customized are

1.Blank Field

When you choose any field as Required Field (using an asterisk(*) symbol), the field becomes compulsory, i.e. if that field will remain blank during submission then a form will throw a validation error and message will display. This message can be modified globally by editing Bank Field message which by default like "This field cannot be blank". The above can also manage field wise by given customize a message for Blank Field in their field options.

2.Incorrect Field

When field is not validated with the required validation like Only Alphabets, Only Numeric, Phone Number format, etc then a message for Incorrect Field Data will be thrown and the message content will be modified from here.

3.Success Message

On successful submission of the form, there will be a success message which indicates the submission of form data is performed without any error. This message can be updated according to user preference, by default it is "Form is successfully submitted. Thank You!" and this can be changed by changing the Success Message field in Global Setting.

4.Submission Failed Message

When due to some errors the submission of the form gets interrupted and submission gets failed, then there will be a Failed Submission Message which indicates the submission of form data has not performed due to some error. These message doesn't show an error but just inform user that form data was not submitted successfully. This message can be updated according to user preference, by default it is "We are sorry. Form is not submitted successfully. " and this can be changed by changing the Success Message field in Global Setting.

5.Default Submit Button

These fields use to define default text of the submit button to all of its new building forms, unlike already built form. If you want a submit button with your preferred text then, you just need to write a new message inside this field. For example, if you want to SAVE text as the default text in for all form which you built now, you just need to change this field data to SAVE from Submit.

# Email Configuration

ARForms allows you to set Auto Response Mail globally in `ARForms > Global settings`. You can set a default setting for email. Even you will be able to choose the server which you want to use to send mail. If you want to set different Email settings for each form then you can manage it also from 'Auto Response Mail' inside the `Form 'Settings' tab`.

Each email from ARForms will be send using this configuration, which you set globally, there is various method to send an email which ARForms provides by default you just need to select from them.

- WordPress Server Method
  All Email that we are sending using WordPress default server in which you didn't need to configure Host, Port or any specific email id. This method requires little configuration. Easy to setup. But this method is unreliable. This method is the most likely reason your emails are in SPAM, or not reaching your inbox at all.

- SMTP Server Method
  SMTP Methods allow you to send Emails using you a specific email account like your Gmail or other email service providers. These settings here would depend on your email provider. Settings for Gmail or a Google Apps account can be found here. For Yahoo, try this. If you are using GoDaddy, set the SMTP Host to localhost, and leave the Username, Password, and Port as blank. If your email provider is not from above you can simply google it and you will get required configuration data with a couple of minutes. If you are using an email provided by your web host, you would find the settings with them.
  1. Sender Name: Type in something like My Blog.
  2. Sender Email: Type in something like ARForms@myblog.com.
  3. Username: The username that you use to login to this email account.
  4. Password: The password of the account.
  5. SMTP Host: For Gmail, this would be smtp.gmail.com.
  6. Port: For Gmail use port 465 with SSL or 587 with TLS.
  Apart from these ARForms SMTP Configuration provides a simple mechanism to Send Test Email so you can confirm the SMTP setting you have done are correct or not. This Test Mail gives you the exact error if there is any while sending a mail using SMTP form your server.

- PHP Mailer Method

In PHP Mailer Method again you didn't require to configured anything just select this method and all set.
Let's see some other Email Configuration which will be useful while sending emails from ARForms.

1.Email Format:

This is used to decide the format in which you can send emails, ie HTML or Plain Text, You will always want this set to HTML unless you have a very specific use case.

2.From/Reply to Name:

This setting will set the name displayed to the recipient when receiving the notification.

3.From/Reply to Email:

This setting will determine which email will be listed as the sender within the notification, If replies should be sent to a different email than the one that the notification is sent from, you can define that email address here. In simple language, we can say that the Reply of the recipient will go to the email address defined here.

# Other General Options

- Decimal Separator

  ARForms serves three kinds of decimal separator namely Dot(.), Comma(,) and No Separator. This option provides using a preferred separator for a decimal part in number.

  ##### Example

      suppose we have number 100.21, then these will be separated using a different option

  Dot(.): 100.21
  Comma(,) : 100,21
  No Separator: 100 ( no decimal part of a number will be displayed)

- Form Submission Method

  ARForms provides an admirable functionality for different kinds of submission methods For submitting that form data. You can select any one method according to your wish.
  AJAX: This type of form submission to submitting form data without refreshing that page.
  Normal Submission: Submission method which you normally observed, in which the whole page gets reload after submission of the form.

- Success Message, hide success message after

  This option helps you to decide the time period till which you want to display Success Message, after Successful form submission, to your users. For better understanding see the image below which shows the Message whose Fade-out time can be decided under `Success Message - hide success message after .....`.

- Form Global CSS

  ARForms gives you a unique feature to customize your own CSS to all of its pages, where ARForms form is included. This helps you out whenever your theme gets conflict with inbuilt CSS of ARForms or when you want some extra design to all your forms or page containing forms or in any other way you can use this customization. This customization will be applied only on the page where you have included Form created through ARForms.

- Choose the character sets which you want to add with google fonts

  By default, many languages ( fonts) don't support some characters to display in the browser, in that case, you need to set the character set along with font family. So, ARForms allow you to set the specific character set for your respective font selection.

- File Upload Path

  Whenever a form is submitted from the front by default file is uploaded at ARForms default path,
  SITEPATH/wp-content/uploads/arforms/userfiles/.

  Now you are able to change the path from Global Settings > Other Settings > File Upload Path.

  Make your file upload path dynamic using shortcodes provided here,

  {form_id}: This shortcode will replace with the form id.
  {year}: This shortcode will replace with the current year.
  {month}: This shortcode will replace with the current month.
  {day}: This shortcode will replace with the current day.

  Please make sure that the static upload directory you have set exists and writable.

  ##### Example

      suppose you have set wp-content/uploads/xyz/{form_id}, then xyz directory should be exist and writable in uploads.

# Load JS & CSS in all pages

This option is mainly used when there is an AJAX-based theme that doesn't load full pages while navigating from one page to another, in such cases, it will be unable to load required JS/CSS files of any plugins. So to overcome this issue ARForms gives an option to load its JS or CSS in all pages of your website.

`These will load ARForms required JS and CSS in all of the pages and posts of your website and encourages forms of ARForms in any environment of Themes or Plugins.`

You are also able to choose which JS & CSS are essentials, according to your need you just have to make switch enable and check the checkbox to make it load in all pages.

# Configuring Email Marketing Tools

You can configure available Email Marketing Tools from this option.

Go to the `Global Settings` > `Opt-ins Tab` to configure Email Marketing Tools.

To configure tool, you just need to verify your Email Marketer account by entering the API key and other required details. And after verification, the system will fetch all the list name/campaign name from your account.
After configuration of a Marketing Tools, goto opt-ins option in add/edit form, there you can select opt-in tools to add a subscriber to list when they submit a form on your site.
So, whenever anyone will submit a form, that user will be added to a selected list of a specific tool as subscriber automatically. We have internally mapped First Name, Last Name & Email Address field of specific form with Email Marketing Tools.
Configuring Email Marketing Tools :

##

AWeber

Please note that the Aweber API mechanism has been changed in ARForms version 3.7. Now it will authorize using an ARForms application instead of your application. So you do not need to create AWeber application.

Please note that if you want to disable confirmation opt-in (opt-in or double opt-in) you need to contact Aweber support to disable it for your list

The following are steps to configure and authorize Aweber in ARForms.

1. Please click on the `Authorize` button you will get a popup window where you need to login to your Aweber account.
2. Please enter your AWeber username and password and click on the “Allow Access” button.
3. After successfully authorization system will fetch all the list names from your AWeber account. Select default List name to add subscribers. Note:You can refresh your list names anytime by clicking the link “Refresh List” You can Deactivate the integration of your account with your system by clicking the link “Delete Configuration”.
4. Click on the Save button.
5. Now go to `ARForms`->`Add/Edit Form`, here you will see the Opt-ins section. You will see tabs for all configured opt-ins. Go to the AWeber tab, enable Aweber and select List in which you wish to add all user's email addresses, in your AWeber mail list.

###

MailChimp

Get API Key from Mailchimp Application
First of all login to your Mailchimp account and click your profile name to expand the Account Panel, and choose Account. Then, Click on the Extras drop-down menu and choose API keys. You can copy an existing API key OR click the Create A Key button for creating a new key.

1. Please Enter your “API Key” obtained from your Mailchimp account.
2. Click on the “Verify” link.
3. That’s all!! The system will verify your account and fetch all list names from your account. Select default List name to add subscribes.
4. If you want to enable the double opt-in method for Mailchimp, then select the “Enable double opt-in” checkbox. Note: You can refresh your list names anytime by clicking the link “Refresh List” You can Deactivate the integration of your account with your system by clicking the link “Delete Configuration”.
5. Click on the Save button.
6. Now go to `ARForms`->`Add/Edit Form`, here you will see the Opt-ins section. You will see a list of all configured opt-ins with the checkbox. Select the checkbox for Mail Chimp and select List in which you wish to add users emails, in your Mail Chimp mail list.

##

GetResponse

Get API Key from GetResponse Application
Log in to your GetResponse account. You can find API Key under `My account` > `Account details` > `API & OAuth`.

1. Please Enter your “API Key” obtained from your GetResponse account.
2. Click on the“Verify” link.
3. That’s all!! The system will verify your account and fetch all campaign names from your account. Select the default campaign name to add subscribes. Note: You can refresh your campaign names anytime by clicking the link “Refresh List”.You can Deactivate the integration of your account with your system by clicking the link “Delete Configuration”.
4. Click on the Save button.
5. Now go to `ARForms`->`Add/Edit Form`, here you will see the Opt-ins section. You will see the a list of all configured opt-ins with a checkbox. Select checkbox for GetResponse and select List in which you wish to add users emails

##

iContact

To configure iContact you need an account with it.

To get APP ID you need to register first with iContact (you must have an account with iContact). Step to get APP ID:

1. Log in to your iContact account. (if you are logging into the sandbox, use the sandbox username and password)For sandbox click here and for Production account click here.
2. Provide a name for the application and a description of the application. Click Save.
3. The API-AppId is displayed. Note: For security purposes, iContact’s API uses your AppId to identify your application.
4. Click the link to “enable the AppID for your account”.
5. Now go to `ARForms`->`Add/Edit Form`, here you will see the Opt-ins section. You will see a list of all configured opt-ins with the checkbox. Select checkbox for iContact and select List in which you wish to add users emails

##

Constant Contact

Get API Key and Access Token from Constant Contact Application
Sign up for a Mashery account or log in. Confirm your account, if it’s new. Then, Register an Application. After Registration an Application API Key will be assigned to your application. Fill your API Key into this page (if not already filled in) and click Get Access Token. Getting an access token requires a Constant Contact account. When you click on Get Access Token then you are taken to a Constant Contact account sign up page. Create a new account, or if you have an existing Constant Contact account (NOT your Mashery developer account), sign in.

1. Please Enter your “API key” and “Access Token” obtained from your Constant Contact account.
2. Click on the“Verify” link.
3. That’s all!! The system will verify your account and fetch all list names from your account. Select default List name to add subscribes. Note: You can refresh your list names anytime by clicking the link “Refresh List” You can Deactivate the integration of your account with your system by clicking the link “Delete Configuration”.
4. Click on the Save button.
5. Now go to `ARForms`->`Add/Edit Form`, here you will see the Opt-ins section. You will see a list of all configured opt-ins with the checkbox. Select checkbox for Constant Contact and select List in which you wish to add users emails

##

GVO

Login in to your GVO account to get your webform and just copy-paste it in a global setting in email marketing tool section under GVO textarea. After that all you need to do is just goto `ARForms`->`Add/Edit Form`, here you will see the Opt-ins section. You will see a list of all configured opt-ins with the checkbox. Select a checkbox for GVO.

##

eBizAC.com

Login in to your eBizAC account to get your webform and just copy-paste it in a global setting in the email marketing tool section under eBizAC textarea. After that all you need to do is just goto `ARForms`->`Add/Edit Form`, here you will see the Opt-ins section. You will see a list of all configured opt-ins with the checkbox. Select a checkbox for eBizAC.

##

Madmimi

Get API Key from Madmimi Application
Login to your Madmimi account, you will observe an `Account tab` on the top left corner, click on that you will see `Settings and Billing` tab further, in that tab you will see `API` tab. So, the steps to get API is `Madmimi(after login) > Account > Settings & Billing > API` .
Again for Adding Subscriber/Audience List you have to visit `Madmimi(after login) > Audience > symbol of a plus (+)`. After getting your API key you just need to follow the below steps to configure it with your ARForms.

1. Please Enter your “API key” and “Access Token” obtained from your Madmimi account.
2. Click on the“Verify” link.
3. That’s all!! The system will verify your account and fetch all list names from your account. Select default List name to add subscribes. Note: You can refresh your list names anytime by clicking the link “Refresh List” You can Deactivate the integration of your account with your system by clicking the link “Delete Configuration”.
4. Click on the Save button.
5. Now go to `ARForms`->`Add/Edit Form`, here you will see the Opt-ins section. You will see list of all configured opt-ins with the checkbox. Select a checkbox for Madmimi and select List in which you wish to add users' emails.

##

MailerLite

Get API Key from MailerLite Application
First of all login to your MailerLite account and click your profile name to expand the Account Panel, and go to Integration -> Developer API. Select your API key from here to use in the ARForms configuration. Now, let's see MailerLite configuration in ARForms.

1. Please enter your "API Key" obtained from your MailerLite account.
2. Click on "Verify".
3. That's all!! The system will verify your account and fetch all group names from your account. Select the default group name to add subscribers.
   Note:
   You can refresh your group names anytime by click on the link "Refresh List".
   You can Deactivate the integration with your MailerLite account by click on the link "Delete Configuration".
4. Click on the Save button.
5. Now go to `ARForms -> Add/Edit Form -> Opt-ins`. Here you will see tabs of all inbuilt opt-ins. Select the MailerLite tab and Enable MailerLite you will get dropdown visible where you need to select your group name in which you wish to add subscribers.

Please note,
If Subscriber already exists with the same email address in any group, it will not be added to your group.

##

Sendinblue

Get API Key from Sendinblue Application
First of all login to your Sendinblue account and click your profile name to expand the Account Panel, and go to SMTP & API. Select your API key from here to use in ARForms configuration. Now, let's see Sendinblue configuration in the ARForms.

1. Please enter your "API Key" obtained from your Sendinblue account.
2. Click on "Verify".
3. That's all!! The system will verify your account and fetch all list names from your account. Select the default group name to add subscribers.
   Note:
   You can refresh your group names anytime by click on the link "Refresh List".
   You can Deactivate the integration with your Sendinblue account by click on the link "Delete Configuration".
4. Click on Save button.
5. Now go to `ARForms -> Add/Edit Form -> Opt-ins`. Here you will see tabs of all inbuilt opt-ins. Select Sendinblue tab and Enable Sendinblue you will get dropdown visible where you need to select your list name in which you wish to add subscribers.

Please note,
If Subscriber already exists with the same email address in any group, it will not be added to your group.

##

HubSpot

Get API Key from HubSpot Application
First of all login to your HubSpot account and click your account name in the top right corner and go to Integration, then in the left sidebar menu, navigate to Integrations -> API key. Now click Show key button and get your API key from here to use in ARForms configuration. Now, let's see HubSpot configuration in ARForms.

1. Please enter your "API Key" obtained from your HubSpot account.
2. Click on "Verify".
3. That's all!! The system will verify your account and fetch all List names from your account. Select default List name to add subscribers.
   Note:
   You can refresh your List names anytime by click on the link "Refresh List".
   You can Deactivate the integration with your HubSpot account by click on the link "Delete Configuration".
4. Click on the Save button.
5. Now go to `ARForms -> Add/Edit Form -> Opt-ins`. Here you will see tabs of all inbuilt opt-ins. Select HubSpot tab and Enable HubSpot you will get dropdown visible where you need to select your List name in which you wish to add subscribers.

Please note,
You cannot manually add List to Dynamic Lists so please create Static Lists in your HubSpot account.

Please note,
If Subscriber already exists with the same email address in any List, it will not be added to your List.

##

ConvertKit

Get API Key & API Secret from ConvertKit Application
First of all login to your ConverKit account and click your account name in the top right corner and here you get your API key, now for API Secret, you have to click on show. Now you get your API key & API Secret from here to use in ARForms configuration. Now, let's see ConvertKit configuration in ARForms.

1. Please enter your "API Key" and "API Secret" obtained from your ConvertKit account.
2. Click on "Verify".
3. That's all!! The system will verify your account and fetch all Form names from your account. Select default Form name to add subscribers.
   Note:
   You can refresh your Form names anytime by click on the link "Refresh List".
   You can Deactivate the integration with your HubSpot account by click on the link "Delete Configuration".
4. Click on the Save button.
5. Now go to `ARForms -> Add/Edit Form -> Opt-ins`. Here you will see tabs of all inbuilt opt-ins. Select ConvertKit tab and Enable ConvertKit you will get dropdown visible where you need to select your Form name in which you wish to add subscribers.

Please note,
You can enable Auto-confirm new subscribers option otherwise subscribers get mail on registered mail id for confirmation.

Please note,
If Subscriber already exists with the same email address in any Form, it will not be added in your Form.

# Import and Export Form(s)

ARForms provides facilitates import form which was exported from ARForms. This provides a kind of backup and if you want the same from in your another site then in no time you can get your existing form by Exporting it and after that Importing in your new site.

## Exporting Forms

ARForms gives a different kind of functionality to exporting a form, entries of form and forms with its entries. There are three different ways to export form in ARForms.

1. Export Forms(s)

   Export Forms will export single or multiple form structure only, No form data/entries will be exported (if you want form entries to export please see further option). The export form is so simple with ARForms. You just need to select the desired form, here you can also select multiple forms together, now just click on the Export button and all done after that you will get a Text File (.txt). This exported .txt file can be saved for future use. `Please don't change the name of Exported .txt file,` else you will be unable to import these file.

2. Export Entries

   You can get a list of all entries for any single form at a time in CSV format, here ARForms helps you to select separator for entries in CSV file. Export Entries with ARforms serves three kinds of separator namely Comma(,), Semicolon(;) and Pipe(|).

   All entries will get in CSV format you can select your preferred separator for separation of entry in CSV.

3. Export Form(s) & Entries

   Using this method you can get full package backup for Forms & its corresponding entries, here you can select as many forms you want to export.
   Note:`Please note that entries' attachment will not be exported. You have to copy wp_content/uploads/arforms/userfiles folder manually to your new location where you are going to import this setting.`

## Importing of Forms from ARForms Version 3.0 and greater (version >= 3.0)

Form which was exported previously in ARForms, that can be imported in ARForms again simple by pasting data from .txt files here.

All the forms of ARForms which were exported from Version 3.0 will be imported simply by pasting the content of exported text file here.

# Restrict Submission of a Form

ARForms form builder provides a facility to restrict Form Entries using restriction methods provides by ARForms in `Add/edit Form > Other Option > General Options` just by clicking Restrict form submission limit Checkbox you will see list of form restriction methods and also you have to give customize the message on restriction of form.

ARForms provides numbers of ways in which you can restrict form submission :

- After Maximum Entries Form will be not displayed after the number of entries defined by users has been reached and Restricted Entry Message will be shown.

- Before Specific Date Form will be displayed only until the date entered in this setting has been occurred.
- After Specific Date Form will be displayed after date entered in this setting has been passed.
- Between Two DatesForm will not be displayed in between two dates entered by the user inside this section.

# Prevent Duplicate Form Entries

We can also say these as Unique Field Validation.
Preventing Duplicate Form Entries setting can be used to ensure that a designated field has unique data entered into it, the best example of its use is to limit one submission per Email address. Likewise, the same can be done in ARForms just by selecting `Add/edit Form > Other Options > General Options > Prevent duplicate form entries checkbox`.

Here you have the option to Prevent Duplicate Entries on bases of

- IP Address:
  You can prevent entries from the same IP Address eg. allow only one registration for an event from one IP Address.
- Current Logged in user:
  You can allow only one entry per user eg. registration for an event once per user.
- Form Fields:
  You can select Form Field for which you want to Prevent Duplicate Entries of that particular field of Form. eg. Email Addresses in the registration form cannot be similar in any of the cases.

# Show Confirmation (Summary)

ARForms provides an awesome feature to enable a very useful submit action to display user's submitted values after form submission or values to be submitted before submitting the form.
Go to `Add/Edit Form > Submit Action` and check Show confirmation (Summary) option there. Here you have other options are visible on check Show confirmation (Summary) action.

#### Display summary

Here you have a choice whether you need to display a summary before submitting the form or to display after submitting the form.

Before submitting form :

Before submitting form option will let you change the labels for buttons displayed with a summary before submitting the form which are,

Confirmation Button Label - Enter text here to display on the Confirm button.
Edit Button Label - Enter text here to display on the edit button.

After submitting form :

On select after submitting form you will have following options are visible,

Please note,
1. You have to select "Display a Message" form submission method from "Form submission action" in order to work "display confirmation summary after form submission".
2. Confirmation summary after form submission only works with Ajax Submission method.

1. Allow user to Print Summary

   Check this option to allow user to print summary displayed after form submission.

   Print Button Label - Change label for print button to be displaying with summary after form submission.
2. Close Button Label

   Change label for close button to be displaying with summary after submitting form successfully.

### How does it work at the front?

After enabling this feature from form editor, let's see how it works at the front-end form.

#### Before submitting form

If you have enabled to display summary before submitting a form, user will have to click on theConfirm button instead of directly Submit the form. You will be able to set all those button labels from "submit action options".

When the user will click on the confirm button, it will display all data that he/she entered in the form and able to confirm values before submitting the form.

Here on that screen, there will be the Edit button and Submit button, in case user finds something wrong in their entered values he/she can click on Edit button and get back to the pre-filled form with their values and will be able to change input values and confirm once again. Now user can submit the form by click on the Submit button.

#### After submitting form

If you have enabled to display summary after submitting form user will have the Close button and Print button if you allowed printing.

If you allow the user to print a summary then the user will have the Print button after submitting the form successfully on click that the user will be able to get their submitted data in hard copy.

Please note,
1. You have to select "Display a Message" form submission method from "Form submission action" in order to work "display confirmation summary after form submission".
2. Confirmation summary after form submission only works with the AJAX Submission method.