Description
WP Mechanic connects your site to a family of companion Android applications. Scan a QR code once on the plugin screen and the app can list and edit your WordPress users, browse WooCommerce orders, products and customers, and more – without you ever typing an admin password into a phone.
Included applications (all pair from the “WP Mechanic” menu)
- WordPress Users
- WordPress Users Management
- WordPress Acrobatics (approve a temporary login from your phone)
- WooCommerce Customers, Orders and Products
- Alphabetic Pagination, Woo Coming Soon and WP Docs
Security by design
- Pairing QR codes expire after a few minutes and work only once.
- Every paired device gets its own random key; keys are never printed in a web page.
- Repeated wrong keys from one IP address are throttled.
- Temporary logins (Acrobatics) must be approved by a paired app, expire quickly and are single use.
Optional Pro add-on
A separate “pro” folder can be dropped into the plugin directory to unlock extra tools (activity log, per-device key revocation, access controls, IP allow-list, users CSV export). Remove the folder and everything above keeps working. The Pro add-on is not part of the copy distributed on WordPress.org.
- Author: Fahad Mahmood
- Project URI: https://androidbubble.com/blog/wordpress/plugins/wordpress-mechanic
External services
WP Mechanic does not call any external service. It only shows links that open when you click them:
- Google Play (play.google.com) – download links for the companion apps on the plugin screen.
- Google Meet (meet.google.com) – optional “need help” link shown on a product page when
?helpis added to the URL; the link can be changed per product with ameeting-linkcustom field.
Credits
QR codes are generated with the bundled “PHP QR Code” library by Dominik Dzienia (LGPL 3, http://phpqrcode.sourceforge.net/).
Installation
- Upload the plugin through Plugins > Add New > Upload Plugin, or copy the
wp-mechanicfolder to/wp-content/plugins/. - Activate WP Mechanic.
- Open WP Mechanic in the admin menu, choose an application, install it from Google Play and press Scan to connect.
To enable the optional Pro add-on, copy the pro folder into /wp-content/plugins/wp-mechanic/. No other setup is required.
FAQ
Do I have to re-pair my Android apps after updating to 1.7.0?
Yes, once. Earlier versions exposed pairing keys in public page source, so all existing pairings are revoked on update. Scan a fresh QR code to reconnect.
Is any data sent to external servers?
No. The plugin makes no outbound requests. See “External services” below for the links it displays.
What happens if I remove the pro folder?
The Pro tools disappear and all free features continue to work unchanged.
The Android app cannot connect behind a proxy / CDN
Sites behind a reverse proxy can opt in to trusting forwarded IP headers with add_filter( 'wm_trust_proxy_headers', '__return_true' );.
Screenshots
Changelog
1.7.0
- Security: pairing keys were printed into the HTML of every public page – they are no longer exposed anywhere; all existing pairings are revoked once so they can be re-created safely.
- Security: QR generation, disconnect and status AJAX actions now require a nonce and an administrator capability (previously any logged-in user could pair an app).
- Security: pairing QR codes now expire and are single use; keys are random, compared in constant time, and failed attempts are throttled.
- Security: temporary-login approvals now expire, are single use, ignore spoofable proxy headers and can no longer take over an existing real account; strong random passwords are used.
- Security: user list responses no longer contain password hashes; the user update endpoint accepts only whitelisted fields and roles.
- Security: all REST routes declare a permission_callback; all request values are sanitized; all output is escaped.
- Security: QR images now live in uploads (not in the plugin folder); stored visitor lists are capped.
- Compatibility: tested with WordPress 7.1 and PHP 8.3; WooCommerce HPOS (custom order tables) supported; removed code that fatals on PHP 8; jQuery 4-safe scripts.
- Performance: scripts load only where needed; no more cache-busting on every request; fewer queries for WooCommerce counters.
- New: optional plug-and-play “pro” folder with activity log, key manager, access controls, IP allow-list and users export.
- New: uninstall routine removes all stored data.
1.6.7
- Updated for WP 5.8.
1.6.6
- WP Docs Android App added.
1.6.5
- Two new apps added.
1.6.4
- PHP Warning: array_key_exists() expects parameter 2 to be array, boolean given – fixed.
1.6.4
- Releasing with four Android Applications including “WordPress Acrobatics”.
1.6.3
- Releasing with first Android Application “WordPress Users”.
1.6.2
- Sanitized input and fixed direct file access issues.
1.6.1
- Database cleanup option refined.
1.6.0
- Database cleanup option added.
1.5.0
- Deprecated Functions search added.
1.4
- A few new features are added.
1.3.1
- Updated with respect to WordPress Jimmy Smith and beyond.
1.3
- Developers toolkit and settings page added.
1.2.5
- PHP Version related error fixed.
1.2.4
- Weekly updates the mechanic info instead of on every onload.



