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.
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 > 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
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
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.
Map Options
Use these options to change how Maps are displayed.
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. |