README

This is rebuild of https://github.com/zxbodya/yii-gallery-manager

Features

AJAX image upload Optional name and description for each image Possibility to arrange images in gallery Ability to generate few versions for each image with different configurations Drag & Drop

Decencies

Yii2 Twitter bootstrap assets (version 3) Imagine library JQuery UI (included with Yii) Installation: The preferred way to install this extension is through composer.

Install

run

php composer.phar require resmedia/yii2-mongo-gallery-manager

or run

composer require resmedia/yii2-mongo-gallery-manager

or add to composer

{
  "resmedia/yii2-mongo-gallery-manager": "^1.1.1"
}

Usage

1) Add widget where you need to upload images

GalleryManager::widget([
    'model' => $model,
    'behaviorName' => 'galleryBehavior',
    'apiRoute' => 'galleryApi'
])

2) Add to controller examples

with actions and behaviors

$actions['galleryApi'] = [
   'class' => GalleryManagerAction::class,
   'types' => [
       'news' => News::class
   ]
];

$behaviors['access']['rules'] = [
      [
           'actions' => [
                    ......, 'galleryApi',
           ],
           'allow' => true,
           'roles' => ['@'],
      ],
];

or only actions

class NewsController extends Controller
{
...
public function actions()
{
    return [
       'galleryApi' => [
           'class' => GalleryManagerAction::class,
           // mappings between type names and model classes (should be the same as in behaviour)
           'types' => [
               'news' => News::class
           ]
       ],
    ];
}

3) Add to model

'galleryBehavior' => [
       'class' => GalleryBehavior::class,
       'type' => 'news',
       'extension' => 'jpg',
       // image dimmentions for preview in widget
       'previewWidth' => 300,
       'previewHeight' => 200,
       // path to location where to save images
       'directory' => Yii::getAlias('@api') . '/web/bucket/items',
          'url' => Yii::$app->params['domainFrontend'] . '/bucket/items',
          // additional image versions
          'versions' => [
              'original' => function ($img) {
                  $width = 1000;
                  $height = 550;
                  return $img
                      ->copy()
                      ->thumbnail(new Box($width, $height), ImageInterface::THUMBNAIL_OUTBOUND);
              },
              'medium' => function ($img) {
                  $width = 600;
                  $height = 328;
                  return $img
                      ->copy()
                      ->thumbnail(new Box($width, $height), ImageInterface::THUMBNAIL_OUTBOUND);
              },
              'preview' => function ($img) {
                  $width = 300;
                  $height = 164;
                  return $img
                      ->copy()
                      ->thumbnail(new Box($width, $height), ImageInterface::THUMBNAIL_OUTBOUND);
              },
          ]
      ],
 ]

See also documentations of imagine for image transformations.

4) To get images

foreach($model->getBehavior('galleryBehavior')->getImages() as $image) {
    echo Html::img($image->getUrl('medium'));
}

TODO

Make alert on big or small size

resmedia / yii2-mongo-gallery-manager

Maintainers

Details