Changeset 54855 for trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Timestamp:

11/17/2022 06:13:47 PM (3 years ago)

Author:

SergeyBiryukov

Message:

Docs: Update various DocBlocks and inline comments per the documentation standards.

Includes minor formatting edits for consistency.

Follow-up to [53/tests], [12179], [12946], [35288], [37884], [38810], [38928], [46596], [48131], [52955], [53548], [53813], [53873], [54118], [54316], [54420], [54421], [54803].

See #56792.

File:

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

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

@@ -660 +660 @@
         ) {
             /*
-             * `wp_unique_post_slug()` returns the same
-             * slug for 'draft' or 'pending' posts.
+             * `wp_unique_post_slug()` returns the same slug for 'draft' or 'pending' posts.
              *
-             * To ensure that a unique slug is generated,
-             * pass the post data with the 'publish' status.
+             * To ensure that a unique slug is generated, pass the post data with the 'publish' status.
              */
             $prepared_post->post_name = wp_unique_post_slug(
@@ -863 +861 @@
 
         /*
-         * `wp_unique_post_slug()` returns the same
-         * slug for 'draft' or 'pending' posts.
-         *
-         * To ensure that a unique slug is generated,
-         * pass the post data with the 'publish' status.
+         * `wp_unique_post_slug()` returns the same slug for 'draft' or 'pending' posts.
+         *
+         * To ensure that a unique slug is generated, pass the post data with the 'publish' status.
          */
         if ( ! empty( $post->post_name ) && in_array( $post_status, array( 'draft', 'pending' ), true ) ) {
             $post_parent     = ! empty( $post->post_parent ) ? $post->post_parent : 0;
-            $post->post_name = wp_unique_post_slug( $post->post_name, $post->ID, 'publish', $post->post_type, $post_parent );
+            $post->post_name = wp_unique_post_slug(
+                $post->post_name,
+                $post->ID,
+                'publish',
+                $post->post_type,
+                $post_parent
+            );
         }