Products.Maps 2.1.2

A Google Maps solution for Plone

The main purpose of this product is to provide a very simple to use Google Maps integration for Plone. The following goals were set for development:

• Ease of use

  • Add locations to a folder

  • Set the view of the folder to Map

  • It figures out how to center and zoom the map automatically

• Flexibility for enhancement by using the Zope 3 component architecture

• Sane fallbacks when Javascript is not available

• Clean separation of javascript, templates and logic

• Works on Topics

Installation

Maps shows up in the “Add-ons” configuration panel.

To use Google Maps you need an “Google Maps API key from Google”:http://www.google.com/apis/maps/signup.html.

You can use the “Maps settings” configuration panel to add keys.

You need to use the URL at which your site is normally available from the outside (most likely your own domain). You can just use the root of your site for the registration and the key will automatically be used for all maps on the site. If you have a map on your site which sees much traffic, then you may want to register another key for it’s URL, so the volume limits from Google Maps are spread out a bit.

Two keys are included for testing with the following URLs:

• http://localhost:8080

• http://testing:8080

UK and China address search

The default Google Maps geocoding (search for coordinates by address) doesn’t work everywhere. As of May 2007 it doesn’t work in the UK and China for example.

We have added a workaround for this. To activate this workaround feature you’ll have to add a key for Google AJAX Search to enable search for those regions.

To use the Google AJAX Search fallback, you need an “Google AJAX Search API key from Google”:http://code.google.com/apis/ajaxsearch/signup.html.

The same rules as for the map key apply, see above.

Implementing custom content with map field

If you want to add location foeld to your custom content type, you should implement the following steps:

Add GeoLocation field:

from Products.Maps.field import LocationWidget, LocationField
from Products.Maps.interfaces import IMapEnabled, ILocation

MyContentSchema = ...

    LocationField('geolocation',
              required=False,
              searchable=False,
              validators=('isGeoLocation',),
              widget = LocationWidget(label = u'Event location'),
    ),
    ...

Update your class definition:

class MyContent(ATCTContent):
    """ my content description """
    implements(IMyContent, IMapEnabled, ILocation)

    ...

    def getMarkerIcon(self):
        """ Can be implemented as select field. See Maps.Location content """
        return "Red Marker"

Add following snippet to custom content view/template:

<div class="googleMapView googleMapLocation"
     tal:define="view context/@@maps_googlemaps_view">
    <dl metal:use-macro="here/maps_map/macros/markers">
    </dl>
</div>

Dependencies

• Plone 4.x

Credits

Created by Florian Schulze for Jarn AS in 2007.

Parts are based on:

• “ATGoogleMaps”:http://takanory.net/plone/develop/atgooglemaps

• “qPloneGoogleMaps”:http://projects.quintagroup.com/products/wiki/qPloneGoogleMaps

• “geolocation”:http://svn.quintagroup.com/products/geolocation/

Development sponsored by

The “Student Services of Bergen, Norway”:http://sib.no

“University of Oxford”:http://medsci.ox.ac.uk (Medical Sciences Division)

A Jarn AS product

“http://www.jarn.com”:http://www.jarn.com

“info@jarn.com”:mailto:info@jarn.com

2.1.2 (2013-02-07)

• Update for Plone 4.1: include Products.CMFCore to define missing permissions. Fix undefined name showContents in default view. [thefunny42]

• Add “Add permission” for Site Administrator too. [thefunny42]

• Add controlpanel option to turn off displaying full item contents in pop-up. (http://plone.org/products/maps/issues/34) [khink]

2.1.1 - 2011-05-13

• Force validator registration before use. Avoids spurious warning. [ggozad]

• Kicked out qPloneGoogleMaps and Products.geolocation [ggozad]

• Fixed broken TestCase. [ggozad]

• Updated control panel actions for Plone 4. [ggozad]

• Update ILocation interface. Custom content type must implement getMarkerIcon method to successfully support LocationMarker adapter. [naro]

• Added notes about implementation geolocation field to custom content type. [naro]

• Allow maps_map to be used as view template without being the default view (http://plone.org/products/maps/issues/32) [khink]

• Replace __init__ profile initialization with xml file GS profile setup, so we can add Products.Maps as a dependency in another product’s Generic Setup profile. [khink]

• Added Dutch translation [kcleong]

2.1.0 - 2010-09-19

• Update documentation to require Plone 4.x. [hannosch]

• Update license to GPL version 2 only. [hannosch]

• Removed IndexIterator since it was removed in Plone 4.0. [pbauer]

• Added support missing plone domain on i18n directory. Added Spanish translation. Updated full support for i18n and generate new template. [macagua]

• Improve map initialization when the location field is displayed in an other schemata. Merged from branches/map-in-another-schemata. Notes: Width and height must be define in the theme’s styles, if you put the field in an other schemata:

  div.googleMapEdit {
      width:756px; /* must be in pixels */
      height:455px; /* must be in pixels */
      padding-bottom:30px;
  }

  [sylvainb, toutpt]

2.0.3 - 2010-05-07

• Added missing i18n_domain to the configure.zcml. [hannosch]

• Cook javascript resources after control panel submissions. [silviot]

2.0.2 - 2010-02-10

• Added an add permission for GeoLocations to support fine grained control of where the content type can be added. [rossp]

2.0.1 - 2010-01-19

• Updated LocationFieldValidator to be compatible with both Plone 3 and 4. [hannosch]

2.0 - 2008-09-17

• Add a metadata.xml to the GenericSetup profile. [wichert]

• Refactored to make it easier to use Maps in custom content types. If you write a content type and use a field named ‘geolocation’, then you can use default implementations of adapters now instead of writing three on your own. [fschulze]

• Moved to common egg file layout. This means there will be no more tarball releases, because the docs are outside of the Products folder. [fschulze]

• Converted HISTORY.txt and README.txt to reStructureText. [fschulze]

• Added a simple buildout configuration to the package, to be able to develop and test it on its own. [hannosch]

1.2 - July 3, 2008

• Added greek translation. [ggozad]

• Updated templates for Plone 3.0. [fschulze]

• Dropped compatibility with Plone 2.5. [fschulze]

1.1 - September 05, 2007

• Fixed the logic when to show layers. [fschulze]

• Fixed viewing of maps if the workflow state was ‘private’. There is a new interface and view which only has the ‘enabled’ attribute and which is accessible without restriction. This is now used as the condition in portal_javascripts. [fschulze]

• The coordinates field now uses a tuple with two floats everywhere. The widget for it now uses two input fields. [fschulze]

• Made LinguaPlone aware. [fschulze]

• Added custom view for locations. The map is smaller at the upper right and the rich text is shown besides it. [fschulze]

1.1rc1 - May 17, 2007

• Added configlet for Plone 3.0. [fschulze]

• Fixed scrolling of map when clicking on pin. This only happend when there were no layers. [fschulze]

• Fixed functionality of layer checkboxes for IE6/7. [fschulze]

• Fixed key lookup when the URL has a trailing slash. [fschulze]

• Added fallback to Google AJAX Search if the Google Maps geocoding did not return any results. This allows you to search for cities i.e. the UK and China. [fschulze]

1.0 - May 03, 2007

• Changed the markup. All markers are in one definition list instead of one marker in one list. A dt with class=”title” marks the beginning of a new marker. [fschulze]

• Added support for layers. The default is to take keywords as the name of the layer in which a marker is visible. Then you get a map control with checkboxes for each keyword and you can view/hide the markers with that. [fschulze]

• Using GenericSetup for installation. [fschulze]

• Added support for existing qPloneGoogleMaps markers. Added support of content with location from the geolocation product. [fschulze]

• Added RichText field to Location objects. [fschulze]

• Added support for tabbed info windows. [fschulze]

0.5 - April 02, 2007

• Initial public release. [fschulze]