PPL Search Intelligence Luma Adapter for Magento 2

This package is the Luma/RequireJS storefront adapter for Ppl_SearchIntelligenceCore. It contains only Luma layout, templates, JavaScript, CSS and frontend translations; all backend behavior is owned once by the shared Core package.

What It Adds

• Luma mini-search integration and Search Intelligence overlay rendering
• Native Magento mini-search fallback while storefront Search Intelligence is disabled
• Consolidated, config-aware frontend assets scoped to the overlay
• Luma frontend translations and contract tests

Requirements And Dependencies

• PHP >=8.1 and Magento Open Source or Adobe Commerce 2.4.9
• Ppl_SearchIntelligenceCore (which requires Ppl_Hub)
• Do not install or enable together with Ppl_SearchIntelligenceHV

Installation

Install the required PPL packages in dependency order. Composer will skip packages that are already installed:

composer require ppl/module-hub ppl/module-search-intelligence
bin/magento module:enable Ppl_Hub Ppl_SearchIntelligenceCore Ppl_SearchIntelligence
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

For manual app/code installation, copy Ppl/Hub, Ppl/SearchIntelligenceCore and Ppl/SearchIntelligence in that order, then enable all three modules.

First Use

• Build the shared Core index before enabling storefront suggestions or search-page ownership.
• Pair with Ppl_DiscoveryFilters only when overlay facets are required.
• Backend commands, configuration, routes, schema, cron and queues belong to Ppl_SearchIntelligenceCore.

Admin entry: PPL Hub > PPL Search Intelligence.

Integrations And Boundaries

• Consumes only the Core block and versioned response contract.
• Does not declare database schema, routes, admin configuration, cron jobs, queues or search/ranking services.
• Conflicts with the Hyva adapter at Composer level; manual installations must also enable only one adapter.

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 docs/user_guides and docs/long_descriptions 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

• Converted the package to the thin Luma storefront adapter for Ppl_SearchIntelligenceCore.
• Removed all duplicated backend, schema, routes, configuration, cron and queue ownership.
• Added native Magento mini-search fallback when the storefront feature is disabled.
• Loads one consolidated, overlay-scoped CSS bundle only when storefront Search Intelligence is enabled.
• Reduced adapter translations to the phrases actually rendered by the Luma frontend.
• Added Magento Open Source and Adobe Commerce 2.4.9 compatibility and PPL Hub 1.3 integration.

1.2.0

• Initial release.
• Added query understanding, MySQL candidate provider, explainable ranking and product signal rebuilds.
• Added admin Test Lab, hub-only configuration sections, CLI commands, cron jobs and core schema tables.
• Added optional configurable storefront suggestions, Discovery Filters integration and read-only internal provider status.
• Search result pages use Search Intelligence as the canonical product basis for product list rendering, Discovery Filters, toolbar totals, pagination and sorting.
• Added overlay fast-path payload mapping, action payload slimming, optional payload pruning and profiler payload parity.
• Added behavior-aware ranking gates that consume aggregated behavior signals; storefront behavior collection, impression tracking and purchase/return attribution are owned by the optional Ppl_Tracking module.
• Added Smart Discovery P0 payload support as an additive, read-only overlay field.
• Added Test Lab timing help and request-path details while keeping winner/loser row backgrounds neutral and limiting colored highlights to metric cells.
• Routed Search Intelligence <-> Discovery Filters cooperation through neutral Ppl_Hub capabilities: SI exposes the canonical search product set via the Hub SearchPageProductSetProviderInterface bridge and reads facet/filter data via the Hub FilterIndexReaderInterface, instead of reading a sibling module's tables.
• Declared an explicit magento/module-cron dependency and Magento_Cron load-order sequence so the bundled cron jobs (index bootstrap/rebuild, signal rebuild, knowledge-pack compile, result-set purge, async dispatch/advance) load deterministically.
• Normalized every ranking component to a common [0,1] scale before weighting, retuned the shipped default weights, and added a data patch that calibrates stored per-scope weight overrides onto the new scale so existing merchant tuning is preserved.
• Added optional async index rebuilds that fan a catalog rebuild out to the Magento message queue (one message per product batch, version-swapped only when complete) with a transactional outbox, per-minute dispatch/advance cron jobs and a broker-availability probe; falls back to the synchronous rebuild when no broker is configured.
• Extended product signal scoring with freshness (recency), return-rate, click-through and search-conversion terms and lifted the signal scale cap so strong products no longer saturate.
• Added search smoke/profile/recall diagnostic and corpus/benchmark/seed CLI commands that exercise the live SI + Discovery Filters result path through the Hub filter-index reader.