paskuale75/yii2-uppy

Wrapper for Uppy uploader jQuery widget

dev-master 2022-08-16 22:47 UTC

Requires

• php: >=7.0.0
• bower-asset/commonjs-require: *
• npm-asset/uppy: ^1.21
• npm-asset/uppy--locales: ^1.16
• yiisoft/yii2: ~2.0.14
• yiisoft/yii2-bootstrap4: ^2.0

MIT

• Pasquale Pellicani

README

Uppy wrapper, modular JavaScript file uploader that integrates seamlessly with any application. It’s fast, easy to use and lets you worry about more important problems than building a file uploader.

Installation

Install yii2-uppy in the usual way with Composer. Add the following to the require section of your composer.json file:

"paskuale75/yii2-uppy": "*"

or run:

composer require paskuale75/yii2-uppy

You can manually install yii2-uppy by downloading the source in ZIP-format.

Usage

echo '<div  id="div_' . $uniqueKey . '" class="col-md-12">';
echo Uppyuploader::widget([
    'id' => 'Uppy_' . $uniqueKey,
    'options' => [
        'source' => [
            'type' => Uppyuploader::MODE_FILEINPUT,
            'options' => [
                'target' => '#div_' . $uniqueKey,
                'locale'   => [
                    'strings' => [
                        'browse'        => 'Seleziona file',
                        'browseFiles'   => 'Seleziona file',
                        'addMoreFiles'  => 'Seleziona file',
                        'chooseFiles'   => 'Seleziona file',
                    ]
                ],
            ]
        ],
        'destination' => [
            'type' => Uppyuploader::DEST_XHR,
            'options' => [
                'endpoint' => Url::toRoute([
                    '//main/allegati/files/upload',
                    'param1'    => $myParam,
                    'param2'    => $myParam2
                ]),
                'headers' => [Yii::$app->request->csrfParam => Yii::$app->request->csrfToken],
                'fieldName' => ['qqfile'],
                'resume'    => true,
                'retryDelays' => ['0', '1000', '3000', '5000']
            ]
        ],
        'progressBar' => [
            'target' => '#ProgressBar_Uppy_' . $uniqueKey,
            'fixed' => false,
            'hideAfterFinish' => false
        ],
        'informer' => [
            //'class' => 'alert alert-primary'
        ]
    ],
    'coreOptions' => [
        'debug' => true,
        'autoProceed' => true,
        'target' => '#div_' . $uniqueKey,
        'locale' => str_replace('-', '_', Yii::$app->language),
        'restrictions' => [
            'maxFileSize' => 1000000,
            'maxNumberOfFiles' => 1,
            'minNumberOfFiles' => 1,
            'allowedFileTypes' => ['.pdf']
        ]
    ],
]);
echo '</div>

P.S.

You may encounter problems with the 'composer update' command if you are using composer version 1.10.13, downgrade to 1.10.10 and everything will work as it should. Downgrade with "composer self-update 1.10.10"