dlds/yii2-attachments

Extension for file uploading and attaching to the models

Yii2 attachments

Extension for file uploading and attaching to the models, _(*1)

Installation

1. The preferred way to install this extension is through composer., _(*2)

   Either run, _(*3)

   php composer.phar require dlds/yii2-attachments "*"
   

   or add, _(*4)

   "dlds/yii2-attachments": "*"
   

   to the require section of your composer.json file., _(*5)

2. Apply migrations, _(*6)

   php yii migrate/up --migrationPath=@vendor/dlds/yii2-attachments/migrations
   

3. Add module to config/main.php, _(*7)

   'modules' => [
       ...
       'attachments' => [
           'class' => dlds\attachments\Module::className(),
           'tempPath' => '@app/uploads/temp',
           'storePath' => '@app/uploads/store'
       ]
       ...
   ]
   

4. Attach behavior to your model (be sure that your model has "id" property), _(*8)

   public function behaviors()
   {
       return [
           ...
           'attachmentBehavior' => [
           'class' => \dlds\attachments\behaviors\AttachmentBehavior::className()
           ]
           ...
       ];
   }
   

5. Make sure that you have added 'enctype' => 'multipart/form-data' to the ActiveForm options, _(*9)

Usage

1. In the form.php of your model add file input, _(*10)

   <?= \kartik\file\FileInput::widget([
       'name' => 'file[]',
       'id' => 'file-input',
       'options' => [
           'multiple' => true, // false if you want to allow upload a single file
       ],
       'pluginOptions' => [
           'uploadUrl' => yii\helpers\Url::toRoute('/attachments/file/upload'), // remove this if you don't want to use AJAX uploading 
           'initialPreview' => $model->isNewRecord ? [] : $model->getInitialPreview(),
           'initialPreviewConfig' => $model->isNewRecord ? [] : $model->getInitialPreviewConfig(),
           // other options
       ]
   ]); ?>
   

2. Use widget to show all attachments of the model in the view.php, _(*11)

   <?= \dlds\attachments\components\AttachmentsTable::widget(['model' => $model]) ?>
   

3. (Optional) Add onclick action to your submit button that uploads all files before submitting form, _(*12)

   <?= Html::submitButton($model->isNewRecord ? 'Create' : 'Update', [
       'class' => $model->isNewRecord ? 'btn btn-success' : 'btn btn-primary',
       'onclick' => "$('#file-input').fileinput('upload');"
   ]) ?>
   

Change log

• Feb 2, 2015 - Fix: all attached files will be deleted with the model.
• Feb 1, 2015 - AJAX or basic upload.
• Jan 30, 2015 - Several previews of images and other files, fix of required packages.
• Jan 29, 2015 - First version with basic uploading and previews.