Zum Inhalt springen
Stone & Water
Doku · 01 Einstieg

Einstieg in 10 Minuten

Plugin installieren, Berechtigungen vergeben, Konfigmatrix-Grundlagen, erste Produktansicht öffnen - Schritt für Schritt.

Vorschaubild zum Video: PIM für Shopware im Überblick Video · 1:41 Min.PIM für Shopware im ÜberblickDie Funktion in Aktion sehen, mit eingeblendeten Erklärungen.Video ansehen →

1. Systemvoraussetzungen prüfen

Das PIM läuft in jeder Standard-Installation von Shopware 6, eine zusätzliche Server-Konfiguration ist nicht nötig.

  • Shopware: 6.6 oder 6.7, ein Paket für beide Reihen
  • PHP: 8.2 oder neuer
  • Datenbank: MySQL 8 oder MariaDB 10.11
  • Speicher: Die Standard-Empfehlung von Shopware reicht (256 MB und mehr), bei großen Katalogen sind 512 MB PHP-Memory sinnvoll
  • Zugang: Shopware-Admin mit Administrator-Rolle für die Installation
Gut zu wissen: Produktdaten bearbeitet das Plugin über die offiziellen Shopware-Datenmodelle und APIs, den Shopware-Kern verändert es nicht. Für seine eigenen Daten (Konfiguration, Presets, Profile, Änderungshistorie, Snapshots, Freigaben, Bearbeitungssperren und den Fremdsystem-Schutz) legt es eigene Tabellen mit dem Präfix staw_pim_direct_ an.

2. Plugin installieren

Über den Shopware Store

  1. Im Admin Erweiterungen → Store öffnen
  2. Nach „PIM für Shopware" suchen und laden
  3. Unter Erweiterungen → Meine Erweiterungen auf Installieren klicken
  4. Anschließend Aktivieren

Manuell per ZIP

  1. ZIP-Datei aus dem Shopware Store herunterladen
  2. Unter Erweiterungen → Meine Erweiterungen hochladen
  3. Installieren und aktivieren wie oben

3. Was beim Aktivieren passiert

Beim Aktivieren richtet das Plugin alles Nötige selbst ein:

  • Migrationen legen die eigenen Tabellen und die Plugin-Konfiguration in der Datenbank an
  • Die Berechtigungen werden im Shopware-Rechtesystem registriert
  • Die Menüpunkte PIM Dashboard, PIM und PIM Konfigurationsmatrix erscheinen im Stone & Water-Menü des Admins
  • Die Konfigmatrix wird mit sinnvollen Standardwerten aufgebaut
Kein Cache leeren nötig: Das Plugin stößt den nötigen Cache-Refresh automatisch an.

4. Berechtigungen vergeben

Das Plugin bringt eine eigene Rechtegruppe „StawPim (Produkte)" mit. Du findest sie unter Einstellungen → Benutzer & Berechtigungen → Rollen, dort eine Rolle wählen oder anlegen, Gruppe „Kataloge". Es gibt genau vier Rollen:

  • staw_pim.viewer - Ansehen: Voraussetzung für die Menüpunkte und alle PIM-Seiten.
  • staw_pim.editor - Bearbeiten: bringt das Shopware-Recht zum Bearbeiten von Produkten mit. Das Plugin prüft die Rolle nicht gesondert.
  • staw_pim.creator - Anlegen: sichert das Anlegen neuer Produkte ab. Setzt Ansehen und Bearbeiten voraus.
  • staw_pim.deleter - Löschen: bringt das Shopware-Recht zum Löschen von Produkten mit. Setzt Ansehen voraus.

Darüber hinaus gelten die Shopware-Rechte auf die jeweiligen Daten. Ohne das Recht „Ansehen" erscheinen Dashboard, Produkte und Konfigurationsmatrix gar nicht erst im Menü. Admin-Rollen sehen wie gewohnt alles.

Funktionen gezielt freigeben: CSV-Import, CSV-Export, Feed-Generator, Mehrfachänderung und weitere Funktionen steuerst du nicht über Rollen, sondern über die Funktionsschalter und die Superadmin-Liste im Tab „PIM-Superadmin" der Konfigmatrix. Standardmäßig sind alle Funktionen eingeschaltet. Details auf der Seite Rechte & Superadmin.

5. Konfigmatrix einrichten

Die zentrale Steuerung öffnest du über den Menüpunkt PIM Konfigurationsmatrix im Stone & Water-Menü des Admins. Für den Start lohnt sich ein Blick auf diese Punkte:

  • Tab Allgemein: sichtbare Spalten der Produktliste, Seitengröße und Filter
  • Tab Produkte: welche Felder in der Detailansicht sichtbar und Pflicht sind
  • Tab Varianten: Muster für Artikelnummer und Name sowie die Quickview-Felder
  • Tab Texte & Übersetzungen: KI-Anbieter mit API-Schlüssel, Modell und Tonalität, dazu die Kanal-Sprachen für Mehrfachänderung und CSV-Export
  • Tab PIM-Superadmin: Superadmins und Funktionen für normale Benutzer

Mit Strg+K durchsuchst du alle Einstellungen. Alle 13 Tabs beschreibt die Dokumentation zur Konfigmatrix.

6. Erste Schritte im PIM

Nach der Aktivierung öffnest du über den Menüpunkt PIM die Produktliste. Probier danach diese vier Dinge aus:

  1. Eine Filterbedingung anlegen, zum Beispiel „Bestand < 10", und als Preset speichern
  2. Einen Bestandswert direkt in der Zeile ändern
  3. Bei einem Variantenartikel die Varianten aufklappen und eine Variante anklicken - das Quickview-Fenster mit den Stammdaten öffnet sich
  4. Einige Produkte auswählen und die Mehrfachänderung öffnen

7. Wenn etwas nicht klappt

  • Listing lädt nicht: Cache leeren, Browser-Konsole prüfen und das PHP-Memory-Limit kontrollieren (512 MB bei großen Katalogen).
  • CSV-Import bricht ab: Zeichenkodierung (UTF-8), Trennzeichen und PHP-Limits prüfen.
  • KI-Generierung schlägt fehl: Den API-Schlüssel unter Konfigmatrix → Texte & Übersetzungen → Verbindung testen prüfen, bei Anthropic das Guthaben, bei OpenAI den Billing-Status.
  • Menüpunkte fehlen nach einem Update: Nicht-Admin-Benutzer brauchen einmalig das Recht „StawPim: Ansehen" in ihrer Rolle.

Weiter geht's

Lies als Nächstes Produktlisting, um Filter und Spalten zu vertiefen, oder springe direkt zur Mehrfachänderung, dem Herzstück des Plugins.

Häufige Fragen

Welche Shopware-Versionen werden unterstützt?

Shopware 6.6 und 6.7, mit einem gemeinsamen Paket für beide Reihen.

Muss ich nach der Installation den Cache leeren?

Nein. Das Plugin stößt den nötigen Cache-Refresh beim Aktivieren automatisch an.

Warum sehen manche Benutzer das PIM nicht im Menü?

Ihnen fehlt das Recht „StawPim: Ansehen" in ihrer Rolle. Ohne dieses Recht werden die Menüpunkte nicht angezeigt.

Verändert das Plugin die Shopware-Datenbank?

Produktdaten schreibt es über die offiziellen Shopware-Datenmodelle und APIs, ohne Eingriffe in den Shopware-Kern. Für seine eigenen Daten legt es eigene Tabellen mit dem Präfix staw_pim_direct_ an.