Plugin Stats provides a shortcode, template function, and dashboard widget which graphs the downloads completed for plugins hosted at WordPress.org.
There's no Options/Settings panel for Plugin Stats. Instead, configuration is done using the template function, shortcode, or dashboard widget and with filters.
Plugin Stats provides a template function to allow you to display a stats graph in your site template. Actually, it's an action, but it can be used the same way as a normal template function. Here's a sample usage:
<?php do_action('plugin-stats', 'wp-crontrol') ?>
This would display a 360x100 graph of the past 180 days of plugin downloads for the plugin
<?php do_action('plugin-stats', 'wp-crontrol', '360x100', true) ?>
This displays a 360x100 graph of the past 180 days linked to the plugin stats page on WordPress.org.
A shortcode is also available for usage in posts and pages. It has the same options as the template function. Here are a few self-explanatory examples:
[plugin-stats slugname="wp-crontrol" size="360x100" addlink="1"] [plugin-stats slugname="wp-crontrol" size="100x100" addlink="0"] [plugin-stats slugname="wp-crontrol"]
The dashboard widget allows you to enter a number of plugin slugs and have the graphs for all of them displayed in a widget on your dashboard.
There are a number of other configuration parameters that can be set using the WordPress filter system.
plugin-stats_build-link: Whether or not a new link will be built. By default, a new link is built each time new stats are available or a new image size is requested. This has the consequence that if you have two plugin-stats graphs on one page with different parameters (see below), the second one won't be generated. To fix this, hook onto the
plugin-stats_build-link filter and return
true to force a new link.
plugin-stats_num-days: This is the number of days that should be included in the graph. The default and upper limit is 180.
plugin-stats_img-link-args: An associative array of parameters that will be sent to the Google Charts API to generate the graph. Use this configuration value to change colors or add additional decoration to the graph.
plugin-stats_img-link: The finished
img tag that is returned.
plugin-stats_cache-time: The number of seconds to cache the downloaded statistics. Defaults to 600 (10 minutes).