# Szablon obrazka OG: Podsumowanie ocen

Blok ocen jak w serwisie z opiniami: zdjęcie i nazwa produktu, duża średnia nad częściowo wypełnionymi gwiazdkami, liczba opinii i histogram od pięciu do jednej gwiazdki.

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

Dla sklepów, aplikacji, lokali i stron z opiniami o SaaS, które pokazują, co dają wszystkie opinie razem (pojedyncza opinia to `testimonial-stars`). Podaj średnią i liczbę opinii albo pozwól karcie wyliczyć je z rozkładu. Gwiazdki są przycinane do średniej i ograniczone do 0–5; bez zdjęcia pojawia się kafelek z inicjałem. W kadrach poziomych i kwadratowych wynik stoi obok histogramu; w pionowych duże zdjęcie, wynik i paski idą jedno pod drugim, wyśrodkowane.

## 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 |
|---|---|---|---|
| `subject` | tekst | Co jest oceniane, np. Słuchawki Northwind Studio. (domyślnie: Product name) | Northwind Studio Headphones |
| `average` | tekst | Średnia ocena w takim zapisie, jak ma się wyświetlić, np. 4,7. Puste pole = wyliczona z rozkładu. | 4.7 |
| `count` | tekst | Liczba opinii w dowolnym zapisie, np. 1240 opinii. Puste pole = suma rozkładu. | 1,240 reviews |
| `distribution` | tekst | Liczba opinii na każdą gwiazdkę, jako 5:820, 4:260, 3:90, 2:40, 1:30 albo pięć samych liczb od pięciu gwiazdek w dół. | 5:902, 4:228, 3:62, 2:28, 1:20 |
| `platform` | tekst | Skąd pochodzą opinie, np. Zweryfikowani kupujący w northwind.shop. | Verified buyers on northwind.shop |
| `platform_logo` | adres obrazka | Logo obok platformy. | https://example.com/images/logo-northwind.png |
| `image` | adres obrazka | Zdjęcie produktu; bez niego pokazuje się pierwsza litera nazwy. | https://example.com/images/headphones.jpg |
| `accent` | kolor | Kolor marki w zapisie hex, np. #6366f1. Barwi przyciski, wyróżnienia i poświatę w tle. (domyślnie: #f59e0b) | #f59e0b |
| `theme` | dark | light | Schemat kolorów: dark albo light. (domyślnie: 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": "rating-summary",
    "modifications": {
        "subject": "Northwind Studio Headphones",
        "average": "4.7",
        "count": "1,240 reviews",
        "distribution": "5:902, 4:228, 3:62, 2:28, 1:20",
        "platform": "Verified buyers on northwind.shop",
        "platform_logo": "https://example.com/images/logo-northwind.png",
        "image": "https://example.com/images/headphones.jpg"
    }
}'
```

## 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/rating-summary/copy" -H "Authorization: Bearer sk_live_YOUR_KEY"
```