Requirements
The versions Shaped Recommend needs, what it does if they're missing, and what it adds to your site.
Minimum versions
| Requirement | Minimum | Notes |
|---|---|---|
| WordPress | 6.6 | Tested up to 7.1. |
| PHP | 7.4 | 8.1 or newer is recommended — WordPress and WooCommerce both perform better there. |
| WooCommerce | 7.0 | Tested up to 11.0. A hard dependency: without it, nothing loads. |
| Shaped Recommend (Free) | 1.0.0 | Required by Shaped Recommend Pro. Pro is an add-on, not a standalone plugin. |
| MySQL / MariaDB | WordPress's own minimum | Shaped Recommend adds three tables of its own — see below. |
Not sure what you're running? In WordPress, go to Tools → Site Health → Info and open the WordPress, Server and Database panels. WooCommerce's own version is on Plugins → Installed Plugins.
What happens if something is missing
Shaped Recommend never white-screens your store over a missing dependency. Every gate does the same thing: the plugin goes dormant — it stops registering anything, leaves your storefront untouched — and shows an admin notice explaining what's missing.
| Situation | What you'll see |
|---|---|
| WooCommerce not installed or not active | WordPress won't let you activate Shaped Recommend until WooCommerce is active (the plugin declares WooCommerce as a required plugin). If WooCommerce is later deactivated, Shaped Recommend goes dormant with the notice Shaped Recommend requires WooCommerce to be installed and active. |
| WooCommerce older than 7.0 | Dormant, with a notice naming the version it needs and the version you're running. |
| Data saved by a newer version of the plugin (for example, after a downgrade) | Shaped Recommend loads nothing and changes nothing, and asks you to update. Your data is left exactly as it was. |
| Pro active without Free | Pro refuses to activate. WordPress itself blocks it, because Pro declares Free as a required plugin. |
| Pro active with a Free version below the one it needs | Pro stays dormant with a notice. Update Free and Pro comes back on its own. |
Always install Free first
Shaped Recommend Pro is an extension, not a replacement. Free owns the recommendation engine, your Recommendations, your analytics and your settings — Pro only unlocks capabilities inside it. Install and activate Free, then Pro. Installation walks through it.
WooCommerce features it supports
- HPOS (High-Performance Order Storage) — declared compatible. You can leave HPOS on.
- Cart and Checkout blocks — declared compatible, meaning the plugin doesn't interfere with them. It does not mean every location renders inside those blocks: the cart and checkout positions hang off classic WooCommerce hooks that the block-built pages may never fire, so a block-built Cart page needs the Shaped Recommend block instead. The thank-you positions are fine either way — WooCommerce's order-confirmation block replays their hooks. Full detail: Locations.
- Classic and block themes — classic themes get the hook-based locations; block themes use the Gutenberg block, which is included in Free precisely because block themes have no PHP hook slots to attach to.
- Product types — every purchasable type renders, with WooCommerce's own button semantics (a variable product gets "Select options", an external product links to its URL, prices render as ranges where they are ranges). One-click surfaces such as the bundle box's Add bundle to cart act on simple products only; a non-simple product there gets a "Choose options" link instead of a button that would silently do the wrong thing.
What it adds to your site
Worth knowing before you install on a store you care about:
Database tables (three, all created by Free):
| Table | Holds |
|---|---|
sprcm_events | Raw view, click and conversion events from the storefront. |
sprcm_event_rollups | Nightly per-day aggregates — what the Analytics screen reads. |
sprcm_affinity | The mined product-pair store that Store Statistics Pro ranks from. Created by Free, filled by Pro. |
Scheduled jobs — a nightly rollup and a nightly purge (Free), plus the incremental mining passes (Pro). They run through Action Scheduler, in the background. Mining never runs inside a page request.
Capabilities — sprcm_manage_recommendations and sprcm_view_analytics, granted to Administrator and Shop manager on activation. Two store-wide actions additionally require full administrator rights (manage_options): Settings → Advanced → Clean-up Data on Deletion and Replace All imports. A shop manager can build and run recommendations without being able to wipe the plugin's data.
Storefront assets — a small stylesheet and a small script, and only on pages that actually have something to render. A page with no recommendations loads neither. Pro's popup and bundle code loads only on pages that use them.
Outbound requests — none from the storefront. With Pro installed, the admin side checks for Pro updates and your license status (weekly) against ShapedPlugin's server.
Hosting notes
Nothing exotic is required, but a few things help:
- Page caching is fine. Per-shopper blocks render a sized placeholder in the cached HTML and fill in from one request afterwards, so a cached page never serves one shopper another shopper's recommendations. See Performance.
- Object caching helps on larger catalogues but isn't required.
- WP-Cron needs to run. Analytics rollups and statistics mining are scheduled jobs. If your host has disabled WP-Cron without setting up a real cron entry, yesterday's numbers won't appear. Troubleshooting covers the symptoms.