=== Ultimate Maps by Supsystic – OpenStreetMap & Leaflet Maps, No API Key ===
Contributors: supsysticcom
Tags: map, openstreetmap, leaflet, osm, map markers
Tested up to: 7.1
Requires PHP: 7.3
Stable tag: 1.6.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Interactive OpenStreetMap and Leaflet maps with unlimited markers, categories and clustering. No Google API key and no requests to Google.

== Description ==

**Ultimate Maps by Supsystic** is a WordPress map plugin for interactive OpenStreetMap maps built on Leaflet. Add unlimited maps and markers, describe each place with text, photos and video, group markers into categories with a filter and cluster them when they crowd together. It works out of the box without a Google Maps API key, and your pages make no requests to Google.

Want a different look? Switch the same map to Mapbox, Thunderforest, Bing Maps or your own tile server without rebuilding a single marker.

**Try it in your browser:** [open a live demo in WordPress Playground](https://playground.wordpress.net/?plugin=ultimate-maps-by-supsystic) – no install, no account.

= OpenStreetMap without an API key =

OpenStreetMap tiles load through Leaflet with no key and no account. Pick the style that suits your site:

* OpenStreetMap Standard, Germany and Humanitarian
* OpenTopoMap, CyclOSM and OpenHikingMap for outdoor, cycling and hiking maps
* Public transport and railway maps
* OpenFreeMap vector styles: Positron, Bright, Liberty, Dark and Fiord
* CartoDB Positron

= More map providers =

* Mapbox: streets, outdoors, light, dark and satellite (free access token)
* Thunderforest: OpenCycleMap, outdoors, landscape and transport (free API key)
* Bing Maps: road, aerial, bird's eye and canvas (Bing Maps key)
* MapTiles API (OpenStreetMap) through RapidAPI
* Any custom or self-hosted Leaflet tile server

Change the provider of an existing map at any time. Your markers stay where they are.

= Unlimited maps and markers =

* Markers with text, photos, video, links, phone and e-mail
* Custom marker icons from the built-in library or your own image
* Marker categories with a front-end filter
* Marker clustering for maps with many locations
* Linked markers that open any URL on click
* Address search: type an address and get the pin

= Map settings =

* Width, height, zoom, minimum and maximum zoom
* Scroll-wheel and drag behaviour, navigation bar and zoom controls
* Responsive maps with touch controls
* A starter set of map themes

= Add maps anywhere =

* Gutenberg block, Elementor widget, sidebar widget, shortcode and PHP snippet
* Works with WPBakery, Divi, Beaver Builder and other page builders through the shortcode

= Moving from Google Maps =

Import maps from our Easy Google Maps plugin and keep your markers. Move maps and markers between sites with CSV import and export.

= Privacy =

Ultimate Maps makes no requests to Google. Map tiles load only from the provider you choose for each map.

= Made for =

* Contact page and office location maps
* Businesses with several branches or dealers
* Real estate and rental listings
* Hiking, cycling and travel maps
* Event venues, campuses and city guides

= Ultimate Maps Pro =

Pro adds layers, shapes and richer ways to present your locations:

* Shapes: polygons, polylines and circles with fill and descriptions
* KML layers from a file or URL, and KML points imported as markers
* Heatmap layer
* Table view: a searchable, sortable list of locations
* Horizontal and vertical photo sliders and an exposition slider next to the map
* Visitors can add markers from the front end
* Markers shown only between two dates
* The full collection of map themes

= Learn more =

* [Official plugin page](https://supsystic.com/plugins/ultimate-maps/)
* [Pro features](https://supsystic.com/plugins/ultimate-maps/#pro-features)
* [Pricing](https://supsystic.com/plugins/ultimate-maps/#pricing)
* [Documentation](https://supsystic.com/docs/ultimate-maps-documentation/)

== Installation ==

1. In your dashboard go to Plugins → Add New Plugin and search for "Ultimate Maps by Supsystic".
2. Click Install Now, then Activate.
3. Open the Ultimate Maps menu and add a new map. OpenStreetMap works right away, no key needed.
4. Add markers by typing an address or clicking on the map, then save.
5. Add the map to a page with the block, the Elementor widget or the shortcode.

== Frequently Asked Questions ==

= Do I need an API key? =

No. OpenStreetMap maps through Leaflet work without any key or account. Mapbox, Thunderforest, Bing Maps and MapTiles API need a key from that provider; Mapbox and Thunderforest offer free plans.

= Is it a Google Maps alternative? =

Yes. Ultimate Maps gives you interactive maps with markers, categories and clustering without Google Maps, a Google API key or Google billing.

= Does the plugin send data to Google? =

No. Ultimate Maps makes no requests to Google. Tiles load only from the map provider you select.

= Can I switch the map provider later? =

Yes. Change the provider or style of an existing map at any time, and your markers stay in place.

= How many maps and markers can I add? =

As many as you need. Maps and markers are unlimited in the free plugin.

= Can I use my own marker icons? =

Yes. Choose an icon from the built-in library or upload your own image.

= Can visitors filter markers by category? =

Yes. Assign markers to categories and show a front-end filter on the map.

= Does it support marker clustering? =

Yes. Nearby markers group into clusters that open as visitors zoom in.

= Can I move my maps from Easy Google Maps? =

Yes. Ultimate Maps imports maps from our Easy Google Maps plugin. You can also move maps and markers between sites with CSV import and export.

= How do I add a map to a page or post? =

Use the plugin's block in the block editor, the Elementor widget, the sidebar widget, or paste the map shortcode. A PHP snippet is available for theme templates.

= Can I draw areas or routes on the map? =

Polygons, polylines and circles are available in Pro, along with KML layers and a heatmap.

= Is the plugin translation-ready? =

Yes. The plugin is translation-ready and ships with a German translation.

= How can I report a security issue? =

Please report security issues through the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/9e5fb555-5627-47cf-a701-78547bbb5e53). The Patchstack team validates and triages each report and notifies us.

== Screenshots ==

1. Interactive map with custom markers and marker descriptions.
2. Switch the map provider in one click: OpenStreetMap, Mapbox, Bing Maps or Thunderforest.
3. Map with a list of all markers displayed below it (Pro).
4. Marker clustering on a map with many locations.
5. Map styles and themes.
6. Map settings in the admin area.
7. Marker settings: address, icon, description and category.
8. Shape settings for polygons, lines and circles (Pro).

== Changelog ==

= 2026 =

= 1.6.4 — October 16, 2026 =

* Maintenance release with minor stability improvements.

= 1.6.3 — October 15, 2026 =

* General security hardening and code improvements.

= 1.6.2 — October 9, 2026 =

* Maintenance release with minor stability improvements.

= 1.6.1 — September 29, 2026 =

* Maintenance release with minor stability improvements.

= 1.6.0 / 29.09.2026 =
 * General code improvements and security hardening

= 1.5.5 / 03.09.2026 =
 * Improved the classic WordPress widget with the same map selection fields used by the Elementor widget and Gutenberg block
 * Added a Gutenberg block for selecting and displaying Ultimate Maps without manually inserting a shortcode
 * Added an Elementor widget for selecting and displaying Ultimate Maps without manually inserting a shortcode
 * Fixed Ultimate Maps shortcode rendering inside Elementor and other dynamic page builder contexts

= 1.5.4 / 01.09.2026 =
 * General security hardening
 * Update Leaflet skin list: add OpenFreeMap, CyclOSM and OpenMaps.fr skins; hide CartoDB skins that require an API key

= 1.5.3 / 31.08.2026 =
 * Fix Leaflet marker position when CSS overrides icon margins

= 1.5.2 / 10.08.2026 =
 * General security hardening and code improvements

= 1.5.1 / 10.08.2026 =
 * Server-side validation for the default Maps Engine setting, enforced when it is saved

= 1.5.0 / 10.08.2026 =
 * General security hardening and code improvements

= 1.4.0 / 03.08.2026 =
 * Fixed a data-loss issue where markers or shapes added to a newly created (unsaved) map could be lost after saving
 * Fixed a critical error that could occur when saving markers on a map
 * Improved marker popup close button contrast to meet WCAG 2.1 accessibility guidelines
 * Completed a full PHP 7.4-8.5 compatibility pass across the plugin core and all modules
 * General code cleanup and stability improvements

= 1.3.3 / 28.07.2026 =
 * Minor fixes

= 1.3.2 / 31.05.2026 =
 * Confirmed compatibility with WordPress 7.0

= 1.3.1 / 17.03.2026 =
 * Fixed an issue with Rocket Loader compatibility and long loading times
 * Added new working map styles, including new Leaflet styles

= 1.3.0 / 14.03.2026 =
 * Multiple stability fixes
 * Fixed a Rocket Loader compatibility issue
 * Confirmed compatibility with WordPress 6.9.4

= 2025 =
 * Delivered ongoing compatibility updates for WordPress 6.7-6.8.x and PHP 8.3
 * Fixed a text-domain loading issue and a file-metadata (Zone) edge case
 * General version maintenance

= 2024 =
 * Added security nonce verification and expertise-level field for the ActiveCampaign form
 * Replaced legacy escaping with wp_kses()/esc_attr() throughout the admin area
 * Fixed several "love link" feature issues

= 2023 =
 * Completed a compatibility pass for WordPress 6.2
 * Updated the bundled Leaflet.js library to its latest version and improved overall map stability
 * Fixed a missing source map file issue

= 2022 =
 * Added support for WordPress 6.0/6.1 and PHP 8.1
 * Fixed map tile rendering and removed unsupported map styles

= 2021 =
 * Added support for WordPress 5.7
 * Completed a major security and database-query hardening pass, and removed the bundled Bootstrap dependency
 * Fixed marker category, media description, and "Show All Maps" issues

= 2020 =
 * Added WordPress 5.5 and PHP 7.4 compatibility
 * Fixed a Mapbox rendering issue and removed CDN-hosted files for GDPR compliance
 * Delivered several security fixes

= 2016-2019 =
 * Refined marker list design, clustering, and translation support
 * Fixed numerous rendering and interaction issues across the Leaflet, Bing, and OpenStreetMap engines
 * Added Deutsch translation and general admin-area interface improvements

= 2015 and earlier =
 * Established the plugin's core feature set: KML layers, shapes, marker lists, and multi-engine map support (Bing, Leaflet, OpenStreetMap)
