ACF_Local_Meta{} │ ACF 1.0

Хуков нет.

Использование

$ACF_Local_Meta = new ACF_Local_Meta();
// use class methods

Методы

1. public __construct()
2. public add( $meta = array(), $post_id = 0, $is_main = false )
3. public capture( $values = array(), $post_id = 0 )
4. public capture_update_metadata( $null, $post_id, $name, $value, $hidden )
5. public is_request( $meta = array() )
6. public pre_load_meta( $null, $post_id )
7. public pre_load_metadata( $null, $post_id, $name, $hidden )
8. public pre_load_post_id( $null, $post_id )
9. public remove( $post_id = 0 )

Код ACF_Local_Meta{} ACF Local Meta{} ^{ACF 6.0.4}

class ACF_Local_Meta {

	/** @var array Storage for meta data. */
	var $meta = array();

	/** @var mixed Storage for the current post_id. */
	var $post_id = 0;

	/**
	 * __construct
	 *
	 * Sets up the class functionality.
	 *
	 * @date    8/10/18
	 * @since   5.8.0
	 *
	 * @param   void
	 * @return  void
	 */
	function __construct() {

		// add filters
		add_filter( 'acf/pre_load_post_id', array( $this, 'pre_load_post_id' ), 1, 2 );
		add_filter( 'acf/pre_load_meta', array( $this, 'pre_load_meta' ), 1, 2 );
		add_filter( 'acf/pre_load_metadata', array( $this, 'pre_load_metadata' ), 1, 4 );
	}

	/**
	 * add
	 *
	 * Adds postmeta to storage.
	 * Accepts data in either raw or request format.
	 *
	 * @date    8/10/18
	 * @since   5.8.0
	 *
	 * @param   array $meta An array of metdata to store.
	 * @param   mixed $post_id The post_id for this data.
	 * @param   bool  $is_main Makes this postmeta visible to get_field() without a $post_id value.
	 * @return  array
	 */
	function add( $meta = array(), $post_id = 0, $is_main = false ) {

		// Capture meta if supplied meta is from a REQUEST.
		if ( $this->is_request( $meta ) ) {
			$meta = $this->capture( $meta, $post_id );
		}

		// Add to storage.
		$this->meta[ $post_id ] = $meta;

		// Set $post_id reference when is the "main" postmeta.
		if ( $is_main ) {
			$this->post_id = $post_id;
		}

		// Return meta.
		return $meta;
	}

	/**
	 * is_request
	 *
	 * Returns true if the supplied $meta is from a REQUEST (serialized <form> data).
	 *
	 * @date    11/3/19
	 * @since   5.7.14
	 *
	 * @param   array $meta An array of metdata to check.
	 * @return  bool
	 */
	function is_request( $meta = array() ) {
		return acf_is_field_key( key( $meta ) );
	}

	/**
	 * capture
	 *
	 * Returns a flattened array of meta for the given postdata.
	 * This is achieved by simulating a save whilst capturing all meta changes.
	 *
	 * @date    26/2/19
	 * @since   5.7.13
	 *
	 * @param   array $values An array of raw values.
	 * @param   mixed $post_id The post_id for this data.
	 * @return  array
	 */
	function capture( $values = array(), $post_id = 0 ) {

		// Reset meta.
		$this->meta[ $post_id ] = array();

		// Listen for any added meta.
		add_filter( 'acf/pre_update_metadata', array( $this, 'capture_update_metadata' ), 1, 5 );

		// Simulate update.
		if ( $values ) {
			acf_update_values( $values, $post_id );
		}

		// Remove listener filter.
		remove_filter( 'acf/pre_update_metadata', array( $this, 'capture_update_metadata' ), 1, 5 );

		// Return meta.
		return $this->meta[ $post_id ];
	}

	/**
	 * capture_update_metadata
	 *
	 * Records all meta activity and returns a non null value to bypass DB updates.
	 *
	 * @date    26/2/19
	 * @since   5.7.13
	 *
	 * @param   null         $null .
	 * @param   (int|string) $post_id The post id.
	 * @param   string       $name The meta name.
	 * @param   mixed        $value The meta value.
	 * @param   bool         $hidden If the meta is hidden (starts with an underscore).
	 * @return  false.
	 */
	function capture_update_metadata( $null, $post_id, $name, $value, $hidden ) {
		$name                            = ( $hidden ? '_' : '' ) . $name;
		$this->meta[ $post_id ][ $name ] = $value;

		// Return non null value to escape update process.
		return true;
	}

	/**
	 * remove
	 *
	 * Removes postmeta from storage.
	 *
	 * @date    8/10/18
	 * @since   5.8.0
	 *
	 * @param   mixed $post_id The post_id for this data.
	 * @return  void
	 */
	function remove( $post_id = 0 ) {

		// unset meta
		unset( $this->meta[ $post_id ] );

		// reset post_id
		if ( $post_id === $this->post_id ) {
			$this->post_id = 0;
		}
	}

	/**
	 * pre_load_meta
	 *
	 * Injects the local meta.
	 *
	 * @date    8/10/18
	 * @since   5.8.0
	 *
	 * @param   null  $null An empty parameter. Return a non null value to short-circuit the function.
	 * @param   mixed $post_id The post_id for this data.
	 * @return  mixed
	 */
	function pre_load_meta( $null, $post_id ) {
		if ( isset( $this->meta[ $post_id ] ) ) {
			return $this->meta[ $post_id ];
		}
		return $null;
	}

	/**
	 * pre_load_metadata
	 *
	 * Injects the local meta.
	 *
	 * @date    8/10/18
	 * @since   5.8.0
	 *
	 * @param   null         $null An empty parameter. Return a non null value to short-circuit the function.
	 * @param   (int|string) $post_id The post id.
	 * @param   string       $name The meta name.
	 * @param   bool         $hidden If the meta is hidden (starts with an underscore).
	 * @return  mixed
	 */
	function pre_load_metadata( $null, $post_id, $name, $hidden ) {
		$name = ( $hidden ? '_' : '' ) . $name;
		if ( isset( $this->meta[ $post_id ] ) ) {
			if ( isset( $this->meta[ $post_id ][ $name ] ) ) {
				return $this->meta[ $post_id ][ $name ];
			}
			return '__return_null';
		}
		return $null;
	}

	/**
	 * pre_load_post_id
	 *
	 * Injects the local post_id.
	 *
	 * @date    8/10/18
	 * @since   5.8.0
	 *
	 * @param   null  $null An empty parameter. Return a non null value to short-circuit the function.
	 * @param   mixed $post_id The post_id for this data.
	 * @return  mixed
	 */
	function pre_load_post_id( $null, $post_id ) {
		if ( ! $post_id && $this->post_id ) {
			return $this->post_id;
		}
		return $null;
	}
}