Update des Shops
================

PhPepperShop Version 1.2: Erweiterungs Update
---------------------------------------------

Dies ist das bisher grösste Update einer PhPepperShop Version. Wenn man sich aber genau an die hier beschriebene
Updateanleitung hält, sollte das Update reibungslos funktionieren.

Dieses Update des Shops betrifft sowohl das Installationsprogramm und die PHP-Scripte als auch die Datenbank.
Man kann dieses Update von der Shopversion v.1.1 aus angehen. Ältere Shopversionen müssen zuerst auf v.1.1 upgedated werden.
Ein Updatetool mit welchem die Bilder von v.1.07 auf v.1.1 automatisch übernommen werden, wurde nicht entwickelt.

Um den Shop updaten zu können, muss zusätzlich noch die Datei v12_update.sql heruntergeladen werden.
Sie ist im Downloadbereich zu finden (http://www.phpeppershop.com/download.html).

1.) Wenn man eigene Shopbuttons und Hintergründe erstellt hat und verwendet, sollte man diese Dateien zuerst backupen
    (siehe Anleitung 'PhPepperShop Dokumentation Manuals'). Wenn man diese Dateien noch ausserhalb des Shopverzeichnisses
    gespeichert hat, kann man auf das Backup auch verzichten. Auch sollte man via Shop-Backup noch ein Backup der Datenbank
    anlegen, sodass man im Notfall den alten Zustand des Shops wiederherstellen kann.

2.) Sicherheit: Sind noch alle Angaben, welche bei der Installation des Shops benutzt wurden vorhanden? Wenn nicht, schauen
    Sie sie bitte nochmals nach (Dateien shopname_create.sql, initialize.sql, ADMIN_initialize.sql). Die Eingaben müssen
    bei der erneuten Installation nochmals getätigt werden.

3.) Das alte Shopverzeichnis aus Sicherheitsgründen zuerst umbenennen und erst nach erfolgreichem Update löschen (Zuerst
    also in der Konsole schreiben: mv shopname shopname_old, oder via FTP eine Kopie ziehen).

4.) Hier teilt sich die Aufgabenstellung, je nach vorheriger Shopinstallation:
    - Installation via Telnet/SSH:
      Nun den neuen Shop installieren (folgende Zeilen gut durchlesen, Gefahr von Datenverlust!):
      - Shop und die Datei v12_update.sql herunterladen von http://www.phpeppershop.com/download.html
      - Shop Sourcen im Webverzeichnis entpacken und ins entpackte Verzeichnis phpeppershop_src wechseln
      - perl ./config.pl aufrufen und damit die Installationsroutine starten
      - Beim Teil 5 der Installation, bei welchem es um das Einfügen der Datenbank ins MySQL-DBMS geht, muss man UNBEDINGT
        n für NEIN wählen. Die Datenbank wird später speziell auf den Shop v.1.2 upgedated.
      - Es wurde nun ein Shop erzeugt, dieser liegt im Verzeichnis mit dem Namen der Datenbank, ev. noch umbenennen.
      - Zum Abschluss muss jetzt noch das Datenbank Update laufen gelassen werden: Dazu muss man die Datei v12_update.sql
        ins MySQL-DBMS einlesen. Dies kann man entweder via phpMyAdmin oder einem ähnlichen Tool erledigen, oder man kann
        es via Shell mit folgendem Befehl machen:
                               mysql -u dbuser -p [-h dbhost] dbname < ./v12_update.sql
        dbuser durch den Datenbank user ersetzen, -h dbhost wird nur benötigt, wenn die Datenbank auf einem anderen Rechner
        liegt, dann muss dbhost durch den Hostnamen des Rechners ersetzt werden, dbname durch den Namen der Datenbank ersetzen.

    - Installation ohne Telnet/SSH -> via FTP und Anleitung 'Installation ohne Telnet/SSH':
      - Zuerst sollte man den neuen Shop (v.1.2) herunterladen und entpacken. Man muss nun nochmals (mühsam) in einem Editor
        gemäss der Anleitung 'Installation ohne Telnet/SSH' alle Einstellungen an den Scripts vornehmen. Es muss aber nur das
        Kapitel 5 durchgearbeitet werden. Den Rest kann man ignorieren.
      - Nun muss man alle neuen Shopdateien hochladen (an genau den Ort, bei welchem zuvor die alte Shopversion abgespeichert war)
      - Nun muss nach der Anleitung 'Installation ohne Telnet/SSH' das Kapitel 8 durchgearbeitet werden - Datei- und Verzeichnisrechte setzen.
      - Zu aller letzt muss jetzt noch das Datenbank-Update ausgeführt werden. Dazu liest man die SQL-Datei v12_update.sql
        via phpMyAdmin oder einem ähnlichen Tool (wird vom Provider zur Verfügung gestellt) in seine MySQL Datenbank ein.

5.) Nun müssen folgende Administrationsmenüs geöffnet und ihre Einstellungen überprüft werden. Danach MUSS das jeweilige Formular
    gespeichert werden, damit der Shop in einen konsistenten Zustand kommt.
    - Allgemeine Shopeinstellungen (Hier bitte alle Einstellungen nochmals überprüfen!)
    - MwSt Management (falls aktiviert)
    - Versandkosten Einstellungen (ansonsten kann es u.a. Probleme mit der Treuhandzahlungsmethode geben)

6.) Hinweise zur Deinstallation: Wenn man die Tabellen des Shops wieder löschen will, so wird  von v.1.1 her mitgelieferte Script
    die folgenden beiden Tabellen bestehen lassen: mehrwertsteuer und artikel_variationsgruppen. Diese muss man von Hand entfernen.

--> Falls Probleme auftauchen sollten, im Forum auf http://www.phpeppershop.com/ bitte die vorherige Shopversion erwähnen.


------------------------------------------------------------------------------
Dateiinformationen
==================

v12_update.txt
ZHW Zuercher Hochschule Winterthur
PhPepperShop Diplomarbeit DA Fei01/1
Autoren: ©2002, Jose Fontanil & Reto Glanzmann

Version 1.2, basierend auf ER-Diagramm v.1.2.3
CVS-Version / Datum: $Id$
Sicherheitsstatus:       *** ADMIN ***

Updateanleitung (v.1.1 --> v.1.2)
v.1.1-fjo-28.04.2003