Description
Easily display stats associated with plugins hosted on WordPress.org, such as the number of downloads, active installations, star rating, and more.
This plugin was designed for developers with plugins in the WordPress.org repository (and anyone else) who want to display their plugin information on an external site. It uses the WordPress Plugins API to fetch the raw data, which can then be inserted into a page or post using a custom block, a Button block variation, or a shortcode. You can display stats from a single plugin, or aggregate stats from multiple plugins.
Available stats
Nearly all of the fields returned by the WordPress.org Plugins API are available, as well as a few extra options. There are currently 28 to choose from.
Single stats
- Active installs
- Times downloaded
- Plugin name
- Plugin slug
- Version
- Author
- Contributors
- Tags
- Requires
- Tested
- Number of reviews
- Rating out of 100
- Rating out of 5
- Star rating
- Last updated
- Date added
- Plugin homepage link
- Download link
- Live preview link
- Support forum link
- Reviews link
- Author profile link
- Donate link
- Description (Shortcode only)
- Installation (Shortcode only)
- Screenshots (Shortcode only)
- Changelog (Shortcode only)
- FAQ (Shortcode only)
Aggregate stats
Display combined stats from multiple plugins.
- Active installs
- Times downloaded
Stay connected
Captures d’écran
Blocs
Cette extension fournit 1 bloc.
- Plugin Stat Display a stat associated with a plugin hosted on WordPress.org.
Installation
- You have a couple of options:
- Go to Plugins → Add New and search for « Easy Plugin Stats ». Once found, click « Install ».
- Download the Easy Plugin Stats from WordPress.org and make sure the folder is zipped. Then upload via Plugins → Add New → Upload.
- Activate the plugin through the ‘Plugins’ screen in WordPress.
- Search for the block within the Block Editor (Gutenberg) and begin using it. See the FAQs for additional usage information.
FAQ
-
How do I use the Plugin Stat block?
-
Search for « Plugin Stat » in the block inserter and add it to a post just like you would any other block. In the inspector, enter the plugin slug and choose the stat you wish to display.
The slug can be retrieved from the plugin’s URL on WordPress.org. For example, this plugin’s slug is
easy-plugin-stats
. -
Insert a WordPress Buttons block, then click on the
+
inserter or open the block inserter. Besides the default Button block, you’ll see the Plugin Button variation. Insert the Plugin Button into the Buttons block. In the inspector, enter the plugin slug and choose the link you wish to connect to the button.The slug can be retrieved from the plugin’s URL on WordPress.org. For example, this plugin’s slug is
easy-plugin-stats
. -
How do I use the shortcode?
-
Below is the base shortcode structure with defaults. Technically,
slug
is the only required field. If you enter your plugin’s slug and place the shortcode in a post or template, it will display the number of active installs and cache the data for43200
seconds (12 hours).`
[eps type= »single » slug= »your-plugin-slug » field= »active_installs » cache= »43200″ before= » » after= » »]
`type
Optional. The type of stat you with to display, either a stat from a single plugin or an aggregate stat generated from multiple plugins. Accepts
single
oraggregate
. Defaults tosingle
.slug
Required. This is the slug which can be retrieved from the plugin’s URL on WordPress.org. For example, this plugin’s slug is
easy-plugin-stats
. Accepts any valid plugin slug forsingle
, or any number of space-separated plugin slugs when usingaggregate
. Defaults tonull
.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 installsdownloaded
– Times downloadedname
– Plugin Nameslug
– Plugin Slugversion
– Versionauthor
– Authorcontributors
– Contributorstags
– Tagsrequires
– Requirestested
– Testednum_ratings
– Number of reviewsrating
– Rating out of 100five_rating
– Rating out of 5star_rating
– Star ratinglast_updated
– Last updatedadded
– Date addedhomepage_link
– Plugin homepage linkdownload_link
– Download linklive_preview_link
– Live preview linksupport_link
– Support forum linkreviews_link
– Reviews linkauthor_profile
– Author profile linkdonate_link
– Donate linkdescription
– Descriptioninstallation
– Installationscreenshots
– Screenshotschangelog
– Changelogfaq
– FAQ
The available stat fields for
aggregate
are:active_installs
– Active installsdownloaded
– 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 to43200
(i.e. 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
.
Avis
Contributeurs/contributrices & développeurs/développeuses
« Easy Plugin Stats » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
ContributeursTraduisez « Easy Plugin Stats » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Journal
2.0.1
Fixed
- Fix bug where an incorrectly set field type in the
eps
shortcode generated a critical error on the front end.
2.0.0
Added
- Add the Plugin Stat block.
- Add the Plugin Button block variation for the Button block.
- Add Playground blueprint for live plugin preview.
Changed
- The minimum required version is now WordPress 6.5. The plugin now uses the Block Bindings API, which was introduced in 6.5.
- The TinyMCE plugin has been removed. Shortcodes still work but have to be created manually.
- Star ratings are now SVGs, and the Dashicons have been removed.
1.0.0
- Initial Release