Metadata-Version: 1.1
Name: collective.geo.openlayers
Version: 3.2b1
Summary: openlayers support for Plone
Home-page: https://github.com/collective/collective.geo.openlayers
Author: Giorgio Borelli
Author-email: giorgio@giorgioborelli.it
License: GPL
Description: Introduction
        ============
        
        collective.geo.openlayers enables `Openlayers`_ machinery into Plone.
        
        This package registers two javascript files into Plone javascript registry:
        
        1. OpenLayers.js
        2. proj4js-compressed.js
        
        
        
        .. image:: https://secure.travis-ci.org/collective/collective.geo.openlayers.png
            :target: http://travis-ci.org/collective/collective.geo.openlayers
        
        Found a bug? Please, use the `issue tracker`_.
        
        .. contents:: Table of contents
        
        
        Requirements
        ============
        
        
        * `Plone`_ >= 3 and < 5.0 for collective.geo.openlayers version 3.x
        * `Plone`_ >= 5.0 for collective.geo.openlayers version 4.x
        
        
        Installation
        ============
        
        This addon can be installed has any other addons, please follow official
        documentation_.
        
        
        Upgrading
        =========
        
        Version 3.0
        -----------
        
        If you are upgrading from an older version to 3.0, you may need to run
        upgrade steps. To do this, follow these steps:
        
        #. Browse to ``portal_setup`` in the ZMI of your site
        #. Click onto the ``Upgrades`` tab
        #. Select ``collective.geo.openlayers:default`` from the drop-down list and
           click ``Choose Profile``
        #. Observe any available upgrades and click the ``Upgrade`` button if any
           are present.
        
        
        Integration example
        ===================
        
        You can include openlayers in a Plone browser page in this way
        (for further information about openlayers see
        other `openlayers examples`_)::
        
                <html xmlns="http://www.w3.org/1999/xhtml"
                      xmlns:metal="http://xml.zope.org/namespaces/metal"
                      xmlns:tal="http://xml.zope.org/namespaces/tal"
                      metal:use-macro="here/main_template/macros/master">
                  <head>
        
                    <metal:block fill-slot="top_slot"
                          tal:define="dummy python:request.set('disable_border',1);
                                      portal_state context/@@plone_portal_state;
                                      portal_url portal_state/portal_url" />
                    <metal:block metal:fill-slot="javascript_head_slot">
                      <!-- optional openlayers translation -->
                      <script type="text/javascript"
                          tal:attributes="src string:$portal_url/lang/de.js"></script>
                      <script type="text/javascript">
                          OpenLayers.Lang.setCode('de');
                      </script>
        
                      <script type="text/javascript">
                          jq(window).bind('load', function() {
                             map = new OpenLayers.Map( 'map');
                             layer = new OpenLayers.Layer.OSM( "Simple OSM Map");
                             map.addLayer(layer);
                             map.setCenter(
                                new OpenLayers.LonLat(-71.147, 42.472).transform(
                                    new OpenLayers.Projection("EPSG:4326"),
                                    map.getProjectionObject()
                                ), 12
                             );
                          });
                      </script>
                    </metal:block>
                  </head>
        
                  <body>
                   <metal:content-core fill-slot="content-core">
                     <metal:content-core define-macro="content-core">
                        <div id="map" class="olMap" style="width:100%;height: 500px;">
                            <!-- openlayers map -->
                        </div>
        
                     </metal:content-core>
                   </metal:content-core>
                  </body>
                </html>
        
        Updating this package
        =====================
        
        There are no new versions of openlayers 2, we need to build our own from master branch of the ol2 respository.
        
        1. Goto skins directory of this package
        2. Download latest master from github `wget https://github.com/openlayers/ol2/archive/master.zip`
        3. `unzip master.zip`
        4. Install closure-compiler.jar (Check Openalayers Readme)
        5. Build Openlayers.js, Openlayers.debug.js, Openlayers.mobile.js, Openlayers.mobile.debug.js, Openlayers.light.js, Openlayers.light.debug.js
        
            - `python build.py -c closure full OpenLayers.js`
            - `python build.py -c none full OpenLayers.debug.js`
            - `python build.py -c closure mobile OpenLayers.mobile.js`
            - `python build.py -c none mobile OpenLayers.mobile.debug.js`
            - `python build.py -c closure light OpenLayers.light.js`
            - `python build.py -c none light OpenLayers.light.debug.js`
        
        6. Move them to skins/geo_openlayers
        7. Copy `img` and `theme` files to skins/geo_openlayers
        8. Copy `lib/Openlayers/Lang/*` to skins(geo_openlayers/lang)
        9. Commit changes, please include hash of Openlayers commit you've used to build ol2.
        
        Contributors
        ============
        
        * Giorgio Borelli - gborelli
        * Silvio Tomatis - silviot
        * David Beitey - davidjb
        * Gerhard Weis - gweis
        * Denis Krienbühl - href
        
        
        .. _Openlayers: http://openlayers.org
        .. _Plone: http://plone.org
        .. _openlayers examples: http://dev.openlayers.org/releases/OpenLayers-2.12/examples
        .. _issue tracker: https://github.com/collective/collective.geo.bundle/issues
        .. _documentation: http://plone.org/documentation/kb/installing-add-ons-quick-how-to
        
        Changelog
        =========
        
        
        3.2b1 (2016-08-05)
        ------------------
        
        - Update Openlayers to latest Openlayers 2 version (https://github.com/openlayers/ol2/commit/6e540a95c968651c1ae37e32a5f076c1703ec446).
          There are no ol2 releases anymore, so that's way I built this one from the mentioned commit.
          [mathias.leimgruber]
        
        
        3.1 (2014-02-26)
        ----------------
        
        - Updated OpenLayers to 2.13.1
          [gborelli]
        
        - Add style for IGeoFeatureStyle behavior
          [gborelli]
        
        
        3.0 (2013-10-29)
        ----------------
        
        - changed package layout
          [gborelli]
        
        - added javascripts in portal_javascript registry [gborelli]
        
        
        2.5 (2013-01-28)
        ----------------
        
        - added travis-ci configurations [gborelli]
        - moved openlayers_test.pt template to tests directory [gborelli]
        - refactored tests in order to use plone.app.testing and unittest2 [gborelli]
        - Updated OpenLayers to version 2.12. ``deprecated.js`` is available
          in this package for deprecated elements as per
          https://github.com/openlayers/openlayers/blob/master/notes/2.12.md#deprecated-components
          [davidjb]
        - Encourage OpenLayers to shorten popup widths via CSS. Long marker
          headings (eg content titles) would cause popups to fill the map.
          [davidjb]
        - Added OpenLayers language files [href]
        
        
        0.2.4 (2012-01-21)
        ------------------
        
        - Updated Openlayers to 2.11 version
        
        
        0.2.3 (2011-09-05)
        ------------------
        
        - added integration example in readme file [gborelli]
        - plone 4.1 fixes [gborelli]
        - changed Browser import from Testing.testbrowser [gborelli]
        - added z3c.autoinclude entry point [gborelli]
        
        
        0.2.2 (2010-12-28)
        ------------------
        
        - fixed css registry entries [gborelli]
        
        
        0.2.1 (2010-11-13)
        ------------------
        
        - Updated Openlayers to 2.10 version
        
        
        0.2 (2010-10-31)
        ----------------
        * renamed cgeo-openlayers css and included in css registry [gborelli]
        * removed openlayers-macros [gborelli]
        * Added CSS for definition lists within the framed cloud popups,
          as used in collective.geo.kml
          [rockdj]
        * Added ZCML registration for all skin subdirectories.  Without this,
          elements like the Edit toolbar don't appear when Plone isn't running
          in debug mode.
          [rockdj]
        * Updated OpenLayers.js to 2.8 (+styles and resources)
        * Register all browser pages and resources for IOpenLayers browser
          layer
        * Removed geo-point.js in favour of editing features provided by OpenLayers
        * Updated coordinate reference order to be consistent with WGS 1984
          reference system.  This involves standardising the coordinate order
          to be [longitude, latitude] rather than [latitude, longitude].
          [rockdj]
        * Gave the Map element a relative position via CSS to allow Plone
          drop-down menus to appear over the top (z-index doesn't apply
          unless position is specified).
          [rockdj]
        * Added ZCML registration for 'img' and 'theme' skin subdirectories.
          Without registration, these folders are unable to be seen in Plone
          and the OpenLayers controls don't appear.
          [rockdj]
        * Added unit tests to ensure skin subdirectory registration works.
          [rockdj]
        
        0.1 (2009-06-19)
        ----------------
        
        * Initial release
        
Keywords: Zope Plone GIS KML Google Maps Bing OpenLayers
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Topic :: Internet
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Programming Language :: Python
