README

laravel file manager is a package for

• manage file uploaded by users with check ACL. you can upload file with custom size
• generate download link
• store file in Sotrage folder
• optimize image
• crop image when file upload , edit file or generate link with three kind of crop .

Requiments

• PHP >= 7.0
• Laravel 5.5|5.6

The package will use these optimizers if you wnat to enable optimization:

• JpegOptim
• Optipng
• Pngquant 2
• SVGO
• Gifsicle

Installation

Quick installation

composer require "alhadi/laravel_file_manager"

for laravel less than 5.5

Register provider and facade on your config/app.php file.

'providers' => [

...,
ArtinCMS\LFM\LFMServiceProvider::class,

]

'aliases' => [

...,
'FileManager' => ArtinCMS\LFM\Facades\FileManager::class,

]

publish vendor

 $ php artisan vendor:publish --provider="ArtinCMS\LFM\LFMServiceProvider"

 $ php artisan vendor:publish --provider="ArtinCMS\LFM\LFMServiceProvider" --force

migrate tabales

  $ php artisan migrate
  

seed data to lfm_file_mime_type table

  php artisan db:seed --class="ArtinCMS\LFM\Database\Seeds\FilemanagerTableSeeder"
  

more installation details

The package will use these optimizers if they are present on your system:

• JpegOptim
• Optipng
• Pngquant 2
• SVGO
• Gifsicle

for install this package in your server :

Here's how to install all the optimizers on Ubuntu:

  sudo apt-get install jpegoptim
  sudo apt-get install optipng
  sudo apt-get install pngquant
  sudo npm install -g svgo
  sudo apt-get install gifsicle

And here's how to install the binaries on MacOS (using Homebrew):

  brew install jpegoptim
  brew install optipng
  brew install pngquant
  brew install svgo
  brew install gifsicle

for enable optimizer in package you shoul go config/laravel_file_manager.php and set 'Optimise_image'= true

for more information you can visit image-optimizer

usage

• create html modal for show manager
• create html modal button
• set your options

LFM_CreateModalFileManager($section, $options , $insert , $callback , $modal_id , $header , $button_id, $button_content)

  

that $section is Require and other input is optional .for use output of filemanager you should install jquery 3 and bootstrap 4 ;

• $section = section name for example 'FileManager';
$options : is options you want to impplement in this package example :

$options = ['size_file' => 100, 'max_file_number' => 30, 'true_file_extension' => ['png','jpg']];
</pre> </div>

  

  //the inserted file result is 
  {

Manager :
    available:1,
    data :
    [{
        0 :
        {
            file :
            {
                height : "0"
                icon : "image"
                id : 115
                name : "photo2017-04-1512-45-2"
                quality : "100"
                size : 60187
                type : "original"
                user : "faramarz"
                version : null
                width:  "0"
            },
            full_url: "http://127.0.0.1:8000/LFM/DownloadFile/ID/115/original/404.png/100/0/0",
            message: "File with ID :115 Inserted",
            success:true
            url: "/LFM/DownloadFile/ID/115/original/404.png/100/0/0",
            full_url_large:"http://127.0.0.1:8000/LFM/DownloadFile/ID/24/small/404.png/100/300/180",
            full_url_medium:"http://127.0.0.1:8000/LFM/DownloadFile/ID/24/medium/404.png/100/300/180",
        }
    }],
    view :
    {
       'list' : 'html grid view code' ,
       'grid' : 'html grid view code' ,
       'small' :'html small view code' ,
       'medium' : 'html thumb view code' ,
       'large' : 'html large view code' 
    }

  }

//to show above data to small view you can use this function

function callback(result)
{
   $('#show_area_small').html(result.Manager.view.small) ;
}
  

$modal_id : this option use to assign id to main modal and default is 'FileManager' .

    $header : this option use to set modal header .and default is 'File manager' .

</li>

you can access to file manager with :http://www.yourdomain.com/LFM/ShowCategories

Helper Functions

Save File

Save Multi File

  $res = LFM_SaveMultiFile($obj_model, $section, $type , $relation_name , $attach_type)
 

   public function files()
   {

      return $this->morphToMany('ArtinCMS\LFM\Models\File' , 'fileable','lfm_fileables','fileable_id','file_id')->withPivot('type')->withTimestamps() ;

   }
 

Save single File

 LFM_SaveSingleFile($obj_model, $column_name, $section,$column_option_name)
 

Direct upload

  LFM_CreateModalUpload($section, $callback , $options, $result_area_id , $modal_id , $header , $button_id , $button_content)
  

       $options = ['size_file' => 1000, 'max_file_number' =>5, 'min_file_number' => 2,'show_file_uploaded'=>'medium', 'true_file_extension' => ['png','jpg','zip'],'path'=>'myuploads/sdadeghi'];

   

load files

Load Multi Files

  for load files (for example you can use this helper functons when you want edit) you can use this helpers function
  LFM_LoadMultiFile($obj_model, $section, $type = null, $relation_name = 'files')
 

Load Single Files

 LFM_loadSingleFile($obj_model, $column_name, $section, $column_option_name = false)
 

Show Files

Show Multi File

LFM_ShowMultiFile($obj_model, $type, $relation_name )  

 

Show Single Files

LFM_ShowingleFile($obj_model, $column_name, $column_option_name)

Generate Link

Generate Download Link

 LFM_GenerateDownloadLink($type, $id , $size_type, $default_img, $quality , $width, $height)
   

• if you want generate file link with ID the $type = 'ID' and if you want generate by name you can use $type = 'Name'
• $id : if you want generate link with id you should fill this item with file id and default is -1 that reffer no file id selected .
• $size_type can pick one on of : original , large , medium , small that reffer which size you want to download
• if image not found with $default_img you can choose image you want to show , default is '404.png'
• $quality is quality of image , it is between 0 and 100 .
• $width is width of result image
• $height is height of result image

Generate Base64 Image

 LFM_GetBase64Image($file_id, $size_type, $not_found_img , $inline_content , $quality , $width , $height )    

Genrate public link

LFM_GeneratePublicDownloadLink($path,$filename)     </pre> </div>
that $psth is path to file and $filename is name of disc file . for example you want access the logo site picture you can 
upload this file in public folder and access directly with above helper function .

 
Custom config

 if you want to have custom config you can chage config/laravel_file_manager.php file as you want .
 

• 'private_middlewares' and 'public_middlewares' describe what middelware should assign to private and public route ,you can add auth and other middelware you want .
• with 'private_route_prefix' and 'public_route_prefix' you can change prefix of private and public route .
• 'allowed' reffer wich mime type files can upload
• 'allowed_pic' is reffer wich mime type is recognize as picture
• with 'size_large' ,'size_large' , 'size_large' and 'size_large' when upload file you can define size of upload deppend of type .
• 'driver_disk' is deriver you use in your project
• 'user_model' is path of your user model .
• 'Optimise_image' if is true and do serve config as tell in installation section . all picture optimize before save in your storage .
• with 'crop_chose' you can choose wich crop type use when upload file (when create large ,medium and small size of picture). you can set it one of : fit,resize and smart that 'fit' is default crop and resize resize image with due attention to config size you set and smart type is smart crop but it was slowler than other crop type .

Example

THe full Example :

Example of use LFM_SaveMultiFile and LFM_SaveSingleFile

in this example we assing zip file and user profile picture to article and save it . at first in Route :

 Route::get('/MultiFile', 'HomeController@multiSection')->name('multiSection');
 Route::get('/MultiFile/{id}', 'HomeController@multiSectionEdit')->name('multiSectionEdit');
 Route::get('/ShowMultiFile/{id}', 'HomeController@showMultiFile')->name('showMultiFile');
 Route::post('/StoreArticle', ['as' => 'StoreArticle', 'uses' => 'HomeController@StoreArticle']);
 Route::post('/StoreEditArticle', ['as' => 'StoreEditArticle', 'uses' => 'HomeController@StoreEditArticle']);

use ArtinCMS\LFM\Traits\lfmFillable ;
use ArtinCMS\LFM\Models\File;
class Article extends Model
{

use lfmFillable;

}

public function multiSection()
{
        $optionsAttach = ['size_file' => 100, 'max_file_number' => 5, 'true_file_extension' => ['zip']];
        $option_single = ['size_file' => 100, 'max_file_number' => 1, 'true_file_extension' => ['png','jpg']];
        $attach =  LFM_CreateModalFileManager('Attach',$optionsAttach , 'insert','showAttach');
        $single = LFM_CreateModalFileManager('Single',$option_single , 'insert','showSingle');
        return view('multiSection',compact('attach','single'));
}
</pre> 
<pre>
 public function multiSectionEdit($id)
{
    $optionsAttach = ['size_file' => 100, 'max_file_number' => 5, 'true_file_extension' => ['zip']];
    $option_single = ['size_file' => 100, 'max_file_number' => 1, 'true_file_extension' => ['png','jpg']];
    $attach =  LFM_CreateModalFileManager('Attach',$optionsAttach , 'insert','showAttach');
    $article = Article::find($id);
    $load_attch = LFM_LoadMultiFile($article,'Attach','zip','files') ;
    $single = LFM_CreateModalFileManager('Single',$option_single , 'insert','showSingle');
    $load_single = LFM_loadSingleFile($article,'default_img_file_id','Single');
    return view('multiSectionedit',compact('attach','single','load_attch','load_single','article'));
}
</pre>
<pre>
public function showMultiFile ($id)
{
    $article = Article::find($id);
    $show_attch = LFM_ShowMultiFile($article,'zip','files') ;
    $show__single = LFM_ShowingleFile($article,'default_img_file_id','Single');
    return view('showMultiFile',compact('show_attch','show__single','article'));
}
</pre>
<pre>
public function StoreArticle(Request $request)
{
    $article = new Article ;
    $article->title = $request->title ;
    $article->body = $request->body ;
    $article->save() ;
    $res['Attach'] = LFM_SaveMultiFile($article,'Attach','zip','files' , 'attach');
    $res['Single'] = LFM_SaveSingleFile($article,'default_img_file_id','Single','options');
    return $res ;
}
</pre>
<pre>
public function StoreEditArticle(Request $request)
{
    $article =Article::find($request->id);
    $res['Attach'] = LFM_SaveMultiFile($article,'Attach','zip','files' , 'sync');
    $res['Single'] = LFM_SaveSingleFile($article,'default_img_file_id','Single','options');
    return $res ;
}
</pre>
 </div>

and in multisection.blade.php
 

{!! $attach['button'] !!}
{!! $attach['modal_content'] !!}

   div#show_area_Attach_list
 function showAttach(res) {
    $('#show_area_Attach_list').html(res.Attach.view.list) ;
    $('#show_area_Attach_grod').html(res.Attach.view.grid) ;
    $('#show_area_Attach_small').html(res.Attach.view.small) ;
    $('#show_area_Attach_medium').html(res.Attach.view.medium) ;
    $('#show_area_Attach_large').html(res.Attach.view.large) ;
    }

 

and in multisectioneditl.blade.php 
    {!! $attach['button'] !!}
    {!! $attach['modal_content'] !!}
    div#show_area_Attach  {!! $load_attch['view']['list'] !!}
  function showAttach(res) {
        $('#show_area_Attach').html(res.Attach.view.list,'slider') ;
    }