Storefront

Menü im Kundenkonto

Das Plugin ergänzt das Menü des Kundenkontos um den Eintrag Bisherige Vorgänge (Snippet transactionsLink). Auf den Vorgangsseiten klappt darunter eine Liste auf:

• je Vorgangsgruppe ein Eintrag mit dem Namen der Gruppe

• unter der gerade geöffneten Gruppe der Eintrag „<Gruppe> Archiv"

• am Ende der Eintrag Archivierte Vorgänge für das Gesamtarchiv

Seiten und Adressen

Gruppe, Gruppenarchiv und Detail haben zusätzlich SEO-URLs. Die Vorlagen lauten /Transaction-Group/{{ group.name }}, /Transaction-Group/{{ group.name }}/Archive und /Transaction/{{ transaction.number }}; die Administration kann sie unter Einstellungen → Shop → SEO ändern. Alle Seiten tragen noindex,follow als Robots-Angabe und gehören damit nicht in Suchmaschinen.

Die Übersicht

Auf /Transactions erscheint für jede Gruppe ein Block mit dem Gruppennamen. Jeder Block zeigt höchstens drei Vorgänge. Gibt es mehr als drei, steht darunter die Schaltfläche „Mehr zu <Gruppe>", die zur Gruppenseite führt. Hat eine Gruppe keine Vorgänge, steht dort „Keine Einträge zu <Gruppe>".

Jeder Eintrag der Liste zeigt:

• die Vorgangsnummer

• das Belegdatum („Erstelldatum")

• den Status als Text, sofern das Lieferdatum einen Wartezustand ausdrückt (siehe unten)

• das Lieferdatum („Lieferdatum"). Bei einem Wartezustand steht der Statustext, und das Lieferdatum zeigt einen Strich.

Ein Klick auf den Eintrag öffnet die Detailseite.

Eine Gruppe und das Archiv

Der Seitentitel der Gruppen- und Gruppenarchivseiten lautet „Bisherige Vorgänge | <Gruppenname>". Für die Übersicht, das Gesamtarchiv und eine unbekannte Gruppe nimmt die Linie 6.7 den Namen der ersten Gruppe.

Auf der Gruppenseite erscheint dieselbe Liste für eine Gruppe, mit

• einer Typauswahl („Belegart auswählen"), wenn die Gruppe mehr als einen für den Kunden freigegebenen Typ hat. Die Auswahl lädt die Liste neu und zeigt nur Vorgänge dieses Typs. Ist die Einstellung showCategoriesInTransactionsView gar nicht gesetzt, stehen alle Typen der Gruppe zur Wahl.

• einer Auswahl der Seitengröße („Einträge pro Seite")

• einem Zähler „angezeigt / gesamt" unter der Liste

• einer Seitennavigation mit den Schaltflächen erste, vorherige, nächste und letzte Seite sowie den Seitenzahlen. Erste und vorherige Seite sowie nächste und letzte Seite erscheinen erst bei mehr als drei Seiten; die Zahlen zeigen die Seiten um die aktuelle herum.

Ist die Seitengröße auf unbegrenzt gestellt, fragt die Seite vor dem Laden nach: Sie warnt, dass das Laden aller Datensätze lange dauern kann, und bietet Alle laden und Abbrechen an.

Die Archivseiten zeigen dieselbe Ansicht für Vorgänge mit gesetztem Archivkennzeichen. Die Liste der Übersicht und der Gruppenseite zeigt dagegen nur nicht archivierte Vorgänge.

Die Detailseite

Die Detailseite zeigt einen Vorgang:

• Typ und Nummer als Überschrift, darunter die Referenznummer (identifier) und den Betreff (description)

• den Status des Vorgangs und das Belegdatum, das in der Linie 6.7 rechts in der Kopfzeile steht

• Rechnungs- und Lieferadresse. Ist am Vorgang ein Freitext hinterlegt (fallbackBilling, fallbackShipping), erscheint dieser, sonst die verknüpfte Adresse (Firma, Name, Straße, Postleitzahl und Ort).

• die Positionen als Tabelle: Position, Artikelnummer, Bezeichnung, Menge, Einzelpreis, Rabatt in Prozent und Preis. Verweist eine Position auf einen Shop-Artikel, ist die Bezeichnung ein Link zur Artikelseite. Jede Position zeigt zusätzlich ihren eigenen Status.

• Downloads: Für jedes am Vorgang hinterlegte Dokument erscheint eine Schaltfläche mit dem Dateinamen.

Ein Kunde sieht nur seine eigenen Vorgänge. Der Zugriff auf einen fremden Vorgang liefert keine Daten.

Der Status

Das Plugin liest den Status aus dem Lieferdatum. Steht dort eines der festgelegten Platzhalterdaten (zum Beispiel der 31.12.2500), zeigt der Shop den dazu hinterlegten Text statt eines Datums; die Zuordnung steht in Backend. Hat der Vorgang kein Platzhalterdatum, aber ein Lieferdatum, zeigt die Detailseite „Lieferdatum" mit dem Datum, und ab dem Folgetag „Fertig". Die Texte sind Snippets unter plugin.leoparden.BusinessTransactions.states.<Zahl> und lassen sich anpassen.

Tabellen aus den CMS-Elementen

Wo ein Betreiber eines der übrigen Elemente in eine Erlebniswelt gestellt hat (siehe Administration), erscheinen Listen mit denselben Bedienelementen:

• Überschrift mit einem Info-Symbol, hinter dem der Hilfetext steht

• ein CSV-Download: Die Schaltfläche neben der Überschrift lädt die Liste als <Titel>.csv herunter

• eine Auswahl der Seitengröße

• Sortierung per Klick oder mit der Tastatur (zur Überschrift tabben, Enter oder Leertaste), wenn die Spalte sortierbar ist; die Richtung steht im Attribut data-sorting-direction der Überschrift und als aria-sort an der Kopfzelle

Die Kopfzeile der Elemente auf den Kontoseiten (Übersicht, Gruppe, Archiv) ersetzt die gemeinsame Kopfzeile und enthält deshalb keinen CSV-Download.

Sprachen

Die Texte der Seiten kommen aus den Storefront-Snippets in Deutsch und Englisch (plugin.leoparden.BusinessTransactions.*). Vorgangstypen und Gruppen zeigen den Namen in der aktiven Sprache.