volto-venue

July 17, 2025 ยท View on GitHub

An addon for Volto as a frontend for collective.venue.

To be used with mrs-developer, see Volto docs for further usage information. The following is an example configuration:

  "volto-venue": {
    "output": "./packages/",
    "package": "volto-venue",
    "url": "git@github.com:collective/volto-venue.git",
    "https": "https://github.com/collective/volto-venue.git",
    "branch": "master"
  }

Installation

Add the name of your add-on in the file package.json in the section dependencies. This example adds volto-venue.

  "addons": [
    ...
    "volto-venue"
    ...
  ],

Usage

If you're using Volto < 16, then use v3.2.0

If you're using Volto < 12, then use v2.0.1

You can use this in combination with collective.venue backend add-on and it will work out of the box, otherwise you can define a field called geolocation or add the GeoLocationWidget on a custom field.

import { GeoLocationWidget } from 'volto-venue';

config.widgets.id = {
  ...config.widgets.id,
  geolocation: GeoLocationWidget,
};

Screenshot

screenshot volto-venue

GeolocationWidget

This widget allows to compile a form with an address data, or use the map to select a point using coordinates.

OSMMap

This component shows a map from OpenStreetMap. Accepts these props:

PropTypeDefaultDescription
centerarraymarkers[0]Array containing latitude as the first element and longitude as the second one
markersobject[]Array of objects with the structure: { latitude: number, latitude: number, title: string }
zoomnumber15Map zoom
onMarkerDragEndfunc() => {}Callback to handle marker position change on the map
draggablebooleanfalseEnables dragging the marker on the map
showTooltipbooleanfalseShows a tooltip with the title on the marker
showPopupbooleanfalseShows a popup on marker click. Content of popup will be passed in marker object in popupContent prop.
clusterbooleanfalseTo show clusters on map if you have a lot of points.

License

The project is licensed under the MIT license.