{"id":236339,"date":"2025-06-12T10:33:55","date_gmt":"2025-06-12T10:33:55","guid":{"rendered":"https:\/\/es.wordpress.org\/plugins\/toolset-maps-custom-osm\/"},"modified":"2026-01-22T19:01:57","modified_gmt":"2026-01-22T19:01:57","slug":"advanced-osm-for-toolset-maps","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/advanced-osm-for-toolset-maps\/","author":13276903,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"3.0.1","stable_tag":"3.0.1","tested":"6.9.4","requires":"6.5","requires_php":"7.0","requires_plugins":null,"header_name":"Advanced OSM for Toolset Maps","header_author":"wp-customtypes.com","header_description":"Extends Toolset Maps OpenStreetMap with missing pro features: Satellite view, Marker Cluster, Grayscale styles and Layer controls. Goes beyond basic OSM implementation.","assets_banners_color":"bc856b","last_updated":"2026-01-22 19:01:57","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/wp-customtypes.com\/","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/advanced-osm-for-toolset-maps\/","header_author_uri":"https:\/\/wp-customtypes.com\/","rating":5,"author_block_rating":0,"active_installs":30,"downloads":698,"num_ratings":2,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.2":{"tag":"1.2","author":"umbaumba","date":"2025-06-12 16:13:21"},"1.2.1":{"tag":"1.2.1","author":"umbaumba","date":"2025-06-12 16:13:21"},"2.0.0":{"tag":"2.0.0","author":"umbaumba","date":"2026-01-12 20:04:10"},"3.0.0":{"tag":"3.0.0","author":"umbaumba","date":"2026-01-22 16:03:01"},"3.0.1":{"tag":"3.0.1","author":"umbaumba","date":"2026-01-22 19:01:57"}},"upgrade_notice":{"3.0.1":"<p>Maintenance update: This version fixes the &quot;Dismiss&quot; button in the admin notification area.<\/p>","3.0.0":"<p>MAJOR UPDATE: Full Gutenberg Block support! You can now configure your maps and tracks visually without using shortcodes. Includes improved media handling for KML\/GPX files.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":2},"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3310426,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3310426,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":{"aotm\/advanced-osm-map":{"name":"aotm\/advanced-osm-map","title":"Advanced OSM Map"},"aotm\/advanced-osm-marker":{"name":"aotm\/advanced-osm-marker","title":"Advanced OSM Map Track"}},"tagged_versions":["1.2","1.2.1","2.0.0","3.0.0","3.0.1"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3310507,"resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3310507,"resolution":"2","location":"assets","locale":""},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":3310507,"resolution":"3","location":"assets","locale":""},"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":3438115,"resolution":"4","location":"assets","locale":""},"screenshot-5.jpg":{"filename":"screenshot-5.jpg","revision":3438115,"resolution":"5","location":"assets","locale":""},"screenshot-6.jpg":{"filename":"screenshot-6.jpg","revision":3444991,"resolution":"6","location":"assets","locale":""}},"screenshots":{"1":"Default OpenStreetMap view with Satellite button","2":"Satellite + Roads + Labels overlay","3":"Grayscale effect with colored clustered markers","4":"GPX and KML track displayed on a Toolset Map via URL.","5":"GPX and KML track displayed on a Toolset Map via Custom Fields.","6":"New Gutenberg Block with sidebar configuration."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[5327,2660,16164,243558,53370],"plugin_category":[49],"plugin_contributors":[243559],"plugin_business_model":[],"class_list":["post-236339","plugin","type-plugin","status-publish","hentry","plugin_tags-kml","plugin_tags-maps","plugin_tags-openstreetmap","plugin_tags-satellite-view","plugin_tags-toolset","plugin_category-maps-and-location","plugin_contributors-umbaumba","plugin_committers-umbaumba"],"banners":{"banner":"https:\/\/ps.w.org\/advanced-osm-for-toolset-maps\/assets\/banner-772x250.png?rev=3310426","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/advanced-osm-for-toolset-maps\/assets\/icon-256x256.png?rev=3310426","icon_2x":"https:\/\/ps.w.org\/advanced-osm-for-toolset-maps\/assets\/icon-256x256.png?rev=3310426","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/advanced-osm-for-toolset-maps\/assets\/screenshot-1.jpg?rev=3310507","caption":"Default OpenStreetMap view with Satellite button"},{"src":"https:\/\/ps.w.org\/advanced-osm-for-toolset-maps\/assets\/screenshot-2.jpg?rev=3310507","caption":"Satellite + Roads + Labels overlay"},{"src":"https:\/\/ps.w.org\/advanced-osm-for-toolset-maps\/assets\/screenshot-3.jpg?rev=3310507","caption":"Grayscale effect with colored clustered markers"},{"src":"https:\/\/ps.w.org\/advanced-osm-for-toolset-maps\/assets\/screenshot-4.jpg?rev=3438115","caption":"GPX and KML track displayed on a Toolset Map via URL."},{"src":"https:\/\/ps.w.org\/advanced-osm-for-toolset-maps\/assets\/screenshot-5.jpg?rev=3438115","caption":"GPX and KML track displayed on a Toolset Map via Custom Fields."},{"src":"https:\/\/ps.w.org\/advanced-osm-for-toolset-maps\/assets\/screenshot-6.jpg?rev=3444991","caption":"New Gutenberg Block with sidebar configuration."}],"raw_content":"<!--section=description-->\n<p><strong>Supercharge Toolset Maps with professional OpenStreetMap features that go beyond the basic core implementation.<\/strong><\/p>\n\n<p>While Toolset Maps provides a foundation for OSM, this plugin enhances the experience with advanced visualization and data tools, now fully integrated with the WordPress Block Editor.<\/p>\n\n<h3>\ud83e\uddf1 NEW: Gutenberg Blocks<\/h3>\n\n<p>Forget about complex shortcodes. Version 3.0 introduces native blocks:\n* <strong>Advanced OSM Map Block:<\/strong> Configure satellite views, clustering, and tracks visually in the sidebar.\n* <strong>Dynamic Track Loader Block:<\/strong> Easily link Toolset File Fields (KML\/GPX) to your maps within Query Loops or Content Templates.<\/p>\n\n<h3>\ud83d\udef0\ufe0f Satellite View<\/h3>\n\n<p>High-resolution Esri satellite imagery not available in native Toolset. Includes an interactive toggle button for front-end users.<\/p>\n\n<h3>\ud83d\udd35 Pro Clustering<\/h3>\n\n<p>While Toolset offers basic clustering, AOTM gives you more control. Customize the cluster color to match your brand and set precise zoom thresholds for declustering.<\/p>\n\n<h3>\ud83d\udccd KML &amp; GPX Support<\/h3>\n\n<p>Visualize tracks, routes, or shapes. Load files in three ways:\n1.  <strong>Media Library:<\/strong> Select multiple files directly from your WordPress media.\n2.  <strong>Direct URLs:<\/strong> Paste manual KML\/GPX links.\n3.  <strong>Dynamic Fields:<\/strong> Use a Toolset File Field slug to pull tracks from your custom posts.<\/p>\n\n<h3>\ud83c\udfa8 Custom Styling &amp; Layers<\/h3>\n\n<ul>\n<li><strong>Grayscale Mode:<\/strong> Apply \"silver\" or \"muted\" styles with precise intensity control.<\/li>\n<li><strong>Layer Management:<\/strong> Toggle roads and labels independently for a cleaner, professional design.<\/li>\n<\/ul>\n\n<p>Check <a href=\"https:\/\/wp-customtypes.com\/advanced-osm-for-toolset-maps\/\">DEMOS<\/a>\nCheck author page <a href=\"https:\/\/wp-customtypes.com\/\">wp-customtypes.com<\/a><\/p>\n\n<h3>Feature Comparison<\/h3>\n\n<p><strong>Satellite View<\/strong><br \/>\nToolset Maps \u274c No\nAdvanced OSM \u2705 1-click<\/p>\n\n<p><strong>Marker Clustering<\/strong> \nToolset Maps \u26a0\ufe0f Basic only\nAdvanced OSM \u2705 Customizable<\/p>\n\n<p><strong>Grayscale Effects<\/strong>\nToolset Maps \u274c No\nAdvanced OSM \u2705 0-100% control<\/p>\n\n<p><strong>Layer Toggles<\/strong>\nToolset Maps \u274c All or none\nAdvanced OSM \u2705 Roads\/Labels separate<\/p>\n\n<p><strong>Zoom Control<\/strong>\nToolset Maps \u274c Basic\nAdvanced OSM \u2705 Precise levels<\/p>\n\n<p><strong>KML\/GPX Support<\/strong>\nToolset Maps \u274c No\nAdvanced OSM \u2705 Yes (Shapes &amp; Tracks)<\/p>\n\n<h3>Shortcode Examples<\/h3>\n\n<p><strong>Basic OpenStreetMap<\/strong>\n[aotm-advanced-osm-map map-id=\"map-1\"]\n[wpv-map-render map_id=\"map-1\"][\/wpv-map-render]<\/p>\n\n<p><strong>Satellite View with Layers<\/strong>\n[aotm-advanced-osm-map map-id=\"map-2\" satellite=\"on\" labels=\"on\" roads=\"on\"]\n[wpv-map-render map_id=\"map-2\"][\/wpv-map-render]<\/p>\n\n<p><strong>Professional Styling<\/strong>\n[aotm-advanced-osm-map map-id=\"map-3\" grayscale=\"0.9\" cluster=\"on\" cluster-color=\"#f05a28\"]\n[wpv-map-render map_id=\"map-3\"][\/wpv-map-render]<\/p>\n\n<p>**Dynamic Tracks in a View or Single Post via URL **\nInside any Post or Page:\n[aotm-advanced-osm-map map-id=\"map-4\" track-field=\"https:\/\/my-domain.com\/wp-content\/uploads\/my-track.gpx,https:\/\/my-domain.com\/wp-content\/uploads\/my-shape.kml\"]\n[wpv-map-render map_id=\"map-4\"][\/wpv-map-render]<\/p>\n\n<p><strong>Dynamic Tracks in a View or Single Post via Custom field<\/strong>\nInside your Toolset View loop or Content Template:\n[aotm-advanced-osm-map map-id=\"map-5\"]\n[wpv-map-render map_id=\"map-5\"][\/wpv-map-render]<\/p>\n\n<p>[aotm-advanced-osm-marker map-id=\"map-4\" track-field=\"track-file-slug\"]<\/p>\n\n<h3>Full Shortcode Reference<\/h3>\n\n<h4>[aotm-advanced-osm-map]<\/h4>\n\n<ul>\n<li>map-id: (Required) Must match your Toolset map ID.<\/li>\n<li>satellite: \"on\" \u2013 Set satellite as default base layer.<\/li>\n<li>satellite-button: \"off\" \u2013 Hide Satellite toggle button (default on).<\/li>\n<li>cluster: \"on\" \u2013 Enable custom marker clustering.<\/li>\n<li>cluster-color: Hex color (e.g., #ff5500) - Change the cluster icon color.<\/li>\n<li>zoom-cluster: 0-18 - Zoom level where clustering turns off (default 12).<\/li>\n<li>track-url: Direct URL to a .kml or .gpx file. Supports multiple URLs separated by commas.<\/li>\n<li>track-field: Slug of the Toolset custom field containing KML\/GPX URLs (for global tracks).<\/li>\n<li>grayscale: 0.1-1 \u2013 Grayscale intensity (default 0).<\/li>\n<li>labels\/roads: \"on\" \u2013 Show extra overlays.<\/li>\n<\/ul>\n\n<h4>[aotm-advanced-osm-marker]<\/h4>\n\n<ul>\n<li>map-id: (Required) Must match your Toolset map ID.<\/li>\n<li>track-field: (Required) Slug of the Toolset File Field (KML or GPX).<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to <code>\/wp-content\/plugins\/advanced-osm-for-toolset-maps\/<\/code><\/li>\n<li>Activate the plugin through WordPress admin.<\/li>\n<li><strong>Using Blocks:<\/strong> Search for \"Advanced OSM\" in the Gutenberg editor.<\/li>\n<li><strong>Using Shortcodes:<\/strong> Use <code>[aotm-advanced-osm-map]<\/code> to configure the map settings.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20work%20with%20the%20new%20toolset%20map%20block%3F\"><h3>Does this work with the new Toolset Map block?<\/h3><\/dt>\n<dd><p>Yes! This plugin is designed to extend the maps rendered by Toolset, whether you use Toolset Blocks or the classic View integration.<\/p><\/dd>\n<dt id=\"how%20is%20this%20different%20from%20native%20toolset%20maps%3F\"><h3>How is this different from native Toolset Maps?<\/h3><\/dt>\n<dd><p>Toolset provides basic OSM functionality. Our plugin adds the \"Pro\" layer:\n- Satellite imagery with interactive toggle button.\n- Customizable cluster markers (change colors and behavior).\n- KML\/GPX file support for displaying tracks and shapes (via URL or Custom Fields).\n- Precise grayscale styling.\n- Independent layer controls (roads\/labels).<\/p><\/dd>\n<dt id=\"do%20i%20need%20to%20know%20how%20to%20code%3F\"><h3>Do I need to know how to code?<\/h3><\/dt>\n<dd><p>Not anymore. With version 3.0, you can configure everything via the Block Editor sidebar.<\/p><\/dd>\n<dt id=\"does%20this%20replace%20toolset%20maps%3F\"><h3>Does this replace Toolset Maps?<\/h3><\/dt>\n<dd><p>No, it enhances it. You still need Toolset Maps installed and active.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>3.0.1<\/h4>\n\n<ul>\n<li>Fixed: Admin rating notice dismissal logic to correctly save user preference.<\/li>\n<li>Improved: Internal admin hooks for better performance.<\/li>\n<\/ul>\n\n<h4>3.0.0<\/h4>\n\n<ul>\n<li>NEW: Native Gutenberg Blocks support.<\/li>\n<li>NEW: Multiple file selection for KML\/GPX from Media Library.<\/li>\n<li>NEW: Visual list management for tracks in the editor.<\/li>\n<li>Optimized: Cleaned up debug logs and internal logic for production.<\/li>\n<\/ul>\n\n<h4>2.1.0<\/h4>\n\n<ul>\n<li>Added support for KML and GPX tracks via Toolset File Fields.<\/li>\n<li>Added support for loading tracks directly via URL using the <code>track-url<\/code> attribute.<\/li>\n<li>New shortcode [aotm-advanced-osm-marker] for dynamic track loading.<\/li>\n<li>Fixed Marker Clustering: Custom brand color for clusters.<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Minor fixes and prefix updates.<\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Extends Toolset Maps with professional OpenStreetMap features: Gutenberg Blocks, Satellite view, Custom Clustering, and KML\/GPX tracks integration.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/236339","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=236339"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/umbaumba"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=236339"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=236339"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=236339"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=236339"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=236339"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=236339"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}