Symfony bundle that adds color management to eZ Platform.
Note : this is the compatibility branch for eZ Platform 2.5 (ezsystems/ezpublish-kernel:7.5). For a Ibexa Platform compatible version, please check this repository instead : https://github.com/Codein-Labs/ibexa-color-picker
composer require codein/ez-color-picker:dev-develop
Activate the bundle in AppKernel.php
new Codein\eZColorPicker\eZColorPickerBundle()
Compile the assets for the admin UI
./bin/console ezplatform:encore:compile
You can set a default color for your field. The default color will be proposed to the user if no color is already set. If the field is required, the default color is assigned as default. If not, no color is assigned.
The default color format rendered in Twig is RGBa. You can pass extra options to ez_render_field.
- format: RGBa, HEXa, HSVa, RGB, HEX
- default: default value returned if field is empty. If not set ez_render_field will return an empty string
{{ ez_render_field(content, 'color2', {'parameters': {'format': 'HEX', 'default': 'none'}}) }}The method \Codein\eZColorPicker\FieldType\ColorPicker\Type::acceptValue will accept a single string and convert it into a color. Following formats are converted into a valid value object :
HSVa: hsva(0, 86%, 69%, 0.69)
RGBa: rgba(176, 25, 25, 0.69)
HEXa: #B01919B0
RGB: rgb(176, 25, 25)
HEX: #B01919
You can use this feature when writing migrations.
We also provide a color converter service for your needs here.
This bundle uses Pickr (https://github.com/Simonwep/pickr) under the MIT Licence.