plugins_api( string $action, array|object $args = array() ): object|array|WP_Error

User Contributed Notes

1. Skip to note 4 content

   Marc Bernard 6 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   Updated field list with defaults for $action = ‘plugin_information’:

   $fields = array(
   	'active_installs' => true,           // rounded int
   	'added' => true,                     // date
   	'author' => true,                    // a href html
   	'author_block_count' => true,        // int
   	'author_block_rating' => true,       // int
   	'author_profile' => true,            // url
   	'banners' => true,                   // array( [low], [high] )
   	'compatibility' => false,            // empty array?
   	'contributors' => true,              // array( array( [profile], [avatar], [display_name] )
   	'description' => false,              // string
   	'donate_link' => true,               // url
   	'download_link' => true,             // url
   	'downloaded' => false,               // int
   	// 'group' => false,                 // n/a 
   	'homepage' => true,                  // url
   	'icons' => false,                    // array( [1x] url, [2x] url )
   	'last_updated' => true,              // datetime
   	'name' => true,                      // string
   	'num_ratings' => true,               // int
   	'rating' => true,                    // int
   	'ratings' => true,                   // array( [5..0] )
   	'requires' => true,                  // version string
   	'requires_php' => true,              // version string
   	// 'reviews' => false,               // n/a, part of 'sections'
   	'screenshots' => true,               // array( array( [src],  ) )
   	'sections' => true,                  // array( [description], [installation], [changelog], [reviews], ...)
   	'short_description' => false,        // string
   	'slug' => true,                      // string
   	'support_threads' => true,           // int
   	'support_threads_resolved' => true,  // int
   	'tags' => true,                      // array( )
   	'tested' => true,                    // version string
   	'version' => true,                   // version string
   	'versions' => true,                  // array( [version] url )
   );
2. Skip to note 5 content

   Tony G 2 years ago

   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

   Follow-up to comment by @luxxor (Mark Bernard):

   Yes, as of 2019, the plugin_information action does explicitly request author_block_count and author_block_rating by default – but this is only when retrieving info for a block plugin … which makes sense if you’re thinking about blocks but not if you’re expecting the data in a response to any other plugin.

   For anyone using the plugins_api to retrieve plugin_information for a non-block plugin, or using the API directly to retrieve that data, these details may be of interest.

   Block plugins are associated with “the Block Directory“.

   WordPress first searches the current site for the block … If it doesn’t find a block, it searches in the Block Directory which is a special corner of the WordPress plugin repository, where single block plugins are available.

   See Block Directory Items which defines the author_block fields discussed here.

   If not requested, the fields are not present in the response from wordpress.org.
   – This link shows a request for plugin_information on a non-block plugin, without the explicit request for the fields. The fields are not in the response.
   – This link shows a request on a block plugin, without the explicit request for the fields. The fields are still not in the response. The plugins_api function adds the fields in for us.

   If requested and the plugin is not a block plugin, the value of author_block_count is zero and author_block_rating is indeterminate.
   – This link shows a request for plugin_information on the same non-block plugin, with the explicit request for the fields. The fields are at the end of the response, but the block count is zero and the block rating is about 96. The code under the plugins_api function divides that number by 20 for a 0-5 rating. (I don’t know what that number is for a non-block plugin.)

   If requested and the plugin is in a block plugin, the value of author_block_count is a number cast as a string (“2”, “5”, etc) and author_block_rating is numeric. When plugins_api() receives a response from the wordpress.org API, the author_block_count is explicitly cast to an integer (and the rating is divided by 20). If you are using the API directly, again, the value you receive is a string which will not be consistent with the data you see from plugins_api() , and may lead to confusion or errors. (The raw rating value may also be confusing.)
   – This link shows a request for plugin_information on the same block plugin as above, with an explicit request for the fields.

   Note also that while the plugins_api arguments use Boolean values to define the return values, and common examples show true/false being used, when using the API you should use 0 or 1 for false and true respectively. With request[fields][author_block_rating]=false, the value ‘false’ is a string and is therefore “truthy”, so the attempt to exclude fields fails … For the API, use digit/number zero or one, and for plugins_api() , use Boolean true/false.
3. Skip to note 6 content

   Andrei Surdu 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Get plugin data by URL or slug:

   function wpdev_get_plugin_data($urlOrSlug){
   	require_once( ABSPATH . 'wp-admin/includes/plugin-install.php' );
   	
   	$basename = str_replace('/', '', basename($urlOrSlug));
   
   	$info = plugins_api( 'plugin_information', array( 'slug' => $basename ) );
   
   	if ( ! $info or is_wp_error( $info ) ) {
   		return false;
   	}
   
   	return $info;
   }
   
   // Usage example
   $plugin_info = wpdev_get_plugin_data('https://wordpress.org/plugins/your-plugin-slug/'); // false or stdClass