StartseiteDokumentationAngebotsanfragen

    Angebotsanfragen

    Individuelle Preise direkt aus dem Warenkorb anfragen

    Zur Plugin-Seite →

    Ü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/BcOfferRequest 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. Konfiguration

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

    Allgemeine Einstellungen:

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

    10. Button-Einstellungen:

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

    13. Formular-Einstellungen:

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

    16. Funktionen:

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

    17. E-Mail-Benachrichtigungen:

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

    22. Funktionen

    Angebotsanfrage erstellen

    Der Kunde füllt seinen Warenkorb und klickt auf "Angebot anfordern". Die Anfrage (bc_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 bc-offer-request. Er kann den Status ändern und über die Chat-Funktion antworten.

    Nachrichtenverlauf

    Nachrichten (bc_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 löst drei Flow-Builder-fähige Events aus:

  22. •**`bc_offer_request.created`** (`BcOfferRequest\Core\Event\OfferRequestCreatedEvent`) -- Eine neue Angebotsanfrage wurde erstellt. Implementiert: `FlowEventAware`, `ShopwareSalesChannelEvent`, `MailAware`, `CustomerAware`, `ScalarValuesAware`
  23. •**`bc_offer_request.status_changed`** (`BcOfferRequest\Core\Event\OfferRequestStatusChangedEvent`) -- Der Status einer Anfrage hat sich geändert. Implementiert: `FlowEventAware`, `MailAware`, `CustomerAware`, `ScalarValuesAware`
  24. •**`bc_offer_request.message_sent`** (`BcOfferRequest\Core\Event\OfferRequestMessageSentEvent`) -- Eine Nachricht wurde zu einer Anfrage hinzugefügt. Implementiert: `FlowEventAware`, `MailAware`, `CustomerAware`, `ScalarValuesAware`

    25. Subscriber:

  25. •`FlowEventSubscriber` -- Verarbeitet Flow-Builder-Events
  26. •`OfferRequestWriteSubscriber` -- Reagiert auf Entity-Schreibvorgänge
  27. •`AccountMenuSubscriber` -- Erweitert das Account-Menü im Storefront

    28. Flow Builder Events

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

    | Event-Name | Klasse | Beschreibung |

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

    | bc_offer_request.created | OfferRequestCreatedEvent | Neue Angebotsanfrage erstellt |

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

    | bc_offer_request.message_sent | OfferRequestMessageSentEvent | Neue Nachricht gesendet |

    E-Mail-Templates

    Das Plugin registriert vier E-Mail-Templates über Migrationen. Die Template-Dateien liegen in src/Migration/Fixtures/mails/:

    offer_request_created** -- Bestätigung 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/bc-offer-request.de-DE.json):

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

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

    Datenbank-Tabellen

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

    | Tabelle | Entity-Name | Beschreibung |

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

    | bc_offer_request | bc_offer_request | Angebotsanfragen mit Status, Kundenbezug |

    | bc_offer_request_item | bc_offer_request_item | Positionen einer Angebotsanfrage |

    | bc_offer_request_message | bc_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 bc-offer-request (Farbe: #ff6b35, Icon: regular-file-text):

    Seiten:

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

    59. Detail-Views (Tabs):

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

    62. Die Admin-Module liegen unter:

    src/Resources/app/administration/src/module/bc-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. •`BcOfferRequestPlugin` (`src/Resources/app/storefront/src/js/plugin/bc-offer-request.plugin.js`)

    72. Storefront-Controller:

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

    74. Kompatibilität

  74. •Kompatibel mit dem Plugin **B2B Plattform** (Angebotsanfragen können von Firmenmitarbeitern gestellt werden)
  75. •Kompatibel mit allen anderen Plugins der Bronner B2B Suite
  76. •Kompatibel mit Standard-Shopware-Themes
  77. •Getestet mit Shopware 6.7.x
  78. •Enthält Unit-Tests für alle drei Event-Klassen

    79. FAQ

    Weitere Plugin-Dokumentationen

    B2B PlattformPreise ausblendenMindermengenzuschlagBestelllisten