Umwandlung von Zusatzfeldern zu Eigenschaften (OttCustomFieldToProperty)

Umwandlung von Zusatzfeldern zu Eigenschaften (OttCustomFieldToProperty)

Beschreibung

Das Plugin überträgt die Werte eines festgelegten Zusatzfeldsets automatisch in eine Eigenschaftengruppe und ordnet die passenden Eigenschaften den entsprechenden Produkten zu. Damit lassen sich Zusatzfeld-Werte, die zum Beispiel für interne Zwecke oder aus einer Datenimport-Schnittstelle gepflegt werden, ohne manuellen Aufwand als Eigenschaften nutzen, etwa für die Facettierung/Filterung im Shop oder für Farbvarianten-Darstellungen.

Welches Zusatzfeldset in welche Eigenschaftengruppe umgewandelt wird, legen Sie in der Plugin-Konfiguration fest. Die eigentliche Umwandlung wird über einen Konsolenbefehl angestoßen, entweder manuell oder automatisiert über einen Cronjob.

Screenshots

Konfiguration

grafik-20260710-184716.png

Anleitung

Bevor die Umwandlung ausgeführt werden kann, müssen im Shop bereits eine Eigenschaftengruppe (Kataloge > Eigenschaften) sowie ein Zusatzfeldset (Einstellungen > Shop > Zusatzfelder) angelegt sein. Beide werden anschließend in der Plugin-Konfiguration hinterlegt (siehe Abschnitt „Plugin Einstellungen").

Die Umwandlung selbst wird über die Konsole ausgeführt:

bin/console ott:custom-field-to-property

Der Befehl geht dabei alle Produkte durch und gleicht deren Zusatzfeld-Werte aus dem konfigurierten Zusatzfeldset mit den Optionen der konfigurierten Eigenschaftengruppe ab:

  • Werte, die in den Zusatzfeldern vorkommen, aber noch nicht als Eigenschaft existieren, werden automatisch als neue Option der Eigenschaftengruppe angelegt.

  • Die Eigenschaften des Produkts aus dieser Eigenschaftengruppe werden bei jedem Lauf neu anhand der aktuellen Zusatzfeld-Werte gesetzt. Ein wiederholter Aufruf des Befehls ist daher unbedenklich und aktualisiert lediglich den Stand.

  • Bei Produktvarianten wird berücksichtigt, ob die Variante bereits eigene Zusatzfeld-Werte oder Eigenschaften besitzt. Ist dies nicht der Fall, aber der Hauptartikel besitzt bereits Eigenschaften aus der konfigurierten Gruppe, wird die Variante nicht verändert, da sie diese Eigenschaften vom Hauptartikel übernimmt. Hat die Variante keine eigenen Zusatzfelder gepflegt, werden stattdessen die Zusatzfelder des Hauptartikels herangezogen.

Damit die Eigenschaften regelmäßig aktuell gehalten werden, zum Beispiel nach einem Produktimport, müssen Sie bei Ihrem Hosting Provider einen Cronjob mit dem oben genannten Befehl einrichten.

Je nach Hosting Anbieter muss ggf. noch der Pfad zur PHP Ausführungsdatei mit angegeben werden.

Plugin Einstellungen

Eigenschaft

Die Eigenschaftengruppe, in die die Werte aus dem Zusatzfeldset als Optionen übernommen und den Produkten zugeordnet werden sollen.

Zusatzfeldset

Das Zusatzfeldset, dessen Werte je Produkt in Eigenschaften der oben gewählten Eigenschaftengruppe umgewandelt werden.

Installation/Konfiguration

Standard Plugin Installation über Plugin-Manager. Nach der Installation muss die Plugin-Konfiguration mit der gewünschten Eigenschaft und dem gewünschten Zusatzfeldset ausgefüllt werden, bevor der Konsolenbefehl ausgeführt wird.