Settings

Configure Basemaps, Markers, Lines, Shapes, Meta, Submissions and other Waymark Map options.

Basemaps

Waymark uses the excellent OpenStreetMap as its default Basemap and supports many other providers.

Thunderforest and Mapbox are examples of providers that offer easy access to beautiful Basemaps (including satellite imagery). They require registration, but have a free usage tier.

Basemap Name: TypetextDefaultOpen Street Map
The Layer Name will appear in a dropdown list shown by the Map when multiple Basemaps have been entered. You can change the default basemap in the shortcode: [Waymark map_id="1234" basemap="Basemap Name"]
Basemap URL: TypetextDefaulthttps://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
Many mapping services support the Slippy Map format. Waymark requires URLs that contain {z} (zoom level) and {x}/{y} (tile coordinates). For example the OpenCycleMap URL is https://tile.thunderforest.com/cycle/{z}/{x}/{y}@2x.png?apikey=[your_api_key].
Basemap Attribution: TypetextDefault© OpenStreetMap contributors
Mapping services often have the requirement that attribution is displayed by the map. Text and HTML links are supported.
Basemap Max Zoom: TypetextDefault18
Set a maximum zoom level for this Basemap, the default is 18.

Markers

Marker Types

Customise how Markers are displayed on the Map. Set these styles once, then select the appropriate Type when you add to the Map.

The label is a display name. The key is a stable internal identifier used in Shortcodes and CSS; translating the label does not change the key.

Marker Label: TypetextDefaultPhoto
What kind of Marker is this? E.g. "Photo", "Grocery Store", "Warning!". Once saved, Marker labels cannot be edited. The Marker Label is displayed in the Tooltip (when hovering over the Marker) and in the Info Window (once the Marker is clicked). Hide in Settings > Misc. > Type Labels.
Marker Shape: TypeselectDefaultmarker
Which shape of Marker to use. Circles and Squares are centered at the specified location, Markers point down to that location.
Marker Size: TypeselectDefaultlarge
Which size of Marker to use.
Marker Background: TypetextDefaultwhite
The Marker background colour. Click "Select Colour" to select.
Marker Show Initially: TypebooleanDefault1
When using the Overlay Filter you can choose to show/hide certain Types when the Map initially loads.
Marker Submissions: TypebooleanDefault1
Make this Type available in front-end Submissions?
Icon Type: TypeselectDefaulticon
Font Icons are available from Font Awesome and Ionic Icons. Simple Text or Emojis are supported, as well as custom HTML. So you can pretty much use anything you like!
Icon Name: TypetextDefaultion-camera
The desired icon name from Ionicons or Font Awesome, e.g. "ion-camera", or "fa-camera". Click the links to see the full list of icons available.
Text to display inside the Marker, in the chosen colour. Space is very limited! Pro Tip: adjust text size using CSS; for all Markers: .waymark-icon-text{font-size: 18px}, or by Type: .waymark-marker-photo .waymark-icon-text{...}. Use your browser's inspector to dig for Type class names.
The HTML entered will be added inside each Marker. Pro Tip! HTML Entities supported (e.g. &cross; as well as Unicode and Emojis!), or provide HTML to integrate with other Icon providers.
Icon Colour: TypetextDefault#475260
The colour of the icon. Click "Select Colour" to select.

Lines

Line Types

Customise how Lines are displayed on the Map. Set these styles once, then select the appropriate Type when you add to the Map.

The label is a display name. The key is a stable internal identifier used in Shortcodes and CSS; translating the label does not change the key.

Line Label: TypetextDefaultRed
What kind of Line is this? E.g. "Easy", "Walking Only", "Dark Red". The Line Label is displayed in the Tooltip (when hovering over the Line) and in the Line Info Window. Once saved, Line labels cannot be edited.
Line Colour: TypetextDefault#d84848
The colour of the Line. Click "Select Colour" to select.
Line Width: TypetextDefault3
The width of the Line, in pixels.
Line Opacity: TypetextDefault0.7
The opacity of the Line, between 0.0 and 1.0 (e.g. "0.5").
Line Show Initially: TypebooleanDefault1
When using the Overlay Filter you can choose to show/hide certain Types when the Map initially loads.
Line Submissions: TypebooleanDefault1
Make this Type available in front-end Submissions?

Shapes

Shape Types

Customise how Shapes are displayed on the Map. Set these styles once, then select the appropriate Type when you add to the Map.

The label is a display name. The key is a stable internal identifier used in Shortcodes and CSS; translating the label does not change the key.

Shape Label: TypetextDefaultRed
What kind of Shape is this? E.g. "Park", "Danger!", "Light Blue". The Shape Label is displayed in the Tooltip (when hovering over the Shape) and in the Shape Info Window. Once saved, Shape labels cannot be edited.
Shape Colour: TypetextDefault#d84848
The colour of the Shape. Click "Select Colour" to select.
Shape Fill Opacity: TypetextDefault0.5
The opacity of the inside of the shape, between 0.0 and 1.0 (e.g. "0.5").
Shape Show Initially: TypebooleanDefault1
When using the Overlay Filter you can choose to show/hide certain Types when the Map initially loads.
Shape Submissions: TypebooleanDefault1
Make this Type available in front-end Submissions?

Properties

Read GeoJSON feature properties when importing.

If Waymark finds data for the property keys below it will be stored when it is imported. These can be automatically appended to the Overlay Description, or accessed programmatically via the layer.feature.properties Object.

Property Key: Typetext
This is the key associated with the data you are trying to access, i.e. "properties": {"property_key": "Some content here"}
Property Title: Typetext
The value for this property will be added to the Overlay Description under this title.

Options

Append listed Properties to the Overlay Description.

Append: TypebooleanDefault0
Append the property value to the Overlay Description.

Submissions

Front-End Submissions

Use the [Waymark content="submission"] Shortcode to allow Map submissions from the front-end of your site.

Allow Submissions: TypebooleanDefault0
Submissions will be available only to site administrators by default, but can also be allowed for registered users or even to guests without registration.

User Submissions

Allow registered users to create Maps from the front-end.

Allowed Roles: Typeselect_multi
Users with the selected roles will be able to make Submissions through the front-end
Editor Features: Typeselect_multi
What features to offer in the Editor. Important! Uploaded images are added to the Media Library, reading from file does not keep a copy of the file on the server. Whether an individual Meta input is displayed can be set in the Settings > Meta.
Default Status: Typeselect
This is the initial status of the submitted Map. Note! Publish means that the Map (including any images added) will be immediately visible on your site.
Default Collection: Typeselect
If specified, user submissions will be automatically added to this Collection.

Public Submissions

This will allow Submissions from any visitor, without registration.

Allow Public Submissions: TypebooleanDefault0
Allow anyone to submit Maps to your site, without registration.
Editor Features: Typeselect_multi
What features to offer in the Editor. Important! Uploaded images are added to the Media Library (see Upload Location below), reading from file does not keep a copy of the file on the server. Whether an individual Meta input is displayed can be set in the Settings > Meta.
Upload Location: TypeselectDefaultwaymark_submission
Images uploaded by non-registered users can be stored separately from other Media Library uploads, to aid with moderation. All uploaded images will be stored in a single directory (/waymark_submission) found in the upload root.
Default Status: Typeselect
This is the initial status of the submitted Map. Note! Publish means that the Map (including any images added) will be immediately visible on your site.
Default Collection: Typeselect
If specified, user submissions will be automatically added to this Collection.

Misc.

Map Options

Use these options to change how Maps are displayed.

Default Centre: TypetextDefault51.38436,-68.74923
Waymark centres the Map automatically when displaying data. These coordinates (Latitude,Longitude) will be used when there is no data available.
Map Height: TypetextDefault450
Specify the desired height of the Map (in pixels). Pro Tip! This will affect all Maps, but you can change the height (and width) of an individual Map through the Shortcode: [Waymark map_id="1234" map_height="640"]
Default Zoom: TypetextDefault9
Waymark zooms the Map automatically when displaying data. This zoom level (0-18) will be used when there is no data available.
Image Gallery: TypebooleanDefault1
Whether to display an image gallery for Markers that have images associated with them. Pro Tip! This will affect all Maps, but you can choose to show/hide the gallery of an individual Map through the shortcode: [Waymark show_gallery="1"]
Overlay Filter: TypebooleanDefault1
Allow the user to filter which Markers, Lines and Shapes are currently visible on the Map. Pro Tip! This will affect all Maps, but you can choose to show/hide the filter for individual Maps through the shortcode: [Waymark show_filter="1"]
Public Export: TypebooleanDefault0
Offer visitors the ability to Download all Collection/Map Overlays in the Shortcode Header and on the Map Details page. GeoJSON, GPX and KML formats supported.
Show Scale: TypebooleanDefault0
Show a distance scale (km and miles) on the Map.

Sleep Options

Waymark Maps will zoom when the user scrolls. This can cause some unexpected/annoying behaviour when scrolling a page.

Sleeping the Map initially and Waking upon user interaction (i.e. hovering/clicking/tapping) may create a better experience.

Hover Wake Time: TypetextDefault2
How many seconds before scroll zoom is enabled. 0 seconds will mean no delay (disabling this feature). A large number of seconds like 3600 (an hour) will essentially disable hover to wake, meaning the user will need to click to wake.
Display Message: TypebooleanDefault0
This message will be displayed by the Map while scroll zoom is disabled.
Display Message Text: TypetextDefaultClick or Hover to Wake

Cluster Options

With Clustering enabled, Markers will be grouped together when they are close together. This can help to reduce clutter on the Map.

Marker Clustering: TypebooleanDefault0
Whether to cluster (stack) Markers that are close together. Pro Tip! This will affect all Maps, but you can also enable/disable clustering through the Shortcode: [Waymark show_cluster="0"]
Cluster Threshold: TypetextDefault14
Markers will not be clustered above this zoom level.
Cluster Radius: TypetextDefault80
The maximum radius that a cluster will cover from the central marker (in pixels). Decreasing will make more, smaller clusters. Default 80.

Shortcode Options

How Maps are embedded into your content using the shortcode.

Shortcode Header: TypeselectDefault1
The shortcode header displays the title and link to the Map or Collection. Pro Tip! This will affect all shortcodes, but you can override the setting through the shortcode: [Waymark map_id="1234" shortcode_header="1"] (the value must be either 0 or 1).
Header for Admin: TypeselectDefault0
Use this Setting to always show the Shortcode Header when signed in as admin, useful for quickly navigating to embedded Maps.

Elevation Options

Lines with elevation data.

Elevation Profile: TypeselectDefault2
Display an interactive elevation profile graph below the Map for Lines that have elevation data. Pro Tip! You can choose to show/hide the elevation graph of an individual Map through the shortcode: [Waymark map_id="1234" show_elevation="1"]
Elevation Units: TypeselectDefaultmetric
Display elevation data in metric (m/km) or imperial (ft/mi) units.
Elevation Colour: TypetextDefault#b42714
The colour of the elevation graph and associated Line.
Show Initially: TypebooleanDefault1
Whether to show the elevation profile when the Map loads. If set to No, the user must click on a Line in order to display the elevation data. If there are multiple Lines with elevation data, the one added to the editor first will be the one shown initially.

Collection Options

How Collections are displayed.

Shortcode Method: TypeselectDefaultfetch
Whether to load multiple Maps in the Background (uses AJAX to improve page load) when embedding with the Shortcode, or to Embed them within the page. Embedding may be a bad idea for LARGE COLLECTIONS, but can resolve some issues where Collections are not displaying correctly.

Editor Options

Customising the Map Editor.

Confirm Deletion: TypebooleanDefault1
Whether to show a confirmation dialog before deleting Markers/Lines/Shapes from the Map. Pro Tip! Even if you accidentally delete something, changes are not saved until the "Update" button is clicked.
Default Basemap: TypeselectDefaultOpen Street Map
Which Basemap to use as the editor default.

Permalinks

Customise your Map and Collection URLs.

Map Slug: TypetextDefaultmap
The URL slug that will be used for links to your Maps, i.e. example.com/[map-slug]/example-map/. Only alpha-numeric characters and hyphens (-) are allowed.
Collection Slug: TypetextDefaultcollection
The URL slug that will be used for links to your Collections, i.e. example.com/[collection-slug]/example-collection/. Only alpha-numeric characters and hyphens (-) are allowed.

Post Type

Enable Custom Post Type features.

Supports: Typeselect_multiDefaulttitle
Enable or disable various WordPress features of the Map Custom Post Type.

Debug

Debug Mode: TypebooleanDefault0
With debug mode enabled, the plugin will output Map and Settings data in Admin Dashboard. This may come in handy if you need to report a bug. Pro Tip! Check the browser console for Waymark output when signed in as an administrator.