Gravity Wiz Gravity Wiz
GF Nested Forms

gpnf_export_child_field_header

  1. Description
  2. Usage
  3. Parameters
  4. Examples
    1. Only show child field labels when Nested Form field has no label

Description

Modify the header label for the current child field.

Usage

Apply to all child fields for all Nested Form fields on all forms.

add_filter( 'gpnf_export_child_field_header', 'my_custom_function' );

Apply to all child fields for all Nested Forms fields on a specific form.

add_filter( 'gpnf_export_child_field_header_FORMID', 'my_custom_function' );

Apply to all child fields for a specific Nested Form field on a specific form.

add_filter( 'gpnf_export_child_field_header_FORMID_FIELDID', 'my_custom_function' );

Parameters

  • header string

    The default header label.

  • form array

    The current form object.

  • field \GF_Field

    The current Nested Form field.

  • child_field \GF_Field

    The current child field.

Examples

Only show child field labels when Nested Form field has no label

If the Nested Form field has no label, the default output might look something like / Child field label. This snippet will update that to Child field label (no slash).

<?php
/**
 * Gravity Perks // Nested Forms // Only show child field labels when Nested Form field has no label
 * https://gravitywiz.com/documentation/gravity-forms-nested-forms/
 */
add_filter( 'gpnf_export_child_field_header', function( $header, $form, $field, $child_field, $input ) {

	$parent_label = $field->get_field_label( false, null );
	if ( ! empty( $parent_label ) ) {
		return $header;
	}

	$child_field_label = $child_field->get_field_label( false, null );

	if ( rgar( $input, 'label' ) ) {
		$header = sprintf( '%s (%s)', $child_field_label, $input['label'] );
	} else {
		$header = $child_field_label;
	}

	return $header;
}, 10, 5 );

All Connections

All Perks