Changeset 13237

Timestamp:

02/22/2024 06:44:16 AM (2 years ago)

Author:

dd32

Message:

Plugin Directory: Readme: Add a note for when the tags specified have low usage.

See #6108.

Location:

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

Files:

• class-parser.php (modified) (1 diff)
• class-validator.php (modified) (3 diffs)

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

@@ -307 +307 @@
                 $this->warnings['ignored_tags'] = true;
             }
+
+            // Check if the tags are low-quality (ie. little used)
+            if ( $this->tags && taxonomy_exists( 'plugin_tags' ) ) {
+                $tags = get_terms( array(
+                    'taxonomy' => 'plugin_tags',
+                    'name'     => $this->tags,
+                ) );
+
+                $low_usage_tags = array_filter(
+                    $tags,
+                    function( $term ) {
+                        return $term->count < 5;
+                    }
+                );
+
+                $this->warnings['low_usage_tags'] = wp_list_pluck( $low_usage_tags, 'name' );
+            }
+
             if ( count( $this->tags ) > 5 ) {
                 $this->tags = array_slice( $this->tags, 0, 5 );

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

@@ -81 +81 @@
         }
 
-        // Warnings.
+        // Warnings & Notes.
         if ( isset( $readme->warnings['requires_header_ignored'] ) ) {
             $latest_wordpress_version = defined( 'WP_CORE_STABLE_BRANCH' ) ? WP_CORE_STABLE_BRANCH : '5.0';
@@ -138 +138 @@
             );
         } elseif ( ! count( $readme->contributors ) ) {
-            $warnings[] = sprintf(
+            $notes[] = sprintf(
                 /* translators: %s: plugin header tag */
                 __( 'The %s field is missing.', 'wporg-plugins' ),
@@ -157 +157 @@
         }
 
-        // Notes.
+        if ( isset( $readme->warnings['low_usage_tags'] ) ) {
+            $notes[] = sprintf(
+                /* translators: %s: list of tags with low usage. */
+                __( 'The following tags are not widely used: %s', 'wporg-plugins' ),
+                '<code>' . implode( '</code>, <code>', array_map( 'esc_html', $readme->warnings['low_usage_tags'] ) ) . '</code>'
+            );
+        }
+
         if ( empty( $readme->requires ) ) {
             $notes[] = sprintf(