StartseiteDokumentationAngebotsanfragen

    Angebotsanfragen

    Individuelle Preise direkt aus dem Warenkorb anfragen

    Zur Plugin-Seite →Anleitung & Konfiguration →

    Überblick

    Das Plugin ermöglicht Kunden, direkt aus dem Warenkorb oder von der Produktdetailseite eine Angebotsanfrage an den Shop-Betreiber zu senden. Der Shop-Betreiber bearbeitet die Anfrage im Admin, kann den Status ändern und über eine integrierte Chat-Funktion mit dem Kunden kommunizieren.

    Der gesamte Prozess wird über drei Entities in der Shopware-Datenbank abgebildet und ist vollständig nachvollziehbar. Drei Flow-Builder-Events ermöglichen automatisierte Workflows.

    Systemvoraussetzungen

  1. •Shopware 6.7 oder höher
  2. •PHP 8.1 oder höher
  3. •MySQL 8.0 oder höher

    4. Installation

  4. 1.Plugin über den Shopware Plugin-Manager installieren oder manuell in custom/plugins/BronnOfferRequest ablegen
  5. 2.Plugin im Plugin-Manager aktivieren
  6. 3.Cache leeren:
    7. php bin/console cache:clear
  7. 4.E-Mail-Templates und Flow-Builder-Flows werden automatisch bei der Installation über drei Migrationen angelegt.

    8. Das Plugin enthaelt vorkompiliertes Admin-JS und funktioniert ohne build-administration.sh – eine reine Installation ueber den Shopware Plugin-Manager im Admin ist ausreichend.

    Konfiguration

    Die Plugin-Konfiguration befindet sich unter Erweiterungen > Meine Erweiterungen > BC Angebotsanfragen > Konfiguration (config.xml).

    Allgemeine Einstellungen:

  8. •**Plugin aktiv** (`BronnOfferRequest.config.active`, Typ: `bool`, Standard: `true`): Aktiviert oder deaktiviert die Angebotsanfrage-Funktion.
  9. •**Nur für eingeloggte Kunden** (`BronnOfferRequest.config.loginRequired`, Typ: `bool`, Standard: `false`): Wenn aktiviert, wird der Button nur für eingeloggte Kunden angezeigt.

    10. Button-Einstellungen:

  10. •**Button-Text** (`BronnOfferRequest.config.buttonText`, Typ: `text`): Text auf dem Angebotsanfrage-Button. Leer = Standard-Snippet.
  11. •**Button-Farbe** (`BronnOfferRequest.config.buttonColor`, Typ: `colorpicker`): Hintergrundfarbe des Buttons.
  12. •**Button auf der Warenkorb-Seite anzeigen** (`BronnOfferRequest.config.showButtonInCart`, Typ: `bool`, Standard: `true`): Zeigt den Button unterhalb des "Zur Kasse"-Buttons.

    13. Formular-Einstellungen:

  13. •**Wunschtermin-Feld anzeigen** (`BronnOfferRequest.config.showDesiredDate`, Typ: `bool`, Standard: `true`): Datumsfeld für gewünschten Liefertermin.
  14. •**Nachricht-Feld anzeigen** (`BronnOfferRequest.config.showMessage`, Typ: `bool`, Standard: `true`): Freitextfeld für zusätzliche Informationen.
  15. •**Mengenanpassung erlauben** (`BronnOfferRequest.config.quantityEditable`, Typ: `bool`, Standard: `true`): Erlaubt Mengenanpassung auf der Angebotsanfrage-Seite.

    16. Funktionen:

  16. •**Chat-Funktion aktivieren** (`BronnOfferRequest.config.showChatFunction`, Typ: `bool`, Standard: `true`): Aktiviert den Nachrichtenverlauf im Kundenkonto.

    17. E-Mail-Benachrichtigungen:

  17. •**Kundenbestätigung bei neuer Anfrage** (`BronnOfferRequest.config.sendCustomerConfirmation`, Typ: `bool`, Standard: `true`)
  18. •**Admin-Benachrichtigung bei neuer Anfrage** (`BronnOfferRequest.config.sendAdminNotification`, Typ: `bool`, Standard: `true`)
  19. •**Admin E-Mail-Adresse** (`BronnOfferRequest.config.adminEmail`, Typ: `text`): Leer = Shop-Standard-Adresse.
  20. •**Mail bei Statusänderung** (`BronnOfferRequest.config.sendStatusChangeMail`, Typ: `bool`, Standard: `true`)
  21. •**Mail bei neuer Nachricht** (`BronnOfferRequest.config.sendMessageMail`, Typ: `bool`, Standard: `true`)

    22. Funktionen

    Angebotsanfrage erstellen

    Der Kunde füllt seinen Warenkorb und klickt auf "Angebot anfordern". Die Anfrage (bronn_offer_request) enthält alle Warenkorbpositionen, Mengen und optionale Bemerkungen. Ein eigener Storefront-Controller (OfferRequestController) verarbeitet die Anfrage.

    Angebotsbearbeitung im Admin

    Der Shop-Betreiber sieht die Anfrage im Admin unter dem Modul bronn-offer-request. Er kann den Status ändern und über die Chat-Funktion antworten.

    Nachrichtenverlauf

    Nachrichten (bronn_offer_request_message) werden chronologisch gespeichert. Kunden und Admin können direkt über das Angebotsanfrage-Detail kommunizieren.

    Angebotshistorie

    Kunden sehen im Account-Bereich unter "Angebotsanfragen" ihre gesamte Historie mit Status, Datum und Artikeln.

    Events & Hooks

    Das Plugin loest drei Flow-Builder-faehige Events aus:

  22. •**`bronn_offer_request.created`** (`BronnOfferRequest\Core\Event\OfferRequestCreatedEvent`) -- Eine neue Angebotsanfrage wurde erstellt. Implementiert: `FlowEventAware`, `ShopwareSalesChannelEvent`, `MailAware`, `CustomerAware`, `ScalarValuesAware`
  23. •**`bronn_offer_request.status_changed`** (`BronnOfferRequest\Core\Event\OfferRequestStatusChangedEvent`) -- Der Status einer Anfrage hat sich geaendert. Implementiert: `FlowEventAware`, `MailAware`, `CustomerAware`, `ScalarValuesAware`
  24. •**`bronn_offer_request.message_sent`** (`BronnOfferRequest\Core\Event\OfferRequestMessageSentEvent`) -- Eine Nachricht wurde zu einer Anfrage hinzugefuegt. Implementiert: `FlowEventAware`, `MailAware`, `CustomerAware`, `ScalarValuesAware`

    25. Shopware 6.7 Kompatibilitaet: Die Events verwenden CustomerDefinition statt CustomerEntity als EntityType (Shopware 6.7 Standard).

    Subscriber:

  25. •`FlowEventSubscriber` -- Verarbeitet Flow-Builder-Events
  26. •`OfferRequestWriteSubscriber` -- Reagiert auf Entity-Schreibvorgaenge
  27. •`AccountMenuSubscriber` -- Erweitert das Account-Menue im Storefront

    28. Flow-Namen: Alle automatisch angelegten Flows tragen den Prefix "Bronn Angebotsanfrage:" (z.B. "Bronn Angebotsanfrage: Neue Anfrage erhalten").

    Flow Builder Events

    Alle drei Events sind im Shopware Flow Builder verfügbar:

    | Event-Name | Klasse | Beschreibung |

    |---|---|---|

    | bronn_offer_request.created | OfferRequestCreatedEvent | Neue Angebotsanfrage erstellt |

    | bronn_offer_request.status_changed | OfferRequestStatusChangedEvent | Status geändert |

    | bronn_offer_request.message_sent | OfferRequestMessageSentEvent | Neue Nachricht gesendet |

    E-Mail-Templates

    Das Plugin registriert vier E-Mail-Templates ueber Migrationen. Die Mail-Template-Type-Namen tragen den Prefix "Bronn" (z.B. "Bronn Angebotsanfrage erstellt"). Die Template-Dateien liegen in src/Migration/Fixtures/mails/:

    offer_request_created** -- Bestaetigung bei neuer Angebotsanfrage

  28. •`de-html.html.twig` / `de-plain.html.twig`
  29. •`en-html.html.twig` / `en-plain.html.twig`

    30. offer_request_status_changed** -- Benachrichtigung bei Statusänderung

  30. •`de-html.html.twig` / `de-plain.html.twig`
  31. •`en-html.html.twig` / `en-plain.html.twig`

    32. offer_request_admin_notification** -- Admin-Benachrichtigung bei neuer Anfrage

  32. •`de-html.html.twig` / `de-plain.html.twig`
  33. •`en-html.html.twig` / `en-plain.html.twig`

    34. offer_request_message_sent** -- Benachrichtigung bei neuer Nachricht

  34. •`de-html.html.twig` / `de-plain.html.twig`
  35. •`en-html.html.twig` / `en-plain.html.twig`

    36. Textbausteine (Snippets)

    Storefront-Snippets (src/Resources/snippet/de_DE/bronn-offer-request.de-DE.json):

  36. •`bronn-offer-request.button` -- "Angebot anfordern"
  37. •`bronn-offer-request.pageTitle` -- "Angebot anfordern"
  38. •`bronn-offer-request.pageSubtitle` -- Untertitel der Angebotsseite
  39. •`bronn-offer-request.itemsTitle` -- "Artikel"
  40. •`bronn-offer-request.messageLabel` -- "Ihre Nachricht"
  41. •`bronn-offer-request.desiredDateLabel` -- "Gewünschter Liefertermin"
  42. •`bronn-offer-request.submitButton` -- "Angebotsanfrage absenden"
  43. •`bronn-offer-request.cartButton` -- "Angebot für den gesamten Warenkorb anfordern"
  44. •`bronn-offer-request.submitSuccess` -- Erfolgsmeldung
  45. •`bronn-offer-request.submitError` -- Fehlermeldung
  46. •`bronn-offer-request.successTitle` -- "Vielen Dank für Ihre Anfrage!"
  47. •`bronn-offer-request.successMessage` -- Mit Platzhalter `%offerNumber%`
  48. •`bronn-offer-request.accountTitle` -- "Meine Angebotsanfragen"
  49. •`bronn-offer-request.accountMenuTitle` -- Menüpunkt-Text
  50. •`bronn-offer-request.columnOfferNumber` / `columnDate` / `columnItems` / `columnStatus` / `columnProduct` / `columnQuantity` / `columnPrice` / `columnOfferPrice` -- Tabellenspalten
  51. •`bronn-offer-request.messagesTitle` -- "Nachrichten"
  52. •`bronn-offer-request.messageThreadTitle` -- "Nachrichtenverlauf"
  53. •`bronn-offer-request.sendMessageTitle` -- "Nachricht senden"

    54. Admin-Snippets (src/Resources/app/administration/src/module/bronn-offer-request/snippet/de-DE.json, en-GB.json)

    Datenbank-Tabellen

    Das Plugin erstellt folgende Datenbank-Tabellen über 3 Migrationen:

    | Tabelle | Entity-Name | Beschreibung |

    |---|---|---|

    | bronn_offer_request | bronn_offer_request | Angebotsanfragen mit Status, Kundenbezug |

    | bronn_offer_request_item | bronn_offer_request_item | Positionen einer Angebotsanfrage |

    | bronn_offer_request_message | bronn_offer_request_message | Nachrichten/Chat zu einer Anfrage |

    Migrationen:

  54. •`Migration1711929600CreateOfferRequestTables` -- Erstellt die drei Haupttabellen
  55. •`Migration1743500000CreateMailTemplatesAndFlow` -- Erstellt Mail-Templates und Flow-Builder-Flows
  56. •`Migration1743600000CreateStatusAndMessageMailTemplates` -- Erstellt Status- und Nachrichten-Mail-Templates

    57. Admin-Integration

    Das Plugin registriert ein Admin-Modul bronn-offer-request (Farbe: #ff6b35, Icon: regular-file-text):

    Seiten:

  57. •`bronn-offer-request-list` -- Liste aller Anfragen mit Status-Filter und Suchfunktion
  58. •`bronn-offer-request-detail` -- Detail-Ansicht mit Tabs

    59. Detail-Views (Tabs):

  59. •`bronn-offer-request-detail-base` -- Stammdaten der Anfrage
  60. •`bronn-offer-request-detail-items` -- Positionen mit Artikeldetails
  61. •`bronn-offer-request-detail-messages` -- Nachrichtenverlauf und Antwortformular

    62. Die Admin-Module liegen unter:

    src/Resources/app/administration/src/module/bronn-offer-request/

    Storefront-Integration

    Das Plugin erweitert den Storefront um:

    Angebotsanfrage-Seiten (src/Resources/views/storefront/page/offer-request/):

  62. •`index.html.twig` -- Angebotsanfrage-Formular
  63. •`success.html.twig` -- Erfolgsseite nach Absenden

    64. Account-Seiten (src/Resources/views/storefront/page/account/offer-request/):

  64. •`index.html.twig` -- Übersicht aller Angebotsanfragen
  65. •`detail.html.twig` -- Detail mit Nachrichtenverlauf

    66. Warenkorb-Erweiterung:

  66. •`page/checkout/cart/index.html.twig` -- Button im Warenkorb

    67. Sidebar-Erweiterung:

  67. •`page/account/sidebar.html.twig` -- Menüpunkt im Account

    68. Produkt-Erweiterungen:

  68. •`component/buy-widget/buy-widget.html.twig` -- Kauf-Widget
  69. •`component/buy-widget/buy-widget-form.html.twig` -- Kauf-Formular
  70. •`component/checkout/offcanvas-cart.html.twig` -- Offcanvas-Warenkorb

    71. JavaScript-Plugin:

  71. •`BronnOfferRequestPlugin` (`src/Resources/app/storefront/src/js/plugin/bronn-offer-request.plugin.js`)

    72. Storefront-Controller:

  72. •`OfferRequestController` -- Verarbeitet Angebotsanfragen
  73. •`AccountOfferRequestController` -- Account-Bereich-Controller

    74. Plugin-Lebenszyklus

    Die Hauptklasse BronnOfferRequest implementiert alle fuenf Lifecycle-Methoden:

  74. •**install()** -- Erstellt die Datenbanktabellen ueber Migrations
  75. •**update()** -- Fuehrt neue Migrations aus, benennt bestehende Flows auf den Prefix "Bronn Angebotsanfrage:" um und aktualisiert Mail-Template-Typ-Namen
  76. •**activate()** -- Aktiviert das Plugin
  77. •**deactivate()** -- Deaktiviert das Plugin
  78. •**uninstall()** -- Bei `keepUserData=false` werden alle Plugin-Daten vollstaendig entfernt: eigene Datenbanktabellen (`bronn_offer_request_message`, `bronn_offer_request_item`, `bronn_offer_request`), Mail-Template-Typen und Mail-Templates (inkl. Uebersetzungen), Flows und Flow-Sequenzen

    79. Die update()-Methode stellt sicher, dass bei einem Update von aelteren Versionen Flow-Namen und Mail-Template-Typen automatisch auf die aktuelle Naming-Konvention migriert werden.

    Kompatibilität

  79. •Aktuelle Version: **1.7.17**
  80. •Kompatibel mit dem Plugin **B2B Plattform** (Angebotsanfragen koennen von Firmenmitarbeitern gestellt werden)
  81. •Kompatibel mit allen anderen Plugins der Bronner B2B Suite
  82. •Kompatibel mit Standard-Shopware-Themes
  83. •Getestet mit Shopware 6.7.x
  84. •Enthaelt Unit-Tests fuer alle drei Event-Klassen
  85. •Flow-Builder-Events verwenden `CustomerDefinition` als EntityType (Shopware 6.7 kompatibel, seit v1.7.14)
  86. •Alle Event-Klassen mit korrektem `CustomerEntity`-Import (Fix in v1.7.16)

    87. FAQ

    Weitere Plugin-Dokumentationen

    B2B PlattformPreise ausblendenMindermengenzuschlagBestelllisten

    Bereit für professionelles B2B?

    Statt 30.000–80.000 € Individualentwicklung: fertige, getestete Plugins — einsatzbereit in Stunden.

    • Alle 12 Plugins im vollen Funktionsumfang
    • Persönliche Einführung durch den Entwickler
    • Individuelle Beratung für deinen Use Case
    Kostenlose Demo anfordernPlugins ansehen

    Keine Kreditkarte nötig · Unverbindlich · Antwort innerhalb von 24h