README

This widget allows to make use of the great File Input Plugin that Arnold Daniels developed to enhance our Bootstrap experience.

Installation

The preferred way to install this extension is through composer.

Either run

$ composer require 2amigos/yii2-file-input-widget:~1.0

or add

"2amigos/yii2-file-input-widget": "~1.0"

to the require section of your composer.json file.

Then, Add to your configuration file, the following to your components section:

'i18n' => [
      'translations' => [
          'file-input*' => [
              'class' => 'yii\i18n\PhpMessageSource',
              'basePath' => dirname(__FILE__).'/../vendor/2amigos/yii2-file-input-widget/src/messages/',
          ],
      ],
  ],

If a translation is missing, feel free to make a PR and I will merge it.

Usage

Using a model:

use dosamigos\fileinput\FileInput;

<?=FileInput::widget([
    'model' => $model,
    'attribute' => 'image', // image is the attribute
    // using STYLE_IMAGE allows me to display an image. Cool to display previously
    // uploaded images
    'thumbnail' => $model->getAvatarImage(),
    'style' => FileInput::STYLE_IMAGE
]);?>

Update

We have included the improved and multiple file upload version from Krajee.


<?= $form->field($model, 'code')->widget(\dosamigos\fileinput\BootstrapFileInput::className(), [
    'options' => ['accept' => 'image/*', 'multiple' => true],
    'clientOptions' => [
        'previewFileType' => 'text',
        'browseClass' => 'btn btn-success',
        'uploadClass' => 'btn btn-info',
        'removeClass' => 'btn btn-danger',
        'removeIcon' => '<i class="glyphicon glyphicon-trash"></i> '
    ]
]);?>

For further information regarding Krajee's version, please visit its site.

Testing

$ ./vendor/bin/phpunit

Contributing

Please see CONTRIBUTING for details.

Credits

License

The BSD License (BSD). Please see License File for more information.

web development has never been so fun
www.2amigos.us

2amigos / yii2-file-input-widget

Maintainers

Details