PHPackages zozoh94/yii2-filemanager - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [File & Storage](/categories/file-storage) 4. / 5. zozoh94/yii2-filemanager ActiveYii2-extension[File & Storage](/categories/file-storage) zozoh94/yii2-filemanager ======================== Yii2 filemanager v0.12.1(8y ago)191MITPHP Since Jun 17Pushed 8y ago1 watchersCompare [ Source](https://github.com/zozoh94/yii2-filemanager)[ Packagist](https://packagist.org/packages/zozoh94/yii2-filemanager)[ RSS](/packages/zozoh94-yii2-filemanager/feed)WikiDiscussions master Synced today READMEChangelogDependencies (8)Versions (35)Used By (0) Yii2 file manager ================= [](#yii2-file-manager) This module is based on [pendalf89/yii2-filemanager](https://github.com/PendalF89/yii2-filemanager). This module provide interface to collect and access all mediafiles in one place. Inspired by WordPress file manager. Features -------- [](#features) - Integrated with TinyMCE editor. - Automatically create actually directory for uploaded files like "2014/12". Or you can castomize it in module settings. - Automatically create thumbs for uploaded images - Unlimited number of sets of miniatures - All media files are stored in a database that allows you to attach to your object does not link to the image, and the id of the media file. This provides greater flexibility since in the future will be easy to change the size of thumbnails. - If your change thumbs sizes, your may resize all existing thumbs in settings. Installation ------------ [](#installation) The preferred way to install this extension is through [composer](http://getcomposer.org/download/). run ``` php composer.phar require zozoh94/yii2-filemanager "@dev" ``` or add ``` "zozoh94/yii2-filemanager": "@dev" ``` to the require section of your `composer.json` file. Apply migration ``` yii migrate --migrationPath=@vendor/zozoh94/yii2-filemanager/migrations/ ``` Configuration ------------- [](#configuration) ``` 'modules' => [ 'filemanager' => [ 'class' => 'zozoh94\filemanager\Module', // Rename files 'rename' => false, // Upload routes 'routes' => [ // Base web directory url 'basePath' => '@webroot', // Path for uploaded files in web directory 'uploadPath' => 'uploads', // Directory format for uploaded files. 'dateDirFormat' => 'Y/m', // Thumbs directory template. Path, where thumb files are located 'thumbsDirTemplate' => '{uploadPath}/{dateDirFormat}', ], // Thumbnails info 'thumbs' => [ 'small' => [ 'name' => 'Small size', 'size' => [120, 80], ], 'medium' => [ 'name' => 'Medium size', 'size' => [400, 300], ], 'large' => [ 'name' => 'Large size', 'size' => [800, 600], ], ], ], ], ``` ### Configuration. Routes [](#configuration-routes) Default values: ``` 'routes' => [ // Base web directory url 'basePath' => '@webroot', // Path for uploaded files in web directory 'uploadPath' => 'uploads', // Directory format for uploaded files. 'dateDirFormat' => 'Y/m', // Thumbs directory template. Path, where thumb files are located 'thumbsDirTemplate' => '{uploadPath}/{dateDirFormat}', ], ``` If some of these parameters is not defined, default values will be used. Default, the path to upload files is `@webroot/uploads/2016/06`, if you upload file in June 2016. Path for thumbnails is similar. #### basePath [](#basepath) Base web directory url. It used for generate absolute path to web directory. It renders by function `Yii::getAlias()`. For example: ``` 'basePath' => '@webroot' ``` ``` 'basePath' => '@frontend/web' ``` ``` 'basePath' => 'system/upload/directory' ``` #### uploadPath [](#uploadpath) Path for uploaded files in web directory. It renders without changes. For example: ``` 'uploadPath' => 'uploads' ``` ``` 'uploadPath' => 'files/upload' ``` #### dateDirFormat [](#datedirformat) Directory format for uploaded files. Makes directory recursively. It renders by function `date($dateDirFormat, time())`. More about available parameters [read here](http://php.net/manual/en/function.date.php). For example: ``` 'dateDirFormat' => 'Y/m' ``` ``` 'dateDirFormat' => 'Y/m/d' ``` ``` 'dateDirFormat' => 'Y-m' ``` #### thumbsDirTemplate [](#thumbsdirtemplate) Thumbs directory template. Path, where thumb files are located. Parameters `{uploadPath}` and `{dateDirFormat}` are replaced by appropriate values in settings. For example: ``` 'thumbsDirTemplate' => '{uploadPath}/{dateDirFormat}' ``` ``` 'thumbsDirTemplate' => '{uploadPath}/thumbs/{dateDirFormat}' ``` ``` 'thumbsDirTemplate' => '{uploadPath}/{dateDirFormat}/thumbs' ``` ### Configuration. Thumbs [](#configuration-thumbs) Thumbnails are resized in "outbound" mode. Default configuration: ``` 'thumbs' => [ 'small' => [ 'name' => 'Small size', 'size' => [120, 80], ], 'medium' => [ 'name' => 'Medium size', 'size' => [400, 300], ], 'large' => [ 'name' => 'Large size', 'size' => [800, 600], ], ], ``` Structure of thumbs configuration: ``` 'thumbs' => [ '' => [ 'name' => 'Name of alias', 'size' => ['', ''], ], ], ``` Alias `default` is reserved by module for displaying uploaded images. If you set it, it will be rewrite by module default settings. ### Configuration. Other parameters [](#configuration-other-parameters) #### rename [](#rename) Set true if you want to rename files if the name is already in use. Default value: `false`. For example: ``` 'rename' => true ``` #### autoUpload [](#autoupload) Set true to enable autoupload. Default value: `false`. ``` 'autoUpload' => true ``` Usage ----- [](#usage) Simple standalone field: ``` use zozoh94\filemanager\widgets\FileInput; echo $form->field($model, 'original_thumbnail')->widget(FileInput::className(), [ 'buttonTag' => 'button', 'buttonName' => 'Browse', 'buttonOptions' => ['class' => 'btn btn-default'], 'options' => ['class' => 'form-control'], // Widget template 'template' => '{input}{button}', // Optional, if set, only this image can be selected by user 'thumb' => 'original', // Optional, if set, in container will be inserted selected image 'imageContainer' => '.img', // Default to FileInput::DATA_URL. This data will be inserted in input field 'pasteData' => FileInput::DATA_URL, // JavaScript function, which will be called before insert file data to input. // Argument data contains file data. // data example: [alt: "Four cats", description: "123", url: "/uploads/2014/12/cats-100x100.jpeg", id: "45"] 'callbackBeforeInsert' => 'function(e, data) { console.log( data ); }', ]); echo FileInput::widget([ 'name' => 'mediafile', 'buttonTag' => 'button', 'buttonName' => 'Browse', 'buttonOptions' => ['class' => 'btn btn-default'], 'options' => ['class' => 'form-control'], // Widget template 'template' => '{input}{button}', // Optional, if set, only this image can be selected by user 'thumb' => 'original', // Optional, if set, in container will be inserted selected image 'imageContainer' => '.img', // Default to FileInput::DATA_IDL. This data will be inserted in input field 'pasteData' => FileInput::DATA_ID, // JavaScript function, which will be called before insert file data to input. // Argument data contains file data. // data example: [alt: "Four cats", description: "123", url: "/uploads/2014/12/cats-100x100.jpeg", id: "45"] 'callbackBeforeInsert' => 'function(e, data) { console.log( data ); }', ]); ``` With TinyMCE: ``` use zozoh94\filemanager\widgets\TinyMCE;