| 开发者 | sirlouen |
|---|---|
| 更新时间 | 2026年7月28日 05:59 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
.gpx file, and visitors get:
<trk>) and GPX routes (<rte>), e.g. Garmin Connect course exports.<wpt> points in the file.tile.openstreetmap.org, which means that server receives the visitor's IP address, browser User-Agent and the coordinates of the map area viewed. See the OpenStreetMap Tile Usage Policy and the OSMF Privacy Policy. The same data is sent to any custom tile provider you configure instead.
The public OSM tile server is rate-limited and is not intended for high-traffic sites. For busy sites, set a custom tile provider in the block's Map tiles panel (or via the gpxrm_tile_url filter). Attribution to OpenStreetMap is always shown, as the license requires.
Source code
The front-end JavaScript in build/ is minified (the block editor script is not, so that its strings stay translatable). The human-readable source lives in the plugin's src/ directory, which is included in this plugin, and is also available with full build instructions at the public repository: https://github.com/SirLouen/gpx-route-map. The plugin is built with Vite (pnpm install && pnpm run build).
gpx-route-map folder to /wp-content/plugins/, or install through the Plugins screen.No. It has no plugin dependencies and works with core WordPress.
Map rendering uses MapLibre GL JS (BSD-3-Clause) with OpenStreetMap raster tiles. The track, elevation profile and the distance/elevation stats are all computed from your GPX file in the browser. When you add the block, those stats are saved with it so the summary still shows without JavaScript.
Yes, set a custom tile URL in the block's Map tiles panel or with the gpxrm_tile_url filter.
Only if that host allows cross-origin (CORS) requests, because the visitor's browser fetches the file directly, and most external sites don't send the required header. The front end then shows "Could not load GPX file." even though the link opens fine in a browser tab. Uploading the file to your Media Library is the reliable option.
GPX files uploaded before this plugin was activated may be stored with a generic XML type or no type at all. The picker shows GPX and XML types; files stored with an empty or unrelated type won't appear. Re-upload them to fix the stored type. On multisite, the network's "Upload file types" setting must also include gpx.
The map library could not be downloaded. The plugin loads its map code as a native JavaScript module, which optimization plugins normally leave alone. But if yours is configured to combine, inline or relocate module scripts, exclude this plugin's view script from it. Visitors on a flaky connection can simply click the message to retry.
.pot template is bundled for translators.[gpx_route_map] shortcode now fills its stats bar with JavaScript; the block continues to show statistics without JavaScript.[gpx_route_map] shortcode with MapLibre map, waypoints, stats and an interactive elevation profile.