API — Szablony (Layouts)
Endpointy
| Metoda | Ścieżka | Opis |
|---|---|---|
| GET | /cms/layouts.json |
Lista szablonów |
| GET | /cms/layouts/:code.json |
Szczegóły (po code lub id) |
| POST | /cms/layouts.json |
Utworzenie |
| PATCH | /cms/layouts/:code.json |
Aktualizacja |
| DELETE | /cms/layouts/:code.json |
Usunięcie |
Pola
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
code |
string | tak | Unikalny kod (zalecany format: {site_code}-layout) |
name |
string | tak | Nazwa |
kind |
string | tak | Typ — page (szablon strony) lub paragraph (szablon paragrafu) |
content |
string | tak | Szablon HTML z {{ content }} jako placeholder na treść strony |
example_content |
string | nie | Przykładowa treść do podglądu szablonu |
site_id |
integer | nie | ID witryny |
system_template |
string | nie | Kod systemowego szablonu (np. "bulma_fresh") |
image |
file | nie | Obrazek szablonu (załącznik) |
fields |
jsonb | nie | Własne pola |
Ważne
- Szablon musi zawierać
{{ content }}— w tym miejscu wstawiana jest treść strony - Szablony używają Liquid — dostępne zmienne:
{{ site.name }},{{ page.name }},{{ pages }}(lista stron menu),{{ year }},{{ paragraphs }} - Szablon typu
pagestosuje się do stron, typuparagraphdo paragrafów
Filtrowanie
-
?q=fraza— szuka w name, code -
?site_id=1— filtrowanie po witrynie -
?kind=page— filtrowanie po typie