4geo35 / fileable
File management for laravel project
Requires
- 4geo35/tailwindcss-theme: ^1.0
- 4geo35/traits-helpers: ^1.0
- intervention/image: ^3.3
- laravel/framework: ^11.0
README
Описание
Пакет содержит livewire
компонент для загрузки галереи изображений, модель для файла, трейты для подключения к модели и четыре стандартных шаблона для конвертации изображений (используется intervention/image
).
ShouldImage
трейт для добавления изображения к модели, необходимо полеimage_id
, можно переопределить черезimageKey
. Добавляются методыimage
,uploadImage
(загрузка изображения, полученного черезrequest()
),livewireImage
(загрузка изображения черезlivewire
),clearImage
(очистить изображение).ShouldGallery
трейт для добавления галереи изображений к модели. Добавляются методыimages
,cover
(обложка, или первое изображение по приоритету),livewireGalleryImage
(загрузка изображения черезlivewire
),clearImages
(очистить галерею)fa-images
компонент для галереи наlivewire
, параметрmodel
для модели, у которой есть трейтShouldGallery
. В компоненте интерфейс для управления галерей (поиск по названию, загрузка группы изображений, удаление изображения, изменение имени изображения, изменение приоритета изображения через drag&drop)thumb:clear { --template= : clear only by template } { --all : clear all }
команда для очистки обрезанных изображений./thumbnail/{template}/{filename}
роут для генерации и сохранения превью файлов
В конфигурации можно задать расширенную модель для файла, необходимо что бы модель наследовалась от той что в пакете. Так же можно расширить observer, компонент для livewire и контроллер для генерации превью.
Что бы добавить новые шаблоны, нужно расширить в конфиге templates
.
Установка
Добавить "./vendor/4geo35/fileable/src/resources/views/**/*.blade.php"
в tailwind.admin.config.js
, созданный в пакете tailwindcss-theme
.
Для добавления таблицы с файлами:
php artisan migrate
Файлы хранить в public
или во внешнем хранилище: В конфиге изменить FILESYSTEM_DISK=public
php artisan storage:link