LernHive Vorlagen

Was dieses Plugin macht

LernHive Vorlagen ist das gemeinsame Zuhause für die Mail- und Dokumentausgaben, die Ihre LernHive-Plattform erzeugt: Buchungsbestätigungen, Zertifikate, Bescheide und ähnliche Artefakte. Es zentralisiert Layouts (Logo, Header, Footer, Rechtstext) und Vorlagen-Inhalte mit Platzhaltern, sodass jedes Plugin konsistente, gebrandete Ausgaben sendet statt fest verdrahteter Texte. Im aktuellen Release liefert das Plugin den Übersichts-Arbeitsbereich, die globalen Fallback-Einstellungen, die zugrunde liegende Rendering-Engine und eine capability-geschützte Verwaltungsoberfläche für Layouts und Vorlagen.

Für wen ist es

Rolle	Was sie tut
Plattform-Administration	Öffnet den Vorlagen-Arbeitsbereich, um zu sehen, welche Vorlagen-Bereiche existieren (Mail, DOCX, PDF, Variablen)
Site-Administrator (eLeDia)	Setzt den globalen Fallback-Absendernamen und den rechtlichen Footer; erreicht den Arbeitsbereich über die Website-Administration

Lernende, Führungskräfte und Trainer/innen interagieren nie direkt mit diesem Plugin — sie erhalten nur die Mails und Dokumente, die andere LernHive-Plugins darüber erzeugen.

Kernkonzepte

Layout

Ein wiederverwendbarer Rahmen um erzeugte Ausgaben: Logo-Platzierung, Header, Footer und Rechtstext. Ein Layout kann viele Vorlagen bedienen, sodass ein Rebranding an einer Stelle geschieht.

Vorlage

Der Inhalt einer konkreten Ausgabe — zum Beispiel eine Buchungsbestätigungs-Mail oder ein Zertifikatsdokument. Vorlagen gehören dem Plugin, das sie versendet (Seminarmanagement, Zertifikate, Lernpfade), und existieren pro Ausgabeformat.

Platzhalter (Token)

Vorlagen verwenden Platzhalter in doppelten geschweiften Klammern mit Punktpfaden, zum Beispiel:

Hello {{participant.fullname}},
your seminar {{seminar.title}} starts on {{slot.startdate}}.

Platzhalter werden zum Sendezeitpunkt mit echten Werten gefüllt. Ein Platzhalter ohne Wert wird als leerer Text gerendert — alte Vorlagen funktionieren weiter, wenn neue optionale Variablen hinzukommen. Platzhalter fügen nur Werte ein; sie können keine Logik, Bedingungen oder Schleifen enthalten.

Ausgabeformat

Vier Formate sind definiert: HTML-Mail, Klartext-Mail, PDF und DOCX. Im aktuellen Release werden die Mail-Formate als Text gerendert und DOCX als echte Word-Datei; die PDF-Erzeugung ist geplant, nicht im aktuellen Release.

Abläufe nach Rolle

Plattform-Administration: den Vorlagen-Arbeitsbereich sichten

Öffnen Sie /local/lernhive_templates/index.php (oder folgen Sie dem Link LernHive Vorlagen unter Website-Administration → Plugins → Lokale Plugins).
Die Seite LernHive Vorlagen öffnet sich mit der Unterzeile Gemeinsame Mail- und Dokumentvorlagen für LernHive-Plugins.
Prüfen Sie die vier als Karten dargestellten Arbeitsbereiche: Mail-Layouts, DOCX-Vorlagen, PDF-Vorlagen und Variablen.
Öffnen Sie DOCX-Vorlagen, um eine kundenseitige DOCX-Vorlage hochzuladen oder zu ersetzen, oder verwalten Sie gemeinsame Vorlagen mit der entsprechenden Berechtigung.

Plattform-Administration: DOCX-Vorlage hochladen oder ersetzen

Öffnen Sie im Vorlagen-Arbeitsbereich die Karte DOCX-Vorlagen.
Geben Sie die besitzende Komponente, den stabilen Vorlagenschlüssel und einen Anzeigenamen ein.
Laden Sie genau eine .docx-Datei hoch und speichern Sie. Ein späterer Upload für dieselbe Komponente und denselben Schlüssel ersetzt das aktuelle Paket.
Verwenden Sie die zurückgegebene Vorlagen-ID beim Aufruf der Rendering-API, damit die erzeugte DOCX-Ausgabe das importierte Paket nutzt.

Die Pakete müssen gültige DOCX-Dateien ohne Makros sein. Unsichere ZIP-Pfade, externe XML-Entitäten und zu große Pakete werden abgewiesen.

Plattform-Administration: Layouts und Vorlagen verwalten

Öffnen Sie den Arbeitsbereich und wählen Sie einen Layout- oder Vorlagenbereich.
Wählen Sie Layout hinzufügen oder Vorlage hinzufügen, um eine Ressource anzulegen, oder das Bearbeiten-Symbol einer bestehenden Zeile.
Geben Sie Name, Ausgabeformat und Inhalt ein. Vorlagen benötigen zusätzlich die zuständige Moodle-Komponente und einen stabilen Vorlagenschlüssel.
Speichern Sie das Formular. Über das Löschen-Symbol und die Moodle-Bestätigungsseite können Sie eine nicht gesperrte Ressource entfernen. Ein verwendetes Layout und eine gesperrte Vorlage können nicht gelöscht werden.

Site-Administrator (eLeDia): die globalen Fallbacks konfigurieren

Gehen Sie zu Website-Administration → Plugins → Lokale Plugins und öffnen Sie Vorlagen-Einstellungen.
Setzen Sie Standard-Absendername — der Fallback-Absendername, den Plugins verwenden, die keinen eigenen Absendernamen liefern.
Setzen Sie Standard-Impressum — der Fallback-Rechtstext für generierte Mail- und Dokumentlayouts, wenn kein layout-spezifischer Footer gesetzt ist.
Speichern Sie die Änderungen. Die Werte greifen für Ausgaben, die über die Vorlagen-Engine erzeugt werden.

Site-Administrator (eLeDia): den Arbeitsbereich aus der Website-Administration öffnen

Gehen Sie zu Website-Administration → Plugins → Lokale Plugins.
Klicken Sie auf LernHive Vorlagen, um den Übersichts-Arbeitsbereich zu öffnen.
Nutzen Sie das Einstellungs-Symbol im Seitenkopf, um direkt zu den Vorlagen-Einstellungen zu springen.

Relevante Einstellungen

Einstellung	Wo	Wirkung
Standard-Absendername	Website-Administration → Plugins → Lokale Plugins → Vorlagen-Einstellungen	Fallback-Absendername für Plugins, die keinen eigenen setzen (Default: `LernHive`)
Standard-Impressum	dieselbe Seite	Fallback-Rechtstext für generierte Mail- und Dokumentlayouts ohne layout-spezifischen Footer
Freigegebene Absender-Domains	dieselbe Seite	Eine extern für SPF/DKIM/DMARC geprüfte Domain je Zeile; aktive Academy-Profile müssen eine davon verwenden
Mails, die eine Person auslöst, senden als	Vorlagen-Einstellungen (Zahnrad im Seitenkopf des Arbeitsbereichs)	Die Person (Standard): Die Person ist Absender/in, ihre Adresse die Reply-To-Adresse. No-Reply mit Reply-To auf die Person: Die Mail kommt von der No-Reply-Adresse oder mit der Identität des Academy-Mailprofils, Antworten gehen an die Person. No-Reply wählen, wenn die Mail-Domains der Personen diesen Server nicht erlauben (SPF, DMARC); siehe Hilfe-Symbol sowie Moodles `allowedemaildomains` und `emailfromvia`

Beide Einstellungen erfordern Site-Administrator-Zugriff; im aktuellen Release gibt es keine kundenseitig anpassbaren Einstellungen unterhalb der Plattformebene.

Grenzen

Mailprofile für Academies

Im Abschnitt Mailprofile kann eine berechtigte Administration eine Academy-Kurskategorie auswählen, getrennte HTML- und Klartext-Layouts zuweisen, Absendername, From- und Reply-To-Adresse pflegen und das Profil aktivieren. Kurs- und Seminarkommunikation erbt das nächste aktive Profil aus der primären Kategorie. Systemmails, für die das Profil greift (Automatisierungsregeln, Erinnerungen, geplante Aufgaben, automatische Bestätigungen), kommen mit Absendername und Absenderadresse des Profils und dessen Reply-To; Mails, die eine Person auslöst, behalten diese Person als Absender/in (oder No-Reply mit Reply-To auf die Person, siehe Mails, die eine Person auslöst, senden als). Moodle sendet nur dann von der Profiladresse, wenn ihre Domain in Moodles allowedemaildomains steht, sonst von der No-Reply-Adresse der Website mit dem Absendernamen des Profils. Die Aktivierung wird abgelehnt, wenn die From-Domain nicht in der Liste freigegebener Absender-Domains steht. Vorschau zeigt Absender sowie isolierte HTML- und Klartext-Beispiele. Das Zustellungs-Audit zeigt den unveränderlichen Profil- und Quellen-Snapshot erfolgreicher Courseflow- und Seminar-Zustellungen. Berechtigte Seminarmanager/innen können auf der Seite Buchungs-Mailvorlagen zusätzlich ein Seminar-Standardprofil und ein Run-spezifisches Profil wählen. Über Änderungshistorie bleibt für jedes Erstellen, Ändern und Löschen ein vollständiger Snapshot einschließlich der handelnden Person erhalten.

Eingeschränkte Vorlagenverwaltung. DOCX-Upload und -Ersetzung sowie Layout-/Vorlagen-CRUD und die Academy-Profilvorschau sind verfügbar. Die Provider-Registrierung ist weiterhin geplant.
Noch keine Variablen-Registrierung. Variablen sind im Schema vorgesehen, die Provider-Registrierung ist als TPL-007 geplant.
Teilweise Producer-Anbindung. Courseflow und Seminarmanagement verwenden Academy-Mailprofile. Zertifikate und Lernpfade nutzen diesen Mailprofil-Pfad noch nicht.
PDF-Ausgabe wird nicht erzeugt. PDF existiert nur als Format-Schlüssel; im aktuellen Release wird keine PDF-Datei erzeugt.
DOCX-Ausgabe hängt von der Quelle ab. Ohne importierte Vorlage enthalten generierte Word-Dateien einen fettgedruckten Titel und Textabsätze. Importierte DOCX-Pakete behalten Bilder, Tabellen, Header, Footer und Formatvorlagen; unterstützte Platzhalter in Word-Textteilen werden beim Rendern ersetzt.
Platzhalter sind reine Werte. Kein bedingter Text, keine Schleifen und keine Berechnungen innerhalb von Vorlagen.

Fehlerbehebung

„Zugriff verweigert" beim Öffnen des Arbeitsbereichs. → Prüfen Sie, ob Ihre Rolle die Fähigkeit Gemeinsame Mail- und Dokumentvorlagen ansehen (local/lernhive_templates:view) enthält. Standardmäßig ist sie dem Manager-Archetyp gewährt — und damit der Moodle-Rolle Manager (Plattform-Administration).

Eine Karte auf der Übersichtsseite öffnet keine Verwaltungsseite. → Die Karte Variablen bleibt bis zur Provider-Registrierung informativ. Die Karten für Mail, DOCX und PDF öffnen die passende Verwaltungsansicht.

Ein Platzhalter in einer Vorlage bleibt leer. → Platzhalter werden als leerer Text gerendert, wenn kein Wert verfügbar ist. Prüfen Sie die Schreibweise des Platzhalters — sie muss exakt einem bereitgestellten Variablenpfad wie participant.fullname entsprechen (nur Buchstaben, Ziffern, Punkte, Bindestriche und Unterstriche).

Der Standard-Absendername oder das Standard-Impressum erscheint nicht in ausgehenden Mails. → Diese Einstellungen sind Fallbacks, die nur für Ausgaben über die Vorlagen-Engine verwendet werden. Mails von Plugins, die die Engine noch nicht übernommen haben, bleiben unberührt. Prüfen Sie außerdem, ob ein layout-spezifischer Footer den Default übersteuert.

„Vorlagen-Einstellungen" sind nicht auffindbar. → Die Einstellungsseite ist nur für Site-Administratoren sichtbar, unter Website-Administration → Plugins → Lokale Plugins → Vorlagen-Einstellungen.

Handbuch