Category: Tools

Stats for Update Manager

Simone Fioravanti

Discover how many sites are using your plugins and themes! This is a companion plugin for Update Manager. With Stats for Update Manager you ...

Download

More Info
Discover how many sites are using your plugins and themes!

This is a companion plugin for Update Manager.

With Stats for Update Manager you can count active installations of your plugins and themes that serve updates with Update Manager.

You’ll find a new submenu, Statistics, under the Update Manager menu.

It’s compatible with Update Manager versions 1.x and 2.x.

It supports WP-CLI. See the help typing:
- wp help statistics show
- wp help statistics purge
- wp help statistics delete
When a plugin/theme is in that count

Plugins and themes that queried Update Manager at least once in the last week are considered active. When a plugin/theme have not queried Update Manager in the last 4 week it’s removed from the database table. See filters section to tweak.

It also add the number of active installations in the plugin details. See filters section to tweak.

You can reset the count using the Reset row action.

Disclaimers

This plugin is intended to be used by developers.

Filters

Change/hide the number of active installations in plugin info tab

sfum_active_installations let’s you change/hide the number displayed in the details of your plugins.

Examples:

add_filter('sfum_active_installations', 'example_filter');

Don’t show active installation for my nothing-to-see plugin and raise it to one million for boost!
function example_filter($ar){ unset ($ar['nothing-to-see/nothing-to-see.php']); $ar['boost/boost.php'] = 1000000; return $ar; }
Or simply disable it all
function example_filter($ar){ return []; }
Note: the real number is cached for 6 hours.

Add opt-in or opt-out for your plugin users

Supported by Update Manager Client since 2.3.0. Note: this filter is from Update Manager, not from Stats for Update Manager.
codepotent_update_manager_filter_{$slug}_client_request let’s you inject data in the request made by UpdateClient.class.php.

Example:
add_filter('codepotent_update_manager_filter_my-slug/my-slug.php_client_request', 'example_filter'); function example_filter($body){ if( 'no' === get_option( 'my-slug-usage-statistics' ) ) { $body['sfum'] = 'no-log'; } return $body; }
Recognize your own sites in debug

Note that debug information is displayed only if WP_DEBUG is set to true.

sfum_my_sites let’s you recognize your own sites. They will be marked with an * in the debug informations.
With this filter you can populate an array of sha512-hashed urls.
Example:
add_filter('sfum_my_sites', 'all_my_sites'); function all_my_sites($sha) { $mysites = [ 'https://my-first-site.dog', 'https://www.my-second-site.dog' ]; $myhashes = array_map(function($value){ return hash('sha512', $value); }, $mysites); return $myhashes; }
Configure the timing a plugin/theme is considered active or stale

sfum_inactive_after let’s you configure the number of days before a plugin/theme installation is considered inactive.

sfum_old_after let’s you configure the number of days before a plugin/theme installation is considered stale and will be removed from the database.

Example:
// An entry is old after 2 days and will be removed after 7 add_filter('sfum_inactive_after', 'return_two'); add_filter('sfum_old_after', 'return_seven'); function return_two($days) { return 2; } function return_seven($days) { return 7; }
Note that filtering sfum_old_after to 0 will erase your database when the daily maintenence cronjob is executed.

Prevent specific(s) plugin(s)/theme(s) to be logged

sfum_exclude let’s you configure an array of identifier that are excluded from logging.

Note: this don’t clean your database from already logged ones.

Example:
// Don't log those plugins add_filter('sfum_exclude', 'no_log_please'); function no_log_please($list) { $excluded = [ 'please-dont/log-me.php', 'excluded-plugin/excluded-plugin.php', 'my-theme-slug' ]; return $excluded; }
Shortcodes

[sfum-installs]

The above shortcode returns an integer depicting the total number of all installations (of all plugins and themes) across the web. Developers can use it in a sentence:

Our plugins have [n] active installations!

[sfum-installs id=”my-plugin-folder/my-plugin-file.php”]

Building on the previous example, you can also provide a plugin or theme id. This shortcode returns an integer depicting the total number of installs for the plugin or theme with the given identifier. Developers can use it in a sentence:

My Awesome Plugin has [n] active installations!

My Amazing Theme has [n] active installations!

[sfum-domains]

This shortcode returns an integer depicting the number of unique domains using all of the developer’s plugins. Developers can use it in a sentence:

Code Potent is running on [n] sites!

REST API

To get a list of endpoint identifier and active installations you can access wp-json/stats/v1/stats/.
To enable this, add to wp-config.php this line:
define( 'SFUM_ENABLE_REST', true );
Note that the value of active installation is affected by the filter sfum_active_installations.

GDPR / privacy

This plugin stores data about plugin/theme updates in a table.
You can configure how much time this data is kept using sfum_old_after filter (defaults to 4 weeks).
All the data is removed at plugin uninstall.
- URL of the site asking for updates, sha512 hashed
- plugin/theme checked
- timestamp of the last check
Is up to you to decide if and to inform your plugin/theme users that this data is kept.

To help us know the number of active installations of this (Stats for Update Manager) plugin, we collect and store anonymized data when the plugin check in for updates. The date and unique plugin identifier are stored as plain text and the requesting URL is stored as a non-reversible hashed value. This data is stored for up to 28 days.

To skip Stats for Update Manager from logging, the plugin/theme have to ask for updates defining, in the body of the request done by UpdateClient, $body['sfum']='no-log'.
Since version 2.3.0 of Update Manager client this can be done using a filter.

Screenshot
Add Twitter Cards

azurecurve

Description Add Twitter Cards to attach rich photos to Tweets, helping to drive traffic to your website. Options allow: Card Types of Summary or ...

Download

More Info
Add Twitter Cards to attach rich photos to Tweets, helping to drive traffic to your website.

Options allow:
- Card Types of Summary or Summary With Images.
- Excerpt or first 200 characters of post added to card.
- Featured Image or first post image will be added to card (subject to configurable minimum size).
- Integrate with Floating Featured Images for card image.
This plugin is multisite compatible; each site will need settings to be configured in the admin dashboard.

Installation
- Download the latest release of the plugin from GitHub.
- Upload the entire zip file using the Plugins upload function in your ClassicPress admin panel.
- Activate the plugin.
- Configure relevant settings via the configuration page in the admin control panel (azurecurve menu).
Frequently Asked Questions

Can I translate this plugin?

Yes, the .pot file is in the plugins languages folder; if you do translate this plugin, please sent the .po and .mo files to [email protected] for inclusion in the next version (full credit will be given).

Is this plugin compatible with both WordPress and ClassicPress?

This plugin is developed for ClassicPress, but will likely work on WordPress.

Changelog

Version 2.0.2
- Update readme file for compatibility with ClassicPress Directory.
Version 2.0.1
- Fix Update Manager View Details link (contributed by xxsimoxx).
Version 2.0.0
- Refactor code to use namespace, improve security and improve maintainability.
- Update language template.
- Update Update Manager to version 2.4.3.
Version 1.4.3
- Update readme files.
- Update language template.
- Fix bug with azurecurve menu.
Version 1.4.2
- Update azurecurve menu.
- Update readme files.
Version 1.4.1
- Update azurecurve logo.
Version 1.4.0
- Add option to use featured image if one set, otherwise use existing functionality.
- Fix bug with missing minimum image size check.
- Fix bug with population of default options causing whitescreen.
- Disable Use FFI option if Floating Featured Image by azurecurve is not installed and active.
Version 1.3.4
- Fix bug with missing default options.
- Update azurecurve menu.
Version 1.3.3
- Fix bug with population of default options.
Version 1.3.2
- Fix bug with incorrect language domain.
- Update azurecurve plugin menu.
Version 1.3.1
- Remove unnecessary code from azrcrv_atc_get_option function.
Version 1.3.0
- Fix plugin action link to use admin_url() function.
- Rewrite option handling so defaults not stored in database on plugin initialisation.
- Add plugin icon and banner.
- Update azurecurve plugin menu.
Version 1.2.0
- Add plugin icon and banner.
- Add minimum dimensions for Twitter card image.
Version 1.1.5
- Fix bug with empty post array when getting twitter name.
- Check size of image greater than 100px and search for next; if none found use fallback image.
- Add unique id to Twitter card images as Twitter only allows one card to use a specific image.
Version 1.1.4
- Fix bug with setting of default options.
- Fix bug with plugin menu.
- Update plugin menu css.
- Extend length of Twitter Username field.
Version 1.1.3
- Fix call of deprectaed get_usermeta to use get_user_meta.
- Fix bug which prevented fall back image.
- Rewrite default option creation function to resolve several bugs.
- Upgrade azurecurve plugin to store available plugins in options.
Version 1.1.2
- Update Update Manager class to v2.0.0.
- Update action link.
- Update azurecurve menu icon with compressed image.
Version 1.1.1
- Fix bug with incorrect language load text domain.
Version 1.1.0
- Add integration with Update Manager for automatic updates.
- Fix issue with display of azurecurve menu.
- Change settings page heading.
- Add load_plugin_textdomain to handle translations.
Version 1.0.3
- Fix bug with selection of image.
Version 1.0.2
- Fix bug with Twitter Card on non-singular pages.
- Fix bug with text domain on addition of menu and rebuild pot.
Version 1.0.1
- Update azurecurve menu for easier maintenance.
- Move require of azurecurve menu below security check.
Version 1.0.0
- Initial release; idea and some code from Code Potent.
Other Notes

azurecurve was one of the first plugin developers to start developing for ClassicPress; all plugins are available from azurecurve Development and are integrated with the Update Manager plugin for fully integrated, no hassle, updates.

The other plugins available from azurecurve are:
- Add Open Graph Tags – details / download
- Avatars – details / download
- BBCode – [details](https://development.a
Add Open Graph Tags

azurecurve

Add Open Graph Tags plugin for ClassicPress

Download

More Info
Add Open Graph Tags to attach rich photos to social media posts to Facebook or LinkedIn, helping to drive traffic to your website.

Options allow:
- Excerpt or first 200 characters of post added to card.
- Featured Image or first post image will be added to card.
- Integrate with Floating Featured Images for card image.
This plugin is multisite compatible; each site will need settings to be configured in the admin dashboard.

Installation
- Download the latest release of the plugin from GitHub.
- Upload the entire zip file using the Plugins upload function in your ClassicPress admin panel.
- Activate the plugin.
- Configure relevant settings via the configuration page in the admin control panel (azurecurve menu).
Frequently Asked Questions

Can I translate this plugin?

Yes, the .pot file is in the plugins languages folder; if you do translate this plugin, please sent the .po and .mo files to [email protected] for inclusion in the next version (full credit will be given).

Is this plugin compatible with both WordPress and ClassicPress?

This plugin is developed for ClassicPress, but will likely work on WordPress.

Changelog

Version 2.0.3
- Update plugin header and readme yet again for compatibility with ClassicPress Directory.
Version 2.0.3
- Update plugin header and readme for compatibility with ClassicPress Directory v2.
- Update Update Manager to version 2.5.0.
Version 2.0.2
- Update readme file for compatibility with ClassicPress Directory.
Version 2.0.1
- Fix Update Manager View Details link (contributed by xxsimoxx).
Version 2.0.0
- Refactor code to use namespace, improve security and improve maintainability.
- Update language template.
- Update Update Manager to version 2.4.3.
Version 1.4.3
- Update readme files.
- Update language template.
- Fix bug with azurecurve menu.
Version 1.4.2
- Update azurecurve menu.
- Update readme files.
Version 1.4.1
- Update azurecurve logo.
Version 1.4.0
- Add option to use featured image if one set, otherwise use existing functionality.
- Fix bug with minimum image size check not using options.
- Fix bug with population of default options causing whitescreen.
- Disable Use FFI option if Floating Featured Image by azurecurve is not installed and active.
Version 1.3.4
- Fix bug with call to non-existant function
- Fix bug when no image found and no default set.
- Update azurecurve menu.
Version 1.3.3
- Fix bug with getfilesize call.
- Fix bug with population of default options.
Version 1.3.2
- Fix bug with population of default options.
- Update azurecurve plugin menu.
Version 1.3.1
- Remove unnecessary code from azrcrv_aogt_get_option function.
Version 1.3.0
- Fix plugin action link to use admin_url() function.
- Rewrite option handling so defaults not stored in database on plugin initialisation.
Version 1.2.1
- Fix bug with incorrect image variable.
Version 1.2.0
- Add plugin icon and banner.
- Add minimum dimensions for open graph tags image.
Version 1.1.5
- Check size of image greater than 100px and search for next; if none found use fallback image.
Version 1.1.4
- Fix bug with setting of default options.
- Fix bug with plugin menu.
- Update plugin menu css.
- Fix bug with call to atc function.
Version 1.1.3
- Fix bug which prevented fall back image.
- Rewrite default option creation function to resolve several bugs.
- Upgrade azurecurve plugin to store available plugins in options.
Version 1.1.2
- Update Update Manager class to v2.0.0.
- Update action link.
- Update azurecurve menu icon with compressed image.
Version 1.1.1
- Fix bug with incorrect language load text domain.
Version 1.1.0
- Add integration with Update Manager for automatic updates.
- Fix issue with display of azurecurve menu.
- Change settings page heading.
- Add load_plugin_textdomain to handle translations.
Version 1.0.1
- Add integration with Update Manager for automatic updates.
- Fix issue with display of azurecurve menu.
- Change settings page heading.
Version 1.0.0
- Initial release.
Other Notes

azurecurve was one of the first plugin developers to start developing for ClassicPress; all plugins are available from azurecurve Development and are integrated with the Update Manager plugin for fully integrated, no hassle, updates.

The other plugins available from azurecurve are:
- Add Twitter Cards – details / download
- Avatars – details / download
- BBCode – details / download
- Breadcrumbs – details / download
- Call-out Boxes – details / download
- Check Plugin Status – details / [download](https://github.com/azurecurve/azrcrv-check-plugin-stat