StartseiteDokumentationKaufmodelle & Tickets & Abo

    Kaufmodelle & Tickets & Abo

    Flexible Preismodelle, Abo-Verwaltung und Support-Tickets in einem Plugin

    Zur Plugin-Seite →

    Überblick

    Das Plugin vereint drei Module in einem: Flexible Kaufmodelle pro Produkt (Kauf, Monatlich, Jährlich), eine vollständige Abo-Verwaltung mit automatischer Verlängerung über einen täglichen Scheduled Task und ein produktbezogenes Support-Ticket-System im Kundenkonto.

    Jedes Modul lässt sich einzeln aktivieren oder deaktivieren. Das Plugin eignet sich besonders für Software-Lizenzen, SaaS-Produkte, Wartungsverträge und Verbrauchsmaterialien im Abo-Modell.

    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/BcProductLicensing ablegen
  5. 2.Plugin im Plugin-Manager aktivieren
  6. 3.Cache leeren:
    7. php bin/console cache:clear
  7. 4.Vier Datenbank-Migrationen werden automatisch ausgeführt für bc_pricing_model, bc_support_ticket, bc_support_ticket_message und bc_subscription.
  8. 5.Der Scheduled Task für die tägliche Abo-Verlängerung wird automatisch registriert.

    9. Konfiguration

    Die Plugin-Konfiguration befindet sich unter Erweiterungen > Meine Erweiterungen > BC Kaufmodelle, Tickets & Abo > Konfiguration (config.xml).

    Allgemein:

  9. •**Plugin aktivieren?** (`BcProductLicensing.config.active`, Typ: `bool`, Standard: `true`): Globaler Schalter.

    10. Kaufmodelle:

  10. •**Kaufmodell-Auswahl auf der Produktdetailseite anzeigen?** (`BcProductLicensing.config.pricingModelEnabled`, Typ: `bool`, Standard: `true`): Zeigt die Auswahl zwischen Kauf, Monatlich und Jährlich.
  11. •**Standard-Label: Kauf** (`BcProductLicensing.config.defaultLabelPurchase`, Typ: `text`, Standard: `Kauf`)
  12. •**Standard-Label: Monatlich** (`BcProductLicensing.config.defaultLabelMonthly`, Typ: `text`, Standard: `Monatlich`)
  13. •**Standard-Label: Jährlich** (`BcProductLicensing.config.defaultLabelYearly`, Typ: `text`, Standard: `Jährlich`)

    14. Ticket-System:

  14. •**Ticket-System im Kundenkonto aktivieren?** (`BcProductLicensing.config.ticketSystemEnabled`, Typ: `bool`, Standard: `true`): Zeigt "Meine Tickets" im Kundenkonto.
  15. •**Maximale Anzahl offener Tickets pro Kunde** (`BcProductLicensing.config.maxTicketsPerCustomer`, Typ: `int`, Standard: `0`): 0 = unbegrenzt.

    16. Anzeige:

  16. •**Kaufmodell-Badge im Warenkorb anzeigen?** (`BcProductLicensing.config.showPricingBadgeInCart`, Typ: `bool`, Standard: `true`): Badge neben dem Produkt im Warenkorb und Checkout.

    17. Funktionen

    Kaufmodelle

    Jedes Produkt kann über die bc_pricing_model-Entity bis zu drei Preismodelle haben: Kauf, Monatlich, Jährlich. Die Konfiguration erfolgt im Admin über die Produkt-Erweiterung (sw-product-detail Extension mit Tab bc-product-pricing). Auf der Produktdetailseite erscheint der BcPricingModelSelectorPlugin als Radio-Card-Selektor mit dynamischer Preisanpassung.

    Abo-Verwaltung

    Bei Bestellung mit Monats- oder Jahresmodell wird über den OrderPlacedSubscriber automatisch ein Abonnement (bc_subscription) angelegt. Der SubscriptionService verwaltet die Geschäftslogik. Im Kundenkonto unter "Meine Abos" sieht der Kunde alle Abonnements mit Verlängerungsdatum, Status und Kündigungsmöglichkeit.

    Support-Ticket-System

    Kunden erstellen Support-Tickets (bc_support_ticket) im Kundenkonto über den TicketController. Der TicketService und TicketNumberGenerator verarbeiten die Erstellung. Nachrichten (bc_support_ticket_message) ermöglichen einen chronologischen Dialog. Tickets haben die Status: Offen, In Bearbeitung, Wartend, Gelöst, Geschlossen.

    Automatische Abo-Verlängerung

    Der SubscriptionRenewalTask prüft täglich Abonnements und löst bei Fälligkeit eine Verlängerung aus.

    Cart Processor

    Der PricingModelCartProcessor passt den Warenkorbpreis basierend auf dem gewählten Kaufmodell an.

    Produkt-Extension

    Das Plugin erweitert die Product-Entity über ProductExtension, um Pricing-Models direkt am Produkt abrufbar zu machen.

    Events & Hooks

    Das Plugin verwendet keine eigenen Event-Klassen. Es reagiert auf folgende Shopware-Events über Subscriber:

  17. •**`CheckoutOrderPlacedEvent`** (`OrderPlacedSubscriber`) -- Erstellt automatisch Abonnements bei Bestellungen mit Monats- oder Jahresmodell.
  18. •**`ProductPageLoadedEvent`** (`ProductPageSubscriber`) -- Stellt Kaufmodell-Daten und Ticket-Informationen auf der Produktdetailseite bereit.

    19. Textbausteine (Snippets)

    Storefront-Snippets (src/Resources/snippet/de_DE/bc-product-licensing.de-DE.json):

    *Account:*

  19. •`bc-product-licensing.account.ticketsTitle` -- "Meine Tickets"
  20. •`bc-product-licensing.account.createTicket` -- "Neues Ticket"
  21. •`bc-product-licensing.account.subscriptionsTitle` -- "Meine Abos"

    22. *Ticket-System:*

  22. •`bc-product-licensing.ticket.number` / `product` / `subject` / `status` / `priority` / `date` -- Ticket-Felder
  23. •`bc-product-licensing.ticket.selectProduct` -- "Produkt auswählen ..."
  24. •`bc-product-licensing.ticket.submit` -- "Ticket absenden"
  25. •`bc-product-licensing.ticket.replyTitle` -- "Antwort schreiben"
  26. •`bc-product-licensing.ticket.you` / `support` -- Nachrichtenabsender

    27. *Abonnements:*

  27. •`bc-product-licensing.subscription.title` -- "Meine Abonnements"
  28. •`bc-product-licensing.subscription.product` / `type` / `price` / `status` / `nextRenewal` / `startDate` -- Spalten
  29. •`bc-product-licensing.subscription.monthly` / `yearly` -- Typen
  30. •`bc-product-licensing.subscription.statusActive` / `statusCancelled` / `statusExpired` -- Status
  31. •`bc-product-licensing.subscription.cancel` -- "Kündigen"
  32. •`bc-product-licensing.subscription.confirmCancel` -- Bestätigungsdialog
  33. •`bc-product-licensing.subscription.messages.cancelled` / `cancelFailed` -- Statusmeldungen

    34. *Ticket-Status:*

  34. •`bc-product-licensing.status.open` / `in_progress` / `waiting` / `resolved` / `closed`

    35. *Kaufmodell:*

  35. •`bc-product-licensing.pricing.chooseModel` -- "Modell wählen"
  36. •`bc-product-licensing.pricing.purchase` -- "Kauf"

    37. Admin-Snippets (src/Resources/app/administration/src/module/bc-product-licensing/snippet/de-DE.json, en-GB.json)

    Scheduled Tasks

  37. •**`bc_product_licensing.subscription_renewal`** (`BcProductLicensing\ScheduledTask\SubscriptionRenewalTask`): Wird täglich ausgeführt (Intervall: 86400 Sekunden / 24 Stunden). Prüft fällige Abonnements und löst automatische Verlängerungen aus. Der zugehörige Handler ist `SubscriptionRenewalTaskHandler`.

    38. Datenbank-Tabellen

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

    | Tabelle | Entity-Name | Beschreibung |

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

    | bc_pricing_model | bc_pricing_model | Kaufmodelle pro Produkt (Kauf/Monatlich/Jährlich mit Preisen) |

    | bc_support_ticket | bc_support_ticket | Support-Tickets mit Kundenreferenz, Produktbezug, Status |

    | bc_support_ticket_message | bc_support_ticket_message | Nachrichten zu Tickets |

    | bc_subscription | bc_subscription | Abonnements mit Kundenbezug, Produktbezug, Status, Verlängerungsdatum |

    Migrationen:

  38. •`Migration1743552010PricingModel`
  39. •`Migration1743552011SupportTicket`
  40. •`Migration1743552012SupportTicketMessage`
  41. •`Migration1743552013Subscription`

    42. Admin-Integration

    Das Plugin registriert ein Admin-Modul bc-product-licensing (Farbe: #ff6b35, Icon: regular-comments) sowie eine Produkt-Erweiterung:

    Admin-Modul:

  42. •`bc-product-licensing-list` -- Liste aller Tickets/Abonnements
  43. •`bc-product-licensing-detail` -- Detail-Ansicht

    44. Produkt-Erweiterung (src/Resources/app/administration/src/extension/sw-product-detail/):

  44. •Erweitert die Shopware-Produkt-Detailseite um einen Tab `bc-product-pricing`
  45. •Template: `view/bc-product-pricing/bc-product-pricing.html.twig`
  46. •Ermöglicht die Konfiguration der Kaufmodelle (Preise für Kauf, Monatlich, Jährlich) direkt am Produkt

    47. Die Admin-Module liegen unter:

    src/Resources/app/administration/src/module/bc-product-licensing/
src/Resources/app/administration/src/extension/sw-product-detail/

    Storefront-Integration

    Das Plugin erweitert den Storefront um:

    Account-Seiten (src/Resources/views/storefront/page/account/):

  47. •`subscription/index.html.twig` -- Abo-Übersicht mit Status, Verlängerungsdatum, Kündigungsoption
  48. •`ticket/index.html.twig` -- Ticket-Übersicht
  49. •`ticket/create.html.twig` -- Ticket-Erstellungsformular
  50. •`ticket/detail.html.twig` -- Ticket-Detail mit Nachrichtenverlauf

    51. Sidebar-Erweiterung:

  51. •`page/account/sidebar.html.twig` -- Menüpunkte "Meine Abos" und "Meine Tickets"

    52. Produkt-Erweiterungen:

  52. •`component/buy-widget/buy-widget.html.twig` -- Kauf-Widget mit Kaufmodell-Selektor
  53. •`component/buy-widget/buy-widget-form.html.twig` -- Kaufformular mit Modell-Auswahl
  54. •`component/ticket/status-badge.html.twig` -- Wiederverwendbare Status-Badge-Komponente

    55. JavaScript-Plugins (src/Resources/app/storefront/src/):

  55. •`pricing-model/bc-pricing-model-selector.plugin.js` -- Radio-Card-Selektor für Kaufmodelle
  56. •`ticket/bc-ticket-form.plugin.js` -- Ticket-Formular-Plugin

    57. Storefront-Controller:

  57. •`TicketController` -- Ticket-Verwaltung
  58. •`SubscriptionController` -- Abo-Verwaltung

    59. Kompatibilität

  59. •Kompatibel mit dem Plugin **B2B Plattform** (Ticket-Erstellung durch Firmenmitarbeiter)
  60. •Kompatibel mit allen anderen Plugins der Bronner B2B Suite
  61. •Kompatibel mit Standard-Shopware-Themes
  62. •Getestet mit Shopware 6.7.x
  63. •Unterstützt Multi-Language (DE/EN)

    64. FAQ

    Weitere Plugin-Dokumentationen

    B2B PlattformPreise ausblendenMindermengenzuschlagAngebotsanfragen