=== Advanced OSM for Toolset Maps ===
Contributors: umbaumba
Donate link: https://wp-customtypes.com/
Tags: toolset, maps, openstreetmap, marker cluster, satellite view
Requires at least: 6.5
Tested up to: 6.8
Stable tag: 1.2.1
Requires PHP: 7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Extends Toolset Maps with advanced OpenStreetMap features not available in the native plugin.

== Description ==

**Supercharge Toolset Maps with professional OpenStreetMap features that are missing in the core plugin.**

While Toolset Maps now supports OpenStreetMap, it lacks advanced visualization options. This plugin fills the gap by adding:

🛰️ **Satellite View** - Not available in Toolset. Enable with one shortcode attribute.

🔵 **Smart Clustering** - Automatic marker clustering that Toolset doesn't offer.

🎨 **Custom Styling** - Grayscale (silver style) effects with intensity control.

🛣️ **Layer Management** - Toggle roads and labels independently - impossible with basic Toolset.


Check [DEMOS](https://wp-customtypes.com/advanced-osm-for-toolset-maps/)

Check author page [wp-customtypes.com](https://wp-customtypes.com/)

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/advanced-osm-for-toolset-maps/`
2. Activate the plugin through WordPress admin
3. Use the [aotm-advanced-osm-map] shortcode with your Toolset map

== Frequently Asked Questions ==

= How is this different from native Toolset Maps? =
Toolset only provides basic OSM maps. Our plugin adds:
- Satellite imagery with toggle button
- Marker clustering
- Color effects (grayscale)
- Layer controls (roads/labels)
- Advanced zoom management

= Does this replace Toolset Maps? =
No, it enhances it. You still need Toolset Maps installed.

== Screenshots ==
1. Default OpenStreetMap view
2. Satellite + Roads + Labels overlay
3. Grayscale effect with clustered markers

== Changelog ==

= 1.2.1 =
* Minor fixes

= 1.2 =
* Initial release with complete feature set
* Updated all function prefixes to 'aotm' for better compatibility
* Changed shortcode to [aotm-advanced-osm-map]

== Upgrade Notice ==

= 1.2.1 =
* Minor fixes

= 1.2 =
* Initial release - requires Toolset Maps to be installed

== Shortcode Examples ==

**Basic OpenStreetMap**
[aotm-advanced-osm-map map-id="map-1"]
[wpv-map-render map_id="map-1"][/wpv-map-render]

**Satellite View with Layers**
[aotm-advanced-osm-map map-id="map-2" satellite="on" labels="on" roads="on"]
[wpv-map-render map_id="map-2"][/wpv-map-render]

**Professional Styling**
[aotm-advanced-osm-map map-id="map-3" grayscale="0.9" cluster="on" cluster-color="#f05a28"]
[wpv-map-render map_id="map-3"][/wpv-map-render]

== Feature Comparison ==

**Satellite View**        
Toolset Maps ❌ No
Advanced OSM ✅ 1-click

**Marker Clustering** 
Toolset Maps ❌ No
Advanced OSM ✅ Customizable

**Grayscale Effects**
Toolset Maps ❌ No
Advanced OSM ✅ 0-100% control

**Layer Toggles**
Toolset Maps ❌ All or none
Advanced OSM ✅ Roads/Labels separate

**Zoom Control**
Toolset Maps ❌ Basic
Advanced OSM ✅ Precise levels |

== Full Shortcode Reference ==

* map-id: (Required) Must match your Toolset map ID
* satellite: "on" – Toggle satellite base layer (default off)
* satellite-button: "off" – Hide Satellite toggle button (default on)
* cluster: "on" – Enable marker clustering (default off)
* cluster-color: Hex color - Set clusters icon color (default #ff5b00)
* zoom-level: 0-14 - Initial zoom level (default auto)
* zoom-cluster: 0-14 - Zoom level where clustering disables (default 12)
* labels: "on" – Show labels overlay (default off)
* roads: "on" – Show roads overlay (default off)
* grayscale: 0.1-1 – Grayscale intensity (default 0)