Title: Forms: 3rd-Party Integration
Author: zaus
Published: <strong>miz Du 14, 2012</strong>
Last modified: Gwengolo 9, 2019

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/forms-3rdparty-integration.svg)

# Forms: 3rd-Party Integration

 By [zaus](https://profiles.wordpress.org/zaus/)

[Download](https://downloads.wordpress.org/plugin/forms-3rdparty-integration.zip)

 * [Details](https://bre.wordpress.org/plugins/forms-3rdparty-integration/#description)
 * [Reviews](https://bre.wordpress.org/plugins/forms-3rdparty-integration/#reviews)
 *  [Installation](https://bre.wordpress.org/plugins/forms-3rdparty-integration/#installation)
 * [Development](https://bre.wordpress.org/plugins/forms-3rdparty-integration/#developers)

 [Support](https://wordpress.org/support/plugin/forms-3rdparty-integration/)

## Description

Send [Contact Form 7](https://wordpress.org/extend/plugins/contact-form-7/), [Gravity Forms](http://www.gravityforms.com/),
or [Ninja Forms](http://ninjaforms.com/) Submissions to a 3rd-party Service, like
a CRM. Multiple configurable services, custom field mapping. Provides hooks and 
filters for pre/post processing of results. Allows you to send separate emails, 
or attach additional results to existing emails. Comes with a couple examples of
hooks for common CRMs (listrak, mailchimp, salesforce). Check out the FAQ section
for add-on plugins that extend this functionality, like sending XML/SOAP posts, 
setting headers, and dynamic fields.

The plugin essentially makes a remote request (POST) to a service URL, passing along
remapped form submission values.

Based on idea by Alex Hager “[How to Integrate Salesforce in Contact Form 7](http://www.alexhager.at/how-to-integrate-salesforce-in-contact-form-7/)“.

Original plugin, [Contact Form 7: 3rdparty Integration](https://wordpress.org/extend/plugins/contact-form-7-3rd-party-integration/)
developed with the assistance of [AtlanticBT](http://www.atlanticbt.com/). Current
plugin sponsored by [Stephen P. Kane Consulting](http://www.stephenpkane.com/). 
Please submit bugs / support requests to [GitHub issue tracker](https://github.com/zaus/forms-3rdparty-integration/issues)
in addition to the WordPress Support Forums because the Forums do not send emails.

### Hooks

_Please note that this documentation is in flux, and may not be accurate for latest
rewrite 1.4.0_

 1.  `add_action('Forms3rdPartyIntegration_service_a#', $response, $param_ref);`
 2.   * hook for each service, indicated by the `#` – _this is given in the ‘Hooks’
        section of each service_
      * provide a function which takes `$response, &$results` as arguments
      * allows you to perform further processing on the service response, and directly
        alter the processing results, provided as `array('success'=>false, 'errors'
        =>false, 'attach'=>'', 'message' => '');`
         - _success_ = `true` or `false` – change whether the service request is treated
           as “correct” or not
         - _errors_ = an array of error messages to return to the form
         - _attach_ = text to attach to the end of the email body
         - _message_ = the message notification shown (from CF7 ajax response) below
           the form
      * note that the basic “success condition” may be augmented here by post processing
 3.  `add_action('Forms3rdPartyIntegration_service', $response, $param_ref, $sid);`
 4.   * same as previous hook, but not tied to a specific service
 5.  `add_filter('Forms3rdPartyIntegration_service_filter_post_#, ...`
 6.   * hook for each service, indicated by the `#` – _this is given in the ‘Hooks’
        section of each service_
      * allows you to programmatically alter the request parameters sent to the service
      * should return updated `$post` array
 7.  `add_filter('Forms3rdPartyIntegration_service_filter_post', 'YOUR_HOOK', 10, 4);`
 8.   * in addition to service-specific with suffix `_a#`; accepts params `$post`, `
        $service`, `$form`, `$sid`
 9.  `add_filter('Forms3rdPartyIntegration_service_filter_args', 'YOUR_HOOK', 10, 3);`
 10.  * alter the [args array](https://codex.wordpress.org/Function_Reference/wp_remote_post#Parameters)
        sent to `wp_remote_post`
      * allows you to add headers or override the existing settings (timeout, body)
      * if you return an array containing the key `response_bypass`, it will skip the
        normal POST and instead use that value as the 3rdparty response; note that 
        it must match the format of a regular `wp_remote_post` response.
      * Note: if using `response_bypass` you should consider including the original
        arguments in the callback result for debugging purposes.
 11. `add_action('Forms3rdPartyIntegration_remote_failure', 'mycf7_fail', 10, 5);`
 12.  * hook to modify the Form (CF7 or GF) object if service failure of any kind occurs—
        use like:
      * function mycf7_fail(&$cf7, $debug, $service, $post, $response) {
         $cf7->skip_mail
        = true; // stop email from being sent // hijack message to notify user ///TODO:
        how to modify the “mail_sent” variable so the message isn’t green? on_sent_ok
        hack? $cf7->messages[‘mail_sent_ok’] = ‘Could not complete mail request:** ‘.
        $response[‘safe_message’]; }
      * needs some way to alter the `mail_sent` return variable in CF7 to better indicate
        an error – no way currently to access it directly.
 13. `add_action('Forms3rdPartyIntegration_service_settings', 'YOUR_HOOK', 10, 3)`
 14.  * accepts params `$eid`, `$P`, `$entity` corresponding to the index of each service
        entity and this plugin’s namespace, and the `$entity` settings array
      * allows you to add a section to each service admin settings
      * name form fields with plugin namespace to automatically save: `$P[$eid][YOUR_CUSTOM_FIELD]`
        $rarr; `Forms3rdPartyIntegration[0][YOUR_CUSTOM_FIELD]`
 15. `add_action('Forms3rdPartyIntegration_service_metabox', 'YOUR_HOOK', 10, 2)`
 16.  * accepts params `$P`, `$entity` corresponding to the index of each service entity
        and this plugin’s namespace, and the `$options` settings array (representing
        the full plugin settings)
      * allows you to append a metabox (or anything else) to the plugin admin settings
        page
      * name form fields with plugin namespace to automatically save: `$P[YOUR_CUSTOM_FIELD]`
        $rarr; `Forms3rdPartyIntegration[YOUR_CUSTOM_FIELD]`
 17. `add_filter('Forms3rdPartyIntegration_debug_message', 'YOUR_HOOK', 10, 5);`
 18.  * bypass/alternate debug logging
 19. `add_filter('Forms3rdPartyIntegration_plugin_hooks', 'YOUR_HOOK', 10, 1);`
 20.  * Accepts an array of contact form plugin hooks to attach F3p to, and returns
        that array. Modify result to attach to additional plugin hooks, like GF edit.
 21. `add_filter('Forms3rdPartyIntegration_service_filter_url', 'YOUR_HOOK', 10, 2);`
 22.  * hook a function that takes the `$service_url, $post_args` and returns the endpoint`
        $url`
      * used to modify the submission url based on mappings or other information
      * `$post_args` contains the `body` and other `wp_remote_post` details

Basic examples provided for service hooks directly on plugin Admin page (collapsed
box “Examples of callback hooks”). Code samples for common CRMS included in the `/
3rd-parties` plugin folder.

### Stephen P. Kane Consulting

From [the website](http://www.stephenpkane.com/) and [Handpicked Tomatoes](http://handpickedtomatoes.com/):

**Transparent and Holistic Approach**

> Transparency is good. It’s amazing how many web design sites hide who they are.
> There are lots of reasons, none of which are good for the customer. We don’t do
> that. I’m Stephen Kane, principal web craftsman at HandpickedTomatoes, and I’m
> an Orange County based freelancer who occasionally works with other local freelancers
> and agencies to deliver quality web solutions at very affordable prices.
>  We work
> to earn the right to be a trusted partner. One that you can turn to for professional
> help in strategizing, developing, executing, and maintaining your Internet presence.
> We take a holistic view. Even if a project is small, our work should integrate
> into the big picture. We craft web architecture and designs that become winning
> websites that are easy to use and to share. We custom build social network footprints
> on sites like linkedin, facebook, twitter, youtube, flickr, yelp!, and google 
> places and integrate them into your website to leverage social marketing. We help
> you set up and execute email campaigns, with search engine marketing, with photography,
> with site copy and content and anything else that you need in order to have a 
> successful Internet presence. Through this holistic approach, we work with clients
> to grow their sales, improve their brand recognition, and manage their online 
> reputation.

## Screenshots

 * [[
 * Admin page – create multiple services, set up debugging/notice emails, example
   code
 * [[
 * Sample service – mailchimp integration, with static and mapped values
 * [[
 * Sample service – salesforce integration, with static and mapped values

## Installation

 1. Unzip, upload plugin folder to your plugins directory (`/wp-content/plugins/`)
 2. Make sure at least one of [Contact Form 7](https://wordpress.org/extend/plugins/contact-form-7/),
    [Gravity Forms](http://www.gravityforms.com/), or [Ninja Forms](http://ninjaforms.com/)
    is installed
 3. Activate plugin
 4. Go to new admin subpage _“3rdparty Services”_ under the CF7 “Contact” menu or Gravity
    Forms “Forms” menu and configure services + field mapping.
 5. Turn on ‘debug mode’ to get emailed a copy of the submission+response data, until
    you’re satisfied everything works, then turn it off

## FAQ

  I need help / My form isn’t working

Turn on ‘debug mode’ from the admin page to send you an email with:

 * the current plugin configuration, including field mappings
 * the user submission (as provided by CF7/GF/Ninja)
 * the post as sent to the service (applied mapping)
 * the response sent back from the service, which hopefully includes error codes
   or explanations (often is the raw HTML of a success/failure page)

Submit an issue to the [GitHub issue tracker][] in addition to / instead of the 
WP Support Forums.

  How do I add / configure a service?

See [Screenshots][] for visual examples.

Essentially,

 1.  Name your service.
 2.  Enter the submission URL — if your “service” provides an HTML form, you would 
     use the form action here.
 3.  Choose which forms will submit to this service (“Attach to Forms”).
 4.  Set the default “success condition”, or leave blank to ignore (or if using post
     processing, see [Hooks][] – this just looks for the provided text in the service
     response, and if present assumes “success”
 5.  Set an optional “failure message” to show if the remote request fails. Can include
     the “nice explanation” as well as the original message provided by the contact
     form plugin.
 6.  Allow hooks for further processing – unchecking it just saves minimal processing
     power, as it won’t try to execute filters.
 7.  Map your form submission values (from the CF7/GF field tags) to expected fields
     for your service.
 8.   * 1:1 mapping given as the _name_ (from the HTML input) of the CF7/GF field and
        the _name_ of the 3rdparty field
      * For GF and Ninja Forms, you may map either by the field name or the field label
      * You can also provide static values by checking the “Is Value?” checkbox and
        providing the value in the “Form Submission Field” column.
      * The “Label” column is optional, and just provided for administrative notes,
        i.e. so you can remind yourself what each mapping pertains to.
 9.  Add, remove, and rearrange mapping – basically just for visual clarity.
 10. Use the provided hooks (as given in the bottom of the service block).
 11. Add new services as needed, drag/drop mappings and service boxes.

  How can I pre/post process the request/results?

See section [Hooks](https://bre.wordpress.org/extend/plugins/forms-3rd-party-integration/other_notes?output_format=md#Hooks).
See plugin folder `/3rd-parties` for example code for some common CRMs, which you
can either directly include or copy to your code.

  I need to submit multiple values as…

 * By default, if more than one value appears in the post request for the same field/
   key, they will be joined by the ‘separator’ value like `&post-values=a,b,c`.
 * However, if you use `[]` as the separator it will instead create multiple keys
   like `&post-values[]=a&post-values[]=b&...`.
 * Use `[#]` to retain the numerical index: `&post-values[0]=a&post-values[1]=b&...`
 * Use `[%]` to place the numerical index at desired location; specifically useful
   with nested fields via Xpost below (and issues [#11](https://github.com/zaus/forms-3rdparty-xpost/issues/11)
   and [#7](https://github.com/zaus/forms-3rdparty-xpost/issues/7)).

If you instead need to combine/nest fields, check out [Forms: 3rdparty Xpost](https://wordpress.org/plugins/forms-3rd-party-xpost/).

  How do I make a GET request instead of POST?

Since v1.7.6, it’s an admin setting for GET and POST, but for anything other than
those two that you’d write a hook.

_from https://wordpress.org/support/topic/method-get?replies=2#post-5996489_

See ‘Hooks’ section, #5 of https://wordpress.org/plugins/forms-3rdparty-integration/
other_notes/ and the [source code](https://github.com/zaus/forms-3rdparty-integration/blob/master/forms-3rdparty-integration.php#L478).

You’ll need to perform `wp_remote_get` inside that filter and set `$post_args['response_bypass']`
with the response, something like:

    ```
    function my_3rdparty_get_override($post_args, $service, $form) {
        $post_args['response_bypass'] = wp_remote_get($service['url'], $post_args);
        return $post_args;
    }
    ```

  How do I dynamically change the URL?

Use the hook `Forms3rdPartyIntegration_service_filter_url`. (see “Hooks” section)

  What about Hidden Fields?

Using hidden fields can provide an easier way to include arbitrary values on a per-
form basis, rather than a single “Is Value?” in the Service mapping, as you can 
then put your form-specific value in the hidden field, and map the hidden field 
name generically.

For convenience, you can install the [Contact Form 7 Modules: Hidden Fields](https://wordpress.org/extend/plugins/contact-form-7-modules/).
This plugin originally included the relevant code, but it was causing issues on 
install, so is no longer bundled with it.

  How do I export/import settings?

Use the “Forms 3rdparty Migration” plugin https://wordpress.org/plugins/forms-3rdparty-
migrate/, which lets you export and import the raw settings as JSON.
 You can also
export settings from the original plugin [Contact Form 7: 3rdparty Integration][]
and “upgrade” them for this plugin (although > 1.6.1 you will need to reselect forms).
Also at https://github.com/zaus/forms-3rdparty-migrate

  How do I map url parameters?

Use the “Dynamic Fields” plugin: https://wordpress.org/plugins/forms-3rdparty-dynamic-
fields/
 Also at https://github.com/zaus/forms-3rdparty-dynamicfields

  How do I send XML/submit to SOAP?

For simple xml containers try the “Forms 3rdparty Xpost” plugin: https://wordpress.
org/plugins/forms-3rd-party-xpost/
 Also at https://github.com/zaus/forms-3rdparty-
xpost

  How do I set headers?

You can also set headers with “Forms 3rdparty Xpost” plugin: https://wordpress.org/
plugins/forms-3rd-party-xpost/
 Also at https://github.com/zaus/forms-3rdparty-xpost

  How do I show a custom message on the confirmation screen?

The failure message is shown by default if the 3rdparty post did not succeed. You
can add custom messaging to the plugin’s (GF, CF7, Ninja) email or success screen
response with something like:

    ```
    class MyPlugin {
        public function MyPlugin() {
            add_filter('Forms3rdPartyIntegration_service', array(&$this, 'adjust_response'), 10, 2);
        }

        public function adjust_response($body, $refs) {
            // use 'attach' to inject to regular email
            // use 'message' to inject to page
            $refs['attach'] = 'custom message in email';
            $refs['message'] = 'custom message on page';
        }
    }
    new MyPlugin(); // attach hook
    ```

  How do I conditionally submit? (if field == …)

Use hook ‘…use_submission’ to check the form submission (pre-mapping), making sure
to pick the appropriate scenario, like:

    ```
    add_filter('Forms3rdPartyIntegration_use_submission', 'f3i_conditional_submit', 10, 3);
    function f3i_conditional_submit($use_this_form, $submission, $sid) {
        // if there was a specific value -- skip
        if(isset($submission['maybe-send']) && 'no' == $submission['maybe-send']) return false;
        // if there was a specific value -- use
        if(isset($submission['maybe-send']) && 'yes' == $submission['maybe-send']) return $use_this_form; // or true, i guess
        // if there was a value for it (e.g. for checkboxes) -- skip
        if(isset($submission['if-not-send'])) return false;
        // if there was a value for it (e.g. for checkboxes) -- use
        if(isset($submission['if-send']) && !empty($submission['if-send'])) return $use_this_form; // or true, i guess

        return $use_this_form; // or `false`, depending on your desired default
    }
    ```

If you want to check _after_ the fields have been mapped, you can “reuse” the hook‘…
service_filter_args’ and return `false` to skip, rather than bypass:

    ```
    add_filter('Forms3rdPartyIntegration_service_filter_args', 'f3i_conditional_post', 10, 3);
    function f3i_conditional_post($post_args, $service, $form) {
        // your skip scenarios, checking `body` subarray instead
        if(isset($post_args['body']['maybe-send']) && ...) return false;

        // regular behavior
        return $post_args;
    }
    ```

  How do I resend a service call?

Using public instance functions `send` and `handle_results`:

    ```
    $f3p = Forms3rdPartyIntegration::$instance;
    $debug = $f3p->get_settings();
    // $sid - maybe get it from the current filter
    // $form - maybe get it from the current filter
    // $submission - probably save it somewhere, or rebuilt it from a database entry, etc
    // $service = $f3p->get_services()[$sid];

    $sendResult = $f3p->send($submission, $form, $service, $sid, $debug);
    if($sendResult === Forms3rdPartyIntegration::RET_SEND_STOP || $sendResult === Forms3rdPartyIntegration::RET_SEND_SKIP) return;

    $response = $sendResult['response'];
    $post_args = $sendResult['post_args'];

    return $f3p->handle_results($submission, $response, $post_args, $form, $service, $sid, $debug);
    ```

  How do I include part of the response in another service call?

See “Forms: 3rdparty Post Again”

 * Github https://github.com/zaus/forms-3rdparty-postagain
 * WordPress https://wordpress.org/plugins/forms-3rdparty-post-again/

  How do I include part of the response the contact form results?

See “Forms: 3rdparty Inject Results”

 * Github https://github.com/zaus/forms-3rdparty-inject-results
 * WordPress https://wordpress.org/plugins/forms-3rdparty-inject-results/

However, currently only confirmed working with Gravity Forms.

## Reviews

![](https://secure.gravatar.com/avatar/4f686be9c8ce4fcf8e997cdd6a5d94c569cce9225f341d82841cae665cc3c93e?
s=60&d=retro&r=g)

### 󠀁[Please continue this plugin!](https://wordpress.org/support/topic/please-continue-this-plugin-3/)󠁿

 [swissspaceboy](https://profiles.wordpress.org/swissspaceboy/) Gwengolo 11, 2021

Excellent free plugin to send your emails contacts to SugarCRM or SuiteCRM like 
I do. Works perfectly for years. Keep this supported, please.

![](https://secure.gravatar.com/avatar/2ba482fb1b0a50d1abd02abc17ffc6336e4a03a860fdc5a8c5b51d575f49cb5d?
s=60&d=retro&r=g)

### 󠀁[This plugin still works!!! Please keep updated](https://wordpress.org/support/topic/this-plugin-still-works-please-keep-updated/)󠁿

 [skop81](https://profiles.wordpress.org/skop81/) Gouere 19, 2021

Fantastic plugin, very useful and most important thing: still works in Wordpress.
Now I’m using Wordpress 5.7.2 and this plugin still works very well! I’ve just one
suggestion: keep updated this plugin, please!!! 😉

![](https://secure.gravatar.com/avatar/2421fb5bb8d65cd80fdebf1ab7eee6c9898c09146110cb38c0020b2acc554cf4?
s=60&d=retro&r=g)

### 󠀁[Great FREE Plugin–Performs Just as Good and Safer Than Premium Alternatives](https://wordpress.org/support/topic/great-plugin-25153/)󠁿

 [kramer842](https://profiles.wordpress.org/duonger/) Meurzh 14, 2020

Works as good as any paid plugin–without requiring you to add your account credentials.
Providing a plugin developer with admin accounts logins for a company’s CRM platform
is a disaster waiting to happen. Not saying those premium plugin companies would
do anything malicious but hard to warrant the risk when using POST or GET and OIDs
with hooks to transfer the data and tying to a campaign keeps the account safe. 
Word of advice… if you’re getting redirect errors make sure you don’t use hyphens
or underscores in the source field ID and select “Enable data forwarding to the 
success location” in the Pardot form handler.

![](https://secure.gravatar.com/avatar/f35f93ae052b2f5b87df05f5ec7de4d0d05c292007f9d8b57e4e2b45f0534bb4?
s=60&d=retro&r=g)

### 󠀁[works well and free](https://wordpress.org/support/topic/works-well-and-free-2/)󠁿

 [Webprom Design](https://profiles.wordpress.org/webprom/) Genver 8, 2020

Excellent plugin, should make UI a bit better

![](https://secure.gravatar.com/avatar/bfe9866a0f479a0e4ba4e111e5b951bfbc25469b9f1a68cafa32a2623ca57c31?
s=60&d=retro&r=g)

### 󠀁[Very Good!](https://wordpress.org/support/topic/very-good-4283/)󠁿

 [mc_deimon](https://profiles.wordpress.org/mc_deimon/) miz Du 5, 2019

It is a great plugin! I use it to join Ninja Forms with Mailrelay and it works perfectly.

![](https://secure.gravatar.com/avatar/594b19d0236e96b788d410adc50273ef86f70de58f42c0a9a1ca3a9622dc0eb9?
s=60&d=retro&r=g)

### 󠀁[Great](https://wordpress.org/support/topic/great-8550/)󠁿

 [Mahfuzul Hasan](https://profiles.wordpress.org/mahfuzul/) Gwengolo 18, 2018

I have tested with Salesforce and it works fine. Thanks.

 [ Read all 31 reviews ](https://wordpress.org/support/plugin/forms-3rdparty-integration/reviews/)

## Contributors & Developers

“Forms: 3rd-Party Integration” is open source software. The following people have
contributed to this plugin.

Contributors

 *   [ zaus ](https://profiles.wordpress.org/zaus/)
 *   [ Atlantic BT ](https://profiles.wordpress.org/atlanticbt/)
 *   [ spkane ](https://profiles.wordpress.org/spkane/)

[Translate “Forms: 3rd-Party Integration” into your language.](https://translate.wordpress.org/projects/wp-plugins/forms-3rdparty-integration)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/forms-3rdparty-integration/),
check out the [SVN repository](https://plugins.svn.wordpress.org/forms-3rdparty-integration/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/forms-3rdparty-integration/)
by [RSS](https://plugins.trac.wordpress.org/log/forms-3rdparty-integration/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.8

 * copy service button
 * Ninja Forms are back! Can use Ninja Forms plugin v3.0+ again.

#### 1.7.9

 * debug message truncation with configure hooks
 * use hook `...debug_truncation` to set field length limits for each section

#### 1.7.8

 * adding per-service delimiter, supports newlines
 * ‘add new service’ button after metaboxes
 * minor ui fixes

#### 1.7.7

 * destination mapping is textarea to make other plugins easier (e.g. newlines in
   xpost formatting), hooks `..._service_mappings_headers` and `..._service_mappings_values`
   to add more columns

#### 1.7.6

 * exposing http method (get/post); result redirection

#### 1.7.5

 * late-bind GF confirmation for script tags

#### 1.7.4

 * another slight fix to make GF Resend do submission hooks too (so Reformat will
   work with it as well)

#### 1.7.3

 * slight refactor of `before_send` to make reposting GF submissions easier

#### 1.7.2.1

 * fix minor conflict between Inject Results and Post-Again

#### 1.7.2

 * added injection hooks for [Forms: 3rdparty Inject Results](https://github.com/zaus/forms-3rdparty-inject-results)—
   use via `$form = apply_filters(Forms3rdPartyIntegration::$instance->N('inject'),
   $form, $values_to_inject);`

#### 1.7

 * refactored internal methods to make them reusable externally, specifically for‘
   forms-3rdparty-postagain’ plugin

#### 1.6.6.5

 * added URL filter to allow customizing GET requests with post body arguments, 
   or shortcodes
 * filter added to fplugin_base to allow multiple attachments per [github #62](https://github.com/zaus/forms-3rdparty-integration/issues/62)
 * fix [github #68](https://github.com/zaus/forms-3rdparty-integration/issues/68)
 * ‘secret’ debugging feature for error dump if logging after unable to send email:
   add a truthy value to post mapping with 3rdparty key `_json`

#### 1.6.6.4

 * fix array value without index placeholder bug introduced in [github #43](https://github.com/zaus/forms-3rdparty-integration/issues/43)
 * final bugfix to #55 (default options `mode` array)
 * tried to address [Xpost issue #7](https://github.com/zaus/forms-3rdparty-xpost/issues/7),
   but not the right place for it

#### 1.6.6.3

 * bugfixes [#53](https://github.com/zaus/forms-3rdparty-integration/issues/53) 
   and [#55](https://github.com/zaus/forms-3rdparty-integration/issues/55)

#### 1.6.6.1

 * debug logging hook
 * fixed #52 – some hosting providers rejected arbitrary sender addresses
 * more options for debug mail failure logging

#### 1.6.6

 * Can now map GF and Ninja Forms by field label as well as id per issue #35 ([map by name](https://github.com/zaus/forms-3rdparty-integration/issues/35))

#### 1.6.5.1

 * fix Github issue #43 ([valid success response codes](https://github.com/zaus/forms-3rdparty-integration/issues/43))
 * fix Github issue #27 ([admin label](https://github.com/zaus/forms-3rdparty-integration/issues/27))
 * exposed `$service` to hook `get_submission` to make extensions easier

#### 1.6.4.3

 * fix escaped slashes for gravity forms submissions, see [GitHub issue #42](https://github.com/zaus/forms-3rdparty-integration/issues/42)

#### 1.6.4.2

 * including original `$submission` in `service_filter_post` hook for [dynamicfields calc](https://wordpress.org/plugins/forms-3rdparty-dynamic-fields/)

#### 1.6.4.1

 * quick fix for global section toggle bug

#### 1.6.4

 * conditional submission hooks (see FAQ)
 * removed somewhat useless ‘can-hook’ setting, since I assume everybody wants success
   processing. Comment via github or author website contact form if you really need
   it.

#### 1.6.3.1

 * Fix for longstanding (?) Firefox admin bug (issue #36) preventing field editing/
   input selection

#### 1.6.3

 * fix form plugin checking when multiple contact form plugins used at same time

#### 1.6.1

 * integration with [Ninja Forms](http://www.ninjaforms.com)
 * refactored CF7 and GF integrations to take advantage of new FPLUGIN base (to 
   make future integrations easier)
 * defined upgrade path

Due to the new common form extension base, the way forms are identified in the settings
has been changed.
 Deactivating and reactivating the plugin (which happens automatically
on upgrade, but not FTP or other direct file changes) should correct your existing
settings.

Depending on how many services you have configured, the upgrade path may DESELECT
your form selections in each service or otherwise break some configurations.
 If
you are concerned this may affect you, please [export](https://github.com/zaus/forms-3rdparty-migrate)
the settings so you can reapply your selections.

#### 1.4.9

 * Updated cf7 plugin to match [their latest changes](http://contactform7.com/2014/07/02/contact-form-7-39-beta/).
    - using new way to access properties
    - removed remaining support for all older versions of CF7 (it was just getting
      complicated)

#### 1.4.8.1

Trying to add some clarity to the admin pages

#### 1.4.8

 * multiple values treated differently depending on separator: ‘char’, `[]`, or `[#]`
 * static values treated the same as dynamic (so they get above processing)
 * fix: php5 constructor re: https://github.com/zaus/forms-3rdparty-integration/
   issues/6

#### 1.4.7

 * totally removing hidden field plugin — seems like even though it wasn’t referenced,
   it may have caused the “invalid header” error during install
 * admin ui – js fixes (configurable section icons via `data-icon`; entire metabox
   title now toggles accordion)
 * stripslashes on submission to fix apostrophes in ‘failure response’ textarea

#### 1.4.6

 * hook `...service_filter_args` to allow altering post headers, etc
 * fix: removed more args-by-reference (for PHP 5.4 issues, see support forum requests)
 * tested with WP 3.8, CF7 3.6

#### 1.4.5

 * fix: failure response attaches to ‘onscreen message’ for Gravity Forms
 * fix: (actually part of the next feature) failure response shows onscreen for 
   Contact Form 7
 * customize the failure response shown onscreen — new admin setting per service(
   see description)

#### 1.4.4

 * protecting against unattached forms
 * Github link
 * global post filter `Forms3rdPartyIntegration_service_filter_post` in addition
   to service-specific with suffix `_0`; accepts params `$post`, `$service`, `$form`,`
   $sid`
 * admin options hook `Forms3rdPartyIntegration_service_settings`, `..._metabox`
 * fix: gravityforms empty ‘notification’ field
 * fix: admin ui — ‘hooks’ toggle on metabox clone, row clone fieldname
 * fix: service hooks not fired multiple times when both GF and CF7 plugins are 
   active
 * fix: Gravityforms correctly updates $form array

#### 1.4.3

 * Fixed “plugin missing valid header” caused by some PHP versions rejecting passing
   variable by reference (?) as reported on Forum support topics [“Error on install”](https://wordpress.org/support/topic/error-on-install-6)
   and [“The plugin does not have a valid header”](https://wordpress.org/support/topic/the-plugin-does-not-have-a-valid-header-34),
   among others
 * Rewrote admin javascript to address style bug as reported on forum post [“fields on mapping maintenance screen misaligned”](https://wordpress.org/support/topic/fields-on-mapping-maintenance-screen-misaligned)
   and via direct contact. Really needed to be cleaned up anyway, I’ve learned more
   jQuery since then 😉
    - Dealt with weird issue where clicking a label also triggers its checkbox click
 * Other general ui fixes
 * More “verbose” endpoint-test script (headers, metadata as well as get/post)

#### 1.4.2

 * Bugfixes
 * cleaned up admin JS using delegate binding
 * added “empty” checking for 3rdparty entries to avoid dreaded “I’ve deleted my
   mappings and can’t do anything” error
 * timeout option
 * fixed CF7 form selection bug
 * conditionally load CF7 or GF only if active/present; note that this plugin must`
   init` normally to check CF7

#### 1.4.1

 * Bugfixes
 * Added “Label” column for administrative notes

#### 1.4.0

 * Forked from [Contact Form 7: 3rdparty Integration](https://wordpress.org/extend/plugins/contact-form-7-3rd-party-integration/).
 * Removed ‘hidden field plugin’ from 1.3.0, as it’s specific to CF7.

#### 1.3.2

 * Added failure hook – if your service fails for some reason, you now have the 
   opportunity to alter the CF7 object and prevent it from mailing.

#### 1.3.1

 * Added check for old version of CF7, so it plays nice with changes in newer version(
   using custom post type to store forms instead, lost original function for retrieval)
 * see original error report https://wordpress.org/support/topic/plugin-forms-3rd-
   party-integration-undefined-function-wpcf7_contact_forms?replies=2#post-2646633

#### 1.3.0

moved “external” includes (hidden-field plugin) to later hook to avoid conflicts
when plugin already called

#### 1.2.3

changed filter callback to operate on entire post set, changed name

#### 1.2.2

fixed weird looping problem; removed some debugging code; added default service 
to test file

#### 1.2

moved filter to include dynamic and static values; icons

#### 1.1

added configuration options, multiple services

#### 1.0

base version, just directly submits values

## Meta

 *  Version **1.8**
 *  Last updated **7 years ago**
 *  Active installations **5,000+**
 *  WordPress version ** 3.0 or higher **
 *  Tested up to **5.2.24**
 *  Language
 * [English (US)](https://wordpress.org/plugins/forms-3rdparty-integration/)
 * Tags
 * [cf7](https://bre.wordpress.org/plugins/tags/cf7/)[contact form](https://bre.wordpress.org/plugins/tags/contact-form/)
   [contact form 7](https://bre.wordpress.org/plugins/tags/contact-form-7/)[form](https://bre.wordpress.org/plugins/tags/form/)
   [gravity forms](https://bre.wordpress.org/plugins/tags/gravity-forms/)
 *  [Advanced View](https://bre.wordpress.org/plugins/forms-3rdparty-integration/advanced/)

## Ratings

 4.9 out of 5 stars.

 *  [  30 5-star reviews     ](https://wordpress.org/support/plugin/forms-3rdparty-integration/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/forms-3rdparty-integration/reviews/?filter=4)
 *  [  1 3-star review     ](https://wordpress.org/support/plugin/forms-3rdparty-integration/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/forms-3rdparty-integration/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/forms-3rdparty-integration/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/forms-3rdparty-integration/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/forms-3rdparty-integration/reviews/)

## Contributors

 *   [ zaus ](https://profiles.wordpress.org/zaus/)
 *   [ Atlantic BT ](https://profiles.wordpress.org/atlanticbt/)
 *   [ spkane ](https://profiles.wordpress.org/spkane/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/forms-3rdparty-integration/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](http://drzaus.com/donate)