Changeset 48242

Timestamp:

07/01/2020 04:22:25 AM (4 years ago)

Author:

TimothyBlynJacobs

Message:

REST API: Introduce plugin management and block directory endpoints.

These endpoints facilitate the Block Directory Inserter feature in Gutenberg. Users can now install, activate, deactivate, and delete plugins over the REST API. The block directoryendpoint allows searching for available blocks from the WordPress.org block directory.

Props cklee, talldanwp, noisysocks, joen, soean, youknowriad, dufresnesteven, gziolo, dd32, tellyworth, ryelle, spacedmonkey, TimothyBlynJacobs.
Fixes #50321.

Location:

trunk

Files:

• src/wp-admin/edit-form-blocks.php (modified) (2 diffs)
• src/wp-admin/includes/plugin-install.php (modified) (1 diff)
• src/wp-includes/rest-api.php (modified) (1 diff)
• src/wp-includes/rest-api/endpoints/class-wp-rest-block-directory-controller.php (added)
• src/wp-includes/rest-api/endpoints/class-wp-rest-plugins-controller.php (added)
• src/wp-settings.php (modified) (1 diff)
• tests/phpunit/data/plugins/link-manager.zip (added)
• tests/phpunit/tests/rest-api/rest-block-directory-controller.php (added)
• tests/phpunit/tests/rest-api/rest-plugins-controller.php (added)
• tests/phpunit/tests/rest-api/rest-schema-setup.php (modified) (1 diff)
• tests/qunit/fixtures/wp-api-generated.js (modified) (1 diff)

trunk/src/wp-admin/edit-form-blocks.php

@@ -362 +362 @@
 wp_tinymce_inline_scripts();
 wp_enqueue_editor();
+wp_enqueue_script( 'wp-block-directory' );
 
 /**
@@ -368 +369 @@
 wp_enqueue_style( 'wp-edit-post' );
 wp_enqueue_style( 'wp-format-library' );
+wp_enqueue_style( 'wp-block-directory' );
 
 /**

trunk/src/wp-admin/includes/plugin-install.php

@@ -174 +174 @@
 
         if ( $ssl && is_wp_error( $request ) ) {
-            trigger_error(
-                sprintf(
-                    /* translators: %s: Support forums URL. */
-                    __( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),
-                    __( 'https://wordpress.org/support/forums/' )
-                ) . ' ' . __( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ),
-                headers_sent() || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE
-            );
+            if ( ! wp_is_json_request() ) {
+                trigger_error(
+                    sprintf(
+                        /* translators: %s: Support forums URL. */
+                        __( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),
+                        __( 'https://wordpress.org/support/forums/' )
+                    ) . ' ' . __( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ),
+                    headers_sent() || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE
+                );
+            }
+
             $request = wp_remote_get( $http_url, $http_args );
         }

trunk/src/wp-includes/rest-api.php

@@ -284 +284 @@
     // Themes.
     $controller = new WP_REST_Themes_Controller;
+    $controller->register_routes();
+
+    // Plugins.
+    $controller = new WP_REST_Plugins_Controller();
+    $controller->register_routes();
+
+    // Block Directory.
+    $controller = new WP_REST_Block_Directory_Controller();
     $controller->register_routes();
 

trunk/src/wp-settings.php

@@ -258 +258 @@
 require ABSPATH . WPINC . '/rest-api/endpoints/class-wp-rest-settings-controller.php';
 require ABSPATH . WPINC . '/rest-api/endpoints/class-wp-rest-themes-controller.php';
+require ABSPATH . WPINC . '/rest-api/endpoints/class-wp-rest-plugins-controller.php';
+require ABSPATH . WPINC . '/rest-api/endpoints/class-wp-rest-block-directory-controller.php';
 require ABSPATH . WPINC . '/rest-api/fields/class-wp-rest-meta-fields.php';
 require ABSPATH . WPINC . '/rest-api/fields/class-wp-rest-comment-meta-fields.php';

trunk/tests/phpunit/tests/rest-api/rest-schema-setup.php

@@ -127 +127 @@
             '/wp/v2/settings',
             '/wp/v2/themes',
+            '/wp/v2/plugins',
+            '/wp/v2/plugins/(?P<plugin>[^.\/]+(?:\/[^.\/]+)?)',
+            '/wp/v2/block-directory/search',
         );
 

trunk/tests/qunit/fixtures/wp-api-generated.js

@@ -4703 +4703 @@
             "_links": {
                 "self": "http://example.org/index.php?rest_route=/wp/v2/themes"
+            }
+        },
+        "/wp/v2/plugins": {
+            "namespace": "wp/v2",
+            "methods": [
+                "GET",
+                "POST"
+            ],
+            "endpoints": [
+                {
+                    "methods": [
+                        "GET"
+                    ],
+                    "args": {
+                        "context": {
+                            "required": false,
+                            "default": "view",
+                            "enum": [
+                                "view",
+                                "embed",
+                                "edit"
+                            ],
+                            "description": "Scope under which the request is made; determines fields present in response.",
+                            "type": "string"
+                        },
+                        "search": {
+                            "required": false,
+                            "description": "Limit results to those matching a string.",
+                            "type": "string"
+                        },
+                        "status": {
+                            "required": false,
+                            "description": "Limits results to plugins with the given status.",
+                            "type": "array",
+                            "items": {
+                                "type": "string",
+                                "enum": [
+                                    "inactive",
+                                    "active"
+                                ]
+                            }
+                        }
+                    }
+                },
+                {
+                    "methods": [
+                        "POST"
+                    ],
+                    "args": {
+                        "slug": {
+                            "required": true,
+                            "description": "WordPress.org plugin directory slug.",
+                            "type": "string"
+                        },
+                        "status": {
+                            "required": false,
+                            "default": "inactive",
+                            "enum": [
+                                "inactive",
+                                "active"
+                            ],
+                            "description": "The plugin activation status.",
+                            "type": "string"
+                        }
+                    }
+                }
+            ],
+            "_links": {
+                "self": [
+                    {
+                        "href": "http://example.org/index.php?rest_route=/wp/v2/plugins"
+                    }
+                ]
+            }
+        },
+        "/wp/v2/plugins/(?P<plugin>[^.\\/]+(?:\\/[^.\\/]+)?)": {
+            "namespace": "wp/v2",
+            "methods": [
+                "GET",
+                "POST",
+                "PUT",
+                "PATCH",
+                "DELETE"
+            ],
+            "endpoints": [
+                {
+                    "methods": [
+                        "GET"
+                    ],
+                    "args": {
+                        "context": {
+                            "required": false,
+                            "default": "view",
+                            "enum": [
+                                "view",
+                                "embed",
+                                "edit"
+                            ],
+                            "description": "Scope under which the request is made; determines fields present in response.",
+                            "type": "string"
+                        },
+                        "plugin": {
+                            "required": false,
+                            "type": "string"
+                        }
+                    }
+                },
+                {
+                    "methods": [
+                        "POST",
+                        "PUT",
+                        "PATCH"
+                    ],
+                    "args": {
+                        "context": {
+                            "required": false,
+                            "default": "view",
+                            "enum": [
+                                "view",
+                                "embed",
+                                "edit"
+                            ],
+                            "description": "Scope under which the request is made; determines fields present in response.",
+                            "type": "string"
+                        },
+                        "plugin": {
+                            "required": false,
+                            "type": "string"
+                        },
+                        "status": {
+                            "required": false,
+                            "enum": [
+                                "inactive",
+                                "active"
+                            ],
+                            "description": "The plugin activation status.",
+                            "type": "string"
+                        }
+                    }
+                },
+                {
+                    "methods": [
+                        "DELETE"
+                    ],
+                    "args": {
+                        "context": {
+                            "required": false,
+                            "default": "view",
+                            "enum": [
+                                "view",
+                                "embed",
+                                "edit"
+                            ],
+                            "description": "Scope under which the request is made; determines fields present in response.",
+                            "type": "string"
+                        },
+                        "plugin": {
+                            "required": false,
+                            "type": "string"
+                        }
+                    }
+                }
+            ]
+        },
+        "/wp/v2/block-directory/search": {
+            "namespace": "wp/v2",
+            "methods": [
+                "GET"
+            ],
+            "endpoints": [
+                {
+                    "methods": [
+                        "GET"
+                    ],
+                    "args": {
+                        "context": {
+                            "required": false,
+                            "default": "view",
+                            "enum": [
+                                "view"
+                            ],
+                            "description": "Scope under which the request is made; determines fields present in response.",
+                            "type": "string"
+                        },
+                        "page": {
+                            "required": false,
+                            "default": 1,
+                            "description": "Current page of the collection.",
+                            "type": "integer"
+                        },
+                        "per_page": {
+                            "required": false,
+                            "default": 10,
+                            "description": "Maximum number of items to be returned in result set.",
+                            "type": "integer"
+                        },
+                        "term": {
+                            "required": true,
+                            "description": "Limit result set to blocks matching the search term.",
+                            "type": "string"
+                        }
+                    }
+                }
+            ],
+            "_links": {
+                "self": [
+                    {
+                        "href": "http://example.org/index.php?rest_route=/wp/v2/block-directory/search"
+                    }
+                ]
             }
         }