| <?php | |
| /** | |
| * Gravity Wiz // Gravity Forms // All Fields Template | |
| * | |
| * Modify the {all_fields} merge tag output via a template file. | |
| * | |
| * @version 0.9.3 | |
| * @author David Smith <david@gravitywiz.com> | |
| * @license GPL-2.0+ | |
| * @link https://gravitywiz.com/gravity-forms-all-fields-template/ | |
| * @copyright 2018 Gravity Wiz | |
| * | |
| * Plugin Name: Gravity Forms All Fields Template | |
| * Plugin URI: https://gravitywiz.com/gravity-forms-all-fields-template/ | |
| * Description: Modify the {all_fields} merge tag output via a template file. | |
| * Author: Gravity Wiz | |
| * Version: 0.9.3 | |
| * Author URI: https://gravitywiz.com | |
| * | |
| * Usage: | |
| * | |
| * {all_fields} | |
| * | |
| * By default, enabling this plugin will look for this template: | |
| * <theme>/gravityforms/templates/all-fields.php | |
| * | |
| * Override the {all_fields} template for a specific form by specifying the form ID: | |
| * <theme>/gravityforms/templates/all-fields-<formId>.php | |
| * | |
| * {all_fields:template[custom]} | |
| * | |
| * Specify a custom template suffix. This is useful for allowing specific forms to use the same template. | |
| * <theme>/gravityforms/template/all-fields-custom.php | |
| * | |
| * {all_fields:notemplate} | |
| * | |
| * Will always load the default Gravity Forms {all_fields} markup. | |
| * | |
| * Filtering Usage: | |
| * | |
| * :filter | |
| * | |
| * Filtering will only include the specified fields and exclude all others. It cannot be combined with the include | |
| * exclude filters. | |
| * | |
| * {all_fields:filter[1]} | |
| * {all_fields:filter[1,2]} | |
| * | |
| * :include | |
| * | |
| * Including will include fields with types that are typically not supported by the {all_fields} merge tag | |
| * (e.g., HTML fields). | |
| * | |
| * {all_fields:filter[3]} | |
| * {all_fields:filter[3,4]} | |
| * {all_fields:include[3,4],exclude[5]} | |
| * | |
| * :exclude | |
| * | |
| * Excluding will exclude specific fields from being included in the {all_fields} output. | |
| * | |
| * {all_fields:exclude[5]} | |
| * {all_fields:exclude[5,6]} | |
| * {all_fields:exclude[5],include[3,4]} | |
| * | |
| */ | |
| class GW_All_Fields_Template { | |
| private static $instance = null; | |
| public static function get_instance() { | |
| if( self::$instance == null ) { | |
| self::$instance = new self; | |
| } | |
| return self::$instance; | |
| } | |
| private function __construct() { | |
| add_action( 'init', array( $this, 'init' ) ); | |
| } | |
| public function init() { | |
| add_filter( 'gform_pre_replace_merge_tags', array( $this, 'replace_merge_tags' ), 10, 7 ); | |
| add_filter( 'gform_merge_tag_filter', array( $this, 'all_fields_extra_options' ), 11, 5 ); | |
| } | |
| /** | |
| * to exclude field from notification add 'exclude[ID]' option to {all_fields} tag | |
| * 'include[ID]' option includes HTML field / Section Break field description / Signature image in notification | |
| * see http://www.gravityhelp.com/documentation/page/Merge_Tags for a list of standard options | |
| * | |
| * include: Include a field that is not included by default (i.e. HTML fields). | |
| * exclude: Exclude a field that is included by default. | |
| * filter: Only include the specified field IDs. This takes precedence over both the 'include' and 'exclude' modifiers. | |
| * | |
| * example: {all_fields:exclude[2,3]} | |
| * example: {all_fields:include[6]} | |
| * example: {all_fields:include[6],exclude[2,3]} | |
| */ | |
| public function all_fields_extra_options( $value, $merge_tag, $modifiers, $field, $raw_value ) { | |
| if( ! is_a( $field, 'GF_Field' ) ) { | |
| $field = new GF_Field(); | |
| $field->type = $field; | |
| } | |
| if( $merge_tag != 'all_fields' && $field->type == 'form' ) { | |
| return $value; | |
| } | |
| $modifiers = $this->parse_modifiers( $modifiers ); | |
| $whitelist = array( 'filter', 'include', 'exclude' ); | |
| $context = rgar( $modifiers, 'context', false ); | |
| foreach( $modifiers as $modifier => $mod_value ) { | |
| if( ! in_array( $modifier, $whitelist ) ) { | |
| continue; | |
| } | |
| if( ! is_array( $mod_value ) ) { | |
| $mod_value = array( $mod_value ); | |
| } | |
| /** | |
| * Integrate w/ GP Nested Forms to allow filtering which fields are displayed for nested entries in the | |
| * Nested Form field's value. GPNF will pass custom modifiers (e.g., context[nested],parent[fieldId]). | |
| */ | |
| if( $context == 'nested' ) { | |
| $nested_form_field_id = rgar( $modifiers, 'parent', false ); | |
| if( ! $nested_form_field_id ) { | |
| break; | |
| } | |
| $field_ids = array(); | |
| foreach( $mod_value as $field_id ) { | |
| if( intval( $field_id ) == $nested_form_field_id && $field_id !== intval( $field_id ) ) { | |
| $field_id_bits = explode( '.', $field_id ); | |
| $field_ids[] = array_pop( $field_id_bits ); | |
| } | |
| } | |
| } else { | |
| $field_ids = array_map( 'intval', $mod_value ); | |
| } | |
| switch( $modifier ) { | |
| case 'filter': | |
| if( in_array( $field->id, $field_ids ) ) { | |
| $value = $this->get_all_fields_field_value( $field, $value ); | |
| } else { | |
| $value = false; | |
| } | |
| break; | |
| case 'include': | |
| if( in_array( $field->id, $field_ids ) ) { | |
| $value = $this->get_all_fields_field_value( $field, $value ); | |
| } | |
| break; | |
| case 'exclude': | |
| if( in_array( $field->id, $field_ids ) ) { | |
| $value = false; | |
| } | |
| break; | |
| } | |
| } | |
| // echo '<pre>'; | |
| // $field_id = $field->id; | |
| // print_r( compact( 'modifiers', 'field_ids', 'field_id', 'value' ) ); | |
| // echo '<pre>'; | |
| return $value; | |
| } | |
| public function replace_merge_tags( $text, $form, $entry, $url_encode, $esc_html, $nl2br, $format ) { | |
| $matches = array(); | |
| preg_match_all( '/{all_fields(?::(.*?))?}/i', $text, $matches, PREG_SET_ORDER ); | |
| foreach ( $matches as $match ) { | |
| // Replace each unique merge tag only once. | |
| if( strpos( $text, $match[0] ) === false ) { | |
| continue; | |
| } | |
| $modifiers = rgar( $match, 1 ); | |
| $options = compact( 'url_encode', 'esc_html', 'nl2br', 'format' ); | |
| $content = $this->parse_template( 'all-fields', $modifiers, $form, $entry, $options ); | |
| if( $content !== false ) { | |
| $text = str_replace( $match[0], $content, $text ); | |
| } | |
| } | |
| return $text; | |
| } | |
| public function parse_template( $template, $modifiers, $form, $entry, $options = array() ) { | |
| $_modifiers = $modifiers; | |
| $modifiers = $this->parse_modifiers( $modifiers ); | |
| if( in_array( 'notemplate', $modifiers ) ) { | |
| return false; | |
| } | |
| $use_value = in_array( 'value', $modifiers ); | |
| $display_empty = in_array( 'empty', $modifiers ); | |
| $use_admin_label = in_array( 'admin', $modifiers ); | |
| $suffixes = array( $form['id'] ); | |
| if( array_key_exists( 'template', $modifiers ) ) { | |
| array_unshift( $suffixes, $modifiers['template'] ); | |
| } | |
| $items = rgar( $options, 'items' ); | |
| if( empty( $items ) ) { | |
| $items = $this->get_items( $form, $entry, $display_empty, ! $use_value, $options['format'], $use_admin_label, 'all_fields', $_modifiers ); | |
| } | |
| $output = $this->load_template( $template, null, array( | |
| 'form' => $form, | |
| 'entry' => $entry, | |
| 'items' => $items | |
| ), $suffixes ); | |
| if( $output === false && rgar( $options, 'fallback' ) ) { | |
| if( is_callable( $options['fallback'] ) ) { | |
| $output = call_user_func( $options['fallback'], $items ); | |
| } | |
| } | |
| return $output; | |
| } | |
| public function replace_nested_forms_all_fields( $value, $field, $nested_form, $entry, $modifiers ) { | |
| $output = $this->parse_template( $modifiers, $nested_form, $entry, array( 'format' => 'html' ) ); | |
| if( $output ) { | |
| $value = $output; | |
| } | |
| return $value; | |
| } | |
| public function parse_modifiers( $modifiers_str ) { | |
| preg_match_all( '/([a-z]+)(?:(?:\[(.+?)\])|,?)/i', $modifiers_str, $modifiers, PREG_SET_ORDER ); | |
| $parsed = array(); | |
| foreach( $modifiers as $modifier ) { | |
| list( $match, $modifier, $value ) = array_pad( $modifier, 3, null ); | |
| if( $value === null ) { | |
| $value = $modifier; | |
| } | |
| // Split '1,2,3' into array( 1, 2, 3 ). | |
| if( strpos( $value, ',' ) !== false ) { | |
| $value = array_map( 'trim', explode( ',', $value ) ); | |
| } | |
| $parsed[ $modifier ] = $value; | |
| } | |
| return $parsed; | |
| } | |
| public function get_items( $form, $lead, $display_empty = false, $use_text = false, $format = 'html', $use_admin_label = false, $merge_tag = '', $modifiers = '' ) { | |
| return $this->get_submitted_fields( $form, $lead, $display_empty, $use_text, $format, $use_admin_label, $merge_tag, $modifiers ); | |
| } | |
| public function get_submitted_fields( $form, $lead, $display_empty = false, $use_text = false, $format = 'html', $use_admin_label = false, $merge_tag = '', $modifiers = '' ) { | |
| $items = array(); | |
| //$field_data = ''; | |
| $modifiers_array = explode( ',', $modifiers ); | |
| $no_admin = in_array( 'noadmin', $modifiers_array ); | |
| $no_hidden = in_array( 'nohidden', $modifiers_array ); | |
| $display_product_summary = false; | |
| foreach ( $form['fields'] as $field ) { | |
| $field_value = ''; | |
| $field_label = $use_admin_label && ! empty( $field->adminLabel ) ? $field->adminLabel : esc_html( GFCommon::get_label( $field, 0, false, $use_admin_label ) ); | |
| switch ( $field->type ) { | |
| case 'captcha' : | |
| break; | |
| case 'section' : | |
| $field_value = false; | |
| if ( GFFormsModel::is_field_hidden( $form, $field, array(), $lead ) ){ | |
| continue; | |
| } | |
| if ( ( ! GFCommon::is_section_empty( $field, $form, $lead ) || $display_empty ) && ! $field->adminOnly ) { | |
| switch ( $format ) { | |
| case 'text' : | |
| $field_value = "--------------------------------\n{$field_label}\n\n"; | |
| break; | |
| default: | |
| $field_value = ''; | |
| break; | |
| } | |
| } | |
| $field_value = apply_filters( 'gform_merge_tag_filter', $field_value, $merge_tag, $modifiers, $field, $field_label ); | |
| //$field_data .= $field_value; | |
| if( $field_value !== false ) { | |
| $item = array( | |
| 'label' => $field_label, | |
| 'value' => $field_value, | |
| 'field' => $field | |
| ); | |
| } | |
| break; | |
| case 'password' : | |
| //ignore password fields | |
| break; | |
| default : | |
| if ( GFCommon::is_product_field( $field->type ) ) { | |
| // ignore product fields as they will be grouped together at the end of the grid | |
| $display_product_summary = apply_filters( 'gform_display_product_summary', true, $field, $form, $lead ); | |
| if ( $display_product_summary ) { | |
| continue; | |
| } | |
| } else if ( GFFormsModel::is_field_hidden( $form, $field, array(), $lead ) ) { | |
| // ignore fields hidden by conditional logic | |
| continue; | |
| } | |
| $raw_field_value = RGFormsModel::get_lead_field_value( $lead, $field ); | |
| $field_value = GFCommon::get_lead_field_display( $field, $raw_field_value, rgar( $lead, 'currency' ), $use_text, $format, 'email' ); | |
| $display_field = true; | |
| //depending on parameters, don't display adminOnly or hidden fields | |
| if ( $no_admin && $field->adminOnly ) { | |
| $display_field = false; | |
| } else if ( $no_hidden && RGFormsModel::get_input_type( $field ) == 'hidden' ) { | |
| $display_field = false; | |
| } | |
| //if field is not supposed to be displayed, pass false to filter. otherwise, pass field's value | |
| if ( ! $display_field ) { | |
| $field_value = false; | |
| } | |
| $field_value = apply_filters( 'gform_merge_tag_filter', $field_value, $merge_tag, $modifiers, $field, $raw_field_value ); | |
| if ( $field_value === false ) { | |
| continue; | |
| } | |
| if ( ! empty( $field_value ) || strlen( $field_value ) > 0 || $display_empty ) { | |
| switch ( $format ) { | |
| case 'text' : | |
| //$field_data .= "{$field_label}: {$field_value}\n\n"; | |
| break; | |
| default: | |
| // $field_data .= sprintf( | |
| // '<tr bgcolor="%3$s"> | |
| // <td colspan="2"> | |
| // <font style="font-family: sans-serif; font-size:12px;"><strong>%1$s</strong></font> | |
| // </td> | |
| // </tr> | |
| // <tr bgcolor="%4$s"> | |
| // <td width="20"> </td> | |
| // <td> | |
| // <font style="font-family: sans-serif; font-size:12px;">%2$s</font> | |
| // </td> | |
| // </tr> | |
| // ', $field_label, empty( $field_value ) && strlen( $field_value ) == 0 ? ' ' : $field_value, apply_filters( 'gform_email_background_color_label', '#EAF2FA', $field, $lead ), apply_filters( 'gform_email_background_color_data', '#FFFFFF', $field, $lead ) | |
| // ); | |
| break; | |
| } | |
| $item = array( | |
| 'label' => $field_label, | |
| 'value' => $field_value, | |
| 'field' => $field | |
| ); | |
| } | |
| } | |
| if( isset( $item ) ) { | |
| $items[] = $item; | |
| unset( $item ); | |
| } | |
| } | |
| if ( $display_product_summary ) { | |
| $value = $this->all_fields_extra_options( GFCommon::get_submitted_pricing_fields( $form, $lead, $format, $use_text, $use_admin_label ), $merge_tag, $modifiers, 'order_summary', null ); | |
| if( $value !== false ) { | |
| $items[] = array( | |
| 'label' => 'Order Summary', | |
| 'value' => $value, | |
| ); | |
| } | |
| } | |
| return $items; | |
| } | |
| public function get_all_fields_field_value( $field, $value ) { | |
| switch ( $field->type ) { | |
| case 'html' : | |
| $value = $field->content; | |
| break; | |
| // Sections are included by default; including them manually will append their description. | |
| case 'section' : | |
| $value .= sprintf( '<tr bgcolor="#FFFFFF"> | |
| <td width="20"> </td> | |
| <td> | |
| <font style="font-family: sans-serif; font-size:12px;">%s</font> | |
| </td> | |
| </tr> | |
| ', $field->description ); | |
| break; | |
| case 'signature' : | |
| $url = is_callable( 'gf_signature' ) ? gf_signature()->get_signature_url( $value ) : $value; | |
| $value = "<img alt='signature' src='{$url}' />"; | |
| break; | |
| } | |
| return $value; | |
| } | |
| public function log( $message ) { | |
| GFCommon::log_debug( $message ); | |
| } | |
| // ### TEMPLATE SYSTEM (compliments of EDD) ### | |
| public function load_template( $slug, $name = null, $data = array(), $suffixes = array() ) { | |
| ob_start(); | |
| extract( $data ); | |
| $template = $this->get_template_part( $slug, $name, false, $suffixes ); | |
| if( ! empty( $template ) ) { | |
| include( $template ); | |
| } | |
| $content = ob_get_clean(); | |
| return ! $template ? false : $content; | |
| } | |
| public function get_template_part( $slug, $name = null, $load = true, $suffixes = array() ) { | |
| // Execute code for this part | |
| do_action( 'get_template_part_' . $slug, $slug, $name, $suffixes ); | |
| // Setup possible parts | |
| $templates = array(); | |
| if( isset( $name ) ) { | |
| $suffixes[] = $name; | |
| } | |
| foreach( $suffixes as $suffix ) { | |
| $templates[] = $slug . '-' . $suffix . '.php'; | |
| } | |
| $templates[] = $slug . '.php'; | |
| // Return the part that is found | |
| return $this->locate_template( $templates, $load, false ); | |
| } | |
| public function locate_template( $template_names, $load = false, $require_once = true ) { | |
| // No file found yet | |
| $located = false; | |
| // Try to find a template file | |
| foreach ( (array) $template_names as $template_name ) { | |
| // Continue if template is empty | |
| if ( empty( $template_name ) ) | |
| continue; | |
| // Trim off any slashes from the template name | |
| $template_name = ltrim( $template_name, '/' ); | |
| // try locating this template file by looping through the template paths | |
| foreach( $this->get_theme_template_paths() as $template_path ) { | |
| if( file_exists( $template_path . $template_name ) ) { | |
| $located = $template_path . $template_name; | |
| break; | |
| } | |
| } | |
| if( $located ) { | |
| break; | |
| } | |
| } | |
| if ( ( true == $load ) && ! empty( $located ) ) | |
| load_template( $located, $require_once ); | |
| return $located; | |
| } | |
| public function get_theme_template_paths() { | |
| $template_dir = $this->get_theme_template_dir_name(); | |
| $file_paths = array( | |
| 1 => trailingslashit( get_stylesheet_directory() ) . $template_dir, | |
| 10 => trailingslashit( get_template_directory() ) . $template_dir | |
| ); | |
| // sort the file paths based on priority | |
| ksort( $file_paths, SORT_NUMERIC ); | |
| return array_map( 'trailingslashit', $file_paths ); | |
| } | |
| public function get_theme_template_dir_name() { | |
| return trailingslashit( 'gravity-forms' ); | |
| } | |
| } | |
| function gw_all_fields_template() { | |
| return GW_All_Fields_Template::get_instance(); | |
| } | |
| gw_all_fields_template(); |
The Gravity Forms {all_fields} merge tag provides a super simple way to output all of the submitted form data but it’s notoriously difficult to customize.
This plugin provides templating support for the {all_fields} merge tag. Huh? It means you can replace the markup generated by the merge tag with the contents of a file. This tutorial offers a solid starter template file too!
Getting Started
This tutorial assumes you’re running a recent version of Gravity Forms, that you already have the {all_fields} merge tag implemented wherever you want, and that you ♥ Gravity Wiz.
 | Download, install, and activate the plugin. |
 | Download the sample template directory/file. Add the folder to your active theme’s root directory: /wp-content/themes/{your-theme}/ |
 | Customize the template as desired. |
Template and Merge Tag Options
This plugin provides a few handy modifiers for controlling which template will be used to render the {all_fields} merge tag.
Note: All template paths are relative to your theme’s root directory.
Default Templates
| Merge Tag | Template |
|---|---|
| {all_fields} | /gravity-forms/all-fields.php |
Form-specific Template
Providing a form-specific template requires not changes to the merge tag. Simply append the targeted form ID to your template’s name. This template will now only be used with the merge tag is used in the context of the specified form.
| Merge Tag | Template |
|---|---|
| {all_fields} | /gravity-forms/all-fields.php /gravity-forms/all-fields-1.php |
Custom Template
You may want to create a custom template that should only be applied to specific instances of the merge tag. The “template” modifier allows you to specify a custom template suffix.
| Merge Tag | Template |
|---|---|
| {all_fields:template[custom]} | /gravity-forms/all-fields-{template}.php /gravity-forms/all-fields-custom.php |
No Template
You may want to create a generic template that applies to all instances of the merge tag by default and then disable that template to use the default Gravity Forms merge tag output in a few specific instances.
| Merge Tag | Template |
|---|---|
| {all_fields:notemplate} | No template |
Field Filtering Modifier
These modifiers allow you to control which fields are output in the {all_fields} merge tag without having to touch any code.
Please note: you only need the plugin installed to use these modifiers. You do not need to install the template files in your theme.
| Merge Tag | Description |
|---|---|
| {all_fields:include[1,2]} | Include a field that is not included by default (i.e. HTML fields). |
| {all_fields:exclude[3,4]} | Exclude a field that is included by default. |
| {all_fields:filter[1,2]} | Only include the specified field IDs. This takes precedence over both the ‘include’ and ‘exclude’ modifiers. |
| {all_fields:include[1,2],exclude[3]} | The :include and :exclude modifiers can be combined. |
GF Nested Forms Support
To filter which fields from a child form display in your {all_fields} merge tag you can use the :filter modifier and the [Nested Form Field ID].[Child Field ID] format (e.g., 4.3; where 4 is the Nested Form field ID and 3 is the child field ID from the child form.
You can use the :include, :exclude, and :filter modifiers on the Nested Form field to filter which child fields should be displayed.
| Merge Tag | Description |
|---|---|
| {all_fields:filter[1,2,3.4,3.5]} | In this example, 1 and 2 are field IDs on the parent form. 3 is the Nested Form Field ID and 4 and 5 are field IDs on the child form. |
| {Nested Form:1:filter[4,5]} | Show fields 4 and 5 from the child form for this Nested Form field. |
Customizing the Template
Ok, don’t let this section intimidate you. Here’s the TLDR; Loop through $items, use $item['label'] for the field label, and $item['value'] for the field value. Here’s the simplest template you could have:
| <ul> | |
| <?php foreach( $items as $item ): ?> | |
| <li> | |
| <strong><?php echo $item['label']; ?><strong><br> | |
| <?php echo $item['value']; ?> | |
| </li> | |
| <?php endforeach; ?> | |
| </ul> |
You’ll most likely want to use the sample template above as a starting point though as it takes care of a requirements to better align the template with Gravity Forms default All Fields functionality.
Digging Deeper
The {all_fields} template works like any other WordPress template with one exception. There is a special $items array available to you.
Each $item contains a label, value, and field property. The label and value are the exact label and value that the default {all_fields} merge tag would output. The field is the input-type-specific GF_Field object for the current field. This is useful when you want to alter the way a field is displayed depending on the field you’re working with.
Lastly, you have access to the current entry via the $entry variable and the current form via the $form variable. For more details on these variables, see the parameters section below.
Parameters
$items array
An array of items, each item containing the Gravity-Forms-formatted field label, field value and field object for the given field. The field label and field value are the same values that Gravity Forms outputs in the default
{all_fields}merge tag.$entry Entry Object
The current Gravity Forms Entry object.
$form Form Object
The current Gravity Forms Form object.
Questions? Feedback?
What questions do you have? What features are missing? We’d like to make this into a more robust plugin and your feedback will be a big part of shaping the final product.
Did this resource help you do something awesome with Gravity Forms? Then you'll absolutely love Gravity Perks; a suite of 29+ essential add-ons for Gravity Forms with support you can count on.
Hi used the plugin works great, thank you as always though one thing the Address field moves the top line over to the right but the following lines of the address are indented to the left same with the ordersummary you can view a screen shot here https://pasteboard.co/HXWm95u.jpg.
Not sure what to edit to change this cannot do it with css as there are just unamed spans any help appreciated REgards Alistair
Ignore last comment found it
What pet do you have? 1. Dog 2. Cat 3. Parrot 4. Other
At the moment the email will just say: What pet do you have?: ‘3.Parrot’
I need it to show: What pet do you have?: 1. Dog 2. Cat 3. Parrot (Selected) 4. Other
Hi Fakhar, each
$itemhas afieldkey which would have all of the choices:$item['field']->choices. You could loop through each choice and output the choice label and the “(Selected)” designator for the choice whose value matches the$item['value'].Hello,
Thanks for providing this code. I have a rather specific scenario that I am dealing with which I wonder if you could help point me in the right direction.
The form we are creating has a few HTML blocks in it which are making use of merge tags to fill in text from the users input. i.e. Dear Mr {Name:2.2}, we would like to inform you … etc.
We are making use of https://gravitywiz.com/better-pre-submission-confirmation/ for this functionality.
In the summary for {all_fields} we are including these HTML blocks so that the user can see what they have agreed to / filled in before submitting. The merge tags in this preview are not replaced with the form values.
My question is, is there a way to convert the merge tags in this all_fields summary page? Is it then possible to submit these HTML blocks to the entry with the merge tags replaced with form values?
Thanks very much
Hi Joshua, hm, I don’t have a good answer on this one. It probably just isn’t supported. I can’t make any promises but if you’re already a Gravity Perks user, we’d be happy to see if this is something we could add support for to our Gravity Forms Preview Submission perk.
Hi David. I thought that would be the case. Sleeping on it seems to have helped. Having returned to the problem to see if I could attack from a different angle, it now all just works™.
So Good Job everyone! 👍
Hi! I just downloaded the plug-in, but since I am not a programmer, I don´t understand the customization. I have created a form and the notification that the filler will get is too complicated. I would like to do it more simplier. Unfortunately I don´t understand tags and customizing the template at all.
I have done the steps one and two. But now, I don’t have a clue, where I will do the customization. I don’t need to make the form different, I just want to have the form that will be send to the form filler in the notification. I can find the Styles and Layouts for the Gravity Forms, but I don’t have a clue, what I need to change to effect to the notification email. There is no that option.
Hi Anni, it sounds like you might want to hire a developer to assist with this. The plugin is very barebones and is intended to serve as starting point rather than a polished solution.
Maybe I can use this plugin to solve my issue with the {all_fileds} merge tag? I have a form with various checkbox elements with various labels. Each label is set to the same value of “1”, but when I use the {all_fields} merge tag to preview the form or include the {all_fields} in a notification, because all the values are set to “1”, the output displays the first option label regardless of whether that is the option selected. Yes, I could set the value equal to the label, however I am summing the values to ensure that a minimum number of options are selected, hence them all having a value of 1. Is there a way around this where we can have the {all_fields} merge tag actually output the option label of the specific option and not the first one in the form field that has that (same) value?
Hi Tyler, Gravity Forms uses the value to uniquely identify the choice. You will run into other issues like this if your choices do not have unique values.
Your snippet here works really well, but a few pointers: – The template that you have made looks nice on the majority of email clients, but when it’s rendered in outlook for windows it’s getting butchered, doesn’t look right at all. – Email clients have come on a long way over the last couple of years, and now it’s pretty safe to use a style tag and classes throughout the document to style all elements, just avoid having multiple classes on elements as then outlook will ignore the extra classes.
Hi Geoff, we followed this guide from MailChimp when coming up with the sample template: https://mailchimp.com/help/css-in-html-email/ The good news is with this template, you can completely change how you handle the CSS to meet your preferences. 🙂
Great tutorial David! Thanks!
I was wondering if there’s a way to display specific items outside the loop. So let’s say I have made this simple template like you can see below. Is that something that’s possible?
And is it possible to then loop through the nested forms data and do something you can see a bit further down? So looping through it with a ready made template?
Cheers!
Hi Peter, the short answer is yes, you can modify the template and output markup outside the loop. I’m not sure I understood the rest of your question?
Hi David, thanks for this plug in. I have a form that all I want to do is wrap the phone number in an A tag with a tel: link to make the phone number clickable straight from the email. I’m a bit confused as to where this would be inputted in the all-fields.php file or if this is possible to do.
Thanks! Chris
I don’t think you need this plugin. Just add the markup around your Phone field’s merge tag. Example:
<a href="tel:{Phone:1}">{Phone:1}</a>Hi. Thank you for the great tutorial. In my form I have created several steps. How can I display the fields by step and display the page name before the fields in each page? I would greatly appreciate any lead to improve the template.
The fields are already in order of their pages and the pages are each represented by a field on the form. You’ll need to loop through and output special markup to wrap the fields by their respective pages.
Thank you, David, for this excellent plugin and documentation.
FYI, in case it helps anyone else, if all you want to do is exclude or include certain fields in the {all_fields} merge tag, just install the plugin. You don’t need to mess around with steps 2 or 3 in the above tutorial — i.e., no need to create the folder and upload the PHP file to your theme’s directory. I may be dense but it wasn’t obvious to me, and I messed around with it for a while before realizing that it was possible to simplify. :)
Thanks for the feedback, Rob. I’ve added a note to this section that should hopefully make this more clear. :)
I wold like to exclude a pricing field used for calculations from the {pricing_fields} or at least from the {all_fields}… How I do that?
This isn’t possible with this snippet; however, here’s an example of how it can be achieved: https://gist.github.com/spivurno/35a6fe24accd961ded0cdc1e4b8ca987
I would like to use this merge tag with the Nested Forms plugin in the manner described in the docs there. It is unclear from the documentation where I use as similar merge tag to the example {Players:1:filter[1]}. Also, it’s unclear what is specifically referenced by “Players.” Is this the title of the nested form?
Hi Peter, “Players” refers to the field label of the Nested Form field that is on the parent form. The {Players:1:filter[1]}-style merge tag can be used anywhere that merge tags are supported in the scope of the parent form (notifications, confirmations, etc). Happy to answer any other questions you have via support. :)
I do not know how to create a template, so I am just using from out of the box. Do I go to the editor and create a template there – any step-by-step instructions I’d appreciate particulary with screenshots! Sorry I’m not that saavy with coding…
Hello. I’ve used CSS to style my gravity form fields into 3 columns, BUT when I get a copy of the submitted form notification, it does not show the 3 columns (as it does online). Gravity Forms recommended that I reach out to you for help on this. I have downloaded your plugin, but I need more guidance on how to do this. Thanks.
Hi Kat, I assume that you’re using a custom all fields template? If so, you’ll need to include your styles in the style attribute for each element. Most email clients will ignore a linked stylesheet or an inline style block.