# Installation

Nach Installation und Aktivierung legt **Herstellerliste und Detailseite** zwei Standard-Erlebniswelten an: „Manufacturer overview (default)" für die Hersteller-Übersicht und „Manufacturer detail (default)" für die Hersteller-Detailseite. Beide Layouts liegen unter dem Page-Type „Manufacturer pages (PremSoft)" und können beliebig erweitert oder dupliziert werden.

Damit die Hersteller-Übersicht im Storefront erreichbar wird, muss eine Kategorie mit dem Übersichts-Layout verknüpft werden:

* Im Katalog eine Kategorie vom Typ „Einstiegspunkt" anlegen (oder eine bestehende verwenden).
* Im Tab „Layout" der Kategorie das Layout „Manufacturer overview (default)" zuweisen — bei Bedarf nach Page-Type „Manufacturer pages (PremSoft)" filtern.
* In der Plugin-Konfiguration unter „Kategorie mit der Hersteller-Liste auswählen" die gleiche Kategorie eintragen, damit der Breadcrumb der Hersteller-Detailseite korrekt aufgebaut wird.

## Grundlegende Konfiguration

Alle Einstellungen sind pro Verkaufskanal pflegbar und finden sich unter *Erweiterungen → Meine Erweiterungen → Herstellerliste und Detailseite → Konfiguration*.

### Allgemein

| Option                                        | Standard | Beschreibung                                                                                                             |
| --------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| Plugin für diesen Verkaufskanal aktivieren    | Ja       | Schaltet alle Storefront-Funktionen für den ausgewählten Sales Channel ein oder aus.                                     |
| A-Z Suche Elemente ohne Hersteller ausblenden | Nein     | Wenn aktiv, werden Buchstaben ohne Hersteller in der A-Z-Navigation komplett entfernt statt nur deaktiviert dargestellt. |

### Sucheinbindung

| Option                                      | Standard | Beschreibung                                                                    |
| ------------------------------------------- | -------- | ------------------------------------------------------------------------------- |
| Hersteller in der Suchvorschau anzeigen     | Aus      | Blendet passende Hersteller im Standard-Suchvorschau-Dropdown von Shopware ein. |
| Herstellerlogo in der Suchvorschau anzeigen | Ja       | Zeigt zusätzlich das Logo neben dem Herstellernamen.                            |
| Max. Hersteller in der Suchvorschau         | 5        | Anzahl der angezeigten Hersteller im Suchvorschau-Dropdown.                     |

### Hersteller-Übersicht

| Option                                       | Standard | Beschreibung                                                                                                         |
| -------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
| Kategorie mit der Hersteller-Liste auswählen | –        | Kategorie, der das Übersichts-Layout zugewiesen ist. Wird für den Breadcrumb auf der Hersteller-Detailseite genutzt. |

### CMS-Erlebniswelten

| Option                                  | Standard                        | Beschreibung                                                                                                                             |
| --------------------------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Erlebniswelt für Hersteller-Detailseite | „Manufacturer detail (default)" | Layout, das auf `/manufacturer/{id}` gerendert wird. Es werden ausschließlich Layouts vom Typ „Manufacturer pages (PremSoft)" angeboten. |

### Produktdetailseite

| Option                                       | Standard | Beschreibung                                                                                                 |
| -------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------ |
| Hersteller auf Produktdetailseiten verlinken | Ja       | Ersetzt den Klartext-Herstellernamen auf der Produktdetailseite durch einen Link zur Hersteller-Detailseite. |


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.premsoft.de/plugins/hersteller-liste-und-detailansicht/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.