class-wpcom-rest-api-v2-endpoint-podcast-player.php — Jetpack – WP Security, Backup, Speed, & Growth 13.0.2

jetpack / _inc / lib / core-api / wpcom-endpoints / class-wpcom-rest-api-v2-endpoint-podcast-player.php

jetpack / _inc / lib / core-api / wpcom-endpoints Last commit date

class-wpcom-rest-api-v2-endpoint-podcast-player.php

163 lines

1	<?php
2	/**
3	* Podcast Player API
4	*
5	* @package automattic/jetpack
6	* @since 8.4.0
7	*/
8
9	/**
10	* Fetch podcast feeds and parse data for the Podcast Player block.
11	*
12	* @since 8.4.0
13	*/
14	class WPCOM_REST_API_V2_Endpoint_Podcast_Player extends WP_REST_Controller {
15	/**
16	* Constructor.
17	*/
18	public function __construct() {
19	if ( ! class_exists( 'Jetpack_Podcast_Helper' ) ) {
20	require_once JETPACK__PLUGIN_DIR . '/_inc/lib/class-jetpack-podcast-helper.php';
21	}
22
23	$this->namespace = 'wpcom/v2';
24	$this->rest_base = 'podcast-player';
25	// This endpoint does not need to connect directly to Jetpack sites.
26	add_action( 'rest_api_init', array( $this, 'register_routes' ) );
27	}
28
29	/**
30	* Register the route.
31	*/
32	public function register_routes() {
33	// GET /sites/<blog_id>/podcast-player - Returns feed data.
34	register_rest_route(
35	$this->namespace,
36	'/' . $this->rest_base,
37	array(
38	array(
39	'methods' => WP_REST_Server::READABLE,
40	'callback' => array( $this, 'get_player_data' ),
41	'permission_callback' => function () {
42	return current_user_can( 'edit_posts' );
43	},
44	'args' => array(
45	'url' => array(
46	'description' => __( 'The Podcast RSS feed URL.', 'jetpack' ),
47	'type' => 'string',
48	'required' => 'true',
49	'validate_callback' => function ( $param ) {
50	return wp_http_validate_url( $param );
51	},
52	),
53	'guids' => array(
54	'description' => __( 'A list of unique identifiers for fetching specific podcast episodes.', 'jetpack' ),
55	'type' => 'array',
56	'required' => 'false',
57	'validate_callback' => function ( $guids ) {
58	return is_array( $guids );
59	},
60	'sanitize_callback' => function ( $guids ) {
61	return array_map( 'sanitize_text_field', $guids );
62	},
63	),
64	'episode-options' => array(
65	'description' => __( 'Whether we should return the episodes list for use in the selection UI', 'jetpack' ),
66	'type' => 'boolean',
67	'required' => 'false',
68	),
69	),
70	'schema' => array( $this, 'get_public_item_schema' ),
71	),
72	)
73	);
74
75	// GET /sites/<blog_id>/podcast-player/track-quantity - Returns number of tracks.
76	register_rest_route(
77	$this->namespace,
78	'/' . $this->rest_base . '/track-quantity',
79	array(
80	array(
81	'methods' => WP_REST_Server::READABLE,
82	'callback' => array( $this, 'get_tracks_quantity' ),
83	'permission_callback' => function () {
84	return current_user_can( 'edit_posts' );
85	},
86	),
87	)
88	);
89	}
90
91	/**
92	* Retrieves tracks quantity
93	*
94	* @return Integer number of tracks.
95	* */
96	public function get_tracks_quantity() {
97	return rest_ensure_response( Jetpack_Podcast_Helper::get_tracks_quantity() );
98	}
99
100	/**
101	* Retrieves data needed to display a podcast player from RSS feed.
102	*
103	* @param WP_REST_Request $request The REST API request data.
104	* @return WP_REST_Response The REST API response.
105	*/
106	public function get_player_data( $request ) {
107	$helper = new Jetpack_Podcast_Helper( $request['url'] );
108
109	$args = array();
110
111	if ( isset( $request['guids'] ) ) {
112	$args['guids'] = $request['guids'];
113	}
114
115	if ( isset( $request['episode-options'] ) && $request['episode-options'] ) {
116	$args['episode-options'] = true;
117	}
118
119	$player_data = $helper->get_player_data( $args );
120
121	if ( is_wp_error( $player_data ) ) {
122	return rest_ensure_response( $player_data );
123	}
124
125	$player_data = $this->prepare_for_response( $player_data, $request );
126	return rest_ensure_response( $player_data );
127	}
128
129	/**
130	* Filters out data based on ?_fields= request parameter
131	*
132	* @param array $player_data Data for the player.
133	* @param WP_REST_Request $request The request.
134	* @return array filtered $player_data
135	*/
136	public function prepare_for_response( $player_data, $request ) {
137	if ( ! is_callable( array( $this, 'get_fields_for_response' ) ) ) {
138	return $player_data;
139	}
140
141	$fields = $this->get_fields_for_response( $request );
142
143	$response_data = array();
144	foreach ( $player_data as $field => $value ) {
145	if ( in_array( $field, $fields, true ) ) {
146	$response_data[ $field ] = $value;
147	}
148	}
149
150	return $response_data;
151	}
152
153	/**
154	* Retrieves the response schema, conforming to JSON Schema.
155	*
156	* @return array
157	*/
158	public function get_item_schema() {
159	return Jetpack_Podcast_Helper::get_player_data_schema();
160	}
161	}
162	wpcom_rest_api_v2_load_plugin( 'WPCOM_REST_API_V2_Endpoint_Podcast_Player' );
163