Changeset 3467922
- Timestamp:
- 02/23/2026 05:53:56 PM (5 weeks ago)
- File:
-
- 1 edited
-
mapthread/tags/1.6.0/readme.txt (modified) (8 diffs)
Legend:
- Unmodified
- Added
- Removed
-
mapthread/tags/1.6.0/readme.txt
r3467718 r3467922 18 18 Perfect for travel bloggers, hiking enthusiasts, and anyone who wants to tell location-based stories that engage readers. 19 19 20 https://www.youtube.com/watch?v=LBp_favwZVs 21 20 22 = Storytelling = 21 23 … … 59 61 5. Publish - the map automatically follows as readers scroll! 60 62 61 = Map Providers =62 63 Mapthread includes three free map styles out of the box (Street, Satellite, Topographic). You can also connect additional tile providers for additional styles:64 65 * **Mapbox** - Streets, Outdoors, Light, Dark, Satellite, Satellite Streets66 * **Thunderforest** - Cycle, Transport, Landscape, Outdoors, Atlas, Pioneer, Neighbourhood67 * **JawgMaps** - Streets, Sunny, Terrain, Dark, Light68 * **Stadia Maps** - Smooth, Smooth Dark, Satellite, Outdoors, OSM Bright, Stamen Toner, Stamen Terrain, Stamen Watercolor69 70 Configure providers under **Settings > Mapthread** by entering your API key and selecting which styles to enable. Each provider offers free tiers suitable for most blogs.71 72 63 = Examples = 73 64 … … 83 74 * Themes: Tested on Twenty Twenty-Four and Twenty Twenty-Five. Should work on most block themes. Classic themes are not supported. 84 75 85 == Configuring Map Providers (Optional) == 76 == Configuring Additional Map Providers (Optional) == 77 78 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**, **Thunderforest**, **JawgMaps**, **Stadia Maps**. 86 79 87 80 1. Go to Settings > Mapthread … … 140 133 = Where can I get support? = 141 134 142 Post in the [plugin support forum](https://wordpress.org/support/plugin/mapthread/) or open an issue at https://github.com/randomwire/Mapthread/issues135 Post in the [plugin support forum](https://wordpress.org/support/plugin/mapthread/) or [open an issue on GitHub](https://github.com/randomwire/Mapthread/issues) 143 136 144 137 = Can I contribute to the plugin? = 145 138 146 Yes! Mapthread is open source — contributions are welcome at https://github.com/randomwire/Mapthread139 Yes! Mapthread is open source — contributions are welcome at [github.com/randomwire/Mapthread](https://github.com/randomwire/Mapthread) 147 140 148 141 == Third-Party Libraries == 149 142 150 * **Leaflet.js** (BSD-2-Clause) - https://leafletjs.com/ 151 Interactive map rendering 152 * **Leaflet.fullscreen** (MIT) - https://github.com/brunob/leaflet.fullscreen 153 Fullscreen map control 154 * **Chart.js** (MIT) - https://www.chartjs.org/ 155 Elevation profile visualization 143 * [Leaflet.js](https://leafletjs.com/) (BSD-2-Clause) — Interactive map rendering 144 * [Leaflet.fullscreen](https://github.com/brunob/leaflet.fullscreen) (MIT) — Fullscreen map control 145 * [Chart.js](https://www.chartjs.org/) (MIT) — Elevation profile visualization 156 146 157 147 == External services == … … 163 153 When: Every time a visitor views a page containing a Mapthread map, the browser requests tile images from OpenStreetMap servers. 164 154 Data 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. 165 Terms of Use: https://wiki.osmfoundation.org/wiki/Terms_of_Use 166 Privacy Policy: https://wiki.osmfoundation.org/wiki/Privacy_Policy 167 Tile Usage Policy: https://operations.osmfoundation.org/policies/tiles/ 155 [Terms of Use](https://wiki.osmfoundation.org/wiki/Terms_of_Use) | [Privacy Policy](https://wiki.osmfoundation.org/wiki/Privacy_Policy) | [Tile Usage Policy](https://operations.osmfoundation.org/policies/tiles/) 168 156 169 157 **Esri / ArcGIS World Imagery** 170 Service URL: https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer158 Service: [server.arcgisonline.com](https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer) 171 159 Used for: Rendering the optional "Satellite" map layer. 172 160 When: Only when the Satellite layer is enabled in Settings > Mapthread and a visitor selects it. No requests are made if the layer is disabled. 173 161 Data sent: Tile coordinate requests and the visitor's IP address. 174 Terms of Use: https://www.esri.com/en-us/legal/terms/full-master-agreement 175 Privacy Policy: https://www.esri.com/en-us/privacy/overview 162 [Terms of Use](https://www.esri.com/en-us/legal/terms/full-master-agreement) | [Privacy Policy](https://www.esri.com/en-us/privacy/overview) 176 163 177 164 **OpenTopoMap** … … 179 166 When: Only when the Topographic layer is enabled in Settings > Mapthread and a visitor selects it. 180 167 Data sent: Tile coordinate requests and the visitor's IP address. 181 Terms of Use: https://opentopomap.org/about 182 Privacy Policy: https://opentopomap.org/about 168 [Terms of Use / Privacy Policy](https://opentopomap.org/about) 183 169 184 170 **Nominatim (OpenStreetMap Geocoding)** … … 186 172 When: Only in the WordPress block editor when an author types into the address search field. Not triggered on the public frontend. 187 173 Data sent: The search query text (partial address or place name) and the editor's IP address. 188 Usage Policy: https://operations.osmfoundation.org/policies/nominatim/ 189 Privacy Policy: https://wiki.osmfoundation.org/wiki/Privacy_Policy 174 [Usage Policy](https://operations.osmfoundation.org/policies/nominatim/) | [Privacy Policy](https://wiki.osmfoundation.org/wiki/Privacy_Policy) 190 175 191 176 **Open-Elevation API** 192 177 Used for: Looking up elevation data for GPX tracks that lack elevation information. 193 When: Server-side only — 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 https://api.open-elevation.com/api/v1/lookup, not from the visitor's browser.178 When: Server-side only — 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](https://api.open-elevation.com/api/v1/lookup), not from the visitor's browser. 194 179 Data 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. 195 Service: https://open-elevation.com/ 196 Source: https://github.com/Jorl17/open-elevation 197 Terms of Use: https://github.com/Jorl17/open-elevation/blob/master/license.md (open-source, GPL-2.0 license) 198 Privacy Policy: https://github.com/Jorl17/open-elevation (open-source project; no user accounts; only receives GPS coordinates from the server) 180 [Service](https://open-elevation.com/) | [Source](https://github.com/Jorl17/open-elevation) | [License (GPL-2.0)](https://github.com/Jorl17/open-elevation/blob/master/license.md) 199 181 200 182 **Optional Tile Providers** (each requires an API key configured in Settings > Mapthread) … … 202 184 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. 203 185 204 * **Mapbox** - https://www.mapbox.com/ 205 Terms: https://www.mapbox.com/legal/tos | Privacy: https://www.mapbox.com/legal/privacy 206 * **Thunderforest** - https://www.thunderforest.com/ 207 Terms: https://www.thunderforest.com/terms/ | Privacy: https://www.thunderforest.com/privacy/ 208 * **JawgMaps** - https://www.jawg.io/ 209 Terms: https://www.jawg.io/en/terms/ | Privacy: https://www.jawg.io/en/privacy/ 210 * **Stadia Maps** - https://stadiamaps.com/ 211 Terms: https://stadiamaps.com/terms-of-service/ | Privacy: https://stadiamaps.com/privacy/privacy-policy/ 186 * **Mapbox** | [Terms](https://www.mapbox.com/legal/tos) | [Privacy](https://www.mapbox.com/legal/privacy) 187 * **Thunderforest** | [Terms](https://www.thunderforest.com/terms/) | [Privacy](https://www.thunderforest.com/privacy/) 188 * **JawgMaps** | [Terms](https://www.jawg.io/en/terms/) | [Privacy](https://www.jawg.io/en/privacy/) 189 * **Stadia Maps** | [Terms](https://stadiamaps.com/terms-of-service/) | [Privacy](https://stadiamaps.com/privacy/privacy-policy/) 212 190 213 191 214 192 == Source Code & Build Instructions == 215 193 216 The compiled JavaScript and CSS files in the `build/` directory are generated from human-readable source files. The full source code is available at: 217 https://github.com/randomwire/Mapthread 194 The compiled JavaScript and CSS files in the `build/` directory are generated from human-readable source files. The full source code is available at [github.com/randomwire/Mapthread](https://github.com/randomwire/Mapthread) 218 195 219 196 To build from source:
Note: See TracChangeset
for help on using the changeset viewer.