[Intum Pomoc](https://intum.pl/pomoc.md) / [Szablony](https://intum.pl/pomoc/cms/szablony.md)

# [Szablony](https://intum.pl/pomoc/cms/szablony-cms-lista.md)

Szablon (layout) to zapisany układ HTML - albo cała rama witryny, albo wygląd pojedynczego
paragrafu. Raz zapisany szablon widać na liście i można go przypiąć w wielu miejscach na
raz.

> [!PATH]
> [CMS → Szablony](app:/cms/layouts)

## Rodzaje szablonów {#rodzaje}

Każdy szablon ma **Rodzaj**:

- **strona** - rama całej witryny albo pojedynczej strony (nagłówek, menu, stopka,
  `{{ content }}` w środku). Do wyboru w ustawieniach witryny i w polu **Szablon** strony.
- **paragraf** - własny wygląd pojedynczego paragrafu, alternatywa dla wbudowanego Szablonu
  prezentacji. Do wyboru w polu **Szablon paragrafu**.

## Szablony systemowe {#gotowe-szablony}

Poza własnymi szablonami konta na liście do wyboru zawsze są dwa gotowe **Szablony
systemowe**, do wzięcia bez pisania kodu:

- **Bulma Fresh** - nowoczesna strona firmowa/agencyjna (sekcja hero, górne menu, ikony),
  oparta o Bulma CSS.
- **BIP Prosty 1** - prosty układ w stylu Biuletynu Informacji Publicznej: link „Przejdź do
  treści", przyciski zmiany wielkości czcionki, przełącznik wysokiego kontrastu, breadcrumby
  i menu boczne chowane na telefonie - gotowy pod wymogi dostępności (WCAG).

## Wybór i dostosowanie szablonu w witrynie albo stronie {#wybor-i-dostosowanie}

W formatce witryny albo strony pole **Szablon** to lista pogrupowana na własne szablony konta
i **Szablony systemowe**. Po wybraniu systemowego pod polem pojawia się:

- podgląd kodu (do odczytu),
- **Podgląd** - otwiera wizualny podgląd w nowej karcie (żeby nie stracić niezapisanej
  formatki),
- **Dostosuj** - odblokowuje kod do edycji: zmiany zapisują się jako własna kopia szablonu,
- **Przywróć domyślny** - widoczny po **Dostosuj**, czyści zmiany i wraca do treści z pliku
  systemowego (dopóki formatka nie jest zapisana, to tylko cofnięcie na ekranie).

Bez kliknięcia **Dostosuj** zapis formatki tworzy szablon, który tylko **wskazuje** plik
systemowy - dostanie więc przyszłe poprawki tego szablonu. Po **Dostosuj** zapis tworzy
własną, niezależną kopię kodu, nazwaną `<nazwa witryny/strony> - <nazwa szablonu>` - jej
dalsze poprawki systemowego szablonu już nie dotyczą. W obu przypadkach na liście szablonów
pojawia się nowy wpis, który potem można normalnie edytować jak każdy inny.

## Szablon systemowy w formatce własnego szablonu {#system-template-w-formatce}

Formatka istniejącego już szablonu (nie witryny/strony) ma pole **Szablon systemowy** -
osobne od opisanego wyżej wyboru w witrynie. Tu nie wybiera się gotowego układu do
przypięcia - pole tylko zapamiętuje, z którego pliku systemowego ten szablon powstał (widać
je potem jako etykietę na podglądzie szablonu). Żeby wstawić gotowy kod strony do edytora,
służą przyciski nad polem **Zawartość** ("Wstaw szablon strony") - wklejają HTML wybranego
szablonu systemowego i same ustawiają to pole.

## Lista i filtrowanie {#lista}

Lista szablonów szuka po nazwie i kodzie (pole wyszukiwania) oraz filtruje po **Witrynie**
i **Rodzaju**.

## Przypisanie do witryny {#przypisanie-do-witryny}

Pole **Witryna** określa, gdzie szablon jest do wyboru. Puste - szablon jest wspólny dla
wszystkich witryn konta; przydaje się, gdy kilka witryn ma korzystać z tego samego układu.

## Obraz podglądu {#obraz}

Pole **Obraz** to miniatura pokazywana na liście szablonów, żeby po obrazku rozpoznać układ.
Na samą witrynę nie trafia.

## Gdy coś nie działa {#gdy-cos-nie-dziala}

**Zmieniłem kod systemowego szablonu, a witryna wygląda po staremu.** Zmiany w polu
**Zawartość** działają tylko wtedy, gdy szablon ma już własną kopię (po kliknięciu
**Dostosuj** w formatce witryny/strony albo gdy pole **Szablon systemowy** jest puste). Jeśli
szablon nadal tylko wskazuje plik systemowy, edycja pola **Zawartość** nie ma efektu - trzeba
najpierw kliknąć **Dostosuj** i zapisać. Pełna lista przyczyn:
[Zmieniłem kod szablonu, a podgląd wygląda po staremu](cms/cms-problem-szablon-bez-zmian).

Więcej częstych problemów z samą zawartością szablonu (brak `{{ content }}`, menu nie
pokazujące nowych stron) - patrz [Edytor szablonu](cms/edytor-szablonu-cms#gdy-cos-nie-dziala).