dmstr/yii2-filefly-module

FlySystem API for Filemanager

Yii2 FileFly Module

, _(*1)

FlySystem API for dmstr/yii2-filemanager-widgets, _(*2)

Installation

ENV variables

i.e. AFM_FILESYSTEM=fsLocal, _(*3)

:question: How to configure a filesystem component Filesystem docs, _(*4)

Yii config

'filefly' => [
    'class'              => 'hrzg\filefly\Module',
    'layout'             => '@backend/views/layouts/main',
    'filesystem'         => getenv('AFM_FILESYSTEM'),
    'slugNames'          => (getenv('AFM_SLUG_NAMES')) ? getenv('AFM_SLUG_NAMES') : true,
    'repair'             => (getenv('AFM_REPAIR')) ? getenv('AFM_REPAIR') : true,
    'deleteRecursive'    => (getenv('AFM_DELETE_RECURSIVE')) ? getenv('AFM_DELETE_RECURSIVE') : false,
    'streamExpireOffset' => 604800 # Offset (in seconds) for Expires Header in stream action
    'defaultPermissions' => [
        \hrzg\filefly\Module::ACCESS_OWNER  => 1,
        \hrzg\filefly\Module::ACCESS_READ   => \hrzg\filefly\models\FileflyHashmap::$_all,
        \hrzg\filefly\Module::ACCESS_UPDATE => \hrzg\filefly\models\FileflyHashmap::$_all,
        \hrzg\filefly\Module::ACCESS_DELETE => \hrzg\filefly\models\FileflyHashmap::$_all,
    ],
    # the urlCallbck property can be used to provide customized urls for each file item which (if defined) will overwrite 
    # the default handler URLs
    'urlCallback'        => function($item) {
        $urls = [];
        $isImageFileExtList = ['jpg', 'jpeg', 'gif', 'tiff', 'tif', 'svg', 'png', 'bmp'] ;
        if ($item['type'] === 'file') {
            if (in_array(strtolower($item['extension']), $isImageFileExtList)) {
                $urls['image url'] = \dmstr\willnorrisImageproxy\Url::image($item['path']);
            }
            else {
                $urls['download url'] = implode('/', ['/img/download', ltrim($item['path'], '/')]) . ',p1';
            }
        }
        return $urls;
    },
    // previewCallback can be used to overwrite the default downloadUrl for preview URLs within filemanagerApp
    'previewCallback' => function($item) {
        $isImageFileExtList = ['jpg', 'jpeg', 'gif', 'tiff', 'tif', 'png', 'bmp'] ;
        if ($item['type'] === 'file') {
            if (in_array(strtolower($item['extension']), $isImageFileExtList)) {
                return \dmstr\willnorrisImageproxy\Url::image($item['path'], '500x');
            }
        }
        return '';
    }
],

RBAC

Prosa - FileflyAdmin full module access including debug information - FileflyDefault management access (eg. POST request for upload, change, delete) - FileflyPermissions assigned users can set or unset roles or permissions which the user himself has assigned, _(*5)

• access_owner permission before access_read, access_update, access_delete
• If no permission is set, it will check if any inherited permission can be granted

So if inherited access_* permissions should be used, set defaultPermissions to null NOT to '*'., _(*6)

            'defaultPermissions' => [
                \hrzg\filefly\Module::ACCESS_OWNER  => 1,
                \hrzg\filefly\Module::ACCESS_READ   => null,
                \hrzg\filefly\Module::ACCESS_UPDATE => null,
                \hrzg\filefly\Module::ACCESS_DELETE => null,
            ],

ActiveRecord: FileflyHashmap - uses dmstr\activeRecordPermissions\ActiveRecordAccessTrait with $activeAccessTrait = false - access checks will be done for each permission type explicitly, hasPermission($action) - uses a pathValidator rule to ensure the path syntax on active record operations, _(*7)

Roles

• FileflyAdmin, _(*8)

  • filefly

• FileflyDefault, _(*9)

  • filefly_default_index

• FileflyApi, _(*10)

  • filefly_api_index

• FileflyPermissions, _(*11)

Permissions

• filefly
• filefly_default_index
• filefly_api_index

RBAC Plugins

Permission checks will ever come after file or folder operation, _(*12)

GrantPermission, _(*13)

Granted or deny permission

1. access field empty (is owner, true or continue)
2. access field set (permission granted, true)
   access field set (is access owner, true, permission denied, false)

SetPermission, _(*14)

Create or update permission

1. Add new hash records
2. Update hash records (recursive option)

- Multi create and update option

RemovePermission, _(*15)

Remove permission

1. Deletes file or folder records

- Multi delete option

CLI

Configure, _(*16)

'controllerMap' => [
    'fs' => [
        'class' => '\hrzg\filefly\commands\FsController',
        'filesystemComponents' => [
            'local' => 'fs',
            's3' => 'fsS3',
            'storage' => 'fsFtp',
        ],
    ],
]

Widget

see https://github.com/dmstr/yii2-filemanager-widgets, _(*17)

    {{ use ('hrzg/filemanager/widgets') }}
    {{ file_manager_widget_widget(
        {
            "handlerUrl": "/#{app.language}/filefly/api"
        }
    ) }}

Options for the yii2-filemanager-widgets Widget can be injected via the Module property fileManagerWidgetOptions, _(*18)

example:, _(*19)

        'filefly' => [
            'filesystemComponents' => [
                'ftp' => 'fsFtp',
                'ftpcrud' => 'fsFtpCrud',
            ],
            // ...
            // other configs
            // ...
            // Options for the angular fileManagerWidget
            'fileManagerWidgetOptions' => [
                'searchForm' => false,
                'allowedActions' => [
                    'move' => false,
                    'upload' => false,
                    'createFolder' => false,
                    ],
            ],
        ],

Controller action in iFrame

Modal button, _(*20)

<a type="button" data-toggle="modal" data-target="#modal-filemanager" id="filefly-iframe-toggle">  
    <i class="fa fa-folder-open"></i>
</a>

Load event listener, _(*21)

<script>
    window.addEventListener('load', function () {
        var fileflyIframeToggle = document.querySelector('#filefly-iframe-toggle');
        var iframe = document.querySelector('#filefly-iframe');

        fileflyIframeToggle.addEventListener('click', function () {
            iframe.src = "/filefly/default/filemanager-full-screen";
        });
    });
</script>

Iframe, _(*22)

{{ use ('yii/bootstrap') }}
{{ modal_begin(    
{        
    'id': 'modal-filemanager',
    'size': 'modal-lg'    
}) }}







{{ modal_end() }}'

Helper