Globale Produktattribute: Einrichtung und Hilfe

Laden Sie die ZIP-Datei unter Modul > "Module Manager" hoch und installieren Sie sie. Öffnen Sie "Improve" > Global Attributes > Vorlagen.

Bereiten Sie die nativen Attributgruppen und Werte im PrestaShop-Bereich "Attributes & Features" vor. Verwenden Sie für die erste Synchronisierung eine kleine Testproduktfamilie. Sichern Sie die Datenbank, bevor Sie bestehende Varianten ersetzen.

Dieses Modul erzeugt echte PrestaShop-Varianten. Es erstellt vor dem Ersetzen eine Momentaufnahme der bestehenden Händlervarianten und kann sie wiederherstellen, wenn das Produkt nicht mehr vom Modul verwaltet wird. Prüfen Sie beim ersten Produkt die resultierenden Bestände, Referenzen und Preise, bevor Sie eine Vorlage breit anwenden.

Öffnen Sie Global Attributes > Einstellungen > Konfiguration.

Diese Ausschlüsse gelten zusätzlich zur eigenen Produktauswahl einer Vorlage. Ein Produkt kann einer Vorlage entsprechen und hier trotzdem von der Synchronisierung ausgeschlossen sein.

Der ältere Schalter "Dynamic storefront options" wird in diesem Konfigurationsformular nicht angezeigt. Verwenden Sie den unten beschriebenen Ablauf mit nativen Varianten.

Erstellen Sie eine Vorlage und öffnen Sie Einrichtung.

Ziehen Sie die ausgewählten Gruppen-Chips, um ihre Reihenfolge festzulegen. Der Editor verwendet diese Reihenfolge für die erzeugte Optionsstruktur und die Darstellung auf der Produktseite. Die Gruppenauswahl liest bestehende native Attributgruppen; sie ersetzt die Attributverwaltung im PrestaShop-Katalog nicht.

Öffnen Sie Werte. Die Werte jeder ausgewählten Gruppe erscheinen in einer Tabelle. Die normale Anfangsreihenfolge folgt den nativen Werten; verwenden Sie die Sortierfunktionen des Editors, wenn Sie eine andere Reihenfolge benötigen.

Legen Sie Referenzsuffix der Gruppe für eine Gruppe und Referenzsuffix für ihre Werte fest. Wo kein eigenes Suffix angegeben ist, werden automatische Suffixe aus den Namen erzeugt. Legen Sie pro Gruppe einen Standard-Wert fest. Der erste Wert ist der anfängliche Standardwert.

Wählen Sie unter Preisänderung einen Prozentsatz oder einen festen Betrag in einer ausgewählten Währung. Neue Wertregeln haben standardmäßig null Prozent. Feste Beträge verwenden standardmäßig die Shop-Währung, sofern Sie keine andere Währung auswählen. Die Währungsumrechnung erfolgt während der Synchronisierung.

Ein Prozentsatz ist eine Preisauswirkung, die anhand des Basispreises berechnet wird. Eine Regel mit 15 Prozent addiert beispielsweise 15 Prozent der jeweiligen Basis, während eine feste Regel mit 20 den umgerechneten Betrag addiert. Die Auswirkungen der ausgewählten Werte werden summiert, sofern keine Überschreibung für eine exakte Variante diese Summe ersetzt.

Sie können mehrere Werte auswählen und über Preis festlegen eine gemeinsame Preisänderung anwenden. Prüfen Sie anschließend die einzelnen Zeilen.

Öffnen Sie vor der Synchronisierung Varianten.

Exakte Auswahlen werden durch sortierte native Attribut-IDs identifiziert. Ein gespeicherter Schlüssel kann etwa 12-31-44 lauten; er kennzeichnet diese exakte Auswahl und keine Produkt-ID.

Referenzsuffixe werden bereinigt. Beispiele unterstützter Suffixformen sind BLK, -XL, .MAT und OAK_120. Mit der Basisproduktreferenz CHAIR-A und der zutreffenden Suffixkette BLK, XL ergibt sich die Form CHAIR-A-BLK-XL. Gruppensuffixe und jede Variantenüberschreibung beeinflussen ebenfalls die endgültige Referenz. Bestätigen Sie diese daher in der Vorschau.

Automatische Abkürzungen umfassen BLACK zu BLK, WHITE zu WHT, SILVER zu SLV, NATURAL zu NAT und OAK zu OAK.

Die Synchronisierungsgrenze liegt bei 500 erzeugten Varianten pro Produkt. Überschreitet die geplante Matrix diese Grenze, protokolliert das Modul einen Fehler und überspringt die Erzeugung für dieses Produkt. Reduzieren Sie vor einem erneuten Versuch die ausgewählten Gruppen oder Werte.

Öffnen Sie Produkte. Verwenden Sie die Produktauswahl und Ausschlüsse, um die gewünschten Katalogartikel festzulegen. Verfügbare Auswahlmethoden können ausgewählte Produkte, Kategorien, Hersteller, Eigenschaften, Attribute, Bestand und Preis umfassen.

Eine leer gespeicherte Auswahl gilt umfassend für geeignete Produkte. Wählen Sie für einen ersten Test ausdrücklich ein Produkt aus. Globale Ausschlüsse für virtuelle Produkte und IDs gelten weiterhin.

Für eine kategoriebasierte Entwicklerkonfiguration können die Auswahldaten diese Form haben:

{
  "products":{
    "groups":[{"include":{"method":"by_category","values":[3,8]}}],
    "excludes":[{"method":"specific","values":[42]}]
  }
}

Dies zielt auf die Kategorien 3 und 8 ab und schließt Produkt 42 aus. Ersetzen Sie die Beispiel-IDs und bestätigen Sie die Vorschau der passenden Produkte, statt gespeichertes JSON direkt zu bearbeiten.

Wenn sich Vorlagen überschneiden, prüfen Sie die Zielauswahl und die Angaben zur Zuständigkeit. Ein wirksamer Vorlagenverantwortlicher steuert die erzeugte Variantenstruktur eines Produkts; gehen Sie nicht davon aus, dass sich überschneidende Vorlagen zusammengeführt werden.

Das Ersetzen bestehender Varianten ist für gruppierte Vorlagen aktiviert. Es ist ein internes Vorlagenverhalten und kein gewöhnlicher Schalter im gruppierten Editor. Das Modul behält eine Momentaufnahme, damit es das Produkt wiederherstellen kann, sobald es nicht mehr verwaltet wird.

Speichern Sie die Vorlage. Das Modul stellt die Synchronisierung in die Warteschlange. Die Verwaltungsseite kann den Auftrag per AJAX verarbeiten, solange sie geöffnet bleibt. Beobachten Sie im Synchronisierungsfenster den Fortschritt und die Anzahlen erstellter, aktualisierter, entfernter, übersprungener und fehlerhafter Einträge.

Ein neuerer Speichervorgang kann einen älteren Auftrag in der Warteschlange ersetzen. Wenn das Fenster meldet, dass ein Auftrag ersetzt wurde, verfolgen Sie den neuesten Auftrag, statt den überholten erneut zu versuchen.

Kopieren Sie für die Hintergrundverarbeitung nach dem Schließen der Seite Cron-URL aus Einstellungen > Konfiguration > Hintergrundsynchronisierung in den Aufgabenplaner Ihres Hostings. Verwenden Sie die erzeugte URL, da Route und Token vom Shop abhängen.

Eine entsprechende URL ohne Umschreibung hat diese Form:

https://yourshop.example/index.php?fc=module&module=mprglobalattributes&controller=cron&token=YOUR_TOKEN&jobs=3&batch=5

Der Endpunkt gibt JSON zurück. Eine gültige Antwort enthält success, processed_jobs und results. Ein falsches Token führt zu HTTP 403. Das Hintergrundfenster zeigt Letzter Treffer, Letzter Erfolg, Treffer gesamt, Jobs beim letzten Treffer verarbeitet, Ausstehende Jobs und gegebenenfalls Letzter Fehler. Ein funktionierender Cron-Aufruf bedeutet nicht, dass jedes Produkt in der Warteschlange abgeschlossen ist; prüfen Sie auch die ausstehenden Aufträge.

Öffnen Sie nach der Synchronisierung das Zielprodukt im Backoffice. Die Warnung zu verwalteten Varianten zeigt an, dass Global Attributes für seine Varianten zuständig ist. Schutzmechanismen für Verwaltungsrouten verhindern manuelle Variantenänderungen, solange es verwaltet wird.

Prüfen Sie im Shop-Frontend Gruppenreihenfolge, ausgewählte Standardwerte, verfügbare Varianten, angezeigten Preis, Referenz, Bestandsverhalten und das Hinzufügen zum Warenkorb. Dies sind native PrestaShop-Varianten und kein separater Ablauf zur Warenkorbanpassung.

Wenn Variantenzeilen des Moduls vorhanden sind, kann das Theme-CSS diese ansprechen:

.mpr-ga-front-option { margin-bottom: 1rem; }
.mpr-ga-front-choice-list { display: flex; flex-wrap: wrap; gap: .5rem; }
.mpr-ga-front-choice.is-disabled { cursor: not-allowed; opacity: .45; }

Um zur manuellen Variantenverwaltung zurückzukehren, entfernen Sie das Produkt aus den wirksamen Zielprodukten der Vorlage und lassen Sie die Synchronisierung seinen Zustand vollständig wiederherstellen. Prüfen Sie die Wiederherstellung, bevor Sie Varianten manuell bearbeiten.

Wenn keine Produkte verarbeitet werden, prüfen Sie die Einstellung Aktiv der Vorlage, die gespeicherte Produktauswahl, globale Ausschlüsse und die Vorlagenzuständigkeit. Virtuelle Produkte sind standardmäßig ausgeschlossen.

Wenn der Auftrag ausstehend bleibt, lassen Sie den Editor für die Verarbeitung geöffnet oder prüfen Sie die Cron-URL und den Status ihres letzten Aufrufs. Schlägt er fehl, lesen Sie den gemeldeten Fehler, bevor Sie erneut speichern. Eine Matrix mit über 500 benötigt eine kleinere Optionsauswahl.

Wenn Preise vom vorgesehenen Betrag abweichen, prüfen Sie, ob die Regel ein Prozentsatz oder ein fester Betrag ist, ihre Währung und etwaige Überschreibungen für exakte Varianten. In der Vorschau können Sie die endgültige Regelauswahl vor einer breiten Synchronisierung bestätigen.

Wenn manuelle Änderungen blockiert werden, prüfen Sie, ob das Produkt weiterhin einer Vorlage untersteht. Umgehen Sie den Schutz nicht: Die nächste Synchronisierung kann direkte Änderungen überschreiben.

Öffnen Sie Einstellungen > "Integrity", um Modultabellen und Installation zu prüfen. Große native Matrizen erzeugen weiterhin echte Varianten und erfordern Katalogplanung; das Modul beseitigt diesen zugrunde liegenden Aufwand nicht.

Sichern Sie die Datenbank und warten Sie, bis laufende Arbeiten abgeschlossen sind. Bei der Deinstallation wird zuerst der Dienst aufgerufen, der den Zustand verwalteter Produkte wiederherstellt. Anschließend werden Modulmenüeinträge, Voreinstellungen, Konfiguration und das Modulschema entfernt. Prüfen Sie nach der Deinstallation repräsentative Produkte, um zu bestätigen, dass ihre ursprünglichen Varianten und Bestände wiederhergestellt wurden.

Erfordert PrestaShop 1.6.1 oder neuer und PHP 7.1 oder neuer.