Yii2-attachments
Yii2-attachments is a module and set of functionality to add attachments to a model in a generic way, (*1)
Installation
Basic installation
The preferred way to install this extension is through composer., (*2)
Either run, (*3)
$ composer require asinfotrack/yii2-attachments
or add, (*4)
"asinfotrack/yii2-attachments": "~0.8.0"
to the require
section of your composer.json
file., (*5)
Migration
After downloading you need to apply the migration creating the required tables:, (*6)
yii migrate --migrationPath=@vendor/asinfotrack/yii2-attachments/migrations
To remove the table just do the same migration downwards., (*7)
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., (*8)
Changelog
- dependency update (__potential breaking change!__)
- added parameter to download action
- added attachment ordering
- added param to imagePreparationCallback
- 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
- 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.