Dies ist eine alte Version des Dokuments!
Auf vielfachen Wunsch habe ich ein Plugin geschrieben, das Untis Vertretungspläne der Lehrer innerhalb des Portfolios anzeigen kann. Da ich selbst keinen Zugriff auf Untis habe, benötige ich an dieser Stelle möglicherweise Ihre Hilfe, um das Plugin zu verbessern und die Dokumentation verständlich zu formulieren.
Das Plugin kann hier heruntergeladen werden. Die Installation erfolgt wie bei DokuWiki Plugins üblich. Wenn Sie die Pläne mit dem weiter unten beschriebenen Batch Skript ins Portfolio laden wollen, müssen Sie außerdem die Datei curlupload.php
aus dem Plugin-Verzeichnis ins Basisverzeichnis Ihrer Portfolioinstallation kopieren.
(Achtung: Wenn Sie das Debian-Paket in einer PaedML4/5/linuxmuster.net 6 Installation verwenden, müssen Sie die Datei ins Verzeichns /usr/share/linuxmuster-portfolio/
kopieren)
Sie müssen für GP Untis das Info-Modul lizenziert haben.
Export
werden auf dem Verwaltungsrechner in eine zip-Datei gepackt und mit Hilfe des Programms curl
ins Portfolio hochgeladen. Das kann man in einer Batch Datei automatisiert oder auf „Doppelklick“ erledigen (lassen).Nach der Installation des Plugins legen sie zuerst eine Seite im Portfolio an, auf der der Plan später angezeigt werden soll:
Der Inhalt der neuen Seite muss nur
{{untis>lehrer}}
oder
{{untis>aula}}
sein, Im ersten Fall wird die Lehrerzimmerversion angezeigt, im zweiten die Schülerversion der Vertretungspläne. Man sollte nicht beide Ausgaben auf einer Seite unterbringen, wie im Screenshot zu sehen, wenngleich das prinzipiell möglich ist. Weitere Eintragungen sind nicht nötig, nach dem Speichern der Seite erscheint eine Fehlermeldung (oder eine leere Seite).
Wechseln Sie nach Admin→Konfiguration
und dort in den Abschnitt Untis Plugin-Konfiguration
.
untis:plandateien
ausgepackt werden soll, finden Sie ihre Plandateien nach dem Auspacken z.B. im Verzeichnis untis:plandateien:export:lehrer_heute:subst001.htm
- und das muss in der Konfiguration auch angegeben werden.Nun muss ein erster Plan ins Portfolio geschafft werden. Dazu muss das Exportverzeichnis gezippt und ins Portfolio geschoben werden:
Hochschieben ins Portfolio wird mit CURL erledigt, das sollte auch durch die meisten Firewalls funktionieren:
Damit das klappt, muss bei der CURL Kommandozeile das zuvor im Portfolio festgelegte Kennwort als Parameter mit übergeben werden:
curl -k -F filedata=@Public.zip https://www.deinserver.irgendwo/curlupload.php -F secret="geheimgeheimiy7Ohng"
Anmerkung: Man kann die zip-Datei natürlich auch „von Hand“ über den Medienmanager an die konfigurierte Stelle ins Portfolio hochladen - aber will man das wirklich x-Mal am Tag machen?
Damit das alles weniger kompliziert ist, habe ich alle benötigten Werkzeuge eingepackt:
Dieses Archiv enthält:
Die „Installation“ erfolgt durch einfaches Auspacken an eine beliebige Stelle (darf auch auf einem Netzlaufwerk sein). Nach dem Auspacken, muss man die Variablen in der Datei vplan2pf.bat
an die eigenen Bedürfnisse und Gegebenheiten anpassen:
rem Installationsverzeichnis der Batch Dateien set BASEDIR=C:\DOKUME~1\ADMINI~1\Desktop\vplan2pf rem Kennwort zum Upload, wie in der rem Konfiguration des Untis-Plugins eingestellt set SECRET=GeheimGeheimSupergeheim rem Vollständige URL des Uploadscripts, wenn möglich rem https verwenden set UPLOADURL=https://www.meinportfolioserver/portfolio/curlupload.php rem Proxy zur Verbindung ins Internet. Aus dem SVN via Belwue funtioniert rem die folgende Einstellung. rem Bei Bedarf "rem" entfernen und einstellungen anpassen: rem -x IP_Adresse_des_Proxys:ProxyPort rem set PROXY=-x 129.143.4.2:8080 rem Vollständiger Pfad zum Verzeichnis, das eingepackt werden soll set EXPORTDIR=E:\untis plan\Export\
Die Kommentare und Vorgaben sollten hier hilfreich sein, besonders wichtig ist, dass als BEASEDIR der Pfad des vplan2pf-Verzeichnisses angegeben wird. In den meisten Fällen wir aus das Setzen den Proxy Option unumgänglich sein, da man aus dem Schulverwaltungsnetz ohne Proxy nicht ins Internet gelangt.
Wenn der Upload geklappt hat, sollte bei korrekter Konfiguration bei Aufruf der Untis-Portfolioseite eine Ausgabe wie die folgende zu sehen sein - und unter den Debugausgaben der Vertretungsplan.
Wenn das soweit klappt, gehen Sie nochmals in die Konfiguration und entfernen Sie das Häkchen bei der Debug Option - nun sollten die Kontrollausgaben verschwinden.
Das Plugin bietet die Möglichkeit, Zeichenketten im Text automatisch bei der Anzeige ersetzen zu lassen und dabei auch farbige Kodierungen anzubringen.
Dazu navigieren Sie nach
Admin→Weitere Plugins→Untis Plugin
.
Auf der dann folgenden Seite können Sie Ersetzungen definieren, die in der Studenplananzeige automatisch vor der Ausgabe des Vertretungsplans vorgenommen werden, um z.B. sehr lange Lehrernamen abzukürzen oder bestimmte Ereigniskategorien mit einer der vordefinierten CSS-Klassen hervorzuheben.
Das Format ist
Nummer Suchmuster|Ersetzung|CSS-Klasse|Spaltennummer
green
, orange
, red
und blue
. Bei diesen wird ein kleines Quadrat in der entsprechenden Farbe vor dem ersetzten Text platziert.1 Vertretung | Vertr. | red 2 Vormerkung | Vorm. | | 7 3 Entfall | (f.a.) | green | 7 4 Betreuung | Betr, | orange
Das Ergebnis sieht in etwa so aus: