Installation | Vorgangsanzeige

Voraussetzungen

Voraussetzung	Version
Shopware	6.7 (`shopware/core`, `shopware/storefront`, `shopware/administration` jeweils `~6.7.0`)
Plugin	`leoparden/business-transactions`, Technischer Name `LeopardenBusinessTransactions`, Version 6.7.6
Kunden	Vorgänge sind an angemeldete Kunden gebunden; Gäste sehen nichts

Die Administrations- und Storefront-Dateien liegen fertig gebaut im Plugin (src/Resources/public/administration und src/Resources/app/storefront/dist). Für den Betrieb ist kein Build nötig.

Installieren und aktivieren

Plugin in Betrieb nehmen

Lesen Sie das Plugin ein, installieren und aktivieren Sie es:
bin/console plugin:refresh bin/console plugin:install --activate LeopardenBusinessTransactions
Leeren Sie den Cache:
bin/console cache:clear
Legen Sie Vorgangsgruppen und Vorgangstypen an und ordnen Sie die Typen den Kundengruppen zu, siehe [](administration.md).

Die Installationsmigration (Migration1692860629InstallPlugin) erledigt vier Dinge:

Sie legt die sieben Tabellen des Plugins an (CREATE TABLE IF NOT EXISTS).
Sie legt den Mailvorlagentyp business_transaction_mail samt einer Mailvorlage an, jeweils in den Sprachen mit den Locales de-DE und en-GB.
Sie legt drei SEO-URL-Vorlagen an (Vorgangsdetail, Gruppe, Gruppenarchiv).
Eine zweite Migration benennt alte Konfigurationsschlüssel um: Einträge, die mit BusinessTransactions.config. beginnen, heißen danach LeopardenBusinessTransactions.config..

Konfiguration

Die Konfiguration steht in der Administration unter Erweiterungen → Meine Erweiterungen → Vorgangsanzeige → Konfigurieren. Sie besteht aus einer Karte Grundeinstellungen (Schlüsselpräfix LeopardenBusinessTransactions.config.) mit drei Feldern. Alle drei wählen Vorgangstypen aus; die Typen müssen also vorher existieren.

Schlüssel	Feld	Wirkung
`showCategoriesInTransactionsView`	Belegtypen wählen, welche im Account gezeigt werden sollen	Je Kundengruppe die sichtbaren Typen. Eigene Komponente `leoparden-business-transactions-customer-group-to-type-mapper`: Sie wählen eine Kundengruppe und dann deren Typen. Gespeichert wird eine Zuordnung Kundengruppen-ID → Liste von Typ-IDs.
`openCategories`	Belegtypen wählen, welche als „Offen" gelten	Typen, aus denen das Element `articles-on-order` (Offene Positionen) seine Positionen liest.
`invoiceCategories`	Belegtypen wählen, welche als „Rechnung" gelten	Typen, aus denen die Elemente `recently-delivered` und `most-bought-by-customer` ihre Positionen lesen.

Die Konfiguration kennt keine weiteren Optionen. Insbesondere gibt es keine Einstellung für Seitengrößen, Sortierung oder Mailversand.

Deinstallieren

Beim Deinstallieren ohne die Option „Benutzerdaten behalten" entfernt das Plugin seine Tabellen, SEO-Vorlagen und -URLs, die Mailvorlage samt Typ, die Konfiguration aller Verkaufskanäle und alle CMS-Slots seiner fünf Elemente. Mit „Benutzerdaten behalten" bleibt alles stehen. Die Einzelheiten stehen unter Backend.