Skip to main content
Mit dem $wsInserts-Modul können Sie die Werbemittelkennzeichen abrufen, die sich der Shop für einzelne Produkte gemerkt hat, sowie die Einstellungen der Werbemittelkennzeichnung. Das Modul stellt das gemerkte Kennzeichen überall dort bereit, wo ein Produkt dargestellt wird - also auch auf Kategorie-Kacheln und der Produktdetailseite -, nicht nur im Warenkorb. Auf dieser Seite geht es um das Auslesen der Werte. Wie der Shop ein Werbemittelkennzeichen erfasst, geprüft und einer Warenkorbposition zugeordnet wird, ist in der Funktionsübersicht Werbemittelkennzeichen beschrieben. Das Kennzeichen einer bereits hinzugefügten Warenkorbposition liefert $wsBasket über $item.insert.

​
Grundkonzept

$wsInserts ist ein reines Lese-Modul. Es fasst zwei Arten von Informationen zusammen:
  • Gemerkte Kennzeichen je Produkt in byProduct: Ruft ein Kunde ein Produkt mit einem Werbemittelkennzeichen auf - beispielsweise über einen Link aus einem Mailing -, merkt sich der Shop den entsprechenden Code. byProduct liefert diesen Code und prüft ihn gegen die für das Produkt gültigen Codes.
  • Die Einstellungen in enabled, separator, position und defaultInsertCode: haben dieselben Werte wie in $wsConfig.inserts. Damit genügt in Templates rund um das Werbemittelkennzeichen ein einziges Objekt, während $wsConfig.inserts weiterhin verfügbar bleibt.
Das Modul liefert die fertige Anzeige aus Artikelnummer und Code nicht. Sie wird im Template über die Komponente components/itemNumberWithInsert.htm erzeugt, siehe Beispiele.

​
Modulübersicht

Beispiel / Ausschnitt über $wsInserts
JSON-Ausgabe
Variablen des Moduls

​
Templates

Das Modul kann auf jeder Seite verwendet werden, auf der Produkte dargestellt sind. Typische Einsatzgebiete sind:
  • Produktdetailseite: Artikelnummer mit dem gemerkten Code anzeigen, nachdem der Kunde über einen Link mit Werbemittelkennzeichen gekommen ist.
  • Kategorie-Kacheln und Produktlisten: den gemerkten Code an jedem Produkt ausgeben, für das einer vorliegt.
  • Warenkorb und Checkout: Ausgaben rund um das Werbemittelkennzeichen nur bei aktiver Funktion anzeigen (enabled).

​
Variablen

​
$wsInserts.byProduct

Gibt die gemerkten Werbemittelkennzeichen je Produkt aus. Über die Produkt-ID als Schlüssel können Sie den Code für ein bestimmtes Produkt lesen.
Für das Verhalten gilt:
  • Der Schlüssel ist die vollständige Produkt-ID. Bei Varianten enthält sie die entsprechende Variante. Daher haben zwei Varianten desselben Produkts jeweils einen eigenen Eintrag.
  • Jeder Code wird gegen die für das jeweilige Produkt gültigen Codes geprüft. Ist der gemerkte Code ungültig, wird stattdessen der Standardcode angezeigt, sofern einer konfiguriert ist.
  • Produkte ohne gemerkten Code und Produkte, für die sich kein gültiger Code ergibt, fehlen in der Liste. Der Zugriff liefert dann einen leeren Wert.
  • Ist die Funktion deaktiviert, ist byProduct leer.
  • Die gemerkten Codes gelten nur für die laufende Sitzung. Nach Abschluss der Bestellung beginnt eine neue Sitzung, sodass sie entfallen. Zudem setzt der Shop die Codes zurück, wenn der Warenkorb beim Abmelden oder beim Wechsel des Kundenkontos geleert wird.

​
$wsInserts.enabled

Gibt aus, ob die Werbemittelkennzeichnung im Shop aktiv ist. Nutzen Sie diesen Wert, um Ausgaben rund um das Werbemittelkennzeichen nur bei aktiver Funktion anzuzeigen.

​
$wsInserts.separator

Gibt das konfigurierte Trennzeichen zwischen Artikelnummer und Code aus, beispielsweise -.

​
$wsInserts.position

Gibt aus, ob der Code vor (before) oder hinter (after) der Artikelnummer steht.

​
$wsInserts.defaultInsertCode

Gibt den konfigurierten Standardcode aus. Ist keiner hinterlegt, ist der Wert leer.
Die Einstellung insertCodeLength aus dem Konfigurationsknoten content.inserts steht im Template weder über $wsInserts noch über $wsConfig.inserts zur Verfügung.

​
Beispiele für den Datenzugriff

​
Artikelnummer mit gemerktem Werbemittelkennzeichen auf der Produktdetailseite anzeigen

Wenn für das Produkt ein Code hinterlegt ist, übergeben Sie diesen zusammen mit der Artikelnummer an die Komponente components/itemNumberWithInsert.htm . Die Komponente berücksichtigt dabei Trennzeichen und Position.
Ergebnis
Wenn der Kunde über den Link/buntes-t-shirt?insert=09 auf die Produktseite kommt, wird die Artikelnummer 123456-09 angezeigt. Ohne gemerkten Code wird nur die reine Artikelnummer angezeigt.

​
Gemerkten Code auf einer Kategorie-Kachel anzeigen

In einer Produktkachel sehen Sie die ID des jeweiligen Produkts. So erscheint der Hinweis nur bei Produkten, für die ein Code hinterlegt ist.
Ergebnis
Nur bei Kacheln von Produkten mit gemerktem Code wird der Hinweis “Werbemittelcode” zusammen mit dem Code angezeigt.
  • Werbemittelkennzeichen: fachliche Übersicht mit Erfassungswegen, Auflösungslogik und Einrichtung.
  • $wsBasket: Werbemittelkennzeichen und Artikelnummer je Warenkorbposition über $item.insert und $item.itemNumber.
  • $wsConfig: dieselben Einstellungen über $wsConfig.inserts.
  • content - Katalog: Konfigurationsknoten content.inserts.