PPL Product Recommendations HV

PPL Product Recommendations HV for Magento adds self-hosted, store-owned product recommendations to Hyvä product pages and Hyvä add-to-cart flows. It is built for merchants and agencies that want practical "customers also bought" and related-product suggestions based on store data, native merchandising links, similarity signals, and optional industry context without sending catalog, order, or shopper context to an external recommendation SaaS.

This is the standalone Hyvä storefront package. It uses theme-specific storefront layout handles, modern storefront-friendly templates, and lightweight storefront JavaScript instead of the standard Luma/RequireJS frontend. Do not install it together with the standard `ppl/module-product-recommendations` package; choose this Hyvä storefront package for Hyvä storefronts and the standard package for Luma-style storefronts.

The module uses store data from Magento first. Its primary signal is a materialized co-purchase index built from order history. Merchant-curated related, up-sell, and cross-sell links can contribute additional candidates, while category overlap, selected product attributes, similar price, category popularity, global popularity, and optional Search Intelligence "goes-with" industry lists provide cold-start and complementary-product coverage.

Features

• Product-page recommendation block for Hyvä product detail pages with modern storefront-friendly product cards and async loading.
• Add-to-cart drawer for Hyvä storefronts that can confirm the cart action, show cart items/subtotal, and suggest complementary products.
• Co-purchase recommendation index with CLI rebuild command and scheduled cron rebuild.
• Fallback candidate sources for native product links, category overlap, attribute similarity, price band, and popularity.
• Optional Search Intelligence industry "goes-with" lists for complementary product-type recommendations.
• Configurable source weights, minimum support, minimum score, order lookback window, result limits, and eligibility rules.
• PPL Hub admin configuration under PPL Hub > Frontend Config (Product Recommendations tab).
• Admin dashboard and preview workflow for rebuild status and recommendation checks.
• Store-aware and customer-group-aware recommendation rows for product-page and cart-drawer surfaces.
• Safe defaults: the module installs disabled, and each storefront surface has its own switch behind the master switch.
• Debug mode for local verification that can include score components in AJAX responses.
• Translation CSV baseline for 12 locales.

Why merchants use it

Recommendations help shoppers continue from the product they are already considering, but many stores do not need a remote personalization platform for the first useful step. PPL Product Recommendations HV for Magento gives teams working with Magento and fast modern storefront themes a local recommendation layer based on actual co-purchase relationships, curated native links, similarity signals, and simple catalog fallbacks. The result is understandable, controllable, and easy to verify in the same Magento and modern storefront runtime where the Hyvä storefront already lives.

Common use cases

• Showing "Customers were also interested in" blocks on product detail pages.
• Opening an add-to-cart drawer that confirms the cart action and suggests complementary products.
• Using real order combinations to lift products that are often purchased together.
• Keeping native related, up-sell, and cross-sell work useful as a boost or fallback source.
• Providing cold-start recommendations when order history is still thin.
• Using selected attributes, price band, and industry "goes-with" context to make similarity more useful.
• Running a CLI rebuild after catalog or order-data changes before validating Hyvä storefront output.

What you get

• Extension package for Magento under Ppl_ProductRecommendationsHV.
• Composer package `ppl/module-product-recommendations-hv`.
• Declarative schema for the recommendation index and build-state table.
• CLI command `bin/magento ppl:productrecommendations:rebuild` with an optional `--store` filter.
• Hourly cron job for rebuilding recommendation pairs.
• Frontend AJAX endpoint `/ppl_recommendations/ajax/recommendations`.
• Hyvä product-page async template, Hyvä add-to-cart drawer template, lightweight storefront JavaScript, and frontend CSS.
• PPL Hub admin configuration, dashboard, preview workflow, and ACL integration.
• Hyvä-specific storefront templates and assets that stay separate from the standard Luma package.
• Focused unit tests for scoring, candidate merging, configuration behavior, and provider behavior.

Compatibility

Designed for Magento Open Source and Adobe Commerce 2.4 environments running a Hyvä storefront. Requires PHP 8.1 or newer, Magento catalog, catalog widget, checkout, customer, sales, store, backend, config, inventory sales API, inventory sales, and wishlist modules, plus PPL Hub 1.3 or newer. Hyvä default theme runtime is suggested for the storefront layer to activate through theme-specific storefront layout handles. PPL Tracking & Privacy HV is suggested only as a future optional signal source and is not required by this release. Optional Search Intelligence industry context can enrich "goes-with" recommendations when configured. The module does not own Magento search, filter, or tracking surfaces.

Ideal for

Merchants and agencies working with Magento and fast modern storefront themes that want a practical, local recommendation layer for Hyvä product pages and Hyvä add-to-cart journeys, with admin-controlled surfaces, transparent scoring inputs, and no hard dependency on external recommendation infrastructure.

Compatibility and trademark note

This package includes a lightweight storefront implementation for modern Magento themes, including Hyvä-based storefronts. Hyvä is a trademark of Hyvä Themes B.V. This extension is developed by PPL and is not affiliated with, endorsed by, or sponsored by Hyvä Themes B.V.