initial commit

hamrokhaanpaan/wp-content/__plugins/advanced-custom-fields-pro/includes/acf-value-functions.php

@@ -0,0 +1,324 @@
+<?php
+
+// Register store.
+acf_register_store( 'values' )->prop( 'multisite', true );
+
+/**
+ * acf_get_reference
+ *
+ * Retrieves the field key for a given field name and post_id.
+ *
+ * @date    26/1/18
+ * @since   5.6.5
+ *
+ * @param   string $field_name The name of the field. eg 'sub_heading'.
+ * @param   mixed  $post_id The post_id of which the value is saved against.
+ * @return  string The field key.
+ */
+function acf_get_reference( $field_name, $post_id ) {
+
+	// Allow filter to short-circuit load_value logic.
+	$reference = apply_filters( 'acf/pre_load_reference', null, $field_name, $post_id );
+	if ( $reference !== null ) {
+		return $reference;
+	}
+
+	// Get hidden meta for this field name.
+	$reference = acf_get_metadata( $post_id, $field_name, true );
+
+	/**
+	 * Filters the reference value.
+	 *
+	 * @date    25/1/19
+	 * @since   5.7.11
+	 *
+	 * @param   string $reference The reference value.
+	 * @param   string $field_name The field name.
+	 * @param   (int|string) $post_id The post ID where meta is stored.
+	 */
+	return apply_filters( 'acf/load_reference', $reference, $field_name, $post_id );
+}
+
+/**
+ * Retrieves the value for a given field and post_id.
+ *
+ * @date    28/09/13
+ * @since   5.0.0
+ *
+ * @param   int|string $post_id The post id.
+ * @param   array      $field The field array.
+ * @return  mixed
+ */
+function acf_get_value( $post_id, $field ) {
+
+	// Allow filter to short-circuit load_value logic.
+	$value = apply_filters( 'acf/pre_load_value', null, $post_id, $field );
+	if ( $value !== null ) {
+		return $value;
+	}
+
+	// Get field name.
+	$field_name = $field['name'];
+
+	// Check store.
+	$store = acf_get_store( 'values' );
+	if ( $store->has( "$post_id:$field_name" ) ) {
+		return $store->get( "$post_id:$field_name" );
+	}
+
+	// Load value from database.
+	$value = acf_get_metadata( $post_id, $field_name );
+
+	// Use field's default_value if no meta was found.
+	if ( $value === null && isset( $field['default_value'] ) ) {
+		$value = $field['default_value'];
+	}
+
+	/**
+	 * Filters the $value after it has been loaded.
+	 *
+	 * @date    28/09/13
+	 * @since   5.0.0
+	 *
+	 * @param   mixed $value The value to preview.
+	 * @param   string $post_id The post ID for this value.
+	 * @param   array $field The field array.
+	 */
+	$value = apply_filters( 'acf/load_value', $value, $post_id, $field );
+
+	// Update store.
+	$store->set( "$post_id:$field_name", $value );
+
+	// Return value.
+	return $value;
+}
+
+// Register variation.
+acf_add_filter_variations( 'acf/load_value', array( 'type', 'name', 'key' ), 2 );
+
+/**
+ * acf_format_value
+ *
+ * Returns a formatted version of the provided value.
+ *
+ * @date    28/09/13
+ * @since   5.0.0
+ *
+ * @param   mixed        $value The field value.
+ * @param   (int|string) $post_id The post id.
+ * @param   array        $field The field array.
+ * @return  mixed.
+ */
+function acf_format_value( $value, $post_id, $field ) {
+
+	// Allow filter to short-circuit load_value logic.
+	$check = apply_filters( 'acf/pre_format_value', null, $value, $post_id, $field );
+	if ( $check !== null ) {
+		return $check;
+	}
+
+	// Get field name.
+	$field_name = $field['name'];
+
+	// Check store.
+	$store = acf_get_store( 'values' );
+	if ( $store->has( "$post_id:$field_name:formatted" ) ) {
+		return $store->get( "$post_id:$field_name:formatted" );
+	}
+
+	/**
+	 * Filters the $value for use in a template function.
+	 *
+	 * @date    28/09/13
+	 * @since   5.0.0
+	 *
+	 * @param   mixed $value The value to preview.
+	 * @param   string $post_id The post ID for this value.
+	 * @param   array $field The field array.
+	 */
+	$value = apply_filters( 'acf/format_value', $value, $post_id, $field );
+
+	// Update store.
+	$store->set( "$post_id:$field_name:formatted", $value );
+
+	// Return value.
+	return $value;
+}
+
+// Register variation.
+acf_add_filter_variations( 'acf/format_value', array( 'type', 'name', 'key' ), 2 );
+
+/**
+ * acf_update_value
+ *
+ * Updates the value for a given field and post_id.
+ *
+ * @date    28/09/13
+ * @since   5.0.0
+ *
+ * @param   mixed        $value The new value.
+ * @param   (int|string) $post_id The post id.
+ * @param   array        $field The field array.
+ * @return  bool.
+ */
+function acf_update_value( $value, $post_id, $field ) {
+
+	// Allow filter to short-circuit update_value logic.
+	$check = apply_filters( 'acf/pre_update_value', null, $value, $post_id, $field );
+	if ( $check !== null ) {
+		 return $check;
+	}
+
+	/**
+	 * Filters the $value before it is updated.
+	 *
+	 * @date    28/09/13
+	 * @since   5.0.0
+	 *
+	 * @param   mixed $value The value to update.
+	 * @param   string $post_id The post ID for this value.
+	 * @param   array $field The field array.
+	 * @param   mixed $original The original value before modification.
+	 */
+	$value = apply_filters( 'acf/update_value', $value, $post_id, $field, $value );
+
+	// Allow null to delete value.
+	if ( $value === null ) {
+		return acf_delete_value( $post_id, $field );
+	}
+
+	// Update meta.
+	$return = acf_update_metadata( $post_id, $field['name'], $value );
+
+	// Update reference.
+	acf_update_metadata( $post_id, $field['name'], $field['key'], true );
+
+	// Delete stored data.
+	acf_flush_value_cache( $post_id, $field['name'] );
+
+	// Return update status.
+	return $return;
+}
+
+// Register variation.
+acf_add_filter_variations( 'acf/update_value', array( 'type', 'name', 'key' ), 2 );
+
+/**
+ * acf_update_values
+ *
+ * Updates an array of values.
+ *
+ * @date    26/2/19
+ * @since   5.7.13
+ *
+ * @param   array values The array of values.
+ * @param   (int|string)                     $post_id The post id.
+ * @return  void
+ */
+function acf_update_values( $values, $post_id ) {
+
+	// Loop over values.
+	foreach ( $values as $key => $value ) {
+
+		// Get field.
+		$field = acf_get_field( $key );
+
+		// Update value.
+		if ( $field ) {
+			acf_update_value( $value, $post_id, $field );
+		}
+	}
+}
+
+/**
+ * acf_flush_value_cache
+ *
+ * Deletes all cached data for this value.
+ *
+ * @date    22/1/19
+ * @since   5.7.10
+ *
+ * @param   (int|string) $post_id The post id.
+ * @param   string       $field_name The field name.
+ * @return  void
+ */
+function acf_flush_value_cache( $post_id = 0, $field_name = '' ) {
+
+	// Delete stored data.
+	acf_get_store( 'values' )
+		->remove( "$post_id:$field_name" )
+		->remove( "$post_id:$field_name:formatted" );
+}
+
+/**
+ * acf_delete_value
+ *
+ * Deletes the value for a given field and post_id.
+ *
+ * @date    28/09/13
+ * @since   5.0.0
+ *
+ * @param   (int|string) $post_id The post id.
+ * @param   array        $field The field array.
+ * @return  bool.
+ */
+function acf_delete_value( $post_id, $field ) {
+
+	/**
+	 * Fires before a value is deleted.
+	 *
+	 * @date    28/09/13
+	 * @since   5.0.0
+	 *
+	 * @param   string $post_id The post ID for this value.
+	 * @param   mixed $name The meta name.
+	 * @param   array $field The field array.
+	 */
+	do_action( 'acf/delete_value', $post_id, $field['name'], $field );
+
+	// Delete meta.
+	$return = acf_delete_metadata( $post_id, $field['name'] );
+
+	// Delete reference.
+	acf_delete_metadata( $post_id, $field['name'], true );
+
+	// Delete stored data.
+	acf_flush_value_cache( $post_id, $field['name'] );
+
+	// Return delete status.
+	return $return;
+}
+
+// Register variation.
+acf_add_filter_variations( 'acf/delete_value', array( 'type', 'name', 'key' ), 2 );
+
+/**
+ * acf_preview_value
+ *
+ * Return a human friendly 'preview' for a given field value.
+ *
+ * @date    28/09/13
+ * @since   5.0.0
+ *
+ * @param   mixed        $value The new value.
+ * @param   (int|string) $post_id The post id.
+ * @param   array        $field The field array.
+ * @return  bool.
+ */
+function acf_preview_value( $value, $post_id, $field ) {
+
+	/**
+	 * Filters the $value before used in HTML.
+	 *
+	 * @date    24/10/16
+	 * @since   5.5.0
+	 *
+	 * @param   mixed $value The value to preview.
+	 * @param   string $post_id The post ID for this value.
+	 * @param   array $field The field array.
+	 */
+	return apply_filters( 'acf/preview_value', $value, $post_id, $field );
+}
+
+// Register variation.
+acf_add_filter_variations( 'acf/preview_value', array( 'type', 'name', 'key' ), 2 );