z_bodya/yii-gallery-manager

Extension for yii, that allows to manage image galleries

dev-master 2015-03-18 11:55 UTC

Requires

• z_bodya/yii-image: dev-default

BSD-3-Clause

• Bogdan Savluk

• image
• gallery

README

Manual

1. Checkout source code to your project, for example to ext.galleryManager.

2. Install and configure image component(https://bitbucket.org/z_bodya/yii-image).

3. Import gallery models to project, by adding "ext.galleryManager.models.*" to import in config/main.php

4. Add GalleryController to application or module controllerMap.

5. Configure and save gallery model

    :::php
    $gallery = new Gallery();
    $gallery->name = true;
    $gallery->description = true;
    $gallery->versions = array(
        'small' => array(
            'resize' => array(200, null),
        ),
        'medium' => array(
            'resize' => array(800, null),
        )
    );
    $gallery->save();
   

6. Render widget for gallery created above:

    :::php
    $this->widget('GalleryManager', array(
        'gallery' => $gallery,
        'controllerRoute' => '/admin/gallery', //route to gallery controller
    ));
   

Using GalleryBehavior

Using gallery behavior is possible to add gallery to any model in application.

To use GalleryBehavior:

1. Add it to your model:

    Example:
    public function behaviors()
    {
        return array(
            'galleryBehavior' => array(
                'class' => 'GalleryBehavior',
                'idAttribute' => 'gallery_id',
                'versions' => array(
                    'small' => array(
                        'centeredpreview' => array(98, 98),
                    ),
                    'medium' => array(
                        'resize' => array(800, null),
                    )
                ),
                'name' => true,
                'description' => true,
            )
        );
    }
   

2. Add gallery widget to your view:

    Example:
    <h2>Product galley</h2>
    <?php
    if ($model->galleryBehavior->getGallery() === null) {
        echo '<p>Before add photos to product gallery, you need to save product</p>';
    } else {
        $this->widget('GalleryManager', array(
            'gallery' => $model->galleryBehavior->getGallery(),
        ));
    }
    ?>
   

Changing image versions for gallery associated with behavior

1. Update your model with new versions configuration

2. Run following code(best place for it - in migration):

    :::php
    $models = Model::model()->findAll();
    foreach($models as $model) $model->galleryBehavior->changeConfig();
   

Note: to run in migration you should define 'webroot' path alias.