Systemweite Templates / Vorlagen

Stack-Vorlagen sind durch die Administration angelegte Strukturen, mit denen alle Lernenden einer Instanz vorbereitete Stacks erhalten – z. B. „Wochenbericht“, „Reflexion zum Praktikum“ oder „Lernfeld Mathematik“. Dieser Abschnitt zeigt, wie Sie als Admin Vorlagen anlegen, verwalten und welche Auto-Mechanismen dabei greifen.

Überblick

Eine Stack-Vorlage (Code: Portfoliotemplate) enthält:

• Titel, Untertitel und Beschreibung als didaktischer Rahmen
• ein Titelbild zur visuellen Wiedererkennung
• einen eindeutigen URI als URL-Bezeichner
• eine Sortierung (sort)

Wenn Sie eine Vorlage anlegen, rollt die Future-Box automatisch einen passenden Stack in jeden existierenden Account aus. Dieser Stack ist mit der Vorlage verknüpft und übernimmt deren Titel, Untertitel und Beschreibung. Lernende können den Stack mit eigenen Memos füllen — ohne den Rahmen ändern zu müssen.

⚠️ Disambiguierung: Stack-Vorlagen (Templates / Portfoliotemplate) in diesem Abschnitt sind nicht zu verwechseln mit den Vorlagen im Sinne von Code-Freigaben (Share / Share). Erstere sind admin-gesteuert und top-down, letztere sind peer-to-peer und code-basiert.

Für wen ist dieser Bereich?

⚙️ Admin / 🛡️ Superadmin mit edit_settings

• Menü: Administration → Stack-Vorlagen
• URL: /administration/portfoliotemplates
• Berechtigung: edit_settings

In der Standardkonfiguration können superadmin (über vererbtes edit_settings) Vorlagen verwalten. Auch admin kann es, sofern edit_settings an die Admin-Rolle vergeben wurde — siehe Rechte & Rollen.

---

Stack-Vorlage erstellen

⚙️ Admin

Schritt-für-Schritt

1. Administration → Stack-Vorlagen öffnen.
2. Auf „Neue Stack-Vorlage“ klicken.
3. Felder ausfüllen:
   • Titel (Pflicht) – z. B. „Wochenbericht 1. Lehrjahr“
   • Untertitel (optional) – Kurzbeschreibung
   • Beschreibung (optional) – Rich-Text mit didaktischem Kontext, Leitfragen, Anweisungen
   • URI (Pflicht) – eindeutiger URL-Bezeichner, z. B. wochenbericht-lj1
   • Sortierung (sort) – Reihenfolge, in der die Vorlage in der Stack-Übersicht der Lernenden erscheint
4. Titelbild wählen — drei Möglichkeiten:
   • Aus Mediathek: vorhandenes Medium auswählen
   • Hochladen + zuschneiden: Bild hochladen, mit Cropper.js Ausschnitt wählen
   • Pfad direkt: bei Legacy-Setups
5. „Speichern“.

Was passiert beim Speichern?

Beim Klick auf „Speichern“ geschieht zweierlei:

1. Vorlage wird angelegt (Datensatz portfoliotemplate).
2. Auto-Rollout: Die Future-Box durchläuft alle existierenden User und legt für jeden einen Stack mit portfoliotemplate_id = (Ihre Vorlage) an. Dabei wird die Sortierung übernommen.

Lernende sehen die Vorlage somit beim nächsten Login automatisch in ihrer Stack-Übersicht im Bereich „System-Stacks“.

💡 Tipp: Pflegen Sie den didaktischen Hinweis in der Beschreibung sorgfältig — er erscheint sowohl im Stack-Detail als auch über das Hilfe-Modal des Stacks. Eine gute Beschreibung erspart viele Rückfragen.

---

Stack-Vorlage bearbeiten

⚙️ Admin

1. In der Vorlagen-Liste auf das Stift-Symbol klicken (oder direkt /administration/portfoliotemplates/{id}/edit).
2. Felder ändern – Titel, Untertitel, Beschreibung, URI, Sortierung, Titelbild.
3. „Speichern“.

Auswirkung auf bestehende User-Stacks

Da User-Stacks die Inhalte dynamisch aus der Vorlage laden (siehe Portfolio::getTitleAttribute() etc.), wirken Änderungen an der Vorlage sofort auf alle damit verknüpften Stacks:

• Neuer Titel → erscheint instant bei allen Lernenden
• Neue Beschreibung → erscheint instant
• Neues Titelbild → erscheint instant

Eigene Memo-Inhalte der Lernenden bleiben dabei unangetastet.

⚠️ Hinweis: Beim Update wird die Auto-Rollout-Logik erneut ausgeführt — Personen, die seit der ursprünglichen Anlage neu hinzugekommen sind, bekommen die Vorlage damit nachträglich zugewiesen.

---

Stack-Vorlage löschen — mit cleverem Auto-Konvertieren

⚙️ Admin

Wenn Sie eine Vorlage löschen, gehen die Inhalte der Lernenden nicht verloren. Stattdessen werden alle damit verknüpften User-Stacks zu eigenständigen Stacks umgewandelt:

1. In der Vorlagen-Liste auf das Lösch-Symbol klicken.
2. Bestätigungsdialog beantworten.
3. Die Future-Box durchläuft alle Stacks, die auf diese Vorlage referenzieren, und für jeden:
   • kopiert Titel, Untertitel, Beschreibung, Sortierung in die User-Stack-Felder selbst
   • dupliziert das Titelbild als eigene Kopie in der Mediathek der jeweiligen Person
   • löst die Verknüpfung (portfoliotemplate()->dissociate())
   • speichert den umgewandelten Stack
4. Anschließend wird das Template gelöscht.

Effekt: Lernende verlieren keinen einzigen Memo-Inhalt; ihre Stacks sind nun freie, editierbare Stacks (Titel, Beschreibung etc. wieder änderbar).

💡 Hinweis: Diese Lösch-Mechanik ist eine besondere Stärke der Future-Box. Sie erlaubt es Admins, Vorlagen-Strukturen ohne Angst um Datenverlust zu rückzubauen oder zu reorganisieren.

---

Default-Stack-Set für neue Nutzer:innen

⚙️ Admin

Über die Funktion „Default-Stack hinterlegen“ können Sie eine Code-Freigabe (Share) als Standard-Vorbestückung neuer Accounts definieren. Beim Anlegen einer neuen Person über die Benutzerverwaltung (mit aktiviertem Häkchen „Stack-Vorlagen importieren“) werden die Stacks/Memos aus dieser Code-Freigabe direkt in den neuen Account kopiert.

Konfiguration

1. Erstellen Sie eine Code-Freigabe Ihrer Wunsch-Stacks (siehe Stacks, Abschnitt „Code-Freigaben“). Notieren Sie den 6-stelligen Code.
2. Im Bereich Stack-Vorlagen den Code im Feld „Default Import-Code“ (default_import_code) eintragen.
3. „Speichern“.

Ab sofort wird beim Anlegen neuer User mit aktiviertem Import-Flag dieser Code aufgerufen und die Inhalte importiert.

⚠️ Hinweis: Die default_import_code-Funktion und das Stack-Vorlagen-System sind zwei unterschiedliche Mechanismen:

• Stack-Vorlage (Portfoliotemplate) — top-down, automatisch ausgerollt, Template-Struktur, Inhalte „dynamisch geerbt“
• Default-Stack-Set (über Share) — wird bei User-Anlage einmalig in den neuen Account kopiert; ist danach unabhängig

Beide können parallel betrieben werden.

---

Wann Stack-Vorlage, wann Default-Stack-Set, wann Code-Freigabe?

Anwendungsfall	Empfohlener Mechanismus
Strukturen, die alle Lernende sehen sollen, zentral pflegbar	Stack-Vorlage (Auto-Rollout, dynamische Vererbung)
Standard-Vorbestückung neuer Accounts	Default-Stack-Set (über Share + default_import_code)
Material, das einzelne Lernende auf Wunsch importieren	Code-Freigabe (siehe Stacks)
Aufgaben mit lock auf den Original-Wortlaut	Memo-Code-Freigabe mit can_edit_trainee = false

---

Hinweise & Tipps

• Vorlagen sparsam einsetzen: Eine geringe Anzahl gut gewählter Vorlagen erleichtert Lernenden die Orientierung. Zu viele System-Stacks können den Bereich überladen wirken lassen.
• URI eindeutig wählen: Der URI taucht in der Adresszeile auf und sollte keine Sonderzeichen enthalten. Empfehlung: nur Kleinbuchstaben, Zahlen und Bindestriche.
• Sortierung in 10er-Schritten: Setzen Sie sort mit Lücken (10, 20, 30 …), damit später Vorlagen dazwischen einsortiert werden können.
• Titelbild auswählen: Aussagekräftige Titelbilder helfen Lernenden, Vorlagen schnell zu erkennen — gerade in Berufsbildungs-Kontexten mit vielen ähnlichen Stacks.
• Vorlage testen: Legen Sie nach dem Erstellen einen Test-Account an und prüfen Sie, wie die Vorlage in der Stack-Übersicht erscheint.
• Renaming und Vorlagen kombinieren: Wenn Sie planen, „Stack“ zu „Lernfeld“ umzubenennen, formulieren Sie auch die Vorlagen-Beschreibungen entsprechend.
• Auto-Konvertierung als Refactoring-Werkzeug: Wenn Ihre didaktische Struktur sich ändert, können Sie alte Vorlagen gefahrlos löschen — Inhalte bleiben erhalten und werden zu eigenständigen Stacks.

Verwandte Bereiche

• Stacks – wie Lernende Stack-Vorlagen wahrnehmen und Code-Freigaben („Vorlagen“) erstellen
• Memos – die Inhalte, die in System-Stacks gepflegt werden
• Administration – Erstkonfiguration einer Instanz
• Benutzerverwaltung – Default-Stack-Set beim User-Anlegen
• Systemkonfiguration – default_import_code, Renaming, Theme
• Rechte & Rollen – edit_settings und edit_all_templates
• Terminologie – Begriffsklärung Stack-Vorlage vs. Vorlage / Code-Freigabe