Out of the Block: OpenStreetMap

外掛說明

A map block for Gutenberg which uses OpenStreetMap and Leaflet.js. It needs no API keys and works out of the box (or, out of the Block, if you prefer). Benefiting from Gutenberg’s potential, the plugin tries a different take on how to add your locations on the map and rethinks a few things, UX-wise.

Instead of manually adding coordinates for each one of your markers, just click-and-drop them directly on the map. You want to adjust their position? Just drag them wherever you want. And instead of filling-in custom fields to set each marker’s popup content, just open that popup and start writing in it, the Gutenberg way (it supports WYSIWYG editing, with links, images, and all). It even stores the map’s zoom level as you use it so that you don’t have to set it by hand.

Features

  • No need for API keys. Just install and use it.
  • Support for multiple markers.
  • Support for a different icon per marker.
  • Support for polygons and polylines.
  • Dead-simple interface. Don’t search for coordinates and don’t get overwhelmed by too many fields when using multiple markers. Just point and click on the map to add your marker where you want it and edit it’s popup content directly from there.
  • Place search. Find locations by typing keywords.
  • Remembers the zoom that you set when adding the markers and stores it so that you don’t set it by hand (which you can do anyway if you prefer).
  • Adjust the map height.
  • Change the default marker icon with a custom one.
  • Enable or disable map dragging.
  • Enable or disable touch zoom.
  • Enable or disable double-click zoom.
  • Enable or disable scroll wheel zoom.
  • Set a minimum and maximum limit that the user can zoom on the frontend. Setting the same value to both fields will lock the zoom at that level.
  • Support for other Layer Providers: MapBox (using your own API key) and Stamen.
  • Option to export locations in a JSON file
  • Option to import locations from a JSON file

螢幕擷圖

  • Adding markers and rich content
  • Using the place search to throw multiple markers in a row by typing keyword and double+enter (no mouse)
  • The map editing screen
  • Map behavior options
  • Adding a marker
  • Using custom markers
  • Place search
  • Plugin settings page
  • Adding a polygon
  • Adding a polyline
  • Export and import locations

適用於區塊編輯器

這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。

  • OpenStreetMap by Out of the Block A map block for the Gutenberg Editor using OpenStreetMaps and Leaflet that needs no API keys and works out of the box.

安裝方式

  1. Upload the plugin to your WordPress plugins directory and activate it.
  2. That’s it. You can go to a post/page that supports the Gutenberg editor and start using the block called “Out of the Block: OpenStreetMap”

常見問題集

Do I need an API key, like with Google Maps?

No.

That’s the point, actually. Just install the plugin and start adding maps. Keep in mind, though, that as stated on the OpenStreetMap Tile Usage Policy, OSM’s own servers are run entirely on donated resources and they have strictly limited capacity. Using them on a site with low traffic will probably be fine. Nevertheless, you are advised to create an account to MapBox and get a free API Key.

How do I add a new location?

To add a location, left-click on the map for a while, until you see the prompt saying “Release to drop a marker here”. On browsers that support it, the cursor transforms from hand to crosshair, to make it even more apparent. As long as the prompt is visible, it means that releasing the click will drop the marker at that spot. That slight delay has been added to prevent you from accidentally adding markers all over the place with every click.

Alternatively, you can use the map’s place search functionality.

How do I remove a location?

Click on the marker to open up its popup. There, you will see the “Remove” button.

I can’t find some of the options like disable dragging, setting zoom levels etc

Check under the “Map behavior” section, at the blocks’ settings at the sidebar on the right. It’s toggled off by default, that’s probably why you missed it.

使用者評論

2023 年 4 月 7 日
This is one hell of a nice plugin. It allows you to easily put a block on your site and add (multiple) markers. You can easily change the contents of the popup (just don't go wild) and is GDPR friendly. If that's what you need this is the plugin to go to. If you need other stuff (e. g. filters and stuff) - keep looking. But for a simple map that just works and has a easy, clean interface take this one.
2023 年 5 月 4 日
<p>The plugin is really great.<br />Too bad it only works with the Gutenberg editor.<br />I prefer to use the Classic Editor, but there I can not use the plugin so.<br />I would have to adjust the HTML source code by hand.</p> <p>The Map is not loading, if CloudFlare Rocket Loader is active.</p>
2021 年 5 月 11 日
I have testet a lot of OSM plugins. I only needed a card with two markers. This plugin is simple. In a few minutes the card is ready.
2020 年 10 月 6 日
Great plugin. First one that works very easy with multiple pins. And no API en giving credentials for billing. In the info window you van make a link to the route on Google maps if you want. Formatting the block is easy.
2020 年 9 月 17 日
Just because we don't need an API license key, and we can have multiple pins per map among other things, for me this is the best mapping block. And of course, the plugin works exactly as advertised. Until now, I was using my own map block I had created with ACF Pro, but that was just simple Google Map embed, which again did not require an API key, but was restricted to one pin per map, and of course no live data like traffic and other visuals, along with no street view. Well done, and thank you, Nick.
閱讀全部 5 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈Out of the Block: OpenStreetMap〉的開發相關工作。

參與者

〈Out of the Block: OpenStreetMap〉外掛目前已有 2 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈Out of the Block: OpenStreetMap〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

2.4.0

  • [New] Adds an option to prevent the default map scroll/touch behaviours.

2.3.0

  • [New] Adds support for different icons per marker.
  • Updates the react-leaflet script to v.4.2.1.
  • Updates compatibility with WordPress 6.2.

2.2.0

  • [New] Adds option to export locations to a JSON file
  • [New] Adds option to import locations from a previously exported JSON file

2.1.0

  • [New] Adds support for polygon shapes
  • [New] Adds support for polyline shapes
  • [Fix] Improves the drag and drop of markers
  • Updates the react-leaflet script to v.4.2.0
  • Updates the plugin’s assets and documentation

2.0.2

  • Replaces str_contains with strpos, for better backwards compatibility with older versions of PHP / WordPress.

2.0.1

  • Fixes a bug which broke the admin on WordPress versions prior to 5.9.

2.0.0

  • Refactors the build scripts to use the official @wordpress/create-block instead of create-guten-block, which isn’t supported anymore.
  • Updates Leaflet and react-leaflet to their latest versions (Leaflet 1.9.3 and react-leaflet 4.1.0).
  • Adds a new option to set the default coordinates when you add a new block. The plugin will try to guess the default location based on the site’s timezone.

1.3.5

  • Fixes a PHP warning in the widgets area of the admin
  • Updates translations

1.3.4

  • Fixes a PHP warning (more info: https://wordpress.org/support/topic/error-under-php8-2/)

1.3.3

  • Fixes a bug where the block’s scripts didn’t load if the block is used in a Widget

1.3.2

  • Fixes a bug where the block’s scripts didn’t load when used as a reusable block

1.3

  • Added Stamen as a Tile Provider
  • Fixed a bug with map centering when there is only one location
  • Fixed wrong link on attributions

1.2

  • Added MapBox as a Tile Provider

1.1

  • Place search functionality added
  • Improved marker precision
  • Better handling of pinning on mobile devices
  • Overall improvements on dragging smoothness

1.0.1

  • Fixed a bug during plugin activation.

1.0

  • First releases