PPL Product Recommendations HV for Magento 2

PPL Product Recommendations HV is the standalone storefront package of PPL Product Recommendations for Hyvä-based storefronts. It adds relevance-scored recommendation surfaces - a product-page block and an add-to-cart drawer - rendered with Hyvä-compatible templates and vanilla JavaScript instead of the Luma RequireJS layer. Recommendations are built from a configurable engine that blends a co-purchase index, native Magento product links, category similarity, attribute/price similarity and a popularity fallback, with per-source weights.

What It Adds

• Product-page recommendation block with configurable title, item count and position
• Add-to-cart drawer that opens after a successful AJAX add-to-cart, with an optional recommendation slider (own title, checkout button label and item count)
• Recommendation engine combining several sources with configurable weights and a minimum score:
  • Co-purchase index built from orders within a rolling lookback window (minimum co-purchase support)
  • Native Magento related / up-sell / cross-sell links
  • Category-overlap similarity
  • Attribute and price-band similarity points (e.g. same manufacturer, target group, similar price)
  • Industry "goes-with" affinity lists driven by the active Search Intelligence vertical
  • Popularity fallback
• Exclusion rules for out-of-stock products and products already in the cart
• Admin dashboard with a live recommendation preview
• Optional debug reasons (score components) in the recommendation JSON for local verification

Hyvä Compatibility

This package targets Hyvä storefronts: the frontend surfaces are wired through hyva_default.xml and a single vanilla product-recommendations-hv.js, with no dependency on the Luma/RequireJS or Knockout stack. Install this package on a Hyvä theme; use the Luma package ppl/module-product-recommendations on a Luma storefront. The two packages conflict and must not be installed together.

Requirements And Dependencies

• PHP: >=8.1
• Magento packages: magento/framework, magento/module-backend, magento/module-catalog, magento/module-catalog-widget, magento/module-checkout, magento/module-inventory-sales-api, magento/module-inventory-sales, magento/module-config, magento/module-customer, magento/module-sales, magento/module-store, magento/module-wishlist
• PPL packages: ppl/module-hub

Installation

Composer installation:

composer require ppl/module-hub ppl/module-product-recommendations-hv
bin/magento module:enable Ppl_Hub Ppl_ProductRecommendationsHV
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Manual app/code installation: copy the module to app/code/Ppl/ProductRecommendationsHV, install the dependencies listed above, then run the same Magento commands without the Composer step.

First Use

• Install Ppl_Hub and enable the module on a Hyvä-based storefront.
• Enable the master switch under Product Recommendations, then enable the product-page block and/or the add-to-cart drawer.
• Review the engine, source weights and similarity settings; the defaults are a safe starting point.
• Build the co-purchase index once (CLI command below) or let the scheduled job run, then open the admin dashboard preview.

Admin entry: PPL Hub > Product Recommendations.

Configuration

Display settings live under PPL Hub > Product Recommendations:

• General - master switch and optional debug reasons in AJAX responses.
• Product Page - enable the block, title, maximum items and block position.
• Add-to-cart Drawer - enable the drawer and its recommendation slider, titles, checkout button label and maximum items.

Engine tuning lives under Stores > Configuration > PPL Hub > Product Recommendations Engine:

• Recommendation Engine - order lookback days, minimum co-purchase count, minimum score, source toggles and stock/cart exclusions.
• Source Weights - co-purchase, native link, category-overlap and popularity weights.
• Similarity Points - matching attributes and per-attribute points, price band and points, and industry "goes-with" affinity points.

Command Line

• bin/magento ppl:productrecommendations:rebuild - rebuild the co-purchase index from recent orders.

Scheduled Tasks

• ppl_productrecommendations_rebuild - rebuilds the co-purchase index (hourly).

Integrations And Boundaries

• Requires only Ppl_Hub for the shared admin navigation; it does not depend on any PPL search or filter module.
• The industry "goes-with" affinity lists use the active Search Intelligence vertical when present and stay inert otherwise.
• Optionally consumes recommendation interaction signals from Ppl_TrackingHV in a later phase; it does not depend on it.
• Conflicts with ppl/module-product-recommendations (the Luma package); install exactly one of the two per storefront.

Localization

The package includes translation CSV files for 12 locales: de_DE, en_US, es_ES, fr_FR, it_IT, ja_JP, nl_NL, pl_PL, pt_BR, ru_RU, tr_TR, zh_CN.

Customer Documentation

Customer-facing User Guides and Marketplace Long Descriptions are maintained outside the Magento module package in the repository-level documentation folders. The module package itself intentionally keeps only this technical README plus developer-relevant files.

Support

Support contact: [email protected]. Include the module version, Magento version, enabled PPL companion modules, and the relevant admin or storefront screenshot when reporting an issue.

Changelog

1.3.0

• Adopted the shared PPL Hub UI theme for the Hyvä storefront recommendation cards
• Aligned to the PPL Hub 1.3 line for admin navigation, ACL, and menu integration
• Magento Open Source and Adobe Commerce 2.4.9 compatibility
• Minor fixes and stability improvements

1.0.0

• Initial release
• Added product-page and add-to-cart recommendation surfaces for Hyvä-based storefronts, compatible with modern storefront themes