Docs
Docs
Allesda
DE | EN
Plugins
Allesda
DE | EN
Plugins

TEMPLATING

Dokumentation
Zurück

TEMPLATING

Wofür ist das?

Mit TEMPLATING verwalten Sie Vorlagen (z.B. für Vertrags-PDFs).

Eine Vorlage legt fest:

  • Welcher Text wo steht (Anrede, Klauseln, AGB)
  • Welche Datenfelder eingesetzt werden (Mieter-Name, Vertrags-Nummer, Inventarliste …)
  • Optional: spezielle Inventar-Zeilen / Layout-Bausteine

Aktuell ist Templating vor allem auf VERTRAG-PDFs ausgerichtet, kann aber für weitere Templates genutzt werden, sobald sie hinzukommen.

Typische Aufgaben (Alltag)

  • Eine Vorlage anlegen
  • Vorlage als Standard markieren
  • Vorlage in der Vorschau ansehen
  • Mehrere Varianten verwalten (z.B. „Vertrag deutsch“ vs. „Vertrag englisch“)

Schritt-für-Schritt

1) Vorlagen-Liste öffnen

  • Admin → Templating (/settings/admin/templating).

2) Neue Vorlage anlegen

1. „Neu“ (/settings/admin/templating/new).
2. Felder ausfüllen:

  • Name
  • Typ (z.B. Vertrag)
  • Body / HTML mit Platzhaltern

3. Speichern (POST /settings/admin/templating).

> Verfügbare Platzhalter hängen vom Typ ab. Beispiel für Vertrag: {{vertrag.id}}, {{mieter.name}}, {{inventar}}. Wenn Sie unsicher sind: Vorschau benutzen.

3) Vorlage bearbeiten

  • Eintrag öffnen (/settings/admin/templating/{id}/edit) → Speichern (POST /settings/admin/templating/{id}).

4) Vorlage als Standard markieren

  • Pro Typ kann genau eine Vorlage als Standard markiert werden.
  • POST /settings/admin/templating/{id}/default.
  • Diese wird beim PDF-Generieren benutzt, wenn keine andere ausgewählt ist.

5) Vorlage löschen

  • POST /settings/admin/templating/{id}/delete.
  • Standard-Vorlagen können nicht gelöscht werden, ohne vorher eine andere als Standard zu wählen.

6) Vorschau

  • POST /settings/admin/templating/preview mit Beispieldaten – zeigt, wie das fertige Dokument mit der Vorlage aussehen würde, ohne ein echtes PDF zu erzeugen.

Häufige Fragen / Probleme

„Mein Platzhalter wird nicht ersetzt“

  • Schreibweise prüfen (Klammern, Punkte, Klein-/Großschreibung).
  • Wert ist evtl. leer (z.B. Mieter ohne Telefon).

„PDF sieht zerschossen aus“

  • HTML-/CSS-Fehler in der Vorlage. Vorschau benutzen.
  • Bilder: müssen zugängliche URLs / eingebettete Daten sein.

„Welche Vorlage wird im Vertrag verwendet?“

  • Im Vertrag selbst kann eine Vorlage gewählt werden – sonst wird die Standard-Vorlage genutzt.

Technische URLs (Kurzreferenz)

Admin (/settings/admin/templating):

  • GET /settings/admin/templating – Liste
  • GET /settings/admin/templating/new – Neu
  • POST /settings/admin/templating – Anlegen
  • GET /settings/admin/templating/{id}/edit – Bearbeiten
  • POST /settings/admin/templating/{id} – Speichern
  • POST /settings/admin/templating/{id}/delete – Löschen
  • POST /settings/admin/templating/{id}/default – als Standard markieren
  • POST /settings/admin/templating/preview – Vorschau

Hinweise

  • TEMPLATING ist eng mit VERTRAG (PDF-Generierung) verbunden.
  • Halten Sie Vorlagen sauber und übersichtlich – „eine Standardvorlage + ein paar Varianten“ ist meist besser als zehn fast identische Dateien.