← Zur Wissensübersicht

JTL Shop Plugins

Merkmalmanager – vollständige Einrichtung und Bedienung

Über den Merkmalmanager

Der Zaxxo Merkmalmanager für JTL Shop 5 steuert zentral, welche Artikelmerkmale an welcher Stelle des Shops sichtbar sind. Damit lassen sich umfangreiche Merkmaldaten aus JTL Wawi gezielt einsetzen, ohne das Template programmieren zu müssen.

Das Plugin wird im JTL Extension Store unter der Artikelnummer exs_zx_1274 geführt. Die aktuelle Version 1.4.0 unterstützt JTL Shop 5.2 bis 5.7 sowie PHP 8.1 bis 8.5. Es besteht keine direkte Abhängigkeit von einer bestimmten JTL Wawi Version.

Welche Bereiche lassen sich steuern?

  • Produktdetailseite: Relevante technische Daten und Produkteigenschaften am Artikel anzeigen.

  • Kategorie- und Suchlisten: Ausgewählte Merkmale bereits in Produktübersichten bereitstellen.

  • Warenkorb und Checkout: Entscheidende Angaben wie Größe, Farbe oder Ausführung vor dem Kauf erneut sichtbar machen.

  • Filter: Festlegen, welche Merkmale Kunden zur Eingrenzung des Sortiments verwenden können.

  • Herstellerseiten: Filter dort bei Bedarf getrennt von anderen Listen konfigurieren.

Voraussetzungen

  • eine kompatible Version von JTL Shop und PHP

  • eine an den Shop gebundene Lizenz des Merkmalmanagers

  • in JTL Wawi gepflegte und mit dem Shop abgeglichene Artikelmerkmale

  • Administrationszugriff auf das Backend von JTL Shop

Bevor Sie die Darstellung konfigurieren, sollten die Merkmale und Merkmalwerte in JTL Wawi inhaltlich bereinigt sein. Unterschiedliche Schreibweisen wie „Rot“, „rot“ und „ROT“ oder uneinheitliche Einheiten führen sonst auch im Shop zu unnötigen Varianten.

Installation

  1. Buchen oder testen Sie den Merkmalmanager im JTL Extension Store.

  2. Öffnen Sie im Backend des gewünschten Shops Plugins > Meine Käufe.

  3. Binden Sie die Lizenz an diesen Shop.

  4. Installieren und aktivieren Sie das Plugin.

  5. Öffnen Sie den Merkmalmanager über den Plugin Manager beziehungsweise dessen Einstellungsseite.

  6. Prüfen Sie das Status-Dashboard des Plugins auf Hinweise.

Das Grundprinzip der Konfiguration

Die zentrale Matrix stellt die vorhandenen Merkmale den möglichen Ausgabebereichen gegenüber. Pro Merkmal wählen Sie aus, wo es erscheinen oder als Filter angeboten werden soll. Die genaue Benennung einzelner Schalter kann abhängig von der installierten Plugin-Version leicht abweichen.

  1. Laden Sie die in Ihrem Shop vorhandenen Merkmale in der Plugin-Konfiguration.

  2. Entscheiden Sie für jedes Merkmal, ob es grundsätzlich sichtbar sein soll.

  3. Aktivieren Sie die gewünschten Ausgabebereiche in der Matrix.

  4. Speichern Sie die Konfiguration.

  5. Leeren Sie bei unveränderter Frontend-Ausgabe den Shop- und gegebenenfalls Objekt-Cache.

  6. Prüfen Sie einen repräsentativen Artikel sowie Kategorie, Suche, Warenkorb und Filter.

Nur ausgewählte Merkmale anzeigen

Ab Version 1.4.0 kann die Ansicht im Backend auf die ausgewählten Merkmale reduziert werden. Diese Funktion erleichtert die Pflege bei Sortimenten mit vielen Merkmalen. Wechseln Sie für eine vollständige Kontrolle wieder zur Gesamtansicht, damit neu hinzugekommene Merkmale nicht übersehen werden.

Empfehlungen für die Produktdetailseite

Auf der Produktdetailseite sollten Merkmale eine Kaufentscheidung unterstützen. Sinnvoll sind beispielsweise Material, Abmessungen, technische Leistung, Inhalt oder Kompatibilität. Interne Klassifikationen, Importkennzeichen und rein organisatorische Merkmale sollten dort ausgeblendet werden.

Bei sehr vielen technischen Angaben empfiehlt sich eine klare Reihenfolge: kaufentscheidende Informationen zuerst, ergänzende Details danach.

Merkmale in Kategorie und Suche

In Produktlisten ist weniger Platz vorhanden. Zeigen Sie dort nur Merkmale, die Produkte unmittelbar unterscheidbar machen. Zu viele Angaben vergrößern Produktkarten, erschweren den Vergleich und können insbesondere auf Mobilgeräten unübersichtlich werden.

Merkmale im Warenkorb und Checkout

Im Warenkorb sollten nur Informationen wiederholt werden, mit denen Kunden die gewählte Variante oder Ausführung kontrollieren können. Typische Beispiele sind Größe, Farbe, Anschluss, Verpackungseinheit oder technische Variante. Lange Beschreibungen und interne Merkmale gehören nicht in diesen Bereich.

Merkmale als Filter

Ein Merkmal eignet sich als Filter, wenn mehrere Produkte sinnvolle, konsistente Werte besitzen und Kunden tatsächlich danach auswählen. Prüfen Sie insbesondere:

  • Sind die Werte einheitlich geschrieben?

  • Sind Einheiten konsistent?

  • Entstehen zu viele Filterwerte mit jeweils nur einem Artikel?

  • Ist das Merkmal für die betreffende Kategorie wirklich relevant?

  • Sind leere oder technisch erzeugte Werte vorhanden?

Herstellerseiten können ab Version 1.4.0 separat konfiguriert werden. Das ist nützlich, wenn dort andere Filter als in normalen Kategorien benötigt werden.

Merkmalwerte sortieren

Version 1.4.0 unterstützt eine alphabetische und numerische Sortierung von Merkmalwerten. Verwenden Sie die numerische Sortierung für echte Zahlenfolgen wie Größen, Leistungen oder Abmessungen. Die alphabetische Sortierung eignet sich für Bezeichnungen und Namen.

Achten Sie darauf, Zahlen und Einheiten konsistent zu pflegen. Gemischte Werte wie „5“, „10 kg“ und „ca. 20“ lassen sich nicht zuverlässig numerisch sortieren.

Abweichungen pro Artikel

Merkmale können ab Version 1.4.0 über ein Artikel-Funktionsattribut gezielt ausgeblendet werden. Verwenden Sie diese Ausnahme nur dort, wo die globale Matrix nicht ausreicht. Die vom Plugin erwartete genaue Attributbezeichnung entnehmen Sie bitte der Einstellungsseite Ihrer installierten Version; sie sollte nicht frei geraten oder abweichend geschrieben werden.

Nach dem Anlegen oder Ändern eines Funktionsattributs in JTL Wawi muss ein vollständiger Abgleich des betroffenen Artikels mit dem Shop erfolgen.

Bewährter Einrichtungsablauf

  1. Beginnen Sie mit einer wichtigen Kategorie und wenigen repräsentativen Artikeln.

  2. Aktivieren Sie zunächst nur die Produktdetailseite.

  3. Ergänzen Sie anschließend gezielt Warenkorb und Produktlisten.

  4. Aktivieren Sie Filter erst, nachdem Merkmalwerte bereinigt wurden.

  5. Prüfen Sie Herstellerseiten separat.

  6. Übertragen Sie die Regeln danach auf das weitere Sortiment.

Prüfliste nach Änderungen

  • Produktdetailseite mit und ohne die betreffenden Merkmale

  • Kategorieansicht und Suchergebnisse

  • Filterauswahl sowie Zurücksetzen der Filter

  • Herstellerseite

  • Warenkorb und Checkout

  • Desktop und Mobilansicht

  • alle verwendeten Sprachen und relevanten Kundengruppen

  • Artikel mit Funktionsattribut-Ausnahme

Fehlerbehebung

Ein Merkmal erscheint nicht

  • Prüfen Sie, ob Merkmal und Wert in JTL Wawi am Artikel gepflegt sind.

  • Führen Sie einen Artikelabgleich durch.

  • Kontrollieren Sie die Auswahl in der Plugin-Matrix.

  • Prüfen Sie ein mögliches Funktionsattribut, das die Anzeige unterdrückt.

  • Leeren Sie Shop- und Objekt-Cache.

Ein Filter fehlt oder enthält falsche Werte

  • Prüfen Sie, ob das Merkmal im Plugin für den Filterbereich freigegeben ist.

  • Kontrollieren Sie die Konfiguration für normale Kategorien und Herstellerseiten getrennt.

  • Bereinigen Sie doppelte Schreibweisen und Einheiten in JTL Wawi.

  • Führen Sie nach Änderungen einen vollständigen Abgleich durch.

Die Darstellung ist nach einem Update verändert

  • Prüfen Sie Changelog und Kompatibilität der installierten Version.

  • Leeren Sie alle beteiligten Caches.

  • Kontrollieren Sie, ob Ihr Template den betreffenden Ausgabebereich überschreibt.

  • Testen Sie bei einem individuellen Template vorübergehend mit einer unveränderten Referenzumgebung.

Versionsübersicht

  • 1.4.0: Auswahlansicht im Backend, getrennte Filterkonfiguration für Herstellerseiten, alphabetische und numerische Sortierung sowie artikelbezogenes Ausblenden per Funktionsattribut.

  • 1.3.0: Kompatibilität mit JTL Shop 5.6.

  • 1.2.0: übersichtliche Auswahl der Merkmale über eine Matrix.

  • 1.1.0: Status-Dashboard und aktualisierte Shop-Kompatibilität.

  • 1.0.0: erste veröffentlichte Version.

Produkt und Support

Aktuelle Preise, Kompatibilitäten und Versionen finden Sie auf der Produktseite des Merkmalmanagers im JTL Extension Store. Halten Sie bei einer Supportanfrage Shop-Version, PHP-Version, Plugin-Version, Template, Beispielartikel und Screenshots der betroffenen Matrix-Einstellungen bereit.

Aktualisiert am 31.07.2026