Update des Shops ================ PhPepperShop Version 2.5: Update -------------------------------- *** Datatrans, Saferpay und PostFinance Kunden, bitte Information am Ende der Datei lesen *** Dieses Update des Shops betrifft sowohl das Installationsprogramm und die PHP-Scripte als auch die Datenbank. Man kann dieses Update von der Shopversion 2.0.1 (v.2.0 mit Service Pack 1) oder von der Shopversion 2.0.2 (v.2.0 mit Service Pack 2) aus angehen. Ältere Shopversionen müssen zuerst auf die Shopversion 2.0.1 upge- dated werden - insbesondere auch die Shopversion 2.0.0. Dieses Shopupdate übernimmt folgende Daten aus dem bestehenden PhPepperShop v.2.0: - Artikel - Kategorien, - Kunden - Bestellungen - Shop-Konfiguration - Layouteinstellungen Eine Kurzanleitung zum Update über mehrere Shopversionen hinweg findet man in folgender Datei: http://www.phpeppershop.com/phpeppershop_files/shopupdate_ueber_mehrere_versionen.txt Um den Shop updaten zu können, muss zusätzlich noch die Datei v25_update.sql heruntergeladen werden. Wenn man den PhPepperShop v.2.0 mit zwei Datenbankbenutzern betreibt (zu sehen in der Rubirk 'Shop Konfigura- tion ansehen' in der Shopadministration), so muss man zusaetzlich noch die Datei v25_update_zwei_db_user.sql herunterladen. Alle SQL-Dateien sind in Ihrem Kundenaccount des PhPepperShop Verkaufsystems erreichbar. Gehen Sie dazu ins Verkaufssystem auf http://www.phpeppershop.com/shop/ und melden Sie sich links an. Nun sehen Sie im Abschnitt Downloads alle verfügbaren Dateien, inkl. den Update-SQLs. Updatevorgang: 1.) Wenn man eigene Shopbuttons und Hintergründe erstellt hat und verwendet, sollte man von diesen Dateien zuerst ein Backup erstellen (siehe Anleitung 'PhPepperShop Dokumentation Manuals'). Wenn man diese Dateien noch ausserhalb des Shopver- zeichnisses gespeichert hat, kann man auf das Backup auch verzichten. Auch muss man unbedingt via Shop-Backup, phpMyAdmin oder z.B. mysqldump noch ein Backup der Datenbank anlegen, sodass man im Notfall den alten Zustand des Shops schnell wiederherstellen kann. 2.) Sicherheit: Sind noch alle Angaben, welche bei der Installation des Shops benutzt wurden vorhanden? Wenn nicht, schauen Sie diese bitte nochmals nach (Dateien shopname_create.sql, initialize.sql, ADMIN_initialize.sql). Die Eingaben müssen bei der erneuten Installation (Teil des Updatevorgangs) nochmals getätigt werden. Gemeint sind folgende Daten: Datenbankbenutzername, Passwort des Datenbankbenutzers, Name des Datenbankrechners, Name der Shopdatenbank. Beim Betrieb mit zwei Datenbankbenutzern sind zusätzlich noch der Benutzername und das Passwort des Kunden-Datenbankbenutzers gefragt. 3.) Das alte Shopverzeichnis sollte man 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 davon herunterladen). Auch von der aktuellen Shopdatenbank muss man (z.B. via phpMyAdmin oder Shop DB-Backup) ein Backup sicher hinterlegen. 4.) Externe PhPepperShop Module: Falls man externe PhPepperShop Module benutzt, so sollte man diese deinstallieren und nach dem Upgrade aktualisierte Versionen neu einspielen. Nehmen Sie hier bei Unklarheiten am besten direkt mit dem jeweiligen Modulhersteller Kontakt auf. Anmerkung: Beim Deinstallieren gehen alle dieses Modul betreffende Informationen in der Datenbank verloren. 5.) Hier teilt sich die Aufgabenstellung, je nach vorheriger Shopinstallation (Anm. Windows Anwender müssen in jedem Fall den Weg 'Installation OHNE Telnet/SSH' wählen): a) Installation via Telnet/SSH: Wir installieren nun den neuen Shop (folgende Zeilen bitte sehr genau durchlesen, Gefahr von Datenverlust!): - Den PhPepperShop v.2.5 und die Datei v25_update.sql herunterladen von http://www.phpeppershop.com/index_download.html - Beim Betrieb mit zwei DB-Benutzern zusätzlich noch die Datei v25_update_zwei_db_user.sql herunterladen - Den Shop Sourcecode im Webverzeichnis entpacken und ins entpackte Verzeichnis phpeppershop_src wechseln - perl ./config.pl aufrufen und damit die Installationsroutine starten (Achtung: config.pl lässt sich NICHT via Browser starten, es muss via Kommando in einer UNIX-Shell aufgerufen werden!) - Beim Teil 5 der Installation, wo es um das Einfügen der Datenbank ins MySQL-DBMS geht, muss man UNBEDINGT n für NEIN wählen, da die schon existierende v.2.0 Datenbank später separat auf den Shop v.2.5 upgedated wird. - Es wurde nun ein Shop erzeugt, dieser liegt im Verzeichnis mit dem Namen der Datenbank (ev. also noch umbenennen). - Zum Abschluss muss jetzt noch das Datenbank Update laufen gelassen werden: Dazu wird die Datei v25_update.sql ins MySQL-DBMS eingelesen. Das 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 < ./v25_update.sql dbuser durch den Datenbank user ersetzen, -h dbhost wird nur benötigt, wenn die Datenbank auf einem anderen Rechner liegt als der, auf dem man den Shop jetzt installiert, dann muss dbhost durch den Hostnamen des Rechners ersetzt werden, dbname durch den Namen der Datenbank ersetzen. ACHTUNG: Das Ausführen der v25_update.sql kann abhängig von der Anzahl Artikel im Shop SEHR lange dauern, da einige neue Indizes aufgebaut werden. Dies kann phpMyAdmin mit einer moderaten max_execution_time schnell überfordern und dann zu Problemen führen! Falls man sehr viele Artikel besitzt (100'000+) sollte deshalb Kontakt mit dem Provider aufnehmen und ihn bitten die Datei v25_update.sql via Kommandokonsole einzulesen. - Wenn der PhPepperShop mit zwei Datenbankbenutzern betrieben wird, müssen wir noch spezielle Rechte für den kundenseitig verwendeten, nicht privilegierten Datenbankbenutzer einlesen. Dies machen wir mit der SQL-Datei v25_update_zwei_db_user.sql. Bevor wir diese aber laufen lassen können, müssen wir sie bearbeiten und folgende Begriffe ersetzen: {hostname} => Rechnername des Datenbankrechners, {shop_db} => Name der Shopdatenbank {shopuser} => Name des nicht privilegierten, kundenseitig verwendeten, zweiten Datenbankbenutzers, {grantor} => Name des Benutzers, mit welchem diese SQL-Datei eingelesen wird (z.B. root) Beim ersetzen müssen die geschweiften Klammern {} mit ersetzt werden, die doppelten Anführungszeichen aber nicht! Um diese Datei einlesen zu koennen, muss man MySQL Root-Rechte besitzen! b) Installation OHNE Telnet/SSH -> via FTP und Anleitung 'Installation ohne Telnet/SSH': - Zuerst sollte man den neuen Shop (v.2.5) herunterladen und entpacken. Man muss nun nochmals (etwas mühsam) in einem Editor gemäss der Anleitung 'Installation ohne Telnet/SSH' alle Einstellungen an den Scripts vornehmen. Es muss aber vorerst nur das Kapitel 5 durchgearbeitet werden. - 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. Dies ist ein wichtiger Punkt, welcher UNBEDINGT sorgsam erledigt werden muss. Neu gibt es seit der Shopversion 2.5 dort auch einen Link zu einer Textdatei, welche alle zu taetigenden FTP-Befehle enthaelt. - Zum Schluss muss jetzt noch das Datenbank-Update ausgeführt werden. Dazu liest man die SQL-Datei v25_update.sql via phpMyAdmin oder einem ähnlichen Tool (wird vom Provider zur Verfügung gestellt) in seine MySQL Datenbank ein. Falls man sehr viele Artikel besitzt (100'000+) sollte deshalb Kontakt mit dem Provider aufnehmen und ihn bitten die Datei v25_update.sql via Kommandokonsole einzulesen! 6.) Nun müssen folgende Administrationsmenüs geöffnet und ihre Einstellungen überprüft werden. Zuerst gehen wir in die neue Shopadministration (via Webbrowser) und klicken dort als aller erstes auf die Rubrik 'Shop Konfiguration'. Hier gehen wir ganz nach unten und klicken dort auf den Link, der mit 'Datenbank aufräumen' betitelt ist. ES IST WICHTIG, DASS DIES DER ERSTE SCHRITT IN DER ADMINISTRATION IST! Dieser Schritt kann bei Shops mit sehr vielen Artikeln etwas dauern... Nun MÜSSEN folgende Menus gespeichert werden, damit der Shop in einen konsistenten Zustand kommt: - Allgemeine Shopeinstellungen (Hier bitte alle Einstellungen nochmals überprüfen!) - Layout Management -> hier gleich auf Speichern klicken und erst nach diesem Vorgang Änderungen anbringen - MwSt Management (nur falls aktiviert / falls der Shop MwSt-pflichtig ist) - Kundenattribute bearbeiten -> Bitte die Einstellungen überprüfen, im Speziellen die Kundenzusatzfelder - Shopbuttons (Knöpfe) hochladen -> Hier bitte alle Buttons überprüfen Um einen bestehenden .htaccess Schutz weiter zu verwenden, einfach die Datei .htaccess (und falls vorhanden auch .htpasswd) vom {alter_shop}/shop/Admin-Verzeichnis kopieren und im neuen Shopverzeichnis wieder im Admin Unterverzeichnis ablegen. Achtung: Da das Versandkostenmanagement durch das neue Menü 'Lieferländer und Versandarten' ersetzt wurde, muss man nun in diesem Untermenü alle Einstellungen korrekt übernehmen. Nun noch die Produktebilder (altershop/shop/ProdukteBilder Ordner) und die ProdukteDetails (altershop/shop/ProdukteBilder Ordner) in den neuen Shop kopieren. 7.) Falls man eine eigens angepasste Startseite verwendet hat, muss man die speziell in den neuen Shop übernehmen. Das heisst, man kopiert die Startseite ({alter_shop}/shop/language/de/html_templates/start_content.html) in den neuen Shop: {neuer_shop}/shop/language/de/html_templates/start_content.tpl.html. Falls der Shop mehrsprachig eingesetzt wurde, sollte man diesen Vorgang für alle verwendeten Sprachen wiederholen (dann in den Pfaden de durch die jeweilige Sprache ersetzen - z.B. en für Englisch). Die Startseite kann später bequem in der Shopadministration bearbeitet werden (Untermenü: Startseite, Footer & Impressum bearbeiten). 8.) Falls man den PhPepperShop mit eingeschalteter Mehrsprachigkeit betreibt: Da auch die jeweiligen Übersetzungsdateien geändert haben, muss man auch diese überarbeiten, falls man selbst Textänderungen vorgenommen hatte. Die Dateien befinden sich immer noch am selben Ort: {shopverzeichnis}/shop/language/xy/localetext.inc.php, wobei xy für den Sprachcode steht - z.B. de für Deutsch oder fr für Französisch. Anmerkung: Ev. ist eine v.2.0 Sprachdatei noch nicht für die Shopversion 2.5 verfügbar! Die Sprachsets findet man hier: http://www.phpeppershop.com/sprachsets/sprachsets.php. Im neuen Shop v.2.5 gibt es einen speziellen Editor zur Bearbeitung der übersetzten Textelemente (Lokalisierungseditor im Sprachen Menü). 9.) Layout Hinweise: Da die HTML-Templates des PhPepperShops sehr stark geändert haben, kann man bearbeitete PhPepperShop v.2.0 HTML-Templates nicht mehr ohne Weiteres im Shopsystem v.2.5 einsetzen. Eigene Änderungen muss man nochmals neu einarbeiten. Informationen zur Verwendung der Templates findet man im Shopadministrationshauptmenü unten auf Hilfethemen klickt und im neu aufgegangenen Fenster auf 'Verwendung des PhPepperShop Templatesystems'. Hier und im Hilfetext des Layout-Managements erfährt man auch Details über die Struktur des PhPepperShop Designs. Hinweise zur Deinstallation: Man kann das Update NICHT mehr rückgängig machen (D.h. man könnte theoretisch schon, aber wir bieten dafür keinen automatisierten Mechanismus oder eine komplexe Anleitung an)! Deinstallation des Shops, allgemeiner Teil: Zuerst in der PhPepperShop Administration im Untermenü 'Externe PhPepperShop Module' alle Module deinstallieren. a) Deinstallation via Telnet/SSH: - Mittels Aufruf von perl ./remove.pl kann der PhPepperShop auf der Kommandozeile Menü geführt deinstalliert werden. b) Deinstallation OHNE Telnet/SSH: - Um den Shop zu deinstallieren, wenn man via FTP und der Anleitung 'Installation ohne Telnet/SSH' gearbeitet hat einfach die SQL-Datei /templates/template_del_tables_only.sql ausführen. Es werden daraufhin alle Shoptabellen gelöscht. Nun kann auch das PhPepperShop-Verzeichnis gelöscht werden und der Shop ist somit deinstalliert. --> Falls Probleme auftreten sollten --> FAQs / Forum auf http://www.phpeppershop.com/ (bitte die vorherige Shopversion erwähnen). *** Informationen für Kunden von Datatrans, Saferpay und PostFinance *** Datatrans: ---------- Die überarbeitete und aktualisierte Datatrans Anbindung im PhPepperShop v.2.5 verbindet sich schon mit dem neuen Payment Server der Datatrans: payment.datatrans.biz. Falls Sie noch auf dem älteren Payment Server eingetragen sind (www.datatrans.biz), bitte diese URL in der Datei shop/datatrans_config.php anpassen. Saferpay: --------- Die Saferpay Anbindung wurde stark überarbeitet und benutzt nun den sogenannten Notify URL Mechanismus, um die Stabilität zu er- höhen. Falls Sie also manuell Änderungen in der Datei shop/saferpay_config.php vorgenommen haben, müssen Sie diese unbedingt in die NEUE saferpay_config.php übernehmen und auf keinen Fall die alte Datei weiter verwenden. PostFinance: ------------ Die PostFinance Anbindung unterstützt neu mehrere Währungen und je eine Shop-ID pro Währung, so dass man gegebenenfalls noch An- passungen in den allgemeinen Shopeinstellungen vornehmen muss. ------------------------------------------------------------------------------ Datei Informationen =================== PhPepperShop, v25_updateinfo.txt, fjo Autoren: ©2001-2007, Jose Fontanil, Reto Glanzmann, Glarotech GmbH Version 2.5, basierend auf ER-Diagramm v.2.5.0.4 CVS-Version / Datum: $Id$ (20.12.2007) Sicherheitsstatus: *** ADMIN *** Updateanleitung (v.2.0.1 oder v.2.0.2 zu v.2.5) <>