misteio/cloudinary-bundle

Cloudinary Wrapper

v0.2 2017-01-05 10:30 UTC

Requires

• php: >=5.4
• cloudinary/cloudinary_php: 1.4.2
• symfony/symfony: ~2.7|~3.0
• twig/extensions: ~1.1

Requires (Dev)

• codeclimate/php-test-reporter: dev-master
• phpunit/phpunit: 4.7.*

MIT

• Miste IO

• api
• bundle
• cloudinary
• misteio

README

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.

Install

Via Composer

$ composer require misteio/cloudinary-bundle

or in composer.json file

"misteio/cloudinary-bundle": "dev-master"

Register the bundle in app/AppKernel.php:

public function registerBundles()
{
    return array(
        // ...
        new Misteio\CloudinaryBundle\MisteioCloudinaryBundle(),
        // ...
    );
}

Configuration

Configure the connection to cloudinary in your config.yml :

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.

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

Upload Image

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

Upload Video (Latest argument is for large files)

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

Display an image

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

Display an image using HTTPS

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

Display a video

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

Display a video using HTTPS

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

More document from cloudinary.com

Rename file

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

Delete file

	$cloudinary -> destroy('public_id');

Manage with tag

    $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.

License

This Wrapper is open-sourced software licensed under the MIT license