INSTALLATIONSANLEITUNG MASTER UPDATE 2.4.0.1 2015 Gambio GmbH. www.gambio.de
Inhaltsverzeichnis 1 Changelog 3 2 Datensicherung 3 3 Installation Master Update 4 3.1 Update von Shopsystemen v2.2.0.0 bis v2.4.0.0 4 3.2 Update Shopdatenbank 4 3.3 Update und Erichtung von Shopmodulen 7 4 Aktualisieren des MobileCandy Templates 8 5 Aktualisieren der E-Mail-Vorlagen 8 6 robots.txt aktualisieren 8 7 Installation Bearbeitungsmodus StyleEdit (optional) 9 8 Installation G-Protector (optional) 9 9 Browser-Cache leeren 9 10 Neuerungen dieser Version 10 10.1 Mailversand 10 10.2 Paketversender 10 10.3 Urlaubsschaltung 10 10.4 Timer 11 10.5 Sprachsystem 11 10.6 Cachg für Bilder und JavaScripte 15 10.7 PayPal Plus 16 2015 Gambio GmbH. www.gambio.de 2
Wichtige Hweise: Dieses Master Update ist nur für die Versionen v2.2.0.0 bis v2.4.0.0 geeignet. Es kann nicht als Update für Gambio GX, Gambio 2007 oder Gambio 2006 genutzt werden. Die Versionsnummer Ihres Shops fden Sie im Admistrationsbereich unter Credits. (sieheabbildungen 1 und 2). Achtung: Wenn Sie Ihrem Shop die klassischen Suchmaschenfreundlichen URLs (Vorgänger des Gambio SEO Boost) verwenden, müssen händisch angelegte Lks ggf. angepasst und die Caches im Bereich Toolbox geleert respektive neu erzeugt werden, da diese Funktion aus dem Grundumfang des Shopsystems entfernt wird. Es steht dann nur noch der Gambio SEO Boost zur Verfügung. Abbildung 1: Menüpunkt Credits im Admistrationsbereich 1 Changelog Ee Liste der diesem Master Update enthaltenen Änderungen entnehmen Sie der beigefügten Datei CHANGELOG.txt. 2 Datensicherung Bitte führen Sie zunächst ee komplette Datensicherung durch. Dazu gehört sowohl die Sicherung aller Dateien und Ordner des Shops, als auch die Sicherung der Shopdatenbank. 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 efach die Datensicherung wieder espielen. Wird kee Datensicherung durchgeführt, gehen alte Daten möglicherweise verloren und können nicht rekonstruiert werden. Abbildung 2: Versionsnummer des Shops Ee Anleitung zur Datensicherung fden Sie der Datei DATENSICHERUNG.txt. 2015 Gambio GmbH. www.gambio.de 3
3 Installation Master Update 3.1 Update von Shopsystemen v2.2.0.0 bis v2.4.0.0 Achtung: Durch die Installation des Master Updates werden Dateien Ihrer Shopversion ersetzt. Individuelle Anpassungen an diesen Dateien gehen dadurch verloren! Bitte stellen Sie vor dem Espielen des Master Updates sicher, dass Sie im Admistrationsbereich Ihres Shops egeloggt sd! Abbildung 3: Eloggen mit Adm-Daten Laden Sie den gesamten Inhalt des Verzeichnisses Dateien aus dem Verzeichnis Shopsystem das Hauptverzeichnis Ihres Shops auf Ihrem FTP-Server und überschreiben Sie die vorhandenen Dateien. 3.2 Update Shopdatenbank Rufen Sie Ihren Shop über http://www.ihr-shop.de/gambio_updater auf, um die Datenbank zu aktualisieren. Ersetzen Sie dabei www.ihr-shop.de durch Ihre tatsächliche Internetadresse. Folgen Sie den Anweisungen des Gambio-Updaters. Dies umfasst mehrere Schritte: 1. Eloggen - Loggen Sie sich mit Ihren Adm-Daten e, die Sie auch im Shop vewenden. Achtung: Abbildung 4: Auswahl der Shopversion bei Erzwgen Der Haken Versionsupdate erzwgen darf nur gesetzt werden, wenn e zuvor begonnener Update-Vorgang abgebrochen worden ist und der Updater nun erneut aufgerufen wird. 2015 Gambio GmbH. www.gambio.de 4
2. Bestätigen der Updates - es wird/werden die Versionsnummer des/der Updates angezeigt. Klicken Sie auf Zur Updates-Konfiguration, um fortzufahren. 3. Je nach Shopversion und Änderungen können Abweichungen der regulären Textbaustee festgestellt werden. Wählen Sie hier aus, ob Sie die bisherigen Texte (lke Spalte) behalten oder diese durch die neuen Texte (rechte Spalte) ersetzen möchten (Abb. 5). Klicken Sie anschließend auf Updates durchführen. Das Datenbankupdate wird nun durchgeführt, bitte warten Sie den Ablauf des Vorganges ab. Abbildung 5: Auflistung der Sprachkonflikte 2015 Gambio GmbH. www.gambio.de 5
4. Nach Abschluss des Updates müssen ggf. noch alte Dateien oder Ordner gelöscht werden. Diese werden eer Liste angezeigt. Sie können die Daten entweder per Hand löschen, dem Sie een FTP-Client verwenden oder die automatische Funktion des Installers verwenden. Klicken Sie im ersten Fall, nachdem Sie die Dateien gelöscht haben, auf auf Erneut prüfen. Sollten Sie die automatische Funktion verwenden, geben Sie bitte Ihre FTP-Zugangsdaten e und klicken auf Verbden. Anschließend werden Sie zur Auswahl des Shopverzeichnisses aufgefordert. Es wird dann unter aktuelles Verzeichnis angezeigt. Wenn Sie sicher sd, das richtige Verzeichnis ausgewählt zu haben, klicken Sie auf Veraltete Dateien löschen. 5. Klicken Sie anschließend auf Fortfahren, um den Update-Vorgang abzuschließen. Abbildung 6: Löschen von veralteten Dateien Abbildung 7: Automatische Lösch-Funktion des Updaters 2015 Gambio GmbH. www.gambio.de 6
3.3 Update und Erichtung von Shopmodulen Nachdem das Datenbankupdate durchgeführt worden ist, müssen verschiedene Module aktualisiert bzw. neu egerichtet werden. 3.3.1 Magnalister Abbildung 8: Update von magnalister unter Marketg > Globale Konfiguration Um Konflikte der Shopversion mit Magnalister zu vermeiden, muss dieses Modul auf die aktuelle Version gebracht werden. Gehen Sie hierzu unter Marketg > Globale Konfiguration und klicken auf die Schaltfläche ganz rechts im oberen Bereich der Seite (vgl. Abbildung 7). 3.3.2 Heidelpay Im Rahmen dieses Service Packs fdet auch ee Aktualisierung des Heidelpay-Moduls statt. Hier ist es notwendig die gewünschten Zahlungsweisen unter Module > Zahlungsweisen nochmals zu stallieren und erneut ezurichten. 3.3.3 MailBeez Wenn Sie bereits ee Version von MailBeez verwenden, beachten Sie bitte folgende Anleitung: https://helpdesk.mailbeez.com/106596-update-von-gambio-mit-alten-mailbeez-versionen 2015 Gambio GmbH. www.gambio.de 7
4 Aktualisieren des MobileCandy Templates Wenn Sie das MobileCandy Template verwenden, so ist es notwendig dieses ebenfalls zu aktualisieren. Das MobileCandy kann seer aktuellsten Version im Gambio Kundenportal heruntergeladen werden. Bitte achten Sie bei der Auswahl des Pakets darauf, dass dieses für Ihre Shopversion geeignet ist. Die Versionsangabe fden Sie der Paket-Beschreibung und über den Lk Kompatible Versionen anzeigen. 5 Aktualisieren der E-Mail-Vorlagen Nach dem Espielen des Service Packs sollten die Origalvorlagen für die E-Mail-Bestellbestätigung und Adm: Änderung Bestellstatus wiederhergestellt werden, da es sonst zu Fehlern im Shop kommen kann. Gehen Sie hierzu im Admistrationsbereich unter Konfiguration > E-Mail Vorlagen und wählen für die genannten Vorlagen Origal wiederherstellen aus und klicken auf OK. Führen Sie dies bitte sowohl für die HTML- als auch die Textvorlagen beiden Sprachen (Deutsch und Englisch) durch. Leeren Sie abschließend unter Toolbox > Cache leeren den Cache für die E-Mail-Vorlagen. Bitte beachten Sie, dass dividuelle Änderungen hierdurch verloren gehen und ggf. erneut vorgenommen werden müssen. 6 robots.txt aktualisieren Falls Ihr Shop eem Unterverzeichnis liegt, also nicht direkt über den Aufruf der Shopdoma erreichbar ist, ist die manuelle Aktualisierung der robots.txt notwendig. Wählen Sie im Admistrationsbereich des Shops den Menüpunkt Gambio SEO > Robots Datei und klicken Sie auf Download, um ee neue robots.txt zu generieren. Speichern Sie die robots.txt Datei auf Ihrem Computer und laden Sie sie anschließend miteem FTP-Programm auf Ihren Ser- 2015 Gambio GmbH. www.gambio.de 8
ver, so dass Sie im Hauptverzeichnis der Doma liegt (nicht im Shop-Ordner!). Die Datei muss Ihrem Browser über www.ihreshopdoma.de/robots.txt erreichbar se. 7 Installation Bearbeitungsmodus StyleEdit (optional) Bei StyleEdit handelt es sich um e eigenständiges Modul, welches nicht unter der GPL-Lizenz steht. Laden Sie das gesamte Verzeichnis StyleEdit (nicht nur den Inhalt) das Hauptverzeichnis Ihres Shops auf Ihrem FTP-Server hoch und überschreiben Sie die vorhandenen Dateien. 8 Installation G-Protector (optional) Der G-Protector ist e eigenständiges Modul zum Schutz vor Angriffen, das nicht unter der GPL-Lizenz steht. Die Aktualisierung des Zusatzmoduls G-Protector ist optional. Laden Sie das gesamte Verzeichnis GProtector (nicht nur den Inhalt) das Hauptverzeichnis Ihres Shops auf Ihrem FTP-Server hoch und überschreiben Sie die vorhandenen Dateien. 9 Browser-Cache leeren Es ist möglich, dass Ihr Shop nach der Installation des Service Packs Darstellungsfehler aufweist, da alte Inhalte aus dem lokalen Browser-Cache geladen werden. Leeren Sie daher den Cache Ihres Browsers. 2015 Gambio GmbH. www.gambio.de 9
10 Neuerungen dieser Version 10.1 Mailversand Der E-Mail-Versand an Kunden wurde stark erweitert. So ist es möglich, E-Mails zu speichern und bei Bedarf zu versenden. Auch ist es möglich mehrere Mails bequem gleichzeitig zu versenden oder zu löschen. Sie fden den neuen Mailversand im Admistrationsbreich unter Kunden > E-Mails. 10.2 Paketversender Es ist nun möglich, den Lk eer Paketverfolgung mit eer Bestellung zu verknüpfen. So hat der Kunde die Möglichkeit, direkt aus seer Bestellung die Sendungsverfolgung aufzurufen. Der Paketversender ist im Admistrationsbereich unter Konfiguration > Paketversender zu fden. 10.3 Urlaubsschaltung Über die Urlaubsschaltung können Kunden formiert werden, wenn der Shopbetreiber im Urlaub ist - also derzeit kee Bestellungen bearbeiten kann. Dies kann entweder über ee Anzeige-Leiste oder e Popup-Fenster umgesetzt werden. Das An- oder Abschalten der Urlaubsschaltung kann auch über een Cronjob für een bestimmten Zeitpunkt festgelegt werden. In Zusammenhang mit der Urlaubsschaltung empfiehlt sich die Verwendung des Timers (siehe Timer). Die Urlaubsschaltung ist als neue Funktion des Menüpunkts Toolbox > Shop onle/offle hzugekommen. 2015 Gambio GmbH. www.gambio.de 10
10.4 Timer Über den Timer können sowohl Artikel- als auch Lieferstatus zeitabhängig angepasst werden. Es ist so z.b. möglich ab eem festgelegten Zeitpunkt für alle Artikel mit eem bestimmten Lieferstatus ee andere Lieferzeit etragen zu lassen. Da hierfür e Cronjob verwendet wird, muss diese Änderung nicht von Hand vorgenommen werden. Die Estellungen hierzu fden Sie unter Artikel > Timer. 10.5 Sprachsystem Mit der Shopversion 2.3 wird e verefachtes, optimiertes Sprachsystem egeführt. Dies erfordert Anpassungen am Dateisystem von Sprachpaketen. Das Service Pack nimmt diese Änderungen für die Standardsprachen Deutsch und Englisch vor. Zusätzliche Sprachen müssen manuell gemäß der neuen Anforderungen angepasst werden. Beispiel ees Sprachpakets für Französisch (Ordnername french, ISO-Code fr): Folgende Dateien müssen umbenannt werden: lang/french/french.php lang/french/it.c.php 2015 Gambio GmbH. www.gambio.de 11
lang/french/adm/french.php lang/french/adm/it.c.php lang/french/fr.png lang/french/flag.png lang/french/sections lang/french/origal_sections lang/french/mail_templates lang/french/origal_mail_templates 2015 Gambio GmbH. www.gambio.de 12
lang/french/origal_mail_templates/adm/_samples/create_account_mail.txt lang/french/origal_mail_templates/adm/_samples/adm_create_account_mail.txt lang/french/origal_mail_templates/adm/_samples/create_account_mail.html lang/french/origal_mail_templates/adm/_samples/adm_create_account_mail.html sofern vorhanden ebenfalls umbennen: lang/french/origal_mail_templates/adm/create_account_mail.html lang/french/origal_mail_templates/adm/adm_create_account_mail.html lang/french/origal_mail_templates/adm/create_account_mail.txt lang/french/origal_mail_templates/adm/adm_create_account_mail.txt Folgende Dateien müssen verschoben werden: 2015 Gambio GmbH. www.gambio.de 13
lang/french/origal_mail_templates/adm (gesamter Inhalt) nach lang/french/origal_mail_templates Die _samples-ordner werden beim Verschieben zusammengeführt. lang/french/origal_mail_templates/_samples (gesamter Inhalt OHNE zu überschreiben) nach lang/french/origal_mail_templates Bereits vorhandene Dateien bleiben erhalten. Die so ggf. nicht verschobenen Dateien können gelöscht werden. Ordner anlegen: lang/french/user_mail_templates lang/french/user_sections Im Admistrationsbereich des Shops muss nun unter dem Menüpunkt Cache leeren der Button Cache für Texte leeren geklickt werden. Anschließend sollte im Shop auf die französische Sprache gewechselt werden können, ohne dass Fehlermeldungen erscheen. Mit der neuen Shopversion wurden Texte verändert und hzugefügt. Diese fehlen zusätzlichen Sprachpaketen und müssten nachgepflegt werden. 2015 Gambio GmbH. www.gambio.de 14
Der Shop zeigt diesem Fall für diese Texte den Wert aus der Standardsprache an, die im Admistrationsbereich unter dem Menüpunkt Sprachen defiert ist. 10.6 Cachg für Bilder und JavaScripte Das Cachen von Bildern und JavaScripten kann die Leistung des Shops verbessern und sich zudem positiv auf das Rankg bei Suchmaschen auswirken. Hweis: Durch die Installation des MobileCandy Templates kann sich den Verzeichnissen images/ images/product_images/ templates/ bereits ee entsprechende.htaccess-datei befden. In diesem Fall kann der betroffene Ordner der untenstehenden Liste übersprungen weden. Um das Cachg für Bilder und JavaScripte zu aktivieren, benennen Sie folgende Dateien.htaccess um: gm/htaccess images/htaccess images/product_images/htaccess templates/htaccess Achtung: Sollte nach dem Umbenennen der Shop nicht mehr funktionieren, unterstützt der Server das Cachg nicht, sodass die Umbenennung rückgängig gemacht werden muss. 2015 Gambio GmbH. www.gambio.de 15
10.7 PayPal Plus Im Rahmen dieses Master Updates wird e aktualisiertes PayPal-Modul mitgeliefert. Hierüber sd die Nutzung der neuen PayPal Plus-Funktionen möglich. Ee genaue Übersicht über die Funktionen und Estellungen fden Sie der beiligenden PayPalPlus Installationsanleitung. Achtung: Da das Modul durch dieses Master Update bereits vorstalliert wird, entfallen diese Schritte nerhalb der Anleitung. Bitte begnen Sie die Erichtung mit dem Abschnitt 2.3 Installieren des Moduls zur Verwendung im Shop. 2015 Gambio GmbH. www.gambio.de 16