Sharing Files

Apart from generating shareable urls to media files, you may want the ability to share files with your users. Kind of like dropbox or Google Drive.

This package allows you to share files with your application users with ease. Users do not need a registered account to access files.

use MOIREI\MediaLibrary\Models\SharedContent;
...

$file = File::find('file-id');
$shareable = SharedContent::make($file)
            ->public()
    		->downloads(2) // users can only download file(s) twice
    		->save();

// share a folder

$folder = Folder::find('file-id');
$shareable = SharedContent::make($folder)
            ->access('access-code') // secure with an access code
    		->save();

Since SharedContent is a Model, you can also fill it with an array

$shareable->fill(
    $request->only([
        'name', 'description',
        'public', 'access_emails', 'access_type', 'access_keys',
        'expires_at', 'can_remove', 'can_upload',
        'max_downloads', 'max_upload_size', 'allowed_upload_types',
    ])
);

Get the shareable url

$url = $shareable->url();

Visit url for a visual access to shared file(s);

Share Files

use MOIREI\MediaLibrary\Models\File;
...

$shareable = File::find('file-id')->share()->save();

Share Folders

use MOIREI\MediaLibrary\Models\Folder;
...

$folder = Folder::find('folder-id');
$shareable = $folder->share()
            ->uploadSize(1000000) // limit upload to 1MB
	        ->canUpload()
            ->uploadTypes([
                'image' => ['png', 'jpg'],
                'docs' => ['*'],
            ])
            ->save();

Limiting Access

If secrete, provided codes are hashed before saved.

$access_type = 'secret'; // `secret` or `token`
$shareable->access($access_type, [
        'code-1',
        'code-2'
    ])
	->canUpload()
    ->uploadTypes('image/png', 'video/*')
    ->allow($user1, $user2)
    ->deny([$admin1, $user3])
    ->save();

Methods

The following methods are chainable.

Method	Description
access(...)	Limit access with codes or passwords. Pass (1) array of codes/passwords or (2) the access type and then an array of codes/passwords.
accessType(string $type)	Explicitly set the access code type.
email(string|array ...$emails)	Further limit access by emails. User must provide this email to access shared files.
canUpload(bool $value = true)	Whether the user can upload further content unto the shared folder.
canRemove(bool $value = true)	Whether the user can remove items in the shared folder.
downloads(int $value)	Limit the amount of user downloads.
uploadSize(int $value)	Limit the total maximum upload size in bytes. Automatically enables uploads.
allow(Model|array ...$users)	Model instances (users) allowed to access this shared content. Access will be allowed even if not authenticated.
deny(Model|array ...$users)	Model instances (users) not allowed to access this shared content. Access is will be denided even if authenticated.