Metadata-Version: 1.1
Name: collective.geo.behaviour
Version: 1.0b2
Summary: collective.geo Dexterity integration
Home-page: https://github.com/collective/collective.geo.behaviour
Author: UNKNOWN
Author-email: UNKNOWN
License: GPL
Description: Introduction
        ============
        
        This package provides the ability to assign geographical information to
        Dexterity-based (``plone.app.dexterity``) content types within Plone and does
        so using `collective.geo.geographer`_ and `collective.geo.mapwidget`_.
        
        By applying the behaviour from this package to a Dexterity content type, a
        `Coordinates` field becomes available when creating or editing said content.
        This allows a user to either look-up coordinates for a place or feature via
        geo-coding, draw a geographical feature (such as a point, line or polygon) on a
        map, or enter details manually in Well-Known Text (`WKT`_) format.
        
        When stored, this geographical information can be used by the rest of the
        ``collective.geo`` set of packages.  For instance, the coordinates can be
        displayed on maps against Collections or Folders using `collective.geo.kml`_.
        
        Found a bug? Please, use the `issue tracker`_.
        
        .. contents:: Table of contents
        
        
        Installation
        ============
        
        This addon can be installed has any other addons, please follow official
        documentation_.
        
        
        About the behaviour
        -------------------
        
        The behaviour adds a ``coordinates`` field to the content type and uses a
        ``collective.z3cform.mapwidget`` widget in order to allow the user to
        manipulate the geographic information.
        
        The behaviour effectively acts as a proxy to load and save the data into the
        relevant location by querying for an
        ``collective.geo.geographer.interfaces.IGeoreferenced`` adapter and
        ``collective.geo.geographer.interfaces.IWriteGeoreferenced`` respectively for
        the given context.
        
        This means that changes made upon as edits to the content object and changes
        made in the `Coordinates` tab are both modifying exactly the same data.
        
        Usage
        -----
        
        Once your type configuration has the behaviour applied, then content objects of
        said type will be marked as georeferenceable for ``collective.geo.geographer``.
        This is achieved through the marker interface
        ``collective.geo.geographer.interfaces.IGeoreferenceable``.
        
        Through the web
        ^^^^^^^^^^^^^^^^
        
        If you are configuring your Dexterity-based type through the web-based
        interface, then proceed to edit your content type in the `Dexterity Content
        Types` control panel. Under the `Behaviours` tab you will find the
        ``collective.geo Maps`` behaviour -- select this and save your content type.
        
        Upon adding or editing an object of your content type, you will see the new
        field accordingly.
        
        Generic Setup (file system)
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        If you've created a file-system Dexterity type configuration, you need to
        specify the relevant interface as a behaviour::
        
            collective.geo.behaviour.interfaces.ICoordinates
        
        and import or re-import your type configuration.  As an example, a type
        configuration at ``${product_dir}/profiles/default/types/my.datatype.xml``
        would look like this::
        
            <?xml version="1.0"?>
            <object name="my.datatype"
               meta_type="Dexterity FTI"
               i18n:domain="tdh.metadata" xmlns:i18n="http://xml.zope.org/namespaces/i18n">
                ...
                <property name="behaviors">
                  <element value="collective.geo.behaviour.interfaces.ICoordinates" />
                </property>
                ...
            </object>
        
        .. _documentation: http://plone.org/documentation/kb/installing-add-ons-quick-how-to
        .. _issue tracker: https://github.com/collective/collective.geo.bundle/issues
        .. _Plone: http://plone.org
        .. _collective.geo.mapwidget: http://pypi.python.org/pypi/collective.geo.mapwidget
        .. _collective.geo.geographer: http://pypi.python.org/pypi/collective.geo.geographer
        .. _collective.geo.kml: http://pypi.python.org/pypi/collective.geo.kml
        .. _WKT: http://en.wikipedia.org/wiki/Well-known_text
        
        Changelog
        =========
        
        1.0b2 (2013-06-02)
        ------------------
        
        - Nothing changed yet.
        
        
        1.0b1 (2013-06-02)
        ------------------
        
        - Add install profile
          [gborelli]
        
        - Removed dependency from rwproperty
          [gborelli]
        
        - Unwrap behaviour context, it raises an error when Dexterity object
          is georeferenced
          [gborelli]
        
        - Removed Shapely dependency, added pygeoif
          [gborelli]
        
        - Added support for Spanish localization
          [macagua]
        
        - Added improvements about the Internationalization
          [macagua]
        
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Programming Language :: Python
