PHPackages                             makaira/shopware6-connect-frontend - 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. [Utility & Helpers](/categories/utility)
4. /
5. makaira/shopware6-connect-frontend

ActiveShopware-platform-plugin[Utility & Helpers](/categories/utility)

makaira/shopware6-connect-frontend
==================================

Makaira Connect Frontend

1.9.21(8mo ago)0100[2 PRs](https://github.com/MakairaIO/shopware-connect-frontend/pulls)GPL-3.0JavaScriptCI passing

Since Apr 15Pushed 2mo ago3 watchersCompare

[ Source](https://github.com/MakairaIO/shopware-connect-frontend)[ Packagist](https://packagist.org/packages/makaira/shopware6-connect-frontend)[ RSS](/packages/makaira-shopware6-connect-frontend/feed)WikiDiscussions stable Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (49)Used By (0)

Makaira Connect Frontend
========================

[](#makaira-connect-frontend)

[![Version](https://camo.githubusercontent.com/247d20b1cd93595cca6f995de4fe8c64533a7f4d3f29a8744936e55040b62115/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f4d616b61697261494f2f73686f70776172652d636f6e6e6563742d66726f6e74656e643f636f6c6f723d626c7565)](https://camo.githubusercontent.com/247d20b1cd93595cca6f995de4fe8c64533a7f4d3f29a8744936e55040b62115/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f4d616b61697261494f2f73686f70776172652d636f6e6e6563742d66726f6e74656e643f636f6c6f723d626c7565) [![Packagist Version](https://camo.githubusercontent.com/b1fe0d6dd205bcbae0b374ab3016490b67f56a2075b6af1d28a0774ebe0c2894/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d616b616972612f73686f7077617265362d636f6e6e6563742d66726f6e74656e64)](https://packagist.org/packages/makaira/shopware6-connect-frontend)

🎯 Purpose
---------

[](#-purpose)

The **Makaira Connect Frontend** module integrates the Makaira API client into Shopware, enabling advanced features such as product listings, search, autosuggest, and personalized recommendations. This module enhances the Shopware storefront by leveraging Makaira's powerful API capabilities to deliver a seamless and optimized shopping experience.

---

✨ Key Features
--------------

[](#-key-features)

- 🔍 **Search Integration**: Provides fast and accurate product search powered by the Makaira API.
- 💡 **Autosuggest**: Offers real-time search suggestions to improve user experience.
- 🛒 **Product Listings**: Displays product data fetched directly from the Makaira API.
- 🎯 **Recommendations**: Delivers personalized product recommendations based on user behavior and preferences.
- 🌐 **API Client**: A robust client for interacting with the Makaira platform.

---

⚙️ Installation
---------------

[](#️-installation)

To install the **Makaira Connect Frontend** module in your Shopware 6 environment, follow these steps:

1. **Install via Composer**:

    ```
    composer require makaira/shopware6-connect-frontend
    ```
2. **Activate the Plugin**:

    - After installation, activate the plugin by running: ```
        bin/console plugin:install --activate MakairaConnectFrontend
        ```
3. **Configure the Plugin**:

    - Navigate to the Shopware administration panel.
    - Go to **Settings > Plugins > Makaira Connect Frontend**.

---

⚙️ Configuration
----------------

[](#️-configuration)

The following configuration options are available for the Makaira Connect Frontend module:

### General Settings

[](#general-settings)

1. **Base URL of Makaira API**:

    - **Key**: `makairaBaseUrl`
    - **Description**: The base URL of the Makaira API.
    - **Default Value**: `https://.makaira.io`
    - **Help Text**: The URL of your Makaira account in the format `https://.makaira.io`.
2. **Makaira Instance**:

    - **Key**: `makairaInstance`
    - **Description**: The instance name for Makaira (e.g., live or staging).
    - **Placeholder**: e.g., live
    - **Help Text**: Please set the Makaira instance name to connect the data provider.
3. **API Timeout**:

    - **Key**: `apiTimeout`
    - **Description**: The timeout for API requests in seconds.
    - **Default Value**: `5`
    - **Help Text**: Set the timeout for API requests in seconds.

---

### Search Settings

[](#search-settings)

1. **Use for Product Lists**:

    - **Key**: `useForProductLists`
    - **Description**: Whether to use Makaira for category product listings.
    - **Default Value**: `false`
    - **Help Text**: Enable this option to use Makaira for category product listings.
2. **Use for Search**:

    - **Key**: `useForSearch`
    - **Description**: Whether to use Makaira for search functionality.
    - **Default Value**: `false`
    - **Help Text**: Enable this option to use Makaira for search functionality.
3. **Use for Autosuggest**:

    - **Key**: `useForSuggest`
    - **Description**: Whether to use Makaira for autosuggest functionality.
    - **Default Value**: `false`
    - **Help Text**: Enable this option to use Makaira for autosuggest functionality.

---

### Recommendation Settings

[](#recommendation-settings)

1. **Use for Recommendations**:

    - **Key**: `useForRecommendation`
    - **Description**: Whether to use Makaira for product recommendations.
    - **Default Value**: `false`
    - **Help Text**: Enable this option to use Makaira for product recommendations.
2. **Recommendation ID**:

    - **Key**: `recommendationId`
    - **Description**: The ID for the recommendation configuration to use for cross-selling.
    - **Placeholder**: Enter recommendation ID
    - **Help Text**: Provide the ID for the recommendation configuration to use for cross-selling.
3. **Recommendation Product Limit**:

    - **Key**: `recommendationProductLimit`
    - **Description**: The maximum number of products to return from the Makaira recommendation.
    - **Default Value**: `10`
    - **Minimum Value**: `1`
    - **Help Text**: Set the maximum number of products to return from the Makaira recommendation.

---

### How to Configure

[](#how-to-configure)

1. Navigate to the Shopware administration panel.
2. Go to **Settings > Plugins > Makaira Connect Frontend**.
3. Fill in the required fields for each sales channel:
    - Base URL of Makaira API
    - Makaira Instance
    - API Timeout
    - Use for Product Lists
    - Use for Search
    - Use for Autosuggest
    - Use for Recommendations
    - Recommendation ID
    - Recommendation Product Limit
4. Save the configuration.

💡 **Note**: Ensure that the `Makaira Instance` values are set individually for each sales channel.

---

🛠️ Development Setup
--------------------

[](#️-development-setup)

1. `git clone git@github.com:MakairaIO/shopware-connect-frontend`
2. `make init`

### Useful Commands

[](#useful-commands)

- Start project: `make up`
- Stop project: `make down`
- SSH to container: `make ssh`

---

### 📢 Events

[](#-events)

The **Makaira Connect Frontend** module provides several events that can be used to customize the request sent to the Makaira API. Below is a list of available events:

#### `ModifierQueryRequestEvent`

[](#modifierqueryrequestevent)

This event allows you to modify the query before it is sent to the Makaira API.

- **Class**: `MakairaConnectFrontend\Events\ModifierQueryRequestEvent`
- **Namespace**: `MakairaConnectFrontend\Events`
- **Event Names**:
    - `makaira.request.modifier.query.search`: Triggered for search queries.
    - `makaira.request.modifier.query.autosuggester`: Triggered for autosuggest queries.
    - `makaira.request.modifier.query.category`: Triggered for category-based search queries.
    - `makaira.request.modifier.query.recommendation`: Triggered for recommendation queries.
- **Methods**:
    - `getQuery(): \ArrayObject`: Returns the query as an `ArrayObject` for modification.

**Usage Example**:

```
use MakairaConnectFrontend\Events\ModifierQueryRequestEvent;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

class CustomQueryModifierSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [
            ModifierQueryRequestEvent::NAME_SEARCH => 'onSearchQueryModify',
        ];
    }

    public function onSearchQueryModify(ModifierQueryRequestEvent $event): void
    {
        $query = $event->getQuery();
        $query['customFilter'] = 'value'; // Add custom filter to the query
    }
}
```

💡 **Note**: You can subscribe to these events in your custom plugin to modify the query dynamically.

---

🛠️ Shopware Compatibility
-------------------------

[](#️-shopware-compatibility)

The **Makaira Connect Frontend** module is compatible with the following Shopware versions:

Shopware VersionSupported6.5✅ Supported6.6✅ Supported💡 **Note**: Ensure your Shopware installation matches one of the supported versions for optimal compatibility.

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance72

Regular maintenance activity

Popularity9

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 56.2% 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 ~3 days

Total

46

Last Release

266d ago

### Community

Maintainers

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

---

Top Contributors

[![BenjaminJoergerMakaira](https://avatars.githubusercontent.com/u/170419041?v=4)](https://github.com/BenjaminJoergerMakaira "BenjaminJoergerMakaira (59 commits)")[![semantic-release-bot](https://avatars.githubusercontent.com/u/32174276?v=4)](https://github.com/semantic-release-bot "semantic-release-bot (45 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (1 commits)")

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/makaira-shopware6-connect-frontend/health.svg)

```
[![Health](https://phpackages.com/badges/makaira-shopware6-connect-frontend/health.svg)](https://phpackages.com/packages/makaira-shopware6-connect-frontend)
```

###  Alternatives

[hisorange/browser-detect

Browser & Mobile detection package for Laravel.

1.1k10.1M50](/packages/hisorange-browser-detect)[frosh/tools

Provides some basic things for managing the Shopware Installation

79709.7k2](/packages/frosh-tools)[frosh/development-helper

Development Helper

90286.1k](/packages/frosh-development-helper)[beacon-hq/bag

A comprehensive immutable value objects implementation

1789.1k3](/packages/beacon-hq-bag)[shopware-pwa/shopware-pwa

Shopware PWA extension

4074.0k](/packages/shopware-pwa-shopware-pwa)[swag/migration-assistant

Migration plugin for shopware/platform

2036.3k](/packages/swag-migration-assistant)

PHPackages © 2026

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