/com_cloudinary

Cloudinary for Nooku Server

Primary LanguagePHP

com_cloudinary

Cloudinary is a cloud based image management service that acts as a CDN as well as an image manipulation tool. com_cloudinary is a Joomla! package that handles image uploads, manipulation and even multiple accounts.

The system requirements are

  • Nooku Server 12.X .
  • PHP 5.3.6 or better

or

  • Joomla 2.5 or 3.X
  • Koowa 0.9 or 1.0 (as yet, Koowa 2 is not supported)
  • PHP 5.3.10 or better

com_cloudinary was developed by Moyo Web Architects.

Installation

Composer

Installation is done through composer. In your composer.json file, you should add the following lines to the repositories section:

from this local repository;

{
    "name": "moyo/com_cloudinary",
    "type": "vcs",
    "url": "https://github.com/kedweber/com_cloudinary.git"
}

or from the company that funded this development;

{
    "name": "moyo/com_cloudinary",
    "type": "vcs",
    "url": "https://github.com/moyoweb/com_cloudinary.git"
}

The require section should contain the following line:

    "moyo/com_cloudinary": "1.0.*",

Afterwards, one just needs to run the command composer update from the root of your Joomla project. This will effectively create a composer.lock file which will contain the collected dependencies and the hash codes for each latest release (depending on the require section's format) for each particular repo. Should installations problems occur due to a bad ordering of the dependencies, one may need to go into the lock file and manualy change the order of the components. Running composer update again will again cause a reordering of the lock file, beware of this factor when running an update. Thereafter, you can run the command composer install.

If you have not setup an alias to use the command composer, then you will need to replace the word composer in the previous commands with the commands with php composer.phar followed by the desired action (eg. update or install).

jsymlinker

Another option is to run the jsymlink script in the root folder, available via the original Moyo developer, Joachim van de Haterd's repository, under the Moyo Git Tools.

License jsymlinker

The joomlatools/installer plugin is free and open-source software licensed under the GPLv3 license.

Github

Alternatively, clone com_cloudinary from our public git repository.

jsymlinker

A third option, currently only available for Moyo developers, is by using the jsymlink script from the Moyo Git Tools.

API

Example: Upload and resize

@service('com://admin/cloudinary.controller.image')
    ->path(*path*)
    ->width(125)
    ->height(125)
    ->cache(0)
    ->read();

Supported Cloudinary states

width
height
crop
gravity
radius
quality
angle
effect
border
background
overlay
underlay
page
density
fetch_format

...and more.

Check out the Cloudinary API for more information about the options for the states that you can use.