Разработка пакетов

# Основы

Основой MoonShine являются пакеты Laravel. Если вы новичок в разработке пакетов для Laravel, вот несколько ресурсов, которые помогут вам понять основные концепции:

# ServiceProvider

Через ServiceProvider Вашего пакета вы можете добавлять автоматически ресурсы, страницы, формировать меню и правила авторизации и многое другое. 

namespace Author\MoonShineMyPackage;
 
use Illuminate\Support\ServiceProvider;
 
class MyPackageServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        moonshine()
            ->resources([
                new MyPackageResource(),
            ])
            ->pages([
                new MyPackagePage(),
            ])
            ->vendorsMenu([
                MenuItem::make('MyPage', new MyPackagePage())
            ]);
    }
}

Также вы можете взаимодействовать с AssetManager или ColorManager 

public function boot(): void
{
    moonshineAssets()->add([
        'path_to_file.css',
        'path_to_file.js',
    ]);
}
public function boot(): void
{
    moonshineColors()
        ->background('#A3C3D9')
        ->content('#A3C3D9')
        ->tableRow('#AE76A6')
        ->dividers('#AE76A6')
        ->borders('#AE76A6')
        ->buttons('#AE76A6')
        ->primary('#CCD6EB')
        ->secondary('#AE76A6');
}

Если необходимо добавить дополнительную логику авторизации в приложении или во внешнем пакете, то воспользуйтесь методом defineAuthorization. 

public function boot(): void
{
    moonshine()->defineAuthorization(
        static function (ResourceContract $resource, Model $user, string $ability): bool {
            return true;
        }
    );
}

Не забудьте автоматически подключить Ваш ServiceProvider в composer.json 

"extra": {
    "laravel": {
        "providers": [
            "Author\\MoonShineMyPackage\\MyPackageServiceProvider"
        ]
    }
}

# Custom field example

Рассмотрим небольшой пример создания собственного поля! Это будет визуальный редактор на основе js плагина Quill

Создадим поле с помощью команды moonshine:field и выберем что оно расширяет Textarea 

php artisan moonshine:field Quill

Уберем лишние методы и добавим css/js 

declare(strict_types=1);
 
namespace App\MoonShine\Fields;
 
use MoonShine\Fields\Textarea;
 
final class Quill extends Textarea
{
    protected string $view = 'moonshine-quill::fields.quill';
 
    protected array $assets = [
        '/css/moonshine/quill/quill.snow.css', // theme
        '/js/moonshine/quill/quill.js', // lib
        '/js/moonshine/quill/quill-init.js', // init
    ];
}

Также изменим view поля 

<div x-data="quill">
    <div class="ql-editor" :id="$id('quill')" style="height: auto;">{!! $value ?? '' !!}</div>
 
    <x-moonshine::form.textarea
        :attributes="$element->attributes()->merge([
            'class' => 'ql-textarea',
            'name' => $element->name(),
            'style' => 'display: none;'
        ])->except('x-bind:id')"
    >{!! $value ?? '' !!}</x-moonshine::form.textarea>
</div>

quill.snow.css и quill.js мы взяли из библиотеки, а вот js инициализации с использованием alpineJs представлен ниже 

document.addEventListener('alpine:init', () => {
    Alpine.data('quill', () => ({
        textarea: null,
        editor: null,
 
        init() {
            this.textarea = this.$root.querySelector('.ql-textarea')
            this.editor = this.$root.querySelector('.ql-editor')
 
            const t = this
 
            this.$nextTick(function() {
                let quill = new Quill(`#${t.editor.id}`, {
                    theme: 'snow'
                });
 
                quill.on('text-change', () => {
                    t.textarea.value = t.editor.innerHTML || '';
                    t.textarea.dispatchEvent(new Event('change'));
                });
            })
        },
    }))
})

Пример выноса этого поля в отдельный пакет можно найти в репозитории

Дополнительно
Тестирование
Рецепты
Рецепты