# Szablon obrazka OG: Podsumowanie roku

Osobiste podsumowanie: okres postawiony bokiem w pasie w kolorze akcentu, jedna ogromna liczba, do czterech kapsułek ze statystykami i ponumerowana pierwsza trójka ze zdjęciami.

- Slug: `year-in-review`
- Preview (real render): https://shareglint.com/storage/template-previews/year-in-review.jpg
- Page: https://shareglint.com/pl/templates/year-in-review

Dla aplikacji, które wysyłają każdemu użytkownikowi jego rok (albo dotychczasowy miesiąc): muzycznych, sportowych, czytelniczych, finansowych czy SaaS — jeden render na osobę. Wielka liczba i okres zmniejszają się, gdy są za długie, kapsułki i nazwy kończą się wielokropkiem, a pozycja bez zdjęcia dostaje kafelek z inicjałem. W kadrach poziomych i kwadratowych okres stoi wzdłuż lewej krawędzi jak grzbiet książki; w pionowych pas leży u góry, a pierwsza trójka ma większe zdjęcia.

## Pola

Każde pole jest opcjonalne. Za długi tekst zmniejsza się, zamiast wychodzić poza kadr; pole obrazka przyjmuje publiczny adres URL, który pobieramy po naszej stronie.

| Pole | Typ | Opis | Przykład |
|---|---|---|---|
| `headline_value` | tekst | Wielka liczba, np. 48 210. (domyślnie: 1,000) | 48,210 |
| `headline_label` | tekst | Co ta liczba liczy, np. minut słuchania. | minutes listened |
| `period` | tekst | Okres w pasie, np. 2026 albo Październik do dziś. (domyślnie: 2026) | 2026 |
| `user_name` | tekst | Imię osoby, dla której jest podsumowanie. | Maya Chen |
| `stats` | tekst | Do czterech kapsułek jako pary etykieta\|wartość oddzielone średnikami, np. Utwory\|2140; Wykonawcy\|386. | Songs\|2,140; Artists\|386; Top genre\|Indie pop; Longest streak\|41 days |
| `top_1` | tekst | Nazwa pierwszej pozycji z trójki (wykonawca, trasa, książka). | Lena Ortiz |
| `top_1_image` | adres obrazka | Zdjęcie pierwszej pozycji; bez niego pojawia się kafelek z inicjałem. | https://example.com/images/avatar-woman.jpg |
| `top_2` | tekst | Nazwa drugiej pozycji. | The Night Owls |
| `top_2_image` | adres obrazka | Zdjęcie drugiej pozycji. | https://example.com/images/album-cover.png |
| `top_3` | tekst | Nazwa trzeciej pozycji. | Marcus Lee |
| `top_3_image` | adres obrazka | Zdjęcie trzeciej pozycji. | https://example.com/images/avatar-man.jpg |
| `app_name` | tekst | Nazwa aplikacji w górnym rogu. | Northwind Music |
| `logo` | adres obrazka | Logo aplikacji w pasie akcentu. | https://example.com/images/logo-m.png |
| `accent` | kolor | Kolor marki w zapisie hex, np. #6366f1. Barwi przyciski, wyróżnienia i poświatę w tle. (domyślnie: #a3e635) | #a3e635 |
| `theme` | dark | light | Schemat kolorów: dark albo light. | — |

## Wyrenderuj go jednym żądaniem

```bash
curl -X POST "https://shareglint.com/v1/images?wait=true" \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "year-in-review",
    "modifications": {
        "headline_value": "48,210",
        "headline_label": "minutes listened",
        "period": "2026",
        "user_name": "Maya Chen",
        "stats": "Songs|2,140; Artists|386; Top genre|Indie pop; Longest streak|41 days",
        "top_1": "Lena Ortiz",
        "top_2": "The Night Owls",
        "top_3": "Marcus Lee",
        "app_name": "Northwind Music",
        "top_1_image": "https://example.com/images/avatar-woman.jpg",
        "top_2_image": "https://example.com/images/album-cover.png",
        "top_3_image": "https://example.com/images/avatar-man.jpg",
        "logo": "https://example.com/images/logo-m.png"
    }
}'
```

## Dopasuj do siebie

accent i theme zmieniasz w każdym żądaniu. Jeśli chcesz więcej, skopiuj szablon na swoje konto: dostajesz zwykły szablon HTML z tymi samymi polami, który edytujesz w panelu albo przez API. Jeśli slug jest na Twoim koncie wolny, kopia go przejmuje — Twoje integracje przechodzą na Twoją wersję bez zmiany jednej linijki.

```bash
curl -X POST "https://shareglint.com/v1/templates/library/year-in-review/copy" -H "Authorization: Bearer sk_live_YOUR_KEY"
```