library laramedias {🖫 669, ⚐ 29, ★ 19}

escapework/laramedias

A Laravel package that integrates Glide for easily manage medias on your project.

Tuesday, October 3, 2017
by luisdalmolin
Repository
6 Watchers
19 Stars
669 Installations

PHP
0 Dependents
0 Suggesters
1 Forks
0 Open issues
29 Versions
4 % Grown

The README.md

Laramedias , _(*1)

, _(*2)

A Laravel package that integrates [Glide](http://glide.thephpleague.com) and easy media management on your Laravel project., _(*3)

    <img src="{{ $product->present->picture(500, 300, 'crop') }}" alt="Easy media management">

Version Compatibility

Laravel	Laramedias
9.0.x	0.9.x
5.5.x	5.6.x\|5.7.x \| 0.7.x
5.4.x	0.6.x
5.4.x	0.5.x
5.3.x	0.4.x
5.2.x	0.3.x
5.1.x	0.2.x

Installation

Via Composer:, _(*4)

$ composer require escapework/laramedias:"0.7.*"

Configuration

And execute the following code:, _(*5)

$ php artisan vendor:publish --provider="EscapeWork\LaraMedias\Providers\MediasServiceProvider"
$ php artisan migrate

Configurations explained:, _(*6)

'disk' => null, // if you dont want to use filesystems.default disk config, change it here...
                // ...for saving on another disk

'max_size' => [
    'width'  => 2000, // when creating medias, the images will be resized to this max_size...
    'height' => 2000, // ...for reducing disk usage
],

'url'  => 'medias',  // if you want to change the laravel glide medias URL
'dir'  => 'medias',  // if you want to change the default directory where the medias are saved
'path' => 'general', // if you want to change the directory where the multipleMedias are saved (you will undestand this later)

Usage

This package allows you to easily use medias with your laravel models. There are two basic ways to use:, _(*7)

One model has multiple medias

Let's say you have a Product model that need to have multiple medias. You have to do this:, _(*8)

Import the following trait in your model;

use EscapeWork\LaraMedias\Traits\Medias;

class Product extends Model
{

    use Medias;
}

Now, you can do this:, _(*9)

Upload and create multiple medias:

$product->uploadMedias($request->file('medias'));

Interate through your medias

The $product->medias will be a default Laravel collection of EscapeWork\LaraMedias\Models\Media models which you can use any of the collection methods available., _(*10)

@foreach ($product->medias as $media)
    picture($width, $height, $fit)
    */ ?>

    <img src="{{ $media->present->picture(600, 300, 'crop') }}">
@endforeach

Each $media object will be a LaraMedias\Models\Media eloquent model, which will have a presenter for easily displaying images (see the above example)., _(*11)

The parameters in the example are the Glide width (w), height (h) and fit. You can see a simple example here (http://glide.thephpleague.com/1.0/simple-example/)., _(*12)

If your model was deleted, all the medias will be deleted too., _(*13)

Deleting medias

For delete your medias, just call the method removeMedias., _(*14)

$product->removeMedias([1, 2]); // just pass the IDs

For removing all medias, just call the removeMedias method without any parameters., _(*15)

$product->removeMedias();

Events

These events are dispatched when in the above use case:, _(*16)

Action	Event
EscapeWork\LaraMedias\Models\Media::created	EscapeWork\LaraMedias\Events\MediaAdded
EscapeWork\LaraMedias\Models\Media::updated	EscapeWork\LaraMedias\Events\MediaUpdated
EscapeWork\LaraMedias\Models\Media::deleted	EscapeWork\LaraMedias\Events\MediaDeleted

One model has one media field

Let's say you have a Banner model and want to upload a single image for him. With Laramedias you can do this:, _(*17)

First, configure the config/medias.php file:, _(*18)

    'models' => [
        'banners' => [
            'model'  => 'App\Models\Banner',
            'fields' => ['banner'] // here you have to put the fields in your model which use medias
        ],
    ],

Second, use the EscapeWork\LaraMedias\Traits\Medias trait in your Banner model., _(*19)

use EscapeWork\LaraMedias\Traits\Medias;

class Banner extends Model
{

    use Medias;
}

Then, you can just use the uploadSingleMedia method., _(*20)

$banner = Banner::find(1);
$banner->uploadSingleMedia($request->file('banner'), 'banner'); // the second parameter is the field name to be updated
$banner->save();

After that, you can just use the media helper method to show your banner., _(*21)

<img src="{{ media_path($banner, 'banner', 1920, 400, 'crop') }}" alt="...">

I would also recomend in this case to make use of Presenters. You can use your custom setup or make use of this package that makes it very easy., _(*22)

Then, you can setup like this:, _(*23)

use EscapeWork\LaravelSteroids\Presenter;

class BannerPresenter extends Presenter
{
    public function banner($w = 100, $h = 50, $fit = 'fit')
    {
        return media_path($this->model, 'banner', $w, $h, $fit);
    }
}

And you like this:, _(*24)

    <img src="{{ $banner->present->banner(1920, 500, 'crop') }}">

Contributing

Feel free to open any pull request/issue with your idea/bug/suggestion., _(*25)

License

See the License file., _(*26)

The Versions

03/10 2017

dev-master

9999999-dev

A Laravel package that integrates Glide for easily manage medias on your project.

library laramedias

A Laravel package that integrates Glide for easily manage medias on your project.

escapework/laramedias

The README.md

Version Compatibility

Installation

Configuration

Usage

One model has multiple medias

Upload and create multiple medias:

Interate through your medias

Deleting medias

Events

One model has one media field

Contributing

License

The Versions

dev-master

The Requires

The Development Requires

0.7.0

The Requires

The Development Requires

0.6.x-dev

The Requires

The Development Requires

0.6.1

The Requires

The Development Requires

0.6.0

The Requires

The Development Requires

0.5.9

The Requires

The Development Requires

0.5.8

The Requires

The Development Requires

0.5.7

The Requires

The Development Requires

0.5.6

The Requires

The Development Requires

0.5.5

The Requires

The Development Requires

0.1.x-dev

The Requires

0.1.2

The Requires

0.1.1

The Requires

0.5.4

The Requires

The Development Requires

0.5.3

The Requires

The Development Requires

0.5.2

The Requires

The Development Requires

0.5.1

The Requires

The Development Requires

0.5.0

The Requires

The Development Requires

0.4.x-dev

The Requires

The Development Requires

0.4.2

The Requires

The Development Requires

0.2.x-dev

The Requires

0.2.1

The Requires

0.4.1

The Requires