PHPackages                             oh/color-picker-type-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. oh/color-picker-type-bundle

ActiveSymfony-bundle

oh/color-picker-type-bundle
===========================

A simple jQuery color picker list for Symfony2

49.6k4[1 PRs](https://github.com/ollieLtd/OhColorPickerTypeBundle/pulls)PHP

Since Dec 22Pushed 9y ago3 watchersCompare

[ Source](https://github.com/ollieLtd/OhColorPickerTypeBundle)[ Packagist](https://packagist.org/packages/oh/color-picker-type-bundle)[ RSS](/packages/oh-color-picker-type-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

OhColorPickerTypeBundle
=======================

[](#ohcolorpickertypebundle)

A very simple color picker for Symfony2 forms using [simplecolorpicker](https://github.com/tkrotoff/jquery-simplecolorpicker) by tkrotoff

Installation
------------

[](#installation)

This bundle is compatible with Symfony 2.1. Add the following to your `composer.json`:

```
"oh/color-picker-type-bundle": "dev-master"

```

In your repositories array in composer.json you need to add the javascript package

```
    "repositories" : [{
        "type": "package",
        "package": {
            "version": "master",
            "name": "tkrotoff/jquery-simplecolorpicker",
            "source": {
                "url": "https://github.com/tkrotoff/jquery-simplecolorpicker.git",
                "type": "git",
                "reference": "master"
            }
        }
}
]

```

Register the bundle in your `app/AppKernel.php`:

```
// app/AppKernel.php
public function registerBundles()
    {
        $bundles = array(
            new Oh\ColorPickerTypeBundle\OhColorPickerTypeBundle(),
            // ...
```

You might need to change a couple of options if you are trying to use Symfony 2.0

If you want to automatically include the assets from the bundle, add OhColorPickerTypeBundle to assetic

```
# app/config/config.yml
# Assetic Configuration
assetic:
    bundles:        [ 'OhColorPickerTypeBundle' ]

```

Usage
-----

[](#usage)

This bundle contains a new FormType called ColorPickerType which can be used in your forms like so:

```
use Oh\ColorPickerTypeBundle\Form\Type\ColorPickerType;
[...]
$builder->add('color', new ColorPickerType());

```

On your model you can add the validation classes

```
// Your model eg, src/My/Colors/Entity/MyColor.php
use Symfony\Component\Validator\Constraints as Assert;
use Oh\ColorPickerTypeBundle\Validator\Constraints as OhAssertColor;

class MyColor
{

    /**
     * @ORM\Column(type="string", length=6, nullable=true)
     * @Assert\NotBlank()
     * @OhAssertColor\HexColor(groups={"colours"})
     */
    public $color;

}

```

Include the twig template for the layout.

```
# your config.yml
twig:
    form:
        resources:
            # This uses the default - you can put your own one here
            - 'OhColorPickerTypeBundle:Form:fields.html.twig'

# or in your twig template
{% form_theme my_form 'OhColorPickerTypeBundle:Form:_event.html.twig' %}

```

Options
-------

[](#options)

There are a number of options, mostly self-explanatory. It's recommended that you include the javascript and css with the rest of your libraries, but if you want a quick test you can include them with the form field using the include\_\* options below (you will have to add the bundle to the assetic.bundles array in your config - see above).

```
array(
        'include_jquery'    => false, // include jquery from google cdn
        'include_js'        => false, // include the javascript
        'include_js_constructor'=>true, // include the constructor for each field
        'include_css'       => false, // include the css
        'picker'            => false // an openable picker rather than an expanded selection
)

```

Screenshots
-----------

[](#screenshots)

[Default form](https://www.dropbox.com/s/e56djqezfuutlzi/colorpicker.png)

Known problems
--------------

[](#known-problems)

Because the form type template includes javascript, there's not yet a way to bunch it all together at the very bottom of the page, so it is included at the bottom of the field. This means that jquery and the javascript plugin needs to be included before the field. I'm not sure of a way around this, but I think it's going to be addressed in a later version of the form framework.

Credits
-------

[](#credits)

- Ollie Harridge (ollietb) as main author.
- Tanguy Krotoff (tkrotoff) for the jQuery plugin

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/c292a6c56c272b9c31da4a195de55521accd66989e84cd7e0767423a6743a275?d=identicon)[ollietb](/maintainers/ollietb)

---

Top Contributors

[![ollietb](https://avatars.githubusercontent.com/u/342090?v=4)](https://github.com/ollietb "ollietb (8 commits)")[![rmasters](https://avatars.githubusercontent.com/u/34284?v=4)](https://github.com/rmasters "rmasters (2 commits)")

### Embed Badge

![Health badge](/badges/oh-color-picker-type-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/oh-color-picker-type-bundle/health.svg)](https://phpackages.com/packages/oh-color-picker-type-bundle)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)