Настройка Collections и Entries Statamic

Настройка Collections и Entries Statamic

Collections — основная единица организации контента в Statamic. Аналог Post Types в WordPress, но более гибкая: определяет URL-структуру, порядок, древовидность и Blueprint для каждого типа записей.

Создание Collection

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: Short description of the post
---
Content of the post in Markdown.

Запрос Entries в шаблонах

{{# Базовый запрос #}}
{{ 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');

Taxonomies: категории и теги

# 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 коллекций с правильными маршрутами и taxonomies — 4–8 часов.