PHPackages                             ns/color-admin-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. [Templating &amp; Views](/categories/templating)
4. /
5. ns/color-admin-bundle

ActiveLibrary[Templating &amp; Views](/categories/templating)

ns/color-admin-bundle
=====================

Template bundle for Color Admin

2.6.1(2y ago)410.1k2JavaScriptPHP ^7.4||^8.0CI failing

Since Sep 16Pushed 1y ago1 watchersCompare

[ Source](https://github.com/NobletSolutions/ColorAdminBundle)[ Packagist](https://packagist.org/packages/ns/color-admin-bundle)[ Docs](https://github.com/NobletSolutions/ColorAdminBundle)[ RSS](/packages/ns-color-admin-bundle/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependencies (11)Versions (155)Used By (2)

Intro to Color Admin Bundle
===========================

[](#intro-to-color-admin-bundle)

### Configuration

[](#configuration)

```
    color_admin:
        use_knp_menu: false #if set to true and KnpMenuBundle is installed, we'll set the template to our knp_menu.html.twig template
        templates:
            theme: apple|default|facebook|material|transparent # template theme; Default: 'default'
            theme_color: aqua|black|blue|default|green|indigo|lime|orange|pink|purple|red|yellow
            pagination:
                template: string # template for KNP Paginator - Default: 'NSColorAdminBundle:Pagination:pagination.html.twig'
                wrapper_class: string # css classname for wrapper  - Default: 'paginator-md'
                labels: true|false # select whether to display "Previous/Next" labels - Default: false
            use_pace: true|false # use the pace.js preloader script for fancy page-load animations - Do not use in development as page content will not display on 500-errors - Default: false
            draggable_panel: true|false # allow widget panels to be rearranged - Default: false
            header:
                fixed: true|false # page header fixed to top of window - Default: true
                inverse: true|false # Inverse (white on black) style for page header - Default: false
            sidebar:
                fixed: true|false # sidebar fixed to top left of window - Default: true
                scrolling: true|false # sidebar scrolls independently - Default: true
                grid: true|false # alternate sidebar style with borders - Default: false
                gradient: true|false # alternate colors with gradient style - Default: false
```

### Main navigation configuration

[](#main-navigation-configuration)

#### MenuBuilder

[](#menubuilder)

See sample MenuBuilder in ColorAdminBundle/Menu/MenuBuilder.php

#### Services config

[](#services-config)

```
    ns_color_admin.menu.sidebar:
        class: NS\ColorAdminBundle\Menu\MenuBuilder
        arguments: ["@knp_menu.factory"]
        tags:
            - { name: knp_menu.menu_builder, method: createSidebarMenu, alias: sidebar } # The alias is what is used to retrieve the menu
            - { name: knp_menu.menu_builder, method: createSidebarMenu, alias: breadcrumbs }
```

#### Other config

[](#other-config)

```
    knp_paginator:
        template: NS\ColorAdminBundle\Resources\Paginator\paginator.html.twig #optional
```

### Forms

[](#forms)

This bundle adds some new form types, and adds additional features to existing ones.

#### New Form Types

[](#new-form-types)

##### Datepicker

[](#datepicker)

NS\\ColorAdminBundle\\Form\\Type\\DatepickerType

Provides an interactive datepicker.

```
options:
    start_date: \DateTime
    date_format: String # "yyyy-mm-dd"
```

##### Telephone

[](#telephone)

NS\\ColorAdminBundle\\Form\\Type\\DatepickerType

Provides a formatted ((999) 999-9999) phone number input. Actually likely redundant with the extension to the text input

```
No options
```

##### SearchableSelect

[](#searchableselect)

NS\\ColorAdminBundle\\Form\\Type\\FilterableSelectType

Provides a filterable select field with typeahead and remote autocomplete support. Inherits all options from ChoiceType with the exception of 'expanded'

```
options:
    allow_new_value: Boolean # Allow the user to submit what they typed if there is no matching option. Default false.
    data_url: String # Remote URL for field options.  If provided, enables remote Autocomplete support. See the class annotations for example request/response format.  Default false.
    data_type: String # Format to expect for autocomplete responses.  Passing anything other than 'json' requires developer to provide custom response handling callback. See https://select2.org for full docs. Default 'json'.
    minimum_input_length: Integer # Minimum number of characters that must be typed before commencing search. Default 0.
    maximum_input_length: Integer # Maximum number of characters that can be used for search.  Why would you want that? Default 0.
    maximum_selection_length: Integer # If multiple=true, the maximum number of results that can be selected. 0 for unlimited. Default 0.
```

#### Extended Form Types

[](#extended-form-types)

##### All Types

[](#all-types)

Additional options for all form types.

```
options:
    note: String # Provide a text note that will be displayed below the field. Useful for stating password requirements, etc.
    wrapper_class: String # CSS class of the div that wraps the form widget (within div.form-group, next to the label). Default 'col-md-9'.
    state: String [valid|invalid] # Provide an input state with accompanying styling. Visual only, provides no user functionality.
    vertical: Boolean # Optionally use a vertical (label above field) layout when using the default form template.  Default false.
```

##### TextType

[](#texttype)

Additional options for TextType and types that extend it (Email, Password, etc)

```
options:
    icon: String|false # FontAwesome-compatible icon to display alongside the text input. Default false.
    icon_position: String [left|right] # Side of the input on which to place the icon.  Default 'left'.
    mask: String # Text to display as an input mask. 9 = number, a = letter, * = wildcard. Example: (999) 999-9999 for a phone number, a9a 9a9 for postal code. Default false.
    mask_placeholder: String # Character to display as a placeholder. Example: mask_placeholder="_" and mask="(999) 999-9999 will have the input display "(___) ___-____" as the user types.  Default '_'.
    mask_definitions: JSON # Custom mask definition.  See annotations in NS\ColorAdmin\Form\Extension\MaskExtension for full details.  Default false.
```

##### PasswordType

[](#passwordtype)

Additional options for PasswordType and types that extend it.

```
options:
    toggle: Boolean # Provide a button to allow the user to toggle between hidden and visible password. Doesn't seem to play nice with autofill. Default false.
    placement: String [before|after] # Display the toggle button before or after the input.  Default 'before'.
    indicator: Boolean # Display a password strength indicator.  Default false.
    # Note: toggle and indicator cannot be used at the same time.
```

##### CollectionType

[](#collectiontype)

Additional options for CollectionType and types that extend it.

```
options:
    add_button_label: String #label for the Add button. Default "Add"
    add_button_icon: string #icon for the Add button. Default "plus"
```

### Error Templates

[](#error-templates)

There are error templates located in views/Exception; Copy/extend these in app/Resources/TwigBundle/views/Exception to use the custom error page templates.

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance28

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity86

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 52.6% 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.

###  Release Activity

Cadence

Every ~18 days

Recently: every ~272 days

Total

152

Last Release

791d ago

Major Versions

0.3.7 → 1.0.02018-09-14

1.0.7 → 2.0.02019-04-12

0.3.x-dev → 2.0.12019-04-15

PHP version history (4 changes)0.1.0PHP &gt;=5.5.9

2.0.3PHP ^7.2

2.5.21PHP &gt;=7.2

2.6.1PHP ^7.4||^8.0

### Community

Maintainers

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

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

---

Top Contributors

[![mwoynarski](https://avatars.githubusercontent.com/u/143827?v=4)](https://github.com/mwoynarski "mwoynarski (184 commits)")[![gnat42](https://avatars.githubusercontent.com/u/325591?v=4)](https://github.com/gnat42 "gnat42 (166 commits)")

---

Tags

bundlephpsymfonysymofnytemplate

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ns-color-admin-bundle/health.svg)

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

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M380](/packages/easycorp-easyadmin-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M723](/packages/sylius-sylius)[oro/platform

Business Application Platform (BAP)

645143.5k114](/packages/oro-platform)[contao/core-bundle

Contao Open Source CMS

1231.6M2.7k](/packages/contao-core-bundle)[pimcore/pimcore

Content &amp; Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.8M497](/packages/pimcore-pimcore)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

9421.6k59](/packages/open-dxp-opendxp)

PHPackages © 2026

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