Szablony PDF: broszury nieruchomości na miarę

Szablony PDF zapewniają broszury, przeglądy dla właścicieli i materiały na dzień otwarty. Pisze Pan/Pani szablon raz w HTML (ze znacznikami Twig dla pól dynamicznych), Tesoro przy każdym pobraniu wypełnia aktualne dane nieruchomości i konwertuje wynik na PDF.

Kiedy to stosować?

Tworzenie broszury zgodnej z identyfikacją wizualną biura (logo, kolory, czcionki)
Osobne szablony dla segmentu luksusowego, standardowego, dnia otwartego, przeglądu dla właściciela
Modyfikacja istniejącego szablonu, ponieważ cena nie przechodzi, brakuje logo lub opis wygląda dziwnie

Jak to działa: przegląd

Tworzy Pan/Pani jednorazowo szablon (HTML + znaczniki Twig) w Settings → PDF.
Pośrednik otwiera nieruchomość i klika Hand-out.
Pośrednik wybiera Pana/Pani szablon + język + (opcjonalnie) inny profil pośrednika.
Tesoro wypełnia znaczniki aktualnymi danymi nieruchomości, renderuje stronę HTML i konwertuje ją na PDF.
PDF otwiera się w nowej karcie, pośrednik pobiera go i udostępnia klientowi.

Przygotowanie: najpierw utwórz grupę szablonów

Zanim będzie Pan/Pani mógł utworzyć szablon, potrzebuje Pan/Pani co najmniej jednej grupy szablonów. Szablony są uporządkowane w grupach (przydatne, gdy ma ich Pan/Pani dziesiątki).

Otwórz Settings → PDF (w panelu bocznym znajduje się w grupie TEMPLATES).
Kliknij w prawym górnym rogu Manage Template Groups.
Wpisz nazwę grupy (np. Brochures PL lub Open House) i kliknij Add.
Zamknij panel, klikając krzyżyk w lewym górnym rogu.

Okno dialogowe Manage Template Groups — Tworzenie grupy, wpisz nazwę i kliknij Add.

Tworzenie szablonu

Przegląd szablonów PDF z przyciskiem + New template w prawym górnym rogu — Z tego przeglądu zarządza Pan/Pani wszystkimi szablonami. + New template w prawym górnym rogu rozpoczyna nowy.

Settings → PDF → kliknij + New template w prawym górnym rogu.

Wypełnij trzy pola:

Pole	Opis
Template group	Wymagane. Wybierz grupę utworzoną powyżej.
Template name	Nazwa opisowa, np. Luksusowa broszura 2026.
Template interface	Na razie dostępna jest tylko opcja Property: łączy szablon ze stroną szczegółową nieruchomości.

Kliknij Save. Automatycznie przejdziesz do edytora kodu nowego szablonu.

Okno modalne nowego szablonu z trzema wymaganymi polami — Template group jest wymagane, nie można utworzyć szablonu bez istniejącej grupy.

Pisanie kodu szablonu

Po kliknięciu Save otwiera się edytor kodu. Wprowadza Pan/Pani tutaj HTML + Twig: serce szablonu.

Edytor kodu szablonu PDF z numerami wierszy i przyciskiem wyboru języka — Zwykły edytor kodu z numerami wierszy. Na górze: typ Property, grupa szablonów i aktywny język.

Co znajduje się na górze?

Property: potwierdza interfejs szablonu
Template Group: lista rozwijana, którą można jeszcze zmienić
Wybór języka (po prawej), przełączanie między wersjami językowymi (PL, EN, ES, …). Każdy język ma własną wersję HTML tego samego szablonu.

Znaczniki Twig dla danych dynamicznych

Tesoro zastępuje znaczniki, takie jak {{ property.name }}, aktualną wartością w momencie generowania PDF. Kilka przydatnych wzorców:

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

Szablony w wielu językach

Chce Pan/Pani, aby broszura była dostępna w kilku językach? Proszę przełączyć się po prawej stronie nad edytorem na inny język i wkleić tam przetłumaczony HTML. Tesoro przy przycisku Hand-out automatycznie wybiera odpowiednią wersję językową.

Save

Proszę kliknąć Save w prawym górnym rogu. Od teraz każdy pośrednik może wybrać Pana/Pani szablon za pomocą przycisku Hand-out.

Generowanie PDF z poziomu nieruchomości

Dla użytkowników końcowych, jak pośrednik używa szablonów, które Pan/Pani utworzył:

Otwórz nieruchomość → kliknij w prawym górnym rogu Hand-out.
Otwiera się panel ze wszystkimi dostępnymi szablonami.
Opcjonalnie: wybierz innego Agent na górze panelu, przydatne, gdy wysyła Pan/Pani broszurę w imieniu kolegi.
Opcjonalnie: wybierz Language: wyświetlane są tylko szablony dostępne w tym języku.
Kliknij ikonę pobierania obok wybranego szablonu. Tesoro otwiera nową kartę, w której pojawia się PDF.

Okno Hand-out w nieruchomości z listą szablonów — Pośrednik wybiera agenta, język, a następnie żądany szablon.

Często spotykane pułapki

<br /> widoczny w opisie: opis nieruchomości zawiera już własne łamania wierszy w HTML. Użyj {{ property.description.text | striptags('<br>') | raw }} zamiast | nl2br.
Zdjęcia nie pojawiają się: użyj {{ images.0 }}, {{ images.1 }} itd. Ścieżka property.photos nie istnieje.
Logo brakuje w PDF: najpierw prześlij logo przez Settings → Company Settings. W przeciwnym razie {{ company.logo }} jest puste i blok firmy pozostaje biały. Użyj tekstowego fallbacka powyżej, aby to ładnie obsłużyć.
PDF jest bardzo duży: ogranicz liczbę zdjęć do 6, 8 za pomocą images | slice(0, 6). Duże zdjęcia sprawiają, że PDF jest ciężki dla załączników e-mail.
Układ łamie się w środku wiersza: dodaj page-break-inside: avoid do wierszy tabel i nagłówków, aby nie przechodziły na następną stronę.
Blok agenta wyświetla pustą kreskę: nie wybrano agenta przy Hand-out? Owiń blok agenta w {% if agent and agent.name %}...{% endif %}, aby zniknął zamiast wyświetlać pusty blok.

Dla użytkowników Claude Code: zainstaluj skill

Pracuje Pan/Pani z Claude Code? Udostępniamy kompletną umiejętność tesoro-pdf-template, która łączy całą wiedzę o szablonach. Claude najpierw zadaje ukierunkowane pytania (grupa docelowa, długość, orientacja, język, branding), a następnie generuje szablon gotowy do skopiowania i wklejenia.

Najszybsza instalacja

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

Lub przez pobranie zip (pakiet offline z instrukcjami instalacji)

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

Następnie uruchom ponownie Claude Code (lub wpisz /reload-plugins w czacie). Claude automatycznie rozpozna umiejętność, gdy tylko zadasz pytanie dotyczące szablonu PDF Tesoro.

Co otrzymujesz?

Kompletną listę dostępnych pól (nieruchomość, właściciel, pośrednik, firma)
Cztery przykładowe szablony do wykorzystania jako punkt wyjścia
Bibliotekę snippetów, hero, układy galerii zdjęć, bloki kontaktowe, separatory sekcji
Wzory do ładnego ukrywania pustych wartości
Kwestionariusz, który Claude przechodzi przed napisaniem kodu, aby wynik odpowiadał Twoim potrzebom

Przykładowe podpowiedzi

Wklej jedną z tych do Claude Code, aby rozpocząć:

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?

Następny krok

Znak wodny na zdjęciach Automatyczny znak wodny dla zdjęć nieruchomości.