ronasit/laravel-media

A module for working with Media.

0.0.6-beta 2024-12-13 11:04 UTC

Requires

• php: ^8.3
• laravel/framework: ^11.30
• ronasit/laravel-helpers: ^3.0.0-beta
• spatie/laravel-medialibrary: ^11.8.3

Requires (Dev)

• orchestra/testbench: ^9.3
• php-coveralls/php-coveralls: ^2.7
• phpunit/phpunit: ^10.5.30

MIT

• Ronas IT

• framework
• media
• laravel

README

Introduction

This plugin adds the ability for users to work with media files.

Installation

1. Install the package using the following command:

composer require ronasit/laravel-media

1. Publish the package configuration:

php artisan vendor:publish --provider=RonasIT\\Media\\MediaServiceProvider

1. For Laravel <= 5.5 add RonasIT\Media\MediaServiceProvider::class to config app.providers list.
2. Set your project's User model to the media.classes.user_model config.

Usage

All media routes, will be automatically registered with the package installation.

You can manually register package routes in any place in your app routes using Route::media() helper:

#routes/api.php

<?php

use Illuminate\Support\Facades\Route;

Route::group(['middleware' => ['my_auth']], function () {
    Route::media();
});

In this case automatically registered package routes will fails with the 404 code error.

Customizing

You can register only necessary routes using MediaRouteActionEnum:

#routes/api.php

<?php

use Illuminate\Support\Facades\Route;
use RonasIT\Media\Enums\MediaRouteActionEnum;

Route::media(MediaRouteActionEnum::SingleUpload, MediaRouteActionEnum::Delete);

Integration with LaravelSwagger

This package includes OpenAPI documentation file. To include it to your project's documentation, you need to register it in the auto-doc.additional_paths config:

vendor/ronasit/laravel-media/documentation.json

Contributing

Thank you for considering contributing to Laravel Media plugin! The contribution guide can be found in the Contributing guide.

License

Laravel Media plugin is open-sourced software licensed under the MIT license.