Image

Give Directions

Beskrivelse

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.

Skærmbilleder

  • Image
    Directions list in the admin panel
  • Image
    Direction edit screen – Route directions tab
  • Image
    Direction edit screen – Address search and expanded details
  • Image
    Direction edit screen – Spot guide tab
  • Image
    Settings page – Marker color and map service settings
  • Image
    Map display on the frontend
  • Image
    Image modal display when clicking on slider images

Installation

  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. 表示されるショートコードを投稿やページにコピー&ペースト

FAQ

How do I use the shortcode?

After saving a direction in the edit screen, a shortcode will be displayed. Paste it into your posts or pages like this:

[give-directions id="1" title="Direction Title"]

How many waypoints can I add?

You can add unlimited waypoints.

What is the spot guide feature?

Separate from route directions, you can place multiple pins on the map and display descriptions and images for each spot. It’s useful for tourist guides or store introductions. You can add unlimited spots.

What is the image modal display?

When you click on an image in the slider, it displays in a larger modal window.

Can I change the marker colors?

Yes, you can freely change the colors for starting point, waypoints, destination, spots, and route lines from the settings page.

Can I use Google Maps?

Yes, you can select the map service from the settings page. To use Google Maps, you need a Google Maps API key.

Anmeldelser

Der er ingen anmeldelser for denne widget.

Bidragsydere & udviklere

“Give Directions” er open source-software. Følgende personer har bidraget til dette plugin.

Bidragsydere

“Give Directions” er blevet oversat til 2 sprog. Tak til oversætterne for deres bidrag.

Oversæt “Give Directions” til dit eget sprog.

Interesseret i udvikling?

Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.

Ændringslog

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)