Metadata-Version: 1.1
Name: collective.z3cform.select2
Version: 1.2
Summary: select2 widget for z3c.form and eea.facetednavigation
Home-page: https://pypi.python.org/pypi/collective.z3cform.select2
Author: Vincent Fretin
Author-email: vincent.fretin@gmail.com
License: GPL version 2
Description: .. This README is meant for consumption by humans and pypi. Pypi can render rst files so please do not use Sphinx features.
           If you want to learn more about writing documentation, please check out: http://docs.plone.org/about/documentation_styleguide_addons.html
           This text does not appear on pypi or github. It is a comment.
        
        ==========================
        collective.z3cform.select2
        ==========================
        
        Features
        --------
        
        - 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.
        
        
        Theming
        -------
        
        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.
        
        
        Translations
        ------------
        
        - One constant Faceted.taxonomyAllString currently in French.
        
        
        Installation
        ------------
        
        Install collective.z3cform.select2 by adding it to your buildout::
        
            [buildout]
        
            ...
        
            eggs =
                collective.z3cform.select2
            zcml =
                collective.z3cform.select2
                # 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.
        
        
        Contribute
        ----------
        
        - Issue Tracker: https://github.com/collective/collective.z3cform.select2/issues
        - Source Code: https://github.com/collective/collective.z3cform.select2
        
        
        Support
        -------
        
        If you are having issues, please let us know.
        
        
        License
        -------
        
        The project is licensed under the GPLv2.
        
        Contributors
        ============
        
        - Vincent Fretin [vincentfretin]
        - Eric Bréhault
        - Martin Peeters [mpeeters]
        
        Changelog
        =========
        
        
        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]
        
        
Keywords: Python Plone
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.3
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
