angrydeer/attachfiles

Add some attached files to Eloquent model and store it to storage/app/attached/{Y-m-d} dir.

Laravel 5.2 Attachfiles

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

Intro

Developed for easy work with the administration panel, such as Sleeping-Owl admin where all downloaded files are stored in a single folder and are not deleted if the record is not saved., _(*2)

Attahfiles creates a link between a record of any model and a collection of downloaded files. He keeps them in the Storage assigning unique names, creates a new folder for each month, and day and deletes the originals from the shared folder upload., _(*3)

When you remove attach, file is deleted from Storage., _(*4)

You can add a file field Title, Alt, and Description. If the field Alt while maintaining empty, it is taken as the original file name., _(*5)

Install

Add to composer.json in require section:, _(*6)

``` php "angrydeer/attachfiles": "dev-master", <sub>(*7)</sub>

Make composer update

after that add to config/app.php:

``` php

'providers' => [

        /*
         * Laravel Framework Service Providers...
         */
         Angrydeer\Attachfiles\AttachfilesServiceProvider::class,
         // ...
     ],

console:, <sub>(*8)</sub>

``` bash $ php artisan vendor:publish $ php artisan migrate, <sub>(*9)</sub>

## Usage

In model:

``` php

// beginning omitted

use Angrydeer\Attachfiles\AttachableTrait;
use Angrydeer\Attachfiles\AttachableInterface;

class SomeModel extends Model implements AttachableInterface
{

   use AttachableTrait;

   public function myfunc()
   {

       $model = SomeModel::find(1);

       $model->updateOrNewAttach($filename, $title, $alt, $desc);

       $model->removeAttach($filename);

       $all_attach_files = $model->attaches;

       $filearray = [ 'file1', 'file12', 'file3' ]

       /*
       * as example, in $all_attach_files now attaches with  'file2', 'file3', 'file4'    
       *
       */

       $model->keepOnly($filearray);
       $all_attach_files = $model->attaches;

       //  'file2', 'file3' included. file4 removed.

   }

}

in route.php you can write for images as example:, <sub>(*10)</sub>

``` php, <sub>(*11)</sub>

Route::get('attaches/{date}/{filename}', function ($date,$filename) {
    return Storage::get('attaches/'.$date.'/'.$filename);
});

in view:

``` php

        @foreach($model->attaches as $attach)
            <img src="{{URL::to($attach->filename)}}" alt="{{$attach->alt}}" title="{{$attach->title}}">
        @endforeach

Change log

Please see CHANGELOG for more information what has changed recently., <sub>(*12)</sub>

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*13)</sub>

issues

If you discover any related issues, please using the issue tracker., <sub>(*14)</sub>

Credits

• [AngryDeer][http://angrydeer.ru]

License

The MIT License (MIT). Please see License File for more information., <sub>(*15)</sub>