Plugins
0

WP Plugin Repo Stats

LICENSE TYPE: INFINITE

Description

Are you a WordPress plugin developer who wants to show off how many plugins you have in the repo and how many times theyve been downloaded? Then look no further.

This plugin lists all of the plugins you have made available on wordpress.org. Using a shortcode on posts or pages, it creates a table listing each plugin and how many downloads it has, as well as the plugin rating.

Disclaimer: This plugin is not affiliated with or endorsed by WordPress.

If you need help with this plugin

If this plugin breaks your site or just flat out does not work, please go to Compatibility and click Broken after verifying your WordPress version and the version of the plugin you are using.

Then, create a thread in the Support forum with a description of the issue. Make sure you are using the latest version of WordPress and the plugin before reporting issues, to be sure that the issue is with the current version and not with an older version where the issue may have already been fixed.

Please do not use the Reviews section to report issues or request new features.

Features

  • Display your plugin stats on any post or page
  • Works with most browsers, but degrades nicely in older browsers
  • CSS only loads on pages with shortcode or function call
  • Includes star rating for each plugin (optional)
  • Show download info for only one plugin (as of 0.2.5)

Inspired by http://www.viper007bond.com/wordpress-plugins/wordpress-download-counter/ and modeled after http://lesterchan.net/portfolio/programming/php/

Shortcode

To display on any post or page, use this shortcode:

[plugin-repo-stats]

Make sure you go to the plugin settings page after installing to set options.

If you use and enjoy this plugin, please rate it and click the Works button below so others know that it works with the latest version of WordPress.

Screenshots

Installation

  1. Upload plugin through the WordPress interface.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Go to Settings WordPress Plugin Repo Stats and configure the plugin.
  4. Insert shortcode on posts or pages, or call PHP function from functions.php or another plugin.

To remove this plugin, go to the Plugins menu in WordPress, find the plugin in the listing and click Deactivate. After the page refreshes, find the plugin again in the listing and click Delete.

FAQ

The plugin arguments and default values may change over time. To get the latest list of arguments and defaults, look at the settings page after installing the plugin.

Use a shortcode to call the plugin from any page or post like this:

[plugin-repo-stats] 

This will:

  • fetch the download counts for a given wordpress.org profile ID (which you put in the plugins Settings page, right?)
  • add rel=nofollow to each link
  • use rounded corner CSS
  • cache the plugin output for one hour (3600 seconds = 60 seconds * 60 minutes * 1 hour)
  • include plugin star rating images
  • links open in same window

Your wordpress.org profile ID is your login on wordpress.org. You must include this or the plugin will do nothing.

You can also call the plugin in your functions.php, ex:

if (function_exists('wpprs')) {   wpprs(array('uid' => 'your userid', 'show' => true)); } 

Always wrap plugin function calls with a function_exists check so that your site doesnt go down if the plugin isnt active.

The output contains extensive CSS classes you can target in your style.css. You can style alternating rows and style each table column separately. View the output source to see the table CSS structure, or browse the plugins css folder. The CSS to duplicate the screenshot is included in the plugin. You will need to override this if you want to see something different.

Clear your browser cache and also clear your cache plugin (if any). If you still dont see anything, check your webpage source for the following:

 

This means you didnt pass a necessary setting to the plugin, so it disabled itself. You need to pass at least the wordpress.org userid, either by entering it on the settings page or passing it to the plugin in the shortcode or PHP function. You should also check that the enabled checkbox on the plugin settings page is checked. If this box is unchecked, the plugin will do nothing even if you pass your userid.

The plugin output is cached (using WP 3.5+ transients) to avoid overtaxing the wordpress.org website with excessive scraping requests. Excessive scraping may result in an IP ban, which would cause denial of service. Wait until the cache expires, then reload the page to view your settings changes.

Even if you specify a very low cache time (ex: 60 seconds), the plugin will only re-fetch content every 5 minutes. Please do not edit the plugin to change this.
Unless the download count is very low, it is highly unlikely that any given plugin is downloaded so often that someone visiting a page after five minutes would actually notice how many more downloads it has.

You might also consider clearing your browser cache and your caching plugin.

Are you using a plugin that minifies CSS? If so, try excluding the plugin CSS file from minification.

The CSS files include a ?ver query parameter. This parameter is incremented with every upgrade in order to bust caches. Make sure none of your plugins or functions are stripping this query parameter. Also, if you are using a CDN, flush it or send an invalidation request for the plugin CSS files so that the edge servers request a new copy of it.

The cache is userid-dependent and site-wide. You cannot specify different cache times for the same userid concurrently the first shortcode or function call that is made on an empty cache will set the cache time. Ideally you are only displaying the output of this plugin once on your site.

WP Plugin Repo Stats has to visit a given users wordpress.org profile page, then (if requested) visit each plugins page and parse it for the plugins rating. This is time consuming and totally dependent on wordpress.orgs network availability. If a given user has a large amount of plugins in the repo, it could take a relatively significant amount of time to fetch each page. To optimize the plugins operation, the star rating is left blank if there is a page error on wordpress.org (no stars).

To speed up the plugin operation, increase the cache time and (if possible) do not request plugin star ratings (uncheck Show plugin ratings? on the plugin settings page). The default cache time is 12 hours and I recommend you leave it that way to avoid burdening wordpress.org.

Add this to your functions.php:

remove_action('admin_print_footer_scripts', 'add_wpprs_quicktag'); 

Add this to your functions.php:

remove_action('admin_head', 'insert_wpprs_admin_css'); 

Add this to your functions.php:

add_action('wp_enqueue_scripts', 'remove_wpprs_style'); function remove_wpprs_style() {   wp_deregister_style('wpprs_style'); } 

This plugin adds one or more toolbar buttons to the HTML editor. You will not see them on the Visual editor.

The label on the toolbar button is Plugin Repo Stats.

Use the pluginname parameter like this:

[plugin-repo-stats pluginname="Name of your plugin"] 

This will output a small box with a link to the plugin page on wordpress.org, the date, the download count and the plugin rating (if checked on the plugin settings page).

On the plugin settings page, go to the Parameters tab. There is a list of possible parameters there along with the default values. Make sure you are spelling the parameters correctly.

The Parameters tab also contains sample shortcode and PHP code.

Leave a Reply

Your email address will not be published.

Fill out this field
Fill out this field
Please enter a valid email address.
You need to agree with the terms to proceed

Most Viewed Posts
Menu