Description
Two tools in one plugin. If you publish plugins or themes on WordPress.org, it’s a private analytics dashboard inside your own WordPress: downloads, active installs, keyword rank tracking and the competitors you choose, read every day from WordPress.org. And for any contributor, it’s a living résumé of your WordPress.org work, published on your own site.
Plugin analytics and keyword rank tracking for plugin and theme developers
Turn on the Stats tab and it becomes your own analytics dashboard: a daily record of your plugins and themes, read from the public WordPress.org APIs in the background. No account, no API key and no external service: the data is stored in your own database.
- Downloads per day, with two years of history from the first day
- Active installs, version adoption, ratings and support threads
- Language packs and the translations still in progress
- The latest reviews
- Keyword rank tracking in the WordPress.org search: add the searches people use to find each plugin or theme (up to 10 each) and follow its position every day, along with the top 10 of every search
- Tag pages: the position and page of each plugin in its tags on WordPress.org
- Alerts for what needs you: open support threads, new releases, big changes in downloads, new reviews and plugins not yet tested with the current WordPress
- Email reports for each user: a daily, weekly or monthly email, each with a summary of the period or only the alerts. Off by default, one email a day at most, and sent by your own site with no mailing service
- Email alerts when something changes: big moves in downloads, active installs moving to another range, new reviews, the average rating, more open support threads and plugins not tested with a new WordPress
- Position alerts for searches and tags: entering or leaving the top 10 or the first page, reaching number one, jumps of several places, and which plugin overtook yours
- An Alerts list in the Stats screen with every alert found, newest first and with the day each one happened, so nothing is lost when an email has to cut lines
- A page for every plugin or theme, sortable tables and charts, with the view you last used remembered in your browser
- CSV export of every view
- A dashboard widget each user sets up: which plugins or themes, which figures, the period, the order and the alerts, or one plugin against its competitors
- A quick look at the stats of any other author, up to three a day
The stats are off by default. Installs, version adoption and search positions have no public history, so they are recorded from the day you turn them on. The collection runs in the background in small batches, and public pages never wait for it.
Competitor tracking: know who you are up against
Pick the plugins and themes you compete with, or take them from suggestions drawn from your own keywords, each with the reason it is there. From that day they are read every day like yours, with two years of download history from the start.
- Head to head: active installs, downloads and their trend, rating, resolved support threads, last update and the WordPress version each one is tested with
- Keyword by keyword: where each competitor ranks in your searches and tags, and in how many of them you rank better
- One downloads chart for all of them, on a logarithmic scale or as an index where everyone starts at 100
- Your share of the top 10 of your keywords, and the opportunities it shows: abandoned plugins in your top 10, competitors behind on updates or support, and the keywords where you lead them all
- Alerts when a competitor passes you, enters your top 10, releases a version, says it is tested with a newer WordPress, moves to another installs range, gains or loses rating, gets a spike in downloads, goes months without an update or is closed on WordPress.org
- A competitors block in the email reports, a Competitors layout in the dashboard widget and a box on the page of each plugin
- Up to 10 competitors for each plugin or theme
What sets it apart
No account, no subscription and no limits tied to a plan. Your figures stay in your own database, the emails go out from your own site, and every view exports to CSV.
A contributor résumé that stays current
Whether you build plugins and themes, translate, take photos, answer support questions, contribute to core or organize events, your WordPress.org profile deserves better than a bare link. Contributor Résumé turns your contributions into a résumé you publish on your own site.
Type your WordPress.org username, check what we find, and publish your résumé page. No numeric IDs, no tokens, no code.
One block, everything about you
A single “Contributor Résumé” block (plus a [contributor_resume] shortcode) composes up to eighteen sections, each one you can turn on or off:
- Profile hero with avatar, real wordpress.org badges and your profile links (website, GitHub, Slack)
- Recent impact (contributions over 30 days, 90 days and 12 months)
- Recent activity timeline
- Events: the WordCamps and meetups you spoke at, organized or attended, with your role
- Team focus (your share across Polyglots, Support, Core, Meta…)
- Community: the teams you belong to and the languages you speak
- WordPress releases you were credited in
- Plugins and themes you published, with stats
- Favorite plugins and themes you starred on WordPress.org
- Photos from the WordPress Photo Directory (with a lightbox)
- Translations (locales, roles and project counts)
- Support forum activity
- Core credits by version
- Time commitment (hours per week)
- Bio, WordPress origin story and work history
- GitHub profile and top repositories (no token required)
Fast by design: zero HTTP requests on the front end
Your visitors never wait. All data is fetched once, cached locally as a snapshot, and refreshed in the background. A public page render performs no external requests at all, and if wordpress.org is ever slow or down, the last good data keeps showing instead of an error.
Yours to style
- Three skins: Modern, Classic (a printed-CV look) and Mono (a developer/terminal look)
- Light, dark or automatic (follows the visitor)
- Accent color (or inherit your theme’s), corner radius, shadow, grid columns, compact layout
- Animated statistics that count up as they scroll into view, and hold still when the visitor prefers reduced motion
- Drag to reorder sections; choose what each section shows (for example, how many repos or grid items)
- A live preview in the settings, with desktop and mobile views
- Fully theme-overridable templates and documented CSS variables
Good for people, search engines and AI
A well-structured, always-current contributor page is proof of your work — for readers, for search, and increasingly for AI assistants that read structured pages.
External services
Contributor Résumé builds your résumé from your own public contribution data on official WordPress.org endpoints and, optionally, GitHub. It only ever requests your public data, identified by the username(s) you configure. No visitor data is ever collected or sent, and public pages make no external requests at all: data is fetched in the background (when you run the check in the settings, on the scheduled refresh, or with WP-CLI) and then served from a local cache.
WordPress.org (operated by the WordPress Foundation)
Reads your public contributor data to build the résumé: your profile page (name, avatar, badges, impact, team focus, community teams and languages, releases, translations, favorites, hours, bio and recent activity), your profile’s public activity timeline (the profiles.wordpress.org admin-ajax endpoint, used to list the events you took part in), the Plugins and Themes directories, the Core credits API, the Photo Directory and your support-forum profile.
Only when you turn on the Stats tab, it also reads the public figures of the plugins and themes of that username, and of the competitors you choose: the Plugins and Themes directories (including the searches you add as keywords and the tag pages of your plugins), the download and version stats, the translations API and translate.wordpress.org, and the review feeds of the support forums. A quick look at another author reads the same public data for that author.
- What is sent, and when: the WordPress.org username you configure, requested from your server when the résumé is first built and when it is refreshed in the background. With the stats on, also the slugs of your plugins and themes, of the competitors you choose and the search keywords you add, once a day in the background or when you press “Collect now”, and the username you type for a quick look. As with any HTTP request, your site’s IP address is visible to the service. No data about your visitors is sent.
- When a visitor views the page, their browser loads images (your avatar, plugin and theme icons, and your photos) directly from WordPress.org and Gravatar. The Stats screen and the dashboard widget load plugin icons and theme screenshots from WordPress.org in the same way.
- Endpoints: https://profiles.wordpress.org/, https://api.wordpress.org/ (plugins, themes, core credits, stats and translations), https://translate.wordpress.org/api/, https://wordpress.org/photos/ and https://wordpress.org/support/ (including the review feeds).
- Privacy policy: https://wordpress.org/about/privacy/
Gravatar (operated by Automattic Inc.)
Your WordPress.org profile avatar is hosted by Gravatar. The plugin stores the avatar URL that already appears on your public profile and outputs it as a normal image, so a visitor’s browser loads it directly from Gravatar when viewing your résumé, the same mechanism WordPress uses to show Gravatar avatars in comments. The plugin sends no email address; the avatar is identified only by the hash already present in the public URL.
- Privacy policy: https://automattic.com/privacy/
GitHub (operated by GitHub, Inc.) — only when you add a GitHub username
Reads your public GitHub profile and your most-starred public repositories.
- What is sent, and when: your GitHub username, requested from your server when the GitHub section is built or refreshed. If you add an optional Personal Access Token in the advanced settings (only to raise GitHub’s rate limit), it is sent to GitHub as an authorization header on those requests. The token is stored in your site and never exposed on the front end.
- When a visitor views the page, their browser loads your GitHub avatar directly from GitHub.
- Endpoint: https://api.github.com/
- Terms of Service: https://docs.github.com/site-policy/github-terms/github-terms-of-service
- Privacy statement: https://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Support
Need private support or custom development?
Do you need one-on-one help, priority troubleshooting, or a custom feature, integration, or tweak built specifically for your site? I offer private support and custom development. Just contact me and tell me what you need.
Need help or have suggestions?
Love the plugin? Please leave us a 5-star review and help spread the word!
About AyudaWP
We are specialists in WordPress security, SEO, AI and performance optimization plugins. We create tools that solve real problems for WordPress site owners while maintaining the highest coding standards and accessibility requirements.
Installation
- Install and activate the plugin.
- Open Contributor Résumé from the account menu in the toolbar (top right), or from the Settings link next to the plugin on the Plugins screen.
- Type your WordPress.org username (and, optionally, your GitHub username) and press “Check & build my résumé”.
- Press “Create my résumé page”, or add the “Contributor Résumé” block (or the
[contributor_resume]shortcode) to any page. - Optionally, open the Stats tab next to the résumé settings and press “Start collecting stats” to track your plugins and themes.
- Optionally, open the Emails tab, next to Stats, and choose a daily, weekly or monthly email, with a summary or only the alerts.
FAQ
Do I need an account, an API key or a token?
No. Your WordPress.org username is enough. A GitHub token is optional and only raises the API rate limit if you ever hit it; the GitHub section works without one.
Which data does it use, and is any visitor data sent anywhere?
No visitor data is ever collected or sent. The plugin only reads your own public contribution data from official WordPress.org endpoints (the plugins, themes, core credits and Photo Directory APIs, your public profile page and support profile) and, if you add a GitHub username, the public GitHub API. Everything is cached locally: profiles and most sources for about a day, core credits of released versions permanently (they never change). Data is refreshed in the background, so the public page itself makes no external requests.
Will it slow down my site?
No. Front-end pages render from a local cache with zero external requests.
Can I choose what to show?
Yes. Every section can be toggled on or off and reordered, globally in the settings or per block. Sections like GitHub and the grids let you pick exactly what and how much to display.
How do I restyle it from my theme?
The block honors your theme’s accent color and exposes CSS variables (prefixed --cvr-). You can also copy any template from the plugin’s templates/ folder to your-theme/contributor-resume/ and edit it there.
Does it work with the block editor and with classic themes?
Both. Use the block in the editor and Site Editor, or the [contributor_resume] shortcode anywhere shortcodes run.
Can I manage it from WP-CLI?
Yes. wp cresume refresh rebuilds your résumé snapshot, wp cresume status shows the per-source cache state, and wp cresume clear-cache empties it (one source or all). For the stats, wp cresume stats status shows the state of the collection, wp cresume stats collect runs it, wp cresume stats keyword-add, keyword-remove and keywords manage the search keywords, and wp cresume stats competitors list, add and remove manage the competitors. Handy on staging or in scripted setups.
Where do the stats come from, and how often are they collected?
From the public WordPress.org APIs: the plugin and theme directories, the download and version stats, the translations and the review feeds of the support forums. They are collected once a day, in the background, and “Collect now” in the Stats tab runs the collection on demand. Downloads come with two years of history. Installs, version adoption and search positions start on the day you turn the stats on, because WordPress.org only publishes their current value. On multisite, each site keeps its own stats.
Can I track where my plugin ranks in the WordPress.org search?
Yes. Add up to 10 search keywords to each plugin or theme in the Stats tab, and every day the plugin checks where it appears in the WordPress.org search for each one, along with the top 10 of every search. The tags of your plugins are tracked too, with your position and page in each tag.
Can I track my competitors?
Yes. In the Competitors view of the Stats tab, search the directory by name or slug and add up to 10 competitors to each plugin or theme, or pick them from the suggestions. They are read every day like your own. You compare them in a head-to-head table, keyword by keyword, in one downloads chart, and in the alerts and emails.
How are competitors suggested?
From your own keywords. Plugins that rank in the same searches and tags as yours, close to your position and of a similar size, come first, each with the reason it is suggested. The market leaders are listed apart. Nothing is added until you choose it, and a suggestion you hide stays hidden.
Does tracking competitors make more requests to WordPress.org?
A few. One request reads the figures of all your competitors at once, plus one per competitor for its downloads and, once a week, its versions. Their positions come from the searches you already track, so they cost nothing extra.
Do I need an account with an external analytics service?
No. The stats are read directly from the public WordPress.org APIs and stored in your own database. There is no sign-up, no API key and no third-party dashboard, and every view can be exported to CSV.
Can it email me reports and alerts?
Yes. In the Emails tab, next to Stats, choose what you want for each schedule: a daily, weekly or monthly email, each one with a summary of the period or only the alerts. Nothing is sent until you turn a schedule on, each administrator sets up their own emails, and you get one email a day at most. The emails are sent by your own site to the address of your user account: there is no mailing service and no sign-up.
What do the email alerts cover?
Big changes in downloads, active installs moving to another range, new reviews, a change in the average rating, more open support threads and plugins not tested with a new WordPress version. For positions, in searches and in tag pages: entering or leaving the top 10 or the first page, reaching or losing number one, jumps of 3, 5 or 10 places, and which plugin overtook yours or was overtaken by it. If you track competitors, also when one passes you or falls behind, enters your top 10, releases a version, is tested with a newer WordPress, changes its installs range or rating, gets a spike in downloads, goes 6 or 12 months without an update or is closed. For a plugin with competitors, the overtakes of other neighbours are left out by default, since its competitors’ own are told apart. You choose which of these you want and for which plugins or themes. Tag pages are read once a week, so their alerts arrive the day each tag is read.
I do not receive the emails. What should I check?
Open the Emails tab, next to Stats, and press “Send me a test email”. The emails go out with the mail function of WordPress, like a password reset email, so if those do not arrive either, your site needs an SMTP plugin or a transactional email service. The same screen shows the last email sent and the last error. The emails are sent after the daily collection, which runs with WP-Cron: on a site with very few visits it can run late.
How many plugins, themes and keywords are tracked?
Up to 50 plugins and 50 themes (the ones with the most active installs), and up to 10 search keywords per plugin or theme. Developers can change these limits with the cresume_stats_max_items and cresume_stats_max_keywords filters.
Can I see the stats of another author?
Yes, with a quick look: today’s figures and the last 90 days of downloads of any WordPress.org author. It is a snapshot, limited to three different authors a day. It is not kept as history, not exported and not shown in the widget, and it expires after 24 hours. Your own stats keep being collected meanwhile.
What happens to the stats if I change my WordPress.org username?
They follow the username of your résumé. The plugins and themes of the previous username stop being tracked, but their history stays and comes back if you switch back.
What happens when I uninstall it?
By default it cleans up after itself: its settings, cached data and stats history are removed when you delete the plugin, on every site of a network. If you’d rather keep them for a future reinstall, enable “Keep settings and cached data when the plugin is deleted” in the Advanced settings first.
Screenshots





Changelog
1.6.1
The competitor search tells why each result competes with yours, and adding a competitor or hiding a suggestion no longer reloads the page. Suggestions go up to 48 with Show more. Fixes the search on sites with a cache in front.
- Improved: The results of the competitor search say why each one competes with yours, as the suggestions do (in how many of your keywords it ranks, where it is above you, its best place and whether it passed you lately), and when it was last updated and the WordPress version it is tested with.
- Improved: The competitor search shows a spinner and a line with the number of results while you type, clears with the cross of the field or with Esc, and has no Search button when JavaScript is on.
- Improved: The suggestions of competitors go up to 48: the first 12 show, and the rest come 12 at a time with Show more.
- Improved: Adding a competitor, from the search or from the suggestions, and hiding a suggestion or showing it again no longer reload the page. The search, its results and the suggestions opened with Show more stay where they were, and the count, the list and the suggestions update in place.
- Improved: Hiding a suggestion that is already hidden, after a double click or by two administrators at once, no longer shows an error, and adding a competitor checks again, while saving, that your plugin or theme is still followed.
- Fix: On sites with a cache in front, such as Cloudflare, the styles and the script of an earlier 1.6.0 could stay in use, so the search did not run as you typed and its results showed beside the field.
1.6.0
Competitor tracking: choose the plugins you compete with and follow them every day, with a head to head view, keyword positions, alerts, emails and a dashboard widget. The plugin is now called Contributor Résumé, Rank and Competitor Tracker.
- New: Competitor tracking. Choose up to 10 competitors for each plugin or theme with a search of the directory by name or slug, with results as you type, or from suggestions taken from your own keywords, each with the reason it is there. They are read every day like your own, with two years of download history from the first day. Market leaders are suggested apart: a leader is followed like the rest but not counted when comparing who ranks better. When a plugin or theme has its 10, the screen says so and explains how to make room.
- New: Competitors view in Stats. Five figures, a sortable head-to-head table, a keyword-by-keyword table that shows where you rank better, one downloads chart for all of them (on a logarithmic scale or as an index that starts everyone at 100), your share of the top 10 of your keywords and the opportunities it shows.
- New: Competitor alerts, in the Alerts view and in the emails. A competitor passes you or falls behind, enters or leaves the top 10, ranks for one of your keywords for the first time, releases a version, says it is tested with a newer WordPress than yours, changes its installs range or rating, gets a spike in downloads without a release, goes 6 or 12 months without an update or is closed on WordPress.org.
- New: The email summary has a block for each plugin or theme with competitors, with four figures, the head to head and the opportunities, and the subject carries the competitor alert that matters most. The new topic is on for whoever already had the emails set up.
- New: A Competitors box on the page of each plugin or theme, the places of its competitors under each search in Keywords, a column in Overview, two CSV datasets and a Competitors layout in the dashboard widget. The One plugin layout of the widget also says in how many keywords it ranks better than its competitors.
- New:
wp cresume stats competitors list,addandremove. - Improved: The plugin is now called Contributor Résumé, Rank and Competitor Tracker, and the new name shows on its screens and in the emails. The résumé block and the link in the account menu of the toolbar keep the short name.
- Improved: The views of Stats are four cards with a figure each (Overview, Competitors, Keywords and Alerts), and the filters sit in a labelled strip below them.
- Improved: For a plugin or theme with competitors, the emails and the Alerts view leave out the overtakes of other neighbours by default, because the competitors’ own are told apart. Each user can go back to every overtake, in the Emails tab and in the Alerts view.
- Improved: On the page of each plugin or theme, the downloads chart is a box you can move, fold or hide like the others, next to active installs and at the same height. Translations and version adoption line up as well.
- Improved: The stats tables are updated automatically to keep the competitors and their positions.
- Improved: The dashboard widget settings ignore unexpected values without a PHP notice, and the rating bars are drawn empty when WordPress.org gives no breakdown of the ratings.
For older changelog entries, please check the changelog.txt file
