raptus.article.maps 2.0b18

Provides a maps content type to be added to articles

Introduction

Provides a maps content type to be added to articles

The following features for raptus.article are provided by this package:

Content

• Map - add google maps in an article.

• Marker - add markers in a map.

Components

• Maps (List of maps contained in the article over the whole width.)

• Maps left (List of maps contained in the article on the left side.)

• Maps right (List of maps contained in the article on the right side.)

Dependencies

• raptus.googlemaps

• raptus.article.core

Installation

To install raptus.article.maps into your Plone instance, locate the file buildout.cfg in the root of your Plone instance directory on the file system, and open it in a text editor.

Add the actual raptus.article.maps add-on to the “eggs” section of buildout.cfg. Look for the section that looks like this:

eggs =
    Plone

This section might have additional lines if you have other add-ons already installed. Just add the raptus.article.maps on a separate line, like this:

eggs =
    Plone
    raptus.article.maps

Note that you have to run buildout like this:

$ bin/buildout

Then go to the “Add-ons” control panel in Plone as an administrator, and install or reinstall the “raptus.article.default” product.

Note that if you do not use the raptus.article.default package you have to include the zcml of raptus.article.maps either by adding it to the zcml list in your buildout or by including it in another package’s configure.zcml.

Usage

Add map

You may now add maps in your article. Click the “Add new” menu and select “Map” in the pull down menu. You get the standard plone form to add your map.

Components

Navigate to the “Components” tab of your article, select the map component and press “save and view”. Note that at least one map has to be contained in the article in which this component is active.

Copyright and credits

raptus.article is copyrighted by Raptus AG and licensed under the GPL. See LICENSE.txt for details.

Developer Manual

Note: You find a developer manual for raptus.article at raptus.article.core. Please have look there if you need more information.

Code overview

Components

plone.abovecontentbody

• raptus.article.maps.left

• raptus.article.maps.right

• raptus.article.maps.full

Interfaces

file: interfaces.py

• IMaps (Provider for maps contained in an article)

  • getMaps - method (Returns a list of maps (catalog brains))

• IMarkers (Provider for markers contained in a map)

  • getMarkers - method (Returns a list of markers (catalog brains))

• IMap (Marker interface for the map content type)

• IMarker (Marker interface for the marker content type)

Changelog

2.0b18 (2013-11-21)

• Adjusted raptus.article.maps.js.py to use the provided adapters rather than a direct call to portal_catalog to enable overrides such as in raptus.article.alias

2.0b17 (2013-07-01)

• Adjusted javascript initialization to work with the new component selection functionality introduced in raptus.article.core 2.0b13

2.0b16 (2012-09-12)

• added new option to enable centering by markers

2.0b15 (2012-04-19)

• fixed broken 2.0b14 release

2.0b14 (2012-04-19)

• fixed raptus.article.maps.js.py to work if no marker is available

• fixed jsregistry (ordering)

2.0b13 (2011-12-06)

• adjusted javascript registry to match the one from raptus.googlemaps 1.0b7

2.0b12 (2011-05-09)

• fixed javascript registry expressions and helper view to prevent Unauthorized exception

2.0b11 (2011-05-06)

• update jquery gomap to version 1.3.0 (raptus.googlemaps product)

• add http/https support

• pin google maps version to 3.3 (this fixed issues with the newest nightly version)

2.0b10 (2011-04-05)

• fix the order for all javascript files

2.0b9 (2011-03-07)

• Added condition for all javascript files to prevent errors if api and plugin is missing

2.0b8 (2011-03-07)

• Added condition for google api js

2.0b7 (2011-02-17)

• plone 3 compatibility

2.0b6 (2011-02-17)

• Change jQuery Plugin. New Plugin is goMap

• http://www.pittss.lv/jquery/gomap/

• Remove Google Maps API Key

• Use Google Map v3

• bugfix by saving a marker

• Load google maps api over portal_javascripts (remove viewlet)

2.0b5 (2010-12-14)

• Load javascript only if a map are available.

2.0b4 (2010-11-10)

• Added French translations

• Fixed vocabulary of the zoom field (Added IntDisplayList)

2.0b3 (2010-10-21)

• Updated readme and manual

2.0b2 (2010-10-20)

• First public release