tfm_attributes: Technische Daten / Produkt Eigenschaften

Mit den 4TFM Produktmerkmalen legen Sie eigene Merkmale mit festen Werten an, zum Beispiel „Material“, „Kompatibel mit“ oder „Systemanforderungen“, und ordnen sie Ihren Artikeln zu. Die Merkmale erscheinen übersichtlich auf der Produktseite. Zusammen mit dem 4TFM Produktfilter werden sie zu Filtern im Shop. Zugeordnet wird am Artikel, je Merkmal in einer übersichtlichen Matrix oder je Wert, auch für viele Artikel auf einmal.

Plugin bestellen

Screenshots

Installation & Konfiguration

Führen Sie die generelle Installationsanleitung für 4tfm-Plugins aus.

Nachdem das Plugin installiert und aktiviert ist, laden Sie den Administrationsbereich mit der F5-Taste neu.

Die Merkmale finden Sie im Backend unter „Shop“ → „4TFM Produktmerkmale“. Für die Anzeige auf der Produktseite muss der Hook einmalig im Template eingebunden werden (siehe „Anzeige auf der Produktseite“). Leeren Sie danach einmal den kompletten Cache.

Plugin-Optionen

Option	Beschreibung	Standardwert
Für Mandant aktivieren	Aktiviert die Ausgabe auf der Produktseite und die Merkmale als Datenquelle im 4TFM Produktfilter	true
Darstellung auf der Produktseite	Liste, Tabelle, Kompakt oder Tags (siehe „Anzeige auf der Produktseite“)	Liste
Backend: Anzahl Werte/Artikel anzeigen	Zeigt in den Übersichten, wie viele Werte und Artikel einem Merkmal zugeordnet sind (bei sehr vielen Artikeln deaktivieren, das spart Datenbankabfragen)	true

Funktionsweise

Mit dem Plugin legen Sie eigene Merkmale mit festen Werten an, z.B. „Material“ mit den Werten „Baumwolle“ und „Leinen“ oder „Passform“ mit „Slim Fit“ und „Regular Fit“. Die Werte werden den Artikeln zugeordnet, auf der Produktseite angezeigt und können im 4TFM Produktfilter als Filter verwendet werden.

Die Daten liegen in eigenen Tabellen, die Artikeltabelle wird nicht verändert. Freitext-Werte sind bewusst nicht vorgesehen: Feste Werte bleiben übersetzbar und ergeben saubere Filteroptionen.

Merkmale anlegen

Unter „Shop“ → „4TFM Produktmerkmale“ legen Sie die Merkmale an:

Feld	Beschreibung
Bezeichnung	Name des Merkmals je Sprache
Aktiv	Merkmal im Shop verwenden
Schlüssel	Optionaler, eindeutiger Name (z.B. material), um das Merkmal im Template gezielt auszugeben
Produktseite	Merkmal auf der Produktseite anzeigen (die Verwendung im Filter ist davon unabhängig)
Auswahlart	Mehrfachauswahl (mehrere Werte je Artikel) oder Einfachauswahl (höchstens ein Wert je Artikel)
Shop-IDs	In welchen Shops das Merkmal gilt („all“ = alle Shops)
Neue Werte hinzufügen	Ein Wert pro Zeile, wird für alle Sprachen übernommen

Über die Zeilenaktion „Werte“ pflegen Sie die Werte eines Merkmals: Bezeichnung je Sprache, Status, Reihenfolge (auch per Pfeilen), Schlüssel sowie Farbe oder Bild für die Darstellung als Swatch im Filter.

Merkmale den Artikeln zuordnen

Für die Zuordnung gibt es drei Wege:

Je Merkmal: Zeilenaktion „Zuordnung zu Artikeln“. Artikel stehen als Zeilen, Werte als Spalten mit Häkchen, mit Suche nach Artikel-ID, Artikelnummer oder Name.

Produktattibute - Zuordnung (Matrix-Ansicht; Mehrere Produkte)

Am Artikel: In der Artikelliste bzw. im Artikel über die Zeilenaktion „Produktmerkmale“ (Liste aller Werte mit Häkchen „Zugeordnet“) oder „Produktmerkmale (Baum)“ (Merkmale als Ordner, Werte als Checkboxen).

Produktattribute - Zuordnung (einzelnes Produkt)

Produktattribute - Zuordnung (Baumansicht)

Je Wert: In der Werte-Liste die Zeilenaktion „Artikel mit diesem Wert“. Sie zeigt die zugeordneten Artikel, über die Suche lassen sich weitere hinzufügen.

Varianten (Master/Slave): Merkmale werden am Hauptartikel gepflegt. Varianten erben die Merkmale ihres Hauptartikels und zeigen sie schreibgeschützt an.

Anzeige auf der Produktseite

Fügen Sie den Hook im Produkt-Template ein, z.B. in templates/<Ihr Template>/xtCore/pages/product/product.html unter dem Warenkorb-Button:

{hook key=tfm_attributes_product}

Angezeigt werden alle aktiven Merkmale mit „Produktseite“, denen der Artikel mindestens einen aktiven Wert zuordnet, in der Reihenfolge der Merkmale und Werte. Die Darstellung wählen Sie in den Plugin-Optionen unter „Darstellung auf der Produktseite“:

Darstellung	Beschreibung
Liste	Überschrift und Aufzählung der Werte je Merkmal (Screenshot 1)
Tabelle	Zweispaltige Tabelle mit Merkmal und Werten, mehrere Werte durch Komma getrennt (Screenshot 9)
Kompakt	Eine Zeile je Merkmal, z.B. „Material: Wolle, Seide“ – platzsparend, auch für schmale Spalten (Screenshot 10)
Tags	Überschrift und Werte als Badges; Werte mit Farbe oder Bild aus der Werte-Liste zeigen einen Farbpunkt (Screenshot 11)

Mit dem Parameter groups geben Sie nur bestimmte Merkmale (Schlüssel oder IDs) in der angegebenen Reihenfolge aus. So lassen sich Merkmale an verschiedenen Stellen der Produktseite zeigen:

{hook key=tfm_attributes_product groups="material,pflege"}

Mit dem Parameter display legen Sie die Darstellung für einen Hook fest, unabhängig von der Plugin-Option (list = Liste, table = Tabelle, inline = Kompakt, badges = Tags). So können Sie z.B. die Farben als Tags und alle übrigen Merkmale als Tabelle zeigen:

{hook key=tfm_attributes_product groups="farbe" display="badges"}
{hook key=tfm_attributes_product groups="material,saison,pflege" display="table"}

Die Ausgabe kann im Theme angepasst werden: templates/<Ihr Template>/plugins/tfm_attributes/tfm_attributes_product.html. Schrift und Überschriften übernimmt das Plugin vom Theme; die Darstellung steht als CSS-Klasse tfm-attributes--<Darstellung> am äußeren Element.

Verwendung im 4TFM Produktfilter

Ist der 4TFM Produktfilter (tfm_products_filter) installiert, erscheint jedes Merkmal dort als Datenquelle „4TFM Produktmerkmal: <Name>“. Legen Sie im Produktfilter einen neuen Filter mit dieser Datenquelle an und wählen Sie die Darstellung (Checkboxen, Radiobuttons, Buttons/Chips, Swatches, Dropdown oder Dropdown mit Mehrfachauswahl).

Zahlenwerte als Slider: Enthält jeder Wert eines Merkmals genau eine Zahl, z.B. „800 W“, „1.200 W“ oder „0,5 HE“, kann der Filter auch als Range-Slider oder mit Eingabefeldern von/bis dargestellt werden. Tragen Sie die Einheit (z.B. W) im Filter unter „Einheit“ ein. Enthält ein Wert keine Zahl (z.B. „variabel“) oder mehrere Zahlen (z.B. „110-240 V“), zeigt der Filter Checkboxen.

Im Filter erscheinen nur aktive Merkmale und Werte, die für den jeweiligen Shop freigegeben sind. Ohne Produktfilter funktionieren die Pflege und die Anzeige auf der Produktseite unverändert.

Hinweise

Beim Kopieren eines Artikels werden die Merkmale übernommen, beim Löschen eines Artikels werden die Zuordnungen entfernt.
Änderungen an Merkmalen, Werten und Zuordnungen leeren automatisch den Cache der betroffenen Produktseiten und die Trefferzahlen des Produktfilters.
Bei der Deinstallation werden alle Merkmale, Werte und Zuordnungen gelöscht.
Falls das Plugin nach einem Update deaktiviert ist, aktivieren Sie es unter „Plugins“ → „installierte Plugins“ wieder.