README

mb4it/bitrix-admin-kit — Bitrix-first пакет для построения административных CRUD-разделов на базе D7 ORM и нативных Bitrix UI-компонентов (main.ui.grid, main.ui.filter, SidePanel).

Требования

• PHP ^8.2
• 1C-Битрикс с D7 ORM
• Composer

Установка

composer require mb4it/bitrix-admin-kit

Подробные шаги подключения: Documentation → Installation.

Минимальный Resource (ORM CRUD)

<?php

declare(strict_types=1);

namespace Vendor\Demo\Admin;

use MB\Bitrix\AdminKit\Action\BulkAction;
use MB\Bitrix\AdminKit\Action\RowAction;
use MB\Bitrix\AdminKit\Field\ID;
use MB\Bitrix\AdminKit\Field\Switcher;
use MB\Bitrix\AdminKit\Field\Text;
use MB\Bitrix\AdminKit\Filter\Types\TextFilter;
use MB\Bitrix\AdminKit\Resource\DataManagerResource;
use Vendor\Demo\Orm\ProductTable;

final class ProductResource extends DataManagerResource
{
    protected string $title = 'Товары';

    public function dataManagerClass(): string
    {
        return ProductTable::class;
    }

    public function indexFields(): iterable
    {
        return [
            ID::make('ID', 'ID'),
            Text::make('Название', 'NAME'),
            Switcher::make('Активен', 'ACTIVE'),
        ];
    }

    public function formFields(): iterable
    {
        return [
            Text::make('Название', 'NAME')->required(),
            Switcher::make('Активен', 'ACTIVE')->default(true),
        ];
    }

    public function filters(): iterable
    {
        return [
            TextFilter::make('Название', 'NAME')->contains(),
        ];
    }

    public function rowActions(): iterable
    {
        return [
            RowAction::view(),
            RowAction::edit(),
            RowAction::delete(),
        ];
    }

    public function bulkActions(): iterable
    {
        return [
            BulkAction::delete(),
        ];
    }
}

Ключевые возможности

• CRUD для D7 ORM через DataManagerResource.
• Grid на bitrix:main.ui.grid и фильтры на main.ui.filter.
• RowAction / BulkAction, включая безопасные массовые операции.
• Standalone-страницы: OptionsPage, DashboardPage, CustomPage.
• Bitrix-native подход: SidePanel, toolbar, UI extensions.

Документация

• Documentation map
• Installation
• Quick Start
• Module integration
• Standalone integration
• First CRUD cookbook
• OptionsPage cookbook
• Resources
• Fields
• Grid
• Actions
• Bulk actions
• OptionsPage
• DashboardPage
• Import/Export