Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

select2 widget for z3c.form and eea.facetednavigation

Project Description



  • select2 multivalued facetednavigation widget for 2-level vocabulary created with collective.taxonomy. Select “Select2” criteria in facetednavigation and select a taxonomy.
  • select2 multivalued z3c.form widget that works nice with 2-level vocabulary created with collective.taxonomy
  • Upon installation, the default zc3form widget for List/Set of Choice will be select2 based. If you don’t want this behavior, you can exclude collective.z3cform.select2.widget adapters.zcml with z3c.unconfigure.


The widget was developped initially for a bootstrap 3 theme and fontawesome. There is a search button icon left to the select that upon click open the select. If your site doesn’t have a bootstrap based theme, you may want to add this css rule to your project to hide the tiny button:

button[data-select2-open] { display: none; }

The z3cform widget in display mode uses the badge class, without a comma separator so it may be confusing when you don’t have style for the badge class. You can revert to a comma separated display by including minimal.zcml instead of configure.zcml, see Installation below.


  • One constant Faceted.taxonomyAllString currently in French.


Install collective.z3cform.select2 by adding it to your buildout:



eggs =
zcml =
    # or collective.z3cform.select2-minimal

and then running bin/buildout

You need to install the collective.z3cform.select2 addon to register the select2 js library. In a facetednav, add a Select2 criterion.


If you are having issues, please let us know.


The project is licensed under the GPLv2.


  • Vincent Fretin [vincentfretin]
  • Eric Bréhault
  • Martin Peeters [mpeeters]


1.4.1 (2017-12-01)

  • Fixed MultiSelect2Widget to use a @property for items as it is the case for SingleSelect2Widget.items it is inheriting from (that was fixed in release 1.4.0). [gbastien]

1.4.0 (2017-11-22)

  • Fix an issue with the width of hidden elements (e.g. in tabs) [mpeeters]
  • Restore initialization for multi select2 widgets [mpeeters]
  • Require z3c.form >= 3.2.11 where the SelectWidget.items is a @property and no more a callable method. [gbastien]

1.3.4 (2017-01-10)

  • Fix widget in overlays when loading a form in an existing overlay. This worked before 1.3, but another overlay fix in 1.3 broke this case. [vincentfretin]

1.3.3 (2017-01-10)

  • Don’t use default param feature in select2-widget.js, the previous fix was incomplete. [vincentfretin]

1.3.2 (2017-01-09)

  • Don’t use default param feature in select2-widget.js, this is ES6, IE 10 doesn’t support it. [vincentfretin]

1.3.1 (2016-12-09)

  • Rename wrong class facted-select-criterion to faceted-select-criterion [vincentfretin]

1.3 (2016-12-01)

  • Remove specific css rules that was introduced in 1.2 [vincentfretin]
  • Fix widget in overlays. If you upgrade from 1.1, you need to reinstall the profile to add a css in portal_css. [cedricmessiant]
  • Wrap call to select2 initialization in JS function initializeSelect2Widgets so it is easy to call from everywhere (like in an overlay initialization). Parameter width can be specified when calling initializeSelect2Widgets and defaults to resolve. [gbastien]

1.2 (2016-08-25)

  • Avoid an error if Faceted namespace is not defined [mpeeters]
  • Add a select2 single and multi select widget [mpeeters]

1.1 (2016-07-07)

  • Use faceted-select2-widget instead of faceted-select-widget to not break the original faceted-select-widget widget. [vincentfretin]
  • Depends on eea.jquery >= 8.8 to fix images in select2. [vincentfretin]
  • Replace collective.taxonomy.widget.TaxonomySelectFieldWidget by the widget from this package. [vincentfretin]
  • Initialize widgets in overlays now. [vincentfretin]

1.0 (2016-04-20)

  • Initial release. [vincentfretin]

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(23.3 kB) Copy SHA256 Hash SHA256
Source None Dec 1, 2017

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers