From d3de5987efaee7c694be314b965325536e11dedd Mon Sep 17 00:00:00 2001
From: Samuel Bassah <sbassah@gmail.com>
Date: Tue, 7 Jan 2025 14:38:53 +0000
Subject: [PATCH] `gpnf-add-child-entry-on-render.php`: Migrated from
 `experimental` folder.

---
 .../gpnf-add-child-entry-on-render.php        | 79 +++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 gp-nested-forms/gpnf-add-child-entry-on-render.php

diff --git a/gp-nested-forms/gpnf-add-child-entry-on-render.php b/gp-nested-forms/gpnf-add-child-entry-on-render.php
new file mode 100644
index 000000000..2ea8e64be
--- /dev/null
+++ b/gp-nested-forms/gpnf-add-child-entry-on-render.php
@@ -0,0 +1,79 @@
+<?php
+/**
+ * Gravity Perks // Nested Forms // Add Child Entry on Render
+ * https://gravitywiz.com/documentation/gravity-forms-nested-forms/
+ *
+ * Experimental Snippet 🧪
+ *
+ * Programattically create and attach a child entry to a Nested Form field when the parent form is rendered.
+ *
+ * Please note: A new child entry will be added on every render. You will need to identify your own condition
+ * for when a child entry should be generated and attached.
+ */
+// Update "123" to your form ID and "4" to your Nested Form field ID.
+add_filter( 'gpnf_submitted_entry_ids_123_4', function( $entry_ids, $parent_form, $nested_form_field ) {
+
+	$hash = gpnf_session_hash( $parent_form['id'] );
+
+	$child_entry_id = gpnf_add_child_entry( $hash, $nested_form_field->id, array(
+		// Update "1" to any field ID from your child form and "Second Choice" the value that should be saved to this field.
+		'1' => 'Second Choice',
+		// Update "2" to another field ID in your child field and "Second" to the value that should be saved to it.
+		'2' => time(),
+		// Add as many "field ID" => "value" pairs as required.
+	), $parent_form['id'] );
+
+	$session = new GPNF_Session( $parent_form['id'] );
+
+	// Attach new child entry to the session.
+	$session->add_child_entry( $child_entry_id );
+
+	// Get all entry IDs from the session and return them.
+	$session_entry_ids = $session->get( 'nested_entries' );
+	if ( ! empty( $session_entry_ids[ $nested_form_field->id ] ) ) {
+		$entry_ids = $session_entry_ids[ $nested_form_field->id ];
+	}
+
+	return $entry_ids;
+}, 10, 3 );
+
+if ( ! function_exists( 'gpnf_session_hash' ) ) {
+	function gpnf_session_hash( $form_id ) {
+		$session = new GPNF_Session( $form_id );
+		return $session->get_runtime_hashcode();
+	}
+}
+
+if ( ! function_exists( 'gpnf_add_child_entry' ) ) {
+	/**
+	 * @param int   $parent_entry_id      The ID of the entry to which this child entry should be attached.
+	 * @param int   $nested_form_field_id The ID of the Nested Form field on the parent form to which this child entry should be attached.
+	 * @param array $field_values         An array of field values that will be used to created the child entry (e.g. array( 1 => 'value' )).
+	 * @param int   $parent_form_id       The ID of the parent entry's form. If not provided, will be looked up based on the provided parent entry ID.
+	 */
+	function gpnf_add_child_entry( $parent_entry_id, $nested_form_field_id, $field_values = array(), $parent_form_id = false ) {
+
+		if ( ! $parent_form_id ) {
+			$parent_entry   = GFAPI::get_entry( $parent_entry_id );
+			$parent_form_id = $parent_entry['form_id'];
+		}
+
+		$nested_form_field = GFAPI::get_field( $parent_form_id, $nested_form_field_id );
+
+		$new_child_entry = array_replace( array(
+			// The ID of the parent form.
+			'form_id'                               => $nested_form_field->gpnfForm,
+			'created_by'                            => null,
+			// The ID of the parent entry.
+			GPNF_Entry::ENTRY_PARENT_KEY            => $parent_entry_id,
+			// The ID of the parent form.
+			GPNF_Entry::ENTRY_PARENT_FORM_KEY       => $parent_form_id,
+			// The ID of the Nested Form field on the parent form.
+			GPNF_Entry::ENTRY_NESTED_FORM_FIELD_KEY => $nested_form_field_id,
+		), $field_values );
+
+		$new_child_entry_id = GFAPI::add_entry( $new_child_entry );
+
+		return $new_child_entry_id;
+	}
+}