diff --git a/README.md b/README.md index fabc99a..53b40f9 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,60 @@ -# Flagbit TableAttributeBundle for Akeneo PIM # +
+ Key Features • + Installation • + Compatibility • + Development • + Contributing +
+ +## Key Features + +Provides a _table_ as attribute type where you can define a set of columns of different types and validation rules. + +#### Column Types -[](https://travis-ci.org/flagbit/akeneo-table-attribute-bundle) -[](https://scrutinizer-ci.com/g/Flagbit/akeneo-table-attribute-bundle) -[](https://packagist.org/packages/flagbit/table-attribute-bundle) -[](LICENSE) +* Text +* Number (Integer or Decimal) +* Simple select +* Simple select from URL + +#### Import/Export -Adds the new attribute type *Table* for Akeneo products. +The extension supports the standard Akeneo product import/export, so you don't need to create any special import/export profile for table information. -## Installation ## +All product information related to attributes of type _table_ will be imported/exported as JSON. + +## Installation -Now you can simply install the package with the following command. +Simply install the package with the following command: ``` bash composer require flagbit/table-attribute-bundle ``` -### Enable the bundle ### +### Enable the bundle Enable the bundle in the kernel: @@ -33,9 +72,9 @@ protected function registerProjectBundles() } ``` -### Configuration ### +### Configuration -Add to config yml to `mapping_overrides` in `app/config/config.yml`: +Add `mapping_overrides` in `app/config/config.yml`: ``` yml akeneo_storage_utils: @@ -45,7 +84,7 @@ akeneo_storage_utils: override: Flagbit\Bundle\TableAttributeBundle\Entity\AttributeOption ``` -Clear your cache: +Clear the cache: ``` bash php bin/console --env=prod cache:clear @@ -60,7 +99,7 @@ php bin/console --env=prod doctrine:schema:update --force Build and install the new front-end dependencies (new icon, etc.) ``` bash -php bin/console pim:installer:assets --symlink --clean --env=prod +php bin/console --env=prod pim:installer:assets --symlink --clean yarn run webpack ``` @@ -76,30 +115,16 @@ and migrate the schema updates: php bin/console --env=prod doctrine:migrations:migrate ``` -## Features ## - -Provides a the table as attribute type where you can define a set of columns of different types and validation rules. - -#### Column Types #### -* Text -* Number (Integer or Decimal) -* Simple select -* Simple select from URL - -#### Import/Export #### -The extension supports the standard Akeneo product import/export, so you don't need to create any special import/export -profile for table information. - -All product information related to attributes of type _table_ will be imported/exported as JSON. - -## Akeneo Compatibility ## +## Compatibility This extension supports the latest Akeneo PIM CE/EE stable versions: * 2.3 (LTS) * 2.1 and 2.2 (STS) -## Running Test-Suits ## +## Development + +### Running Test-Suits The TableAttributeBundle is covered with tests and every change and addition has also to be covered with unit or/and integration tests. It uses two testing suits: [PHPSpec](https://www.phpspec.net) and @@ -112,7 +137,7 @@ vendor/bin/phpunit vendor/bin/phpspec run ``` -## Coding style ## +### Coding style TableAttributeBundle uses the [PSR-2](https://www.php-fig.org/psr/psr-2/) coding style and can be checked with [Codesniffer](https://github.com/squizlabs/PHP_CodeSniffer). @@ -121,6 +146,10 @@ TableAttributeBundle uses the [PSR-2](https://www.php-fig.org/psr/psr-2/) coding vendor/bin/phpcs --standard=PSR2 --extensions=php ./src ``` -## License ## +## Contributing + +Contributions are always welcome! Please have a look at the [contribution guidelines](CONTRIBUTING.md) first. + +## License -The TableAttributeBundle is licensed under the MIT License - see the [LICENSE](LICENSE) file for details +The TableAttributeBundle is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.