Visual Leaflet editor

From Maps for MediaWiki
Revision as of 15:06, 27 May 2021 by Jeroen De Dauw (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

You can add data to Leaflet maps using a visual map editor.

This editor needs to be enabled per map. When it is enabled, an edit icon will show below the zoom control to people with edit permissions.

View demo video of the Visual Leaflet Editor in Maps 7.13.

The edit button that activates the editor
Map in edit mode after activating the editor

Activating the editor[edit | edit source]

The editor stores data on a separate page in the GeoJSON namespace. This results in a two step process.

Step 1: create a new page in that namespace by going to GeoJson:WhateverYourMapIsAbout. Click the "Create this page" button. A preview of the map will appear and you can edit it in place if you already wish to add some data.

The edit button that activates the editor

Step 2: on the page where you wish to show the map, place the usual #display_map code to display your Leaflet map. Add the geojson parameter with the value being the name of the GeoJson page you created: geojson=WhateverYourMapIsAbout.

{{#display_map: center=Berlin | geojson=WhateverYourMapIsAbout}}

Multiple maps can use the same GeoJson page and thus share data. If you want to use an existing GeoJson page, skip step 1.

Using the editor[edit | edit source]

The editor only shows to people with edit permissions for Leaflet maps that use the geojson parameter with the name of an existing page as value.

Activate the editor by clicking the edit button. This puts the map in edit mode. Only data that can be edited is shown. This means markers and shapes defined in wikitext will be hidden in edit mode.

In edit mode you can click markers and shapes to open a tooltip in which you can add a title and/or description. Controls on the left side of the map allow adding, deleting and modifying markers and shapes.

Once you make a change, a save button is shown on the left below the edit controls. Click the save button to save your changes and exit edit mode.

To exit edit mode without making changes, refresh the page in your browser. Or just leave the map in edit mode.

Sharing GeoJson[edit | edit source]

Multiple maps can use the same GeoJson page and thus share data.

Changes via the GeoJson page or via other pages using the same map data do not cause automatic updates of the map when page caching is enabled. Manual cache invalidation might be needed at times. When switching to edit mode, the map always fetches the latest data, to minimize the chance of merge conflicts.

Example[edit | edit source]

{{ #display_map: center=Berlin | geojson=LeafletEditorExample | cluster=on }}
Loading map...

The editor currently does not support captchas. Since this wiki requires captchas for anonymous editors, saving the map after editing anonymously will fail. To get the complete experience create an account.