Metadata-Version: 1.1
Name: ftw.referencewidget
Version: 1.2.3
Summary: A reference browser widget (Maintainer Timon Tschanz)
Home-page: https://github.com/4teamwork/ftw.referencewidget
Author: Timon Tschanz
Author-email: mailto:info@4teamwork.ch
License: GPL2
Description: ftw.referencewidget
        ===================
        
        This Widget provides a Referencebrowser and a searchfield, which allows users to select references.
        
        The basequery is all types which are not in the types_not_searched property all modification to the allowed types are relative to this query.
        
        Traversal or Selectability can be changed for all widgets with the IReferenceSettings registry interface or per widget with the widget parameters.
        
        The widget takes the following parameters:
         - allow_traversal: These Types are traversable
         - block_traversal: These Types are not traversable
         - selectable: These Types are selectable
         - nonselectable: These Types are not selectable
         - start: The path first opened. Can either be a callable or a path. Additionaly the strings "parent", "navroot", "ploneroot" can be used.
         - allow_nonsearched_types: If this is set to true all the types will be traversable and selectable.
         - override: drops all global config and the base query if a list is passed to the widget. All types need to be added to be selectable.
        
        
        **IMPORTANT NOTE:**
        Currently this widget drops the SourceBinder concept, which has huge impact on the usability.
        
        The following combinations are supported.
        - RelationList with value_type Relation --> Stores a List of RelationValues
        - RelationList with value_type RelationChoice --> Stores a List of RelationValues
        - Relation --> Stores a RelationValue
        - List of RelationChoice --> Stores a list of absolute paths, without the portal root part
        - TextLine --> Stores a absolute path as string, without the portal root part
        
        
        
        TODO
        ----
        
        - The SourceBinder concept needs to be implemented for better compatibility with everything/everyone else.
        - Proper Integration Tests using test behaviors with several configurations.
        
        
        Screenshots
        -----------
        The general Listing:
        ![Listing](https://github.com/4teamwork/ftw.referencewidget/raw/master/docs/static/list.png)
        The Search Listing:
        ![Search Listing](https://github.com/4teamwork/ftw.referencewidget/raw/master/docs/static/search.png)
        The Selected Items
        ![Selected](https://github.com/4teamwork/ftw.referencewidget/raw/master/docs/static/selected.png)
        
        Links
        -----
        
        - Github: https://github.com/4teamwork/ftw.referencewidget
        - Issues: https://github.com/4teamwork/ftw.referencewidget/issues
        - Continuous integration: https://jenkins.4teamwork.ch/search?q=ftw.referencewidget
        
        
        Copyright
        ---------
        
        This package is copyright by `4teamwork <http://www.4teamwork.ch/>`_.
        
        ``ftw.referencewidget`` is licensed under GNU General Public License, version 2.
        
        Changelog
        =========
        
        
        1.2.3 (2016-10-18)
        ------------------
        
        - Fix edge case (mainly for tests) if the value passed to the
          IList/Widget converter is not a list, but a string.
          [raphael-s]
        
        
        1.2.2 (2016-10-18)
        ------------------
        
        - Implement testbrowser widget.
          [raphael-s]
        
        
        1.2.1 (2016-10-17)
        ------------------
        
        - Respect missing_value set by the field.
          [tschanzt]
        
        - Implement support for ITextLine only with ReferenceWidget.
          [mathias.leimgruber]
        
        
        1.2.0 (2016-10-04)
        ------------------
        
        - Show absolute path starting at the plone root for the selected value.
          [mathias.leimgruber]
        
        - Remove the list style type and the obsolete spacing for the selected elements.
          [mathias.leimgruber]
        
        - Implement support for IList of IRelationChoice explicitly.
          Check Readme for more informations
          [mathias.leimgruber]
        
        
        1.1.0 (2016-09-27)
        ------------------
        
        - Ignore empty value for multiple value field.
          [mathias.leimgruber]
        
        - Support chameleon by not rendering handlebar templates. [jone]
        
        
        1.0.4 (2016-09-19)
        ------------------
        
        - Make it possible to remove an given internal reference (radio button).
          [mathias.leimgruber]
        
        - Ignore empty value for single value field.
          [mathias.leimgruber]
        
        - Fix search by pressing the "enter" button.
          [mathias.leimgruber]
        
        - Always unbind the click event before binding a new one on the ref button.
          [mathias.leimgruber]
        
        
        1.0.3 (2016-09-14)
        ------------------
        
        - Same as 1.0.2 but uploaded to PyPI.
          [mbaechtold]
        
        
        1.0.2 (2016-09-14)
        ------------------
        
        - Reload Items when overlay is reloaded.
          [tschanzt]
        
        - Respect Type constraints on search.
          [tschanzt]
        
        
        1.0.1 (2016-09-09)
        ------------------
        
        - Ignore empty strings in converter.
          [tschanzt]
        
        - Improve overlay behavior (close on click outside the overlay + close on ESC).
          [mathias.leimgruber]
        
        - Get Widget name on overlay creation.
          [tschanzt]
        
        
        1.0.0 (2016-09-07)
        ------------------
        
        - Initial release
          [tschanzt]
        
Keywords: ftw 4teamwork widget reference browser
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.3
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
