We have two methods of integrating ImageEngine with a Magento 2.x site:
- Directly modifying the Base URLs in your Magento 'web' settings.
- Using a plugin that we have created for the purpose of integrating with Magento.
In both cases, to implement ImageEngine’s image optimization for Magento 2.x, you will first need to sign up for an ImageEngine account, if you do not already have one. During the signup process, you’ll be asked for the website domain where you intend to use ImageEngine and origin URL for the majority of the images. For more information about signing up, please refer to this article: Getting Started: Signup.
Once signed up, you will be issued a unique delivery address following this pattern: “aabbcc.cdn.imgeng.in.” Custom delivery addresses may also be made after the initial signup process is complete. For more information, see our article here.
Take note of your delivery address, as it will be needed for both of the suggested deployment methods.
Base URL modification method:
- In the Admin Panel click the “Stores” and under the Settings category click “Configuration.”
In the General settings click on the “Web” section.
Open up the “Base URLs” settings.
Modify the “Base URL for User Media Files” to use your ImageEngine Delivery Address. Remember to append the Magento
media/directory to the end of the domain name:
Important: Perform the same operation in "Base URL for User Media Files" in the “Base URLs (Secure)” section.
Note: You must make this change to “Base URLs (Secure)” if you are serving HTTPS traffic
Save your Configuration.
It is recommended that the Catalog and Page Caches are flushed to ensure that the old image URLs are not still represented. To do this, navigate to System->Cache Management.
- Check the "Page Cache" box
- Click "Flush Catalog Images Cache"
- Click "Flush Magento Cache"
- Once finished, verify that images are being served by ImageEngine.
Installation using Composer
The ImageEngine Magento module is available on pagagist.org and can be installed using composer:
# Install the module with Composer
composer require scientiamobile/module-magento2-image-cdn-imageengine
# Enable the module
magento module:enable scientiamobile/module-magento2-image-cdn-imageengine
|Please pay attention to the supported PHP versions:
Installation through Magento Marketplace
This guide assumes your marketplace account is synced up with your Magento 2 instance. See this article if you need help setting up access keys which are used as marketplace login credentials within the application.
The Web Setup Wizard was deprecated in Magento 2.3.6 and is removed in Magento 2.3.7. After it is removed, you must use the command line to install or upgrade Magento, as well as modules and extensions.
See Magento's documenation for more information: Magento Marketplace Installation Process
Once on the Setup Wizard’s home page, proceed to Extension Manager:
To make sure the ImageEngine module is available, hit refresh, and go to the list of extensions awaiting installation:
Lastly, verify that the module is enabled. You can check its status in the Module Manager section:
Locate scientiamobile/magento2-module-io in the list of installed modules and ensure that it is turned on:
Go to Stores in the application menu and select Configuration:
You should see tab labeled "ScientiaMobile" on the left.
Log into your ImageEngine account via control.imageengine.io to access your account dashboard. Copy the “Delivery Address” from the Engines table.
Going back to the plugin settings in Magento, paste the ImageEngine Delivery Address into the “ImageEngine media URL” field. Be sure to include http:// or https:// in front of the Delivery Address.
This configuration will change the secure and non-secure base media URL in the Magento settings. Note that the module will automatically append the
media/path to the provided domain name.
Enable the module globally.
Save the configuration.
ImageEngine is now configured. Verify that images are loaded from the Delivery Address pasted into the ImageEngine media URL field.
You can fine-tune the image delivery in the ImageEngine control panel.