Settings

Basemaps

Title	Tip	Link
Basemap Name	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	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	Mapping services often have the requirement that attribution is displayed by the map. Text and HTML links are supported.
Basemap Max Zoom	Set a maximum zoom level for this Basemap, the default is 18.

Markers

Title	Tip	Link
Marker Label	What kind of Marker is this? E.g. "Photo", "Grocery Store", "Warning!". Once saved, Marker labels can not 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 > Map > Misc. > Type Labels.
Marker Shape	Which shape of Marker to use. Circles and Squares are centered at the specified location, Markers point down to that location.
Marker Size	Which size of Marker to use.
Marker Background	The Marker background colour. Click "Select Colour" to select.
Marker Show Initially	When using the Overlay Filter you can choose to show/hide certain Types when the Map initially loads.
Marker Submissions?	Make this Type available in front-end Submissions?
IconType	Marker Icons are available from Font Awesome and Ionic Icons, you can also specify your own text, or provide custom HTML.
IconName	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. ✗ as well as Unicode characters), or provide HTML to integrate with other Icon providers.
IconColour	The colour of the icon. Click "Select Colour" to select.

Lines

Title	Tip	Link
Line Label	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 can not be edited.
Line Colour	The colour of the Line. Click "Select Colour" to select.
Line Weight	The width of the Line, in pixels.
Line Show Initially	When using the Overlay Filter you can choose to show/hide certain Types when the Map initially loads.
Line Submissions?	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.

Title	Tip	Link
Shape Label	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 can not be edited.
Shape Colour	The colour of the Shape. Click "Select Colour" to select.
Shape Fill Opacity	The opacity of the inside of the shape, between 0.0 and 1.0 (e.g. "0.5").
Shape Show Initially	When using the Overlay Filter you can choose to show/hide certain Types when the Map initially loads.
Shape Submissions?	Make this Type available in front-end Submissions?

Meta

Title	Tip	Link
Meta Title	The title appears next to the input field.
Meta Default	The default value for the input field. For Select and Multi-Select enter the option/comma-separated options to be selected by default.
Meta Tip	A tip provides additional information about an input field... just like this!
Meta Type	The type of input field to use.
Meta Options	A comma-separated list of options for the input.
Meta Group	Which group this Meta belongs to (if any). Meta in the same group will be displayed together when editing and viewing Maps. Meta not in a group will be displayed above any groups.
Meta In Shortcode?	Whether this content should be displayed when embedding a Map using the Shortcode.
Meta In Submissions?	Make this Meta available in front-end Submissions?

Groups

Create groups to organise your Map Meta. Meta in the same group will be displayed together when editing and viewing Maps.

Title	Tip	Link
Group Title	The title appears above the Meta in that group.

Submissions

Front-End Submissions

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

Title	Tip	Link
Allow Submissions	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.

Title	Tip	Link
Allow From	Users with the selected roles will be able to make Submissions through the front-end
Editor Features	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 > Map > Meta.
Default Status	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	If specified, user submissions will be automatically added to this Collection.

Public Submissions

This will allow Submissions from any visitor, without registration.

Title	Tip	Link
Public Submissions	Allow *anyone* to submit Maps to your site, without registration.
Editor Features	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 > Map > Meta.
Upload Location	Images upload by non-registered users can be stored seperately 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	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	If specified, user submissions will be automatically added to this Collection.

Properties

Properties

Read GeoJSON feature properties when importing.

If Waymark finds data for the property keys below it will be added to the Overlay description when it is imported.

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

Misc.

Title	Tip	Link
Default Centre	Waymark centres the Map automatically when displaying data. These coordinates (Latitude,Longitude) will be used when there is no data available.
Map Height	Specify the desired height of the Map (in pixels). The Map will automatically adjust it’s width to fill the space available to it. Pro Tip! This will affect all Maps, but you can change the height of an individual Map through the shortcode: [Waymark map_id="1234" map_height="640"]
Type Labels	Whether to display the Marker/Line/Shape Type Label in the tooltip and Info Window.
Default Zoom	Waymark zooms the Map automatically when displaying data. This zoom level (0-18) will be used when there is no data available.
Image Gallery	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	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	Enable visitors to download the Overlays (Markers, Lines and Shapes) currently displayed on the Map Details page. An Export option is also displayed in the Details section of the Shortcode Header when embedding a Map or Collection. Can be used in conjunction with the Overlay Filter to select which Overlays to download. GeoJSON, GPX and KML formats supported.
Show Scale	Show a distance scale (km and miles) on the Map.

Interaction Options

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

By default, Waymark disables scroll zoom until the user hovers over the Map for 2 seconds.

Title	Tip	Link
Hover Wake Time	How many seconds before scroll zoom is enabled. 0 seconds will mean no delay (disbling this feature). A large number of seconds like 3600 (an hour) will esentially *disable hover to wake*, meaning the user will need to *click* to wake.
Display Message	This message will be displayed by the Map while scroll zoom is disabled.
Display Message Text

Collection Options

How Collections are displayed.

Title	Tip	Link
Link to Maps	Whether to display a link to the individual Map Details page when clicking on a Marker/Line/Shape displayed by the Collection.
Link from Maps	Whether to display a link to the Collection(s) that a Map belongs to on the Map Details page.

Shortcode Options

How Maps are embedded into your content using the shortcode.

Title	Tip	Link
Shortcode Header	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	Use this Setting to always show the Shortcode Header when signed in as admin, useful for quickly navigating to embeded Maps.

Elevation Options

Lines with elevation data.

Title	Tip	Link
Elevation Profile	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	Display elevation data in metric (m/km) or imperial (ft/mi) units.
Elevation Colour	The colour of the elevation graph and associated Line.
Show Initially?	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.

Editor Options

Customising the Map Editor.

Title	Tip	Link
Confirm Delete?	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	Which Basemap to use as the editor default.
Store Read Files	By default Waymark does not store any files read using the Editor. Using this option you can use the Media Library to store the uploaded GPX/KML/GeoJSON file.

Permalinks

Customise your Map and Collection URLs.

Title	Tip	Link
Map Slug	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	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.

Debug

Title	Tip	Link
Debug Mode	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.