WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

plugin_row_meta

apply_filters( ‘plugin_row_meta’, string[] $plugin_meta, string $plugin_file, array $plugin_data, string $status )

In this article

Back to top

Filters the array of row meta for each plugin in the Plugins list table.

Parameters

$plugin_metastring[]
An array of the plugin’s metadata, including the version, author, author URI, and plugin URI.
$plugin_filestring
Path to the plugin file relative to the plugins directory.
$plugin_dataarray
An array of plugin data.
  • id string
    Plugin ID, e.g. w.org/plugins/[plugin-name].
  • slug string
    Plugin slug.
  • plugin string
    Plugin basename.
  • new_version string
    New plugin version.
  • url string
    Plugin URL.
  • package string
    Plugin update package URL.
  • icons string[]
    An array of plugin icon URLs.
  • banners string[]
    An array of plugin banner URLs.
  • banners_rtl string[]
    An array of plugin RTL banner URLs.
  • requires string
    The version of WordPress which the plugin requires.
  • tested string
    The version of WordPress the plugin is tested against.
  • requires_php string
    The version of PHP which the plugin requires.
  • upgrade_notice string
    The upgrade notice for the new plugin version.
  • update-supported bool
    Whether the plugin supports updates.
  • Name string
    The human-readable name of the plugin.
  • PluginURI string
    Plugin URI.
  • Version string
    Plugin version.
  • Description string
    Plugin description.
  • Author string
    Plugin author.
  • AuthorURI string
    Plugin author URI.
  • TextDomain string
    Plugin textdomain.
  • DomainPath string
    Relative path to the plugin’s .mo file(s).
  • Network bool
    Whether the plugin can only be activated network-wide.
  • RequiresWP string
    The version of WordPress which the plugin requires.
  • RequiresPHP string
    The version of PHP which the plugin requires.
  • UpdateURI string
    ID of the plugin for update purposes, should be a URI.
  • Title string
    The human-readable title of the plugin.
  • AuthorName string
    Plugin author’s name.
  • update bool
    Whether there’s an available update. Default null.
$statusstring
Status filter currently applied to the plugin list. Possible values are: 'all', 'active', 'inactive', 'recently_activated', 'upgrade', 'mustuse', 'dropins', 'search', 'paused', 'auto-update-enabled', 'auto-update-disabled'.

More Information

The plugin_row_meta filter hook is used to add additional links below each plugin on the Plugins page.

Source

$plugin_meta = apply_filters( 'plugin_row_meta', $plugin_meta, $plugin_file, $plugin_data, $status );

View all references View on Trac View on GitHub

Used byDescription
WP_Plugins_List_Table::single_row()wp-admin/includes/class-wp-plugins-list-table.php

Changelog

VersionDescription
2.8.0Introduced.

User Contributed Notes

  1. Skip to note 3 content
    Mahdi Yazdani
    You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
    /**
 * Filters the array of row meta for each/specific plugin in the Plugins list table.
 * Appends additional links below each/specific plugin on the plugins page.
 *
 * @access  public
 * @param   array       $links_array            An array of the plugin's metadata
 * @param   string      $plugin_file_name       Path to the plugin file
 * @param   array       $plugin_data            An array of plugin data
 * @param   string      $status                 Status of the plugin
 * @return  array       $links_array
 */
function prefix_append_support_and_faq_links( $links_array, $plugin_file_name, $plugin_data, $status ) {
	if ( strpos( $plugin_file_name, basename(__FILE__) ) ) {

		// You can still use `array_unshift()` to add links at the beginning.
		$links_array[] = '<a href="#">FAQ</a>';
		$links_array[] = '<a href="#">Support</a>';
	}
 
	return $links_array;
}

add_filter( 'plugin_row_meta', 'prefix_append_support_and_faq_links', 10, 4 );
  2. Skip to note 4 content
    Steven Lin
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

    Example Migrated from Codex:

    Adds new links to the metadata array of the plugin.

    add_filter( 'plugin_row_meta', 'custom_plugin_row_meta', 10, 2 );

function custom_plugin_row_meta( $plugin_meta, $plugin_file, $plugin_data, $status ) {

	if ( strpos( $plugin_file, 'plugin-file-name.php' ) !== false ) {
		$new_links = array(
				'donate' => '<a href="donation_url" target="_blank">Donate</a>',
                'doc' => '<a href="doc_url" target="_blank">Documentation</a>'
				);
		
		$plugin_meta = array_merge( $plugin_meta, $new_links );
	}
	
	return $plugin_meta;
}

You must log in before being able to contribute a note or feedback.