> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-auf-dem-handy.md).

# Suche auf dem Handy

Die Suche auf Smartphones: vier mobile Designs, Produktdarstellung, Vorschläge und Filter im Fenster von unten.

Auf kleinen Bildschirmen braucht die Suche andere Lösungen als am Desktop: weniger Platz für Vorschläge, Filter, die nicht im Weg stehen, und Treffer, die man ohne Scrollen sieht. Dafür gibt es vier mobile Designs, die Sie auswählen können. Ohne Änderung bleibt alles wie bisher.

Die Einstellungen finden Sie in der Plugin-Konfiguration auf der Karte „Sucheinstellungen“.

## Die Schwellen

Zwei Bildschirmbreiten sind wichtig:

* **Unter 768 Pixel** gelten die mobilen Designs, die Produktdarstellung und die Anzahl der Vorschläge für Mobilgeräte.
* **Unter 992 Pixel** gilt die Einstellung „Filter auf Mobilgeräten“. Bei einem neuen mobilen Design gilt sie im Such-Fenster nur noch zwischen 768 und 991 Pixel.

Die Schwelle von 768 Pixel wird beim Öffnen der Seite festgelegt. Verändert oder dreht ein Kunde danach das Fenster, ändert sich ein bereits offenes Such-Fenster nicht mehr.

Die mobilen Designs wirken nicht im Layout „Natives Shopware-Design“, weil es dort kein Such-Fenster des Plugins gibt.

## Design auf Mobilgeräten

Einstellung: „Design auf Mobilgeräten“ (Standard: „Wie bisher“).

| Design             | Beschreibung                                                                                                                                                                                                                           | Empfehlung                                                                  |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| „Wie bisher“       | Die bisherige Darstellung: Vorschläge als Auswahl-Knöpfe, Filter nach der Einstellung „Filter auf Mobilgeräten“.                                                                                                                       | Wenn Sie nichts ändern möchten.                                             |
| „Kompakte Leisten“ | Vorschläge stehen in einer Zeile zum Wischen. Filter öffnen über einen Knopf „Filter“ mit der Zahl aktiver Filter, die aktiven Filter stehen in einer eigenen Zeile. Die Filter öffnen sich in einem Fenster von unten.                | Guter Mittelweg für die meisten Shops mit Filtern.                          |
| „Treffer zuerst“   | Vorschläge erscheinen nur, wenn es keine Treffer gibt. Filter öffnen über einen festen Knopf unten, aktive Filter stehen oben.                                                                                                         | Wenn Kunden vor allem schnell Produkte sehen sollen.                        |
| „Wie eine App“     | Höchstens 3 Vorschläge als schlichte Textzeilen, darunter eine wischbare Zeile mit einem Knopf je Filtergruppe (zum Beispiel „Marke (2)“, wenn zwei Marken gewählt sind). Ein Tipp öffnet nur diese Gruppe in einem Fenster von unten. | Shops mit klar gegliederten Filtern, die sich wie eine App anfühlen sollen. |

Bei den drei neuen Designs ist der Kopfbereich kompakter. **Kategorien, Seiten und Banner (aus einer Suchbegriff-Regel) sowie der Hinweis bei gelockerter Suche stehen unter den Produkten**, damit die Treffer ohne Scrollen sichtbar sind.

Die neuen Designs zeigen Filter nur, wenn „Aktiviert die Filter in der Suche“ an ist.

## Produkte auf Mobilgeräten

Einstellung: „Produkte auf Mobilgeräten“ (Standard: „Automatisch wie bisher“).

| Auswahl                  | Wirkung                                                                                                                                                                                                                |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| „Automatisch wie bisher“ | Die Raster (detailliert und kompakt) werden mobil zur Liste. „Kompakte Liste“ und „Karussell“ bleiben, wie sie sind.                                                                                                   |
| „Liste“                  | Kompakte Liste für jedes Layout, auch das Karussell.                                                                                                                                                                   |
| „2er-Raster mit Kacheln“ | Zwei feste Spalten mit Standard-Karten, quadratisches Bild, Name höchstens zwei Zeilen, nur das erste Badge, ohne Schnellansicht-Knopf, kleinere Rundung. Der Untertitel bleibt, der Warenkorb-Knopf bleibt (kleiner). |

**Empfehlung:** Das 2er-Raster zeigt viele Produkte auf einen Blick und passt zu bildstarken Sortimenten. Die Liste ist besser, wenn Namen lang sind.

## Anzahl der Vorschläge auf Mobilgeräten

Einstellung: „Anzahl Vorschläge auf Mobilgeräten“ (Standard: leer, erlaubt 0 bis 10).

* **Leer:** wie „Anzahl Suchvorschläge“.
* **0:** keine Vorschläge, solange es Treffer gibt.
* **1 bis 10:** diese Zahl.

Gibt es keine Treffer, bleiben alle Vorschläge stehen, denn dann sind sie die beste Hilfe. Ein Hinweis auf einen Tippfehler bleibt immer sichtbar. „Treffer zuerst“ begrenzt die Vorschläge auf 0, „Wie eine App“ auf höchstens 3, auch bei einer höheren Einstellung.

## Filter auf Mobilgeräten

Einstellung: „Filter auf Mobilgeräten“ (Standard: „Anzeigen wie bisher“). Sie gilt für Bildschirme unter 992 Pixel und, solange ein mobiles Design gewählt ist, im Such-Fenster nur zwischen 768 und 991 Pixel.

* **„Anzeigen wie bisher“:** Die Filter stehen im Fenster über den Treffern.
* **„Hinter einem Filter-Knopf einklappen“:** Zuerst kommen die Treffer. Ein Knopf „Filter“, mit der Zahl aktiver Filter wie „Filter (2)“, klappt die Filter auf.
* **„Ausblenden“:** Im Fenster gibt es keine Filter. Aktive Filter bleiben als entfernbare Auswahl mit „Zurücksetzen“ sichtbar. Auf der Suchergebnisseite von Shopware entfällt dann der Knopf „Filter“, solange kein Filter aktiv ist.

## Das Filter-Fenster von unten

Bei den neuen Designs öffnen sich die Filter in einem Fenster, das von unten hochfährt:

* Titel „Filter“, bei „Wie eine App“ der Name der Gruppe.
* Schließen über „×“.
* Unten „Zurücksetzen“ (nur bei aktiven Filtern) und der Knopf „128 Treffer anzeigen“, der das Fenster schließt und die aktuelle Trefferzahl nennt.
* Esc schließt nur dieses Fenster, nicht das Such-Fenster.
* Der Hintergrund scrollt nicht mit. Der Fokus geht beim Öffnen auf den Titel und beim Schließen zurück auf den Knopf, der das Fenster geöffnet hat.

## Weitere Besonderheiten

* Das Logo erscheint unter 768 Pixel nicht im Fenster.
* Bei wiederhergestellter Suche öffnet sich auf Touch-Geräten die Bildschirmtastatur nicht von selbst.
* Der Shopping-Assistent zeigt in Warenkorb und Kasse keinen Knopf „Beratung“.

{% hint style="info" %}
Die Einstellung „Basis-Styling durch Custom CSS ersetzen“ lässt die Regeln für „Filter auf Mobilgeräten“ und die mobilen Designs absichtlich unberührt. Ein eigenes Stylesheet zerstört also nicht das Filter-Fenster von unten oder die Leisten. Mehr dazu unter [Design anpassen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/design-anpassen.md).
{% endhint %}

## Empfehlung zum Start

1. Schalten Sie „Aktiviert die Filter in der Suche“ ein, wenn Sie Filter anbieten.
2. Wählen Sie „Kompakte Leisten“ als Design und „2er-Raster mit Kacheln“ für die Produkte.
3. Prüfen Sie die Suche auf einem echten Handy mit einem Begriff mit vielen und einem ohne Treffer.
4. Passen Sie die Anzahl der Vorschläge an, wenn sie zu viel Platz einnehmen.

## Weiterlesen

{% content-ref url="/pages/OXAoj5NTuVjQy9UJJi7n" %}
[Die Suche im Shop](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-im-shop.md)
{% endcontent-ref %}

{% content-ref url="/pages/vHbSYnjIL0wgwKxanyHw" %}
[Filter](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/filter.md)
{% endcontent-ref %}

{% content-ref url="/pages/ceNUx96ZlKkPq7TqlNY8" %}
[Design anpassen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/design-anpassen.md)
{% endcontent-ref %}

{% content-ref url="/pages/Ldiml6Xb2DKBYoCOFNLC" %}
[Plugin Einstellungen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/plugin-einstellungen.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-auf-dem-handy.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
