Settings
This tab contains main options and those groups of options that didn't get their own screen.
Main settings​
| Field | Description |
|---|---|
| File | Name of the SVG file. If you use a custom SVG file and need to upload a new version - go to MapSVG start screen and click on Upload SVG file button on the MapSVG start screen. If you keep the filename the same as previously, then existing SVG file will be automatically overwritten. Then to go Map editor > Settings > File > click on "Reload" button to reload the list of Regions. Also, you can change the file by clicking on "Change", or remove the file by clicking on "Remove". |
| Title | The title is used only internally in MapSVG editor. |
| Preloader text | The text that is shown when the map loads. |
Size​
| Field | Description |
|---|---|
| Responsive | When the map is responsive, it always takes the full width of the parent container. |
| Width / Height | If Responsive is "Off" then changing width/height changes the actual size of the map, but the size doesn't change in the preview - changes are visible only on the front-end. When "Responsive" is "On" - the map always takes the full width of the parent container and width/height options change only map proportions, the width/height ratio. |
| Lock aspect ratio | When it's "On" width/height ratio is preserved while you change width or height. Example: if your map is 640x480, "Lock aspect ratio" is "On", and you change the width to "320", the height is automatically adjusted to "240". |
Position​
| Field | Description |
|---|---|
| Start position | This option lets you to change the initial zoom & scroll position of the map.If you need to change the initial position: turn on zoom & scroll, zoom-in to the desired location, click Set current position as initial. |
| Fit markers | Choose if you want the map to change its position to fit all loaded markers |
Containers​
MapSVG has 4 containers that can be used for showing the Directory, Filters and Details view. In this settings section you can choose which containers you want to show and set their size.
Scroll​
| Field | Description |
|---|---|
| Scroll | Choose if you want to allow to scroll the map with the mouse pointer (or fingers on touch-devices). |
| Limit scroll to boundaries | Prevent scrolling past the map boundaries. Works only with SVG maps, doesn't work with Google Maps. |
Zoom​
MapSVG supports zoom by clicking +/- buttons, zoom by mousewheel and zoom by pinch on touch-devices.
| Field | Description |
|---|---|
| Zoom | Turn zoom on/off |
| Zoom by mousewheel | If your map takes the full width of the screen then you may want to turn this option off because otherwise users will not be able to scroll down past your map - when they reach it, scrolling the mouse wheel will zoom the map, not the page. If you set this option "On" there should be enough space around the map for the mouse pointer to scroll the page. |
| Zoom buttons | Choose zoom buttons location or turn them off. |
| Zoom limits | How many +/- zoom steps you want to provide, counting from the initial map position. |
Tooltips​
Tooltips are shown on mouse hover over a Region or Marker. Tooltips contain HTML content with your custom fields.
| Field | Description |
|---|---|
| Tooltips | Turn tooltips on/off |
| Tooltip position | Choose tooltip position relative to the mouse pointer. |
Popovers​
Popovers are scrollable pop-ups that are shown on click on a Region or Marker. Popovers contain HTML content with your custom fields.
| Field | Description |
|---|---|
| Width | With of popovers in pixels. |
| Max-Width | Maximum width relative to the map container. |
| Max-height | Maximum height relative to the map container. |
| Center map on popovers | Popovers are always shown over the center of a clicked object. If popover is shown at the edge of the map, its content may get cut off. To prevent that, turn this option "On". |
| Reset map position on popover close | If "Center map on popovers is on" - choose if you want to reset the map position when popover is closed. |
| Fullscreen on mobile devices | Popovers on mobile devices may be too small for comfortable reading. This options helps to solve that isse. |
Choropleth​
Choropleth map is a map that shows some kind of statistical data on the map with different shades of a color. For example, you want to show number of votes by each US state. Then you add a custom field "votes" to your regions, add numbers to each state and then turn on Choropleth map. States with the highest number of votes become painted red, states with the lowest numbers become black, all states between get colors from a gradient between red and black.
Detailed tutorial with screenshots: /tutorials/choropleth-map
Colors for the Choropleth map can be changed in the Menu > Colors tab.
| Field | Description |
|---|---|
| Choropleth | on/off |
| Region field | Choose a custom Region field that contains numbers that should be converted to colors. |
| Gradient labels | Enter labels for "lowest" and "highest" values. |
Pagination​
When DB Objecst are loaded to the map and Directory they are split into pages. Default number is 30 items per page. You can change this number or turn off pagination entirely.
| Field | Description |
|---|---|
| Pagination | On/Off: Choose if you want to split the list of objects in the directory and on the map into pages (even if you don't use the directory, markers can be paginated too). |
| Location | Choose the location of pagination buttons: Directory (at the bottom of the list), map container, both. |
| Items per page | How many items to load for each page. |
| Next page label | When pagination is shown, there are 2 buttons: "Next page" and "Prev. page". You can change these labels (translate to your language) |
| Prev. page label | Same as above |
Labels​
You can use these 2 options to add labels above Markers (for example, to show city names) or in center of Regions (to show country/state names). What is shown in the labels can be defined in the following 2 templates: Marker label template and Region label template
| Field | Description |
|---|---|
| Marker labels | On/Off |
| Regions labels | On/Off |
Buttons​
If you use Directory, on mobile devices 2 buttons are shown below the map: Map / List. You can change the texts of those buttons.
| Field | Description |
|---|---|
| "Map" button label | Enter your text |
| "Map" button label | Enter your text |
| "Close" button label | This button is shown at the bottom of fullscreen Details view / Popovers / Modal Filters windows. |