Description
Nahnu Install Tracker keeps your plugin numbers up to date on your own site. Add a WordPress.org slug or a GitHub URL, copy the shortcode, and paste it into any page, heading, widget, or page builder text field.
It is built for plugin developers who want “Active installs: 10,000+” or “Version 2.1.4” on their website without updating it by hand.
This plugin is a service that relies on external APIs. To get your numbers, it reads public data from the WordPress.org Plugins API (api.wordpress.org), and, only if you add such sources, from the GitHub REST API (api.github.com) and the SureCart API (api.surecart.com). No account or API key is needed for WordPress.org or GitHub; SureCart sources use your own store token and license details. It never loads scripts, styles, images, or fonts from other servers; every file it uses is bundled in the plugin. See “External services” below for exactly what is sent and when.
100% free. Every feature is included. Nothing is locked, there is no account to create, and nothing about your site is tracked.
What it tracks
- Active installs from WordPress.org, shown the same way WordPress.org shows them (e.g. 10,000+ or Fewer than 10), per plugin or combined across all of them
- Downloads, star rating, and review count from WordPress.org
- Current version, “tested up to” version, and last updated date from WordPress.org
- Release version and stars from GitHub, from the latest release or a JSON file in your repository
- Current release version of your SureCart products
- Active installs of your SureCart products: every activation on every license, added up (on the site that runs your SureCart store)
- Manual versions you type in yourself, for anything else
Shortcodes
Every shortcode prints only the value, with no words or HTML around it. You write the text yourself, in any language, and place the shortcode where the number belongs. For example: Trusted on [nahnu_total_installs] sites.
WordPress.org (use the plugin slug):
[nahnu_installs slug="your-plugin"]active installs, e.g.10,000+orFewer than 10[nahnu_total_installs]active installs of every plugin on your Install Tracker list added up, e.g.50,000+(limit it withslugs="plugin-a,plugin-b")[nahnu_downloads slug="your-plugin"]total downloads, e.g.9,400[nahnu_rating slug="your-plugin"]star rating out of 5, e.g.4.9[nahnu_reviews slug="your-plugin"]number of ratings, e.g.37[nahnu_wp_version slug="your-plugin"]current version, e.g.2.1.4[nahnu_tested slug="your-plugin"]latest WordPress version it is tested with, e.g.7.0[nahnu_last_updated slug="your-plugin"]date of the last release in your site date format, e.g.July 1, 2026(change it withformat="M Y")
GitHub, SureCart and manual entries (use the label you gave the source, in lowercase with hyphens):
[nahnu_gh_version id="your-label"]GitHub version exactly as published, e.g.v1.2.3[nahnu_gh_stars id="your-label"]stars on the repository, e.g.128[nahnu_sc_version id="your-label"]current release version of a SureCart product, e.g.3.4.0[nahnu_sc_installs id="your-product"]active installs of a SureCart product, e.g.1,284(addround="true"for1,000+)[nahnu_sc_total_installs]active installs of every tracked SureCart product added up, e.g.3,950[nahnu_total_installs surecart="true"]WordPress.org and SureCart installs added up, e.g.50,000+[nahnu_manual_version id="your-label"]a version you typed in, e.g.2.0.1
Because the output is plain text, it fits inside headings, buttons, and page builder fields, and it is easy to translate. The settings screen shows a ready-to-copy shortcode for every plugin you track.
How it stays fast
Data is fetched in the background on a schedule you choose (every 1, 6, 12, or 24 hours) and saved in your database. Shortcodes read from the saved data, so visitors never wait on an outside request. You can also fetch everything right away with the Refresh now button.
Features
- Clean tabbed settings screen: Install Tracker, SureCart Installs, WP.org Version, GitHub Version, SureCart Version, Manual Version, Fetch Settings, More Plugins, and About
- Paste plain slugs or full wordpress.org/plugins/ URLs
- Install change since the previous fetch, total downloads, rating, and review count
- Combined install total across all your plugins
- Copy button next to every shortcode
- Keeps the last good value if a fetch fails, so your site never shows a blank
- Translation ready
External services
This plugin is a service that reads public data about plugins and GitHub repositories so you can display it on your site. It does not load any scripts, styles, images, or fonts from other servers. Every file it uses is included in the plugin.
To do its job, it connects to the services below. Connections happen only during the scheduled background fetch (every 1, 6, 12, or 24 hours, your choice) or when an administrator saves settings or clicks Refresh now. Shortcodes only read data already saved in your database, so site visitors never cause a connection. No account, API key, or sign-up is needed for WordPress.org or GitHub.
WordPress.org Plugins API
- What it is: the public API WordPress itself uses to show plugin details under Plugins > Add New.
- Server called: api.wordpress.org, through WordPress’s built-in
plugins_api()function. - What is sent: the plugin slugs you enter on the Install Tracker and WP.org Version tabs. As with every Plugins > Add New lookup, WordPress also includes your site address and WordPress version in the request header.
- What it is used for: active installs, downloads, rating, number of ratings, version, “tested up to” version, and last updated date.
- Service: https://wordpress.org/
- Privacy policy: https://wordpress.org/about/privacy/
GitHub
- What it is: the public GitHub REST API.
- Server called: api.github.com only, over HTTPS.
- What is sent: requests for the repositories you add on the GitHub Version tab: the latest release, the JSON file you name (through the repository contents endpoint), and the repository’s public details to read its star count. Nothing about your site or its visitors is sent.
- What it is used for: the version number and star count of each source you add.
- No account or token is needed for public repositories.
- Terms of service: https://github.com/site/terms
- Privacy policy: https://github.com/site/privacy
SureCart
Only used if you add products on the SureCart Version tab. SureCart has no public version feed, so the plugin reads a product’s current release the same way the SureCart licensing SDK does.
- What it is: the SureCart public API.
- Server called: api.surecart.com only, over HTTPS.
- When you save a new license key: the plugin reads the license and activates it once. The activation request sends the license, your site address (with “?nahnu-install-tracker=1” added so it is told apart from the product itself) and the name “Nahnu Install Tracker on” plus your site name, so you can recognise it in SureCart.
- On each fetch: a request for that license’s current release, with the license key and its activation ID.
- When you remove a product or change its key: the activation the plugin created is deleted, freeing the slot.
- Every request carries your store’s public token. Nothing about your visitors is sent.
- What it is used for: the product’s current release version.
- Credentials: your own SureCart public token and license keys, created in your SureCart account. They are stored in your WordPress database as plugin settings and sent only to api.surecart.com.
SureCart Installs tab: install counts are read through the SureCart plugin on the same site, with the connection SureCart already has to your store. This plugin makes no request of its own for them, stores no SureCart secret, and sends nothing extra. SureCart reads your products and licenses from its servers as it always does.
* Terms of service: https://surecart.com/terms-and-conditions/
* Privacy policy: https://surecart.com/privacy-policy/
Installation
- Install from Plugins > Add New, or upload the
nahnu-install-trackerfolder to/wp-content/plugins/. - Activate the plugin.
- Go to Settings > Install Tracker.
- Add your plugin slugs or GitHub URLs and click Save and fetch.
- Copy a shortcode from the table and paste it anywhere on your site.
FAQ
Is it really free?
Yes. Every feature is included and nothing is locked. There is no account or sign-up.
Why do the shortcodes print only a number?
So you can write the text around it yourself, in your own words and language. For example Trusted on [nahnu_total_installs] sites or Más de [nahnu_installs slug="my-plugin"] instalaciones activas.
How is the combined total worked out?
It adds up the active installs of every plugin on your Install Tracker list. Each count is already rounded down by WordPress.org, so the total is a minimum too.
Do the shortcodes slow down my pages?
No. Shortcodes only read data that is already saved in your database.
Why does my plugin show “Fewer than 10”?
WordPress.org reports 0 active installs for any plugin with fewer than 10. The plugin shows “Fewer than 10”, the same wording WordPress.org uses.
My shortcode prints nothing. Why?
The slug has not been added yet, or it has not been fetched. Add the slug on the Install Tracker or WP.org Version tab and click Save and fetch. Shortcodes print nothing rather than an error, so your pages never show a broken message.
Which GitHub sources are supported?
Public repositories. Enter the repository as owner/repo or paste its GitHub link, then choose:
- Latest release: leave the JSON file field empty. The version is the tag of the latest release.
- JSON file: enter the path of a JSON file in the repository, such as version.json, and the key that holds the version (default
version). Branch is optional; the default branch is used when it is empty.
Pasting a github.com link to the file fills in the path and branch for you.
How do I set up a SureCart product?
- Sign in to app.surecart.com, open API in the sidebar and copy the public token (never the secret token). Enter it once on the SureCart Version tab.
- In WordPress, go to SureCart > Licenses and open a license for the product that belongs to you, for example from a test purchase with a 100% off coupon. Copy its key.
- Paste the key on the tab with a label and click Save and fetch.
The plugin activates the key once, the same way a customer site would, and the version appears in the table with its shortcode. The tab has these steps too, under “How to set this up”.
What is a SureCart activation ID, and where do I find it?
When a license key is activated on a site, SureCart records an activation; its ID is what SureCart’s update system pairs with the key to hand out the current release. You do not need to find it: leave the field blank and the plugin creates the activation for you when you save. The activation appears on the license in SureCart as “Nahnu Install Tracker on” followed by your site name, and uses one activation slot. Removing the product from the tab removes that activation again.
If you already have an activation ID for the key (for example from a site where the product is activated), you can paste it into the optional field instead, and no new activation is created.
Saved keys are never shown again on the screen. Leave a field blank to keep what is saved, or type a new value to replace it.
Can it count every install of my SureCart products?
Yes. The SureCart Installs tab adds up every activation on every license of a product that is not revoked, so every customer site counts. Tick your products and click Save and fetch.
It works on the site that runs your SureCart store, with the SureCart plugin active, because counting every license needs the store’s private access. The plugin uses SureCart’s own connection for this, so you never enter a secret token. On any other site the tab explains this and stays empty.
Numbers are exact (e.g. 1,284). Add round="true" to show them the WordPress.org way (1,000+). The activation the plugin makes for the SureCart Version tab is not counted.
What is the Manual Version tab for?
For anything the plugin cannot fetch: a theme sold on your own site, a mobile app, a service. Type a label and a version, save, and use the shortcode. Update the version here when you release.
What is the shortcode id for a GitHub source?
It is your label in lowercase with hyphens, so “My Plugin” becomes my-plugin. The same rule applies to SureCart products and manual entries. The exact shortcode is shown in the table on each tab.
How often is data updated?
Every 24 hours by default. Change it to every 1, 6, or 12 hours on the Fetch Settings tab. WordPress runs scheduled jobs when your site gets a visit, so on very quiet sites a fetch can run a little late.
What is removed when I delete the plugin?
All of its settings, saved data, and scheduled jobs.
Screenshots
Changelog
1.0.2
- New SureCart Installs tab: count every activation on every license of your SureCart products, on the site that runs your store.
- New SureCart Version tab: track the current release version of your SureCart products.
- New Manual Version tab: type in versions for anything that cannot be fetched.
- New shortcodes:
[nahnu_sc_installs],[nahnu_sc_total_installs],[nahnu_sc_version]and[nahnu_manual_version]. [nahnu_total_installs surecart="true"]adds SureCart installs to the WordPress.org total.
1.0.1
- First public release.


