Disclaimer: This plugin is geared towards developers with plugins in the WordPress.org repository and anyone else who wants to display information about a plugin in the repository.
This plugin was designed to be as simple as possible while still being very powerful. There is no settings page, just one shortcode and TinyMCE shortcode interface to help you generate codes with ease. You can display stats from a single plugin or aggregate stats from multiple plugins. Check out the video below for a quick overview.
Available Fields
You can display any of the fields returned by the WordPress.org plugins API, as well as a few extra options. There are currently 28 options.
Active Installs
Times Downloaded
Plugin Name
Plugin Slug
Version
Author
Author Profile Link
Contributors
Requires
Tested
Compatibility
Rating out of 100
Rating out of 5
Star Rating
Number of Reviews
Last Updated
Date Added
Plugin Homepage Link
Short Description
Description
Installation
Screenshots
Change Log
FAQ
Download Link
Support Link
Tags
Donate Link
You can also display aggregate stats from multiple plugins. There are currently two supported aggregate fields.
Active Installs
Times Downloaded
If you have questions or would like to request additional features, please let me know in the plugin support forum.
What Easy Plugin Stats Doesn’t Do
You will be disappointed if you are looking for download charts/graphs, rating graphic breakdowns, etc. With the exception of the Star Rating option, this plugin basically returns the raw data from the WordPress.org API. Styling is up to you.
Support This Plugin
There are a few ways you can help support the development of this plugin:
Rate the plugin on WordPress.org.
If you spot an error or bug, please let us know in the support forums. The issue will be diagnosed, and a new release will be pushed out as soon as possible.
The easiest way is to click the new plugin stat icon that is added to the top bar of your WordPress editor. It looks like the standard WordPress plugin icon. This will launch a popup window where you can then choose your settings and enter in the desired plugin slug(s). Click insert, and the generated shortcode will be added to your editor’s content field.
Manual Method
If you don’t want to bother with the popup window or what to use the shortcode outside the editor, you can manually type out the shortcode. Below is the base shortcode structure with defaults. Technically, “slug” is the only required field. If you enter your plugin’s slug, the shortcode will display the number of active installs and cache the data for 43200 seconds (12 hours).
Optional. The type of stat you wish to display, either a stat from a single plugin or an aggregate stat generated from multiple plugins. Accepts “single” or “aggregate”. Defaults to “single”.
slug
Required. This is the plugin slug that will be retrieved from the plugin URL on WordPress.org. For example, this plugin’s slug is easy-plugin-stats. Accepts any valid plugin slug for “single” or any number of space-separated plugin slugs when using “aggregate”. Defaults to null.
field
Optional. The name of the field you have chosen to display. Accepts any of the following fields. Defaults to “active_installs”.
The available stat fields for “single” are:
active_installs (Active Installs)
downloaded (Times Downloaded)
name (Plugin Name)
slug (Plugin Slug)
version (Version)
author (Author)
author_profile (Author Profile Link)
contributors (Contributors)
requires (Requires)
tested (Tested)
rating (Rating out of 100)
five_rating (Rating out of 5)
star_rating (Star Rating)
num_ratings (Number of Reviews)
last_updated (Last Updated)
added (Date Added)
homepage (Plugin Homepage Link)
short_description (Short Description)
description (Description)
installation (Installation)
screenshots (Screenshots)
changelog (Change Log)
faq (FAQ)
download_link (Download Link)
support_link (Support Link)
tags (Tags)
donate_link (Donate Link)
The available stat fields for “aggregate” are:
active_installs (Active Installs)
downloaded (Times Downloaded)
cache
Optional. The shortcode requests your plugin’s stats from WordPress.org. To limit the number of requests made, response data is cached. This optional setting allows you to adjust the cache time as you see fit. Accepts any positive integer (representing seconds) greater than 5. Defaults to “43200” (12 hours).
before
Optional. Optional HTML to be printed before the field’s output. Accepts any valid HTML, but note that all double quotes will be replaced with single quotes to adhere to the required shortcode markup. Defaults to null.
after
Optional. Optional HTML to be printed after the field’s output. Accepts any valid HTML, but note that all double quotes will be replaced with single quotes to adhere to the required shortcode markup. Defaults to null.
Where do I go to get more help?
If you have additional questions or would like to request additional features, please let me know in the plugin support forum.
