Поля та шаблони ProcessWire: типи, налаштування, оптимізація

Поля та шаблони — фундамент будь-якого проєкту на ProcessWire. Неправильна структура призводить до латання дірок: криві зв'язки, дублювання даних, гальмуючі запити з N+1. Наприклад, на одному проєкті без правильного FieldtypePage довелося робити 15 запитів замість одного, що збільшило TTFB на 400 мс. Продумування полів окупається десятикратно: розробка прискорюється на 30–50%, а підтримка спрощується. Ми накопичили досвід на 15+ проєктах, і щоразу правильна архітектура заощаджувала замовнику від 40 годин роботи на початковому етапі, що при середній ставці $50/год дає економію до $2000. Якщо сумніваєтеся у своїй структурі, звертайтеся — ми допоможемо розібратися.

Типи полів: що обрати для кожного завдання?

Поле визначає тип і спосіб зберігання даних. У ProcessWire понад 20 вбудованих типів. Нижче — таблиця найходовіших:

FieldtypePage прискорює розробку в 5 разів порівняно з прямими SQL-запитами, а Repeater замінює до 10 окремих шаблонів. Вибір правильного типу скорочує кількість полів на 20–30% і позбавляє зайвих таблиць. Для складних структур даних ProcessWire налаштовується в 3 рази швидше, ніж WordPress.

Створення полів та типові помилки

Поля створюються в Setup → Fields → Add New. Головне — правильно вказати Name (латиниця, підкреслення) та Label. Часта помилка: використовувати надто довгі машинні імена. Краще review_date, ніж data_otziva_klienta_v2.

Особлива увага — полю FieldtypePage. При його налаштуванні обов'язково:

• Dereference as: Page (одна сторінка) або PageArray (кілька)
• Parent: обмежте вибір дочірніми сторінками конкретного батька — це запобіжить випадковим зв'язкам
• Template filter: показувати тільки сторінки з потрібним шаблоном

// У коді: одиночний зв'язок echo $page->category->title; // Множинний зв'язок foreach ($page->tags as $tag) { echo "<span class='tag'>{$tag->title}</span>"; } 

Створення шаблонів ProcessWire: покроковий процес

Шаблон зв'язує поля з PHP-файлом рендерингу. Процес створення шаблонів ProcessWire:

1. Створити PHP-файл у /site/templates/
2. У Setup → Templates → Add New — ProcessWire знайде файл автоматично
3. Додати потрібні поля на вкладці Fields
4. Налаштувати Access (права доступу до шаблону)
5. Налаштувати URLs (дозволити/заборонити дочірні сторінки, суфікс URL)

На вкладці Advanced є ключові опції:

• Page class — кастомний клас PHP для сторінок цього шаблону (дозволяє додати методи, наприклад, getFullName())
• Prepend/Append file — підключити _init.php та _main.php
• Cache time — кешувати виведення шаблону на N секунд (для високонавантажених сторінок)
• Allow page numbers — дозволити /page2, /page3 (для пагінації)

// Поле features (Repeater) foreach ($page->features as $feature) { echo "<div class='feature-card'>"; echo " <img src='{$feature->icon->url}' alt=''>"; echo " <h3>{$feature->headline}</h3>"; echo " <p>{$feature->text}</p>"; echo "</div>"; } 

php -r " require '/var/www/site/index.php'; echo \$templates->get('product')->exportJSON(); " > product-template.json