# Требования
Для использования MoonShine необходимо выполнение следующих требований перед установкой:
- php >= 8.1
- laravel >= 10.23
- composer > 2
# Composer
composer require moonshine/moonshine
# Установка
php artisan moonshine:install
После выполнения будет добавлен config/moonshine.php
с основными настройками.
Подробнее о файле конфигурации
Также будет добавлена директория с административной панелью и ресурсами - app/MoonShine
.
Подробнее о Ресурсах
А также будет добавлен провайдер MoonShineServiceProvider
,
где необходимо регистрировать ресурсы.
Подробнее о Ресурсах
# Создание администратора
Если при установке админ-панели MoonShine
не был создан администратор или требуется создать еще одного,
то сделать это можно выполнив консольную команду.
php artisan moonshine:user
# Сервис провайдер
Для регистрации новых ресурсов в MoonShine и формирования меню нам потребуется app/Providers/MoonShineServiceProvider.php
namespace App\Providers; use MoonShine\Menu\MenuGroup;use MoonShine\Menu\MenuItem;use MoonShine\Providers\MoonShineApplicationServiceProvider;use MoonShine\Resources\MoonShineUserResource;use MoonShine\Resources\MoonShineUserRoleResource; class MoonShineServiceProvider extends MoonShineApplicationServiceProvider{ protected function resources(): array { return [ ]; } protected function menu(): array { return [ MenuGroup::make('moonshine::ui.resource.system', [ MenuItem::make('moonshine::ui.resource.admins_title', new MoonShineUserResource()) ->translatable(), MenuItem::make('moonshine::ui.resource.role_title', new MoonShineUserRoleResource()) ->translatable(), ])->translatable(), MenuItem::make('Documentation', 'https://laravel.com') ->badge(fn() => 'Check'), ]; } protected function theme(): array { return []; }}
После установки в MoonShineServiceProvider
будет зарегистрировано несколько ресурсов.
Подробнее о Меню
.
Отлично! Теперь можно создавать и регистрировать разделы будущей админ-панели и приступать к работе! Но не забудьте ознакомиться с документацией до конца!
По умолчанию админ-панель доступна по url /admin
.
Изменить url можно в
файле конфигурации
.