Administration
Das Plugin liefert ein eigenes Admin-Modul sowie eine Tab-Erweiterung an der Standard-Kundendetailseite. Diese Seite beschreibt die Verwaltung der Vertreter, die Zuordnungs- und Berechtigungs-Felder am Kunden sowie die Konfiguration.
Modul „Vertreter"
Das Modul liegt in der Navigation unter Kunden → Vertreter (Route leoparden.sales.representative.index, Entität leoparden_sales_representative). Vertreter sind außerdem als eigener Suchtyp in der globalen Suche hinterlegt — auffindbar über Kundennummer, Vor- und Nachname.
Ansicht „Listing"
Übersicht aller angelegten Vertreter mit den Standard-Such- und Sortierfunktionen. Anzeige-Eigenschaften sind Vor-/Nachname und Kundennummer des hinterlegten Kunden.
Ansicht „Detail"
Pflege der Stammdaten des Vertreters (Kontakt- und Adressdaten, Profilbild) sowie Einsicht der zugeordneten Kunden. Über die Detailseite eines Kunden gelangt man in dessen Ansicht zurück.
Tab „Vertreter" am Kunden
In sw-customer-detail injiziert das Plugin per routeMiddleware eine neue Route und überschreibt die Detailseite, sodass ein Vertreter-Tab erscheint — sofern der Kunde selbst ein Vertreter ist. Der Tab führt in dieselbe Ansicht wie die Vertreter-Detailseite des Moduls.
Zuordnung und Berechtigungen (Custom-Fields)
Die Steuerung erfolgt über Custom-Fields am Kunden (Field-Set leoparden_sales_representative):
Feld | Typ | Bedeutung |
|---|---|---|
| Entity (Mehrfach-Auswahl | Ordnet einem Kunden seine(n) Vertreter zu |
| Checkbox | Vertreter darf im Namen des Kunden bestellen |
| Checkbox | Bestellungen werden im Namen des Vertreters durchgeführt |
| Checkbox | Vertreter darf die Rechnungsadresse auf die des Kunden setzen |
| Checkbox | Vertreter darf die Lieferadresse auf die des Kunden setzen |
Profilbilder von Vertretern erhalten am media-Eintrag das Feld leoparden_sales_representative_media_uploaded_by, das den hochladenden Vertreter referenziert (für die Zugriffsprüfung beim Bildtausch im Frontend).
Konfiguration
Einstellungen → System → Plugins → SalesRepresentative:
Feld | Default | Effekt |
|---|---|---|
Kundenzuordnung via AffiliateCode | aus | Kunde kann sich über den URL-Parameter erstmalig einem Vertreter zuordnen |
Update von Kundenzuordnung via AffiliateCode | aus | Bereits zugeordneter Kunde darf den Vertreter über den URL-Parameter wechseln |
Standard-Medienordner für Profilbilder | (bei Install gesetzt) | Zielordner für im Frontend hochgeladene Profilbilder |
Mail-Template
Für die Einladungs-Mail liegt der Template-Type sales_representative_mail unter Einstellungen → Shop → E-Mail-Templates. Auslöser ist das Flow-Event CustomerInviteEvent — im Flow Builder lässt sich damit „Bei Vertreter-Einladung versende Mail-Template X" einrichten.