Installation eines Updates: Unterschied zwischen den Versionen

Aus DynPG-Wiki
Wechseln zu: Navigation, Suche
(Vorbereitung: Infobox-Templates eingefügt)
 
(Eine dazwischenliegende Version von einem anderen Benutzer werden nicht angezeigt)
Zeile 42: Zeile 42:
 
== Abschließende Schritte ==
 
== Abschließende Schritte ==
 
Nach dem Update wird Ihnen eine List zu löschender Dateien angezeigt. Aktualisieren Sie bitte dazu erst das Verzeichnis <tt>update/</tt>. Dadurch sehen Sie dann alle vorhandenen Dateien, die Sie dann gemäß der Beschreibung löschen können. Klicken Sie danach auf den Link zur Administration. Sobald Sie die Dateien gelöscht haben, ist das Update abgeschlossen und Sie können sich wieder in das Backend einloggen.
 
Nach dem Update wird Ihnen eine List zu löschender Dateien angezeigt. Aktualisieren Sie bitte dazu erst das Verzeichnis <tt>update/</tt>. Dadurch sehen Sie dann alle vorhandenen Dateien, die Sie dann gemäß der Beschreibung löschen können. Klicken Sie danach auf den Link zur Administration. Sobald Sie die Dateien gelöscht haben, ist das Update abgeschlossen und Sie können sich wieder in das Backend einloggen.
 +
 +
== Updates auf Versionen ab 4.6 ==
 +
Seit Version 4.6 ist DynPG auf die Zeichenkodierung UTF-8 festgelegt. Dies bietet den Vorteil zu älteren Versionen, dass zum einen mehr Zeichen unterstützt werden und zum anderen, dass
 +
die Kompatibilität zu aktuellen Vesionen von PHP (5.4 und neuer), sowie MySQL verbessert wird.
 +
 +
{{Caution
 +
|Sollten Sie DynPG von einer Version älter als oder identisch zu 4.5.3 updaten auf eine Version ab 4.6, dann beachten Sie bitte die nun folgenden Hinweise zur Umstellung der alten DynPG ISO Versionen auf die neueren Versionen mit UTF-8 Unterstützung.}}
 +
 +
Nachdem Sie das Update auf eine neue UTF-8 Version von DynPG wie oben beschrieben durchgeführt haben, dann ist es notwendig, dass sie einmalig nach dem Update die folgenden drei Schritte ausführen, um Ihre Webseite kompatibel mit der neuen Version von DynPG zu machen.
 +
 +
=== Schritt 1: Plugins Updaten ===
 +
 +
Alle vorhandenen Plugins müssen ebenfalls auf neue, UTF-8 kompatible Versionen, geupdated werden. Dies sind alle Versionen mit einem Bereitsstellungsdatum ab dem 21.07.2014. Laden Sie sich dazu die Plugins-Updates herunter und installieren Sie diese wie gewohnt (siehe auch [[Installation von Modulen]]).
 +
 +
=== Schritt 2: MySQL Encoding Umstellen ===
 +
 +
In der config.php (siehe [[Einstellungen in der Konfigurationsdatei]]), stellen Sie bitte das MySQL-Encoding auf UTF-8 um. Dazu modifizieren Sie die Parameter <tt>config_force_mysql_encoding</tt>, <tt>config_mysql_encoding</tt>, <tt>config_mysql_collation</tt> wiefolgt:
 +
 +
{| class="wikitable"
 +
! <center>'''Bezeichner'''</center>
 +
! <center>'''Wert'''</center>
 +
 +
|-
 +
| <tt>config_force_mysql_encoding</tt>
 +
| <code>true</code>
 +
 +
|-
 +
| <tt>config_mysql_encoding</tt>
 +
| <code>'utf8'</code>
 +
 +
|-
 +
| <tt>config_mysql_collation</tt>
 +
| <code>'utf8_unicode_ci'</code>
 +
 +
|}
 +
 +
=== Schritt 3: Bestehende PHP-Dateien umstellen ===
 +
 +
Zuletzt ist es notwendig, auch bestehende PHP-Dateien, in welche Sie Snippets von DynPG integriert haben, in UTF-8 codiert auszugeben. Dazu ändern Sie zunächst den META-Type der Seite auf UTF-8:
 +
 +
<code>[html,N]<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"></code>
 +
 +
Anschließend ändern Sie die Kodierung der PHP-Datei in UTF-8, sofern Umlaute direkt darin vorkommen (z.B. mithilfe von Notepad++ [http://notepad-plus-plus.org/]) und weisen DynPG an, die Codierung vor dem Senden an den Browser in UTF-8 festzuschreiben:
 +
 +
<code>[php,N]
 +
<?php
 +
    require('./dynpg/getcontent.php');
 +
    $GLOBALS["DynPG"]->init('./dynpg/');
 +
    $GLOBALS["DynPG"]->sendHTTPHeader('utf-8');
 +
?>
 +
</code>
 +
 +
Beachten Sie, dass dies auf ggf. vorhandene RSS Feeds betrifft, die z.B. nach [[Tutorial - RSS-Feeds]] erstellt wurden.

Aktuelle Version vom 4. September 2014, 23:07 Uhr


Übersicht

Vorbereitung

Entpacken

Entzippen Sie als erstes das entsprechende Update.

Caution.png Achtung: Achten Sie darauf, dass Sie die Updates der Reihenfolge nach vornehmen, sofern Sie mehrere gleichzeitig durchführen. Stellen Sie dabei sicher, das die Versionen der Updates einander entsprechen, d.h. das die neue Versionsummer eines Updates der Ausgangsversion des nächsten Updates entspricht. Die Versionsnummer der aktuell installierten Version von DynPG finden Sie im Backend, wenn Sie in der oberen Leiste auf das Btn info.jpg Info-Symbol klicken.

Hochladen

  • Wechseln Sie zu Ihrem FTP-Programm und stellen die Verbindung zu Ihrem Server her.
  • Versichern Sie sich, dass im Verzeichnis Update alle Dateien mit dem Namen "update.* entfernt worden sind, welche ggf. von einem vorgängigen Update noch vorhanden sind.
  • Kopieren Sie die Dateien des Updates in den Ordner, in dem sich Ihre DynPG Installation befindet. Dabei wird üblicherweise eine Viehlzahl von Dateien überschrieben, was zum normalen Update-Prozess gehört.


Caution.png Achtung: Bevor Sie die Update-Dateien hochladen, sollten Sie eine Kopie aller Dateien von DynPG anlegen, die evtl. verändert wurden. Dies können z.B. CSS Style Sheets oder Templates von DynPG sein. Sollten Sie sich nicht sicher sein, ob Dateien im CMS-Ordner verändert wurden, dann können Sie ein auch ein Backup des gesamten CMS-Ordners anlegen und lokal auf Ihrem Computer speichern, um ggf. veränderte Dateien später wieder hochzuladen.

Rechtevergabe

Wenn Sie alle Dateien hochgeladen haben, navigieren Sie auf dem Server in das Verzeichnis update/ und geben Sie dort für den Ordner bin/ die alle Rechte an (Schreib-, Lese- und Ausführungsrechte), sofern Sie dies noch nicht bei der Installation getan haben. Sie können dies z.B. mit den meisten gängigen FTP-Programmen tun.

Beispiel: Rechtevergabe im FTP Programm

Updatevorgang

Wechseln Sie nun zum Browser und rufen die Seite auf, über die Sie sich normalerweise in das Backend einloggen (z.B. www.beispiel.de/cms oder www.beispiel.de/dynpg). Dort wird Ihnen der Update-Bildschirm angezeigt. Hier sehen Sie die Änderungen, welche seit der letzten Version vorgenommen wurden und die Lizenzbestimmungen, sowie den aktuellen Stand der Vorbereitungen zum Update-Prozess. Wenn die angezeigten Voraussetzungen alle erfüllt sind, bestätigen Sie die Lizenzbedingungen und starten Sie das Update mit einem Klick auf den entsprechenden Button.

Abschließende Schritte

Nach dem Update wird Ihnen eine List zu löschender Dateien angezeigt. Aktualisieren Sie bitte dazu erst das Verzeichnis update/. Dadurch sehen Sie dann alle vorhandenen Dateien, die Sie dann gemäß der Beschreibung löschen können. Klicken Sie danach auf den Link zur Administration. Sobald Sie die Dateien gelöscht haben, ist das Update abgeschlossen und Sie können sich wieder in das Backend einloggen.

Updates auf Versionen ab 4.6

Seit Version 4.6 ist DynPG auf die Zeichenkodierung UTF-8 festgelegt. Dies bietet den Vorteil zu älteren Versionen, dass zum einen mehr Zeichen unterstützt werden und zum anderen, dass die Kompatibilität zu aktuellen Vesionen von PHP (5.4 und neuer), sowie MySQL verbessert wird.

Caution.png Achtung: Sollten Sie DynPG von einer Version älter als oder identisch zu 4.5.3 updaten auf eine Version ab 4.6, dann beachten Sie bitte die nun folgenden Hinweise zur Umstellung der alten DynPG ISO Versionen auf die neueren Versionen mit UTF-8 Unterstützung.

Nachdem Sie das Update auf eine neue UTF-8 Version von DynPG wie oben beschrieben durchgeführt haben, dann ist es notwendig, dass sie einmalig nach dem Update die folgenden drei Schritte ausführen, um Ihre Webseite kompatibel mit der neuen Version von DynPG zu machen.

Schritt 1: Plugins Updaten

Alle vorhandenen Plugins müssen ebenfalls auf neue, UTF-8 kompatible Versionen, geupdated werden. Dies sind alle Versionen mit einem Bereitsstellungsdatum ab dem 21.07.2014. Laden Sie sich dazu die Plugins-Updates herunter und installieren Sie diese wie gewohnt (siehe auch Installation von Modulen).

Schritt 2: MySQL Encoding Umstellen

In der config.php (siehe Einstellungen in der Konfigurationsdatei), stellen Sie bitte das MySQL-Encoding auf UTF-8 um. Dazu modifizieren Sie die Parameter config_force_mysql_encoding, config_mysql_encoding, config_mysql_collation wiefolgt:

Bezeichner
Wert
config_force_mysql_encoding true
config_mysql_encoding 'utf8'
config_mysql_collation 'utf8_unicode_ci'

Schritt 3: Bestehende PHP-Dateien umstellen

Zuletzt ist es notwendig, auch bestehende PHP-Dateien, in welche Sie Snippets von DynPG integriert haben, in UTF-8 codiert auszugeben. Dazu ändern Sie zunächst den META-Type der Seite auf UTF-8:

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

Anschließend ändern Sie die Kodierung der PHP-Datei in UTF-8, sofern Umlaute direkt darin vorkommen (z.B. mithilfe von Notepad++ [1]) und weisen DynPG an, die Codierung vor dem Senden an den Browser in UTF-8 festzuschreiben:

<?php
    require('./dynpg/getcontent.php');
    $GLOBALS["DynPG"]->init('./dynpg/');
    $GLOBALS["DynPG"]->sendHTTPHeader('utf-8');
?>

Beachten Sie, dass dies auf ggf. vorhandene RSS Feeds betrifft, die z.B. nach Tutorial - RSS-Feeds erstellt wurden.