GPX files with named waypoints can now be imported as Map Marker blocks in one click from the Map GPX block editor.<\/p>","1.6.0":"
First official release on the WordPress.org plugin directory.<\/p>","1.5.8":"
Adds source repository link to the plugin Description and prepends a source comment to all compiled JavaScript files to address WordPress.org review guidelines.<\/p>","1.5.7":"
Adds an elevation chart indicator that syncs with GPX track hover \u2014 hover over the track on the map to see your position and elevation on the chart.<\/p>","1.5.6":"
Addresses remaining WordPress.org review scanner issues: reformatted external services section with explicit Privacy Policy URLs for every service, separated third-party libraries, and added source code link in Description.<\/p>","1.5.5":"
Addresses WordPress.org plugin review feedback: enqueues settings JS properly, documents source code location, and adds explicit service URLs and terms\/privacy links for all external services.<\/p>","1.5.2":"
Addresses WordPress.org plugin review feedback: removes CDN dependency, updates block apiVersion to 3, and expands external service documentation.<\/p>","1.5.1":"
Fixes abrupt zoom jumps when scrolling between markers with different zoom levels in follow mode, and resolves a JS error in the elevation profile.<\/p>","1.5.0":"
New settings page! Configure additional map providers (Mapbox, Thunderforest, JawgMaps, Stadia Maps) under Settings > Mapthread. Toggle free layers and choose from dozens of map styles.<\/p>","1.3.9":"
GPX files with routes (not just tracks) are now supported.<\/p>","1.3.8":"
Paste coordinates directly from Google Maps or Gaia GPS into a single field \u2014 no more splitting lat\/lng manually.<\/p>","1.3.7":"
Elevation gain\/loss readings are now much more accurate \u2014 fixes overcounting on noisy GPS data.<\/p>","1.3.6":"
Hiding the map on desktop now expands the article to full width \u2014 the restore tile floats in the corner without reserving space.<\/p>","1.3.5":"
Scroll the page without accidentally zooming the map \u2014 use Ctrl (or \u2318 on macOS) + scroll to zoom.<\/p>","1.3.4":"
New map dismiss button \u2014 collapse the map to a small tile and expand it again with one tap.<\/p>","1.3.3":"
Smoother map following \u2014 camera now completes its animation after scrolling stops.<\/p>","1.3.2":"
Bug fix for track drift when other map plugins are active on the same page.<\/p>","1.3.1":"
Bug fix for track alignment when other map plugins are active on the same page.<\/p>","1.3.0":"
New map viewing options! Switch between Street, Satellite, and Topographic map styles. Fullscreen mode for immersive viewing.<\/p>","1.2.0":"
Major update with elevation profiles, emoji markers, and UI improvements. All third-party services properly attributed.<\/p>","1.1.0":"
Adds address search and markers-only mode for enhanced flexibility.<\/p>","1.0.0":"
Initial release of Mapthread.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3467716,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3467716,"resolution":"256x256","location":"assets","locale":""},"icon.svg":{"filename":"icon.svg","revision":3467716,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3467716,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3467716,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":{"mapthread\/map-marker":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"mapthread\/map-marker","version":"0.1.0","title":"Map Marker","category":"media","icon":"location","description":"Mark a location on the map that corresponds to this point in your story.","keywords":["map","marker","waypoint","location","mapthread"],"textdomain":"mapthread","attributes":{"id":{"type":"string","default":""},"title":{"type":"string","default":""},"lat":{"type":"number","default":0},"lng":{"type":"number","default":0},"address":{"type":"string","default":""},"zoom":{"type":"integer","default":14},"emoji":{"type":"string","default":""}},"supports":{"html":false,"align":false,"customClassName":false},"editorScript":"file:..\/..\/..\/build\/blocks\/map-marker\/index.js","style":"file:..\/..\/..\/build\/blocks\/map-marker\/style-style.css"},"mapthread\/map-gpx":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"mapthread\/map-gpx","version":"0.1.0","title":"Map GPX","category":"media","icon":"location-alt","description":"Upload and display a GPX track on an interactive map.","keywords":["map","gpx","track","route","mapthread"],"textdomain":"mapthread","attributes":{"attachmentId":{"type":"integer","default":0},"fileName":{"type":"string","default":""},"gpxUrl":{"type":"string","default":""},"pointCount":{"type":"integer","default":0},"bounds":{"type":"object","default":{"north":0,"south":0,"east":0,"west":0}},"showProgressIndicator":{"type":"boolean","default":true},"showElevationProfile":{"type":"boolean","default":true},"defaultMapLayer":{"type":"string","default":"Street"},"allowGpxDownload":{"type":"boolean","default":false}},"supports":{"html":false,"align":false,"customClassName":false},"editorScript":"file:..\/..\/..\/build\/blocks\/map-gpx\/index.js","style":"file:..\/..\/..\/build\/blocks\/map-gpx\/style-style.css","render":"file:.\/render.php"}},"tagged_versions":["1.6.0","1.6.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3467716,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3467716,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3467716,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3467716,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3467716,"resolution":"5","location":"assets","locale":""},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3467716,"resolution":"6","location":"assets","locale":""}},"screenshots":{"1":"Editor view - Map GPX block settings","2":"Editor view - Map Marker block settings","3":"Map desktop layout - Story on left, sticky map on right","4":"Map desktop layout - Additional map styles","5":"Mapthread settings - API keys for additional map providers","6":"Map mobile layout - Sticky map at top (hidden by default)"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[10682,16150,2909,10346,249],"plugin_category":[39,49],"plugin_contributors":[256450],"plugin_business_model":[],"class_list":["post-283303","plugin","type-plugin","status-publish","hentry","plugin_tags-gpx","plugin_tags-hiking","plugin_tags-map","plugin_tags-route","plugin_tags-travel","plugin_category-business","plugin_category-maps-and-location","plugin_contributors-randomwire","plugin_committers-randomwire"],"banners":{"banner":"https:\/\/ps.w.org\/mapthread\/assets\/banner-772x250.png?rev=3467716","banner_2x":"https:\/\/ps.w.org\/mapthread\/assets\/banner-1544x500.png?rev=3467716","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/mapthread\/assets\/icon.svg?rev=3467716","icon":"https:\/\/ps.w.org\/mapthread\/assets\/icon.svg?rev=3467716","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/mapthread\/assets\/screenshot-1.png?rev=3467716","caption":"Editor view - Map GPX block settings"},{"src":"https:\/\/ps.w.org\/mapthread\/assets\/screenshot-2.png?rev=3467716","caption":"Editor view - Map Marker block settings"},{"src":"https:\/\/ps.w.org\/mapthread\/assets\/screenshot-3.png?rev=3467716","caption":"Map desktop layout - Story on left, sticky map on right"},{"src":"https:\/\/ps.w.org\/mapthread\/assets\/screenshot-4.png?rev=3467716","caption":"Map desktop layout - Additional map styles"},{"src":"https:\/\/ps.w.org\/mapthread\/assets\/screenshot-5.png?rev=3467716","caption":"Mapthread settings - API keys for additional map providers"},{"src":"https:\/\/ps.w.org\/mapthread\/assets\/screenshot-6.png?rev=3467716","caption":"Map mobile layout - Sticky map at top (hidden by default)"}],"raw_content":"\n
Mapthread<\/strong> brings your adventures to life with interactive, auto-following maps.<\/p>\n\n Perfect for travel bloggers, hiking enthusiasts, and anyone who wants to tell location-based stories that engage readers.<\/p>\n\n https:\/\/www.youtube.com\/watch?v=LBp_favwZVs<\/p>\n\n Mapthread includes three free map styles out of the box (Street, Satellite, Topographic). You can also connect additional tile providers with an API key for more map styles: Mapbox<\/strong>, Thunderforest<\/strong>, JawgMaps<\/strong>, Stadia Maps<\/strong>.<\/p>\n\n GPX (GPS Exchange Format) is a standard file format for GPS data. Most hiking apps, fitness trackers, and GPS devices can export GPX files.<\/p><\/dd>\n You can export GPX files from:\n* Hiking apps (Gaia GPS, AllTrails, etc.)\n* Fitness apps (Strava, Garmin Connect, etc.)\n* GPS devices (Garmin, Suunto, etc.)\n* Google Maps (via Google My Maps)<\/p><\/dd>\n Not currently. Only the first Map GPX block per post is used.<\/p><\/dd>\n Yes, if your GPX file contains named waypoints ( Mapthread is designed for block themes. It has not been tested with classic themes.<\/p><\/dd>\n We recommend GPX files under 10MB. Larger files will show a warning and may be slow to render.<\/p><\/dd>\n Not currently. But you can set emojis for each Marker instead of the default.<\/p><\/dd>\n Go to Settings > Mapthread and enter your API key for any supported provider (Mapbox, Thunderforest, JawgMaps, Stadia Maps). Then select which styles to enable. Each provider offers free tiers suitable for most blogs.<\/p><\/dd>\n The tile provider API keys used by Mapthread are publishable tokens designed for client-side use. Security is handled via domain restrictions configured in each provider's dashboard.<\/p><\/dd>\n No, Mapthread requires an internet connection to load map tiles.<\/p><\/dd>\n Post in the plugin support forum<\/a> or open an issue on GitHub<\/a><\/p><\/dd>\n Yes! Mapthread is open source \u2014 contributions are welcome at github.com\/randomwire\/Mapthread<\/a><\/p><\/dd>\n Yes. Mapthread connects to third-party services to display map tiles, geocode addresses, and look up elevation data. Below is a full description of each service, what data is sent, and when.<\/p>\n\n OpenStreetMap Tile Service<\/strong>\nUsed for: Rendering the default \"Street\" map layer.\nWhen: Every time a visitor views a page containing a Mapthread map, the browser requests tile images from OpenStreetMap servers.\nData sent: Tile coordinate requests (zoom level, x\/y tile numbers) indicating the geographic area being viewed. The visitor's IP address is visible to OpenStreetMap servers.\nTerms of Use<\/a> | Privacy Policy<\/a> | Tile Usage Policy<\/a><\/p>\n\n Esri \/ ArcGIS World Imagery<\/strong>\nUsed for: Rendering the optional \"Satellite\" map layer.\nWhen: Only when the Satellite layer is enabled in Settings > Mapthread and a visitor selects it. No requests are made if the layer is disabled.\nData sent: Tile coordinate requests and the visitor's IP address.\nTerms of Use<\/a> | Privacy Policy<\/a><\/p>\n\n OpenTopoMap<\/strong>\nUsed for: Rendering the optional \"Topographic\" map layer.\nWhen: Only when the Topographic layer is enabled in Settings > Mapthread and a visitor selects it.\nData sent: Tile coordinate requests and the visitor's IP address.\nTerms of Use \/ Privacy Policy<\/a><\/p>\n\n Nominatim (OpenStreetMap Geocoding)<\/strong>\nUsed for: Address search autocomplete when editing a Map Marker block.\nWhen: Only in the WordPress block editor when an author types into the address search field. Not triggered on the public frontend.\nData sent: The search query text (partial address or place name) and the editor's IP address.\nUsage Policy<\/a> | Privacy Policy<\/a><\/p>\n\n Open-Elevation API<\/strong>\nUsed for: Looking up elevation data for GPX tracks that lack elevation information.\nWhen: Server-side only \u2014 when a GPX file is uploaded that has no elevation data and the elevation profile feature is enabled. The request is made from the WordPress server to api.open-elevation.com<\/a>, not from the visitor's browser.\nData sent: GPS coordinates (latitude\/longitude pairs) sampled from the GPX track, sent from the WordPress server's IP address. No user accounts or personal data involved.\nService<\/a> | Source<\/a> | License (GPL-2.0)<\/a><\/p>\n\n Optional Tile Providers<\/strong> (each requires an API key configured in Settings > Mapthread)<\/p>\n\n The following services are only contacted when a site administrator has entered an API key and a visitor selects the corresponding map layer. In each case the browser sends tile coordinate requests, the configured API key\/token, and the visitor's IP address.<\/p>\n\nStorytelling<\/h4>\n\n
\n
Maps<\/h4>\n\n
\n
Markers<\/h4>\n\n
\n
Layout<\/h4>\n\n
\n
Perfect For<\/h4>\n\n
\n
How It Works<\/h4>\n\n
\n
Examples<\/h4>\n\n
\n
Compatibility<\/h4>\n\n
\n
Configuring Additional Map Providers (Optional)<\/h3>\n\n
\n
\n
What is a GPX file?<\/h3><\/dt>\n
Where do I get GPX files?<\/h3><\/dt>\n
Can I use multiple GPX files in one post?<\/h3><\/dt>\n
How do I get coordinates for markers?<\/h3><\/dt>\n
\n
Can I import waypoints from my GPX file?<\/h3><\/dt>\n
<wpt><\/code> elements with a <name><\/code> tag). After uploading your GPX file, the Map GPX block will show an \"Import as Map Markers\" button with a count of available waypoints. Clicking it creates Map Marker blocks for all waypoints not already present in the post, inserted immediately after the Map GPX block. Re-clicking is safe \u2014 already-imported waypoints are detected by coordinates and skipped.<\/p><\/dd>\nDoes it work with my theme?<\/h3><\/dt>\n
Is there a file size limit for GPX?<\/h3><\/dt>\n
Can I customize the map\/track\/marker colors?<\/h3><\/dt>\n
How do I add more map styles?<\/h3><\/dt>\n
Are API keys secure?<\/h3><\/dt>\n
Does this work offline?<\/h3><\/dt>\n
Where can I get support?<\/h3><\/dt>\n
Can I contribute to the plugin?<\/h3><\/dt>\n
What third-party libraries does Mapthread use?<\/h3><\/dt>\n
\n
Does Mapthread connect to any external services?<\/h3><\/dt>\n