evneandreys/yii2-filemanager

A file manager for Yii2. Allow user to manage files from any location as well as browsing files within the application.

File Manager for Yii2 (by dpodium/yii2-filemanager)

Installation

Install With Composer

The preferred way to install this extension is through composer., _(*1)

Either run, _(*2)

php composer.phar require evneandreys/yii2-filemanager

or add, _(*3)

"evneandreys/yii2-filemanager": "dev-master"

to the require section of your composer.json file., _(*4)

Execute migration here:, _(*5)

yii migrate --migrationPath=@vendor/evneandreys/yii2-filemanager/migrations
yii migrate/down --migrationPath=@vendor/evneandreys/yii2-filemanager/migrations

Usage

Once the extension is installed, simply modify your application configuration as follows:, _(*6)

Configure i18n component:, _(*7)

'components' => [
    // ...
    'i18n' => [
    'translations' => [
        '*' => [
        'class' => 'yii\i18n\PhpMessageSource',
        ],
    ],
    ],
    // ...
],

Upload file in local:, _(*8)

return [
    'modules' => [
            'gridview' => [
                'class' => '\kartik\grid\Module'
            ],
            'filemanager' => [
                'class' => 'evneandreys\filemanager\Module',
                'storage' => ['local'],
                // This configuration will be used in 'filemanager/files/upload'
                // To support dynamic multiple upload
                // Default multiple upload is true, max file to upload is 10
                // If multiple set to true and maxFileCount is not set, unlimited multiple upload
                'filesUpload' => [
                    'multiple' => true,
                    'maxFileCount' => 30
                ],
                // in mime type format
                'acceptedFilesType' => [
                    'image/jpeg',
                    'image/png',
                    'image/gif',
                ],
                // MB
                'maxFileSize' => 8,
                // [width, height], suggested thumbnail size is 120X120
                'thumbnailSize' => [120,120] 
            ]
        ]
];

Upload file to AWS S3:, _(*9)

return [
    'modules' => [
        'gridview' => [
                'class' => '\kartik\grid\Module'
            ],
            'filemanager' => [ // do not change module to other name
                'class' => 'evneandreys\filemanager\Module',
                // This configuration will be used in 'filemanager/files/upload'
                // To support dynamic multiple upload
                // Default multiple upload is true, max file to upload is 10
                // If multiple set to true and maxFileCount is not set, unlimited multiple upload
                'filesUpload' => [
                    'multiple' => true,
                    'maxFileCount' => 30
                ],
                'storage' => [
                    's3' => [
                        'key' => 'your aws s3 key',
                        'secret' => 'your aws s3 secret',
                        'bucket' => '',
                        'region' => '',
                        'proxy' => '192.168.16.1:10'
                    ]
                ],
                // in mime type format
                'acceptedFilesType' => [
                    'image/jpeg',
                    'image/png',
                    'image/gif',
                ],
                // MB
                'maxFileSize' => 8,
                // [width, height], suggested thumbnail size is 120X120
                'thumbnailSize' => [120,120] 
            ]
        ]
];

You can then access File Manager through the following URL:, _(*10)

http://localhost/path/to/index.php?r=filemanager/folders
http://localhost/path/to/index.php?r=filemanager/files

In order to use File Manager Browse feature:, _(*11)

    use yii\helpers\Html;
    use yii\widgets\ActiveForm;
    use evneandreys\filemanager\widgets\FileBrowse;

    // This is just an example to upload a banner
    $form = ActiveForm::begin();
    echo $form->field($model, 'banner_name');
    echo $form->field($model, 'banner_description');

    // if you would like to store file_identifier in your table
    echo $form->field($model, 'file_identifier')->widget(FileBrowse::className(), [
            'multiple' => false, // allow multiple upload
            'folderId' => 1 // set a folder to be uploaded to.
    ]);

    echo Html::submitButton('Submit', ['class' => 'btn btn-primary']);
    ActiveForm::end();

    // !important: modal must be rendered after form
    echo FileBrowse::renderModal();