Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- praxistipps:untis:start [10.05.2013 21:11]
Frank Schiebel [Plugin konfigurieren]
+++ praxistipps:untis:start [12.12.2018 15:54] (aktuell)
@@ Zeile 3: / Zeile 3: @@
 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.
-<note warning>**Achtung:** Das Plugin ist wirklich noch **experimentell**, bitte installieren und probieren Sie es nur aus, wenn Sie bei der Entwicklung mithelfen möchten. Gefahr für Ihre übrigen Portfoliodaten besteht nicht.</note>
+<note warning>**Achtung:** Das Plugin ist noch **in der Testphase**, Bitte installieren und probieren Sie es nur aus, wenn Sie bei der Entwicklung mithelfen möchten. Gefahr für Ihre übrigen Portfoliodaten besteht nicht.</note>
+Das Plugin kann [[https://github.com/ironiemix/dokuwiki-untis/archive/master.zip|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 oder in einer linuxmuster.net Installation verwenden, müssen Sie die Datei ins Verzeichnis ''/usr/share/linuxmuster-portfolio/'' kopieren.
 ===== Voraussetzungen =====
@@ Zeile 33: / Zeile 35: @@
   {{untis>aula}}
-sein, Im ersten Fall wird die Lehrerzimmerversion angezeigt, im zweiten die Schülerversion der Vertretungspläne. Weitere Eintragungen sind nicht nötig, nach dem Speichern der Seite erscheint eine Fehlermeldung (oder eine leere Seite).
+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).
 {{ :praxistipps:untis:auswahl_608.png |}}
@@ Zeile 49: / Zeile 51: @@
   - Dann geben Sie die Datei an, in die das gezippte Planarchiv nach dem Upload verschoben werden soll. Hier muss der ganze Dateiname angegeben werden. Die Schreibweise muss im "DokuWiki"-Stil sein, Verzeichnisse müssen also durch Doppelpunkte getrennt werden.
   - Als nächstes geben Sie das Verzeichnis an, in dem die zip-Datei entpackt werden soll. Beachten Sie, dass alle Unterverzeichnisse, die sich in Ihrer zip-Datei befinden dorthin ausgepackt werden.
+  - Setzen Sie das Häkchen bei "Ersetzugsliste im Cache-Verzeichnis speichern?".
-  - Setzen Sie das Häkchen bei Debugging, dass man dann später erst mal sehen kann, was passiert.
+  - Setzen Sie das Häkchen bei "Ausgaben zur Fehlersuche an/ausschalten", dass man dann später erst mal sehen kann, was passiert.
+  - Optional können Sie bei (7) und (8) noch Spalten von der Anzeige ausnehmen.
 ====== Arbeiten am Verwaltungsrechner ======
@@ Zeile 85: / Zeile 88: @@
   * Ein Batchskript, welches konfigurierbar ist und dann den Rest erledigt
-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 ''untis2osp.bat'' an die eigenen Bedürfnisse und Gegebenheiten anpassen:
+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
@@ Zeile 107: / Zeile 110: @@
   set EXPORTDIR=E:\untis plan\Export\
-Die Kommentare und Vorgaben sollten hier hilfreich sein, besonders wichtig ist, dass als BEASEDIR der Pfad des vplan2pf2-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.
+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.
 ====== Testen im Portfolio ======
@@ Zeile 118: / Zeile 121: @@
 {{ :praxistipps:untis:auswahl_612.png |}}
+====== Ersetzungen definieren ======
+Das Plugin bietet die Möglichkeit, Zeichenketten im Text automatisch bei der Anzeige ersetzen zu lassen und dabei auch farbige Kodierungen anzubringen.
+{{ :praxistipps:untis:auswahl_619.png|}}
+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
+<code>
+Nummer  Suchmuster|Ersetzung|CSS-Klasse|Spaltennummer
+</code>
+  * Die Nummern der Ersetzungsregeln dürfen nur einmal vorkommen, andernfalls überschreibt die in der Datei weiter unten festgelegte Regel die zuerst definierte. Die Nummern müssen nicht fortlaufend sein.
+  * Die CSS-Klasse ist optional und kann auch weggelassen werden. Wenn eine Klasse angegeben wird, wird der Text in ein //span//-Element mit der angegebenen Klasse eingebettet. Vordefinierte Klassen sind ''green'', ''orange'', ''red'' und ''blue''. Bei diesen wird ein kleines Quadrat in der entsprechenden Farbe vor dem ersetzten Text platziert.
+  * Die Spaltennummer ist optional. Ist Sie angegeben, werden nur in der angegebenen Spalte Ersetzungen vorgenommen. Wenn keine CSS Klasse gewünscht ist und dennoch eine Spaltennummer spezifiziert werden soll, muss die durch eine "leere" CSS Klasse geschehen: zwei Senkrechte nacheinander. Wenn in der Plugin-Konfiguration Spalten von der Anzeige ausgenommen wurden, müssen diese trotzdem weiterhin mitgezählt werden! Spalte 7 ist also stets die 7. Spalte in der Original Untis HTML Ansicht.
+===== Beispiele =====
+   Vertretung   | Vertr. | red
+   Vormerkung   | Vorm.  | | 7
+   Entfall      | (f.a.) | green | 7
+   Betreuung    | Betr,  | orange
+  * **Regel 1:** Ersetze "Vertretung" durch "Vertr." und stelle ein rotes Quadrat voran.
+  * **Regel 2:** Ersetze "Vormerkung" durch "Vorm.", keine Farbcodierung, nur ersetzen, wenn "Vormerkung" in der 7. Spalte des Untis HTML-Exports gefunden wird.
+  * **Regel 3:** Ersetze "Entfall" durch "(f.a.)" und stelle ein grünes Quadrat voran, aber nur in der 7. Spalte.
+  * **Regel 4:** Ersetze "Betreuung" durch "Betr," mir oranger Markierung.
+Das Ergebnis sieht in etwa so aus:
+{{ :praxistipps:untis:auswahl_620.png?800 |}}

open | Schulportfolio

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge