README

SPONSOR: Amadeco

This module by Amadeco extends Smile ElasticSuite (https://github.com/Smile-SA/elasticsuite) to add an advanced stock filter in the layered navigation.

PR to reimplement "quantity_and_stock_status" product attribute (currently open) : magento/magento2#40425 (comment)

Features

• Adds a dedicated stock filter in the layered navigation
• Intelligent handling of stock status based on Magento's backorders configuration
• Improves user experience by showing accurate product availability
• Provides clear "In Stock" and "Out of Stock" filter options
• Fully compatible with Magento's MSI (Multi-Source Inventory)

Installation

composer require amadeco/module-elasticsuite-stock
bin/magento module:enable Amadeco_ElasticsuiteStock
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean
bin/magento indexer:reindex catalogsearch_fulltext

Requirements

• PHP 8.3+
• Magento 2.4.x
• Smile ElasticSuite 2.12.0 or higher (introduces the layered-navigation filter TypeProviderInterface)

Configuration

Go to Stores > Configuration > ElasticSuite > Stock Filter

Configure the following options:

• Display Out Of Stock Filter: When enabled, shows the "Out of Stock" option in the layered navigation. When disabled, only the "In Stock" option is shown.

Usage

After installation and configuration, the stock filter will automatically appear in the layered navigation on category pages and search results pages (remember to reindex after installation).

How It Works

Smart Stock Status Determination

This module creates an indexed attribute stock_status that handles stock differently based on your Magento configuration:

When Backorders are Disabled

• Uses Magento's native stock status logic
• Products are either in stock or out of stock, as determined by Magento's inventory system

When Backorders are Enabled

• Enhanced behavior: Determines availability based on actual quantity
• Products with quantity > 0 are marked as "In Stock"
• Products with quantity ≤ 0 are marked as "Out of Stock" (even if Magento would allow them to be ordered)
• This gives customers a clearer view of which products have physical inventory

Filter Options in Layered Navigation

The filter provides these options:

1. In Stock:

   • Shows products with positive inventory when backorders are enabled
   • Follows standard Magento stock status rules when backorders are disabled

2. Out of Stock (can be hidden via configuration):

   • Shows products with zero or negative inventory when backorders are enabled
   • Shows products marked as out of stock when backorders are disabled

This approach helps customers find products based on actual availability while respecting your inventory settings.

Technical Details

Stock Data Implementation

This module leverages the existing stock.is_in_stock and stock.qty fields from quantity_and_stock_status attribute and creates a derived stock_status field that combines this information intelligently.

Instead of relying on Magento's quantity_and_stock_status attribute (which has limitations for filtering ; see reported issue: magento/magento2#33453), our module:

• Creates a dedicated filterable attribute for stock status
• Applies specific logic when backorders are enabled to show actual inventory status
• Integrates seamlessly with ElasticSuite's facet filtering system

Compatibility with Other ElasticSuite Modules

Filter registration: TypeProvider pattern (no FilterList override)

This module has no dependency on Smile_ElasticsuiteRating and does not override Smile\ElasticsuiteCatalog\Model\Layer\FilterList.

The stock renderer is registered through the core ElasticSuite filterTypeProviders pool. Smile\ElasticsuiteCatalog\Model\Layer\FilterList::getAttributeFilterClass() iterates every injected Smile\ElasticsuiteCatalog\Api\Layer\Filter\TypeProviderInterface and lets it swap the filter class for its attribute. We provide one for stock_status:

<type name="Smile\ElasticsuiteCatalog\Model\Layer\FilterList">
    <arguments>
        <argument name="filterTypeProviders" xsi:type="array">
            <item name="stock" xsi:type="object">Amadeco\ElasticsuiteStock\Model\Layer\Filter\TypeProvider\Stock</item>
        </argument>
    </arguments>
</type>

Because the core categoryFilterList and searchFilterList virtual types extend that base type, they inherit the provider automatically — no preference, no virtual-type override, and no module load-order constraint against other filter modules.

Earlier versions extended FilterList and added a second preference over Smile\ElasticsuiteRating\Model\Layer\FilterList to resolve a preference conflict. Both the rating module (PR #19) and this module have since migrated to the TypeProvider pattern, so the conflict — and the dependency — no longer exist. Multiple filter modules now coexist cleanly because each only appends its own provider to the shared pool.

License

This module is licensed under the Open Software License ("OSL") v3.0. See the LICENSE.txt file for details.