Źródło: https://wpinplate.com/dokumentacja/ekrany-tv/

# Ekrany TV w lokalu

Ekrany TV pokazują menu na telewizorach i monitorach w lokalu. Korzystają z tego samego menu co strona: zmiana ceny albo wyłączenie dania w panelu pojawia się na ekranie przy najbliższym odświeżeniu, zwykle w ciągu kilkunastu sekund. Nie musisz drukować tablic ani utrzymywać osobnego systemu.

## Jak to działa

- **Ekran** to układ złożony z bloków TV (siatka dań, pokaz slajdów, baner, obraz, wideo, odstęp). Układ budujesz w edytorze Gutenberg.
- **Slot** to blok dań, którego zawartością zarządzasz w **TV Managerze** – bez edycji układu. Np. slot „Danie tygodnia” w pokazie slajdów.
- **Telewizor** otwiera adres ekranu w przeglądarce: `/wp-inplate/tv/{nazwa-ekranu}/`.

## Tworzenie ekranu

1. Otwórz **TV → Manager ↗** (adres `/wp-inplate/tv-manager/`).
2. Kliknij **Nowy ekran** i podaj nazwę, albo wybierz **Gotowe szablony**:

| Szablon | Opis |
|---|---|
| **Siatka ze zdjęciami** | Siatka kart z dużymi zdjęciami. Dobra dla menu z atrakcyjnymi zdjęciami |
| **Pełna lista** | Jeden slot z listą dań na cały ekran. Dla menu dnia lub karty dań |
| **Dwie kolumny** | Dwie listy obok siebie, np. dania główne i napoje. Każda kolumna ma własny slot i nagłówek |
| **Pokaz slajdów** | Pełnoekranowy pokaz – jedno danie na raz ze zdjęciem w tle. Dla promocji lub burgera tygodnia |

3. Kliknij **Edytuj layout ↗**, żeby dopracować układ w edytorze, albo od razu dodawaj dania do slotów.

Ekrany możesz **eksportować** do pliku JSON i **importować** – np. żeby przenieść układ na inną stronę.

Lista ekranów jest też w panelu: **TV → Ekrany**.

## Ustawienia ekranu

W edytorze ekranu, w panelu bocznym **Ustawienia ekranu TV**:

| Ustawienie | Opis |
|---|---|
| **Układ ekranu** | Poziomo (16:9) albo pionowo (9:16) |
| **Rozmiar treści** | 80–200%. Powiększa cały ekran naraz: tekst, odstępy i zdjęcia. Zwiększ, gdy z daleka treść jest za mała |
| **Miniatura** | Obrazek ekranu w launcherze |
| **Kolor tła, kolor tekstu, kolor akcentu** | Kolorystyka ekranu |

Żeby sprawdzić rozmiar na jednym telewizorze bez zmiany ustawień, dopisz do adresu ekranu `?scale=150`.

Wysokość ekranu jest dzielona między bloki automatycznie. Bloki ustawione w kolumnach obok siebie wypełniają swoją kolumnę.

## Bloki TV

### TV – Siatka dań

Dania z kategorii albo ze slotu, jako siatka kart lub lista.

| Opcja | Opis |
|---|---|
| Kategoria | Źródło dań, gdy blok nie jest slotem (albo zapas, gdy slot jest pusty) |
| Układ | **Siatka** albo **Lista** (lista może mieć kilka kolumn) |
| Kolumny, maks. liczba dań | Domyślnie 3 kolumny, 12 dań |
| Układ karty | **Karta** (zdjęcie na górze), **Tło** (zdjęcie na całość), **Zdjęcie z lewej**, **Dolny pasek** |
| Rozmiar zdjęcia | Brak, małe, średnie, duże |
| Widoczność | Ceny, zdjęcia, opis, tytuł, znaczniki, dania niedostępne |
| Styl tekstu | Skala czcionki, kolor, odstęp wewnętrzny (padding) i margines – osobno dla tytułu, opisu i ceny |
| Waga wysokości | Ręczny udział bloku w wysokości ekranu (0 = automatycznie) |

**Lista dopasowuje się do miejsca:** cały blok używa jednego rozmiaru czcionki. Długie nazwy zawijają się do dwóch linii i zmniejszają, ceny są wyrównane do prawej, a gramatura i opis nie schodzą poniżej czytelnego rozmiaru. Nic nie jest ucinane.

### TV – Pokaz slajdów

Dania zmieniające się co kilka sekund.

| Opcja | Opis |
|---|---|
| Kategoria, maks. liczba slajdów | Źródło dań i limit (domyślnie 10) |
| Czas wyświetlania slajdu | W sekundach (domyślnie 5) |
| Przejście | Przenikanie albo przesunięcie |
| Układ slajdu | Tło, zdjęcie z lewej, karta, dolny pasek |
| Slajdów na stronę | 1–4 dania naraz. Najlepiej z układem Karta. Ostatnia strona pokazuje pozostałe dania |
| Efekt zoom | Powolne przybliżanie zdjęcia (efekt Ken Burns) w układach ze zdjęciem w tle |
| Widoczność | Ceny, zdjęcia, znaczniki, dania niedostępne |

### TV – Baner tekstowy

Tekst na ekranie, np. nazwa lokalu, godziny otwarcia, komunikat. Rozmiar: mały (24 px), średni (36 px), duży (56 px), bardzo duży (80 px). Wyrównanie i kolor tekstu.

### TV – Obrazek

Obrazek lub logo z biblioteki mediów, z wyrównaniem i maksymalną szerokością.

### TV – Wideo

Wideo albo playlista kilku plików z biblioteki mediów. Opcje: autoodtwarzanie, zapętlenie całej playlisty, wyciszenie, kontrolki. Przeglądarki blokują autoodtwarzanie z dźwiękiem – do autoodtwarzania zostaw wideo wyciszone. Kontrolki przydają się na ekranach dotykowych; po 10 sekundach bezruchu znikają razem z kursorem.

### TV – Divider

Odstęp albo kolorowa linia o wybranej wysokości, np. margines na dole ekranu.

## Sloty i TV Manager

W bloku siatki lub pokazu slajdów, w sekcji **TV Manager – Slot**, nadaj blokowi **klucz slotu** i **etykietę**. Od tej chwili dania w tym bloku ustawiasz w TV Managerze:

- **Dodaj produkt** – wyszukiwarka z filtrem kategorii, kilka dań pod rząd,
- kolejność – przeciąganie myszą lub palcem,
- **Ukryj na TV** – danie zostaje na liście, ale nie wyświetla się,
- **Usuń z ekranu**,
- **Znaczki dla dania** – jeden lub kilka,
- **Label nad daniami** – nagłówek nad slotem, z wyborem rozmiaru,
- **Slot widoczny / ukryty na TV** – chowa cały slot.

Te same funkcje ma zakładka **TV** w [panelu managera w KDS](/dokumentacja/panel-managera/#tv), więc manager zmieni ekrany z tabletu.

Do TV Managera mają dostęp administrator i kierownik sklepu.

## Znaczki na ekranach TV

Znaczki to nazwane, kolorowe plakietki przy daniach na ekranach, np. „Promocja”, „Nowość”, „Dzisiaj polecamy”.

- Katalog znaczków tworzysz w **InPlate → Ustawienia → System → Ekrany TV → Badge na ekranach TV**. Kierownik sklepu może go też edytować w KDS: **Manager → TV → Znaczki TV**.
- Znaczek ma nazwę, kolor tła (albo przezroczyste tło), kolor tekstu i opcjonalny obrys.
- Opcjonalna ikona: obrazek z biblioteki mediów albo znak lub emoji wpisany z klawiatury. Obrazek ma pierwszeństwo. Starsze telewizory często nie wyświetlają emoji – na nich użyj obrazka. Ikona jest wyśrodkowana przy nazwie.
- Przypisujesz je do dania na konkretnym ekranie w TV Managerze albo w KDS. Danie może mieć kilka znaczków.
- Znaczek pokazuje się w rogu karty, obok ceny na liście albo pod nazwą w pokazie slajdów.
- Zmiana nazwy lub koloru w katalogu działa od razu na wszystkich ekranach.

## Co jeszcze widać na ekranie

- **Gramatura** dania i **znaczniki produktu** (tagi, opcjonalnie z ikoną) – znaczniki, jeśli je włączysz w bloku.
- **Pełny opis dania** z podziałami linii.
- **Dania niedostępne** – oznaczone automatycznie, jeśli w bloku włączysz ich pokazywanie.
- **Kategorie „Tylko TV”** – pozycje widoczne tylko na ekranach, nie w menu online. Zobacz [Produkty i kategorie](/dokumentacja/produkty-i-kategorie/#kategorie-tylko-dla-tv).

## Uruchomienie na telewizorze

1. Na telewizorze otwórz przeglądarkę.
2. Wejdź na `/wp-inplate/tv/` (launcher) i wybierz ekran, albo od razu na adres ekranu `/wp-inplate/tv/{nazwa-ekranu}/`.
3. Włącz tryb pełnoekranowy przeglądarki.

**PIN:** launcher możesz zabezpieczyć 4-cyfrowym kodem w **InPlate → Ustawienia → System → Ekrany TV → PIN dla panelu TV**. Puste pole oznacza brak zabezpieczenia.

**Odświeżanie:** ekran pobiera dane mniej więcej co 15 sekund. Zmiany w układzie (kolory, odstępy, bloki) pojawiają się przy następnym odświeżeniu. Po aktualizacji wtyczki ekran przeładowuje się sam.

**Starsze telewizory:** ekrany działają także w przeglądarkach starszych Smart TV (np. Vestel / Vewd z Chromium 38 lub nowszym). Możesz też użyć sticka lub mini-PC z HDMI.

**Diagnostyka:** dopisz do adresu ekranu `?debug=1`, żeby zobaczyć, co raportuje przeglądarka telewizora (rozdzielczość, gęstość pikseli, obsługa CSS). Przydaje się, gdy ekran wygląda inaczej niż na komputerze.

## Licencja

Ekrany TV wymagają aktywnej licencji lub okresu próbnego. Po wygaśnięciu licencji ekrany są wstrzymane. Zobacz [Licencja](/dokumentacja/licencja/).