# Installation

After installation and activation, **Manufacturer List and Detailpage** creates two default shopping experiences: "Manufacturer overview (default)" for the manufacturer overview and "Manufacturer detail (default)" for the manufacturer detail page. Both layouts live under the page type "Manufacturer pages (PremSoft)" and can be extended or duplicated as needed.

To make the manufacturer overview reachable in the storefront, a category must be linked to the overview layout:

* In the catalogue, create a category of type "Entry point" (or use an existing one).
* On the category's "Layout" tab, assign the "Manufacturer overview (default)" layout — filter by page type "Manufacturer pages (PremSoft)" if needed.
* In the plugin configuration, set the same category under "Select category with the manufacturer listing" so the breadcrumb on the manufacturer detail page is built correctly.

## Basic Configuration

All settings are configurable per sales channel and located under *Extensions → My Extensions → Manufacturer Liste and Detailpage → Configuration*.

### General

| Option                                 | Default | Description                                                                                                            |
| -------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------- |
| Activate plugin for this sales channel | On      | Enables or disables all storefront features for the selected sales channel.                                            |
| Hide empty letters in A-Z navigation   | Off     | When enabled, letters without any manufacturer are removed from the A-Z navigation instead of being shown as disabled. |

### Search Integration

| Option                               | Default | Description                                                                 |
| ------------------------------------ | ------- | --------------------------------------------------------------------------- |
| Show manufacturers in search suggest | Off     | Adds matching manufacturers to Shopware's standard search suggest dropdown. |
| Show manufacturer logo in suggest    | On      | Displays the manufacturer logo next to the name.                            |
| Max. manufacturers shown in suggest  | 5       | Number of manufacturers shown in the search suggest dropdown.               |

### Manufacturer Overview

| Option                                        | Default | Description                                                                                                |
| --------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| Select category with the manufacturer listing | –       | Category the overview layout is assigned to. Used to build the breadcrumb on the manufacturer detail page. |

### CMS Layouts

| Option                         | Default                         | Description                                                                                                 |
| ------------------------------ | ------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Layout for manufacturer detail | "Manufacturer detail (default)" | Layout rendered for `/manufacturer/{id}`. Only layouts of type "Manufacturer pages (PremSoft)" are offered. |

### Product Detail Page

| Option                                    | Default | Description                                                                                                  |
| ----------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------ |
| Link manufacturer on product detail pages | On      | Replaces the plain manufacturer name on the product detail page with a link to the manufacturer detail page. |


---

# 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/en/plugins/manufacturer-list-and-detailpage/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.