Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rrze-webteam/cf7-conditional-fields


https://github.com/rrze-webteam/cf7-conditional-fields

Last synced: 2 days ago
JSON representation

Awesome Lists containing this project

README 

        
=== Conditional Fields for Contact Form 7 ===

Contributors: Jules Colle

Donate link: https://shop.bdwm.be/contact-form-7-conditional-fields-pro/

Author: Jules Colle

Website: http://bdwm.be

Tags: contact form 7, forms, form, conditional fields, conditional logic

Requires at least: 5.0

Tested up to: 6.6

Stable tag: 2.5.1

Requires PHP: 7.0

License: GPLv2 or later

License URI: http://www.gnu.org/licenses/gpl-2.0.html



Adds conditional logic to Contact Form 7.



== Description ==



This plugin adds conditional logic to [Contact Form 7](https://wordpress.org/plugins/contact-form-7/).



If you edit your CF7 form, you will see an additional tag called "Conditional fields Group". Everything you put between the start and end tag will be hidden by default.

After you have added the field group(s), go to the "Conditional fields" tab to create one or more conditions that will make the group(s) appear.



= How to use it =



[Follow this tutorial](https://conditional-fields-cf7.bdwm.be/conditional-fields-for-contact-form-7-tutorial/)



== Main features ==



= Support for required fields =



Required fields inside hidden groups will never trigger validation errors.



= Hide/show info in emails based on what groups are visible =



Conditional groups can now be added to the emails as well.

Just wrap the content with `[group-name] ... [/group-name]` tags.



= Groups can be nested =

Groups can be nested, both in the form and in the email



Example form:

`

[group group-1]

  [group group-inside-1]

    ...

  [/group]

[/group]`



Example email:

`

[group-1]

  [group-inside-1]

    ...

  [/group-inside-1]

[/group-1]`



= Advanced =



Advanced users can code up the conditions as plain text instead of using the select boxes, using the Text View.



== Need more power? ==



Just like WordPress, the power of Contact Form 7 lies in its [rich eco-system of extensions](https://conditional-fields-cf7.bdwm.be/list-of-all-contact-form-7-extensions/) that build on top of it. However, it can be difficult to find a set of complex extensions that work well together.



That's why I created Conditional Fields Pro. It adds some powerful features to Contact form 7 and guarantees that everything will run smoothly with Conditional Fields.



Pro features include:



* Repeatable fields (repeaters)

* Forms with multiple steps (multistep)

* Custom conditions with JavaScript functions

* Additional operators ( greater than, less than, .. )



[Get the PRO version of Conditional Fields for Contact Form 7!](https://conditional-fields-cf7.bdwm.be/contact-form-7-conditional-fields-pro/)



== Installation ==



Please follow the [standard installation procedure for WordPress plugins](http://codex.wordpress.org/Managing_Plugins#Installing_Plugins).



Follow [this tutorial](https://conditional-fields-cf7.bdwm.be/conditional-fields-for-contact-form-7-tutorial/) if you are not sure how to use the plugin.



== Frequently Asked Questions ==



= Email message is not showing the correct values / Wrong values are submitted =



All field names should be unique



Even though your fields might never show up at the same time, it is still important to realize that WPCF7CF will not remove the fields, it merely hides them. So all fields will be submitted when the form is sent. Because of this no two fields can have the same name.



Incorrect form (2 input elements having the same name "a"):

`

[group group-1][select a "1" "2" "3"][/group]

[group group-2][select a "1" "2" "3"][/group]

`



Correct form (all groups and fields have unique names):

`

[group group-1][select a "1" "2" "3"][/group]

[group group-2][select b "1" "2" "3"][/group]

`



= All my groups show up all the time and never get hidden. =



Reason #1: Javascript error

Check your browser console (F12) for any javascript errors. WPCF7CF loads it's scripts at the bottom of the HTML page, so if some javascript error gets triggered before that, the code will not be executed in most browsers.

Before reaching out to the support forum try to determine which plugin or theme is causing the problem, by gradually disabling plugins and changing theme.



Reason #2: wp_footer() isn't loaded

Check if your theme is calling the `wp_footer()` function. Typically this function will be called in your theme's footer.php file.

The conditional fields javascript code is loaded during wp_footer, so a call to this function is crucial. If there is no such call in your theme, go to your theme's footer.php file and add this code right before the closing `