jhotadhari

<ul>
<li>## Deprecated</li>
<li>This project is no longer active and not recommended for use.</li>
<li>It works with WordPress version < 5.0 and the gutenberg plugin. But it doesn’t work with any current version!</li>
<li>It is left here for reference</li>
</ul>
<p>Highly customizable Map Block for Gutenberg, based on Leaflet</p>
<ul>
<li>Customize the Map and its Features directly from within the <strong>Gutenberg Block</strong></li>
<li><strong>Draw and edit Features</strong>. Markers, Lines, Polygons …</li>
<li><strong>Customize Feature-Appearance</strong>. Icon/Shadow, Color, Opacity, Class-Names …</li>
<li>A <strong>Wysiwyg Editor</strong> to Edit the Popup-Content. Use <strong>Images/Videos/Audios</strong> inside the Popup-Content</li>
<li><strong>Customize the Map</strong> itself. Dimensions, Baselayers, Controls …</li>
<li>Map Features are shareable and can be used between users and posts (depending on Features settings)</li>
</ul>
<blockquote>
<p>Geo Masala on <a href="https://github.com/jhotadhari/geo-masala" rel="nofollow ugc">GitHub</a>.<br />It’s open-source, free as freedom, free of cost and it will remain free.</p>
</blockquote>
<h4>How to use</h4>
<p>Edit any Post with gutenberg and add a ‘Geo Masala Map’ block, save post and done. Your post will display a map.</p>
<ul>
<li>Draw some Features or select some from the Feature-Panel.
<ul>
<li>The default Status for a new Feature is draft, only published ones are displayed in frontend.</li>
<li>To get Features from other posts/users, open Feature-Panel and adjust the Filters.</li>
</ul>
</li>
<li>Edit the Feature, change status, icon or color, change the popup content and title.</li>
<li>Open the Map Settings Panel and customize the controls.</li>
<li>Change the Feature sharing settings for a single Feature, and reuse the Feature in other Posts</li>
<li>…</li>
</ul>
<blockquote>
<p>The <a href="https://wordpress.org/plugins/gutenberg/" rel="ugc">Gutenberg Editor Plugin</a> <strong>is required</strong> for WordPress versions prior to 5.0, see <a href="https://wordpress.org/plugins/geo-masala/#installation" rel="ugc">requirements</a></p>
</blockquote>
<h4>What is a Feature?</h4>
<p>The term “Feature” is used in the cartographic context. A representation of a real-world object on a map (<a href="https://support.esri.com/en/other-resources/gis-dictionary/term/dcc335be-78ae-4bd2-b254-b44c37343f75" rel="nofollow ugc">feature|Definition – Esri Support GIS Dictionary</a>).<br />
Within this plugin, a Feature can represent a simple location (Marker), a way/route/track (Polyline) or an Area (Polygon/Rectangle).<br />
A couple of properties are stored with the Feature, eg. appereance and popup-content data.</p>
<h4>How does the Plugin work?</h4>
<p>A Feature is saved as a post type, and not saved to the Block!</p>
<ul>
<li>The Plugin registered a new custom-post-type ‘geom_feature’. Each geom_feature is used to store a single cartographic Feature, formatted in geoJSON. The cartographic Feature and other data (appearance, popup-content …) are stored as post-meta.</li>
<li>The geom_feature is registered without wordpress ui (List table and editing screen) or appearance in admin-navigation or admin-bar.</li>
<li>When editing any post with gutenberg, the ‘Geo Masala Map’ block displays a leaflet map and some settings-panels beneath it. All crud actions (create, read, update, delete) for geom_feature(s) are handled within the editor block using the wp rest api and its backbone client. All geom_feature crud actions are saved immediately (Some ui elements have reset/save buttons).</li>
<li>default post_status for geom_feature(s) is ‘draft’.</li>
<li>The Features-Panel lists geom_features. Features on Map are highlighted. If a Feature gets removed from map, the geom_feature is still saved and available to use.</li>
<li>Therefor a Feature created by one post can be used in another post as well (depending on the individual feature settings). All changes made to a geom_feature are saved immediately and will effect all posts where the Feature is displayed.</li>
<li>All attributes related to the map (and not to its features) are stored as block attributes.</li>
</ul>
<h4>In Development</h4>
<p>The Plugin is in early development (and needs a sponsor to go on).<br />
Some ui will change and more options will be added.</p>
<p>Coming soon hopefully:</p>
<ul>
<li>wiki and tutorials</li>
<li>Possibility to draw routes on a map.</li>
<li>Import for gpx/geoJSON/kml</li>
<li>Method to add altitude and slope values for features</li>
<li>Elevation profile for line/routes</li>
<li>Color line/routes by z value or slope</li>
<li>…</li>
</ul>
<p>Known issues:</p>
<ul>
<li>Currently there is a maximum for hundred Features, will be changed in future.</li>
<li>Feature Sharing: The popover control controls if the Feature appears in a Feature-Pool. If it is already in use somwhere, it will still be used, but just not displayed in Feature-Panel.</li>
</ul>
<h4>Contribute</h4>
<ul>
<li>Most welcome 🙂</li>
<li>Geo-Masala is free and open source. The source is hosted on <a href="https://github.com/jhotadhari/geo-masala" rel="nofollow ugc">GitHub</a>. So dig the code as you like.</li>
<li>For <strong>support</strong>, to <strong>request new plugin-features</strong> or inform me about <strong>issues and bugs</strong> <a href="https://github.com/jhotadhari/geo-masala/issues/new" rel="nofollow ugc">create a new issue on Github</a> or <a href="https://wordpress.org/support/plugin/geo-masala" rel="ugc">add a new topic to WP’s support forum</a></li>
<li>Love to get your <strong>feedback</strong>, <a href="https://wordpress.org/support/plugin/geo-masala/reviews/#new-post" rel="ugc">Create a new review and rate this Plugin</a>, write a tutorial and tell your friends.</li>
<li><a href="https://waterproof-webdesign.info/en/#contact" rel="nofollow ugc">Tell me</a> your wishes, maybe get me a bowl of rice and some masala: <a href="http://waterproof-webdesign.info/donate" rel="nofollow ugc">Donate</a></li>
</ul>
<blockquote>
<p>I’m hungry, cycling around the world and Geo-Masala is coded while sitting wet in a tent during Monsoon somwhere in south himalaya. I appreaciate any kind of <a href="http://waterproof-webdesign.info/donate" rel="nofollow ugc">donation</a> or sponsorship.</p>
</blockquote>
<h4>Thanks for beautiful ressoucres</h4>
<ul>
<li>WordPress, the <a href="https://developer.wordpress.org/rest-api/" rel="nofollow ugc">WP REST API</a>, the <a href="https://developer.wordpress.org/rest-api/using-the-rest-api/backbone-javascript-client/" rel="nofollow ugc">Backbone JavaScript Client</a> and the <a href="https://wordpress.org/gutenberg/handbook/" rel="ugc">Gutenberg Editor</a> and its components.</li>
<li><a href="http://backbonejs.org/" rel="nofollow ugc">Backbone</a>, <a href="http://marionettejs.com/" rel="nofollow ugc">Backbone Marionette</a>, <a href="https://www.npmjs.com/package/backbone.deep-model" rel="nofollow ugc">Backbone Deep Model</a> and <a href="https://github.com/onsi/cocktail" rel="nofollow ugc">Backbone Cocktail</a>.</li>
<li><a href="https://reactjs.org/" rel="nofollow ugc">React</a>, <a href="https://github.com/bvaughn/react-virtualized" rel="nofollow ugc">react-virtualized</a> and <a href="https://github.com/khan/react-multi-select" rel="nofollow ugc">react-multi-select</a></li>
<li><a href="http://leafletjs.com/" rel="nofollow ugc">Leaflet</a> and Plugins:
<ul>
<li><a href="https://github.com/Leaflet/Leaflet.draw" rel="nofollow ugc">Leaflet Draw</a></li>
<li><a href="https://github.com/justinmanley/leaflet-draw-toolbar" rel="nofollow ugc">Leaflet Draw Toolbar</a></li>
<li><a href="https://github.com/smeijer/leaflet-geosearch" rel="nofollow ugc">Leaflet Geosearch</a></li>
<li><a href="https://github.com/ebrelsford/Leaflet.loading" rel="nofollow ugc">Leaflet Loading</a></li>
<li><a href="https://github.com/leaflet-extras/leaflet-providers" rel="nofollow ugc">Leaflet Providers</a></li>
<li><a href="https://github.com/brunob/leaflet.fullscreen" rel="nofollow ugc">Leaflet Fullscreen</a></li>
<li><a href="https://github.com/Leaflet/Leaflet.toolbar" rel="nofollow ugc">Leaflet Toolbar</a></li>
</ul>
</li>
<li>This Plugin is generated with <a href="https://github.com/jhotadhari/generator-pluginboilerplate" rel="nofollow ugc">generator-pluginboilerplate version 1.2.3</a></li>
<li>Background for plugin banner and icon <a href="http://opentopomap.org/" rel="nofollow ugc">OpenTopoMap</a></li>
<li>…</li>
</ul>


Geo Masala

Highly customizable Map Block for Gutenberg, based on Leaflet

Giorgos Sarigiannidis

<p>A map block for Gutenberg which uses <a href="https://www.openstreetmap.org" rel="nofollow ugc">OpenStreetMap</a> and <a href="https://leafletjs.com" rel="nofollow ugc">Leaflet.js</a>. 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.</p>
<p>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.</p>
<span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/FGe7zJnrIgo?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span>
<ul>
<li><a href="https://github.com/gsarig/ootb-openstreetmap" rel="nofollow ugc">Follow the project’s development on GitHub</a></li>
<li><a href="https://github.com/gsarig/ootb-openstreetmap/releases" rel="nofollow ugc">Release history</a></li>
<li><a href="https://github.com/users/gsarig/projects/1" rel="nofollow ugc">Roadmap</a></li>
<li><a href="https://github.com/gsarig/ootb-openstreetmap?tab=readme-ov-file#hooks" rel="nofollow ugc">Hooks🪝</a></li>
<li><a href="https://github.com/gsarig/ootb-openstreetmap?tab=readme-ov-file#shortcodes" rel="nofollow ugc">Shortcodes</a></li>
</ul>
<h4>Features</h4>
<ul>
<li>No need for API keys. Just install and use it.</li>
<li>Support for multiple markers.</li>
<li>Support for a different icon per marker.</li>
<li>Support for polygons and polylines.</li>
<li>Marker clustering: group nearby markers into clusters that expand as you zoom in.</li>
<li><a href="https://www.gsarigiannidis.gr/wordpress-gutenberg-map-block-openstreetmap/" rel="nofollow ugc">Dead-simple interface</a>. 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.</li>
<li><a href="https://www.gsarigiannidis.gr/openstreetmap-place-search/" rel="nofollow ugc">Place search</a>. Find locations by typing keywords.</li>
<li>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).</li>
<li>AI integration which allows you to add markers by using commands in natural language. Just say “please” to activate (e.g. “Please, show me where GOT was filmed”). Requires an API key from an AI Provider, or a site-level AI connector on WordPress 7.0+. <a href="https://www.gsarigiannidis.gr/openstreetmap-openai-integration/" rel="nofollow ugc">Read more</a>.</li>
<li>Query Maps: Supports creating a map out of maps added on other posts or post types. This can be quite powerful when, for example, you have a custom post type for “Places” with each place having its own map, and you want to dynamically gather-up all the places on a single map.</li>
<li>Shortcode support: You can use the shortcode <code>[ootb_query]</code> as an alternative way to use the aforementioned Query Maps feature (see the FAQ for more info).</li>
<li>Support for a location custom field, which can be used to store a post’s or post type’s location, following the <a href="https://codex.wordpress.org/Geodata" rel="nofollow ugc">Geodata guidelines</a>. Read more in the <a href="https://github.com/gsarig/ootb-openstreetmap/releases/tag/2.8.0" rel="nofollow ugc">v.2.8.0 release notes</a>.</li>
<li>Adjust the map height.</li>
<li>Change the default marker icon with a custom one.</li>
<li>Enable or disable map dragging.</li>
<li>Enable or disable touch zoom.</li>
<li>Enable or disable double-click zoom.</li>
<li>Enable or disable scroll wheel zoom.</li>
<li>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.</li>
<li>Support for other Layer Providers: MapBox (using your own API key) and Stamen.</li>
<li>Option to export locations in a JSON file</li>
<li>Option to import locations from a JSON file</li>
</ul>


Out of the Block: OpenStreetMap

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.

The best map block


In 5 minutes I had a map with a marker. Easy!


Loved it!

A map block for Gutenberg using OpenStreetMap and Leaflet that needs no API keys and works out of the box. Or should we say, ...Out of the Block?

Geo Masala vs Out of the Block: OpenStreetMap