class-gp-nested-forms.php

<?php

if ( ! class_exists( 'GP_Plugin' ) ) {
	return;
}

class GP_Nested_Forms extends GP_Plugin {

	protected $_version     = GP_NESTED_FORMS_VERSION;
	protected $_path        = 'gp-nested-forms/gp-nested-forms.php';
	protected $_full_path   = __FILE__;
	protected $_slug        = 'gp-nested-forms';
	protected $_title       = 'Gravity Forms Nested Forms';
	protected $_short_title = 'Nested Forms';

	public $parent_form_id = null;
	public $field_type     = 'form';

	private $shortcode_field_values = array();

	public static $nested_forms_markup = array();

	private static $instance = null;

	/**
	 * @var array|null $entry_being_edited Stores the entry being edited so we can access the entry prior to it being
	 *  updated.
	 */
	public $entry_being_edited = null;

	public static function get_instance() {

		if ( self::$instance === null ) {
			self::includes();
			self::$instance = isset( self::$perk_class ) ? new self( new self::$perk_class ) : new self();
		}

		return self::$instance;
	}

	public static function includes() { }

	public function minimum_requirements() {
		return array(
			'gravityforms' => array(
				'version' => '2.4',
			),
			'wordpress'    => array(
				'version' => '4.9',
			),
		);
	}

	public function pre_init() {

		parent::pre_init();

		$this->setup_cron();

		require_once( 'includes/class-gp-template.php' );
		require_once( 'includes/class-gp-field-nested-form.php' );
		require_once( 'includes/class-gpnf-feed-processing.php' );
		require_once( 'includes/class-gpnf-gravityview.php' );
		require_once( 'includes/class-gpnf-gravityflow.php' );
		require_once( 'includes/class-gpnf-gfml.php' );
		require_once( 'includes/class-gpnf-wc-product-addons.php' );
		require_once( 'includes/class-gpnf-merge-tags.php' );
		require_once( 'includes/class-gpnf-parent-merge-tag.php' );
		require_once( 'includes/class-gpnf-notification-processing.php' );
		require_once( 'includes/class-gpnf-zapier.php' );
		require_once( 'includes/class-gpnf-entry.php' );
		require_once( 'includes/class-gpnf-session.php' );
		require_once( 'includes/class-gpnf-export.php' );
		require_once( 'includes/class-gpnf-easy-passthrough.php' );

		// Nested Form fields have a dynamically retrieved value set via this filter and needs to be in place as early as possible.
		add_filter( 'gform_get_input_value', array( $this, 'handle_nested_form_field_value' ), 10, 3 );

		// Must happen on pre_init to intercept the 'gform_export_form' filter.
		gpnf_export();

	}

	public function init() {

		parent::init();

		load_plugin_textdomain( 'gp-nested-forms', false, basename( dirname( __file__ ) ) . '/languages/' );

		// Initialize sub classes.
		gpnf_gravityview();
		gpnf_gravityflow();
		gpnf_gfml();
		gpnf_feed_processing();
		gpnf_parent_merge_tag();
		gpnf_notification_processing();
		gpnf_zapier();
		gpnf_merge_tags();
		gpnf_wc_product_addons();
		gpnf_easy_passthrough();

		// General Hooks
		add_action( 'gform_form_args', array( $this, 'stash_shortcode_field_values' ) );
		add_action( 'gform_pre_validation', array( $this, 'maybe_load_nested_form_hooks' ) );
		add_action( 'gform_pre_render', array( $this, 'maybe_load_nested_form_hooks' ) );
		add_filter( 'gform_entry_meta', array( $this, 'register_entry_meta' ) );
		add_filter( 'gform_merge_tag_filter', array( $this, 'all_fields_value' ), 11, 6 );
		add_action( 'gform_calculation_formula', array( $this, 'process_merge_tags' ), 10, 4 );
		add_filter( 'gform_custom_merge_tags', array( $this, 'add_nested_form_field_total_merge_tag' ), 10, 4 );

		// Handle parent form.
		add_action( 'gform_register_init_scripts', array( $this, 'register_all_form_init_scripts' ) );
		add_filter( 'gform_form_tag', array( $this, 'add_session_hash_input' ), 10, 2 );
		add_action( 'gform_entry_created', array( $this, 'handle_parent_submission' ), 10, 2 );
		add_action( 'gform_after_update_entry', array( $this, 'handle_parent_update_entry' ), 10, 2 );
		add_action( 'gform_entry_post_save', array( $this, 'handle_parent_submission_post_save' ), 20 /* should happen well after feeds are processed on 10 */, 2 );

		// Handle nested form.
		add_action( 'gform_get_form_filter', array( $this, 'handle_nested_forms_markup' ), 10, 2 );
		add_filter( 'gform_confirmation', array( $this, 'handle_nested_confirmation' ), 10, 3 );
		add_filter( 'gform_confirmation_anchor', array( $this, 'handle_nested_confirmation_anchor' ) );
		add_action( 'gform_entry_id_pre_save_lead', array( $this, 'maybe_edit_entry' ), 10, 2 );
		add_action( 'gform_entry_post_save', array( $this, 'add_child_entry_meta' ), 10, 2 );
		add_filter( 'gform_get_field_value', array( $this, 'row_id_field_value' ), 11, 3 );
		add_filter( 'gform_form_args', array( $this, 'force_display_expired_nested_form' ), 10, 1 );
		add_filter( 'gform_pre_validation', array( $this, 'skip_expired_nested_form_schedule_validation' ), 10, 1 );

		// Administrative hooks.
		// Trash child entries when a parent entry is trashed or deleted.
		add_action( 'gform_update_status', array( $this, 'child_entry_trash_manage' ), 10, 3 );
		// Delete child entries when parent entry is permanently deleted.
		add_action( 'gform_delete_entry', array( $this, 'child_entry_delete' ), 10 );
		// Filter child entries by parent entry ID in the List View.
		add_filter( 'gform_get_entries_args_entry_list', array( $this, 'filter_entry_list' ) );
		// Add support for processing nested forms in Gravity Forms preview.
		add_action( 'wp', array( $this, 'handle_core_preview_ajax' ), 9 );
		// Add support for filtering by Parent Entry ID in Entries List or and plugins like Gravity Flow Form Connector
		add_filter( 'gform_field_filters', array( $this, 'add_parent_form_filter' ), 10, 2 );
		// Add support for displaying Parent Entry link in Child Entry Info box.
		add_action( 'gform_entry_info', array( $this, 'add_parent_entry_link' ), 10, 2 );

		add_filter( 'gform_form_theme_slug', array( $this, 'override_gf_theme_in_preview' ), 11, 2 );

		// Integrations.
		add_filter( 'gform_webhooks_request_data', array( $this, 'add_full_child_entry_data_for_webhooks' ), 10, 4 );
		add_filter( 'gform_partialentries_post_entry_saved', array( $this, 'adopt_partial_entry_children' ), 10, 2 );
		add_filter( 'gform_partialentries_post_entry_updated', array( $this, 'adopt_partial_entry_children' ), 10, 2 );

		// Integration Fixes.
		if ( $this->use_jquery_ui_dialog() ) {
			add_action( 'wp_enqueue_scripts', array( $this, 'fix_jquery_ui_issue' ), 1000 );
		}

		add_filter( 'gform_enqueue_scripts', array( $this, 'enqueue_child_form_scripts' ) );

		add_filter( 'gform_field_input', array( $this, 'rerender_signature_field_on_edit' ), 10, 5 );

		// Make single entry label and plural entry label translatable via WPML.
		add_filter( 'gform_multilingual_field_keys', array( $this, 'wpml_translate_entry_labels' ) );

		// Allow Gravity Forms 2.9.18+ to retain previously uploaded files when a nested entry is edited.
		add_filter( 'gform_submission_files_pre_save_field_value', array( $this, 'prepare_submission_files_for_save' ), 9, 4 );

		// Clear form's nested entries if save and continue is used (migrated from snippet library)
		add_action( 'gform_post_process', function( $form ) {
			if ( rgpost( 'gform_save' ) && class_exists( 'GPNF_Session' ) ) {
				$session = new GPNF_Session( $form['id'] );
				$session->delete_cookie();
			}
		} );

		add_filter( 'gform_pre_render', array( $this, 'maybe_disable_honeypot_on_pre_render' ), 10, 3 );

		add_filter( 'gform_pre_validation', array( $this, 'maybe_disable_honeypot_on_validation' ), 10, 1 );
	}

	public function maybe_disable_honeypot_on_pre_render( $form, $ajax, $field_values ) {
		return $this->maybe_disable_honeypot( $form );
	}

	public function maybe_disable_honeypot_on_validation( $form ) {
		return $this->maybe_disable_honeypot( $form );
	}

	public function maybe_disable_honeypot( $form ) {
		// Honeypot validation started causing issues when on child forms starting with Gravity Forms 2.7.0.
		// This disables Honeypot validtion for child forms in this scenario so that the form can be successfully submitted.
		if ( $this->is_nested_form_submission() && version_compare( GFForms::$version, '2.7', '>=' ) ) {
			$form['enableHoneypot'] = false;
		}

		return $form;
	}

	public function init_admin() {

		parent::init_admin();

		add_filter( 'gform_admin_pre_render', array( $this, 'cleanup_form_meta' ) );

		// Field Settings
		add_action( 'gform_field_standard_settings_1430', array( $this, 'editor_field_standard_settings' ) );
		add_action( 'gform_field_appearance_settings_500', array( $this, 'editor_field_appearance_settings' ) );
		add_action( 'gform_field_advanced_settings_400', array( $this, 'editor_field_advanced_settings' ) );

	}

	public function init_ajax() {

		parent::init_ajax();

		// AJAX
		add_action( 'wp_ajax_gpnf_get_form_fields', array( $this, 'ajax_get_form_fields' ) );
		add_action( 'wp_ajax_nopriv_gpnf_get_form_fields', array( $this, 'ajax_get_form_fields' ) );
		add_action( 'wp_ajax_gpnf_delete_entry', array( $this, 'ajax_delete_entry' ) );
		add_action( 'wp_ajax_nopriv_gpnf_delete_entry', array( $this, 'ajax_delete_entry' ) );
		add_action( 'wp_ajax_gpnf_edit_entry', array( $this, 'ajax_edit_entry' ) );
		add_action( 'wp_ajax_nopriv_gpnf_edit_entry', array( $this, 'ajax_edit_entry' ) );
		add_action( 'wp_ajax_gpnf_refresh_markup', array( $this, 'ajax_refresh_markup' ) );
		add_action( 'wp_ajax_nopriv_gpnf_refresh_markup', array( $this, 'ajax_refresh_markup' ) );
		add_action( 'wp_ajax_gpnf_duplicate_entry', array( $this, 'ajax_duplicate_entry' ) );
		add_action( 'wp_ajax_nopriv_gpnf_duplicate_entry', array( $this, 'ajax_duplicate_entry' ) );
		add_action( 'wp_ajax_gpnf_session', array( $this, 'ajax_session' ) );
		add_action( 'wp_ajax_nopriv_gpnf_session', array( $this, 'ajax_session' ) );

	}

	public function upgrade( $previous_version ) {
		global $wpdb;

		if ( ! $previous_version ) {
			return;
		}

		if ( version_compare( $previous_version, '1.0-beta-8', '<' ) ) {
			add_option( 'gpnf_use_jquery_ui', true );
		}

		if ( version_compare( $previous_version, '1.0-beta-5', '<' ) ) {

			// Delete expiration meta key from entries that have a valid parent entry ID.
			$sql = $wpdb->prepare(
				"
				DELETE em1 FROM {$wpdb->prefix}gf_entry_meta em1
				INNER JOIN {$wpdb->prefix}gf_entry_meta em2 ON em2.entry_id = em1.entry_id
				WHERE em1.meta_key = %s
				AND em2.meta_key = %s
				AND concat( '', em2.meta_value * 1 ) = em2.meta_value",
				GPNF_Entry::ENTRY_EXP_KEY,
				GPNF_Entry::ENTRY_PARENT_KEY
			);

			// phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
			$wpdb->query( $sql );

		}

	}

	public function tooltips( $tooltips ) {

		$template        = '<h6>%s</h6> %s';
		$learn_more_link = sprintf(
			'<a href="%1$s" target="_blank" rel="noopener noreferrer">%2$s</a>',
			esc_url( 'https://gravitywiz.com/documentation/gravity-forms-nested-forms/#what-happens-to-child-entries-when-the-parent-entry-is-never-submitted' ),
			esc_html__( 'Learn more', 'gp-nested-forms' )
		);

		$tooltips['gpnf_form']                 = sprintf( $template, __( 'Nested Form', 'gp-nested-forms' ), __( 'Select the form that should be used to create nested entries for this form.', 'gp-nested-forms' ) );
		$tooltips['gpnf_fields']               = sprintf( $template, __( 'Summary Fields', 'gp-nested-forms' ), __( 'Select which fields from the nested entry will display in table on the current form. This does not affect which fields will appear in the modal.', 'gp-nested-forms' ) );
		$tooltips['gpnf_entry_labels']         = sprintf( $template, __( 'Entry Labels', 'gp-nested-forms' ), __( 'Specify a singular and plural label with which entries submitted via this field will be labeled (i.e. "employee", "employees").', 'gp-nested-forms' ) );
		$tooltips['gpnf_entry_limits']         = sprintf( $template, __( 'Entry Limits', 'gp-nested-forms' ), __( 'Specify the minimum and maximum number of entries that can be submitted for this field.', 'gp-nested-forms' ) );
		$tooltips['gpnf_feed_processing']      = sprintf( $template, __( 'Feed Processing', 'gp-nested-forms' ), __( 'By default, any Gravity Forms add-on feeds will be processed immediately when the nested form is submitted. Use this option to delay feed processing for entries submitted via the nested form until after the parent form is submitted. <br><br>For example, if you have a User Registration feed configured for the nested form, you may not want the users to actually be registered until the parent form is submitted.', 'gp-nested-forms' ) );
		$tooltips['gpnf_modal_header_color']   = sprintf( $template, __( 'Modal Color', 'gp-nested-forms' ), __( 'Select a color which will be used to set the background color of the nested form modal header and navigational buttons.', 'gp-nested-forms' ) );
		$tooltips['gpnf_orphaned_child_entry'] = sprintf(
			$template,
			__( 'Orphaned Child Entry', 'gp-nested-forms' ),
			sprintf(
				__( 'This child entry does not have a numeric parent entry ID yet because the parent form has not been submitted. %s', 'gp-nested-forms' ),
				$learn_more_link
			)
		);

		return $tooltips;
	}

	public function scripts() {

		$scripts = array(
			array(
				'handle'  => 'knockout',
				'src'     => $this->get_base_url() . '/js/built/knockout.js',
				'version' => $this->_version,
				'enqueue' => null,
			),
		);

		if ( GFForms::is_gravity_page() ) {
			$scripts[] = array(
				'handle'   => 'gp-nested-forms-admin',
				'src'      => $this->get_base_url() . '/js/built/gp-nested-forms-admin.js',
				'version'  => $this->_version,
				'deps'     => array( 'jquery', 'gwp-asmselect' ),
				'enqueue'  => array(
					array( 'admin_page' => array( 'form_editor' ) ),
				),
				'callback' => array( $this, 'localize_scripts' ),
			);
		}

		$deps = array( 'jquery', 'gform_gravityforms', 'knockout' );
		if ( $this->use_jquery_ui_dialog() ) {
			$deps[] = 'jquery-ui-dialog';
		}

		$src = $this->use_jquery_ui_dialog() ? '/js/built/gp-nested-forms-jquery-ui.js' : '/js/built/gp-nested-forms.js';

		$scripts[] = array(
			'handle'   => 'gp-nested-forms',
			'src'      => $this->get_base_url() . $src,
			'version'  => $this->_version,
			'deps'     => $deps,
			'enqueue'  => array(
				array( $this, 'should_enqueue_frontend_script' ),
			),
			'callback' => array( $this, 'localize_scripts' ),
		);

		return array_merge( parent::scripts(), $scripts );
	}

	public function styles() {

		$min = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG || isset( $_GET['gform_debug'] ) ? '' : '.min';

		$styles = array(
			array(
				'handle'  => 'gwp-asmselect',
				'enqueue' => array(
					array( 'admin_page' => array( 'form_editor' ) ),
				),
			),
			array(
				'handle'  => 'gp-nested-forms-admin',
				'src'     => $this->get_base_url() . "/css/gp-nested-forms-admin{$min}.css",
				'version' => $this->_version,
				'deps'    => array(),
				'enqueue' => array(
					array( 'admin_page' => array( 'form_editor', 'entry_view', 'entry_edit' ) ),
				),
			),
		);

		$deps = array();
		if ( ! $this->use_jquery_ui_dialog() ) {
			$styles[] = array(
				'handle'  => 'tingle',
				'src'     => $this->get_base_url() . "/css/tingle{$min}.css",
				'version' => $this->_version,
				'enqueue' => null,
			);
			$deps[]   = 'tingle';
		}

		$styles[] = array(
			'handle'  => 'gp-nested-forms',
			'src'     => $this->get_base_url() . "/css/gp-nested-forms{$min}.css",
			'version' => $this->_version,
			'deps'    => $deps,
			'enqueue' => array(
				array( $this, 'should_enqueue_frontend_script' ),
			),
		);

		return array_merge( parent::styles(), $styles );
	}

	public function should_enqueue_frontend_script( $form ) {
		// Do not enqueue if we're inside the Elementor editor. For some reason with the add-on framework, our scripts
		// are getting enqueued while gform_gravityforms is not.
		if (
			class_exists( '\Elementor\Plugin' )
			// @phpstan-ignore-next-line
			&& method_exists( '\Elementor\Plugin', 'instance' )
			&& \Elementor\Plugin::$instance->editor->is_edit_mode()
		) {
			return false;
		}
		return ! GFForms::get_page() && ! rgempty( GFFormsModel::get_fields_by_type( $form, array( 'form' ) ) );
	}

	public function use_jquery_ui_dialog() {

		$raw = (bool) get_option( 'gpnf_use_jquery_ui' );
		/**
		 * Filter whether jQuery UI Dialog should be used to power the Nested Forms modal experience.
		 *
		 * @since 1.0-beta-8
		 *
		 * @param bool $use_jquery_ui Should jQuery UI Dialog be used to power the modal experience?
		 */
		$filtered      = (bool) apply_filters( 'gpnf_use_jquery_ui', $raw );
		$use_jquery_ui = $filtered;

		if ( $filtered !== $raw ) {
			update_option( 'gpnf_use_jquery_ui', $filtered );
		}

		return $use_jquery_ui;
	}

	public function localize_scripts( $form ) {

		wp_localize_script(
			'gp-nested-forms-admin',
			'GPNFAdminData',
			array(
				'nonces'  => array(
					'getFormFields' => wp_create_nonce( 'gpnf_get_form_fields' ),
				),
				'strings' => array(
					'getFormFieldsError' => esc_html__( 'There was an error retrieving the fields for this form. Please try again or contact support.', 'gp-nested-forms' ),
				),
			)
		);

		wp_localize_script(
			'gp-nested-forms',
			'GPNFData',
			array(
				'nonces'  => array(
					'editEntry'      => wp_create_nonce( 'gpnf_edit_entry' ),
					'refreshMarkup'  => wp_create_nonce( 'gpnf_refresh_markup' ),
					'deleteEntry'    => wp_create_nonce( 'gpnf_delete_entry' ),
					'duplicateEntry' => wp_create_nonce( 'gpnf_duplicate_entry' ),
				),
				'strings' => array(),
			)
		);

		if ( ! is_array( rgar( $form, 'fields' ) ) ) {
			return;
		}

		foreach ( $form['fields'] as $field ) {
			if ( $field->get_input_type() === 'form' ) {
				$nested_form = $this->get_nested_form( $field->gpnfForm );
				if ( ! $nested_form ) {
					continue;
				}
				foreach ( $nested_form['fields'] as $_field ) {
					if ( $_field->get_input_type() === 'fileupload' && $_field->multipleFiles ) {
						GFCommon::localize_gform_gravityforms_multifile();
					}
				}
			}
		}

	}

	/**
	 * If certain scripts are loaded *after* jQuery UI it hides the close button in the modal. If one of these scripts
	 * is enqueued, let's add it as a dependency to jQuery UI so that script will be loaded first.
	 *
	 * @deprecated 1.0-beta-8
	 *
	 * @see https://stackoverflow.com/questions/17367736/jquery-ui-dialog-missing-close-icon
	 */
	public function fix_jquery_ui_issue() {

		$deps = array(
			/**
			 * Beaver Builder Theme
			 * https://www.wpbeaverbuilder.com/
			 */
			'bootstrap',
			/**
			 * Understrap Theme
			 * https://github.com/understrap/understrap
			 */
			'understrap-scripts',
		);

		/**
		 * Filter the dependencies for jQuery UI.
		 *
		 * Allows 3rd parties to avoid the issue where the modal close button is not present if certain scripts they
		 * load are loaded - after - jQuery UI.
		 *
		 * @since 1.0-beta-5.5
		 *
		 * @param array $deps An array of script handles.
		 */
		$deps = apply_filters( 'gpnf_jquery_ui_dependencies', $deps );

		foreach ( $deps as $dep ) {
			if ( wp_script_is( $dep ) ) {
				$this->add_script_dependency( 'jquery-ui-core', $dep );
			}
		}

	}

	/**
	 * Add a dependency to an existing script.
	 *
	 * @deprecated 1.0-beta-8
	 *
	 * @see https://wordpress.stackexchange.com/questions/100709/add-a-script-as-a-dependency-to-a-registered-script
	 *
	 * @param $handle
	 * @param $dep
	 *
	 * @return bool
	 */
	public function add_script_dependency( $handle, $dep ) {
		global $wp_scripts;

		$script = $wp_scripts->query( $handle, 'registered' );
		if ( ! $script ) {
			return false;
		}

		if ( ! in_array( $dep, $script->deps ) ) {
			$script->deps[] = $dep;
		}

		return true;
	}

	public function setup_cron() {

		if ( ! wp_next_scheduled( 'gpnf_daily_cron' ) ) {
			wp_schedule_event( time(), 'daily', 'gpnf_daily_cron' );
		}

		add_action( 'gpnf_daily_cron', array( $this, 'daily_cron' ) );

	}

	public function daily_cron() {

		$expired = $this->get_expired_entries();

		$this->log( 'Running daily cron.' );
		$this->log( sprintf( 'Expired entry IDs: %s', implode( ', ', $expired ) ) );

		foreach ( $expired as $entry_id ) {

			// Move expired entries to the trash. Gravity Forms will handle deleting them from there.
			GFAPI::update_entry_property( $entry_id, 'status', 'trash' );

			// Remove expiration meta so this entry will never "expire" again.
			$entry = new GPNF_Entry( $entry_id );
			$entry->delete_expiration();

		}

	}

	public function get_expired_entries() {
		global $wpdb;

		// Orphaned entries have an expiration timestamp. If it is before the current time, it is expired.
		$expiration = time();
		$this->log( sprintf( 'Expiration Timestamp: %d', $expiration ) );

		$results   = $wpdb->get_results( $wpdb->prepare( "SELECT entry_id FROM {$wpdb->prefix}gf_entry_meta WHERE meta_key = %s and meta_value < %d", GPNF_Entry::ENTRY_EXP_KEY, $expiration ) );
		$entry_ids = wp_list_pluck( $results, 'entry_id' );

		return $entry_ids;
	}

	public function handle_core_preview_ajax() {
		if ( rgget( 'gf_page' ) == 'preview' && $this->is_nested_form_submission() && class_exists( 'GFFormDisplay' ) && ! empty( GFFormDisplay::$submission ) ) {
			echo GFForms::get_form( rgpost( 'gform_submit' ), true, true, true, null, true );
			exit;
		}
	}

	public function add_parent_form_filter( $field_filters, $form ) {

		$field_filters[] = array(
			'key'             => GPNF_Entry::ENTRY_PARENT_KEY,
			'text'            => __( 'Parent Entry ID', 'gp-nested-forms' ),
			'preventMultiple' => false,
			'operators'       => array(
				'is',
				'isnot',
			),
		);

		return $field_filters;

	}

	function add_parent_entry_link( $form_id, $entry ) {

		$parent_entry_id = rgar( $entry, 'gpnf_entry_parent' );
		$parent_form_id  = rgar( $entry, 'gpnf_entry_parent_form' );

		if ( $parent_entry_id && $parent_form_id ) {
			$parent_entry_url = '';
			$default_template = '%1$s: %2$s';
			$orphan_note      = '';

			if ( is_numeric( $parent_entry_id ) ) {
				$parent_entry_url = add_query_arg(
					array(
						'page' => 'gf_entries',
						'view' => 'entry',
						'id'   => $parent_form_id,
						'lid'  => $parent_entry_id,
					),
					admin_url( 'admin.php' )
				);
				$default_template = '%1$s: <a href="%3$s">%2$s</a>';
			} else {
				$orphan_note = gform_tooltip( 'gpnf_orphaned_child_entry', null, true );
			}

			/**
			 * Filters the template used to render the parent entry link.
			 *
			 * @param string $template            The format string used to generate the parent entry link.
			 * @param string $label               The label for the parent entry (default: "Parent Entry").
			 * @param int|string $parent_entry_id The ID of the parent entry or temporary parent hash.
			 * @param string $parent_entry_url    The URL of the parent entry detail view.
			 * @since 1.2.4
			 */
			$gpnf_parent_entry_link_template = apply_filters(
				'gpnf_parent_entry_link_template',
				$default_template,
				'Parent Entry',
				$parent_entry_id,
				$parent_entry_url
			);

			echo sprintf(
				$gpnf_parent_entry_link_template,
				esc_html( 'Parent Entry' ), // Label
				esc_html( $parent_entry_id ), // Parent entry ID
				esc_url( $parent_entry_url ) // URL
			);

			if ( $orphan_note ) {
				echo $orphan_note;
			}
		}
	}

	public function filter_entry_list( $args ) {

		$parent_entry_id      = rgget( GPNF_Entry::ENTRY_PARENT_KEY );
		$nested_form_field_id = rgget( GPNF_Entry::ENTRY_NESTED_FORM_FIELD_KEY );

		if ( ! $parent_entry_id || ! $nested_form_field_id ) {
			return $args;
		}

		// set field filters if not already set
		if ( ! isset( $args['search_criteria']['field_filters'] ) ) {
			$args['search_criteria']['field_filters'] = array();
		}

		$args['search_criteria']['field_filters'][] = array(
			'key'   => GPNF_Entry::ENTRY_PARENT_KEY,
			'value' => $parent_entry_id,
		);

		$args['search_criteria']['field_filters'][] = array(
			'key'   => GPNF_Entry::ENTRY_NESTED_FORM_FIELD_KEY,
			'value' => $nested_form_field_id,
		);

		return $args;
	}

	public function child_entry_trash_manage( $entry_id, $new_status, $old_status ) {

		$entry = new GPNF_Entry( $entry_id );

		if ( ! $entry->has_children() ) {
			return;
		}

		// Entry is trashed, send children to trash.
		if ( $new_status == 'trash' ) {
			$entry->trash_children();
		}

		// Entry is untrashed, set children to active.
		if ( $old_status == 'trash' && $new_status == 'active' ) {
			$entry->untrash_children();
		}

	}

	public function child_entry_delete( $entry_id ) {

		$entry = new GPNF_Entry( $entry_id );

		if ( $entry->has_children() ) {
			$entry->delete_children();
		}

	}



	// # ADMIN

	public function editor_field_standard_settings( $form_id ) {

		$forms = GFFormsModel::get_forms();

		?>

		<li class="gpnf-setting field_setting gp-field-setting">

			<div class="gp-row">

				<label for="gpnf-form" class="section_label">
					<?php _e( 'Nested Form', 'gp-nested-forms' ); ?>
					<?php gform_tooltip( 'gpnf_form' ); ?>
					<a href="" id="gpnf-edit-child-form" target="_blank">Edit Nested Form</a>
				</label>

				<select id="gpnf-form" onchange="SetFieldProperty( 'gpnfForm', this.value ); window.gpGlobals.GPNFAdmin.toggleNestedFormFields();" class="fieldwidth-3">
					<option value=""><?php _e( 'Select a Form', 'gp-nested-forms' ); ?></option>
					<?php
					foreach ( $forms as $form ) :
						if ( $form->id == $form_id ) {
							continue;
						}
						?>
						<option value="<?php echo $form->id; ?>">
							<?php
							echo $form->title;
							if ( ! $form->is_active ) {
								echo ' (' . __( 'Inactive', 'gp-nested-forms' ) . ')';
							}
							?>
						</option>
					<?php endforeach; ?>
				</select>

			</div>

			<div id="gpnf-form-settings" class="gp-row">

				<label for="gpnf-fields" class="section_label">
					<?php _e( 'Summary Fields', 'gp-nested-forms' ); ?>
					<?php gform_tooltip( 'gpnf_fields' ); ?>
				</label>
				<div id="gpnf-fields-container" class="gp-group">
					<select id="gpnf-fields" title="<?php esc_html_e( 'Select your fields', 'gp-nested-forms' ); ?>" class="fieldwidth-3" multiple disabled>
						<!-- dynamically populated based on selection in 'form' select -->
					</select>
					<img class="gpnf-static-spinner" src="<?php echo GFCommon::get_base_url(); ?>/images/<?php echo $this->is_gf_version_gte( '2.5-beta-1' ) ? 'spinner.svg' : 'spinner.gif'; ?>">
				</div>

			</div>

			<!-- Entry Labels -->
			<div id="gpnf-entry-labels" class="gp-row">
				<label for="gpnf-entry-label-singular" class="section_label">
					<?php esc_html_e( 'Entry Labels', 'gp-nested-forms' ); ?>
					<?php gform_tooltip( 'gpnf_entry_labels' ); ?>
				</label>
				<div class="gp-group">
					<label for="gpnf-entry-label-singular">
						<?php _e( 'Singular', 'gp-nested-forms' ); ?>
					</label>
					<input type="text" id="gpnf-entry-label-singular" placeholder="<?php esc_html_e( 'e.g. Entry', 'gp-nested-forms' ); ?>" onchange="SetFieldProperty( 'gpnfEntryLabelSingular', jQuery( this ).val() );" />
				</div>
				<div class="gp-group">
					<label for="gpnf-entry-label-plural">
						<?php _e( 'Plural', 'gp-nested-forms' ); ?>
					</label>
					<input type="text" id="gpnf-entry-label-plural" placeholder="<?php esc_html_e( 'e.g. Entries', 'gp-nested-forms' ); ?>" onchange="SetFieldProperty( 'gpnfEntryLabelPlural', jQuery( this ).val() );" />
				</div>
			</div>

		</li>

		<?php
	}

	public function editor_field_appearance_settings() {
		?>

		<li class="gpnf-modal-header-color-setting field_setting" style="display:none;">

			<label for="gpnf-modal-header-color" class="section_label">
				<?php _e( 'Modal Color', 'gp-nested-forms' ); ?>
				<?php gform_tooltip( 'gpnf_modal_header_color' ); ?>
			</label>

			<div class="gp-group">
				<input type="text" class="iColorPicker" onchange="SetFieldProperty( 'gpnfModalHeaderColor', this.value );" id="gpnf-modal-header-color" />
				<img id="chip_gpnf-modal-header-color" height="24" width="24" src="<?php echo GFCommon::get_base_url(); ?>/images/blankspace.png" />
				<img id="chooser_gpnf-modal-header-color" height="16" width="16" src="<?php echo GFCommon::get_base_url(); ?>/images/color.png" />
			</div>

		</li>

		<?php
	}

	public function editor_field_advanced_settings() {
		?>

		<li class="gpnf-entry-limits-setting field_setting gp-field-setting" id="gpnf-entry-limits" style="display:none;">

			<label for="gpnf-entry-limit-min" class="section_label">
				<?php esc_html_e( 'Entry Limits', 'gp-nested-forms' ); ?>
				<?php gform_tooltip( 'gpnf_entry_limits' ); ?>
			</label>

			<div class="gp-group">
				<label for="gpnf-entry-limit-min">
					<?php _e( 'Minimum', 'gp-nested-forms' ); ?>
				</label>
				<input type="number" id="gpnf-entry-limit-min" placeholder="<?php esc_html_e( 'e.g. 2', 'gp-nested-forms' ); ?>" onchange="SetFieldProperty( 'gpnfEntryLimitMin', jQuery( this ).val() );" />
			</div>

			<div class="gp-group">
				<label for="gpnf-entry-limit-max">
					<?php _e( 'Maximum', 'gp-nested-forms' ); ?>
				</label>
				<input type="number" id="gpnf-entry-limit-max" placeholder="<?php esc_html_e( 'e.g. 5', 'gp-nested-forms' ); ?>" onchange="SetFieldProperty( 'gpnfEntryLimitMax', jQuery( this ).val() );" />
			</div>

		</li>

		<?php if ( apply_filters( 'gpnf_enable_feed_processing_setting', false ) ) : ?>
			<li class="gpnf-feed-processing-setting field_setting" id="gpnf-feed-processing-setting" style="display:none;">

				<label for="gpnf-feed-processing" class="section_label">
					<?php esc_html_e( 'Feed Processing', 'gp-nested-forms' ); ?>
					<?php gform_tooltip( 'gpnf_feed_processing' ); ?>
				</label>

				<span><?php esc_html_e( 'Process nested feeds when the', 'gp-nested-forms' ); ?></span>
				<select id="gpnf-feed-processing" onchange="SetFieldProperty( 'gpnfFeedProcessing', jQuery( this ).val() );">
					<option value="parent"><?php esc_html_e( 'parent form', 'gp-nested-forms' ); ?></option>
					<option value="child"><?php esc_html_e( 'nested form', 'gp-nested-forms' ); ?></option>
				</select>
				<span><?php esc_html_e( 'is submitted.', 'gp-nested-forms' ); ?></span>

			</li>
		<?php endif; ?>

		<?php
	}



	// # GENERAL FUNCTIONALITY

	/**
	 * Enqueue child scripts/styles at the same time as the parent.
	 *
	 * This resolves an issue with GF Tooltip where there inline styles were being output *before* the child form's
	 * inline styles had been enqueued. The child form styles were thus enqueued by not never output.
	 *
	 * @param $form
	 */
	public function enqueue_child_form_scripts( $form ) {

		if ( empty( $form['fields'] ) || ! is_array( $form['fields'] ) ) {
			return;
		}

		foreach ( $form['fields'] as $field ) {

			if ( $field->type !== 'form' ) {
				continue;
			}

			$nested_form_id = rgar( $field, 'gpnfForm' );
			$nested_form    = $this->get_nested_form( $nested_form_id );

			if ( rgar( $nested_form, 'fields' ) ) {
				GFFormDisplay::enqueue_form_scripts( $nested_form, true );
			}
		}

	}

	public function get_nested_forms_markup( $form ) {
		global $wp_filter;

		do_action( 'gpnf_pre_nested_forms_markup', $form );

		// I'm not a huge fan of this... but Gravity Forms is promoting a snippet that wraps all GF inline scripts in a
		// DOMContentLoaded event listener. This prevents child form markup from being properly initialized. As a stop-gap
		// solution, let's unbind (and later rebind) all functions on the 'gform_cdata_open' filter.
		$cdata_open_filters  = rgar( $wp_filter, 'gform_cdata_open' );
		$cdata_close_filters = rgar( $wp_filter, 'gform_cdata_close' );

		if ( $cdata_open_filters ) {
			unset( $wp_filter['gform_cdata_open'] );
			unset( $wp_filter['gform_cdata_close'] );
		}

		ob_start();

		foreach ( $form['fields'] as $field ) :

			if ( $field->type != 'form' ) {
				continue;
			}

			$nested_form_id = rgar( $field, 'gpnfForm' );
			$nested_form    = $this->get_nested_form( $nested_form_id );

			if ( ! $nested_form ) {
				$data = array(
					'nested_field_id' => $field->id,
					'nested_form_id'  => $nested_form_id,
				);
				$this->log( sprintf( $nested_form_id ? 'No nested form ID is configured for this field: %s' : 'Nested form does not exist: %s', print_r( $data, true ) ) );
				continue;
			}

			?>

			<div class="gpnf-nested-form gpnf-nested-form-<?php echo $form['id']; ?>-<?php echo $field['id']; ?>" style="display:none;">
				<?php
				if ( $this->use_jquery_ui_dialog() ) {
					$this->load_nested_form_hooks( $nested_form_id, $form['id'] );

					gravity_form( $nested_form_id, false, true, $this->is_preview(), $this->get_stashed_shortcode_field_values( $form['id'] ), true, $this->get_tabindex() );

					$this->unload_nested_form_hooks( $nested_form_id, $form );
				} else {
					/**
					 * Preload the form but do not echo it out. This is important for making sure all CSS/JS gets
					 * enqueued if enqueueing logic during the form.
					 *
					 * This addition was necessary for compatibility with GP Populate Anything's Live Merge Tags.
					 *
					 * @param boolean  $value Whether or not to pre-load (but not echo to document) the form.
					 * @param array    $form  The current form.
					 * @since 1.0-beta-9.4
					 */
					if ( gf_apply_filters( array( 'gpnf_preload_form', $form['id'] ), true, $form ) ) {
						// Store hooks_js_printed, so we can know if this child form impacts the state of the variable.
						// Needed after GF 2.8.9.1
						$hooks_js_printed = GFFormDisplay::$hooks_js_printed;

						add_filter( 'gform_init_scripts_footer', '__return_false', 123 );
						/* Ensure that the last param ($echo) is false so it does not get rendered out. */
						gravity_form( $nested_form_id, false, true, $this->is_preview(), $this->get_stashed_shortcode_field_values( $form['id'] ), true, $this->get_tabindex(), false );
						remove_filter( 'gform_init_scripts_footer', '__return_false', 123 );

						if ( $hooks_js_printed !== GFFormDisplay::$hooks_js_printed ) {
							GFFormDisplay::$hooks_js_printed = $hooks_js_printed;
						}
					}

					echo '<!-- Loaded dynamically via AJAX -->';
				}
				?>
			</div>

			<div class="gpnf-edit-form gpnf-edit-form-<?php echo $form['id']; ?>-<?php echo $field['id']; ?>" style="display:none;">
				<!-- Loaded dynamically via AJAX -->
			</div>

			<?php
		endforeach;

		if ( $cdata_open_filters ) {
			$wp_filter['gform_cdata_open']  = $cdata_open_filters;
			$wp_filter['gform_cdata_close'] = $cdata_close_filters;
		}

		do_action( 'gpnf_nested_forms_markup', $form );

		return ob_get_clean();
	}

	public function get_tabindex() {
		return GFCommon::$tab_index > 1 ? GFCommon::$tab_index++ : 0;
	}

	/**
	 * Output all queued nested forms markup.
	 */
	public static function output_nested_forms_markup() {
		foreach ( self::$nested_forms_markup as $markup ) {
			echo $markup;
		}
	}

	public function register_entry_meta( $meta ) {

		$meta[ GPNF_Entry::ENTRY_PARENT_KEY ] = array(
			'label'      => esc_html__( 'Parent Entry ID', 'gp-nested-forms' ),
			'is_numeric' => true,
		);

		$meta[ GPNF_Entry::ENTRY_PARENT_FORM_KEY ] = array(
			'label'      => esc_html__( 'Parent Entry Form ID', 'gp-nested-forms' ),
			'is_numeric' => true,
		);

		$meta[ GPNF_Entry::ENTRY_NESTED_FORM_FIELD_KEY ] = array(
			'label'      => esc_html__( 'Child Form Field ID', 'gp-nested-forms' ),
			'is_numeric' => true,
		);

		return $meta;
	}

	public function process_merge_tags( $formula, $field, $form, $entry ) {

		preg_match_all( '/{[^{]*?:([0-9]+):(sum|total|count|set)=?([0-9]*)}/', $formula, $matches, PREG_SET_ORDER );
		foreach ( $matches as $match ) {

			list( $search, $nested_form_field_id, $func, $target_field_id ) = $match;

			$nested_form_field = GFFormsModel::get_field( $form, $nested_form_field_id );
			if ( ! $nested_form_field ) {
				continue;
			}

			$nested_form  = $this->get_nested_form( $nested_form_field->gpnfForm );
			$target_field = GFFormsModel::get_field( $nested_form, $target_field_id );
			$replace      = '';

			$_entry = new GPNF_Entry( $entry );

			/**
			 * Filter the child entries used for Nested Forms' calculation merge tag modifiers such as :count, :sum,
			 * and more. This is useful for conditionally including/excluding entries while calculating the results.
			 *
			 * @param array $entries Child entries to be used for calculations
			 * @param array $match Information about the matched merge tag.
			 * @param GF_Field $field Current Nested Form field.
			 * @param array $form Current child form.
			 * @param GF_Field $formula_field The formula field with the merge tag in it.
			 *
			 * @since 1.1.5
			 *
			 */
			$child_entries = gf_apply_filters( array( 'gpnf_calc_entries', $form['id'], $nested_form_field['id'] ), $_entry->get_child_entries( $nested_form_field_id ), array(
				$search,
				$nested_form_field_id,
				$func,
				$target_field_id,
			), $nested_form_field, $form, $field );

			switch ( $func ) {
				case 'sum':
					$total = 0;
					foreach ( $child_entries as $child_entry ) {
						if ( $target_field && $target_field->type === 'product' ) {
							$total += (float) $this->get_product_sum_value( $target_field, $child_entry, $nested_form, $entry['currency'] );
						} else {
							$total += (float) GFCommon::to_number( rgar( $child_entry, $target_field_id ), $entry['currency'] );
						}
					}
					$replace = $total;
					break;
				case 'total':
					$total = 0;
					foreach ( $child_entries as $child_entry ) {
						$total += (float) GFCommon::get_order_total( $nested_form, $child_entry );
					}
					$replace = $total;
					break;
				case 'count':
					$replace = count( $child_entries );
					break;
				case 'set':
					$items = array();
					foreach ( $child_entries as $child_entry ) {
						$items[] = (float) GFCommon::to_number( rgar( $child_entry, $target_field_id ), $entry['currency'] );
					}
					$replace = implode( ', ', $items );
					break;
			}

			/*
			 * When using very small numbers (such as 0.000001) in values, PHP will use scientific notation instead
			 * of decimals which will result in the replacement value being a string and having characters that will
			 * be rejected by the eval() protection regular expression.
			 *
			 * Using sprintf(), we can force the number back to a decimal notation.
			 */
			$replace = is_numeric( $replace ) ? sprintf( '%F', $replace ) : $replace;

			/**
			 * Filter the replacement values for Nested Forms calculation merge tag modifiers such as :sum.
			 *
			 * @param float $replace Replacement value to use for the merge tag in the calculation.
			 * @param array $match Information about the matched merge tag.
			 * @param array $entries Child entries to be used for calculations
			 * @param GF_Field $field Current Nested Form field.
			 * @param array $form Current child form.
			 * @param GF_Field $formula_field The formula field with the merge tag in it.
			 *
			 * @since 1.1.5
			 *
			 */
			$replace = gf_apply_filters( array( 'gpnf_calc_replacement_value', $form['id'], $nested_form_field['id'] ), $replace, array(
				$search,
				$nested_form_field_id,
				$func,
				$target_field_id,
			), $child_entries, $nested_form_field, $form, $field );

			$formula = str_replace( $search, $replace, $formula );

		}

		return $formula;
	}

	/**
	 * Get the numeric value used by :sum when targeting a Product field.
	 *
	 * @param GF_Field $product_field Product field object.
	 * @param array    $entry Child entry.
	 * @param array    $form Child form.
	 * @param string   $currency Currency code.
	 *
	 * @return float
	 */
	public function get_product_sum_value( $product_field, $entry, $form, $currency ) {

		$product_value = GFFormsModel::get_lead_field_value( $entry, $product_field );
		$quantity      = $this->get_product_quantity( $product_field, $entry, $form );
		$price         = '';

		if ( is_array( $product_value ) ) {
			$price = rgar( $product_value, "{$product_field->id}.2" );
		} elseif ( is_string( $product_value ) && strpos( $product_value, '|' ) !== false ) {
			$parts = explode( '|', $product_value );
			$price = array_pop( $parts );
		} elseif ( ! is_array( $product_value ) ) {
			$price = $product_value;
		}

		if ( rgblank( $price ) || empty( $quantity ) ) {
			return 0;
		}

		$unit_price = (float) GFCommon::to_number( $price, $currency );

		return $unit_price * (float) $quantity;
	}

	public function add_nested_form_field_total_merge_tag( $merge_tags ) {
		return $merge_tags;
	}

	public function stash_shortcode_field_values( $form_args ) {
		$this->shortcode_field_values[ $form_args['form_id'] ] = $form_args['field_values'];
		return $form_args;
	}

	public function get_stashed_shortcode_field_values( $form_id ) {
		return rgar( $this->shortcode_field_values, $form_id );
	}

	// # AJAX

	public function ajax_get_form_fields() {

		if ( ! wp_verify_nonce( rgpost( 'nonce' ), 'gpnf_get_form_fields' ) ) {
			die( __( 'Oops! You don\'t have permission to get fields for this form.', 'gp-nested-forms' ) );
		}

		$form_id = rgpost( 'form_id' );
		$form    = $this->get_nested_form( $form_id );
		$form    = $this->add_row_id_field( $form );

		wp_send_json( $form['fields'] );

	}

	public function ajax_delete_entry() {

		//usleep( 500000 ); // @todo Remove!

		if ( ! wp_verify_nonce( rgpost( 'nonce' ), 'gpnf_delete_entry' ) ) {
			wp_send_json_error( __( 'Oops! You don\'t have permission to delete this entry.', 'gp-nested-forms' ) );
		}

		$entry_id = $this->get_posted_entry_id();
		$entry    = GFAPI::get_entry( $entry_id );

		if ( is_wp_error( $entry ) ) {
			wp_send_json_error( __( 'Oops! There was an error finding an entry. Did you pass a valid entry_id?', 'gp-nested-forms' ) );
		}

		if ( ! GPNF_Entry::can_current_user_edit_entry( $entry ) ) {
			wp_send_json_error( __( 'Oops! You don\'t have permission to delete this entry.', 'gp-nested-forms' ) );
		}

		/**
		 * Filter whether GPNF should trash child entries when they are deleted on the front-end.
		 *
		 * @param boolean  $should_trash_entries Should entries be trashed on delete? (default: false)
		 * @since 1.0-beta-10.1
		 */
		if ( gf_apply_filters( array( 'gpnf_should_trash_entries_on_delete', $entry['form_id'] ), false ) ) {
			$result = GFAPI::update_entry_property( $entry_id, 'status', 'trash' );
		} else {
			$result = GFAPI::delete_entry( $entry_id );
		}

		if ( is_wp_error( $result ) ) {
			wp_send_json_error( $result->get_error_message() );
		} else {
			wp_send_json_success();
		}

	}

	/**
	 * Sets the child form theme to match the parent. Needed for GF 2.9+.
	 *
	 * @see GP_Nested_Forms::ajax_refresh_markup()
	 * @see GP_Nested_Forms::ajax_edit_entry()
	 *
	 * @param string $slug The form theme slug.
	 * @param array $form The form object.
	 */
	public function set_form_theme_slug_for_child( $slug, $form ) {
		if ( ! wp_doing_ajax() ) {
			return $slug;
		}

		// $_POST gets emptied out at this point.
		$form_theme = rgar( $_REQUEST, 'form_theme' );

		if ( empty( $form_theme ) ) {
			return $slug;
		}

		return $form_theme;
	}

	/**
	 * Fetch the form with the entry pre-populated, ready for editing.
	 */
	public function ajax_edit_entry() {

		if ( ! wp_verify_nonce( rgpost( 'nonce' ), 'gpnf_edit_entry' ) ) {
			die( __( 'Oops! You don\'t have permission to edit this entry.', 'gp-nested-forms' ) );
		}

		$entry_id = $this->get_posted_entry_id();
		$entry    = GFAPI::get_entry( $entry_id );
		$form_id  = $entry['form_id'];

		if ( ! $entry ) {
			die( __( 'Oops! We can\'t locate that entry.', 'gp-nested-forms' ) );
		}

		if ( ! GPNF_Entry::can_current_user_edit_entry( $entry ) ) {
			die( __( 'Oops! You don\'t have permission to edit this entry.', 'gp-nested-forms' ) );
		}

		/**
		 * Needed for rehydrating Signature Field
		 */
		$GLOBALS['gpnf_current_edit_entry'] = $entry;

		ob_start();

		add_filter( 'gform_form_theme_slug', array( $this, 'set_form_theme_slug_for_child' ), 10, 2 );
		add_filter( 'gform_pre_render_' . $form_id, array( $this, 'prepare_form_for_population' ) );
		add_filter( 'gform_form_tag', array( $this, 'set_edit_form_action' ) );
		add_filter( 'gwlc_is_edit_view', '__return_true' );
		add_filter( 'gwlc_selected_values', array( $this, 'set_gwlc_selected_values' ), 20, 2 );

		add_filter( 'gform_get_form_filter_' . $form_id, array( $this, 'replace_post_render_trigger' ), 10, 2 );
		add_filter( 'gform_footer_init_scripts_filter_' . $form_id, array( $this, 'replace_post_render_trigger' ), 10, 2 );

		$this->get_parent_form_id();
		add_filter( 'gform_form_tag', array( $this, 'add_nested_inputs' ), 10, 2 );
		add_filter( 'gform_field_value', array( $this, 'populate_field_from_session_cookie' ), 10, 3 );

		gravity_form( $form_id, false, false, false, $this->prepare_entry_for_population( $entry ), true, $this->get_tabindex() );

		/**
		 * footer_init_scripts does not run by default if explicitly loading the form with AJAX enabled in GF >2.5.
		 */
		if ( $this->is_gf_version_gte( '2.5-beta-1' ) && apply_filters( 'gform_init_scripts_footer', false ) ) {
			GFFormDisplay::footer_init_scripts( $form_id );
		}

		$markup = trim( ob_get_clean() );

		/**
		 * This previously just use to send the string using wp_send_json(), but when used with Weglot Translate, the
		 * JSON string was malformed.
		 *
		 * Sending an object resolves the issue.
		 */
		wp_send_json( array(
			'formHtml' => $markup,
		) );
	}

	public function ajax_refresh_markup() {

		if ( ! wp_verify_nonce( rgpost( 'nonce' ), 'gpnf_refresh_markup' ) ) {
			die( __( 'Oops! You don\'t have permission to do this.', 'gp-nested-forms' ) );
		}

		$form_id = $this->get_parent_form_id();
		$form    = GFAPI::get_form( $form_id );

		$nested_form_field_id = $this->get_posted_nested_form_field_id();
		$nested_form_field    = GFFormsModel::get_field( $form, $nested_form_field_id );
		$nested_form_id       = rgar( $nested_form_field, 'gpnfForm' );

		// Display an error if the child form contains a nested form as well
		if ( $this->has_child_form( $nested_form_id ) ) {
			// GF 2.5 border color
			$border_color = ( version_compare( GFForms::$version, '2.5.0', '>=' ) ) ? '#ddd' : '#D2E0EB';
			wp_send_json( sprintf(
				'<div class="gpnf-nested-entries-container ginput_container"><p style=" border: 1px dashed %s; border-radius: 3px; padding: 1rem; background: #fff; "><strong style="color: #ca4a1f;">%s</strong><br>%s</p></div>',
				$border_color,
				__( 'Configuration Error', 'gp-nested-forms' ),
				__( 'Child forms cannot contain nested forms. Please edit the child form and remove any nested form fields in it.', 'gp-nested-forms' )
			) );
			wp_die();
		}

		add_filter( 'gform_form_theme_slug', array( $this, 'set_form_theme_slug_for_child' ), 10, 2 );

		$nested_form   = GFAPI::get_form( $nested_form_id );
		$require_login = rgar( $nested_form, 'requireLogin' );
		if ( $require_login && ! is_user_logged_in() ) {
			// GF 2.5 border color
			$border_color = ( version_compare( GFForms::$version, '2.5.0', '>=' ) ) ? '#ddd' : '#D2E0EB';
			wp_send_json( sprintf(
				'<div class="gpnf-nested-entries-container ginput_container"><p style=" border: 1px dashed %s; border-radius: 3px; padding: 1rem; background: #fff; "><strong style="color: #ca4a1f;">%s</strong><br>%s</p></div>',
				$border_color,
				__( 'Sorry. You must be logged in to view this form.', 'gp-nested-forms' ),
				sprintf( '%s', $nested_form['requireLoginMessage'] )
			) );
		}

		ob_start();

		$this->load_nested_form_hooks( $nested_form_id, $form_id );
		add_filter( 'gform_form_tag', array( $this, 'set_edit_form_action' ) );
		add_filter( 'gform_field_value', array( $this, 'populate_field_from_session_cookie' ), 10, 3 );

		$field_values = rgars( $_REQUEST, 'gpnf_context/field_values' );

		// Clear the post so Gravity Forms will use isSelected property on choice-based fields and not try to determine
		// isSelected based on posted values. I'm betting this will resolve many other unknown issues as well.
		$_POST = array();

		gravity_form( $nested_form_id, false, true, true, $field_values, true, $this->get_tabindex() );

		/**
		 * footer_init_scripts does not run by default if explicitly loading the form with AJAX enabled in GF >2.5.
		 */
		if ( $this->is_gf_version_gte( '2.5-beta-1' ) && apply_filters( 'gform_init_scripts_footer', false ) ) {
			GFFormDisplay::footer_init_scripts( $nested_form_id );
		}

		$this->unload_nested_form_hooks( '', $nested_form_id );

		$markup = trim( ob_get_clean() );

		/**
		 * This previously just use to send the string using wp_send_json(), but when used with Weglot Translate, the
		 * JSON string was malformed.
		 *
		 * Sending an object resolves the issue.
		 */
		wp_send_json( array(
			'formHtml' => $markup,
		) );

	}

	public function ajax_duplicate_entry() {

		if ( ! wp_verify_nonce( rgpost( 'nonce' ), 'gpnf_duplicate_entry' ) ) {
			wp_send_json_error( __( 'Oops! You don\'t have permission to duplicate this entry.', 'gp-nested-forms' ) );
		}

		$entry_id             = $this->get_posted_entry_id();
		$parent_form_id       = $this->get_posted_parent_form_id();
		$nested_form_field_id = $this->get_posted_nested_form_field_id();

		/**
		 * Filter the child entry that will be duplicated.
		 *
		 * @since 1.0
		 *
		 * @param array $entry                The entry that will be duplicated.
		 * @param int   $entry_id             The ID of the entry that will be duplicated.
		 * @param int   $parent_form_id       The ID of the form that contains the Nested Form field.
		 * @param int   $nested_form_field_id The ID of the Nested Form field for which the entry is being duplicated.
		 */
		$entry = gf_apply_filters( array( 'gpnf_duplicate_entry', $parent_form_id, $nested_form_field_id ), GFAPI::get_entry( $entry_id ), $entry_id, $parent_form_id, $nested_form_field_id );

		if ( ! GPNF_Entry::can_current_user_edit_entry( $entry ) ) {
			wp_send_json_error( __( 'Oops! You don\'t have permission to duplicate this entry.', 'gp-nested-forms' ) );
		}

		// Prepare the entry for duplication.
		unset( $entry['id'] );

		$dup_entry_id = GFAPI::add_entry( $entry );

		if ( is_wp_error( $dup_entry_id ) ) {
			wp_send_json_error( $dup_entry_id->get_error_message() );
		}

		$parent_form       = GFAPI::get_form( $this->get_posted_parent_form_id() );
		$nested_form_field = $this->get_posted_nested_form_field( $parent_form );
		$child_form        = GFAPI::get_form( $nested_form_field->gpnfForm );

		// Note: Entry meta included in the passed entry will also be duplicated.
		$dup_entry    = GFAPI::get_entry( $dup_entry_id );
		$field_values = gp_nested_forms()->get_entry_display_values( $dup_entry, $child_form );

		// Attach session meta to child entry.
		$session = new GPNF_Session( $parent_form['id'] );
		$session->add_child_entry( $dup_entry_id );

		// set args passed back to entry list on front-end
		$args = array(
			'formId'      => $parent_form['id'],
			'fieldId'     => $nested_form_field->id,
			'entryId'     => $dup_entry_id,
			'entry'       => $dup_entry,
			'fieldValues' => $field_values,
			'mode'        => 'add',
		);

		wp_send_json_success( $args );

	}

	public function ajax_session() {

		$form_id = rgpost( 'form_id' );

		$session = new GPNF_Session( $form_id );
		$session
			->set_session_data()
			->set_cookie();

		die();

	}



	// # VALUES

	public function get_child_entry_ids_from_value( $value ) {
		// For child entry ids passed over URLs, the comma character may have encoded to %2C which must be decoded before processing.
		$child_entry_ids = is_string( $value ) ? explode( ',', urldecode( $value ) ) : array();
		foreach ( $child_entry_ids as &$child_entry_id ) {
			// We typecast the value as an integer for consistency and to as a security measure. See PR #77.
			$child_entry_id = (int) trim( $child_entry_id );
		}
		$child_entry_ids = array_filter( $child_entry_ids );
		return $child_entry_ids;
	}

	public function get_entries( $entry_ids ) {

		$entries = array();

		if ( empty( $entry_ids ) ) {
			return $entries;
		}

		if ( is_string( $entry_ids ) ) {
			$entry_ids = $this->get_child_entry_ids_from_value( $entry_ids );
		} elseif ( ! is_array( $entry_ids ) ) {
			$entry_ids = array( $entry_ids );
		}

		foreach ( $entry_ids as $entry_id ) {
			$entry = GFAPI::get_entry( (int) $entry_id );
			if ( ! is_wp_error( $entry ) ) {
				$entries[] = GFAPI::get_entry( $entry_id );
			}
		}

		return $entries;
	}

	public function get_entry_url( $entry_id, $form_id ) {
		/**
		 * Filter the URL for entry detail view per entry.
		 *
		 * @since 1.0-beta-4.16
		 *
		 * @param string $entry_url The URL to a specific entry's detail view.
		 * @param int    $entry_id  The current entry ID.
		 * @param int    $form_id   The current form ID.
		 */
		return gf_apply_filters( array( 'gpnf_entry_url', $form_id ), admin_url( "admin.php?page=gf_entries&view=entry&id={$form_id}&lid={$entry_id}" ), $entry_id, $form_id );
	}

	public function all_fields_value( $value, $merge_tag, $modifiers, $field, $raw_value, $format = 'html' ) {

		// Only process for Nested Form fields - and - if All Fields template has not filtered this field out (i.e. false).
		if ( $field->type != 'form' || $value === false ) {
			return $value;
		}

		$nested_form_id = rgar( $field, 'gpnfForm' );
		$nested_form    = $this->get_nested_form( $nested_form_id );

		if ( ! $nested_form ) {
			$data = array(
				'nested_field_id' => $field->id,
				'nested_form_id'  => $nested_form_id,
			);
			$this->log( sprintf( $nested_form_id ? 'No nested form ID is configured for this field: %s' : 'Nested form does not exist: %s', print_r( $data, true ) ) );
			return $value;
		}

		$is_all_fields = $merge_tag === 'all_fields';
		$modifiers     = $is_all_fields ? "context[nested],parent[{$field->id}]," . $modifiers : $modifiers;

		// Allow changing the format based on the modifier. Example: {Nested Form:1:index[0],filter[3],format[text]}
		$format = $this->parse_modifier( 'format', $modifiers ) ? $this->parse_modifier( 'format', $modifiers ) : $format;

		// When filtering down to a single field from the child form (via All Fields Template), show simplified template.
		if ( $this->is_filtered_single( $modifiers, $field, $is_all_fields ) ) {
			$index = $this->parse_modifier( 'index', $modifiers );
			if ( $index !== false ) {
				return $this->get_single_value( $index, $field, $value, $modifiers, $format );
			}
			return $this->get_filtered_single_template( $field, $raw_value, $modifiers, $format );
		}

		// When not filtering a single field, but filtering a single index.
		$index = $this->parse_modifier( 'index', $modifiers );
		if ( is_numeric( $index ) ) {
			$values = explode( ',', $raw_value );
			if ( $index < 0 ) {
				$index = count( $values ) + $index;
				$index = max( $index, 0 );
			}
			if ( isset( $values[ $index ] ) ) {
				$raw_value = $values[ $index ];
			}
		}

		// Provide opportunity for users to override the all entries template; no core template provided.
		return $this->get_all_entries_template( $field, $raw_value, $modifiers, $merge_tag, $format );
	}

	/**
	 * @param string $modifiers
	 * @param boolean $standard_mode Due to the dependency on All Fields Template, there are multiple ways to parse
	 *   the modifiers. All Fields Template utilizes commas when combining multiple modifiers
	 *   such as {Nested Form A:1:filter[1],value}
	 *
	 * @return array
	 */
	public function parse_modifiers( $modifiers, $standard_mode = false ) {

		if ( empty( $modifiers ) ) {
			return array();
		}

		if ( $standard_mode ) {
			$parsed = explode( ',', $modifiers );
			$parsed = array_fill_keys( $parsed, $parsed );
		} elseif ( is_callable( 'gw_all_fields_template' ) ) {
			$parsed = gw_all_fields_template()->parse_modifiers( $modifiers );
		} else {
			$parsed = array();
		}

		return $parsed;
	}

	public function parse_modifier( $modifier, $modifiers ) {
		$standard_modifiers = array( 'value' );
		$modifiers          = $this->parse_modifiers( $modifiers, in_array( $modifier, $standard_modifiers, true ) );
		// rgar() returns false when modifier is 0
		return isset( $modifiers[ $modifier ] ) ? $modifiers[ $modifier ] : false;
	}

	public function get_template_names( $base, $form_id, $field_id, $custom_suffix = false ) {
		$template_names = array(
			sprintf( '%s-%s-%s.php', $base, $form_id, $field_id ),
			sprintf( '%s-%s.php', $base, $form_id ),
			sprintf( '%s.php', $base ),
		);

		if ( $custom_suffix ) {
			$custom_template_names = array();

			foreach ( $template_names as $template_name ) {
				$custom_template_names[] = str_replace( $base, $base . '-' . $custom_suffix, $template_name );
			}

			$template_names = array_merge( $custom_template_names, $template_names );
		}

		return $template_names;
	}

	/**
	 * This template is used to render all entries for Nested Form field merge tags - and - the {all_fields} merge tag.
	 *
	 * @param $field
	 * @param $value
	 *
	 * @return string
	 */
	public function get_all_entries_template( $field, $value, $modifiers, $merge_tag, $format = 'html' ) {

		$template         = new GP_Template( gp_nested_forms() );
		$template_name    = 'nested-entries-all';
		$nested_field_ids = rgar( $field, 'gpnfFields' );
		$nested_form      = $this->get_nested_form( rgar( $field, 'gpnfForm' ) );

		$args = array(
			'template'             => $template_name,
			'field'                => $field,
			'nested_form'          => $nested_form,
			'nested_fields'        => gp_nested_forms()->get_fields_by_ids( $nested_field_ids, $nested_form ),
			'nested_field_ids'     => $nested_field_ids,
			'value'                => $value,
			'entries'              => gp_nested_forms()->get_entries( $value ),
			'column_count'         => null,
			'related_entries_link' => null,
			'actions'              => array(),
			'labels'               => array(),
			'modifiers'            => $modifiers,
			'is_all_fields'        => $merge_tag == 'all_fields',
			'format'               => $format,
		);

		/** Documented in GP_Field_Nested_Form::get_value_entry_detail(). */
		$args = gf_apply_filters( array( 'gpnf_template_args', $field->formId, $field->id ), $args, $this );

		if ( ! $args['entries'] ) {
			return null;
		}

		$markup = $template->parse_template(
			gp_nested_forms()->get_template_names( $args['template'], $field->formId, $field->id, $this->parse_modifier( 'template', $modifiers ) ),
			true,
			false,
			$args
		);

		return $markup;
	}

	public function is_filtered_single( $modifiers, $nested_form_field, $is_all_fields ) {

		$filter = $this->parse_modifier( 'filter', $modifiers );
		if ( ! $filter ) {
			return false;
		}

		if ( $is_all_fields ) {

			if ( ! is_array( $filter ) ) {
				$filter = array( $filter );
			}

			$field_ids = array();
			foreach ( $filter as $field_id ) {
				// Convert "1.1" to "1" and make sure we're only doing field-specific NF (e.g. "1.1" vs "1").
				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 );
					if ( count( $field_ids ) > 1 ) {
						return false;
					}
				}
			}
		}
		// If it's not the {all_fields} merge tag and the filter is an array, we know it's more than one field.
		elseif ( is_array( $filter ) ) {
			return false;
		}

		return true;
	}

	public function get_filtered_single_template( $field, $value, $modifiers, $format = 'html' ) {

		$template    = new GP_Template( gp_nested_forms() );
		$nested_form = $this->get_nested_form( rgar( $field, 'gpnfForm' ) );
		$entry_ids   = $this->get_child_entry_ids_from_value( $value );

		$args = array(
			'template'    => 'nested-entries-simple-list',
			'field'       => $field,
			'nested_form' => $nested_form,
			'modifiers'   => $modifiers,
			'entry_ids'   => $entry_ids,
			'items'       => $this->get_simple_list_items( $entry_ids, $nested_form, $modifiers, $format ),
			'format'      => $format,
		);

		/** Documented in GP_Field_Nested_Form::get_value_entry_detail(). */
		$args = gf_apply_filters( array( 'gpnf_template_args', $field->formId, $field->id ), $args, $this );

		$markup = $template->parse_template(
			gp_nested_forms()->get_template_names( $args['template'], $field->formId, $field->id, $this->parse_modifier( 'template', $modifiers ) ),
			true,
			false,
			$args
		);

		return $markup;
	}

	public function get_single_value( $index, $field, $value, $modifiers, $format = 'html' ) {

		$nested_form = $this->get_nested_form( rgar( $field, 'gpnfForm' ) );
		$entry_ids   = $this->get_child_entry_ids_from_value( $value );
		$items       = $this->get_simple_list_items( $entry_ids, $nested_form, $modifiers, $format );

		if ( $index < 0 ) {
			$count  = count( $items );
			$index += $count;
			$index  = max( $index, 0 );
		}

		return rgars( $items, "{$index}/value" );
	}

	public function get_simple_list_items( $entry_ids, $nested_form, $modifiers, $format = 'html' ) {

		if ( ! is_callable( 'gw_all_fields_template' ) ) {
			return array();
		}

		$items    = array();
		$use_text = ! in_array( 'value', explode( ',', $modifiers ), true );

		foreach ( $entry_ids as $entry_id ) {

			$entry = GFAPI::get_entry( $entry_id );
			if ( is_wp_error( $entry ) ) {
				continue;
			}

			$items = array_merge( $items, gw_all_fields_template()->get_items( $nested_form, $entry, true, $use_text, $format, false, '', $modifiers ) );

		}

		return $items;
	}

	public function get_all_entries_markup( $field, $value, $modifiers, $is_all_fields, $format = 'html' ) {

		$template    = new GP_Template( gp_nested_forms() );
		$entry_ids   = $this->get_child_entry_ids_from_value( $value );
		$nested_form = $this->get_nested_form( rgar( $field, 'gpnfForm' ) );

		$values = array();
		/** Documented in GP_Field_Nested_Form::get_value_entry_detail(). */
		$args = gf_apply_filters(
			array( 'gpnf_template_args', $field->formId, $field->id ),
			array(
				'template'        => 'nested-entry',
				'field'           => $field,
				'nested_form'     => $nested_form,
				'modifiers'       => $modifiers,
				'is_all_fields'   => $is_all_fields,
				'use_text'        => $this->parse_modifier( 'value', $modifiers ) === false,
				'use_admin_label' => false,
				'display_empty'   => false,
				'format'          => $format,
			),
			$this
		);

		foreach ( $entry_ids as $entry_id ) {

			// Gravity Forms cache is too aggressive to in the GFFormsModel::is_field_hidden() method. In order to render
			// the {all_fields} template for each entry, we must clear the cache before each.
			// @see https://secure.helpscout.net/conversation/918488296/13120/
			GFCache::flush();

			$entry = GFAPI::get_entry( $entry_id );
			if ( is_wp_error( $entry ) ) {
				continue;
			}

			$args['entry'] = $entry;
			// Pass entry for integration with GP Preview Submission.
			$args['modifiers'] = $modifiers . ",entry[{$entry_id}]";

			// Pass filtered form with the entry for each entry that way Populate Anything and other plugins can modify it.
			$args['form'] = $this->get_nested_form( rgar( $field, 'gpnfForm' ), $entry );

			/**
			 * Filter an individual entry's markup when displayed using {all_fields}.
			 *
			 * @param string                $markup            Entry markup.
			 * @param \GP_Field_Nested_Form $nested_form_field Current Nested Form field.
			 * @param array                 $nested_form       Current nested form.
			 * @param array                 $entry             Child entry.
			 * @param array                 $args              Template args used to generate the entry markup.
			 *
			 * @since 1.0.20
			 */
			$values[] = gf_apply_filters( 'gpnf_all_entries_nested_entry_markup', array( $field->formId, $field->id ), $template->parse_template(
				gp_nested_forms()->get_template_names( $args['template'], $field->formId, $field->id, $this->parse_modifier( 'template', $modifiers ) ),
				true,
				false,
				$args
			), $field, $args['form'], $entry, $args );

		}

		$hr = $format == 'html' ? '<hr class="gpnf-nested-entries-hr" style="height:12px;visibility:hidden;margin:0;border:0;">' : "---\n\n";
		/**
		 * Filter the separator between child entry summaries when displaying all child entries either in {all_fields}
		 * merge tag or a specific Nested Form field's merge tag.
		 *
		 * Defaults to an <hr> when the output format is "html".
		 *
		 * @since 1.0
		 *
		 * @param string                $hr     The horizontal rule to be used.
		 * @param \GP_Nested_Form_Field $field  The current Nested Form field object.
		 * @param string                $format The format in which the child entries will be displayed ('html' or 'text').
		 */
		$hr = gf_apply_filters( array( 'gpnf_child_entries_separator', $field->formId, $field->id ), $hr, $field, $format );

		if ( $is_all_fields ) {
			foreach ( $values as &$_value ) {
				$_value = preg_replace( '/bgcolor/', 'style="border-top:5px solid #faebd2;" bgcolor', $_value, 1 );
				$_value = str_replace( 'EAF2FA', 'FAF4EA', $_value );
			}
			$markup = sprintf( '%s%s%s', $format == 'html' ? $hr : "\n\n{$hr}", implode( $hr, $values ), $hr );
		} else {
			foreach ( $values as &$_value ) {
				$_value = preg_replace( '/bgcolor/', 'style="border-top:5px solid #d2e6fa;" bgcolor', $_value, 1 );
			}
			$markup = implode( $hr, $values );
		}

		return $markup;
	}

	public function handle_nested_confirmation( $confirmation, $submitted_form, $entry ) {

		if ( ! $this->is_nested_form_submission() ) {
			return $confirmation;
		}

		$parent_form       = GFAPI::get_form( $this->get_parent_form_id() );
		$nested_form_field = $this->get_posted_nested_form_field( $parent_form );
		//$display_fields    = $nested_form_field->gpnfFields;
		$field_values = $this->get_entry_display_values( $entry, $this->get_nested_form( $submitted_form ) );
		$mode         = rgpost( 'gpnf_mode' ) ? rgpost( 'gpnf_mode' ) : 'add';

		// Attach session meta to child entry.
		$entry   = new GPNF_Entry( $entry );
		$session = new GPNF_Session( $parent_form['id'] );
		$session->add_child_entry( $entry->id );

		// set args passed back to entry list on front-end
		$args = array(
			'formId'      => $parent_form['id'],
			'fieldId'     => $nested_form_field['id'],
			'entryId'     => $entry->id,
			'entry'       => $entry,
			'fieldValues' => $field_values,
			'mode'        => $mode,
		);

		return '<script type="text/javascript"> if( typeof GPNestedForms != "undefined" ) { GPNestedForms.loadEntry( ' . json_encode( $args ) . ' ); } </script>';

	}

	public function handle_nested_confirmation_anchor( $anchor ) {
		return $this->is_nested_form_submission() ? false : $anchor;
	}

	public function handle_parent_submission( $parent_entry_or_id, $form ) {

		if ( ! $this->has_nested_form_field( $form ) ) {
			return;
		}

		// Clear the session when the parent form is submitted.
		$session = new GPNF_Session( $form['id'] );
		$session->delete_cookie();

		$parent_entry = new GPNF_Entry( $parent_entry_or_id );
		$parent_entry->get_entry(); // Ensure that the entry is populated as we'll be using it here shortly.

		/*
		 * Partial Entries: Delete session hash from parent entry meta – any orphaned child entries from the current
		 * session will be adopted below.
		 */
		gform_delete_meta( $parent_entry->id, GPNF_Session::SESSION_HASH_META_KEY );

		if ( ! $parent_entry->has_children() ) {
			return;
		}

		$child_entries = $parent_entry->get_child_entries();
		if ( ! $child_entries ) {
			return;
		}

		foreach ( $child_entries as $child_entry ) {

			$child_form = gf_apply_filters( array( 'gform_pre_process', $child_entry['form_id'] ), GFAPI::get_form( $child_entry['form_id'] ) );

			// Create posts for child entries; the func handles determining if the entry has post fields.
			GFCommon::create_post( $child_form, $child_entry );

			$child_entry      = new GPNF_Entry( $child_entry );
			$parent_entry->id = $child_entry->set_parent_meta( $form['id'], $parent_entry->id );
			$child_entry->delete_expiration();

		}

	}

	public function handle_parent_update_entry( $form, $entry_id ) {

		$this->handle_parent_submission( $entry_id, $form );

	}

	public function handle_parent_submission_post_save( $entry, $form ) {

		if ( ! $this->has_nested_form_field( $form ) ) {
			return $entry;
		}

		$parent_entry = new GPNF_Entry( $entry );
		if ( ! $parent_entry->has_children() ) {
			return $entry;
		}

		$child_entries = $parent_entry->get_child_entries();

		foreach ( $child_entries as $child_entry ) {
			$child_entry = new GPNF_Entry( $child_entry );
			// Always match the created_by property of the child entry with that of the parent. Resolves issue with User
			// Registration add-on where, in some cases, the newly registered user is set as the entry creator.
			$child_entry->set_created_by( $parent_entry->id );
		}

		return $entry;
	}

	/**
	 * Check if the given field supports the GF 2.9.18+ file upload pipeline.
	 *
	 * @param mixed $field Field instance or array.
	 *
	 * @return bool
	 */
	protected function supports_modern_file_upload_handling( $field ) {
		return $field instanceof GF_Field_FileUpload && method_exists( $field, 'populate_file_urls_from_value' );
	}

	/**
	 * Populate GF's submission cache for GF 2.9.18+ multi-file handling so existing files persist across edits.
	 *
	 * @param GF_Field_FileUpload $field Field instance.
	 * @param array               $form  Form meta.
	 * @param array               $entry Entry being prepared.
	 *
	 * @return void
	 */
	protected function hydrate_submission_files_cache( $field, $form, $entry ) {
		if ( ! $field instanceof GF_Field_FileUpload ) {
			return;
		}

		$form_id = (int) rgar( $form, 'id' );
		if ( ! $form_id ) {
			return;
		}

		if ( method_exists( $field, 'set_submission_files' ) ) {
			// Start with a clean submission cache so populate_file_urls_from_value() can rebuild it.
			$field->set_submission_files( null );
		}

		if ( method_exists( $field, 'set_context_property' ) ) {
			// GF 2.9.18+ expects the current form & entry to be stored as context before populating files.
			$field->set_context_property( 'form', $form );
			$field->set_context_property( 'entry', $entry );
		}

		if ( ! isset( GFFormsModel::$uploaded_files[ $form_id ] ) || ! is_array( GFFormsModel::$uploaded_files[ $form_id ] ) ) {
			GFFormsModel::$uploaded_files[ $form_id ] = array();
		}

		// Remove any stale cache keyed by this field so the helper can repopulate it.
		unset( GFFormsModel::$uploaded_files[ $form_id ][ 'input_' . $field->id ] );

		$field_value = rgar( $entry, $field->id );
		$field->populate_file_urls_from_value( $field_value );
	}

	/**
	 * Drop the dynamic URL marker so GF keeps original uploads when saving the field.
	 *
	 * GF treats entries in $files['existing'] with a URL as dynamic data; since we don't repost the raw field value,
	 * those would be discarded unless we strip the URL before save. Removing it lets GF reuse the stored file path.
	 *
	 * @param array                $files Files Gravity Forms is about to save.
	 * @param GF_Field_FileUpload  $field File upload field instance.
	 * @param array                $entry Entry being saved (partial at this point).
	 * @param array                $form  Current form.
	 *
	 * @return array
	 */
	public function prepare_submission_files_for_save( $files, $field, $entry, $form ) {
		if ( ! $this->is_nested_form_edit_submission() || ! $this->supports_modern_file_upload_handling( $field ) || empty( $files['existing'] ) || ! $field->multipleFiles ) {
			return $files;
		}

		// Load the original entry so we can compare the stored file URLs against the current payload.
		$original_entry = $this->entry_being_edited;
		if ( empty( $original_entry ) ) {
			$entry_id       = $this->get_posted_entry_id();
			$original_entry = $entry_id ? GFAPI::get_entry( $entry_id ) : null;
			if ( is_wp_error( $original_entry ) || empty( $original_entry ) ) {
				return $files;
			}

			$this->entry_being_edited = $original_entry;
		}

		$original_urls = json_decode( rgar( $original_entry, $field->id ), true );
		if ( ! is_array( $original_urls ) ) {
			return $files;
		}

		foreach ( $files['existing'] as &$existing_file ) {
			$url = rgar( $existing_file, 'url' );
			if ( empty( $url ) ) {
				continue;
			}

			// When GF sees a URL without a temp filename it treats the file as dynamically populated and drops it.
			if ( in_array( $url, $original_urls, true ) && empty( $existing_file['temp_filename'] ) ) {
				unset( $existing_file['url'] );
			}
		}

		unset( $existing_file );

		return $files;
	}

	public function get_posted_nested_form_field( $form ) {
		foreach ( $form['fields'] as $field ) {
			if ( $field->id == $this->get_posted_nested_form_field_id() ) {
				return $field;
			}
		}
		return false;
	}

	public function get_entry_display_values( $entry, $form, $display_fields = array() ) {

		if ( ! is_array( $entry ) ) {
			$entry = GFAPI::get_entry( $entry );
		}

		if ( is_wp_error( $entry ) ) {
			return false;
		}

		$field_values = array();
		if ( empty( $display_fields ) ) {
			$display_fields = wp_list_pluck( $form['fields'], 'id' );
		}

		foreach ( $display_fields as $display_field_id ) {

			$field = $display_field_id !== 'row_id' ? GFFormsModel::get_field( $form, $display_field_id ) : $this->get_row_id_field( $form );

			// This can happen if the field is deleted from the child form but is still set as a Display Field on the Nested Form field.
			if ( ! $field ) {
				continue;
			}

			$raw_value = GFFormsModel::get_lead_field_value( $entry, $field );

			/**
			 * Check if multi-input product fields (e.g. Single Product, Calculation) and have a quantity. Without this,
			 * unselected products will still return their Name and Price creating a confusing UX - and - products with
			 * a separate quantity field will not display their correct quantity.
			 */
			if ( $field->type === 'product' && is_array( $raw_value ) ) {
				$quantity = $this->get_product_quantity( $field, $entry, $form );
				if ( empty( $quantity ) ) {
					$raw_value = array();
				} else {
					$raw_value[ "{$field->id}.3" ] = $quantity;
				}
			}

			if ( version_compare( GFForms::$version, '2.9.29', '>=' ) ) {
				$value = GFCommon::get_lead_field_display( $field, $raw_value, $entry, true );
			} else {
				$value = GFCommon::get_lead_field_display( $field, $raw_value, rgar( $entry, 'currency' ), true );
			}

			// Run $value through same filter GF uses before displaying on the entry detail view.
			$value = apply_filters( 'gform_entry_field_value', $value, $field, $entry, $form );

			if ( is_array( $value ) ) {
				ksort( $value );
				$value = implode( ' ', $value );
			}

			$value = array(
				'label' => $value,
				'value' => $raw_value,
			);

			/**
			 * Filter the value to be displayed in the Nested Form entries view (per field).
			 *
			 * @since 1.0
			 *
			 * @param mixed    $value The field value to be displayed.
			 * @param GF_Field $field The current field object.
			 * @param array    $form  The current form.
			 * @param array    $entry The current entry.
			 */
			$value = gf_apply_filters( array( 'gpnf_display_value', $form['id'], $field->id ), $value, $field, $form, $entry );
			$value = gf_apply_filters( array( "gpnf_{$field->get_input_type()}_display_value", $form['id'] ), $value, $field, $form, $entry );

			$field_values[ $display_field_id ] = $value;

		}

		$field_values['id'] = $entry['id'];

		$entry = new GPNF_Entry( $entry );
		$entry->set_total();
		$field_values['total'] = $entry->get_total();

		return $field_values;
	}

	/**
	 * Get the quantity of a product field for the given entry.
	 *
	 * Extracted from GP Conditional Pricing and modified for Nested Forms. Used when generating the display value for
	 * Product fields in the Nested Entries table.
	 *
	 * @param $product_field
	 * @param $entry
	 * @param $form
	 *
	 * @return int
	 */
	function get_product_quantity( $product_field, $entry, $form ) {

		$product_value = GFFormsModel::get_lead_field_value( $entry, $product_field );
		$qty_field     = GFCommon::get_product_fields_by_type( $form, array( 'quantity' ), $product_field->id );
		$has_qty_field = ! empty( $qty_field );

		if ( $has_qty_field ) {
			$qty_field = $qty_field[0];
		}

		$is_qty_field_valid = $has_qty_field && ! GFFormsModel::is_field_hidden( $form, $qty_field, array(), $entry );

		if ( $is_qty_field_valid ) {
			$quantity = GFFormsModel::get_lead_field_value( $entry, $qty_field );
		} else {
			if ( is_array( $product_value ) && ! $product_field->disableQuantity ) {
				$quantity = rgar( $product_value, "{$product_field->id}.3" );
			} elseif ( is_array( $product_value ) && empty( array_filter( $product_value ) ) ) {
				// product_value is made up of all empty values, it shouldn't be populated with a value of 1.
				$quantity = 0;
			} elseif ( ! is_array( $product_value ) && rgblank( $product_value ) ) {
				$quantity = 0;
			} else {
				$quantity = 1;
			}
		}

		return (int) ( ! $quantity ? 0 : $quantity );
	}

	/**
	 * Get map of Product field IDs to Quantity field IDs for the given form.
	 *
	 * @param array $form Child form.
	 *
	 * @return array
	 */
	public function get_product_quantity_field_map( $form ) {
		$map = array();

		foreach ( GFCommon::get_fields_by_type( $form, array( 'quantity' ) ) as $field ) {
			if ( rgblank( $field->productField ) ) {
				continue;
			}

			$map[ (string) $field->productField ] = (int) $field->id;
		}

		return $map;
	}



	// # FORM RENDERING

	/**
	 * Generate and output the session hash as a hidden input within the form markup.
	 *
	 * This is used in GP_Nested_Forms::adopt_partial_entry_children() to save the session hash in the parent partial
	 * entry meta. This allows child entries that are adopted by a partial entry to be verified as part of the current
	 * session (aka when repopulating child entries or when editing/deleting a child entry via a Nested Form field).
	 *
	 * @param $form_tag
	 * @param $form
	 *
	 * @return string
	 */
	public function add_session_hash_input( $form_tag, $form ) {

		if ( ! $this->has_child_form( $form ) ) {
			return $form_tag;
		}

		$form_id = (int) $form['id'];
		$session = new GPNF_Session( $form_id );
		$hash    = $session->get_runtime_hashcode();

		$form_tag .= sprintf( '<input id="gpnf_session_hash_%d" type="hidden" name="gpnf_session_hash" value="%s">', $form_id, esc_attr( $hash ) );

		return $form_tag;
	}

	public function handle_nested_forms_markup( $form_html, $form ) {

		if ( ! $this->has_nested_form_field( $form, true ) ) {
			return $form_html;
		}

		$is_ajax_submission = rgpost( 'gform_submit' ) && rgpost( 'gform_ajax' );

		if ( $is_ajax_submission ) {
			//	$nested_entries = $this->get_submitted_nested_entries( $form );
			//	$form_html      = sprintf( '<script type="text/javascript"> parent.gpnfNestedEntries[%d] = %s; </script>', $form['id'], json_encode( $nested_entries ) ) . $form_html;
			return $form_html;
		}

		$nested_forms_markup = $this->get_nested_forms_markup( $form );

		/**
		 * This hook is deprecated.
		 */
		if ( apply_filters( 'gpnf_append_nested_forms_to_footer', apply_filters( 'gform_init_scripts_footer', true ), $form ) ) {
			self::$nested_forms_markup[ $form['id'] ] = $nested_forms_markup;
			if ( ! has_action( 'wp_footer', array( $this, 'output_nested_forms_markup' ) ) ) {
				add_action( 'wp_footer', array( $this, 'output_nested_forms_markup' ), 21 );
				add_action( 'gform_preview_footer', array( $this, 'output_nested_forms_markup' ), 21 );
				add_action( 'admin_footer', array( $this, 'output_nested_forms_markup' ), 21 );
			}
		} else {
			$form_html .= $nested_forms_markup;
		}

		return $form_html;
	}

	public function maybe_load_nested_form_hooks( $form ) {

		if ( ! $this->is_nested_form_submission() || did_action( 'gform_pre_validation' ) ) {
			return $form;
		}

		$this->load_nested_form_hooks( $form['id'], $this->get_parent_form_id() );

		return $form;
	}

	public function load_nested_form_hooks( $form_id, $parent_form_id ) {

		$this->parent_form_id = $parent_form_id;

		add_filter( 'gform_form_tag', array( $this, 'add_nested_inputs' ), 10, 2 );
		add_filter( 'gform_pre_render', array( $this, 'remove_extra_other_choices' ) );
		add_filter( 'gform_form_args', array( $this, 'force_child_form_ajax' ), PHP_INT_MAX );

		if ( $this->use_jquery_ui_dialog() ) {
			// Force scripts to load in the footer so that they are not reincluded in the fetched form markup.
			add_filter( 'gform_init_scripts_footer', '__return_true', 11 );
		}

		add_filter( 'gform_get_form_filter_' . $form_id, array( $this, 'replace_post_render_trigger' ), 10, 2 );
		add_filter( 'gform_footer_init_scripts_filter_' . $form_id, array( $this, 'replace_post_render_trigger' ), 10, 2 );

		// Prevent posts from being generated.
		add_filter( 'gform_disable_post_creation_' . $form_id, '__return_true', 11 );

		add_filter( 'gform_validation', array( $this, 'override_no_duplicates_validation' ) );

		// Setup unload to remove hooks after form has been generated.
		add_filter( 'gform_get_form_filter_' . $form_id, array( $this, 'unload_nested_form_hooks' ), 99, 2 );

		do_action( 'gpnf_load_nested_form_hooks', $form_id, $parent_form_id );

	}

	/**
	 * When editing a child entry via a Nested Form, override the no duplicates validation if the value of the child entry
	 * has not changed.
	 *
	 * @param $result
	 *
	 * @return mixed
	 */
	public function override_no_duplicates_validation( $result ) {

		if ( $result['is_valid'] ) {
			return $result;
		}

		$edit_entry_id = $this->get_posted_entry_id();
		if ( ! $edit_entry_id ) {
			return $result;
		}

		/** @var GF_Field $field */
		foreach ( $result['form']['fields'] as &$field ) {

			if ( ! $field->noDuplicates || ! $field->failed_validation ) {
				continue;
			}

			$submitted_value = $field->get_value_submission( array() );
			if ( ! GFFormsModel::is_duplicate( $result['form']['id'], $field, $submitted_value ) ) {
				continue;
			}

			$entry          = GFAPI::get_entry( $edit_entry_id );
			$existing_value = rgar( $entry, $field->id );

			if ( $submitted_value == $existing_value ) {
				$field->failed_validation = false;
			}
		}

		$result['is_valid'] = true;
		foreach ( $result['form']['fields'] as &$field ) {
			if ( $field->failed_validation ) {
				$result['is_valid'] = false;
			}
		}

		return $result;
	}

	public function unload_nested_form_hooks( $form_string, $form_or_id ) {

		if ( $this->use_jquery_ui_dialog() ) {
			remove_filter( 'gform_init_scripts_footer', '__return_true', 11 );
		}

		remove_filter( 'gform_form_tag', array( $this, 'add_nested_inputs' ) );
		remove_filter( 'gform_pre_render', array( $this, 'remove_extra_other_choices' ) );
		remove_filter( 'gform_form_args', array( $this, 'force_child_form_ajax' ), PHP_INT_MAX );

		do_action( 'gpnf_unload_nested_form_hooks', rgar( $form_or_id, 'id', $form_or_id ), $this->parent_form_id );

		$this->parent_form_id = null;

		return $form_string;
	}

	/**
	 * WCGFPA (and possibly other plugins) add a crazy bit of code that disables AJAX on ALL forms. Not just their own. 😫
	 * This necessitates us forcing AJAX for child forms very aggressively as it is required for Nested Form fields to work.
	 *
	 * @param $form_args
	 *
	 * @return mixed
	 */
	public function force_child_form_ajax( $form_args ) {
		$form_args['ajax'] = true;
		return $form_args;
	}

	public function replace_post_render_trigger( $form_html, $form ) {
		$form_html = preg_replace( '/trigger\([ ]*[\'"]gform_post_render[\'"]/', "trigger('gpnf_post_render'", $form_html );

		// Used by event handler functionality to target nested form post render events and prioritize them.
		$form_html = preg_replace( '/bind\([ ]*[\'"]gform_post_render[\'"]/', "bind('gform_post_render.gpnf'", $form_html );

		// .bind was switch to .on in the following PR: https://github.com/gravityforms/gravityforms/pull/1779
		$form_html = preg_replace( '/on\([ ]*[\'"]gform_post_render[\'"]/', "on('gform_post_render.gpnf'", $form_html );

		/*
		 * https://github.com/gravityforms/gravityforms/pull/2762 introduced more complex logic for handling hidden forms.
		 *
		 * This logic isn't needed for GPNF as we move all events to gpnf_post_render and call it ourselves. If we keep it
		 * it causes multiple inits to happen and breaks perks such as GPFUP or GPLD's Inline Date Pickers.
		 *
		 * TODO, do we need to handle `gform.utils.trigger( { event: 'gform/postRender' } );`?
		 */
		$form_html = str_replace( 'function triggerPostRender() {', 'function triggerPostRender() { return false;', $form_html );

		if ( ! $this->use_jquery_ui_dialog() ) {
			$form_html = preg_replace( '/<script.*gformInitSpinner.*?<\/script>/', '<!-- GPNF removes GF\'s default <iframe> script; replacing it with its own in gp-nested-form.js. -->', $form_html );
		}
		return $form_html;
	}

	public function handle_nested_form_field_value( $value, $entry, $field ) {

		if ( $this->should_use_static_value( $field, $entry ) ) {
			return $value;
		}

		$cache_value_key   = "gpnf_field_value_{$field->formId}_{$field->id}_{$entry['id']}";
		$cache_entries_key = "gpnf_field_entries_{$field->formId}_{$field->id}_{$entry['id']}";

		$cached_value   = GFCache::get( $cache_value_key, $_unused, false );
		$cached_entries = GFCache::get( $cache_entries_key, $_unused, false );

		if ( $cached_value !== false ) {
			// Filter documented below.
			return gf_apply_filters( array( 'gpnf_nested_form_field_value', $field->formId, $field->id ), $cached_value, $field, $entry, $cached_entries );
		}

		// Turns out GFAPI::get_entries() is WAYYY faster than querying the DB directly...
		$child_entries = GFAPI::get_entries(
			$field->gpnfForm,
			array(
				/*
				 * When a parent entry is trashed, its child entries are also trashed. When a parent entry is restored,
				 * we should also restore its child entries. To support this, fetch child entries based on the status
				 * of the parent entry. We will likely need to improve this logic when we add support for more types of
				 * relationships between parent and child entries.
				 */
				'status'        => $entry['status'] === 'trash' ? 'trash' : 'active',
				'field_filters' => array(
					'mode' => 'all',
					array(
						'key'   => GPNF_Entry::ENTRY_PARENT_KEY,
						'value' => $entry['id'],
					),
					array(
						'key'   => GPNF_Entry::ENTRY_NESTED_FORM_FIELD_KEY,
						'value' => $field->id,
					),
				),
			),
			array(
				'key'        => 'id',
				'direction'  => 'ASC',
				'is_numeric' => true,
			),
			array(
				'offset'    => 0,
				'page_size' => $this->get_child_entry_max(),
			)
		);

		$value = implode( ',', wp_list_pluck( $child_entries, 'id' ) );

		GFCache::set( $cache_value_key, $value );
		GFCache::set( $cache_entries_key, $child_entries );

		/**
		 * Filter the nested form field value.
		 *
		 * @param string                $nested_form_field_value Nested form field value.
		 * @param \GP_Field_Nested_Form $field                   The current Nested Form field.
		 * @param array                 $entry                   The current entry.
		 * @param array                 $child_entries           The child entries.
		 *
		 * @since 1.1.68
		 */
		return gf_apply_filters( array( 'gpnf_nested_form_field_value', $field->formId, $field->id ), $value, $field, $entry, $child_entries );
	}

	public function should_use_static_value( $field, $entry ) {

		// Honor the submitted value.
		// Note: with this change, the conditional below (for the WCGF Product plugin) may no longer be necessary...
		if ( $this->is_form_submission() ) {
			return true;
		}

		// Only process for Nested Form fields and when we're working with a "real" entry.
		// The latter check resolves a conflict with Preview Submission where an empty entry ID returned erroneous child entries.
		// The Code Canyon WCGF Product plugin uses randomly generated alphanumeric entry IDs for some reason. Let's ignore these entries.
		// 	@see https://secure.helpscout.net/conversation/956639062/13730?folderId=14965
		if ( ! is_a( $field, 'GP_Field_Nested_Form' ) || ! $entry['id'] || ! is_numeric( $entry['id'] ) ) {
			return true;
		}

		/**
		 * Filter whether the current Nested Form field's value should be fetched dynamically from the database or left as is.
		 *
		 * @param bool                  $should_use_static_value Should the field's value be static?
		 * @param \GP_Field_Nested_Form $field                   The current Nested Form field.
		 * @param array                 $entry                   The current entry.
		 *
		 * @since 1.0-beta-8.80
		 */
		$should_use_static_value = gf_apply_filters( array( 'gpnf_should_use_static_value', $field->formId, $field->id ), false, $field, $entry );

		return $should_use_static_value;
	}

	public static function get_child_entry_max() {
		/**
		 * Filter the maximum number of child entries accepted in a Nested Form field.
		 *
		 * This supersedes any maximum set in the Entry Limits setting of a Nested Form field.
		 *
		 * @since 1.0-beta-8.44
		 *
		 * @param int $child_entry_max The maximum number of child entries accepted in a Nested Form field.
		 */
		return apply_filters( 'gpnf_child_entry_max', 99 );
	}

	public function register_all_form_init_scripts( $form ) {

		$script = '';

		foreach ( $form['fields'] as $field ) {

			if ( $field->type != 'form' || $field->visibility == 'administrative' ) {
				continue;
			}

			/**
			 * @var GP_Field_Nested_Form $field
			 */
			$nested_form    = $this->get_nested_form( rgar( $field, 'gpnfForm' ) );
			$display_fields = rgar( $field, 'gpnfFields' );
			$entries        = $this->get_submitted_nested_entries( $form, $field->id );
			$primary_color  = $field->gpnfModalHeaderColor ? $field->gpnfModalHeaderColor : '#3498db';

			$ajax_context = array(
				'post_id'      => get_queried_object_id(),
				'path'         => GPNF_Session::get_session_path(),
				'field_values' => $this->get_stashed_shortcode_field_values( $form['id'] ),
				'request'      => GPNF_Session::get_session_request_vars( GFAPI::get_form( $form['id'] ) ),
			);

			$args = array(
				'formId'              => $form['id'],
				'fieldId'             => $field['id'],
				'nestedFormId'        => rgar( $nested_form, 'id' ),
				'displayFields'       => $display_fields,
				'entries'             => $entries,
				'ajaxUrl'             => admin_url( 'admin-ajax.php', ! is_ssl() ? 'http' : 'admin' ),
				'modalLabels'         => array(
					/* Translators: %s is replaced by singular item label. */
					'title'                  => sprintf( __( 'Add %s', 'gp-nested-forms' ), $field->get_item_label() ),
					/* Translators: %s is replaced by singular item label. */
					'editTitle'              => sprintf( __( 'Edit %s', 'gp-nested-forms' ), $field->get_item_label() ),
					'submit'                 => false,
					'editSubmit'             => false,
					'cancel'                 => esc_html__( 'Cancel', 'gp-nested-forms' ),
					'delete'                 => esc_html__( 'Delete', 'gp-nested-forms' ),
					'confirmAction'          => esc_html__( 'Are you sure?', 'gp-nested-forms' ),
					'closeScreenReaderLabel' => esc_html__( 'Close', 'gp-nested-forms' ),
				),
				'modalColors'         => array(
					'primary'   => $primary_color,
					'secondary' => $this->color_luminance( $primary_color, -0.5 ),
					'danger'    => '#e74c3c',
				),
				'modalHeaderColor'    => $primary_color,
				'modalClass'          => $this->use_jquery_ui_dialog() ? 'gpnf-dialog' : 'gpnf-modal',
				'modalStickyFooter'   => true,
				'entryLimitMin'       => $field->gpnfEntryLimitMin,
				'entryLimitMax'       => $field->gpnfEntryLimitMax,
				'sessionData'         => GPNF_Session::get_default_session_data( $field->formId ),
				'spinnerUrl'          => gf_apply_filters( array( 'gform_ajax_spinner_url', $field->formId ), GFCommon::get_base_url() . '/images/spinner' . ( $this->is_gf_version_gte( '2.5-beta-1' ) ? '.svg' : '.gif' ), $form ),
				/* @deprecated options below */
				// translators: placeholder is a singular item label such as "Item" or "Player"
				'modalTitle'          => sprintf( __( 'Add %s', 'gp-nested-forms' ), $field->get_item_label() ),
				// translators: placeholder is a singular item label such as "Item" or "Player"
				'editModalTitle'      => sprintf( __( 'Edit %s', 'gp-nested-forms' ), $field->get_item_label() ),
				'modalWidth'          => 700,
				'modalHeight'         => 'auto',
				'hasConditionalLogic' => GFFormDisplay::has_conditional_logic( $nested_form ),
				'productFieldIds'     => wp_list_pluck( GFCommon::get_fields_by_type( $nested_form, array( 'product' ) ), 'id' ),
				'productQuantityFieldMap' => $this->get_product_quantity_field_map( $nested_form ),
				'isGF25'              => $this->is_gf_version_gte( '2.5-beta-1' ),
				'enableFocusTrap'     => true,
				'ajaxContext'         => $ajax_context,
			);

			// Backwards compatibility for deprecated "modalTitle" option.
			// translators: placeholder is a singular item label such as "Item" or "Player"
			if ( $args['modalLabels']['title'] == sprintf( __( 'Add %s', 'gp-nested-forms' ), $field->get_item_label() ) && $args['modalTitle'] !== $args['modalLabels']['title'] ) {
				$args['modalLabels']['title'] = $args['modalTitle'];
			}

			// Backwards compatibility for deprecated "editModalTitle" option.
			// translators: placeholder is a singular item label such as "Item" or "Player"
			if ( $args['modalLabels']['editTitle'] == sprintf( __( 'Edit %s', 'gp-nested-forms' ), $field->get_item_label() ) && $args['editModalTitle'] !== $args['modalLabels']['editTitle'] ) {
				$args['modalLabels']['editTitle'] = $args['editModalTitle'];
			}

			/**
			 * Filter the arguments that will be used to initialized the nested forms frontend script.
			 *
			 * @param array{
			 *     formId: int, // The current form ID.
			 *     fieldId: int, // The field ID of the Nested Form field.
			 *     nestedFormId: int, // The form ID of the nested form.
			 *     displayFields: array, // The fields which will be displayed in the Nested Forms entries view.
			 *     entries: array, // An array of modified entries, including only their display values.
			 *     ajaxUrl: string, // The URL to which AJAX requests will be posted.
			 *     modalLabels: array{
			 *         title: string, // The title to be displayed in the modal header.
			 *         editTitle: string, // The title to be displayed in the modal header when editing an existing entry.
			 *         submit: string|false, // The text to be displayed inside Submit button.
			 *         editSubmit: string|false, // The text to be displayed inside Submit button when editing an entry.
			 *         cancel: string, // The text to be displayed inside Cancel button.
			 *         delete: string, // The text to be displayed inside Delete button.
			 *         confirmAction: string, // The question to be displayed when confirming an action.
			 *         closeScreenReaderLabel: string, // The close button label for screen readers.
			 *     }, // The labels for the modal.
			 *     modalColors: array{
			 *         primary: string, // A HEX color that will be set as the default background color of the Add and Edit Entry buttons.
			 *         secondary: string, // A HEX color that will be set as the default background color for Cancel button.
			 *         danger: string, // A HEX color that will be set as the default background color for Delete and Are you sure? buttons.
			 *     }, // The colors for the modal.
			 *     modalHeaderColor: string, // A HEX color that will be set as the default background color of the modal header.
			 *     modalClass: string, // The class that will be attached to the modal for styling.
			 *     modalStickyFooter: bool, // Whether the footer should stick to the bottom of the modal.
			 *     entryLimitMin: int, // The minimum number of entries that can be submitted for this field.
			 *     entryLimitMax: int, // The maximum number of entries that can be submitted for this field.
			 *     sessionData: array, // Default session data for the field.
			 *     spinnerUrl: string, // The URL to the loading spinner image.
			 *     modalTitle: string, // The title to be displayed in the modal header (deprecated).
			 *     editModalTitle: string, // The title to be displayed in the modal header when editing an existing entry (deprecated).
			 *     modalWidth: int, // The default width of the modal; defaults to 700.
			 *     modalHeight: string|int, // The default height of the modal; defaults to 'auto' which will automatically size the modal based on its contents.
			 *     hasConditionalLogic: bool, // Indicate whether the current form has conditional logic enabled.
			 *     productFieldIds: array, // Field IDs for Product fields in the child form.
			 *     productQuantityFieldMap: array, // Map of Product field IDs to related Quantity field IDs.
			 *     isGF25: bool, // Whether Gravity Forms version is 2.5 or higher.
			 *     enableFocusTrap: bool, // Whether the nested form should use a focus trap when open to prevent tabbing outside the nested form.
			 *     ajaxContext: array, // Context data for AJAX requests including post_id, path, field_values, and request.
			 * } $args The arguments that will be used to initialized the nested forms frontend script.
			 * @param GF_Field $field The current Nested Form field.
			 * @param array $form The current form.
			 *
			 * @usage gpnf_init_script_args Filter applied globally to all forms and fields
			 * @usage gpnf_init_script_args_FORMID Filter applied to all fields for a specific form
			 * @usage gpnf_init_script_args_FORMID_FIELDID Filter applied to a specific form and field
			 *
			 * @example Change Modal Title and Submit Button
			 * By default, the submit button label will be the same as the modal title, "Add {Item}" and "Edit {Item}" respectively. Use this snippet to change the title and submit button labels for both the Add and Edit modals.
			 * <github-file>snippet-library/gp-nested-forms/gpnf-change-modal-title-and-submit-button.php</github-file>
			 *
			 * @example Unstick the Modal Footer
			 * By default, the Nested Forms field modal has "sticky" footer. It will keep the footer visible on longer forms by sticking it to the bottom of the screen. Use this snippet to "unstick" the footer and it will appear at the bottom of the form.
			 * <github-file>snippet-library/gp-nested-forms/gpnf-unstick-the-modal-footer.php</github-file>
			 *
			 * @since 1.0
			 */
			$args = gf_apply_filters( array( 'gpnf_init_script_args', $form['id'], $field->id ), $args, $field, $form );

			//$script .= 'if( typeof window.gpnfNestedEntries == "undefined" ) { window.gpnfNestedEntries = {}; }';
			$script .= 'new GPNestedForms( ' . json_encode( $args ) . ' );';

		}

		if ( $script ) {
			GFFormDisplay::add_init_script( $form['id'], 'gpnf_init_script', GFFormDisplay::ON_PAGE_RENDER, $script );
		}

	}

	public function color_luminance( $hex, $percent ) {

		// validate hex string

		$hex     = preg_replace( '/[^0-9a-f]/i', '', $hex );
		$new_hex = '#';

		if ( strlen( $hex ) < 6 ) {
			$hex = $hex[0] . $hex[0] . $hex[1] . $hex[1] . $hex[2] . $hex[2];
		}

		// convert to decimal and change luminosity
		for ( $i = 0; $i < 3; $i++ ) {
			$dec      = hexdec( substr( $hex, $i * 2, 2 ) );
			$dec      = min( max( 0, $dec + $dec * $percent ), 255 );
			$new_hex .= str_pad( dechex( (int) $dec ), 2, 0, STR_PAD_LEFT );
		}

		return $new_hex;
	}

	public function get_submitted_nested_entries( $form, $field_id = false, $display_values = true ) {

		$all_entries = array();
		$nested_form = null;

		foreach ( $form['fields'] as $field ) {

			if ( $field->type != 'form' || $field->id != $field_id ) {
				continue;
			}

			$bypass_permissions = false;

			$entries   = array();
			$entry_ids = rgpost( 'input_' . $field['id'] );

			/**
			 * This has been updated to be a little more deliberate. Previously, we used $field->get_value_submission()
			 * to fetch the prepopulation value. Let's call GFFormsModel::get_parameter_value() directly instead.
			 */
			if ( empty( $entry_ids ) && $field->allowsPrepopulate ) {
				// If prepop is enabled - AND - we're using prepopulated values, let's bypass permissions.
				//$bypass_permissions = true; @note Good idea; bad execution. Allows bad folks to populate arbitrary entry IDs and view entry data. Filter below to allow advanced users to bypass permissions.
				$entry_ids = GFFormsModel::get_parameter_value( $field->inputName, array() /* @todo this might get us in trouble; should pass real $field_values */, $field );
			}

			if ( empty( $entry_ids ) || ! is_string( $entry_ids ) ) {
				$entry_ids = array();
			} else {
				$entry_ids = $this->get_child_entry_ids_from_value( $entry_ids );
			}

			// if no posted $entry_ids check if we are resuming a saved entry
			if ( $this->get_save_and_continue_token( $form['id'] ) && empty( $entry_ids ) ) {
				$entry_ids = $this->get_save_and_continue_child_entry_ids( $form['id'], $field->id );
			}

			// phpcs:ignore
			if ( empty( $entry_ids ) && is_callable( 'gravityview' ) && $gv_entry = gravityview()->request->is_edit_entry() ) {
				$parent_entry = $gv_entry->as_entry();
				$entry_ids    = $this->get_child_entry_ids_from_value( $this->get_field_value( $form, $parent_entry, $field->id ) );

				if ( $entry_ids ) {
					$bypass_permissions = true;
				}
			}

			// Support populating child entries back into Nested Form field when parent form is reloaded via the
			// WC GF Product Add-on's Enable Cart Edit option.
			// phpcs:ignore
			if ( empty( $entry_ids ) && is_callable( 'WC' ) && $cart_item_key = rgget( 'wc_gforms_cart_item_key' ) ) {

				$cart_item = WC()->cart->get_cart_item( $cart_item_key );
				if ( ! empty( $cart_item ) && isset( $cart_item['_gravity_form_lead'] ) && isset( $cart_item['_gravity_form_data'] ) ) {
					$entry     = $cart_item['_gravity_form_lead'];
					$entry_ids = $this->get_child_entry_ids_from_value( $this->get_field_value( $form, $entry, $field->id ) );
				}
			}

			/**
			 * Filter the entry IDs when populating entries into a Nested Form field (typically for editing). This is useful for adding support for editing
			 * Nested Forms in other plugins such as GP Entry Blocks.
			 *
			 * Note, this filter is often used in tandem with `gpnf_bypass_entry_permissions`.
			 *
			 * @since 1.0.8
			 *
			 * @param array  $entry_ids          Entry IDs to populate the field with.
			 * @param array  $form               Current form object.
			 * @param object $field              Current field object.
			 */
			$entry_ids = gf_apply_filters( array( 'gpnf_submitted_entry_ids', $form['id'], $field->id ), $entry_ids, $form, $field );

			// Load entries from session.
			if ( empty( $entry_ids ) && $this->should_load_child_entries_from_session( $form, $field ) ) {

				$session  = new GPNF_Session( $form['id'] );
				$_entries = $session->get( 'nested_entries' );
				if ( ! empty( $_entries[ $field['id'] ] ) ) {
					$entry_ids = $_entries[ $field['id'] ];
				}
			}

			/**
			 * Bypass entry permissions when populating entries into a Nested Form field.
			 *
			 * @since 1.0
			 *
			 * @param bool   $bypass_permissions Should entry permissions be bypassed?
			 * @param array  $form               Current form object.
			 * @param object $field              Current field object.
			 */
			$bypass_permissions = gf_apply_filters( array( 'gpnf_bypass_entry_permissions', $form['id'], $field->id ), $bypass_permissions, $form, $field );

			if ( ! empty( $entry_ids ) ) {

				foreach ( $entry_ids as $entry_id ) {

					$entry = GFAPI::get_entry( $entry_id );
					// Confirm the child entry exists and is not spammed or deleted.
					// GFAPI will fetch the WP_Error class if entry is deleted.
					if ( is_wp_error( $entry ) || rgar( $entry, 'status' ) === 'spam' ) {
						continue;
					}

					if ( ! $bypass_permissions && ! GPNF_Entry::can_current_user_edit_entry( $entry ) ) {
						continue;
					}

					if ( $display_values ) {
						$nested_form = $this->get_nested_form( $field->gpnfForm, $entry );
						$entries[]   = $this->get_entry_display_values( $entry, $nested_form );
					} else {
						$entries[] = $entry;
					}
				}
			}

			$all_entries[ $field->id ] = $entries;

		}

		$return_entries = $field_id ? rgar( $all_entries, $field_id ) : $all_entries;
		/**
		 * Filter nested form submitted child entries.
		 *
		 * @since 1.0-beta-8.57
		 * @param array                $return_entries  Current submitted entries
		 * @param GP_Field_Nested_Form $nested_form     Nested form entries belong to
		 * @param bool                 $display_values  Array contains a simplified version of entries
		 *                                              if false, array contains a list of GPNF_Entry objects.
		 */
		$return_entries = gf_apply_filters(
			array( 'gpnf_submitted_nested_entries' ),
			$return_entries,
			$nested_form,
			$display_values
		);
		return $return_entries;
	}

	public function should_load_child_entries_from_session( $form, $field ) {
		/**
		 * Filter whether child entries should be loaded from the Nested Forms session.
		 *
		 * @since 1.1.17
		 *
		 * @param bool   $load_from_session Should child entries be loaded from session?
		 * @param array  $form              Current parent form object.
		 * @param object $field             Current Nested Form field object.
		 */
		return gf_apply_filters( array( 'gpnf_should_load_child_entries_from_session', $form['id'], $field->id ), true, $form, $field );
	}

	public function remove_extra_other_choices( $form ) {

		foreach ( $form['fields'] as &$field ) {

			if ( $field->get_input_type() !== 'radio' ) {
				continue;
			}

			$choices     = $field->choices;
			$other_index = 0;

			foreach ( $choices as $index => $choice ) {
				if ( $choice['value'] == 'gf_other_choice' ) {
					$other_index = $index;
				}
			}

			if ( $other_index ) {
				$field->choices = array_splice( $choices, 0, $other_index );
			}
		}

		return $form;
	}

	public function populate_field_from_session_cookie( $value, $field, $name ) {
		$_value = $this->get_query_arg( $name );
		if ( $_value ) {
			$value = $_value;
		}

		return $value;
	}

	/**
	 * Get Save & Continue from URL if it exists.
	 *
	 * @var int|bool $form_id The parent form ID for which the Save & Continue token is being fetched.
	 *
	 * @return string|null
	 */
	public function get_save_and_continue_token( $form_id = false ) {

		$gf_token = null;

		/* gf_token is used as the initial GET parameter and is then changed to gform_resume_token via POST. */
		if ( ! empty( $this->get_query_arg( 'gform_resume_token' ) ) ) {
			$gf_token = $this->get_query_arg( 'gform_resume_token' );
		} elseif ( ! empty( $this->get_query_arg( 'gf_token' ) ) ) {
			$gf_token = $this->get_query_arg( 'gf_token' );
		}

		/**
		 * Filter the Save & Continue token that will be used to retrieve child entries for population in a Nested Form field.
		 *
		 * @param null|string $gf_token The Save & Continue token.
		 * @param int|bool    $form_id  The parent form ID for which the Save & Continue token is being fetched.
		 *
		 * @since 1.0.25
		 */
		$gf_token = apply_filters( 'gpnf_save_and_continue_token', $gf_token, $form_id );

		return $gf_token;
	}

	public function get_save_and_continue_child_entry_ids( $form, $field_id = false ) {

		if ( ! $this->get_save_and_continue_token( is_numeric( $form ) ? $form : $form['id'] ) ) {
			return array();
		}

		// Form ID was passed; get form.
		if ( is_numeric( $form ) ) {
			$form = GFAPI::get_form( $form );
		}

		$incomplete_submission_info = GFFormsModel::get_draft_submission_values( $this->get_save_and_continue_token( $form['id'] ) );
		if ( empty( $incomplete_submission_info ) || $incomplete_submission_info['form_id'] != $form['id'] ) {
			return array();
		}

		$submission_details_json = $incomplete_submission_info['submission'];
		$submission_details      = json_decode( $submission_details_json, true );
		$submitted_values        = $submission_details['submitted_values'];

		$child_entries = array();

		foreach ( $form['fields'] as $field ) {
			if ( $field->get_input_type() == 'form' ) {
				$child_entries[ $field->id ] = $this->get_child_entry_ids_from_value( rgar( $submitted_values, $field->id ) );
			}
		}

		if ( $field_id ) {
			return rgar( $child_entries, $field_id );
		}

		return $child_entries;
	}

	public function get_save_and_continue_parent_hash( $form_id ) {

		$entry_ids = $this->get_save_and_continue_child_entry_ids( $form_id );

		if ( ! empty( $entry_ids ) ) {
			$first_entry_id = rgars( array_values( $entry_ids ), '0/0' );
			$parent_entry_id = gform_get_meta( $first_entry_id, GPNF_Entry::ENTRY_PARENT_KEY );

			/**
			 * If the parent entry ID is numeric, the child entry was already adopted by a Partial Entry.
			 * In this case, retrieve the original session hash stored on the partial entry so the session
			 * can be properly restored. A numeric hash would be rejected by can_current_user_edit_entry()
			 * which would prevent editing child entries after resuming via Save & Continue.
			 */
			if ( is_numeric( $parent_entry_id ) ) {
				$session_hash = gform_get_meta( $parent_entry_id, GPNF_Session::SESSION_HASH_META_KEY );
				if ( $session_hash ) {
					return $session_hash;
				}
			}

			return $parent_entry_id;
		}

		return false;
	}

	public function add_child_entry_meta( $entry ) {

		$is_rest_request = $this->is_valid_rest_api_submissions_request();
		if ( ! $is_rest_request && ! $this->is_nested_form_submission() ) {
			return $entry;
		}

		if ( $is_rest_request ) {

			$parent_entry_id      = rgpost( GPNF_Entry::ENTRY_PARENT_KEY );
			$parent_form_id       = rgpost( GPNF_Entry::ENTRY_PARENT_FORM_KEY );
			$nested_form_field_id = rgpost( GPNF_Entry::ENTRY_NESTED_FORM_FIELD_KEY );

		} else {

			$parent_form_id       = $this->get_parent_form_id();
			$nested_form_field_id = $this->get_posted_nested_form_field_id();

			/**
			 * Account for child entries that were repopulated and are being edited. Preserve the original parent
			 * entry ID if it is an actual entry and not a session hash.
			 *
			 * The child entry will be adopted by the newly submitted parent entry once it is submitted.
			 */
			$parent_entry_id = rgar( $entry, GPNF_Entry::ENTRY_PARENT_KEY, false );
			if ( ! is_numeric( $parent_entry_id ) ) {
				$parent_entry_id = false;
			}
		}

		$parent_form       = GFAPI::get_form( $parent_form_id );
		$nested_form_field = GFAPI::get_field( $parent_form, $nested_form_field_id );

		$entry           = new GPNF_Entry( $entry );
		$parent_entry_id = $entry->set_parent_meta( $parent_form['id'], $parent_entry_id );
		$entry->set_nested_form_field( $nested_form_field->id );

		if ( ! is_numeric( $parent_entry_id ) ) {
			$entry->set_expiration();
		}

		return $entry->get_entry();
	}

	public function is_valid_rest_api_submissions_request() {
		global $wp;

		if ( ! defined( 'REST_REQUEST' ) || ! REST_REQUEST ) {
			return false;
		}

		if ( ! preg_match( '|wp-json/gf/v2/forms/([\d]+)/submissions|', $wp->request ) ) {
			return false;
		}

		if ( ! rgpost( GPNF_Entry::ENTRY_PARENT_KEY ) || ! rgpost( GPNF_Entry::ENTRY_PARENT_FORM_KEY ) || ! rgpost( GPNF_Entry::ENTRY_NESTED_FORM_FIELD_KEY ) ) {
			return false;
		}

		return true;
	}



	// # EDIT POPULATION AND SUBMISSION

	public function prepare_form_for_population( $form ) {

		foreach ( $form['fields'] as &$field ) {

			$field['allowsPrepopulate'] = true;

			if ( is_array( $field['inputs'] ) ) {
				$inputs = $field['inputs'];
				foreach ( $inputs as &$input ) {
					$input['name'] = (string) $input['id'];
				}
				$field['inputs'] = $inputs;
			}

			$field['inputName'] = $field['id'];

		}

		return $form;
	}

	public function set_edit_form_action( $form_tag ) {
		return preg_replace( "|action='(.*?)'|", "action=''", $form_tag );
	}

	public function set_gwlc_selected_values( $values, $field ) {

		$entry_id = $this->get_posted_entry_id();
		$entry    = GFAPI::get_entry( $entry_id );

		return GFFormsModel::get_lead_field_value( $entry, $field );

	}

	public function prepare_entry_for_population( $entry ) {

		$form = GFFormsModel::get_form_meta( $entry['form_id'] );

		foreach ( $form['fields'] as $field ) {

			switch ( GFFormsModel::get_input_type( $field ) ) {

				case 'checkbox':
					$values = $this->get_field_values_from_entry( $field, $entry );
					if ( is_array( $values ) ) {
						$value = implode( ',', array_filter( $values ) );
					} else {
						$value = $values;
					}
					$entry[ $field['id'] ] = $value;

					break;

				case 'list':
					$value       = maybe_unserialize( rgar( $entry, $field->id ) );
					$list_values = array();

					if ( is_array( $value ) ) {
						foreach ( $value as $vals ) {
							if ( is_array( $vals ) ) {
								// Escape commas so the value is not split into multiple inputs.
								$vals = implode(
									'|',
									array_map(
										function( $value ) {
											$value = str_replace( ',', '&#44;', $value );
											return $value;
										},
										$vals
									)
								);
							}
							array_push( $list_values, $vals );
						}
						$entry[ $field->id ] = implode( ',', $list_values );
					}

					break;

				case 'number':
					$value         = rgar( $entry, $field->id );
					$number_format = rgar( $field, 'numberFormat' );

					/*
					 * Ensure that number is correctly formatted when loaded into the form. By default, the saved value
					 * will always come through with periods for the decimal place and commas for thousand separator.
					 *
					 * Without this when using comma-period (e.g. Euro) format, conditional logic will reload the
					 * default value and can cause the number to be drastically changed.
					 */
					$entry[ $field['id'] ] = GFCommon::format_number( $value, $number_format );
					break;

				case 'multiselect':
					$value                 = self::maybe_decode_json( rgar( $entry, $field->id ) );
					$entry[ $field['id'] ] = $value;
					break;

				case 'fileupload':
					$field_id = (int) $field->id;
					$value    = rgar( $entry, $field_id );
					// Fetch the field from GF so populate_file_urls_from_value() updates the instance Gravity Forms saves.
					$field_object = GFFormsModel::get_field( $form, $field_id );

					// For GF 2.9.18+ multi-file fields, seed Gravity Forms' submission cache and skip the legacy branch below.
					if ( $this->supports_modern_file_upload_handling( $field_object ) ) {
						$this->hydrate_submission_files_cache( $field_object, $form, $entry );
						break;
					}

					$is_multiple = $field->multipleFiles;
					$return      = array();

					if ( $is_multiple ) {
						$files = json_decode( $value );
					} else {
						$files = array( $value );
					}

					if ( is_array( $files ) ) {
						foreach ( $files as $file ) {

							$path_info = pathinfo( $file );

							// Check if file has been "deleted" via form UI.
							$upload_files = json_decode( rgpost( 'gform_uploaded_files' ), ARRAY_A );
							$input_name   = "input_{$field_id}";

							if ( is_array( $upload_files ) && array_key_exists( $input_name, $upload_files ) && ! $upload_files[ $input_name ] ) {
								continue;
							}

							if ( $is_multiple ) {
								$return[] = array(
									'uploaded_filename' => $path_info['basename'],
								);
							} else {
								$return[] = $path_info['basename'];
							}
						}
					}

					// if $uploaded_files array is not set for this form at all, init as array
					if ( ! isset( GFFormsModel::$uploaded_files[ $form['id'] ] ) || ! is_array( GFFormsModel::$uploaded_files[ $form['id'] ] ) ) {
						GFFormsModel::$uploaded_files[ $form['id'] ] = array();
					}

					// check if this field's key has been set in the $uploaded_files array, if not add this file (otherwise, a new image may have been uploaded so don't overwrite)
					if ( ! isset( GFFormsModel::$uploaded_files[ $form['id'] ][ "input_{$field_id}" ] ) ) {
						GFFormsModel::$uploaded_files[ $form['id'] ][ "input_{$field_id}" ] = $is_multiple ? $return : reset( $return );
					}
			}

			switch ( $field->type ) {
				case 'post_category':
					$value = rgar( $entry, $field->id );

					if ( ! empty( $value ) ) {
						$categories = array();

						foreach ( explode( ',', $value ) as $cat_string ) {
							$categories[] = GFCommon::format_post_category( $cat_string, true );
						}

						$entry[ $field['id'] ] = 'multiselect' === $field->get_input_type() ? $categories : implode( '', $categories );
					}
					break;

				/*
				 * Gravity Flow Discussions cannot be edited, only new comments can be added so we need to clear out the value.
				 *
				 * Gravity Flow will handle appending the new comment to the discussion.
				 */
				case 'workflow_discussion':
					$entry[ $field['id'] ] = '';
					break;
			}
		}

		/**
		 * Filter the entry that will be populated for editing in the nested form.
		 *
		 * @since 1.0-beta-10.11
		 *
		 * @param array $entry An array of entry data that has been prepared for population.
		 * @param array $form  The form object of the nested form.
		 */
		$entry = gf_apply_filters( array( 'gpnf_populated_entry', $this->get_posted_parent_form_id(), $this->get_posted_nested_form_field_id() ), $entry, $form );

		return $entry;
	}

	public function get_field_values_from_entry( $field, $entry ) {

		$values = array();

		foreach ( $entry as $input_id => $value ) {
			$fid = intval( $input_id );
			if ( $fid == $field['id'] ) {
				$values[] = $value;
			}
		}

		return count( $values ) <= 1 ? $values[0] : $values;
	}

	public function maybe_edit_entry( $entry_id, $form ) {

		if ( $this->is_nested_form_edit_submission() ) {

			$entry_id = $this->get_posted_entry_id();
			$this->handle_existing_images_submission( $form, $entry_id );

			$this->entry_being_edited = GFAPI::get_entry( $entry_id );

			// Force Gravity Forms to fetch data from the post when evaluating conditional logic while re-saving the entry.
			add_filter( 'gform_use_post_value_for_conditional_logic_save_entry', '__return_true' );

			add_filter( 'gform_entry_post_save', array( $this, 'refresh_product_cache_and_update_total' ), 10, 2 );
			add_filter( 'gform_entry_post_save', array( $this, 'delete_conditional_logic_field_values' ), 10, 2 );

			// Run before other perks like GP Media Library change the new entry.
			add_filter( 'gform_entry_post_save', array( $this, 'delete_removed_uploaded_files' ), 5, 2 );

		}

		return $entry_id;
	}

	public function add_nested_inputs( $form_tag, $form ) {

		// makes it easier to show/hide these fields for debugging
		$type = 'hidden';

		// append parent form ID input
		$form_tag .= '<input type="' . $type . '" name="gpnf_parent_form_id" value="' . esc_attr( $this->get_parent_form_id() ) . '" />';

		// append nested form field ID input
		$form_tag .= '<input type="' . $type . '" name="gpnf_nested_form_field_id" value="' . esc_attr( $this->get_posted_nested_form_field_id() ) . '" />';

		// append entry ID and mode inputs
		$entry_id = $this->get_posted_entry_id();

		if ( $entry_id ) {
			$form_tag .= '<input type="' . $type . '" value="' . esc_attr( $entry_id ) . '" name="gpnf_entry_id" />';
			$form_tag .= '<input type="' . $type . '" value="edit" name="gpnf_mode" />';
		}

		// append has_validation_error bool input
		$is_valid  = ! isset( GFFormDisplay::$submission[ $form['id'] ] ) || rgar( GFFormDisplay::$submission[ $form['id'] ], 'is_valid' );
		$form_tag .= '<input type="' . $type . '" value="' . esc_attr( $is_valid ) . '" id="' . esc_attr( 'gpnf_is_valid_' . $form['id'] ) . '" />';

		$entry = GFAPI::get_entry( $entry_id );

		if ( wp_verify_nonce( rgpost( 'nonce' ), 'gpnf_edit_entry' ) && rgar( $entry, 'gpnf_entry_parent_form' ) == rgpost( 'gpnf_parent_form_id' ) ) {
			$form_tag .= '<input type="hidden" value="' . esc_attr( wp_create_nonce( 'gpnf_edit_entry_submission_' . $form['id'] ) ) . '" name="gpnf_edit_entry_submission" />';
		}

		return $form_tag;
	}

	/**
	 * When editing a child entry, refresh the product cache so changes made to pricing fields are correctly reflected in
	 * the entry.
	 *
	 * @param $entry
	 * @param $form
	 *
	 * @return mixed
	 */
	public function refresh_product_cache_and_update_total( $entry, $form ) {

		if ( ! $this->has_pricing_field( $form ) ) {
			return $entry;
		}

		// Gravity Forms will already refresh product cache when re-saving an entry if there is a calculation field.
		// Let's save a little load and only do this when GF won't.
		if ( ! GFFormDisplay::has_calculation_field( $form ) ) {
			GFFormsModel::refresh_product_cache( $form, $entry );
		}

		foreach ( $form['fields'] as $field ) {

			if ( $field['type'] == 'total' ) {
				$entry[ $field['id'] ] = GFCommon::get_order_total( $form, $entry );
				GFAPI::update_entry( $entry );
			}
		}

		return $entry;
	}

	/**
	 * Gravity Forms will not delete values from fields that are hidden via conditional logic when editing an entry.
	 * Let's handle this ourselves after editing a child entry.
	 *
	 * @param $entry
	 * @param $form
	 */
	public function delete_conditional_logic_field_values( $entry, $form ) {

		$original_entry = $entry;

		foreach ( $form['fields'] as &$field ) {
			if ( GFFormsModel::is_field_hidden( $form, $field, array(), $entry ) ) {
				foreach ( $entry as $key => &$value ) {
					if ( (int) $key === (int) $field->id ) {
						$value = null;
					}
				}
			}
		}

		if ( $original_entry !== $entry ) {
			GFAPI::update_entry( $entry );
		}

		return $entry;
	}

	/**
	 * When editing entries with `gform_entry_id_pre_save_lead` hook, when files are removed from File Upload field,
	 * Gravity Forms does not handle deleting them.
	 *
	 * @param array $entry
	 * @param array $form
	 *
	 * @return array
	 */
	public function delete_removed_uploaded_files( $entry, $form ) {
		if ( empty( $this->entry_being_edited ) || is_wp_error( $this->entry_being_edited ) ) {
			return $entry;
		}

		$existing_entry  = $this->entry_being_edited;
		$files_to_delete = array();
		$attachment_ids  = array();

		foreach ( $form['fields'] as $field ) {
			if ( $field->get_input_type() !== 'fileupload' ) {
				continue;
			}

			$input_name = "input_{$field['id']}";

			/*
			 * If the field is a Single File Upload, the value will be a string with the URL. Multi-file upload fields
			 * will have an array of URLs.
			 */
			if ( ! rgar( $field, 'multipleFiles' ) ) {
				$entry_value          = $entry[ $field['id'] ];
				$existing_entry_value = $existing_entry[ $field['id'] ];

				if ( $entry_value !== $existing_entry_value && ! empty( $existing_entry_value ) ) {
					$files_to_delete[] = $existing_entry_value;
				}

				if ( function_exists( 'gp_media_library' ) && gp_media_library()->is_applicable_field( $field ) ) {
					$attachment_ids[] = gp_media_library()->get_file_ids( $entry['id'], $field['id'] );
				}
			} else {
				/**
				 * Do an array intersect to get the files that were removed by comparing $entry with
				 *  $existing_entry.
				 */
				$entry_value          = json_decode( $entry[ $field['id'] ] );
				$entry_value          = is_array( $entry_value ) ? $entry_value : array();
				$existing_entry_value = json_decode( $existing_entry[ $field['id'] ] );
				$existing_entry_value = is_array( $existing_entry_value ) ? $existing_entry_value : array();
				$files_to_delete      = is_array( $$files_to_delete ) ? $files_to_delete : array();

				$files_to_delete = array_merge( $files_to_delete, array_diff( $existing_entry_value, $entry_value ) );

				if ( function_exists( 'gp_media_library' ) && gp_media_library()->is_applicable_field( $field ) ) {
					// $file_ids will have the same indexes as $existing_entry_value. Figure out the indexes of the files that were removed.
					$file_ids = gp_media_library()->get_file_ids( $entry['id'], $field['id'] );

					foreach ( $existing_entry_value as $index => $url ) {
						if ( ! in_array( $url, $entry_value ) ) {
							$attachment_ids[] = $file_ids[ $index ];
						}
					}
				}
			}
		}

		unset( $this->entry_being_edited );

		if ( ! empty( $files_to_delete ) ) {
			foreach ( $files_to_delete as $file_to_delete ) {
				$this->delete_physical_file( $file_to_delete, $entry['id'] );
			}
		}

		if ( ! empty( $attachment_ids ) ) {
			foreach ( $attachment_ids as $attachment_id ) {
				wp_delete_attachment( $attachment_id, true );
			}
		}

		return $entry;
	}

	/**
	 * Duplicate of GFFormsModel::delete_physical_file() due to it being a private method.
	 *
	 * @param $file_url
	 * @param $entry_id
	 *
	 * @return void
	 */
	public function delete_physical_file( $file_url, $entry_id ) {

		$ary = explode( '|:|', $file_url );
		$url = rgar( $ary, 0 );
		if ( empty( $url ) ) {
			return;
		}

		$file_path = GFFormsModel::get_physical_file_path( $url, $entry_id );

		/**
		 * Allow the file path to be overridden so files stored outside the /wp-content/uploads/gravity_forms/ directory can be deleted.
		 *
		 * @since 2.2.3.1
		 *
		 * @param string $file_path The path of the file to be deleted.
		 * @param string $url       The URL of the file to be deleted.
		 */
		$file_path = apply_filters( 'gform_file_path_pre_delete_file', $file_path, $url );

		if ( file_exists( $file_path ) ) {
			unlink( $file_path );
			gform_delete_meta( $entry_id, GF_Field_FileUpload::get_file_upload_path_meta_key_hash( $url ) );
		}
	}

	public function has_pricing_field( $form ) {

		if ( $form && is_array( $form['fields'] ) ) {
			foreach ( $form['fields'] as $field ) {
				if ( GFCommon::is_product_field( $field->type ) ) {
					return true;
				}
			}
		}

		return false;
	}

	public function handle_existing_images_submission( $form, $entry_id ) {
		global $_gf_uploaded_files;

		$entry = GFAPI::get_entry( $entry_id );
		if ( ! $entry ) {
			return;
		}

		// get all fileupload fields
		// loop through and see if the image has been:
		//  - resubmitted:         populate the existing image data into the $_gf_uploaded_files
		//  - deleted:             do nothing
		//  - new image submitted: do nothing

		if ( empty( $_gf_uploaded_files ) ) {
			$_gf_uploaded_files = array();
		}

		foreach ( $entry as $input_id => $value ) {

			if ( ! is_numeric( $input_id ) ) {
				continue;
			}

			$field = GFFormsModel::get_field( $form, $input_id );
			// If the Input ID doesn't point to a field on the form, skip it.
			if ( ! $field ) {
				continue;
			}

			$field_id   = (int) ( $field instanceof GF_Field ? $field->id : $input_id );
			$input_name = "input_{$field_id}";

			if ( $field->get_input_type() != 'fileupload' ) {
				continue;
			}

			// GF 2.9.18+ fields already have their cache seeded in prepare_entry_for_population().
			if ( $this->supports_modern_file_upload_handling( $field ) ) {
				continue;
			}

			// Handle multi-file uploads.
			if ( $field->multipleFiles ) {

				$value = json_decode( $value, true );
				if ( ! is_array( $value ) ) {
					$value = array();
				}

				$posted = wp_list_pluck( rgar( json_decode( rgpost( 'gform_uploaded_files' ), true ), $input_name ), 'uploaded_filename' );
				$count  = count( $value );

				// Remove any files that have been removed via the UI.
				for ( $i = $count - 1; $i >= 0; $i-- ) {
					$path = pathinfo( $value[ $i ] );
					if ( ! in_array( $path['basename'], $posted ) ) {
						unset( $value[ $i ] );
					}
				}
			}
			// Handle single file uploads.
			elseif ( self::is_prepopulated_file_upload( $form['id'], $input_name ) ) {
				$_gf_uploaded_files[ $input_name ] = $value;
				// Not sure why but this is needed only required for Gravity Flow. Otherwise, the file uploaded value gets lost.
				if ( rgget( 'page' ) == 'gravityflow-inbox' ) {
					$_FILES[ $input_name ]['name'] = $value;
				}
			}
		}

	}

	/**
	 * Check for newly updated file. Only applies to single file uploads.
	 *
	 * @param $form_id
	 * @param $input_name
	 *
	 * @return bool
	 */
	public function is_new_file_upload( $form_id, $input_name ) {

		$file_info     = GFFormsModel::get_temp_filename( $form_id, $input_name );
		$temp_filepath = GFFormsModel::get_upload_path( $form_id ) . '/tmp/' . $file_info['temp_filename'];

		// check if file has already been uploaded by previous step
		if ( $file_info && file_exists( $temp_filepath ) ) {
			return true;
		}
		// check if file is uploaded on current step
		elseif ( ! empty( $_FILES[ $input_name ]['name'] ) ) {
			return true;
		}

		return false;
	}

	public function is_prepopulated_file_upload( $form_id, $input_name, $is_multiple = false ) {

		// prepopulated files will be stored in the 'gform_uploaded_files' field
		$uploaded_files = json_decode( rgpost( 'gform_uploaded_files' ), ARRAY_A );

		// file is prepopulated if it is present in the 'gform_uploaded_files' field AND is not a new file upload
		$in_uploaded_files = is_array( $uploaded_files ) && array_key_exists( $input_name, $uploaded_files ) && ! empty( $uploaded_files[ $input_name ] );
		$is_prepopulated   = $in_uploaded_files && ! $this->is_new_file_upload( $form_id, $input_name );

		return $is_prepopulated;
	}



	// # VALIDATION

	public function has_nested_form_field( $form, $check_visibility = false ) {
		$fields = GFCommon::get_fields_by_type( $form, $this->field_type );
		$count  = 0;
		foreach ( $fields as $field ) {
			if ( ! $check_visibility || $field->visibility != 'administrative' ) {
				$count++;
			}
		}
		return $count > 0;
	}



	// # INTEGRATIONS

	public function add_full_child_entry_data_for_webhooks( $data, $feed, $entry, $form ) {

		// This should be structed like an Entry Object; if not, we don't want to mess with it.
		if ( ! is_array( $data ) ) {
			return $data;
		}

		foreach ( $form['fields'] as $field ) {

			if ( $field->get_input_type() != $this->field_type || ! array_key_exists( $field->id, $data ) ) {
				continue;
			}

			$_entry             = new GPNF_Entry( $entry );
			$data[ $field->id ] = $_entry->get_child_entries( $field->id );

		}

		return $data;
	}

	public function adopt_partial_entry_children( $partial_entry, $form ) {

		$parent_entry  = new GPNF_Entry( $partial_entry );
		$child_entries = $parent_entry->get_child_entries();

		foreach ( $child_entries as $child_entry ) {
			$child_entry      = new GPNF_Entry( $child_entry );
			$parent_entry->id = $child_entry->set_parent_meta( $form['id'], $parent_entry->id );
			$child_entry->delete_expiration();
		}

		// Set the session hash on the partial entry so we know that this parent entry (and its child entries) still belong to the current session.
		gform_update_meta( $partial_entry['id'], GPNF_Session::SESSION_HASH_META_KEY, rgpost( 'gpnf_session_hash' ) );

		return $partial_entry;
	}


	// # HELPERS

	public function is_nested_form_submission() {
		$parent_form_id = $this->get_parent_form_id();
		return $parent_form_id > 0;
	}

	public function is_form_submission() {
		// $_POST['gforms_save_entry'] is set when editing an entry via Gravity Flow.
		return rgpost( 'gform_submit' ) || rgpost( 'gforms_save_entry' );
	}

	public function is_nested_form_edit_submission() {
		return $this->is_nested_form_submission() && rgpost( 'gpnf_mode' ) == 'edit' && GPNF_Entry::can_current_user_edit_entry( GFAPI::get_entry( $this->get_posted_entry_id() ) );
	}

	public function get_parent_form_id() {

		if ( ! $this->parent_form_id ) {
			$this->parent_form_id = $this->get_posted_parent_form_id();
		}

		return $this->parent_form_id;
	}

	/**
	 * Check if a form has a nested form field
	 * @param string $form_id  Form ID to check
	 * @return bool Form contains a nested form
	 */
	public function has_child_form( $form_or_id ) {
		$form = is_array( $form_or_id ) ? $form_or_id : GFAPI::get_form( $form_or_id );
		if ( ! $form || empty( $form['fields'] ) ) {
			return false;
		}
		foreach ( $form['fields'] as $field ) {
			if ( $field->type === 'form' ) {
				return true;
			}
		}
		return false;
	}

	/**
	 * @param int|array $form_or_id The form ID or form object.
	 * @param array $entry The entry object. It is passed to the gpnf_get_nested_form filter so that GPPA can hydrate values with the entry data.
	 */
	public function get_nested_form( $nested_form_or_id, $entry = null ) {
		// Do not return a form object if it contains a child form
		// This prevents recursion/infinite loop.
		if ( ! $this->has_child_form( $nested_form_or_id ) ) {
			$nested_form = is_array( $nested_form_or_id ) ? $nested_form_or_id : GFAPI::get_form( $nested_form_or_id );

			if ( ! $nested_form ) {
				return false;
			}

			return gf_apply_filters( array( 'gpnf_get_nested_form', $nested_form['id'] ), $nested_form, $entry );
		}

		return false;
	}

	public function get_posted_parent_form_id() {
		return absint( rgpost( 'gpnf_parent_form_id' ) );
	}

	public function get_posted_nested_form_field_id() {
		return absint( rgpost( 'gpnf_nested_form_field_id' ) );
	}

	public function get_posted_entry_id() {
		return rgpost( 'gpnf_entry_id' );
	}

	public function get_fields_by_ids( $ids, $form, $include_row_id = false ) {
		$fields = array();

		if ( ! is_array( $ids ) ) {
			return $fields;
		}

		foreach ( $ids as $id ) {
			if ( $include_row_id && $id === 'row_id' ) {
				$fields[] = $this->get_row_id_field( $form );
			} else {
				foreach ( $form['fields'] as $field ) {
					if ( $field->id == $id ) {
						$fields[] = $field;
					}
				}
			}
		}

		return $fields;
	}

	/**
	 * Due to our __call() method, is_callable() checks will result in fatal errors. We don't need this function but
	 * let's define it to avoid unpleasantries.
	 */
	public function get_form_field_value( $entry, $field_id, $field ) {
		return $field->get_value_export( $entry, $field_id );
	}

	/**
	 * Remove/replace old settings with their newer counterparts.
	 *
	 * @param $form
	 *
	 * @return mixed
	 */
	public function cleanup_form_meta( $form ) {

		$settings_map = array(
			'gp-nested-forms_fields' => 'gpnfFields',
			'gp-nested-forms_form'   => 'gpnfForm',
		);

		if ( empty( $form['fields'] ) ) {
			return $form;
		}

		foreach ( $form['fields'] as &$field ) {

			if ( $field->type != 'form' ) {
				continue;
			}

			foreach ( $settings_map as $old => $new ) {
				if ( $field->$old ) {
					if ( ! $field->$new ) {
						$field->$new = $field->$old;
					}
					unset( $field->{$old} );
				}
			}
		}

		return $form;
	}

	public function wpml_translate_entry_labels( $field_keys ) {
		$field_keys[] = 'gpnfEntryLabelSingular';
		$field_keys[] = 'gpnfEntryLabelPlural';
		return $field_keys;
	}

	/**
	 * Re-render the Signature field when editing Nested Entries with the value of the entry being edited.
	 *
	 * Ticket #22155
	 */
	public function rerender_signature_field_on_edit( $markup, $field, $value, $entry_id, $form_id ) {
		static $_processing;

		if ( $field->type !== 'signature' ) {
			return $markup;
		}

		/**
		 * Prevent recursion
		 */
		if ( $_processing === true ) {
			return $markup;
		}

		if ( empty( $GLOBALS['gpnf_current_edit_entry'] ) ) {
			return $markup;
		}

		$entry = $GLOBALS['gpnf_current_edit_entry'];
		$form  = GFAPI::get_form( $form_id );

		$_processing = true;
		$markup      = GFCommon::get_field_input( $field, rgar( $entry, $field->id ), $entry_id, $form_id, $form );
		$_processing = false;

		return $markup;
	}

	public function is_preview() {
		return rgget( 'gf_page' );
	}

	/**
	 * Check if installed version of Gravity Forms is greater than or equal to the specified version.
	 *
	 * @param string $version Version to compare with Gravity Forms' version.
	 *
	 * @return bool
	 */
	public function is_gf_version_gte( $version ) {
		return class_exists( 'GFForms' ) && version_compare( GFForms::$version, $version, '>=' );
	}

	/**
	 * Returns a query parameter from the current XHR request or the parent form's $_REQUEST.
	 *
	 * Note: This relies on the session cookie that's stored when the parent form initially loads
	 *
	 * @param string $param Query parameter to get
	 *
	 * @return string|null Value of query parameter if present
	 */
	public function get_query_arg( $param ) {
		$value = rgar( $_REQUEST, $param );

		// If we didn't find a value in $_GET, let's check our session.
		if ( rgblank( $value ) ) {
			$value = rgars( $_REQUEST, "gpnf_context/request/{$param}" );
		}

		return $value;
	}

	/**
	 * @param $nested_form array The nested form having the Row ID field prepended to it. Used for filtering.
	 *
	 * @return GF_Field Row ID field.
	 */
	public function get_row_id_field( $nested_form ) {
		return new GF_Field( array(
			'id'    => 'row_id',
			/**
			 * Filter the Row ID Summary Field label.
			 *
			 * @since 1.1.3
			 *
			 * @param string $row_id_label Row ID label.
			 * @param array $nested_form The current nested form.
			 */
			'label' => gf_apply_filters( array( 'gpnf_row_id_label', $nested_form['id'] ), __( 'Row ID', 'gp-nested-forms' ), $nested_form ),
			'type'  => 'gpnf_row_id',
		) );
	}

	public function add_row_id_field( $nested_form ) {
		if ( isset( $nested_form['fields'] ) && is_array( $nested_form['fields'] ) && rgars( $nested_form, 'fields/0/type' ) !== 'gpnf_row_id' ) {
			array_unshift( $nested_form['fields'], $this->get_row_id_field( $nested_form ) );
		}

		return $nested_form;
	}

	public function get_index_of_child_entry( $child_entry ) {
		$parent_entry_form_id = rgar( $child_entry, GPNF_Entry::ENTRY_PARENT_FORM_KEY, false );
		$parent_entry_id      = rgar( $child_entry, GPNF_Entry::ENTRY_PARENT_KEY, false );
		$nested_form_field_id = rgar( $child_entry, GPNF_Entry::ENTRY_NESTED_FORM_FIELD_KEY, false );

		// If the parent is numeric, it has been created and the child entries are not orphaned.
		if ( is_numeric( $parent_entry_id ) ) {
			$parent_entry = new GPNF_Entry( $parent_entry_id );

			if ( ! is_wp_error( $parent_entry->get_entry() ) ) {
				$child_entry_ids = wp_list_pluck( $parent_entry->get_child_entries( $nested_form_field_id ), 'id' );

				return array_search( $child_entry['id'], $child_entry_ids );
			}
		}

		/*
		 * Pull off of session.
		 *
		 * Note, this logic won't be used in many scenarios as the frontend row ID is handled by Knockout computed.
		 */
		$session                = new GPNF_Session( $parent_entry_form_id );
		$session_nested_entries = $session->get( 'nested_entries' );

		if ( ! empty( $session_nested_entries[ $nested_form_field_id ] ) ) {
			$index = array_search( $child_entry['id'], $session_nested_entries[ $nested_form_field_id ] );

			if ( $index !== false ) {
				return $index;
			}

			// We're returning the new index so no need to increment by one.
			return count( $session_nested_entries[ $nested_form_field_id ] );
		}

		return 0;
	}

	public function row_id_field_value( $value, $entry, $field ) {
		if ( empty( $field ) || $field->type !== 'gpnf_row_id' ) {
			return $value;
		}

		return $this->get_index_of_child_entry( $entry ) + 1;
	}

	/*
	 * Force Nested Forms to be displayed if the nonce is passed or if we're in a GravityView Edit context.
	 *
	 * We need this for obvious reasons when the nonce is passed for the Edit modal so the form can actually be rendered.
	 *
	 * The reason for the GravityView edit context is not as straight-forward. That's needed so the assets for the
	 * child form can get enqueued, such as for Rich Text Editors, etc.
	 */
	public function force_display_expired_nested_form( $form_args ) {
		// If we're in the context of GravityView, we need to force the display of the child form to enqueue assets.
		if (
			function_exists( 'gravityview' )
			&& gravityview()->request->is_edit_entry()
			&& class_exists( 'GravityView_frontend' )
		) {
			$gv_entry = GravityView_frontend::getInstance()->getEntry();

			if ( $gv_entry ) {
				$gv_entry_form = GFAPI::get_form( rgar( $gv_entry, 'form_id' ) );

				// If $form_args['id'] exists in the parent form as a nested form field, allow it to be displayed.
				if ( is_array( $gv_entry_form['fields'] ) ) {
					foreach ( $gv_entry_form['fields'] as $field ) {
						if ( $field->type === 'form' && $field->gpnfForm == $form_args['form_id'] ) {
							$form_args['force_display'] = true;
							break;
						}
					}
				}
			}
		}

		if ( wp_verify_nonce( rgpost( 'nonce' ), 'gpnf_edit_entry' ) ) {
			$form_args['force_display'] = true;
		}

		return $form_args;
	}

	/*
	 * If the nonce is passed when submitting an edited entry, we need to ensure that we clear out any form scheduling
	 * so that the submission is accepted.
	 */
	public function skip_expired_nested_form_schedule_validation( $form ) {
		if ( wp_verify_nonce( rgpost( 'gpnf_edit_entry_submission' ), 'gpnf_edit_entry_submission_' . $form['id'] ) ) {
			$form['scheduleForm'] = false;
		}

		return $form;
	}

	/**
	 * Callback to override the Gravity Forms theme when in the GF preview.
	 *
	 * This is needed as GFCommon::is_preview() does not account for the AJAX requests to get the child form markup.
	 */
	public function override_gf_theme_in_preview( $slug, $form ) {
		/*
		 * If the slug is already gravity-theme, we don't need to change it. We're also only here to change the slug
		 * in AJAX contexts (for GF version prior to 2.9.3).
		 */
		if ( $slug === 'gravity-theme' || ! wp_doing_ajax() || version_compare( GFCommon::$version, '2.9.3', '>=' ) ) {
			return $slug;
		}

		// Get the referring URL for the AJAX request to determine if it's a GF preview.
		$referrer = wp_get_referer();

		// If the referrer is not set, we can't determine if it's a GF preview.
		if ( ! $referrer ) {
			return $slug;
		}

		// If the referrer is not a GF preview, we don't need to change the slug.
		if ( strpos( $referrer, 'gf_page=preview' ) === false ) {
			return $slug;
		}

		return 'gravity-theme';
	}

}

/**
 * Returns the GP_Nested_Forms singleton.
 *
 * @return GP_Nested_Forms
 */
function gp_nested_forms() {
	return GP_Nested_Forms::get_instance();
}

GFAddOn::register( 'GP_Nested_Forms' );