Papoo Update

Sie sind hier: Hauptseite / Handbuch / Administration von Papoo / System / Stammdaten / Papoo Update

Im Gegensatz zu einem Upgrade ist ein Update nie eigenständig, d.h. es ist ohne eine bereits bestehende Basisversion nutzlos. In den meisten Fällen werden von Papoo Upgrades zur Verfügung gestellt. Diese ersetzen komplett die alten Skripte von Papoo und es gibt eine diesen Menüpnukt, der Änderungen an der Datenbank durchführt.

Update von 4.x.x / 5.x.x / 6.x.x auf aktuellste Version

Erstellen Sie wie immer *vorher!* eine Sicherung per FTP der Dateien UND über System / Konfiguration / Sicherungen eine Sicherung der Datenbank.

An der Datenbank wurde im Kernsystem einige Kleinigkeiten verändert, daher sollten Sie zuerst über System / Konfiguration / Sicherungen die Datei /update/update40x.sql als Sicherung einspielen. Wobei mit x alle SQL Dateien gemeint sind die in der Differenz zu finden sind.

Also z.B. Update von 4.0.2 auf 6.0.2, dann alle update403.sql,update404.sql usw. ALLE nacheinander einspielen. Ja, wirklich alle einzelnen Dateien eine nach der anderen einspielen.

Das passiert dort wo Sie eine Datei hochladen können unter "Eine Sicherung hochladen und einspielen" -> Eingabe der Datei: Das Dokument..

Danach können Sie einfach per FTP die Dateien drüberspielen und damit Ihre Seite aktualisieren,achten Sie darauf dass Sie die /lib/site_conf.php nicht überschreiben!

Achtung - löschen Sie danach Cache und Cookies im Browser und melden Sie sich dann erneut an. Das dient dazu einige neue Layoutanweisungen in der Administration korrekt umzusetzen - ansonsten sehen Sie ein wenig durcheinander.

Achten Sie auch darauf dass evtl. durchgeführte Änderungen an Dateien des Kernsystems, der Templates und CSS Dateien die Sie selber durchgeführt haben, zurückgespielt werden müßen.

Im Anschluß an das Update muß das RSS-Feed Pluin neu installiert werden (natürlich nur falls es bereits installiert ist).

Bei einem Update auf 6.0.2 muss man als letztes einmal in der Administration Artikel bearbeitung und einmal auf Menü bearbeiten klicken damit die neue Artikel und Menüsteuerung gesetzt werden kann. Wenn man das nicht macht sind erstmal keine Menüpunkte und Artikel zu sehen.

Update von 3.x auf 5.x.x

Der Updateprozess auf die Version 5 ist etwas komplizierter als die vorherigen Updates, weil sich unglaublich viel in der Datenbankstruktur und der Dateistruktur verändert hat. Diese Anleitung bezieht sich auf Papoo ab Version 3.5. Frühere Versionen müssen erst auf Version 3.5 upgedatet werden.

Weil die Updateprozedur nicht ganz unkompliziert ist, wird in dieser Anleitung beschrieben, wie sie zunächst eine Installation von Papoo 5 in einem Unterverzeichnis vornehmen, dann Ihre Webseite in diese Installation übertragen, und erst zum Schluss Ihre alte 3.7.x - Installation durch die neue ersetzen. Dies hat den Vorteil, dass Ihre Webseite auch während des Updateprozesses erreichbar bleibt. Sollte beim Updateprozess etwas schiefgehen, so haben sie immer noch eine funktionierende Version Ihrer Webseite und können das Update ggf. neu starten.

Wenn Sie sich ein Update nicht zutrauen, können wir das gerne gegen Aufpreis für Sie durchführen, fragen Sie uns einfach mal nach einem Kostenvoranschlag.

Spätere Updates werden deutlich einfacher werden, da wir in Zukunft ein automatisches Update entwickeln und anbieten werden.

Ein schönes Video Tutorial findet sich auch hier: http://blog.hiltmann.net/video/tutorial-cms-software-update-von-papoo-3-x-auf-papoo-4/2010/05/20/

Wichtig ist, dass Ihr Server PHP 5 unterstützt! Wenn Sie das nicht wissen,
halten Sie bitte Rücksprache mit Ihrem Provider!!! (PHP 4 ist völlig veraltet!!)

Bei 1und1, die oft noch PHP4 nutzen, muss man diesen Link beachten:
http://hilfe-center.1und1.de/hosting/scripte_datenbanken/php/17.html

Schritt 1 - Unterverzeichnis erstellen

Erstellen Sie per FTP auf Ihrem Webserver ein Verzeichnis "/neu".

Schritt 2 - Papoo 4 installieren

Installieren Sie Papoo 5 auf Ihrem Webserver in dem Unterverzeichnis "/neu". Kopieren Sie dazu den Inhalt der ZIP-Datei, die sie von http://www.papoo.de heruntergeladen haben, per FTP in das soeben erstellte Unterverzeichnis "neu" auf Ihrem Webserver und starten Sie das Setup durch die Eingabe von

http://www.meine-webseite.xy/neu

in Ihrem Browser, wobei Sie natürlich "meine-webseite.xy" durch den Namen Ihrer Domain ersetzen. Achten Sie bei der Installation darauf, dass sie nicht die Tabellen Ihrer alten Installation überschreiben. Um dies zu vermeiden, benutzen Sie ein anderes Tabellen-Präfix für Ihre neue Installation, z.B. "pap5_", oder sie benutzen, falls möglich, eine andere Datenbank.

Eine detaillierte Installationsanleitung können Sie sich hier als PDF herunterladen: http://www.papoo.de/index.php?menuid=26&downloadid=249&reporeid=21

Schritt 3 - Sicherung erstellen

Erstellen Sie zuerst in der neuen Installation eine komplette Sicherung der Datenbank, Daten und Struktur! Dies machen Sie über das Entwicklerwerkzeuge-Plugin (Plugins / Entwicklerwerkzeuge / Datensicherung). Achten Sie dabei darauf, dass sie die Sicherungsdatei im Format UTF-8 abspeichern.

Diese Daten-und-Struktur-Sicherung dient nur dazu, zum Ausgangsstand zurückzukommen, falls etwas schief geht!

Schritt 4 - Nur Datensicherung erstellen

Erstellen Sie nun über das oben genannten Plugin "Entwicklerwerkzeuge" eine reine Datensicherung in der alten Installation. Setzen Sie dafür das Häkchen ganz unten bei "Daten speichern.". Diese Sicherung brauchen Sie in einem späteren Schritt, um die Daten in Ihre neue Papoo-Installation zu übernehmen. Achten Sie auch hierbei darauf, dass sie die Sicherungsdatei im Format UTF-8 abspeichern. Normalerweise geschieht das zwar automatisch, nur falls es später beim Rückspielen einen Fehler gibt, kann dies eine mögliche Ursache sein. Falls Ihr Browser die Sicherungsdatei anzeigt und nicht zum Download anbietet, dann klicken Sie bitte mit der rechten und nicht mit der linken Maustaste auf den Link und wählen Sie dann die Option "Ziel speichern unter..."

Schritt 5 - Sichern der Verzeichnisstruktur

Sichern Sie nun Ihre komplette alte Papoo-Installation per FTP auf Ihre lokale Festplatte. Denken Sie hierbei daran, das soeben erstellte Verzeichnis "/neu" nicht mitzusichern. Falls Sie in Ihrer alten Papoo-Installation automatische Sicherungen aktiviert haben, so kann dieser Prozess unter Umständen ziemlich lange dauern. In diesem Fall empfiehlt es sich, die .sql-Dateien unter "/dokumente/logs" nicht mitzusichern; das müssen Sie in diesem Fall selbst entscheiden.

Schritt 6 - Plugins installieren

Gehen Sie in die Administrationsoberfläche Ihrer alten Papoo-Installation und notieren Sie sich genau, welche Plugins Sie installiert haben. Gehen Sie nun in die Administrationsoberfläche ihrer neuen Papoo-Installation und installieren Sie genau diese Plugins.

Dieser schritt ist absolut notwendig, da es sonst zu verwaisten Plugins kommen kann.

Anmerkung: Das neue, in Papoo 5 vorhandene Kalender-Plugin ist nicht abwärtskompatibel. Weiterhin heisst das Keywords-Plugin nun "Tag Cloud Plugin". Weiterhin ist das Plugin "Freie Module" NICHT updatefähig, d.h. die freien Module müssen nach einem Update wieder neu geschrieben werden.

Schritt 7 - Einspielen der Datenbank

Gehen Sie in der Administrationsoberfläche ihrer neuen Papoo-Installation auf "System / Konfiguration / Sicherungen" und spielen Sie dort die Sicherungsdatei ein, die sie unter Schritt 4 erstellt haben. (Die reine Datensicherung - ohne Struktur.) Dazu suchen Sie unter "Eingabe der Datei:" die entsprechende Datei heraus und klicken dann auf "hochladen". Setzen Sie kein weiteres Häkchen, auch nicht das bei "Dump aus einer älteren Version".

Upload klappt nicht...

falls sie keine Anzeige sehen, wie die Daten zurückgespielt werden, oder falls der Rückspielprozess unterbricht, können Sie die alternative Methode zur Rücksicherung der Datenbank benutzen.

1. Laden Sie die Sicherungsdatei, die Sie in Schritt 4 erstellt haben (ohne Struktur), per FTP in das Verzeichnis "/neu/interna/templates_c" Ihres Webservers und benennen Sie sie dort in "restore.sql" um.
2. Rufen sie die Seite System / Konfiguration / Sicherung auf.
3. Klicken Sie auf den Link: ""restore.sql"-Datei zurückspielen"; damit sollte das zurückspielen dann starten.

Falls Sie nun Fehlermeldungen sehen, dass bestimmte Sprachdateien nicht mehr vorhanden sind, deinstallieren Sie das betreffende Plugin im Pluginmanager. Erst wenn Sie keine Fehlermeldung mehr sehen, fahren Sie fort.

Sollte die Rücksicherung der Datenbank immer noch nicht funktionieren, dann könnte das Problem sein, dass die Sicherungsdatei einfach zu gross ist. In diesem Fall können Sie nochmal eine Sicherungsdatei ohne die alten Versionen Ihrer Artikel anlegen, die dann höchstwahrscheinlich sehr viel kleiner ist.

Gehen Sie dazu in das Backend Ihrer alten Papoo-Installation und wählen Sie im Plugin "Entwickler-Werkzeuge" den Menüpunkt "Datensicherung" aus. Aktivieren Sie nun alle Tabellen bis auf die, die den Ausdruck "_papoo_version_" im Tabellennamen enthalten. Speichern Sie diese Tabellen im UTF-8-Format ohen Struktuir ab und benutzen Sie diese Datei, um Ihre Datenbank in Ihre neue Papoo-Installation zurückzuspielen.

In ganz seltenen Fällen könnte die Sicherungsdatei immer noch zu gross sein. Falls Sie dieses Pech haben sollten, so können Sie die Datei mit einem Texteditor in mehrere Teile aufsplitten und diese Teile dann nacheinander einspielen. Wer jetzt nicht genau verstanden hat, was wir damit meinen, der sollte am besten die Finger davon lassen und jemanden fragen, der ihm dabei helfen kann.

Schritt 8 - Aktualisieren der Inhalte

Wenn Sie Papoo Version 3.5.x oder Version 3.6.0 verwenden, dann spielen Sie unter "System - Konfiguration - Sicherungen" die Datei update361.sql aus dem Verzeichnis /update ihres Papoo-Paketes ein.

Danach, und sowieso, wenn Sie Papoo ab Version 3.6.1 verwenden, spielen Sie noch die Datei "update400.sql" und alle folgenden update4xx.sql Dateien ein.

Dies gilt auch für Papoo 3.7.x !!!

Damit werden die neuen Menüpunkte in der Administration initialisiert und evtl. Fehleinträge aus der Datenbank entfernt.

Falls Sie hier Fehlermeldungen sehen, ignorieren Sie diese einfach und klicken Sie unten auf der Seite auf den Link "weiter".

Damit haben Sie das schwierigste hinter sich!!

Sollten Sie Papoo 3.6.1 oder früher verwendet haben, so sind die Artikel noch nicht sichtbar. Diese müssen in der Datenbank noch neu zugeordnet werden. Klicken Sie dazu im Menüpunkt "System" - "Konfiguration" - "Papoo Update" auf den Link "Update der bestehenden Installation starten" und auf der nächsten Seite noch auf den Link "Das Update mit den obigen SQL-Anweisungen durchführen". Danach sind die Artikel neu zugeordnet und auch wieder sichtbar.

Schritt 9 - Layout wiederherstellen

Die Verzeichnisstruktur für die Layouts haben sich in Papoo 5 grundlegend geändert; jedes Layout liegt nun im Verzeichnis "/styles". Um Ihr Layout nun wieder herzustellen, gehen Sie wie folgt vor:

1. Erstellen sie im Verzeichnis "/neu/styles" ein neues Unterverzeichnis, z.B. "test_layout". (Das können Sie natürlich frei bezeichnen)
2. In diesem Verzeichnis erstellen Sie ein Verzeichnis "css" und ein Verzeichnis "templates".
3. Kopieren Sie nun die Datei "screenshot.gif" aus Ihrem "/css/mein_layout/" Verzeichnis in das soeben angelegte Verzeichnis "test_layout".
4. Kopieren Sie dann den Inhalt Ihres CSS-Layout Verzeichnisses (nein, nicht alle Verzeichnisse im alten Verzeichnis "/css", sonder nur den Inhalt des Layout-Verzeichnisses, das sie übernehmen möchten) in das Verzeichnis "/neu/styles/test_layout/css".

Das Verzeichnis "/templates" können Sie zunächst leer lassen, weil zuerst automatisch die default-Templates aus dem Verzeichnis "/styles_default/templates" verwendet werden.

Jetzt können Sie das Layout wie gewohnt unter "Layout / Styles + Module" aktivieren.

Danach gehen Sie in den Modulmanager, den Sie in der Version 5 nicht mehr als eigenen Menüpunkt finden, sondern durch klicken auf den Link "Layoutdaten, Module usw von: Mein neuer Style -- bearbeiten".

Dort können Sie die Module dann so wie in Ihrer alten Papoo-Installation platzieren.

Da wir an den Templates einige, wenn auch kleinere Änderungen durchgeführt haben, sind evtl. Anpassungen am Layout notwendig.

Schritt 10 - Dateien zurückspielen

Kopieren Sie nun Ihre Dateien und Bilder, die Verzeichnisse "/dokumente" und "/images", auf Ihren Webserver in das Verzeichnis "/neu" (vergessen Sie nicht, die Rechte via FTP korrekt zu setzen (evtl. 777), sonst können Sie die nicht bearbeiten oder löschen). Nun kopieren Sie noch die Verzeichnisse von evtl. vorhandenen Bildergalerien und Shop-Dateien auf Ihren Webserver in das Verzeichnis "/neu".

Schritt 11 - Plugins

Die Plugin-Struktur wurde im Zuge der Version 5 geändert. Die jeweils zum Plugin gehörende xml-Datei wurde in das jeweilige Plugin Verzeichnis verschoben. Früher hatte man eine "beispiel.xml"-Datei und ein "beispiel"-Verzeichnis, heute befindet sich die Datei "beispiel.xml in dem Verzeichnis "beispiel". Wenn man also ältere Plugins weiter verwenden bzw. neu installieren möchte, die dazugehörige xml Datei also entsprechend verschieben.

Schritt 12 - Verschiebung ins Hauptverzeichnis

Jetzt sollte Ihre neue Papoo-Installation genauso aussehen wie Ihre alte. Ist dies nicht der Fall, so führen Sie nun entsprechende Anpassungen durch.

Um Ihre neue Papoo-Installation jetzt aus dem Verzeichnis "/neu" in das Hauptverzeichnis Ihres Webservers zu verlegen, gehen Sie wie folgt vor:

1. Laden Sie die Datei "/neu/lib/site_conf.php" via FTP auf Ihren Computer.
2. Öffnen Sie diese mit einem Texteditor und löschen Sie den String "/neu" aus den Variablen "$pfadhier" und "$webverzeichnis".
3. Ändern Sie per FTP die Zugriffsrechte der Datei "/neu/lib/site_conf.php" auf Ihrem Webserver auf 777 und überschreiben Sie diese Datei mit der, die Sie eben auf Ihrem Computer editiert haben. Ändern Sie die Zugriffsrechte dieser Datei danach wieder auf 444. In diesem Moment ist Ihre neue Papoo-Installation nicht erreichbar.
4. Gehen Sie nun in das Hauptverzeichnis Ihres Webservers und erstellen Sie dort ein Verzeichnis "/alt".
5. Verschieben Sie alle Dateien und Ordner bis auf den Ordner "/neu" in das Verzeichnis "/alt".
6. Gehen Sie in den Ordner "/neu" und verschieben Sie alle Dateien und Ordner aus diesem Ordner in das Hauptverzeichnis Ihres Webservers.
7. Den leeren Ordner "/neu" können Sie nun löschen.

Das Update ist nun beendet und sie können Ihre neue Papoo-Installation unter Ihrer gewohnten Domain erreichen.

Sobald Sie sich sicher sind, dass Ihre neue Papoo-Installation tatsächlich fehlerfrei funktioniert, können Sie natürlich den Ordner "/alt" von Ihrem Webserver löschen.

Update von 3.7.1/2/3 auf 3.7.5

Sicherungskopie

Zuerst sollten Sie sich eine Sicherungskopie Ihrer aktuellen Papoo-Installation anlegen. Dazu sichern Sie zuerst Ihre komplette Papoo-Datenbank. Nutzen Sie dazu entweder die Papoo Administration (System/Stammdaten/Sicherungen) oder ein Datenbanktool wie z.B. phpMyAdmin. Desweiteren empfiehlt es sich, Ihre aktuelle Papoo-Installation per FTP lokal auf Ihrem Rechner zu sichern. So haben Sie bei eventuellen Problemen relativ einfach die Möglichkeit auf Ihren jetzigen Stand zurück zu kehren. Dies gilt vor allen Dingen, wenn Sie Änderungen an .css-Dateien oder Templates vorgenommen haben, die Sie später wiederherstellen möchten.

Update

1. Spielen Sie die passende SQL Datei in Ihre bestehende Installation über Stammdaten / Sicherung ein also die update/update373.sql für ein Update von 373 auf 375
2. Kopieren Sie nun alle Daten der neuen Version per FTP hinüber
3. Spielen Sie die Sicherungen Ihres CSS und Template Verzeichnisses zurück
4. Fertig

Update von 3.7.1/2 auf 3.7.2/3

Sicherungskopie

Zuerst sollten Sie sich eine Sicherungskopie Ihrer aktuellen Papoo-Installation anlegen. Dazu sichern Sie zuerst Ihre komplette Papoo-Datenbank. Nutzen Sie dazu entweder die Papoo Administration (System/Stammdaten/Sicherungen) oder ein Datenbanktool wie z.B. phpMyAdmin. Desweiteren empfiehlt es sich, Ihre aktuelle Papoo-Installation per FTP lokal auf Ihrem Rechner zu sichern. So haben Sie bei eventuellen Problemen relativ einfach die Möglichkeit auf Ihren jetzigen Stand zurück zu kehren. Dies gilt vor allen Dingen, wenn Sie Änderungen an .css-Dateien oder Templates vorgenommen haben, die Sie später wiederherstellen möchten.

Bei diesem Update muß die Datenbank nicht upgedated werden. Es reicht wenn Sie die Dateien per FTP hochkopieren und die bestehende Installation überschreiben.

Spielen Sie danach Ihre Sicherung des eigenen auf der Seite verwendeten CSS zurück falls Sie dafür kein eigenes CSS Verzeichnis verwendet haben.

Achtung

• Achten Sie darauf dass Sie die originale /lib/site_conf.php zurückspielen falls Sie diese beim Update überkopiert haben.
• Achten Sie weiterhin darauf dass Sie die die originale .htaccess wieder zurückspielen die Sie benutzen.

Update von 3.6.1 auf 3.7.x

Sicherungskopie

Zuerst sollten Sie sich eine Sicherungskopie Ihrer aktuellen Papoo-Installation anlegen. Dazu sichern Sie zuerst Ihre komplette Papoo-Datenbank. Nutzen Sie dazu entweder die Papoo Administration (System/Stammdaten/Sicherungen) oder ein Datenbanktool wie z.B. phpMyAdmin. Desweiteren empfiehlt es sich, Ihre aktuelle Papoo-Installation per FTP lokal auf Ihrem Rechner zu sichern. So haben Sie bei eventuellen Problemen relativ einfach die Möglichkeit auf Ihren jetzigen Stand zurück zu kehren. Dies gilt vor allen Dingen, wenn Sie Änderungen an .css-Dateien oder Templates vorgenommen haben, die Sie später wiederherstellen möchten.

Ablauf des Updates

1. Kopieren Sie die drei Verzeichnisse "interna", "lib" und "update" aus dem Update Patch (Verzeichnis "\update_patch_36x_auf_37x" aus dem ZIP-File der Installation) per FTP in das Stammverzeichnis Ihrer Papoo Installation und überschreiben Sie die vorhandenen Dateien
2. Loggen Sie sich nun im interna-Bereich Ihrer bisherigen 3.6.1er-Installation als Administator ein und gehen Sie zur Seite System / Stammdaten / Papoo Update
3. Wenn dort nichts zu sehen ist, dann Inhalt!! des Verzeichnisses /interna/templates_c/standard/ per FTP löschen und laden Sie die Seite neu mit der Taste F5 im Browser
4. Versionen < 3.6.1 bitte das Verzeichnis /interna/templates_c/standard/ manuell erstellen und mit den Rechten 777 versehen, außerdem die Dateien, die im Patch im Verzeichnis /interna/templates/standard/ enthalten sind, in das Verzeichnis /interna/templates/standard/ kopieren auf dem Server.
5. Klicken Sie nun den unteren Link: "Update der bestehenden Installation starten"
6. Anschließend klicken Sie "Das Update mit den obigen SQL Anweisungen durchführen.".
7. Achtung, entfernen Sie nun aus der neuen Version 370 die Datei /lib/site_conf.php vor dem Upload (natürlich nicht die vorhandene auf dem Server!)
8. Öffnen sie die Datei /lib/site_conf.php auf Ihrem Server (also die derzeit vorhandene) und ergänzen Sie unten in der Datei vor dem ?> den folgenden Eintrag:
   //Konstanten belegen
   define(PAPOO_ABS_PFAD,$pfadhier);
   define(PAPOO_WEB_PFAD,$webverzeichnis);
   define(PAPOO_VERSION,$version);
   define(PAPOO_DOKU_USER,"");
9. Speichern Sie die Datei wieder auf dem Server, evtl. müssen Sie noch die Schreibrechte ändern, damit Sie die Datei überschreiben können.
10. Kopieren Sie nun alle restlichen Dateien auf den Server, einfach alles überschreiben.
11. Spielen Sie Ihre Sicherung des eigenen auf der Seite verwendeten CSS zurück falls Sie dafür kein eigenes CSS Verzeichnis verwendet haben.
12. Gleiches gilt für eigene Templates
13. Falls die Artikel nicht mehr zu sehen sein sollten unter den Menüpunkten, dann nochmal Stammdaten/Papoo Update -> Update der vorhandenen Version klicken und bestätigen - da laufen einige Aufräumfunktionen ab die nicht immer beim ersten Durchlauf 100%ig funktionieren.
14. Fertig

ACHTUNG bei Strato Accounts

Dort muß anschließend evtl. noch die folgende Zeile in die .htaccess eingebaut werden, direkt am Anfang:

AddType application/x-httpd-php5 .php .php5

Update auf 3.6

Anmerkung vom Autor

Ich beschreibe hier wie ich das Update auf die Version 3.6. durchgeführt habe. Ich übernehme keine Garantie für die Vollständigkeit dieses Artikels.

Stefan

Das Update auf die Version 3.6. ist einfach und erfolgt im wesentlichen wie das Update auf die Version 3.5. Zur Übersicht sind hier nochmal alle wesentlichen Punkte zusammengefasst.

Sicherungskopie

Zuerst sollten Sie sich eine Sicherungskopie Ihrer aktuellen Pappo Installation anlegen. Dazu sichern Sie zuerst Ihre komplette Papoo Datenbank. Nutzen Sie dazu entweder die Papoo Administration (System/Stammdaten/Sicherungen) oder ein Datenbanktool wie z.B. phpMyAdmin. Desweiteren empfiehlt es sich Ihre aktuelle Papoo Installation per FTP lokal auf Ihrem Rechner zu sichern. So haben Sie bei eventuellen Problemen relativ einfach die Möglichkeit auf Ihren jetzigen Stand zurück zu kehren.

Update auf 3.6 von Version 3.5.x

Um sicherzugehen, dass keine alten Dateien überleben, sollten Sie zuerst die komplette alte Installation auf Ihrem Webspace löschen. Stellen sie sicher, dass Sie eine Sicherrungskopie erstellt haben. Ihre aktuelle Datenbank auf keinen Fall löschen. Diese wird später noch benötigt.

Schritt 1: Neuinstallation der Version 3.6

Führen Sie zunächst eine komplette Neuinstallation der Version 3.6 - entweder mit einem neuen Präfix in die gleiche Datenbank oder in eine neue Datenbank - durch. Wie sie Papoo installieren lesen Sie in diesem Artikel. Achten Sie besonders auf die korrekte Rechtevergabe für die Ordner und Dateien.

Es kann vorkommen, dass Sie beim ersten Aufruf des Frontends Ihrer neuen Seite einen Smartyerror angezeigt bekommen bzw. die Seite leer bleibt.

Dies liegt häufig daran, dass ab der Version 3.6. verschiedene Templates genutzt werden können. Die eigentlichen Template Dateien, wie z.B. die _kopf.utf8.html liegen hierfür nochmal in eigenen Unterordnern in dem Templates Ordner Ihrer Papoo Installation. Beim Aufruf der Seite werden diese Dateien von der Smarty Engine compiliert und in dem Ordner templates_c abgelegt. In dem Ordner templates_c müssen die selben Unterordner vorhanden sein, wie in dem Ordner templates. Sollten diese Unterordner nicht vorhanden sein, legen Sie sie bitte per FTP Programm im Ordner templates_c Ihrer Papoo Installation an.

Schritt 2: Hochladen Ihres alten Layouts

Sie können bereits jetzt Ihr altes CSS Layout per FTP in den Ordner CSS hochladen. Ebenso empfiehlt es sich alle Mediendateien in den Ordner Images bzw. Dokumente hochzuladen.

Schritt 3: Datenbankübernahme

Führen Sie nach erfolgreicher Installation das Datenbank Update durch. Hierzu rufen Sie im Papoo Backend den Punkt (System/Stammdaten/Papoo Update) auf. Die alte Datenbank bleibt dabei bestehen.

Sie sehen dann unter dem Menüpunkt das folgende Formular:

Geben Sie hier das Präfix der alten Installation an:

Das Präfix bitte ohne "_" angeben, also z.B. "123" und nicht "123_". Also so wie Sie es bei der vorherigen (alten) Installation angegeben haben.

Zugriffs-Parameter der alten Datenbank

Befinden sich Ihre alten Daten nicht in derselben Datenbank wie die jetzige Installation, müssen Sie hier zusätzlich die Zugriffs-Paramter der alten Datenbank angeben. Liegen die Daten in derselben Datenbank, könnnen sie die folgenden Felder einfach leer belassen. Das Skript könnte Probleme mit großen Datenmemgen haben oberhalb vo 10 MB (Stand 23.06.06).

Der alte Datenbank-Server:

Diesen erfahren Sie von Ihrem Provider (Beispiel Strato: rdbms.strato.de)

Der alte Datenbank-Name:

Der Name der alten Datenbank

Der alte Datenbank-Benutzer-Name:

Ihr vorheriger Benutzername

Das alte Datenbank-Benutzer-Passwort:

Das vorherige Passwort.

Diese Felder können leider nicht auf ihre Richtigkeit überprüft werden. Haben Sie hier also falsche Angaben gemacht, erhalten Sie nach Absenden der Seite eine Datenbank-Fehlermeldung oder eine komplett weisse Seite. In diesem Fall verwenden Sie bitte den "Zurück-Knopf" Ihres Browser und korrigieren Sie Ihre Angaben.

CSS-Styles einbeziehen

Möchten Sie auch die Datenbank-Einträge der CSS-Sytles ihrer alten Installation übernehmen, dann können Sie die folgende Option aktivieren. Beachten Sie dabei aber, dass die CSS-Styles dieser Installation dadurch verloren gehen. Wir empfehlen deshalb die CSS-Styles nicht zu übernehmen und sie anschließend über den Menü-Punkt "System -> CSS-Layout" einzupflegen. CSS-Styles einbeziehen

Datenbank-Parameter setzen

Damit setzen Sie die Parameter die im folgenden Schritt überprüft werden.

Überprüfung

Wenn nicht alle Plugins oder Tabellen aus der alten Installation installiert sind, werden Sie darauf aufmerksam gemacht. Sie können die Datenbankübernahme auch ohne die Installation aller alten Plugins durchführen, allerdings verlieren Sie dann alle Datenbankeinträge für Ihre Plugins (z.B. Termine im Kalender). Es empfiehlt sich daher vor dem Datenbankupdate alle alten Plugins auch in der Neuinstallation von Papoo zu installieren.

Anschließend können Sie das Update durchführen. Nach dem Update sehen Sie ein Liste der Tabellen die aktualisiert wurden. Bei Problemen bitte diese Liste kopieren und mit im Forum posten.

Schritt 4: Einrichten Ihres alten Layouts

• Installieren Sie einen mitglieferten Style, z.B. LGBlue falls dieser nicht installiert ist
• Machen Sie diesen zum Standard
• Deinstallieren Sie Ihren Style (Funktion "löschen" in der Backend CSS Verwaltung)
• Öfnnen Sie Ihr FTP Programm und gehen Sie auf den Server
• Kopieren Sie die css.xml Datei aus dem Verzeichnis /css/LGBlue in Ihren Stylesheet Pfad
• Installieren Sie Ihren Style erneut unter Stammdaten/CSS bearbeiten
• Machen Sie Ihren Style zum Standard
• Öffnen Sie im Modulmanager Ihren Style
• Machen Sie dort Ihre Einstllungen zur Platzierung der Module

Schritt 5: Eigenes Template / Template Anpassungen

Wenn Sie in Ihrer alten Papoo Installation Anpassungen an den Template Dateien vorgenommen haben, empfiehlt es sich, diese nun in ein eigenes Template zu überführen. Legen Sie dazu als erstes einen eigenen Unterordner in den Ordnern templates und templates_c an. Danach kopieren Sie alle Dateien aus dem Ordner templates/standard in Ihren eigenen Ordner.

In den CSS Einstellungen für Ihr Layout müssen Sie jetzt noch angeben welches Template Ihr css Layout verwenden soll. Hier wählen Sie Ihr neuerstelltes Template aus.

Sie können nun beliebige Anpassungen an den Templatedateien vornehmen. Bitte beachten Sie, dass die umgebenen DIV Container (page_margin, main, head etc) nicht mehr in der _kopf.utf8.html geöffnet und in der _fuss.html geschlossen werden, sondern dies jetzt alles zentral in der _index.html erfolgt.

Schritt 6: Modul Dritte Spalte

Die Artikel für das Modul 3. Spalte müssen nach einem Update auf die Version 3.6 angepasst werden, damit sie wieder korrekt angezeigt werden. Ab der Version 3.6 ist es möglich die Artikel der 3. Spalte mehreren Menüpunkten zuzuweisen. Nach einem Update sind die Artikel per default keinem Menü zugeordnet. Um einen Artikel einem Menü zuzuweisen, öffnen Sie den Artikel im Backend über Inhalte / 3. Spalte verwalten / Eintrag bearbeiten.

Wählen Sie den Artikel aus, den Sie ändern möchten. Geben Sie Ihrem Artikel zuerst eine neue Überschrift. Danach speichern Sie die Änderungen. Wenn Sie nicht speichern, gehen Ihre Änderungen nach Zuweisung des Menüpunktes verloren. Danach wählen Sie über das Drop Down Menü den Menüpunkt aus, unter dem Ihr Artikel erscheinen soll. Nach Klick auf den Button "Menü hinzufügen" erscheint das zugewiesene Menü in einem neuen Abschnitt Ihres Artikels. Sie können hier mehrere Menüpunkte zuweisen. Speichern Sie zum Abschluss alle Ihre Änderungen.

OrderID für Artikel der 3. Spalte Wenn Sie unter einem Menüpunkt mehrere Artikel zugewiesen haben, können Sie über die Order ID bestimmen, welcher Artikel zuerst angezeigt wird. Dabei gilt: je kleiner die Nummer desto höher wird der Artikel gelisted (1 erscheint vor 2 usw.) Um einem Artikel eine andere Order ID zuzuweisen, geben Sie einfach die Ziel Order ID hinter dem Artikel ein unnd bestätigen mit dem Button "Eintragen". Der Artikel tauscht dann die Order ID mit dem Artikel der momentan die Ziel Order ID hat.

ACHTUNG In den ersten Download Versionen der Verion 3.6 gab es einen Fehler in der Datenbank, der die korrekte Order ID Verwaltung nicht zuließ. Dieser äußerte sich dahingehend, dass Order ID scheinbar willkürlich zugewiesen wurden und die Reihenfolge der Artikel nicht korrekt war (Die Nummern 10,11,12 usw wurden vor 2 gelistet). Um dieses Problem zu lösen, gehen Sie wie folgt vor.

• verbinden Sie sich per phpMyAdmin oder einem anderen Tool mit Ihrer Datenbank
• suchen Sie die Tabelle papoo_collumn3
• weisen Sie dem Datenfeld col_order_id den Typ INT zu

Jetzt sollte alles wie oben beschrieben funktionieren

Update auf 3.6 von Versionen < 3.5

Ob und ggf. welche besonderen Punkte bei einem Update von einer Version kleiner 3.5 zu beachten sind entnehmen Sie bitte dem Kapitel Update bei Version kleiner 3.0. Bitte beachten Sie hierbei auch die Umstellung auf Utf-8 ab der Version 3.5

Update auf 3.5.x

Das Update auf die Version 3.5 von einer 3.0.x Version ist einfach. Dafür die unten angegebenen Punkte des Datenbankupdates durchführen.

Als einzige Neuerung die händischen Eingriff erfordert ist unsere Umstellung des Modulmanagers. Dort können jetzt pro Style die Blöcke zugewiesen werden. Damit das jetzt auch mit dem eigenen Style funktioniert sind folgende Schritte durchzuführen, wobei wir hier davon ausgehen dass Sie ein Datenbankupdate schon mit Papoo Update durchgeführt haben.

• Installieren Sie einen mitglieferten Style, z.B. LGBlue falls dieser nicht installiert ist
• Machen Sie diesen zum Standard
• Deinstallieren Sie Ihren Style
• Öfnnen Sie Ihr FTP Programm und gehen Sie auf den Server
• Kopieren Sie die css.xml Datei aus dem Verzeichnis /css/LGBlue in Ihren Stylesheet Pfad
• Installieren Sie Ihren Style erneut unter Stammdaten/CSS bearbeiten
• Machen Sie Ihren Style zum Standard
• Öffnen Sie im Modulmanager Ihren Style
• Machen Sie dort Ihre Einstllungen zur Platzierung der Module
• Fertig

Update bei Versionen ab 3.0.0

Ab der Version 3.0 gibt es ein Update Skript, das nach einer Neuinstallation durchgeführt werden kann. Damit können prinzipiell auch Papoo Versionen ab 2.0 für ein Update genutzt werden. Allerdings wird das Layout nicht übernommen.

Auch hier gilt wieder: Sicherheit geht vor!

Ablauf des Updates

Führen Sie als erstes eine komplette Neuinstallation entweder mit einem neuen Präfix in die gleiche Datenbank oder in eine neue Datenbank durch. Rufen Sie dann diesen Menüpunkt auf. Die alte Datenbank bleibt dabei bestehen. Sie können die alte Installation laufen lassen und z.B. auf einer Subdomain oder Lokal mit xampp testen.

Sie sehen dann unter dem Menüpunkt das folgende Formular:

Geben Sie hier das Präfix der alten Installation an:

Das Präfix bitte ohne "_" angeben, also z.B. "123" und nicht "123_". Quasi so wie Sie es bei der vorherigen (alten) Installation angegeben haben.

Zugriffs-Parameter der alten Datenbank

Befinden sich Ihre alten Daten nicht in derselben Datenbank wie die jetzige Installation, müssen Sie hier zusätzlich die Zugriffs-Paramter der alten Datenbank angeben. Liegen die Daten in derselben Datenbank, könnnen sie die folgenden Felder einfach leer belassen. Das Skript könnte Probleme mit großen Datenmemgen haben oberhalb vo 10 MB (Stand 23.06.06).

Der alte Datenbank-Server:

Das ist in der Regel localhost, Sie erfahren von Ihrem Provider die genauen Daten.

Der alte Datenbank-Name:

Der Name der alten Datenbank

Der alte Datenbank-Benutzer-Name:

Ihr vorheriger Benutzername

Das alte Datenbank-Benutzer-Passwort:

Das vorherige Passwort.

Diese Felder können leider nicht auf ihre Richtigkeit überprüft werden. Haben Sie hier also falsche Angaben gemacht, erhalten Sie nach Absenden der Seite eine Datenbank-Fehlermeldung oder eine komplett weisse Seite. In diesem Fall verwenden Sie bitte den "Zurück-Knopf" Ihres Browser und korrigieren Sie Ihre Angaben.

CSS-Styles einbeziehen

Möchten Sie auch die Datenbank-Einträge der CSS-Sytles ihrer alten Installation übernehmen, dann können Sie die folgende Option aktivieren. Beachten Sie dabei aber, dass die CSS-Styles dieser Installation dadurch verloren gehen. Wir empfehlen deshalb die CSS-Styles nicht zu übernehmen und sie anschließend über den Menü-Punkt "System -> CSS-Layout" einzupflegen. CSS-Styles einbeziehen

Datenbank-Parameter setzen

Damit setzen Sie die Parameter die im folgenden Schritt überprüft werden.

Überprüfung

Wenn Sie nicht alle Plugins oder Tabellen die in der alten Installation drin sind in der neuen auch drin haben, werden Sie darauf aufmerksam gemacht.

Anschließend können Sie das Update durchführen. Nach dem Update sehen Sie ein Liste der Tabellen die aktualisiert wurden. Bei Problemen bitte diese Liste kopieren und mit im Forum posten.

Update bei den Versionen kleiner 3.0

Um ein Update von Papoo in den Versionen 2.x zu machen geht man folgendermaßen vor:

Die ersten beiden Punkte dienen der Absicherung falls etwas schief geht. Es ist zwar äußerst unwahrscheinlich das etwas schief geht, aber Sicherheit geht vor.

1. per FTP alle Dateien in einem Sicherungsverzeichnis auf dem lokalen Rechner sichern
2. per phpmyadmin einen Daten und Strukturdump machen
3. Im alten System unter Stammdaten/Sicherung eine Sicherung erstellen
4. Upload des neuen Papoo Systems per FTP

   Ihr könnt den Upload in das alte Verzeichnis vornehmen (Vorteil für die Installation s.u.)

   • Soll die bisherige Version, auf einem neuen Server, weiterhin genutzt werden, können per FTP alle Dateien aus dem Sicherungsverzeichnis wieder hoch gespielt werden. Damit werden dann auch alle benutzerspezifischen Dateien (Verzeichnisse: CSS, Dokumente, Images, sowie templates und lib/messages) hochgeladen.
   • Wird dabei gleich auf eine neue Version geupdatet, sind, nach dem die neue Version hochgespielt wurde, folgende Ordner zu prüfen und aus dem Sicherungsverzeichnis zu übernehmen: Dokumente, Images, CSS, sowie geänderte templates und aus dem lib/messages-Verzeichnis. Aus den letzten drei sind nur die Änderungen manuell in die neuen Dateien zu übernehmen.
   • Spielt auch die aktuellen plugins hoch, die nicht im Grundsystem dabei sind.

5. Installation normal durchführen

   In der Datei lib\site_conf.php stehen die alten Installationswerte. Diese Datei also immer beachten. Wurde die neue Version ins selbe Verzeichnis überspielt und soll der gleiche Präfix benutzt werden, kann die Installation vereinfacht werden.

   Haben sich die Server-Werte nicht geändert (Update auf gleichem Server), kann mittels www.IhreDomain.de/setup/install2.php die Installation verkürzt werden. Hier mit landet Ihr direkt beim Anlegen der Tabellen.

   Hinweis: Falls Euch mal das root-Passwort abhanden gekommen ist, mittels www.IhreDomain.de/setup/start.php kann es neu gesetzt werden.

6. In dem neu installierten System unter Stammdaten/Sicherung die erstellte Sicherung aus 3 einspielen.

   Achtung: Danach gelten wieder die Passwörter aus der Sicherung, falls man das root-Paßwort bei der Installation geändert hat.

7. Fertig!

Erfahrungsbericht: http://www.papoo.de/forumthread/forumid/6/menuid/138/rootid/6077/msgid/6077#6077

Neue CSS-Verwaltung Version 2.1.3

Wer auf die aktuelle Version 2.1.3 umsteigt, wird mit der neuen CSS-Verwaltung bekanntschaft machen.

Wie Ihr Eure bisherige CSS-Dateien in das neue System einpflegen könnt ist hier beschrieben:

1. Im CSS-Verzeichnis gibt es nun für jedes CSS ein eigenes Unterverzeichnis. In diesem Unterverzeichnis gibt es die Dateien xxx.css IEFixes_xxx.css und den Order images bzw. bilder (kommt darauf an, ob Du das papoo-css-Verzeichnis wählst oder ein neues anlegst.)
2. Wenn Du Papoo neu installiert hast, kannst Du Deine CSS-Datei (xxx.css) übers Backend hochspielen. Es werden dann die Verzeichnisse angelegt.
3. Per ftp spielst Du dann die Datei IEFixes_xxx.css in das Verzeichnis. Sowie die benutzten Bilder aus dem alten CSS-Bilder-Verzeichnis bilder in das neue bilder-Verzeichnis im css-Ordner.
4. Danach pass bitte noch die Pfade in der CSS-Datei auf das neue Bilder-Verzeichnis an.
5. Fertig!

Update von 0.237 auf 2.0.x

Diese Anleitung soll das Update von einer Ur-Version von Papoo erläutern. Der Link in Papoo stimmt nicht mehr und im Wiki ist der Text nun verewigt.

OK, hier ein kurzer Fahrplan:

1. Du installierst die neue Version auf einem Test-Rechner, oder in einem Unterverzeichnis mit einem eigenen Datenbank-Präfix (kannst du bei der Installation angeben)
2. du kopierst die beiden Verzeichnise /images und /dokumente deiner alten Installation in die neue (einfach die beiden Verzeichnise überschreiben) Jetzt sollten auch die meisten Bilder und Dokument-Downloads wieder funktionieren
3. du kopierst deine CSS-Datei(en) und alle zugehörigen Bilder ebenfalls von der alten Installation in die neue.
4. du erstellst von deiner alten Installation eine Sicherung vom Typ "complete inserts OHNE Struktur". Kannst du z.B. mit phpmyadmin machen.

   PHPMySQL Version 2.6.3 ausprobiert. Du muß folgende Häkchen setzen bzw. ausschalten

   • Struktur AUS
   • Daten AN
   • Vollständige INSERTs AN (restlichen Felder unter Daten AUS)
   • Export-Typ: REPLACE

5. du öffnest die so erstellte Datei mit deinem Lieblingseditor und führst folgende Ersetzung über die ganze Datei aus:

   "altesPraefix_papoo" -> "neuesPräfix_papoo".

   Wenn du ganz gut bist, kannst du auch noch alle Einträge mit

   "INSERT INTO `altesPraefix_papoo_menuint`..." entfernen. Sollten so grob 50 Stück sein.

6. die so geänderte Sicherungs-Datei spielt du in deine neue Installation ein. Das kannst du auch wieder mit phpmyadmin machen.
7. jetzt sollten alle deine alten Daten in der neuen Installation sein.
8. du installierst in der neuen Installation das Plugin "decode" und führst es aus.
9. kurz nochmal sämtliche Artikel kontrollieren. Es sollten jetzt eigentlich keine Dinge wie "ä" o.Ä. mehr zu sehen sein. Falls doch, das decode-Plugin nochmals ausführen.
10. Wenn alles sauber funktioniert, kannst du alles an die gewünschte Stelle kopieren. Das einzige was du dann noch machen mußt, ist die beiden Pfade $pfadhier und $webverzeichnis in der Datei /lib/site_conf.php anzupassen.
11. dich freuen, dass du die neue Version hast, die jetzt auch eine eingebaute Sicherung mitbringt, was das ganze ungemein vereinfacht.

Stephan