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`_ >= 5.0
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:
#. 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 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:
* https://github.com/collective/collective.geo.openlayers/graphs/contributors
.. _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
.. _list of contributors: https://github.com/collective/collective.geo.openlayers/graphs/contributors
Changelog
=========
4.0 (2019-01-23)
----------------
- Use self build Openlayers.js from 3.x branch. [mathias.leimgruber]
- Display issues with the terrain google maps layer. Also see https://github.com/collective/collective.geo.openlayers/pull/6
- Fix getting several images in static folder. Fixed by Openlayers.js in _getScriptLocation method.
- 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