Akeneo Image Importer | Local File & FTP URL Image Impoter

Kavita Singh

Published: August 19, 2022

Akeneo Image Importer: Importing photos is now simple because you can do so from both an FTP URL and a local directory.

When importing images from a local directory, you must specify the image’s path since the names of the images for products & product models will be used to determine which images to assign to which items.

You must specify the path and the FTP information for the FTP URL. The picture name will be used here as well to determine how the images are assigned.

Basic Requirements

Before you begin, please see the minimum requirements for using this module:

This module is compatible with the Akeneo community and Enterprise(Flexibility) edition.
If you want to use this extension on Akeneo EE Serenity mode, please contact us.
For the Akeneo installation, your Akeneo server should meet these system requirements.
This module works with Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x, 4.0.x, 5.0.x.Download Akeneo from here

Features

From the FTP URL, import the product images.
Import Product Images from the Local Directory.
For products, images assignment will be based on their SKU/image name.
The product model uses the product model code for image naming and assignment.

Composer Installation

Read This Blog

Searching for an experienced
Akeneo Company ? Read More

Before beginning the composer installation

1: Get the ACCESS KEYS [Create a support ticket]
2: In Akeneo composer.json, add our repository as well as the installation script.

For Akeneo <=5.x

{
  "scripts": {
        "post-update-cmd": [
           
"vendor/webkul/imageimporterconnector/composer_install.sh"
        ],
        "post-install-cmd": [
           
"vendor/webkul/imageimporterconnector/composer_install.sh"
        ],
        "post-create-project-cmd": [
         
"vendor/webkul/imageimporterconnector/composer_install.sh"
       ]
   },
  "repositories": [{
    "type": "composer",
    "url": "https://akeneorepo.webkul.com/"
  }]
}

3: Use composer to install the extension.

         composer require webkul/imageimporterconnector

4: Complete the authentication form.
5: Send a Message of Success
6: Delete your browser’s cache.

Installing Module for Version 4.0.x to 5.0.x

Please follow these steps for installing the Akeneo Image Importer module in your Akeneo PIM platform.

1 – Unzip the respective extension zip then merge the “src” folder into akeneo project root directory.

2 – Goto config/Bundles.php then add the line:

  Webkul\ImageImporterBundle\ImageImporterBundle::class => ['all' => true],
  Ijanki\Bundle\FtpBundle\IjankiFtpBundle::class => ['all' => true]

in the return array.

3 – Copy the “config” folder into the akeneo project root directory for routing.

4 – Run this command after ssh to your akeneo server by the terminal

php -d memory_limit=4G /usr/local/bin/composer require ijanki/ftp-bundle --no-scripts
rm -rf var/cache/ && php bin/console image:setup:install --env=prod;

5 – If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.

For Akeneo 5

sudo service php-fpm7.4 restart

For Akeneo 4

sudo service php-fpm7.3 restart

Docker Installation Command :

For Akeneo 5

alias docker_php='docker-compose run -u www-data --rm php php';
alias docker_yarn='docker-compose run -u node --rm node yarn';
docker_php bin/console cache:clear --env=prod;
docker_php bin/console pim:installer:assets --symlink --clean --env=prod;
docker_php bin/console d:s:u --force;
docker_yarn run webpack;
docker_yarn run update-extensions;
docker_yarn run less;

For Akeneo 4

alias docker_php='docker-compose run -u www-data --rm php php';
alias docker_yarn='docker-compose run -u node --rm node yarn';
docker_php bin/console cache:clear --env=prod;
docker_php bin/console pim:installer:assets --symlink --clean --env=prod;
docker_php bin/console d:s:u --force;
docker_yarn run webpack;
docker_yarn run less;

Installing Module For Version 3.x

Please follow these steps for installing the Akeneo SEO Manager module in your Akeneo PIM platform.

1 – Unzip the respective extension zip then merge the “src” folder into akeneo project root directory.

2 – After that, go to app/AppKernel.php then add the line.

new Webkul\ImageImporterBundle\ImageImporterBundle(),
new Ijanki\Bundle\FtpBundle\IjankiFtpBundle(),

3 – Goto app/config/routing.yml then add these lines at top of file.

images_import_bundle:
      resource: "@ImageImporterBundle/Resources/config/routing.yml"
      prefix:   /

4 – Then run this command after ssh to your akeneo server by the terminal.

php -d memory_limit=4G /usr/local/bin/composer --no-scripts require ijanki/ftp-bundle --ignore-platform-reqs
rm -rf var/cache/ && php bin/console image:setup:install --env=prod;

5 – If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.

sudo service php-fpm7.2 restart

Common Issues After Installation

It might happen that even after proper installation, upon opening your Akeneo admin dashboard, you see a loading screen. In that case, do check for the following solution:

Webpack Installation: If you get the below error

It means that web pack is not installed in your system. Run the following command.

npm install --save-prod webpack
npm install

Module routing.yml is not configured properly. Re-check the routing.yml file as mentioned in the 3rd step of Module Installation
Clear your browser cache.

How to add images to a folder

To begin, create a folder named product/model image inside of another folder with the same name as the product/model SKU. This folder should be created inside the FTP directory path.

In the directory, you must create an image folder. Add images in the Product image folder. For example, image/ProductskuImageFolder/Productsku.jpg

A product image’s naming convention is as follows:

If the SKU is 1234
Accordingly, the filename for the image should be 1234.jpg. Image names must not contain an underscore but rather a hyphen.
The image names will be 1234-1.jpg and 1234-2.jpg if more than one image is available.

Product/model SKU is always the sole information that appears in the main image, never with a hyphen.
Example: 1234.jpg