admin panel

Панель администратора

Панель Agnostic Agnostic Admin.

Цель

пытаясь сделать это максимально минимальным. Это позволяет создавать несколько страниц с разными типами (таблица, форма). не вмешиваясь в базу кода.

PS: вам все еще нужно настроить свои маршруты, аутентификацию и т. Д.

Ответ

Мы разрешаем несколько типов ответов, в качестве по умолчанию мы использовали представления PHP, но вместо этого мы решили для пользователей blade , поэтому одно возможное решение - создать другой Renderer .

На данный момент у нас есть два Renderers по умолчанию:

• DefaultRenderer Это просто возвращает массив в качестве вывода
• JsonRenderer это возвращает вывод JSON

Чтобы создать рендеринг, заставьте его расширять AecodesAdminPanelResponsesRenderer . Затем добавьте его в config.

В настоящее время поддерживаются макеты

• Таблица (принимает массив TD, каждый TD может быть представлен на заказ)
• Форма (принимает массив полей)
• Div (единственный вариант использования - иметь настраиваемые обертки)
• Можно создать свои собственные виджеты.

PS: виджеты реализуют интерфейс Widget .

В настоящее время поддерживаемые поля формы

• Ввод (текст, пароль, электронная почта, номер, ...)
• Радио
• Выбирать
• Textarea
• Флажок
• Изображение (загрузить отдельное изображение)

Как настроить

1. Установите с помощью композитора
2. Создайте файл конфигурации, используя config/panel.php в качестве отправной точки.
3. Создайте (Singleton) экземпляр класса Dashboard , обязательно пропустите конфигурацию в качестве массива.

 $ config = require ' ./config/panel.php ' ;
Aecodes  AdminPanel Dashboard:: setup ( $ config );

Как создать страницу администратора

1. Создайте новый класс, расширяя класс Panel
2. Для удобства установите свойства как для $name , так и $description панели (видно на странице).
3. Создайте метод query , который возвращает массив данных.

 function query (): array {
    // get data from database.
    return Page:: all ()-> toArray ();
}

4. Создайте метод render , который возвращает массив виджетов.

• Чтобы создать таблицу

 function render (): array {
    return [
        Table:: make ([
            // (label, name) both are optional
            TD :: make ( ' # ' , ' id ' ),
            // it's also possible to use Table::column
            Table:: column ( ' Title ' , ' title ' ),
        ])
        // ...
    ];
}

• Чтобы создать форму

 function render (): array {
    return [
        Form:: make ([
            Input:: make ( ' title ' )-> title ( ' Title ' ),

            // form submit
            Action:: button ( ' Save ' ),
        ])
        -> action ( ' # ' )
        -> method ( ' post ' ),
        // ...
    ];
}

5. Чтобы закончить, в обратном вызове вашего маршрута просто верните новый экземпляр созданного вами класса.

 // callback for some route
public function index () {
    // PagesTable extends Panel
    return ( new Response ( new PagesTable ))-> render ();
}

Расширяемость

Макеты

При расширении класса Panel вы можете указать свойство $layout .

Виды

Это не поставляется с обзором. Вы можете использовать пакеты представлений по умолчанию (скоро).

Конфигурация

Конфигурация по умолчанию:

 return [
    // current renderer.
	' renderer ' => ' default ' ,

    // add new renderer here.
	' renderers ' => [
		' json '    => Aecodes  AdminPanel  Responses JsonRenderer::class,
		' default ' => Aecodes  AdminPanel  Responses DefaultRenderer::class,
	],

    // default classes for button and a tag.
	' classes ' => [
		' link '   => '' ,
		' button ' => '' ,
	],

    // global menus, can be and array or callback
	' menu ' => function () {
		return [];
	},

    // input old value.
	' old_value ' => function ( $ name , $ default ) {
		return $ default ;
	},

    // global errors (i.e: validation errors)
	' errors ' => function () {
		return [];
	}

];