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_meta

(string[]) An array of the plugin's metadata, including the version, author, author URI, and plugin URI.

$plugin_file

(string) Path to the plugin file relative to the plugins directory.

$plugin_data

(array) 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.

$status

(string) 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'.


Top ↑

More Information

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


Top ↑

Source

File: wp-admin/includes/class-wp-plugins-list-table.php

View on Trac



Top ↑

Changelog

Changelog
Version Description
2.8.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    Contributed by Mahdi Yazdani
    /**
     * 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 2 content
    Contributed by Steven Lin

    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.