Настройка Panel Kirby: blueprints, права, кастомизация

Настройка 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

В отличие от WordPress, где настройка админ-панели требует плагинов, Kirby Panel настраивается исключительно через код — это даёт полный контроль и упрощает поддержку.

Типы полей в blueprints

Что входит в работу?

• Разработка blueprints для сайта и всех типов страниц
• Настройка ролей и прав доступа
• Создание кастомных разделов и панелей
• Кастомизация CSS (цвета, логотип, размеры)
• Документация по blueprints и правам
• Обучение редакторов работе в Panel
• Тестирование и гарантия стабильности

Мы гарантируем, что настроенная Panel будет работать стабильно, а все blueprints будут аккуратно документированы. Наш опыт — более 30 проектов на Kirby. Получите консультацию по настройке Panel под ваш проект — мы подготовим коммерческое предложение в течение дня. Свяжитесь с нами через форму на сайте или по телефону.

Сроки

Базовая настройка с blueprints для 5–7 типов страниц и двумя ролями занимает 1–2 дня. Если требуются сложные структуры, кастомные права и CSS — до 3 дней. Сроки уточняются после оценки вашего проекта.