mirror of
https://github.com/WordPress/WordPress.git
synced 2024-09-10 14:48:07 +02:00
In each child and grandchild class, renames the first parameter to match the parent's method signature. Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match. Changes for readability: - `@since` clearly specifies the original parameter name and its new name as well as why the change happened. - In methods longer than a single line, the generic parameter is reassigned to the original parameter restoring it for context for use within the method. An inline comment is added to explain why this reassignment is made. Follow-up to [38832], [39011], [39015], [39021], [39024], [39025], [39031], [39036], [43519], [43735], [43739], [43768], [46821], [48173], [48242], [49088], [50995], [51003], [51021]. Props jrf, hellofromTonya, sergeybiryukov, azaozz, desrosj, johnbillion. See #51553. Built from https://develop.svn.wordpress.org/trunk@51786 git-svn-id: http://core.svn.wordpress.org/trunk@51393 1a063a9b-81f0-0310-95a4-ce76da25c4cd
324 lines
9.6 KiB
PHP
324 lines
9.6 KiB
PHP
<?php
|
|
/**
|
|
* REST API: WP_REST_Block_Directory_Controller class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage REST_API
|
|
* @since 5.5.0
|
|
*/
|
|
|
|
/**
|
|
* Controller which provides REST endpoint for the blocks.
|
|
*
|
|
* @since 5.5.0
|
|
*
|
|
* @see WP_REST_Controller
|
|
*/
|
|
class WP_REST_Block_Directory_Controller extends WP_REST_Controller {
|
|
|
|
/**
|
|
* Constructs the controller.
|
|
*/
|
|
public function __construct() {
|
|
$this->namespace = 'wp/v2';
|
|
$this->rest_base = 'block-directory';
|
|
}
|
|
|
|
/**
|
|
* Registers the necessary REST API routes.
|
|
*/
|
|
public function register_routes() {
|
|
register_rest_route(
|
|
$this->namespace,
|
|
'/' . $this->rest_base . '/search',
|
|
array(
|
|
array(
|
|
'methods' => WP_REST_Server::READABLE,
|
|
'callback' => array( $this, 'get_items' ),
|
|
'permission_callback' => array( $this, 'get_items_permissions_check' ),
|
|
'args' => $this->get_collection_params(),
|
|
),
|
|
'schema' => array( $this, 'get_public_item_schema' ),
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Checks whether a given request has permission to install and activate plugins.
|
|
*
|
|
* @since 5.5.0
|
|
*
|
|
* @param WP_REST_Request $request Full details about the request.
|
|
* @return true|WP_Error True if the request has permission, WP_Error object otherwise.
|
|
*/
|
|
public function get_items_permissions_check( $request ) {
|
|
if ( ! current_user_can( 'install_plugins' ) || ! current_user_can( 'activate_plugins' ) ) {
|
|
return new WP_Error(
|
|
'rest_block_directory_cannot_view',
|
|
__( 'Sorry, you are not allowed to browse the block directory.' ),
|
|
array( 'status' => rest_authorization_required_code() )
|
|
);
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Search and retrieve blocks metadata
|
|
*
|
|
* @since 5.5.0
|
|
*
|
|
* @param WP_REST_Request $request Full details about the request.
|
|
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
|
|
*/
|
|
public function get_items( $request ) {
|
|
require_once ABSPATH . 'wp-admin/includes/plugin-install.php';
|
|
require_once ABSPATH . 'wp-admin/includes/plugin.php';
|
|
|
|
$response = plugins_api(
|
|
'query_plugins',
|
|
array(
|
|
'block' => $request['term'],
|
|
'per_page' => $request['per_page'],
|
|
'page' => $request['page'],
|
|
)
|
|
);
|
|
|
|
if ( is_wp_error( $response ) ) {
|
|
$response->add_data( array( 'status' => 500 ) );
|
|
|
|
return $response;
|
|
}
|
|
|
|
$result = array();
|
|
|
|
foreach ( $response->plugins as $plugin ) {
|
|
// If the API returned a plugin with empty data for 'blocks', skip it.
|
|
if ( empty( $plugin['blocks'] ) ) {
|
|
continue;
|
|
}
|
|
|
|
$data = $this->prepare_item_for_response( $plugin, $request );
|
|
$result[] = $this->prepare_response_for_collection( $data );
|
|
}
|
|
|
|
return rest_ensure_response( $result );
|
|
}
|
|
|
|
/**
|
|
* Parse block metadata for a block, and prepare it for an API repsonse.
|
|
*
|
|
* @since 5.5.0
|
|
* @since 5.9.0 Renamed `$plugin` to `$item` to match parent class for PHP 8 named parameter support.
|
|
*
|
|
* @param array $item The plugin metadata.
|
|
* @param WP_REST_Request $request Request object.
|
|
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
|
|
*/
|
|
public function prepare_item_for_response( $item, $request ) {
|
|
// Restores the more descriptive, specific name for use within this method.
|
|
$plugin = $item;
|
|
|
|
// There might be multiple blocks in a plugin. Only the first block is mapped.
|
|
$block_data = reset( $plugin['blocks'] );
|
|
|
|
// A data array containing the properties we'll return.
|
|
$block = array(
|
|
'name' => $block_data['name'],
|
|
'title' => ( $block_data['title'] ? $block_data['title'] : $plugin['name'] ),
|
|
'description' => wp_trim_words( $plugin['short_description'], 30, '...' ),
|
|
'id' => $plugin['slug'],
|
|
'rating' => $plugin['rating'] / 20,
|
|
'rating_count' => (int) $plugin['num_ratings'],
|
|
'active_installs' => (int) $plugin['active_installs'],
|
|
'author_block_rating' => $plugin['author_block_rating'] / 20,
|
|
'author_block_count' => (int) $plugin['author_block_count'],
|
|
'author' => wp_strip_all_tags( $plugin['author'] ),
|
|
'icon' => ( isset( $plugin['icons']['1x'] ) ? $plugin['icons']['1x'] : 'block-default' ),
|
|
'last_updated' => gmdate( 'Y-m-d\TH:i:s', strtotime( $plugin['last_updated'] ) ),
|
|
'humanized_updated' => sprintf(
|
|
/* translators: %s: Human-readable time difference. */
|
|
__( '%s ago' ),
|
|
human_time_diff( strtotime( $plugin['last_updated'] ) )
|
|
),
|
|
);
|
|
|
|
$this->add_additional_fields_to_object( $block, $request );
|
|
|
|
$response = new WP_REST_Response( $block );
|
|
$response->add_links( $this->prepare_links( $plugin ) );
|
|
|
|
return $response;
|
|
}
|
|
|
|
/**
|
|
* Generates a list of links to include in the response for the plugin.
|
|
*
|
|
* @since 5.5.0
|
|
*
|
|
* @param array $plugin The plugin data from WordPress.org.
|
|
* @return array
|
|
*/
|
|
protected function prepare_links( $plugin ) {
|
|
$links = array(
|
|
'https://api.w.org/install-plugin' => array(
|
|
'href' => add_query_arg( 'slug', urlencode( $plugin['slug'] ), rest_url( 'wp/v2/plugins' ) ),
|
|
),
|
|
);
|
|
|
|
$plugin_file = $this->find_plugin_for_slug( $plugin['slug'] );
|
|
|
|
if ( $plugin_file ) {
|
|
$links['https://api.w.org/plugin'] = array(
|
|
'href' => rest_url( 'wp/v2/plugins/' . substr( $plugin_file, 0, - 4 ) ),
|
|
'embeddable' => true,
|
|
);
|
|
}
|
|
|
|
return $links;
|
|
}
|
|
|
|
/**
|
|
* Finds an installed plugin for the given slug.
|
|
*
|
|
* @since 5.5.0
|
|
*
|
|
* @param string $slug The WordPress.org directory slug for a plugin.
|
|
* @return string The plugin file found matching it.
|
|
*/
|
|
protected function find_plugin_for_slug( $slug ) {
|
|
require_once ABSPATH . 'wp-admin/includes/plugin.php';
|
|
|
|
$plugin_files = get_plugins( '/' . $slug );
|
|
|
|
if ( ! $plugin_files ) {
|
|
return '';
|
|
}
|
|
|
|
$plugin_files = array_keys( $plugin_files );
|
|
|
|
return $slug . '/' . reset( $plugin_files );
|
|
}
|
|
|
|
/**
|
|
* Retrieves the theme's schema, conforming to JSON Schema.
|
|
*
|
|
* @since 5.5.0
|
|
*
|
|
* @return array Item schema data.
|
|
*/
|
|
public function get_item_schema() {
|
|
if ( $this->schema ) {
|
|
return $this->add_additional_fields_schema( $this->schema );
|
|
}
|
|
|
|
$this->schema = array(
|
|
'$schema' => 'http://json-schema.org/draft-04/schema#',
|
|
'title' => 'block-directory-item',
|
|
'type' => 'object',
|
|
'properties' => array(
|
|
'name' => array(
|
|
'description' => __( 'The block name, in namespace/block-name format.' ),
|
|
'type' => 'string',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'title' => array(
|
|
'description' => __( 'The block title, in human readable format.' ),
|
|
'type' => 'string',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'description' => array(
|
|
'description' => __( 'A short description of the block, in human readable format.' ),
|
|
'type' => 'string',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'id' => array(
|
|
'description' => __( 'The block slug.' ),
|
|
'type' => 'string',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'rating' => array(
|
|
'description' => __( 'The star rating of the block.' ),
|
|
'type' => 'integer',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'rating_count' => array(
|
|
'description' => __( 'The number of ratings.' ),
|
|
'type' => 'integer',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'active_installs' => array(
|
|
'description' => __( 'The number sites that have activated this block.' ),
|
|
'type' => 'string',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'author_block_rating' => array(
|
|
'description' => __( 'The average rating of blocks published by the same author.' ),
|
|
'type' => 'integer',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'author_block_count' => array(
|
|
'description' => __( 'The number of blocks published by the same author.' ),
|
|
'type' => 'integer',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'author' => array(
|
|
'description' => __( 'The WordPress.org username of the block author.' ),
|
|
'type' => 'string',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'icon' => array(
|
|
'description' => __( 'The block icon.' ),
|
|
'type' => 'string',
|
|
'format' => 'uri',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'last_updated' => array(
|
|
'description' => __( 'The date when the block was last updated.' ),
|
|
'type' => 'string',
|
|
'format' => 'date-time',
|
|
'context' => array( 'view' ),
|
|
),
|
|
'humanized_updated' => array(
|
|
'description' => __( 'The date when the block was last updated, in fuzzy human readable format.' ),
|
|
'type' => 'string',
|
|
'context' => array( 'view' ),
|
|
),
|
|
),
|
|
);
|
|
|
|
return $this->add_additional_fields_schema( $this->schema );
|
|
}
|
|
|
|
/**
|
|
* Retrieves the search params for the blocks collection.
|
|
*
|
|
* @since 5.5.0
|
|
*
|
|
* @return array Collection parameters.
|
|
*/
|
|
public function get_collection_params() {
|
|
$query_params = parent::get_collection_params();
|
|
|
|
$query_params['context']['default'] = 'view';
|
|
|
|
$query_params['term'] = array(
|
|
'description' => __( 'Limit result set to blocks matching the search term.' ),
|
|
'type' => 'string',
|
|
'required' => true,
|
|
'minLength' => 1,
|
|
);
|
|
|
|
unset( $query_params['search'] );
|
|
|
|
/**
|
|
* Filters REST API collection parameters for the block directory controller.
|
|
*
|
|
* @since 5.5.0
|
|
*
|
|
* @param array $query_params JSON Schema-formatted collection parameters.
|
|
*/
|
|
return apply_filters( 'rest_block_directory_collection_params', $query_params );
|
|
}
|
|
}
|