kolyya/photo-bundle

Allows you to upload an unlimited number of photos for the object, delete them and sort them. Also allows you to specify several formats for storing photos.

dev-master / 0.1.x-dev 2018-02-06 09:59 UTC

Requires

• php: >=5.3.2
• symfony/symfony: >=3.1

MIT

• Nikolai Gurin

• photo
• photo bundle
• sort photo
• resize photo

README

Allows you to upload an unlimited number of photos for the object, delete them and sort them. Also allows you to specify several formats for storing photos.

Requires

• intervention/image: >=2.3
• Dropzone Js
• jQuery UI

Installation

1. Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

   $ composer require kolyya/photo-bundle

2. Enable bundle in your AppKernel.php

   // AppKernel.php
   public function registerBundles()
      {
          $bundles = [
          // ...
          new Kolyya\PhotoBundle\KolyyaPhotoBundle(),
          // ...
          ];
      //...

3. Define routes

   # app/config/routing.yml
   kolyya_photo:
       resource: "@KolyyaPhotoBundle/Resources/config/routing.yml"

4. 4.1 Create an entity(ies) for photos, inheriting from Kolyya\PhotoBundle\Entity\Photo.

   4.2 Set methods getObject() and setObject()

5. Add object(s) in Config config.yml

   kolyya_photo:
        objects:
            product:
             object_class: AppBundle\Entity\Product
             photo_class: AppBundle\Entity\ProductPhoto
             check_permissions: app.check_permissions
             path: images/product
             manager_format: small
             formats:
                 small:
                     resize: [120,120]
                 medium:
                     heighten: 250
                 full:
                     resize: false
                     heighten: false
            <ANOTHER_OBJECT>
            ...

Usage

1. On the page where the photo editor form will be include Dropzone Js and jQuery UI

   {# Dropzone Js #}
   <link rel="stylesheet" href="{{asset('lib/dropzone/dropzone.css') }}">
   <script type="text/javascript" src="{{asset('lib/dropzone/dropzone.js') }}"></script>
   {# Jquery Ui #}
   <script type="text/javascript" src="{{ asset('lib/jquery-ui/jquery-ui.min.js') }}"></script>

2. Include a handler template with parameters objectId, objectName, photos

   {{ kolyya_photo_manager(<objectId>, <objectName>, <photos>) }}

Config

Object

• object_class - Object Entity for which photos are added;
• photo_class - Photo Entity;
• check_permissions - optional - [Service](#Check Permissions) to verify the rights to actions with this object;
• path - Path, relative to the web directory for storing photos;
• manager_format - Format of Photo, to show in handler;
• formats - List of formats to store photos.

Format

The format name is the folder name for this format

• resize | boolean/array | optional | Fit in a specific format (default: false)
• heighten | boolean/integer | optional | Fit to width (default: false)

Check Permissions

When you need to check the permissions, one of the methods works: canUpload(), canDelete() or canSort().

• $object - Product Object
• $photo - Photo Object

    public function canUpload($object)
    {
        return true;
    }

    public function canDelete($photo)
    {
        return true;
    }

    public function canSort($object)
    {
        return true;
    }

This example allows everyone to do anything.