# Pisanie treści — opisy kategorii

## Cel dokumentu

Ten dokument jest obowiązującą instrukcją tworzenia, tłumaczenia, wdrażania i kontroli opisów kategorii w sklepach internetowych. Łączy zasady z materiałów szkoleniowych z ustaleniami wypracowanymi przy Figurydeco.pl.

Jeżeli zasada uniwersalna koliduje z ustaleniem projektowym, pierwszeństwo ma ustalenie projektowe opisane w sekcji „Zasady obowiązujące w Figurydeco.pl”.

## 1. Zanim powstanie tekst

Nie pisz opisu wyłącznie na podstawie nazwy kategorii. Najpierw:

1. Otwórz kategorię i sprawdź jej położenie w drzewie.
2. Ustal kategorię nadrzędną, kategorie sąsiednie i podkategorie.
3. Przejrzyj faktycznie dostępne produkty, ich nazwy, materiały, rozmiary, warianty i zastosowania.
4. Zidentyfikuj intencję użytkownika oraz główną frazę kategorii.
5. Sprawdź, czym kategoria różni się od sąsiednich kategorii i produktów.
6. Wybierz 2–3 logiczne cele linkowania wewnętrznego.
7. Zweryfikuj wszystkie fakty o firmie, produktach, dostawie i zwrotach. Nie dopowiadaj informacji, których nie ma w źródłach.

Opis ma wynikać z drzewa kategorii i realnego asortymentu. Nazwa kategorii daje kierunek, ale kontekst produktów decyduje o treści.

## 2. Fundament jakości: Helpful Content, E-E-A-T i 3XCO

### Helpful Content

- Pisz przede wszystkim dla człowieka, nie dla algorytmu.
- Tekst ma pomagać w zrozumieniu oferty i podjęciu decyzji zakupowej.
- Nie lej wody, nie wydłużaj tekstu na siłę i nie mieszaj kilku intencji.
- Każda kategoria musi otrzymać unikalny tekst dopasowany do swojego asortymentu.
- Nie kopiuj całych akapitów pomiędzy kategoriami. Powtarzalne fakty firmowe można przedstawiać za każdym razem innym, naturalnym zdaniem.

### E-E-A-T

Treść powinna pokazywać doświadczenie, wiedzę, wiarygodność i transparentność poprzez konkretne, możliwe do potwierdzenia fakty. Nie twórz sztucznych „cytatów eksperta” w opisach kategorii — takie formy są przeznaczone dla bloga.

### Zasada 3XCO

Każdy opis powinien odpowiadać na trzy pytania:

1. **Co to jest?** Jakie produkty faktycznie znajdują się w kategorii?
2. **Co daje cecha produktu?** Jakie znaczenie ma materiał, rozmiar, forma, wykończenie lub konstrukcja?
3. **Co zyskuje klient?** Do jakiej przestrzeni lub zastosowania produkt może pasować i co ułatwia właściwy wybór?

Korzyść musi wynikać z cechy. Nie stosuj pustych określeń typu „najwyższa jakość”, „wyjątkowy design” czy „idealny wybór” bez konkretnego uzasadnienia.

## 3. Intencja kategorii

Opis kategorii ma intencję komercyjną. Ma prezentować ofertę, cechy, funkcje, zastosowanie i realne różnice pomiędzy modelami.

### Nie zamieniaj kategorii w poradnik

W nagłówkach i głównej narracji nie używaj tematów blogowych, takich jak:

- „jak wybrać...”;
- „jak dobrać...”;
- „co pasuje do...”;
- rozbudowane rankingi i poradniki;
- poboczne zagadnienia informacyjne niezwiązane bezpośrednio z ofertą.

Pytanie w FAQ może mieć naturalną formę konwersacyjną, jeżeli dotyczy asortymentu, wymiarów, materiału, dostawy, ekspozycji lub procesu zamówienia.

## 4. Obowiązkowa struktura opisu kategorii

### H1

- H1 jest nazwą kategorii i zawiera główną frazę.
- Nie dodawaj drugiego H1 w opisie.

### `short_description` — nad produktami

- Krótki lead, maksymalnie około 500 znaków ze spacjami.
- Zawiera główną frazę w naturalnej odmianie.
- Od razu mówi, co znajduje się w kategorii i pomaga rozpocząć przeglądanie oferty.
- Może kończyć się lekkim CTA, ale bez reklamowego banału.
- Jest wyświetlany wyłącznie nad listą produktów.
- Nie może być kopią pierwszego akapitu długiego opisu.

### `long_description` — pod produktami

- Pełny opis jest wyświetlany wyłącznie pod listą produktów.
- Zwykle zawiera 3–4 logiczne sekcje H2 oraz FAQ.
- Długość wynika z szerokości i złożoności kategorii. Nie obowiązuje zasada „im dłużej, tym lepiej”.
- Akapity mają być krótkie i obejmować jedną myśl; orientacyjnie do około 400 znaków, jeżeli temat na to pozwala.
- Listę wypunktowaną stosuj, gdy trzeba czytelnie wymienić więcej niż trzy grupy, cechy lub kryteria. Zwykle wystarczy jedna lista; nie przekraczaj 1–2 list w opisie.

### FAQ

- FAQ znajduje się pod główną częścią długiego opisu.
- Stosuj dokładny nagłówek `<h2>FAQ</h2>`.
- W Figurydeco stosuj dokładnie dwa pytania w `<h3>` i dwie konkretne odpowiedzi.
- Pytania muszą dotyczyć danej kategorii, a nie przypadkowych tematów ogólnych.
- Dobre obszary pytań: dostępne rozmiary, warianty, materiał, sposób ekspozycji, dostawa dużych modeli, kompletacja, zastosowanie w konkretnej przestrzeni.
- Odpowiedź ma być zwięzła, samodzielna i użyteczna — zwykle 1–3 zdania.
- Nie obiecuj cech, których nie da się potwierdzić na karcie produktu.

### Pole techniczne `description`

W obecnej implementacji OpenCart pole `description` może być utrzymywane jako kopia `long_description` dla kompatybilności danych, ale szablon nie może wyświetlać tego samego tekstu dwukrotnie. Na stronie obowiązuje rozdział:

- góra: `short_description`;
- dół: `long_description`.

## 5. Nagłówki, akapity i język

### Nagłówki H2

- Opisują zawartość, cechy, materiały, skalę, zastosowania lub logistykę kategorii.
- Mogą zawierać wariant frazy, ale nie powtarzaj głównej frazy w każdym H2.
- Mają brzmieć jak naturalna polszczyzna, nie jak lista słów kluczowych.
- Unikaj sztucznych sformułowań, np. „dekoracje do otoczenia budynku”. Lepsze są konkretne miejsca: „do ogrodu, na taras lub przy wejściu”.

### Styl

- Pisz konkretnie, naturalnie i na poziomie osoby znającej ofertę.
- Używaj zwykłych słów, krótkich zdań i płynnych przejść między akapitami.
- Nie buduj zdań z automatycznych kalk, abstrakcyjnych rzeczowników i korporacyjnych frazesów.
- Nie rozpoczynaj wszystkich kategorii tym samym schematem.
- Nie powtarzaj tego samego przymiotnika w jednym akapicie.
- Nie nadużywaj wyliczeń, dwukropków i konstrukcji „od X do Y”.
- Po napisaniu wykonaj obowiązkową humanizację: przeczytaj tekst jak klient, usuń zdania brzmiące „AI-owo”, zbyt symetrycznie lub nienaturalnie.

### Boldowanie

- Nie pogrubiaj pojedynczych słów kluczowych.
- Pogrubienie stosuj oszczędnie i tylko dla pełnej korzyści, ważnej wskazówki lub kluczowej odpowiedzi.
- Jeżeli pogrubienie nie poprawia skanowania tekstu, nie używaj go.

## 6. SEO on-page

### Frazy kluczowe

- Używaj frazy głównej i semantycznych wariantów naturalnie, w poprawnych odmianach.
- Orientacyjna częstotliwość to 1–3 użycia na 1000 znaków ze spacjami, ale ważniejsza jest naturalność.
- Fraza główna powinna wystąpić w H1, leadzie, meta title, meta description i sensownie w długim opisie.
- Nie stosuj keyword stuffingu.

### Meta title

- Unikalny dla każdej kategorii.
- Zawiera główny temat kategorii i, gdy mieści się naturalnie, markę `Figurydeco`.
- Najważniejsza fraza powinna znaleźć się możliwie blisko początku.
- Nie kopiuj automatycznie H1, jeśli można zbudować lepszy tytuł wyników wyszukiwania.
- Orientacyjnie utrzymuj około 45–60 znaków, ale nie tnij sensownego tytułu tylko dla sztywnej liczby.

### Meta description

- Unikalny, konkretny opis oferty kategorii.
- Zawiera główną frazę lub jej naturalny wariant, najważniejsze grupy produktów i lekkie zaproszenie do sprawdzenia oferty.
- Nie wpisuj obietnic nieobecnych w treści i na produktach.
- Praktyczny zakres projektu: około 110–155 znaków.

### Unikanie kanibalizacji

- Kategoria opisuje grupę produktów, nie szczegół jednego modelu.
- Opis produktu koncentruje się na konkretnych wymiarach, cechach i wariancie danego produktu.
- Blog odpowiada na szerokie pytania informacyjne; kategoria zachowuje intencję zakupową.

## 7. Linkowanie wewnętrzne

### Cel

Linki pomagają użytkownikowi przejść do logicznie powiązanej części oferty, wspierają indeksację, przepływ autorytetu oraz zrozumienie drzewa kategorii przez Google.

### Zasady uniwersalne

- Linkuj do kategorii nadrzędnej, równorzędnej lub logicznie powiązanej podkategorii.
- Anchor ma opisywać stronę docelową i być naturalną częścią zdania.
- Dywersyfikuj anchory; nie używaj wszędzie identycznej frazy exact match.
- Link umieszczaj w kontekście, nie jako przypadkowy dopisek na końcu akapitu.
- Nie linkuj do niedostępnych, pustych lub nieistniejących kategorii.
- W tłumaczeniach zachowaj adres `href`, ale przetłumacz anchor na język docelowy.

### Wiążąca zasada Figurydeco

- Stosuj **2–3 linki wewnętrzne na opis, nie więcej**.
- Linkuj przede wszystkim do kategorii sąsiednich i nadrzędnej, zgodnie z drzewem oraz realnym asortymentem.
- Na tym etapie **nie uwzględniaj bloga**.
- Nie dodawaj linku tylko dlatego, że istnieje — musi pomagać w dalszym przeglądaniu oferty.
- Nie twórz sztucznych bloków typu „zobacz również”. Link wplataj w zdanie.

### Kategorie markowe — reguła uniwersalna

Jeżeli sklep posiada kategorie markowe lub modelowe, linkuj w obrębie tej samej marki: do głównej kategorii marki i logicznie powiązanych modeli. Nie łącz przypadkowo konkurencyjnych marek. W Figurydeco tę regułę stosuje się odpowiednio do rodzin motywów, stylów i sąsiednich kategorii, zawsze w limicie 2–3 linków.

## 8. Zasady obowiązujące w Figurydeco.pl

### Zatwierdzone fakty E-E-A-T

- Figurydeco działa od **2021 roku**. Nigdy nie wpisuj 2010 roku.
- Producenci i manufaktury mają ponad 30 lat doświadczenia.
- Figury są zamawiane bezpośrednio w fabrykach i manufakturach z Nowej Soli.
- Obowiązujące sformułowanie sensu: **„Figury zamawiamy bezpośrednio w fabrykach i manufakturach z Nowej Soli.”**
- Nie pisz „asortyment kupujemy”. To ważna różnica językowa i wizerunkowa.
- Figury z żywicy są ręcznie malowane lakierem.
- Figury z betonu mogą być ręcznie patynowane.
- Każda sztuka przechodzi kontrolę jakości przed wysyłką.
- Dostawa zależy od gabarytu: paczka, paleta, a przy największych instalacjach możliwy jest transport własny.
- Możliwe są realizacje indywidualne i figury XL, jeżeli kontekst kategorii tego wymaga.
- Zatwierdzone krótkie hasło: **„Ręcznie wykonane figury z żywicy oraz z betonu.”**

### Dane BOK do użycia w odpowiednim FAQ lub bloku kontaktowym

- E-mail: `bok@figurydeco.pl`
- Telefon: `+48 698 803 200`
- Nazwa nadawcy wiadomości sklepu: `BOK Figurydeco.pl`

Nie zapisuj danych logowania ani haseł SMTP w treściach, wytycznych contentowych lub publicznych materiałach.

### Informacje zakazane lub wymagające ostrożności

Nie używaj następujących twierdzeń:

- „autorskie projekty” lub „autorskie figury”;
- „100% mrozoodporne”;
- realizacje w kolorach RAL jako ogólna korzyść detaliczna;
- niepotwierdzone liczby opinii, średnie ocen i inne sztuczne dowody społeczne;
- „30 dni na zwrot”;
- „Figurydeco działa od 2010 roku”;
- informacji o autorstwie wzorów, której nie da się potwierdzić;
- zapewnień, że każdy produkt nadaje się na zewnątrz, jeżeli karta produktu tego nie potwierdza.

Jeżeli zwrot pojawia się w FAQ, podawaj **14 dni zgodnie z obowiązującym prawem i regulaminem**. Nie eksponuj tego mocniej, niż wymaga pytanie użytkownika. Przy kwestiach prawnych zawsze sprawdź aktualny regulamin i przepisy przed publikacją.

### Precyzyjne rozróżnienie materiałów

Nie mieszaj technologii wykończenia:

- żywica → ręczne malowanie lakierem;
- beton → możliwe ręczne patynowanie.

Nie przypisuj wszystkim produktom obu procesów. Jeżeli kategoria obejmuje jeden materiał, pisz tylko o właściwym procesie.

## 9. Styl strony i prezentacja opisu

- Pole długiego opisu ma wykorzystywać 100% szerokości właściwego pola roboczego, bez sztucznego zwężania kolumny.
- Zachowaj czytelne, równe odstępy pomiędzy sekcjami H2, akapitami, listami i FAQ.
- Nagłówek nie może „przyklejać się” do poprzedniej listy lub akapitu.
- FAQ znajduje się pod długim opisem i jest wizualnie oddzielone od wcześniejszej sekcji.
- Długi tekst może działać w sekcji „Pokaż więcej / Pokaż mniej”, ale całość musi pozostawać dostępna w kodzie strony.
- Styl wszystkich kategorii musi być spójny: typografia, szerokość, odstępy, przyciski rozwijania i akordeon FAQ.
- Po wdrożeniu sprawdź widok desktopowy i mobilny.

## 10. Kolejność pracy i content plan

1. Zbuduj listę wszystkich aktywnych kategorii wraz z `category_id`, poziomem drzewa, rodzicem i adresem URL.
2. Zacznij od kategorii głównych.
3. Następnie opracuj kolejno wszystkie poziomy drzewa: poziom 1, poziom 2, poziom 3 i kolejne.
4. Dla każdej kategorii zaplanuj frazę, kontekst produktów i 2–3 linki wewnętrzne.
5. Najpierw ukończ oraz zatwierdź język polski.
6. Dopiero po zakończeniu polskiego wykonuj tłumaczenia.
7. Kolejność tłumaczeń w projekcie: czeski, słowacki, litewski.
8. Wdrażaj opisy do właściwych kategorii, nie pozostawiaj ich wyłącznie w plikach roboczych.
9. Po każdej partii wykonaj walidację lokalną, a po wdrożeniu audyt produkcyjny.

## 11. Zasady tłumaczeń

- Tłumacz sens, nie szyk zdań słowo w słowo.
- Tekst ma brzmieć jak napisany przez native speakera danego języka.
- Tłumacz lead, cały długi opis, H2, FAQ, pytania H3, meta title, meta description i anchory.
- Zachowuj bez zmian adresy `href`, identyfikatory kategorii i strukturę HTML.
- Nie zmieniaj zatwierdzonych faktów E-E-A-T.
- W każdym języku wykonaj osobną humanizację i kontrolę nienaturalnych kalk.
- Nie tłumacz nieaktywnego języka tylko dlatego, że istnieje w bazie.

Konfiguracja obecnego projektu:

- polski — `language_id=2`;
- czeski — `language_id=3`;
- słowacki — `language_id=4`;
- litewski — `language_id=5`;
- nieaktywny angielski — `language_id=1`, pozostawić bez zmian.

## 12. Wzorzec techniczny HTML

```html
<!-- short_description: nad produktami -->
<p>Krótki, konkretny lead opisujący zawartość kategorii i skalę oferty.</p>

<!-- long_description: pod produktami -->
<h2>Naturalny nagłówek o najważniejszej grupie produktów</h2>
<p>Konkretna informacja wynikająca z asortymentu kategorii.</p>
<p>Naturalnie wpleciony link do <a href="URL-KATEGORII">powiązanej kategorii</a>.</p>

<h2>Materiał, wykończenie lub skala</h2>
<p>Informacja dopasowana do rzeczywistych produktów, bez uogólnień.</p>

<h2>Doświadczenie, kontrola jakości lub dostawa</h2>
<p>Zatwierdzony fakt E-E-A-T przedstawiony naturalnym językiem.</p>

<h2>FAQ</h2>
<h3>Pytanie bezpośrednio dotyczące tej kategorii?</h3>
<p>Krótka i jednoznaczna odpowiedź.</p>
<h3>Drugie pytanie ważne przed zamówieniem?</h3>
<p>Krótka odpowiedź, ewentualnie z naturalnym linkiem do kategorii sąsiedniej.</p>
```

## 13. Obowiązkowa kontrola przed publikacją

### Treść i fakty

- [ ] Opis odpowiada realnej zawartości kategorii.
- [ ] Lead ma maksymalnie około 500 zzs i nie powtarza pierwszego akapitu.
- [ ] Tekst realizuje zasadę 3XCO.
- [ ] Wszystkie fakty E-E-A-T są prawdziwe i zatwierdzone.
- [ ] W tekście nie ma 2010 roku, „autorskich figur”, „100% mrozoodporności”, RAL, niepotwierdzonych opinii ani 30 dni na zwrot.
- [ ] Właściwie rozróżniono żywicę i beton.
- [ ] Użyto „figury zamawiamy”, a nie „asortyment kupujemy”.

### SEO i język

- [ ] H1, lead, meta title i meta description wspierają tę samą intencję.
- [ ] Frazy są odmienione naturalnie i nie są upychane.
- [ ] Nagłówki nie powtarzają mechanicznie frazy głównej.
- [ ] Opis nie zamienia kategorii w artykuł poradnikowy.
- [ ] Meta title i meta description są unikalne.
- [ ] Tekst został przeczytany na głos i nie brzmi jak automatyczny tekst AI.
- [ ] Nie ma powtórzeń, pustych superlatywów i nienaturalnych sformułowań.

### Linkowanie

- [ ] Są dokładnie 2–3 logiczne linki wewnętrzne.
- [ ] Linki prowadzą do istniejących kategorii nadrzędnych, sąsiednich lub podkategorii.
- [ ] Na obecnym etapie nie ma linków do bloga.
- [ ] Anchory są naturalne, zróżnicowane i opisują cel linku.
- [ ] W tłumaczeniu `href` pozostał bez zmian, a anchor został przetłumaczony.

### HTML i wdrożenie

- [ ] `short_description` wyświetla się tylko nad produktami.
- [ ] `long_description` wyświetla się tylko pod produktami.
- [ ] Nie ma duplikacji tego samego opisu nad i pod listą produktów.
- [ ] Jest dokładnie jedno `<h2>FAQ</h2>` i dokładnie dwa pytania `<h3>`.
- [ ] HTML jest poprawny, a wszystkie znaczniki są domknięte.
- [ ] Opis korzysta z pełnej szerokości pola roboczego i ma prawidłowe odstępy.
- [ ] „Pokaż więcej / Pokaż mniej” działa na desktopie i urządzeniach mobilnych.
- [ ] FAQ oraz dane BOK są poprawne.

### Audyt zbiorczy i produkcyjny

- [ ] Każda aktywna kategoria ma lead, długi opis, meta title i meta description we wszystkich aktywnych językach.
- [ ] Liczba opisów zgadza się z content planem i liczbą aktywnych kategorii.
- [ ] Wszystkie migracje wykonały się bez błędu.
- [ ] Po wdrożeniu wyczyszczono wymagane cache.
- [ ] Na produkcji sprawdzono reprezentatywne kategorie z każdego poziomu drzewa i każdego języka.
- [ ] Linki prowadzą do poprawnych stron, FAQ działa, a tekst nie jest zduplikowany.
- [ ] W bazie i na stronie nie występują zakazane sformułowania.

## 14. Szybki test jakości jednego opisu

Opis można uznać za gotowy tylko wtedy, gdy odpowiedź na każde pytanie brzmi „tak”:

1. Czy po przeczytaniu leadu wiadomo, co znajduje się w kategorii?
2. Czy tekst zawiera informacje, których nie da się wkleić bez zmian do dowolnej innej kategorii?
3. Czy klient rozumie różnice w rozmiarach, materiałach, wariantach lub zastosowaniu?
4. Czy każdy fakt można obronić kartą produktu albo zatwierdzoną informacją firmową?
5. Czy 2–3 linki faktycznie pomagają przejść do kolejnego logicznego miejsca?
6. Czy FAQ odpowiada na realne pytania przed zakupem?
7. Czy tekst brzmi naturalnie, a nie jak wygenerowany szablon?
8. Czy meta title i meta description wiernie opisują ofertę?
9. Czy lead i długi opis są wyświetlane w prawidłowych miejscach bez duplikacji?
10. Czy po publikacji opis został sprawdzony na żywej stronie?

## 15. Źródła zasad

Dokument powstał na podstawie:

- „ZASADA LINKOWANIA WEWNĘTRZNEGO W OPISACH KATEGORII MARKOWYCH”;
- „UNIWERSALNE WYTYCZNE OPISU SEO”;
- „WYTYCZNE DO OPISU KATEGORII”;
- ustaleń projektowych i korekt redakcyjnych wypracowanych podczas wdrażania opisów Figurydeco.pl.