Skip to content

About

The Hack Repair Guy’s Group Password Reset plugin is a native WordPress admin tool that lets administrators bulk reset passwords by scope, skip excluded usernames, and send secure password reset links to affected users.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

The Hack Repair Guy’s Group Password Reset

The Hack Repair Guy's Group Password Reset

Bulk reset WordPress user passwords by scope, skip excluded usernames, and optionally notify affected users with secure password reset links.
By Jim Walker, The Hack Repair Guy

Version 3.6.3 WordPress 6.9.4+ Tested up to WordPress 7.1.3 PHP 7.4+ License GPLv2 or later

DOWNLOAD PLUGIN


Current release: 3.6.3 See the release notes for changes and validation scope.

Requirements

Minimum Tested up to
WordPress 6.9.4 7.1.3
PHP 7.4 8.3

Administrator access to the target site is also required.

Features

  • Reset passwords for all users, a single role, or Administrator (excluding current user)
  • Persist excluded usernames between runs
  • Show the latest 20 per-user results, including skipped accounts, while summary counts cover the full run
  • Send secure password reset links by email instead of exposing raw passwords
  • Support a reset-only mode that skips email when admins need to communicate through another channel
  • Support both JavaScript-enhanced batch processing and a chunked non-JavaScript fallback
  • Store async progress per reset run so multiple tabs do not overwrite each other
  • Retain completed summary counts and metadata for up to 15 minutes, without storing per-user result rows
  • Manually email selected administrators a full-width branded HTML summary with a plain-text alternative
  • Select recipients individually or with All administrators; add an optional note and review the subject
  • Identify plugin emails with [domain] [Group Password Reset] subject tags
  • Write audit-log entries for reset job creation and completion
  • Show a Support container at the bottom of the screen with the coffee link and GitHub Discussions
  • Check this plugin's own GitHub releases for updates, so the Plugins screen offers a one-click update

How It Works

  1. Open Tools → Group Password Reset. Under Choose accounts, use Accounts to reset to select a scope. No scope is selected by default.
  2. Choose All users, a specific role, or Administrator (excluding current user).
  3. Enter comma-separated usernames to exclude.
  4. Choose whether to attempt email notifications or run in reset-only mode.
  5. Confirm that you want to invalidate current passwords.
  6. Select Reset Passwords, then review progress and Latest results. The in-page completion message is Done! Password reset complete., displayed in bold. Check the result counts and details for failures or skipped accounts.
  7. To share the completed summary, use Notify administrators, select recipients, optionally add a note, review Preview summary and Subject, then choose Send email.

With JavaScript enabled, the plugin processes users in batches of 20 and updates the results table in place. Without JavaScript, the form submits through WordPress admin-post.php, processes the reset in redirecting batches, and returns to the admin screen with the final summary.

When email mode is enabled, the plugin resets passwords first and then attempts to send secure reset-link emails. Mail failures do not roll back the reset, so choose no-email mode when you plan to communicate through another channel.

Administrator summaries and email format

After a completed reset, Notify administrators shows a tinted recipient panel. Select individual administrators or use All administrators. The list uses two columns on desktop and stacks on small screens. Nothing is selected automatically. Add an optional personal note, review the plain-text Preview summary and subject, then choose Send email. The preview shows summary content; the delivered administrator email uses the branded HTML template.

The latest completed summary belongs to the administrator who ran it and is available for 15 minutes; a newer completed run replaces it. Summary metadata includes completion time, scope, notification mode, exclusion count, and full-run counts. The results screen retains only the latest 20 per-user rows during the current JavaScript run; older rows are removed and detailed rows are not saved for later review. The counts and emailed summary still cover the whole run.

Administrator emails use a full-width THRG HTML layout inspired by Site Inspector, with a personalized greeting, optional note, results table, notification mode, conditional failure guidance, dashboard button, and privacy footer. Each message includes a plain-text alternative. User reset-link emails retain their plain-text format. Subjects use:

  • [example.com] [Group Password Reset] Password Reset
  • [example.com] [Group Password Reset] Password Reset Summary

The domain is taken from the configured site home URL, retaining subdomains and explicit ports (such as localhost:8081) and omitting scheme and path. Both message types identify the site URL in the body.

Summary sending is independent of reset-link notifications and works after a reset-only run. It requires manage_options, a valid nonce, the initiating administrator's current summary, and current administrator recipients with valid addresses (up to 100 shown). Each receives a separate message; repeat sends are throttled for one minute. The summary omits target-user lists, passwords, and reset links. Personal notes are sanitized text; avoid adding sensitive information yourself. Sending feedback reports acceptance or failure, not confirmed delivery. JavaScript and regular form submission are supported.

Architecture Notes

  • group-password-reset.php is the bootstrap file and loads the admin and reset subsystems.
  • includes/admin-menu.php owns the admin screen, asset registration, and the non-JavaScript form handler.
  • includes/password-reset.php owns shared reset logic, role-scope handling, summary-backed job state, result formatting, and AJAX endpoints.
  • includes/admin-notification.php owns summary storage, recipient selection, preview, and administrator email endpoints.
  • includes/email.php builds domain/plugin subject tags; includes/email-template.php renders the HTML administrator summary.
  • includes/audit-log.php owns the audit table schema and event logging.
  • includes/class-gpr-updater.php points WordPress at this plugin's GitHub releases and fills the update details window from readme.txt.
  • assets/js/admin.js progressively enhances the admin screen with async batching.
  • assets/css/admin.css applies the Site Inspector design family to this plugin’s admin page.

Maintainer Notes

See CONTRIBUTING.md for contribution guidelines and MAINTAINING.md for the repository QA checklist, WordPressCS commands, release packaging rules, and local test environment notes.

Testing Notes

Baseline compatibility target:

  • WordPress 6.9.4 (minimum) through 7.1.3
  • PHP 7.4 (minimum) and PHP 8.3

Recommended manual scenarios:

  • Reset a single role with multiple users.
  • Reset Administrator (excluding current user) and verify the current admin is skipped automatically.
  • Reset all users while excluding one or more usernames.
  • Run the tool with a role that has no users.
  • Trigger a run with JavaScript disabled to verify the fallback path.
  • Verify results distinguish success, failed, and skipped.
  • Verify the audit log records start and completion events without storing target usernames or emails.
  • Verify completed runs retain summary counts and metadata without per-user rows after reload.
  • Check the last-20-row limit across multiple batches.
  • Check administrator selection, select-all/partial states, summary ownership/expiry, email subjects, HTML/plain-text parts, and failure guidance. Use a local mail catcher such as Mailpit.

Release Checklist

  • Update the plugin version and changelog.
  • Verify readme.txt matches the plugin header and current behavior.
  • Keep the bold completion text Done! Password reset complete. aligned with the localized JavaScript string and completion styling.
  • Confirm the admin screen loads without PHP notices.
  • Run php tests/admin-notification.php, php tests/update-notices.php, PHP/JavaScript syntax checks, and shared PHPCS.
  • Consider a Codex Security diff review; do not run the security plugin automatically.
  • Confirm the reset flow works on WordPress 6.9.4 and 7.1.x with PHP 7.4 and with PHP 8.3, plus any newer local prerelease builds used for forward-compatibility checks.

Author and support

Jim Walker — The Hack Repair Guy — author and maintainer.

Questions, ideas and community support · Report a bug · Security reporting · Buy Jim a coffee

Thank you

GitHub updates use Plugin Update Checker by Janis Elsts, bundled under the MIT license.

License

GPL-2.0-or-later. See LICENSE.

Changelog

See the Changelog section of readme.txt.

About

The Hack Repair Guy’s Group Password Reset plugin is a native WordPress admin tool that lets administrators bulk reset passwords by scope, skip excluded usernames, and send secure password reset links to affected users.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages