Установка

# Требования

Для использования 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 можно в файле конфигурации .