Give Directions

Give Directions is a map display plugin designed for creating route directions and spot guides.
You can place routes and pins on the map, with coordinated images and comments.

日本語: 道案内を目的としたプラグイン。スポット案内としても利用できます。地図上にルートやピンを表示し、画像やコメントを連動表示します。

Key Features

• Map Display

  • Beautiful map display using Leaflet.js or Google Maps
  • Easy pin placement with drag and drop
  • Automatic address retrieval

• Route Directions

  • Automatic route guidance with Leaflet Routing Machine
  • Set starting point, destination, and waypoints
  • Show/hide waypoints
  • Real-time route display

• Spot Guide

  • Place pins on the map for spot guides
  • Add images and comments to each spot

• Image Display

  • Image slider display using Slick
  • Map and slider coordination
  • Image enlargement in modal window

• Customization

  • Marker color settings (starting point, waypoints, destination, spots, route line)
  • Map service selection (Leaflet.js / Google Maps)
  • Easy embedding with shortcodes

External Services

This plugin may connect to the following external services depending on your configuration and usage:

Google Maps API (Optional)

What it is: Google’s mapping and geocoding service.

When used: Only when you select “Google Maps” as the map service in the plugin settings and provide an API key.

What data is sent:
– Location coordinates (latitude/longitude) for displaying maps and calculating routes
– Address strings when using the address search feature in the admin panel
– User’s browser language for localized map display

Privacy Policy: https://policies.google.com/privacy
Terms of Service: https://cloud.google.com/maps-platform/terms

OpenStreetMap Nominatim (Optional)

What it is: OpenStreetMap’s geocoding service for address search and reverse geocoding.

When used: Only when you use the address search feature in the admin panel with Leaflet.js map service, or when retrieving address information from coordinates.

What data is sent:
– Address strings when searching for locations
– Location coordinates (latitude/longitude) for reverse geocoding

Usage Policy: https://operations.osmfoundation.org/policies/nominatim/
Privacy Policy: https://wiki.osmfoundation.org/wiki/Privacy_Policy

OSRM (Project-OSRM) Demo Server (Optional)

What it is: Open Source Routing Machine’s demo routing service.

When used: Only when using Leaflet.js map service for calculating and displaying routes between locations.

What data is sent:
– Location coordinates (latitude/longitude) for route calculation

Important Note: The plugin uses OSRM’s demo server by default, which is NOT suitable for production use according to OSRM’s usage policy. Users are encouraged to set up their own OSRM server or use alternative routing services for production websites.

Usage Policy: https://github.com/Project-OSRM/osrm-backend/wiki/Api-usage-policy

Note: All external service connections are made only when actively using the respective features. No data is sent to external services without user action (creating/editing directions with maps).

Third-Party Libraries

This plugin includes the following third-party libraries:

Leaflet

• Version: 1.9.4
• License: BSD 2-Clause License
• Copyright (c) 2010-2023, Volodymyr Agafonkin
• Copyright (c) 2010-2011, CloudMade
• Source: https://leafletjs.com/
• License URL: https://github.com/Leaflet/Leaflet/blob/main/LICENSE

Leaflet Routing Machine

• Version: 3.2.12
• License: ISC License
• Copyright (c) 2013 Per Liedman
• Source: https://www.liedman.net/leaflet-routing-machine/
• License URL: https://github.com/perliedman/leaflet-routing-machine/blob/master/LICENSE

Slick Carousel

• Version: 1.8.1
• License: MIT License
• Copyright (c) 2017 Ken Wheeler
• Source: https://kenwheeler.github.io/slick/
• License URL: https://github.com/kenwheeler/slick/blob/master/LICENSE

For full license texts, please see the LICENSE files in the respective library directories under assets/lib/.

Languages

This plugin is translation ready and includes:

• English (en_US) – Default
• Japanese (ja) – 日本語

You can contribute additional translations via WordPress.org.

1. Upload and activate the plugin
2. Go to “Directions” menu in the admin panel and click “Add New”
3. Configure the map and save
4. Copy and paste the displayed shortcode into your posts or pages

日本語:
1. プラグインをアップロードして有効化します
2. 管理画面の「道案内」メニューから新規追加
3. 地図の設定を行い保存
4. 表示されるショートコードを投稿やページにコピー&ペースト

1. 

   Directions list in the admin panel

2. 

   Direction edit screen - Route directions tab

3. 

   Direction edit screen - Address search and expanded details

4. 

   Direction edit screen - Spot guide tab

5. 

   Settings page - Marker color and map service settings

6. 

   Map display on the frontend

7. 

   Image modal display when clicking on slider images

1.0.0

• Initial release
• Map display using Leaflet.js
• Drag and drop pin placement
• Automatic address retrieval
• Route directions with Leaflet Routing Machine
• Starting point, destination, and waypoint settings
• Show/hide waypoints
• Spot guide feature
• Tab switching between route directions and spot guides
• Image slider using Slick
• Map and slider coordination
• Image enlargement in modal window
• Settings page (map service selection, marker color settings)
• Unlimited waypoints and spots
• Admin panel performance improvements
• Improved map marker icon design
• Improved popup display
• Bundled external libraries (Leaflet, Leaflet Routing Machine, Slick Carousel)= 1.1.0 =
• Added: Multilingual support (English/Japanese)
• Added: Translation files (POT, PO, MO) for WordPress.org translation system
• Changed: All UI strings converted to English with Japanese translations
• Changed: Enabled load_plugin_textdomain() for proper translation loading
• Improved: Removed unnecessary English translation files
• Fixed: Data passing in admin edit page
• Fixed: Marker display improvements
• Fixed: JavaScript syntax errors
• Changed: Removed all quantity limits (unlimited waypoints and spots)
• Improved: External service documentation for WordPress.org compliance
• Improved: Security enhancements (sanitization and nonce verification)
• Improved: Proper function prefixing throughout the plugin

1.0.0

• Initial release
• Route directions with starting point, waypoints, and destination
• Show/hide waypoints
• Spot guide feature
• Tab switching between route directions and spot guides
• Image slider using Slick
• Map and slider coordination
• Image enlargement in modal window
• Settings page (map service selection, marker color settings)
• Unlimited waypoints and spots
• Admin panel performance improvements
• Improved map marker icon design
• Improved popup display
• Bundled external libraries (Leaflet, Leaflet Routing Machine, Slick Carousel)