laker-ls/yii2-ar-image

A set for upload, delete and display images.

0.7.0 2021-11-05 13:53 UTC

Requires

• yiisoft/yii2-imagine: ~2.2.0

BSD-3-Clause

• Владислав Сусып

• extension
• Behavior
• widget
• yii2
• widgetInput

README

yii2-ar-image

Это расширение предназначено для загрузки изображений на yii2 и содержит в себе WidgetInput и Behavior.

Установка

Рекомендуемый способ установки этого расширения является использование composer. Проверьте composer.json на предмет требований и зависимостей данного расширения.

Для установки запустите

$ php composer.phar require laker-ls/yii2-ar-image "~0.7.0"

или добавьте в composer.json в раздел require следующую строку

"laker-ls/yii2-ar-image": "~0.7.0"

Смотрите список изменений для подробной информации о версиях.

Использование

Использования виджета в ActiveRecord:

use lakerLS\arImage\widgets\ArImageInput;

echo $form->field($model, 'image')->widget(ArImageInput::class);

cartSize - размер карточек изображений. По умолчанию 'normal'. Возможные значения: normal, large.

Подключение поведения в необходимой модели:

use lakerLS\arImage\behaviors\ArImageBehavior;

public function behaviors()
{
    return [
        'ArImageBehavior' => [
            'class' => ArImageBehavior::class,
            'fields' => ['image'],
        ]
    ];
}

fields - обязательное свойство, в котором указываются поля таблицы, в которых будут сохраняться изображения.
imageFolderOriginal - путь к папке, в которой хранятся оригинальные изображения.
imageNotFound - путь к изображению, которое используется при отсутствии оригинала.

Использование виджета для отображения изображений на странице. Отображение одного изображения.

use lakerLS\arImage\widgets\ArImageThumbnail; 

$result = ArImageThumbnail::widget([
    'image' => unserialize($fashionModel->images)[0] ?? null,
    'size' => ['width' => 300, 'height' => 200],
    'options' => [
        'alt' => 'Наименование изображения',
        'data-example' => 'Необходимые атрибуты'
    ],
]);

Использование виджета для отображения изображений на странице. Отображение нескольких изображений.

use lakerLS\arImage\widgets\ArImageThumbnail; 

foreach (unserialize($model->images) as $image) {
    $result = ArImageThumbnail::widget([
        'image' => $image,
        'size' => ['width' => 300, 'height' => 200],
        'options' => [
            'alt' => 'Наименование изображения',
            'data-examplt' => 'Необходимые атрибуты'
        ],
    ]);
}

src - путь, по которому хранится оригинальное изображение. size - размеры миниатюры. options - свойства тега img. imageFolderThumbnail - путь к папке, в которой хранятся миниатюры изображения.
imageNotFound - путь к изображению, из которого будет создана миниатюра, если оригинал отсутствует.

Лицензия

yii2-nested-set-menu выпущено по лицензии BSD-3-Clause. Ознакомиться можно в файле LICENSE.md.