ACF_Rest_Embed_Links{} │ ACF 1.0

Class ACF_Rest_Embed_Links

Manage the addition of embed links on supported REST endpoints.

Хуков нет.

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

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

Методы

1. private hook_link_handlers()
2. public initialize()
3. public load_item_links( $response, $item, $request )
4. public prepare_links( $post_id, array $field )

Код ACF_Rest_Embed_Links{} ACF Rest Embed Links{} ^{ACF 6.0.4}

class ACF_Rest_Embed_Links {

	/** @var array Links to add to the response. These can be flagged as embeddable and expanded when _embed is passed with the request. */
	private $links = array();

	public function initialize() {
		$this->hook_link_handlers();
	}

	/**
	 * Hook into all REST-enabled post type, taxonomy, and the user controllers in order to prepare links.
	 */
	private function hook_link_handlers() {
		foreach ( get_post_types( array( 'show_in_rest' => true ) ) as $post_type ) {
			add_filter( "rest_prepare_{$post_type}", array( $this, 'load_item_links' ), 10, 3 );
		}

		foreach ( get_taxonomies( array( 'show_in_rest' => true ) ) as $taxonomy ) {
			add_filter( "rest_prepare_{$taxonomy}", array( $this, 'load_item_links' ), 10, 3 );
		}

		add_filter( 'rest_prepare_user', array( $this, 'load_item_links' ), 10, 3 );
	}

	/**
	 * Add links to internal property for subsequent use in \ACF_Rest_Embed_Links::load_item_links().
	 *
	 * @param       $post_id
	 * @param array   $field
	 */
	public function prepare_links( $post_id, array $field ) {
		$links = acf_get_field_rest_links( $post_id, $field );
		if ( ! $links ) {
			return;
		}

		foreach ( $links as $link ) {
			// If required array keys are not provided, skip.
			if ( empty( $link['rel'] ) or empty( $link['href'] ) ) {
				continue;
			}

			// Use the 'rel' and 'href' to for a key. The key only prevents against the same object
			// appearing more than once within the same 'rel' property.
			$this->links[ $link['rel'] . ':' . $link['href'] ] = $link;
		}
	}

	/**
	 * Hook into the rest_prepare_{$type} filters and add links for the object being prepared.
	 *
	 * @param WP_REST_Response        $response
	 * @param WP_Post|WP_User|WP_Term $item
	 * @param WP_REST_Request         $request
	 * @return WP_REST_Response
	 */
	public function load_item_links( $response, $item, $request ) {
		if ( empty( $this->links ) ) {
			return $response;
		}

		while ( $attributes = array_pop( $this->links ) ) {
			$response->add_link(
				acf_extract_var( $attributes, 'rel' ),
				acf_extract_var( $attributes, 'href' ),
				$attributes
			);
		}

		// Reset the links prop.
		$this->links = array();

		return $response;
	}

}