PHPackages                             lupasearch/prestashop-lupasearch-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search & Filtering](/categories/search)
4. /
5. lupasearch/prestashop-lupasearch-plugin

ActivePrestashop-module[Search & Filtering](/categories/search)

lupasearch/prestashop-lupasearch-plugin
=======================================

Help your website visitors turn into buyers. LupaSearch delivers accurate search results that boost your business sales.

0.6.0(3mo ago)12MITPHPPHP >=7.1

Since Sep 24Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/lupasearch/prestashop-plugin)[ Packagist](https://packagist.org/packages/lupasearch/prestashop-lupasearch-plugin)[ RSS](/packages/lupasearch-prestashop-lupasearch-plugin/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)DependenciesVersions (28)Used By (0)

LupaSearch PrestaShop plugin
============================

[](#lupasearch-prestashop-plugin)

Upgrade your PrestaShop store with our plugin that transforms your search feature. It connects to a fast, smart LupaSearch solution, making it easy for customers to find what they need quickly.

Requirements
------------

[](#requirements)

- **PHP**: >=7.1
- **PrestaShop**: compatible with PrestaShop 1.7.x - 9.x

Installation
------------

[](#installation)

### Installation steps

[](#installation-steps)

1. Download the [latest plugin version](https://github.com/lupasearch/prestashop-plugin/releases/download/latest/lupasearch.zip).
2. Log in to your PrestaShop back office.
3. Navigate to **Modules → Module Manager → Upload a module**.
4. Upload the downloaded `lupasearch.zip` file.
5. Follow the on-screen instructions to complete the installation.

### Configuration

[](#configuration)

1. Go to **Modules → Module Manager → LupaSearch integration → Configure**.
2. Enter the configuration values from your LupaSearch dashboard into the **UI Plugin Configuration Key** and **Product Index ID** fields, then click **Save**.
3. Activate the widget by setting **Enable Widget** to **Yes**.

Below is an example of how the configuration screen looks after setting up the LupaSearch plugin:

[![LupaSearch Configuration Example](https://camo.githubusercontent.com/304996b4c6fcd2efc202a2d2a001d3c82bdaeffd08be6a2bb193e4bf016c9a1c/68747470733a2f2f73746f726167652e676f6f676c65617069732e636f6d2f6c7570612d6578616d706c652d696d616765732f706c6174666f726d732f70726573746173686f702f706c7567696e2d636f6e66696775726174696f6e2d73616d706c652e706e67)](https://camo.githubusercontent.com/304996b4c6fcd2efc202a2d2a001d3c82bdaeffd08be6a2bb193e4bf016c9a1c/68747470733a2f2f73746f726167652e676f6f676c65617069732e636f6d2f6c7570612d6578616d706c652d696d616765732f706c6174666f726d732f70726573746173686f702f706c7567696e2d636f6e66696775726174696f6e2d73616d706c652e706e67)

Add custom attributes to LupaSearch product feed
------------------------------------------------

[](#add-custom-attributes-to-lupasearch-product-feed)

LupaSearch provides two hooks to allow other modules to extend product and variant data:

- `actionLupaSearchAddProductAttributes`
- `actionLupaSearchAddVariantAttributes`

These hooks let your module inject custom attributes into the LupaSearch feed, enhancing search and filtering capabilities.

### How to extend product or variant data

[](#how-to-extend-product-or-variant-data)

#### 1. Create or edit a PrestaShop module

[](#1-create-or-edit-a-prestashop-module)

Documentation:

#### 2. Register LupaSearch hooks in your module’s `install()` method

[](#2-register-lupasearch-hooks-in-your-modules-install-method)

Documentation:

```
public function install()
{
    return parent::install() &&
        $this->registerHook('actionLupaSearchAddProductAttributes') &&
        $this->registerHook('actionLupaSearchAddVariantAttributes');
}
```

#### 3. Add custom attributes to the LupaSearch feed

[](#3-add-custom-attributes-to-the-lupasearch-feed)

Documentation:

Example: Add custom attributes to products

```
public function hookActionLupaSearchAddProductAttributes($params)
{
    $productIds = $params['product_ids'] ?? [];
    $shopId = $params['shop_id'] ?? null;
    $langId = $params['language_id'] ?? null;

    $data = [];

    foreach ($productIds as $id) {
        $data[$id] = [
            'custom_label' => 'Extra info for product ' . $id,
            'rating' => rand(1, 5),
        ];
    }

    return $data;
}
```

Example: Add custom attributes to variants

```
public function hookActionLupaSearchAddVariantAttributes($params)
{
    $productIds = $params['product_ids'] ?? [];
    $combinationIds = $params['combination_ids'] ?? [];
    $shopId = $params['shop_id'] ?? null;
    $langId = $params['language_id'] ?? null;

    $data = [
        'products' => [],
        'combinations' => [],
    ];

    // Add custom attributes for simple product variants
    foreach ($productIds as $id) {
        $data['products'][$id] = [
            'variant_type' => 'simple',
            'sku_group' => 'product_' . $id,
        ];
    }

    // Add custom attributes for combination-based variants
    foreach ($combinationIds as $id) {
        $data['combinations'][$id] = [
            'variant_type' => 'combination',
            'color_label' => 'Color for combo #' . $id,
            'limited_edition' => (bool) rand(0, 1),
        ];
    }

    return $data;
}
```

For detailed guidance on setting up, reach out to our support team () who are ready to assist you with the process.

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance82

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~36 days

Recently: every ~70 days

Total

15

Last Release

92d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e731dcdb8b5eb320746e071e16e6dc71c6403eb1e2ab874485900ad476adfa7b?d=identicon)[aurzal](/maintainers/aurzal)

---

Top Contributors

[![aurzal](https://avatars.githubusercontent.com/u/101714175?v=4)](https://github.com/aurzal "aurzal (36 commits)")

### Embed Badge

![Health badge](/badges/lupasearch-prestashop-lupasearch-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/lupasearch-prestashop-lupasearch-plugin/health.svg)](https://phpackages.com/packages/lupasearch-prestashop-lupasearch-plugin)
```

###  Alternatives

[ruflin/elastica

Elasticsearch Client

2.3k50.4M203](/packages/ruflin-elastica)[opensearch-project/opensearch-php

PHP Client for OpenSearch

15024.3M65](/packages/opensearch-project-opensearch-php)[mailerlite/laravel-elasticsearch

An easy way to use the official PHP ElasticSearch client in your Laravel applications.

934529.3k2](/packages/mailerlite-laravel-elasticsearch)[massive/search-bundle

Massive Search Bundle

721.4M13](/packages/massive-search-bundle)[outl1ne/nova-multiselect-filter

Multiselect filter for Laravel Nova.

45802.7k3](/packages/outl1ne-nova-multiselect-filter)[handcraftedinthealps/zendsearch

a general purpose text search engine written entirely in PHP 5

39921.0k35](/packages/handcraftedinthealps-zendsearch)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)