precary / acf-gravityforms-add-on

Advanced Custom Fields: Gravityforms Add-on

Advanced Custom Fields: Gravityforms Add-on

Advanced Custom Field with which we can select Gravityforms.

Getting started

The plugin is primarily available from the WordPress plugin repository. It allows you to choose a Gravity Form in WordPress Admin and use the selected form ID in your Theme or Plugin to output the form.

This plugin does not have any effect on the output of the website. It only adds a custom ACF field type for use in an ACF field group.

Installation and usage

1. Upload the plugin files to the /wp-content/plugins/acf-gravityforms-add-on directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Add a new field of type 'Forms' to the required ACF field group.

You can also install Advanced Custom Fields: Gravityforms Add-on using Composer.

composer require dannyvanholten/acf-gravityforms-add-on

…or if you make use of WPackagist, …

composer require wpackagist-plugin/acf-gravityforms-add-on

Using Advanced Custom Fields: Gravityforms Add-on

To use the the field you just need to know how Advanced Custom Fields work. You can check out their documentation.

The Gravity Forms Add-on returns either an single form object / ID or an array of objects / IDs. Now we know that we can easily use it to build our fields :)

Output of the form in the frontend

This plugin doesn't integrate any code to the frontend of the website. You will need to ensure that your own Plugin or Theme handles the output of the form. An example of how do do this is detailed in this blog post on the Gravity Forms website.

Getting the form ID

If you return an ID from your ACF field configuration:

$form_id = get_field('my-form');
gravity_form($form_id);

If you return an Object from your ACF field configuration:

$form = get_field('my-form');
gravity_form($form['id']);

If you return multiple Form IDs from your ACF field configuration:

$form_ids = get_field('my-form');

foreach($form_ids as $form_id) {
    gravity_form($form_id);
}

Filtering the field HTML

Versions 1.3.2/1.3.3/1.3.4 added a plain HTML filter to the output of the field. This filter is not applied to fields in ACF version 4.

apply_filters('acf-gravityforms-add-on/field_html', string $field_html, array $field, string $field_options, string $multiple)

Getting involved

Want to get involved and improve Advanced Custom Fields: Gravityforms Add-on? Fork this repo and whenever you have something just make a pull request. After review we might add it to the Gravityforms ACF Field GitHub Repository.

Credits

This plugin is maintained by Say Hello GmbH, a specialist WordPress agency in Spiez, Switzerland.

The plugin was initially developed by Danny van Holten based on work by @stormuk, (@lgladdy and @adampope).