Changeset 46342

Timestamp:

09/29/2019 12:18:48 PM (2 months ago)

Author:

SergeyBiryukov

Message:

Docs: Improve comments in tests/multisite/network.php per the documentation standards.

Props garrett-eclipse, jrf.
See #48142.

File:

• trunk/tests/phpunit/tests/multisite/network.php (modified) (12 diffs)

trunk/tests/phpunit/tests/multisite/network.php

@@ -153 +153 @@
 
             $site_ids = self::factory()->blog->create_many( 1 );
-            $actual   = (int) get_blog_count(); // count only updated when cron runs, so unchanged
+            $actual   = (int) get_blog_count(); // Count only updated when cron runs, so should be unchanged.
 
             foreach ( $site_ids as $site_id ) {
@@ -172 +172 @@
             add_filter( 'enable_live_network_counts', '__return_false' );
             $site_ids = self::factory()->blog->create_many( 1 );
-            $actual   = (int) get_blog_count(); // count only updated when cron runs, so unchanged
+            $actual   = (int) get_blog_count(); // Count only updated when cron runs, so should be unchanged.
             remove_filter( 'enable_live_network_counts', '__return_false' );
 
@@ -235 +235 @@
          */
         function test_enable_live_network_user_counts_filter() {
-            // false for large networks by default
+            // False for large networks by default.
             add_filter( 'enable_live_network_counts', '__return_false' );
 
-            // Refresh the cache
+            // Refresh the cache.
             wp_update_network_counts();
             $start_count = get_user_count();
@@ -244 +244 @@
             wpmu_create_user( 'user', 'pass', 'email' );
 
-            // No change, cache not refreshed
+            // No change, cache not refreshed.
             $count = get_user_count();
 
@@ -266 +266 @@
             $path = 'hello.php';
 
-            // local activate, should be invisible for the network
-            activate_plugin( $path ); // $network_wide = false
+            // Local activate, should be invisible for the network.
+            activate_plugin( $path ); // Enable the plugin for the current site.
             $active_plugins = wp_get_active_network_plugins();
             $this->assertEquals( array(), $active_plugins );
@@ -273 +273 @@
             add_action( 'deactivated_plugin', array( $this, '_helper_deactivate_hook' ) );
 
-            // activate the plugin sitewide
-            activate_plugin( $path, '', $network_wide = true );
+            // Activate the plugin sitewide.
+            activate_plugin( $path, '', $network_wide = true ); // Enable the plugin for all sites in the network.
             $active_plugins                           = wp_get_active_network_plugins();
             $this->assertEquals( array( WP_PLUGIN_DIR . '/hello.php' ), $active_plugins );
 
-            //deactivate the plugin
+            // Deactivate the plugin.
             deactivate_plugins( $path );
             $active_plugins = wp_get_active_network_plugins();
             $this->assertEquals( array(), $active_plugins );
 
-            $this->assertEquals( 1, $this->plugin_hook_count ); // testing actions and silent mode
-
-            activate_plugin( $path, '', $network_wide = true );
-            deactivate_plugins( $path, true ); // silent
-
-            $this->assertEquals( 1, $this->plugin_hook_count ); // testing actions and silent mode
+            $this->assertEquals( 1, $this->plugin_hook_count ); // Testing actions and silent mode.
+
+            activate_plugin( $path, '', $network_wide = true ); // Enable the plugin for all sites in the network.
+            deactivate_plugins( $path, true ); // Silent mode.
+
+            $this->assertEquals( 1, $this->plugin_hook_count ); // Testing actions and silent mode.
         }
 
@@ -299 +299 @@
             add_action( 'activate_' . $path, array( $mock, 'action' ) );
 
-            // should activate on the first try
-            activate_plugin( $path, '', true );
+            // Should activate on the first try.
+            activate_plugin( $path, '', true ); // Enable the plugin for all sites in the network.
             $active_plugins = wp_get_active_network_plugins();
             $this->assertCount( 1, $active_plugins );
             $this->assertEquals( 1, $mock->get_call_count() );
 
-            // should do nothing on the second try
-            activate_plugin( $path, '', true );
+            // Should do nothing on the second try.
+            activate_plugin( $path, '', true ); // Enable the plugin for all sites in the network.
             $active_plugins = wp_get_active_network_plugins();
             $this->assertCount( 1, $active_plugins );
@@ -329 +329 @@
 
         function test_get_user_count() {
-            // Refresh the cache
+            // Refresh the cache.
             wp_update_network_counts();
             $start_count = get_user_count();
 
-            // Only false for large networks as of 3.7
+            // Only false for large networks as of 3.7.
             add_filter( 'enable_live_network_counts', '__return_false' );
             self::factory()->user->create( array( 'role' => 'administrator' ) );
 
-            $count = get_user_count(); // No change, cache not refreshed
+            $count = get_user_count(); // No change, cache not refreshed.
             $this->assertEquals( $start_count, $count );
 
-            wp_update_network_counts(); // Magic happens here
+            wp_update_network_counts(); // Magic happens here.
 
             $count = get_user_count();
@@ -350 +350 @@
             $this->assertFalse( wp_next_scheduled( 'update_network_counts' ) );
 
-            // We can't use wp_schedule_update_network_counts() because WP_INSTALLING is set
+            // We can't use wp_schedule_update_network_counts() because WP_INSTALLING is set.
             wp_schedule_event( time(), 'twicedaily', 'update_network_counts' );
 
@@ -360 +360 @@
          */
         function test_get_dashboard_blog() {
-            // if there is no dashboard blog set, current blog is used
+            // If there is no dashboard blog set, current blog is used.
             $dashboard_blog = get_dashboard_blog();
             $this->assertEquals( 1, $dashboard_blog->blog_id );
@@ -368 +368 @@
             $this->assertInternalType( 'int', $blog_id );
 
-            // set the dashboard blog to another one
+            // Set the dashboard blog to another one.
             update_site_option( 'dashboard_blog', $blog_id );
             $dashboard_blog = get_dashboard_blog();
@@ -648 +648 @@
 
         /**
-         * Gets the ID of the site with the highest ID
+         * Gets the ID of the site with the highest ID.
          * @return int
          */
         protected function _get_next_network_id() {
             global $wpdb;
-            //create an extra network, just to make sure we know the ID of the following one
+            // Create an extra network, just to make sure we know the ID of the following one.
             static::factory()->network->create();
             return (int) $wpdb->get_var( 'SELECT id FROM ' . $wpdb->site . ' ORDER BY id DESC LIMIT 1' ) + 1;