search

OpenGIS / Waymark

Waymark adds powerful mapping features to WordPress that are easy to use. Create beautiful, interactive Maps that you can customise to suit your needs.
https://www.waymark.dev
GNU General Public License v2.0
21 stars 6 forks source link
elevation geosjon gps gpx guide kml leafletjs location map mapping markers navigation route wordpress wordpress-plugin

readme

Waymark

Contributors: morehawes
Tags: GIS, Map maker, GPX, Track, Elevation
Requires at least: 4.6
Tested up to: 6.7
Requires PHP: 5.2
Stable tag: 1.4.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Waymark adds powerful mapping features to WordPress that are easy to use. Create beautiful, interactive Maps customised to suit your needs.

Description

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

If you find value in Waymark please consider supporting it's continued development through sponsorship. Any amount is appreciated.

Creating Maps

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

Displaying Maps

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

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:

For developers:

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).

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 (and the Waymark JS submodule)
git clone --recurse-submodules 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.

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 »

Frequently Asked Questions

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!

Screenshots

1. Add Overlays (Markers, Lines and Shapes) to create detailed interactive Maps. You can import/export from GPX/KML/GeoJSON.

Add Overlays (Markers, Lines and Shapes) to create detailed interactive Maps. You can import/export from GPX/KML/GeoJSON.

2. Every Overlay can be given a title, image and description. Marker images can be displayed as a gallery.

Every Overlay can be given a title, image and description. Marker images can be displayed as a gallery.

3. 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.

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.

4. If you have more than one Basemap, you can switch between them when viewing the Map. Overlays can be shown/hidden by Type.

If you have more than one Basemap, you can switch between them when viewing the Map. Overlays can be shown/hidden by Type.

5. Use Meta to provide extra information about your Maps. Meta inputs are customisable and can be grouped.

Use Meta to provide extra information about your Maps. Meta inputs are customisable and can be grouped.

6. The Map Details page displays an image gallery, elevation profile, export options, featured image and all Meta provided for the Map.

The Map Details page displays an image gallery, elevation profile, export options, featured image and all Meta provided for the Map.

7. Add Maps to your content using the Waymark Shortcode. You can choose which Meta is displayed.

Add Maps to your content using the Waymark Shortcode. You can choose which Meta is displayed.

8. 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.

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.

9. Waymark was designed to be very flexible, with lots of Settings to choose from.

Waymark was designed to be very flexible, with lots of Settings to choose from.

10. Documentation and Help is available from the Waymark website.

Documentation and Help is available from the <a href="https://www.waymark.dev/">Waymark</a> website.

Changelog

1.4.1

1.4.0

1.3.2

Collection background loading bug fix. Thanks to zerider for reporting this.

1.3.0

1.2.0

Enable or disable various WordPress features of the Map Custom Post Type, including the new ability to enable comments and excerpt integration. This Setting is Available in Settings > Advanced > Post Type. Thanks to YosoraLife for requesting this (here and here).

1.1.8

Show/Hide Overlay Types bug fix. Thanks to YosoraLife for raising this issue.

1.1.7

Another Collection Map link fix.

1.1.6

Removed Link to/from Maps Setting in Collection options. Links to/from Collections and Maps will now be displayed by default, but can be hidden using CSS if desired. Thanks to wkndwlk for reporting this.

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.4

1.0.3

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! ❤️

0.9.30

0.9.29.5

0.9.29.4

0.9.29.3

0.9.29.2

0.9.29.1

0.9.29

0.9.28.7

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

0.9.28.2

0.9.28.1

0.9.28

0.9.27

0.9.26

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

Thanks to hansolo68 for the suggestion.

0.9.25.1

0.9.25

0.9.24

0.9.23

0.9.22

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

0.9.21

0.9.20

0.9.19

0.9.18

0.9.17.1

0.9.17

A BIG thank you to the following users for their help with testing:

0.9.16

0.9.15.2

0.9.15.1

0.9.15

0.9.14

A big thank you to everyone who provided input for this release. Extra special thanks goes to coloursign, meggsico, davinian, snake-plissken, sunlight1976 and bumbar for their help with testing.

0.9.13

Thanks to neilhorton740, carldavidcarlstrom, and coloursign for testing and feedback.

0.9.12

A big thanks to neilhorton740 and carldavidcarlstrom for bug finding and testing.

0.9.11

Thanks to neilhorton740 and carldavidcarlstrom for suggestions and testing.

0.9.10

Another big thanks to neilhorton740 for suggestions and testing.

0.9.9

Added the ability to specify a default basemap through shortcode: [Waymark map_id="1234" basemap="Basemap Name"]. Which Basemap to use as the Map Editor default can also be specified in Settings > Misc. > Editor Options. Thanks again to neilhorton740 for the suggestion and testing.

0.9.8

Added Line Weight setting for Lines and the ability to override the Shortcode Header setting through the shortcode. A HUGE thank you to neilhorton740 for the suggestions and testing.

0.9.7

Added support for Meta, which allows you to customise the input fields that display under the Map Editor. Any data you input will display on the Map Details page. Plus some minor improvements and bug fixes.

0.9.6

Added support for Collections, which allow you to organise your Maps and display multiple Maps at once. Also more bug fixes.

0.9.5

Integrated leaflet-control-geocoder, thanks for the suggestion! Also minor fixes and tweaks.

0.9.4

Bug fixes and improvements. Thanks again to rottensod!

0.9.3

Bug fixes and minor tweaks. Thanks to rottensod for your bug finding efforts!

0.9.2

Integrated Leaflet.Sleep into Waymark for better zoom/scroll event handling. Thanks to numeeja for this suggestion!

0.9.1

Minor bug fix.

0.9

First public release of Waymark!