asinfotrack/yii2-attachments

Yii2-attachments is a module and set of functionality to add attachments to a model in a generic way

1.0.1 2021-12-15 10:02 UTC

Requires

• php: >=7.1.0
• asinfotrack/yii2-toolbox: ~1.0.0
• yiisoft/yii2: ~2.0.6
• yiisoft/yii2-bootstrap: ~2.0.0

MIT

• Pascal Mueller

• module
• bundle
• Behavior
• action
• widget
• attachment
• yii2
• attachments

README

Yii2-attachments is a module and set of functionality to add attachments to a model in a generic way

Installation

Basic installation

The preferred way to install this extension is through composer.

Either run

$ composer require asinfotrack/yii2-attachments

or add

"asinfotrack/yii2-attachments": "~0.8.0"

to the require section of your composer.json file.

Migration

After downloading you need to apply the migration creating the required tables:

yii migrate --migrationPath=@vendor/asinfotrack/yii2-attachments/migrations

To remove the table just do the same migration downwards.

Add the module to the yii-config

    'modules'=>[
        
        //your other modules...
        
        'attachments'=>[
            'class'=>'asinfotrack\yii2\attachments\Module',
            
            'userRelationCallback'=>function ($model, $attribute) {
                return $model->hasOne('app\models\User', ['id'=>$attribute]);
            },
            'backendAccessControl'=>[
                'class'=>'yii\filters\AccessControl',
                'rules'=>[
                    ['allow'=>true, 'roles'=>['@']],
                ],
            ],
        ],
    ],

For a full list of options, see the attributes of the classes within the module. Especially check the classes asinfotrack\yii2\attachments\Module. Some examples are provided below.

Changelog

v1.0.1

• fixed ordering bug

v1.0.0

• dependency update (potential breaking change!)

v0.8.4

• added parameter to download action

v0.8.3

• added attachment ordering

v0.8.2

• added param to imagePreparationCallback

v0.8.1

• Breaking change:
  • avatarMode is removed in asinfotrack\yii2\attachments\widgets\AttachmentUpload
• new mode in asinfotrack\yii2\attachments\widgets\AttachmentUpload
• redirect to referrer after updating an attachment
• use new Icon function from toolbox
• dependency update

v0.8.0

• main classes in a stable condition
• further features will be added in a backwards-compatible way from here on
• all breaking changes will lead to a new minor version.