README

👁 Scrutinizer Code Quality
👁 Build Status

Facilitates the creation of PIM reference data and related views in the PIM.

For more information, please see http://docs.akeneo.com/

Requirements

Installation

You can install this bundle with composer (see requirements section):

 php composer.phar require "akeneo-labs/custom-entity-bundle":"4.0.*"

Then add the following lines at the end of your config/routes/routes.yml :

 pim_customentity:
 prefix: /reference-data
 resource: "@PimCustomEntityBundle/Resources/config/routing.yml"

and enable the bundle in the config/bundles.php file:

 return [
 // ...
 Pim\Bundle\CustomEntityBundle\PimCustomEntityBundle::class => ['all' => true]
 ];

If your installation is already set up, you have to run the following command in order to add the quick export job:

 php bin/console akeneo:batch:create-job "Akeneo Mass Edit Connector" "csv_reference_data_quick_export" "quick_export" "csv_reference_data_quick_export" '{"delimiter": ";", "enclosure": "\"", "withHeader": true, "filePath": "/tmp/reference_data_quick_export.csv"}'

Documentation

The reference data documentation can be found in the PIM documentation.

Detailled information can be found in the bundle documentation.

Run the Tests

Unit tests

 $ composer install
 $ vendor/bin/phpspec run

Code style

 $ composer install
 $ vendor/bin/php-cs-fixer fix -v --diff --config .php_cs.php

PHPUnit

• Install an Akeneo PIM with the CustomEntityBundle
• Copy Tests/Resources/phpunit.xml to project root
• Copy Tests/Resources/.env.test to project root, and edit accordingly to your config
• Copy Tests/Resources/bundles.php or Tests/Resources/bundles_ee.php (depending on your PIM version) content in the config/bundles.php file

Then:

 $ php bin/console cache:warmup --env=test

 If you're on EE Edition :
 $ php bin/console pim:installer:db --env=test --catalog vendor/akeneo/pim-enterprise-dev/src/Akeneo/Platform/Bundle/InstallerBundle/Resources/fixtures/minimal
 Else :
 $ php bin/console pim:installer:db --env=test --catalog vendor/akeneo/pim-community-dev/src/Akeneo/Platform/Bundle/InstallerBundle/Resources/fixtures/minimal

 $ vendor/bin/phpunit

Contributing

If you want to contribute to this open-source project, thank you to read and sign the following contributor agreement