File "acf-form-functions.php"

Full Path: /home/vantageo/public_html/wp-admin-20240915120854/wp-includes-20240915121038/IXR/advanced-custom-fields-pro/includes/acf-form-functions.php
File size: 3.31 KB
MIME-type: text/x-php
Charset: utf-8

<?php 

// Register store for form data.
acf_register_store( 'form' );

/**
 * acf_set_form_data
 *
 * Sets data about the current form.
 *
 * @date	6/10/13
 * @since	5.0.0
 *
 * @param	string $name The store name.
 * @param	array $data Array of data to start the store with.
 * @return	ACF_Data
 */
function acf_set_form_data( $name = '', $data = false ) {
	return acf_get_store( 'form' )->set( $name, $data );
}

/**
 * acf_get_form_data
 *
 * Gets data about the current form.
 *
 * @date	6/10/13
 * @since	5.0.0
 *
 * @param	string $name The store name.
 * @return	mixed
 */
function acf_get_form_data( $name = '' ) {
	return acf_get_store( 'form' )->get( $name );
}

/**
 * acf_form_data
 *
 * Called within a form to set important information and render hidden inputs.
 *
 * @date	15/10/13
 * @since	5.0.0
 *
 * @param	void
 * @return	void
 */
function acf_form_data( $data = array() ) {
	
	// Apply defaults.
	$data = wp_parse_args($data, array(
		
		/** @type string The current screen (post, user, taxonomy, etc). */
		'screen' => 'post',
		
		/** @type int|string The ID of current post being edited. */
		'post_id' => 0,
		
		/** @type bool Enables AJAX validation. */
		'validation' => true,
	));
	
	// Create nonce using screen.
	$data['nonce'] = wp_create_nonce( $data['screen'] );
	
	// Append "changed" input used within "_wp_post_revision_fields" action.
	$data['changed'] = 0;
	
	// Set data.
	acf_set_form_data( $data );
	
	// Render HTML.
	?>
	<div id="acf-form-data" class="acf-hidden">
		<?php 
		
		// Create hidden inputs from $data
		foreach( $data as $name => $value ) {
			acf_hidden_input(array(
				'id'	=> '_acf_' . $name,
				'name'	=> '_acf_' . $name,
				'value'	=> $value
			));
		}
		
		/**
		 * Fires within the #acf-form-data element to add extra HTML.
		 *
		 * @date	15/10/13
		 * @since	5.0.0
		 *
		 * @param	array $data The form data.
		 */
		do_action( 'acf/form_data', $data );
		do_action( 'acf/input/form_data', $data );
		
		?>
	</div>
	<?php
}


/**
 * acf_save_post
 *
 * Saves the $_POST data.
 *
 * @date	15/10/13
 * @since	5.0.0
 *
 * @param	int|string $post_id The post id.
 * @param	array $values An array of values to override $_POST.
 * @return	bool True if save was successful.
 */
function acf_save_post( $post_id = 0, $values = null ) {
	
	// Override $_POST data with $values.
	if( $values !== null ) {
		$_POST['acf'] = $values;
	}
	
	// Bail early if no data to save.
	if( empty($_POST['acf']) ) {
		return false;
	}
	
	// Set form data (useful in various filters/actions).
	acf_set_form_data( 'post_id', $post_id );
	
	// Filter $_POST data for users without the 'unfiltered_html' capability.
	if( !acf_allow_unfiltered_html() ) {
		$_POST['acf'] = wp_kses_post_deep( $_POST['acf'] );
	}
	
	// Do generic action.
	do_action( 'acf/save_post', $post_id );
	
	// Return true.
	return true;
}

/**
 * _acf_do_save_post
 *
 * Private function hooked into 'acf/save_post' to actually save the $_POST data.
 * This allows developers to hook in before and after ACF has actually saved the data.
 *
 * @date	11/1/19
 * @since	5.7.10
 *
 * @param	int|string $post_id The post id.
 * @return	void
 */
function _acf_do_save_post( $post_id = 0 ) {
	
	// Check and update $_POST data.
	if( $_POST['acf'] ) {
		acf_update_values( $_POST['acf'], $post_id );
	}	
}

// Run during generic action.
add_action( 'acf/save_post', '_acf_do_save_post' );