1 files changed, 46 insertions, 29 deletions

diff --git a/plugins/jetpack/json-endpoints/class.wpcom-json-api-list-embeds-endpoint.php b/plugins/jetpack/json-endpoints/class.wpcom-json-api-list-embeds-endpoint.php
index 6f2ce126..a3997e70 100644
--- a/plugins/jetpack/json-endpoints/class.wpcom-json-api-list-embeds-endpoint.php
+++ b/plugins/jetpack/json-endpoints/class.wpcom-json-api-list-embeds-endpoint.php
@@ -1,60 +1,77 @@
-<?php
-
-new WPCOM_JSON_API_List_Embeds_Endpoint( array(
-	'description' => "Get a list of embeds available on a site. Note: The current user must have publishing access.",
-	'group'       => 'sites',
-	'stat'        => 'embeds',
-	'method'      => 'GET',
-	'path'        => '/sites/%s/embeds',
-	'path_labels' => array(
-		'$site'    => '(int|string) Site ID or domain',
-	),
-	'response_format' => array(
-		'embeds' => '(array) A list of supported embeds by their regex pattern.',
-	),
-	'example_request' => 'https://public-api.wordpress.com/rest/v1/sites/82974409/embeds',
-	'example_request_data' => array(
-		'headers' => array(
-			'authorization' => 'Bearer YOUR_API_TOKEN'
+<?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
+
+/**
+ * List Embeds endpoint.
+ */
+new WPCOM_JSON_API_List_Embeds_Endpoint(
+	array(
+		'description'          => 'Get a list of embeds available on a site. Note: The current user must have publishing access.',
+		'group'                => 'sites',
+		'stat'                 => 'embeds',
+		'method'               => 'GET',
+		'path'                 => '/sites/%s/embeds',
+		'path_labels'          => array(
+			'$site' => '(int|string) Site ID or domain',
+		),
+		'response_format'      => array(
+			'embeds' => '(array) A list of supported embeds by their regex pattern.',
+		),
+		'example_request'      => 'https://public-api.wordpress.com/rest/v1/sites/82974409/embeds',
+		'example_request_data' => array(
+			'headers' => array(
+				'authorization' => 'Bearer YOUR_API_TOKEN',
+			),
 		),
 	)
-) );
+);
 
+/**
+ * List Embeds Endpoint class.
+ *
+ * /sites/%s/embeds -> $blog_id
+ */
 class WPCOM_JSON_API_List_Embeds_Endpoint extends WPCOM_JSON_API_Endpoint {
-	// /sites/%s/embeds -> $blog_id
-	function callback( $path = '', $blog_id = 0 ) {
+	/**
+	 * API Callback.
+	 *
+	 * @param string $path - the path.
+	 * @param int    $blog_id - the blog ID.
+	 */
+	public function callback( $path = '', $blog_id = 0 ) {
 		$blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) );
 		if ( is_wp_error( $blog_id ) ) {
 			return $blog_id;
 		}
 
-		// permissions check
+		// permissions check.
 		if ( ! current_user_can( 'edit_posts' ) ) {
 			return new WP_Error( 'unauthorized', 'Your token must have permission to post on this blog.', 403 );
 		}
 
-		// list em
+		// list em.
 		$output = array( 'embeds' => array() );
 
 		if ( ! function_exists( '_wp_oembed_get_object' ) ) {
-			require_once( ABSPATH . WPINC . '/class-oembed.php' );
+			require_once ABSPATH . WPINC . '/class-oembed.php';
 		}
 
 		global $wp_embed;
 		$oembed = _wp_oembed_get_object();
 
-		foreach( $wp_embed->handlers as $priority => $handlers ) {
-			foreach( $handlers as $handler ) {
-				if ( ! empty( $handler['regex'] ) )
+		foreach ( $wp_embed->handlers as $handlers ) {
+			foreach ( $handlers as $handler ) {
+				if ( ! empty( $handler['regex'] ) ) {
 					$output['embeds'][] = $handler['regex'];
+				}
 			}
 		}
 
 		foreach ( $oembed->providers as $regex => $oembed_info ) {
-			if ( ! empty( $regex ) )
+			if ( ! empty( $regex ) ) {
 				$output['embeds'][] = $regex;
+			}
 		}
 
 		return $output;
 	}
-}
\ No newline at end of file
+}