How to setup Cloudinary's Magento module?

The following are the steps to install and set-up the Cloudinary module on your Magento site:


Install the module

1. In the Magento Admin Panel, select 'Cache Management' from the System menu.
2. Select all cache types
3. choose 'Disable' from the Actions drop-down the top right and click the 'Submit' button.
4. go to the system menu and select 'Magento Connect > Magento Connect Manager' (you might be requested to enter your credentials again)
5. find the relevant extension key as found on Magento Connect in the 'Install New Extensions' tab.
6. Paste the extension key and click 'Install'.
7. Confirm that the Cloudinary extension dependencies are present, then click 'Proceed'.
8. When the installation is done, click 'Refresh'. Cloudinary should now be included in your packages list.
9. Log out of the Admin Panel, then log back in.
10.Return to the 'Cache Management' page. select all required cache types, choose 'Enable' from the Actions dropdown on the top right and click the 'Submit' button.


For more information about installing Magento modules, please refer to the Magento documentation.


Configure the Module

1. In the Magento Admin Panel, go to 'system' and click on 'Configuration'
2. Click on the new 'Cloudinary' menu link under the 'services' section
3. In the 'Cloudinary Setup' section of this page, enter your CLOUDINARY_URL, as found in your Dashboard.
4. Set 'Enable Cloudinary' to Yes.
5. Further options can be specified in the 'Cloudinary Configuration' and 'Default Image Transformations' sections of the Cloudinary config.
6. Click the 'Save config' button at the top right of the page.

Enable Auto Upload Mapping (Recommended)
Auto upload mapping eliminates the need for manual migration by fetching individual images from your Magento environment when they are first requested. On all subsequent page loads, images will be served directly from your Cloudinary Media Library.

1. In the Magento Admin Panel, go to 'system' and click on 'Configuration'
2. Click on the 'Cloudinary' menu link under the 'services' section
3. On the Cloudinary configuration section, Set 'Use auto upload mapping to upload images' to Yes.
4. Click the 'Save config' button at the top right of the page.
5. Click on 'Cache Management' from the System menu.
6. On to the 'Cache Management' page, select all required cache types, choose 'Refresh' from the Actions dropdown on the top right and click the 'Submit' button.

Migrate Images to Cloudinary (Fallback option)
Manual migration is not required if using auto-upload mapping.


It is recommended to enable foldered migration prior to migrating. Here is how to do that:
1. In the Magento Admin Panel, go to 'system' and click on 'Configuration'
2. Click on the 'Cloudinary' menu link under the 'services' section
3. On the Cloudinary configuration section, set 'Migrate images to folders relative to the Magento root folder' to Yes.
4. Click the 'Save config' button at the top right.

To start the migration process:
1. In the main admin navigation, from the 'Cloudinary' menu item click on 'Manage'
2. At the upper-right section, click on 'Enable Cloudinary', then click on 'Start Migration'. Make sure you have cron-jobs defined on your Magento server.

When the migration is complete, return to the 'Cache Management' page, select all cache types, choose 'Refresh' from the Actions drop-down and click the 'Submit' button.


The migration will take place in the background via cron, so you can leave the Manage page or keep it open to track its progress. Any errors that prevent migration will be shown on the Manage page - if this happens you can click the 'Stop Migration' button, resolve the problem, then start the migration again.
Note that the initial migration process may take a while, especially if you have a large number of images.

Have more questions? Submit a request

Comments

Powered by Zendesk