Waymark – Create an Interactive Map, or entire GIS. Embed OpenStreetMap, OSM, MapBox & Google Maps with Leaflet | Import + Export GPX, KML & GeoJSON | Elevation, EXIF & Geo Location

Description

🗺 Demo
🛠️ Try
📼 Watch
📖 Docs
🌟 GitHub
❤️ WordPress
☕️ Waymark JS

Creating Maps

Use the intuitive Editor to create Maps with one, or thousands of interactive Overlays.

  • Overlays – Create Markers, Lines and Shapes with a:
    • Title
    • Image (Media Library or link to external image)
    • Description (Rich text editor, HTML supported)
    • Type (defined in Settings)
  • Import
    • GPX
    • KML
    • GeoJSON
    • EXIF (Image location metadata)
    • Elevation data (adds an interactive profile chart for Lines with elevation data)
  • Meta – Add extra information to your Maps; these are customisable form inputs that allow you to add additional content to your Maps.
  • Types – Set options to visually distinguish between Overlays (colours/icons etc.), then select it when using the Editor.
  • Collections – Group Maps together and display multiple Maps at once. Create complex Collection hierarchies to suit your needs and associate Maps with multiple Collections.
  • Submissions – Allow registered users, or guests to create Maps from the front-end of your site. You can control who can Submit Maps, what editor features are available and whether submissions should be approved before they are published.

Displaying Maps

Embed your Maps using the [Waymark] Shortcode, or link to the Map Details page.

  • Shortcodes
    • Display a single Map, or a Collection of Maps anywhere that Shortcodes are supported.
    • An optional Shortcode Header displays the Map/Collection title, a link to the Map Details page and any Meta.
    • Display a Marker defined through the Shortcode.
    • Display Files (GPX, KML & GeoJSON) from a URL without the need for a Map to be created.
    • Display a Basemap only, without any Overlays by providing centre and zoom parameters.
  • Basemaps – Uses OpenStreetMap by default, with support for multiple raster tiled/”slippy” Basemaps. You can switch Basemaps using the Overlay Filter.
  • Overlay Filter – Allow the user to filter which Overlays are currently visible on the Map.
  • Export
    • (Optionally) Let anyone Export Maps into GPX, KML and GeoJSON formats through the Shortcode Header or on the Map Details page.
    • Works on mobile devices.

Customising

Built to be flexible, Waymark has lots of Settings and Types provide one place to control how Overlays (Markers/Lines/Shapes) are displayed.

Marker Icons can be provided as:
– Font Icons (Ionic Icons v2/Font Awesome v4)
– Simple Text, or Emojis (i.e. 🏕️, 🚩, 📸).
– Custom HTML (good ol’ <img src="https://example.com/icon.svg">, or a more complex structure). So you can pretty much create any kind of Icon you want.

For developers:

  • Most elements can be styled using CSS and have sensibly named waymark- classes.
  • WordPress integration:
    • Maps are stored using the custom post type waymark_map.
    • Collections use the waymark_collection Taxonomy.
    • Embed Maps using the [Waymark] Shortcode anywhere they are supported, or dynamically using the do_shortcode(["Waymark"]) function.
  • Geographical data is stored in GeoJSON format. Types are specified using the type Property, i.e. {feature: { geometry: { type: 'Point', coordinates: [0, 0] } }, properties: { type: 'Alert', title: 'Bridge Removed!' }.
  • Maps are displayed using the Leaflet JavaScript library, which is bundled with Waymark and can be extended using the callback function.
  • Use the JavaScript callback functions to extend Waymark functionality client-side, provided either globally (for integration with all Waymark Maps) or provided as a Shortcode parameter.

Be sure to check out Map First, a minimal WordPress theme with an obsession for Maps (it’s open-source too and contains lots of comments about customisations). As seen in the demo.

Waymark is free, open-source (GPL v2) and a labour of Love. I try to keep the plugin well supported, so please feel free to reach out with any issues, questions or feedback.

Development

[!NOTE]
To develop locally you will need to have both Node.js and NPM installed.

Grunt is used to run the build script, which compiles the JavaScript and CSS and performs some other tasks.

# Clone the repository
git clone https://github.com/opengis/waymark.git

# Navigate to the Waymark directory
cd waymark

# Install the dependencies (or pnpm/yarn install)
npm install

# Run the build script
grunt

The build script will watch for changes to the JavaScript and CSS files.

Pull requests are welcome!

[!IMPORTANT]
Waymark JS is responsible for the Viewer and Editor and is included as a Git submodule (/waymark-js directory). View on GitHub.

Screenshots

  • Add Overlays (Markers, Lines and Shapes) to create detailed interactive Maps. You can import/export from GPX/KML/GeoJSON.
  • Every Overlay can be given a title, image and description. Marker images can be displayed as a gallery.
  • Waymark features a clean, intuitive Editor for creating and editing your Maps. Overlays are customisable using Types, which allow you set styles once (colours/icons etc.), so you can simply select it when you are adding to the Map.
  • If you have more than one Basemap, you can switch between them when viewing the Map. Overlays can be shown/hidden by Type.
  • Use Meta to provide extra information about your Maps. Meta inputs are customisable and can be grouped.
  • The Map Details page displays an image gallery, elevation profile, export options, featured image and all Meta provided for the Map.
  • Add Maps to your content using the Waymark Shortcode. You can choose which Meta is displayed.
  • Organise Maps with Collections and display multiple Maps at once using the Shortcode. Collections can be nested and Maps can be associated with multiple Collections.
  • Waymark was designed to be very flexible, with lots of Settings to choose from.
  • Documentation and Help is available from the Waymark website.

Installation

With Waymark enabled, click on the “Maps” link in the sidebar to create and edit Maps. Once you are happy with your Map, copy the Waymark shortcode and add it to your content.

Read the Docs »

FAQ

Is There a Demo?

Yes, here. You can also try the Editor here.

Can I Get More Help?

Yes, please view the Documentation. If you still need help, feel free to reach out.

How Can I Contribute?

Please help translate the plugin! If you like the plugin and speak multiple languages, **please consider becoming a Translation Editor (PTE) for the plugin.**

You could also:

If you have anything bad to say, please create an issue before leaving a review, this is how the plugin gets better!

Does Waymark Support Google Maps?

Yes! While the Google Maps API is not used, Google Basemaps can be added to Waymark as raster tiles.

Can I Translate the Plugin?

Please! Waymark is localization ready, translation contributions are greatly appreciated.

Acknowledgements?

Waymark relies on input from it’s users, thank you to everyone for providing feedback 🙂

Built on the shoulders of giants, thank you!

Reviews

February 22, 2024 1 reply
A nice plugin to include maps/tracks on your website. We use it for our (road) cycling club so members can download the gpx of the group ride. We do not use all functionality like "rich" maps with markers and photo's. We also not create maps within the plugin but reference the gpx file directly that is stored in the media section of WP. Support by the creator of this plugin is very good (in the odd case something does not work).
February 21, 2024 1 reply
I use this plugin to show maps for our cycling routes on our website and it is perfect. Twice when I needed support so far, Joe responded in minutes and problem solved.
February 17, 2024 1 reply
This plugin is simply brilliant and practical. Easy to use, it allows you to make maps very quickly. The elevation, photos and collections features are a real plus compared to other plugins!
January 16, 2024 4 replies
This plugin is very simple and good. Joe helped me quickly when I needed it.Raccomended plugin.
January 7, 2024
I was looking for a simple plugin to display all sort of maps on my website (with the possibility to import GPX files directly) and this one is just what I needed ! The plugin work perfectly, and everything is customisable through CSS or shortcakes. Awesome job ! Thanks a lot to the author !
December 27, 2023 1 reply
I am putting up a WordPress site for a blog I keep about my sailing adventures. The WayMark mapping pluggin does everything I need. It is really easy to setup a new map and easy to have a map read from a gpx file that I automatically update as my boat moves. And Joe has been great at responding to my questions! thanks Pat
Read all 41 reviews

Contributors & Developers

“Waymark – Create an Interactive Map, or entire GIS. Embed OpenStreetMap, OSM, MapBox & Google Maps with Leaflet | Import + Export GPX, KML & GeoJSON | Elevation, EXIF & Geo Location” is open source software. The following people have contributed to this plugin.

Contributors

“Waymark – Create an Interactive Map, or entire GIS. Embed OpenStreetMap, OSM, MapBox & Google Maps with Leaflet | Import + Export GPX, KML & GeoJSON | Elevation, EXIF & Geo Location” has been translated into 3 locales. Thank you to the translators for their contributions.

Translate “Waymark – Create an Interactive Map, or entire GIS. Embed OpenStreetMap, OSM, MapBox & Google Maps with Leaflet | Import + Export GPX, KML & GeoJSON | Elevation, EXIF & Geo Location” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1.3

  • Submission File Upload bug fix.

1.1.2

  • Adding missing localisations.

1.1.1

1.1.0

  • Waymark JS – The plugin has been significantly refactored, with the JavaScript codebase being split into a separate project. This makes the Waymark Editor and Viewer available as a standalone library, which can be used in any web page and does not require WordPress.
  • Removed the Show/Hide “Type Labels” Setting. Type labels are always shown by default, but can be hidden using CSS.
  • Removed Settings for importing custom GeoJSON properties.
  • Lots of other improvements and bug fixes.

1.0.4

  • Removed “Store Read Files” Setting, which was disabled by default and did not work reliably.
  • Waymark JS refactoring, preparing for spin-off.
  • Other fixes and improvements.

1.0.3

  • Global Callback – If the function waymark_loaded_callback is defined globally, it will be called when Waymark has loaded. This allows you to extend Waymark functionality similar to the Shortcode Callback, however it will apply to all Waymark Maps.
  • Fix for Export/Overlay Filter bug.
  • Other fixes and improvements.

1.0.2

Fix for colours not appearing correctly in the Overlay Filter. Thanks to geomfranzo for raising this.

1.0.1

Fixed a bug with Map Exporting. Thanks to microteq for reporting this.

1.0.0

Thanks for helping Waymark get to Version 1! ❤️

  • Map First – A minimal WordPress theme with an obsession for Maps. It’s open-source too and contains lots of comments about customisations. As seen in the demo.
  • Added Total Ascent and Descent to Elevation Profile. Thanks to MaximeChallon for the Pull Request 🙂
  • Improved rendering of multiple Maps through the Collection Shortcode, where the initial view would sometimes not be set correctly to view all Map data.
  • Updated documentation.
  • Lots of other bug fixes and improvements.

0.9.30

  • Marker Clustering
    • Once enabled, Markers will be stacked when they are close together. This can help to reduce clutter on the Map.
    • You can enable this feature in Settings > Maps > Clustering, or using the show_cluster="1" Shortcode option.
    • There are also settings to adjust the cluster radius and what what zoom level to start clustering at.
  • Added file_start_type and file_end_type options to the Shortcode Files feature, which allow you to automatically add a Marker of the specified type to the start and/or end of all Lines in the file. Thanks to digbymaass for the suggestion.
  • Stop Elevation plugin from adjusting map bounds. Thanks to ellocosolo for the report.
  • Improved KML error handling when loading from URL.
  • Improved rendering of multiple Maps through the Collection Shortcode.
  • Minor bug fixes

0.9.29.5

  • Fixed a bug where Submissions were not being saved.

0.9.29.4

  • Minor bug fix.

0.9.29.3

  • Added a Collections > “Shortcode Method” Setting. This allows you to choose whether Map data is loaded in the Background (via AJAX), or Embedded in the page when embedding a Collection via the Shortcode. Embedding may be a bad idea for LARGE COLLECTIONS, but may resolve some (JavaScript) issues where Collections are not displaying correctly.

0.9.29.2

  • Fixed a bug where the Shortcode Zoom and Centre parameters were being ignored. Thanks to killianweid for creating this issue.

0.9.29.1

0.9.29

  • Added map_width Shortcode option, which has been requested a couple of times. Thanks for bugging me! :0)
  • Added Opacity Setting for Line Types (Lines > Opacity), thanks to digbymaass for the suggestion.

0.9.28.7

  • Meta data is now preserved when the Map is trashed/restored. Thanks to killiandev7 for bringing this to my attention.
  • Fixed a bug where special characters in Description were being messed up. Thanks to killianweid for creating this issue.
  • Fixed a bug with some KML files when loading from URL using Shortcode. Thanks to henkna for letting me know about this.
  • Added Leaflet Basemap examples URL to Settings > Basemaps.
  • Minor bug fixes and improvements.

0.9.28.6

Added max_zoom Shortcode option, which will prevent the Map from being zoomed in further that this zoom level (usually ~1-20 range). Thanks to microteq for the suggestion.

0.9.28.5

Added elevation_units (metric/imperial) Shortcode option, which will override the Waymark > Elevation > Elevation Units option. Thanks to randombuffalo for the suggestion.

0.9.28.4

0.9.28.3

  • More fixes!

0.9.28.2

  • Fixed a bug where Maps initally hidden on page load are broken. Thanks to microteq for reporting this.

  • Fix for a weird glitch where sometimes the Map will not “wake” if the mouse is hovering over that Map during initial page load. Thanks to microteq for reporting this.

0.9.28.1

  • Fixed a bug where Line direction arrows were being shown for hidden Lines. Thanks to microteq for reporting this.

0.9.28

  • Direction Arrows
    • Lines can now have a direction associated with them. To add a direction, click on a Line while editing a Map and select from the direction dropdown. Thanks for the suggestions!
  • Interaction
    • By default, Waymark disables scroll zoom until the user hovers over the Map for 2 seconds. This behaviour can now be customised in Waymark Settings > Maps > Interaction. Settings allow you to adjust the delay and optionally display a message to the user while scroll zoom is disabled, for example “Click or Hover to Wake”.
    • Fixed an annoying glitch where mouse “wheeling” over the elevation chart caused the Map to zoom.
    • Added Max Zoom setting in Maps > Basemaps, which was requested a long time ago!
  • Permalinks
    • Customise your Map and Collection URLs in Waymark Settings > Advanced > Permalinks by specifying Map and Collection slugs (i.e. example.com/[map-slug]/example-map/ and example.com/[collection-slug]/example-collection/). Thanks to wkndwlk for the suggestion.
  • GeoJSON Properties
    • You can now read GeoJSON feature properties when importing from file by adding them in Waymark Settings > Overlays > Properties. If Waymark finds data for these properties it will be added to the Overlay description when it is imported. Thanks to waimek for the suggestion.
  • Collection Export
    • You can now Export entire Collections when embedding them with the Shortcode. Click Details in the Shortcode Header to see the Export feature. The Public Export (Settings > Map > Misc.) and Shortcode Header (Settings > Map > Shortcodes) Settings must be enabled. As with Maps only the currently visible Overlays are exported, with GeoJSON, KML and GPX supported. Thanks to wimzwag for the suggestion.
  • Fixed a bug where elevation data remained visible even when a Line was hidden. Thanks to Nigel for pointing this out.

0.9.27

  • Added Map Scale Setting, which displays a distance scale on the Map in kilometers and miles (Settings > Map > Misc.)

0.9.26

  • Individual Overlay Types can now be Shown/Hidden initially using the Shortcode, overriding the “Show Initially” Setting for each. Use the hide_marker, show_marker, hide_line, show_line, hide_shape, show_shape Shortcode parameters, providing one or multiple (comma separated) Type Keys. For example:

    [Waymark map_id=”1234″ hide_marker=”photo,alert” show_line=”green”]

Thanks to hansolo68 for the suggestion.

  • Admin Help page removed in favour of a link to the Waymark website Documentation.

0.9.25.1

  • Fixed map data container bug, which was causing Map Data not to save.

0.9.25

  • Settings navigation improvements.
  • Submission localization fixes.
  • Minor bug fixes.

0.9.24

  • Editor popup redesign, including Type previews.
  • Front-end Submissions improvements.
  • Lots of other bug fixes and improvements.

0.9.23

  • Bug fix

0.9.22

  • Ignore file extension capitalisation when reading from file. This was a bug that meant reading from file.GPX (instead of file.gpx) was rejected for no good reason.

Credit to Werner for getting in touch and prompting these changes.

0.9.21

  • Bug fix. Uncaught TypeError: Assignment to constant variable. Thanks to huubl for the Pull Request!

0.9.20

  • Front-end Submissions can now be added to a Collection by default. A collection for User and Guest submissions can be specified in Settings > Submissions > Default Collection.

0.9.19

  • Shortcode Files
    • Files (GPX, KML & GeoJSON) can now be displayed using the Shortcode, without the need for a Map to be created. For example:
      [Waymark file_url="http://example.com/track.gpx"]
      By default, …