Wie klone ich ein Xoops- Modul ?
Es kommt vor, daß man liebgewonnene Module mehrfach verwenden möchte. Dieses "Doppeln" nennt sich fachdeutsch "Klonen".

Dabei aber bitte immer darauf achten, dass der ursprüngliche Autor eines Moduls auch weiterhin erwähnt bleibt (ist meist in den Quelltexten angegeben), selbst wenn man umfangreiche Änderungen vornimmt. Natürlich kann man sich mit dazuschreiben, aber Respekt gegenüber den eigentlichen "Vorfahren" des Moduls muß einfach sein. Open Source heisst nicht "Klau was du willst", sondern: "guck ab und entwickle es weiter" :)

Schreiten wir zur Tat: nehmen wir an, ich habe Modul Bla und möchte Modul Blub draus machen:

1. Daten sichern. Ab jetzt betrittst Du Niemandsland, das Dein bisheriges Xoops schrotten kann.

2. modules/bla Ordner duplizieren und das Duplikat in modules/blub umbenennen.

3. im kompletten blub Verzeichnis (inkl. Unterverzeichnissen) alles, was "bla" heisst, gegen "blub" austauschen, das gilt sowohl für ...

a) die Dateinamen: dabei auch auf die Templates (falls vorhanden) und Block-Templates in modules/blub/templates achten.

b) die Datei-Inhalte: dazu am besten einen Editor wie z.B. Scribe verwenden, der "Erweitertes Suchen und Ersetzen" unterstützt, d.h. in allen Dateien eines Ordners (und dessen Unterordnern) automatisch alle Inhalte untersucht und austauscht. Dabei darauf achten, dass wirklich in allen Dateien gesucht und ersetzt wird (php, inc, sql usw.). Die Suchmaske dafür lautet: *.html;*.txt;*.php;*.inc;*.sql;*.tpl;

4. Sprachangaben (siehe languages/(sprache)/modinfo.php etc.) checken. Alle Sprachkonstanten (define ...) müssen eindeutig dem BLUB Modul zuzuordnen sein und nicht mehr auf BLA verweisen. Hier kann es sein, dass die Bezeichner noch manuell angepasst werden müssen. Dann muss wiederum durch alle blub-Moduldateien ein Suchen und Ersetzen auf die korrekte(n) Sprachkonstante(n) stattfinden, damit alle Bezüge korrekt sitzen.

5. Das Logo-Image in /modules/blub/images an blub-Modul ändern, damit im Admin später die Module schnell zu unterscheiden sind. Am besten das vorhandene Logo mit irgendeiner Bildbearbeitung öffnen und umgestalten. Aber auch hier nicht einfach das vorhandene Logo mit einem neuen Text "bepappen", sondern im Stil der Xoops Modul Logos (Gelb/Weiss) irgendwas eigenes entwerfen. Gute Logos haben zum einen den Wiedererkennungseffekt für manche Autoren (wie das baerchn bei meinen Modulen) und sind auch ein Haufen Arbeit, bitte respektiert das.

6. Zum Schluss die /modules/blub/xoops_version.php checken, ob jetzt alle darin enthaltenen Bezüge zu den blub Dateien stimmen.

7. Upload und Installation in Live-Version (FTP auf Server, dann Admin > Module > Modul installieren). Wenn die Installation eine Fehlermeldung erzeugt, wurde vermutlich irgendeine Umbenennung vergessen: also genau auf die Fehlermeldung achten und entsprechend korrigieren.

8. Ärgern, weil man was vergessen hat, dann nochmal machen (meistens) - korrigieren und sich schliesslich freuen :)))

Wenn was nicht funktioniert: im Admin > Voreinstellungen den Debug-Modus einschalten und die Seite nochmal aufrufen, dann erhält man meist gute Informationen (falls nicht sogar schon vorher eine konkrete Fehlermeldung erschien). Wenn man Pech hat, werden geklonte Funktionen doppelt angesprochen ("Cannot redeclare ..."), dann muss man tiefer eingreifen.

Im Zweifelsfall die Fehlermeldung im Forum posten und um Hilfe bitten. Bei so konkreten Angaben bekommt man die meist sehr schnell und ausführlich.

Happy Coding! baerchn
http://www.baerenbuch.de

StormCrow schrieb:

Ich hab es schon probiert mit einem Text Editor alles von xcgal in xcgal2 umzubenennen allerdings bekomme ich dann nach der inst. nur eine weisse seite.