slawap/yii2-uploadcare

Yii2 wrapper for uploadcare service

Yii2 wrapper for Uploadcare PHP package

Uploadcare handles uploading, storing and processing files for you. All components of Uploadcare, from widget to CDN, work seamlessly together, require almost no configuration and allow maximum flexibility exactly when you need it., _(*1)

, _(*2)

PHP Library, _(*3)

Uploadcare documentation, _(*4)

Configuration

Api is a yii2 component, which is a facade to \Uploadcare\Api., _(*5)

Example config:, _(*6)

'components' => [
    'uploadcare' => [
        'class' => 'uploadcare\yii2\Api',
        'publicKey' => 'your_public_key',
        'secretKey' => 'your_secret_key',
        'globalWidgetOptions' => [
            'UPLOADCARE_LOCALE' => 'ru',
        ]
    ]
]

globalWidgetOptions - allow you set global options for all call of widget. supported options, _(*7)

Widget

Show file(s) input widget, _(*8)

Example call:, _(*9)

use uploadcare\yii2\UploadCare;

echo $form->field($model, 'logo')->widget(
    UploadCare::className(),
    [
        'options' => [
            'data' => [
                'multiple' => true
            ]
        ],
        'validators' => [
            new \yii\web\JsExpression('function (fileInfo) {
              console.log("test1");
            }'),
            new \yii\web\JsExpression('function (fileInfo) {
              console.log("test2");
            }')
        ]
    ]
);

Local widget settings you can set using html5 data attributes. supported options, _(*10)

Validators allow restricting user choice to certain kind of files., _(*11)

Store file(s) permanently and set UUID to model attribute

Example config:, _(*12)

    public function behaviors()
    {
        return [
            'logo' => [
                'class' => FilesBehavior::class,
                'groupUUID' => false,
                'attributes' => ['logo']
            ]
        ];
    }

File(s)Behavior call api method for save file(s) permanently., _(*13)

FilesBehavior - set UIID to model attribute, _(*14)

FilesBehavior - group UIID or files UIID array (depending on the groupUUID attribute) to model attribute., _(*15)

Show images

Image helper generates an image tag by UUID, _(*16)

Example:, _(*17)

echo Image::img($uuid, $options); //draw img tag
echo Image::img($image, ['width' => '100'])->resize(200)->crop(100,100); //resize and crop image, then render img tag