PDF-templates: woningbrochures op maat

PDF-templates leveren brochures, eigenaarsoverzichten en open-house handouts. U schrijft de template één keer in HTML (met Twig-tags voor de dynamische velden), Tesoro vult bij elke download de actuele woningdata in en converteert het resultaat naar een PDF.

Admin-werk met HTML-kennis

Het aanmaken en onderhouden van templates is adminwerk. U schrijft direct in HTML + Twig, er is geen visuele drag-and-drop editor. Eindgebruikers (makelaars) hoeven niets van HTML te weten; zij selecteren alleen een bestaande template bij Hand-out op een woning.

Wanneer gebruikt u dit?

• Een huisstijl-brochure aanmaken voor uw kantoor (logo, kleuren, lettertypen)
• Aparte templates voor luxe segment, standaard segment, open house, eigenaarsoverzicht
• Een bestaande template aanpassen omdat de prijs niet doorkomt, het logo ontbreekt of de beschrijving er raar uitziet

Hoe het werkt: overzicht

1. U maakt eenmalig een template aan (HTML + Twig-placeholders) in Settings → PDF.
2. Een makelaar opent een woning en klikt op Hand-out.
3. De makelaar kiest uw template + taal + (optioneel) een ander makelaarsprofiel.
4. Tesoro vult de placeholders met de actuele woningdata, render een HTML-pagina en converteert die naar een PDF.
5. De PDF opent in een nieuw tabblad, de makelaar downloadt en deelt ‘m met de klant.

Voorbereiding: maak eerst een Template Group

Vóórdat u een template kunt aanmaken, heeft u minimaal één Template Group nodig. Templates worden in groepen geordend (handig wanneer u er tientallen heeft).

1. Open Settings → PDF (in de sidebar staat het onder de groep TEMPLATES).
2. Klik rechtsboven op Manage Template Groups.
3. Tik een groepsnaam in (bijvoorbeeld Brochures NL of Open House) en klik Add.
4. Sluit het paneel met het kruisje linksboven.

Klik om te vergroten

Een groep aanmaken, type een naam en klik Add.

Een template aanmaken

Klik om te vergroten

Vanaf dit overzicht beheert u alle templates. + New template rechtsboven start een nieuwe.

1. Settings → PDF → klik + New template rechtsboven.

2. Vul de drie velden in:

   Veld	Wat
   Template group	Verplicht. Kies de groep die u hierboven heeft aangemaakt.
   Template name	Beschrijvende naam, bijvoorbeeld Luxe brochure 2026.
   Template interface	Op dit moment alleen Property beschikbaar, dat koppelt de template aan een woning-detailpagina.

3. Klik Save. U komt automatisch in de code-editor van de nieuwe template.

Klik om te vergroten

Template group is verplicht, u kunt geen template aanmaken zonder bestaande groep.

De template-code schrijven

Na Save opent een code-editor. Hier typt u HTML + Twig: het hart van uw template.

Klik om te vergroten

Een gewone code-editor met regelnummers. Bovenin: Property type, Template Group en de actieve taal.

Wat staat er bovenin?

• Property badge, bevestigt het Template Interface
• Template Group dropdown, kunt u nog wijzigen
• Taal-keuze (rechts), schakel tussen taalversies (NL, EN, ES, …). Elke taal heeft zijn eigen HTML-versie van dezelfde template.

Twig-tags voor dynamische data

Tesoro vervangt placeholders zoals {{ property.name }} met de actuele waarde op het moment dat de PDF wordt gegenereerd. Een paar handige patronen:

{# 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 %}

Multilingue templates

Wilt u uw brochure in meer talen? Schakel rechts boven de editor naar een andere taal en plak daar de vertaalde HTML. Tesoro kiest bij de Hand-out automatisch de juiste taal-versie.

Save

Klik rechtsboven Save. Vanaf nu kan elke makelaar uw template selecteren via de Hand-out knop.

Een PDF genereren vanaf een woning

Voor eindgebruikers, zo gebruikt een makelaar de templates die u heeft gemaakt:

1. Open een woning → klik rechtsboven op Hand-out.
2. Een paneel opent met alle beschikbare templates.
3. Optioneel: kies een andere Agent bovenin het paneel, handig wanneer u namens een collega een brochure stuurt.
4. Optioneel: kies een Language: toont alleen templates die in die taal beschikbaar zijn.
5. Klik op het download-icoontje naast de gewenste template. Tesoro opent een nieuw tabblad waar de PDF verschijnt.

Klik om te vergroten

De makelaar kiest een agent, taal, en daarna de gewenste template.

Veelvoorkomende valkuilen

• <br /> zichtbaar in beschrijving: de woningbeschrijving bevat zelf al regelafbrekingen in HTML. Gebruik {{ property.description.text | striptags('<br>') | raw }} in plaats van | nl2br.
• Foto’s verschijnen niet: gebruik {{ images.0 }}, {{ images.1 }} enzovoort. Het pad property.photos bestaat niet.
• Logo ontbreekt in de PDF: upload eerst het logo via Settings → Company Settings. Anders is {{ company.logo }} leeg en blijft het bedrijfsblok wit. Gebruik de tekst-fallback hierboven om dat netjes op te vangen.
• PDF wordt heel groot: limiteer het aantal foto’s tot 6, 8 met images | slice(0, 6). Veel grote foto’s maken de PDF zwaar voor e-mailbijlages.
• Layout breekt midden in een rij: voeg page-break-inside: avoid toe aan tabel-rijen en headings, zodat ze niet over twee pagina’s lopen.
• De agent-blok toont een lege streep: bij Hand-out geen makelaar gekozen? Wrap het agent-blok in {% if agent and agent.name %}...{% endif %} zodat het verdwijnt in plaats van een leeg blok te tonen.

Volledige referentie?

Een uitgebreide gids met alle beschikbare velden, voorbeeldtemplates en best practices staat in een aparte skill voor Claude Code: zie de volgende sectie.

Voor Claude Code-gebruikers: skill installeren

Werkt u met Claude Code? Wij delen een complete skill tesoro-pdf-template die alle template-kennis bundelt. Claude stelt eerst gerichte vragen (doelgroep, lengte, oriëntatie, taal, branding) en genereert daarna een copy-paste-klaar template.

Snelste installatie

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

Of via zip-download (offline-bundle met install-instructies)

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

Daarna Claude Code herstarten (of /reload-plugins typen in een chat). Claude herkent de skill automatisch zodra u een Tesoro PDF-template-vraag stelt.

Wat krijgt u erbij?

• Een complete lijst van beschikbare velden (woning, eigenaar, makelaar, bedrijf)
• Vier voorbeeldtemplates om als startpunt te gebruiken
• Snippet-bibliotheek, hero’s, foto-galerij-layouts, contact-blokken, section dividers
• Patronen om lege waarden netjes te verbergen
• Een vragenlijst die Claude doorloopt voordat hij code schrijft, zodat het resultaat aansluit bij wat u nodig heeft

Voorbeeld-prompts

Plak een van deze in Claude Code om te 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?

Bron-transparantie

De skill citeert voor elke uitspraak het exacte bestand in de Tesoro-broncode waar het gedrag verifieerbaar is. Niets is verzonnen, alles is traceerbaar.

Volgende stap

Watermerk op foto's Auto-watermerk voor woningfoto's.