> For the complete documentation index, see [llms.txt](https://docs.premsoft.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.premsoft.de/en/plugins/manufacturer-list-and-detailpage/installation.md).

# 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
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 dynamically by asking a question.

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

```
GET https://docs.premsoft.de/en/plugins/manufacturer-list-and-detailpage/installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.