README

This package provides media/file management for your Laravel models. It stores files in a model-based directory structure, generates conversions (thumbnails/webp), and provides convenient URL access.

Installation

composer require profscode/media-management

1. Use Trait in Your Model

use Profscode\MediaManagement\MediaManagement;

class User extends Model
{
    use MediaManagement;
}

ProfscodeMedia Model Structure

This model keeps metadata about uploaded media files.

Fields

addMediaFromRequest Usage

$user = User::find(1);
$user->addMediaFromRequest("profile_picture", "avatars");

Requires:

<input type="file" name="profile_picture">

Optional conversion structure:

[
    "admin_panel" => [
        "width" => 100,
        "height" => 100,
        "webp" => true
    ]
]

addMediaFromUrl Usage

$user->addMediaFromUrl("https://domain.com/image.jpg", "gallery");

or

$conversions = [
    "admin_panel" => [
        "width" => 100,
        "height" => 100,
        "webp" => true
    ]
]
$user->addMediaFromUrl("https://domain.com/image.jpg", "gallery", $conversions);

Retrieving Media (Relation)

$user->getMedia();

retrive Media as Collection

getUrl Usage

Original URL:

$media->getFirstMediaUrl($collection = "default");

Thumbnail or WebP:

$media->getFirstMediaUrl($collection , 'admin_panel');

getFirstMediaUrl Usage

$user->getFirstMediaUrl("avatars", "admin_panel");

Storage Structure

storage/app/public/media/{ModelType}/{ModelId}/{collection}/{filename.ext}

License

MIT © Profscode

Support

For issues, please open a GitHub Issue.