Comments: Add a REST API endpoint for comment types

src/wp-includes/class-wp-comment-type.php

@@ -85,6 +85,17 @@ final class WP_Comment_Type {
 	 */
 	public $internal = false;
 
+	/**
+	 * Whether to expose this comment type in the `/wp/v2/comment-types` endpoint.
+	 *
+	 * Does not affect access to comments of this type via `/wp/v2/comments`.
+	 * Default is the value of $public.
+	 *
+	 * @since 7.3.0
+	 * @var bool
+	 */
+	public $show_in_rest;
+
 	/**
 	 * Whether this comment type is a native or "built-in" comment type.
 	 *
@@ -172,15 +183,21 @@ public function set_props( $args ): void {
 
 		// No 'label' default, so get_comment_type_labels() can fall back to the default name.
 		$defaults = array(
-			'labels'      => array(),
-			'description' => '',
-			'public'      => true,
-			'internal'    => false,
-			'_builtin'    => false,
+			'labels'       => array(),
+			'description'  => '',
+			'public'       => true,
+			'internal'     => false,
+			'show_in_rest' => null,
+			'_builtin'     => false,
 		);
 
 		$args = array_merge( $defaults, $args );
 
+		// Unlike WP_Post_Type, there is no back-compat reason to default this to false.
+		if ( null === $args['show_in_rest'] ) {
+			$args['show_in_rest'] = $args['public'];
+		}
+
 		$args['name'] = $this->name;
 
 		// The hierarchical label slots are null, so a true value would null every default label.

src/wp-includes/comment.php

@@ -434,23 +434,27 @@ function create_initial_comment_types(): void {
  * @param array|string $args {
  *     Optional. Array or string of arguments for registering a comment type. Default empty array.
  *
- *     @type string     $label       Name of the comment type. Usually plural.
- *                                   Default is the value of $labels['name'].
- *     @type string[]   $labels      An array of labels for this comment type. If not set, the
- *                                   default comment labels are used. See get_comment_type_labels()
- *                                   for a full list of supported labels.
- *     @type string     $description A short descriptive summary of what the comment type is.
- *                                   Default empty.
- *     @type bool       $public      Whether the comment type is intended for use publicly either via
- *                                   the admin interface or by front-end users. Core does not
- *                                   currently act on this argument. Default true.
- *     @type bool       $internal    Whether the comment type is for internal use only. Internal
- *                                   types are meant to be excluded from comment queries and counts
- *                                   by default. Core does not currently act on this argument.
- *                                   Default false.
- *     @type bool       $_builtin    For internal core use only. Marks the type as native to
- *                                   WordPress, which blocks it from being re-registered or
- *                                   unregistered. Default false.
+ *     @type string     $label        Name of the comment type. Usually plural.
+ *                                    Default is the value of $labels['name'].
+ *     @type string[]   $labels       An array of labels for this comment type. If not set, the
+ *                                    default comment labels are used. See get_comment_type_labels()
+ *                                    for a full list of supported labels.
+ *     @type string     $description  A short descriptive summary of what the comment type is.
+ *                                    Default empty.
+ *     @type bool       $public       Whether the comment type is intended for use publicly either via
+ *                                    the admin interface or by front-end users. Core does not
+ *                                    currently act on this argument. Default true.
+ *     @type bool       $internal     Whether the comment type is for internal use only. Internal
+ *                                    types are meant to be excluded from comment queries and counts
+ *                                    by default. Core does not currently act on this argument.
+ *                                    Default false.
+ *     @type bool       $show_in_rest Whether to expose this comment type in the REST API comment types
+ *                                    discovery endpoint (`/wp/v2/comment-types`). Does not affect
+ *                                    access to comments of this type via `/wp/v2/comments`.
+ *                                    Default is the value of $public.
+ *     @type bool       $_builtin     For internal core use only. Marks the type as native to
+ *                                    WordPress, which blocks it from being re-registered or
+ *                                    unregistered. Default false.
  * }
  * @return WP_Comment_Type|WP_Error The registered comment type object on success,
  *                                  WP_Error object on failure.

src/wp-includes/rest-api.php

@@ -324,6 +324,10 @@ function create_initial_rest_routes() {
 	$controller = new WP_REST_Comments_Controller();
 	$controller->register_routes();
 
+	// Comment types.
+	$controller = new WP_REST_Comment_Types_Controller();
+	$controller->register_routes();
+
 	$search_handlers = array(
 		new WP_REST_Post_Search_Handler(),
 		new WP_REST_Term_Search_Handler(),