-
Notifications
You must be signed in to change notification settings - Fork 9
/
readme.txt
282 lines (161 loc) · 7.58 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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
=== CF7 to Webhook ===
Contributors: mariovalney
Donate link: https://www.paypal.com/donate?campaign_id=9AA82JCSNWNFS
Tags: cf7, contact form, zapier, integration, contact form 7, webhook, mariovalney
Requires at least: 4.7
Tested up to: 6.4
Stable tag: trunk
Requires PHP: 7.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Use Contact Form 7 as a trigger to any webhook!
== Description ==
[Contact Form 7 (CF7)](https://wordpress.org/plugins/contact-form-7/ "Install it first, of course") is a awesome plugin used by 1+ million WordPress websites.
Webhooks are endpoint (urls) you can send data!
Now you can join both: the best contact form plugin to WordPress and any webhook which receive JSON!
And Zapier?
[Zapier (Zapier)](https://zapier.com) is a awesome service to connect your apps and automate workflows!
Just activate and configure Zapier to receive data!
Disclaimer: this plugin was created without any encouragement from Zapier or CF7 developers and any webhook/API service.
= How to Use =
Easily and quickly! Just activate "Contact Form 7" and "CF7 to Webhook" and configure a URL to send data (or go to Zapier to create your Zap).
= Configuration =
This is a example to integrate with Zapier:
1. Create a Zap.
1. Choose your trigger as "Webhooks" app (Screenshot 2).
1. Choose "Catch Hook" option (Screenshot 3).
1. Done! Now insert the URL given (Screenshot 4) into your Contact Form configuration and activate integration.
= Creating your workflow =
After configuration you can send one form to create a example data into Zapier dashboard. Then you can continue creating your workflow with filters and other apps.
= Translations =
You can [translate CF7 to Webhook](https://translate.wordpress.org/projects/wp-plugins/cf7-to-zapier) to your language.
= Review =
We would be grateful for a [review here](https://wordpress.org/support/plugin/cf7-to-zapier/reviews/).
= Support =
* Contact Form 7 - 5.9.X
== Installation ==
`Install [Contact Form 7](https://wordpress.org/plugins/contact-form-7/) and activate it.`
* Install "CF7 to Webhook" by plugins dashboard.
Or
* Upload the entire `cf7-to-zapier` folder to the `/wp-content/plugins/` directory.
Then
* Activate the plugin through the 'Plugins' menu in WordPress.
You will find 'Zapier' tab into form configuration.
== Frequently Asked Questions ==
= Did you renamed the plugin? =
Yes. Due to [this](https://make.wordpress.org/plugins/2019/08/08/trademark-enforcement/).
= Does it works with Gutenberg? =
Yes. We support WordPress 5+ and CF7 too.
= Does it works for forms sent out of CF7? =
Nope. The intention here is to integrate CF7 to Zapier (and another webhooks).
= Can I use it without Zapier? =
Yep. We are creating a integration to Zapier webhook, but you can insert any URL to receive a JSON formated data.
= My sent data is empty =
Please, go to [support forum](https://wordpress.org/support/plugin/cf7-to-zapier/) to get help.
= How can I submit one form to multiple webhooks? =
Just add one webhook per line in "Webhook URL" settings.
Please, read [this topic](https://wordpress.org/support/topic/make-multiple-webhooks-optionals/) for more information.
= How can I show webhook errors on form submit? =
We already show WordPress request errors. If you want to add theatment to webhook errors, please [check this post](https://wordpress.org/support/topic/form-sent-to-zapier-randomly/#post-11249864).
= How can I upload files and send link to webhook? =
If you send a form with file, we will copy this to a directory before CF7 remove it and send the link to Zapier.
= How can I rename a field to webhook? =
You can add a "webhook" option to your field on form edit tab.
It's like the "class" option: `[text your-field class:form-control id:field-id webhook:webhook-key]`.
This will create a text field with name "your-field", class "form-control", id "field-id" and will be sent to webhook with key "webhook-key".
= How I can get the free text value? =
We will replace the value for last option (which is the free_text input) with the value.
This way your webhook will receive the free text value and other options if you allow it (like in checkbox).
= Who is the developer? =
[Mário Valney](https://mariovalney.com/me)
Brazilian developer who is part of [WordPress community](https://profiles.wordpress.org/mariovalney).
= Can I help you? =
Yes! Visit [GitHub repository](https://github.com/mariovalney/cf7-to-zapier) or [make a donation](https://www.paypal.com/donate?campaign_id=9AA82JCSNWNFS).
== Screenshots ==
1. CF7 to Webhook configuration
2. Zapier Step 1 - Choosing you app trigger
3. Zapier Step 2 - Choosing Catch Hook option
4. Zapier Step 3 - Webhook URL (waiting for first data)
== Changelog ==
= 3.0.2 =
* Avoid empty webhook URLs.
= 3.0.1 =
* Just some docs and donate link.
* Added 'ctz_remove_donation_alert' filter to remove donate link.
= 3.0.0 =
* New feature: placeholders in webhook URL [read more](https://wordpress.org/support/topic/use-webhook-url-placeholders).
* Added 'ctz_hook_url_placeholder' filter.
* Tested against new CF7 and WP versions.
= 2.4.0 =
* Added support to "_raw_" values (label value in [PIPES](https://contactform7.com/selectable-recipient-with-pipes/)).
* Added support to multiple webhook URLs.
* Added 'ctz_trigger_webhook_errors' action to allow trigger submission error after ignoring them.
* Tested against new CF7 and WP versions.
= 2.3.0 =
* Added Custom Header option.
* Added 'ctz_ignore_default_webhook' to allow ignore core submit.
* Added more parameters to 'ctz_trigger_webhook' action.
* Added more parameters to 'ctz_post_request_args' action.
= 2.2.5 =
* Some minor adjustments.
* Tested against new CF7 and WP versions.
= 2.2.4 =
* Support to CF7 new way to load properties.
= 2.2.3 =
* Support to CF7 multiple files upload.
* Support to files with same name.
= 2.2.2 =
* Support to CF7 5.2.1 changing 'wpcf7_special_mail_tags' filter.
= 2.2.1 =
* Support to CF7 5.2 changing 'free_text' input name.
Props to @brunojlt
= 2.2.0 =
* Support to free_text option on radio and checkboxes.
= 2.1.4 =
* Added 'ctz_hook_url' filter to change webhook URL
Props to @shoreline-chrism
= 2.1.2 =
* Fix checkboxes.
= 2.1.1 =
* Fix slashes on POST data.
= 2.1.0 =
* Support to rename fields.
= 2.0.2 =
* Plugin renamed.
= 2.0.0 =
* Support to submit files.
= 1.4.0 =
* Show form error when WordPress request fails and added support to throw or own exceptions.
* Added 'ctz_post_request_result' action after submit.
* Added 'ctz_trigger_webhook_error_message' filter to change form message error.
= 1.3.1 =
* Remove PHP 7+ dependency.
* It's sad... I know.
= 1.3.0 =
* Added support to [Special Mail Tags] (https://contactform7.com/special-mail-tags) on CF7.
* Tested against WP 5.0.2 and CF7 version 5.1.
= 1.2.1 =
* Tested against Contact Form 7 version 5.0.
= 1.2 =
* Added support to [PIPE](https://contactform7.com/selectable-recipient-with-pipes) on CF7.
* Tested against WP 4.9.2.
= 1.1.1 =
* Fixed problem with a function inside empty() prior PHP 5.5.
= 1.1 =
* Added the 'application/json' header by default to POST request.
* Added 'ctz_post_request_args' filter to POST request args.
* Tested against WP 4.9.
= 1.0 =
* It's alive!
* Form configuration.
* Integration to Zapier webhook.
* Ignore or not CF7 mail sent.
== Upgrade Notice ==
= 3.0.0 =
Added support to placeholders in webhook URLs!
You can check details [in this topic](https://wordpress.org/support/topic/use-webhook-url-placeholders).
More changes:
* Added 'ctz_hook_url_placeholder' filter.
* Tested against new CF7 and WP versions.
* A donate link if you feel the need to give back.
* Some fixes.