
=== WP Maps - Store Locator,Google Maps,OpenStreetMap,Mapbox,Listing,Directory & Filters ===
Contributors:      flippercode
Plugin Name:       WP MAPS
Tags: store locator, google maps, openstreetmap, map, directory
Author URI:        http://profiles.wordpress.org/flippercode/
Author:            flippercode
Requires at least: 3.4
Tested up to: 6.9
Stable tag: 4.8.8
Requires PHP: 5.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

WordPress map plugin for Google Maps, OpenStreetMap & Mapbox with store locator, filterable listings & custom markers.

== Description ==

**WP Maps** is a powerful and user-friendly WordPress map plugin that supports both Google Maps and OpenStreetMap. With just a few clicks, you can create unlimited maps with custom markers, filterable listings, store locators, and dynamic infowindows. Perfect for real estate listings, directories, multi-location businesses, and more.

* Unlimited maps and locations
* Store locator with search and filters
* Custom markers, SVG support, and clustering
* Info windows on click or hover
* KML, KMZ, GeoJSON, and layer integration
* OpenStreetMap Maps require no API key; Google Maps support available

== Try It Now ==

Explore the plugin instantly using the WordPress Playground:
👉 [Try WP Maps](https://playground.wordpress.net/?plugin=wp-google-map-plugin)

== Features ==

### 🗺️ Map Creation & Display
* Create unlimited maps with shortcode support
* Display maps in posts, pages, widgets
* Auto-center by visitor location or assigned locations
* Show/hide markers on load

### 📌 Marker & Infowindow Controls
* Use custom or pre-built marker icons (SVG supported)
* Infowindows on click or hover
* Bounce/drop animation effects
* Center or zoom on marker click

### 📋 Listings & Filters
* Show listing below map with search and filters
* Enable category, sort, per-page, and filters
* Customize listing layout
* Show info window when listing title is clicked

### 🎨 Design & Themes
* Custom map color schema
* Set primary/secondary color
* Add custom CSS
* Responsive & mobile-friendly design

### ⚙️ Controls & Settings
* Enable/disable zoom, fullscreen, map type, scale, street view
* Enable search box and "locate me" controls
* Limit panning using SW/NE coordinates

### 🌐 Map Layers & Data
* KML/KMZ, Traffic, Transit, Bicycling layers
* GeoJSON support
* Import/export settings via JSON

### 💻 Compatibility
Works with all major page builders and themes:
* Elementor, WPBakery, Divi, Gutenberg, Brizy, Beaver Builder
* Astra, Avada, OceanWP, GeneratePress, Hello Elementor

Here is a quick highlight on the numerous customizable features offered by the free and pro versions of the <strong>[WP MAPS PRO Version](https://www.wpmapspro.com?utm_source=wordpress&utm_medium=liteversion&utm_campaign=freemium&utm_id=freemium)</strong>.
 
* NO API Key required for OpenStreetMap Maps and API Keys is required for Google Maps.
* Fully GDPR-compliant Google Maps integration for secure and privacy-friendly usage
* Use Google Maps, OpenStreetMap or Mapbox as your map provider. Easy switching between each map provider.
* Show a listing of locations below the map with built-in search and filter controls
* Use SVG as marker icons – choose from pre-built SVGs or upload your own
* Apply multiple Infowindow designs for custom popup layouts
* Create unlimited Google/Leaflet Maps with custom marker icons, categories, and assigned locations
* Add and manage multiple locations with rich content and info windows
* Assign multiple locations to a single map for complex layouts
* Show info windows on click or hover with customizable content
* Display maps on any post, page, or widget using shortcode or sidebar widget
* Define custom center latitude/longitude for each map
* Auto-center map based on assigned locations
* Categorize locations for filterable maps and better organization
* Choose from over 100+ ready-to-use colorful markers via [Map Icons Collection](https://mapicons.mapsmarker.com/)
* Enable marker clustering to handle dense location areas
* Choose from 4 map types: Roadmap, Satellite, Hybrid, and Terrain
* Set custom map height, width, and zoom level easily
* Enable or disable map drag, scroll zoom, and interactivity
* Add layers like Traffic, Transit, Bicycling, and more for enhanced context
* Support for Street View, 45° imagery, and POV controls
* Add visual elements like circles to highlight areas
* Fully responsive maps – looks perfect on desktop, tablet, and mobile
* Cross-browser compatible – tested on IE8+, Chrome, Firefox, Safari
* Multilingual ready – supports WPML and translation plugins
* Works across WordPress Multisite, with network-wide activation support
* Easily style maps using Snazzy Maps
* Built-in search control to locate places directly on the frontend map
* Filter markers on the frontend by category
* Seamless upgrade to Pro – no data loss when switching from free to paid

### 🏬 Use Cases – Map Solutions for Every Business

WP Maps helps you build advanced location maps for any industry. From store locators to real estate maps, here are popular use cases powered by Google Maps or Leaflet:

* 🛍️ Retail Store Locator – Showcase nearby outlets, branches, or chain locations  
* 🍽️ Restaurant Locator – Help users find your cafes, diners, or food franchises  
* 🏠 Real Estate Property Map – Display properties with filters for listings  
* 🏥 Hospital & Clinic Map – Show medical centers, diagnostic labs & walk-ins  
* 🏋️ Gym & Fitness Center Locator – Promote local gyms, yoga studios & wellness hubs  
* 🛒 Shopping Mall Directory – Build interactive directories with category filters  
* 🏨 Hotel & Resort Locator – List resorts, BnBs, and vacation rentals by location  
* 🚗 Car Dealership Map – Map showrooms, service centers, and authorized dealers  
* 🏦 Bank & ATM Locator – Help customers locate ATMs and branches  
* 💊 Pharmacy Finder – Display medical stores and 24/7 pharmacy locations  
* 💅 Salon & Spa Locator – Show salons, nail bars, and beauty spas nearby  
* ✂️ Barber Shop Locator – Map grooming centers, barbershops, and hair stylists  
* 🎓 School & University Maps – Display educational institutions with filters  
* 🎤 Event Venue Locator – Help users find event halls, venues, and stadiums  
* 🎬 Cinema & Entertainment Map – List theaters, gaming zones, and arcades  
* 🖼️ Museum & Art Gallery Locator – Showcase local exhibitions and museums  
* 🏛️ Government Office Map – Map municipal offices, courts, or embassies  
* 📦 Post Office & Courier Center Locator – Find shipping centers and drop boxes  
* ⛪ Religious Center Locator – Show churches, mosques, temples, or community halls  
* 📚 Library Map – Display public and academic library locations  
* 🐾 Veterinary & Pet Store Map – Highlight vets, clinics, or pet supply stores  
* 🔧 Hardware & Home Services Map – Show electricians, repair centers, or hardware stores  
* 💼 Co-working Space Locator – Help users find shared office spaces or business hubs  
* 🏗️ Construction & Project Map – Showcase new projects or development plots  
* 🍷 Wine & Liquor Store Map – Find wine shops and liquor outlets with filters  
* 🚴 Outdoor & Sports Store Map – Locate gear shops, bike rental points, etc.  
* 🧸 Toy Store Locator – Promote branded or local toy stores  
* 🌻 Garden Center & Nursery Map – Help users find garden shops and nurseries  
* 📖 Bookstore Locator – Showcase independent and chain bookstores  
* 📱 Electronics Store Map – Map mobile, computer, and appliance retailers  
* 👗 Clothing Store Locator – Help users find fashion outlets and boutiques  
* 🛠️ Service Center Locator – Map repair centers for electronics, cars, or devices  
* ⚖️ Legal & Consultancy Locator – List law firms, advisors, and service offices  
* 📄 Insurance Office Map – Show agents, offices, and policy assistance centers  
* 🚛 Dealer & Warehouse Locator – Display regional warehouses and distributors  
* 🍼 Childcare & Preschool Finder – Help parents locate daycares and nurseries  
* 🛒 Supermarket & Grocery Store Map – Show supermarkets, mini-markets, or organic stores

**💡 Whether you're running a small local shop or a global brand, WP Maps helps you build responsive, searchable, and filterable maps tailored to your business.**


== Installation ==

1. Upload the **wp-google-map-plugin** folder to the `/wp-content/plugins/` directory.
2. Log in to your WordPress dashboard and navigate to **Plugins**.
3. Locate **WP Maps** in the plugin list and click **Activate**.
4. After activation, go to **WP Maps > Tools**.
5. Scroll to the **Install Sample Data** section.
6. Enter `YES` to confirm and click the **Create Sample Data** button.
   - This will create 2 sample categories, 5 sample locations, 2 demo routes, and 1 sample map for demonstration.

*Note: Installing sample data is optional, but highly recommended for new users to explore plugin features quickly.*

== How It Works ==

1. Add your locations from **Add Location**
2. Create a map from **Add Map** and assign locations
3. Use the shortcode (from **Manage Maps**) in posts, pages, or widgets

*Note: Google Maps requires an API key. OpenStreetMap works without a key.*

== Frequently Asked Questions ==

= Is this plugin GDPR-compliant? =
Yes, WP Maps is fully GDPR-compliant for both Google Maps and OpenStreetMap integrations.

= Do I need a Google Maps API key? =
Only for Google Maps. OpenStreetMap requires no API key.

= Can I use my own marker icons? =
Yes, upload PNG or SVG icons or choose from 100+ pre-designed icons.

= How many locations can I add? =
You can add unlimited locations.

= Can I display maps with shortcodes? =
Yes, each map has a unique shortcode you can place anywhere.

= Is there widget support? =
Yes, you can show maps in sidebars using the widget.

= Do you offer documentation and tutorials? =
Yes! Visit [WP Maps Tutorials](https://www.wpmapspro.com/tutorials/).

= What if I need help or support? =
Contact us at [Support](https://weplugins.com/support/).

== Important Links ==

* [Live Demos](https://www.wpmapspro.com/try-now/)
* [Tutorials](https://www.wpmapspro.com/tutorials/)
* [Hooks & Filters](https://www.wpmapspro.com/map-hooks/)
* [Support](https://weplugins.com/support/)

== Screenshots ==

1.  Google Map Page – Add and manage maps using Google Maps as the provider
2.  Open Source Map Page – Create maps using OpenStreetMap or Leaflet
3.  Add Marker Category – Create categories to group markers (e.g., Hospitals, Restaurants)
4.  Assign Marker Icon to Category – Set a default icon for each marker category
5.  Assign SVG Marker Icon – Upload and assign custom SVG icons to marker categories
6.  Manage Marker Categories – Edit, delete, or organize your marker categories
7.  Add Location Page – Add new locations with address, coordinates, and other details
8.  Manage Location Page – View, edit, or delete all added locations
9.  Add Map Page – Create a new map with layout, zoom, and marker options
10. Map Center Settings – Set the default center and zoom level for the map
11. Assign Locations to Map – Attach selected locations to a specific map
12. Map Listing Settings – Customize how location listings appear next to the map
13. Listing Item Skins – Choose from different styles for listing item design
14. Marker Cluster Settings – Enable clustering of nearby markers for better performance
15. Map Center Display – Show a circle or marker at the map’s center point
16. Map Theme Settings – Change the map appearance using pre-built themes or styles
17. GeoJSON Settings – Upload and display GeoJSON shapes or regions on the map
18. Limit Panning Settings – Restrict map movement beyond a certain boundary
19. Map Layers Settings – Toggle layers like traffic, transit, or bicycle routes
20. Manage Maps Page – View, edit, or delete all your saved maps
21. Google Map Provider Settings – Configure API keys and features for Google Maps
22. Street View Settings – Enable or disable Google Street View on the map
23. Advanced Marker Settings – Customize marker animations, z-index, behavior, etc.
24. Open Source Map Provider Settings – Configure options for Leaflet/OpenStreetMap usage


== Changelog ==

= 4.8.8 =
* Fix : Reported security issue related to shortcode attribute fixed.

= 4.8.7 =
* Fix : Reported security issue related to file control fixed.
* Fix : Sample csv download functionality fixed.

= 4.8.6 =
* Add : Search and Category placeholder settings now work correctly with OpenStreetMap.
* Add : Plugin script and style files will not load on another pages.

= 4.8.5 =
* Add : Fix Autosuggest selected address displays the formatted address.
* Add : Fix the frontend Font Awesome console error.
* Add : Fix the category parameter handling in the shortcode.

= 4.8.4 =
* Add : API Key missing message display if opensource provider selected fixed.

= 4.8.3 =
* Add : Updated the doc for Infowindow Message for Locations.
* Add : Fixed the Undefined wpgmp_api_key error.

= 4.8.2 =
* Add : Fixed the Fatel error htmlspecialchars_decode().
* Add : Fixed the search control error.

= 4.8.1 =
* Add : Fixed the png marker default size issue.
* Add : Infowindow open on wrong area issue fixed.
* Add : Search control autosuggest issue fixed.


= 4.7.4 =
* Add : Fixed the empty latitude and longitude vaildation error message.

= 4.7.3 =
* Add : Fixed the _load_textdomain_just_in_time issue.
* Add : Fixed the headers already sent issue.

= 4.7.2 =
* Add : Fixed the security issues related to map controls.

= 4.7.1 =
* Add : Fix the issue of Camera control position.

= 4.7.0 =
* Add : Fix the cookie consent hook callback issue.
* Add : Add Camera control manageable settings.

= 4.6.9 =
* Add : Copy map shortcode by icon functionality added.

= 4.6.8 =
* Fix : compatible with cookiebot plugin.
* Fix : Backup Table Constant issue solved.

= 4.6.7 =
* Fix : Some backend strings were not translatable for site admins.

= 4.6.6 =
* Fix : Fix some Deprecated messages.

= 4.6.5 =
* Fix : Async loading of Maps API stopped.
* Fix : Compatible with PHP Version 8.2.12

= 4.6.4 =
* Fix : Made it compatible with GTM(Google Tag Manager).

= 4.6.3 =
* New : Added feature of CodeMirror editor for Infowindow Message for Locations backend.

= 4.6.2 =
* Fix : Security issue fixed
* New : Backend UI improved

= 4.6.1 =
* New : Gutenberg map block component added

= 4.6.0 =
* New : API loaded asynchronously for faster map page load.


== Upgrade Notice ==

= 4.8.8 =
– Upgrade for more stable release.

= 4.8.7 =
– Upgrade for more stable release.

= 4.8.6 =
– Upgrade for more stable release.

= 4.8.5 =
– Upgrade for more stable release.

= 4.8.4 =
– Upgrade for more stable release.

= 4.8.3 =
– Upgrade for more stable release.

= 4.8.2 =
– Upgrade for more stable release.

= 4.8.1 =
– Upgrade for more stable release.

= 4.7.4 =
– Upgrade for more stable release.

= 4.7.3 =
– Upgrade for more stable release.

= 4.7.2 =
  – Upgrade for more stable release.

= 4.7.1 =
  – Upgrade for more stable release.

= 4.7.0 =
  – Upgrade for more stable release.
  
= 4.6.9 =
  – Upgrade for more stable release.

= 4.6.8 =
  – Upgrade for compatibility with cookiebot plugin.

= 4.6.7 =
  – Upgrade for using more translatable strings

= 4.6.6 =
  – Upgrade for more stable release.

= 4.6.5 =
  – Upgrade for PHP version 8 compatibility.

= 4.6.4 =
  – Upgrade for compatibility with Google Tags Manager.

= 4.6.3 =
  – Upgrade for code mirror editor in the backend.

= 4.6.2 =
  – Upgrade for more stable and secure version of plugin. Security issue was fixed.

= 4.6.1 =
  – New Gutenberg block added to display and customise the google map with live preview right inside the Gutenberg editor.
  – Unlocked one more paid feature from pro version – Map Themes. User can apply color theme to Map UI.
  – More hooks added to make plugin more extensible and scalable.

= 4.6.0 =
  – Implemented a popup to get feedback from the plugin user if user deactivates the plugin.
  – Google API loaded via asynchronous way to speedup page load process.

= 4.5.9 =
  – Referrer link updated inside plugin and some internal links updated inside core framework

= 4.5.8 =
  – Plugin tags updated plus unsued file removed.

= 4.5.7 =
  – Get Direction link placeholder {get_directions_link} support added to display Get Direction link inside Infowindow.

= 4.5.6 =
  – Playground link added and support links updated

= 4.5.5 =
  – Design improvements using css

= 4.5.4 =
  – Remove entry of same category from parent category dropdown when editing that category in backend
  
= 4.5.3 =
  – Translated in 15 Languages.
  – Tutorial links added.

= 4.5.2 =
  – Maps preview added on settings page.

= 4.5.1 =
  – GDPR compatiblity issue fixed.

= 4.5.0 =
  – GDPR compatiblity issue fixed.

= 4.4.9 =
  – Fixed the initwpmaps error and use the default confirmation for delete.

= 4.4.8 =
  – Fixed the json encode error on add location page.

= 4.4.7 =
  – GDPR support added for popular wordpress plugins.

= 4.4.6 =
  Please update to 4.4.6 or above to use the most stable version of the plugin.

= 4.4.5 =
  Please update to 4.4.5 or above to use the most stable version of the plugin.
