collective.geo.flexitopic 0.5

Introduction
============

Use collective.geo.flexitopic to easily build interactive maps out of plone
collections. It combines plone maps (collective.geo_) with collective.flexitopic_.


collective.flexitopic
=====================

Flexitopic integrates the easy use of plone collections with a Flexigrid_
AJAX view. The criteria from the topic are taken to construct a simple
query form to narrow down a search inside a collection.
For old style colletions subtopics are displayed inside tabs of the collection.

* Flexitopic does not install a new content type but just adds an
additional view to the collection type.
* it degrades for non javascript browsers to a simple table - (almost)
same usability, no information loss.
* it requires JQuery only (built into plone 4) no JQueryUI
* lightweight JS
* Flexigrid_: 24 KB packed
* JSlider_: 15 KB packed

.. _Flexigrid: http://flexigrid.info/
.. _JSlider: http://egorkhmelev.github.com/jslider/


Usage
-----

Add a collection. The Criteria of the collection will be used to build
a form to narrow down your search inside the collection.
If the criterion (the index in portal_catalog) is sortable you can sort
this column. Not all criteria types can be used as input for
Flexicollection so beware.

* Search Text: full text search inside the collections. If you leave
the criterion value empty users can search for content containing
that text, if the value is not empty it will search for this text
plus the text the user supplied.
* Title: search or sort by title (see above)
* Description: search description only (search see above, no sorting here!)
* Dates (effective, created, ...): will be converted to date ranges
and can be selected with the JQuery JSlider_ Plugin)
* Location (path index): will not be displayed in the search form
and always be applied to the query
* Keyword Indices (like tags): a drop down list will be generated to
narrow the search down

* if the criterion operator is AND the list will contain all
unique values of the index minus the ones you selected,
the query will search for all terms that match your criteria
plus the user input (this only applies to old style collections)
* if the criterion is OR the terms you selected will be display
in the selection list. The search will be for the user supplied
input only. This is the only available behaviour for new style
collections

The output is always a table with the fields you supplied in the
'Table Columns' of the collection, no matter if 'Display as Table'
is checked or not.

Subtopics (old style Collections only):
---------------------------------------

Flexitopic will display subtopics as tabs on top of the page. The first
tab is the description of the topic, subtopics will occupy the following
tabs. Subtopics will always be displayed as (plain html) tables defined
by the criteria, 'Table Columns' and the 'Number of Items' of the subtopic.

Portlets
---------

You can display Topics and Collections in a Flexitopic portlet.
The Portlet is mainly meant to be used with products that let you
dispay portlets inside the content area such as ContentWellPortlets_
or PortletPages_ but it may be usefull as a 'real' portlet in edge cases
as well. The portlet can be configured to show the map only without
the flexigrid or queryform.

.. _ContentWellPortlets: http://plone.org/products/contentwellportlets
.. _PortletPages: http://plone.org/products/collective.portletpage



Installation
============
This addon can be installed has any other addons, please follow official
documentation_.

.. _documentation: http://plone.org/documentation/kb/installing-add-ons-quick-how-to

Add to buildouts configuration

::

[buildout]
...
eggs =
collective.geo.flexitopic

Re-run buildout, e.g. with

::

$ ./bin/buildout

Restart Plone and activate the product in Plones Add-on configuration
section.


- Code repository: https://github.com/collective/collective.geo.flexitopic/
- Questions and comments to http://www.coactivate.org/projects/collectivegeo/lists/collectivegeo-discussion/
- Report bugs at https://github.com/collective/collective.geo.flexitopic/issues


.. _Flexigrid: http://flexigrid.info/
.. _JSlider: http://egorkhmelev.github.com/jslider/
.. _collective.flexitopic: http://plone.org/products/collective.flexitopic
.. _collective.geo.index: http://plone.org/products/collective.geo.index
.. _collective.geo: http://plone.org/products/collective.geo


Changelog
=========

0.5 (2013/12/04)
----------------

- add configurable portlets


0.4 (2013/09/05)
-----------------

- disable search inside BBOX with c.g.index
- fixes


0.3 (2013/08/30)
----------------

- search inside a BBOX with collective.geo.index
- support for plone.app.collection
- use Vectorlayer instead of GMLLayer
- add caching

0.2 (2011/06/17)
----------------

- Added support for Spanish localization [macagua]
- Added improvements about the Internationalization [macagua]
- plone 4.1 compatible

0.1 (2011/03/30)
-------------------

- Initial release