Kurselemente

Komponente tiny_elements · Version 1.0.1

Einsatz und Zielgruppe

Kurselemente richtet sich an zwei Gruppen:

• Die Administration oder ein Designteam legt Bausteine an und pflegt sie. Dafür sind Kenntnisse in HTML und CSS nötig.
• Lehrende fügen die Bausteine im Editor ein, ohne HTML zu kennen.

Das Plugin stammt vom ISB Bayern (bycs-lp) und ist ein Fork von Components for Learning (tiny_c4l). Es ist auf moodle.org veröffentlicht und hat den Reifegrad Beta.

Einrichtung

1. Installieren Sie das Plugin unter lib/editor/tiny/plugins/elements.
2. Wir empfehlen zusätzlich das Plugin editor_codemirror. Es macht das Bearbeiten von HTML und CSS in der Verwaltung deutlich angenehmer.
3. Öffnen Sie die Verwaltung unter /lib/editor/tiny/plugins/elements/management.php.
4. Importieren Sie bei Bedarf die mitgelieferten Vorlagen aus db/base.zip.

Über das Recht tiny/elements:viewplugin legen Sie fest, welche Rollen die Bausteine im Editor sehen.

Der Aufbau

• Kategorie: bündelt Bausteine. Sie hat einen internen Namen, einen Anzeigenamen, eine Reihenfolge, gemeinsames CSS und Dateien wie Bilder oder Schriften.
• Baustein: HTML und CSS, das beim Klick in den Editor eingefügt wird. Jeder Baustein gehört zu genau einer Kategorie.
• Stil (Flavor): eine Unterform einer Kategorie mit eigenem CSS, etwa eine Farbvariante. Bausteine werden mit Stilen verbunden.
• Variante: bis zu drei pro Baustein, einzeln ein- und ausschaltbar, etwa mit Rahmen oder mit Hintergrund.

Einen Baustein anlegen

1. Legen Sie eine Kategorie an. Vergeben Sie einen eindeutigen internen Namen in Kleinbuchstaben ohne Leerzeichen, etwa hochschule. Er wird Teil der CSS-Klassen.
2. Laden Sie Bilder für die Kategorie hoch. SVG ist empfohlen.
3. Legen Sie einen Baustein an, etwa hochschule-merksatz, mit Anzeigename, HTML und CSS.
4. Verbinden Sie ihn bei Bedarf mit Stilen und legen Sie Varianten an.
5. Prüfen Sie das Ergebnis im Editor.

Kategorien und Bausteine erhalten das Präfix elements-. Wählen Sie Namen sorgfältig, besonders wenn Sie Vorlagen mit anderen teilen.

Bausteine einfügen

Lehrende klicken im Editor auf die Schaltfläche Elements, wählen eine Kategorie und einen Baustein. Er wird an der Cursorposition eingefügt. Danach ersetzen sie den Platzhaltertext. Eine Vorschau beim Überfahren lässt sich abschalten.

Empfehlungen für den Betrieb

Beginnen Sie mit den mitgelieferten Vorlagen und passen Sie Farben und Schriften im CSS der Kategorie an. Das ist schneller als ein Neuanfang und zeigt, wie Bausteine aufgebaut sind.

Führen Sie neue Bausteine zuerst auf einem Testsystem ein und exportieren Sie die fertige Kategorie, um sie auf die Produktivplattform zu übertragen. So bleibt die Produktivplattform frei von Zwischenständen.

Halten Sie die Zahl der Bausteine überschaubar und beschreiben Sie in einer kurzen Hilfeseite, wofür jeder gedacht ist. Prüfen Sie neue Bausteine auch auf Kontraste und Lesbarkeit, bevor Sie sie freigeben.

Datenschutz

Das Plugin speichert keine personenbezogenen Daten. Bausteine und Dateien gehören zur Plattform, nicht zu Personen.

Grenzen

• Das Anlegen von Bausteinen erfordert HTML- und CSS-Kenntnisse.
• Ändern Sie das CSS einer Kategorie, ändert sich die Darstellung in allen Kursen. Das HTML bereits eingefügter Bausteine bleibt unverändert.
• Das Plugin hat den Reifegrad Beta.
• Bausteine enthalten frei definierbares HTML. Geben Sie die Verwaltung nur wenigen, vertrauenswürdigen Personen.

FAQ und Fehlerbehebung

Ein Baustein sieht im Kurs anders aus als in der Vorschau. Das Theme überschreibt Teile des CSS. Machen Sie die Selektoren in der Kategorie genauer.

Bilder fehlen nach einem Import. Prüfen Sie, ob die Dateien zur Kategorie gehören. Bausteine sollten keine Dateien aus anderen Kategorien verwenden.

Die Schaltfläche fehlt im Editor. Ihrer Rolle fehlt das Recht tiny/elements:viewplugin.