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 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).
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.
The joomlatools/installer plugin is free and open-source software licensed under the GPLv3 license.
Alternatively, clone com_cloudinary
from our public git repository.
A third option, currently only available for Moyo developers, is by using the jsymlink script from the Moyo Git Tools.
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.