內容簡介
Waymark 是一款強大的地圖創建外掛，讓使用者能夠輕鬆製作互動式地圖，並添加多種標記和圖層。無論是個人專案還是商業用途，Waymark 都能提供靈活的地圖管理功能，提升網站的互動性和可視化效果。
【主要功能】
• 直觀編輯器製作互動地圖
• 支援多種格式匯入（GPX、KML、GeoJSON）
• 自訂標記、線條和形狀的屬性
• 允許用戶從前端提交地圖
• 使用短碼輕鬆嵌入地圖到任何頁面
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
❤️ Keep This Project Alive Through Sponsorship ❤️
Creating Maps
Use the intuitive Editor to create Maps with one, or thousands of interactive Overlays.
Overlays – Create Markers, Lines and Shapes with a:
Title
Image (Media Library or link to external image)
Description (Rich text editor, HTML supported)
Type (defined in Settings)
Import
GPX
KML
GeoJSON
EXIF (Image location metadata)
Elevation data (adds an interactive profile chart for Lines with elevation data)
Meta – Add extra information to your Maps; these are customisable form inputs that allow you to add additional content to your Maps.
Types – Set options to visually distinguish between Overlays (colours/icons etc.), then select it when using the Editor.
Collections – Group Maps together and display multiple Maps at once. Create complex Collection hierarchies to suit your needs and associate Maps with multiple Collections.
Submissions – Allow registered users, or guests to create Maps from the front-end of your site. You can control who can Submit Maps, what editor features are available and whether submissions should be approved before they are published.
🌟 GitHub
👐 WordPress
📖 Demo & Docs
Displaying Maps
Embed your Maps using the [Waymark] Shortcode, or link to the Map Details page.
Shortcodes
Display a single Map, or a Collection of Maps anywhere that Shortcodes are supported.
An optional Shortcode Header displays the Map/Collection title, a link to the Map Details page and any Meta.
Display a Marker defined through the Shortcode.
Display a Basemap only, without any Overlays by providing centre and zoom parameters.
Basemaps – Uses OpenStreetMap by default, with support for multiple raster tiled/”slippy” Basemaps. You can switch Basemaps using the Overlay Filter.
Overlay Filter – Allow the user to filter which Overlays are currently visible on the Map.
Export
(Optionally) Let anyone Export Maps into GPX, KML and GeoJSON formats through the Shortcode Header or on the Map Details page.
Works on mobile devices.
Customising
Built to be flexible, Waymark has lots of Settings and Types provide one place to control how Overlays (Markers/Lines/Shapes) are displayed.
Marker Icons can be provided as:
– Font Icons (Ionic Icons v2/Font Awesome v4)
– Simple Text, or Emojis (i.e. 🏕️, 🚩, 📸).
– Custom HTML (good ol’ 
, or a more complex structure). So you can pretty much create any kind of Icon you want.
For developers:
Most elements can be styled using CSS and have sensibly named waymark- classes.
WordPress integration:
Maps are stored using the custom post type waymark_map.
Collections use the waymark_collection Taxonomy.
Embed Maps using the [Waymark] Shortcode anywhere they are supported, or dynamically using the do_shortcode(["Waymark"]) function.
Geographical data is stored in GeoJSON format. Types are specified using the type Property, i.e. {feature: { geometry: { type: 'Point', coordinates: [0, 0] } }, properties: { type: 'Alert', title: 'Bridge Removed!' }.
Specify which GeoJSON feature properties to store when importing (Settings > Overlays > Properties). These can be automatically appended to the Overlay Description, or accessed programatically via the layer.feature.properties Object.
Maps are displayed using the Leaflet JavaScript library, which is bundled with Waymark and can be extended using the waymark_loaded_callback [callback function](https://www.ogis.org/waymark-wp/advanced/using-the-global-callback-function/.
Be sure to check out Map First, a minimal WordPress theme with an obsession for Maps (it’s open-source too and contains lots of comments about customisations).
Waymark is free, open-source (GPL v2) and a labour of Love. I try to keep the plugin well supported, so please feel free to reach out with any issues, questions or feedback.
User Examples
Association Franc-Comtoise du Chemin de Compostelle – eGuide
Cres & Lošinj Trail – Lošinj Trail 2025
hikingTICINO
Horizontes – PT281
Iggy’s Hikes – Staze na Medvednici
Il Cammino del Lago Maggiore – Le 11 tappe
Merritt Mountain Bike Association – Iron Mountain
The Island Walk – Island Walk Map
Trekkaholic – Trekking al lago Bianco in Alpe Veglia
Via Apsyrtides
Zadar Archipelago – Interactive Map
Zagorje Outdoor – Konjička staza broj 10
Updated 10 September 2026
Development
[!NOTE]
To develop locally you will need to have both Node.js and NPM installed.
Grunt is used to run the build script, which compiles the JavaScript and CSS and performs some other tasks.
# Clone the repository (and the Waymark JS submodule)
git clone --recurse-submodules https://github.com/opengis/waymark.git
# Navigate to the Waymark directory
cd waymark
# Install the dependencies (or pnpm/yarn install)
npm install
# Run the build script
grunt
The build script will watch for changes to the JavaScript and CSS files.
Pull requests are welcome!
[!IMPORTANT]
Waymark JS is responsible for the Viewer and Editor and is included as a Git submodule (/waymark-js directory). View on GitHub.
Dev Server
A local WordPress environment is provided via wp-env. Docker must be running.
npm run dev
This starts WordPress at http://localhost:8888 and prints the credentials summary:
────────────────────────────────────
MySQL 127.0.0.1 root / password
Admin http://localhost:8888/wp-admin admin / password
────────────────────────────────────
