Description
Shake Connect is the site-side companion to the WPShake dashboard at wpshake.com. Install it on each WordPress site you want to monitor, then add the site to your WPShake account using the connection token shown on the plugin’s settings page. The dashboard then runs daily checks across every connected site without you logging into each one.
What Shake Connect adds to this site
- A bearer-token-authenticated REST API under
/wp-json/wpshake/v1/*that the WPShake dashboard calls to read site state. - Endpoints for: plugin and theme inventory with available updates, core info, WP checksums, database health, recent WooCommerce orders if WooCommerce is installed, recent PHP errors from
WP_DEBUG_LOG, backup-plugin detection (UpdraftPlus, BlogVault, BackWPup, Solid Backups, WPvivid, Duplicator), the activity log (plus the WP Activity Log plugin’s table when that plugin is installed), a built-in malware signature scanner, and a broken-link checker. - Maintenance endpoints scoped to safe operations: cache flush across popular caching plugins, run-due WP-Cron, expired-transient cleanup, permalinks flush.
- A WP-CLI subcommand
wp wpshakefor token rotation and status checks.
Activity log
Shake Connect records who did what on the site and keeps it in its own database tables. Open it from the Activity log menu in the WordPress admin.
- Sign-ins, failed logins, user and role changes, application passwords, plugin, theme and core changes, settings, menus, widgets, cron and file edits.
- Posts, pages, custom post types, media and terms, with the fields that changed.
- WooCommerce orders, products, coupons, stock and store settings when WooCommerce is active.
- Yoast SEO, Rank Math, Redirection, ACF, Gravity Forms, WPForms, TablePress, Termly, Two Factor, bbPress, LearnDash, MemberPress, Paid Memberships Pro and MainWP when those plugins are active.
- A log viewer with filters, saved searches, notes, CSV and JSON export, and a dashboard widget.
- A list of logged-in users, with the option to end a session and to limit how many sessions each role may hold.
- Scheduled email reports.
- Copies of the log to a local file or to a destination you choose: syslog, Papertrail, Loggly, Slack, AWS CloudWatch Logs, an HTTPS webhook or an external MySQL database.
- Events made by AI agents and automation tools are tagged with the agent behind them.
- A setup wizard, retention settings, and
wp shake activitycommands for WP-CLI.
Once the site is connected to WPShake, the dashboard also keeps an off-site copy of the log.
How the connection works
- Install and activate Shake Connect.
- Open Settings → Shake Connect in the WordPress admin to generate a connection token. The token is shown once.
- Sign up at wpshake.com, click “Add a site”, paste the token and your site URL.
- The dashboard performs an initial handshake and pulls site state.
The token is stored as a SHA-256 hash on this site. The dashboard sends the plain token in an Authorization: Bearer header on every request. Every authenticated endpoint validates the header before doing anything.
Built for agencies
If you maintain more than a handful of WordPress sites, you already know the work. Shake Connect is the receiver for an agent that handles the daily checks across your fleet: backup verification, plugin and theme update visibility, vulnerability scanning, performance probes, PHP error monitoring, broken link checks, and per-site recommendations on what to update and what to hold.
The WPShake dashboard is a separate paid service. This connector plugin is free and open source under GPL.
Multisite
Shake Connect supports WordPress multisite. Network-activate the plugin and the connection token is stored at the network level so every subsite shares the same credentials. Enumerate subsites via /network/sites and pass ?blog_id=N to per-site read endpoints (for example /site/info?blog_id=3 or /plugins?blog_id=3) to inspect each subsite. Without blog_id, requests run against the main site. Enumeration is capped at 500 subsites per call.
External services
Shake Connect contacts the services below. Each one is either the WPShake dashboard you connect the site to, or a destination you add yourself.
WPShake dashboard
The site sends activity log events to WPShake so the dashboard keeps an off-site copy of the log. This starts only after you connect the site to your WPShake account and the dashboard sets up the connection with your bearer token. Events are sent at the end of the page request that recorded them, and once a day for any the dashboard hasn’t confirmed. Each event holds its type and severity, the time, the user ID, username and roles, the visitor’s IP address and browser user agent, the affected object’s type, ID and name, the subsite ID and a few event-specific details. Requests go to the WPShake ingest address the dashboard provides (for example https://ingest.example.com/activity) and are signed with a key shared during setup.
Service: wpshake.com. Terms of service, privacy policy.
Log mirrors you configure
Under Activity log, Mirrors, you can copy the log to destinations of your own. Nothing is sent until you add one. Each mirror receives the same event fields as above, plus the site address and a readable message. A background job sends new events about once a minute.
- Papertrail: syslog messages over TLS or UDP to the host and port from your Papertrail account (for example
logs.example.com:12345). Terms, privacy. - Loggly: HTTPS requests to
https://logs-01.loggly.com/bulk/, with your customer token. Terms, privacy. - Slack: messages listing each event’s severity, description, username and type, sent to the incoming webhook URL you enter (for example
https://hooks.slack.com/services/T000/B000/XXXX). Terms, privacy. - AWS CloudWatch Logs: signed HTTPS requests to
https://logs.<region>.amazonaws.com/for the region, log group and stream you choose. Terms, privacy. - HTTPS webhook: JSON batches, signed with your secret, to the URL you enter (for example
https://hooks.example.com/activity). The terms and privacy policy are those of whoever runs that address. - Syslog: messages over UDP, TCP or TLS to the server and port you enter (for example
syslog.example.com:514). The terms are those of whoever runs that server. - External MySQL or MariaDB: rows written to a table in the database server you enter (for example
db.example.com:3306). The terms are those of whoever runs that server.
Broken-link checks
When the WPShake dashboard asks for a link check, the site sends a HEAD request (or a GET, if the server refuses HEAD) to each link found in its own content, to read the response status. Only the URL is requested, nothing else is sent. These go to whichever sites your content links to. The Recheck now action in Tools > Broken Links sends the same request for one link when an editor clicks it. Addresses on private or internal networks are never requested.
When an editor dismisses or restores a link in Tools > Broken Links, the site also tells the WPShake dashboard, so both show the same list. The request goes to the WPShake ingest address (the same one as the activity log, with a different path) and is signed with the key shared during setup. It carries the site ID, the link URLs and the editor’s username. It is sent only after the dashboard has set up the connection.
Scheduled activity reports are emailed through this site’s own mail setup.
Installation
- Upload the
shake-connectfolder to the/wp-content/plugins/directory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the “Plugins” screen in WordPress.
- Go to Settings → Shake Connect to generate a connection token.
- Sign up at wpshake.com (free trial available) and add the site using the token.
FAQ
Is this plugin free?
Yes, this connector plugin is free and GPL-licensed. The WPShake dashboard is a paid service with a free trial. You can use the connector with any WPShake plan.
Where does my data go?
Site data stays on this site until the WPShake dashboard asks for it with a valid bearer token. Activity log events go to WPShake once the dashboard has set up the connection, and to any log destination you add yourself. The External services section lists each one.
What happens if I deactivate the plugin?
The site stops responding to dashboard requests immediately. The connection token remains stored as a hash so that re-activating the plugin restores the connection. Deleting the plugin removes the stored token hash.
Can I rotate the connection token?
Yes. Either click “Reset token” on the plugin’s settings page, or run wp shake reset-token from WP-CLI. The previous token is invalidated immediately.
Which backup plugins does it detect?
UpdraftPlus, BlogVault, BackWPup, Solid Backups (formerly BackupBuddy), WPvivid, and Duplicator. For each, it surfaces the last backup time and status when the backup plugin exposes them.
Does it require WooCommerce?
No. The WooCommerce-related endpoint returns wc_active: false and an empty list when WooCommerce is not installed. The rest of the plugin works the same on any WordPress site.
Is there a WP-CLI command?
Yes. wp shake exposes status, reset-token, and revoke subcommands for ops scripts, and wp shake activity reads and configures the activity log.
Screenshots
Changelog
0.8.0
- Fix a broken link from Tools > Broken Links: “Edit URL” changes it in every post that uses it, “Unlink” removes the link and keeps its text, and bulk Unlink works on a selection. Each change is saved as a post revision, and posts you can’t edit are skipped and listed.
- Edits only touch the links being fixed: every other part of a post stays as it was, including block settings for images, buttons and embeds.
0.7.0
- Broken links in wp-admin: a new Tools > Broken Links screen lists broken links and warnings with the posts they appear in, with search, type filter, sorting and paging. Dismiss or restore links (one at a time or in bulk), recheck a link on the spot, and open the post to fix it. Editors and above can use it.
- A “Broken links” dashboard widget shows the counts and the newest broken links, and the Tools menu item shows how many links are broken.
- Link checks no longer request private or internal addresses. Every redirect hop is checked before it is followed, and links that point at such addresses are skipped instead of reported as broken.
- Dismissing or restoring a link in wp-admin takes effect on this site at once and is passed on to WPShake, so the dashboard and rel=”nofollow” stay in step.
0.6.0
- New activity log, recorded by the plugin itself: sign-ins, users, content, plugins, themes, settings, WooCommerce and popular SEO, forms and membership plugins.
- Activity log viewer with filters, saved searches, notes, export and a dashboard widget.
- Logged-in users screen with session limits per role.
- Scheduled email reports.
- Log mirrors: local file, syslog, Papertrail, Loggly, Slack, AWS CloudWatch Logs, HTTPS webhook and external MySQL.
- Events from AI agents and automation tools are tagged with the agent.
- Setup wizard and
wp shake activityWP-CLI commands. - Connected sites send activity events to the WPShake dashboard. See External services.
- Uninstalling removes the activity log tables, settings and files.
- Link checker: timeouts, connection errors, 5xx and 429 are warnings until a link has failed 3 times over at least 24 hours (rechecked after 6 hours, then daily); 404 and other 4xx stay broken at once. Warnings never get rel=”nofollow”.
- Link checker now also checks image sources (img src and the first srcset candidate) and plain-text URLs in post content, parsed with the WordPress HTML API. Only links (a href) are ever nofollowed.
- Redirects are followed up to 5 hops and reported with their final URL instead of being treated as broken.
- Links dismissed in the WPShake dashboard are no longer nofollowed. New POST /links/dismissed endpoint and a recheck_only parameter on /links/broken.
- Requires WordPress 6.5 or newer (the link checker uses the HTML API token reader).
0.5.1
- Removed two unnecessary core-file
require_oncecalls in the REST controller (wp-admin/includes/file.phpandwp-admin/includes/cron.php) — the functions used were already available without them.
0.5.0
- Multisite support:
Network: trueheader, network-level token storage, new/network/sitesendpoint for subsite enumeration (capped at 500), and?blog_id=Nparameter on read endpoints to query individual subsites.
0.1.0
- Initial release on WordPress.org.
- Read endpoints: plugins, themes, core/info, checksums, db/health, orders/recent, php-errors/recent, php-errors/stats, backups/state, activity-log/source, activity-log/recent, security/malware-scan, links/broken.
- Maintenance endpoints: cache/flush, cron/run-due, transients/delete-expired, permalinks/flush.
- WP-CLI command
wp wpshakefor token management.



