README

The module provides a library and stream wrapper of Cloudinary service.

It can help user easily to use Cloudinary image transformation in Drupal, and it can convert all drupal default image effects into Cloudinary transformations.

Modules

This module include several sub-modules, some modules can be used alone as other modules.

cloudinary

Provides image transformations of Cloudinary, implements hook_image_effect_info().

Provides image style feature with Cloudinary image transformations.

Auto convert image effects (Crop, Desaturate, Resize, Rotate, Scale, Scale and crop) of drupal's image style into Cloudinary image transformations, without patch.

cloudinary_streamwrapper

Provides stream wrappers to access Cloudinary files (images, raw files). Support read and write with "cloudinary[.folder]".

So you can easily upload your images to Cloudinary with default drupal method based on streamwrapper "cloudinary://".

And this module has a hook let user can easily convert other image effects to Cloudinary transformation, cloudinary module has been use this hook to implemnt Cloudinary transformation for drupal default image effects.

cloudinary_storage

Provides storage file structure of Cloudinary to local, it will be load file structure from storage to reduce network requests and improve loading speed for uploaded Cloudinary files.

Also it has several sub-modules to implement storage based on db, filesystem, mongodb, redis.

• cloudinary_storeage_db - Save file structure into drupal database.
• cloudinary_storeage_file - Save file structure into filesystem.
• cloudinary_storeage_mongodb - Save file structure into mongodb, require Mongodb(https://www.drupal.org/project/mongodb).
• cloudinary_storeage_redis - Save file structure into redis, require Redis(https://www.drupal.org/project/redis).

cloudinary_sdk

Support library of Cloudinary SDK for the other modules. Implements hook_libraries_info().

Requirements

• Libraries(http://drupal.org/project/libraries)
• Cloudinary SDK for PHP(https://github.com/cloudinary/cloudinary_php)
• Cloudinary API Account(https://cloudinary.com/console)

Usage

Drush make file

On github repository(git@github.com:everright/cloudinary_drush_make.git), it include a drush make file for you to test cloudinary module quickly.

You just need to clone the make files, then drush make it and install your drupal site.

cloudinary_sdk

All modules dependency cloudinary_sdk.

• Log in cloudinary console 'https://cloudinary.com/console' to get API account.
• Install and enable module 'cloudinary_sdk' as usual.
• Go to cloudinary settings page 'admin/config/media/cloudinary'.
• On settings page, type your Cloud name, API key and API secret.
• Click 'Save configuration' button to save API account. In order to check the validity of the API, system will be auto ping your Cloudinary account after change API settings.
• If there has no error messages, it means connect to cloudinary_sdk successfully.

cloudinary_stream_wrapper

• Install and enable module 'cloudinary_sdk' as usual.
• After module installed, you will be see cloudinary stream wrapper option on file or image field setting form.
• You also can use cloudinary stream wrapper "cloudinary://" to save images with your code, like "file_save_data(your image data here, cloudinary://sample.jpg))".
• In cloudinary settings page, you can enable more stream wrappers for Cloudinary with folder name under root folder, after enable it, you can use "cloudinary.folder_name://" to save your images into this folder as root.

cloudinary_storage

• Install and enable module 'cloudinary_storage' and it's sub-modules as usual, you can just choose one sub-module to cache the file structure.
• After module installed, in cloudinary settings page, you can enable one of cloudinary storage settings.
• If you enabled cloudinary storage for file structure, it will be reduce network requests and improve loading speed for uploaded Cloudinary files.

cloudinary

• Install and enable module 'cloudinary' as usual.
• After module installed, it will auto convert image effects (Crop, Desaturate, Resize, Rotate, Scale, Scale and crop) of drupal's image style into Cloudinary image transformations, without patch.
• Also it will be provides a new image effect "cloudinary_crop" on image style manage page, you can easy to create cloudinary transformation directly.

Bugs

Please report bugs and issues on drupal.org in the issue queue: http://drupal.org/project/issues/cloudinary

Remember to first search the issue queue and help others where you can!

Credits

The module was built by everright in Ci&T (http://www.ciandt.com).