=== Mapster WP Maps ===
Contributors: tempranova, mapster
Donate link: https://wpmaps.mapster.me/
Tags: maplibre, mapbox, maps, interactive map, gis
Requires at least: 5.0.0
Tested up to: 6.8
Stable tag: 1.21.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Mapster WP Maps is the smoothest, easiest way to make maps for your site. No API keys required.

== Description ==

With Mapster WP Maps, we're trying to make the best map editor and creator for Wordpress.

We integrate **MapLibre, Mapbox, and Google Maps**. You don't need an API key to use MapLibre!

* [Main site](https://wpmaps.mapster.me/)
* [Example site](https://wpmaps.mapster.me/examples/)
* [Documentation](https://wpmaps-docs.mapster.me/) (with video guides!)

Check out the extensive feature list below.

💽 If you're a developer, you can extend this plugin with custom code, too.

Happy mapping!

== 🌟 Free Version ==

Download the free version from this page. We hope to make this really useful for the vast majority of users. But if you need more, check out [Pro](https://wpmaps.mapster.me/pro)!

= 🗺️ Map Features =

* Live map editor and preview
* Choose between Maplibre (no API key required), Mapbox, and Google Maps
* 20 default map styles to choose from
* Use your own custom styles from Mapbox or any map tile provider
* Shortcodes and Block integrations to place your maps anywhere
* Variety of map projections available
* Custom size ranging from specific pixel sizes to full-screen maps
* Mapbox Standard with 3D features and environment
* 3D terrain
* Set custom center, zoom, tilt and rotation of map
* Have map automatically fit to features
* Add unlimited features (points, polygons, lines) to maps
* Cluster circles, labels, or markers for displaying many features at once
* Change user ability to interact with the map
* Move map to user IP on map load

= 🕹️ Map Controls =

* All controls can be positioned around the map as desired
* Category filter, where you can hide/show specific categories of features
* Custom search through features on the map (by text)
* Clickable, filterable dropdown list of features on the map
* Basic list
* Geocoder (search by address)
* 3D switcher
* Directions (origin and destination)
* Geolocation (user tracking)
* Make map fullscreen
* Zoom control, scale control
* Modify logo and attribution

= 📍 Geographic Features =

* Easy creation of features by drawing, entering address, or uploading data
* Unlimited Points, Labels, Text, Markers, Circles, Lines, Bezier Curves, Polygons
* Custom markers, icons, text
* Customize color, borders, opacity, line thickness
* Custom marker color, size, rotation, anchors
* Circle radius, opacity, color, border width and color
* Custom text labels with font choice, positioning, font size, color
* Custom icons with image of your choice, scale, rotation, position
* Use geographic features across multiple maps at once
* Interaction with any feature via click or hover
* Open popups on click or hover for any features

= 💬 Popups =

* Set of default popup styles or define your own using a Popup Builder
* Set popup to open automatically on click or hover, or when the map loads
* Popup header, description, thumbnail image, button footer all included optionally
* Easy preview of Popup Builder
* Set colors and text for popups
* Add custom CSS for popups to take full control of styling
* Center popup on map open
* Zoom on open
* Close when map clicked
* Open to directions, custom links, post information, or modal

= 📥 Import =

* Import up to 100 features per file (depending on number of coordinates)
* Import geoJSON, KML, GPX, Shapefiles
* All metadata retained in custom fields during import
* Easily import/export settings between installations

= 🖳 Developer =

* Custom permalinks for geographies and maps
* Add custom scripts to load and get access to the `map` variable
* Use [hooks](https://wpmaps-docs.mapster.me/for-developers/javascript-hooks) to run scripts on specific map events
* Shortcodes for outputting features on maps via IDs

== 🌟🌟 Pro Version ==

If you're building a really custom application or need some special functionality, [Pro](https://wpmaps.mapster.me/pro) has got it. We also offer a lot of support and are happy to build out new features.

= 🗺️ Map Features =

* Additional 16 map styles, for a total of 36 styles available
* Custom images as the map base, including scalable SVGs
* Set 3D globe view
* Add 3D buildings
* Set map language
* Restrict map movement to specific boundaries
* Set custom sizes of the map at different screen widths (mobile breakpoints)
* Advanced clustering options for size, color, and settings of clusters
* Replace clusters with images
* Choose cooperative gestures to avoid accidental map scrolling
* Customize the map loading graphic
* Add data to custom post types and add them to your map (Mapster ACF field)
* Geolocate to user IP address

= 🕹️ Map Controls =

* Manually order controls to appear the way you want on the map
* High accuracy geolocation, user heading, tracking as user moves, accuracy circle
* Style switcher to change between different Mapbox or Maplibre style JSONs
* Layer switcher to turn off and on layers from your Mapbox style
* Custom HTML control to make your own interactivity
* Print control to allow users to download an image of the map
* Download control (users can download all geographic features from the map)
* Allow searching by latitude and longitude in geocoder
* Display images in clickable feature lists
* Change type of filtering (inclusive or exclusive), set initial visibility, add additional filters based on custom fields
* Store Locator list
* List of features can be ordered and grouped by categories
* Manually order categories for category filter
* Manually order controls appearance on map
* Create a toggleable container to open/close your controls

= 📍 Geographic Features =

* Add MultiLineStrings, MultiPolygons
* Change styles of features on hover
* Add 3D models (GLB) and set size and rotation
* Add images on top of polygons as image layers
* Static sized icons to real-world measurements
* Mass edit features to make changes to 100s of styles at once
* Add images to map, defined by drawn polygons

= 💬 Popups =

* Render shortcodes inside popups
* Button to open modal with more information
* Open directly to modal on marker click
* Replace Popups completely with custom HTML
* Insert data from custom fields into your popups (using ACF or built-in fields)

= 💾 Big Data =

* Unlimited size of imports
* Caching for quick loading of map
* Import from Google Sheets
* Manage automatic uploading of data to Mapbox through the Mapbox Tiling Service
* Access and create Spatial APIs from your data

= 🌎 Specialty Maps =

* Allow users to submit points to make a crowdsourced map
* Compare two different maps
* Add elevation detail for a route
* Design heatmaps with big data
* Creating a listing page that connects your custom posts with geographic data on the map

= 🖳 Developer =

* Advanced Custom Fields (ACF) field type for maps
* Gravity Forms map field

Love,

Your Friends at [Mapster](https://mapster.me)

== Installation ==

1. Upload `mapster-wp-maps.php` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Click on "Maps" to start building your maps.
4. Add an Access Token if you would like to use custom Mapbox styles or geocoders
5. Use the provided shortcodes to output these maps in your posts or widgets.

== Frequently Asked Questions ==

= Something seems broken! =

Get in touch with us at [https://wpmaps.mapster.me/](https://wpmaps.mapster.me/) and we'll message you back right away.

= Do you have any instructions on how to use the plugin? =

We've got you covered with extensive documentation at [https://wpmaps-docs.mapster.me/](https://wpmaps-docs.mapster.me/).

= You almost have what I need, but not quite... =

Email us at https://mapster.me, write a [feature request](https://mapster-wp-maps.canny.io/feature-requests), or leave a comment in the Wordpress Support Forum.

== Screenshots ==

1. Globe view with markers.
2. Map creation interface with a 3D terrain map.
3. Heatmap specialty map.
4. Further view of editing interface.
5. Dust of the World markers and popups.
6. Creating custom popups.
7. Listing map.
8. Mapbox's Standard Style, usable in this plugin.

== Changelog ==

= 1.21.0 =
* Fix and reversion for sanitization
= 1.20.0 =
* Improvement to ensure assets loaded for globe animation
* Further Wordfence security sanitization
= 1.19.0 =
* Updating ACF to 6.4.3
* Adding selection by CPT category
* Fix for Store Locator missing hours 
* Adding basic polygon patterns 
* Wordfence vulnerability patches 
* Geocoder able to embed on separate page 
* Fixing image thumbnail in popup preview
= 1.18.0 =
* Added thumbnails to Locations, Lines, and Polygons
* Fixes to permalink jankiness
* Improved validation Popup Template
* Removing unneeded local fonts
* Error checking for coordinate points Google Map
* Bounds working with filter dropdown
* Adding popup functionality to listing map
* Adding better bounds reset to listing map
* Bug fix for clicking when complex clusters 
* Improvement in simulated clicks on layer features
* Adding clustering polygons and clustering lines 
= 1.17.0 =
* Static CSV import added
* Advanced Static CSV options
* Adding default translucent borders to clusters
* Changing default render order to put polygons on the bottom
* Minor access token loading Mapbox issue
* Base image input removed
* Documentation major update
* Adding post display options to CSV import
* AutomatorWP bug fix
* Fix to filter dropdown query click
* Improving CSV image import
* Adding lat, lng, and zoom to query string load parameters
* Adding custom position translation to popup templates
* Bug fix with custom filter and sidebar popup
* Fix for default custom fields showing (ACF)
* Upgrade Freemius version
= 1.16.0 =
* Enhanced CSV upload with recurring scheduled CSV
* Adding complete custom fields to enhanced CSV
* Attribution control added to Maplibre
* Allowing rendering of linebreaks in labels
* Return glyphs to remote source
= 1.15.0 =
* Fix to full page height in some cases
* Adding header to modal popup
* Permalink flush fix
= 1.14.0 =
* Improving null location error alert
* Added static circles
* Fix to ACF field sans styling, more clarity
* Major enhancements to Listing Map
* Option to have category filter parent be cosmetic only
* Fix for Google Maps marker popups
= 1.13.0 =
* Loading fonts locally for free map types
* Fix to hover popup when hovering over other polygons
* Update for 6.8
= 1.12.0 =
* Adding {post_title} tag to HTML editor
* Adding Gravity Forms integration and custom field
* Fix to distance sorting when category list control enabled
* Fix to popups opening on listing page
* Unlimited categories during geoJSON import (set_categories property)
* Adding support for WEBP, AVIF, and SVG for icon images and polygon images
* Adding support for scalable SVGs as background images for maps
* Bug fix for permalink flushes
= 1.11.0 =
* Store Locator loading fix
* Freemius update
= 1.10.0 =
* Fix for zooming on custom search filter
* Fix for multiple image maps
* Adding cursor effect on hover
* Freemius update
= 1.9.0 =
= 1.8.0 =
* Bug fix for geocoder search
= 1.7.1 =
* Fix with category list special properties
* Large custom image maps working in mobile
* Fix for missing popups on full screen maps
* Allow text overlap
* Adding popup anchor options
* Popup fixes and map centering fixes for Store Locator
= 1.6.0 =
* Fix for clicking 3D objects
* Bug fix for "Text" Mass Editing Popup description
* Quick set for manual view values
* Map compare shortcode fix
* Heatmap trimming fix
* Style switch fix with Mapbox update
* Improving security for API endpoints
* Alignment fix for popup text
* Security fix for popup JS injection
= 1.5.0 =
* Custom search working with custom zoom level
* Adding restriction by bounds to geocoder
* Security fix to options
* Opacity hover effect on icons added
= 1.4.0 =
* Create completely full-page maps
* Update Mapbox 3.6.0
* Adding Standard Styles with lighting
* Control menu toggle container for hiding controls
* Fixing event listener bugs associated with controls on multi-map pages
* Freemius update
* Improved printer icon for Print Control
* Add custom padding for bounds on load
* Labels present on Category Filter Dynamic Properties
* Adding a ton of awesome new styles
* More restrictive scoping of event listeners on various controls
* Bug with download control
= 1.3.0 =
* Adding Reset button for category filter
* Adding image layer for polygons
* Making Mapster ACF field functional for other post types
* Fixing bug for tilt and rotation in mobile
* Adding ability to draw bezier curve
* Adding shortcode render for popup content
* Adding ability to reorder categories in filter
* Reorganized map editor interface for easier navigation
* Cleaning up some interface text in Pro
* Ordering control load order
* Can enter multiple features in shortcodes
* New version numbering system
* Validating ACF Mapster Map field for required field
* Ability to geolocate to user IP address
* Improved selector for map styles
* Fix for Carbon Fields meta fields display
* Advanced List Control functionality (accordion, ordering features, sorting by categories)
* Fix on List Control clicking
* Fix on modal opening immediately showing undefined
= 1.2.42 =
* Fix for google maps markers
= 1.2.41 =
* Loading a map via querystring and opening popup automatically
* Select map language for Mapbox maps
* Added blueprint for testing
* Custom zoom level for locations
* Adding images for clusters
* Fixing globe transparency
* Adding Print Control
* 3D shapes working with category filter
* Images with filter dropdown
* Modal details including custom properties
* Attribution control added
* Static icon sizes
* Images with list control
* Embed to iframe for Safari
* Geocoder now accepts lat/lng entries
* Added optional animation to globe view
= 1.2.40 =
* Updating Mapbox GL JS to v3.1.2
* Adding marker color option for geocoder
* Updating image thumbnail sizes for sidebar slideshow images
* Updating ACF and more deprecation notices for PHP 8.2+
* Allowing display for non-category symbols during category clustering
* Bug fixes
* Freemius update
= 1.2.39 =
* Stamen tiles update (still not open except from localhost)
* Adding cooperative gestures
* Fix to filter dropdown clicking in some browsers
* Changing how symbols show/hide during category filters
* Centering coordinates when edited manually in Locations
* Adding listing specialty map
* Ability to open directly to modal
* Popups working on 3D models
* Fix on directions layers not appearing (not detecting loaded state)
* Prevent focus on popups when opened
* Store hours properly hidden
* Google Maps Store Locator Mobile fix, scrolling fix
* PHP 8 fix for deprecated dynamic properties
* Security fix for shortcode XSS vulnerability
= 1.2.38 =
* Ensuring borders are hidden when circles are hidden
* Prepping for major update of Maplibre version
* Fixing some mobile popup issues with Maplibre
* Popup image resolution options added
* Adding additional geolocation options
* Fixing reloading of custom icons on default style switch
* Interactions between search filter and category toggle
* Updates for PHP 8.1
* Fix for cursors on label icons with popups
* Moving cache generation to wp-uploads
* Fix to user submission posts showing in single feature shortcodes
= 1.2.37 =
* Ability to create map caches
* Simplification tool for shapes
* Properly output content in feature object
* Hovering bug fix for overlapping polygons
= 1.2.36 =
* User submission datepicker bug
* Modals able to render shortcode content
* Category option to have numbers rendered
* Ability to show category name as cluster instead of number
* Freemius update
= 1.2.35 =
* Previews for specialty map types
* Improving modal close button
* Renaming Mapbox Style URL to Style URL for all providers
* Added ESRI Satellite layer
* Layer control error correction
* Improved user submission flow
* Removing references to CSV regular importer
* Adding features images to maps
= 1.2.34 =
* Fix for popup image backgrounds
* Incorrect update
= 1.2.33 =
* User Submission error
* Ensuring custom HTML shows correctly in map edit
* Removing unneeded vendor files
* Mass Edit for showing map in post
* Correcting import count on title
* GeoJSON download button fix
* User Submission edit post display script fix
* Map style slider beta
* Heatmap beta
* Reorganize map editor tabs
* Elevation map beta
* Fix for none permalink type
* Download only included fields
* Ensuring general and specific hooks both run
= 1.2.32 =
* Fix to accordion layout (oops)
* Ensuring premium plugin deactivates free plugin without an error
* Improving script loading by pre-compiling
* Restricting enqueued backend scripts to appropriate post types
* Fixing click-to-link so doesn't open when disabled
* Fixing overflow scroll on List Control
* More elegant marker clustering (no flash of single markers)
* Ability to set number of search results for Custom Search Filter
* Style switcher control
* Layer switcher control
* Different search options for Custom Search Filter
= 1.2.31 =
* Removing extra field User Submission
* Minor CSS fixes User Submission
= 1.2.31 =
* Removing test code limiting uploads /facepalm
= 1.2.30 =
* Fixes to category marker clustering
= 1.2.29 =
* List control mobile layout fix
* Limited geocoder country fix
* Shortcode generator for features
* Setting default template map
* Improving centering of popups
* Update instructions for importing shapefiles
* Improving hover flickering on polygon popups
* Completing first version CSV import
* Fix to 3D terrain adding
* Hovering on layer features improved
* Extra list elements removed category filter
* Speed improvements in Pro
* Move attribution control
* Move logo position
* Allowing category exclusion for filter
* Collapsible menu for category filter
* Improved loading UX
* Fixing icon size bug with large images
= 1.2.28 =
* Added indicators of current map details in Manual Center and Zoom
* Fixing geolocation on load bug
* Custom list control store locator button
* Fill extrusion bug fix
= 1.2.27 =
* Extend zooming functionality to non-markers in List
* Adding functionality for zoom on click popups
= 1.2.26 =
* Allowing disable rotation and pitch
* Adding functionality for center on click popups
= 1.2.25 =
* Fix to embed code
* Allowing uploading errored geojsons
* Ability to change editing map style
= 1.2.24 =
* Fixing encoding in Dropdown List
* Mobile breakpoints
* Update to latest ACF version, extracting styles
= 1.2.21 =
* Improvements to User Submission
* Expandable map edit screen
* Download geoJSON edit screen
* Showing proper labels for complex ACF fields
* Adding Gutenberg selection block for map
* Custom Images as base maps
* Fix to map rotation (bearing)
= 1.2.20 =
* Labels on checkboxes for filter
* Strings for User Submission
* WPML integration User Submission
* Editing permissions User Submission
= 1.2.19 =
* User Submission popups
* Adding link to store locator fields
* Category filter interact with Store Locator
* Multi features initial shape
= 1.2.18 =
* Restriction of user movement on map
* Allowed area during user submission
* Adding custom HTML control
* Adding CSV export user submissions
* Adding clustering by category
* Translation strings for submission process
= 1.2.17 =
* Bug fix layer trigger popup on load
= 1.2.16 =
* Revision of user submission
= 1.2.15 =
* Geocoder control fix
= 1.2.14 =
* Ensure code fields show up in Free version
* Adding globe view
* Add geolocation on by default to control
* Properly render HTML entities in Custom Search Filter
* Remove marker from Custom Search Filter, add automatic popup open on markers
= 1.2.13 =
* Open popup on feature layer on map load
* Bug related to lines automatically showing dashes
* Bug with X/Y positioning on labels and icons in production
* Adding function to add category to a div
* Making sure properties formatted properly when objects
* Bug editing features in user submission with template overwrite
* Loading support for Elementor elements
* Unhiding height fields
* Adding custom lat/long and zoom options to shortcode
= 1.2.12 =
* Layout user submission
* Adding wrapper, CSS, JS to user submission
= 1.2.11 =
* Bug with duplication importing
* Migration tool and documentation
* Category fix
* Semantic change user submission
= 1.2.10 =
* First implementation 3D models
* Adding starter tutorial
* ListControl fix
= 1.2.9 =
* Adding custom spatial database
* Adding MultiPolygon, MultiLineString editing
* Spatial API 1.0
* Fix for local ACF and ACF Pro
= 1.2.8 =
* Minor Mass Edit js bug
= 1.2.7 =
* Full width fix for all containers
* Optional widths for sidebar
* Secondary categories in advanced importer
* Adding dynamic features to custom HTML popup templates
* Gallery margin-left fix
= 1.2.6 =
* Adding custom style JSON
* Google Maps first integration
* Hiding Mapster WP Maps ACF field
= 1.2.5 =
* Import bug with many properties
* Mass edit small bug
= 1.2.4 =
* Map projections
* Update Mapbox 2.8.2
* Adding 3D models first pass
= 1.2.3 =
* Clustering for markers
* 3D extrusions
* Pitch and rotate enabled
= 1.2.2 =
* Hover effects for popups
= 1.2.1 =
* Custom HTML for popups
= 1.2.0 =
* Integrating Freemius
= 1.1.5 =
* Updates for WPML fetch all language posts
* Fixing front end geocoder
= 1.1.4 =
* Adding map display to location, line, and polygon post types
* Fatal error
* Image issue fixed
= 1.1.3 =
* Major PHP bug fixed
= 1.1.2 =
* CSS Admin menu
* Domain fix
= 1.1.1 =
* Popups stay open on mouse hover option
* Customizable permalinks
* Breaking errors
= 1.1.0 =
* Numerous bug fixes
* Splitting plugin into Basic and Pro
* Quality of life fixes
= 1.0.3 =
* Editor bug fixes
* Marker overlapping bug fix
= 1.0.2 =
* Bug fixes custom scripts
* Allowing large file uploads
= 1.0.1 =
* Bug fixes marker popups and dropdown list
= 1.0.0 =
* Rewrite to make plugin more extendable and developer-friendly
* Store locator functionality and addon
* Numerous smaller bug fixes
= 0.5.16 =
* Allow MultiLineString and MultiPolygon uploads into features
* Significantly expanded Store Locator functionality
* Prepping for addon plugins
= 0.5.15 =
* Adding user submission of features
* Bug with search filter not loading geocoder
= 0.5.14 =
* Allowing category filter to be initialized "off"
= 0.5.13 =
* Updating initial bounds zoom
* Some issues with the last update, missing scripts
= 0.5.12 =
* Improvement to script loading
* Placeholder option for list control
* Ability to turn off map horizontal duplication
= 0.5.11 =
* Conditional script loading
* Editor improvements adding/deleting
* Editor improvements clustering icons
* Addition of gallery slideshow to popups
* Ability to open popups in a sidebar instead
* Ability to enter in location coordinates directly
= 0.5.10 =
* More API bug fixes
= 0.5.9 =
* Bug fixes editor
* Bug fixes API
* Marker fix for category filter
= 0.5.8 =
* Marking some features as in development
* Improving marker image sizes
= 0.5.7 =
* Improving marker clicks during mobile
* Major loading improvements for larger maps
= 0.5.6 =
* Fixing multiple maps on one page
* Cross-origin image fix
* Properly calling titles for filters
* Click hover popups in mobile
= 0.5.5 =
* Increasing specificity of button styles
* Adding geosearch to Lines and Polygons
= 0.5.4 =
* Fix pointer background bug
* Easy duplication of posts
* Improved bounds loading
* Marker click to URL
= 0.5.3 =
* Import geoJSON
* Ability to interact via custom scripts
* Full width maps
* Fixed Safari/Firefox icon bug
= 0.5.1 =
* Import from Mapbox WP GL JS
* Add/remove features by category
= 0.5.0 =
* Complete rewrite with ACF and jQuery
= 0.4.3 =
* Adding Mapbox Terrain
* Adding custom tilesets
* Set view with a button
* Tutorial links
= 0.4 =
* Switching Mapbox 1.13 to MapLibre
= 0.3 =
* Adding delete functionality
* Improving geocoding
* Improving view control
= 0.2 =
* Adding location geocoding
= 0.1 =
* Push to do beta testing.
