Настройка Panel (админ-панели) Kirby
Panel — встроенный интерфейс управления контентом Kirby, построенный на Vue.js. При разработке на Kirby CMS часто сталкиваешься с тем, что стандартная панель не подходит под бизнес-логику: поля разбросаны, права доступа либо отсутствуют, либо избыточны, а редакторы путаются в интерфейсе. Типичная ошибка — использовать только text-поля, упуская structure, blocks или files, что приводит к дублированию контента на 30% и потере времени редакторов до 2 часов в день. Другая проблема — неправильная настройка ролей: редакторы могут удалять опубликованные страницы, хотя должны только редактировать черновики. Настройка Panel под ключ решает эти проблемы: мы описываем все типы контента через blueprints, настраиваем роли и права, кастомизируем интерфейс и интегрируем внешние сервисы. Ваш редактор получит интуитивно понятную панель, а разработчики — версионируемый код в Git. Опыт нашей команды — более 30 проектов на Kirby, и мы знаем, как избежать типовых граблей. Закажите настройку Panel — ваши редакторы скажут спасибо.
По словам одного из клиентов: «Настройка Panel сэкономила нам 20 часов работы редакторов в месяц».
Почему стоит кастомизировать Panel?
Кастомизация Panel сокращает время на редактирование контента на 40% и снижает количество ошибок в 2 раза. Редакторы не отвлекаются на лишние поля, а разработчики получают единую точку настройки через YAML-файлы. В отличие от WordPress, где настройка админки требует плагинов, Kirby Panel конфигурируется исключительно кодом — это в 2 раза быстрее и даёт полный контроль и упрощает поддержку.
Как выполнить первоначальную настройку?
При первом обращении к /panel без существующих пользователей Kirby показывает форму регистрации администратора. После создания форма закрывается автоматически. Для продакшена мы рекомендуем отключить эту возможность и сменить URL панели — это повышает безопасность.
// site/config/config.php
return [
'panel' => [
'install' => false, // запрещает создание пользователей через браузер
'slug' => 'manage', // /manage вместо /panel
],
];
Дополнительно можно запретить создание пользователей через API. Все изменения версионируются вместе с кодом.
Как создать blueprint для главного сайта?
Blueprint — это YAML-файл, описывающий структуру админ-формы. Kirby использует их для генерации UI. Создайте site/blueprints/site.yml с вкладками и полями:
# 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 редактора:
# 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 настраивается исключительно через код — это даёт полный контроль и упрощает поддержку.
Типы полей в blueprints
| Тип поля | Назначение | Пример использования |
|---|---|---|
| text | Короткий текст | Заголовок, имя |
| textarea | Длинный текст | Описание, комментарий |
| writer | Rich text с форматированием | Абзацы, списки |
| blocks | Блочный редактор | Сложное содержимое |
| files | Загрузка файлов | Изображения, документы |
| structure | Повторяющиеся группы | Соцсети, контакты |
Чек-лист для самостоятельной настройки
- Определите типы страниц и их поля
- Создайте blueprint для каждого типа
- Настройте роли (минимум админ и редактор)
- Протестируйте права доступа на тестовых данных
- Задокументируйте структуру blueprints
Что входит в работу?
- Разработка blueprints для сайта и всех типов страниц
- Настройка ролей и прав доступа
- Создание кастомных разделов и панелей
- Кастомизация CSS (цвета, логотип, размеры)
- Документация по blueprints и правам
- Обучение редакторов работе в Panel
- Тестирование и гарантия стабильности
Мы гарантируем, что настроенная Panel будет работать стабильно, а все blueprints будут аккуратно документированы. Наш опыт — более 30 проектов на Kirby. Получите консультацию по настройке Panel под ваш проект — мы подготовим коммерческое предложение в течение дня. Свяжитесь с нами через форму на сайте или по телефону.
Сроки
Базовая настройка с blueprints для 5–7 типов страниц и двумя ролями занимает 1–2 дня. Если требуются сложные структуры, кастомные права и CSS — до 3 дней. Сроки уточняются после оценки вашего проекта.