misteio/cloudinary-bundle

Cloudinary Wrapper

MisteioCloudinaryBundle

, _(*1)

MisteioCloudinaryBundle is a Symfony2/3 Bundle forked from laravel4-cloudinary (thanks Teeplus) and cloudinary-bundle (thanks Speicher210). You can use it as a service, and some extends are implemented for Twig. Cloudinary Library v1.7.1., _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require misteio/cloudinary-bundle, <sub>(*4)</sub>

or in composer.json file
``` bash
"misteio/cloudinary-bundle": "dev-master"

Register the bundle in app/AppKernel.php:, <sub>(*5)</sub>

``` php public function registerBundles() { return array( // ... new Misteio\CloudinaryBundle\MisteioCloudinaryBundle(), // ... ); }, <sub>(*6)</sub>

Configuration
-------------

Configure the connection to cloudinary in your `config.yml` :

``` yaml
misteio_cloudinary:
  cloud_name: yourCloudRegistrationName
  api_key: yourApiKey
  secret_key: yourSecretApiKey

Usage

This wrapper api provide simple methods to upload, rename, delete, tag manage and full features from original cloudinary class methods. You can use it via Dependency Injection Component(DIC) service., <sub>(*7)</sub>

    $cloudinary = $this -> container -> get('misteio_cloudinary_wrapper');

Upload Image, <sub>(*8)</sub>

    $cloudinary -> upload('path/to/file', 'name', $tags, $options)

Upload Video (Latest argument is for large files), <sub>(*9)</sub>

    $cloudinary -> uploadVideo('path/to/file', 'name', $tags, true)

Display an image, <sub>(*10)</sub>

    $cloudinary -> show('public_name', array('width' => 150, 'height' => 150, 'crop' => 'fit', 'radius' => 20));

Display an image using HTTPS, <sub>(*11)</sub>

  $cloudinary -> show('public_name', array('width' => 150, 'height' => 150, 'crop' => 'fit', 'radius' => 20, 'secure' => true));

Display a video, <sub>(*12)</sub>

    $cloudinary -> showVideo('public_name', array('width' => 150, 'height' => 150, 'crop' => 'fit', 'radius' => 20));

Display a video using HTTPS, <sub>(*13)</sub>

  $cloudinary -> showVideo('public_name', array('width' => 150, 'height' => 150, 'crop' => 'fit', 'radius' => 20, 'secure' => true));

More document from cloudinary.com, <sub>(*14)</sub>

Rename file, <sub>(*15)</sub>

    $cloudinary -> rename('from_public_id', 'to_public_id');

Delete file, <sub>(*16)</sub>

    $cloudinary -> destroy('public_id');

Manage with tag, <sub>(*17)</sub>

    $cloudinary -> addTag('my_tag_1', array('my_public_id', 'my_public_id_2'));
    $cloudinary -> removeTag('my_tag_2', array('my_public_id', 'my_public_id_2'));
    $cloudinary -> replaceTag('my_tag_3', array('my_public_id', 'public_id_2'));

Twig for displaying image

    {{ 'my_public_id'|cloudinary_url({"width" : 150, "height" : 150, "crop" : "fill", "radius" : 20}) }}

Twig for displaying image using HTTPS

  {{ 'my_public_id'|cloudinary_url({"width" : 150, "height" : 150, "crop" : "fill", "radius" : 20, "secure" : true}) }}

Twig for displaying video

    {{ 'my_public_id'|cloudinary_url_video({"width" : 150, "height" : 150, "crop" : "fill", "radius" : 20}) }}

Twig for displaying video using HTTPS

  {{ 'my_public_id'|cloudinary_url_video({"width" : 150, "height" : 150, "crop" : "fill", "radius" : 20, "secure" : true}) }}

Security

If you discover a security vulnerability , please email instead of using the issue tracker. All security vulnerabilities will be promptly addressed., <sub>(*18)</sub>

License

This Wrapper is open-sourced software licensed under the MIT license, <sub>(*19)</sub>