Skip to content
Setup your Akeneo PIM data with a single init.xls file
Branch: master
Clone or download
mmetayer Merge pull request #68 from pchasle/patch-1
Revert PIM dependency to version >=3.0 <4.0
Latest commit daa0d12 Apr 29, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.ci Pim 3.0 compatibility (#66) Feb 6, 2019
doc
spec/Pim/Bundle/ExcelInitBundle
src Pim 3.0 compatibility (#66) Feb 6, 2019
.gitignore Prepare 1.2.5 version (#47) Sep 5, 2017
.php_cs.php Jenkinsfile Mar 2, 2017
CHANGELOG-2.0.md Add categories step to import job (#56) Dec 1, 2017
CHANGELOG-2.1.md PIM 2.2 migration (#62) Mar 15, 2018
CHANGELOG.md Prepare 1.2.5 version (#47) Sep 5, 2017
LICENCE.txt Initialize bundle from Excel Connector Bundle Aug 25, 2016
README.md Pim 3.0 compatibility (#66) Feb 6, 2019
composer.json
composer.lock
docker-compose.yml Pim 3.0 compatibility (#66) Feb 6, 2019

README.md

Excel Init Bundle

Build Status

alt text

This bundle adds support of Excel XSLX files as a source for initializing catalog structure for Akeneo PIM.

This extension replaces the ExcelConnectorBundle for Akeneo PIM >= 1.6. Be carefull to use the new init.xlsx file of this bundle as there are some structure modifications.

Note: this bundle is not compatible with Excel 2003 xls files. Editing the XLSX file with LibreOffice/OpenOffice is also not supported as it can lead to unwanted behavior.

Requirements

ExcelInitBundle Akeneo PIM Community Edition
v3.0.* >= v3.0
v2.1.* >= v2.2 - < 3.0
v2.0.* v2.0 - v2.1
v1.2.* v1.7.*
v1.1.* v1.6.*
v1.0.* v1.6.*

Installation

From your application root:

    php composer.phar require --prefer-dist akeneo/excel-init-bundle:3.0

Enable the bundle in the app/AppKernel.php file in the registerProjectBundles() method:

    $bundles = [
        // ...
        new Pim\Bundle\ExcelInitBundle\PimExcelInitBundle(),
    ]

Now let's clean your cache and dump your assets:

    php bin/console cache:warmup --env=prod
    php bin/console pim:installer:assets --env=prod

Documentation

Getting started

See doc/Getting started for more details on how to set your catalog structure using the init.xslx file.

See doc folder for more details on how to set your catalog structure.

Supported file

Input file must follow init.xslx structure.

Note that the file should be opened with Excel. LibreOffice/OpenOffice are not fully in compliance with validations data that are available in the spreadsheet.

Troubleshooting

The import fails when importing families

Check that your channels names are correct in both family and channel tabs. You might have a typo in the channels tab and not in the family tab. You will have to remove the mispelled channel once you corrected this.

Dev notes

Unit tests

You can launch the PHPSpec tests with the provided docker-compose.yml file:

docker-compose pull
docker-compose up -d
docker-compose exec fpm composer install --prefer-dist
docker-compose exec fpm ./bin/phpspec run
You can’t perform that action at this time.