Changeset 57120 for trunk/src/wp-includes/media.php

Timestamp:

11/17/2023 01:27:23 PM (18 months ago)

Author:

SergeyBiryukov

Message:

Docs: Improve some DocBlocks and inline comments per the documentation standards.

Follow-up to [56834], [56836], [56837], [56838].

Props kebbet, costdev, mukesh27, SergeyBiryukov.
See #59651.

File:

• trunk/src/wp-includes/media.php (modified) (2 diffs)

trunk/src/wp-includes/media.php

@@ -2637 +2637 @@
         $post_parent = get_post( $post_parent_id );
 
-        // terminate the shortcode execution if user cannot read the post or password-protected
-        if (
-        ( ! is_post_publicly_viewable( $post_parent->ID ) && ! current_user_can( 'read_post', $post_parent->ID ) )
-        || post_password_required( $post_parent ) ) {
+        // Terminate the shortcode execution if the user cannot read the post or it is password-protected.
+        if ( ! is_post_publicly_viewable( $post_parent->ID ) && ! current_user_can( 'read_post', $post_parent->ID )
+            || post_password_required( $post_parent )
+        ) {
             return '';
         }
@@ -2980 +2980 @@
         $post_parent = get_post( $id );
 
-        // terminate the shortcode execution if user cannot read the post or password-protected
+        // Terminate the shortcode execution if the user cannot read the post or it is password-protected.
         if ( ! current_user_can( 'read_post', $post_parent->ID ) || post_password_required( $post_parent ) ) {
             return '';