Univention Bugzilla – Bug 26275
Dokumentation zur Erstellung eines UMC-Moduls
Last modified: 2014-06-11 07:25:38 CEST
Für die Entwickler-Doku +++ This bug was initially created as a clone of Bug #23876 +++ Für die Entwicklung eines UMC-Moduls wäre es sehr hilfreich eine Tool zur Verfügung zu stellen, das es erlaubt ein neues UMC-Modul anhand eines Templates zu erstellen. Dazu gibt der Benutzer die grundlegenden Informationen wie Modul-ID, Beschreibungstext etc. an, durch die dann Platzhalter in den Template-Dateien ersetzt werden. Zur Erstellung könnten dann verschiedenen Templates zur Verfügung stehen, in denen dann Python- und JavaScript-Methoden bereits als Dummies mit Dummywerten bereitgestellt werden, bspw.: * Ein Template-Modul mit einem Grid und bereits implementierten Dummy-Methoden für query, remove, set etc. * Ein Template-Modul mit Tabs und verschiedenen Seiten (also mehrere Klassen) * Ein einfaches Modul mit nur einer Seite und einem Formular Das würde sicherlich die Einstiegshürde zur Modulprogrammieren senken und wäre sehr hilfreich für der Dokumentation im Wiki.
*** Bug 26110 has been marked as a duplicate of this bug. ***
Es sollte beschrieben werden, wie mit umc-create-module ein Modul erstellt werden kann und wie die UMC-API-Doku installiert werden kann, in der die Architektur und weitere Funktionen beschrieben werden.
Das ganze kann auch auf Basis dieses Artikels erstellt werden: http://wiki.univention.de/index.php?title=UCS_3.0_UMC_API_for_Modules Der sollte dann anschließend gelöscht werden, bzw. auf die Entwicker-Doku verweisen.
*** Bug 28799 has been marked as a duplicate of this bug. ***
Die Dokumentation aus Bug 26494 sollte ebenfalls integriert werden.
*** Bug 26494 has been marked as a duplicate of this bug. ***
Created attachment 4980 [details] DTD für UMC Module This help to validate the .xml files (and shows, that several new attributes of UCS-3.1 are still unducomented) Relax-NG or XML-Schema would be better, because they're more powerful to describe allowed attribute values and unordered child elemens (flavor<->categories) To check all current UMC-xml-files run the following command from "branches/ucs-3.1": find ucs/management ucs-school -name \*.xml -exec xmllint --dtdvalid ucs/management/univention-management-console/doc/module.dtd --noout {} \;
*** This bug has been marked as a duplicate of bug 31269 ***