Version vom 00:43, 16. Mai 2007

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 auf 3.6

Anmerkung vom Author

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 das keine alten Dateien überleben, sollten Sie zuerst die komplette alte Installation auf Ihrem Webspace löschen. Stellen sie sicher das 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 Mediendateinen in den Ordner Images bzw. Dokumente hochzuladen.

Schritt 3: Datenbanü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_". 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:

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 Sie nicht alle Plugins oder Tabellen die in der alten Installation drin sind in der neuen auch drin haben, 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, empfiehtl es sich diese nun in ein eigenes Template zu überführen. Legen Sie dazu als erstes einen eigenen Unterordner in den Ordner 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.

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 (Club-Mitglieder, Kauf-Plugins).

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