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

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 );

Changelog

VersionDescription
2.8.0Introduced.

User Contributed Notes

  1. Skip to note 3 content
    /**
     * 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

    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.