MarketBasketAnalysis for WooCommerce
| 开发者 | brian48x |
|---|---|
| 更新时间 | 2026年10月2日 21:15 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Market Basket Analysis turns your WooCommerce order history into ranked bundle and cross-sell opportunities, backed by real co-purchase patterns. Not "people also viewed" guesses. Not random product carousels. Proper association-rule mining (FP-Growth + SQL pairs), the same algorithms big retailers use, shipped as a WordPress plugin that runs entirely on your server.
Every rule is auditable: support, confidence, and lift are visible on the Opportunities grid, so you can see why the engine picked what it picked.
What's included
- Four real mining engines, all local:
sql_pairs(fast pair-only miner, scales to large transaction stores),fp_growth(multi-item bundles, up to 4-item kits, the default),seasonal_cohort(weights recent and same-season baskets more heavily), andreturn_aware(down-weights pairs whose products are frequently returned). - AI catalog engine. Produces recommendations from catalog metadata alone using your own Anthropic or OpenAI API key (the provider bills you directly), so a brand-new store with no orders still gets bundle suggestions on day one.
- AI bundle copy and catalog enrichment. Generate merchant-ready bundle names, product descriptions, image alt text, category tags, and SEO meta from your own Anthropic or OpenAI key, then write the result back to the product. The only thing an AI feature needs is your provider key, and the provider bills you directly. MarketBasketAnalysis never sees the key or the catalog payload.
- Auto-mining cron, an order-velocity trigger plus a scheduled cadence (daily, weekly, or custom) via WP-Cron. Turn it on with the Auto-run mining toggle under Settings, Mining.
- Email + webhook notifications, alerts when a job completes with a high-value opportunity, or fails entirely. The webhook posts a signed JSON summary to a URL you choose.
- Cost-aware scoring and scoring modes, feed product cost via a meta key (compatible with WooCommerce Cost of Goods) and switch the Opportunities grid score between statistical, revenue, profit, or hybrid.
- Autonomous merchandising agent, an opt-in agent (off by default) that proposes weekly-plan actions and routes them through a human approval queue before anything ships.
- Opportunities admin, a sortable, filterable grid of ranked bundle candidates with confidence + lift visible per rule.
- Jobs admin, start a mining job manually with one click, or check scheduled-run status.
- Frequently Bought Together widget, shortcode
[mbawoo_fbt], Gutenberg block, and theme template tag. Sub-millisecond render because recommendations are precomputed, not computed at page load. - Bundle Builder widget, customer-customizable bundle on the product page. Shortcode
[mbawoo_bundle_builder]or the MBA Bundle Builder Gutenberg block. Source product locked in, recommendations togglable, running subtotal, optional "buy N+, save X%" discount preview, single Add to Cart. - Notion page sync, optional: connect your own Notion integration and the plugin keeps four summary pages (weekly plan, rationale analytics, forecasts, checkout experiments) up to date under a Notion page you pick.
- WP-CLI commands,
wp mbawoo run-job,wp mbawoo purge-old-jobsfor ops teams who live in the terminal. - HPOS + classic order tables, the miner detects which storage your site uses and queries accordingly.
- No SaaS dependency, all mining happens inside your WordPress install. The data-driven mining engines make no outbound API calls, and individual orders and customer records never leave your server under any configuration. The optional AI features call your own Anthropic or OpenAI account directly with a key you paste in, send only the catalog data and aggregate statistics listed under External services, and stay inert until you add a key.
- WordPress 6.4+ (tested up to 7.1)
- WooCommerce 8.0+ (tested up to 9.4)
- PHP 8.1+ (8.2 recommended)
- Both classic and High-Performance Order Storage (HPOS) order tables
- Multisite-compatible (per-site activation, per-site settings)
安装:
- Upload the plugin folder to
/wp-content/plugins/. The in-admin install via Plugins, Add New, Search "MarketBasketAnalysis" applies once the plugin is live in the WordPress.org directory; until the listing is approved, the upload path is the way in. - Activate the plugin through the Plugins menu in WordPress.
- Make sure WooCommerce is installed and active.
- Navigate to WooCommerce, MBA: Dashboard to run your first mining job.
- (Optional) Add the FBT widget to a product page via the Gutenberg block or the
[mbawoo_fbt]shortcode. - (Optional) The separate MBA Plus plugin, with the revenue-weighted HUI engine and hosted compute, is available at marketbasketanalysis.com.
屏幕截图:
常见问题:
Does this work with a fresh store with no orders yet?
The data-driven engines (sql_pairs, fp_growth) require order history. Around 200 completed orders in the analysis window is the sensible floor below which patterns are too sparse to mine. For brand-new stores with no order history, the free ai_catalog engine produces recommendations from catalog metadata alone, using your own Anthropic or OpenAI API key (the provider bills you directly).
Will mining slow down my site?
No. Jobs run in the background via WP-Cron or are kicked off manually from the admin. The storefront widget hits precomputed rules from a fast database table; lookups are sub-millisecond and never a real-time computation at page load.
Does this support High-Performance Order Storage (HPOS)?
Yes. The miner checks the site's HPOS setting and queries the right tables automatically. No configuration needed.
Where does my data go?
Mining runs locally. The data-driven mining engines make no outbound API calls, and individual orders and customer records never leave your server.
AI features call your own Anthropic or OpenAI account directly using a key you paste into Settings. They send product catalog data and aggregate statistics (for example, how many baskets contain a product pair), never customer names, email addresses, or individual orders. The External services section below lists exactly what each optional service receives and when. We never see the catalog payload or the LLM response. Every AI feature (the ai_catalog engine, AI bundle copy, and catalog enrichment) needs only your provider key, and the provider bills you directly. You set a monthly token budget for the AI assistant and the storefront rationales under Settings, AI Catalog Pairing, so a busy month cannot surprise you; 0 means no limit.
How does the FBT widget choose recommendations?
For a given product, the widget looks up the top-scored opportunities where that product appears in the antecedent (the "if" side of an association rule). Ties are broken by lift, then confidence.
Can I customize the widget styling?
Yes. Every block exposes its CSS classes (.mbawoo-fbt, .mbawoo-fbt__item, etc.). Override in your theme's stylesheet or use the Gutenberg block's color/layout controls.
How is AI billed?
AI features that call an LLM use YOUR Anthropic or OpenAI API key, and the provider bills you directly. Nothing about them is metered by us. You can cap the monthly token spend for the AI assistant and the storefront rationales under Settings, AI Catalog Pairing.
Is the source code available?
Yes, this plugin is GPLv2+ licensed and you can read and modify any of its code.
Where do I get support?
Use the WordPress.org plugin support forum once the directory listing is approved; until then, marketbasketanalysis.com/contact.
更新日志:
0.17.0
- Changed: activating the plugin creates its tables and settings and does nothing else. It sends no email, starts no analysis, and contacts no server.
- Changed: setup tips emails are off by default. Turn them on with the checkbox in the setup hub or under Settings, Notifications, and turn them off the same way or with the link in any of the emails.
- Changed: the first analysis starts when you first open the setup hub.
- Changed: every global name uses the mbawoo prefix, and PHP classes use the MarketBasketAnalysis\WooCommerce namespace. The shortcodes are [mbawoo_fbt] and [mbawoo_bundle_builder], and the WP-CLI command is wp mbawoo.
- Changed: the External services section lists every service the plugin contacts, what it sends, when, and links to each provider's terms and privacy policy.
- Removed: the Slack, Linear, HubSpot, and Salesforce connectors, which connected but sent nothing. Notion remains.
- Security: storefront impression tracking is tied to the shopper's own session cookie, so a copied nonce cannot record impressions for another session.
- Security: every REST route checks access in its permission callback: feed tokens, the unsubscribe token, OAuth state, webhook signatures, and manage_woocommerce for the health check.
- Security: all admin output is escaped at the point it is printed.
- Fixed: the direct-file-access guard now sits in the first lines of every file, where Plugin Check reads it.
- Removed: the Domain Path header, which pointed at a languages folder this plugin does not ship.
- Changed: plugin renamed to MarketBasketAnalysis for WooCommerce.
- Changed: every admin style and script now loads through the WordPress enqueue API; the plugin prints no inline style or script tags.
- Changed: the AI monthly token budgets (assistant chat, storefront rationales) are now yours to set under Settings, AI. They are spending guards on your own AI provider bill, and 0 means no monthly limit.
- Changed: the free AI clients moved out of the Pro namespace (MarketBasketAnalysis\WooCommerce\Ai); no behavior change.
- Security: every read of cookie, header, and request data is sanitized and unslashed at the point of use, and the public REST routes document why each one is public.
- Removed: the storefront "Powered by" credit link.
- Fixed: the Opportunities grid and its count now read only the most recent completed mining job, as the page states. Previously every historical run's rows aggregated, so re-mining showed each surviving pair once per run.
- Changed: admin page titles use the MarketBasketAnalysis brand name consistently.
- Changed: every feature in this plugin works with no license and no account: job notifications, cost-aware scoring, scoring modes, the full diagnostics event log, catalog-enrichment scans, and the autonomous agent are all included.
- Changed: the seasonal_cohort and return_aware engines are now selectable from the Jobs quick-run form, matching the Settings default-engine picker.
- New: a Catalog Hygiene page flags dead SKUs, duplicate listings, missing reorder thresholds, and mis-categorized products, each with a one-click fix.
- New: a Returns Insights page ranks products by return rate and suggests an action for the worst offenders.
- New: a Drift Alerts page surfaces divergence between mining runs.
- New: enabling a bundle proposal now creates its discount for you. The plugin auto-generates a WooCommerce coupon from the bundle's discount (percent or fixed), restricted to the bundle's products, so you no longer hand-make a coupon after you approve a bundle.
- New: the bundle discount auto-applies at the cart. The moment a shopper has every item in the bundle in their cart, the price drops on its own with no code to type; drop one item and it lifts again.
- New: a Disable bundle action on the Bundle Proposals page un-enables a live bundle and removes its discount coupon.
- Improved: the guided setup is now a single resumable hub. Each step opens in place with its own focused content, and you can jump to any step or come back later right where you left off.
- New: bundle proposals carry an editable description alongside the name. Draft AI copy, edit both, and save them together.
- New: the catalog enrichment workspace is now a full review queue. A catalog scan ranks your thinnest listings by quality score and generates suggestions for the worst ones first (description, alt text, category tags, SEO meta).
- New: edit any proposal in place before you apply it, apply suggestions one at a time, or tick several and write them all back in one click with Apply selected.
- New: a per-product Generate marketing blurb action writes a short agent and bundle-context line to a product custom field.
- New: an optional daily catalog scan on WP-Cron, off by default, using your own AI provider key. Older entries are at marketbasketanalysis.com/changelog.