Meili Search Webshop

LicenseStablePHPIssuesMerge Requests

Description

Meili Search Webshop connects the Enso webshop filtering layer to Meilisearch.

When the application uses scout.driver=meilisearch and the base Meili Search integration is enabled, the package replaces the default database-backed webshop product and category filters with Meilisearch-backed implementations. It also keeps EAV-driven filters synchronized with the searchable catalog.

The package does not expose its own HTTP API or UI. It extends the existing webshop flow by rebinding filter services, swapping sorts, and reacting to EAV attribute updates.

Installation

Install the package:

composer require laravel-enso/meili-search-webshop

Make sure the host application already has:

  • laravel-enso/meili-search installed and enabled
  • a working Laravel Scout + Meilisearch configuration
  • indexed webshop products

No additional routes or published assets are required by this package.

Features

  • Switches webshop product filtering to Meilisearch-backed pagination and facet filtering.
  • Switches category filter resolution to Meilisearch facet distributions.
  • Swaps the webshop sorts enum when Meilisearch search is active.
  • Observes EAV attribute updates and queues EAV filter refresh jobs.
  • Chains EAV filter updates with product attribute resynchronization.

Usage

Once Meili Search is enabled in the base integration settings and the Scout driver is set to meilisearch, the package bindings are applied automatically.

The category and product filter providers are resolved lazily and fall back to the core database implementations when the integration is disabled.

EAV attributes marked as filterable are pushed into the Meilisearch-backed webshop filtering layer through the queued UpdateEavFilters job and the attribute observer chain.

API

Service bindings

When Meili Search is active, the package replaces these webshop services:

  • product filter provider
  • category filter provider
  • sorts enum provider

Queue jobs

  • LaravelEnso\\MeiliSearchWebshop\\Jobs\\UpdateEavFilters
  • LaravelEnso\\ProductEav\\Jobs\\SyncAttributeProducts

Behavior:

  • reads the current EAV attribute configuration
  • refreshes the derived webshop filter structure
  • re-synchronizes affected product attribute payloads

Depends On

Required Enso packages:

Edit this page on GitHub
Last Updated: 4/20/2026, 5:43:20 PM