Inventory_Presser_REST

Inventory_Presser_REST

Description Description

Adds routes to the REST API at /wp-json/invp/


Top ↑

Source Source

File: includes/class-rest.php

class Inventory_Presser_REST {
	/**
	 * add_hooks
	 *
	 * @return void
	 */
	public function add_hooks() {
		/*
			Adds
				/invp/v1/settings
				/invp/v1/feed-complete routes.
		*/
		add_action( 'rest_api_init', array( $this, 'add_routes' ) );
		// Adds the inventory_type_slugs field to the response of the /wp-json/wp/v2/inventory_vehicle route.
		add_action( 'rest_api_init', array( $this, 'add_inventory_type_slugs_to_posts' ) );

		// Allow attachments to be ordered by the inventory_presser_photo_number meta value.
		add_filter( 'rest_attachment_collection_params', array( $this, 'allow_orderby_photo_number' ) );
		add_filter( 'rest_attachment_query', array( $this, 'orderby_photo_number' ), 10, 2 );

		if ( defined( 'INVP::POST_TYPE' ) ) {
			// Allow vehicles to be returned in a random order.
			add_filter( 'rest_' . INVP::POST_TYPE . '_collection_params', array( $this, 'allow_orderby_rand' ) );

			// Strip deleted vehicles from the query before WP core tries to read their properties.
			add_filter( 'rest_' . INVP::POST_TYPE . '_query', array( $this, 'exclude_deleted_posts' ), 10, 2 );
		}
	}

	/**
	 * Adds an attribute `inventory_type_slugs` to the response of the
	 * /wp-json/wp/v2/inventory route.
	 *
	 * @return void
	 */
	public function add_inventory_type_slugs_to_posts() {
		register_rest_field(
			INVP::POST_TYPE,
			'inventory_type_slugs',
			array(
				'get_callback' => array( $this, 'get_the_type_slugs' ),
				'schema'       => array(
					'description' => __( 'The type taxonomy term slugs.', 'inventory-presser' ),
					'type'        => 'string',
				),
			)
		);
	}

	/**
	 * Adds the photo_number meta field to the allowed orderby values.
	 *
	 * @param  array $params
	 * @return array
	 */
	public function allow_orderby_photo_number( $params ) {
		$params['orderby']['enum'][] = apply_filters( 'invp_prefix_meta_key', 'photo_number' );
		return $params;
	}

	/**
	 * Allow vehicles to be returned in a random order.
	 *
	 * @param  array        $query_params
	 * @param  WP_Post_Type $post_type
	 * @return array
	 */
	public function allow_orderby_rand( $query_params ) {
		$query_params['orderby']['enum'][] = 'rand';
		return $query_params;
	}

	/**
	 * Given a post object, returns the term slugs of the type taxonomy.
	 *
	 * @param  array $post_object An array representing a post object.
	 * @return array Term slugs of the type taxonomy.
	 */
	public function get_the_type_slugs( $post_object ) {
		$terms = get_the_terms( $post_object['id'], 'type' );
		if ( is_array( $terms ) ) {
			return wp_list_pluck( $terms, 'slug' );
		}
		return array();
	}

	/**
	 * Strips post IDs that no longer exist from a REST API collection query so
	 * that WordPress core never attempts to prepare a response for a deleted
	 * vehicle. The previous approach of using rest_prepare_{post_type} was too
	 * late — WP core had already read properties off the null post object and
	 * generated PHP warnings before the filter ran.
	 *
	 * @param  array           $args    WP_Query args built by the REST controller.
	 * @param  WP_REST_Request $request The REST API request.
	 * @return array
	 */
	public function exclude_deleted_posts( $args, $request ) {
		if ( empty( $args['post__in'] ) ) {
			return $args;
		}

		$existing = get_posts(
			array(
				'post__in'       => $args['post__in'],
				'post_type'      => INVP::POST_TYPE,
				'post_status'    => 'publish',
				'posts_per_page' => -1,
				'fields'         => 'ids',
			)
		);

		// When every requested ID has been deleted, pass 0 so WP doesn't fall
		// back to returning all posts.
		$args['post__in'] = ! empty( $existing ) ? $existing : array( 0 );

		return $args;
	}

	/**
	 * Changes the query args for requests to order attachments by the
	 * photo_number meta key.
	 *
	 * @param  array           $args Array of arguments for WP_Query.
	 * @param  WP_REST_Request $request The REST API request.
	 * @return array
	 */
	public function orderby_photo_number( $args, $request ) {
		$order_by = $request->get_param( 'orderby' );
		if ( isset( $order_by ) && apply_filters( 'invp_prefix_meta_key', 'photo_number' ) === $order_by ) {
			$args['meta_key'] = $order_by;
			$args['orderby']  = 'meta_value_num'; // user 'meta_value_num' for numerical fields.
		}
		return $args;
	}

	/**
	 * Adds /invp/v1/settings & /invp/v1/feed-complete routes.
	 *
	 * @return void
	 */
	public function add_routes() {
		register_rest_route(
			'invp/v1',
			'/settings/',
			array(
				'methods'             => 'GET',
				'callback'            => array( $this, 'response_settings' ),
				'permission_callback' => '__return_true',
			)
		);
		register_rest_route(
			'invp/v1',
			'/feed-complete/',
			array(
				'methods'             => 'PUT',
				'callback'            => array( $this, 'response_feed_complete' ),
				'permission_callback' => function () {
					return current_user_can( 'edit_posts' );
				},
			)
		);
	}

	/**
	 * Creates the response data for the /feed-complete/ route.
	 *
	 * @return array
	 */
	public function response_feed_complete() {
		/**
		 * A successful PUT request to /wp-json/invp/v1/feed-complete has
		 * occurred. Assume a client has just updated the entire list of
		 * inventory posts and attachments.
		 */
		do_action( 'invp_feed_complete' );

		// Tell the user what just happened.
		return array(
			'action'        => 'invp_feed_complete',
			'documentation' => 'https://inventorypresser.com/docs/reference/hooks/invp_feed_complete/',
		);
	}

	/**
	 * Creates the response data for the /settings/ route.
	 *
	 * @return array
	 */
	public function response_settings() {
		if ( ! class_exists( 'INVP' ) ) {
			return array();
		}

		$public_keys = array(
			'use_carfax',
		);

		return array_filter(
			INVP::settings(),
			function ( $k ) use ( $public_keys ) {
				return in_array( $k, $public_keys, true );
			},
			ARRAY_FILTER_USE_KEY
		);
	}
}

Top ↑

Methods Methods

  • add_hooks — add_hooks
  • add_inventory_type_slugs_to_posts — Adds an attribute `inventory_type_slugs` to the response of the /wp-json/wp/v2/inventory route.
  • add_routes — Adds /invp/v1/settings & /invp/v1/feed-complete routes.
  • allow_orderby_photo_number — Adds the photo_number meta field to the allowed orderby values.
  • allow_orderby_rand — Allow vehicles to be returned in a random order.
  • exclude_deleted_posts — Strips post IDs that no longer exist from a REST API collection query so that WordPress core never attempts to prepare a response for a deleted vehicle. The previous approach of using rest_prepare_{post_type} was too late — WP core had already read properties off the null post object and generated PHP warnings before the filter ran.
  • get_the_type_slugs — Given a post object, returns the term slugs of the type taxonomy.
  • orderby_photo_number — Changes the query args for requests to order attachments by the photo_number meta key.
  • response_feed_complete — Creates the response data for the /feed-complete/ route.
  • response_settings — Creates the response data for the /settings/ route.