PDF-Vorlagen: maßgeschneiderte Immobilienbroschüren

PDF-Vorlagen liefern Broschüren, Eigentümerübersichten und Open-House-Handouts. Sie schreiben die Vorlage einmal in HTML (mit Twig-Tags für die dynamischen Felder), Tesoro füllt bei jedem Download die aktuellen Immobiliendaten ein und konvertiert das Ergebnis in ein PDF.

Admin-Arbeit mit HTML-Kenntnissen

Das Erstellen und Verwalten von Vorlagen ist Adminarbeit. Sie schreiben direkt in HTML + Twig, es gibt keinen visuellen Drag-and-Drop-Editor. Endbenutzer (Makler) müssen nichts von HTML wissen; sie wählen lediglich eine vorhandene Vorlage bei Hand-out auf einer Immobilie aus.

Wann verwenden Sie dies?

• Eine Hausbroschüre für Ihr Büro erstellen (Logo, Farben, Schriftarten)
• Separate Vorlagen für Luxussegment, Standardsegment, Open House, Eigentümerübersicht
• Eine vorhandene Vorlage anpassen, weil der Preis nicht durchkommt, das Logo fehlt oder die Beschreibung seltsam aussieht

Wie es funktioniert: Überblick

1. Sie erstellen einmalig eine Vorlage (HTML + Twig-Platzhalter) in Settings → PDF.
2. Ein Makler öffnet eine Immobilie und klickt auf Hand-out.
3. Der Makler wählt Ihre Vorlage + Sprache + (optional) ein anderes Maklerprofil.
4. Tesoro füllt die Platzhalter mit den aktuellen Immobiliendaten, rendert eine HTML-Seite und konvertiert diese in ein PDF.
5. Die PDF wird in einem neuen Tab geöffnet, der Makler lädt sie herunter und teilt sie mit dem Kunden.

Vorbereitung: erstellen Sie zuerst eine Template Group

Bevor Sie eine Vorlage erstellen können, benötigen Sie mindestens eine Template Group. Vorlagen werden in Gruppen geordnet (praktisch, wenn Sie Dutzende haben).

1. Öffnen Sie Settings → PDF (in der Seitenleiste befindet es sich unter der Gruppe TEMPLATES).
2. Klicken Sie rechts oben auf Manage Template Groups.
3. Geben Sie einen Gruppennamen ein (z.B. Brochures DE oder Open House) und klicken Sie Add.
4. Schließen Sie das Fenster mit dem Kreuz oben links.

Klicken zum Vergrößern

Eine Gruppe erstellen, geben Sie einen Namen ein und klicken Sie auf Add.

Eine Vorlage erstellen

Klicken zum Vergrößern

Von dieser Übersicht aus verwalten Sie alle Vorlagen. + New template oben rechts startet eine neue.

1. Settings → PDF → klicken Sie rechts oben auf + New template.

2. Füllen Sie die drei Felder aus:

   Feld	Beschreibung
   Template group	Pflicht. Wählen Sie die oben erstellte Gruppe.
   Template name	Beschreibender Name, z.B. Luxusbroschüre 2026.
   Template interface	Derzeit nur Property verfügbar, das verknüpft die Vorlage mit einer Immobilien-Detailseite.

3. Klicken Sie auf Save. Sie gelangen automatisch in den Code-Editor der neuen Vorlage.

Klicken zum Vergrößern

Template group ist Pflicht, Sie können keine Vorlage ohne bestehende Gruppe erstellen.

Den Vorlagencode schreiben

Nach Save öffnet sich ein Code-Editor. Hier tippen Sie HTML + Twig: das Herz Ihrer Vorlage.

Klicken zum Vergrößern

Ein gewöhnlicher Code-Editor mit Zeilennummern. Oben: Property-Typ, Template Group und die aktive Sprache.

Was steht oben?

• Property-Badge, bestätigt das Template Interface
• Template Group-Dropdown, können Sie noch ändern
• Sprachauswahl (rechts), wechseln Sie zwischen Sprachversionen (DE, EN, ES, …). Jede Sprache hat ihre eigene HTML-Version derselben Vorlage.

Twig-Tags für dynamische Daten

Tesoro ersetzt Platzhalter wie {{ property.name }} durch den aktuellen Wert zum Zeitpunkt der PDF-Generierung. Einige nützliche Muster:

{# Eenvoudige variabele afdrukken, prijs komt al met valutateken #}
{{ property.name }}
{{ property.price }}

{# Toon alleen wanneer er data is, voorkomt lege regels en em-dashes #}
{% if property.number_of_bedrooms %}
  <li>Slaapkamers: {{ property.number_of_bedrooms }}</li>
{% endif %}

{# Eerste niet-lege waarde gebruiken #}
{{ property.description.title | default(property.name) | default('Woning') }}

{# Foto's, maximaal 6 in de galerij, kleinere PDF #}
{% for img in images | slice(0, 6) %}
  <img src="{{ img }}" alt="" style="width: 100%;">
{% endfor %}

{# Bedrijfslogo met tekst-fallback als geen logo is geüpload #}
{% if company.logo %}
  <img src="{{ company.logo }}" alt="{{ company.name }}" style="height: 16mm;">
{% else %}
  <strong>{{ company.name }}</strong>
{% endif %}

Mehrsprachige Vorlagen

Möchten Sie Ihre Broschüre in mehreren Sprachen? Wechseln Sie rechts oben im Editor zu einer anderen Sprache und fügen Sie dort die übersetzte HTML ein. Tesoro wählt bei der Hand-out automatisch die richtige Sprachversion.

Save

Klicken Sie rechts oben auf Save. Von nun an kann jeder Makler Ihre Vorlage über die Hand-out-Schaltfläche auswählen.

Ein PDF von einer Immobilie aus generieren

Für Endbenutzer, so verwendet ein Makler die von Ihnen erstellten Vorlagen:

1. Öffnen Sie eine Immobilie → klicken Sie rechts oben auf Hand-out.
2. Ein Fenster öffnet sich mit allen verfügbaren Vorlagen.
3. Optional: Wählen Sie oben im Fenster einen anderen Agenten: praktisch, wenn Sie im Namen eines Kollegen eine Broschüre versenden.
4. Optional: Wählen Sie eine Sprache: zeigt nur Vorlagen an, die in dieser Sprache verfügbar sind.
5. Klicken Sie auf das Download-Symbol neben der gewünschten Vorlage. Tesoro öffnet einen neuen Tab, in dem die PDF erscheint.

Klicken zum Vergrößern

Der Makler wählt einen Agenten, eine Sprache und dann die gewünschte Vorlage.

Häufige Fallstricke

• <br /> sichtbar in der Beschreibung: Die Immobilienbeschreibung enthält bereits HTML-Zeilenumbrüche. Verwenden Sie {{ property.description.text | striptags('<br>') | raw }} anstelle von | nl2br.
• Fotos erscheinen nicht: Verwenden Sie {{ images.0 }}, {{ images.1 }} usw. Der Pfad property.photos existiert nicht.
• Logo fehlt im PDF: Laden Sie zuerst das Logo über Settings → Company Settings hoch. Andernfalls ist {{ company.logo }} leer und der Firmenblock bleibt weiß. Verwenden Sie die Text-Fallback oben, um das sauber abzufangen.
• PDF wird sehr groß: Begrenzen Sie die Anzahl der Fotos auf 6, 8 mit images | slice(0, 6). Viele große Fotos machen die PDF schwer für E-Mail-Anhänge.
• Layout bricht mitten in einer Zeile: Fügen Sie page-break-inside: avoid zu Tabellenzeilen und Überschriften hinzu, damit sie nicht auf zwei Seiten geteilt werden.
• Der Agentenblock zeigt einen leeren Strich: Bei Hand-out kein Makler ausgewählt? Umschließen Sie den Agentenblock mit {% if agent and agent.name %}...{% endif %}, sodass er verschwindet anstatt einen leeren Block anzuzeigen.

Vollständige Referenz?

Eine umfassende Anleitung mit allen verfügbaren Feldern, Beispielvorlagen und Best Practices finden Sie in einem speziellen Skill für Claude Code: siehe den nächsten Abschnitt.

Für Claude Code-Benutzer: Skill installieren

Arbeiten Sie mit Claude Code? Wir teilen einen kompletten Skill tesoro-pdf-template, der das gesamte Vorlagenwissen bündelt. Claude stellt zunächst gezielte Fragen (Zielgruppe, Länge, Ausrichtung, Sprache, Branding) und generiert dann eine copy-paste-fertige Vorlage.

Schnellste Installation

mkdir -p ~/.claude/skills/tesoro-pdf-template && \
  curl -fsSL https://kb.tesorohq.io/skills/tesoro-pdf-template/SKILL.md \
  -o ~/.claude/skills/tesoro-pdf-template/SKILL.md

Oder per Zip-Download (Offline-Bundle mit Installationsanleitung)

curl -fsSL https://kb.tesorohq.io/skills/tesoro-pdf-template/tesoro-pdf-template.zip \
  -o /tmp/tesoro-pdf-template.zip
mkdir -p ~/.claude/skills
unzip -o /tmp/tesoro-pdf-template.zip -d ~/.claude/skills/
rm /tmp/tesoro-pdf-template.zip

Danach Claude Code neu starten (oder /reload-plugins in einem Chat eingeben). Claude erkennt den Skill automatisch, sobald Sie eine Frage zu Tesoro PDF-Vorlagen stellen.

Was bekommen Sie dazu?

• Eine vollständige Liste der verfügbaren Felder (Immobilie, Eigentümer, Makler, Unternehmen)
• Vier Beispielvorlagen als Ausgangspunkt
• Snippet-Bibliothek, Hero-Bereiche, Fotogalerie-Layouts, Kontaktblöcke, Abschnittstrennzeichen
• Muster, um leere Werte sauber zu verstecken
• Einen Fragenkatalog, den Claude durchgeht, bevor er Code schreibt, damit das Ergebnis Ihren Anforderungen entspricht

Beispiel-Prompts

Fügen Sie einen dieser in Claude Code ein, um zu beginnen:

Maak een PDF-template voor een open-house handout in Tesoro. Eén pagina, NL, met grote hero-foto.

Mijn property brochure heeft een lelijke titel, kun je de fallback verbeteren? Ik plak de bestaande template.

Ik wil een eigenaarsoverzicht met owner_net_price en commissie. Welke variabelen moet ik gebruiken?

Quellentransparenz

Der Skill zitiert für jede Aussage die genaue Datei im Tesoro-Quellcode, in der das Verhalten überprüfbar ist. Nichts ist erfunden, alles ist nachvollziehbar.

Nächster Schritt

Wasserzeichen auf Fotos Auto-Wasserzeichen für Immobilienfotos.