Як кастомні Twig-шаблони Craft CMS усувають N+1 та оптимізують LCP

Matrix-поля Craft CMS не відображаються коректно, Live Preview видає помилки, а сторінки завантажуються з LCP > 4 с. Стандартні шаблони часто не справляються зі складною структурою контенту. Замовте кастомні Twig-шаблони та отримайте перші результати вже через 4 дні. Ми вирішили цю проблему для понад 50 проєктів — від корпоративних сайтів до медіа-порталів із тисячами записів. Нижче розберемо, які технічні складнощі усувають кастомні Twig-шаблони та як їх розробка окупається.

Чому кастомні Twig-шаблони швидші за стандартні?

Кастомні шаблони дозволяють повністю контролювати генерацію HTML. У стандартних шаблонах часто зустрічаються N+1 запити — цикл із зверненнями до пов'язаних елементів. Як зазначено в документації Craft CMS: Eager-loading drastically reduces query count. Ми використовуємо eager-loading через with(), що скорочує кількість SQL-запитів у 3–5 разів. Також застосовуємо кешування {% cache %} та оптимізуємо зображення через Image Transforms із WebP і srcset. У результаті TTFB падає до 200–400 мс, а LCP виявляється нижче 2.5 с.

Наші кастомні Twig-шаблони для Craft CMS завантажуються в 2-3 рази швидше за стандартні, що підтверджується тестами Core Web Vitals.

Які проблеми вирішуємо

N+1 запитів та повільне завантаження

У стандартних шаблонах часто зустрічається звернення до пов'язаних елементів всередині циклу — наприклад, post.categories.all(). Кожен виклик створює окремий SQL-запит. Ми використовуємо with() та eager-loading прямо в контролері або в entry-типі. Результат — TTFB падає до 200–400 мс, а загальна продуктивність зростає.

Неповне відображення Matrix-блоків

Якщо в адмінці налаштовано 10 типів блоків, а шаблон обробляє лише 3 — контент-менеджери не зможуть використовувати решту. Ми реалізуємо повний switch по кожному block.type, з окремими partial-компонентами та стилями.

Помилки в SEO-мета-тегах

Відсутність Open Graph, невірний alt для зображень, дублювання title — часті проблеми. У кастомних шаблонах ми задаємо {% block meta %} для кожної сторінки, динамічно формуємо description та зображення. Наприклад, у зображень прописуємо alt="кастомний Twig шаблон Craft CMS", щоб покращити семантику.

Як ми це робимо: кейс із нашої практики

Наш клієнт — медіа-портал із 5000+ записів. Ми замінили стандартні шаблони на кастомні. Спершу сторінка категорії виконувала 78 SQL-запитів і завантажувалася за 6 секунд. Після рефакторингу з eager-loading та кешуванням кількість запитів скоротилася до 12, а LCP знизився до 1.8 с — це в 3,3 рази швидше. Додатково налаштували Image Transforms для WebP і додали lazy-load для зображень. Контент-менеджери тепер можуть використовувати всі 8 типів Matrix-блоків без доробок. Клієнт заощадив близько 30% бюджету на хостингу завдяки зменшенню навантаження.

Покрокова інструкція з налаштування кастомного шаблону

1. Аналіз структури контенту: вивчаємо entry-типи, Matrix-поля, типи відносин.
2. Проектування layout-ів: створюємо _layouts/ (base, default, fullwidth) та _components/ (header, footer).
3. Реалізація з eager-loading: у контролерах і шаблонах використовуємо with() для підвантаження пов'язаних елементів.
4. Налаштування Matrix-блоків: пишемо switch для кожного типу блоку з окремим partial-компонентом.
5. Кешування: застосовуємо {% cache %} для часто запитаних блоків (навігація, сайдбари).
6. Тестування Live Preview: перевіряємо всі entry-типи та мобільну верстку.
7. Дефолтна оптимізація зображень: налаштовуємо WebP та srcset через Image Transforms.

Що входить у роботу

• Вихідні коди всіх шаблонів (Twig).
• Налаштовані Image Transforms (якщо потрібні).
• Документація по макросах та partial-компонентах.
• Інструкція з розгортання.
• 14 днів гарантійної підтримки після деплою.
• Навчання контент-менеджерів роботі з Matrix-полями (при необхідності).

Процес роботи

Як ми налаштовуємо Live Preview для всіх entry-типів?

Для кожного entry-типу створюємо окремий шаблон _entry.twig у відповідній папці. У ньому наслідуємо базовий layout та перевизначаємо блоки content і meta. Live Preview підхоплює правильний шаблон автоматично, якщо дотримана структура папок templates/ з іменем entry-типу. Додатково перевіряємо, що craft.app.request.getSegment не викликає помилок при прев'ю.

Чому варто замовити кастомні шаблони у нас?

Понад 5 років досвіду з Craft CMS — ми знаємо, як працюють pagination, Image Transforms, globals та relations. Кожен проєкт отримує гарантію сумісності з останньою стабільною версією Craft CMS та PHP 8.1+. Оптимізація Core Web Vitals: LCP < 2.5 с завдяки fetchpriority та lazy-load. Економія до 40% на підтримці за рахунок спрощення шаблонів. Повна документація по кожному макросу та partial-компоненту. Для подробиць щодо eager-loading дивіться документацію Craft CMS. Зв'яжіться з нами для оцінки вашого проєкту — отримайте консультацію. Середній чек проєкту — 1500$.

Приклади коду

Базова структура шаблонів:

templates/
├── _layouts/
│   ├── base.twig
│   ├── default.twig
│   └── fullwidth.twig
├── _components/
│   ├── header.twig
│   ├── footer.twig
│   ├── post-card.twig
│   └── breadcrumbs.twig
├── _macros/
│   └── helpers.twig
├── index.twig
├── 404.twig
├── blog/
│   ├── index.twig
│   └── _entry.twig
└── services/
    ├── index.twig
    └── _entry.twig

Базовий layout (base.twig):

<!DOCTYPE html>
<html lang="{{ craft.app.language }}">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>{% block title %}{{ siteName }}{% endblock %}</title>
    {% block meta %}{% endblock %}
    {{ craft.vite.stylesheet('src/css/app.pcss') }}
</head>
<body class="{% block bodyClass %}{% endblock %}">
    {% include '_components/header' %}
    <main id="main" tabindex="-1">
        {% block content %}{% endblock %}
    </main>
    {% include '_components/footer' %}
    {{ craft.vite.script('src/js/app.ts') }}
    {% block scripts %}{% endblock %}
</body>
</html>

Обробка Matrix-блоків:

<div class="post-body">
    {% for block in entry.pageContent.all() %}
        {% switch block.type %}
            {% case 'richText' %}
                <div class="prose">{{ block.body }}</div>
            {% case 'pullQuote' %}
                <blockquote>
                    <p>{{ block.quote }}</p>
                    {% if block.attribution %}<cite>{{ block.attribution }}</cite>{% endif %}
                </blockquote>
            {% case 'imageBlock' %}
                {% set img = block.image.one() %}
                {% if img %}
                    <figure>
                        <img src="{{ img.getUrl({ width: 1200 }) }}" alt="{{ img.alt }}">
                        {% if block.caption %}<figcaption>{{ block.caption }}</figcaption>{% endif %}
                    </figure>
                {% endif %}
            {% case 'codeSnippet' %}
                <pre><code class="language-{{ block.language }}">{{ block.code | escape }}</code></pre>
        {% endswitch %}
    {% endfor %}
</div>

Макроси та Image Transforms:

// config/image-transforms.php
return [
    'thumbnail' => [
        'width' => 400,
        'height' => 300,
        'mode' => 'crop',
    ],
    'large' => [
        'width' => 1200,
        'height' => 630,
        'mode' => 'crop',
    ],
    'avatar' => [
        'width' => 100,
        'height' => 100,
        'mode' => 'crop',
        'position' => 'center-center',
    ],
    'ogImage' => [
        'width' => 1200,
        'height' => 630,
        'mode' => 'crop',
        'format' => 'jpg',
    ],
];

{# templates/_macros/helpers.twig #}
{% macro truncate(text, length = 150) %}
    {% if text | length > length %}
        {{ text | slice(0, length) }}…
    {% else %}
        {{ text }}
    {% endif %}
{% endmacro %}
{% macro breadcrumbs(entry) %}
    <nav aria-label="Хлібні крихти">
        <a href="/">Головна</a>
        {% for ancestor in entry.getAncestors() %}
            <a href="{{ ancestor.url }}">{{ ancestor.title }}</a>
        {% endfor %}
        <span aria-current="page">{{ entry.title }}</span>
    </nav>
{% endmacro %}

Всі шаблони проходять код-рев'ю та оптимізуються під Core Web Vitals. Якщо у вас нестандартна бізнес-логіка — додамо підтримку custom fields, relations та events. Замовте кастомні шаблони та переконайтеся в їх ефективності.