README

Pinax is a media library for Filament applications. It stores uploaded file metadata in a polymorphic media table and provides gallery, upload and infolist components with folders, ordering and semantic marks.

Features

Polymorphic media attachments for any Eloquent model.
Configurable filesystem disk, base directory and database connection.
MediaUpload for a single upload workflow.
MediaGallery for multiple ordered files.
Named Mark values such as cover, primary or featured, including unique/default behavior.
MediaEntry for image display in Filament schemas.
Optional tenancy and policy-backed media management.

Installation

composer require phpinnacle/pinax
php artisan vendor:publish --tag="phpinnacle-pinax-migrations"
php artisan migrate

For the default public disk, ensure its storage link exists:

php artisan storage:link

Register PinaxPlugin::make() in the Filament panel. Publish phpinnacle-pinax-config to change upload.disk, upload.folder, connection or tenancy.

Gallery usage

use PHPinnacle\Pinax\Forms\MediaGallery;
use PHPinnacle\Pinax\Mark;

MediaGallery::make('gallery')
    ->disk('public')
    ->directory('products')
    ->marks(
        Mark::make('cover')->label('Cover')->unique()->default(),
        Mark::make('featured')->label('Featured'),
    );

The Media model also exposes fetch(), store(), clear(), one(), single() and folder() for application-level access. Public URLs require a disk capable of generating accessible URLs.

Testing

composer test

Changelog and license

See CHANGELOG. Released under the MIT License.

phpinnacle / pinax

Maintainers

Package info

Statistics

Security