README

Provisionsrechner für Contao

Frontend-Modul für Contao 5.7: Wer über eine Plattform verkauft oder vermittelt wird, sieht auf einen Blick, was ihn die Provision im Jahr kostet – und ab wann sich eine eigene Lösung rechnet. Ob Restaurant und Lieferdienst, Hotel und Buchungsportal, Händler und Marktplatz oder Handwerk und Vermittlungsportal: Beschriftungen, Bereiche und Angebote stellst du im Modul ein.

Drei Regler (Standard: Bestellungen pro Woche, durchschnittlicher Bestellwert, Provision) – Beschriftung, Start, Minimum, Maximum und Schritt frei wählbar
Ergebnis live im Browser: Provision pro Jahr, Kosten des eigenen Angebots, Ersparnis im ersten Jahr und über einen Zeitraum, Balkenvergleich, Amortisation einer Einmalzahlung
Mehrere Angebote (z. B. „nur Abo“, „mit Einrichtung“) als Auswahl
Vanilla-JS und -CSS, kein Build, kein Framework; Texte auf Deutsch und Englisch

Live im Einsatz auf gratorder.de.

Installation

composer require gratlinie/contao-provisionsrechner
vendor/bin/contao-console contao:migrate

Oder über den Contao Manager: nach „Provisionsrechner“ suchen und installieren.

Einrichtung

Theme → Frontend-Module → neues Modul vom Typ Provisionsrechner.
Rechner: Name des eigenen Angebots (z. B. „GratOrder“ → „GratOrder-Abo pro Jahr“), Währung (ISO-Code, z. B. EUR) und Vergleichszeitraum in Jahren.
Regler: für Bestellungen pro Woche, Bestellwert und Provision je Startwert, Minimum, Maximum und Schrittweite, auf Wunsch eine eigene Beschriftung (z. B. „Buchungen pro Woche“ für andere Branchen).
Angebote: je Zeile Titel, laufende Kosten pro Jahr und einmalige Kosten (netto). Mehrere Angebote erscheinen als Auswahl. Leer lassen, wenn eine andere Erweiterung die Angebote liefert (siehe unten).
Modul per Inhaltselement „Modul“ oder im Seitenlayout einbinden.

Gestaltung

Stylesheet und Skript lädt das Modul selbst (nur auf Seiten mit dem Rechner). Die Variablen stehen unter :where(.module-provisionsrechner) und lassen sich mit jeder eigenen Regel überschreiben:

.module-provisionsrechner {
    --pr-color: #1f2937;          /* Beschriftungen, aktive Auswahl */
    --pr-accent: #e8590c;         /* Werte, Ersparnis, eigener Balken */
    --pr-accent-strong: #c43800;  /* Zahlen an den Reglern, Regler */
    --pr-border: #d6d3d1;
    --pr-radius: 0.75rem;
    --pr-result-bg: #1f2937;      /* Ergebnis-Box */
    --pr-result-color: #b9bdc7;
    --pr-result-strong: #ffffff;
    --pr-result-line: rgb(255 255 255 / 0.1);
    --pr-gap: 4rem;               /* Abstand der Spalten ab 58 rem Breite */
}

Mit dem Theme GratFrame übernimmt der Rechner automatisch dessen Farben.

Angebote aus einer anderen Erweiterung

Statt die Angebote im Modul zu pflegen, kann eine Erweiterung sie liefern, z. B. aus einer Produkttabelle:

use Gratlinie\ProvisionsrechnerBundle\Event\OffersEvent;
use Symfony\Component\EventDispatcher\Attribute\AsEventListener;

#[AsEventListener]
class ShopOffersListener
{
    public function __invoke(OffersEvent $event): void
    {
        if ([] !== $event->getOffers()) {
            return;
        }

        $event->setOffers([
            ['code' => 'abo', 'title' => 'Nur Abo', 'yearly' => 790.0, 'once' => 0.0],
            ['code' => 'setup', 'title' => 'Mit Einrichtung', 'yearly' => 790.0, 'once' => 690.0],
        ]);
    }
}

Rechnung

Provision pro Jahr = Bestellungen/Woche × 52 × Bestellwert × Provision
Ersparnis im ersten Jahr = Provision − Kosten pro Jahr − einmalige Kosten
Ersparnis in X Jahren = X × Provision − (einmalige Kosten + X × Kosten pro Jahr)
Amortisation = einmalige Kosten ÷ ((Provision − Kosten pro Jahr) ÷ 365) Tage

gratlinie / contao-provisionsrechner

Package info

Security

Statistics