PHPackages                             bepo/turbo-suggest - 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. bepo/turbo-suggest

ActiveShopware-platform-plugin[Search & Filtering](/categories/search)

bepo/turbo-suggest
==================

Enhance your search experience by displaying categories and landing pages prominently in the search suggestions, making it easier for customers to find what they're looking for.

0.1.2(5mo ago)3168MITPHP

Since Oct 26Pushed 5mo agoCompare

[ Source](https://github.com/vanWittlaer/BepoTurboSearch)[ Packagist](https://packagist.org/packages/bepo/turbo-suggest)[ RSS](/packages/bepo-turbo-suggest/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (6)Used By (0)

Turbo Search Suggests
=====================

[](#turbo-search-suggests)

Enhance your Shopware search experience by displaying categories and landing pages prominently in the search suggestions, making it easier for customers to find what they're looking for.

What does this plugin do?
-------------------------

[](#what-does-this-plugin-do)

When customers use your shop's search function, they typically only see product suggestions. With **Turbo Search Suggests**, you can also show relevant **categories** and **landing pages** at the top of the search dropdown.

### Example

[](#example)

Your customer types "shi" into the search bar:

- **Without this plugin**: Only shows product results
- **With this plugin**: Shows your "Shirts" category prominently at the top, followed by product suggestions

This helps customers navigate directly to the right category or landing page, improving their shopping experience and increasing conversion rates.

Features
--------

[](#features)

- Display categories in search suggestions
- Display landing pages in search suggestions
- Fully translatable titles and teaser texts
- Smart search matching (exact match and prefix match)
- Priority-based sorting (show most important results first)
- Sales channel specific configuration
- Language-specific search terms
- Active/inactive toggle for individual search terms
- Easy-to-use administration interface

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

[](#installation)

### Via Shopware Extension Store

[](#via-shopware-extension-store)

1. Open your Shopware Administration
2. Navigate to **Extensions → My extensions**
3. Search for "Turbo Search Suggests"
4. Click **Install** and then **Activate**

### Via Shopware Administration (Manual Upload)

[](#via-shopware-administration-manual-upload)

1. Download the plugin ZIP file
2. Open your Shopware Administration
3. Navigate to **Extensions → My extensions**
4. Click **Upload extension**
5. Select the downloaded ZIP file
6. Click **Install** and then **Activate**

### Via Composer

[](#via-composer)

```
composer require bepo/turbo-suggest
bin/console plugin:refresh
bin/console plugin:install --activate BepoTurboSuggest
```

How to Use
----------

[](#how-to-use)

### 1. Access the Plugin

[](#1-access-the-plugin)

In your Shopware Administration, navigate to: **Marketing → Turbo Search Suggests**

### 2. Create a Search Target

[](#2-create-a-search-target)

Click **"Add new target"** and configure:

- **Title** (optional): Override the category or landing page name shown in suggestions
- **Teaser Text** (optional): Add a short description below the title
- **Category OR Landing Page**: Select either a category or a landing page (not both)
- **Sales Channel**: Choose which sales channel this target applies to
- **Priority**: Higher numbers appear first in search results (e.g., 100 appears before 50)

### 3. Add Search Terms

[](#3-add-search-terms)

After saving your target, switch to the **"Search Terms"** tab:

1. Click **"Add search term"**
2. Enter the search term (e.g., "shirts", "mens", "socks")
3. Select the language
4. Toggle **"Active"** on/off
5. Save

**Tip**: Use complete words as search terms (e.g., "shirts", "t-shirts") - the plugin automatically matches partial inputs like "sh", "shi", or "shirt" against them. Only add multiple terms for different word variations.

### 4. Language Support

[](#4-language-support)

Both the target (title and teaser text) and search terms support multiple languages:

- Use the **language switcher** in the top bar to add translations
- Create search terms for each language your shop supports
- Translations are automatically displayed based on the customer's selected language

How Search Matching Works
-------------------------

[](#how-search-matching-works)

The plugin uses a smart two-tier matching system:

1. **Exact Match (Priority 1)**: If a search term exactly matches the customer's input, that target is shown
2. **Prefix Match (Priority 2)**: If no exact match exists, the plugin looks for terms that start with the customer's input

When multiple targets match:

- Targets with the **shortest matching term** are preferred
- Results are sorted by **priority** (highest first)

Examples
--------

[](#examples)

### Example 1: Category Suggestion

[](#example-1-category-suggestion)

**Target Configuration:**

- Category: "Men's Clothing"
- Priority: 100
- Search Terms: "men", "mens", "herren" (German)

**Result**: When customers type "men", they see "Men's Clothing" at the top of suggestions.

### Example 2: Landing Page Promotion

[](#example-2-landing-page-promotion)

**Target Configuration:**

- Landing Page: "Summer Sale 2025"
- Title: "☀️ Summer Sale"
- Teaser Text: "Up to 50% off on selected items"
- Priority: 200
- Search Terms: "summer", "sale", "sommer" (German)

**Result**: When customers type "sum", they see your prominent summer sale landing page with the custom title and teaser.

### Example 3: Multiple Categories

[](#example-3-multiple-categories)

**Target 1:**

- Category: "Women's Shirts"
- Priority: 80
- Search Terms: "shirt"

**Target 2:**

- Category: "Men's Shirts"
- Priority: 70
- Search Terms: "shirt"

**Result**: When customers type "shirt", both categories appear, with "Women's Shirts" first (higher priority).

Best Practices
--------------

[](#best-practices)

1. **Use meaningful priorities**: Reserve high numbers (100+) for your most important categories or promotions
2. **Use complete words as search terms**: The plugin matches prefixes automatically, so "shirts" will match "sh", "shi", "shirt", etc. Only add separate terms for different word variations (e.g., "shirts" and "t-shirts")
3. **Keep teaser texts short**: One sentence is usually enough
4. **Test in multiple languages**: Make sure each language has appropriate search terms
5. **Use the active toggle**: Temporarily disable search terms for seasonal campaigns without deleting them

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

[](#requirements)

- Shopware 6.6.0 or higher

Support
-------

[](#support)

For questions, feature requests, or bug reports, please contact:

- Website:
- Support:

License
-------

[](#license)

This plugin is licensed under the MIT License. See LICENSE file for details.

Credits
-------

[](#credits)

Developed by Benny Poensgen Copyright (c) 2025 B. Poensgen IT-Dienstleistungen

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance72

Regular maintenance activity

Popularity17

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity29

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 ~23 days

Total

5

Last Release

158d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/25815517?v=4)[Benny Poensgen](/maintainers/vanWittlaer)[@vanWittlaer](https://github.com/vanWittlaer)

---

Top Contributors

[![vanWittlaer](https://avatars.githubusercontent.com/u/25815517?v=4)](https://github.com/vanWittlaer "vanWittlaer (15 commits)")

### Embed Badge

![Health badge](/badges/bepo-turbo-suggest/health.svg)

```
[![Health](https://phpackages.com/badges/bepo-turbo-suggest/health.svg)](https://phpackages.com/packages/bepo-turbo-suggest)
```

###  Alternatives

[shopware/elasticsearch

Elasticsearch for Shopware

153.9M19](/packages/shopware-elasticsearch)[shopware/storefront

Storefront for Shopware

684.6M237](/packages/shopware-storefront)[shopware/production

177209.0k](/packages/shopware-production)[frosh/tools

Provides some basic things for managing the Shopware Installation

87820.7k3](/packages/frosh-tools)[shopware/administration

Administration frontend for the Shopware Core

414.3M116](/packages/shopware-administration)[adyen/adyen-shopware6

Official Shopware 6 Plugin to connect to Payment Service Provider Adyen

25117.9k](/packages/adyen-adyen-shopware6)

PHPackages © 2026

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