Changeset 47122 for trunk/src/wp-admin/menu-header.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/menu-header.php (modified) (3 diffs)

trunk/src/wp-admin/menu-header.php

@@ -70 +70 @@
 
     $first = true;
-    // 0 = menu_title, 1 = capability, 2 = menu_slug, 3 = page_title, 4 = classes, 5 = hookname, 6 = icon_url
+    // 0 = menu_title, 1 = capability, 2 = menu_slug, 3 = page_title, 4 = classes, 5 = hookname, 6 = icon_url.
     foreach ( $menu as $key => $item ) {
         $admin_is_parent = false;
@@ -185 +185 @@
             $first = true;
 
-            // 0 = menu_title, 1 = capability, 2 = menu_slug, 3 = page_title, 4 = classes
+            // 0 = menu_title, 1 = capability, 2 = menu_slug, 3 = page_title, 4 = classes.
             foreach ( $submenu_items as $sub_key => $sub_item ) {
                 if ( ! current_user_can( $sub_item[1] ) ) {
@@ -239 +239 @@
 
                 if ( ! empty( $menu_hook ) || ( ( 'index.php' != $sub_item[2] ) && file_exists( WP_PLUGIN_DIR . "/$sub_file" ) && ! file_exists( ABSPATH . "/wp-admin/$sub_file" ) ) ) {
-                    // If admin.php is the current page or if the parent exists as a file in the plugins or admin dir
+                    // If admin.php is the current page or if the parent exists as a file in the plugins or admin directory.
                     if ( ( ! $admin_is_parent && file_exists( WP_PLUGIN_DIR . "/$menu_file" ) && ! is_dir( WP_PLUGIN_DIR . "/{$item[2]}" ) ) || file_exists( $menu_file ) ) {
                         $sub_item_url = add_query_arg( array( 'page' => $sub_item[2] ), $item[2] );