Skip to main content

openlayers support for Plone

Project 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

https://secure.travis-ci.org/collective/collective.geo.openlayers.png

Found a bug? Please, use the issue tracker.

Requirements

for previous Plone versions use collective.geo.openlayers < 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:

  1. Browse to portal_setup in the ZMI of your site

  2. Click onto the Upgrades tab

  3. Select collective.geo.openlayers:default from the drop-down list and click Choose Profile

  4. 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 metal:fill-slot="javascript_head_slot">
      <script type="text/javascript">
        <!--
          (function ($) {
            var map;
            $(window).load(function() {
              map = new OpenLayers.Map('map',{
                theme: null
              });
              map.addLayer(new OpenLayers.Layer.OSM("OpenStreetMap"));
              map.setCenter(new OpenLayers.LonLat(7, 45).transform(
                  new OpenLayers.Projection("EPSG:4326"),
                  map.getProjectionObject()
              ), 5);

            });
          }(jQuery));
        // -->
      </script>
    </metal:block>
  </head>
  <body>
    <metal:content fill-slot="content-core">
        <metal:content define-macro="content-core">
          <div id="map" class="olMap widget-cgmap">
            <!-- openlayers map -->
          </div>
        </metal:content>
    </metal:content>
  </body>
</html>

Updating this package

When a new version of OpenLayers is released, the javascript on this package can be updated by using the Makefile in the root directory. Commands available:

  • build - it builds a new version of OpenLayer javascript.

  • copysrc - it copies all necessary files in plone resources directory.

  • dist - it is the default command, it executes all previous commands.

Contributors

See the complete list of contributors on Github:

Changelog

4.0 (2019-01-23)

  • Use self build Openlayers.js from 3.x branch. [mathias.leimgruber]

  • Added nodejs/bower configuration and specific Makefile in order to have a simple way to compile and update OpenLayers.js [giorgio]

  • Moved proj4js and geo-openlayers to plone resources directory [gborelli]

  • Removed skin layer, use plone resources instead [gborelli]

  • Fixed tests and doctests for plone5 and external api modifications [pbauer]

  • Modified openlayer css to fix collectivegeo-controlpanel issues [pbauer]

  • Fixed typo in resources registration [pbauer]

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

collective.geo.openlayers-4.0.tar.gz (338.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page