UPDATE: We support both Magento 1 and Magento 2. These instructions refer to Magento 1. A full user guide of our module for Magento 2 can be found on the Magento marketplace, here
The following are the steps to install and set-up the Cloudinary module on your Magento 1 site.
Download and Install the Module
In the Magento Marketplace, download and install the Cloudinary module for Magento 1.
For more information, see the help pages for the Magento Marketplace.
After installing the Cloudinary module, a new Cloudinary menu is available in the Magento Admin Panel.
Configure the Cloudinary Module
- In the Admin Panel, select Cloudinary > Configuration.
- In the Cloudinary Setup section:
- In Cloudinary Account Credentials, enter your CLOUDINARY_URL environment variable, as shown in the Dashboard of your Cloudinary console (including the "CLOUDINARY_URL=" part of the code). For example:
CLOUDINARY_URL=cloudinary://1234567890123:aBc1deF2gHi-M@mycloudname - Set Enable Cloudinary to Yes.
- If needed, adjust the default Cloudinary Configuration settings. For more details on the auto-mapping option, see "Migrate on Demand with Auto-Mapping (Recommended)" below.
- The Default Image Transformations section enables you to define the default transformations that will be applied to every asset you deliver via Cloudinary. In addition to setting your preferences for the specific transformation options in this section, you can add additional global custom transformations that will be applied to every image asset.
For details on transformations you can use for global custom transformations, see Cloudinary's image transformation guide and reference.
Click the Preview custom transformation button to make sure you are satisfied with your transformation settings. - When finished, click the Save config button at the top of the page.
Migrate on Demand with Auto-Mapping (Recommended)
Auto upload mapping eliminates the need for manual migration. This option automatically fetches individual images from your Magento environment when they are first requested and uploads them to Cloudinary. On all subsequent page loads, the images will automatically be served directly from your Cloudinary Media Library.
To enable auto mapping:
- In the Magento Admin Panel, Cloudinary Configuration form, make sure that the Use auto upload mapping to upload images option is set to Yes (default). For details, see "Configure the Module" above.
- In the Magento Admin Panel, select System > Cache Management.
- Select all required cache types. Then select Refresh from the Actions drop-down above the options grid and click the Submit button.
Migrate All Images to Cloudinary (Manual Migration Fallback)
Manual migration is not required if you have enabled auto-mapping as described above. The manual migration option performs a full bulk migration of all images in your Magento environment.
- Make sure you have cron jobs defined on your Magento server.
- In the Magento Admin Panel, select Cloudinary > Manual Migration.
- Click Start Migration.
The migration takes place in the background via cron, so you can close the Manual Migration page or keep it open to track its progress. Any errors that prevent migration will be shown on the Manual Migration page. If this happens, click the Stop Migration button, resolve the problem, and then start the migration again. - When the migration is complete, select System > Cache Management. Select all required cache types. Then select Refresh from the Actions drop-down above the options grid and click the Submit button.
Note that the initial migration process may take a while, especially if you have many images.
Comments
6 comments
Documentation is needed for Magento 2 as these instructions do not apply.
Hi Donovan,
Thanks for pointing this out. these indeed fit M1 more than M2. and we would make another article the fits M2 as well.
Please note that although the places of the setup on the UI is different, the general instructions are still the same for both M1 and M2.
If you have any specific question we would be happy to help out. You could also send a request to support@cloudinary.com so we could take a closer look at your specific use case.
So sad we have to guess how to use the "Global custom transformation"... Tried (and failed) different things from the general linked documentation (PHP, JS, etc.) but how we use these in the Magento field?
Hi,
Thank you for your feedback!
The "Global custom transformation" field is set with transformations in a URL format. This means, that for example, if you'de like the "grayscale" effect to be set to all images delivered by Cloudinary, you can set the global transformation to - e_grayscale
Additional information regarding the transformation parameters can be found here -
https://cloudinary.com/documentation/image_transformation_reference
Please let me know if there is a specific transformation you would like to perform, and I'd be glad to help you with constructing it.
Olá, tentei instalar o modulo Magento pelo Magento Conect e não funcionou. Colocou a loja em Manutenção.
Baixei o modulo e descompactei no servidor e também não funcionou. Deu erro no PHP
Hi Rua 44,
In order to better help you on this, can you open a ticket on our support portal and provide as much detail as possible on what error you are getting?
Regards,
Erwin Lukas
Please sign in to leave a comment.