Modul Flächenberechnung

Modul Flächenberechnung Inhalt Funktionsbeschreibung... 2 Systemeinstellungen... 2 Installation... 3 Wichtige Information... 3 Menüinstellungen... 4 Optionsgruppen... 5 Optionswerte... 6 Artikeleinstellungen... 11 Kalkulationseinheiten... 12 Art der Berechnung... 13 FAQ.... 17 1

Funktionsbeschreibung Bieten Sie Ihren Kunden die Möglichkeit, Online die Breite, Länge, Höhe Ihres individuellen Produktes zu berechnen und anschließend zu kaufen. Frontend Das Modul beeinhaltet auch eine Uploadfunktion die bei jedem Produkt individuell de- oder aktiviert werden kann. Der Kunde hat dann nach der Bestellung die Möglichkeit eine Datei hochzuladen Backend Das Backend des Moduls bietet umfangreiche Einstellmöglichkeiten: Upload aktivieren Einstellen von Berechnungseinheiten (m, mm, cm, l) Einstellen von Berechnungseinheiten für das Kalkulationsergebnis(m², mm², cm², m³ ) Einstellen der Dateiendungen beim Upload Dynamische Preiskalkulation Systemeinstellungen Systemvoraussetzung für dieses Plugin ist das Shopsystem Veyton ab Version 4.0.14. 2

Installation Wichtige Information Vor der Installation des Plugins unbedingt eine Sicherung des Shops und der Datenbank durchführen Für STRATO Kunden: Sofern Sie Strato als Provider haben oder Ihr Shop bei einem Provider haben die Ioncube per Php.ini im Root des Shops zur Laufzeit laden, müssen Sie unbedingt in jedem Verzeichnis des Moduls was PHP-Dateien beinhaltet, eine PHP.ini Datei mit absoluten Pfad zum Ioncube Ordner kopieren, da ansonsten Sie eine Fehlermeldung erhalten bzw. der Shop nicht mehr erreichbar ist. z.b. müsste die PHp.ini Datei so angepasst werden: zend_extension = /IHRABSOLUTERPFAD/ioncube/ioncube_loader_sun_5.2.so safe_mode = no 1. Die von uns gesendete ZIP-Datei entpacken. 2. Den Ordner plugins, xtframework des entpackten Zip-Archivs in Ihrem Shopverzeichnis hochladen. 3. Den Ordner Templates hochladen und alte Dateien überschreiben oder gegebenenfalls anpassen Neue Passagen fangen mit  und enden mit <! FLAECHE ENDE--> 4. Die beiliegende Lizenzdatei in den Ordner lic des Shops laden. 5. Im Adminbereich des Shops das Plugin unter Inhalte -> deinstallierte Plugins - >Flächenberechnung installieren. 6. Unter Inhalte -> Plugins -> installierte Plugins das Modul Flächenberechnung auf bearbeiten klicken. 7. Setzen Sie bei den Einstellungen des Modul einen Haken unter Plugin-Status und geben Sie Domain ein, mit http und Slash am Ende z.b. http://ihredomain.de/. 3

8. Die Administrationsseite erneut mit F5 neu laden. Menu Einstellungen Nachdem die Seite neu geladen wurde finden Sie unter Shop folgende neue Punkte vom Modul Optionsgruppen: Erstellen neuer Optionsgruppen und Werte Kalkulationseinheiten: Einstellen von Berechnungseinheiten (m, mm, cm, l) Einstellen von Berechnungseinheiten für das Kalkulationsergebnis(m², mm², cm², m³ ) Art der Berechnung: Erstellen neuer Berechnungsformeln. Vier sind schon eingebunden als Standard Berechnung = (a = b * c * d) 4

Berechnung = (a = b - c) Berechnung = (a = b + c) Berechnung (a = b * c) Optionsgruppen Wenn Sie auf Optionsgruppen klicken erscheint folgendes Fenster: Sie können mittels klick auf Neu eine neue Optionsgruppe hinzufügen. Weitere Funktionen können Sie dem untenstehenden Bild entnehmen Gelbes Sternchen: Zur Optionswertseite gelangen um neue Optionswerte zur Optionsgruppe hinzufügen Wenn Sie auf Bearbeiten oder Neu klicken, können Sie entweder eine Optionsgruppe hinzuzufügen oder bearbeiten. Geben Sie der Optionsgruppe einen Namen, wählen Sie ihr gewünschtes Optionsfeld (Select für Optionen, calculator für Berechnungsfeld ) aus. 5

Unter Template können Sie das Template für die Optionsgruppe auswählen. Sie müssen aber darauf achten dass Sie zum gewählten Optionsfeld (Select oder Calculator )das dementsprechende Template dazu auswählen. Sie können auch selber eigene Templates erstellen und unter plugins/pix_flaeche/templates hochladen. Wichtige Info zu den Optionswerten: Die Optionsgruppe Calculator können je Produkt nur einmal eingesetzt werden! Optionswerte Wenn Sie in der Liste der Optionsgruppen auf das gelbe Sternchen der jeweiligen Optionsgruppe klicken gelangen Sie zur Optionswerteansichtsseite. 6

Hier können Sie der Optionsgruppe, Optionswerte hinzufügen Geben Sie auch hier einen Namen und eine Beschreibung ein. Die Beschreibung ist nur als Interner Merkzettel gedacht und wird nicht im Frondend angezeigt. Wichtig: Sollten Sie der Optionsgruppe Calculator, Optionswerte hinzufügen, müssen Sie so viele Optionswerte einfügen die Ihre Berechnungsgrundlage an Variablen hat z.b. Berechnung = (a = b * c * d) a ist immer das Ergebnis, somit müssten Sie bei dieser Berechnungsgrundlage (b * c * d), drei Optionsfelder hinzufügen. Wichtige Info zu den Optionswerten: Die Optionsgruppe Calculator kann je Produkt nur einmal eingesetzt werden! 7

Wenn Sie jetzt auf Artikel unter Shop klicken, sehen Sie zwei zusätzliche Buttons vom Modul. Vorgehensweise: Sofern Sie vorher Optionsgruppen und Optionswerte erstellt haben, klicken Sie auf den Button links neben dem gelben Sternchen bei Ihrem gewünschten Produkt dem Sie Optionsgruppen und Werte unterordnen wollen. Es öffnet sich ein neues Fenster mit allen Optionsgruppen und deren Werte. Setzen Sie bei Ihrem gewünschten Optionswert ein Häkchen. Wenn Sie alle Werte ausgewählt haben klicken Sie oben links auf Speichern. Schließen sie danach das Fenster Klicken Sie dann auf das gelbe Sternchen in der Artikelliste, bei Ihrem gewünschten Produkt. Somit gelangen Sie zur nächsten Seite, bei dem Sie ihre vorher ausgewählten Optionswerte konfigurieren 8

können. Wenn Sie auf bearbeiten klicke, können Sie Einstellungen vornehmen zum Optionswert Artikelnummer, Gewicht, Gewicht-Prefix ist zur Zeit ohne Funktion Kalkulationsparameter: Wenn Sie z.b. eine Optionsgruppe Calculator eingestellt haben und z.b. die Berechnungsgrundlage für die Flächenberechnung Berechnung (a = b * c) ausgewählt haben, und dementsprechend zwei Optionswerte für b und c erstellt haben, müssen sie hier vorgeben welche Formel dieser Optionswert hat. z.b. 2 Optionswerte erstellt 1 x Optionswert für b = width/breite bei Formel auswählen 1 x Optionswert für c = height/höhe auswählen Preis-Prefix (nur bei Select Feldern) : + = der Aufpreis wird der Gesamtsumme dazuaddiert - = der Aufpreis wird von der Gesamtsumme subtrahiert % = Aufschlag an Prozent auf den Gesamtpreis der Flächenberechnung. 9

Beispiel: Aufschlag an Prozent: 10 %; Basiskalkulationspreis (Siehe Artikeleinstellungen) : 10, 00 EUR Kunde gibt 1m Breite und 2m Höhe ein Gesamtfläche wäre dann: 2m² Gesamtpreis = Gesamtfläche * 10,00 EUR Aufpreis des Optionswerts wäre dann 10% von 20,00 EUR wären dann 2,00 EUR 2 EUR würden dann auf den Gesamtpreis aufgeschlagen x = Wert wird multipliziert mit den Gesamtpreis der Flächenberechnung. Kalkulationseinstellungen Hier haben Sie die Möglichkeit, Einstellungen vorzunehmen für die Optionswerte der Optionsgruppe Calculator. Maximale Breite: Maximale Breite die der User eingeben kann Maximale Höhe: Maximale Höhe die der User eingeben kann Minimale Breite: Minimale Breite die der User eingeben kann Minimale Höhe: Minimale Höhe die der User eingeben kann Minimale Länge: Minimale Länge die der User eingeben kann Maximale Länge: Maximale Länge die der User eingeben kann Berechnungseinheit: mm, cm, m. Minimale Breite: Minimale Breite die der User eingeben kann 10

Artikeleinstellungen Wenn Sie Ihre Einstellungen bei den Optionswerten durchgeführt haben, müssen Sie noch beim Artikel selbst, noch Einstellungen vornehmen. Klicken Sie daher auf Bearbeiten Button beim gewünschten Artikel. Klicken Sie dann oben auf Flächenberechnung. Sie sehen dann folgende Einstellungen Setzen Sie ein Häkchen bei Flächenberechnung ja / nein, damit bei diesem Produkt in der Artikeldetailseite das Modul mit den Optionsgruppen und Optionswerten die Sie voreingestellt haben, angezeigt wird. Preis für Berechnung: Hier den Basiskalkulationspreis angeben für die Flächenberechnung Berechnungseinheit (Gesamt): Einstellen der Einheit für das Gesamtergebnis der Kalkulation. Art der Berechnung: Wählen Sie hier die Berechnungsgrundlage aus 11

Kalkulationseinheiten Überblick Unter diesem Punkt können Sie Berechnungseinheiten (m, mm, cm, m, m²,cm²..) einfügen. Die gängigsten sind schon standardmäßig installiert. Hierbei wird von zwei Arten unterschieden: 1: Berechnungseinheiten für die Optionswerte (mm, cm, m) 2: Berechnungseinheiten für die Kalkulation des Gesamtergebnisses (mm², cm², m²) Einstellungen Wert: Geben Sie hier den Wert der Einheit ein Art: Wählen Sie hier die Art der Einheit Name: Name der Einheit Beschreibung: Nur intern, nicht zwingend notwendig 12

Art der Berechnung Überblick Hier können Sie neue Berechnungsformeln einfügen 13

Einstellungen Kalkulation: $a muss immer als Ergebnis vorne stehen. folgende Variablen stehen zur Verfügung: $a als Ergebnis, $b als Breite, $c als Höhe, $d als Länge Am Ende muss immer ein Semikolon stehen und nicht die Dollarzeichen vergessen. Möchten Sie z.b. die Fläche berechnen müssen Sie folgendes dann eintragen: $a = $b * $c; Zwei Optionswerte erforderlich (Breite, Höhe) Volumen: $a = $b * $c * $d; Drei Optionswerte erforderlich (Breite, Höhe, Länge) Name: Ein Namen ihrer Berechnung 14

Flächenstaffeln In der Artikelübersicht finden Sie jetzt ein neues Icon was wie ein Taschenrechner aussieht. Wenn Sie bei einem Artikel auf dieses Icon klicken, öffnet sich ein neues Fenster mit den Flächenstaffeln. Hier können Sie nun Ihre Flächenstaffeln eingeben. Sofern Sie mit Flächenstaffeln arbeiten möchten, müssen Sie unbedingt als ersten Eintrag bei der Mengengrenze die Nummer 1 eingeben. Berechnungsgrundlage für Flachenstaffeln. Im unterem Beispiel sind zwei Staffeln eingepflegt Mengengrenze : 1, Preis : 10,00 EUR Mengengrenze : 1 0, Preis : 9,00 EUR Sobald der Kunde z.b. bei Breite und Höhe etwas eingibt und das Gesamtergebnis ist größer als z.b. 10m² wird der m² Preis mit 9,00 EUR berechnet. Wichtig: Sie können entweder mit Flächenstaffeln oder Preisstaffeln vom Xt:Commerce 4 arbeiten. Beides geht technisch nicht. Email-Manager Unter Email-Manager, bei send_order auf bearbeiten klicken. Dann unter HTML-EMAIL nach den Eintrag {$order_values.products_name} suchen. Nach dem Eintrag: {$order_values.products_name} folgendes einfügen: 15

{if $order_values.pix_flaeche_oupload_status == '2' } {txt key=text_upload_after} {/if} {base64 path=$order_values.pix_flaeche_description } {foreach name=aussen item=calc_data from=$order_values.products_flaeche_information.calc_options} {$calc_data.label}:{$calc_data.text} {$calc_data.suffix} {/foreach} {foreach name=aussen item=calcoptions_data from=$order_values.products_flaeche_information.options} {$calcoptions_data.label}:{$calcoptions_data.text} {$calcoptions_data.prefix}{if $calcoptions_data.price}{$calcoptions_data.price}{/if}{if $calcoptions_data.value}{$calcoptions_data.value}{/if} {/foreach}  16

FAQ Im Frontend wird nichts berechnet? Es kann unter Umständen vorkommen dass bei der Installation die Formeln unter Art der Berechnung nicht korrekt gespeichert wurden bei der Installation des Plugins. Gehen Sie dann wie folgt vor: 1. Klicken Sie z.b. auf die erste Formel a = b * c *d auf bearbeiten 2. Sollte im ersten Textfeld Formel bzw. TEXT_CALCULATION nur Zeichen wie z.b. Plus, Minus oder Gleichheitszeichen stehen müssen Sie dann folgendes machen: Kopieren Sie den Namen, in diesem Fall wäre es a = b * c *d und fügen Sie es in das Textfeld Formel bzw. TEXT_CALCULATION ein. Fügen Sie vor a, b, c, d jeweils ein Dollarzeichen $ davor und am Ende ein Semikolon. Es sollte dann folgendes im Textfeld Formel bzw. TEXT_CALCULATION stehen: $a = $b * $c * $d; Die gleiche Prozedur müssen Sie bei den anderen Berechnungsformeln tun. Weitere Module finden Sie auf unserer Webseite www.pixeleyes.de Individuelle Anpassungen richten Sie bitte an info@pixeleyes.de Pixeleyes Geschäftsführer: Stefan Pakos Oststraße 82 42551 Velbert Tel.: 02051 313533 Fax: 02051 6076640 17