Systemvoraussetzungen Für die Installation und den Betrieb des Moduls müssen folgende Voraussetzungen gegeben sein:

Transkript

1 Modul: SWGX2_0010 Bezahl- und Versandsperre V3.00 Die erworbene Nutzungslizenz erweitert Ihren GX2-Shop V2.1.x.x um folgende Funktionen: Optionale Sperrung von Versandarten abhängig vom Artikel (Versandsperre) Optionale Sperrung von Zahlungsarten abhängig vom Artikel (Bezahlsperre) Systemvoraussetzungen Für die Installation und den Betrieb des Moduls müssen folgende Voraussetzungen gegeben sein: PHP 5.4 oder 5.5 Shopversion 2.1.x.x Verfügbarkeit von Prüfen Sie bei Ihrem Hoster vor der Installation die notwendigen Systemvoraussetzungen, da nur so ein ungestörter Betrieb möglich ist. Hinweise und eine Vorgehensweise finden Sie auf unserer Homepage unter folgendem Link:

2 Selbst-Installation (DIESEN PUNKT BITTE ÜBERSPRINGEN, WENN SIE DEN INSTALLATIONS-SERVICE GEBUCHT HABEN) WICHTIG! Führen Sie zunächst eine komplette Datensicherung durch. Dazu gehört sowohl die Sicherung aller Dateien und Ordner des Shops, als auch die Sicherung der Shop Datenbank. Für den Fall dass nach der Installation der vorliegenden Software bzw. der vorliegenden Scripte, Dateien etc. der Shop nicht wie gewünscht funktioniert, können Sie die Datensicherung wieder einspielen. Wird keine Datensicherung durchgeführt, gehen bisherige Daten möglicherweise verloren und können nicht rekonstruiert werden. Beachten Sie hierzu die Hinweise zur Datensicherung an Ende dieses Dokumentes. WIR ÜBERNEHMEN KEINE HAFTUNG FÜR SELBSTVERSCHULDETE DATENVERLUSTE INSBESONDERE WENN AUF DIE VORHERIGE ANFERTIGUNG EINES BACKUPS VON SHOP UND/ODER DATENBANK VOR DER INSTALLATION VERZICHTET ODER DIESE FEHLERHAFT DURCHGEFÜHRT WURDEN. BEAUFTRAGEN SIE IM ZWEIFELSFALL DEN INSTALLATIONSSERVICE FÜR DAS MODUL. Sie erhalten zwei Archive: eines mit dem Modul und eines mit dem jeweils aktuellsten Modul-Framework beide Archive müssen entpackt und ihr Inhalt in das Shophauptverzeichnis per FTP hochgeladen werden. Das Modul liegt als gepacktes Archiv im Format ZIP vor und trägt den Namen und die Nummer des jeweiligen Moduls: swgx2_0010_versandundbezahlsperre.zip Entpacken Sie das Archiv in ein neues Verzeichnis Ihrer Wahl, in dem sich nicht bereits andere Dateien befinden, so dass der Inhalt des Archivs sauber bleibt und nicht mit anderen Dateien vermischt wird. Nach dem Entpacken des Installationsarchivs befinden sich die Installationsdateien in dem von Ihnen gewählten Ordner: Verbinden Sie sich nun über Ihr FTP-Programm mit Ihrem Shop Server und begeben Sie sich in das Hauptverzeichnis des Shops. Laden Sie nun alle Dateien aus dem oben gewählten Verzeichnis in das Hauptverzeichnis Ihres Shops hoch. Beachten Sie aber, dass Sie nicht das Verzeichnis, in welches Sie das Archiv entpackt haben hochladen, sondern nur seinen Inhalt mit den oben gezeigten Verzeichnissen. Bei einem Shop, in dem das Modul noch nicht installiert wurde werden keine Dateien überschrieben.

3 Selbst-Installation Das ModulFramework Alle Module der Shopversion 2.1 können nur bei gleichzeitigem Einsatz und Verfügbarkeit des ModulFrameworks betrieben werden. Das Modul-Framework liegt als gepacktes Archiv im Format ZIP vor und trägt einen entsprechenden Namen und die Versionsnummer des Frameworks: swgx2_modulframework_8.01.zip Entpacken Sie das Archiv in ein neues Verzeichnis Ihrer Wahl, in dem sich nicht bereits andere Dateien befinden, so dass der Inhalt des Archivs sauber bleibt und nicht mit anderen Dateien vermischt wird. Nach dem Entpacken des Installationsarchivs befinden sich die Installationsdateien in dem von Ihnen gewählten Ordner: Verbinden Sie sich nun über Ihr FTP-Programm mit Ihrem Shop Server und begeben Sie sich in das Hauptverzeichnis des Shops. Laden Sie nun alle Dateien aus dem oben gewählten Verzeichnis in das Hauptverzeichnis Ihres Shops hoch. Beachten Sie aber, dass Sie nicht das Verzeichnis, in welches Sie das Archiv entpackt haben hochladen, sondern nur seinen Inhalt mit den oben gezeigten Verzeichnissen. Bei der Installation Ihres ersten Xycons-Moduls werden keine Dateien überschrieben. Bei einem Shop, in dem bereits Xycons-Module betrieben werden und in dem bereits ein Modulframework vorhanden ist wird es zur Überschreibung des Modulframeworks kommen. Bestätigen Sie das Überschreiben der Dateien jeweils und erlauben Sie die Überschreibung.

4 Vollständige De-Installation Sollte es notwendig sein oder wenn Sie die De-Installation des Moduls wünschen gehen Sie folgendermaßen vor: Nehmen Sie sich die aus dem Modul-ZIP entpackte Struktur als Vorlage und löschen Sie per FTP alle entsprechenden Dateien, welche in derselben Hierarchie ausgehend vom Shophauptverzeichnis liegen. Zur De-Installation des Modul-Frameworks gehen Sie genauso mit dem Framework-ZIP vor und löschen die gleichnamigen Dateien im Shop. Nach dem Löschen der Dateien müssen Sie den Ordner /cache bis auf die Dateien index.html und.htaccess per FTP-Löschen, damit die nun fehlenden Klassenüberladungen und Dateien vom Shop nicht mehr als fehlend gemeldet werden. Schnelle De-Aktivierung der Module Sollte es notwendig sein können Sie die Modulstarter löschen um das Laden der Module zu unterdrücken. Löschen Sie hierzu folgende Dateien im Shop: /user_classes/overloads/adminapplicationtopextendercomponent/swgx2_all_adminapplicationtopextendercomponent.inc.php /user_classes/overloads/applicationtopextendercomponent/swgx2_all_applicationtopextendercomponent.inc.php Nach dem Löschen der Dateien müssen Sie den Ordner /cache bis auf die Dateien index.html und.htaccess per FTP-Löschen, damit die nun fehlenden Klassenüberladungen und Dateien vom Shop nicht mehr als fehlend gemeldet werden.

5 NUTZUNGLIZENZEN - WICHTIGER HINWEIS FÜR TEST-LIZENZEN: Das Modul installiert beim ersten Aufruf alle notwendigen Veränderungen, legt benötigte Datensätze an und generiert aus Ihrer Shop Konfiguration (URL, Pfad zum Shop-Hauptverzeichnis, Modulnummer, Datum) einen eindeutigen Schlüssel der für die unlimitierte Freischaltung notwendig ist. Dieser Lizenzschlüssel wird an den Xycons-Lizenzserver übertragen welcher eine 14-tägige Test-Lizenz zurück liefert, die den Betrieb des Moduls 14 Tage lang nahezu ohne Einschränkungen ermöglicht. Während dieser Testphase erfolgt aber die Anzeige einer roten Hinweis-Box im Informationsbereich des Admins, dass das Modul in seiner Laufzeit limitiert ist. Selbstverständlich verschwindet diese Anzeige sobald Sie eine vollwertige Lizenz erworben haben und diese vom Lizenz-Server bestätigt wurde. Während der Testphase kontaktiert das Modul unregelmäßig den Xycons-Lizenzserver und fragt die Gültigkeit des Shoplizenz- Schlüssels ab. Läuft der Test-Zeitraum ab, dann warnt das Modul 3 Tage vor Ablauf der Test-Lizenz durch entsprechende Hinweise vor dem Ablauf der Test-Lizenz. Wurde keine vollwertige Lizenz erworben schaltet sich das Modul nach Ablauf des Test-Zeitraums selbsttätig ab und kann nicht mehr eingeschaltet werden. Die Abschaltung nach Deaktivierung der Testlizenz unterscheidet sich von der Ausschaltung, die Sie selbst über das Setup des Moduls jeweils vornehmen können, da nur bei einer abgelaufenen Testlizenz weiterhin Hinweise auf die abgelaufene Test-Lizenz erzeugt werden. Es empfiehlt sich daher das Modul wieder zu deinstallieren wenn Sie sich entschließen haben keine vollwertige Nutzungslizenz zu erwerben, da die Hinweise sonst doch sehr störend und nervig sein könnten. Als Inhaber einer vollwertigen Lizenz haben Sie diese Lizenz-Hinweise jedoch nicht. Eine zeitlich begrenzte Nutzungslizenz wird Ihnen im Info-Bereich angezeigt. Sie können über unsere Webseite eine unbegrenzte Nutzungslizenz direkt über den angezeigten Link erwerben. HINWEISE BEIM ERWERB EINER UNLIMITIERTEN NUTZUNGSLIZENZ Nach dem Erwerb der unlimitierten Nutzungslizenz wird Ihnen zunächst eine (s. o.) Test-Lizenz freigeschaltet. Nach Ausgleich der Nutzungslizenz schalten wir die entsprechende Lizenz in unserem Lizenz-Server zeitnah für Sie frei. Bei seiner nächsten Gültigkeitsanfrage an den Lizenzserver passiert folgendes: Der Lizenzserver beantwortet die Anfrage nach der Lizenzgültigkeit mit einem Gegenschlüssel und signalisiert so die Verfügbarkeit einer unlimitierten Lizenz passend zu Ihrem individuellen System-Schlüssel Das Modul nimmt den Gegen-Schlüssel entgegen und hebt die Limitierung auf. Ist der Gegenschlüssel eingetragen und gültig unterlässt das Modul jegliche weitere Anfragen an den Lizenz-Server sobald der passende Gegenschlüssel in der o. g. Datei gefunden wird. Das Lizenzgültigkeitsdatum wechselt exemplarisch auf den Ab dieser Freischaltung erfahren wir nicht mehr (z. B. wenn Sie Updates des Moduls installiert haben) in welcher Version sich das Modul gerade befindet; teilen Sie uns deshalb die Modulversion bei allen Anfragen mit. Sie finden die Versionsangabe in der Kopfzeile der Setup-Verwaltung des jeweiligen Moduls.

6 Das Setup Das Setup erlaubt die Einrichtung des Moduls und die Anpassung an den gewünschten Einsatz. Das Gesamt-Modul kann ein- und ausgeschaltet werden. Ist das Modul eingeschaltet, so können die Funktionen (Teil-Module) für Bezahlsperre und Versandsperre unabhängig voneinander aktiviert oder deaktiviert werden. Im ausgeschalteten Zustand werden alle Anzeigen und Funktionen ggf. beschränkt auf das Teil-Modul - unterdrückt.

7 Die Einrichtung der Sperren Ist das Gesamt-Modul und das jeweilige Teil-Modul aktiviert, dann stehen die jeweiligen Funktionen zur Verfügung. BEZAHLSPERRE Ist die Bezahlsperre aktiviert, so erscheinen bei jedem Artikel innerhalb der Artikel-/Kategorieverwaltung entsprechende Checkboxen die erlauben, die jeweilige Zahlungsweise zu sperren. Dies bedeutet, dass die Zahlungsweise nicht mehr angeboten wird, sobald sich dieser Artikel im Warenkorb befindet. Sie finden diese Einstellmöglichkeit im oberen Bereich der Seite zur Verwaltung von Artikeln/Kategorien nach Aufruf eines Artikels zur Änderung oder bei der Neuanlage: Die Funktion listet die aktivierten Zahlungsweisen des Shops auf und bietet die Sperrung an. Bitte beachten Sie: Wenn mehrere Artikel mit einer Bezahlsperre ausgestattet wurden, dann ergänzen sich die jeweiligen Einstellungen; das kann ggf. dazu führen, dass nach Auswertung der Sperren keine Zahlungsweise mehr zur Verfügung steht, wenn die beteiligten Artikel letztendlich alle verfügbaren Zahlungsarten gesperrt haben! In diesem Fall wäre der Warenkorb nicht bestellbar! VERSANDSPERRE Ist die Versandsperre aktiviert, so erscheinen bei jedem Artikel innerhalb der Artikel-/Kategorieverwaltung entsprechede Checkboxen die erlauben, die jeweilige Versandart zu sperren. Dies bedeutet, dass die Versandart nicht mehr angeboten wird, sobald sich dieser Artikel im Warenkorb befindet. Sie finden dieses Einstellmöglichkeit im oberen Bereich der Seite zur Verwaltung von Artikeln/Kategorien nach Aufruf eines Artikels zur Änderung oder bei der Neuanlage: Die Funktion listet die aktivierten Versandarten des Shops auf und bietet die Sperrung an. Bitte beachten Sie: Wenn mehrere Artikel mit einer Versandsperre ausgestattet wurden, dann ergänzen sich die jeweiligen Einstellungen; das kann ggf. dazu führen, dass nach Auswertung der Sperren keine Versandart mehr zur Verfügung steht, wenn die beteiligten Artikel letztendlich alle verfügbaren Versandarten gesperrt haben! In diesem Fall wäre der Warenkorb nicht bestellbar!

8 Die Funktionsweise Das Modul wertet die gesetzten Sperren für Versandarten und Zahlungsweisen innerhalb des Warenkorbes aus. Hierbei wird die Anzeige für die Versandkostenberechnung, die Versandinformation und die Zahlungsinformation ggf. entsprechend beeinflusst, je nachdem welches Teil-Modul aktiviert ist und ob die im Warenkorb befindlichen Artikel mit einer entsprechenden Sperre ausgestattet wurden. Im nachfolgenden Beispiel ergänzen sich die beiden Artikel mit ihren Sperren, so dass lediglich die Selbstabholung als Versandart und die Barzahlung als Zahlungsweise noch verfügbar sind. Der Kunde kann nun nur noch aus den nicht gesperrten und aktivierten Versandarten und Zahlungsweisen auswählen.

9 Die Modultexte Das eingebaute Modul unterstützt den neuen Textmanager, welcher basierend auf dem Gambio Text Manager Texte anpassen speziell für die Texte der Xyconsmodule integriert wurde. Hierdurch können Sie die von den jeweiligen Modulen genutzten Sprachvariablen beeinflussen und ändern. Bitte beachten Sie aber, dass diese spezielle Version ausschließlich die Texte der Xyconsmodule verwaltet; normale Textanpassungen nehmen Sie bitte über das gewohnte Tool Texte anpassen vor. Die Bedienung entspricht jedoch dem eingebauten Tool Texte anpassen. Ihre Änderungen beziehen sich immer auf die aktuell im Admin-Bereich ausgewählte Sprache. Die Erfassung der Texte muss in html-codierung erfolgen; ein ü wird also als $uuml; dargestellt und eingegeben. Hinweise zu dieser Schreibweise erhalten Sie z. B. auf folgender Internetquelle: Wir wünschen Ihnen viel Erfolg beim Einsatz dieses Moduls! Versionshistorie: Modulrelease V4.00 GX

10 LIZENZ-INFORMATION Das vorliegende Modul wurde von uns in Ihr Shopsystem integriert. Das Modul unterliegt weitestgehend der GPL. Aufgrund der Entwicklungsaufwände haben wir zum Schutz unserer investierten Arbeit zentrale Berechnungsroutinen und Prozesse in separate PHP-Dateien ausgelagert. Diese ausgelagerten Prozesse benutzen keinerlei Routinen des Kernshops und unterliegen somit und ausdrücklich NICHT der GPL. Wir erheben auf diese Routinen - ohne die das Modul nicht betrieben werden kann - das Copyright wie auch die Leistungsschutzrechte und gewähren Ihnen ein zeitlich unbegrenztes Nutzungsrecht. Die zentralen Routinen wurden verschlüsselt und wurden an Ihre Domain gebunden. Jeder Betrieb einer Modul-Kopie in einem Shop-System, welches nicht auf der das Modul kodierten Domain betrieben wird, verursacht einen terminierenden Lizenzfehler, da das gewährte Nutzungsrecht nur an diese Domain gebunden ist. Wir behalten uns vor den einen Verstoß gegen das Urheberrecht hinsichtlich der nicht unter die GPL fallenden Routinen entsprechend zu verfolgen. Sollten Sie eine Lizenzänderung benötigen binden wir Ihnen das Modul selbstverständlich kostenfrei an eine andere Domain. Bitte nehmen Sie diesbezüglich bei Bedarf Kontakt mit uns auf. Sie sind pro Lizenz berechtigt dieses Modul auf einer Domain und in einem Shop zu betreiben. Xycons ist und bleibt Eigentümer der nicht unter die GPL fallenden Routinen, auch wenn diese aufgrund individueller Wünsche oder Aufträge modifiziert wurden. Durch individuell beauftragte Modifizierungen erwirbt der Auftraggeber kein Eigentumsrecht an diesen sondern er beauftragt lediglich den zeitlichen Aufwand für die Programmierung, die Dokumentation und Installation und das damit einhergehende erweiterte Nutzungsrecht für das geänderte Modul, wie auch für die beauftragten Modifizierungen. HAFTUNG Xycons haftet nicht für Schäden an Soft- oder Hardware oder Vermögensschäden, die durch den Einsatz dieses Moduls oder unsere Dienstleistung entstehen, es sei denn diese beruhen auf einem grob fahrlässigen oder vorsätzlichen Handeln des Auftragnehmers, seiner Erfüllungsgehilfen oder seiner gesetzlichen Vertreter. Für Schäden an der Gesundheit, dem Körper oder dem Leben haftet der Auftragnehmer uneingeschränkt. Ebenso haftet er für die Verletzung von Pflichten, die zur Erreichung des Vertragszwecks von besonderer Bedeutung sind (Kardinalspflichten), dabei ist die Haftung auf die Höhe typisch vorhersehbare Fehler beschränkt. Mit dem Einsatz und der Nutzung des Moduls werden unsere AGB anerkannt. Grundsätzlich gilt: Irrtümer und Änderungen vorbehalten! Die hier beschriebenen Funktionen sind keine bindenden Leistungsbeschreibungen. Die Funktionsweise des Moduls kann abweichen, modifiziert sein oder mehr bzw. weniger Funktionen enthalten oder auch anders funktionieren. Die beschriebenen Leistungsmerkmale sind NICHT garantiert, dennoch haben wir uns Mühe gegeben das Modul und dessen Funktionsweise möglichst treffend zu beschreiben. Abweichungen können dennoch bestehen, stellen aber keinen Grund zu einem Mangel dar.

11 Gambio s Hinweise zur Datensicherung MANUELLE DATENSICHERUNG Die im Shop enthaltenen Funktionen zur Datensicherung können aus technischen Gründen nur bis zu einem serverabhängigen Shopumfang verwendet werden. Sollte die Verwendung dieser Funktionen bei Ihnen zu Fehlern führen, müssen Datensicherungen manuell angelegt werden. Eine komplette Sicherung der Daten Ihres Onlineshops umfasst sämtliche Dateien und Verzeichnisse sowie die gesamte Datenbank Ihres Shops. Die Datensicherung sollte regelmäßig durchgeführt werden und auf einem störunanfälligen Datenträger wie CD- oder DVD-ROM archiviert werden. Im unwahrscheinlichen Fall eines Datenverlustes auf Ihrem Server können Sie dann Ihre aktuellste Datensicherung zurückspielen. Beachten Sie, dass beim vollständigen Wiedereinspielen einer Datensicherung sämtliche neu eingetroffenen Bestellungen, neue Kunden und Änderungen an Artikeln verloren gehen. Hinweis: Versetzen Sie Ihren Shop vor der Datensicherung in den Offline-Modus. Sie stellen dadurch sicher, dass während Ihrer Datensicherung keine Änderungen vorgenommen werden. SICHERUNG DER DATEIEN UND VERZEICHNISSE IHRES SHOPS Die Dateien und Verzeichnisse Ihres Shops können Sie direkt von Ihrem Webserver herunterladen. Sie benötigen dazu ein FTP- Programm, wie beispielsweise das im Installationspaket des Shops enthaltene, kostenlose 'FileZilla'. Starten Sie Ihr FTP-Programm und verbinden Sie sich mit dem FTP-Server. Wechseln Sie auf Ihrem FTP-Server in das Verzeichnis, in das Sie Ihren Shop installiert haben. Erstellen Sie auf Ihrem Computer ein neues Verzeichnis und weisen Sie diesem Verzeichnis einen aussagekräftigen Namen, wie beispielsweise 'Datensicherung_ ' zu. Laden Sie sämtliche Dateien aus dem Shopverzeichnis auf Ihrem FTP-Server in das neu erstellte Verzeichnis auf Ihrem Computer herunter. Bitte beachten Sie, dass dieser Vorgang, je nach Umfang Ihres Shops, einige Zeit in Anspruch nehmen kann. Wenn alle Dateien und Verzeichnisse heruntergeladen wurden, haben Sie die für Ihre Shopdatenbank erforderlichen Dateien und Verzeichnisse gesichert. Sämtliche Artikel-, Kunden- und Bestelldaten befinden sich in der Datenbank Ihres Shops. SICHERUNG DER SHOP-DATENBANK Viele Hosting-Provider bieten zur Verwaltung von MySQL-Datenbanken die Software 'phpmyadmin' an, die in der Regel über das Kundenportal des Providers aufgerufen werden kann. Mit phpmyadmin kann die komplette Datenbank gesichert und zu einem späteren Zeitpunkt bei Bedarf wieder eingespielt werden. ACHTUNG!: Ihre MySQL-Datenbank ist sehr empfindlich. Nehmen Sie keine Änderungen an der Konfiguration des Shopsystems direkt in der Datenbank vor. Die unsachgemäße Verwendung der Software kann zu unwiderruflichem Verlust von wichtigen Shopdaten führen! Gegebenenfalls werden Sie von phpmyadmin zur Eingabe eines Benutzernamen und Passworts aufgefordert. Wenn Sie Ihre MySQL-Zugangsdaten nicht kennen, können Sie diese im Kundenportal Ihres Providers einsehen oder aus den Konfigurationsdateien des Shops auslesen. ACHTUNG!: Ändern Sie unter keinen Umständen das MySQL-Passwort im Kundenportal Ihres Providers. Die Daten sind in den Konfigurationsdateien hinterlegt, wenn sich das Passwort ändert, kann das Shopsystem nicht mehr auf die Datenbank zugreifen und Ihr Shop wird nicht mehr korrekt dargestellt. In den Konfigurationsdateien und ADMIN/INCLUDES/CONFIGURE.PHP INCLUDES/CONFIGURE.PHP finden Sie im unteren Bereich einen Block, der unter anderem die Konstanten 'DB_SERVER_USERNAME' und 'DB_SERVER_PASSWORD' enthält. Diese Konstanten enthalten die für phpmyadmin erforderlichen Zugangsdaten. Merken Sie sich außerdem den Wert der Konstante 'DB_DATABASE', der den Namen der verwendeten Datenbank enthält. Loggen Sie sich mit den Daten aus den Konfigurationsdateien bei phpmyadmin ein. Je nach Konfiguration der Software wird die Datenbank für Ihren Shop automatisch ausgewählt, oder muss anhand des Namens aus der Konfigurationsdatei aus einer Liste ausgewählt werden. Wählen Sie Ihre Shopdatenbank aus und klicken Sie auf 'Exportieren'. In der Regel müssen an dieser Stelle keine weiteren Einstellungen vorgenommen werden. Klicken Sie auf 'OK'. Je nach Konfiguration Ihres Browsers wird die Export- Datei automatisch heruntergeladen, oder Sie werden in einem Dialogfenster aufgefordert, den Speicherort der erzeugten Datei festzulegen. Der Name der Exportdatei enthält den Datenbanknamen und, je nach Konfiguration, das aktuelle Datum. Verschieben Sie die Datenbanksicherung in das im vorangegangenen Schritt erstellte Verzeichnis für Ihre Datensicherung bzw. einem sicheren Ort.