Last active
June 8, 2021 19:10
-
-
Save spivurno/5a50ae342b1c7a16d2e4 to your computer and use it in GitHub Desktop.
Gravity Wiz // Gravity Forms // All Fields Template
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| <?php | |
| /** | |
| * WARNING! THIS SNIPPET MAY BE OUTDATED. | |
| * The latest version of this snippet can be found in the Gravity Wiz Snippet Library: | |
| * https://github.com/gravitywiz/snippet-library/blob/master/gravity-forms/gw-all-fields-template.php | |
| */ | |
| /** | |
| * Gravity Wiz // Gravity Forms // All Fields Template | |
| * | |
| * Modify the {all_fields} merge tag output via a template file. | |
| * | |
| * @version 0.9.6 | |
| * @author David Smith <[email protected]> | |
| * @license GPL-2.0+ | |
| * @link https://gravitywiz.com/gravity-forms-all-fields-template/ | |
| * | |
| * 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.6 | |
| * Author URI: http://gravitywiz.com | |
| * | |
| * Usage: | |
| * | |
| * {all_fields} | |
| * | |
| * By default, enabling this plugin will look for this template: | |
| * <theme>/gravity-forms/all-fields.php | |
| * | |
| * Override the {all_fields} template for a specific form by specifying the form ID: | |
| * <theme>/gravity-forms/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>/gravity-forms/all-fields-custom.php | |
| * | |
| * {all_fields:notemplate} | |
| * | |
| * Will always load the default Gravity Forms {all_fields} markup. | |
| * | |
| * {all_fields:nopricingfields} | |
| * | |
| * Hide all pricing fields (i.e. order summary). | |
| * | |
| * 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:include[3]} | |
| * {all_fields:include[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' ), 9, 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', 'nopricingfields' ); | |
| $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 ); | |
| } | |
| if( $modifier === 'nopricingfields' ) { | |
| $func = function() use ( &$func ) { | |
| remove_filter( 'gform_order_summary', $func ); | |
| return ''; | |
| }; | |
| add_filter( 'gform_order_summary', $func ); | |
| } | |
| /** | |
| * 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[ strtolower( $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 ) ){ | |
| break; | |
| } | |
| 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 ) { | |
| break; | |
| } | |
| } else if ( GFFormsModel::is_field_hidden( $form, $field, array(), $lead ) ) { | |
| // ignore fields hidden by conditional logic | |
| break; | |
| } | |
| $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 ) { | |
| break; | |
| } | |
| 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(); |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| <ul> | |
| <?php foreach( $items as $item ): ?> | |
| <li> | |
| <strong><?php echo $item['label']; ?><strong><br> | |
| <?php echo $item['value']; ?> | |
| </li> | |
| <?php endforeach; ?> | |
| </ul> |
Author
Hey @R3dRidle, a little slow on the draw but the inline usage has been fixed.
I tested this several times, but it does not seem to work.
It seems first of all you have a mistype in the "Usage"
There you state that the directory should be "gravityforms/templates", yet in the code it seems you are looking for "gravity-forms".Furthermore you state that you look in the "templates" subdirectory, which it doesn't look for in the code.
With these things changed, I got it working.
I have the same problem. The Gravity Forms dir is located at ../gravityforms
Author
@dreamkatana This doesn't look for the template file in the Gravity Forms plugin directory but rather a newly created gravity-forms directory that you should add to your theme. Full instructions here: https://gravitywiz.com/gravity-forms-all-fields-template/
@dreamkatana This doesn't look for the template file in the Gravity Forms plugin directory but rather a newly created
gravity-formsdirectory that you should add to your theme. Full instructions here: https://gravitywiz.com/gravity-forms-all-fields-template/
That´s right, my mistake.
I´m getting trouble to format the output of a nested form with product, quantity and value.
Do u know where is it locate?
@spivurno Do you know how to get rid of the bullets that are inserted into the output when you are answering a radio button or checkbox?
Thank you for any help you can provide!
Author
@spiaust Those values are being wrapped in <ul> and <li> tags. You can use CSS to disable the list-style property of the <ul>.
@spiaust Those values are being wrapped in
<ul>and<li>tags. You can use CSS to disable the list-style property of the<ul>.
Great thank you. I just have one more question. It looks to be in a table format. Would there be any way to change this to a plain text?
Thank you so much for your help!
@spiaust Those values are being wrapped in
<ul>and<li>tags. You can use CSS to disable the list-style property of the<ul>.Great thank you. I just have one more question. It looks to be in a table format. Would there be any way to change this to a plain text?
Thank you so much for your help!
Hi there.
Take a look at the common.php file in the GF plugin folder.
@spiaust Those values are being wrapped in
<ul>and<li>tags. You can use CSS to disable the list-style property of the<ul>.Great thank you. I just have one more question. It looks to be in a table format. Would there be any way to change this to a plain text?
Thank you so much for your help!Hi there.
Take a look at the common.php file in the GF plugin folder.
Would you happen to know what I would be looking for? Sorry I'm a beginner at this. Thank you for all the help!
Author
👉 This Gist has been migrated to the Gravity Wiz Snippet Library:
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
I tested this several times, but it does not seem to work.
It seems first of all you have a mistype in the "Usage"
There you state that the directory should be "gravityforms/templates", yet in the code it seems you are looking for "gravity-forms".
Furthermore you state that you look in the "templates" subdirectory, which it doesn't look for in the code.
With these things changed, I got it working.