Easy Plugin Stats

外掛說明

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

螢幕擷圖

  • A screenshot of the Plugin Stat block in Editor, which displays the total downloads for the Easy Plugin Stats plugin.
  • A screenshot of the Plugin Button block variation in Editor, which is connected to the Easy Plugin Stats download link.
  • A screenshot of the shortcode implementation in the Editor.

適用於區塊編輯器

這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。

  • Plugin Stat Display a stat associated with a plugin hosted on WordPress.org.

安裝方式

  1. 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.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Search for the block within the Block Editor (Gutenberg) and begin using it. See the FAQs for additional usage information.

常見問題集

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.

How do I use the Plugin Button variation for the Button block?

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 for 43200 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 or aggregate. Defaults to single.

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 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
  • contributors – Contributors
  • tags – Tags
  • requires – Requires
  • tested – Tested
  • num_ratings – Number of reviews
  • rating – Rating out of 100
  • five_rating – Rating out of 5
  • star_rating – Star rating
  • last_updated – Last updated
  • added – Date added
  • homepage_link – Plugin homepage link
  • download_link – Download link
  • live_preview_link – Live preview link
  • support_link – Support forum link
  • reviews_link – Reviews link
  • author_profile – Author profile link
  • donate_link – Donate link
  • description – Description
  • installation – Installation
  • screenshots – Screenshots
  • changelog – Changelog
  • faq – FAQ

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

使用者評論

2017 年 4 月 15 日
Works really well, would be awesome to see support for Google Schema and the ability to drop individual reviews into pages which would help massively with onsite SEO, have it on 3 plugins https://optimisation.io/wordpress-plugins/ here
2017 年 1 月 15 日
Great, simple to use plugin that works perfectly. Thank you!
2016 年 9 月 3 日 1 則留言
Quick and to the point. I’m now able to display stats about my Kanban for WordPress plugin (https://KanbanWP.com ) on my homepage. Love it.
閱讀全部 3 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈Easy Plugin Stats〉的開發相關工作。

參與者

〈Easy Plugin Stats〉外掛目前已有 1 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈Easy Plugin Stats〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

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