Changeset 14504

Timestamp:

08/01/2025 07:26:08 AM (11 months ago)

Author:

dd32

Message:

Plugin Directory: Reviewer Tools: Display the number of installs of the latest version of a plugin in the controls metabox.

This is only displayed privately for now to determine the performance of the queries nad viability of use within the Release rollout functionality for "progress of update".

See #8009.

Location:

sites/trunk/wordpress.org/public_html/wp-content/plugins/plugin-directory

Files:

• admin/metabox/class-controls.php (modified) (1 diff)
• api/routes/class-internal-stats.php (modified) (3 diffs)
• class-template.php (modified) (1 diff)

sites/trunk/wordpress.org/public_html/wp-content/plugins/plugin-directory/admin/metabox/class-controls.php

@@ -221 +221 @@
             </tr>
 
+            <?php if (
+                function_exists( 'WordPressdotorg\Stats\plugin_active_installs' ) &&
+                $post->version &&
+                'publish' === $post->post_status
+            ): ?>
+            <tr>
+                <td><?php echo esc_html( "Installs of {$post->version}:" ); ?></td>
+                <td><strong><?php
+                    echo Template::format_active_installs_for_display(
+                        Template::sanitize_active_installs(
+                            \WordPressdotorg\Stats\plugin_active_installs( $post->post_name, $post->version )
+                        )
+                    );
+                ?></strong></td>
+            </tr>
+            <?php endif; ?>
+
             <?php if ( $post->tested ) : ?>
             <tr>

sites/trunk/wordpress.org/public_html/wp-content/plugins/plugin-directory/api/routes/class-internal-stats.php

@@ -4 +4 @@
 use WordPressdotorg\Plugin_Directory\Plugin_Directory;
 use WordPressdotorg\Plugin_Directory\API\Base;
+use WordPressdotorg\Plugin_Directory\Template;
 
 /**
@@ -56 +57 @@
                     update_post_meta( $plugin->ID, '_active_installs', wp_slash( $value ) );
 
-                    $value = $this->sanitize_active_installs( $value );
+                    $value = Template::sanitize_active_installs( $value );
                 } elseif ( 'usage' == $stat_name ) {
                     $value = $this->sanitize_usage_numbers( $value, $plugin );
@@ -70 +71 @@
 
         return true;
-    }
-
-    /**
-     * Sanitizes the Active Install count number to a rounded display value.
-     *
-     * @param int $active_installs The raw active install number.
-     * @return int The sanitized version for display.
-     */
-    protected function sanitize_active_installs( $active_installs ) {
-        if ( $active_installs > 10000000 ) {
-            // 10 million +
-            return 10000000;
-        } elseif ( $active_installs > 1000000 ) {
-            $round = 1000000;
-        } elseif ( $active_installs > 100000 ) {
-            $round = 100000;
-        } elseif ( $active_installs > 10000 ) {
-            $round = 10000;
-        } elseif ( $active_installs > 1000 ) {
-            $round = 1000;
-        } elseif ( $active_installs > 100 ) {
-            $round = 100;
-        } else {
-            // Rounded to ten, else 0
-            $round = 10;
-        }
-
-        return floor( $active_installs / $round ) * $round;
     }
 

sites/trunk/wordpress.org/public_html/wp-content/plugins/plugin-directory/class-template.php

@@ -250 +250 @@
     public static function active_installs( $full = true, $post = null ) {
         $post  = get_post( $post );
-        $count = get_post_meta( $post->ID, 'active_installs', true ) ?: 0;
+        $count = get_post_meta( $post->ID, 'active_installs', true ) ?: 0; // Already sanitized to a round number.
 
         if ( 'closed' === $post->post_status ) {
             $text = __( 'N/A', 'wporg-plugins' );
-        } elseif ( $count < 10 ) {
-            $text = __( 'Fewer than 10', 'wporg-plugins' );
-        } elseif ( $count >= 1000000 ) {
+        } else {
+            $text = self::format_active_installs_for_display( $count );
+        }
+
+        return $full ? sprintf( __( '%s active installations', 'wporg-plugins' ), $text ) : $text;
+    }
+
+    /**
+     * Formats the active installs count for display.
+     *
+     * @static
+     *
+     * @param int $count The active installs count.
+     * @return string The formatted count.
+     */
+    public static function format_active_installs_for_display( $count ) {
+        if ( $count < 10 ) {
+            return __( 'Fewer than 10', 'wporg-plugins' );
+        }
+
+        if ( $count >= 1000000 ) {
             $million_count = intdiv( $count, 1000000 );
+
             /* translators: %d: The integer number of million active installs */
-            $text = sprintf( _n( '%d+ million', '%d+ million', $million_count, 'wporg-plugins' ), $million_count );
+            return sprintf( _n( '%d+ million', '%d+ million', $million_count, 'wporg-plugins' ), $million_count );
+        }
+
+        return number_format_i18n( $count ) . '+';
+    }
+
+    /**
+     * Sanitizes the Active Install count number to a rounded display value.
+     *
+     * @static
+     *
+     * @param int $active_installs The raw active install number.
+     * @return int The sanitized version for display.
+     */
+    public static function sanitize_active_installs( $active_installs ) {
+        if ( $active_installs > 10000000 ) {
+            // 10 million +
+            return 10000000;
+        } elseif ( $active_installs > 1000000 ) {
+            $round = 1000000;
+        } elseif ( $active_installs > 100000 ) {
+            $round = 100000;
+        } elseif ( $active_installs > 10000 ) {
+            $round = 10000;
+        } elseif ( $active_installs > 1000 ) {
+            $round = 1000;
+        } elseif ( $active_installs > 100 ) {
+            $round = 100;
         } else {
-            $text = number_format_i18n( $count ) . '+';
-        }
-
-        return $full ? sprintf( __( '%s active installations', 'wporg-plugins' ), $text ) : $text;
+            // Rounded to ten, else 0
+            $round = 10;
+        }
+
+        return floor( $active_installs / $round ) * $round;
     }