English Version

Zurück zur Übersicht

Kleinunternehmer: Storefront

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Wo der Hinweis erscheint

Bei aktiver Regelung blendet das Plugin den Hinweis über Twig Hooks überall ein, wo Kunden einen Preis oder eine Steuersumme sehen. Du musst kein Template anpassen.

Produktseite, Produktkarte und Warenkorb nutzen ein Absatz-Template, die beiden tabellenbasierten Zusammenfassungen eine Tabellenzeile.

Wann der Hinweis erscheint

Der Hinweis erscheint nur, wenn die Regelung aktiv ist und der Hinweis zum jeweiligen Objekt passt:

Ohne Warenkorb, Bestellung, Variante oder Produkt bleibt der Hinweis aus: Eine Steueraussage, die sich nicht prüfen lässt, ist schlimmer als keine.

graph TD
    A["Hook rendert Hinweis-Template"] --> B{"Regelung aktiv?"}
    B -->|Nein| Z["Kein Hinweis"]
    B -->|Ja| C{"Warenkorb oder Bestellung im Kontext?"}
    C -->|Ja| D{"Beide Steuersummen 0?"}
    C -->|Nein| E{"Variante oder Produkt im Kontext?"}
    D -->|Ja| Y["Hinweis anzeigen"]
    D -->|Nein| Z
    E -->|Ja| F{"Alle relevanten Varianten auf kleinunternehmer_zero?"}
    E -->|Nein| Z
    F -->|Ja| Y
    F -->|Nein| Z

Eine Bestellung, die vor dem Umschalten der Regelung aufgegeben wurde, zeigt den Hinweis nur, wenn ihre Steuersummen tatsächlich 0 sind. Ein teilweise migrierter Warenkorb zeigt ihn nicht, weil sonst der Hinweis neben einer „Steuern gesamt“-Zeile mit Betrag stünde.

Hinweistext

Den Text bearbeitest du im Admin, siehe Konfiguration. Ohne eigenen Text gelten diese Standardtexte:

Die Hinweise tragen die CSS-Klasse mmd-kleinunternehmer-notice und in der Storefront zusätzlich text-secondary small, in den Tabellenzeilen außerdem text-end. Der Hinweis im Gutschrift-PDF hat nur mmd-kleinunternehmer-notice. Damit lässt sich die Darstellung im Theme anpassen.

Hinweis verschieben oder abschalten

Alle fünf Hooks registrieren das Hookable kleinunternehmer_notice. Die Priorität bestimmt die Position: -100 für Produktseite, Produktkarte und Bestellübersicht, 150 für den Warenkorb, 50 für die Checkout-Seitenleiste. In deiner eigenen sylius_twig_hooks-Konfiguration kannst du es unter demselben Hook-Namen mit enabled: false abschalten oder mit einer anderen priority verschieben. Die Template-IDs sind @MmdSyliusKleinunternehmerPlugin/shop/product/kleinunternehmer_notice.html.twig (Absatz) und @MmdSyliusKleinunternehmerPlugin/shop/order_summary/kleinunternehmer_notice_row.html.twig (Tabellenzeile).

Gutschrift-PDF

Ist sylius/refund-plugin installiert, ersetzt dieses Plugin das Template des Gutschrift-PDFs durch eine Variante, die das Original erweitert und den Hinweis unter der Tabelle ergänzt. Der Hinweis erscheint nur, wenn die Regelung aktiv ist und die Gutschrift keine Steuern enthält. Er steht in der Sprache, in der die Gutschrift ausgestellt wurde, und nutzt denselben Text wie die Storefront, einschließlich deiner Admin-Überschreibungen.

Das Refund-Plugin ist keine Abhängigkeit. Ist es nicht installiert, ändert sich nichts. Hat eine andere Erweiterung das Gutschrift-Template bereits ersetzt, lässt dieses Plugin es unangetastet.

Rechnungen und Stornobelege behandelt das Plugin nicht. Der Hinweis wird dort nicht ergänzt, nur auf Gutschriften des Refund-Plugins.

Twig-Funktionen

Für eigene Templates stellt das Plugin diese Funktionen bereit:

Beispiel für einen eigenen Hinweis in einem Theme-Template:

{% if kleinunternehmer_notice_applies(order) %}
    <p class="mmd-kleinunternehmer-notice">{{ kleinunternehmer_notice_text() }}</p>
{% endif %}

Theme-Kompatibilität

Die Hooks hängen am Standard-Markup von Sylius. Ersetzt dein Theme eines der Templates, das einen dieser Hook-Punkte enthält, und rendert den Hook nicht mehr, entfällt dort auch der Hinweis. Binde in dem Fall den Hook wieder ein oder nutze die Twig-Funktionen oben direkt.