Extension Flächen- & Längenrechner
Extension Flächen- & Längenrechner
Extension Flächen- & Längenrechner
Flächen- & Längenrechner
Beschreibung
Der Flächen- & Längenrechner ist eine Extension für das salepix_templater Plugin, die es Kunden ermöglicht, Produkte nach Länge oder Volumen zu bestellen. Der Rechner arbeitet mit der im Produkt hinterlegten Masseneinheit (z.B. Meter, Liter, Kilogramm) und berechnet den Preis automatisch.
Der Flächen- & Längenrechner ersetzt die Standard-Mengeneingabe durch einen spezialisierten Rechner, der die Masseneinheit des Produkts berücksichtigt. Optional kann ein prozentualer Verschnitt-Zuschlag aktiviert werden.
Anwendungsbereiche
Die Extension eignet sich für folgende Produktkategorien:
- Laufmeterware (Stoffe, Kabel, Schläuche, Rohre)
- Flüssigkeiten (Farben, Öle, Chemikalien)
- Schüttgüter (Sand, Kies, Erde)
- Holz und Baumaterial (Bretter, Balken, Profile)
- Textilien und Kurzwaren (Bänder, Kordeln, Gummis)
- Elektrokabel und Leitungen
- Dichtungsmaterial und Dämmstoffe
- Gartenbedarf (Zäune pro Meter, Rasenkanten)
Einrichtung
Die Konfiguration erfolgt über Funktionsattribute im JTL-Shop Backend und erfordert die Einrichtung einer Masseneinheit im Produkt.
Schritt 1: Öffnen Sie das gewünschte Produkt im JTL-Shop Backend unter "Artikel → Artikel bearbeiten"
Schritt 2: Wechseln Sie zum Tab "Basis" und konfigurieren Sie unter "Verkaufseinheit" die Masseneinheit:
- Verkaufseinheit: z.B. "1" (Menge pro Verkaufseinheit)
- Masseneinheit: z.B. "m" für Meter, "kg" für Kilogramm, "l" für Liter
- Mindestbestellmenge: z.B. "1"
- Abnahmeintervall: z.B. "0.5" für halbe Meter
Schritt 3: Wechseln Sie zum Tab "Attribute" und scrollen Sie zu "Funktionsattribute"
Schritt 4: Fügen Sie das Funktionsattribut detailsrechner hinzu und setzen Sie es auf 1 oder true
Schritt 5 (Optional): Fügen Sie das Funktionsattribut verschnitt hinzu und geben Sie einen Prozentsatz ein (z.B. 4.2 für 4,2% Verschnitt)
Schritt 6: Speichern Sie das Produkt
Der Produktpreis wird automatisch basierend auf der eingegebenen Menge und der Masseneinheit berechnet.
Funktionsattribute
| Attribut-Name | Beschreibung | Beispielwert |
|---|---|---|
| detailsrechner | Aktiviert den Rechner | 1 oder true |
| verschnitt (optional) |
Verschnitt-Prozentsatz (wird als Checkbox angezeigt) | 4.2 |
Das Feld fMassMenge (Masseneinheit) muss im Produkt ausgefüllt sein, damit der Rechner aktiviert wird.
Masseneinheit-Konfiguration im Produkt
Die Masseneinheit wird in den Produkt-Basis-Einstellungen konfiguriert:
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Masseneinheit (fMassMenge) | Verkaufsmenge pro Einheit | 1 |
| Masseneinheit Name (cMasseinheitName) | Name der Einheit (z.B. m, kg, l) | m |
| Mindestbestellmenge | Minimale Bestellmenge | 1 |
| Abnahmeintervall | Schritte, in denen bestellt werden kann | 0.5 (für halbe Meter) |
| Teilbar | Erlaubt beliebige Dezimalwerte | Ja |
Verschnitt-Funktion
Wenn das Funktionsattribut verschnitt gesetzt ist, wird auf der Produktseite eine Checkbox angezeigt, mit der Kunden optional einen Verschnitt-Zuschlag hinzufügen können.
Der Verschnitt wird in Prozent angegeben und auf die bestellte Menge aufgeschlagen.
Beispiel:
- Kunde bestellt: 10 Meter
- Verschnitt aktiviert: 4,2%
- Tatsächliche Bestellmenge: 10 × 1,042 = 10,42 Meter
Berechnungsbeispiele
Beispiel 1: Textilkabel pro Meter
Produktkonfiguration:
- Grundpreis: 2,50 € pro Meter
- Masseneinheit (fMassMenge): 1
- Masseneinheit Name: m
- Mindestbestellmenge: 1
- Abnahmeintervall: 0.5
- detailsrechner: 1
Kundenbestellung:
- Menge: 5 Meter
Berechnung:
Menge: 5 m
Preis: 5 m × 2,50 € = 12,50 €
Beispiel 2: Stoff mit Verschnitt
Produktkonfiguration:
- Grundpreis: 12,00 € pro Meter
- Masseneinheit (fMassMenge): 1
- Masseneinheit Name: m
- Mindestbestellmenge: 1
- Abnahmeintervall: 0.5
- detailsrechner: 1
- verschnitt: 5
Kundenbestellung:
- Menge: 8 Meter
- Verschnitt aktiviert: Ja (5%)
Berechnung:
Basismenge: 8 m
Verschnitt: 8 m × 0,05 = 0,4 m
Gesamtmenge: 8 + 0,4 = 8,4 m
Preis: 8,4 m × 12,00 € = 100,80 €
Beispiel 3: Schüttgut (Kies pro Tonne)
Produktkonfiguration:
- Grundpreis: 45,00 € pro Tonne
- Masseneinheit (fMassMenge): 1
- Masseneinheit Name: t
- Mindestbestellmenge: 1
- Abnahmeintervall: 0.5
- detailsrechner: 1
Kundenbestellung:
- Menge: 3,5 Tonnen
Berechnung:
Menge: 3,5 t
Preis: 3,5 t × 45,00 € = 157,50 €
Beispiel 4: Elektrokabel mit Verschnitt
Produktkonfiguration:
- Grundpreis: 1,80 € pro Meter
- Masseneinheit (fMassMenge): 1
- Masseneinheit Name: m
- Mindestbestellmenge: 5
- Abnahmeintervall: 1
- detailsrechner: 1
- verschnitt: 10
Kundenbestellung:
- Menge: 25 Meter
- Verschnitt aktiviert: Ja (10%)
Berechnung:
Basismenge: 25 m
Verschnitt: 25 m × 0,10 = 2,5 m
Gesamtmenge: 25 + 2,5 = 27,5 m
Preis: 27,5 m × 1,80 € = 49,50 €
Beispiel 5: Flüssigkeit (Farbe pro Liter)
Produktkonfiguration:
- Grundpreis: 8,50 € pro Liter
- Masseneinheit (fMassMenge): 1
- Masseneinheit Name: l
- Mindestbestellmenge: 2.5
- Abnahmeintervall: 2.5
- Teilbar: Ja
- detailsrechner: 1
Kundenbestellung:
- Menge: 7,5 Liter
Berechnung:
Menge: 7,5 l
Preis: 7,5 l × 8,50 € = 63,75 €
Frontend-Darstellung
Auf der Produktseite wird die Standard-Mengeneingabe durch den Flächen- & Längenrechner ersetzt:
- Ein Eingabefeld für die Menge mit der konfigurierten Masseneinheit
- Plus/Minus-Buttons zum Erhöhen/Verringern der Menge
- Automatische Validierung basierend auf Mindestbestellmenge und Abnahmeintervall
- Optional: Checkbox für Verschnitt-Zuschlag (wenn konfiguriert)
Warenkorb-Verhalten
Produkte mit aktiviertem Flächen- & Längenrechner können im Warenkorb in der Menge geändert werden. Die Mengenänderung berücksichtigt automatisch die konfigurierten Mindestbestellmengen und Abnahmeintervalle.
Die bestellte Menge wird mit der Masseneinheit in der Bestellung gespeichert (z.B. "5 m", "3,5 kg", "10 l").
Technische Hinweise
Die Extension validiert automatisch die Eingaben:
- Werte unter der Mindestbestellmenge werden auf die Mindestbestellmenge korrigiert
- Werte werden auf das nächste gültige Abnahmeintervall gerundet
- Bei aktivem "Teilbar"-Flag sind beliebige Dezimalwerte möglich
- Nur numerische Eingaben sind möglich
Die Berechnung erfolgt nach der Formel:
Preis = (Menge × fMassMenge) × Grundpreis
Mit Verschnitt: Preis = (Menge × fMassMenge × (1 + Verschnitt/100)) × Grundpreis
Unterschiede zur Standard-Mengeneingabe
| Feature | Standard-Eingabe | Flächen- & Längenrechner |
|---|---|---|
| Masseneinheit | Nicht erforderlich | Erforderlich (fMassMenge) |
| Anzeige | Nur Anzahl | Anzahl + Masseneinheit (z.B. "5 m") |
| Verschnitt | Nicht verfügbar | Optional per Checkbox |
| Preisberechnung | Anzahl × Preis | (Anzahl × fMassMenge) × Preis |