This repository has been archived by the owner on Dec 15, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
executable file
·95 lines (66 loc) · 4.8 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
=== Plugin Name ===
Contributors: aurovrata
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=64EDYAVB7EGTJ
Tags: multislide, slide form, contact form 7, contact form 7 extension, contact form 7 module
Requires at least: 3.0.1
Tested up to: 4.7
Stable tag: 1.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
This plugin enables creation of multi-slide forms using the contact form 7 plugin.
== Description ==
This plugin is an extension (module) for Contact Form 7 plugin. It allows users to develop multislide
forms, one cf7 form on each slide. However, a single mail with all the combined slide-forms entry
is sent upon successful submission of the last slide-form.
= Checkout our other CF7 plugin extensions =
* [CF7 Polylang Module](https://wordpress.org/plugins/cf7-polylang/) - this plugin allows you to create forms in different languages for a multi-language website. The plugin requires the [Polylang](https://wordpress.org/plugins/polylang/) plugin to be installed in order to manage translations.
* [CF7 Multi-slide Module](https://wordpress.org/plugins/cf7-multislide/) - this plugin allows you to build a multi-step form using a slider. Each slide has cf7 form which are linked together and submitted as a single form.
* [Post My CF7 Form](https://wordpress.org/plugins/post-my-contact-form-7/) - this plugin allows you to save you cf7 form submissions to a custom post, map your fields to meta fields or taxonomy. It also allows you to pre-fill fields before your form is displayed.
== Installation ==
1. Unpack `cf7-multislide.zip` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Create a new form in the CF7 editor. Select the [multislide] tag, and place it at the end of your form. Define the number of total slides as well as the current slide. So if you plan on having 3 slides, you need to create 3 cf7 forms. The first form (show on the first slide) will have slide number = 1 and total slides = 3. In the 2nd cf7 form you will need to add a new [multislide] tag, this time the slide number = 2 and total slides = 3 and so on.
4. In your last form, you can use the previous slide-forms fields in your mail settings. Note, CF7 plugin may complain that these don't exist. Ignore these messages.
== Frequently Asked Questions ==
= What slider should I use? =
Any slider should be compatible, use whichever is your favourite slider plugin for build your own.
= How do I make the slider change to the next slide upon successful form submission? =
Contact Form 7 allows you to add javascript command to be executed upon successful form submission.
Use this functionality to execute the slide-change command automatically. You need to add your code to the
Additional Settings tab of your newly created form. Here is the [CF7 documentation](http://contactform7.com/additional-settings/) for this.
You need to use the,
`on_sent_ok: "alert('form sent!');"`
format. You can use jQuery's [`trigger`]() function to trigger the slider click event. most
slider plugins will create navigation buttons to change to the next slide, these are triggered
with a click of the mouse. Inspect your button element, and copy the css selector to uniquely identify
this button, then add it to your form Additional Settings section as,
`on_sent_ok: "jQuery('#my-home-page-slider .next .nav-container').trigger('click')";`
where `#my-home-page-slider .next .nav-container` would uniquely identify your slider element to trigger
a mouse click event.
== Screenshots ==
1. A new `[multislide]` tag is added to your CF7 form options. Ideally place it at
the end of the form.
2. Define the current slide and the total number of slides.
== Changelog ==
= 1.1.1 =
* fixed a bug which checked for security nonce on all cf7 forms, including those not using multislide tags
= 1.1 =
* updated to reflect changes in Contact Form 7 v4.6
* fixed jquery bug in tag generator
= 1.0 =
* first version, only in english locale
== Final slide-form data ==
This plugin merges all slides form data into a single list of submitted data. It
does this my storing intermediate slides data as transients. When the final slide form
is submitted, it merges all submitted data sets into a single one, allowing the CF7
plugin to find all the field tags described in the various slide forms.
Before this final merged data-set is submitted to the CF7 plugin, it applies the following
filer `cf7_mulstislide_merged_posted_data`. You can use this filter to further interact with
the final data-set before it is being sent by email using,
`add_filter('cf7_mulstislide_merged_posted_data','filter_the_final_data')
function filter_the_final_data($posted_data){
//do somethinn here with the array of <tag_name>=><value> pairs
return $posted_data;
}
`
hope you find this plugin useful.