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