Skip to content

Latest commit

 

History

History
143 lines (113 loc) · 6.13 KB

Getting-started.rst

File metadata and controls

143 lines (113 loc) · 6.13 KB

Getting started

Initializing the PIM with a XLSX file

Create an InstallerBundle

You can create your own InstallerBundle by following the instructions from the documentation : http://docs.akeneo.com/1.4/cookbook/setup_data/customize_installer.html

Copy the fixtures

All minimal fixtures are located in the Resources/fixtures/minimal folder inside the ExcelConnectorBundle.

All these fixtures can't be set in the init.xslx files. Be sure to use the very same name/code in both the init.xslx files and the YML files.

Place them in the same directory inside your InstallerBundle. Here is a description of what each files contains:

CE edition

You can still have a look at the Akeneo PIM minimal fixtures set to get a full list of the files and their expected format.

EE edition (incl. CE files)

EE edition adds support of ACL, please refer to the minimal fixtures set located in the InstallerBundle to see the structure and the content of the files. Note that you cannot define ACL in the init.xslx file and will have to define them separately.

File Description
attribute_groups_accesses.yml Contains ACL for attribute groups
category_accesses.yml Contains ACL for categories
locale_accesses.yml Contains ACL for locales
jobs_accesses.yml Contains ACL for jobs
asset_categories.csv Contains assets master category
asset_category_accesses.yml Contains ACL for assets categories

Customize init.xslx !

Edit the init.xlsx file to match your needs following the instructions inside the file itself. The file is composed of various tabs that allow you to set your catalog structure:

  • channels
  • categories
  • group types
  • association types
  • attributes
  • attribute groups
  • attribute options
  • families (as many tabs as required)

See tab description section for more details on how to customize the init.xslx file.

Change PIM parameter to use your custom installation

You have to override pim_installer.fixture_loader.job_loader.config_file. To do so, add the following lines in the parameters.yml. If this file does not exist, create it in Acme/Bundle/InstallerBundle/Resources/config/parameters.yml and make sure that the file is loaded inside DependencyInjection/AcmeBundleInstallerExtension.php :

parameters:
    pim_installer.fixture_loader.job_loader.config_file: 'PimExcelConnectorBundle/Resources/config/fixtures_jobs.yml'

Define the data used by the installer :

# app/config/pim_parameters.yml
parameters:
    ...
    installer_data: 'AcmeDemoBundle:minimal'