WPForms Documentation

Documentation, Reference Materials and Tutorials for WPForms

How to Install the WPForms Plugin

Are you ready to install the WPForms plugin? After purchasing a license, the next step is to install our plugin so you can start building forms.

In this step by step guide, we will walk you through how to install WPForms on your WordPress site.

Note: This tutorial is intended for brand new installs of WPForms. If you are upgrading from WPForms Lite, please see our tutorial on how to upgrade to our paid plugin version.

Downloading the WPForms Plugin

To get started, log into your WPForms Account. Once inside, click on the Downloads tab, or the View Downloads link.

WPForms Account View Downloads

Next, click on the Download link to save a zipped file of WPForms plugin to your computer.

WPForms Account Downloads

WPForms Zip File

Note: In some cases, this file may unzip as you download it, and instead appear as a regular folder. However, the folder must be zipped to use the WordPress plugin uploader.

For instructions, please check out these instructions for Windows or Mac operating systems.

For now, you don’t have to download the addons because you can easily install and activate addons from inside your WordPress dashboard later.

Installing WPForms on Your Site

Once you have the zip file, navigate to the site where you want to install WPForms. Inside the admin dashboard, you’ll need to go to Plugins ยป Add New.
On the next screen, click the Upload Plugin button.

You will see the option to upload the plugin. Click on the Choose File button and select your WPForms zip file.

Upload a WordPress Plugin

After your file is uploaded, click on the Install Now button.

WordPress will install the plugin for you. Once the plugin is installed, you’ll need to click on the Activate Plugin button.

After activating the plugin, you’ll need to verify your WPForms license key to get new updates and plugin support.

Adding the license key will also allow you to easily install and activate WPForms addons from inside your WordPress dashboard.

That’s it! Now that you’ve installed and activated WPForms, you might want to check out our guide on how to create your first form in WPForms.

Changelog (2019-04-15)

  • Fixed: PHP notice/warnings from undefined constant (typo).
  • Fixed: Addons screen not populating for all license levels. (2019-04-11)

  • Fixed: Entry print preview page not supporting non-UTF8 charsets.
  • Fixed: Entry print preview page not displaying entry notes.
  • Fixed: Required Checkbox fields asking for all inputs to be checked to pass validation.

1.5.2 (2019-04-10)

  • Added: Smart format for Phone fields.
  • Added: Choice Limit advanced option for Checkbox fields.
  • Added: Smart domain name typo detection for Email fields.
  • Added: New Gutenberg block keywords to help with discovery.
  • Added: Link to "How to Properly Test Your WordPress Forms Before Launching" doc inside Gutenberg block.
  • Added: Filter wpforms_upload_root to change uploads location.
  • Changed: Form builder field delete icon, now a trash can.
  • Changed: Removed legacy check for conditional logic.
  • Changed: Improved Entries list table on small devices.
  • Changed: User IP detection method, now filterable.
  • Changed: Updated flatpickr JS library to v4.5.5.
  • Changed: Updated jQuery inputmask library to v4.0.6.
  • Changed: Updated jQuery validation plugin to v1.19.0.
  • Changed: Clear Dashboard widget cache when form is created/deleted/updated.
  • Fixed: Blank form if using form template containing target="_blank".
  • Fixed: Honeypot field not using unique IDs.
  • Fixed: Duplicating forms creating another duplicate if afterwards the table was sorted.
  • Fixed: Minor issues with Gutenberg editor.
  • Fixed: Browser autocomplete conflict with US address zipcode input mask.
  • Fixed: Form Builder embed modal showing Classic Editor instructions for Gutenberg users.
  • Fixed: No detection or errors if combined multiple file uploads size is greater than post_max_size.
  • Fixed: Number field allowing non-numerical characters on iOS devices.
  • Fixed: Incorrect data in CSV entry exports if fields have been deleted.
  • Fixed: Field Dynamic Choices not showing in form preview when using "Post Type". (2019-03-20)

  • Fixed: Styling issue with single entry previous/next buttons.
  • Fixed: Importing forms that containing `target="_blank"`.
  • Fixed: Issues with duplicating Form Notifications and conditional logic rules inside Form Notifications.
  • Fixed: Quote support/display inside query param Smart Tags.
  • Fixed: Addon cache not clearing when license key is switched or deactivated.
  • Fixed: Other minor fixes. (2019-02-28)

  • Fixed: Conditional logic issue with Checkbox/Multiple choice fields when default values are set. (2019-02-26)

  • Fixed: Conflict with WordPress 5.1 if form contained target="_blank".
  • Fixed: Long field labels cut off when viewed in Entry Print page compact view.
  • Fixed: PHP notices on Entry Print page.
  • Fixed: PHP notices on Entries page.
  • Fixed: Unable to uncheck default Multiple Choice value in form builder after being set initially.
  • Fixed: PHP error when entries are exported after a field has been deleted.
  • Fixed: Form builder Email notification conditional logic settings display issue after new notification is added.
  • Fixed: Conflict with some themes preventing Multiple Choice fields from being selectable.

1.5.1 (2019-02-06)

  • Added: Checkbox Items field (payment checkboxes).
  • Added: Complete translations for Spanish, Italian, Japanese, and German.
  • Added: Improved form builder education and workflows: install and activate any addon without ever leaving the form builder!
  • Added: Smart Tag for referencing user meta data, {user_meta key=""}.
  • Changed: Removed limit on Entry Columns when customizing.
  • Changed: Improved support with LocoTranslate plugin.
  • Changed: Refactored Form Preview functionality, no longer requiring hidden private page to be created.
  • Changed: Always load full WPForms styling inside Gutenberg so forms render correctly.
  • Fixed: Entry counts getting off sync with entry heartbeat detection.
  • Fixed: Typos, grammar, and other i18n related issues.
  • Fixed: Created alias class for WPForms to prevent issue with namespacing introduced in 1.5.0.
  • Fixed: Dynamic population issue when using Image Choices field. (2018-12-20)

  • Changed: Dashboard widget improvements.
  • Fixed: Various typos. (2018-12-06)

  • Changed: Minor improvements to Gutenberg block for WordPress 5.0.
  • Fixed: Error when activating WPForms Pro if WPForms Lite is still activated. (2018-12-03)

  • Fixed: File Upload validation issue if max file size was defined.
  • Fixed: Dashboard widget appearance on Windows. (2018-11-28)

  • Fixed: Required validation enforcement on Date Time fields.

1.5.0 - 2018-11-28

  • IMPORTANT: Support for PHP 5.2 has been discontinued. If you are running PHP 5.2, you MUST upgrade PHP before installing WPForms 1.5. Failure to do that will disable WPForms core functionality.
  • Added: Dashboard widget with basic reporting.
  • Added: WPForms Challenge: an interactive step-by-step guide to creating a form for new users.
  • Added: Dynamic field population, available to enable from form settings.
  • Added: New entries "heartbeat" notification on entries list screen.
  • Added: "About Us" admin page (WPForms > About Us).
  • Added: {user_first_name} and {user_last_name} Smart Tags.
  • Changed: Improved randomizing if field is configured to randomize items.
  • Changed: Improved file size validations with multiple uploads.
  • Changed: Improved i18n support.
  • Fixed: Form builder errors if user had Visual Editor disabled in profile.
  • Fixed: Form builder Windows styling issues.
  • Fixed: Form builder dynamic choices warning not always removing.
  • Fixed: Form builder "Show Layout" CSS formatting.
  • Fixed: reCAPTCHA compatibility when form is inside OptinMonster popup.
  • Fixed: PHP errors if form does not contain entries.
  • Fixed: Validation and formatting issues on some fields if submitted value is zero.
  • Fixed: File upload javascript validation conflicting with multi-page forms.
  • Fixed: Gutenberg block returning error if no forms have been created.

1.4.9 (2018-09-19)

  • Added: Pirate Forms importer.
  • Changed: Some form builder tooltips to contain documentation links.
  • Fixed: Form builder javascript conflict with jQuery non-conflict mode.
  • Fixed: RTL issue with Phone field when using input masks.
  • Fixed: PHP Notice from WPForms widget.
  • Fixed: Incorrect markup around Addons submenu item. (2018-08-31)

  • Fixed: Certain confirmation settings, before 1.4.8, not displaying correctly in the form builder.
  • Fixed: Compatibility issue with MySQL `Strict_Trans_Tables` mode (again).

1.4.8 (2018-08-28)

  • Added: Gutenberg block.
  • Added: Conditional form confirmations - forms can now have multiple confirmations with conditional logic!
  • Added: WP Mail SMTP detection and hints in the form builder notification settings.
  • Added: Alt and title tags to image choices images on frontend display.
  • Changed: Improved Website URL field frontend validation - now automatically adds protocol if omitted.
  • Changed: i18n improvements.
  • Fixed: Compatiblity issue with MySQL Strict_Trans_Tables mode.
  • Fixed: Incorrect param used with shortcode_atts.
  • Fixed: NPS and Rating fields not having access to all conditional logic comparisons.
  • Fixed: Accessing wpforms_setting in frontend javascript before checking if it exists.
  • Fixed: Escaping method in HTML field mangling code on save.
  • Fixed: PHP error toggling form builder notifications in some use cases.
  • Fixed: GDPR field Agreement text not updating in real time.
  • Fixed: Marketing provider connections containing an escaped apostrophe.
  • Fixed: Pressing "Enter" in the form builder resulting in unexpected behavior.
  • Fixed: Incorrect pagination when searching entries.
  • Fixed: Security enhancements and other misc. bug fixes. (2018-06-21)

  • Changed: Adding new choice to Multiple Items field now defaults price to $0..
  • Fixed: Entry ID always displaying 0 when viewing single entry details.
  • Fixed: Honeypot field using a none unique CSS ID.
  • Fixed: Form builder Bulk Add display issues in certain use cases.
  • Fixed: Checkbox field values not saving if Show Values field option is enabled.
  • Fixed: Date Time field date dropdown placeholder text not accessible. (2018-06-07)

  • Added: Greater Than and Less Than conditional logic rules.
  • Added: Conditional logic support for Net Promoter Score field (Surveys and Polls addon v1.1.0).
  • Changed: Updated Russian translation.
  • Fixed: Various i18n issues.

1.4.7 (2018-06-04)

  • Added: New Providers class and functionality. The Drip addon is the first to leverage the new class and existing provider addons will be updated over time.
  • Changed: CSV export columns are now filterable (wpforms_export_get_csv_cols).
  • Changed: Old PHP version (5.2 and 5.3) admin warning adjusted to reflect new August 2018 time line.
  • Fixed: Checkbox fields showing as Radio fields in the builder preview when first created.
  • Fixed: Duplicating fields in the form builder causing issues with certain field types.
  • Fixed: Entry ID becomes 0 when resending notifications.
  • Fixed: Escaping issue with provider connection names contained an apostrophe.
  • Fixed: Alignment issues with the Addons page display.
  • Fixed: Incorrect text on the Welcome activation page.

1.4.6 (2018-05-14)

  • Added: GDPR Enhancements plugin setting [doc].
  • Added: GDPR Enhancement: Disable User Cookies plugin setting.
  • Added: GDPR Enhancement: Disable User Details (IP and User Agent) plugin setting.
  • Added: GDPR Enhancement: Disable Storing User Details form setting.
  • Added: GDPR Enhancement: User Agreement form field.
  • Added: Page break, section divider, and HTML fields can now be enabled in email notifications with a filter [doc].
  • Changed: Hide credit card field unless enabled by a payment addon or with a filter [doc].
  • Changed: PHP warning that alerts users support for PHP 5.4 and below will be dropped this summer.
  • Changed: Spam logging, to improve performance.
  • Fixed: Rating and Likert Scale not included in CSV exports.
  • Fixed: Typo in base form CSS.
  • Fixed: Stripping HTML from the checkbox, mulitple choice, and multiple payment choice labels in the form builder.
  • Fixed: Unreadable errors if 1-click addon install fails.
  • Fixed: Date and Time field time interval labels not translatable.
  • Fixed: Form builder icon visibility when field labels are hidden. (2018-04-03)

  • Changed: Use minified admin assets when appropriate.
  • Changed: Show helpful doc link in form embed modal.
  • Changed: Minor improvements with complex conditional logic rule processing.
  • Fixed: Rating and Likert fields missing from CSV exports.
  • Fixed: reCAPTCHA v2 showing in form builder when using Invisible reCAPTCHA.
  • Fixed: Conditional logic rules inception.
  • Fixed: Conditional logic rules with Radio and Checkbox choices not updating until save.
  • Fixed: Remove jQuery shorthand references in `admin-utils` to prevent conflicts.
  • Fixed: Issue with form return hash not processing correctly in some scenarios. (2018-03-21)

  • Fixed: Checkbox and Multiple choice fields not validating when inside pagebreaks.
  • Fixed: Incorrect documenation link for Input Mask.
  • Fixed: Input Mask value disappearing when form builder is refreshed. (2018-03-20)

  • Fixed: Dynamic choices not displaying correctly for Multiple Choice and Checkbox fields.

1.4.5 (2018-03-15)

  • Added: Image choices feature with Checkbox, Multiple Choice and Multiple Payments fields; Images can now be uploaded and displayed with your choices!
  • Added: Custom input masks for Single Line Text fields (Advanced Options).
  • Added: No-Conflict Mode for Google reCAPTCHA (Settings > reCAPTCHA). Removes other reCAPTCHA occurrences, to prevent conflicts.
  • Added: SSL Connection Test (Tools > System Info). Quicky verify that your web host correct supports SSL connections.
  • Added: {user_full_name} Smart Tag, displays users first and last name.
  • Added: Discalimer / Terms of Service Display formatting option for Checkbox fields (Advanced Options).
  • Added: Basic CSS styling for disabled fields.
  • Added: Uninstall routine, available from Settings > Misc.
  • Added: Form builder performance improvements. Editing a form with hundreds of fields is now 500%+ faster!
  • Added: Search field on Addons page to quickly search available Addons.
  • Changed: New Settings tab: Misc, moved Hide Annoucements option to new tab.
  • Changed: "Total" entries column only displays if the form has a gateway configured and enabled.
  • Changed: {user_display} Smart Tag diplays user's display name (in most cases, this is the user's name).
  • Changed: All
    attributes can now be changed via wpforms_frontend_form_atts filter.
  • Fixed: Processing and validation of return hashes (primarily used with PayPal Standard addon).
  • Fixed: Smart Tag usage in confirmation messages displayed from return hashes (primarily used with PayPal Standard addon).
  • Fixed: Form builder tab icon alignment conflicts with third party plugin CSS.
  • Fixed: Smart Tag dropdown display issues in the form builder.
  • Fixed: Form builder drag and drop area disappearing if all fields are removed from a form. (2018-02-13)

  • Changed: Textdomain loading to a later priority.
  • Changed: Provide entry ID if logging entries to improve performance.
  • Changed: Allow the `WPForms_Builder` class to be accessible.
  • Changed: Move the confirmation message `wpautop` to an earlier priority to not conflict with content added using filters.
  • Fixed: Form builder templates area not aligning correctly in some browsers.
  • Fixed: Payment transaction IDs not displaying on entry details page.
  • Fixed: Incorrect permissions check for annoucements feed.

1.4.4 (2018-01-30)

  • Added: Form entries searching; search by specific field or across all fields, multiple conditionals available (is, is not, contains, does not contain)
  • Added: Form entries filtering by date; e.g. show form entries from Dec 1 - Dec 31 2017
  • Added: Rating field
  • Added: Advanced setting for Multiple Choice and Checkbox fields to randomize choices
  • Added: Filter for Date Time date dropdown select inputs, to customize ranges (wpforms_datetime_date_dropdowns)
  • Changed: Lists (both ordered and unordered) used in the HTML field now have basic styling if using full form theme setting
  • Changed: Admin menu icons now uses SVG instead of custom font icon
  • Changed: Reviewed all translatable strings, improved escaping and formatting
  • Changed: External links have rel="noopener noreferrer" improve security
  • Changed: Permission check centralized into a single function (wpforms_current_user_can())
  • Changed: Required label field text centralized into a single function (wpforms_get_required_label())
  • Changed: Improved list of Countries
  • Fixed: Conditional logic mismatches due to sanitizing values
  • Fixed: Typo in German translation
  • Fixed: Improved i18n for countries
  • Fixed: Required email provider connection fields not highlighting when left empty
  • Fixed: Inside form builder, notification name area breaking into multiple lines on smaller screens
  • Fixed: Total field not updating correctly when multiple forms are on the same page

1.4.3 (2017-12-04)

  • Added: Form entry field values are now stored (additionally) in a new database, wpforms_entry_fields, to be used with exciting new features in the near future
  • Added: Upgrade routine for the above mentioned new database
  • Added: Early filter for form data before form output, wpforms_frontend_form_data
  • Added: Setting to hide Announcement feed
  • Added: Announcement feed data
  • Changed: Standardize and tweak modal window button styles
  • Changed: Default mail notification settings are now sent "from" the site administrator email; user email is used in Reply-To where applicable (to hopefully improve email deliverability)
  • Changed: Removed "Hide form name and description" form setting as it was a common source or confusion
  • Changed: Provide base styling for hr elements inside HTML fields
  • Fixed: Site cache being flushed when it shouldnt have been, affecting performance in some scenarios
  • Fixed: Country, state, months and days not properly exposed to i18n
  • Fixed: CSV export dates not properly using i18n
  • Fixed: Incorrect usage of esc_sql with `wpdb->prepare`
  • Fixed: Styling preventing the entries column picker from displaying correctly
  • Fixed: WPForms custom post types omitting labels
  • Fixed: Smart Tag value encoding issues with email notifications
  • Fixed: Infinite recursion issue when using Dynamic Values option
  • Fixed: PHP notice in form builder

1.4.2 (2017-10-25)

  • Added: Import your old Ninja Forms or Contact Form 7 forms! (WPForms > Tools > Import)
  • Changed: Date i18n improvements
  • Changed: Dropdown/Checkbox/Multiple Choice "Show Values" setting has been hidden by default to avoid confusion, can be re-enabled using the wpforms_fields_show_options_setting filter
  • Changed: Date Time field inputs break into separate lines on mobile to prevent Date picker from going off screen in some scenarios
  • Fixed: reCAPTCHA now showing in the Form Builder preview when enabled
  • Fixed: Encoded/escaped entities in email notifications
  • Fixed: German translation issue (2017-10-03)

  • Fixed: New CSV separator filter introduced 1.4.1 not correctly running (2017-09-29)

  • Changed: Improved the loading order of javascript files for forms builder
  • Changed: Update some strings for Russian translation
  • Fixed: Entries export functionality was broken
  • Fixed: Multipage indicators behavior when several multipage forms present on the same page

1.4.1 (2017-09-27)

  • Added: Ability to rename Form >Settings>Notifications>Single notification panels
  • Added: Define a minimum PHP version support in plugin readme.txt file
  • Added: Display a friendly link to a full page version, when form is previewed on AMP pages
  • Added: Ability to collapse Form>Settings>Notifications>Single notification panels
  • Added: Russian translation
  • Added: Allow more than 1 default selection for checkboxes fields
  • Changed: Bump minimum WordPress version to 4.6
  • Changed: Improved localization support of the plugin
  • Changed: Improved texts in various places
  • Changed: Code style improvements throughout the plugin
  • Changed: Combine WPFORMS_DEBUG and WPFORMS_DEVELOPMENT into one, use wpforms_debug() to check
  • Changed: All HTTP requests now validate target sites SSL certificates with WP bundled certificates (since 3.7)
  • Fixed: Payments and providers classes version visibility
  • Fixed: Postal field (part of Address field) now supports the {query_var} smart tag
  • Fixed: Form's Entries page unread/read and starred/unstarred counters
  • Fixed: Incomplete selection of Date dropdown fields causes entries to be recorded as "Array"
  • Fixed: Notification email is empty if submitted form has no user values (displaying user friendly message instead)
  • Fixed: Pressing enter in "Enter a notification name" popup does nothing
  • Fixed: Removed Screen Options on single entry screen
  • Fixed: Allow postal code to be hidden/removed, fix Country issues
  • Fixed: Country names don't have redundant ) or spaces anymore
  • Fixed: Do not display 2400 option in TimePicker in Date / Time field for 24h format
  • Fixed: Deprecate a misspelled `wpforms_csv_export_seperator` filter, introduced a proper name for it
  • Fixed: Conditional logic comparison issues if rule contained special characters (2017-08-24)

  • Added: Non-dismissible Dashboard page admin only notice about PHP 5.2
  • Changed: Updated FontAwesome library
  • Fixed: Fatal error with PHP 5.2 due to an anonymous function
  • Fixed: Required Credit Card fields incorrectly passing JS validation if empty
  • Fixed: CSV exports missing line breaks
  • Fixed: Entries dropdown menu being cut off under the WordPress menu

1.4.0 (2017-08-21)

  • Added: Entries table columns can now be customized; personalize what fields you want to see!
  • Added: All entries can be deleted for a form from the Entries page
  • Changed: Phone number field switched to `tel` input for improved mobile experience
  • Changed: Core form templates are now displayed separate in the form builder from other custom templates
  • Changed: Refactored CSV exporting for better support
  • Fixed: Dynamic Choices large items modal render issue
  • Fixed: Certain characters (such as comma) breaking CSV export format
  • Fixed: Cursor issues inside the form builder
  • Fixed: CSS Layout Generator class name typo
  • Fixed: Dynamic choices with nesting sometimes causing form builder to time out
  • Fixed: Settings page typos
  • Fixed: Deleting a form in some cases did not remove entry meta for its entries
  • Fixed: File Uploads stored in the media library not storing the correct URL when offloaded to other services such as S3
  • Fixed: Tools page export description text typo
  • Fixed: Widget state not displayed correctly when adding via Customizer, without forcing user to select a form (2017-08-03)

  • Fixed: Currency setting for new users saving to an incorrect option key (2017-08-02)

  • Changed: Template Export excludes array items with empty strings
  • Fixed: Admin notices displaying on plugin Welcome/activation screen
  • Fixed: WPForms admin pages displaying blank due to conflicts with a few other plugins
  • Fixed: License related notices not removed immediately after key is activated
  • Fixed: Addons page items not displaying with uniform height
  • Fixed: Addons page installing returned JS object instead of message

1.3.9 (2017-08-01)

  • Added: Complete redesign and refactor of admin area
  • Added: New Settings API
  • Added: Entry print preview compact mode
  • Added: Entry print preview view entry notes
  • Added: Dynamic field choices nest hierarchical items
  • Changed: Moved Import/Export and System Info content to new Tools sub-page
  • Changed: Shortcode provided in form builder now includes title/description arguments
  • Changed: Don't show CSS layout selector helper in Pagebreak fields
  • Fixed: Form builder URL redirect issue on the Marketing tab with some configurations
  • Fixed: Password field item mislabeled
  • Fixed: PHP notices on Entries page if form contained no fields
  • Fixed: PHP notices when using HTML field with conditional logic

1.3.8 (2017-06-13)

  • Added: Conditional logic functionality is now in the core plugin - the Conditional Logic addon can be removed
  • Added: New conditional logic rules: empty and not empty
  • Added: Conditional logic can now be applied to fields that are marked as required
  • Changed: Available conditional logic rules/functionality with Providers have been updated
  • Changed: Updated form builder modals (jquery-confirm.js)
  • Changed: Many Form Builder performance enhancements
  • Fixed: Allowing Storing entries form setting to be enabled when form is connected to payments
  • Fixed: Number field validation message not saving
  • Fixed: Email/Password confirmation setting not displaying correctly with Small field size (2017-05-17)

  • Fixed: Required setting checkbox getting out of sync when duplicating fields
  • Fixed: CSS class name typo in the form builder layout selector
  • Fixed: Excel mangling non-english characters when opening CSV export files
  • Fixed: Smart Tag `field_id` stripping line breaks
  • Fixed: Multiple Items field choices not updating correctly in form builder preview
  • Fixed: Form JS settings `wpforms_settings` missing due to some caching plugins
  • Fixed: Empty classes causing `array` string to be printed in some use cases
  • Changed: Updated credit card, page break, password, and phone fields to improved field class. (2017-04-26)

  • Fixed: PHP warning when displaying page break indicator at the top of a form
  • Fixed: Error for some users with PHP 5.4 and below (2017-04-26)

  • Fixed: Issue sending form notifications using email fields that had confirmation enabled

1.3.7 (2017-04-26)

  • Added: Google Invisible reCAPTCHA support
  • Added: Custom field validation messages (see WPForms Settings page)
  • Added: Bulk add choices for Checkbox, Multiple Choice, and Dropdown fields
  • Added: Filter to allow email notifications to include empty fields, wpforms_email_display_empty_fields
  • Added: Custom form template exporting
  • Added: Field CSS layout selector
  • Added: Total payment fields can now be marked as required, preventing the field from submitting unless it contains a payment
  • Changed: HTML fields now allow and run WordPress shortcodes
  • Changed: Leverage wp_json_encode instead of native PHP function
  • Changed: Various WordPress coding standard improvements (work in progress)
  • Changed: Refactored form front-end code to allow for more customizations
  • Changed: Refactored text, textarea, email, number, name, divider, file upload, hidden, html, payment total, and URL fields to allow for more customizations (more coming next release)
  • Fixed: Welcome page typo
  • Fixed: Address field options getting off sync inside form builder
  • Fixed: Bug adding new notifications and element IDs not updating
  • Fixed: Page indicator (navigation) overflowing in some use cases
  • Fixed: SmartTag selectors getting off sync inside form builder
  • Fixed: File upload routine using pathinfo which is not reliable with some locales

1.3.6 (2017-03-09)

  • Added: Constant Contact integration
  • Changed: Don't strip tags from plain text emails
  • Fixed: Address field variable name typo
  • Fixed: Form builder javascript conflict with Clef plugin
  • Fixed: Form builder logo URL double slash
  • Fixed: Form builder embed code field not being selectable

1.3.5 (2017-02-23)

  • Fixed: Some browers allowing unexpected characters inside number input fields
  • Fixed: Error when resending email notifications through Single Entry page
  • Fixed: Issue with Dropdown field placeholder text
  • Fixed: Select few plugins loading conflicting scripts in form builder

1.3.4 (2017-02-09)

  • Added: reCAPTCHA improvements; reCAPTCHA now required if turned on
  • Fixed: Date/Time Smart Tag not using WordPress time zone settings
  • Fixed: Name field defaults not processing Smart Tags

1.3.3 (2017-02-01)

  • Added: Default value support in the email field
  • Added: Related Entries metabox on single entry page
  • Added: Various new hooks and filters for improved extendibility
  • Changed: Payment status is now displayed in status column, indicated with money icon
  • Changed: Multi-page scroll can be customized via JS overrides, wpform_pageScroll
  • Fixed: Possible errors if web host had set_time_limit() disabled
  • Fixed: File upload failing in edge cases due to library not being loaded
  • Fixed: PHP 7.1 warning message inside the form builder when using payments

1.3.2 (2017-01-17)

  • Added: CSS class support for hidden fields, for easier targeting
  • Added: WP.org review request
  • Added: New form class, .inline-fields, to apply single line form layout
  • Added: Allow date and time pickers properties to be specified on a per form/field basis
  • Changed: All Smart Tags now available for Email Subject field in form notifications
  • Changed: License checks rely on options, instead of transients, for more reliability
  • Changed: Enable date picker on mobile devices
  • Fixed: Email addresses reporting as invalid of the domain contained capitalization
  • Fixed: Error uploading MP3 files when File upload was using the media library
  • Fixed: Author related Smart Tags not working in form notification fields
  • Fixed: Typo on settings page related to Carbon Copy
  • Fixed: Incorrect messaging/layout on plugins addon page for Basic license users
  • Fixed: Date Time field date picker causing validation issues for mobile users
  • Fixed: PHP 7.1 warning messages inside the form builder (2016-12-12)

  • Fixed: Plugin name to correctly indicate Lite for Lite release (2016-12-12)

  • Fixed: Error with 1.3.1 Lite release

1.3.1 (2016-12-08)

  • Added: Dropdown Items payment field
  • Added: Smart Tags for author ID, email, and name
  • Added: Carbon Copy (CC) support for form notifications; enable in WPForms Settings
  • Changed: Form data and fields publicly accessible in email class
  • Fixed: Field duplication issues
  • Fixed: Total payment field error when only using Multiple Items payment field
  • Fixed: TinyMCE "Add Form" button not opening modal with dynamic TinyMCE instances
  • Fixed: Email formatting issues when using plain text formatting
  • Fixed: Number field validation tripping when number submitted is zero
  • Fixed: reCAPTCHA validation passing when reCAPTCHA left blank
  • Fixed: Dropdown field size not reflecting in builder
  • Fixed: File Upload field offering Size option but not supported (option removed)
  • Fixed: File uploads configured to go to the media library not working
  • Fixed: Server-side file upload errors not displaying correct due to a type (2016-11-10)

  • Added: Context usage param to wpforms_html_field_value filter
  • Added: New filter, wpforms_plaintext_field_value, for plaintext email values
  • Fixed: Bug with date picker limiting date selection to current year
  • Fixed: PHP notice when uploading non-media library files
  • Fixed: Issue with form title/description being toggled with shortcode
  • Fixed: Secured target=_blank usage

1.3.0 (2016-10-24)

  • Added: Email field confirmantion
  • Added: Password field confirmation
  • Added: Support for Visual Composer
  • Added: Additional date field types (datepicker or dropdowns)
  • Added: Field class to force elements to full-width on mobile devices, wpforms-mobile-full
  • Changed: Datepicker library
  • Changed: Timepicker library
  • Changed: Placeholders are added/updated in real-time for Dropdown fields in the form builder
  • Changed: Add empty value to select element placeholders when displaying form for better markup validation
  • Fixed: Multiple instances of reCAPTCHA on a page not correctly loading
  • Fixed: Field choice defaults not restoring in form builder
  • Fixed: Field alignment issues in the form builder when dragging field more than once
  • Fixed: PHP fatal erroring if form notification email address provided is not valid upon sending
  • Fixed: Date field Datepicker allows empty submit when marked as required
  • Fixed: Compatibility issuses when network activated on a Multisite install (2016-10-07)

  • Fixed: Compatibility issue with Stripe addon

1.2.9 (2016-10-04)

  • Added: Individual fields can be duplicated in the form builder
  • Changed: How data is stored for fields using Dynanic Choices
  • Changed: File Upload contents can (optionally) be stored in the WordPress media library
  • Fixed: CSV exports not handling new lines well
  • Fixed: Global assets setting causing errors in some cases
  • Fixed: Writing setting ("correct invalidly nested XHTML") breaking forms containing HTML
  • Fixed: Forms being displayed/included on the native WordPress Export page
  • Fixed: Dynamic Choices erroring when used with Post Types
  • Fixed: Form labels including blank IDs (2016-09-19)

  • Fixed: Form javascript email validation being too strict (introducted in 1.2.8)
  • Fixed: Provider sub-group IDs not correctly stored with connection information

1.2.8 (2016-09-15)

  • Added: Dynamic choice feature for Dropdown, Multiple Choice, and Checkbox fields
  • Changed: Loading order of templates and field classes - moved to init
  • Changed: Form javascript email validation requires domain TLD to pass
  • Changed: File Upload file size setting now allows non-whole numbers, eg 0.5
  • Fixed: HTML email notification templates uses site locale text-direction
  • Fixed: Javascript in the form builder conflicting with certain locales
  • Fixed: Datepicker overflowing off screen on small devices

1.2.7 (2016-08-31)

  • Added: Store intial plugin activation date
  • Added: Input mask for US zip code within Address field, supports both 5 and 9 digit formats
  • Added: Duplicate form submit protection
  • Changed: Entry dates includes GMT offset defined in WordPress settings
  • Changed: Entry export now includes both local and GMT dates
  • Changed: Improved Address field to allow for new schemes/formats to be create and better customizations
  • Fixed: Provider conditonal logic processing when using checkbox field
  • Fixed: Strip slashes from entry data before processing
  • Fixed: Single Item field price not live updating inside form builder

1.2.6 (2016-08-24)

  • Added: Expanded support for additional currencies
  • Added: Display payment status and total column on entry list screen as allow sorting with these new columns
  • Added: Display payment details on single entry screen
  • Added: Miscellaneous internal improvements
  • Changed: Added month/year selector to date picker for better accessibility
  • Changed: Payment validation methods
  • Fixed: Incorrectly named variables in the front-end javascript preventing features from properly being extendable

1.2.5 (2016-08-03)

  • Added: Setting for Email template background color
  • Added: Form setting for form wrapper CSS class
  • Changed: Multiple Payment field stores Choice label text
  • Changed: reCAPTCHA tweaks and added filter
  • Changed: Improved IP detection
  • Fixed: Mapped select fields in builder triggering JS error

1.2.4 (2016-07-07)

  • Added: Form import and exporting
  • Added: Additional logging and error reporting
  • Changed: Footer asset detection priority, for improved capatibility with other services
  • Changed: Refactored and refined front-end javascript
  • Fixed: Restored form notification defaults for Blank template
  • Fixed: Default field validation considered 0 value as empty
  • Fixed: Rogue PHP notices

1.2.3 (2016-06-23)

  • Added: Multiple form notifications capability
  • Added: Form notification message setting
  • Added: Form notification conditional logic (via add-on)
  • Added: Additional Smart Tags available inside Form Settings panels
  • Added: Process Smart Tags inside form confirmation messages and URLs
  • Added: Hide WPForms Preview page from WordPress dashboard
  • Added: System Details tab to WPForms Settings, to display debug information, etc
  • Changed: Center align text inside page break navigation buttons
  • Changed: Scroll to top most validation error when using form pagination
  • Changed: Many form builder javascript improvements
  • Changed: Improved internal logging and debugging tools
  • Changed: Don't show Page Break fields in Entry Tables
  • Fixed: Form select inside modal window overflowing when a form exists with a long title
  • Fixed: Large forms not always saving because of max_input_vars PHP setting
  • Fixed: Entry Read/Unread count incorrect after AJAX toggle
  • Fixed: Single Payment field failed validation if configured for user input and amount contained a comma (2016-06-03)

  • Fixed: Entry ID not always correctly passing to hooks

1.2.2 (2016-06-03)

  • Added: Page Break navigation buttons now have an alignment setting
  • Added: Page Break previous navigation button is togglable and defaults to off
  • Changed: Improved styling of Page Break fields in the builder
  • Changed: Choice Layouts now use flexbox instead of CSS columns for better rendering
  • Fixed: Class name typo in a CSS column class introduced with 1.2.1
  • Fixed: PHP notice on Entries page when there are no forms

1.2.1 (2016-05-30)

  • Added: Drag and drop field buttons - simply drag the desired field to the form!
  • Added: Page Break progress indicator themes, with optional page titles
  • Added: Choice Layout option for Checkboxes and Multiple Choice fields (under Advanced Options)
  • Added: Full and expanded column class/grid support
  • Changed: Refactored Page Break field, fully backwards compatible with previous version
  • Changed: Page Break navigation buttons with without a label do not display
  • Changed: Refactored CSS column classes, previous classes are deprecated
  • Changed: Improved field and column gutter consistency
  • Fixed: Form ending with column classes not closing correctly
  • Fixed: reCAPTCHA button overlaying submit button preventing it from being clicked

1.2 (2016-05-19)

  • Fixed: Removed nonce verification
  • Fixed: Issue with Address fields not processing correctly when using international format
  • Added: Column classes for Checkbox and Multiple choice inputs
  • Changed: Improved file upload text format inside entry tables (2016-05-06)

  • Fixed: Payment calculations incorrect with large values

1.1.9 (2016-05-06)

  • Added: Form preview
  • Added: Form general setting to disable saving entries
  • Changed: reCAPTCHA settings description to include link to how-to article
  • Changed: Some fields did not have the correct (unique) CSS ID, this has been corrected, which means custom styling may need to be adjusted
  • Changed: Form notification settings hide if set to Off
  • Fixed: Issue with submit button position when form ends with columns classes
  • Fixed: PHP warnings inside the form builder

1.1.8 (2016-04-29)

  • Added: "WPForm" to new-content admin bar menu item
  • Changed: Removed "New" field name prefix
  • Changed: Moved email related settings into email settings group
  • Fixed: Incorrect i18n strings
  • Fixed: Load order causing add-on update conflicts

1.1.7 (2016-04-26)

  • Added: Smart Tag for Dropdown/Multiple choice raw values, allowing for conditional email addres notifications (link)
  • Added: HTML/Code field Conditional Logic support
  • Added: HTML/Code field CSS class support
  • Added: Three column CSS field classes (link)
  • Added: Support for WordPress Zero Spam plugin (link)
  • Changed: Checkbox/Multiple Choice fields allow certain HTML to display in choice labels
  • Fixed: Issue when stacking fields with 2 column classes

1.1.6 (2016-04-22)

  • Added: Entry starring
  • Added: Entry read/unread tracking
  • Added: Entry filtering by stars/read state
  • Added: Entry notes
  • Added: Entry exports (CSV) for all entries in a form
  • Changed: Improved entries table overview page
  • Changed: Email Header Image setting description to include recommended sizing
  • Fixed: reCAPTCHA cutting off with full form theme
  • Fixed: Debug output from wpforms.js
  • Fixed: Conflict between confirmation action and filter

1.1.5 (2016-04-15)

  • Added: Print entry for single entries
  • Added: Export (CSV) for single entries
  • Added: Resend notifications for single entries
  • Added: Store user ID, IP address, and user agent for entries
  • Changed: Improved single entry page (more improvements soon!)
  • Changed: HTML Email template footer text appearance
  • Fixed: Form builder textareas not displaying full width
  • Fixed: HTML emails not displaying correctly in Thunderbird

1.1.4 (2016-04-12)

  • Added: Form general setting for "Submit Button CSS Class"
  • Added: Duplicate forms from the Forms Overview page (All Forms)
  • Added: Suggestion form template
  • Changed: Improved error logging for providers, now writes to CPT error log
  • Changed: Adjusted field display inside the Form Builder to better resemble full theme
  • Fixed: Firefox CSS issue in form base theme
  • Fixed: Don't allow inserting shortcode via modal if there are no forms
  • Fixed: Issue limiting Total field display amount

1.1.3 (2016-04-06)

  • Added: New class that handles sending/processing emails
  • Added: Form notification setting for "From Address", defaults to site administrator's email address
  • Added: HTML email template for sleek emails (enabled by default, see more below)
  • Added: General setting to configure email notification format
  • Added: General setting to optionally configure email notification header image
  • Changed: Default email notification format is now HTML, can go back to plain text format via option on WPForms > Settings page
  • Changed: File Upload field now saves original file name
  • Changed: Empty fields are no longer included in email notifications
  • Fixed: Various issues with File Upload field in different configurations
  • Fixed: Address field saving select values when empty
  • Fixed: Issue with Checkbox field when empty

1.1.2 (2016-04-01)

  • Added: Form option to scroll page to form after submit, defaults on for new forms
  • Changed: Revamped "Full" form theme to be more consistent across different themes, browsers, and devices
  • Changed: Full theme and bare theme separated
  • Fixed: File upload required message when not set to required

1.1.1 (2016-03-29)

  • Fixed: Settings page typo
  • Fixed: Providers issue causing AJAX to fail

1.1.0 (2016-03-28)

  • Added: Credit Card payment field
  • Changed: CSS updates to improve compatiblity
  • Fixed: PHP notices when saving plugin Settings

1.0.9 (2016-03-26)

  • Changed: Email field defaulting to Required

1.0.8 (2016-03-24)

  • Fixed: Name field setting always showing Required
  • Fixed: Debug function incorrectly requiring WP_DEBUG

1.0.7 (2016-03-22)

  • Changed: CSS tweaks
  • Fixed: Issue with File Upload field returning incorrect file URL
  • Fixed: Filter (wpforms_manage_cap) incorrectly named in some instances

1.0.6 (2016-03-21)

  • Added: Embed button inside the Form Builder
  • Added: Basic two column CSS class support
  • Added: French translation
  • Changed: Form names are no longer required, if no form name is provided the template name is used
  • Changed: Inputmask script, for better broad device support
  • Changed: Field specific assets are now conditionally loaded
  • Changed: CSS tweaks for form display
  • Fixed: Issue with Date/Time field
  • Fixed: Issue Address field preventing Country select from hiding in some configurations
  • Fixed: Localization string errors

1.0.5 (2016-03-18)

  • Added: Pagination for Entries table
  • Changed: Checkboxes/Dropdown/Multiple Choice fields always show choice label value in e-mail notifications
  • Fixed: PHP notices inside the Form Builder
  • Fixed: Typo inside Form Builder tooltip (2016-03-17)

  • Added: Check for TinyMCE in the builder before triggering TinyMCE save
  • Fixed: Sub labels showing when configured to hide
  • Fixed: Forms pagination number screen setting not saving
  • Fixed: Email notification setting always displaying "On"

1.0.4 (2016-03-16)

  • Changed: Improved marketing provider conditional logic
  • Changed: Addons page [Lite]
  • Fixed: Variable assignment in the builder

1.0.3 (2016-03-15)

  • Added: Basic TinyMCE editor for form confirmation messages
  • Changed: Removed form ID from form overview table, ID still visible in shortcode column
  • Fixed: Checkbox/radio form elements alignment
  • Fixed: Quotation slashes in email notification text
  • Fixed: SSL verification preventing proper API calls on some servers

1.0.2 (2016-03-13)

  • Added: Widget to display form
  • Added: Function to display form, wpforms_display( $form_id )
  • Changed: Default notification settings for Contact form template
  • Changed: Success message styling for full form theme

1.0.1 (2016-03-12)

  • Added: "From Name" and "Reply To" Setting>Notification fields
  • Added: Smart Tags feature to all Setting>Notification fields

1.0.0 (2016-03-11)

  • Initial release.