2017 © Pedro Peláez
 

yii2-extension yii2-images

yii2 images module for storing images

image

numkms/yii2-images

yii2 images module for storing images

  • Monday, June 4, 2018
  • by numkms
  • Repository
  • 1 Watchers
  • 2 Stars
  • 19 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 80 Forks
  • 0 Open issues
  • 12 Versions
  • 19 % Grown

The README.md

yii2-images

Yii2-images is yii2 module that allows to attach images to any of your models, next you can get images in any sizes, also you can set main image of images set., (*1)

Since 2.0 you can upload your files simply with use files attributes;, (*2)

Module supports Imagick and GD libraries, you can set up it in module settings., (*3)

Usage instance:

$model = Model::findOne(12); //Model must have id

//If an image is first it will be main image for this model
$model->attachImage('../../image.png');

//But if you need set another image as main, use second arg
$model->attachImage('../../image2.png', true);

//get all images
$images = $model->getImages();
foreach($images as $img){
    //retun url to full image
    echo $img->getUrl();

    //return url to proportionally resized image by width
    echo $img->getUrl('300x');

    //return url to proportionally resized image by height
    echo $img->getUrl('x300');

    //return url to resized and cropped (center) image by width and height
    echo $img->getUrl('200x300');
}

//Returns main model image
$image = $model->getImage();

if($image){
    //get path to resized image 
    echo $image->getPath('400x300');

    //path to original image
    $image->getPathToOrigin();

    //will remove this image and all cache files
    $model->removeImage($image);
}

Details

  1. Get images, (*4)

    $model->getImage(); //returns main image for model (first added image or setted as main)
    
    $model->getImages(); //returns array with images
    
    //If there is no images for model, above methods will return PlaceHolder images or null
    //If you want placeholder set up it in module configuration (see documentation)
    
    
  2. Remove image/images, (*5)

    $model->removeImage($image); //you must to pass image (object)
    
    $model->removeImages(); //will remove all images of this model
    
  3. Set main image, (*6)

    $model->attachImage($absolutePathToImage, true); //will attach image and make it main
    
    foreach($model->getImages() as $img){
        if($img->id == $ourId){
            $model->setMainImage($img);//will set current image main
        }
    }
    
  4. Get image sizes, (*7)

    $image = $model->getImage();
    $sizes = $image->getSizes(); // Array. Original image sizes
    $sizes = $image->getSizesWhen('x500');
    echo '<img width="'.$sizes['width'].'" height="'.$sizes['height'].'" src="'.$image->getUrl('x500').'" />';
    
  5. Get original image, (*8)

    $img = $model->getImage();
    echo $img->getPathToOrigin();
    

Installation

  1. Add Yii2-images to the require section of your composer.json file:
       {
            "require": {
                "numkms/yii2-images": "dev-master"
            }
       }
    
  1. run
      php composer.phar update
    
  1. run migrate
    php yii migrate/up --migrationPath=@vendor/numkms/yii2-images/migrations
    
  1. setup module, (*9)

    'modules' => [
            'yii2images' => [
                'class' => 'numkms\yii2images\Module',
                //be sure, that permissions ok 
                //if you cant avoid permission errors you have to create "images" folder in web root manually and set 777 permissions
                'imagesStorePath' => 'images/store', //path to origin images
                'imagesCachePath' => 'images/cache', //path to resized copies
                'graphicsLibrary' => 'GD', //but really its better to use 'Imagick' 
                'placeHolderPath' => '@webroot/images/placeHolder.png', // if you want to get placeholder when image not exists, string will be processed by Yii::getAlias
                'imageCompressionQuality' => 100, // Optional. Default value is 85.
            ],
        ],
    
  2. attach behaviour to your model (be sure that your model has "id" property), (*10)

        public function behaviors()
        {
            return [
                'image' => [
                    'class' => 'numkms\yii2images\behaviors\ImageBehave',
                    'fileAttribute' => 'mainimage',
                    'filesAttribute' => 'gallery',
                ]
            ];
        }
    

Thats all!, (*11)

The Versions

04/06 2018

dev-master

9999999-dev

yii2 images module for storing images

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

by Rob Rhyne
by Costa numkms

yii2 store images images store yii2-images costa numkms

13/03 2018

2.0.0.2

2.0.0.2

yii2 images module for storing images

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

by Rob Rhyne
by Costa numkms

yii2 store images images store yii2-images costa numkms

12/03 2018

2.0.0.1

2.0.0.1

yii2 images module for storing images

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

by Rob Rhyne
by Costa numkms

yii2 store images images store yii2-images costa numkms

08/12 2017

2.0.0

2.0.0.0

yii2 images module for storing images

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

by Rob Rhyne
by Costa numkms

yii2 store images images store yii2-images costa numkms

24/01 2017

1.0.5

1.0.5.0

yii2 images module for storing images

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

by Rob Rhyne

yii2 store images images store yii2-images costa rico

26/11 2014

dev-widget

dev-widget

yii2 images module for storing images

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

by Costa Rico

yii2 store images images store yii2-images costa rico

05/11 2014

dev-imagesEffetcs

dev-imagesEffetcs

yii2 images module for storing images

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

by Costa Rico

yii2 store images images store yii2-images costa rico

27/10 2014

1.0.4

1.0.4.0

yii2 images module for storing images

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

by Costa Rico

yii2 store images images store yii2-images costa rico

11/08 2014

1.0.3

1.0.3.0

yii2 images module for storing images

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

by Costa Rico

yii2 store images images store yii2-images costa rico

09/08 2014

1.0.2

1.0.2.0

yii2 images module for storing images

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

by Costa Rico

yii2 store images images store yii2-images costa rico

22/07 2014

1.0.1

1.0.1.0

yii2 images module for storing images

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

by Costa Rico

yii2 store images images store yii2-images costa rico

17/07 2014

1.0.0

1.0.0.0

test

  Sources   Download

MIT

The Requires

 

The Development Requires

by Costa Nevazno

costa rico