Changeset 53074 for trunk/src/wp-admin/includes/class-wp-plugin-install-list-table.php

Timestamp:

04/05/2022 11:00:58 AM (2 years ago)

Author:

SergeyBiryukov

Message:

Plugins: Introduce the plugin_install_description filter.

This allows for modification of the plugin card description on the Add Plugins screen.

Use cases include displaying a list of dependencies for the ​Plugin Dependencies feature project (​GitHub).

Props afragen, davidbaumwald, peterwilsoncc, SergeyBiryukov.
Fixes #55480.

File:

• trunk/src/wp-admin/includes/class-wp-plugin-install-list-table.php (modified) (2 diffs)

trunk/src/wp-admin/includes/class-wp-plugin-install-list-table.php

@@ -515 +515 @@
             // Remove any HTML from the description.
             $description = strip_tags( $plugin['short_description'] );
-            $version     = wp_kses( $plugin['version'], $plugins_allowedtags );
+
+            /**
+             * Filters the plugin card description on the Add Plugins screen.
+             *
+             * @since 6.0.0
+             *
+             * @param string $description Plugin card description.
+             * @param array  $plugin      An array of plugin data. See the {@see 'plugin_row_meta'} filter
+             *                            for the list of possible values.
+             */
+            $description = apply_filters( 'plugin_install_description', $description, $plugin );
+
+            $version = wp_kses( $plugin['version'], $plugins_allowedtags );
 
             $name = strip_tags( $title . ' ' . $version );
@@ -661 +673 @@
              *
              * @param string[] $action_links An array of plugin action links. Defaults are links to Details and Install Now.
-             * @param array    $plugin       The plugin currently being listed.
+             * @param array    $plugin       An array of plugin data. See the {@see 'plugin_row_meta'} filter
+             *                               for the list of possible values.
              */
             $action_links = apply_filters( 'plugin_install_action_links', $action_links, $plugin );