Skip to content Skip to main navigation Skip to footer

Settings

Basemaps

Basemaps

Waymark uses the excellent OpenStreetMap as it’s default Basemap and allows integration for services that support tiled web maps.

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.

Pro Tip! If you have more than one Basemap, you can switch between them when viewing the Map. The first listed will be used as the default, unless specified in the shortcode like this: [Waymark map_id="1234" basemap="Basemap Name"]. Drag to re-order, remove all to restore defaults.

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.

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.

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 > Misc. > Map Options > 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

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.

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

Meta

Create additional input fields that appear underneath the Map Editor. Any Meta that has been input is displayed on the Map Details page, and can also be displayed by the Shortcode.

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

This feature is currently being tested and is only available in the development release. This software is not ready for production. Feedback greatly appreciated 🙂

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 > Meta.
Post 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.
Email Alert Receive email alerts for new submissions.

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 > 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.
Post 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.
Email Alert Receive email alerts for new submissions.

Misc.

Map Options

Use these options to change how Maps are displayed.

Title Tip Link
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 Centre Waymark centres the Map automatically when displaying data. These coordinates (Latitude,Longitude) will be used when there is no data available.
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. Can be used in conjunction with the Overlay Filter to select which Overlays to download. GeoJSON, GPX and KML formats supported.

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.

Advanced

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.
0 Comments

There are no comments yet

Leave a comment

Submitting as Guest, your email address will not be published.
Login | Register.