Title: WP_Plugin_Install_List_Table::display_rows
Published: April 25, 2014
Last modified: February 24, 2026

---

# WP_Plugin_Install_List_Table::display_rows()

## In this article

 * [Source](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/?output_format=md#source)
 * [Hooks](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/?output_format=md#hooks)
 * [Related](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/?output_format=md#wp--skip-link--target)

Generates the list table rows.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/?output_format=md#source)󠁿

    ```php
    public function display_rows() {
    	$plugins_allowedtags = array(
    		'a'       => array(
    			'href'   => array(),
    			'title'  => array(),
    			'target' => array(),
    		),
    		'abbr'    => array( 'title' => array() ),
    		'acronym' => array( 'title' => array() ),
    		'code'    => array(),
    		'pre'     => array(),
    		'em'      => array(),
    		'strong'  => array(),
    		'ul'      => array(),
    		'ol'      => array(),
    		'li'      => array(),
    		'p'       => array(),
    		'br'      => array(),
    	);

    	$plugins_group_titles = array(
    		'Performance' => _x( 'Performance', 'Plugin installer group title' ),
    		'Social'      => _x( 'Social', 'Plugin installer group title' ),
    		'Tools'       => _x( 'Tools', 'Plugin installer group title' ),
    	);

    	$group = null;

    	foreach ( (array) $this->items as $plugin ) {
    		if ( is_object( $plugin ) ) {
    			$plugin = (array) $plugin;
    		}

    		// Display the group heading if there is one.
    		if ( isset( $plugin['group'] ) && $plugin['group'] !== $group ) {
    			if ( isset( $this->groups[ $plugin['group'] ] ) ) {
    				$group_name = $this->groups[ $plugin['group'] ];
    				if ( isset( $plugins_group_titles[ $group_name ] ) ) {
    					$group_name = $plugins_group_titles[ $group_name ];
    				}
    			} else {
    				$group_name = $plugin['group'];
    			}

    			// Starting a new group, close off the divs of the last one.
    			if ( ! empty( $group ) ) {
    				echo '</div></div>';
    			}

    			echo '<div class="plugin-group"><h3>' . esc_html( $group_name ) . '</h3>';
    			// Needs an extra wrapping div for nth-child selectors to work.
    			echo '<div class="plugin-items">';

    			$group = $plugin['group'];
    		}

    		$title = wp_kses( $plugin['name'], $plugins_allowedtags );

    		// Remove any HTML from the description.
    		$description = strip_tags( $plugin['short_description'] );

    		/**
    		 * 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 plugins_api()
    		 *                            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 );

    		$author = wp_kses( $plugin['author'], $plugins_allowedtags );
    		if ( ! empty( $author ) ) {
    			/* translators: %s: Plugin author. */
    			$author = ' <cite>' . sprintf( __( 'By %s' ), $author ) . '</cite>';
    		}

    		$requires_php = isset( $plugin['requires_php'] ) ? $plugin['requires_php'] : null;
    		$requires_wp  = isset( $plugin['requires'] ) ? $plugin['requires'] : null;

    		$compatible_php = is_php_version_compatible( $requires_php );
    		$compatible_wp  = is_wp_version_compatible( $requires_wp );
    		$tested_wp      = ( empty( $plugin['tested'] ) || version_compare( get_bloginfo( 'version' ), $plugin['tested'], '<=' ) );

    		$action_links = array();

    		$action_links[] = wp_get_plugin_action_button( $name, $plugin, $compatible_php, $compatible_wp );

    		$details_link = self_admin_url(
    			'plugin-install.php?tab=plugin-information&amp;plugin=' . $plugin['slug'] .
    			'&amp;TB_iframe=true&amp;width=600&amp;height=550'
    		);

    		$action_links[] = sprintf(
    			'<a href="%s" class="thickbox open-plugin-details-modal" aria-label="%s" data-title="%s">%s</a>',
    			esc_url( $details_link ),
    			/* translators: %s: Plugin name and version. */
    			esc_attr( sprintf( __( 'More information about %s' ), $name ) ),
    			esc_attr( $name ),
    			__( 'More Details' )
    		);

    		if ( ! empty( $plugin['icons']['svg'] ) ) {
    			$plugin_icon_url = $plugin['icons']['svg'];
    		} elseif ( ! empty( $plugin['icons']['2x'] ) ) {
    			$plugin_icon_url = $plugin['icons']['2x'];
    		} elseif ( ! empty( $plugin['icons']['1x'] ) ) {
    			$plugin_icon_url = $plugin['icons']['1x'];
    		} else {
    			$plugin_icon_url = $plugin['icons']['default'];
    		}

    		/**
    		 * Filters the install action links for a plugin.
    		 *
    		 * @since 2.7.0
    		 *
    		 * @param string[] $action_links An array of plugin action links.
    		 *                               Defaults are links to Details and Install Now.
    		 * @param array    $plugin       An array of plugin data. See plugins_api()
    		 *                               for the list of possible values.
    		 */
    		$action_links = apply_filters( 'plugin_install_action_links', $action_links, $plugin );

    		$last_updated_timestamp = strtotime( $plugin['last_updated'] );
    		?>
    	<div class="plugin-card plugin-card-<?php echo sanitize_html_class( $plugin['slug'] ); ?>">
    		<?php
    		if ( ! $compatible_php || ! $compatible_wp ) {
    			$incompatible_notice_message = '';
    			if ( ! $compatible_php && ! $compatible_wp ) {
    				$incompatible_notice_message .= __( 'This plugin does not work with your versions of WordPress and PHP.' );
    				if ( current_user_can( 'update_core' ) && current_user_can( 'update_php' ) ) {
    					$incompatible_notice_message .= sprintf(
    						/* translators: 1: URL to WordPress Updates screen, 2: URL to Update PHP page. */
    						' ' . __( '<a href="%1$s">Please update WordPress</a>, and then <a href="%2$s">learn more about updating PHP</a>.' ),
    						self_admin_url( 'update-core.php' ),
    						esc_url( wp_get_update_php_url() )
    					);
    					$incompatible_notice_message .= wp_update_php_annotation( '</p><p><em>', '</em>', false );
    				} elseif ( current_user_can( 'update_core' ) ) {
    					$incompatible_notice_message .= sprintf(
    						/* translators: %s: URL to WordPress Updates screen. */
    						' ' . __( '<a href="%s">Please update WordPress</a>.' ),
    						self_admin_url( 'update-core.php' )
    					);
    				} elseif ( current_user_can( 'update_php' ) ) {
    					$incompatible_notice_message .= sprintf(
    						/* translators: %s: URL to Update PHP page. */
    						' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ),
    						esc_url( wp_get_update_php_url() )
    					);
    					$incompatible_notice_message .= wp_update_php_annotation( '</p><p><em>', '</em>', false );
    				}
    			} elseif ( ! $compatible_wp ) {
    				$incompatible_notice_message .= __( 'This plugin does not work with your version of WordPress.' );
    				if ( current_user_can( 'update_core' ) ) {
    					$incompatible_notice_message .= sprintf(
    						/* translators: %s: URL to WordPress Updates screen. */
    						' ' . __( '<a href="%s">Please update WordPress</a>.' ),
    						self_admin_url( 'update-core.php' )
    					);
    				}
    			} elseif ( ! $compatible_php ) {
    				$incompatible_notice_message .= __( 'This plugin does not work with your version of PHP.' );
    				if ( current_user_can( 'update_php' ) ) {
    					$incompatible_notice_message .= sprintf(
    						/* translators: %s: URL to Update PHP page. */
    						' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ),
    						esc_url( wp_get_update_php_url() )
    					);
    					$incompatible_notice_message .= wp_update_php_annotation( '</p><p><em>', '</em>', false );
    				}
    			}

    			wp_admin_notice(
    				$incompatible_notice_message,
    				array(
    					'type'               => 'error',
    					'additional_classes' => array( 'notice-alt', 'inline' ),
    				)
    			);
    		}
    		?>
    		<div class="plugin-card-top">
    			<div class="name column-name">
    				<h3>
    					<a href="<?php echo esc_url( $details_link ); ?>" class="thickbox open-plugin-details-modal">
    					<?php echo $title; ?>
    					<img src="<?php echo esc_url( $plugin_icon_url ); ?>" class="plugin-icon" alt="" />
    					</a>
    				</h3>
    			</div>
    			<div class="action-links">
    				<?php
    				if ( $action_links ) {
    					echo '<ul class="plugin-action-buttons"><li>' . implode( '</li><li>', $action_links ) . '</li></ul>';
    				}
    				?>
    			</div>
    			<div class="desc column-description">
    				<p><?php echo $description; ?></p>
    				<p class="authors"><?php echo $author; ?></p>
    			</div>
    		</div>
    		<?php
    		$dependencies_notice = $this->get_dependencies_notice( $plugin );
    		if ( ! empty( $dependencies_notice ) ) {
    			echo $dependencies_notice;
    		}
    		?>
    		<div class="plugin-card-bottom">
    			<div class="vers column-rating">
    				<?php
    				wp_star_rating(
    					array(
    						'rating' => $plugin['rating'],
    						'type'   => 'percent',
    						'number' => $plugin['num_ratings'],
    					)
    				);
    				?>
    				<span class="num-ratings" aria-hidden="true">(<?php echo number_format_i18n( $plugin['num_ratings'] ); ?>)</span>
    			</div>
    			<div class="column-updated">
    				<strong><?php _e( 'Last Updated:' ); ?></strong>
    				<?php
    					/* translators: %s: Human-readable time difference. */
    					printf( __( '%s ago' ), human_time_diff( $last_updated_timestamp ) );
    				?>
    			</div>
    			<div class="column-downloaded">
    				<?php
    				if ( $plugin['active_installs'] >= 1000000 ) {
    					$active_installs_millions = floor( $plugin['active_installs'] / 1000000 );
    					$active_installs_text     = sprintf(
    						/* translators: %s: Number of millions. */
    						_nx( '%s+ Million', '%s+ Million', $active_installs_millions, 'Active plugin installations' ),
    						number_format_i18n( $active_installs_millions )
    					);
    				} elseif ( 0 === $plugin['active_installs'] ) {
    					$active_installs_text = _x( 'Less Than 10', 'Active plugin installations' );
    				} else {
    					$active_installs_text = number_format_i18n( $plugin['active_installs'] ) . '+';
    				}
    				/* translators: %s: Number of installations. */
    				printf( __( '%s Active Installations' ), $active_installs_text );
    				?>
    			</div>
    			<div class="column-compatibility">
    				<?php
    				if ( ! $tested_wp ) {
    					echo '<span class="compatibility-untested">' . __( 'Untested with your version of WordPress' ) . '</span>';
    				} elseif ( ! $compatible_wp ) {
    					echo '<span class="compatibility-incompatible">' . __( '<strong>Incompatible</strong> with your version of WordPress' ) . '</span>';
    				} else {
    					echo '<span class="compatibility-compatible">' . __( '<strong>Compatible</strong> with your version of WordPress' ) . '</span>';
    				}
    				?>
    			</div>
    		</div>
    	</div>
    		<?php
    	}

    	// Close off the group divs of the last one.
    	if ( ! empty( $group ) ) {
    		echo '</div></div>';
    	}
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-admin/includes/class-wp-plugin-install-list-table.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-admin/includes/class-wp-plugin-install-list-table.php#L477)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-admin/includes/class-wp-plugin-install-list-table.php#L477-L751)

## 󠀁[Hooks](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/?output_format=md#hooks)󠁿

 [apply_filters( ‘plugin_install_action_links’, string[] $action_links, array $plugin )](https://developer.wordpress.org/reference/hooks/plugin_install_action_links/)

Filters the install action links for a plugin.

 [apply_filters( ‘plugin_install_description’, string $description, array $plugin )](https://developer.wordpress.org/reference/hooks/plugin_install_description/)

Filters the plugin card description on the Add Plugins screen.

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/?output_format=md#related)󠁿

| Uses | Description | 
| [WP_Plugin_Install_List_Table::get_dependencies_notice()](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/get_dependencies_notice/)`wp-admin/includes/class-wp-plugin-install-list-table.php` |

Returns a notice containing a list of dependencies required by the plugin.

  | 
| [wp_get_plugin_action_button()](https://developer.wordpress.org/reference/functions/wp_get_plugin_action_button/)`wp-admin/includes/plugin-install.php` |

Gets the markup for the plugin install action button.

  | 
| [wp_admin_notice()](https://developer.wordpress.org/reference/functions/wp_admin_notice/)`wp-includes/functions.php` |

Outputs an admin notice.

  | 
| [is_php_version_compatible()](https://developer.wordpress.org/reference/functions/is_php_version_compatible/)`wp-includes/functions.php` |

Checks compatibility with the current PHP version.

  | 
| [is_wp_version_compatible()](https://developer.wordpress.org/reference/functions/is_wp_version_compatible/)`wp-includes/functions.php` |

Checks compatibility with the current WordPress version.

  | 
| [wp_get_update_php_url()](https://developer.wordpress.org/reference/functions/wp_get_update_php_url/)`wp-includes/functions.php` |

Gets the URL to learn more about updating the PHP version the site is running on.

  | 
| [wp_update_php_annotation()](https://developer.wordpress.org/reference/functions/wp_update_php_annotation/)`wp-includes/functions.php` |

Prints the default annotation for the web host altering the “Update PHP” page URL.

  | 
| [wp_star_rating()](https://developer.wordpress.org/reference/functions/wp_star_rating/)`wp-admin/includes/template.php` |

Outputs a HTML element with a star rating for a given rating.

  | 
| [_nx()](https://developer.wordpress.org/reference/functions/_nx/)`wp-includes/l10n.php` |

Translates and retrieves the singular or plural form based on the supplied number, with gettext context.

  | 
| [human_time_diff()](https://developer.wordpress.org/reference/functions/human_time_diff/)`wp-includes/formatting.php` |

Determines the difference between two timestamps.

  | 
| [sanitize_html_class()](https://developer.wordpress.org/reference/functions/sanitize_html_class/)`wp-includes/formatting.php` |

Sanitizes an HTML classname to ensure it only contains valid characters.

  | 
| [wp_kses()](https://developer.wordpress.org/reference/functions/wp_kses/)`wp-includes/kses.php` |

Filters text content and strips out disallowed HTML.

  | 
| [self_admin_url()](https://developer.wordpress.org/reference/functions/self_admin_url/)`wp-includes/link-template.php` |

Retrieves the URL to the admin area for either the current site or the network depending on context.

  | 
| [current_user_can()](https://developer.wordpress.org/reference/functions/current_user_can/)`wp-includes/capabilities.php` |

Returns whether the current user has the specified capability.

  | 
| [_x()](https://developer.wordpress.org/reference/functions/_x/)`wp-includes/l10n.php` |

Retrieves translated string with gettext context.

  | 
| [__()](https://developer.wordpress.org/reference/functions/__/)`wp-includes/l10n.php` |

Retrieves the translation of $text.

  | 
| [_e()](https://developer.wordpress.org/reference/functions/_e/)`wp-includes/l10n.php` |

Displays translated text.

  | 
| [esc_html()](https://developer.wordpress.org/reference/functions/esc_html/)`wp-includes/formatting.php` |

Escaping for HTML blocks.

  | 
| [esc_url()](https://developer.wordpress.org/reference/functions/esc_url/)`wp-includes/formatting.php` |

Checks and cleans a URL.

  | 
| [esc_attr()](https://developer.wordpress.org/reference/functions/esc_attr/)`wp-includes/formatting.php` |

Escaping for HTML attributes.

  | 
| [get_bloginfo()](https://developer.wordpress.org/reference/functions/get_bloginfo/)`wp-includes/general-template.php` |

Retrieves information about the current site.

  | 
| [number_format_i18n()](https://developer.wordpress.org/reference/functions/number_format_i18n/)`wp-includes/functions.php` |

Converts float number to format based on the locale.

  | 
| [apply_filters()](https://developer.wordpress.org/reference/functions/apply_filters/)`wp-includes/plugin.php` |

Calls the callback functions that have been added to a filter hook.

  |

[Show 18 more](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/?output_format=md#)

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wp_plugin_install_list_table/display_rows/?output_format=md#changelog)󠁿

| Version | Description | 
| [3.1.0](https://developer.wordpress.org/reference/since/3.1.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_plugin_install_list_table%2Fdisplay_rows%2F)
before being able to contribute a note or feedback.