Options- und Freitext-Modul Datei-Upload Modul für xt:commerce Veyton Plugin-Funktionen... Systemvoraussetzung... Installation... 3 Code-Anpassungen... 4 Konfiguration... 6 1
Plugin-Funktionen Das Options- und Freitextmodul Datei-Upload ist eine Erweiterung des Optionsund Freitextmoduls. Damit können Ihre Kunden eigene Dateien hochladen, zum Beispiel Bilddateien für den Druck individualisierter T-Shirts. Systemvoraussetzung Systemvoraussetzung für dieses Plugin ist xt:commerce Veyton ab Version 4.0.13. Bitte beachten Sie, dass das Plugin eine Erweiterung des Options- und Freitextmoduls ist. Dieses Plugin (ab Version 1..1) muss also bereits installiert sein, wenn das Datei-Upload-Modul funktionieren soll.
Installation Vorbereitung Vor der Installation eines Plugins sollten Sie Ihre Daten sichern. Besonders wichtig: die Shopdatenbank. Installation Schritt für Schritt 1. Plugin entpacken und per FTP in den Ordner Plugins des Veyton-Shops laden.. Die beiliegende Lizenzdatei in den Ordner /lic des Shops laden. 3. Im Adminbereich des Shops das Plugin unter Inhalte -> deinstallierte Plugins installieren. 4. Im Adminbereich das Plugin unter Inhalte -> installierte Plugins aktivieren (auch für den jeweiligen Mandanten) und konfigurieren. Nach der Installation laden sie den kompletten Adminbereich neu (in den meisten Browsern mit F5). Installations-/Deinstallations-Reihenfolge Das Options- und Freitextmodul Datei-Upload ist eine Erweiterung des Optionsund Freitextmoduls ist. Zuerst muss also das Options- und Freitextmodul installiert sein, bevor die Erweiterung installiert werden kann. Beim Deinstallieren Falls Sie noch andere Erweiterungen des Options- und Freitextmoduls nutzen und eventuell Module deinstallieren möchten, müssen Sie diese in genau der umgekehrten Reihenfolge deinstallieren, in der Sie die Module installiert haben. Code-Anpassungen Damit alle Funktionen des Plugins nutzbar sind, müssen Sie einige Code-Zeilen anpassen und Dateien ersetzen. Genaue Anweisungen dazu finden Sie auf der Seite Code-Anpassungen. 3
Code-Anpassungen Damit alle Funktionen des Plugins nutzbar sind, müssen Sie einige Code-Zeilen anpassen und Dateien ersetzen. Die notwendigen Änderungen unterscheiden sich nach der Veyton-Version. Bis zur Version 4.0.1 führen Sie bitte alle fünf Schritte durch. 1 In der Datei (abhängig von Ihrem Template): templates/{ihr Template}/xtCore/pages/product/product.html ersetzen Sie diese Anweisung: {form type=form name=product action='dynamic' link_params=getparams method=post} durch folgende: {form type=form name=product action='dynamic' link_params=getparams method=post enctype='multipart/formdata'} In der Datei: xtframework/database_handler.php ersetzen Sie diese Anweisung: $SessName = 'x'.substr(md5($_server['http_user_agent']),0,5); durch folgende: $SessName = 'x'.substr(md5($_server['remote_addr']),0,5); Falls beim Hinzufügen in den Warenkorb die Datei nicht übernommen wird, tragen Sie noch folgende Anweisung dahinter ein: if (isset ($_POST[$SessName])) { $_GET[$SessName] = $_POST[$SessName]; } 3 Im Ordner../xt_product_options_fileupload/newfiles finden Sie folgende Dateien: class.extadminhandler.php class.exteditform.php class.extfunctions.php 4
Überschreiben Sie damit die gleichnamigen Dateien in folgendem Ordner: xtframework/admin/classes 4 Im Ordner../xt_product_options_fileupload/newfiles finden Sie folgende Dateien: swfupload_f10.js handlers.js Überschreiben Sie damit die gleichnamigen Dateien in folgendem Ordner: xtframework/library/ext_plugin/swfuploadpanel 5 Im Ordner../xt_product_options_fileupload/newfiles finden Sie folgende Dateien: popup.html Überschreiben Sie damit die gleichnamige Datei in folgendem Ordner (abhängig von Ihrem Template): templates/{ihr Template}/ 5
Konfiguration (Beachten Sie bitte auch die generelle Konfigurations-Anleitung für das Options- und Freitext-Modul.) Einstellungsmöglichkeiten im Plugin- Bearbeitungsfenster Ort im Admin: Inhalte -> Plugin -> installierte Plugins -> Product Options Fileupload Plugin-Status: aktiviert das Plugin generell Status: aktiviert das Plugin für den jeweiligen Shop Thumbnail-Höhe: in px, für die Vorschau von Bild-Dateien Thumbnail-Breite: in px, für die Vorschau von Bild-Dateien Hinweisseite zu Uploads: Eine Hinweisseite können Sie über den Contentmanager im Admin-Bereich Inhalte anlegen. Nach der Aktivierung des Plugins laden Sie den gesamten Adminbereich mit F5 neu. Options-Gruppen und -Werte für Datei-Uploads anlegen Ort im Admin: Shop -> Produkt-Optionen Neue Optionsgruppen für Datei-Uploads legen Sie mit Dateiupload Neu an. Darauf öffnet sich ein Bearbeitungsfenster, in dem Sie neben einigen Standardangaben Folgendes einstellen können: Feld-Typ: Auswählen lässt sich nur der Feldtyp File Upload. Erlaubte Dateitypen: Tragen Sie die Datei-Endungen ein, getrennt durch Kommas ohne Leerzeichen. Zum Beispiel: jpg,jpeg,pdf min. Bildhöhe und min. Bildbreite: in px (für Bilder, die eine bestimmte Mindestgröße aufweisen sollen) Ihre Einstellungen können Sie später auch beim Bearbeiten der Optionswerte und Artikel überschreiben. 6
Weitere Informationen und Angebote finden Sie auf: www.bui-hinsche.de Individuelle Anfragen richten Sie bitte an: info@bui-hinsche.de BuI Hinsche GmbH Geschäftsführer: Matthias Hinsche Donaliesstraße 45/46 0671 Zeitz Telefon: +49 (0) 34 41 / 7 53 06 Telefax: +49 (0) 34 41 / 7 53 07 7