Sie befinden sich hier: start » de » customization

Anpassungen

Manchmal besteht die Notwendigkeit CMSimple_XH anzupassen. Grundsätzlich ist es in Ordnung die benötigten Änderungen direkt in den Programmdateien an der passenden Stelle durchzuführen. Aber in Hinblick auf künftige Updates ist es besser die Programmdateien nicht mehr als unbedingt nötig zu ändern. Idealerweise sollten Sie versuchen jede Änderung als ein Plugin, oder, wenn Sie nicht das gesamte Leistungsvermögen eines Plugins brauchen, als Funktionalität in userfuncs.php zu implementieren.

userfuncs.php

Es ist sichergestellt, dass die Datei cmsimple/userfuncs.php niemals mit CMSimple_XH ausgeliefert wird, so dass Sie nicht mit dem nächsten Update überschrieben werden kann. Aber sie wird automatisch von CMSimple_XH vor den Plugins eingebunden. Daher können Sie diese Datei verwenden um benötigte Funktionalität zu CMSimple_XH hinzuzufügen.

Die erste Zeile von userfuncs.php sollte immer lauten:
<?php

Wenn Sie eine Funktion von CMSimple_XH zu ändern haben, können Sie diese Funktion nach userfuncs.php kopieren, sie an der ursprünglichen Stelle löschen und Ihre Änderungen an der Kopie in userfuncs.php vornehmen. Nach einem Update ist es oft ausreichend, wenn Sie die Funktion von der ursprünglichen Stelle erneut entfernen.

Wenn sie Code im globalen Sichtbarkeitsbereich (d.h. außerhalb einer Funktion) zu ändern haben, können Sie diesen Code meist nicht nach userfuncs.php verschieben, da die Reihenfolge der Ausführung beachtet werden muss. In diesem Fall ist es das beste, wenn Sie die Änderungen an den Systemkern-Dateien auf ein Minimum beschränken, und soweit möglich, eine neue Funktion in userfuncs.php schreiben, die sie an der Stelle, an der die Änderungen gewünscht sind, aufrufen.

Buchführung

Das ist der wichtigste Teil jedweder Änderung, die Sie vornehmen: notieren Sie alle Ihre Änderungen detailliert. Eine einfache Methode ist alle Änderungen in den Programmdateien von CMSimple_XH zu kommentieren. Um diese später leicht wieder finden zu können, können Sie die Kommentare wie folgt schreiben:

// ANPASSUNG: ...

oder für einen Code-Block:

// ANPASSUNG-ANFANG: ...
...
// ANPASSUNG-ENDE

FIXME Weiß jemand ob und wie solche Anpassungen mit einem separaten SVN-Repositorium nachverfolgt werden können?

Allgemein nützliche Änderungen

Wenn Sie davon ausgehen, dass Ihre Änderung auch für andere nützlich sein könnte, stellen Sie diese im Open Development Forum (oder in einem der nicht englischen Foren) vor. Wenn andere Ihre Meinung über die allgemeine Nützlichkeit teilen, stehen die Chancen gut, dass die Änderung in der nächsten Version von CMSimple_XH enthalten sein wird, so dass Sie Ihre Änderungen beim nächsten Update nicht erneut durchführen müssen.

 
Sie befinden sich hier: start » de » customization
Falls nicht anders bezeichnet, ist der Inhalt dieses Wikis unter der folgenden Lizenz veröffentlicht: GNU Free Documentation License 1.3
Valid XHTML 1.0 Valid CSS Driven by DokuWiki