Hersteller Professional: Hersteller-Seiten in Shopware 6 einrichten

Q: Wo stelle ich den Basispfad /hersteller/ ein?

Nicht im Plugin-Formular, sondern als Textbaustein cbaxManufacturer.basisPathSnippet unter Einstellungen → Shop → Textbausteine. Leeres Feld = Fallback hersteller.

Q: Warum ist meine Marke unter zwei URLs erreichbar?

Das Plugin legt zusätzlich zur kanonischen /hersteller/marke/ eine Kurzform /marke/ an. Die Kurzform ist per Canonical geregelt; wer Crawl-Budget schonen will, leitet sie zusätzlich per 301 auf die Langform um.

Lesezeit: 9 Min · getestet auf Shopware 6.7.x

Kurz erklärt: Shopware 6 hat – anders als Shopware 5 – im Standard keine eigenen Hersteller-/Markenseiten mehr. Das Plugin Hersteller Professional von coolbax (technischer Paketname CbaxModulManufacturers), eine über 1.000-fach installierte Erweiterung, schließt diese Lücke: Es erzeugt eine Hersteller-Übersichtsseite, eine Detailseite pro Marke, eigene Erlebniswelten-Blöcke und trägt die Hersteller-URLs in die Sitemap ein. Dieser Eintrag ist die vollständige Einrichtungs-Referenz.

Auf einen Blick

Plugin	Hersteller Professional (von coolbax, 1.000+ Installationen)
Anbieter	coolbax · Plugin-ID `cbax951420758690m`
Getestet auf	Shopware 6.7.x · Plugin-Version 5.0.9
Was es löst	Fehlende Hersteller-/Markenseiten im SW6-Standard
Übersichtsseite	`/hersteller/` mit A–Z-Navigation
Detailseite	`/hersteller/markenname/` pro Marke
Worauf achten	Kurz- und Langform der URL (Canonical ist gesetzt) – optionale 301-Konsolidierung fürs Crawl-Budget

Was das Plugin macht

Erstellt automatisch eine Hersteller-Übersichtsseite (/hersteller/) mit A–Z-Navigation.
Erstellt automatisch eine Hersteller-Detailseite pro Marke (/hersteller/markenname/).
Verlinkt Hersteller-Logos auf Produktdetailseiten automatisch mit der jeweiligen Herstellerseite.
Erweitert die Ajax-Suche um Hersteller-Treffer.
Integriert Breadcrumbs (Basis für Rich Snippets).
Fügt die Hersteller-Links in die sitemap.xml ein.
Bietet eigene Erlebniswelten-Blöcke für freie Gestaltung von Übersicht und Detailseite.

Plugin installieren & aktivieren

Shopware Admin → Erweiterungen → Meine Erweiterungen.
Plugin suchen: CbaxModulManufacturers.
Installieren → Aktiv schalten.
Drei-Punkte-Menü → Konfiguration öffnen.

Nach der Aktivierung erscheinen im Admin zwei neue Bereiche: Kataloge → Hersteller (erweiterte Felder) und Inhalte → Erlebniswelten (neue Vorlagen-Typen „Coolbax Hersteller“). Fehlen Typ oder Vorlagen, Plugin einmal deaktivieren und erneut aktivieren.

Allgemeine Einstellungen

Einstellung	Bedeutung
Aktiv	Plugin für den Verkaufskanal an/aus.
Sitemap erstellen	Hersteller-URLs werden in die `sitemap.xml` aufgenommen. Voraussetzung: „Produktanzahl Berechnung“ muss kurzzeitig auf Aus Datenbank stehen.
Anzeigefilter	Alle Hersteller anzeigen – oder nur jene mit aktiven Produkten.
Produktanzahl Berechnung	Live (langsamer, immer aktuell) oder Aus Datenbank (schneller, alle 4 h per Scheduled Task aktualisiert).
Hersteller-Tab auf Detailseite	Zeigt nach dem „Beschreibung“-Tab einen Tab „Infos zum Hersteller“ mit Beschreibung + Link zur Herstellerseite.
Herstellerlink in neuem Tab öffnen	Link zur Herstellerseite öffnet in neuem Browser-Tab.

Produktanzahl manuell aktualisieren (API-Endpunkt):

https://meinshop.de/api/cbax/manufacturer/runProductCount

SEO-URL-Einstellungen

SEO-URLs werden automatisch 1× täglich generiert; manuelle Generierung ist jederzeit möglich.

Einstellung	Bedeutung / Beispiel
SEO-Basispfad zur Übersicht	Name der Übersichtsseite, z. B. `hersteller` → `/hersteller/`.
SEO-Basispfad auch für Herstellerseiten	Präfix vor dem Herstellernamen, z. B. `/hersteller/vivobarefoot/`.
Slash am Ende der URL	Trailing Slash – ja empfohlen (konsistent halten!).
SEO-URLs generieren	Button: neue Hersteller bekommen URLs. Bestehende werden nicht überschrieben.
Alle SEO-URLs löschen	Button: kompletter Reset – danach sofort neu generieren.

Wichtig – Basispfad steckt in einem Textbaustein, nicht im Formular: Der SEO-Basispfad wird über Einstellungen → Shop → Textbausteine gesetzt, Key cbaxManufacturer.basisPathSnippet. Ist das Feld leer, gilt der Fallback hersteller.

Nach Basispfad-Änderung: erst Alle SEO-URLs löschen, dann neu generieren – sonst werden bereits erzeugte URLs nicht aktualisiert.

Ajax-Suche erweitern

Einstellung	Bedeutung
Aktiv	Hersteller erscheinen in der Suchvorschau.
Maximale Anzahl	Wie viele Hersteller maximal gezeigt werden.
Ab Bildschirmgröße	Ab welcher Viewport-Breite die Erweiterung aktiv ist.
Maximale Breite in px	Breite des Vorschlag-Containers.

Kompatibel mit dem Lexikon/Glossar-Plugin von coolbax (beide erweitern die Ajax-Suche gleichzeitig).

Meta / Robots

Zwei Einstellungen steuern das Crawler-Verhalten: Robots-Meta-Tag Übersicht (für /hersteller/) und Robots-Meta-Tag Detailseiten (für /hersteller/[name]/).

Wert	Wirkung
`index,follow`	Seite indexieren, Links folgen – Standard für Hersteller-Seiten.
`noindex,follow`	Nicht indexieren, aber Links folgen.

Erlebniswelten zuweisen

Ab Plugin-Version 1.1.5 werden Übersichts- und Detailseiten vollständig über Erlebniswelten gestaltet.

Inhalte → Erlebniswelten → Typ „Coolbax Hersteller“ wählen.
Vorlagen Coolbax Hersteller Übersicht und Coolbax Hersteller Detail duplizieren (Original nie direkt bearbeiten).
Duplikat bearbeiten.
In den Plugin-Einstellungen unter Erlebniswelten (CMS) zuweisen: CMS-Page für die Übersichtsseite und CMS-Page für die Standard-Detailseite.

Einzelne Hersteller können im Hersteller-Modul eine abweichende Erlebniswelt bekommen (ab Version 2.0.1).

Hersteller-Modul: Zusatzfelder

Kataloge → Hersteller → [Hersteller] → Bearbeiten. Das Plugin erweitert das Standard-Formular:

Feld	Bedeutung
Hersteller ausblenden	Wird nicht in Listing, Sidebar und Slider angezeigt.
Top Hersteller	Erscheint im Top-Hersteller-Slider.
Banner Media	Banner wird auf der Detailseite angezeigt.
Nicht anzeigen in Verkaufskanälen	Hersteller aus Listing, Suche und Slider in bestimmten Kanälen ausschließen.
Alternatives Layout	Andere Erlebniswelt als die Standard-Zuweisung.
Alternative URL	Leitet auf externe URL / Landingpage statt auf die cbax-Seite.
Meta-Titel / -Keywords / -Description	SEO-Felder für diesen einzelnen Hersteller.

Die SEO-Optimierung der Übersichtsseite erfolgt dagegen über Textbausteine (siehe unten), nicht hier.

Erlebniswelten-Blöcke im Detail

Plugin-eigene Blöcke erkennt man am grünen Icon oben rechts im Block. Es gibt drei Block-Kategorien: Coolbax Hersteller (Übersicht + Detail + Produktdetailseite), Coolbax Hersteller Übersicht und Coolbax Hersteller Detail.

Block	Funktion (wichtigste Optionen)
Hersteller Navigation	A–Z-Buchstabennavigation oben auf der Übersicht. Optionen: Scroll-Verhalten, Scroll-Geschwindigkeit (ms), Scroll-Abstand (px).
Hersteller Filter	Alphabetische Sidebar mit aufklappbaren Buchstabengruppen. Optionen: Headline ausblenden, aktive Gruppe offen, Produktanzahl anzeigen.
Hersteller Listing	Hersteller-Kacheln. Optionen: Darstellung (Name / Logo / Logo+Name), Template (2/3/4-spaltig oder Slider), Box-Höhe, Artikelanzahl.
Hersteller Banner	Zeigt das beim Hersteller hinterlegte Banner. Optionen: Fallback-Banner, Anzeigemodus (Standard/Füllen/Beibehalten), Mindesthöhe, Link-Ziel.
Hersteller Headline	Text vor/nach dem Herstellernamen, z. B. „Alle Produkte von … im Überblick“.
Hersteller Slider (Top)	Ausgewählte Hersteller als Karussell. Quelle: Hersteller einer Kategorie, manuelle Auswahl oder alle „Top Hersteller“.
Hersteller Produktslider	Nur auf der Produktdetailseite – weitere Produkte des Herstellers. Optionen: Headline, Logo+Beschreibung, kategoriebezogen, Varianten, Sortierung, Limit.
Hersteller Bild-Text (flexible Spalten)	Kombination aus Hersteller-Bild und Beschreibungstext, frei spaltig.

Hersteller-Menüpunkt in der Navigation einbinden

Das Plugin legt keinen Navigationseintrag automatisch an – der Menüpunkt muss manuell erstellt werden. Empfohlener Weg über eine Link-Kategorie:

Kataloge → Kategorien → Neue Kategorie.
Name: Hersteller oder Marken.
Kategorietyp: Link · Linktyp: Extern · URL: /hersteller/.
Kategorie in die gewünschte Navigationsebene einordnen.

Wichtig: Der Kategoriename darf nicht identisch mit dem SEO-Basispfad sein, sonst entsteht ein URL-Konflikt. Bei Basispfad hersteller also z. B. Marken oder Alle Hersteller als Kategorienamen wählen.

Navigationsänderungen niemals per SQL/phpMyAdmin direkt in die category-Tabellen schreiben – nur über Inhalte → Navigation. Direkte DB-Manipulation kann das System inkonsistent machen.

SEO-Textbausteine der Übersichtsseite

Einstellungen → Shop → Textbausteine, dann suchen:

Textbaustein-Key	Bedeutung
`cbaxManufacturer.page.index.allManufacturers`	Meta-Titel der Übersichtsseite.
`cbaxManufacturer.page.index.metaKeywords`	Meta-Keywords der Übersichtsseite.
`cbaxManufacturer.page.index.metaDescription`	Meta-Description der Übersichtsseite.
`cbaxManufacturer.basisPathSnippet`	SEO-Basispfad (Standard: `hersteller`).

Technische Details: URL-Generierung & Datenbank

Das Plugin schreibt seine URLs direkt in Shopwares seo_url-Tabelle. Route-Namen:

frontend.cbax.manufacturer.index – Übersichtsseite.
frontend.cbax.manufacturer.detail – Detailseiten.

Canonical-Verhalten: Die kanonische URL (is_canonical = 1) ist /hersteller/markenname/. Zusätzlich legt das Plugin eine nicht-kanonische Kurzform /markenname/ als Alias an (is_canonical = NULL). Wer die Alias-Pfade zusätzlich per 301 konsolidieren möchte (Crawl-Budget), findet das Vorgehen im Praxisbericht (siehe nächster Abschnitt). Zusätzlich kann der Canonical-Tag der Detailseiten auf den internen Routing-Pfad statt die SEO-URL zeigen – das korrigiert man update-sicher per Twig-Override des Blocks layout_head_canonical (Details im Praxisbericht).

Alle cbax-Hersteller-Routen anzeigen:

SELECT route_name, seo_path_info, is_canonical, is_deleted
FROM seo_url
WHERE route_name LIKE '%cbax%'
ORDER BY seo_path_info ASC;

Alle Duplikat-Paare (Kurz- vs. Langpfad) ermitteln:

SELECT
  su_short.seo_path_info AS kurze_url,
  su_long.seo_path_info  AS lange_url
FROM seo_url su_short
JOIN seo_url su_long
  ON su_short.path_info = su_long.path_info
  AND su_long.seo_path_info LIKE 'hersteller/%'
  AND su_long.is_canonical = 1
  AND su_long.is_deleted = 0
WHERE su_short.seo_path_info NOT LIKE 'hersteller/%'
  AND su_short.route_name = 'frontend.cbax.manufacturer.detail'
  AND su_short.is_deleted = 0
GROUP BY su_short.seo_path_info, su_long.seo_path_info
ORDER BY su_short.seo_path_info ASC;

Hinweis: doppelte URL-Pfade (Kurz- und Langform)

Das Plugin liefert neben der kanonischen Langform /hersteller/markenname/ zusätzlich die Kurzform /markenname/ als Alias aus. Das ist bei URL-erzeugenden Erweiterungen normal und per Canonical geregelt. Wer es besonders sauber halten möchte, kann die Alias-Pfade zusätzlich per 301 auf die Langform konsolidieren, damit Suchmaschinen kein Crawl-Budget darauf verwenden.

Sinnvolle Prüfungen bei einer Shop-Übernahme: Trailing-Slash (/hersteller/marke vs. /hersteller/marke/ – nur eine darf 200 liefern), Kurz- vs. Langpfad (/marke/ vs. /hersteller/marke/), Groß-/Kleinschreibung (case-insensitiver Server = Duplikate) und die Sitemap (keine Kurz-URLs).

Ein konkreter Praxisbericht – mit SQL-Audit, 30 Alias-Paaren und der Konsolidierung per 301 und nginx-map – steht hier: Doppelte Hersteller-URL-Pfade konsolidieren. Ob das messbar auf Traffic-Zahlen wirkt, wird dort bewusst offengelassen.

Setup-Checkliste

Erstinstallation (neuer Shop):

Plugin installieren & aktivieren.
SEO-Basispfad prüfen (Textbaustein cbaxManufacturer.basisPathSnippet).
Trailing Slash: AN.
Robots-Tags: index,follow für Übersicht und Detail.
Sitemap-Generierung: AN.
SEO-URLs generieren lassen.
Sitemap prüfen: nur /hersteller/…-Varianten, keine Kurz-URLs.
Menüpunkt „Hersteller“ einbinden (Kategorie als Link).
Erlebniswelten-Vorlagen duplizieren und anpassen.

Übernahme eines Bestandsshops (Audit):

SQL-Query: Duplikat-Paare ermitteln (s. o.).
HTTP-Status aller Duplikate prüfen (beide Varianten aufrufen).
Sitemap auf doppelte Hersteller-Einträge prüfen.
Canonical-Tags prüfen (is_canonical in seo_url).
Trailing-Slash- und Case-Sensitivity-Verhalten prüfen.
Bei Befund: 301-Redirects für alle Kurzpfade einrichten, Sitemap neu generieren, in der GSC prioritäre URLs zur Neuerfassung einreichen.

Laufender Betrieb:

Neuer Hersteller → SEO-URL sofort generieren (Button in den Plugin-Einstellungen).
Nach Basispfad-Änderung: löschen + neu generieren.
Hersteller ohne Produkte: ausblenden oder aus der Navigation entfernen (sonst 404-Menüpunkte).
Produktanzahl-Berechnung: „Aus Datenbank“ für Performance.

Häufige Fragen

Warum hat Shopware 6 keine Hersteller-Seiten von Haus aus? Im Standard existieren Hersteller nur als Produkt-Attribut ohne eigene SEO-Seite. Eigene Marken-Landingpages gab es zuletzt in Shopware 5 – diese Lücke füllt das cbax-Plugin.

Wo stelle ich den Basispfad /hersteller/ ein? Nicht im Plugin-Formular, sondern als Textbaustein cbaxManufacturer.basisPathSnippet unter Einstellungen → Shop → Textbausteine. Leeres Feld = Fallback hersteller.

Warum ist meine Marke unter zwei URLs erreichbar? Das Plugin legt zusätzlich zur kanonischen /hersteller/marke/ eine Kurzform /marke/ an. Die Kurzform ist per Canonical geregelt; wer Crawl-Budget schonen will, leitet sie zusätzlich per 301 auf die Langform um.

Erstellt das Plugin den Navigationspunkt automatisch? Nein. Der Menüpunkt muss als Link-Kategorie oder Navigations-Eintrag manuell angelegt werden – mit einem Namen, der sich vom Basispfad unterscheidet.

Quellen

Erstellt von great2gether · getestet auf Shopware 6.7.x mit Plugin-Version 5.0.9 (Praxisbasis: naturfuss-shop.de).