Description
A simple way to add custom maps or store locators to your WordPress posts and pages with our intuitive plugin. Ideal for contact pages, showcasing business locations, event venues, and more!
Block Features
- Versatile Data Sources: Choose the data source for your markers, whether from WordPress post types, taxonomies, or categories.
- Sidebar Integration: Optionally display a sidebar with the selected posts for additional context.
- Search Functionality: Enable a search bar to help users find specific locations quickly.
- Advanced Filtering: Provide filters to refine search results based on different criteria.
- Customizable Markers: Personalize marker colors to match your branding.
- Multiple Map Tiles: Select from multiple map tile options to fit your design preferences.
- Real-Time Preview: View your map in real time within the block editor, ensuring it meets your needs before publishing.
- User-Friendly Interface: Easily customize maps without any coding experience.
- Optimized Performance: Lightweight construction ensures optimal performance without burdening your site.
- No Database Overhead: Works without additional database queries or tables, maintaining site efficiency.
- Zoom Control: Adjust the zoom level of your map to fit your display requirements.
- Localization Support: Fully supports localization to cater to a global audience.
- Full site editing: You can edit the posts render directly inside the block.
- Advanced Custom Fields compatibility: You can use ACF/SCF fields instead of native custom fields if needed.
Two Block Options
This plugin includes two distinct blocks to cater to different user needs:
-
Simple Block:
- Designed for ease of use with minimal customization options.
- Ideal for users who want a quick and straightforward way to add a map or store locator to their site.
-
Complex Block:
- Offers multiple inner blocks for advanced customization.
- Allows for detailed personalization, including custom markers, advanced filtering, and more.
- Best suited for users who require a highly tailored map experience.
References
We leverage several high-quality libraries and third-party service providers to render maps in your preferred mapping engine. Below are the details and when they are used:
- Leaflet: A leading open-source JavaScript library for interactive maps, renowned for its simplicity, performance, and usability.
- Leaflet GeoSearch: An advanced geocoding control for Leaflet, enabling seamless address searches and location suggestions.
- React Leaflet: Provides bindings for using Leaflet with React, ensuring smooth integration with React-based applications.
- React leaflet markercluster: A powerful plugin for clustering markers on a Leaflet map when using React Leaflet, boosting map performance and enhancing user experience with clustered markers.
Screenshots
This is a desktop view of the plugin in front-end This is a desktop view of the plugin in front-end, with a location searched This is a desktop view of the plugin in front-end, with a searched location displayed This is a desktop view of the plugin in front-end, with the filters opened This is a desktop view of the plugin in front-end, with a post selected This is a desktop RTL view of the plugin in front-end This the loader of the plugin This is a mobile view of the plugin in front-end This is a mobile view of the plugin in front-end, with the filters opened This is a mobile view of the plugin in front-end, with the posts list opened This is a mobile view of the plugin in front-end, with a post selected This is a mobile view of the plugin in front-end, with the post details popup expanded This is a mobile RTL view of the plugin in front-end, with a post selected This is a view of a post with the lat & lng filled in custom fields This is a view of the gutenberg block with all inner blocks
Blocks
This plugin provides 11 blocks.
- Mappps A bloc that display maps
- Mappps (blocks) A bloc that display maps
- Sidebar Contains the block elements used to render the sidebar, like the posts, search bar, title, and filters.
- Filters Contains the filters.
- Search bar Contains search bar.
- Map Contains the map.
- Loader Contains the global loader.
- Post Details Contains the block elements used to render more details from a post, like the title, date, featured image, content or excerpt, and more.
- Post Template Contains the block elements used to render a post, like the title, date, featured image, content or excerpt, and more. For better preview performances only 2 posts will be displayed here
- Mobile toggles Contains mobile toggles buttons.
- Filters toggle The button that'wll open/close the filters.
FAQ
-
Advanced Custom Field (ACF/SCF) compatibility
-
In order to make the plugin work with ACF (or SCF), you’ll need to create new fields for your desired post types.
Go to Field groups and add a new one:
Then add a new Field with the type Text and use mappps_lat as field name.
Add another one and name it mappps_lng.
In the Settings below, go to the Group Settings tab and check Show in REST API. -
Can I customize the markers on the map?
-
Yes, you can customize the marker color and size inside the “Block settings” > “Render settings”.
-
What if I have multiple posts with the same location?
-
The plugin support the clustering for the markers, you can disable it but then the map will display overlapping markers.
-
Can I put multiple “Mappps” blocks in the same page?
-
Yes.
-
Can I put “Mappps” and “Mappps (blocks)” blocks in the same page?
-
Yes.
-
Known bug
-
Leaflet is not compatible with Gridjs somehow Gridjs and Leaflet both uses the property “window.L”.
Depending on which library is called first, the other takes priority and the first one don’t work.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Mappps” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Mappps” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.3.0
- Released: January 23, 2025
- https://github.com/LaTableRouge/Mappps/releases/tag/1.3.0
- Fixing marker clustering in Gutenberg
- Fixing having multiple maps in the same page
- Fixing tileLayer change in gutenberg editor
1.2.1
- Released: January 13, 2025
- https://github.com/LaTableRouge/Mappps/releases/tag/1.2.1
- Cleaning up the codebase
- Preventing interaction with the map in the block editor
1.2.0
- Released: December 5, 2024
- https://github.com/LaTableRouge/Mappps/releases/tag/1.2.0
- Adding ACF/SCF compatibility.
1.1.2
- Released: November 13, 2024
- https://github.com/LaTableRouge/Mappps/releases/tag/1.1.2
- Removing @changey/react-leaflet-markercluster dependency and other useless dependencies
- CSS compatibility following the deprecation of the @import rule in Dart Sass
- Better icon handling
1.1.1
- Released: September 13, 2024
- https://github.com/LaTableRouge/Mappps/releases/tag/1.1.1
- Adding icons
1.1.0
- Released: August 30, 2024
- https://github.com/LaTableRouge/Mappps/releases/tag/1.1.0
1.0.0
- Released: August 28, 2024
- https://github.com/LaTableRouge/Mappps/releases/tag/1.0.0-beta
- Adding new blocks
0.0.10
- Released: August 30, 2024
- https://github.com/LaTableRouge/Mappps/releases/tag/0.0.10
- fix loader height
0.0.9
- Released: August 27, 2024
- https://github.com/LaTableRouge/Mappps/releases/tag/0.0.9
- RTL styles fix
0.0.8
- Released: August 27, 2024
- https://github.com/LaTableRouge/Mappps/releases/tag/0.0.8
- Guidelines review
0.0.7
- Released: August 26, 2024
- https://github.com/LaTableRouge/Mappps/releases/tag/0.0.7
- Name change
0.0.6
- Released: July 29, 2024
- https://github.com/LaTableRouge/Mappps/releases/tag/0.0.6