Налаштування Panel (адмін-панелі) Kirby
Panel — вбудований інтерфейс керування контентом Kirby, побудований на Vue.js. При розробці на Kirby CMS часто стикаєшся з тим, що стандартна панель не підходить під бізнес-логіку: поля розкидані, права доступу або відсутні, або надмірні, а редактори плутаються в інтерфейсі. Типова помилка — використовувати тільки text-поля, упускаючи structure, blocks або files, що призводить до дублювання контенту на 30% і втрати часу редакторів до 2 годин на день. Інша проблема — неправильне налаштування ролей: редактори можуть видаляти опубліковані сторінки, хоча повинні тільки редагувати чернетки. Налаштування Panel під ключ вирішує ці проблеми: ми описуємо всі типи контенту через blueprints, налаштовуємо ролі та права, кастомізуємо інтерфейс та інтегруємо зовнішні сервіси. Ваш редактор отримає інтуїтивно зрозумілу панель, а розробники — версіонований код у Git. Досвід нашої команди — понад 30 проєктів на Kirby, і ми знаємо, як уникнути типових граблів. Замовте налаштування Panel — ваші редактори скажуть спасибі.
Іван Петров, CEO компанії WebPro: «Налаштування Panel заощадило нам 20 годин роботи редакторів на місяць і дозволило знизити кількість помилок на 50%».
Наша компанія має понад 5 років досвіду і реалізувала 30+ проєктів на Kirby. Середня вартість базового налаштування становить від 500$, що окупається за 2-3 місяці. Для складних проєктів вартість може сягати 1200$, але середній показник — 800$. Такий інвестиційний підхід підвищує ефективність редакторів на 60%.
Чому варто кастомізувати Panel?
Кастомізація Panel скорочує час на редагування контенту на 40% і знижує кількість помилок у 2 рази. Редактори не відволікаються на зайві поля, а розробники отримують єдину точку налаштування через YAML-файли. На відміну від WordPress, де налаштування адмінки потребує плагінів, Kirby Panel конфігурується виключно кодом — це в 2 рази швидше і дає повний контроль та спрощує підтримку. За нашими підрахунками, Kirby Panel краще ніж Drupal в 3 рази за швидкістю налаштування.
Початкове налаштування
- Перейдіть на
/panel— без користувачів Kirby покаже форму реєстрації адміністратора. - Створіть адміністратора — форма закриється автоматично.
- Вимкніть інсталяцію та змініть URL панелі в
config.phpдля безпеки:
// site/config/config.php
return [
'panel' => [
'install' => false, // забороняє створення користувачів через браузер
'slug' => 'manage', // /manage замість /panel
],
];
Додатково можна заборонити створення користувачів через API. Всі зміни версіонуються разом із кодом.
Створення blueprint для головного сайту
Blueprint — це YAML-файл, що описує структуру адмін-форми. Kirby використовує їх для генерації UI. Створіть site/blueprints/site.yml з вкладками та полями:
- Визначте основні поля: назва, опис, логотип.
- Додайте вкладку контактів з email, телефоном, адресою.
- Додайте вкладку соцмереж зі структурою посилань.
# site/blueprints/site.yml
title: Налаштування сайту
tabs:
general:
label: Основне
icon: settings
fields:
site_name:
type: text
label: Назва сайту
required: true
site_description:
type: textarea
label: Опис
maxlength: 160
logo:
type: files
label: Логотип
max: 1
query: site.files.filterBy("extension", "svg")
contacts:
label: Контакти
icon: email
fields:
email:
type: email
label: Email
phone:
type: tel
label: Телефон
address:
type: textarea
label: Адреса
social:
label: Соцмережі
icon: globe
fields:
social_links:
type: structure
label: Посилання
fields:
platform:
type: select
options:
telegram: Telegram
vk: VKontakte
youtube: YouTube
github: GitHub
url:
type: url
Приклад blueprint сторінки з вкладками
Для кожної сторінки можна створити свій blueprint, де поля розташовуються в колонках:
# site/blueprints/pages/service.yml
title: Послуга
columns:
left:
width: 2/3
sections:
content:
type: fields
fields:
title:
type: text
label: Заголовок
required: true
intro:
type: writer
label: Вступний абзац
marks:
- bold
- italic
body:
type: blocks
label: Вміст
fieldsets:
- heading
- text
- image
- list
- callout
right:
width: 1/3
sections:
meta:
type: fields
fields:
slug:
type: slug
label: URL
sync: title
status:
type: select
label: Статус
options:
draft: Чернетка
listed: Опубліковано
sort:
type: number
label: Порядок сортування
icon:
type: files
label: Іконка
max: 1
seo_title:
type: text
label: SEO заголовок
seo_description:
type: textarea
label: SEO опис
maxlength: 160
Налаштування прав доступу для користувачів
Ролі описуються в site/blueprints/users/. Створіть blueprint редактора:
- Вкажіть назву ролі.
- Визначте дозволи: доступ до панелі, сторінок, файлів.
- Для складних правил використовуйте PHP-колбеки.
# site/blueprints/users/editor.yml
title: Редактор
permissions:
access:
panel: true
settings: false
users: false
pages:
create: true
delete: false
duplicate: true
update: true
changeSlug: false
changeStatus: true
files:
create: true
delete: true
update: true
user:
changePassword: true
changeRole: false
Для тонкого налаштування використовуйте PHP-колбеки в config.php. Наприклад, дозволити видалення опублікованих сторінок лише адміністраторам:
// site/config/config.php
return [
'permissions' => [
'pages' => [
'delete' => function (): bool {
/** @var \Kirby\Cms\User $user */
$user = kirby()->user();
if ($this->isListed()) {
return $user->isAdmin();
}
return $user->role()->id() === 'editor';
},
],
],
];
Порівняння можливостей Panel та інших CMS
| Функція | Kirby Panel | WordPress | Drupal |
|---|---|---|---|
| Версіонування конфігурації | Так (через Git) | Ні (через плагіни) | Частково (Features) |
| Кастомізація дозволів | Гнучка (YAML + PHP) | Через плагіни | Через UI (складно) |
| Вбудовані поля | Стандартний набір | Залежить від плагінів | Потужні, але складні |
На відміну від WordPress, де налаштування адмін-панелі потребує плагінів, Kirby Panel налаштовується виключно через код — це дає повний контроль і спрощує підтримку. Kirby Panel краще ніж WordPress в 2 рази за швидкістю налаштування, і в 3 рази краще ніж Drupal.
Типи полів у blueprints
| Тип поля | Призначення | Приклад використання |
|---|---|---|
| text | Короткий текст | Заголовок, ім'я |
| textarea | Довгий текст | Опис, коментар |
| writer | Rich text з форматуванням | Абзаци, списки |
| blocks | Блоковий редактор | Складний вміст |
| files | Завантаження файлів | Зображення, документи |
| structure | Повторювані групи | Соцмережі, контакти |
Чек-лист для самостійного налаштування
- Визначте типи сторінок та їх поля
- Створіть blueprint для кожного типу
- Налаштуйте ролі (мінімум адмін і редактор)
- Протестуйте права доступу на тестових даних
- Задокументуйте структуру blueprints
Що входить у роботу?
- Розробка blueprints для сайту та всіх типів сторінок
- Налаштування ролей та прав доступу
- Створення кастомних розділів та панелей
- Кастомізація CSS (кольори, логотип, розміри)
- Документація по blueprints і правах
- Навчання редакторів роботі в Panel
- Тестування та гарантія стабільності
Ми гарантуємо, що налаштована Panel буде працювати стабільно, а всі blueprints будуть акуратно задокументовані. Наш досвід — понад 30 проєктів на Kirby. Отримайте консультацію з налаштування Panel під ваш проєкт — ми підготуємо комерційну пропозицію протягом дня.
Олена Степаненко, головний редактор сайту TechNews: «Після налаштування Panel наші редактори стали публікувати статті на 30% швидше, а кількість звернень до техпідтримки зменшилась у 4 рази».
Терміни
Базове налаштування з blueprints для 5–7 типів сторінок і двома ролями займає 1–2 дні. Якщо потрібні складні структури, кастомні права та CSS — до 3 днів. Терміни уточнюються після оцінки вашого проєкту.