Changeset 47122 for trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php

Timestamp:

01/29/2020 12:43:23 AM (5 years ago)

Author:

SergeyBiryukov

Message:

Docs: Improve inline comments per the documentation standards.

Includes minor code layout fixes for better readability.

See #48303.

File:

• trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php (modified) (6 diffs)

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php

@@ -88 +88 @@
                 $taxonomies = get_taxonomies( '', 'objects' );
             }
+
             foreach ( $taxonomies as $taxonomy ) {
                 if ( ! empty( $taxonomy->show_in_rest ) && current_user_can( $taxonomy->cap->assign_terms ) ) {
@@ -93 +94 @@
                 }
             }
-            return new WP_Error( 'rest_cannot_view', __( 'Sorry, you are not allowed to manage terms in this taxonomy.' ), array( 'status' => rest_authorization_required_code() ) );
-        }
+
+            return new WP_Error(
+                'rest_cannot_view',
+                __( 'Sorry, you are not allowed to manage terms in this taxonomy.' ),
+                array( 'status' => rest_authorization_required_code() )
+            );
+        }
+
         return true;
     }
@@ -116 +123 @@
             $taxonomies = get_taxonomies( '', 'objects' );
         }
+
         $data = array();
+
         foreach ( $taxonomies as $tax_type => $value ) {
             if ( empty( $value->show_in_rest ) || ( 'edit' === $request['context'] && ! current_user_can( $value->cap->assign_terms ) ) ) {
                 continue;
             }
+
             $tax               = $this->prepare_item_for_response( $value, $request );
             $tax               = $this->prepare_response_for_collection( $tax );
@@ -150 +160 @@
                 return false;
             }
+
             if ( 'edit' === $request['context'] && ! current_user_can( $tax_obj->cap->assign_terms ) ) {
-                return new WP_Error( 'rest_forbidden_context', __( 'Sorry, you are not allowed to manage terms in this taxonomy.' ), array( 'status' => rest_authorization_required_code() ) );
+                return new WP_Error(
+                    'rest_forbidden_context',
+                    __( 'Sorry, you are not allowed to manage terms in this taxonomy.' ),
+                    array( 'status' => rest_authorization_required_code() )
+                );
             }
         }
@@ -168 +183 @@
     public function get_item( $request ) {
         $tax_obj = get_taxonomy( $request['taxonomy'] );
+
         if ( empty( $tax_obj ) ) {
-            return new WP_Error( 'rest_taxonomy_invalid', __( 'Invalid taxonomy.' ), array( 'status' => 404 ) );
-        }
+            return new WP_Error(
+                'rest_taxonomy_invalid',
+                __( 'Invalid taxonomy.' ),
+                array( 'status' => 404 )
+            );
+        }
+
         $data = $this->prepare_item_for_response( $tax_obj, $request );
+
         return rest_ensure_response( $data );
     }
@@ -380 +402 @@
 
         $this->schema = $schema;
+
         return $this->add_additional_fields_schema( $this->schema );
     }