Tipps, die euch das Leben mit Generico einfacher machen
- Entwickelt zuerst auf einer Testinstanz, bevor ihr auf einer Produktivinstanz damit arbeitet.
- Generico bietet keine Versionierung an. Es wäre sinnvoll, die Entwicklung auf GitLab etc. auszulagern, um die Versionen zu speichern.
- Entwickelt die Vorlage (soweit möglich) zuerst (mit Platzhaltern) in normalen Moodle-Textfeldern im Editor. Übertragt sie dann erst in Generico.
- Vorsicht bei CSS und <style>-Tags: Macht keine Anpassungen an globalen Tags wie <p>, <h4> usw. Diese betreffen dann die ganze Seite, die dann ggf. nicht mehr funktioniert! Erstellt für eure Elemente stattdessen eindeutige Klassen (class="generico-betreuerbox") und ändert das CSS dann nur für diese Klasse.
- Verwendet eine IDE (z.B. Visual Studio Code, um den Code insgesamt zu testen. (In Genericotwo ist ein Editor mit Vorschau eingebaut)
- Haltet die Seite im Backend (z.B. /admin/settings.php?section=filter_generico_templatepage_5) geöffnet, wenn ihr eine Vorlage testet. Solltet ihr die Vorlage soweit zerstört haben, dass die Seite, auf der sie eingebettet ist, nicht mehr funktioniert:
- Speichert euch die Vorlage per Bundle-Button
- Löscht den Inhalt der Vorlage (und CSS und JavaScript)
- Speichert die leere Vorlage, damit die Seite wieder funktioniert
- Untersucht den Code in einer IDE
- Fügt nicht nur Variablen in die Vorlage ein. Kapselt diese in <span class="generico-vorlage"> oder ähnlich. Stellt im Theme-CSS ein, dass die Klasse "generico-vorlage" (bzw. so wie ihr sie benannt habt) für Admins im CSS (z.B. durch einen roten gepunkteten Rahmen) umrandet wird. Damit könnt ihr unterscheiden, was Generico ist und was regulärer Text im Kurs. Schaltet ihr auf eine andere Rolle, verschwinden die Markierungen.
