Tour Itinerary Map

Sharraxaad

Tour Itinerary Map allows you to display interactive animated routes on maps using MapLibre.
Easily show tour routes, travel itineraries, and paths with customizable markers, colors, and animation settings.

The plugin includes a modern admin dashboard to configure:
* Map provider and style
* Start, end, waypoint, and moving markers
* Route colors and default marker colors
* Animation speed, looping, and auto-start behavior

Usage

This plugin provides the following shortcode:

[tour_itinerary_map]

The shortcode is designed to work on single pages of supported post types only.

You must first enable the desired post types from the plugin settings in the admin dashboard. Once enabled, add the shortcode inside the content of that post type (or its single template).

The map will automatically load and display route data dynamically based on the current post.

Perfect for travel websites, tour operators, bloggers, and itinerary-based content.

External Services

This plugin connects to the following external services:

Stadia Maps

The plugin uses Stadia Maps to load map tile styles (visual appearance of the map). When a visitor views a page containing the map shortcode, their browser connects to Stadia Maps servers to download the map style and tile data.

  • What is sent: The visitor’s IP address (standard HTTP request), the selected map style name, and an optional API key if configured in the plugin settings.
  • When it is sent: Every time a page containing the [tour_itinerary_map] shortcode is loaded in a visitor’s browser.
  • Service provider: Stadia Maps
  • Terms of Service: https://stadiamaps.com/terms-of-service/
  • Privacy Policy: https://stadiamaps.com/privacy-policy/

MapLibre GL JS (Bundled Library)

This plugin bundles MapLibre GL JS, an open-source JavaScript library for rendering interactive maps. MapLibre itself does not transmit any data to external servers — all rendering is done client-side in the visitor’s browser.

  • Source code: https://github.com/maplibre/maplibre-gl-js
  • License: BSD 3-Clause License

Turf.js (Bundled Library)

This plugin bundles Turf.js, an open-source geospatial analysis library used for route animation calculations (smoothing, interpolation). Turf.js does not communicate with any external server; all processing is done client-side.

  • Source code: https://github.com/Turfjs/turf
  • License: MIT License

Lucide Icons v0.577.0 (Bundled Library)

This plugin bundles Lucide, an open-source icon library used in the admin interface. Lucide does not communicate with any external server.

  • Source code: https://github.com/lucide-icons/lucide
  • License: ISC License

Source Code & Build Tools

The following files included in this plugin are compiled or minified builds of third-party open-source libraries. The original human-readable source code for each is publicly available at the links provided above in the External Services section.

  • assets/js/maplibre-gl.js — MapLibre GL JS (https://github.com/maplibre/maplibre-gl-js)
  • assets/css/maplibre-gl.css — MapLibre GL JS (https://github.com/maplibre/maplibre-gl-js)
  • assets/js/turf.js — Turf.js (https://github.com/Turfjs/turf)
  • admin/assets/lucide.js — Lucide v0.577.0 (https://github.com/lucide-icons/lucide)

All other JavaScript and CSS files in this plugin are unminified, human-readable source files authored specifically for this plugin:

  • public/js/touritma-map.js — Frontend map initialisation logic
  • public/js/metabox.js — Admin metabox interactions
  • public/js/metabox.css — Admin metabox styles
  • admin/assets/settings.js — Admin settings page interactions
  • admin/assets/settings.css — Admin settings page styles
  • assets/css/map.css — Frontend map styles

Rakibaad

  1. Upload the tour-itinerary-map folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Go to Itinerary Map in the WordPress admin menu to configure settings.

Dibu-eegisyo

Ma jiraan wax dibu-eegis ah oo ku saabsan kaabahan.

Ka-qaybgalayaasha & Horumariyayaasha

“Tour Itinerary Map” waa softiweer il furan. Dadka soo socda ayaa wax ku biiriyay kaabahan.

Ka-qaybgalayaasha

Ku tarjun “Tour Itinerary Map” luqaddaada.

Ma xiisaynaysaa horumarinta?

Baadh koodka, fiiri bakhaarka SVN, ama iska qor diiwaanka horumarinta adigoo adeegsanaya RSS.

Isbeddellada

1.0.1

  • Updated Lucide icon library to v0.577.0
  • Moved all inline JavaScript and CSS to properly enqueued external files
  • Renamed all function/option/constant prefixes from “tim” to “touritma” (≥4 chars, per WP guidelines)
  • Improved data sanitization and validation on metabox save (wp_unslash + per-field sanitize_text_field + numeric range validation)
  • Added External Services disclosure to readme
  • Added Source Code documentation links to readme

1.0.0

  • Initial release
  • Interactive map rendering using MapLibre
  • Custom markers with image and color fallback support
  • Route animation with speed and loop controls
  • Modern admin settings dashboard