Metadata-Version: 1.1
Name: collective.geo.openlayers
Version: 2.5
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.
        
        .. 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
        
        
        Installation
        ============
        
        You can install collective.geo.openlayers as part of a specific project's buildout,
        by having a buildout configuration such as: ::
        
                [buildout]
                ...
                eggs =
                    collective.geo.openlayers
                ...
        
        Install this product from the Plone control panel.
        
        
        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">
                      <script type="text/javascript"
                          tal:attributes="src string:$portal_url/OpenLayers.js"></script>
        
                      <!-- 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
        =====================
        
        When a new version of OpenLayers is released, this package can be updated
        accordingly using the following steps, keeping in mind that some paths and URLs
        will need adjustment::
        
            cd ~/collective.geo.openlayers
            cd collective/geo/openlayers/skins/
            #Change URL accordingly
            wget http://openlayers.org/download/OpenLayers-2.12.tar.gz
            tar xf OpenLayers*.tar.gz
            mv OpenLayers-2.12 OpenLayers
            #Maintain 3rd party files
            mv geo_openlayers/plone3_fix_form_tabbing.js geo_openlayers/proj4js-compressed.js .
            git rm geo_openlayers/* -r
            mkdir geo_openlayers
            #Only select the files we need
            mv OpenLayers/{*.js,*.txt,*.md,img,theme} geo_openlayers/
            mv *.js geo_openlayers/
            git add geo_openlayers/
            #Copy the translation files
            mv OpenLayers/lib/OpenLayers/Lang/*.js geo_openlayers/lang/
        
            #Edit change note now in history
            vim ~/collective.geo.openlayers/docs/HISTROY.txt
            git commit -a -m "Updated to OpenLayers [version]"
        
        
        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
        
        Changelog
        =========
        
        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 Yahoo OpenLayers
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Topic :: Internet
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Programming Language :: Python
