Installation
Before installing the extension, please make sure to Backup your web directory and store database
You will require to install MageDelight Base Extension first. If it is not installed then please download it from https://www.magedelight.com/pub/extensions/magedelight-base.zip and unzip the package file into the root folder of your Magento 2 installation.
Root Directory is - "app/code/magedelight/#YourExtensionName#"
- Unzip the extension package file into the root folder of your Magento 2 installation.
- Connect to SSH console of your server:
- Navigate to the root folder of your Magento 2 setup
Run command as per below sequence,
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:clean
- log out from the backend and log in again
If you are using Magento 2.3 or later then you do not need to activate license. Extension will be activated with silent activation mechanism and does not require activation keys to be entered manually.
Backend Configuration (Admin side)
| Field | Description |
|---|---|
| Enable AI Image Generator | Allows you to enable or disable the AI image generation feature. Set this option to “Yes” to activate AI-based image creation within the system. |
| AI Provider | Selects the AI service provider responsible for generating images. Choose the preferred provider (e.g., Ayna) from the dropdown list. |
| Debug Mode | Enables or disables debug logging for troubleshooting purposes. Set this option to “Yes” only if technical support requires detailed logs to identify issues. |
| Field | Description |
|---|---|
| API Key | Enter your Ayna API key provided by the AI image generation service. This key is required for authentication and to establish a secure connection with the Ayna API. |
| API URL | Specify the Ayna API endpoint URL used for communication with the image generation service. |
| API Timeout (seconds) | Defines the maximum time (in seconds) the system waits for a response from the Ayna API before timing out. The default value is 60 seconds. |
| Max Polling Attempts | Sets the maximum number of times the system will poll the Ayna API to check for image generation results. The default value is 30 attempts. |
| Poll Interval (seconds) | Determines the interval (in seconds) between each polling attempt to check the image generation status. The default value is 10 seconds. |
| Field | Description |
|---|---|
| Images Per Request | Specifies the number of AI-generated images to be created in a single request. The default value is 5. |
| Max File Size (MB) | Defines the maximum file size (in megabytes) allowed for uploaded images. The default value is 10 MB. |
| Allowed Extensions | Lists the permitted file formats for image uploads. Provide a comma-separated list of extensions (default: jpg, jpeg, png, gif). |
| Field | Description |
|---|---|
| Enable Queue Processing | Allows you to enable or disable background queue processing for AI image generation requests. Set to “Yes” to process image generation asynchronously in the background. |
| Batch Size | Specifies the number of image generation requests to process in each batch. The default value is 10. |
Backend Functionality
Path: Catalog → Product → Add/Edit (Product) → AI Image Generator
The AI Image Generator allows store administrators to create realistic AI-generated product images by combining a garment image (such as a jacket) with a model image. This feature helps visualize how the product would appear when worn, enhancing the product gallery and improving customer engagement.
| Section | Description |
|---|---|
| Upload Images | In this section, you can upload two images: a Garment Image (for example, a jacket or clothing item) and a Model Image (a person on whom the garment will be visualized). |
| Garment Image | Upload the clothing item image that you want to generate AI-based visualizations for. |
| Model Image | Upload the model’s photo to be used for generating the try-on image. |
| Assign Generated Images to Product Gallery | When this option is enabled, all AI-generated images will automatically be added to the product’s image gallery. |
| Generate Images | After uploading both images, click the Generate Images button. The system will process your request and create AI-generated images showing the uploaded garment (e.g., jacket) on the model. The number of images generated depends on the configuration under Image Settings → Images Per Request. |
Thank you for choosing MageDelight!