dbrisinajumi/d2files

file uploader

1.0.0 2015-03-23 08:30 UTC

Requires

• php: >=5.3.2
• blueimp/jquery-file-upload: 9.5.*
• dbrisinajumi/audittrail: 2.1.3

BSD-2-Clause

• Uldis Nelsons

• files
• uploader
• yii
• widget
• phundament

README

Features

• attach files to model record
• widget for model view

Installation

• install https://github.com/blueimp/jQuery-File-Upload?source=c
• install https://github.com/DBRisinajumi/d2files.git

php composer.phar require dbrisinajumi/d2files dev-master

• add to config/main.php

     'import' => array(
        'vendor.dbrisinajumi.d2files.models.*',
        'vendor.dbrisinajumi.d2files.widgets.*', // shared classes
    ),
    'modules' => array(
        'd2files' => array(
            'class' => 'vendor.dbrisinajumi.d2files.D2filesModule',
            'upload_dir' => 'root.upload',
            'accept_file_types' => '/\.(gif|pdf|dat|jpe?g|png|doc|docx|xls|xlsx|htm)$/i',
            
            //automaticly registre tasks, when upload files to model 
            // d2person.PprsPerson, if user role is Agent or Client
            'registre_tasks_to_models' => array(
                'd2person.PprsPerson' => array(
                    'new_project_status' => 1, //Not started
                    'task_init_status' => 1, //Active
                    'task_due_in_days' => 3,
                    'user_roles' => array('Agent','Client'),
                    ),
            ),
            'shareable_by_link' => [
                'my_module.my_model' => [
                    'allow_ip' => [
                        '127.0.0.1',
                        ],
                    'salt' => '1212133243243',
                ]
            ]
         ),  
	 ),

• to config/console.php under commandMap add

	'd2files' => 'vendor.dbrisinajumi.d2files.migrations', 

• execute yiic migration
• in table d2files can define file types for model.

Usage

VIEW

    $this->widget('d2FilesWidget',[
        'module'=>$this->module->id, 
        'model'=>$model,
        'title'=> 'Wiget Title',
        'icon' => false,
        'hideTitle' => false,
        'readOnly' => false,
        'showImagesTypes' => '/\.(gif|jpe?g|png)$/i'
        ]
        );

Requirements

• To upload file user must have "ModuleName.ModelName.uploadD2File" access rights for caller module
• To delete file user must have "ModuleName.ModelName.deleteD2File" access rights for caller module
• To download, upload or delete file user must have read access to corresponding item it is attached to and "ModuleName.ModelName.downloadD2File"

sql statement example for giving access

INSERT INTO `authitem` 
(`name`, `type`, `description`, `bizrule`, `data`) 
VALUES
('D2company.CcmpCompany.uploadD2File','0','D2company.CcmpCompany upolad D2Files',NULL,'N;'),
('D2company.CcmpCompany.downloadD2File','0','D2company.CcmpCompany downloas D2Files',NULL,'N;'),
('D2company.CcmpCompany.deleteD2File','0','D2company.CcmpCompany delete D2Files',NULL,'N;')
;

INSERT INTO `authitemchild` (`parent`, `child`) VALUES ('Agent', 'D2company.CcmpCompany.uploadD2File'); 
INSERT INTO `authitemchild` (`parent`, `child`) VALUES ('Agent', 'D2company.CcmpCompany.downloadD2File'); 
INSERT INTO `authitemchild` (`parent`, `child`) VALUES ('Agent', 'D2company.CcmpCompany.deleteD2File');