Налаштування колекцій та записів Statamic
Колекції — основна одиниця організації контенту в Statamic. Аналог Post Types у WordPress, але більш гнучка: визначає URL-структуру, порядок, древовидність та Blueprint для кожного типу записів.
Створення колекції
php artisan statamic:make:collection blog
php artisan statamic:make:collection pages --structure
Конфіг колекції:
# content/collections/blog.yaml
title: Blog
template: blog/show
layout: layout
date: true
date_behavior:
past: public
future: private # приховуємо відкладені публікації
sort_field: date
sort_direction: desc
paginate: 12
slugs: true
propagate: false
routes: '/blog/{slug}'
Структуровані колекції (сторінки)
# content/collections/pages.yaml
title: Pages
template: page
layout: layout
routes: '/{parent_uri}/{slug}'
structure:
root: true # кореневі сторінки без parent
max_depth: 3
expects_root: true
Запис (Entry) у файловій системі
# content/collections/blog/2024-03-15.my-first-post.md
---
id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
title: My First Post
slug: my-first-post
date: 2024-03-15
template: blog/show
blueprint: post
published: true
categories:
- key: web-development
featured_image: assets/images/hero.jpg
excerpt: Короткий опис посту
---
Вміст посту в Markdown.
Запрос записів у шаблонах
{{# Базовий запрос #}}
{{ collection:blog }}
{{ title }} — {{ date format="d.m.Y" }}
{{ /collection:blog }}
{{# З фільтрацією та сортуванням #}}
{{ collection:blog
status:is="published"
sort="date:desc"
limit="6"
taxonomy:categories="web-development"
}}
{{ results }}
{{ partial:blog/post-card :post="this" }}
{{ /results }}
{{ /collection:blog }}
{{# Фільтр за кастомним полем #}}
{{ collection:events
where:event_date:gte="{ now }"
sort="event_date:asc"
limit="10"
}}
{{# Через кілька колекцій #}}
{{ collection from="blog|news|press-releases"
sort="date:desc"
limit="10"
}}
PHP-заприти через API
use Statamic\Facades\Entry;
use Statamic\Facades\Collection;
// Отримання записів
$posts = Entry::query()
->where('collection', 'blog')
->where('status', 'published')
->orderBy('date', 'desc')
->limit(10)
->get();
// Один запис за slug
$post = Entry::query()
->where('collection', 'blog')
->where('slug', $slug)
->first();
// Запис за ID
$entry = Entry::find('a1b2c3d4-e5f6-7890');
Таксономії: категорії та теги
# content/taxonomies/categories.yaml
title: Categories
route: '/blog/category/{slug}'
collection:
- blog
- news
{{# Список всіх категорій з кількістю #}}
{{ taxonomy:categories sort="title:asc" }}
<a href="{{ url }}">{{ title }} ({{ entries_count }})</a>
{{ /taxonomy:categories }}
Налаштування 3–5 колекцій з правильними маршрутами та таксономіями — 4–8 годин.