# Szablon OLX PREMIUM — Dywanowy Bazar

> **Cel:** ogłoszenie, które na mobile wygląda jak dopracowana karta produktu — bez HTML, tylko plain text + hierarchia wizualna.
>
> **Gdzie wkleić:** Base.com → **Integracje → OLX → Szablony ofert** (lub edycja szablonu przypisanego do konta OLX).
>
> Powiązane: [`szablon_olx`](szablon_olx) (wariant prosty), [`AUTO-PUBLISH-BL.md`](AUTO-PUBLISH-BL.md), [`BASELINKER-TEMPLATE-TAGS.md`](BASELINKER-TEMPLATE-TAGS.md), [`config/olx-template-curated-features.json`](../config/olx-template-curated-features.json).

---

## Dlaczego ten układ działa

| Problem na OLX | Rozwiązanie PREMIUM |
|----------------|---------------------|
| Ściana parametrów z `[cechy_lista]` | Wybrane `[cecha_i_nazwa\|…]` — tylko to, co wpływa na decyzję |
| Duplikat wymiarów (cm w features + tagi) | Jedna linia: `[szerokosc] x [dlugosc] cm` |
| Narracja schowana na dole | Hook na górze — `[opis_dodatkowy4]` od pierwszego ekranu |
| Zaufanie ginie w tekście | Sekcja **ZAUFANIE** tuż pod hookiem |
| „Kolejny sklep z dywanami” | Stała ramka marki + CTA, bez powtarzania w AI |

Apka dostarcza treści (`extra1`, `extra4`, `features`); **Ty układasz je w szablonie BL** — to jedyna ręczna konfiguracja.

---

## SZABLON PREMIUM — WKLEJ DO PANELU BL

Skopiuj blok od `===` do `===` (włącznie z liniami ramki).

```
═══════════════════════════════════════
◆ DYWANOWY BAZAR

[opis_dodatkowy4]

───────────────────────────────────────
▸ ZAUFANIE
[opis_dodatkowy1]

▸ PARAMETRY
  Rozmiar · [szerokosc] x [dlugosc] cm
  Kolor · [cecha_i_nazwa|Kolor]
  Materiał · [cecha_i_nazwa|Materiał runa]
  Skład · [cecha_i_nazwa|Skład materiału]
  Runo · [cecha_i_nazwa|Rodzaj]
  Kształt · [cecha_i_nazwa|Kształt]
  Wzór · [cecha_i_nazwa|Wzór]
  Zastosowanie · [cecha_i_nazwa|Zastosowanie]
  Antypoślizg · [cecha_i_nazwa|Antypoślizgowy]
  Czyszczenie · [cecha_i_nazwa|Łatwy w czyszczeniu]
  Ogrzewanie podłogowe · [cecha_i_nazwa|Ogrzewanie podłogowe]
  Stan · [cecha_i_nazwa|Stan]
  EAN · [ean]

───────────────────────────────────────
▸ WYSYŁKA I KONTAKT
Kurierem na terenie Polski.
Napisz na OLX — odpowiadamy szybko.

dywanowy-bazar.pl
═══════════════════════════════════════
```

### Co widzi kupujący (kolejność ekranów mobile)

```mermaid
flowchart TD
  A[◆ Marka + hook narracji] --> B[▸ Zaufanie outlet/zwrot]
  B --> C[▸ Parametry w punktach]
  C --> D[▸ Wysyłka + CTA + URL]
```

1. **Hook** — 2–3 zdania z AI: zastosowanie, materiał, ewentualnie stan (bez listy parametrów).
2. **Zaufanie** — krótki plain text z apki (inny dla outlet / po zwrocie).
3. **Parametry** — skanowalna lista; separator `·` czytelny na małym ekranie.
4. **Stopka** — wysyłka + kontakt; bez powielania «sprawdzamy przed wysyłką» (to jest wyżej).

---

## Wariant PREMIUM KOMPAKT (mniej linii)

Gdy produkt ma mało cech lub chcesz krótszy opis — zostaw tylko „rdzeń” decyzyjny:

```
═══════════════════════════════════════
◆ DYWANOWY BAZAR

[opis_dodatkowy4]

▸ ZAUFANIE
[opis_dodatkowy1]

▸ PARAMETRY
  Rozmiar · [szerokosc] x [dlugosc] cm
  Kolor · [cecha_i_nazwa|Kolor]
  Materiał · [cecha_i_nazwa|Materiał runa]
  Runo · [cecha_i_nazwa|Rodzaj]
  Antypoślizg · [cecha_i_nazwa|Antypoślizgowy]
  EAN · [ean]

▸ WYSYŁKA
Kurierem · zapytaj na OLX

dywanowy-bazar.pl
═══════════════════════════════════════
```

---

## Które parametry pokazywać (a których nie)

Pełna lista kuratorowana: [`config/olx-template-curated-features.json`](../config/olx-template-curated-features.json).

| Pokazuj w PREMIUM | Ukryj (szum / duplikat) |
|-------------------|-------------------------|
| Rozmiar (`[szerokosc]` × `[dlugosc]`) | `Szerokość (cm)`, `Długość (cm)` w features |
| Kolor, Materiał runa, Skład materiału | `Numer artykułu`, `Numer artykułu dostawcy` |
| Rodzaj (runo), Kształt, Wzór | `Wysokość całkowita`, `Waga całkowita` |
| Zastosowanie, Antypoślizgowy, Łatwy w czyszczeniu | `Informacje dodatkowe`, pola DE (`Herstellungsart`…) |
| Ogrzewanie podłogowe, Stan (outlet) | `Marka` — zwykle jest w tytule `[nazwa]` |
| EAN | `GTIN` (top-level jako `[ean]`) |

**Pusta linia:** gdy produkt nie ma danej cechy, BL często zostawia `Kolor ·` bez wartości. Po pierwszym podglądzie możesz usunąć rzadkie linie (np. `Wzór`) z szablonu — zostaw tylko te, które regularnie się wypełniają.

---

## Zasady (nie łam kontraktu z apką)

1. **Plain text only** — bez `<p>`, `<b>`, list HTML.
2. **Parametry z szablonu, nie z AI** — `[opis_dodatkowy4]` to narracja; lista idzie z tagów cech.
3. **Nie powtarzaj zaufania w narracji** — «sprawdzamy przed wysyłką» jest w `[opis_dodatkowy1]`.
4. **Tytuł ogłoszenia ≠ `[opis_dodatkowy4]`** — tytuł to `[nazwa]` lub ręczny tytuł OLX z apki.
5. **Nie używaj** `[opis]`, `[opis_dodatkowy2]`, `[opis_dodatkowy3]` w szablonie OLX.
6. **Znaki Unicode** (`◆`, `▸`, `·`, `═`) — OLX je wyświetla; unikaj emoji flag i skomplikowanych fontów.

---

## Porównanie z szablonem standardowym

| | Standard ([`szablon_olx`](szablon_olx)) | PREMIUM (ten dokument) |
|---|------------------------------------------|-------------------------|
| Parametry | `[cechy_lista]` — wszystko | `[cecha_i_nazwa\|…]` — kuratorowane |
| Hierarchia | Proste linie `───` | Sekcje `▸` + marka `◆` |
| Długość | Krótszy szablon | Więcej linii, ale czytelniejszy skan |
| Konfiguracja | Zero decyzji | Jednorazowy dobór linii parametrów |

Oba warianty są poprawne — PREMIUM rekomendowany na konto główne OLX.

---

## Checklista po wdrożeniu

1. Szablon zapisany w BL → **Integracje → OLX**.
2. Produkt zapisany z apki: `description_extra4` i `description_extra1` niepuste.
3. `features` uzupełnione (kanon: [`baselinker-feature-canonical.json`](../config/baselinker-feature-canonical.json)).
4. **Publikacje → OLX** — podgląd na telefonie: hook widoczny bez scrolla.
5. Brak pustych «dziur» przy kluczowych liniach (Rozmiar, Kolor, Materiał).
6. Tytuł: `[nazwa]` lub tytuł OLX z apki — bez duplikatu w opisie.

---

## Rozwiązywanie problemów

| Objaw | Działanie |
|-------|-----------|
| `wysyłkąW` / sklejone słowa | Upewnij się, że `[opis_dodatkowy1]` pochodzi z apki (plain text), nie ze starego HTML w magazynie — przegeneruj produkt. |
| Narracja z listą PARAMETRY | Apka powinna to wycinać; zaktualizuj deploy i zapisz produkt ponownie. |
| Surowy HTML w `[opis_dodatkowy1]` | Przez zapis z apki — pole `plainByOfferState` w `description-blocks.json`. Tymczasowo: wariant B w [`szablon_olx`](szablon_olx). |
| Za długi opis | Użyj wariantu **KOMPAKT** lub usuń linie `Wzór`, `Ogrzewanie podłogowe`. |

---

*Dywanowy Bazar — szablon OLX PREMIUM, czerwiec 2026*