laravel-plupload
================

Laravel plupload support.

Handeling chunked uploads.

## Installation

Install using composer 

```sh
composer require jildertmiedema/laravel-plupload
```

Add the provider to `config/app.php`

```php
'providers' => [
    JildertMiedema\LaravelPlupload\LaravelPluploadServiceProvider::class,
]
```

If you want to use te build in builder insert the facade

```php
'aliases' => array(
    'Plupload' => JildertMiedema\LaravelPlupload\Facades\Plupload::class,
),
```

To publish the assets:

```sh
php artisan vendor:publish
```
## Receiving files

Use this route to receive a file on the url `/upload`. Of course you can place this is a controller.

```php
Route::post('/upload', function()
{
    return Plupload::receive('file', function ($file)
    {
        $file->move(storage_path() . '/test/', $file->getClientOriginalName());

        return 'ready';
    });
});
```

## Sending files

There are 3 ways to send files with this plugin.

### 1. Use default plupload html

Use the [examples](http://www.plupload.com/examples/) found on the plupload site.

#### Issues

If you are encountering a Token Mismatch Exception; 

```
TokenMismatchException in VerifyCsrfToken.php line 53:
```

add in your blade file

```
<meta name="csrf-token" content="{{ csrf_token() }}">
```

in your JS file, add

```js
headers: {
        'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
    },
```

Eg:

```js
$('.js-uploader').pluploadQueue({

	// General settings
	runtimes: 'html5,flash,silverlight,html4',
	url: '/upload/',
	chunk_size: '200kb',
    rename: false,
    dragdrop: true,
	// add X-CSRF-TOKEN in headers attribute to fix this issue
	headers: {
        'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
    },
	// add more overrides; see documentation...

});

```
### 2. Simple plupload builder
To use the builder for creating send form you can use this function:

```php
echo Plupload::make([
    'url' => 'upload',
    'chunk_size' => '100kb',
]);
```

**Note:** The options given to the make function are found on in the [pluload documentation](http://www.plupload.com/docs/Options).


### 3. Extended plupload builder

```php
echo Plupload::init([
    'url' => 'upload',
    'chunk_size' => '100kb',
])->withPrefix('current')->createHtml();
```


## Alternatives

Other packages supporting plupload:

* [fojuth/plupload](https://github.com/fojuth/plupload)