ms3ProductSets

ms3ProductSets adds recommendation blocks to MiniShop3: “Frequently bought together”, similar products, VIP sets, cart suggestions. Manual links come first (TVs on the product and manager templates). When they are empty, auto logic runs by set type (category, orders, VIP settings).

Features

• Set types: buy_together, similar, popcorn, cart_suggestion, auto_sales, vip, auto. Aliases also-bought / cross-sell use buy_together auto logic. custom uses auto. See set types.
• Manual mode: table ms3_product_sets, TVs ms3productsets_*, bulk template apply to categories in the manager.
• Auto mode: picks by category, similar products, order stats (auto_sales), VIP fallback from ms3productsets.vip_set_*. Off when auto_recommendation=0. See system settings.
• Site output: snippet ms3ProductSets. Optional AJAX via get_set and window.ms3ProductSets.render(). See API and integration.
• Cache: TTL from ms3productsets.cache_lifetime. 0 disables cache. See system settings.
• Cart: stock cards use MiniShop3 ms3_form. productsets.js hits MiniShop3 Web API first. Connector add_to_cart is the fallback. “Add whole set” is data-add-set.
• Manager UI: Components → Product sets (VueTools + PrimeVue): templates, apply to categories, unbind. See manager guide and interface.
• Plugins: sync TVs to the DB on product save. Clean links when a resource is deleted. See architecture.
• Localization: component lexicon. On the frontend use mspsLexiconScript (window.mspsLexicon, window.mspsConfig).

System requirements

Requirement	Version
MODX Revolution	3.0+
PHP	8.1+
MySQL	5.7+ / MariaDB 10.3+

Dependencies

• MiniShop3: products and categories
• pdoTools 3.0.0+
• VueTools: “Product sets” manager page

Installation

Encrypted transport needs provider modstore.pro/extras. Without it install fails with Package provider not found.

Steps, requirements, and ModStore download: Quick start.

After installation

Load mspsLexiconScript, productsets.css and productsets.js. Add ms3ProductSets to the product or landing template. Limits and cache: system settings, namespace ms3productsets.

Storefront wiring: Frontend setup.

Terms

Term	Description
Set	Recommended product list for a context (resource_id, type, category)
Set type	Logic mode: buy_together, similar, vip, etc.
Manual links	Rows in ms3_product_sets (and/or TV values) defined by a manager
Set template	Row in ms3_product_set_templates for bulk apply to categories
Auto recommendations	ID selection without manual links (category, orders, catalog)
VIP set	Type vip. Without manual links, fallback from vip_set_{set_id}