Description
Allows you to include results from a Forms 3rdparty Integration submission by flattening the response and inserting it within the original contact form submission.
Installation
- Unzip, upload plugin folder to your plugins directory (
/wp-content/plugins/
) - Make sure Forms 3rdparty Integration is installed and settings have been saved at least once.
- Activate plugin
- In the newly available section «Inject Results» in the ‹3rdparty services› admin, enter the flattened service response keys like
Response/Body/SomeKey
, one per line.
a. If the response is JSON or XML it will scan the elements/keys according to the segments you’ve entered; in the above example it will look for{ Response: { Body: { SomeKey: "foobar" } } }
and include «foobar» with the submission. - Some contact form plugins only allow injecting/overwriting an existing field (e.g. Gravity Forms). In these cases you can provide an «alias» to overwrite with
Response/Body/SomeKey=the_alias
, where the_alias is the contact form field to override.
a. With Gravity Forms, fields should be overwritten using aliases likeinput_X
where ‹X› is the field’s id.
FAQ
- How does it add the response values?
-
If you have an endpoint test-response.php that will «echo» back your 3rdparty submission with keys altered to be prefixed with ‹req-‹, then if your submission was
{ name: { first: "FirstName", last: "LastName" }, email: "myemail@email.com", etc: "foobar" }
The response would be flattened and prefixed to
{ "req-name/first": "FirstName", "req-name/last": "LastName", "req-email": "myemail@email.com", "req-etc": "foobar" }
You would then inject
req-name/first
orreq-etc
. - What are some XML/JSON examples?
-
XML
[env:Envelope/env:Body/ns1:Response/ns1:Resultstatus] => foo [env:Envelope/env:Body/ns1:Response/ns1:Result] => bar [env:Envelope/env:Body/ns1:Response/ns1:Description] => baz
JSON
[Body/Response/ResultStatus] => foo [Body/Response/Result] => bar [Body/Response/Description] => baz
Note that XML responses will include the namespace prefixes. You may then reference them by the entire key shown above.
- It doesn’t work right…
-
Drop an issue at https://github.com/zaus/forms-3rdparty-inject-results
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Forms: 3rd-Party Inject Results” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Forms: 3rd-Party Inject Results” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.3
- fix: inconsistent nested key delimiters, now expecting ‹/›
- removed testing endpoint per WP Security request (see archives for example)
0.2
- confirmed with GF at least
0.1
IT HAS BEGUN