Changeset 47122 for trunk/src/wp-admin/user-edit.php

Timestamp:

01/29/2020 12:43:23 AM (6 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-admin/user-edit.php (modified) (5 diffs)

trunk/src/wp-admin/user-edit.php

@@ -236 +236 @@
 
 <form id="your-profile" action="<?php echo esc_url( self_admin_url( IS_PROFILE_PAGE ? 'profile.php' : 'user-edit.php' ) ); ?>" method="post" novalidate="novalidate"
-                                            <?php
-                                            /**
-                                             * Fires inside the your-profile form tag on the user editing screen.
-                                             *
-                                             * @since 3.0.0
-                                             */
-                                            do_action( 'user_edit_form_tag' );
-                                            ?>
+        <?php
+        /**
+         * Fires inside the your-profile form tag on the user editing screen.
+         *
+         * @since 3.0.0
+         */
+        do_action( 'user_edit_form_tag' );
+        ?>
     >
         <?php wp_nonce_field( 'update-user_' . $user_id ); ?>
@@ -311 +311 @@
         </td>
     </tr>
-            <?php
-endif; // $_wp_admin_css_colors
-        if ( ! ( IS_PROFILE_PAGE && ! $user_can_edit ) ) :
-            ?>
+        <?php endif; // End if count ( $_wp_admin_css_colors ) > 1 ?>
+
+        <?php if ( ! ( IS_PROFILE_PAGE && ! $user_can_edit ) ) : ?>
     <tr class="user-comment-shortcuts-wrap">
         <th scope="row"><?php _e( 'Keyboard Shortcuts' ); ?></th>
@@ -412 +411 @@
 <td><select name="role" id="role">
             <?php
-            // Compare user role against currently editable roles
+            // Compare user role against currently editable roles.
             $user_roles = array_intersect( array_values( $profileuser->roles ), array_keys( get_editable_roles() ) );
             $user_role  = reset( $user_roles );
 
-            // print the full list of roles with the primary one selected.
+            // Print the full list of roles with the primary one selected.
             wp_dropdown_roles( $user_role );
 
-            // print the 'no role' option. Make it selected if the user has no role yet.
+            // Print the 'no role' option. Make it selected if the user has no role yet.
             if ( $user_role ) {
                 echo '<option value="">' . __( '&mdash; No role for this site &mdash;' ) . '</option>';
@@ -428 +427 @@
 </select></td></tr>
             <?php
-endif; //!IS_PROFILE_PAGE
+        endif; // End if ! IS_PROFILE_PAGE.
 
         if ( is_multisite() && is_network_admin() && ! IS_PROFILE_PAGE && current_user_can( 'manage_network_options' ) && ! isset( $super_admins ) ) {
@@ -479 +478 @@
         }
 
-        if ( ! in_array( $profileuser->display_name, $public_display ) ) { // Only add this if it isn't duplicated elsewhere
+        if ( ! in_array( $profileuser->display_name, $public_display ) ) { // Only add this if it isn't duplicated elsewhere.
             $public_display = array( 'display_displayname' => $profileuser->display_name ) + $public_display;
         }